# 09 — 客户导入 + 联系人快速新增（OCR 划出）

Type: research
Status: open
Blocked by: 02

## 问题

定客户 Excel 批量导入流程（模板下载 / 上传解析 / 校验 / 结果反馈）。**OCR 快捷新增划出**（chart D2），本图只做 Excel 导入。

## 一手证据（蓝湖缓存 txt）

- `a4-3-2_客户导入.txt` — 客户导入主页
- `a4-3-2_新增客户信息.txt` — 与新增页同族（同 a4-3-2 前缀，可能是导入后进入新增回显）
- `a4-3-5_客户导入.txt` / `a4-3-6_客户导入.txt` — 导入步骤/结果页
- `a4-3-3-3______.txt` / `a4-3-3-4_ocr____.txt` / `a4-3-5_ocr____.txt` — OCR 相关（划出，不读）

## 已知事实（待原型细读补充）

- 模板下载 → 用户填 → 上传 → 后台异步解析 → 结果表（成功/失败逐行）。
- 复用票 04 查重口径：信用代码唯一硬拦、名称相似只提示不阻断（导入场景可能改为「相似=跳过」或「相似=创建但标记」）。
- 复用票 02 字段清单：必填校验（客户名称/客户类型/所属地区/行业/星级/关系星级）。
- 销售负责人：允许在 Excel 里指定 or 默认导入者。

## 待拍板点

1. **导入策略**：全成才提交（整体事务）vs 逐行独立事务（部分成功）？→ 推荐**逐行独立**（对称一般 CRM 导入的常识 + 商机模块导入若已建可参照）。
2. **异步 vs 同步**：批量大（>500）走异步任务 + 轮询进度 vs 同步阻塞？→ 推荐**同步小批 + 异步大批**双通道，阈值可配。
3. **相似客户在导入场景的处理**：跳过 / 创建但标记 / 报错 → 拍板。
4. **导入历史记录表** `customer_import_batch`：批次号 / 上传人 / 上传时间 / 总数 / 成功数 / 失败数 / 状态 / 失败明细文件 url。
5. **模板字段清单**：Excel 列 = 客户主表可导入字段子集（工商信息、附件、人脉关系单位标签集怎么表达？→ 标签用「;」分隔）。
6. **联系人一起导入**：Excel 是否含联系人 sheet？还是分两批？→ 推荐只导客户主表，联系人另导（联系人导入本图划出，见票 06）。

## Answer

_(待 resolve)_