feat: 建立小程序品牌运行时上下文

This commit is contained in:
que01 committed 2026-09-23 13:31:08 +08:00
1 parent dcb40f629b
commit f7fe6d6b20
6 files changed
+51 -1

No files matched your search

@@ -0,0 +1,27 @@
# 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` 作为开发 fallback;未知 slug 返回 404。
## Alternatives
- 让每个页面手动拼接 `brandSlug`:容易遗漏,无法保证一致性。
- 只依赖 API 默认品牌:无法支持同一代码包服务多个品牌。
- 通过域名解析品牌:适合生产部署,但当前小程序开发和预览环境仍需要显式配置,后续可作为解析器的新增来源。
## Consequences
- 同一小程序代码可以通过运行时配置切换品牌内容和模板。
- 公共请求具有统一、可测试的品牌边界。
- 生产发布需要为每个小程序实例配置正确的 `brandSlug`,不能继续依赖默认值。
## Migration Plan
后续将把 `brandSlug` 从本地 storage 配置提升为构建环境或远程启动配置,并在发布检查中验证品牌 slug 存在且与目标品牌匹配。