1.9 KiB
1.9 KiB
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
- 旧品牌记录继续保留原
capabilityVersion,下一次 Admin 更新由服务端派生为注册表版本。 - 已存在的能力配置继续进入发布快照;未声明字段需要在下一次保存时按新校验清理。