2.1 KiB
2.1 KiB
品牌运行时与多品牌隔离推进计划
目标
个人品牌是产品主线,行业模板、视觉模板和能力插件都必须在品牌隔离的运行时上下文中工作。Admin 与小程序不得维护第二套实时品牌数据。
当前结论
- 数据模型已经普遍包含
brandId,但 Admin 运行时仍依赖DEFAULT_BRAND_ID,当前属于单品牌运行模式。 BrandProfile及其品牌业务表应是实时品牌内容的唯一来源。BrandTemplateInstallation.configSnapshot仅用于模板版本、升级和回滚,不得覆盖实时品牌内容。RuntimeWorkspace是 Admin 和小程序统一消费的读取契约。- 小程序静态数据只能作为按模板选择的离线 fallback,不能覆盖成功的 API 返回。
阶段
Phase 1:统一品牌运行时数据
- Admin 页面统一通过
/admin/workspace获取运行时数据。 - 小程序页面移除直接读取行业静态数据的路径。
- fallback 按
personal、food、doors模板拆分。 - API 成功时不允许 fallback 覆盖 API 数据。
- 增加三模板数据一致性和 API 失败 fallback 测试。
Phase 2:品牌上下文与权限隔离
- 增加
AdminUser、BrandMembership和角色模型。 - 从 token 与 membership 解析可信当前品牌,不再依赖
DEFAULT_BRAND_ID。 - 所有 Admin 查询、写入、删除强制使用服务端品牌上下文。
- 增加跨品牌越权集成测试。
Phase 3:公开品牌解析与缓存隔离
- 生产环境支持
brandSlug或appId -> brandId解析。 - Runtime Workspace 缓存按品牌和版本隔离。
- 公开接口只返回当前品牌已发布内容。
Phase 4:行业能力扩展
- 在前 3 个阶段通过验收前,不新增行业专属页面。
- 后续行业差异继续通过模板、模块、能力插件和声明式字段表达。
交付门槛
- API integration tests 通过。
- Admin production build 通过。
- 小程序结构和视觉 fixture 通过。
- personal、food、doors 不得出现跨行业文案、字段或业务数据污染。
- 每个完成阶段使用一个完整、可审查的提交收口。