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,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 均通过
1 id title task_type depends_on status task_dir acceptance_criteria validation_command notes
2 1 定义用户配置契约与品牌 presentation API single-full DONE tasks/presentation-api 普通用户可提交受控的 presentation 配置且按当前品牌保存 pnpm --filter @personal-brand/api test:integration 独立 presentation API 只接受允许的页面 section,集成测试 31/31 通过
3 2 实现普通用户友好的品牌表达表单 single-full 1 DONE tasks/brand-editor 表单使用中文业务概念并覆盖核心页面文案和资源 pnpm --filter @personal-brand/admin build 已实现首页、咨询页、主理人与我页面表达表单;不暴露 JSON、manifest、slot 和版本概念
4 3 接入保存后的运行时预览与错误状态 single-full 1;2 DONE tasks/runtime-preview 保存成功刷新后台预览和小程序运行时数据 pnpm --filter @personal-brand/admin build 已显示小程序当前已生效内容;运行时读取失败显示明确提示,保存失败保留输入
5 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 均通过