待测试

2026-07-28 07:58:26 +08:00
parent 1e9e25fe67
commit 6fbcf21024
22 changed files with 1294 additions and 264 deletions
@@ -1,9 +1,11 @@
 # Apifox 写接口字段—表单控件映射

+> 当前有效的 149 operation 总表、页面 owner 与阻塞项见 [APP-149接口页面归属与表单字段审计-2026-07-27.md](APP-149接口页面归属与表单字段审计-2026-07-27.md)。本文件保留为字段控件速查表；其中以下修订以根目录最新 `家谱.openapi.json` 为准。
+
 ## 口径与来源

 - 核对时间：2026-07-27。
- 主源：桌面 Apifox 当前 `APP` 项目中的接口详情；根目录 `家谱.openapi.json` 只用于补全接口路径和没有展示在当前屏幕中的普通字段。
+- 主源：桌面 Apifox 当前 `APP` 项目（149 条 operation）及同一时刻导出的根目录 `家谱.openapi.json`；两者的 operation 数量一致。
 - `必填` 以 Apifox `必需` 标记为准；没有 `必需` 的字段均应允许不填，提交时传空值或省略由当前 API 适配器统一处理。
 - `枚举选择` 只能提交下表列出的 value，不能把中文标签提交给后端。
 - `候选选择` 只能从对应选项接口选取，页面不得暴露裸露的内部 ID 输入框。
@@ -129,7 +131,7 @@
 | `ceremonyDesc` | 否 | 多行文本 |
 | `ceremonyTime` | 否 | 示例为 `yyyy-MM-dd HH:mm:ss`；日期 + 时间选择 |
 | `location` / `locationAddress` | 否 | 地点名称、详细地址文本框；两项都应保留 |
-| `longitude` / `latitude` | 否 | decimal 数字框；应由地图选点回填，不能把经纬度当文本 |
+| `longitude` / `latitude` | 否 | 仅可由地图选点组件成对回填；当前没有地图候选/选点合同，R07 不暴露手输框，也不传这两个字段。API 适配层只接受成对有限数字，供后续真实地图组件使用。 |
 | `coverOssId` | 否 | 图片上传，字符串 OSS ID |
 | `sortOrder` | 否 | 整数数字框 |
 | `status` | 否 | `sys_normal_disable` 选择，默认 `0` |
@@ -177,7 +179,7 @@
 | `GenerationPoemBody` | `generationNo` 必填正整数；`generationText` 必填文本；`description` 多行文本；`sortOrder` 数字；`status` 用 `sys_normal_disable`。 |
 | `GenerationPoemBatchBody` | `poemText` 必填多行文本；`disableMissing` 布尔开关。 |
 | `FamilyFeedCommentBody` | `parentCommentId` 为评论候选/回复上下文，不能输入 ID；`commentContent` 必填多行文本。 |
-| `FeedbackBody` | `feedbackType` 当前详情为 string，待字典明确前为文本；`feedbackContent` 必填多行文本；`contactInfo` 文本。 |
+| `FeedbackBody` | `feedbackType` 选填枚举选择：`advice` 建议、`bug` 功能问题、`complaint` 投诉反馈、`other` 其他；界面显示中文标签，提交 value。`feedbackContent` 必填多行文本；`contactInfo` 文本。 |
 | `VipOrderBody` | `packageId` 必填，VIP 套餐候选选择；`genealogyId` 为当前家谱上下文选择；`payType` 只能使用支付方式字典，不能手填代码。 |
 | `VideoBody` | `videoTitle` 必填文本，`videoDesc` 多行文本，`coverOssId`/`videoOssId` 为上传，`durationSeconds`/`sortOrder` 为数字，`status` 为 `sys_normal_disable`。 |
 | `CeremonyInviteesBody` | `inviteeUserIds` 必填多选业务用户候选；无候选接口不能用逗号文本代替数组。 |
@@ -192,4 +194,4 @@
 1. 已经可以立即改为选择控件的字段：`sex`、出生/逝世农历、`personStatus`、`visibility`、`joinMode`、所有 `status`、`meritType`、邀请响应。
 2. 必须改为候选选择的字段：所有家谱/成员/世系人物/分类/套餐/受邀用户的 ID 字段。
 3. 必须改为上传的字段：所有 `*OssId`、`mediaOssIds`、头像、封面、照片、视频文件。
-4. `completed`、`feedbackType`、`payType`、审核 `status` 等尚未在当前 Apifox 字段详情给出允许值；在后端未提供字典或候选接口前，不增加猜测性选择项。
+4. `completed`、`payType`、审核 `status` 等尚未在当前 Apifox 字段详情给出允许值；在后端未提供字典或候选接口前，不增加猜测性选择项。`feedbackType` 已有四个枚举值，已改为选择控件。