统一模板包 visual 契约并补齐完成证据;修复 release 版本一致性、管理员 token 撤销、CORS 与默认品牌配置;收敛依赖安全风险并完成全量回归验证。
1.6 KiB
1.6 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,该配置缺失时返回 503,不使用硬编码 fallback;未知 slug 返回 404。
Alternatives
- 让每个页面手动拼接
brandSlug:容易遗漏,无法保证一致性。 - 只依赖 API 默认品牌:无法支持同一代码包服务多个品牌。
- 通过域名解析品牌:适合生产部署,但当前小程序开发和预览环境仍需要显式配置,后续可作为解析器的新增来源。
Consequences
- 同一小程序代码可以通过运行时配置切换品牌内容和模板。
- 公共请求具有统一、可测试的品牌边界。
- 生产发布需要为每个小程序实例配置正确的
brandSlug,不能继续依赖默认值。
Migration Plan
后续将把 brandSlug 从本地 storage 配置提升为构建环境或远程启动配置,并在发布检查中验证品牌 slug 存在且与目标品牌匹配。