feat: 建立小程序品牌运行时上下文
This commit is contained in:
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 存在且与目标品牌匹配。
|
||||
Reference in new issue
Block a user