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 / Taro builds (atelier-solopreneur) (push) Has been cancelled
CI / Taro builds (linjing-editorial) (push) Has been cancelled
CI / Browser regression (push) Has been cancelled
165 lines
8.3 KiB
Markdown
165 lines
8.3 KiB
Markdown
# 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
|
||
20261021030406-737010ea0392
|
||
```
|
||
|
||
该 release 由提交 `737010e` 构建,包含创建品牌与页面方案的交互修复、发布流程浏览器回归、小程序配置表单实例修复、前置的 Node 24 版本门禁、Ant Design 6 弃用项收口,Admin 渲染错误边界,以及后台外壳的异常数据容忍。部署后已完成公开路由健康检查、三个品牌公开接口和发布快照核对。
|
||
|
||
生产健康检查:
|
||
|
||
```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` 不出现林境页面方案。
|
||
- 切换业务类型后清除不兼容的页面方案选择,提交按钮禁用。
|
||
- 创建失败时保留用户输入并显示错误。
|
||
- 页面方案切换和升级提交正确版本、校验和与冲突保留参数。
|
||
- 操作成功后刷新工作区、页面方案选项和升级预览查询。
|
||
|
||
`apps/taro/test/browser/publication-release.spec.ts` 覆盖内容与发布流程:
|
||
|
||
- 发布按钮按 readiness 启用;空备注发布提交空 body,不写入 `note`。
|
||
- 备注提交前去除首尾空格。
|
||
- 发布失败时保留备注与确认弹窗,并显示服务端错误。
|
||
- 撤回当前版本、恢复历史版本分别提交正确路径与版本号。
|
||
- 小程序配置页从服务端回填设置,只提交用户新输入的私钥。
|
||
|
||
该回归同时发现并修复了 `MiniAppSettingsTab` 的 `Form` 实例归属问题:表单实例原本在父组件创建、子组件懒挂载,触发 antd `useForm` 未连接警告;现已下沉到配置页自身。
|
||
|
||
## Admin 渲染错误边界
|
||
|
||
后台此前没有任何 React error boundary:任一页面在渲染阶段抛错(例如接口返回了形状不符的数据)都会导致整页白屏,用户只能从控制台看到堆栈。现在按两级兜底:
|
||
|
||
- `Root` 上的整页边界:后台外壳自身渲染失败时显示错误页,提供「重新加载页面」和「返回概览」。
|
||
- `Dashboard` 内容区的页面边界:单个业务页面失败时保留侧边栏与顶部导航,提供「重试」和「重新加载页面」,切换路由后自动复位。
|
||
- 错误页展示可复制的错误编号,日志侧输出同一编号、堆栈与组件栈,便于把用户反馈和服务器日志对应起来。
|
||
- 开发环境额外显示原始错误信息;生产环境不暴露堆栈。
|
||
|
||
外壳数据不再直接信任接口形状:`apps/admin/src/lib/brand-switcher.ts` 只接受完整成员记录,跳过异常条目并对重复品牌、缺失名称和非字符串品牌名做稳定收敛,避免单条脏数据让整个后台外壳崩溃。错误边界只作为最后一道防线。
|
||
|
||
`apps/taro/test/browser/admin-error-boundary.spec.ts` 覆盖:
|
||
|
||
- 品牌成员与品牌名称返回异常结构时,后台外壳仍正常渲染。
|
||
- 业务页面数据异常时保留导航,重试仍失败保持错误页,重新加载后恢复。
|
||
|
||
`apps/admin/test/brand-switcher.test.mjs` 覆盖选项转换的异常条目、非数组、重复品牌、缺失名称与非字符串名称。
|
||
|
||
## 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`
|
||
- `publication-release.spec.ts`
|
||
- `admin-error-boundary.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 记录在安全审计文档。
|
||
|
||
## 未决事项
|
||
|
||
- `miniprogram-ci` 上游发布修复版本后,需要移除对应的 audit ignore、风险登记和本地 patch。
|
||
- Gitea SSH 直连仍受 OCI 安全列表限制;当前本机通过 `oracle_arm` ProxyCommand 转发访问,不阻塞业务。
|
||
- CI 已加入 audit 和三套模板矩阵构建;后续可继续拆分更细粒度的 smoke/visual matrix。
|