forge-town tRPC 按需查询接口设计规范
本 Skill 指导在 tRPC 架构下，通过标准化的 include 和 fields 参数，为查询接口添加按需数据加载与字段裁剪能力，无需引入 GraphQL。
使用说明
- 阅读 按需查询设计指南，了解参数设计规范与执行流程
- 参考 Router 实现示例 了解完整实现
- 参考 Schema 定义示例：BattleSchema.ts、BattleExtendedSchema.ts、GetBattleInputSchema.ts
- 使用 检查清单 验证实现是否符合规范
核心规范
- 双参数设计：
include（扩展字段加载）+fields（响应裁剪），职责分离 - 三步执行流程：基础查询 → include 扩展加载 → fields 字段裁剪
- 枚举 include 选项：使用
z.enum([...])明确声明支持的扩展字段名 - 权限校验：扩展字段按需进行权限检查（不加载即不暴露）
- 一级限制：仅支持一级扩展，禁止嵌套 include（如
user.friends.votes） - 降级安全：
fields包含未加载的 include 字段时，静默忽略并记录 warning