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

@@ -14,3 +14,4 @@
- 下一步:运行全量门禁,记录根级检查结果并完成提交。
- 全量门禁已通过:`format:check`、`lint`、`typecheck`、Admin build、Miniapp fixture/visual fixture、API integration `28/28`。
- API lint 保留 6 个既有测试文件 `any` warning,无 error。
- 小程序运行时已从唯一配置读取 `brandSlug`,公共请求层统一注入品牌上下文;客户和管理请求不会误带公共品牌参数。
+2
View File
@@ -1,9 +1,11 @@
const DEFAULT_API_BASE_URL = "http://172.16.6.123:3001";
const DEFAULT_BRAND_SLUG = "default-brand";
App({
onLaunch() {
this.globalData = {
apiBaseUrl: wx.getStorageSync("apiBaseUrl") || DEFAULT_API_BASE_URL,
brandSlug: wx.getStorageSync("brandSlug") || DEFAULT_BRAND_SLUG,
brand: {},
};
},
+10
View File
@@ -1,6 +1,16 @@
const fs = require("node:fs");
const path = require("node:path");
const root = path.resolve(__dirname, "..");
const requestSource = fs.readFileSync(path.join(root, "utils/request.js"), "utf8");
const configSource = fs.readFileSync(path.join(root, "utils/config.js"), "utf8");
if (
!requestSource.includes('path.startsWith("/public/")') ||
!requestSource.includes("brandSlug") ||
!configSource.includes("brandSlug")
) {
console.error("miniapp: public requests must carry the configured brand slug");
process.exit(1);
}
const fixtureFiles = ["linjing-door.json", "minimal-neutral.json", "doors-industry.json"];
const fixtures = fixtureFiles.map((file) =>
JSON.parse(fs.readFileSync(path.join(__dirname, "fixtures", file), "utf8")),
+3
View File
@@ -7,4 +7,7 @@ module.exports = {
get brand() {
return app.globalData.brand || {};
},
get brandSlug() {
return app.globalData.brandSlug || "default-brand";
},
};
+8 -1
View File
@@ -1,9 +1,16 @@
const config = require("./config");
function withBrandContext(path, options) {
if (options.includeBrand === false || !path.startsWith("/public/")) return path;
const separator = path.includes("?") ? "&" : "?";
return path + separator + "brandSlug=" + encodeURIComponent(config.brandSlug);
}
function request(path, options = {}) {
return new Promise((resolve, reject) => {
const requestPath = withBrandContext(path, options);
wx.request({
url: config.apiBaseUrl + path,
url: config.apiBaseUrl + requestPath,
method: options.method || "GET",
header: { accept: "application/json", ...(options.header || {}) },
...(options.data === undefined ? {} : { data: options.data }),
@@ -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 存在且与目标品牌匹配。