persionalBrand/docs/04-implementation-plan.md

实施计划与交付管理

1. 交付策略

以真实朋友项目为第一个可用版本，采用短迭代，每个迭代都产出可运行结果。所有新增想法先进入需求池，不直接插入当前迭代。

2. 里程碑

M0：确认内容与原型

产出：真实品牌资料、页面线框、字段清单、预约流程图、朋友确认记录。

完成条件：朋友可以指出页面上每个字段的真实内容和客户要完成的动作。

M1：项目骨架与本地环境

产出：Monorepo、三应用、共享包、环境变量模板、Docker 数据库、统一启动命令。

完成条件：新环境按 README 可以启动 API、后台和数据库。

M2：内容管理闭环

产出：管理员登录、品牌资料、服务、作品、图片上传、小程序公开展示。

完成条件：后台保存内容后，小程序可以正确展示；停用内容不会出现在公开页面。

M3：预约与反馈闭环

产出：预约表单、预约管理、反馈提交、审核与展示。

完成条件：从客户提交到管理员处理的完整流程可演练，权限和重复提交保护有效。

M4：真实试用与发布

产出：真实内容、错误修复、使用说明、发布版本。

完成条件：朋友独立完成至少三次内容更新，演练三次预约和两次反馈审核。

3. 建议任务顺序

1. 初始化仓库和开发工具链。
2. 创建 Prisma schema 和数据库迁移。
3. 建立 API 模块和统一错误格式。
4. 建立后台登录与权限中间件。
5. 完成品牌、服务和作品管理。
6. 完成小程序首页、详情和内容读取。
7. 完成图片上传和资源管理。
8. 完成预约写入和后台处理。
9. 完成反馈审核和公开展示。
10. 执行验收清单并发布试点版。

4. 测试要求

必须自动化验证

• API DTO 校验。
• 未授权访问管理接口。
• 服务停用后不能预约。
• 重复提交不能创建重复预约。
• 反馈未审核不能公开。
• 预约状态只能使用定义的枚举。

必须人工验收

• 手机端首页在真实图片下不溢出。
• 朋友能独立完成品牌、服务、作品编辑。
• 图片上传失败时可以恢复。
• 联系方式在公开页面和后台的展示边界正确。
• 小程序首次打开、返回、刷新和网络失败状态可用。

5. 发布前检查

• 生产环境没有默认管理员密码。
• .env 和密钥未提交仓库。
• 数据库已执行迁移并完成初始化。
• 对象存储读写权限正确。
• 公开接口不会返回管理备注和敏感字段。
• 管理接口有登录和角色校验。
• 预约、反馈、内容删除行为符合软删除/隐藏规则。
• 朋友确认品牌文案、联系方式和图片版权。
• 有一份回滚和数据库备份方案。

6. 需求变更规则

新增需求必须记录：

• 解决的用户问题
• 是否影响当前里程碑
• 是否需要新增数据表或状态
• 是否影响后续支付兼容性
• 是否由朋友真实使用验证过

以下内容默认进入后续版本：支付、自动通知、排班、多员工、多门店、优惠券、会员、自动发布、多商户注册。

7. 试点后的评估

上线两周后评估：

• 朋友是否能自行维护内容。
• 客户是否完成浏览到联系/预约。
• 预约是否比原有聊天记录更可追踪。
• 哪些功能被重复使用。
• 哪些功能造成理解成本。
• 是否出现第二个真实品牌项目。

只有重复需求出现后，才抽象多品牌、租户、计费和自动化发布能力。