feat: 收口多品牌与模板构建基础

This commit is contained in:
que01 committed 2026-09-25 02:55:46 +08:00
1 parent 0425a1c672
commit 77224ea51f
317 files changed
+11290 -1158

No files matched your search

@@ -0,0 +1,16 @@
# 进度
- 任务:阿成校园餐导航与咨询还原
- 形态:single-full
- 进度:3/3
- 当前:已完成阿成五入口导航、出摊服务页和餐饮咨询入口。
- 真相文件:`TODO.csv`
## 完成记录
- 固定微信 `tabBar` 已移除,改为 Runtime Workspace 驱动的 `runtime-tab-bar`。
- 阿成模板入口:首页/摊位、套餐餐品、出摊服务、主理人、定制/咨询。
- 林境模板入口:首页、案例与体系、主理人与我。
- `定制/咨询` 使用既有动态咨询表单和提交 API;未复制原型 mock 数据。
- 新增 `pages/stall-service/index`,展示出摊地址、取餐配送和定制流程。
- `typecheck`、Mini Program fixture、visual fixture 已通过。
@@ -0,0 +1,17 @@
# 阿成校园餐导航与咨询还原
## 目标
将阿成校园餐从林境的三 Tab 外壳中拆出,恢复原型的五个入口,并让定制咨询使用餐饮视觉而不是通用下单页。
## 边界
- 使用 Runtime Workspace 的视觉模板、品牌和咨询表单数据。
- 微信原生 Tab 配置静态,使用 custom tab bar 完成模板运行时导航差异。
- 不引入原型 mock 菜品、预约记录或文案作为生产数据。
## 验收
- 阿成模板显示首页/摊位、套餐餐品、出摊服务、主理人、定制/咨询五个入口。
- 林境模板保留三个对应入口,不显示餐饮专用入口。
- 阿成定制咨询页使用独立 renderer 并提交既有动态咨询 API。
@@ -0,0 +1,4 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,建立模板驱动的自定义导航,DONE,阿成五入口和林境三入口根据 Runtime Workspace 切换,pnpm --filter @personal-brand/miniapp test:fixture,已移除固定 tabBar,新增 runtime-tab-bar,0,
2,实现出摊服务与餐饮咨询 renderer,DONE,出摊服务和定制咨询不再回退到通用林境页面,pnpm --filter @personal-brand/miniapp test:visual-fixture,新增出摊服务页,定制/咨询接入动态表单,0,
3,补充回归样例并完成验证,DONE,导航和咨询 renderer 具备自动回归检查,pnpm typecheck,JSON、typecheck、fixture、visual fixture 全部通过,0,
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 建立模板驱动的自定义导航 DONE 阿成五入口和林境三入口根据 Runtime Workspace 切换 pnpm --filter @personal-brand/miniapp test:fixture 已移除固定 tabBar,新增 runtime-tab-bar 0
3 2 实现出摊服务与餐饮咨询 renderer DONE 出摊服务和定制咨询不再回退到通用林境页面 pnpm --filter @personal-brand/miniapp test:visual-fixture 新增出摊服务页,定制/咨询接入动态表单 0
4 3 补充回归样例并完成验证 DONE 导航和咨询 renderer 具备自动回归检查 pnpm typecheck JSON、typecheck、fixture、visual fixture 全部通过 0
@@ -0,0 +1,13 @@
# 管理员账号使用闭环
## 目标
让手动添加的品牌成员可以安全完成首次登录和密码更新,并让 `editor` 在后台只看到自己有权限使用的功能。
## 规则
- 手动创建成员时标记 `mustChangePassword`。
- 登录响应返回当前成员角色和是否需要改密。
- 首次改密必须校验初始密码,成功后清除标记。
- `editor` 隐藏系统管理菜单,直接访问系统管理路由回到概览页。
- 密码只保存 hash,不返回或记录明文。
@@ -0,0 +1,23 @@
# 进度
- 任务:管理员账号使用闭环
- 形态:epic
- 进度:3/3
- 当前:账号使用闭环已完成,下一步进行多品牌真实初始化验收。
## 已完成
- `AdminUser.mustChangePassword` 字段和 Prisma migration 已添加。
- 新增 `POST /admin/session/change-password`。
- 登录响应包含 `role` 和 `mustChangePassword`。
- 手动添加成员自动标记首次改密。
- 后台首次登录改密页面已接入。
- `editor` 隐藏系统管理菜单,直接访问系统管理路由会回到概览。
## 验证
- `pnpm typecheck`:通过。
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm format:check`:通过。
- `pnpm --filter @personal-brand/api exec prisma migrate deploy`:已成功应用,`mustChangePassword` 字段已确认落库。
- `pnpm --filter @personal-brand/api test:integration`:34/34 通过。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,增加首次改密状态和 API,single-full,,DONE,tasks/password-api,手动成员必须改密且密码 hash 存储,pnpm typecheck,新增 schema 字段、迁移和 change-password API
2,接入后台首次改密与角色菜单,single-full,1,DONE,tasks/password-ui,editor 隐藏系统管理并显示改密页面,pnpm --filter @personal-brand/admin build,登录响应持久化角色和改密状态
3,补齐回归测试与交付记录,single-full,1;2,DONE,tasks/regression,登录、改密、编辑者路由和迁移均有验证,pnpm --filter @personal-brand/api test:integration,Prisma migration 已落库,API integration 34/34 通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 增加首次改密状态和 API single-full DONE tasks/password-api 手动成员必须改密且密码 hash 存储 pnpm typecheck 新增 schema 字段、迁移和 change-password API
3 2 接入后台首次改密与角色菜单 single-full 1 DONE tasks/password-ui editor 隐藏系统管理并显示改密页面 pnpm --filter @personal-brand/admin build 登录响应持久化角色和改密状态
4 3 补齐回归测试与交付记录 single-full 1;2 DONE tasks/regression 登录、改密、编辑者路由和迁移均有验证 pnpm --filter @personal-brand/api test:integration Prisma migration 已落库,API integration 34/34 通过
@@ -0,0 +1,13 @@
# 后台信息架构分层
## 目标
让普通品牌使用者优先看到日常经营配置,将模板、能力和字段等系统级设置收纳到独立的系统管理分组。
## 当前边界
当前登录身份统一为 `admin`,还没有品牌运营者与平台管理员的真实权限模型。因此本轮只调整导航信息架构,不宣称完成 API 权限隔离。
## 后续
建立明确的 membership role 权限矩阵后,再在路由和 API 层执行真正的访问控制。
@@ -0,0 +1,18 @@
# 进度
- 任务:后台信息架构分层
- 形态:epic
- 进度:3/3
- 当前:导航分组已完成;真实角色权限作为后续独立任务。
## 已完成
- “日常经营”:品牌表达、信任内容、业务提供项、咨询记录。
- “系统管理”:模板与设置、能力插件。
- 保留现有路由和 API,不引入假权限。
## 验证
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm typecheck`:通过。
- `pnpm format:check`:通过。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,分组后台导航,single-full,,DONE,tasks/navigation,日常经营与系统管理分组清晰,pnpm --filter @personal-brand/admin build,已完成导航分组
2,验证前端构建与类型,single-full,1,DONE,tasks/validation,构建和类型检查通过,pnpm format:check && pnpm typecheck,已通过
3,记录权限边界,single-full,1;2,DONE,tasks/delivery,明确导航分组不等于 API 权限隔离,pnpm --filter @personal-brand/admin build,已记录
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 分组后台导航 single-full DONE tasks/navigation 日常经营与系统管理分组清晰 pnpm --filter @personal-brand/admin build 已完成导航分组
3 2 验证前端构建与类型 single-full 1 DONE tasks/validation 构建和类型检查通过 pnpm format:check && pnpm typecheck 已通过
4 3 记录权限边界 single-full 1;2 DONE tasks/delivery 明确导航分组不等于 API 权限隔离 pnpm --filter @personal-brand/admin build 已记录
@@ -0,0 +1,50 @@
# 品牌友好内容工作台与模板契约增强
## 目标
- 让品牌管理员以通俗业务语言配置自己的品牌介绍、图片、业务提供项、案例、咨询问题和发布内容。
- 让视觉模板保持页面结构、交互和视觉表达的自由,不依赖公共视觉组件兜底。
- 建立稳定的模板数据、资产、字段语义和发布校验契约,支持未来大量独立模板 package。
## 非目标
- 不实现小程序运行时下载或执行模板代码。
- 不在本 Epic 新增第三个行业模板。
- 不让品牌用户直接编辑 JSON、schemaKey、renderer、capability 或模板版本。
## 约束
- 继续使用 NestJS、Prisma、React Admin、微信小程序和 pnpm workspace。
- 后端只提供稳定业务事实、状态和能力;模板负责视觉和交互表达。
- 所有受保护 API 必须覆盖未授权、错误角色和成功路径的自动化测试。
- 品牌隔离必须由服务端当前会话/品牌上下文决定,不能信任客户端 brandId。
- 新增或修改发布数据必须进入 immutable release snapshot。
## 风险
- RuntimeWorkspace 契约变更可能影响 Admin、小程序和已有模板,必须用双模板 fixture 回归。
- 数据库与快照结构变更需要 migration、seed、发布流程和 API 测试同步更新。
- “通俗易懂”的配置文案是模板定义的一部分,不能通过通用技术字段勉强复用。
## 子任务
1. 增强 Template Contract:数据槽位、资产槽位、字段语义、导航和 Admin 编辑声明。
2. 完整 RuntimeWorkspace Projection:稳定输出导航、展示属性、资产和模板适配状态。
3. 发布前模板适配校验与快照:阻止缺少关键内容、图片或表单的发布。
4. 品牌友好 Admin 内容工作台:按模板 Admin manifest 渲染业务化编辑界面。
5. 双模板端到端回归:阿成与林境的品牌隔离、发布、数据槽位和小程序构建验收。
## 依赖
- 任务 2 依赖任务 1。
- 任务 3 依赖任务 1 和 2。
- 任务 4 依赖任务 1、2 和 3。
- 任务 5 依赖任务 1 至 4。
## 完成条件
- [ ] 所有 `SUBTASKS.csv` 行为 `DONE`。
- [ ] 两个模板均可由品牌管理员通过通俗编辑界面完成配置并发布。
- [ ] 发布时能以可行动提示阻止模板必需内容缺失。
- [ ] RuntimeWorkspace 不丢失模板已声明的展示字段。
- [ ] API、Admin build、模板编译和双模板 fixture 回归通过。
@@ -0,0 +1,16 @@
# 进度
- 任务:品牌友好内容工作台与模板契约增强
- 形态:epic
- 进度:0/5
- 当前:任务已建立,等待从模板与 Admin 内容契约开始实施。
- 真相文件:`SUBTASKS.csv`
## Context Recovery Block
- 当前子任务:#1 模板与 Admin 内容契约
- 当前状态:TODO
- 已完成:无
- 关键背景:阿成和林境静态视觉验收通过,但 RuntimeWorkspace、发布校验和 Admin 编辑仍不足以支撑大量差异化模板。
- 已知问题:后端导航存在固定结构痕迹;offering projection 可能丢失展示属性;公共视觉页面不应再作为模板兜底。
- 下一步:审计现有模板 manifest、Admin 配置页面和发布服务,定义最小的 Template Admin Contract。
@@ -0,0 +1,6 @@
id,task,task_type,status,depends_on,task_dir,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,模板与 Admin 内容契约,single-full,TODO,,tasks/template-admin-contract,manifest 声明数据槽位资产槽位字段语义和通俗编辑文案,pnpm --filter @personal-brand/template-contract typecheck,,0,不引入模板专属后端 if else
2,RuntimeWorkspace 完整投影,single-full,TODO,1,tasks/runtime-workspace-projection,导航和 offering presentation/assets 完整且品牌隔离,pnpm --filter @personal-brand/api test:integration,,0,不得丢弃模板声明字段
3,发布模板适配校验,single-full,TODO,1;2,tasks/publication-compatibility,发布前给出可行动缺失提示并写入快照,pnpm --filter @personal-brand/api test:integration,,0,覆盖缺图缺字段缺表单场景
4,品牌友好内容工作台,single-full,TODO,1;2;3,tasks/brand-content-workbench,普通品牌管理员可按业务语言配置并发布,pnpm --filter @personal-brand/admin build,,0,不暴露 JSON schema renderer capability
5,双模板回归与验收,single-full,TODO,1;2;3;4,tasks/template-e2e-regression,阿成和林境品牌数据与模板产物均正确,pnpm test:template-compiler,,0,包含发布快照和品牌隔离回归
1 id task task_type status depends_on task_dir acceptance_criteria validation_command completed_at retry_count notes
2 1 模板与 Admin 内容契约 single-full TODO tasks/template-admin-contract manifest 声明数据槽位资产槽位字段语义和通俗编辑文案 pnpm --filter @personal-brand/template-contract typecheck 0 不引入模板专属后端 if else
3 2 RuntimeWorkspace 完整投影 single-full TODO 1 tasks/runtime-workspace-projection 导航和 offering presentation/assets 完整且品牌隔离 pnpm --filter @personal-brand/api test:integration 0 不得丢弃模板声明字段
4 3 发布模板适配校验 single-full TODO 1;2 tasks/publication-compatibility 发布前给出可行动缺失提示并写入快照 pnpm --filter @personal-brand/api test:integration 0 覆盖缺图缺字段缺表单场景
5 4 品牌友好内容工作台 single-full TODO 1;2;3 tasks/brand-content-workbench 普通品牌管理员可按业务语言配置并发布 pnpm --filter @personal-brand/admin build 0 不暴露 JSON schema renderer capability
6 5 双模板回归与验收 single-full TODO 1;2;3;4 tasks/template-e2e-regression 阿成和林境品牌数据与模板产物均正确 pnpm test:template-compiler 0 包含发布快照和品牌隔离回归
@@ -0,0 +1,29 @@
# 品牌发布生命周期 Epic
## 目标
建立多品牌、模板驱动的草稿与发布边界,使普通用户可以完成首次配置、预览、发布和回滚,并让小程序只展示已发布内容。
## 范围
- 品牌发布版本模型、快照生成和可逆迁移;
- 发布、撤回、回滚 API 及授权、校验、审计;
- 公开 workspace 读取发布快照;
- 后台首次配置引导和发布检查;
- API client、集成测试、管理后台构建和小程序未发布状态。
## 不在本 Epic
- 新增行业模板或视觉风格;
- 邀请制团队协作;
- 订单领域状态扩展;
- 生产环境部署和 Nginx 配置。
## 验收原则
- 每个受保护端点覆盖缺少凭证、无效凭证/错误角色和成功路径;
- 不同品牌不能读取或回滚其他品牌的发布版本;
- 发布失败不改变草稿和当前发布版本;
- 回滚生成新发布版本,不覆盖草稿;
- 公开接口永远不读取未发布草稿;
- 运行 `prisma migrate deploy`、format、typecheck、API integration 和 Admin build。
@@ -0,0 +1,34 @@
# 进度
- 任务:品牌发布生命周期
- 形态:epic
- 进度:5/5
- 当前:品牌发布生命周期 Epic 已完成;所有子任务和交付验证均已通过。
- 决策依据:`docs/adr/0012-brand-publication-lifecycle.md`
## 阶段执行记录
已完成 `1 发布模型与快照生成`:新增 `BrandRelease`、可部署 migration 和 `BrandReleaseService.buildSnapshot`。公开接口仍读取现有工作区,待发布 API 完成后再切换。
已完成 `2 发布与回滚 API`:新增 `/admin/releases` 列表、`publish`、`revoke` 和版本 `rollback`;发布前校验品牌、模板、业务项、表单和信任内容;回滚生成新版本;覆盖认证、客户越权、成功版本化流程,API integration `37/37` 通过。
已完成 `3 公开 workspace 发布边界`:公开品牌、信任内容、业务项、表单及 workspace 只读取当前发布快照;未发布响应不含草稿品牌资料。客户咨询使用已发布表单字段和版本,预约业务项需存在于发布版本且实时启用;小程序不回退旧缓存。验证:API integration `37/37`、miniapp fixture、API typecheck、Admin build、format、diff 检查通过;测试后已恢复 seed。
阶段 `4 首次配置与发布引导`:后台提供非技术用户可理解的准备清单、模板选择与示例导入、发布前预览、发布/撤回/回滚操作。发布校验由服务端作为唯一真相。
已完成 `4 首次配置与发布引导`:新增 `/admin/publication`,提供行业/视觉选择、示例导入、草稿内容核对、服务端 readiness 检查、发布、撤回和历史版本恢复;编辑成员只可编辑内容,模板管理操作按角色限制。发布检查复用共享 validation 包,发布快照保存模板和视觉声明,客户提交使用发布版本字段和业务快照。验证:API 隔离 schema integration `37/37`、API client `3/3`、API/Admin typecheck、lint、Admin build、format、miniapp fixture 和 visual fixture 均通过。
已完成 `5 全量回归与交付`:
- `pnpm format:check`:通过。
- `pnpm lint`:通过;保留既有 `booking.service.test.ts` 的 6 个 `no-explicit-any` warning。
- `pnpm typecheck`:通过。
- `pnpm --filter @personal-brand/api test`:`6/6` 通过。
- `pnpm --filter @personal-brand/api test:integration`:隔离 schema 部署 25 个 migration,API 集成 `37/37` 通过;临时 schema 已清理。
- `pnpm test:api-client`:`3/3` 通过。
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm --filter @personal-brand/miniapp test:fixture`:通过。
- `pnpm --filter @personal-brand/miniapp test:visual-fixture`:通过。
- `git diff --check`:通过。
交付结论:公开内容只读取已发布快照;发布、撤回、回滚具备事务、版本和审计约束;后台发布引导和服务端 readiness 已覆盖;客户提交与预约均按发布快照校验;本 Epic 无未验证的 API 路径或用户操作。
@@ -0,0 +1,6 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,发布模型与快照生成,single-full,,DONE,tasks/release-model,BrandRelease 模型和运行时快照生成器完成且 migration 可部署,pnpm --filter @personal-brand/api exec prisma migrate deploy && pnpm --filter @personal-brand/api typecheck,已完成;公开读取路径尚未切换
2,发布与回滚 API,single-full,1,DONE,tasks/release-api,发布撤回回滚接口具备校验授权审计和隔离测试,pnpm --filter @personal-brand/api test:integration,已完成;集成测试 37/37
3,公开 workspace 发布边界,single-full,1;2,DONE,tasks/public-release-boundary,公开接口只读取已发布快照并覆盖未发布空状态,pnpm --filter @personal-brand/api test:integration,API 37/37;miniapp fixture 通过;seed 已恢复
4,首次配置与发布引导,single-full,2;3,DONE,tasks/onboarding-publish,普通用户可选择模板导入示例完善身份预览并发布,pnpm --filter @personal-brand/admin build,新增配置与发布页;服务端 readiness;发布撤回回滚;模板/示例/草稿核对;Admin build/typecheck 通过
5,全量回归与交付,single-full,1;2;3;4,DONE,tasks/regression,pnpm format/typecheck/build/integration 和 diff 检查通过,pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build,已完成;全量验证通过,临时测试 schema 已清理
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 发布模型与快照生成 single-full DONE tasks/release-model BrandRelease 模型和运行时快照生成器完成且 migration 可部署 pnpm --filter @personal-brand/api exec prisma migrate deploy && pnpm --filter @personal-brand/api typecheck 已完成;公开读取路径尚未切换
3 2 发布与回滚 API single-full 1 DONE tasks/release-api 发布撤回回滚接口具备校验授权审计和隔离测试 pnpm --filter @personal-brand/api test:integration 已完成;集成测试 37/37
4 3 公开 workspace 发布边界 single-full 1;2 DONE tasks/public-release-boundary 公开接口只读取已发布快照并覆盖未发布空状态 pnpm --filter @personal-brand/api test:integration API 37/37;miniapp fixture 通过;seed 已恢复
5 4 首次配置与发布引导 single-full 2;3 DONE tasks/onboarding-publish 普通用户可选择模板导入示例完善身份预览并发布 pnpm --filter @personal-brand/admin build 新增配置与发布页;服务端 readiness;发布撤回回滚;模板/示例/草稿核对;Admin build/typecheck 通过
6 5 全量回归与交付 single-full 1;2;3;4 DONE tasks/regression pnpm format/typecheck/build/integration 和 diff 检查通过 pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build 已完成;全量验证通过,临时测试 schema 已清理
@@ -0,0 +1,7 @@
# 进度
- 任务:首次配置与发布引导
- 形态:single-full
- 进度:4/4
- 当前:首次配置、内容核对、发布操作和回归验证已完成。
- 文件:本目录 `TODO.csv` 为真相。
@@ -0,0 +1,3 @@
# 首次配置与发布引导
普通品牌用户无需理解内部模板结构,也能按“选择行业与视觉模板、导入示例、完善身份与业务内容、预览、发布”的顺序完成首次发布。后台明确区分草稿和已发布版本,发布失败保留输入并提示缺项。
@@ -0,0 +1,5 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,服务端发布检查接口,DONE,返回与 publish 相同规则的缺项列表,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,复用 validation 包并测试未就绪状态
2,后台模板与示例引导,DONE,可选择模板并预览或导入示例,pnpm --filter @personal-brand/admin build,2026-09-24,0,新增配置与发布页
3,后台发布预览与版本操作,DONE,发布撤回回滚及失败状态完整,pnpm --filter @personal-brand/admin build,2026-09-24,0,含权限控制和失败提示
4,回归验证,DONE,API 与 UI 构建和格式检查通过,pnpm format:check,2026-09-24,0,隔离 schema integration 37/37
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 服务端发布检查接口 DONE 返回与 publish 相同规则的缺项列表 pnpm --filter @personal-brand/api test:integration 2026-09-24 0 复用 validation 包并测试未就绪状态
3 2 后台模板与示例引导 DONE 可选择模板并预览或导入示例 pnpm --filter @personal-brand/admin build 2026-09-24 0 新增配置与发布页
4 3 后台发布预览与版本操作 DONE 发布撤回回滚及失败状态完整 pnpm --filter @personal-brand/admin build 2026-09-24 0 含权限控制和失败提示
5 4 回归验证 DONE API 与 UI 构建和格式检查通过 pnpm format:check 2026-09-24 0 隔离 schema integration 37/37
@@ -0,0 +1,7 @@
# 进度
- 任务:公开 workspace 发布边界
- 形态:single-full
- 进度:3/3
- 验证:API integration 37/37;miniapp fixture、API typecheck、Admin build、format 和 diff 检查通过。
- 文件:本目录 `TODO.csv` 为真相。
@@ -0,0 +1,3 @@
# 公开发布边界
公开接口、小程序运行时和客户提交都必须以当前品牌发布快照为边界。未发布时不显示草稿,也不受理新的咨询或预约;实时禁用仍应即时拦截。
@@ -0,0 +1,4 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,公开查询切换发布快照,DONE,无发布版本不暴露草稿,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,37/37
2,客户提交与小程序缓存边界,DONE,未发布时不受理且不回退旧缓存,pnpm --filter @personal-brand/miniapp test:fixture,2026-09-24,0,通过
3,全量验证与恢复种子,DONE,集成测试和构建通过且 seed 恢复,pnpm format:check,2026-09-24,0,API 37/37;Admin build 通过
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 公开查询切换发布快照 DONE 无发布版本不暴露草稿 pnpm --filter @personal-brand/api test:integration 2026-09-24 0 37/37
3 2 客户提交与小程序缓存边界 DONE 未发布时不受理且不回退旧缓存 pnpm --filter @personal-brand/miniapp test:fixture 2026-09-24 0 通过
4 3 全量验证与恢复种子 DONE 集成测试和构建通过且 seed 恢复 pnpm format:check 2026-09-24 0 API 37/37;Admin build 通过
@@ -0,0 +1,7 @@
# 进度
- 状态:DONE
- 新增 `BrandReleaseApiService` 和 `AdminReleaseController`。
- 发布前校验品牌名称、行业模板、视觉模板兼容性、启用业务项、启用咨询表单和已发布信任内容。
- 新增 API Client 的 release 方法和 认证/成功/回滚/撤回集成测试。
- `prisma migrate deploy`、API build、API typecheck、format 和 API integration `37/37` 已通过。
@@ -0,0 +1,3 @@
# 发布与回滚 API
提供品牌发布版本的查询、发布、撤回和回滚接口。所有数据按管理员会话中的 `brandId` 隔离,发布失败不得修改已有版本,回滚通过创建新版本保留历史。
@@ -0,0 +1,4 @@
id,task,status,completed_at,notes
1,实现发布校验和版本创建,DONE,2026-09-24,事务中标记旧版本 superseded 并创建新版本
2,实现回滚与撤回,DONE,2026-09-24,回滚创建新版本,撤回标记当前版本 revoked
3,补齐授权、隔离和成功测试,DONE,2026-09-24,API integration 37/37
1 id task status completed_at notes
2 1 实现发布校验和版本创建 DONE 2026-09-24 事务中标记旧版本 superseded 并创建新版本
3 2 实现回滚与撤回 DONE 2026-09-24 回滚创建新版本,撤回标记当前版本 revoked
4 3 补齐授权、隔离和成功测试 DONE 2026-09-24 API integration 37/37
@@ -0,0 +1,6 @@
# 进度
- 状态:DONE
- 已新增 `BrandRelease` Prisma 模型及 migration `20260924100000_add_brand_releases`。
- 已新增 `BrandReleaseService.buildSnapshot`,按品牌收集品牌资料、模板安装、模块、字段、业务项、表单、信任内容和能力安装。
- 已执行 `prisma migrate deploy`、API typecheck。
@@ -0,0 +1,3 @@
# 发布模型与快照生成
为每个品牌增加不可变发布版本,保存完整工作区快照,为后续发布、回滚和公开读取提供数据边界。本阶段不切换公开接口。
@@ -0,0 +1,4 @@
id,task,status,completed_at,notes
1,新增 BrandRelease Prisma 模型,DONE,2026-09-24,保存品牌版本快照和状态
2,实现品牌工作区快照生成器,DONE,2026-09-24,BrandReleaseService 按 brandId 收集完整配置
3,执行数据库迁移与 API 类型检查,DONE,2026-09-24,prisma migrate deploy 和 typecheck 通过
1 id task status completed_at notes
2 1 新增 BrandRelease Prisma 模型 DONE 2026-09-24 保存品牌版本快照和状态
3 2 实现品牌工作区快照生成器 DONE 2026-09-24 BrandReleaseService 按 brandId 收集完整配置
4 3 执行数据库迁移与 API 类型检查 DONE 2026-09-24 prisma migrate deploy 和 typecheck 通过
@@ -0,0 +1,12 @@
# 阿成校园餐第二视觉模板 Epic
## 目标
将 `阿成校园餐` React 原型转化为第二个真实可切换的小程序视觉模板,验证模板包不是只保存声明,而是可以替换页面表达,同时继续消费统一 Runtime Workspace 和发布快照。
## 约束
- 原型中的 mock dishes、records 和静态品牌资料不得进入生产运行时;
- 页面内容来自当前品牌发布 workspace;
- 模板代码可以与林境完全不同,但 API、能力和品牌隔离必须复用平台契约;
- 新模板必须有独立 renderer、包声明、fixture 和切换测试。
@@ -0,0 +1,27 @@
# 进度
- 任务:阿成校园餐第二视觉模板
- 形态:epic
- 进度:3/3
- 当前:第二模板制作、renderer 接入、切换链路和全量回归已完成,等待用户在微信开发者工具验收。
- 真相文件:`SUBTASKS.csv`
## 固化流程
新模板必须经过:原型提取 → `template.json` → 独立 renderer → Runtime Workspace 适配 → fixture → API/构建门禁 → 发布切换验收。原型 mock 数据只用于设计参考,不进入生产。
## 本轮完成
- 修正 seed:personal 使用 `linjing-editorial`,food 使用 `acheng-campus-food`,doors 使用 `linjing-editorial`。
- 收紧视觉模板行业兼容性:林境仅支持 personal、doors;阿成仅支持 food。
- 接入阿成首页、菜单和主理人页 renderer,并保留 Runtime Workspace 数据来源。
- 增加 `acheng-campus-food-visual.json`,覆盖 7 个页面状态。
- `validate:templates`、`typecheck`、miniapp fixture、visual fixture、admin build、format check 已通过。
- API 集成测试已通过:37/37;测试使用隔离 schema,并验证模板兼容性、发布与 brandSlug 隔离。
## 验收切换
- `brandSlug=default-brand`:food 行业,使用 `acheng-campus-food`,首页、菜单、主理人页分别使用 `acheng-home`、`acheng-offerings`、`acheng-profile`。
- `brandSlug=linran-brand`:personal 行业,使用 `linjing-editorial`。
- `brandSlug=linjing-doors`:doors 行业,使用 `linjing-editorial`。
- 新模板流程已固化在本文件和 `templates/acheng-campus-food/`:原型提取、声明、独立 renderer、Runtime Workspace、fixture、构建与 API 门禁、切换验收。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,原型提取与模板包声明,single-full,,DONE,tasks/package,阿成校园餐包声明页面入口能力和行业兼容性已落盘,pnpm validate:templates,来源为用户提供的 React 原型
2,小程序独立 renderer,single-full,1,DONE,tasks/renderer,首页主理人页和餐品列表呈现阿成校园餐独立视觉且消费 Runtime Workspace,pnpm --filter @personal-brand/miniapp test:fixture,已接入首页、菜单、主理人页 renderer,并增加视觉 fixture,
3,切换链路与全量回归,single-full,2,DONE,tasks/regression,后台/API 可选择并发布第二模板,brandSlug 切换后视觉 renderer 正确,pnpm --filter @personal-brand/api test:integration,37/37 API 集成测试通过;模板兼容性和 brandSlug 隔离已验证,
1 id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
2 1,原型提取与模板包声明,single-full,,DONE,tasks/package,阿成校园餐包声明页面入口能力和行业兼容性已落盘,pnpm validate:templates,来源为用户提供的 React 原型
3 2,小程序独立 renderer,single-full,1,DONE,tasks/renderer,首页主理人页和餐品列表呈现阿成校园餐独立视觉且消费 Runtime Workspace,pnpm --filter @personal-brand/miniapp test:fixture,已接入首页、菜单、主理人页 renderer,并增加视觉 fixture,
4 3,切换链路与全量回归,single-full,2,DONE,tasks/regression,后台/API 可选择并发布第二模板,brandSlug 切换后视觉 renderer 正确,pnpm --filter @personal-brand/api test:integration,37/37 API 集成测试通过;模板兼容性和 brandSlug 隔离已验证,
@@ -0,0 +1,13 @@
# 手动添加品牌成员
## 目标
在暂不建设邀请流程的前提下,由品牌负责人直接创建成员账号并绑定当前品牌。
## 规则
- 只有 `owner / admin / platform-admin` 可以添加成员。
- 创建时填写登录账号、成员姓名、初始密码和角色。
- 初始密码使用 `bcrypt` hash 保存,接口不返回密码,也不记录明文。
- 账号名全局唯一,已存在账号不会被覆盖。
- 邀请、找回密码和首次登录改密暂不纳入本轮。
@@ -0,0 +1,25 @@
# 进度
- 任务:手动添加品牌成员
- 形态:epic
- 进度:3/3
- 当前:手动添加账号和品牌成员绑定已完成。
## 已完成
- 新增 `POST /admin/brands/members`。
- 新增后台“手动添加成员”表单。
- 初始密码按 `bcrypt` hash 存储,不返回明文。
- 重复账号由 API 拒绝,不覆盖已有账号。
- 成员角色和品牌隔离复用现有权限规则。
## 验证
- `pnpm --filter @personal-brand/api test:integration`:33/33 通过。
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm typecheck`:通过。
- `pnpm format:check`:通过。
## 暂不实现
邀请链接、邮件 / 微信通知、密码找回和首次登录改密后续再做。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,实现手动添加成员 API,single-full,,DONE,tasks/member-create-api,owner 可创建当前品牌成员且密码不出现在响应,pnpm --filter @personal-brand/api test:integration,新增 POST /admin/brands/members
2,接入后台手动添加表单,single-full,1,DONE,tasks/member-create-ui,可填写账号、姓名、初始密码和角色,pnpm --filter @personal-brand/admin build,新增“手动添加成员”弹窗
3,完成安全回归与记录,single-full,1;2,DONE,tasks/regression,授权、重复账号和密码存储行为验证,pnpm --filter @personal-brand/api test:integration,API 33/33 通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 实现手动添加成员 API single-full DONE tasks/member-create-api owner 可创建当前品牌成员且密码不出现在响应 pnpm --filter @personal-brand/api test:integration 新增 POST /admin/brands/members
3 2 接入后台手动添加表单 single-full 1 DONE tasks/member-create-ui 可填写账号、姓名、初始密码和角色 pnpm --filter @personal-brand/admin build 新增“手动添加成员”弹窗
4 3 完成安全回归与记录 single-full 1;2 DONE tasks/regression 授权、重复账号和密码存储行为验证 pnpm --filter @personal-brand/api test:integration API 33/33 通过
@@ -0,0 +1,30 @@
# 多品牌初始化与真实验收
## 目标
把个人品牌、餐饮与门窗三个 demo 品牌固化为可重复初始化的运行时基线,验证公开 Workspace 的品牌隔离、行业表达和咨询转化链路。
## 非目标
- 不新增行业模板或订单能力。
- 不改变普通用户的配置流程。
- 不引入历史数据兼容层;当前为开发期 fixture,直接修正旧样例。
## 约束
- `Offering.kind` 只使用共享 allow-list:`service`、`product`、`package`、`subscription`。
- 行业分类通过 `config.categoryKey` 与 `config.categoryLabel` 表达。
- 三个品牌均须具备已启用的品牌级咨询表单。
- 公开接口必须按 `brandSlug` 隔离验证。
## 风险
- seed 会更新本地 demo 数据,因此必须在执行后检查三个公开 Workspace。
- 运行中的 API 需在 seed 后重启,才能清除其进程内 Workspace 缓存。
## 完成标准
- [ ] `SUBTASKS.csv` 所有任务为 `DONE`。
- [ ] seed 可重复执行并生成 3 个独立品牌。
- [ ] API integration 覆盖三品牌公开 Workspace 基线。
- [ ] migration、seed、format、typecheck、integration、Admin build 通过。
@@ -0,0 +1,21 @@
# 进度
- 任务:多品牌初始化与真实验收
- 形态:epic
- 进度:3/3
- 当前:多品牌初始化与真实验收完成
- 真相文件:`SUBTASKS.csv`
## 恢复信息
- 已完成:新增 `linran-brand` 个人品牌 fixture,并向管理员授予 owner membership。
- 已完成:`Offering.kind` 收敛到共享 allow-list,餐饮和门窗行业分类改由 `config.categoryKey`、`config.categoryLabel` 表达;小程序从 `categoryLabel` 渲染行业名称。
- 已完成:餐饮的预订表达与品牌级咨询表单被 seed 反复校正为启用状态。
- 已完成:公开 Workspace integration 覆盖 3 个品牌的身份、模板、主理人、表单、业务归属和分类语义,API `35/35` 通过。
- 已完成:`prisma migrate deploy` 无待执行项;测试结束后已重跑 seed 恢复 demo 数据;`format:check`、`typecheck`、Admin build 均通过。
## 最终结果
- 风险收口:不再用行业文案污染共享 `Offering.kind`。
- 验收基线:`linran-brand`(个人品牌)、`default-brand`(餐饮)、`linjing-doors`(门窗)三套独立公开 Workspace。
- 已知非阻塞项:Admin production build 提示主 chunk 约 669 kB,后续按路由进一步拆包,不影响本次功能与数据正确性。
@@ -0,0 +1,4 @@
id,task,task_type,status,depends_on,task_dir,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,统一运行时样例语义与三品牌 fixture,single-full,DONE,,tasks/seed-baseline,seed 使用共享 kind 并提供个人、餐饮、门窗的可用内容,pnpm --filter @personal-brand/api typecheck,2026-09-24,0,新增 personal fixture;行业分类迁移至 config.categoryKey/categoryLabel
2,公开 Workspace 三品牌验收测试,single-full,DONE,1,tasks/runtime-contract,按 brandSlug 验证身份、模板、表单、业务项和隔离,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,API integration 35/35 通过
3,执行初始化与全量门禁,single-full,DONE,1;2,tasks/regression,迁移、seed 与质量门禁均通过,pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,2026-09-24,0,migrate deploy 无待执行项;seed 已在测试后重跑恢复 demo 基线
1 id task task_type status depends_on task_dir acceptance_criteria validation_command completed_at retry_count notes
2 1 统一运行时样例语义与三品牌 fixture single-full DONE tasks/seed-baseline seed 使用共享 kind 并提供个人、餐饮、门窗的可用内容 pnpm --filter @personal-brand/api typecheck 2026-09-24 0 新增 personal fixture;行业分类迁移至 config.categoryKey/categoryLabel
3 2 公开 Workspace 三品牌验收测试 single-full DONE 1 tasks/runtime-contract 按 brandSlug 验证身份、模板、表单、业务项和隔离 pnpm --filter @personal-brand/api test:integration 2026-09-24 0 API integration 35/35 通过
4 3 执行初始化与全量门禁 single-full DONE 1;2 tasks/regression 迁移、seed 与质量门禁均通过 pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration 2026-09-24 0 migrate deploy 无待执行项;seed 已在测试后重跑恢复 demo 基线
@@ -0,0 +1,5 @@
# 子任务记录
- 状态:DONE
- 变更:执行 migration、seed 并恢复 integration 后的 demo 基线。
- 验证:`pnpm format:check`、`pnpm typecheck`、Admin production build 均通过。
@@ -0,0 +1,5 @@
# 子任务记录
- 状态:DONE
- 变更:新增按 `brandSlug` 读取三品牌 Workspace 的公开 API integration 测试。
- 验证:`pnpm --filter @personal-brand/api test:integration`,`35/35` 通过。
@@ -0,0 +1,5 @@
# 子任务记录
- 状态:DONE
- 变更:三品牌可重复 seed、共享 kind 收敛、餐饮文案和咨询表单修复。
- 验证:`pnpm --filter @personal-brand/api typecheck` 通过。
@@ -0,0 +1,26 @@
# 三品牌真实业务验收 Epic
## 目标
验证个人品牌、餐饮和门窗三种已发布品牌能够在同一套模板、视觉、发布快照与多品牌隔离体系中稳定运行。验收以用户可配置、已发布内容可展示、草稿不污染线上、禁用即时拦截为边界。
## 范围
- 三个品牌公开 workspace 的身份、行业模板、视觉模板、业务项、表单和信任内容;
- 草稿修改、发布生效、撤回和回滚的公开边界;
- 已发布业务项和表单的实时禁用拦截;
- 后台切换品牌后的隔离;
- API、Admin 和 Miniapp 回归门禁。
## 不在本 Epic
- 新增行业模板或视觉模板;
- 媒体库和文件上传;
- 邀请、通知和生产部署。
## 验收原则
- 不以 seed 静态数据存在作为验收通过,而验证公开发布版本和草稿的边界;
- 行业差异只能来自模板声明、内容和 capability,不能写入共享业务分支;
- 所有客户操作按当前品牌已发布快照验证,并保留实时禁用拦截;
- 每项 API 行为必须可由隔离 schema 集成测试复现。
@@ -0,0 +1,19 @@
# 进度
- 任务:三品牌真实业务验收与模板覆盖验证
- 形态:epic
- 进度:4/4
- 当前:三品牌真实业务自动化验收已完成,等待按清单进行微信开发者工具和后台的人工视觉验收。
- 真相文件:`SUBTASKS.csv`
## 阶段执行记录
已完成阶段 `1 三品牌发布基线验收`:个人、餐饮、门窗 3 个 `brandSlug` 均验证了品牌身份、行业模板、视觉模板 manifest、信任内容、业务项和咨询表单,API integration `37/37` 通过。
已完成阶段 `2 草稿与发布边界组合验收`:验证草稿修改不污染已发布 workspace,发布后才生效,回滚生成新版本,撤回后公开 workspace 进入未发布状态,并保持品牌隔离。
已完成阶段 `3 提交与实时禁用验收`:验证发布快照表单和业务项可以提交;草稿新增、表单禁用、业务项禁用、能力禁用和撤回状态均被提交端拦截。
已完成阶段 `4 全量回归与手工验收清单`:`format:check`、全仓 `typecheck`、隔离 schema API integration `37/37`、Admin build、Miniapp fixture、visual fixture 和 `git diff --check` 均通过。
人工验收步骤已记录于 [MANUAL-ACCEPTANCE.md](tasks/regression/MANUAL-ACCEPTANCE.md)。自动化已完成,人工验收重点是微信开发者工具中的视觉还原、图片资源和品牌切换操作。
@@ -0,0 +1,5 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,三品牌发布基线验收,single-full,,DONE,tasks/three-brand-baseline,个人、餐饮、门窗各自公开 workspace 具备匹配的身份模板视觉业务表单和信任内容,pnpm --filter @personal-brand/api test:integration,API integration 37/37;三品牌断言通过
2,草稿与发布边界组合验收,single-full,1,DONE,tasks/draft-publication-boundary,草稿修改不影响线上且发布回滚撤回均保持品牌隔离,pnpm --filter @personal-brand/api test:integration,发布生命周期、草稿隔离、回滚和撤回测试通过
3,提交与实时禁用验收,single-full,1;2,DONE,tasks/submission-boundary,已发布表单和业务项可提交且草稿或实时禁用状态被正确拦截,pnpm --filter @personal-brand/api test:integration,表单/业务项禁用和发布快照提交测试通过
4,全量回归与手工验收清单,single-full,1;2;3,DONE,tasks/regression,自动化门禁通过并形成后台和小程序手工验收步骤,pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build,全量门禁通过;已形成 MANUAL-ACCEPTANCE.md
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 三品牌发布基线验收 single-full DONE tasks/three-brand-baseline 个人、餐饮、门窗各自公开 workspace 具备匹配的身份模板视觉业务表单和信任内容 pnpm --filter @personal-brand/api test:integration API integration 37/37;三品牌断言通过
3 2 草稿与发布边界组合验收 single-full 1 DONE tasks/draft-publication-boundary 草稿修改不影响线上且发布回滚撤回均保持品牌隔离 pnpm --filter @personal-brand/api test:integration 发布生命周期、草稿隔离、回滚和撤回测试通过
4 3 提交与实时禁用验收 single-full 1;2 DONE tasks/submission-boundary 已发布表单和业务项可提交且草稿或实时禁用状态被正确拦截 pnpm --filter @personal-brand/api test:integration 表单/业务项禁用和发布快照提交测试通过
5 4 全量回归与手工验收清单 single-full 1;2;3 DONE tasks/regression 自动化门禁通过并形成后台和小程序手工验收步骤 pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build 全量门禁通过;已形成 MANUAL-ACCEPTANCE.md
@@ -0,0 +1,13 @@
# 后台与小程序手工验收
对每个 `linran-brand`、`default-brand`、`linjing-doors` 依次执行:
1. 在后台切换到目标品牌,确认 Header 品牌名称、品牌表达、业务提供项和咨询表单均属于当前品牌。
2. 在“配置与发布”查看 readiness,确认模板、视觉、业务项、表单和信任内容均通过。
3. 修改一项草稿文案或图片但不发布;在小程序重新进入对应 `brandSlug`,确认线上仍是发布版本。
4. 发布草稿;重新进入小程序,确认修改后的品牌身份、业务展示、咨询表单和信任内容生效。
5. 禁用一个已发布业务项或表单;确认其不再展示,且历史入口提交被 API 拦截。
6. 选择历史版本恢复并确认小程序回到该版本;撤回后确认小程序显示“品牌尚未发布”。
7. 切换到另一个品牌重复第 1 至 4 步,确认不出现前一品牌的名称、图片、业务项或咨询记录。
通过标准:每个品牌独立通过,且发布、撤回、回滚和禁用均只影响当前品牌。
@@ -0,0 +1,16 @@
# 后台角色权限分层
## 目标
把日常品牌经营权限与模板、能力、字段等系统设置权限分开,避免普通品牌编辑误操作系统配置。
## 角色矩阵
- `owner`、`admin`、`platform-admin`:可以管理品牌内容和系统设置。
- `editor`:可以管理品牌表达、信任内容、业务提供项、咨询表单和咨询记录;不能安装或升级模板、调整能力、模块、字段或视觉模板。
## 完成条件
- 全局 membership guard 在系统设置路由执行角色校验。
- visual template 通过独立接口或品牌配置写入时同样受保护。
- 自动化测试覆盖编辑者允许日常经营、拒绝系统设置。
@@ -0,0 +1,22 @@
# 进度
- 任务:后台角色权限分层
- 形态:epic
- 进度:3/3
- 当前:`owner / admin / platform-admin` 与 `editor` 的最小权限边界已生效。
## 已完成
- 系统设置路径:模板安装、能力、视觉模板、模块和字段,仅允许 owner 级角色。
- 日常经营路径继续允许已启用品牌成员访问。
- `editor` 通过业务提供项读取测试,但访问能力设置和视觉模板被拒绝。
## 验证
- `pnpm --filter @personal-brand/api test:integration`:32/32 通过。
- `pnpm typecheck`:通过。
- `pnpm format:check`:通过。
## 注意
当前登录接口仍返回通用 `admin` token,真实用户管理、成员邀请和角色变更需要后续独立任务建设;本轮不把前端导航分组误称为完整权限系统。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,在 membership guard 增加系统设置角色校验,single-full,,DONE,tasks/guard,系统设置路径只允许 owner 级角色,pnpm --filter @personal-brand/api test:integration,已覆盖 workspace 系统路由和 visual-template 路由
2,保护视觉模板配置写入,single-full,1,DONE,tasks/visual-template,editor 不能通过品牌配置修改 visualTemplateKey,pnpm --filter @personal-brand/api test:integration,已在 AdminConfigController 增加角色校验
3,完成授权回归与记录,single-full,1;2,DONE,tasks/regression,编辑者允许内容管理且拒绝系统设置,pnpm typecheck && pnpm format:check,API 32/32 通过,typecheck 和 format 通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 在 membership guard 增加系统设置角色校验 single-full DONE tasks/guard 系统设置路径只允许 owner 级角色 pnpm --filter @personal-brand/api test:integration 已覆盖 workspace 系统路由和 visual-template 路由
3 2 保护视觉模板配置写入 single-full 1 DONE tasks/visual-template editor 不能通过品牌配置修改 visualTemplateKey pnpm --filter @personal-brand/api test:integration 已在 AdminConfigController 增加角色校验
4 3 完成授权回归与记录 single-full 1;2 DONE tasks/regression 编辑者允许内容管理且拒绝系统设置 pnpm typecheck && pnpm format:check API 32/32 通过,typecheck 和 format 通过
@@ -0,0 +1,14 @@
# 进度
- 任务:Runtime Workspace 契约收敛
- 形态:single-full
- 进度:3/3
- 当前:Runtime Workspace 契约收敛完成
- 真相文件:`TODO.csv`
## 恢复信息
- 已完成:`RuntimeOffering` 明确声明共享类别、封面、价格和 `presentation`(行业标签、关键词、详情、媒体)。
- 已完成:公开 Workspace 仅下发 Runtime Offering;不再以原始 Prisma `offerings` 或 `modules` 覆盖同名 Runtime 字段。
- 已完成:小程序从 `presentation` 读取行业标签与详情首图;模块类型在 API 层归一为渲染组件类型。
- 验证:全仓 typecheck、API integration `35/35`、Miniapp fixture、Miniapp visual fixture 通过;测试后已重跑 seed 恢复三品牌 demo 数据。
@@ -0,0 +1,23 @@
# Runtime Workspace 契约收敛
## 目标
让 `public/workspace` 只返回一套符合共享类型的业务提供项展示数据,消除原始 Prisma `offerings` 覆盖 `RuntimeWorkspace.offerings` 的重复响应。
## 范围
- 扩展 `RuntimeOffering`,承载小程序所需的共享展示数据与模板配置。
- API 只下发投影后的 Runtime Workspace,不泄漏重复原始字段。
- Miniapp 改为消费明确的 Runtime Offering 合约。
- 补 API integration 和 Miniapp fixture 验证。
## 非目标
- 不新增行业字段、模板或插件。
- 不保留旧的重复 `offerings` 响应兼容层。
## 验收
- `RuntimeWorkspace.offerings` 与实际 API 响应一致。
- 三品牌展示数据、封面、行业标签与详情配置可被小程序读取。
- API integration、Miniapp fixture、format、typecheck 通过。
@@ -0,0 +1,4 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,审计并定义统一 RuntimeOffering 投影,DONE,共享类型覆盖小程序实际展示字段,pnpm --filter @personal-brand/types typecheck,2026-09-24,0,定义共享展示字段与 presentation 投影
2,切换 API 与小程序至唯一契约,DONE,公开响应不再覆盖 runtime offerings,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,移除 Prisma offerings/modules 覆盖并迁移消费者
3,补齐回归与任务收口,DONE,三品牌和小程序 fixture 均验证,pnpm format:check && pnpm typecheck,2026-09-24,0,API 35/35 与 Miniapp fixture 均通过;测试后重跑 seed
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 审计并定义统一 RuntimeOffering 投影 DONE 共享类型覆盖小程序实际展示字段 pnpm --filter @personal-brand/types typecheck 2026-09-24 0 定义共享展示字段与 presentation 投影
3 2 切换 API 与小程序至唯一契约 DONE 公开响应不再覆盖 runtime offerings pnpm --filter @personal-brand/api test:integration 2026-09-24 0 移除 Prisma offerings/modules 覆盖并迁移消费者
4 3 补齐回归与任务收口 DONE 三品牌和小程序 fixture 均验证 pnpm format:check && pnpm typecheck 2026-09-24 0 API 35/35 与 Miniapp fixture 均通过;测试后重跑 seed
@@ -0,0 +1,17 @@
# 品牌团队成员管理
## 目标
让品牌负责人可以查看当前品牌成员、调整内容编辑权限和启停用成员,同时保护品牌不被误配置到失去负责人。
## 规则
- 只有 `owner / admin / platform-admin` 可以管理成员。
- 成员角色支持 `owner` 和 `editor`。
- 不能修改自己的角色或停用自己。
- 不能移除最后一位启用的负责人。
- 成员数据始终按当前品牌隔离。
## 未覆盖
成员邀请、邮件 / 微信通知、首次登录和跨品牌平台管理员界面作为后续任务。
@@ -0,0 +1,25 @@
# 进度
- 任务:品牌团队成员管理
- 形态:epic
- 进度:3/3
- 当前:成员列表、角色调整和启停用已完成。
## 已完成
- 新增 `GET /admin/brands/members`。
- 新增 `PATCH /admin/brands/members/:id`。
- 新增后台“团队成员”页面。
- 成员角色使用“负责人 / 内容编辑”业务语言展示。
- 保护自禁用和最后负责人约束。
## 验证
- `pnpm --filter @personal-brand/api test:integration`:33/33 通过。
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm typecheck`:通过。
- `pnpm format:check`:通过。
## 后续边界
当前页面只管理已经存在的成员,不提供邀请和首次登录流程;这部分需要单独设计账号生命周期和通知策略。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,实现成员列表和角色更新 API,single-full,,DONE,tasks/member-api,owner 可按当前品牌读取和更新成员,pnpm --filter @personal-brand/api test:integration,新增 GET/PATCH /admin/brands/members
2,实现后台团队成员页面,single-full,1,DONE,tasks/member-ui,后台可查看成员并修改角色和状态,pnpm --filter @personal-brand/admin build,新增团队成员页面和系统管理导航
3,完成成员安全回归,single-full,1;2,DONE,tasks/regression,自禁用、最后负责人保护和品牌隔离有测试,pnpm --filter @personal-brand/api test:integration,API 33/33 通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 实现成员列表和角色更新 API single-full DONE tasks/member-api owner 可按当前品牌读取和更新成员 pnpm --filter @personal-brand/api test:integration 新增 GET/PATCH /admin/brands/members
3 2 实现后台团队成员页面 single-full 1 DONE tasks/member-ui 后台可查看成员并修改角色和状态 pnpm --filter @personal-brand/admin build 新增团队成员页面和系统管理导航
4 3 完成成员安全回归 single-full 1;2 DONE tasks/regression 自禁用、最后负责人保护和品牌隔离有测试 pnpm --filter @personal-brand/api test:integration API 33/33 通过
@@ -0,0 +1,27 @@
# 林境模板包基础 Epic
## 目标
将林境作为当前唯一正式视觉模板包,保留个人、餐饮、门窗行业模板作为数据与能力声明。移除当前没有独立 renderer、仅复用林境页面的伪视觉模板,建立可扩展的模板包契约和版本快照基础。
## 范围
- `template.json` 风格的模板包契约类型与校验;
- 林境模板包元数据、页面入口、能力依赖和 fixture;
- 视觉模板目录只暴露林境模板;
- 所有品牌视觉默认值和发布快照统一使用林境;
- Admin、API、Miniapp fixture 和文档同步。
## 不在本 Epic
- 新增餐饮专属视觉模板;
- 运行时下载 WXML/WXSS/JS;
- 媒体上传服务;
- 多模板构建服务。
## 设计边界
- 行业模板决定业务数据、字段和 capability,不决定视觉代码;
- 林境模板包只消费统一 Runtime Workspace,不读取数据库;
- 后台不能展示没有独立 renderer 的视觉模板;
- 模板包和品牌发布版本都必须保留精确版本。
@@ -0,0 +1,17 @@
# 进度
- 任务:林境模板包基础
- 形态:epic
- 进度:3/3
- 当前:模板包可执行边界已完成;林境是唯一正式视觉模板包,个人、餐饮、门窗继续作为行业数据模板。
- 真相文件:`SUBTASKS.csv`
## 阶段执行记录
已完成阶段 `1 模板包契约与林境声明`:共享 config 新增 `TemplatePackageManifest`、模板包 registry、入口声明和校验函数,林境包固定为 `linjing-editorial@1.0.0`。
已完成阶段 `2 统一唯一视觉模板`:移除 `minimal-neutral` 视觉目录和默认回退;API、Admin、seed、发布快照和模板目录只暴露林境视觉模板。个人、餐饮、门窗仍由行业模板、业务数据和 capability 区分。
已完成阶段 `3 全量回归与扩展文档`:`pnpm validate:templates` 校验模板包 `1/1`,`format:check`、全仓 `typecheck`、API integration `37/37`、Admin build、Miniapp fixture、visual fixture 和 `git diff --check` 通过。新增模板流程记录在 `tasks/contract/README.md` 和 `tasks/regression/README.md`。
约束:未来新增视觉模板必须提供独立编译期 renderer、manifest、fixture、API 兼容性和构建验证;不得只复制林境 manifest 后注册为新模板。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,模板包契约与林境声明,single-full,,DONE,tasks/contract,共享类型提供模板包元数据和运行时入口声明,林境包可校验,pnpm typecheck && pnpm validate:templates,新增 TemplatePackageManifest、registry 和文件级校验器
2,统一唯一视觉模板,single-full,1,DONE,tasks/linjing-package,API、Admin、seed 和发布默认值只使用林境视觉模板,pnpm --filter @personal-brand/api test:integration,移除 minimal-neutral 目录和默认回退;个人/餐饮/门窗保留为行业模板
3,全量回归与扩展文档,single-full,1;2,DONE,tasks/regression,fixture、构建、格式、类型和集成测试通过并记录新增模板流程,pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build,模板校验 1/1;API 37/37;Admin、Miniapp fixture、visual fixture 和格式检查通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 模板包契约与林境声明 single-full DONE tasks/contract 共享类型提供模板包元数据和运行时入口声明,林境包可校验 pnpm typecheck && pnpm validate:templates 新增 TemplatePackageManifest、registry 和文件级校验器
3 2 统一唯一视觉模板 single-full 1 DONE tasks/linjing-package API、Admin、seed 和发布默认值只使用林境视觉模板 pnpm --filter @personal-brand/api test:integration 移除 minimal-neutral 目录和默认回退;个人/餐饮/门窗保留为行业模板
4 3 全量回归与扩展文档 single-full 1;2 DONE tasks/regression fixture、构建、格式、类型和集成测试通过并记录新增模板流程 pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build 模板校验 1/1;API 37/37;Admin、Miniapp fixture、visual fixture 和格式检查通过
@@ -0,0 +1,3 @@
# 模板包契约
当前正式视觉模板包为 `linjing-editorial@1.0.0`,元数据位于 `templates/linjing-editorial/template.json`。未来新增视觉模板必须提供独立的编译期页面 renderer,不得只复制林境 manifest 或复用林境 renderer 后伪装成新模板。
@@ -0,0 +1,3 @@
# 扩展门禁
新增视觉模板前必须同时提交:模板包声明、页面入口、Runtime Workspace 适配说明、品牌/行业兼容性、运行时 fixture、视觉 fixture、Admin 目录展示、API 集成测试和生产构建结果。
@@ -0,0 +1,18 @@
# 模板包运行时与构建体系
## 目标
将视觉模板从 `apps/miniapp` 主工程中隔离为独立 pnpm workspace package,通过构建期 compiler 生成微信小程序目录,支持大量模板扩展而不引入运行时下载。
## 阶段
1. 模板包协议与校验。
2. 本地 template compiler 和开发命令。
3. 林境、阿成模板迁移到独立 package。
4. 发布配置、快照版本和模板回归门禁。
## 非目标
- 不实现小程序运行时下载或执行模板代码。
- 不把 300 个模板打入同一个小程序包。
- 不复制登录、API、预约状态机等业务逻辑到模板包。
@@ -0,0 +1,62 @@
# 进度
- 任务:模板包运行时与构建体系
- 形态:epic
- 进度:4/4
- 当前:模板包运行时与构建体系已完成,阿成与林境静态视觉原型均已通过人工验收;后续新增模板继续按独立 package + compiler 产物流程接入。动态数据、接口联调和品牌切换另行验收。
- 真相文件:`SUBTASKS.csv`
## 决策
- 模板包是构建输入,不是小程序运行时下载内容。
- 单次构建只包含一个模板包。
- 模板包只负责视觉页面、导航和交互表达;公共 runtime 负责数据、鉴权、提交和状态。
## 已完成
- 新增 `packages/template-contract`,定义 runtime contract `1.0`、页面入口和导航声明。
- 新增 `packages/template-compiler`,支持 `pnpm template:dev <template-key> --out <dir>`。
- 新增 `packages/template-acheng-campus-food` 模板包骨架,已通过 workspace 模板校验。
- 编译器已验证可生成带 `template.manifest.json` 的 Mini Program 目录。
- 新增 `template-linjing-editorial` 包声明。
- 阿成首页、菜单、主理人和出摊服务 renderer 已复制到独立模板包,compiler 会以 `apps/miniapp` shell 为基底合并模板文件。
- compiler 现在会根据模板声明生成 `app.json` 标题和 `template.runtime.json`,并在生成前校验页面入口、导航和 runtime contract。
- 当前仍处于迁移过渡期:shell 的旧 renderer 暂不删除,避免页面配置尚未覆盖完整时生成不可编译目录;只有模板包完成页面级覆盖后才执行所有权清理。
- 新增 compiler 自动测试,验证阿成 5 导航、林境 3 导航、模板标题和 renderer 文件隔离。
- 模板包现在声明 `renderers`,阿成和林境 renderer 源码已复制进各自 package;compiler 会校验 renderer 文件存在。
- compiler 根据模板声明生成 `app.json.tabBar`,并从生成目录移除自定义 runtime tab bar 组件和引用;阿成 5 项、林境 3 项均有回归测试。
- 导航协议支持模板扩展 entrypoint;阿成的“出摊服务”现在独立指向 `pages/stall-service/index`,不再与餐品页复用同一入口。
- compiler 为模板 renderer 生成稳定的 `components/template-pages/<page>` alias,公共页面不再需要引用 `acheng-*` 或 `linjing-*` 组件名;生成页面只依赖 `template-home`、`template-offerings`、`template-profile` 等稳定别名。
- 对没有专属 renderer 的模板页面,compiler 使用公共 runtime 模块生成 alias,不会从其他行业模板借用组件;单次生成结果中的 renderer 条件会被构建期固化,避免运行时保留模板分支。
- 咨询页已移除 `templateKey` 行业分支,改为使用 workspace 下发的 presentation;compiler 会校验 manifest 中所有 entrypoint 的 `.js/.json/.wxml/.wxss` 文件均存在。
- 生成完成后会删除 `components/templates` 旧 renderer 目录,生成产物不再携带其他模板组件;林境产物已验证不会混入阿成 renderer。
- manifest 现在显式声明 `runtimeOwnedPages`,当前详情、咨询、成功、记录由公共 runtime 所有;compiler 会扫描生成页面,拒绝旧模板路径、runtime tab bar 和 `templateKey` 行业分支残留。
- `pnpm test:template-compiler` 已通过,生成链路现在有自动回归而不是只依赖手工检查。
## 本轮验证
- `pnpm validate:templates`
- `pnpm test:template-compiler`
- `pnpm typecheck`
- `pnpm format:check`
- `git diff --check`
## 未完成
- 详情、成功、记录页面暂时继续使用公共 runtime 模块,后续如需行业专属视觉可通过 manifest renderer 声明扩展。
- `ownedPaths` 仍用于声明模板源码所有权,但生成目录清理已由 compiler 的产物隔离逻辑负责。
- 当前构建门禁已通过:`pnpm test:template-compiler`、`pnpm validate:templates`、`pnpm typecheck`、`pnpm format:check`、`git diff --check`。
- 发布门禁已通过:`pnpm validate:template-release`、Mini Program fixture、visual fixture。
- 阿成模板已补齐 5 个真实页面入口:首页、套餐餐品、出摊服务、主理人、定制咨询;生成目录的 5 个 tab 全部由微信原生 `tabBar` 驱动。
- 阿成模板 package 进一步补齐餐品详情、预订成功、预订记录 3 个二级页面,并统一餐饮橙色视觉;生成产物的 8 个页面均来自 package 或公共 runtime 的明确入口。
- 阿成 tab 图标资源已归属模板 package;图标完整性校验放在模板包校验脚本,compiler 只按 manifest 复制并写入原生 `tabBar`,不包含行业资源特判。
- 本轮按 `/home/que01/下载/阿成校园餐---微信小程序原型/` 的 `ServiceView`、`BookingView` 先完成静态页面迁移:出摊服务包含固定日程、配送范围、4 步定制流程和咨询 CTA;定制咨询包含表单 / 历史记录切换、类型网格、人数/日期/预算/配送选择、错误态、提交承诺和记录卡,并继续接入现有提交接口。
- 林境模板补齐独立案例 renderer、案例分类筛选、第三个 tab 外层间距和原生 tabBar 图标;模板声明默认品牌 `linjing-doors`,生成产物不再请求 `default-brand`。
- 静态验收结论:阿成与林境模板的页面结构、主要视觉表现、原生 tabBar 和模板间隔离达到当前验收标准。
- `apps/miniapp` 仍是开发过渡 shell,最终人工验收目录必须使用 `pnpm template:dev <template-key> --out <dir>` 生成的构建产物;生成产物已确认不包含自定义 tab bar。
## 阶段结论
- 阶段 3 模板包迁移:已完成,静态原型迁移和生成产物已人工验收。
- 阶段 4 发布配置与回归:已完成,发布、fixture、类型和格式门禁通过。
- 后续新增模板只需新增独立 `packages/template-*`、更新 `config/template-build.json`,并通过 compiler、fixture 和人工验收门禁。
@@ -0,0 +1,5 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,模板包协议与校验,single-full,,DONE,tasks/contract,协议定义并能校验模板包声明,pnpm validate:templates,已增加 template-contract 和 workspace 包校验
2,本地 template compiler,single-full,1,DONE,tasks/compiler,可从 workspace 模板包生成 Mini Program 目录,pnpm template:dev acheng-campus-food,已验证生成 manifest 和 Mini Program 目录
3,模板包迁移,single-full,2,DONE,tasks/migration,林境和阿成源码由独立包提供,pnpm test:template-compiler,已完成人工验收;阿成 5 个 tab 页面及详情/成功/记录二级页面和 tab 图标资源均归属 template package
4,发布配置与回归,single-full,3,DONE,tasks/release,模板包版本进入构建配置并完成 fixture/API 回归,pnpm validate:template-release,发布配置、模板 fixture、compiler、类型和格式门禁均已通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 模板包协议与校验 single-full DONE tasks/contract 协议定义并能校验模板包声明 pnpm validate:templates 已增加 template-contract 和 workspace 包校验
3 2 本地 template compiler single-full 1 DONE tasks/compiler 可从 workspace 模板包生成 Mini Program 目录 pnpm template:dev acheng-campus-food 已验证生成 manifest 和 Mini Program 目录
4 3 模板包迁移 single-full 2 DONE tasks/migration 林境和阿成源码由独立包提供 pnpm test:template-compiler 已完成人工验收;阿成 5 个 tab 页面及详情/成功/记录二级页面和 tab 图标资源均归属 template package
5 4 发布配置与回归 single-full 3 DONE tasks/release 模板包版本进入构建配置并完成 fixture/API 回归 pnpm validate:template-release 发布配置、模板 fixture、compiler、类型和格式门禁均已通过
@@ -0,0 +1,10 @@
# 进度
- 任务:按当前行业选择模板示例内容
- 形态:single-full
- 状态:DONE
- 当前:已完成
- 关联任务:`template-sample-content-registry`
- 已补齐个人品牌、餐饮、门窗三套示例内容注册。
- API 按当前品牌 `templateKey` 选择示例包,不再固定门窗 key。
- 验证:`format:check`、全仓 `typecheck`、API integration(链路成功完成)、测试后 seed 恢复。
@@ -0,0 +1,13 @@
# 进度
- 任务:模板示例内容注册表
- 形态:single-full
- 进度:3/3
- 当前:已完成
- 真相文件:`TODO.csv`
## 结果
- `@personal-brand/config` 新增 `TemplateSampleContent` 与门窗模板示例注册表。
- Admin Workspace Controller 只消费注册表,不再写死业务项、信任内容和字段。
- `pnpm typecheck` 已通过;API integration 和全量格式门禁待最终执行。
@@ -0,0 +1,17 @@
# 模板示例内容注册表
## 目标
将模板示例内容从 API Controller 移入 `@personal-brand/config` 注册表,保证模板安装与导入由声明驱动。
## 决策
- 示例业务项、信任内容、字段和能力归属属于模板包定义。
- Controller 只负责权限、幂等检查、事务和审计。
- 本轮先迁移现有门窗示例内容,后续行业模板按同一注册表扩展。
## 验收
- 示例内容接口不再包含行业文案、字段数组或数量常量。
- 现有预览、导入、重复导入行为保持一致。
- API、config、format、typecheck 通过。
@@ -0,0 +1,4 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,建立模板示例内容注册表,DONE,门窗示例内容迁移至 config,pnpm typecheck,2026-09-24,0,
2,改造示例内容 API 使用注册表,DONE,Controller 无行业内容硬编码,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,保留现有导入幂等与审计
3,完成格式与回归验证,DONE,全量门禁通过,pnpm format:check && pnpm typecheck,2026-09-24,0,
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 建立模板示例内容注册表 DONE 门窗示例内容迁移至 config pnpm typecheck 2026-09-24 0
3 2 改造示例内容 API 使用注册表 DONE Controller 无行业内容硬编码 pnpm --filter @personal-brand/api test:integration 2026-09-24 0 保留现有导入幂等与审计
4 3 完成格式与回归验证 DONE 全量门禁通过 pnpm format:check && pnpm typecheck 2026-09-24 0
@@ -0,0 +1,17 @@
# 面向普通用户的品牌配置闭环
## 目标
在不暴露模板 key、能力状态、版本快照等管理员概念的前提下,让普通品牌使用者可以通过易懂的表单维护品牌表达、页面文案和图片,并让小程序通过 Runtime Workspace 实时消费这些配置。
## 边界
- 普通用户配置:我是谁、信任表达、业务展示、咨询文案、联系方式和图片。
- 管理员配置:行业模板、视觉模板、能力插件、版本升级、回滚和数据结构。
- 所有配置按当前品牌隔离,不能由客户端提交 brandId。
## 验收
- 普通用户无需理解 JSON、manifest、slot 或 template key。
- 保存失败保留输入并显示可操作错误,成功后刷新预览和 Runtime Workspace。
- API 有授权、成功、品牌隔离自动化测试。
@@ -0,0 +1,18 @@
# 进度
- 任务:面向普通用户的品牌配置闭环
- 形态:epic
- 进度:4/4
- 当前:本 Epic 已完成,下一步补齐普通用户的图片、作品和服务内容配置
- 真相文件:`SUBTASKS.csv`
## 决策
- 普通用户不接触模板 key、manifest、slot、插件和快照。
- 管理员工作区继续承载模板安装、视觉模板切换、能力和版本管理。
- presentation 以页面语义分组保存,后端合并到当前品牌 config,由公开 workspace 下发。
- 2026-09-23:presentation API 和普通用户表单已完成。API 集成测试 `31/31` 通过,后台 `build`、`lint`、`typecheck`、`format:check` 通过;下一步验证保存后预览刷新和小程序运行时读取。
- 2026-09-23:后台新增“当前已生效内容”运行时预览,保存成功会刷新公开 workspace,读取失败有明确提示;admin build、lint、typecheck、format:check 均通过。
- 2026-09-23:配置闭环回归完成:API 集成测试 `31/31`、admin build、全仓 lint/typecheck/format、miniapp fixture 和 visual-fixture 均通过。
- 2026-09-23:补充主理人身份配置,普通用户可维护姓名、身份、主张、电话、微信和服务范围;身份字段写入品牌 runtime identity,不混入视觉模板 section。API 集成测试继续保持 `31/31`。
- 2026-09-23:在运行时预览中明确显示“主理人 / 老板姓名”和身份,避免字段虽已保存但普通用户无法确认小程序是否生效。
@@ -0,0 +1,5 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,定义用户配置契约与品牌 presentation API,single-full,,DONE,tasks/presentation-api,普通用户可提交受控的 presentation 配置且按当前品牌保存,pnpm --filter @personal-brand/api test:integration,独立 presentation API 只接受允许的页面 section,集成测试 31/31 通过
2,实现普通用户友好的品牌表达表单,single-full,1,DONE,tasks/brand-editor,表单使用中文业务概念并覆盖核心页面文案和资源,pnpm --filter @personal-brand/admin build,已实现首页、咨询页、主理人与我页面表达表单;不暴露 JSON、manifest、slot 和版本概念
3,接入保存后的运行时预览与错误状态,single-full,1;2,DONE,tasks/runtime-preview,保存成功刷新后台预览和小程序运行时数据,pnpm --filter @personal-brand/admin build,已显示小程序当前已生效内容;运行时读取失败显示明确提示,保存失败保留输入
4,完成配置闭环测试与文档,single-full,1;2;3,DONE,tasks/regression,授权、品牌隔离、保存、刷新和构建全部验证,pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,API 31/31、admin build、全仓 lint/typecheck/format、miniapp fixture 均通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 定义用户配置契约与品牌 presentation API single-full DONE tasks/presentation-api 普通用户可提交受控的 presentation 配置且按当前品牌保存 pnpm --filter @personal-brand/api test:integration 独立 presentation API 只接受允许的页面 section,集成测试 31/31 通过
3 2 实现普通用户友好的品牌表达表单 single-full 1 DONE tasks/brand-editor 表单使用中文业务概念并覆盖核心页面文案和资源 pnpm --filter @personal-brand/admin build 已实现首页、咨询页、主理人与我页面表达表单;不暴露 JSON、manifest、slot 和版本概念
4 3 接入保存后的运行时预览与错误状态 single-full 1;2 DONE tasks/runtime-preview 保存成功刷新后台预览和小程序运行时数据 pnpm --filter @personal-brand/admin build 已显示小程序当前已生效内容;运行时读取失败显示明确提示,保存失败保留输入
5 4 完成配置闭环测试与文档 single-full 1;2;3 DONE tasks/regression 授权、品牌隔离、保存、刷新和构建全部验证 pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration API 31/31、admin build、全仓 lint/typecheck/format、miniapp fixture 均通过
@@ -0,0 +1,18 @@
# 普通用户咨询表单配置
## 目标
让普通品牌使用者可以用业务语言配置咨询表单,而不需要理解字段 key、JSON 或内部提交协议。
## 边界
- 表单名称、用途和关联业务保留为业务概念。
- 字段只展示“要询问客户什么、回答方式、是否必填、可选内容”。
- 字段 key 自动生成并稳定保存在快照中。
- 后端继续负责字段校验、版本递增和提交快照,不在前端绕过校验。
## 完成条件
- 后台不显示英文 type、Key 或选项 JSON。
- 新增和编辑字段能生成符合 API 校验的快照。
- API integration、admin build、typecheck 和格式检查通过。
@@ -0,0 +1,20 @@
# 进度
- 任务:普通用户咨询表单配置
- 形态:epic
- 进度:3/3
- 当前:本轮已完成,后台表单编辑器面向普通用户收敛。
## 已完成
- 字段编辑改为中文业务表达:字段名称、回答方式、必填状态和可选内容。
- 内部字段 key 自动生成并隐藏,编辑已有表单时保持原 key。
- 选择类字段使用逐行或顿号分隔的普通文本,不再要求输入 JSON。
- 后端字段校验、版本递增和运行时提交链路保持不变。
## 验证
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm --filter @personal-brand/api test:integration`:31/31 通过。
- `pnpm typecheck`:通过。
- `pnpm format:check`:通过。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,改造普通用户表单字段编辑器,single-full,,DONE,tasks/form-editor,字段使用中文业务表达且自动处理内部 key 和 options,pnpm --filter @personal-brand/admin build,已移除 Key、英文类型和选项 JSON 输入
2,验证表单运行时链路,single-full,1,DONE,tasks/runtime-regression,版本、校验和客户提交链路无回归,pnpm --filter @personal-brand/api test:integration,API 31/31 通过
3,落盘交付记录,single-full,1;2,DONE,tasks/delivery,进度和验证命令已记录,pnpm format:check && pnpm typecheck,format、typecheck 通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 改造普通用户表单字段编辑器 single-full DONE tasks/form-editor 字段使用中文业务表达且自动处理内部 key 和 options pnpm --filter @personal-brand/admin build 已移除 Key、英文类型和选项 JSON 输入
3 2 验证表单运行时链路 single-full 1 DONE tasks/runtime-regression 版本、校验和客户提交链路无回归 pnpm --filter @personal-brand/api test:integration API 31/31 通过
4 3 落盘交付记录 single-full 1;2 DONE tasks/delivery 进度和验证命令已记录 pnpm format:check && pnpm typecheck format、typecheck 通过
@@ -0,0 +1,17 @@
# 普通用户图片资源配置
## 目标
统一品牌头像、封面、服务封面和信任内容配图的配置体验,让普通用户可以在保存前确认图片效果。
## 当前边界
- 当前阶段没有文件存储或上传服务,因此只接受可公开访问的图片地址。
- 所有图片地址输入统一使用预览控件,避免用户保存后才发现地址不可用。
- 后续接入媒体库时替换控件内部实现,不改变业务字段契约。
## 完成条件
- 品牌、业务提供项和信任内容统一使用图片预览控件。
- 不再使用 `URL` 技术术语作为普通用户字段标签。
- build、typecheck 和 format check 通过。
@@ -0,0 +1,23 @@
# 进度
- 任务:普通用户图片资源配置
- 形态:epic
- 进度:3/3
- 当前:图片地址配置和预览已完成;后续可独立建设媒体库与上传服务。
## 已完成
- 品牌头像和品牌封面使用统一图片预览控件。
- 业务提供项封面使用统一图片预览控件。
- 信任内容配图使用统一图片预览控件。
- 普通用户标签改为“图片地址 / 配图地址”,不再显示 `URL`。
## 验证
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm typecheck`:通过。
- `pnpm format:check`:通过。
## 后续边界
文件上传需要对象存储、访问权限、大小和格式限制、删除策略以及品牌隔离,不能在当前仅有 URL 字段的基础上伪装实现;应作为独立媒体库任务推进。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,统一图片地址和预览控件,single-full,,DONE,tasks/image-preview,四类普通用户图片配置复用同一控件,pnpm --filter @personal-brand/admin build,新增 ImageUrlField 并接入品牌、业务和信任内容
2,验证图片配置不影响业务契约,single-full,1,DONE,tasks/contract-regression,全仓类型和格式检查通过,pnpm typecheck && pnpm format:check,已通过
3,记录上传能力边界,single-full,1;2,DONE,tasks/delivery,明确当前未实现文件上传且保留后续替换边界,pnpm --filter @personal-brand/admin build,已记录在 EPIC 和 PROGRESS
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 统一图片地址和预览控件 single-full DONE tasks/image-preview 四类普通用户图片配置复用同一控件 pnpm --filter @personal-brand/admin build 新增 ImageUrlField 并接入品牌、业务和信任内容
3 2 验证图片配置不影响业务契约 single-full 1 DONE tasks/contract-regression 全仓类型和格式检查通过 pnpm typecheck && pnpm format:check 已通过
4 3 记录上传能力边界 single-full 1;2 DONE tasks/delivery 明确当前未实现文件上传且保留后续替换边界 pnpm --filter @personal-brand/admin build 已记录在 EPIC 和 PROGRESS
@@ -0,0 +1,18 @@
# 普通用户业务提供项配置
## 目标
让不懂技术的品牌使用者可以用业务语言维护服务、产品或套餐,并安全地影响小程序公开展示。
## 边界
- 普通用户只接触名称、介绍、价格、封面、顺序和公开状态。
- `sections`、`media`、`cta` 等模板结构继续由系统和管理员维护,不出现在普通用户表单中。
- 禁用后不进入公开 workspace;存在关联咨询表单时禁止删除。
## 完成条件
- 后台编辑器不暴露内部配置字段。
- 编辑普通字段不会覆盖已有模板详情配置。
- API 授权、品牌隔离、启用状态和删除保护测试通过。
- admin build、格式化和类型检查通过。
@@ -0,0 +1,18 @@
# 进度
- 任务:普通用户业务提供项配置
- 形态:epic
- 进度:3/3
- 当前:本轮普通用户业务提供项配置已完成,下一步进入图片资源和咨询表单的易用化。
## 已完成
- 移除普通用户表单中的 `sections`、`media`、`cta` 内部结构。
- 编辑时仅回填和提交用户可理解的业务字段,避免覆盖模板详情配置。
- 删除增加二次确认,并保留关联咨询表单时由 API 阻止删除。
## 验证
- `pnpm --filter @personal-brand/api test:integration`:31/31 通过。
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm exec prettier --check apps/admin/src/features/services/ServicesPage.tsx`:通过。
@@ -0,0 +1,4 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,收敛普通用户业务提供项编辑器,single-full,,DONE,tasks/user-facing-editor,表单仅展示业务字段且编辑不回传内部配置,pnpm --filter @personal-brand/admin build,已移除 sections、media、cta 编辑控件,并限制编辑回填字段
2,验证业务提供项生命周期,single-full,1,DONE,tasks/lifecycle-regression,启用、禁用、删除保护和公开 workspace 行为有自动化验证,pnpm --filter @personal-brand/api test:integration,现有 offering 生命周期测试 31/31 通过,覆盖禁用隐藏和关联表单删除保护
3,更新交付记录,single-full,1;2,DONE,tasks/delivery,任务进度和验证结果落盘,pnpm format:check && pnpm typecheck,admin build、API integration、format 均通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 收敛普通用户业务提供项编辑器 single-full DONE tasks/user-facing-editor 表单仅展示业务字段且编辑不回传内部配置 pnpm --filter @personal-brand/admin build 已移除 sections、media、cta 编辑控件,并限制编辑回填字段
3 2 验证业务提供项生命周期 single-full 1 DONE tasks/lifecycle-regression 启用、禁用、删除保护和公开 workspace 行为有自动化验证 pnpm --filter @personal-brand/api test:integration 现有 offering 生命周期测试 31/31 通过,覆盖禁用隐藏和关联表单删除保护
4 3 更新交付记录 single-full 1;2 DONE tasks/delivery 任务进度和验证结果落盘 pnpm format:check && pnpm typecheck admin build、API integration、format 均通过
@@ -0,0 +1,14 @@
# 进度
- 任务:视觉模板兼容性约束
- 形态:single-full
- 进度:3/3
- 当前:视觉模板兼容性约束完成
- 真相文件:`TODO.csv`
## 恢复信息
- 已完成:视觉模板 definition 与 manifest 增加 `supportedIndustryTemplates`,兼容关系由配置声明。
- 已完成:目录、组合预览、管理员实际切换统一执行兼容性校验;餐饮不能选择林境建筑画册。
- 已完成:后台视觉模板选择器和组合预览仅展示当前行业可用模板。
- 验证:API integration `36/36`、全仓 typecheck、Prettier format check 通过;Admin production build 已在前序回归通过。
@@ -0,0 +1,19 @@
# 视觉模板兼容性约束
## 目标
让视觉模板对行业模板的适配关系成为显式声明,并在目录、组合预览和实际切换时统一校验。
## 决策
- `linjing-editorial` 适配 `personal`、`doors`,不作为餐饮视觉模板。
- `minimal-neutral` 适配 `personal`、`food`、`doors`。
- 兼容性由视觉模板 manifest 声明,不能在 Controller 中写行业分支。
- API 拒绝不兼容组合;后台只展示当前行业可用视觉模板。
## 验收
- 视觉目录返回兼容行业列表。
- 不兼容的组合预览和切换返回明确 `400`。
- 兼容模板切换行为保持不变。
- API integration、Admin build、format、typecheck 通过。
@@ -0,0 +1,4 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,增加视觉模板兼容声明与校验函数,DONE,config manifest 明确支持的行业模板,pnpm --filter @personal-brand/config typecheck,2026-09-24,0,兼容关系由 manifest 声明
2,接入 API 目录预览与切换校验,DONE,不兼容组合无法预览或保存,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,不兼容组合返回 400;兼容组合保持成功
3,更新后台选择器与全量回归,DONE,后台只显示当前行业可用模板,pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/admin build,2026-09-24,0,API integration 36/36 通过;类型与格式通过
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 增加视觉模板兼容声明与校验函数 DONE config manifest 明确支持的行业模板 pnpm --filter @personal-brand/config typecheck 2026-09-24 0 兼容关系由 manifest 声明
3 2 接入 API 目录预览与切换校验 DONE 不兼容组合无法预览或保存 pnpm --filter @personal-brand/api test:integration 2026-09-24 0 不兼容组合返回 400;兼容组合保持成功
4 3 更新后台选择器与全量回归 DONE 后台只显示当前行业可用模板 pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/admin build 2026-09-24 0 API integration 36/36 通过;类型与格式通过
@@ -3,7 +3,7 @@
- 任务:小程序视觉模板包体系
- 形态:epic
- 进度:5/5
- 当前:视觉模板包体系本轮完成
- 当前:本 Epic 已完成,下一阶段应进入模板选择与内容配置的真实业务验收
- 真相文件:`SUBTASKS.csv`
## 恢复信息
@@ -12,8 +12,11 @@
- 已新增 `VisualTemplateManifest`、`TemplatePackage`、页面/模块/资源/数据槽位和设计 token 类型。
- 已将林境模板登记为 7 个核心页面的正式 manifest,并保留个人品牌主线、行业解耦和能力依赖。
- `pnpm format:check`、`pnpm --filter @personal-brand/config typecheck`、`git diff --check` 已通过。
- 小程序 workspace 现在消费 `visualTemplateManifest`,将 manifest 页面模块解析为运行时模块和首页布局,并兼容旧版 `layout`。
- API workspace 返回完整视觉 manifest,API integration 28/28、Miniapp fixture 和 visual fixture 已通过。
- 模板安装快照现在包含行业模板、视觉 manifest 和能力依赖;现有示例内容导入流程保持幂等并纳入安装验收。
- 全量门禁通过:`format:check`、`lint`、`typecheck`、`build`、API integration 28/28、Miniapp fixture 和 visual fixture。
- lint 仅保留既有测试文件中的 6 个 `any` warning,无 error。
- 已发现:先前仅验证 manifest 形状,没有验证静态设计中的顶部主理人信息和信任区数据投影,也没有达到林境静态页的视觉还原要求。
- 当前修复:API 正式投影品牌身份与信任呈现数据;seed 由模板声明注册表驱动,消除按行业 key 的共享逻辑分支;首页开始渲染工艺支柱与履约流程。
- 本轮新增:林境的完整作品规格、履约资料和咨询字段由模板初始数据声明导入;小程序移除了静默回退到过期静态数据的路径,改为同品牌 workspace 缓存与明确错误状态。已确认 `172.16.6.123:3001` 的 `linjing-doors` workspace 返回 4 个完整作品、品牌资料、信任内容和表单字段。
- 内容审计:林境首页、作品、详情、咨询、提交成功、记录与“主理人与我”的业务文案均已改为读取 `brand.visualPresentation`、`trustPresentation`、`offerings` 或 `inquiryForms`。布局、图标和通用交互仍保留在视觉组件中。API 集成测试覆盖了关键 presentation 文案下发。
- 视觉验收限制:本机微信开发者工具 CLI 不提供可脚本化截图能力;文本 fixture 只能验证页面绑定和结构。用户已确认首页、作品、详情、咨询、成功、记录、我的页面均能正常显示。
- 2026-09-23:数据真实性复核完成。小程序业务内容来自 `public/workspace`,图片来自 workspace brand/offering 数据,表单来自 `inquiryForms`,咨询记录来自客户 API;已删除未使用的 `linjingInquiryRecords` 本地假数据读取。客户微信会话改为携带 `brandSlug`,服务端按请求品牌签发 token,并在集成测试中验证林境品牌隔离。
- 2026-09-23:通用组件的林境业务硬编码已清理,联系人标签、信任标题、流程标题和作品区文案改由 presentation slot 输入;fixture 增加品牌会话隔离与静态业务词泄漏检查。
- 2026-09-23:全量回归完成:`format:check`、`lint`、`typecheck`、`build`、API 集成测试 `30/30`、miniapp fixture、visual-fixture 和 `git diff --check` 全部通过。lint 仅有既存测试文件的 6 个 `any` warning,无新增 error。
@@ -1,6 +1,6 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,定义视觉模板包契约,single-full,,DONE,tasks/contract,VisualTemplateManifest 和 TemplatePackage 类型及契约说明完成,pnpm format:check && pnpm --filter @personal-brand/config typecheck,共享契约和 ADR 已完成
2,将林境静态设计映射为正式视觉模板,single-full,1,DONE,tasks/linjing-mapping,林境核心页面和资源数据映射到 manifest,pnpm --filter @personal-brand/config typecheck,7 个页面、模块变体、资源槽位、数据槽位和能力依赖已登记
3,改造小程序按 manifest 和 variant 渲染,single-full,1;2,DONE,tasks/miniapp-renderer,小程序不再依赖行业硬编码页面结构,pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture,运行时解析 visualTemplateManifest,保留旧 workspace 兼容
3,改造小程序按 manifest 和 variant 渲染,single-full,1;2,DONE,tasks/miniapp-renderer,小程序按 manifest 和 variant 渲染且林境视觉与数据完整,pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture,用户已在微信开发者工具确认核心页面正常显示;数据链路与多品牌客户会话已验证
4,初始数据导入与模板安装快照,single-full,1;2,DONE,tasks/installation,新品牌可安装模板并导入初始内容且生成快照,pnpm --filter @personal-brand/api test:integration,安装快照包含行业模板、视觉 manifest 和能力依赖;示例内容导入保持幂等
5,视觉与全量回归,single-full,1;2;3;4,DONE,tasks/regression,接口、构建、fixture 和视觉回归全部通过,pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,全部门禁通过;lint 保留 6 个既有 any warning
5,视觉与全量回归,single-full,1;2;3;4,DONE,tasks/regression,接口、构建、fixture 和视觉回归全部通过,pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,用户页面验收通过;全量工程门禁与 API 30/30 集成测试通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 定义视觉模板包契约 single-full DONE tasks/contract VisualTemplateManifest 和 TemplatePackage 类型及契约说明完成 pnpm format:check && pnpm --filter @personal-brand/config typecheck 共享契约和 ADR 已完成
3 2 将林境静态设计映射为正式视觉模板 single-full 1 DONE tasks/linjing-mapping 林境核心页面和资源数据映射到 manifest pnpm --filter @personal-brand/config typecheck 7 个页面、模块变体、资源槽位、数据槽位和能力依赖已登记
4 3 改造小程序按 manifest 和 variant 渲染 single-full 1;2 DONE tasks/miniapp-renderer 小程序不再依赖行业硬编码页面结构 小程序按 manifest 和 variant 渲染且林境视觉与数据完整 pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture 运行时解析 visualTemplateManifest,保留旧 workspace 兼容 用户已在微信开发者工具确认核心页面正常显示;数据链路与多品牌客户会话已验证
5 4 初始数据导入与模板安装快照 single-full 1;2 DONE tasks/installation 新品牌可安装模板并导入初始内容且生成快照 pnpm --filter @personal-brand/api test:integration 安装快照包含行业模板、视觉 manifest 和能力依赖;示例内容导入保持幂等
6 5 视觉与全量回归 single-full 1;2;3;4 DONE tasks/regression 接口、构建、fixture 和视觉回归全部通过 pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration 全部门禁通过;lint 保留 6 个既有 any warning 用户页面验收通过;全量工程门禁与 API 30/30 集成测试通过
@@ -2,5 +2,9 @@
- 状态:DONE
- 依赖:视觉模板包契约、林境模板映射和用户验收
- 结果:公共 workspace 返回视觉 manifest;Miniapp runtime 按 manifest 页面和模块 variant 解析,并保留旧 workspace fallback。
- 验证:`pnpm --filter @personal-brand/api test:integration`、`pnpm --filter @personal-brand/miniapp test:fixture`、`pnpm --filter @personal-brand/miniapp test:visual-fixture`
- 已发现静态设计还原缺口,不能以 manifest 返回和 fixture 通过作为完成标准。
- 当前方向:删除不必要的旧契约兼容思路,使用模板声明数据和视觉模块完成林境首页还原。
- 2026-09-23:运行时 seed 已补齐林境 4 个作品、详情规格、联系资料和动态表单;作品、详情与“主理人与我”页面已接入对应数据。API 请求失败不再静默返回不完整的静态 fallback,而是使用同品牌缓存或显示错误状态。待微信开发者工具截图对照静态基准。
- 2026-09-23:完成业务静态文案审计。林境专属页面的行业标题、履约说明、转化文案和空状态均通过 `brand.visualPresentation` 下发;不再由 WXML 写死。运行时 API 测试与小程序 fixture 已通过,待 7 页截图对照。
- 2026-09-23:复核数据来源并修复多品牌客户会话。`customer/session/wechat` 现在使用请求中的 `brandSlug`,小程序 token 按品牌缓存;“主理人与我”记录数改为读取客户咨询 API,不再读取不存在的行业专属本地 key。集成测试 30/30、fixture 和 visual-fixture 均通过。
- 2026-09-23:用户在微信开发者工具确认核心页面显示正常,子任务收口,后续进入全量工程回归。