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,29 @@
# 品牌发布生命周期 Epic
## 目标
建立多品牌、模板驱动的草稿与发布边界,使普通用户可以完成首次配置、预览、发布和回滚,并让小程序只展示已发布内容。
## 范围
- 品牌发布版本模型、快照生成和可逆迁移;
- 发布、撤回、回滚 API 及授权、校验、审计;
- 公开 workspace 读取发布快照;
- 后台首次配置引导和发布检查;
- API client、集成测试、管理后台构建和小程序未发布状态。
## 不在本 Epic
- 新增行业模板或视觉风格;
- 邀请制团队协作;
- 订单领域状态扩展;
- 生产环境部署和 Nginx 配置。
## 验收原则
- 每个受保护端点覆盖缺少凭证、无效凭证/错误角色和成功路径;
- 不同品牌不能读取或回滚其他品牌的发布版本;
- 发布失败不改变草稿和当前发布版本;
- 回滚生成新发布版本,不覆盖草稿;
- 公开接口永远不读取未发布草稿;
- 运行 `prisma migrate deploy`、format、typecheck、API integration 和 Admin build。
@@ -0,0 +1,34 @@
# 进度
- 任务:品牌发布生命周期
- 形态:epic
- 进度:5/5
- 当前:品牌发布生命周期 Epic 已完成;所有子任务和交付验证均已通过。
- 决策依据:`docs/adr/0012-brand-publication-lifecycle.md`
## 阶段执行记录
已完成 `1 发布模型与快照生成`:新增 `BrandRelease`、可部署 migration 和 `BrandReleaseService.buildSnapshot`。公开接口仍读取现有工作区,待发布 API 完成后再切换。
已完成 `2 发布与回滚 API`:新增 `/admin/releases` 列表、`publish`、`revoke` 和版本 `rollback`;发布前校验品牌、模板、业务项、表单和信任内容;回滚生成新版本;覆盖认证、客户越权、成功版本化流程,API integration `37/37` 通过。
已完成 `3 公开 workspace 发布边界`:公开品牌、信任内容、业务项、表单及 workspace 只读取当前发布快照;未发布响应不含草稿品牌资料。客户咨询使用已发布表单字段和版本,预约业务项需存在于发布版本且实时启用;小程序不回退旧缓存。验证:API integration `37/37`、miniapp fixture、API typecheck、Admin build、format、diff 检查通过;测试后已恢复 seed。
阶段 `4 首次配置与发布引导`:后台提供非技术用户可理解的准备清单、模板选择与示例导入、发布前预览、发布/撤回/回滚操作。发布校验由服务端作为唯一真相。
已完成 `4 首次配置与发布引导`:新增 `/admin/publication`,提供行业/视觉选择、示例导入、草稿内容核对、服务端 readiness 检查、发布、撤回和历史版本恢复;编辑成员只可编辑内容,模板管理操作按角色限制。发布检查复用共享 validation 包,发布快照保存模板和视觉声明,客户提交使用发布版本字段和业务快照。验证:API 隔离 schema integration `37/37`、API client `3/3`、API/Admin typecheck、lint、Admin build、format、miniapp fixture 和 visual fixture 均通过。
已完成 `5 全量回归与交付`:
- `pnpm format:check`:通过。
- `pnpm lint`:通过;保留既有 `booking.service.test.ts` 的 6 个 `no-explicit-any` warning。
- `pnpm typecheck`:通过。
- `pnpm --filter @personal-brand/api test`:`6/6` 通过。
- `pnpm --filter @personal-brand/api test:integration`:隔离 schema 部署 25 个 migration,API 集成 `37/37` 通过;临时 schema 已清理。
- `pnpm test:api-client`:`3/3` 通过。
- `pnpm --filter @personal-brand/admin build`:通过。
- `pnpm --filter @personal-brand/miniapp test:fixture`:通过。
- `pnpm --filter @personal-brand/miniapp test:visual-fixture`:通过。
- `git diff --check`:通过。
交付结论:公开内容只读取已发布快照;发布、撤回、回滚具备事务、版本和审计约束;后台发布引导和服务端 readiness 已覆盖;客户提交与预约均按发布快照校验;本 Epic 无未验证的 API 路径或用户操作。
@@ -0,0 +1,6 @@
id,title,task_type,depends_on,status,task_dir,acceptance_criteria,validation_command,notes
1,发布模型与快照生成,single-full,,DONE,tasks/release-model,BrandRelease 模型和运行时快照生成器完成且 migration 可部署,pnpm --filter @personal-brand/api exec prisma migrate deploy && pnpm --filter @personal-brand/api typecheck,已完成;公开读取路径尚未切换
2,发布与回滚 API,single-full,1,DONE,tasks/release-api,发布撤回回滚接口具备校验授权审计和隔离测试,pnpm --filter @personal-brand/api test:integration,已完成;集成测试 37/37
3,公开 workspace 发布边界,single-full,1;2,DONE,tasks/public-release-boundary,公开接口只读取已发布快照并覆盖未发布空状态,pnpm --filter @personal-brand/api test:integration,API 37/37;miniapp fixture 通过;seed 已恢复
4,首次配置与发布引导,single-full,2;3,DONE,tasks/onboarding-publish,普通用户可选择模板导入示例完善身份预览并发布,pnpm --filter @personal-brand/admin build,新增配置与发布页;服务端 readiness;发布撤回回滚;模板/示例/草稿核对;Admin build/typecheck 通过
5,全量回归与交付,single-full,1;2;3;4,DONE,tasks/regression,pnpm format/typecheck/build/integration 和 diff 检查通过,pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build,已完成;全量验证通过,临时测试 schema 已清理
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 发布模型与快照生成 single-full DONE tasks/release-model BrandRelease 模型和运行时快照生成器完成且 migration 可部署 pnpm --filter @personal-brand/api exec prisma migrate deploy && pnpm --filter @personal-brand/api typecheck 已完成;公开读取路径尚未切换
3 2 发布与回滚 API single-full 1 DONE tasks/release-api 发布撤回回滚接口具备校验授权审计和隔离测试 pnpm --filter @personal-brand/api test:integration 已完成;集成测试 37/37
4 3 公开 workspace 发布边界 single-full 1;2 DONE tasks/public-release-boundary 公开接口只读取已发布快照并覆盖未发布空状态 pnpm --filter @personal-brand/api test:integration API 37/37;miniapp fixture 通过;seed 已恢复
5 4 首次配置与发布引导 single-full 2;3 DONE tasks/onboarding-publish 普通用户可选择模板导入示例完善身份预览并发布 pnpm --filter @personal-brand/admin build 新增配置与发布页;服务端 readiness;发布撤回回滚;模板/示例/草稿核对;Admin build/typecheck 通过
6 5 全量回归与交付 single-full 1;2;3;4 DONE tasks/regression pnpm format/typecheck/build/integration 和 diff 检查通过 pnpm format:check && pnpm typecheck && pnpm --filter @personal-brand/api test:integration && pnpm --filter @personal-brand/admin build 已完成;全量验证通过,临时测试 schema 已清理
@@ -0,0 +1,7 @@
# 进度
- 任务:首次配置与发布引导
- 形态:single-full
- 进度:4/4
- 当前:首次配置、内容核对、发布操作和回归验证已完成。
- 文件:本目录 `TODO.csv` 为真相。
@@ -0,0 +1,3 @@
# 首次配置与发布引导
普通品牌用户无需理解内部模板结构,也能按“选择行业与视觉模板、导入示例、完善身份与业务内容、预览、发布”的顺序完成首次发布。后台明确区分草稿和已发布版本,发布失败保留输入并提示缺项。
@@ -0,0 +1,5 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,服务端发布检查接口,DONE,返回与 publish 相同规则的缺项列表,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,复用 validation 包并测试未就绪状态
2,后台模板与示例引导,DONE,可选择模板并预览或导入示例,pnpm --filter @personal-brand/admin build,2026-09-24,0,新增配置与发布页
3,后台发布预览与版本操作,DONE,发布撤回回滚及失败状态完整,pnpm --filter @personal-brand/admin build,2026-09-24,0,含权限控制和失败提示
4,回归验证,DONE,API 与 UI 构建和格式检查通过,pnpm format:check,2026-09-24,0,隔离 schema integration 37/37
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 服务端发布检查接口 DONE 返回与 publish 相同规则的缺项列表 pnpm --filter @personal-brand/api test:integration 2026-09-24 0 复用 validation 包并测试未就绪状态
3 2 后台模板与示例引导 DONE 可选择模板并预览或导入示例 pnpm --filter @personal-brand/admin build 2026-09-24 0 新增配置与发布页
4 3 后台发布预览与版本操作 DONE 发布撤回回滚及失败状态完整 pnpm --filter @personal-brand/admin build 2026-09-24 0 含权限控制和失败提示
5 4 回归验证 DONE API 与 UI 构建和格式检查通过 pnpm format:check 2026-09-24 0 隔离 schema integration 37/37
@@ -0,0 +1,7 @@
# 进度
- 任务:公开 workspace 发布边界
- 形态:single-full
- 进度:3/3
- 验证:API integration 37/37;miniapp fixture、API typecheck、Admin build、format 和 diff 检查通过。
- 文件:本目录 `TODO.csv` 为真相。
@@ -0,0 +1,3 @@
# 公开发布边界
公开接口、小程序运行时和客户提交都必须以当前品牌发布快照为边界。未发布时不显示草稿,也不受理新的咨询或预约;实时禁用仍应即时拦截。
@@ -0,0 +1,4 @@
id,task,status,acceptance_criteria,validation_command,completed_at,retry_count,notes
1,公开查询切换发布快照,DONE,无发布版本不暴露草稿,pnpm --filter @personal-brand/api test:integration,2026-09-24,0,37/37
2,客户提交与小程序缓存边界,DONE,未发布时不受理且不回退旧缓存,pnpm --filter @personal-brand/miniapp test:fixture,2026-09-24,0,通过
3,全量验证与恢复种子,DONE,集成测试和构建通过且 seed 恢复,pnpm format:check,2026-09-24,0,API 37/37;Admin build 通过
1 id task status acceptance_criteria validation_command completed_at retry_count notes
2 1 公开查询切换发布快照 DONE 无发布版本不暴露草稿 pnpm --filter @personal-brand/api test:integration 2026-09-24 0 37/37
3 2 客户提交与小程序缓存边界 DONE 未发布时不受理且不回退旧缓存 pnpm --filter @personal-brand/miniapp test:fixture 2026-09-24 0 通过
4 3 全量验证与恢复种子 DONE 集成测试和构建通过且 seed 恢复 pnpm format:check 2026-09-24 0 API 37/37;Admin build 通过
@@ -0,0 +1,7 @@
# 进度
- 状态:DONE
- 新增 `BrandReleaseApiService` 和 `AdminReleaseController`。
- 发布前校验品牌名称、行业模板、视觉模板兼容性、启用业务项、启用咨询表单和已发布信任内容。
- 新增 API Client 的 release 方法和 认证/成功/回滚/撤回集成测试。
- `prisma migrate deploy`、API build、API typecheck、format 和 API integration `37/37` 已通过。
@@ -0,0 +1,3 @@
# 发布与回滚 API
提供品牌发布版本的查询、发布、撤回和回滚接口。所有数据按管理员会话中的 `brandId` 隔离,发布失败不得修改已有版本,回滚通过创建新版本保留历史。
@@ -0,0 +1,4 @@
id,task,status,completed_at,notes
1,实现发布校验和版本创建,DONE,2026-09-24,事务中标记旧版本 superseded 并创建新版本
2,实现回滚与撤回,DONE,2026-09-24,回滚创建新版本,撤回标记当前版本 revoked
3,补齐授权、隔离和成功测试,DONE,2026-09-24,API integration 37/37
1 id task status completed_at notes
2 1 实现发布校验和版本创建 DONE 2026-09-24 事务中标记旧版本 superseded 并创建新版本
3 2 实现回滚与撤回 DONE 2026-09-24 回滚创建新版本,撤回标记当前版本 revoked
4 3 补齐授权、隔离和成功测试 DONE 2026-09-24 API integration 37/37
@@ -0,0 +1,6 @@
# 进度
- 状态:DONE
- 已新增 `BrandRelease` Prisma 模型及 migration `20260924100000_add_brand_releases`。
- 已新增 `BrandReleaseService.buildSnapshot`,按品牌收集品牌资料、模板安装、模块、字段、业务项、表单、信任内容和能力安装。
- 已执行 `prisma migrate deploy`、API typecheck。
@@ -0,0 +1,3 @@
# 发布模型与快照生成
为每个品牌增加不可变发布版本,保存完整工作区快照,为后续发布、回滚和公开读取提供数据边界。本阶段不切换公开接口。
@@ -0,0 +1,4 @@
id,task,status,completed_at,notes
1,新增 BrandRelease Prisma 模型,DONE,2026-09-24,保存品牌版本快照和状态
2,实现品牌工作区快照生成器,DONE,2026-09-24,BrandReleaseService 按 brandId 收集完整配置
3,执行数据库迁移与 API 类型检查,DONE,2026-09-24,prisma migrate deploy 和 typecheck 通过
1 id task status completed_at notes
2 1 新增 BrandRelease Prisma 模型 DONE 2026-09-24 保存品牌版本快照和状态
3 2 实现品牌工作区快照生成器 DONE 2026-09-24 BrandReleaseService 按 brandId 收集完整配置
4 3 执行数据库迁移与 API 类型检查 DONE 2026-09-24 prisma migrate deploy 和 typecheck 通过