crm-backend-matt/.scratch/customer-module/tickets/11-opportunity-customer-wiring.md

11 — 商机模块客户接口对接（切真源）

What to build: 把 crm-opportunity 里之前 A4 未建时的降级 stub 全部切到真实 customer 数据源，让商机侧「关联客户 / 关键联系人 / 客户搜索 / 快速建客户」真正打通客户模块；同时接上 customer 侧「关联商机」页签的反查 port。这是清偿 A4 未建时留下的技术债。

Blocked by: 02 — 客户主表 CRUD + 查重校验；03 — 联系人子表；06 — 客户详情页（关联商机 port 定义）

Status: ready-for-agent

背景：A4 未建期间 crm-opportunity 用了多处降级 stub（返回空列表/仅存引用 id）。customer 建成后需切真源，签名不变。依赖方向只走 opportunity → customer 单向；customer 侧「关联商机」反查通过 customer 定义、opportunity 实现的出站 port 解耦（ADR-0029 范式），不形成 Maven 循环。

• crm-opportunity/pom.xml 增加依赖 crm-customer（单向，opportunity → customer）
• OpportunitySubController / IOpportunitySubService#listCustomerContacts(customerId)：stub 返回空列表 → 改调 customer GET /api/customer/{id}/contacts 真源；CustomerContactDTO 由 stub 字段占位 → 真源填充（签名不变）
• searchCustomers(param)：票 04 D-02「候选客户池降级=取关联客户快照去重」→ 切 customer POST /api/customer/search（四维模糊+分页）真源
• OpportunityCustomer.customerId（"客户模块 A4 未建：引用 id + 名快照并存"）：确认关联真实 customer 记录；customer_name_snapshot 免 join 展示保留（快照口径不变）
• POST /api/customer/quick-create（商机弹窗快速建客户入口）真源接线
• customer 侧「关联商机」页签（票 06 定义的 CustomerOpportunityQueryPort）：在 crm-opportunity 实现该 port（按 customer_id 反查该客户全部商机：名称/编号/阶段/预计金额/负责人/最近更新），供客户详情页签只读展示
• 回归：切真源后 crm-opportunity 原有关联客户/联系人相关测试仍绿；跨模块调用无循环依赖、mvn compile 全绿
• 清理 stub 上遗留的"A4 未建/降级"注释，改为正式实现说明