feat: 收口多品牌与模板构建基础
This commit is contained in:
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,
|
||||
|
@@ -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 通过
|
||||
|
@@ -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,已记录
|
||||
|
@@ -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,包含发布快照和品牌隔离回归
|
||||
|
@@ -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 已清理
|
||||
|
@@ -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
|
||||
|
+7
@@ -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 通过
|
||||
|
@@ -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
|
||||
|
@@ -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 通过
|
||||
|
@@ -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 隔离已验证,
|
||||
|
@@ -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 通过
|
||||
|
@@ -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 基线
|
||||
|
@@ -0,0 +1,5 @@
|
||||
# 子任务记录
|
||||
|
||||
- 状态:DONE
|
||||
- 变更:执行 migration、seed 并恢复 integration 后的 demo 基线。
|
||||
- 验证:`pnpm format:check`、`pnpm typecheck`、Admin production build 均通过。
|
||||
+5
@@ -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
|
||||
|
@@ -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 通过
|
||||
|
@@ -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
|
||||
|
@@ -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 通过
|
||||
|
@@ -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 和格式检查通过
|
||||
|
@@ -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、类型和格式门禁均已通过
|
||||
|
@@ -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,
|
||||
|
@@ -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 均通过
|
||||
|
@@ -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 通过
|
||||
|
@@ -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
|
||||
|
@@ -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 均通过
|
||||
|
@@ -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 通过;类型与格式通过
|
||||
|
@@ -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 集成测试通过
|
||||
|
@@ -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:用户在微信开发者工具确认核心页面显示正常,子任务收口,后续进入全量工程回归。
|
||||
Reference in new issue
Block a user