Files
persionalBrand/PROJECT_STATUS.md
T
que01 8c5860699f
CI / Taro builds (atelier-solopreneur) (push) Has been cancelled
CI / Taro builds (linjing-editorial) (push) Has been cancelled
CI / Static checks (push) Has been cancelled
CI / Production build (push) Has been cancelled
CI / API integration (push) Has been cancelled
CI / Taro builds (acheng-campus-food) (push) Has been cancelled
CI / Browser regression (push) Has been cancelled
docs: 更新生产发布状态
2026-10-21 10:37:36 +08:00

6.2 KiB
Raw Blame History

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:

20261021023448-06619a191f70

该 release 由提交 06619a1 构建,包含创建品牌与页面方案的交互修复、浏览器回归用例、前置的 Node 24 版本门禁,以及 Ant Design 6 弃用项收口。部署后已完成公开路由健康检查和三个品牌发布快照核对。

生产健康检查:

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 会校验证据覆盖和哈希;当前三套模板均为:

staticStatus=pass
completionStatus=complete
unresolvedIssues=0

Admin 浏览器回归新增 apps/taro/test/browser/brand-creation-and-page-scheme.spec.ts,覆盖:

  • 创建品牌时按业务类型筛选页面方案。
  • personal 不出现林境页面方案。
  • 切换业务类型后清除不兼容的页面方案选择,提交按钮禁用。
  • 创建失败时保留用户输入并显示错误。
  • 页面方案切换和升级提交正确版本、校验和与冲突保留参数。
  • 操作成功后刷新工作区、页面方案选项和升级预览查询。

Ant Design 6 弃用项

  • Alert 统一使用 title,Space 统一使用 orientation。
  • 提示与确认框改为 App.useApp() 实例,删除静态 message 转出口 components/AdminMessage.ts。
  • apps/admin/test/antd-deprecations.test.mjs 作为静态门禁,阻止静态 message、Modal.confirm、Alert.message、Space.direction 回流。
  • List 仍保留:Listy 是虚拟滚动组件,API 不兼容,当前仅用于小数据量场景;已记录在 docs/adr/0034-antd6-static-api-and-list.md,升级 Ant Design 7 前重新评估。

已验证门禁

  • 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。