docs: design bilingual inquiry dictionary mapping

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
ping 2026-08-07 10:08:01 +08:00
parent cd8e267c30
commit 3d4a146174

View File

@ -0,0 +1,29 @@
# 咨询字典双语接口设计
## 目标
咨询相关接口适配 `product_inquiry_dict` 的双语字段
`dict_value_zh``dict_value_en`,不再读取旧字段 `dict_value`
## 接口调整
- `search_user_inquiry.dspy` 同时查询并构建中英文映射。
- 普通咨询列表分别返回 `*_name_zh``*_name_en`
- 单选字段包括客户类型、企业类型、区域和反馈状态。
- 多选咨询方向分别返回 `consult_direction_name_zh`
`consult_direction_name_en`,并保持原选项顺序。
- Excel 导出继续使用中文表头和中文字典值。
- `search_user_inquiry_dict.dspy` 明确返回
`id``dict_type``dict_key``dict_value_zh`
`dict_value_en``sort_order`
## 兼容边界
旧的 `*_name` 单语字段不再生成。调用方应读取对应的
`*_name_zh``*_name_en` 字段。
## 验证
- 字典查询不再引用 `dict_value`
- 普通列表中的单选和多选字段均包含中英文显示名称。
- Excel 仍只输出中文显示值。