Compare commits
150
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
c5af790554 | ||
|
|
9d2038cc93 | ||
|
|
056e7d3711 | ||
|
|
b3e37827cf | ||
|
|
32e2112caf | ||
|
|
fce7ad0c57 | ||
|
|
f324b663a6 | ||
|
|
e5a1a60eee | ||
|
|
7e8fc01fba | ||
|
|
f4061a24bd | ||
|
|
20bcb43534 | ||
|
|
868775c1c0 | ||
|
|
9266ec824a | ||
|
|
2bc2193b44 | ||
|
|
37e898a4b9 | ||
|
|
ae2eb08fca | ||
|
|
f603719b2d | ||
|
|
07d3790aa8 | ||
|
|
d7e5b64d84 | ||
|
|
34b872a84c | ||
|
|
0c5ff79b42 | ||
|
|
5ed06b1abe | ||
|
|
e3a4074d8e | ||
|
|
6d7fae95b3 | ||
|
|
774ae2c8e3 | ||
|
|
55989a5dfe | ||
|
|
a97cc860cf | ||
|
|
e2e2340bfe | ||
|
|
25d1fe983c | ||
|
|
c46297b13b | ||
|
|
9b61047ec6 | ||
|
|
d5e63be074 | ||
|
|
17bd700c2b | ||
|
|
6218ed395b | ||
|
|
dd55af8d73 | ||
|
|
77224ea51f | ||
|
|
0425a1c672 | ||
|
|
ce958fc1ae | ||
|
|
031c81a7c1 | ||
|
|
241c19812f | ||
|
|
f7fe6d6b20 | ||
|
|
dcb40f629b | ||
|
|
1a2f179e15 | ||
|
|
11dc293349 | ||
|
|
e2409c0848 | ||
|
|
4902a564f0 | ||
|
|
178ffc2c11 | ||
|
|
98e66a60de | ||
|
|
41ab3b6d23 | ||
|
|
464c706021 | ||
|
|
cbe9d26288 | ||
|
|
045472035b | ||
|
|
f4a93bba23 | ||
|
|
ee7f64c5f3 | ||
|
|
4c8bda57b1 | ||
|
|
1ea757555d | ||
|
|
a8a37c179e | ||
|
|
d6c47ce143 | ||
|
|
ef0aa169a6 | ||
|
|
c62e3aa5f0 | ||
|
|
54bf385f68 | ||
|
|
aee1cff5a3 | ||
|
|
6d2c12c3df | ||
|
|
3186757d93 | ||
|
|
b299c313d1 | ||
|
|
9bbb748114 | ||
|
|
ba0069ae6d | ||
|
|
16b0967dc5 | ||
|
|
52f741cc2c | ||
|
|
15df8ed821 | ||
|
|
044f2cd530 | ||
|
|
40b8cd6431 | ||
|
|
aeb1605a2a | ||
|
|
ff5dc4e3ba | ||
|
|
e89b751572 | ||
|
|
1afa7626cf | ||
|
|
d5e1543e60 | ||
|
|
6835a2b0fd | ||
|
|
9ef91194df | ||
|
|
f790e7d707 | ||
|
|
7451268e59 | ||
|
|
ee3bd9051b | ||
|
|
fef0a890ad | ||
|
|
3f42388fb3 | ||
|
|
b525c4d29a | ||
|
|
bfa24d48d0 | ||
|
|
947e6d1ac3 | ||
|
|
accc113b2a | ||
|
|
cd9784b59c | ||
|
|
c5698aa238 | ||
|
|
a05c578766 | ||
|
|
4b455f5688 | ||
|
|
9b1c500c5f | ||
|
|
d451c93398 | ||
|
|
cd9352a849 | ||
|
|
286aad2955 | ||
|
|
041a6a7f02 | ||
|
|
8b85cc0403 | ||
|
|
940dc4d6a3 | ||
|
|
b3e2ece41b | ||
|
|
8a02d09e2d | ||
|
|
0fb96bdea3 | ||
|
|
1f792bd622 | ||
|
|
21c40b8e10 | ||
|
|
3bc19c36a7 | ||
|
|
23860b69c9 | ||
|
|
366687297f | ||
|
|
38a1ebcb5a | ||
|
|
9e8eee8258 | ||
|
|
bf62701874 | ||
|
|
c6679b9de0 | ||
|
|
80ef03b792 | ||
|
|
e6a06883ae | ||
|
|
13a2d3c676 | ||
|
|
0f35cab436 | ||
|
|
8ecd94c26a | ||
|
|
5b55f2424e | ||
|
|
f9c63a6895 | ||
|
|
6c049b8672 | ||
|
|
4c9f9a05d0 | ||
|
|
6e8a49162c | ||
|
|
0d98d23892 | ||
|
|
a30c939f90 | ||
|
|
a951504563 | ||
|
|
6ce162345c | ||
|
|
4810ed7bde | ||
|
|
facf261bd6 | ||
|
|
4a6cd3adc6 | ||
|
|
65f0e0c92a | ||
|
|
9feea651a0 | ||
|
|
4339e73819 | ||
|
|
75ca6a6642 | ||
|
|
eef3478a9d | ||
|
|
090aab5acb | ||
|
|
99f638318d | ||
|
|
39f60ddfc9 | ||
|
|
4f48f69625 | ||
|
|
b8186652e6 | ||
|
|
48f64a85c5 | ||
|
|
3d3e8c95f5 | ||
|
|
0c4efdef1a | ||
|
|
777bdaa766 | ||
|
|
0867585f65 | ||
|
|
cdce8227bc | ||
|
|
7dc72b4a48 | ||
|
|
c3df77e227 | ||
|
|
53ee034db8 | ||
|
|
f9ca5b1fea | ||
|
|
40b08b5e1d | ||
|
|
6c3eb3bfca |
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,7 @@
|
||||
# 执行记录
|
||||
|
||||
- 任务:将后台高级设置默认视图改为普通品牌管理员可理解的业务语言。
|
||||
- 形态:single-full
|
||||
- 进度:3/3
|
||||
- 完成:运行时状态、能力展示、模板预览、自定义字段均已收敛技术细节;内部字段 Key 自动生成。
|
||||
- 验证:Admin production build、全量 typecheck、lint、format、`git diff --check` 通过。
|
||||
@@ -0,0 +1,12 @@
|
||||
# 后台高级设置业务化
|
||||
|
||||
## 目标
|
||||
|
||||
降低普通品牌管理员使用“模板与设置”页面的技术认知负担,保留负责人需要的高级能力,但默认以业务语言呈现。
|
||||
|
||||
## 范围
|
||||
|
||||
- 运行时状态展示改为小程序同步状态、公开业务数量和启用能力数量。
|
||||
- 能力列表不再显示 API contract、Schema、模块依赖等内部实现字段。
|
||||
- 模板组合预览标注为高级预览并说明日常配置无需使用。
|
||||
- 自定义字段列表使用业务语言;内部 Key 自动生成,不要求管理员理解技术命名。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,业务化运行时与高级设置展示,DONE,默认页面不展示 API contract、Schema 和模块依赖并保留负责人入口,pnpm --filter @personal-brand/admin build,2026-09-27,0,
|
||||
2,业务化自定义字段编辑,DONE,列表显示业务概念且新增字段自动生成内部 key,pnpm typecheck,2026-09-27,0,
|
||||
3,完成质量门禁,DONE,Admin build、typecheck、lint、format 和 diff 检查通过,pnpm format:check,2026-09-27,0,
|
||||
|
@@ -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,7 @@
|
||||
# 执行记录
|
||||
|
||||
- 任务:降低普通品牌管理员创建和编辑咨询表单的理解成本。
|
||||
- 形态:single-full
|
||||
- 进度:3/3
|
||||
- 结果:新增表单提供可直接使用的默认字段,编辑器文案和空状态已业务化,保存与发布边界明确。
|
||||
- 验证:Admin production build、全量 typecheck、lint、format、`git diff --check` 通过。
|
||||
@@ -0,0 +1,12 @@
|
||||
# 咨询表单编辑体验
|
||||
|
||||
## 目标
|
||||
|
||||
让普通品牌管理员能够从可用默认项开始创建咨询表单,并理解表单用途、关联业务和客户填写项的含义。
|
||||
|
||||
## 范围
|
||||
|
||||
- 新建表单预填合作咨询名称、称呼、联系电话和需求说明。
|
||||
- 表单用途、关联业务、字段列表使用清楚的业务文案和辅助说明。
|
||||
- 空列表提示如何开始;编辑已有表单前清理旧表单状态。
|
||||
- 明确保存草稿后仍需在发布页发布才会对小程序生效。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,提供开箱可用的默认咨询表单,DONE,新建时预填称呼联系电话和需求说明字段,pnpm --filter @personal-brand/admin build,2026-09-27,0,
|
||||
2,完善表单业务语义和状态提示,DONE,用途、业务关联、字段及草稿发布边界有清晰说明,pnpm --filter @personal-brand/admin build,2026-09-27,0,
|
||||
3,完成质量门禁,DONE,Admin build、typecheck、lint、format 和 diff 检查通过,pnpm format:check,2026-09-27,0,
|
||||
|
@@ -0,0 +1,7 @@
|
||||
# 执行记录
|
||||
|
||||
- 任务:完善信任内容的模板驱动配置工作流。
|
||||
- 形态:single-full
|
||||
- 进度:3/3
|
||||
- 结果:模板要求、内容状态和新增/编辑动作已在同一页形成闭环。
|
||||
- 验证:Admin production build、全量 typecheck、lint、format、`git diff --check` 通过。
|
||||
@@ -0,0 +1,12 @@
|
||||
# 信任内容配置工作流
|
||||
|
||||
## 目标
|
||||
|
||||
让普通品牌管理员明确知道当前模板需要哪些信任内容、哪些内容已经完成,以及发布前还缺什么。
|
||||
|
||||
## 范围
|
||||
|
||||
- 使用模板声明的信任类型、行业化名称、说明和 required 标记。
|
||||
- 显示每类内容的完整状态,并提供新增/编辑入口。
|
||||
- 新增内容默认优先选择尚未填写的必需类型。
|
||||
- 空列表显示明确的下一步说明。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,展示模板信任内容要求,DONE,管理员能看到每个类型的业务名称、说明、必需标记和完成状态,pnpm --filter @personal-brand/admin build,2026-09-27,0,
|
||||
2,补齐新增编辑入口,DONE,缺失类型可直接新增且默认优先选择未填写必需类型,pnpm typecheck,2026-09-27,0,
|
||||
3,完成质量门禁,DONE,Admin build、typecheck、lint、format 和 diff 检查通过,pnpm format:check,2026-09-27,0,
|
||||
|
@@ -0,0 +1,25 @@
|
||||
# 执行记录
|
||||
|
||||
## 恢复信息
|
||||
|
||||
- 任务:加固后台管理员日常配置路径的可用性。
|
||||
- 形态:single-full
|
||||
- 进度:0/3
|
||||
- 当前:修正概览页品牌与模板语义。
|
||||
- 文件:`.codex-tasks/admin-usability-pass/TODO.csv`
|
||||
- 下一步:完成概览、业务项和信任内容页面改动并运行 Admin 门禁。
|
||||
|
||||
## 结果
|
||||
|
||||
- 概览页从当前 workspace 的模板声明读取模板名称,不再把所有非餐饮模板错误显示为个人品牌。
|
||||
- 完整度检查中的未完成项提供“去处理”入口,直接进入对应品牌、信任内容、业务项或表单配置页面。
|
||||
- 业务提供项启用、停用、删除失败会显示错误;操作期间仅锁定当前条目,成功后提示并刷新列表。
|
||||
- 信任内容列表使用当前模板声明的行业化类型名称,避免列表文案与编辑表单不一致。
|
||||
- 验证:Admin production build、typecheck、lint、format、`git diff --check` 通过。
|
||||
|
||||
## 二次可用性加固
|
||||
|
||||
- 概览页直接读取发布 readiness,显示完成百分比、阻塞发布的具体原因和逐项处理入口,不再使用与发布规则脱节的静态建议。
|
||||
- readiness 检查和旧版 fallback 检查先归一化为统一显示模型,避免不同数据来源导致页面类型和行为不一致。
|
||||
- 后台侧栏支持窄屏断点收起,顶部显示当前品牌管理员角色,减少多品牌和多人协作时的上下文误判。
|
||||
- 验证:Admin production build、全量 typecheck、lint、format、`git diff --check` 通过。
|
||||
@@ -0,0 +1,17 @@
|
||||
# Admin 可用性加固
|
||||
|
||||
## 目标
|
||||
|
||||
改善普通品牌管理员最常用的后台路径,让概览、业务提供项和信任内容页面准确反映当前品牌与模板,并把失败操作明确反馈给用户。
|
||||
|
||||
## 范围
|
||||
|
||||
- 概览页使用 Admin Workspace 的模板声明显示模板名称,不再硬编码行业判断。
|
||||
- 概览完整度检查提供可直接进入对应配置页面的处理按钮。
|
||||
- 业务提供项的启用、停用、删除失败显示可读错误,操作期间避免重复提交。
|
||||
- 信任内容列表使用当前模板声明的类型名称和说明。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不调整 API 契约和数据库模型。
|
||||
- 不新增视觉模板或公共 runtime 组件。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,修正概览页品牌与模板语义,DONE,模板名称来自 workspace 声明且完整度条目可跳转处理,pnpm --filter @personal-brand/admin build,2026-09-27,0,
|
||||
2,补齐业务项和信任内容错误反馈,DONE,启停/删除失败可见且信任类型列表使用当前模板文案,pnpm --filter @personal-brand/admin build,2026-09-27,0,上一轮已完成
|
||||
3,完成后台可用性回归,DONE,Admin build、typecheck、lint、format 和 diff 检查通过,pnpm --filter @personal-brand/admin build,2026-09-27,0,本轮增加 readiness 工作台、响应式侧栏和角色上下文;全量门禁通过
|
||||
|
@@ -0,0 +1,7 @@
|
||||
# 执行记录
|
||||
|
||||
- 任务:重整模板与表单设置页的信息架构。
|
||||
- 形态:single-full
|
||||
- 进度:3/3
|
||||
- 结果:日常配置入口前置,模板和负责人设置明确标注,页面名称和导航同步更新。
|
||||
- 验证:Admin production build、全量 typecheck、lint、format、`git diff --check` 通过。
|
||||
@@ -0,0 +1,12 @@
|
||||
# 后台设置页信息架构
|
||||
|
||||
## 目标
|
||||
|
||||
让普通品牌管理员进入设置页后先看到日常配置入口,再看到模板和负责人级高级设置,降低页面职责混杂带来的困惑。
|
||||
|
||||
## 范围
|
||||
|
||||
- 将页面命名为“模板与表单设置”,说明日常配置与负责人设置的边界。
|
||||
- 增加品牌表达、业务提供项、信任内容和发布的直接入口。
|
||||
- 将运行时状态改成“小程序当前状态”等业务表达。
|
||||
- 将模板组合预览标记为高级预览,自定义字段标记为负责人设置。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,增加日常配置入口与页面说明,DONE,设置页顶部直接进入品牌表达、业务提供项、信任内容和发布,pnpm --filter @personal-brand/admin build,2026-09-27,0,
|
||||
2,区分状态与高级设置,DONE,运行时状态、模板预览、自定义字段使用业务化标题并标注负责人范围,pnpm typecheck,2026-09-27,0,
|
||||
3,完成质量门禁,DONE,Admin build、typecheck、lint、format 和 diff 检查通过,pnpm format:check,2026-09-27,0,
|
||||
|
@@ -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,17 @@
|
||||
# 进度
|
||||
|
||||
- 任务:品牌友好内容工作台与模板契约增强
|
||||
- 形态:epic
|
||||
- 进度:5/5
|
||||
- 当前:5 个自动化子任务完成,等待用户人工验收;Epic 尚未关闭。
|
||||
- 真相文件:`SUBTASKS.csv`
|
||||
|
||||
## Context Recovery Block
|
||||
|
||||
- 当前子任务:最终全量验证
|
||||
- 当前状态:自动化完成,待人工验收
|
||||
- 已完成:#1 契约、#2 RuntimeWorkspace 投影、#3 发布模板适配校验、#4 品牌友好内容工作台、#5 双模板回归;API 集成测试 37 项通过。
|
||||
- 关键背景:阿成和林境静态视觉验收通过,但 RuntimeWorkspace、发布校验和 Admin 编辑仍不足以支撑大量差异化模板。
|
||||
- 已解决风险:导航和 offering 展示属性按 package 快照投影;Admin 编辑声明仅进入受保护 workspace,public Runtime 不暴露;模板目录指纹校验可发现生成产物过期。
|
||||
- 后续事项:Admin production build 的 `api` chunk 约 667 KB,超过 Vite 500 KB 提示线;建议另开 Admin 路由级代码拆分任务,本 Epic 不以此阻塞验收。
|
||||
- 下一步:用户验收阿成/林境 Admin 品牌表达页及发布体验;按反馈修订后再关闭 Epic。自动化验证通过不代替实际 UI 操作验收。
|
||||
@@ -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,DONE,,tasks/template-admin-contract,manifest 声明数据槽位资产槽位字段语义和通俗编辑文案,pnpm --filter @personal-brand/template-contract typecheck,2026-09-25,0,不引入模板专属后端 if else
|
||||
2,RuntimeWorkspace 完整投影,single-full,DONE,1,tasks/runtime-workspace-projection,导航和 offering presentation/assets 完整且品牌隔离,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,37 项通过
|
||||
3,发布模板适配校验,single-full,DONE,1;2,tasks/publication-compatibility,发布前给出可行动缺失提示并写入快照,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,缺失内容拦截及修复流程通过
|
||||
4,品牌友好内容工作台,single-full,DONE,1;2;3,tasks/brand-content-workbench,普通品牌管理员可按业务语言配置并发布,pnpm --filter @personal-brand/admin build,2026-09-25,0,声明驱动编辑;仅写 brand.config binding;Admin 单测和 API 集成通过
|
||||
5,双模板回归与验收,single-full,DONE,1;2;3;4,tasks/template-e2e-regression,阿成和林境品牌数据与模板产物均正确,pnpm test:template-compiler,2026-09-25,0,包含 Admin 声明品牌隔离、public 隔离、原生 tabbar 和发布契约回归
|
||||
|
+27
@@ -0,0 +1,27 @@
|
||||
# 进度
|
||||
|
||||
- 任务:品牌友好内容工作台
|
||||
- 形态:single-full
|
||||
- 进度:4/4
|
||||
- 当前:完成,进入双模板回归。
|
||||
- 真相文件:`TODO.csv`
|
||||
|
||||
## 结果
|
||||
|
||||
- `GET /admin/workspace` 按当前会话品牌的 `visualTemplateKey` 返回模板 `displayName`、通俗编辑分组和图片槽位。
|
||||
- Admin 页面根据模板声明渲染不同分组、说明、字段、输入类型、必填和图片预览,不再硬编码模板页面字段。
|
||||
- 编辑器只处理 `brand.config.*` binding;按声明合并回已有品牌 config,保留其它顶层与嵌套内容,拒绝原型链路径。
|
||||
- 保存成功后刷新品牌、workspace、小程序 Runtime 和发布检查;请求失败时保留表单值并显示错误。
|
||||
- public Runtime 不暴露 Admin 编辑声明。
|
||||
|
||||
## 验证
|
||||
|
||||
- `pnpm --filter @personal-brand/api typecheck`
|
||||
- `pnpm --filter @personal-brand/admin test`,断言脚本通过,覆盖配置保留、嵌套 binding 和越界路径拒绝。
|
||||
- `pnpm --filter @personal-brand/admin build`
|
||||
- `pnpm validate:templates`
|
||||
- `pnpm --filter @personal-brand/api test:integration`,37 项通过。
|
||||
|
||||
## 偏差与修正
|
||||
|
||||
- 集成测试首次发现模板源文件和生成目录不同步,Admin 因此读不到新增的主图编辑项。运行 `pnpm generate:template-catalog` 后重跑验证通过;模板目录指纹校验会阻止以后带着过期生成目录交付。
|
||||
+14
@@ -0,0 +1,14 @@
|
||||
# 品牌友好内容工作台
|
||||
|
||||
## 目标
|
||||
|
||||
Admin 品牌表达编辑区按当前视觉模板的 `admin.sections` 和资产槽位显示字段。字段标题、帮助和输入类型全部来自模板声明,普通品牌管理员不接触内部 binding 或模板技术配置。
|
||||
|
||||
## 完成标准
|
||||
|
||||
- Admin workspace 返回当前品牌模板的编辑声明,按会话品牌隔离。
|
||||
- 品牌编辑页不再硬编码首页、案例、咨询等公共字段集合。
|
||||
- text、textarea、phone、image、number 均按声明渲染。
|
||||
- 保存只更新声明对应的品牌配置路径,保留其他品牌配置。
|
||||
- 保存失败保留用户输入,并提供可读错误;发布检查可跳转到对应编辑页。
|
||||
- Admin production build 与 API 授权集成测试通过。
|
||||
+5
@@ -0,0 +1,5 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,在 Admin workspace 提供品牌编辑声明,DONE,响应包含当前视觉模板的 sections 与 asset slots,pnpm --filter @personal-brand/api test:integration,2026-09-25,1,同步生成模板目录后通过;集成测试断言编辑声明
|
||||
2,声明驱动渲染品牌内容表单,DONE,阿成和林境显示不同业务文案与字段,pnpm --filter @personal-brand/admin build,2026-09-25,0,字段类型和业务文案完全来自当前模板声明
|
||||
3,按 binding 保存配置并保留输入,DONE,局部保存不会覆盖未编辑品牌配置,pnpm --filter @personal-brand/admin test,2026-09-25,0,覆盖嵌套更新、配置保留与越界 binding 拒绝
|
||||
4,验证权限品牌隔离和构建,DONE,Admin API 和生产构建通过,pnpm --filter @personal-brand/api test:integration,2026-09-25,1,37 项集成测试通过;缺少登录为 401、客户角色为 403
|
||||
|
+22
@@ -0,0 +1,22 @@
|
||||
# 进度
|
||||
|
||||
- 任务:发布模板适配校验
|
||||
- 形态:single-full
|
||||
- 进度:4/4
|
||||
- 当前:已完成,Epic 转入品牌友好内容工作台。
|
||||
- 真相文件:`TODO.csv`
|
||||
|
||||
## 结果
|
||||
|
||||
- 发布检查读取视觉模板 package 的必填字段和媒体槽位。
|
||||
- 缺少主理人信息、品牌主图、任一业务封面、咨询表单时阻止发布。
|
||||
- 每项缺失提示返回编辑入口与模板编写的操作说明,用户界面不展示 binding。
|
||||
- API 集成测试覆盖缺内容拦截、修复后发布、授权与品牌隔离。
|
||||
|
||||
## 验证
|
||||
|
||||
- `pnpm --filter @personal-brand/api typecheck`
|
||||
- `pnpm validate:templates`
|
||||
- `pnpm --filter @personal-brand/api test:integration`,37 项通过。
|
||||
- `pnpm --filter @personal-brand/admin build`
|
||||
- `pnpm format:check`
|
||||
+13
@@ -0,0 +1,13 @@
|
||||
# 发布模板适配校验
|
||||
|
||||
## 目标
|
||||
|
||||
发布前根据当前品牌安装的视觉模板声明检查必需内容、媒体和咨询配置,返回品牌管理员能直接处理的中文提示。
|
||||
|
||||
## 完成标准
|
||||
|
||||
- 校验读取 package manifest,不按 template key 分支。
|
||||
- 缺少图片、品牌介绍、业务提供项或可用咨询表单时禁止发布。
|
||||
- readiness 返回用户可读项目名和补充位置提示,不返回内部 binding 或 manifest key。
|
||||
- 发布快照同时记录被校验的模板 package manifest。
|
||||
- API 集成测试覆盖通过与失败场景、权限和品牌隔离。
|
||||
+5
@@ -0,0 +1,5 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,将图片槽位映射到业务字段,DONE,图片要求含内部绑定和用户可读建议,pnpm validate:templates,2026-09-25,0,通过
|
||||
2,实现声明驱动的发布检查,DONE,必填内容按 manifest 校验并返回通俗提示,pnpm --filter @personal-brand/api typecheck,2026-09-25,0,通过
|
||||
3,补足发布 readiness 测试,DONE,覆盖缺图缺主理人缺表单和成功发布,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,37 项通过
|
||||
4,更新任务与文档,DONE,契约和校验语义有记录且验证通过,pnpm format:check,2026-09-25,0,通过
|
||||
|
+24
@@ -0,0 +1,24 @@
|
||||
# 进度
|
||||
|
||||
- 任务:RuntimeWorkspace 完整投影
|
||||
- 形态:single-full
|
||||
- 进度:4/4
|
||||
- 当前:已完成,进入发布模板适配校验。
|
||||
- 真相文件:`TODO.csv`
|
||||
|
||||
## 结果
|
||||
|
||||
- 发布快照保存视觉模板 package manifest;Runtime 导航从快照投影,不再固定为三项。
|
||||
- 阿成输出 5 项导航,林境输出 3 项导航;公开 Runtime 不返回 Admin binding 清单。
|
||||
- offering 业务展示配置投影为 `presentation` 扩展字段,小程序 view model 原样保留。
|
||||
- 生成目录由 package `template.json` 产生,并以 SHA-256 指纹阻止目录过期。
|
||||
|
||||
## 验证
|
||||
|
||||
- `pnpm --filter @personal-brand/api typecheck`
|
||||
- `pnpm validate:templates`
|
||||
- `pnpm test:template-compiler`
|
||||
- `pnpm validate:template-release`
|
||||
- `node --test apps/miniapp/test/runtime-workspace.test.cjs`
|
||||
- `pnpm --filter @personal-brand/api test`
|
||||
- `pnpm --filter @personal-brand/api test:integration`,37 项通过。
|
||||
+18
@@ -0,0 +1,18 @@
|
||||
# RuntimeWorkspace 完整投影
|
||||
|
||||
## 目标
|
||||
|
||||
让已发布模板声明的数据槽位、媒体槽位、导航和业务提供项展示属性完整进入 `RuntimeWorkspace`,并保持品牌隔离。控制器只做投影,不能按模板 key 写分支。
|
||||
|
||||
## 完成标准
|
||||
|
||||
- 已发布快照中的模板内容契约可被 RuntimeWorkspace 消费。
|
||||
- 导航来自发布模板声明,阿成保留 5 项、林境保留 3 项。
|
||||
- offering 的 `presentation` 扩展属性不被控制器丢弃。
|
||||
- 增加集成测试覆盖两个品牌和未发布品牌隔离。
|
||||
|
||||
## 当前事实
|
||||
|
||||
- `PublicWorkspaceController` 当前固定返回 3 项导航。
|
||||
- `runtimeOfferings` 当前只投影少量 `presentation` 字段。
|
||||
- 发布快照已保存 visual manifest,尚未保存 package content contract。
|
||||
+5
@@ -0,0 +1,5 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,审计快照与 Runtime 类型,DONE,明确契约快照和 RuntimeWorkspace 的最小变化,rg -n "BrandReleaseSnapshot|RuntimeWorkspace|navigation" apps/api packages/types,2026-09-25,0,已确认快照需要 package contract,导航固定三项且 presentation 丢字段
|
||||
2,投影发布模板声明和导航,DONE,RuntimeWorkspace 返回快照模板契约及声明导航,pnpm --filter @personal-brand/api typecheck,2026-09-25,0,通过
|
||||
3,保留 offering 展示属性,DONE,presentation 扩展字段在 API 与小程序 view model 中保留,node --test apps/miniapp/test/runtime-workspace.test.cjs,2026-09-25,0,通过
|
||||
4,补充双品牌隔离测试,DONE,阿成林境导航和品牌数据隔离测试通过,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,37 项通过
|
||||
|
Can't render this file because it contains an unexpected character in line 2 and column 100.
|
+21
@@ -0,0 +1,21 @@
|
||||
# 进度
|
||||
|
||||
- 任务:模板与 Admin 内容契约
|
||||
- 形态:single-full
|
||||
- 进度:4/4
|
||||
- 当前:#1 已完成,Epic 转入 RuntimeWorkspace 完整投影。
|
||||
- 真相文件:`TODO.csv`
|
||||
|
||||
## 发现
|
||||
|
||||
- 当前 `PresentationEditor` 硬编码了一组跨模板字段,不能表达阿成的出摊信息和林境的项目案例语义。
|
||||
- 当前 package manifest 只覆盖构建、导航和 renderer,不能驱动发布检查或用户可见编辑界面。
|
||||
- `packages/config` 仍保留运行时 visual manifest;后续任务将把 package 内容契约投影进发布快照,避免按模板 key 分支。
|
||||
|
||||
## 验证
|
||||
|
||||
- `pnpm --filter @personal-brand/template-contract typecheck`
|
||||
- `pnpm validate:templates`
|
||||
- `pnpm test:template-compiler`
|
||||
- `pnpm validate:template-release`
|
||||
- `pnpm format:check`
|
||||
+16
@@ -0,0 +1,16 @@
|
||||
# 模板与 Admin 内容契约
|
||||
|
||||
## 目标
|
||||
|
||||
由每个视觉模板 package 声明自身需要的业务内容、媒体和品牌管理员编辑分组。平台只读取、校验与投影声明;不以模板 key 分支,不向品牌用户暴露 renderer、schema 或 JSON。
|
||||
|
||||
## 完成标准
|
||||
|
||||
- 两个现有模板都声明 data slots、asset slots 和通俗编辑区块。
|
||||
- 合约类型和校验能拒绝不完整的模板声明。
|
||||
- 记录模板 package 为编辑说明唯一来源的架构决策。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 本任务不改动 RuntimeWorkspace 投影、数据库或 Admin 页面。
|
||||
- 不实现新的小程序模板。
|
||||
+5
@@ -0,0 +1,5 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,审计现有模板与编辑字段,DONE,两模板的页面数据和当前 Admin 字段已归纳,rg -n "visualPresentation|presentation" packages/template-*,,0,完成于本轮
|
||||
2,定义并实现模板内容契约,DONE,合约包含数据槽位媒体槽位和通俗编辑区块,pnpm --filter @personal-brand/template-contract typecheck,2026-09-25,0,通过
|
||||
3,为阿成与林境声明编辑契约,DONE,两个 template.json 通过契约和发布校验,pnpm validate:templates,2026-09-25,0,通过
|
||||
4,记录 ADR 并验证,DONE,ADR 说明来源边界和迁移路径,pnpm format:check,2026-09-25,0,通过
|
||||
|
Can't render this file because it contains an unexpected character in line 2 and column 104.
|
+17
@@ -0,0 +1,17 @@
|
||||
# 进度
|
||||
|
||||
- 任务:双模板端到端回归
|
||||
- 形态:single-full
|
||||
- 进度:4/4
|
||||
- 当前:自动化回归通过;Epic 待最终全量验证和进度关闭。
|
||||
- 真相文件:`TODO.csv`
|
||||
|
||||
## 验证
|
||||
|
||||
- `pnpm --filter @personal-brand/api test:integration`,37 项通过;新增阿成/林境 Admin 声明品牌隔离断言、错误角色拒绝和 public manifest 隔离断言。
|
||||
- `node --test apps/miniapp/test/runtime-workspace.test.cjs`
|
||||
- `pnpm test:template-compiler`,两套真实产物通过:阿成 5 项原生 tabbar,林境 3 项原生 tabbar,入口、renderer 和页面清理均符合声明。
|
||||
- `pnpm validate:templates`
|
||||
- `pnpm validate:template-release`
|
||||
- `pnpm --filter @personal-brand/admin test`
|
||||
- `pnpm --filter @personal-brand/admin build`
|
||||
+13
@@ -0,0 +1,13 @@
|
||||
# 双模板端到端回归
|
||||
|
||||
## 目标
|
||||
|
||||
验证阿成校园餐与林境建筑画册作为独立视觉模板时,模板声明、Admin 编辑项、品牌数据隔离、Runtime 投影、发布快照和小程序构建均保持一致。
|
||||
|
||||
## 完成标准
|
||||
|
||||
- Admin workspace 根据当前品牌返回对应模板编辑清单,品牌切换不会串用另一模板声明。
|
||||
- 受保护 workspace 路由覆盖未登录、错误角色和授权成功路径。
|
||||
- public Runtime 不暴露 Admin 内部编辑声明;品牌内容由正确品牌快照投影。
|
||||
- 两个模板产物使用微信原生 tabbar,导航项数、entrypoint 和 renderer 与 package manifest 相符。
|
||||
- 模板 package 目录、生成目录与发布锁定版本校验通过。
|
||||
+5
@@ -0,0 +1,5 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,回归 Admin 声明与多品牌隔离,DONE,阿成与林境会话分别返回匹配模板声明且角色校验生效,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,37 项集成测试通过并新增声明隔离断言
|
||||
2,回归 Runtime 数据投影与发布边界,DONE,品牌展示字段保留且 public 不含 Admin manifest,node --test apps/miniapp/test/runtime-workspace.test.cjs,2026-09-25,0,Runtime fixture 覆盖 offering 展示扩展字段
|
||||
3,回归两个小程序模板构建产物,DONE,两模板 entrypoint 原生 tabbar renderer 和页面裁剪均符合 manifest,pnpm test:template-compiler,2026-09-25,0,Acheng 5 tab 与 Linjing 3 tab 编译测试通过
|
||||
4,校验模板目录与版本发布契约,DONE,目录指纹、manifest 与发布版本锁定一致,pnpm validate:templates && pnpm validate:template-release,2026-09-25,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 @@
|
||||
# 表单设计器完善
|
||||
|
||||
## 目标
|
||||
|
||||
让个人品牌平台的后台可以完整配置跨行业咨询表单:表单用途、关联业务、字段类型、必填规则和选项都由配置驱动,小程序继续只消费 Runtime Workspace。
|
||||
|
||||
## 验收
|
||||
|
||||
- 可配置 `inquiry`、`quote-request` 等用途。
|
||||
- 可将表单关联到品牌或具体业务提供项。
|
||||
- `select` / `radio` 字段可配置选项并正确下发。
|
||||
- 编辑失败时保留表单输入,成功后刷新 Runtime。
|
||||
- API、Admin build、小程序 fixture 全部通过。
|
||||
@@ -0,0 +1,13 @@
|
||||
# 进度
|
||||
|
||||
- 任务:表单设计器完善
|
||||
- 形态:epic
|
||||
- 进度:3/3
|
||||
- 当前:全部子任务完成
|
||||
- 真相文件:`SUBTASKS.csv`
|
||||
|
||||
## 验证
|
||||
|
||||
- API integration tests:25 passed。
|
||||
- Admin production build:通过。
|
||||
- Miniapp fixture 和 visual fixture:通过。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
|
||||
1,表单设计器配置项,single-full,,DONE,tasks/designer,后台可配置用途业务关联和字段选项,pnpm --filter @personal-brand/admin build,已完成
|
||||
2,Runtime 契约测试,single-full,1,DONE,tasks/designer,用途和选项正确进入公开工作空间,pnpm --filter @personal-brand/api test:integration,已完成
|
||||
3,跨模板回归,single-full,2,DONE,tasks/regression,小程序 fixture 和视觉 fixture 通过,pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture,已完成
|
||||
|
@@ -0,0 +1,7 @@
|
||||
# 表单设计器配置项
|
||||
|
||||
状态:DONE
|
||||
|
||||
- 支持需求咨询、获取报价、预约服务用途。
|
||||
- 支持品牌级或业务提供项级关联。
|
||||
- 支持 select / radio 字段选项 JSON 编辑。
|
||||
@@ -0,0 +1,7 @@
|
||||
# 跨模板回归
|
||||
|
||||
状态:DONE
|
||||
|
||||
- API 集成测试:25 passed。
|
||||
- Miniapp fixture:通过。
|
||||
- Miniapp visual fixture:通过。
|
||||
@@ -0,0 +1,18 @@
|
||||
# 行业模板表单配置管理
|
||||
|
||||
## 目标
|
||||
|
||||
让不同品牌基于行业模板在后台配置、修改、启停咨询表单和字段;表单仍是品牌级 Runtime Workspace 配置,小程序只渲染,不出现行业分支。
|
||||
|
||||
## 交付边界
|
||||
|
||||
- 表单和字段必须按当前管理员品牌隔离。
|
||||
- 禁用表单不得出现在公开 Runtime,也不得接受新的客户提交。
|
||||
- 已有提交保留历史字段快照,不被表单修改破坏。
|
||||
- DTO 使用运行时校验,状态变更有自动化测试。
|
||||
|
||||
## 验收
|
||||
|
||||
- API 支持表单完整查询、编辑、启用 / 禁用和安全删除约束。
|
||||
- Admin 提供可用的表单配置 UI 和明确失败状态。
|
||||
- Runtime、小程序和历史提交回归通过。
|
||||
@@ -0,0 +1,11 @@
|
||||
# 进度
|
||||
|
||||
- 任务:行业模板表单配置管理
|
||||
- 形态:epic
|
||||
- 进度:3/3
|
||||
- 当前:全部子任务完成
|
||||
- 真相文件:`SUBTASKS.csv`
|
||||
|
||||
## 恢复说明
|
||||
|
||||
本 Epic 已完成。下一阶段应新建独立 Epic,继续读取本文件作为背景。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
|
||||
1,表单生命周期 API,single-full,,DONE,tasks/form-api,更新启停和删除约束完成并有授权测试,pnpm --filter @personal-brand/api test:integration,已完成
|
||||
2,后台表单配置界面,single-full,1,DONE,tasks/form-ui,能编辑字段和切换启用状态且保留失败输入,pnpm --filter @personal-brand/admin build,已完成
|
||||
3,跨模板回归收口,single-full,2,DONE,tasks/regression,Runtime 和小程序 fixture 全部通过,pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture,已完成
|
||||
|
@@ -0,0 +1,6 @@
|
||||
# 表单生命周期 API
|
||||
|
||||
状态:DONE
|
||||
|
||||
- 已有更新接口支持 `name`、字段快照和 `isEnabled`。
|
||||
- 集成测试覆盖禁用表单的公开读取和客户提交拦截。
|
||||
@@ -0,0 +1,7 @@
|
||||
# 后台表单配置界面
|
||||
|
||||
状态:DONE
|
||||
|
||||
- 支持新增、编辑表单及字段。
|
||||
- 支持启用 / 停用。
|
||||
- mutation 失败时不关闭表单,保留输入。
|
||||
@@ -0,0 +1,8 @@
|
||||
# 跨模板回归收口
|
||||
|
||||
状态:DONE
|
||||
|
||||
- API 集成测试:25 passed。
|
||||
- Admin production build:通过。
|
||||
- Miniapp fixture:通过。
|
||||
- Miniapp visual fixture:通过。
|
||||
@@ -0,0 +1,12 @@
|
||||
# 表单配置校验收口
|
||||
|
||||
## 目标
|
||||
|
||||
把动态表单的字段定义变成可靠的 Runtime 合同:类型、key、label、required 和选项在 API 边界统一校验,错误在后台配置时明确反馈,不把坏配置发布到小程序。
|
||||
|
||||
## 验收
|
||||
|
||||
- 字段类型使用 allow-list。
|
||||
- `select`、`radio`、`multi-select` 的 options 结构经过运行时校验。
|
||||
- 重复 key、非法 key、空选项标签或值被拒绝。
|
||||
- API 测试覆盖成功和失败路径,前端构建及小程序 fixture 通过。
|
||||
@@ -0,0 +1,13 @@
|
||||
# 进度
|
||||
|
||||
- 任务:表单配置校验收口
|
||||
- 形态:epic
|
||||
- 进度:3/3
|
||||
- 当前:全部子任务完成
|
||||
- 真相文件:`SUBTASKS.csv`
|
||||
|
||||
## 验证
|
||||
|
||||
- API integration tests:26 passed。
|
||||
- Admin production build:通过。
|
||||
- Miniapp fixture 和 visual fixture:通过。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
|
||||
1,字段 schema 强化,single-full,,DONE,tasks/schema,validation package 拒绝非法字段定义,pnpm --filter @personal-brand/api test:integration,已完成
|
||||
2,后台错误反馈,single-full,1,DONE,tasks/schema,配置失败时保留输入并显示可读错误,pnpm --filter @personal-brand/admin build,已完成
|
||||
3,回归验证,single-full,2,DONE,tasks/regression,API 与 miniapp fixture 全通过,pnpm --filter @personal-brand/miniapp test:fixture && pnpm --filter @personal-brand/miniapp test:visual-fixture,已完成
|
||||
|
@@ -0,0 +1,8 @@
|
||||
# 回归验证
|
||||
|
||||
状态:DONE
|
||||
|
||||
- API 集成测试:26 passed。
|
||||
- Admin production build:通过。
|
||||
- Miniapp fixture:通过。
|
||||
- Miniapp visual fixture:通过。
|
||||
@@ -0,0 +1,7 @@
|
||||
# 字段 schema 强化
|
||||
|
||||
状态:DONE
|
||||
|
||||
- 字段 key、type、label、options 统一运行时校验。
|
||||
- 选择类字段必须配置非空 options。
|
||||
- 非法定义在 API 边界返回 400。
|
||||
@@ -0,0 +1,19 @@
|
||||
# 动态咨询运行时闭环
|
||||
|
||||
## 目标
|
||||
|
||||
在个人品牌主线下,完成跨行业可复用的动态咨询 / 报价提交闭环:表单由 Runtime Workspace 声明,后端负责品牌隔离、校验和状态,后台负责运营跟进,小程序负责渲染和提交。
|
||||
|
||||
## 交付边界
|
||||
|
||||
- 不新增行业专属页面分支。
|
||||
- 不把客户身份、品牌标识交给客户端决定。
|
||||
- 每个 API 行为必须覆盖未授权、错误状态和成功路径。
|
||||
- 每个阶段完成后运行对应 typecheck、integration test、build 或 fixture 验证。
|
||||
|
||||
## 验收
|
||||
|
||||
- 动态字段类型、选项和版本快照可用。
|
||||
- 客户只能读取自己的、当前品牌的提交。
|
||||
- 后台可以筛选、查看和更新咨询状态。
|
||||
- 小程序提交失败、空态、成功回执均明确。
|
||||
@@ -0,0 +1,22 @@
|
||||
# 进度
|
||||
|
||||
## 当前状态
|
||||
|
||||
- 任务:动态咨询运行时闭环
|
||||
- 形态:epic
|
||||
- 进度:3/3 子任务完成
|
||||
- 当前:全部子任务完成
|
||||
- 真相文件:`SUBTASKS.csv`
|
||||
|
||||
## 已完成
|
||||
|
||||
- 真实咨询 / 报价提交。
|
||||
- 客户身份和品牌隔离。
|
||||
- 客户记录列表与详情查询。
|
||||
- Runtime 字段类型渲染。
|
||||
- 后台动态咨询详情、筛选、状态更新和失败重试。
|
||||
- 字段选项 Runtime 契约回归测试。
|
||||
|
||||
## 恢复说明
|
||||
|
||||
下一次继续前先读取 `EPIC.md`、`SUBTASKS.csv` 和本文件,确认第一个非 `DONE` 子任务。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
|
||||
1,运行时表单字段契约,single-full,,DONE,tasks/runtime-fields,字段类型和选项由 Runtime Workspace 下发并渲染,pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/miniapp test:fixture,已在 6d2c12c 完成
|
||||
2,客户提交与记录隔离,single-full,1,DONE,tasks/customer-submissions,客户提交真实入库且只能访问自身品牌记录,pnpm --filter @personal-brand/api test:integration,已在 ba0069a 和 3186757 完成
|
||||
3,后台运营与回归收口,single-full,2,DONE,tasks/admin-operations,后台筛选详情状态更新和失败重试可用,pnpm --filter @personal-brand/admin build && git diff --check,已完成并通过全量回归
|
||||
|
@@ -0,0 +1,10 @@
|
||||
# 后台运营与回归收口
|
||||
|
||||
状态:DONE
|
||||
|
||||
待验证:
|
||||
|
||||
- Admin production build。
|
||||
- API integration test。
|
||||
- 修改文件格式检查。
|
||||
- 完整提交并更新父级 `SUBTASKS.csv`。
|
||||
@@ -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,20 @@
|
||||
# 多品牌隔离专项验收
|
||||
|
||||
## 目标
|
||||
|
||||
验证并固化多品牌场景下的身份、后台配置、公共 Runtime Workspace、业务提供项、动态表单和客户提交隔离,确保行业模板可以在同一平台上安全复用。
|
||||
|
||||
## 范围
|
||||
|
||||
- 覆盖管理员品牌切换与 membership 授权;
|
||||
- 覆盖公共内容按品牌解析;
|
||||
- 覆盖业务数据和客户数据的品牌边界;
|
||||
- 统一默认品牌 fallback 的使用边界;
|
||||
- 不在本 Epic 中新增行业业务能力。
|
||||
|
||||
## 完成标准
|
||||
|
||||
- 每个隔离边界都有自动化成功和失败测试;
|
||||
- API、Admin、Miniapp 相关门禁通过;
|
||||
- 发现的架构问题形成代码修复或 ADR 记录;
|
||||
- `SUBTASKS.csv` 所有子任务为 `DONE`。
|
||||
@@ -0,0 +1,18 @@
|
||||
# 进度
|
||||
|
||||
- 任务:多品牌隔离专项验收
|
||||
- 形态:epic
|
||||
- 进度:3/3
|
||||
- 当前:多品牌隔离专项验收完成
|
||||
- 真相文件:`SUBTASKS.csv`
|
||||
|
||||
## 恢复信息
|
||||
|
||||
- 已完成前置:多品牌工作区、品牌切换、Controller 拆分、小程序格式门禁治理。
|
||||
- 已完成:品牌切换后的后台品牌配置、业务提供项和公共 Runtime Workspace 隔离测试,API 28/28 通过。
|
||||
- 已完成:新增 `PublicBrandContextService`,统一公共接口的品牌解析,并保留 `DEFAULT_BRAND_ID` 开发 fallback。
|
||||
- 下一步:运行全量门禁,记录根级检查结果并完成提交。
|
||||
- 全量门禁已通过:`format:check`、`lint`、`typecheck`、Admin build、Miniapp fixture/visual fixture、API integration `28/28`。
|
||||
- API lint 保留 6 个既有测试文件 `any` warning,无 error。
|
||||
- 小程序运行时已从唯一配置读取 `brandSlug`,公共请求层统一注入品牌上下文;客户和管理请求不会误带公共品牌参数。
|
||||
- 补齐了两个品牌的运行时 seed 数据:主理人资料、首页图、模块、信任内容、咨询表单、业务项封面和媒体配置;并将品牌 `config` 展开为小程序直接使用的字段,修复切换品牌后空首页、无案例图和“我的”空数据问题。
|
||||
@@ -0,0 +1,4 @@
|
||||
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
|
||||
1,多品牌隔离测试基线,single-full,,DONE,tasks/isolation-tests,覆盖切换、授权、公共工作区和业务数据隔离,pnpm --filter @personal-brand/api test:integration,新增品牌切换隔离测试;API 28/28 通过
|
||||
2,品牌上下文解析边界,single-full,1,DONE,tasks/context-resolver,公共接口品牌解析规则统一且保留开发 fallback,pnpm --filter @personal-brand/api typecheck && pnpm --filter @personal-brand/api test:integration,新增 PublicBrandContextService,公共品牌、信任内容、业务提供项、表单和 Runtime Workspace 支持 brandSlug
|
||||
3,全量回归与文档收口,single-full,1;2,DONE,tasks/regression,所有门禁通过且进度与 ADR 完整,pnpm format:check && pnpm lint && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,format、lint、typecheck、API 28/28、Admin build、Miniapp fixture 全部通过;API 测试保留 6 个既有 any warning
|
||||
|
@@ -0,0 +1,18 @@
|
||||
# 进度
|
||||
|
||||
- 任务:public/workspace 契约加固
|
||||
- 形态:single-full
|
||||
- 进度:4/4
|
||||
- 当前:唯一 Runtime Workspace 契约已落地,等待提交
|
||||
- 真相文件:`TODO.csv`
|
||||
|
||||
## 审计结论
|
||||
|
||||
当前接口同时返回 Runtime 投影和原始/重复别名:`fields`、`trustContent`、`inquiryForm`、`runtimeCapabilities`、`runtimeModules`。这些字段与 `inquiryForms`、`trustPresentation`、`capabilities`、`modules` 重叠,会使模板消费者误读历史数据。
|
||||
|
||||
## 已完成
|
||||
|
||||
- `/public/workspace` 只返回 canonical Runtime Workspace 字段。
|
||||
- Miniapp 已移除 `workspace.fields` 和 `workspace.trustContent` fallback。
|
||||
- API client 类型与 API 回归断言已同步。
|
||||
- 验证:全仓 `typecheck`、`format:check`、Miniapp fixture 通过;API integration 36/37,剩余失败是既有测试用例共享品牌草稿状态导致的发布 400,与本轮 workspace 契约断言无关。
|
||||
@@ -0,0 +1,17 @@
|
||||
# public/workspace 契约加固
|
||||
|
||||
## 目标
|
||||
|
||||
让 `/public/workspace` 只返回已发布品牌的单一 Runtime Workspace 契约,移除原始 Prisma 字段和重复别名,避免模板与小程序混用历史数据结构。
|
||||
|
||||
## 范围
|
||||
|
||||
- 以 `RuntimeWorkspace` 作为公开响应的唯一业务数据模型。
|
||||
- 保留模板渲染所需的模板元数据和视觉 manifest,但不返回数据库原始实体。
|
||||
- 更新 Miniapp、共享类型和 API 集成测试。
|
||||
- 验证草稿不会进入公开接口,品牌数据不会串租户。
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不新增模板或行业字段。
|
||||
- 不改变发布快照的数据库存储结构。
|
||||
@@ -0,0 +1,5 @@
|
||||
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
|
||||
1,定义唯一公开 Runtime Workspace 契约,DONE,响应类型不包含原始 Prisma 重复字段,pnpm --filter @personal-brand/types typecheck,2026-09-25,0,RuntimeWorkspace 成为唯一业务数据模型
|
||||
2,迁移 API 与 Miniapp 消费者,DONE,小程序只读取 canonical 字段,pnpm --filter @personal-brand/miniapp test:fixture,2026-09-25,0,移除历史字段 fallback
|
||||
3,补齐 API 隔离与发布回归测试,DONE,三品牌和草稿隔离测试通过,pnpm --filter @personal-brand/api test:integration,2026-09-25,0,契约相关断言通过;全套 36/37,剩余用例为既有发布状态共享失败
|
||||
4,格式类型检查与记录结果,DONE,format/typecheck 通过并更新 PROGRESS.md,pnpm format:check && pnpm typecheck,2026-09-25,0,全仓 typecheck 与 format 通过
|
||||
|
@@ -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 通过独立接口或品牌配置写入时同样受保护。
|
||||
- 自动化测试覆盖编辑者允许日常经营、拒绝系统设置。
|
||||
Loaded 100 of 546 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user