主题
工期预期
AI 辅助开发基准说明
本工期估算基于以下前提：
- 三名开发者均熟练使用 AI 编程工具（Cursor / GitHub Copilot 等），AI 生成代码占比 60%+
- 需求明确：每个功能系统文档已详细定义，减少沟通返工
- 技术栈统一：团队在同一技术栈内开发，减少学习成本
- AI 辅助下，标准 CRUD 模块开发效率约为传统开发的 2-3 倍
- 硬件联调、第三方 SDK 集成等仍需实际调试时间，加速幅度较小
工期估算说明
| 工作类型 | 传统工期 | AI 辅助工期 | 说明 |
|---|---|---|---|
| 标准 CRUD 模块（API + 页面） | 3-5 天/人 | 1-2 天/人 | AI 生成大量样板代码 |
| 复杂业务逻辑（订单/支付/权限） | 1-2 周/人 | 3-5 天/人 | 逻辑复杂，需仔细校验 |
| 硬件 SDK 集成与调试 | 1-2 周 | 5-7 天 | 依赖实体硬件，AI 加速有限 |
| AB 门状态机（核心硬件逻辑） | 2-3 周 | 1-2 周 | 需反复联调测试 |
| 第三方集成（微信支付、飞书） | 3-5 天/项 | 2-3 天/项 | 文档熟悉 + AI 辅助 |
| 前端页面（列表/详情/表单） | 2-3 天/页 | 0.5-1 天/页 | UI 组件 + AI 生成效率极高 |
| 联调测试（前后端+硬件） | 随功能复杂度 | — | 不可大幅压缩 |
分阶段工期规划
第一阶段：基础工程 + 用户系统（预计 2 周）
目标：三端框架跑通，用户可以微信登录并录入人脸
| 周次 | 硬件端 | 后端 | 前端 |
|---|---|---|---|
| Week 1 | 工控机框架搭建（F-06/07/08）、GPIO 封装验证 | API 框架搭建（F-01/02/03）、用户系统 API（U-01/02） | 管理后台框架（F-04）、小程序框架+登录（F-05/U-03） |
| Week 2 | 人脸 SDK 集成（FA-05/06）、本地人脸库 | 人脸 API（FA-01/02/03） | 小程序人脸录入页（FA-04）、个人中心（U-04） |
里程碑：用户可在小程序完成注册和人脸录入，工控机可完成本地人脸比对
第二阶段：AB 门核心逻辑（预计 2-3 周）
目标：AB 门完整进出流程可用，刷脸进门跑通端到端
| 周次 | 硬件端 | 后端 | 前端 |
|---|---|---|---|
| Week 3 | AB 门状态机（进入流程）（D-01/03） | 会员资格验证 API（P-02）、进出记录 API（D-09） | 管理后台用户列表（U-05） |
| Week 4 | AB 门状态机（离开流程）（D-02）、边界情况（D-04/05） | 远程开门 API（D-06）、产品 CRUD API（P-01） | 管理后台硬件控制面板（D-08） |
| Week 5（缓冲/联调） | 工控机云端回退验证（FA-08）、人脸同步（FA-07） | 联调配合、Bug 修复 | 管理后台产品管理（P-03） |
里程碑：在实际门店硬件环境中，用户可通过刷脸完成进出全流程
第三阶段：商业化核心功能（预计 2 周）
目标：用户可购买套餐，订单、支付、优惠券全流程跑通
| 周次 | 硬件端 | 后端 | 前端 |
|---|---|---|---|
| Week 6 | 灯光控制（H-03/04）、UPS 监控（H-06） | 订单+支付 API（O-01/02/03）、退款（O-04） | 小程序购买流程（O-05）、订单页（O-06） |
| Week 7 | 心跳上报（H-05）、灯控 MQTT 接收（H-01/02 配合） | 优惠券系统（C-01/02/03） | 管理后台订单管理（O-07）、优惠券管理（C-04）、小程序优惠券选择（C-05） |
里程碑：完整购买 → 刷脸进门 → 使用完毕的闭环商业流程可用
第四阶段：运营功能完善（预计 2 周）
目标：数据分析、多门店、灯控后台、飞书集成完成
| 周次 | 硬件端 | 后端 | 前端 |
|---|---|---|---|
| Week 8 | 淋浴硬件驱动（S-03/04，依赖方案确定） | 数据分析 API（A-01/02）、多门店 API（M-01） | 管理后台数据分析页面（A-04）、灯控面板（H-07）、告警中心（H-08） |
| Week 9 | 全端集成测试配合 | 飞书同步（A-03）、权限系统（M-02）、数据导出（A-05） | 小程序门店地图（M-04）、多门店切换、权限适配（M-03）、淋浴控制页（S-05） |
里程碑：系统功能完整，运营人员可通过管理后台独立操作
第五阶段：测试、优化与上线（预计 1-2 周）
| 任务 | 说明 |
|---|---|
| 端到端测试 | 模拟真实用户场景全流程测试 |
| 性能压测 | API 并发、MQTT 连接数 |
| 安全审查 | 支付签名、权限越权、人脸数据合规 |
| 硬件稳定性测试 | AB 门连续开关 N 次测试、断电恢复测试 |
| 文档完善 | 部署文档、运维手册 |
| 上线部署 | 生产环境部署、域名/证书配置 |
总工期汇总
| 阶段 | 预计工期 | 关键里程碑 |
|---|---|---|
| 第一阶段：基础 + 用户 | 2 周 | 微信登录 + 人脸录入跑通 |
| 第二阶段：AB 门核心 | 2-3 周 | 刷脸进出端到端联调成功 |
| 第三阶段：商业化 | 2 周 | 购买 + 刷脸闭环跑通 |
| 第四阶段：运营功能 | 2 周 | 管理后台完整可用 |
| 第五阶段：测试上线 | 1-2 周 | 生产环境正式上线 |
| 总计 | 9-11 周 | 约 2.5 个月 |
风险与缓冲
| 风险项 | 影响 | 应对策略 |
|---|---|---|
| 人脸识别 SDK 选型与调试 | +1 周 | 提前采购硬件进行预研 |
| 微信支付审核与联调 | +3-5 天 | 尽早提交微信支付申请 |
| 硬件到货延迟 | +1-2 周 | 提前下单，软件开发不依赖实体硬件（可先用模拟 GPIO） |
| 淋浴硬件方案延期确定 | 推迟 S 系列工作项 | 第四阶段前确认方案 |
| AB 门联调超时 | +1 周 | 在第二阶段末预留 1 周缓冲 |
总建议预留缓冲：在 9-11 周基础上额外预留 2 周，即预计总工期 11-13 周（约 3 个月）。