feat: 收口多品牌与模板构建基础
This commit is contained in:
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 已清理
|
||||
|
@@ -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 通过
|
||||
|
Reference in new issue
Block a user