crm-backend-matt/.scratch/customer-rework/issues/09-audit-fixes.md

09 · 复核差异清单修复

• Status: resolved
• Type: task
• Blocked by: 08-audit-prototype

目标

修复 08 号票产出的 audit-findings.md 差异清单中"能机械修"的部分；"需决策"项单开票走 grilling。

范围（08 产出回填，2026-09-04）

依据 audit-findings.md（三节：镜头一 S 项 + 镜头二 F 项 + 归并建议）：

机械修（本票直接做）：

• S1：OpportunityRuleConstants.CODE_SCHEME_TPL_INVALID 64018→64022（解重复；引用处+测试同步）；
• F3：import 端点 tag 补挂"客户公海"（a4-1-1 工具条实证有导入入口，ADR-0024 多值）——补 5 个 import 端点注解 + bruno 侧副本生成；
• F10 若用户选"客户 oplog 扩操作类型"轻方案，则属本票；选独立表则单开票。

需决策（grill 后归票）：

• F5 战略协议（补 or 划出——原型有完整三页，翻案需确认）；
• F6 批量更新工商信息；F7 内置检索视图过滤参数（我负责/我协同/待跟进/我关注/最近访问）；F8 导入重复策略；F10 联系人操作日志形态；
• F4 关联项目（A5 依赖）、F9 导出日志（导出家族）——划出确认。

每修一项：对应单测/集成测试同步补；修复波及 .scratch/customer-module 文档的，随修随改（11 号票统一校验）。

验收

• 差异清单全部条目状态为"已修 / 已单开票 / 明确不修（记理由）"，无悬空项。

Answer（2026-09-05 收尾）

处置总览（明细见 audit-findings.md §四处置状态表）：

• 已修六项：
  • S1 错误码撞号——实改与票面建议相反：64022 已被 CODE_SCHEME_TPL_FIELD_INVALID 占用，故 CODE_SCHEME_TPL_INVALID 保 64018（64018-64022 归方案卡模板段），CODE_STAGE_TPL_SEED_PROTECTED 64018→64024 顺延补位；
  • F3 import 六端点双 tag 增挂「客户公海」；
  • F6 批量工商更新 POST /api/customer/company-lookup/batch-update（ids 表单绑定、§C2 只补空缺、五种状态软处置、上限 100；port stub 恒 NO_HIT，真实企查查接入自动激活）；
  • F7 审计口径偏差澄清——viewType 单参数已承载五内置视图，真缺口为 customer_view_log 生产侧零写入（票 04 建壳挂账），按实体 javadoc 设计意图在 detailHead 聚合时 upsert touchViewLog，零新端点；
  • F8 导入重复策略 duplicateStrategy（SKIP 缺省 / OVERWRITE 67013 拦非法；D24 冻结语义：作用面仅文件内重复组，overwrite=组内最后一条通过校验的行 UPDATE 生效；不触名称相似 SUSPECT）；
  • F10 联系人日志轻方案——客户 oplog 扩 CONTACT_ADD/EDIT/DELETE，联系人增删改三处写日志。
• 已单开票：F5 战略协议 → 票 12（原型三页完整，全栈实现+测试+bruno 移交）。
• 明确不修（记理由）：F4 关联项目随 A5 项目域划出；F9 导出日志随 D2 导出家族划出（均经用户 2026-09-05 逐项拍板）。

验证：mvn clean test -pl crm-customer -am BUILD SUCCESS——crm-customer 152 用例全绿（含 F6 +4、F7 +1、F8 +3、F10 +1 新用例），依赖六模块（base 38 / file 84 / auth 210 / dict 51 / rule 152 / preference 23）全绿；全模块 .java BOM 扫描 NO BOM。

随票移交：bruno 侧 F6/F8 新参数与 F7 行为示例未在本票内同步，随票 10 bruno 对账步统一核补（文档仓本机 D:\code\crm-api-docs）。