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 仍只输出中文显示值。