Files
persionalBrand/docs/adr/0007-miniapp-brand-runtime-context.md
que01 4f0b50c7f1 fix: 收口模板契约与安全门禁
统一模板包 visual 契约并补齐完成证据;修复 release 版本一致性、管理员 token 撤销、CORS 与默认品牌配置;收敛依赖安全风险并完成全量回归验证。
2026-10-18 22:05:31 +08:00

28 lines
1.6 KiB
Markdown

# 0007 小程序品牌运行时上下文
## Context
平台支持多个独立品牌,但小程序页面此前直接请求公共 API,默认依赖服务端 `DEFAULT_BRAND_ID`。同一套小程序代码切换品牌时,存在首页、业务列表和信任内容来自不同品牌的风险。
## Decision
小程序在 `app.js` 的 `globalData.brandSlug` 中维护唯一品牌身份,优先读取本地配置 `brandSlug`,没有配置时使用开发默认值 `default-brand`。`utils/request.js` 对 `/public/*` 请求统一追加 `brandSlug`,页面和模块不得自行拼接品牌参数。客户和管理接口不追加该参数。
API 通过 `PublicBrandContextService` 统一解析 `brandSlug`;没有 slug 时使用显式配置的 `DEFAULT_BRAND_ID`,该配置缺失时返回 503,不使用硬编码 fallback;未知 slug 返回 404。
## Alternatives
- 让每个页面手动拼接 `brandSlug`:容易遗漏,无法保证一致性。
- 只依赖 API 默认品牌:无法支持同一代码包服务多个品牌。
- 通过域名解析品牌:适合生产部署,但当前小程序开发和预览环境仍需要显式配置,后续可作为解析器的新增来源。
## Consequences
- 同一小程序代码可以通过运行时配置切换品牌内容和模板。
- 公共请求具有统一、可测试的品牌边界。
- 生产发布需要为每个小程序实例配置正确的 `brandSlug`,不能继续依赖默认值。
## Migration Plan
后续将把 `brandSlug` 从本地 storage 配置提升为构建环境或远程启动配置,并在发布检查中验证品牌 slug 存在且与目标品牌匹配。