fix: 收口模板契约与安全门禁
统一模板包 visual 契约并补齐完成证据;修复 release 版本一致性、管理员 token 撤销、CORS 与默认品牌配置;收敛依赖安全风险并完成全量回归验证。
This commit is contained in:
1 parent
456171aa85
commit
4f0b50c7f1
84 files changed
+7367
-5180
No files matched your search
@@ -8,7 +8,7 @@
|
||||
|
||||
小程序在 `app.js` 的 `globalData.brandSlug` 中维护唯一品牌身份,优先读取本地配置 `brandSlug`,没有配置时使用开发默认值 `default-brand`。`utils/request.js` 对 `/public/*` 请求统一追加 `brandSlug`,页面和模块不得自行拼接品牌参数。客户和管理接口不追加该参数。
|
||||
|
||||
API 通过 `PublicBrandContextService` 统一解析 `brandSlug`,没有 slug 时保留 `DEFAULT_BRAND_ID` 作为开发 fallback;未知 slug 返回 404。
|
||||
API 通过 `PublicBrandContextService` 统一解析 `brandSlug`;没有 slug 时使用显式配置的 `DEFAULT_BRAND_ID`,该配置缺失时返回 503,不使用硬编码 fallback;未知 slug 返回 404。
|
||||
|
||||
## Alternatives
|
||||
|
||||
|
||||
@@ -10,7 +10,7 @@
|
||||
|
||||
## 决策
|
||||
|
||||
- 所有模板包必须通过唯一的 `TemplatePackageManifest` 契约及其 `runtimeContract` 校验。契约外字段、缺失字段、未知 renderer 或不匹配的行业声明均明确失败,不推断、不静默回退。
|
||||
- 所有模板包必须通过唯一的 `TemplatePackageManifest` 契约及其 `runtimeContract` 校验;`visualPresentation` 是该契约的一部分,承载 description、variants、theme 和 layout。契约外字段、缺失字段、未知 renderer 或不匹配的行业声明均明确失败,不推断、不静默回退。
|
||||
- 品牌当前使用的模板方案必须有明确、持久化的唯一安装记录,并锁定一个已发布的 `TemplatePackageVersion`。package key、版本、视觉 renderer key 和 checksum 只由该版本的 package manifest 与不可变归档确定;数据库不重复存 renderer key。运行时不得从品牌行业、全局默认值或本地注册表推测视觉模板。
|
||||
- 模板 manifest 是模板结构、资源、编辑绑定、能力声明、preview fixture 和 bootstrap sample 的唯一事实来源。删除包外的重复 sample 注册表和 fallback。
|
||||
- `BrandProfile.templateKey` 表示行业模型,不是视觉模板;模板版本选择只由正式安装记录的精确 package version 引用表达。视觉 renderer key 只存在于 package manifest。禁止在 `BrandProfile.config.visualTemplateKey` 或安装/版本表再存一份副本。
|
||||
|
||||
+5
-1
@@ -86,7 +86,11 @@ DEFAULT_BRAND_ID=<production-brand-id>
|
||||
SEED_ADMIN_PASSWORD=<first-boot-admin-password>
|
||||
```
|
||||
|
||||
`DATABASE_URL` 使用最小权限数据库账号。`SESSION_SECRET` 不能复用示例值或开发值。媒体上传使用 S3 兼容对象存储和预签名直传,生产环境必须配置独立的 `OBJECT_STORAGE_PUBLIC_URL`、最小权限访问密钥和专用 bucket。微信相关变量只在启用对应能力时配置,同样不能提交真实凭据。
|
||||
`DATABASE_URL` 使用最小权限数据库账号。`SESSION_SECRET` 不能复用示例值或开发值。`DEFAULT_BRAND_ID` 供未携带 `brandSlug` 的公共请求使用,缺失时 API 返回 503,不会回退到硬编码品牌。
|
||||
|
||||
`CORS_ORIGINS` 默认为空并关闭跨域访问;只有 Admin 或预览应用从其他 origin 调用 API 时,才配置逗号分隔的 HTTPS origin allow-list。
|
||||
|
||||
本次部署会为管理员账号引入 `tokenVersion`。既有 admin token 会因缺少当前版本号而失效,管理员需要重新登录;之后修改密码会立即撤销同一账号的旧 token。媒体上传使用 S3 兼容对象存储和预签名直传,生产环境必须配置独立的 `OBJECT_STORAGE_PUBLIC_URL`、最小权限访问密钥和专用 bucket。微信相关变量只在启用对应能力时配置,同样不能提交真实凭据。
|
||||
|
||||
### 2. 构建发布包
|
||||
|
||||
|
||||
@@ -0,0 +1,33 @@
|
||||
# Security Audit
|
||||
|
||||
最后更新:2026-10-18
|
||||
|
||||
## 结论
|
||||
|
||||
`pnpm audit --prod --registry=https://registry.npmjs.org` 已从 84 条 advisory 降到 0 条未登记 advisory。可直接修复的传递依赖通过根 `pnpm.overrides` 升级到修复版本;`request` 已替换为维护 fork `@cypress/request@4.0.1`。
|
||||
|
||||
## 已执行的兼容性验证
|
||||
|
||||
- `pnpm --filter @personal-brand/api test`
|
||||
- `pnpm --filter @personal-brand/admin build`
|
||||
- `TEMPLATE_KEY=acheng-campus-food pnpm --filter @personal-brand/taro build:h5`
|
||||
- `TEMPLATE_KEY=acheng-campus-food pnpm --filter @personal-brand/taro build:weapp`
|
||||
|
||||
Taro 虽然在 peer dependency 中声明 Vite 4,但 Vite 6.4.3 的 H5 与 Weapp 实际构建均通过。已知 peer warning 记录在安装输出中,不能在未升级 Taro 前移除。
|
||||
|
||||
## 已接受的未修复上游 advisory
|
||||
|
||||
以下 8 条来自 `miniprogram-ci@2.1.31` 的无修复版本依赖。上游当前最新版本仍是 `2.1.31`,没有 patched version。它们在 `pnpm.auditConfig.ignoreGhsas` 中显式登记,避免每次审计重复失败;这不是宣称风险不存在。
|
||||
|
||||
| GHSA | 包 | 风险面 | 当前控制 | 跟进 |
|
||||
| ------------------- | ----------------- | ---------------- | ------------------------------- | ------------------------------------------ |
|
||||
| GHSA-pfq8-rq6v-vf5m | `html-minifier` | 构建期 HTML 压缩 | 仅处理平台生成的受信模板产物 | 升级 `miniprogram-ci` 或替换构建器 |
|
||||
| GHSA-35jh-r3h4-6jhm | `lodash.template` | 构建期模板编译 | 仅处理平台生成的受信模板产物 | 升级 `miniprogram-ci` |
|
||||
| GHSA-67hx-6x53-jw92 | `babel-traverse` | Babel 6 构建路径 | 仅处理平台生成的受信模板产物 | 升级 `miniprogram-ci` 或替换 Babel 6 链路 |
|
||||
| GHSA-mp2f-45pm-3cg9 | `decompress` | 下载包解压 | 未把用户上传 archive 交给该链路 | 升级 `miniprogram-ci` 或移除 download 链路 |
|
||||
| GHSA-h39j-r5qq-r9mm | `decompress` | 下载包解压 | 同上 | 同上 |
|
||||
| GHSA-jwp9-9v96-94mx | `decompress` | 下载包解压 | 同上 | 同上 |
|
||||
| GHSA-hrh2-vp3x-79xf | `decompress` | 下载包解压 | 同上 | 同上 |
|
||||
| GHSA-vfj7-8cjw-p6xm | `braces` | 构建期 glob 匹配 | 仅匹配平台生成的受信文件 | 升级 `miniprogram-ci` |
|
||||
|
||||
负责人:平台维护者。跟进条件:`miniprogram-ci` 发布包含上述依赖修复的新版本,或将小程序上传 worker 独立部署并移除 API 生产依赖。
|
||||
@@ -30,6 +30,8 @@ staticStatus 只代表支持范围内的静态检查。completionStatus 保持 u
|
||||
|
||||
已逐条完成源码审阅的 review 可登记在 `.codex-tasks/template-audit-execution/raw/manual-review.json`。登记必须使用和诊断报告一致的 `file/page/target/binding/line/message`,并保留结论与证据;doctor 只把精确匹配的 review 标记为 `source-reviewed`,不改变 `completionStatus`。未匹配的新 review 和全部 blocker 仍会让命令失败。
|
||||
|
||||
完成证据登记在 `.codex-tasks/template-audit-execution/raw/completion-evidence.json`。每套模板必须提供 `real-manifest-interaction`、`save-reload-publish-isolation`、`visual-reference`、`empty-error-branches` 四类 `passed` 证据;每类证据必须包含实际命令、日志或截图产物及其 SHA-256。doctor 会校验证据覆盖全部模板、产物存在且哈希一致。全部通过时 `completionStatus=complete`;证据文件缺失时保持 `unverified`;登记不完整或哈希不匹配时对应模板为 `incomplete` 并让命令失败。
|
||||
|
||||
AST 解析可追踪 workspace.brand、presentation、object 和局部别名。动态路径、跨组件和间接映射等未知情况标为 review,不能猜测为通过。诊断器包含正反故障注入测试。
|
||||
|
||||
## 修复闭环
|
||||
|
||||
@@ -14,9 +14,9 @@
|
||||
|
||||
### 仓库内视觉模板包
|
||||
|
||||
- acheng-campus-food@1.0.2:餐饮场景,使用 food 行业能力。
|
||||
- acheng-campus-food@1.0.3:餐饮场景,使用 food 行业能力。
|
||||
- linjing-editorial@1.0.4:林境建筑画册,可用于 doors 和 personal 组合。
|
||||
- atelier-solopreneur@1.3.1:独立工坊方向,适配 personal 行业。
|
||||
- atelier-solopreneur@1.3.2:独立工坊方向,适配 personal 行业。
|
||||
|
||||
以上是仓库盘点,不表示三个包都已经通过线上导入、预览、品牌安装和微信上传验收。生成目录当前位于 packages/config/src/generated-template-packages.ts,后续必须由导出和 conformance 流程生成并校验。
|
||||
|
||||
|
||||
Reference in new issue
Block a user