前后端联调（API-Frontend Integration）

适用场景

• Mock 切换到真实 API
• 前后端字段名 / 类型对齐
• 错误码 → 前端提示映射
• Token / Cookie 传递验证
• 分页 / 筛选 / 排序参数对接
• 文件上传联调
• WebSocket / SSE 联调

核心原则

1. 类型共享（TypeScript 端到端）
   tRPC / OpenAPI 生成 / 共享 types 包