feat: 能力插件元数据与运行时消费闭环
This commit is contained in:
1 parent
076c6124c8
commit
bb0709b8cc
26 files changed
+2188
-267
No files matched your search
@@ -0,0 +1,29 @@
|
||||
# 0024 Capability 产品元数据契约
|
||||
|
||||
## Context
|
||||
|
||||
Capability 之前只有技术 key 和状态,Admin 难以判断能力是否可选、停用影响和入口配置。插件配置也存在硬编码 `{}` 的问题,且客户端曾要求提交 `capabilityVersion`,容易让服务端版本被错误覆盖。
|
||||
|
||||
## Decision
|
||||
|
||||
- `capabilityRegistry` 是产品元数据、禁用策略、允许页面、依赖模块、用途绑定和入口导航的唯一来源。`offerings` 是不可移除的核心能力;`inquiry` 核心能力允许停用;`quote-request` 是可选能力。
|
||||
- 咨询和报价能力只声明 `entryLabel`、`submitHint`、`disabledHint` 三个文本配置字段。服务端按注册表白名单校验,不接受未声明字段。
|
||||
- Admin 读写契约返回元数据与配置字段声明;更新接口只接受状态和配置,`capabilityVersion` 由服务端按当前注册表派生。
|
||||
- Runtime Workspace 的 capabilities 与 plugins 输出品牌级配置。已发布快照读取发布时能力记录,草稿变更只进入 Admin 预览,直到重新发布。
|
||||
|
||||
## Alternatives
|
||||
|
||||
- 在每个行业模板中重复能力元数据:会造成同一能力多份定义。
|
||||
- 允许客户端提交版本:可能导致品牌记录与平台契约漂移。
|
||||
- 继续把配置写入硬编码 `{}`:无法支撑可运营入口和提示文案。
|
||||
|
||||
## Consequences
|
||||
|
||||
- 新增能力时必须同步注册表元数据、配置字段和集成回归。
|
||||
- 未声明元数据的能力在 Runtime 中只保留技术状态,不会伪装成可配置产品能力。
|
||||
- 停用 `inquiry` 会阻止对应表单提交;移除 `quote-request` 后报价表单不再可用。
|
||||
|
||||
## Migration Plan
|
||||
|
||||
1. 旧品牌记录继续保留原 `capabilityVersion`,下一次 Admin 更新由服务端派生为注册表版本。
|
||||
2. 已存在的能力配置继续进入发布快照;未声明字段需要在下一次保存时按新校验清理。
|
||||
Reference in new issue
Block a user