收口V4 Trace卡后端契约

This commit is contained in:
andy
2026-07-21 17:47:25 +07:00
parent 0c4f5e298d
commit 38661257d1
16 changed files with 1054 additions and 21 deletions

View File

@@ -504,7 +504,7 @@ RESERVATION_ROOMING_LIST_GENERATE
- 所有按钮应按后端 `availability.confirmable``availability.reviewable``availability.ackable` 和前端权限共同控制;不可操作原因优先展示 `readonly_reason_message`,否则按 `readonly_reason_code` 做友好映射。
- `fields[].validation_errors` 应展示在对应字段旁边;接口返回 `V4_FIELD_VALIDATION_FAILED``details[]` 带嵌套路径时,前端应尝试定位到对应 field定位不到则在当前卡片动作错误区展示。
- `options_source=reservation_v4_account_catalog``reservation_v4_room_type_catalog``reservation_v4_rate_code_catalog` 时,前端应调用对应 lookup API不再硬编码固定种子如果 lookup 返回空列表或 `warnings[]`,前端展示非阻塞提示,但提交时仍以后端目录校验为准。
- Trace 卡 `trace_items[].department_code` 第一版先固定下拉选项 `FO``HSK``FO+HSK`不要调用不存在的 Department lookup API也不要允许自由文本正式 Department 目录和后端目录校验后续单独扩展
- Trace 卡第一版使用稳定业务展示模型:普通事项内容字段统一为 `trace_items[].text`,不要使用或提交 `trace_items[].content``GENERAL` 的可编辑字段为 `/trace_items/{index}/text``/trace_items/{index}/department_code``EXTRA_BED` 的可编辑字段为 `/trace_items/{index}/target_room_type_code``/trace_items/{index}/extra_bed_room_count``/trace_items/{index}/department_code``department_code` 固定下拉 `FO``HSK``FO+HSK`后端在对应字段返回 `options_source=reservation_v4_trace_department_fixed``fixed_options[]``target_room_type_code` 使用 Room Type lookup`extra_bed_room_count` 为正整数;确认和复核都只提交 `fields[]` 暴露的白名单 pointer不要提交 `target_order`、邮件正文、附件 URL、raw evidence 或 Agent 原始 payload
- 前端不展示 `ai_payload_json`、附件 URL、raw evidence 或 SuperAgent 原始 payloadV4 任务详情页底部 `SOURCE_MESSAGE_DISPLAY` 可展示当前触发该 order task 的 SourceMessage 正文,但必须通过 `GET /api/source-messages/{sourceMessageId}/conversation` 读取并写原文读取审计,不能要求 `GET /api/reservation/order-tasks/{orderTaskId}` 直接返回正文。Payment 卡如展示付款凭证图片,也必须通过同一会话接口获取受控附件 URL卡片内显示缩略图点击打开大图预览非图片只显示文件列表和下载。HTML 邮件优先渲染 `html_body_sanitized`,缺少原文权限或接口失败时降级为安全摘要和“查看邮件会话”入口。
- V4 来源消息卡读取 `attachments``uploaded_media``file_references` 时,只允许展示附件名称、类型和大小等安全摘要;如果后端 payload 中异常出现 `https://``oss://``s3://` 等直接 URL 字符串,前端必须替换为“未命名附件”或隐藏,不得把 URL 渲染到普通业务页面。`SOURCE_MESSAGE_DISPLAY` 的邮件正文默认做长度折叠,用户可展开全文。
- V4 主流程不调用旧 V2/V3 草稿、旧任务确认、旧同卡复核接口,也不展示 OPERA 模拟操作入口。