You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3.6 KiB
3.6 KiB
04 — 新增/编辑客户的查重校验 + 企查查工商回填 seam
Type: research Status: open Blocked by: 02
问题
定新增/编辑客户表单的查重校验规则（内建在新增流程、写死不做后台可配）+ 企查查外部服务契约 seam（调用点/回填范围/异常/精确查重触发）。A4-6 独立查重页 + 客户合并不做（chart grill D6）。
一手证据（蓝湖缓存 txt）
a4-3-3-1_新增客户信息.txt— 主页面 §3.2 客户名称与自动查重 / §3.3 企业查询与工商信息回填 / §3.4 客户重复校验 / §3.5 联系人明细表 / §3.6 工商信息a4-3-3-2_编辑客户信息.txt— 编辑页复用新增结构 + 有 seam
已知事实（原型明文，节选）
- 自动查重（防抖）：客户名称停止输入→防抖异步查 CRM 相似客户；仅名称输入框下方展示相似列表；只提示、不阻止；无权限的匹配脱敏为「存在匹配记录」不显 name/编号/负责人。
- 企业查询：
查询企业→调外部工商服务→候选列表→单选回填。首次选择只回填当前为空且属于允许范围的工商字段（工商名称/信用代码/法代/成立时间/注册资本/经营范围/人员规模/年产值/工商注册地址）。已填字段再次选择必须弹「受影响字段确认」再覆盖；空值不覆盖原值。不覆盖：客户类型/行业/所属地区/关系星级/负责人/部门/协同人/人脉关系单位/联系人/备注。 - 精确查重触发：选择企业并回填后立即用统一社会信用代码执行精确查重；保存时再执行一次终查。
- 保存时校验（服务端最终查重）：
- 统一社会信用代码在全部未删除客户中必须唯一 → 完全相同硬拦禁止创建（含无权查看时不显 name/编号，只提示阻断）。
- 客户名称相似但信用代码不同 → 弹「客户相似确认」弹窗，用户可"仍要创建"；"仍要创建"后服务端必须再查一次（防并发/防中间被人创建同信用代码）。
- 联系人明细表内联查重：同表格内联系电话相同→禁止提交定位重复行；无电话按「客户+姓名+职务」提示疑似重复；全库按电话查重（对已存在联系人）。→ 联系人查重口径归本票，联系人 CRUD 建模归票 06。
- 父子客户防环：
是否子客户=是时父客户必填；父客户不得选择自身及其下级 → 服务端必须校验不得形成循环。 - 人脉关系单位：标签集（单个≤50字，同 name 不重复），非关联 CRM 客户。
待拍板点
- 相似客户判定口径（阈值/算法）——原型说「使用 CRM 后端统一查重服务，不在前端固化阈值」。本票拍板：走什么算法（简单 Trigram / MySQL 全文索引 / 编辑距离 / N-gram 分词）？先给最简可行方案。
- 企查查外部服务契约 seam：不深挖服务实现，只定接口（
CustomerCompanyLookupPort?）+ 请求(name)/响应(候选列表带9项工商字段)/异常语义（无结果/失败/超时）；实现可 mock。 - 信用代码格式校验：18 位数字或字母组合（原型明说，正则拍死）。
- 成立时间不得晚于当前日期 前置校验。
- 并发建客户（同信用代码并发提交）：DB 唯一约束兜底 + 乐观返回「重复」错误；先查后写做双保险但不依赖它。
- 相似客户提示的脱敏：无权限用户命中他人客户时的返回负载最小化（不带 name/编号/负责人/联系方式），只回「命中数量+提示语」。
Answer
(待 resolve)