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

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

No files matched your search

@@ -0,0 +1,30 @@
# 多品牌初始化与真实验收
## 目标
把个人品牌、餐饮与门窗三个 demo 品牌固化为可重复初始化的运行时基线,验证公开 Workspace 的品牌隔离、行业表达和咨询转化链路。
## 非目标
- 不新增行业模板或订单能力。
- 不改变普通用户的配置流程。
- 不引入历史数据兼容层;当前为开发期 fixture,直接修正旧样例。
## 约束
- `Offering.kind` 只使用共享 allow-list:`service`、`product`、`package`、`subscription`。
- 行业分类通过 `config.categoryKey` 与 `config.categoryLabel` 表达。
- 三个品牌均须具备已启用的品牌级咨询表单。
- 公开接口必须按 `brandSlug` 隔离验证。
## 风险
- seed 会更新本地 demo 数据,因此必须在执行后检查三个公开 Workspace。
- 运行中的 API 需在 seed 后重启,才能清除其进程内 Workspace 缓存。
## 完成标准
- [ ] `SUBTASKS.csv` 所有任务为 `DONE`。
- [ ] seed 可重复执行并生成 3 个独立品牌。
- [ ] API integration 覆盖三品牌公开 Workspace 基线。
- [ ] migration、seed、format、typecheck、integration、Admin build 通过。
@@ -0,0 +1,21 @@
# 进度
- 任务:多品牌初始化与真实验收
- 形态:epic
- 进度:3/3
- 当前:多品牌初始化与真实验收完成
- 真相文件:`SUBTASKS.csv`
## 恢复信息
- 已完成:新增 `linran-brand` 个人品牌 fixture,并向管理员授予 owner membership。
- 已完成:`Offering.kind` 收敛到共享 allow-list,餐饮和门窗行业分类改由 `config.categoryKey`、`config.categoryLabel` 表达;小程序从 `categoryLabel` 渲染行业名称。
- 已完成:餐饮的预订表达与品牌级咨询表单被 seed 反复校正为启用状态。
- 已完成:公开 Workspace integration 覆盖 3 个品牌的身份、模板、主理人、表单、业务归属和分类语义,API `35/35` 通过。
- 已完成:`prisma migrate deploy` 无待执行项;测试结束后已重跑 seed 恢复 demo 数据;`format:check`、`typecheck`、Admin build 均通过。
## 最终结果
- 风险收口:不再用行业文案污染共享 `Offering.kind`。
- 验收基线:`linran-brand`(个人品牌)、`default-brand`(餐饮)、`linjing-doors`(门窗)三套独立公开 Workspace。
- 已知非阻塞项:Admin production build 提示主 chunk 约 669 kB,后续按路由进一步拆包,不影响本次功能与数据正确性。
@@ -0,0 +1,4 @@
id,task,task_type,status,depends_on,task_dir,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,统一运行时样例语义与三品牌 fixture,single-full,DONE,,tasks/seed-baseline,seed 使用共享 kind 并提供个人、餐饮、门窗的可用内容,pnpm --filter @personal-brand/api typecheck,2026-09-24,0,新增 personal fixture;行业分类迁移至 config.categoryKey/categoryLabel
2,公开 Workspace 三品牌验收测试,single-full,DONE,1,tasks/runtime-contract,按 brandSlug 验证身份、模板、表单、业务项和隔离,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,API integration 35/35 通过
3,执行初始化与全量门禁,single-full,DONE,1;2,tasks/regression,迁移、seed 与质量门禁均通过,pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration,2026-09-24,0,migrate deploy 无待执行项;seed 已在测试后重跑恢复 demo 基线
1 id task task_type status depends_on task_dir acceptance_criteria validation_command completed_at retry_count notes
2 1 统一运行时样例语义与三品牌 fixture single-full DONE tasks/seed-baseline seed 使用共享 kind 并提供个人、餐饮、门窗的可用内容 pnpm --filter @personal-brand/api typecheck 2026-09-24 0 新增 personal fixture;行业分类迁移至 config.categoryKey/categoryLabel
3 2 公开 Workspace 三品牌验收测试 single-full DONE 1 tasks/runtime-contract 按 brandSlug 验证身份、模板、表单、业务项和隔离 pnpm --filter @personal-brand/api test:integration 2026-09-24 0 API integration 35/35 通过
4 3 执行初始化与全量门禁 single-full DONE 1;2 tasks/regression 迁移、seed 与质量门禁均通过 pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration 2026-09-24 0 migrate deploy 无待执行项;seed 已在测试后重跑恢复 demo 基线
@@ -0,0 +1,5 @@
# 子任务记录
- 状态:DONE
- 变更:执行 migration、seed 并恢复 integration 后的 demo 基线。
- 验证:`pnpm format:check`、`pnpm typecheck`、Admin production build 均通过。
@@ -0,0 +1,5 @@
# 子任务记录
- 状态:DONE
- 变更:新增按 `brandSlug` 读取三品牌 Workspace 的公开 API integration 测试。
- 验证:`pnpm --filter @personal-brand/api test:integration`,`35/35` 通过。
@@ -0,0 +1,5 @@
# 子任务记录
- 状态:DONE
- 变更:三品牌可重复 seed、共享 kind 收敛、餐饮文案和咨询表单修复。
- 验证:`pnpm --filter @personal-brand/api typecheck` 通过。