Files
persionalBrand/docs/brand-runtime-multitenancy-plan.md
T

2.3 KiB

品牌运行时与多品牌隔离推进计划

目标

个人品牌是产品主线,行业模板、视觉模板和能力插件都必须在品牌隔离的运行时上下文中工作。Admin 与小程序不得维护第二套实时品牌数据。

当前结论

  • 数据模型已经普遍包含 brandId,但 Admin 运行时仍依赖 DEFAULT_BRAND_ID,当前属于单品牌运行模式。
  • BrandProfile 及其品牌业务表应是实时品牌内容的唯一来源。
  • BrandTemplateInstallation.configSnapshot 仅用于模板版本、升级和回滚,不得覆盖实时品牌内容。
  • RuntimeWorkspace 是 Admin 和小程序统一消费的读取契约。
  • 小程序静态数据只能作为按模板选择的离线 fallback,不能覆盖成功的 API 返回。

阶段

Phase 1:统一品牌运行时数据

  • Admin 页面统一通过 /admin/workspace 获取运行时数据。
  • 小程序页面移除直接读取行业静态数据的路径。
  • fallback 按 personal、food、doors 模板拆分。
  • 页面不再直接读取 linjing-data.js 作为实时业务来源。
  • /public/workspace 返回已发布信任内容,供 Admin 与小程序统一消费。
  • 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 不得出现跨行业文案、字段或业务数据污染。
  • 每个完成阶段使用一个完整、可审查的提交收口。