docs: define initial product requirements

This commit is contained in:
2026-09-18 14:15:49 +08:00
commit e28140a0b3
9 changed files with 1346 additions and 0 deletions

View File

@@ -0,0 +1,106 @@
# 实施计划与交付管理
## 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. 试点后的评估
上线两周后评估:
- 朋友是否能自行维护内容。
- 客户是否完成浏览到联系/预约。
- 预约是否比原有聊天记录更可追踪。
- 哪些功能被重复使用。
- 哪些功能造成理解成本。
- 是否出现第二个真实品牌项目。
只有重复需求出现后,才抽象多品牌、租户、计费和自动化发布能力。