Files
persionalBrand/docs/adr/0007-miniapp-brand-runtime-context.md

1.5 KiB

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 存在且与目标品牌匹配。