根据 spec 或一组 tickets 实现一项工作。

# 关于任务的说明与迁移方案框架

一、需要先说明的重要问题

• 您提到的“这份API重构spec”和“issues里的前3个ticket”并未随消息附上，我无法看到其具体内容。
• 为避免编造不存在的接口定义和ticket描述，我无法直接给出“15个接口逐一映射表”或假造的前3个ticket实现代码。
• 请补充材料（spec文档、issue列表/截图/文本），我即可输出精确的一对一迁移方案与代码。

二、在等待材料期间，可先确认的通用迁移框架

迁移前评估清单

• 盘点15个REST接口的：HTTP方法、入参、返回结构、调用方依赖
• 梳理orders、payments两表的字段、外键关系、高频查询模式（决定GraphQL Schema设计）
• 确认是否需要兼容期（REST与GraphQL双跑、灰度切流）

GraphQL设计要点

• 类型定义：Order、Payment及其关联（Order→Payments一对多），决定是否暴露嵌套查询
• 查询拆分：REST的列表+详情接口通常合并为一个orders(query)入口；写操作对应Mutation
• N+1问题：预埋DataLoader批量查询payments
• 分页规范：统一用Relay Cursor或offset，需与现有调用方确认
• 错误处理：GraphQL无HTTP状态码，需定义errors结构与错误码映射

实施步骤建议（对应前3个ticket的典型顺序）

1. Schema搭建：初始化GraphQL服务（Node/Apollo或您现有技术栈），定义Order、Payment基础类型与resolvers

2. 只读接口先行：迁移查询类接口（通常风险最低），用真实数据库做集成测试

3. 写操作迁移：实现创建/更新订单的Mutation，注意事务边界跨orders、payments两表时的处理

三、请您补充的信息

• spec文档原文或关键部分（15个接口的路径、参数、响应）
• 前3个ticket的标题与描述
• 技术栈偏好（如Apollo Server、GraphQL Yoga、hasura等）
• 是否要求REST/GraphQL并行过渡

提供以上材料后，我会输出完整的字段级映射表和可直接落地的实现代码。