CraftKit/plugins/dev/skills/prepare-api/references/mapping.md

映射规则

按页面动作建立接口清单，再分别映射请求和响应：

• 字段的业务含义、路径、必填条件、基数、空值和默认值。
• 前端表示与传输类型，以及初始化和提交两个方向的转换。
• 标识符精度、金额精度、日期时间格式与时区、枚举值域和嵌套结构。
• 查询、分页、排序、筛选、批量和文件传输约定。
• 成功、业务拒绝、输入错误、认证授权失败和系统失败的呈现需求。

名称不同但含义一致时记录映射证据；名称相同但含义或单位不同时列为冲突。未匹配字段和缺失接口必须完整保留，不用猜测值或临时 Mock 隐藏缺口。