# Project Status 最后更新:2026-10-21 ## 当前阶段 系统已从“餐饮试点小程序”演进为多模板个人品牌平台。当前已完成统一模板契约收口、模板完成证据门禁、品牌与页面方案拆分、管理员登录态撤销和 release 版本一致性修复。 ADR 0033 已落地: - “表达方式”已从 Admin 源码移除。 - “业务类型”和“页面方案”是两个独立概念。 - 新增“创建品牌”和“页面方案”页面。 - 创建品牌不会自动导入示例内容。 - `linjing-editorial` 只兼容 `doors`,不再兼容 `personal`。 ## 当前能力 - NestJS + Fastify API、Prisma PostgreSQL、全局 DTO 校验、统一错误响应和 `requestId`。 - 多品牌 Admin、品牌 membership、角色边界、品牌切换和品牌隔离。 - 创建品牌时按业务类型筛选兼容的页面方案;不兼容组合无法提交。 - 模板包发现、确定性打包、导入、校验、发布、预览、安装、升级和回滚。 - 三套已交付模板及其业务类型: - `acheng-campus-food@1.0.3`:`food` - `atelier-solopreneur@1.3.2`:`personal` - `linjing-editorial@1.0.7`:`doors` - Taro Runtime、Admin 组件预览、真实 manifest 驱动编辑、草稿/发布隔离。 - 发布备注为可选字段;空备注不会写入数据库,也不影响发布、回滚和公开内容。 - 依赖 override 的运行时兼容性通过 `miniprogram-ci` / Jimp / image-size / uuid smoke test 守卫。 - 小程序构建、上传任务状态机、attempt lease 和失败记录。 - Admin/Customer token version:修改 admin 密码或调用 logout 后旧 token 立即失效;无 membership 的账号不会自动获得 owner 权限。 - `visualPresentation` 已进入唯一 `template.json` 契约,旧手写 visual manifest 优先路径已删除。 ## 生产状态 当前生产 release: ```text 20261021013244-6df4e1d72b6a ``` 生产健康检查: ```text api=online pm2-autostart=enabled admin=active database=running backups=7 /admin/ 200 /template-preview/ 200 /api/health 200 /media/seed/food-package-02.jpg 200 ``` 生产数据库已应用全部 48 个 Prisma migration,schema 为 up to date。 三个生产品牌的当前发布快照: | 品牌 | 业务类型 | 页面方案 | 发布版本 | | ---------------- | ---------- | --------------------------- | ------------ | | `atelier-studio` | `personal` | `atelier-solopreneur@1.3.2` | `v2 current` | | `default-brand` | `food` | `acheng-campus-food@1.0.3` | `v2 current` | | `linjing-doors` | `doors` | `linjing-editorial@1.0.7` | `v3 current` | ## 完成证据 `.codex-tasks/template-audit-execution/raw/completion-evidence.json` 登记四类证据: - `real-manifest-interaction` - `save-reload-publish-isolation` - `visual-reference` - `empty-error-branches` 每条证据保留执行命令、日志和产物 SHA-256。`pnpm template:doctor` 会校验证据覆盖和哈希;当前三套模板均为: ```text staticStatus=pass completionStatus=complete unresolvedIssues=0 ``` Admin 浏览器回归新增 `apps/taro/test/browser/brand-creation-and-page-scheme.spec.ts`,覆盖: - 创建品牌时按业务类型筛选页面方案。 - `personal` 不出现林境页面方案。 - 切换业务类型后清除不兼容的页面方案选择,提交按钮禁用。 - 创建失败时保留用户输入并显示错误。 - 页面方案切换和升级提交正确版本、校验和与冲突保留参数。 - 操作成功后刷新工作区、页面方案选项和升级预览查询。 ## 已验证门禁 - `pnpm check` - `pnpm validate:template-release` - `pnpm --filter @personal-brand/api test` - `pnpm --filter @personal-brand/api test:integration` - `miniprogram-ci` override 兼容 smoke test - `pnpm test:api-client` - `pnpm test:deploy` - `pnpm --filter @personal-brand/admin typecheck` - `pnpm --filter @personal-brand/admin lint` - `pnpm --filter @personal-brand/admin test` - `pnpm --filter @personal-brand/admin build` - `pnpm build` - `pnpm template:doctor` - Playwright: - `brand-creation-and-page-scheme.spec.ts` - `template-preview-media.spec.ts` - `admin-editor.spec.ts` 发布脚本的 Node 版本门禁已提前到所有构建之前。Node 22 下执行 `pnpm deploy:release` 会立即失败,并给出 Node.js 24 要求提示,不再先执行一轮无用构建。 ## 安全审计 - `pnpm audit --prod --registry=https://registry.npmjs.org` 已完成。 - 可修复 advisory 已通过 `pnpm.overrides` 收敛;`request` 替换为 `@cypress/request@4.0.1`。 - 剩余 8 条为 `miniprogram-ci@2.1.31` 无修复版本的上游 advisory,已在 `pnpm.auditConfig.ignoreGhsas` 和 `docs/security-audit.md` 中显式登记风险、控制措施与跟进条件。 - Taro 官方 peer 仍声明 Vite 4;当前使用 Vite 6.4.3,H5 与 Weapp 实际构建均通过,peer warning 记录在安全审计文档。 ## 未决事项 - 本次源码新增的 Admin 浏览器回归、页面方案查询缓存修复和 Node 门禁修复尚未部署到生产;部署后需更新本节的生产 release 和验证结果。 - `miniprogram-ci` 上游发布修复版本后,需要移除对应的 audit ignore、风险登记和本地 patch。 - Gitea SSH 直连仍受 OCI 安全列表限制;当前本机通过 `oracle_arm` ProxyCommand 转发访问,不阻塞业务。 - CI 已加入 audit 和三套模板矩阵构建;后续可继续拆分更细粒度的 smoke/visual matrix。