选题：社区奶茶/咖啡小店的「点单 + 会员 + 库存」轻量系统
目标：用 AI 编码助手（如 Claude Code）做 快原型—真可用—能交付 的闭环。
立场：它是“增效助手”，不替代工程判断；强调方法与边界，少夸张、重可复用。

一、项目概述（大众化、好落地）

• 核心功能：商品管理、下单、优惠/会员、库存扣减、日结报表。

• 约束：单店、轻并发、移动端点单为主；一周内可上线原型。

• 技术栈（示例）：FastAPI + SQLite（后端），任意轻量前端（HTML/JS）即可。

二、用 Claude Code 的工作法（六步闭环）

1. 先让它列计划

   • 提示词要点：给出用户故事、非功能性要求（性能/安全/日志），输出任务拆解与接口表。

2. 先 schema，后接口

   • 让它产出 ER 表、字段约束、关键索引；再生成 REST API 草稿与类型注释。

3. 逐模块生成

   • 以“控制器→服务→仓储”顺序产出，每次只给一个文件上下文，避免漂移。

4. 先测后改

   • 让它生成单测/假数据，用失败用例驱动修正实现。

5. 对话式重构

   • 明示“性能瓶颈/安全点”，要求输出“重构前后 diff 风格片段”。

6. 文档与脚本

   • 令其生成 README、启动脚本、种子数据与 Postman/HTTP 请求示例。

范式提示词模板（可直接复用）

• 「请按表格输出：模块、用户故事、成功标准、接口、边界条件。」

• 「基于下列 schema 生成 FastAPI 路由与 Pydantic 模型，必须含类型与错误码。」

• 「为函数 X 写 边界用例：空购物车、超库存、优惠叠加冲突。」

• 「对下面的实现做安全审计：SQL 注入、库存竞态、敏感日志。」

• 「生成最小可运行示例（MVP），并附 curl 自测脚本。」

三、技巧与经验（精简可执行）

• 上下文要“窄而准”：一次只谈一个文件/函数；用清单列出约束与返回格式。

• 固定风格：先给“命名/返回体/错误码”模板，要求严格遵循，减少返工。

• 多让它写“对照表”：接口—用例—日志字段三线对齐，便于联调。

• 把难点前置：优惠叠加、库存一致性、退款回滚，先出“失败路径”再写主流程。

• 版本锁定：要求生成 requirements.txt/uv.lock（或 Node 的 package-lock.json），避免依赖游移。

• 边界与风控：门店真实数据、密钥与个人信息不贴给模型；只喂假数据与结构。

四、优势与边界（克制表达）

• 可见优势：

  • 快速拉起原型，减少样板代码与文档编写；

  • 统一风格、自动补充类型与测试用例；

  • 对话式重构，便于小步快跑。

• 理性边界：

  • 生成代码需人工审查；

  • 需求模糊会引发“自信但错误”的实现；

  • 第三方依赖与安全策略必须由团队把关。

五、微型案例（一天打底的店内试点）

场景：社区奶茶店试点“手机点单+到店自取”。
过程：

• 上午：用 Claude Code 产出数据表、下单与库存接口；

• 下午：生成前端最小页与单测，导入 20 个商品假数据；

• 晚间：实地自测 30 笔模拟订单，定位优惠叠加与库存扣减两个 bug，通过“失败用例→修复→回归”闭环解决。
  效果：可运行的 MVP + 可复用测试清单。

注：这是方法演示，非商业承诺；实际周期取决于人员与约束。

如何借助 Claude Code 生成上述代码？
1）把“需求清单 + 字段表 + 错误码规范”贴给它；
2）让它先给出 Product/Order 的 Pydantic 模型与路由草稿；
3）要求生成 _apply_coupon 及其单测；
4）请它写 curl 自测脚本与“日结”接口；
5）我们人工审阅：校验库存竞态、错误码、一致性与输入合法性；必要时再次让它“生成重构补丁”。

七、落地清单（上手即用）

• 明确：接口规范、错误码、日志字段与脱敏规则

• 让 Claude Code 产出：任务清单 + schema + API 草稿

• 生成：单测 + 假数据 + 自测脚本

• 接入：简单鉴权、限流、健康检查与容器化

• 预演：真实设备下单 20～50 笔，记录问题与回归