模块 Manifest v1

每个 StackRivet 模块只使用一套严格的 module.manifest.json 合同。运行时 Registry、生成器与文档共用同一个带版本 JSON Schema；未知字段、非法权限或 路由结构会被直接拒绝。

• Schema 固定地址：/schemas/module-manifest-v1.schema.json
• JSON Schema 草案：2020-12
• 当前 schemaVersion：1

最小 Manifest

{
  "$schema": "https://stackrivet.zkthink.com/schemas/module-manifest-v1.schema.json",
  "schemaVersion": 1,
  "id": "ticket",
  "name": "Ticket",
  "version": "1.0.0"
}

生成模块还会声明权限、菜单、迁移和生成身份。编辑器可以通过 $schema 获得补全与校验；CI 应在打包前用这份 Schema 校验所有 Manifest。

兼容性

schemaVersion 是兼容边界。v1 内可以增加可选字段；字段或语义发生破坏性 变化时，必须发布新的 Schema URL 与版本。消费者不得静默忽略未知字段。