# 品牌运行时与多品牌隔离推进计划 ## 目标 个人品牌是产品主线,行业模板、视觉模板和能力插件都必须在品牌隔离的运行时上下文中工作。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 不得出现跨行业文案、字段或业务数据污染。 - 每个完成阶段使用一个完整、可审查的提交收口。