YH. 周毅恒PERSONAL PORTFOLIO
菜单 +
← 返回项目列表
CASE STUDY / 03 / ENGINEERING / WORKFLOW

商业项目开发工作流

以网球场地预约为案例,梳理需求、开发、测试与上线流程。

Claude CodePython微信小程序

打开交互 Demo ↗

内容类型技术案例与方案拆解
阅读重点架构 · 数据 · 失败边界
技术主线身份 · 状态 · 数据一致性
01 / FOLLOW THE REQUEST架构流程 · 节点详解
STEP / 01

需求与原型

工作流强调先从产品视角描述场地预约、会员卡与管理端行为,再做技术方案。

需求 → 页面 → 交互 → 验收条件
点击节点查看数据如何流动

场景与技术范围

以网球场地预约商业项目为例,介绍 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、业务埋点和部署配置。测试预约不得使用真实生产库存。

验收标准

  • 多用户同时请求一个时段时,最多只有一个有效占用。
  • 普通账号不能调用管理员操作。
  • 订单取消、支付超时和重复回调保持状态一致。
  • 测试环境不能访问生产数据或占用真实场地。
  • 回滚步骤与数据迁移策略有明确记录。

参考资料

NEXT CASE / 04

AI 漫剧创作平台 ↗