07-方案先行：先定数据模型与接口契约.docxVIP

07方案先行：先定数据模型与接口契约

FDE一个人干全栈，最大的便利是前后端之间没有沟通损耗，最大的风险也是：脑子里的接口定义和页面假设不写下来，两周后自己都忘了。所以方案阶段必须产出两样东西：数据模型和接口契约。

数据模型先行：先画出核心实体、字段、关系，再谈页面。因为页面是数据的投影，表结构定清楚了，页面结构自然清晰。字段设计注意三点：命名统一（如create_time全项目一致）、类型贴合语义（金额用定点数不用浮点）、冗余可控（预先计算值如订单总额，明确由谁维护）。

接口契约先行：为每个接口写清楚路径、方法、请求参数、响应结构、错误码。契约明确后，前端页面与后端实现可以各自推进，互不阻塞，也方便让AI分别生成两端代码时参照同一份契约。

让AI提效的方式：把需求描述喂给AI，让它产出数据模型草案和API文档草案，然后你对照本文的检查清单逐项评审：命名是否一致、分页/排序/过滤是否齐备、鉴权是否覆盖、写操作是否幂等、错误信息是否对用户友好。契约评审通过后再写代码，能省掉大量「接口对不上」的返工。