场景与技术范围
以网球场地预约商业项目为例,介绍 Claude Code 开发工作流。系统包含微信小程序、管理后台及统一 Python 后端,工作流强调需求文档、原型、基础能力验证、逐功能开发与上线准备。
工作流围绕需求澄清、接口边界、业务状态与交付验证展开。
系统分层
| 端或服务 | 职责 | 边界 |
|---|---|---|
| 微信小程序 | 会员、场地与课程预约 | 展示状态不等于预约已成功 |
| 管理后台 | 商品、订单与业务管理 | 管理员权限独立校验 |
| Python 后端 | 统一业务接口 | 不因共享接口而混淆角色权限 |
| 数据库与支付 | 订单、余额、时段与付款 | 状态变化需要可追踪 |
开发顺序从登录开始,因为后续数据和权限依赖统一身份。支付与上传等难点先用独立演示验证,再进入业务流程。
数据与状态设计
预约模型通过场地、时段、占用记录与订单描述资源和交易状态:
Court(id, name)
Slot(id, court_id, starts_at, ends_at)
Reservation(id, user_id, slot_id, status, expires_at)
Order(id, reservation_id, amount, payment_status)
available → held → confirmed
↘ expired / cancelled
同一时段的占用约束必须由服务端与数据库保障。前端按钮置灰只能减少误操作,不能防止多个用户同时抢占。
关键工程问题
预约占用与支付一致性
预约流程先建立有限时间的占用,再创建支付订单。支付确认后转为正式预约;超时释放前需检查真实订单状态。迟到的支付通知不能简单覆盖已释放且被他人占用的时段,应进入明确的补偿流程。
AI 辅助开发的上下文组织
工作流强调用需求文档与原型清楚描述业务,再准备技术资料,并按功能生成实现计划。每个任务应包含依赖、边界和验收条件,完成后做 Git 提交。AI 生成代码同样需要验证权限和异常路径。
环境隔离
开发、测试与生产分别配置数据库、接口域名和密钥。上线检查应覆盖 metadata、业务埋点和部署配置。测试预约不得使用真实生产库存。
验收标准
- 多用户同时请求一个时段时,最多只有一个有效占用。
- 普通账号不能调用管理员操作。
- 订单取消、支付超时和重复回调保持状态一致。
- 测试环境不能访问生产数据或占用真实场地。
- 回滚步骤与数据迁移策略有明确记录。
参考资料
- Claude Code 最佳实践:上下文管理、任务拆分与验证反馈的开发实践。
- Anthropic / Claude Code:Claude Code 官方项目,包含使用说明、示例与开发工具配置。