# 10 — 接入电信实名回调

**What to build:** 电信 XML 回调可以按真实协议识别实名补录成功，并通过公共实名观测幂等更新卡；同一路由收到实名信息清除时只留痕忽略。无效报文、未找到、冲突和重复成功均按安全规则记录并返回运营商约定应答。

**Blocked by:**

- 01 — 建立回调 ICCID 精确唯一性发布门禁
- 02 — 交付实名观测的公共写入闭环
- 06 — 交付可合并的 0/3/5 观测序列

**Status:** ready-for-agent

**架构通道:** 主通道为 Infrastructure Adapter，辅助通道为复杂写。

**完整业务边界:** 本票只实现已知电信 XML 报文的 Translator、成功应答、系统级精确查卡和实名观测接入。明确不创建电信独立解除实名路由，不验证来源真实性，不调用 Gateway 二次确认、旧第三方推送或删除实名接口。

- [ ] 回调仅在结果消息为成功且受理消息包含实名信息补录完成时生成已实名观测；实名信息清除只写 `ignored` Integration Log。
- [ ] ICCID 去除首尾空白后仅接受合法 19 或 20 位值，并分别精确查询对应列，禁止截断、补位、模糊匹配和跨列降级。
- [ ] 系统级 Repository 不应用登录账号数据范围；未找到记录 `not_found`，多匹配记录 `conflict`，均不任取卡写入。
- [ ] 重复成功回调幂等返回成功，不重复首次实名、套餐激活或领域事件，并提前完成同卡未执行实名序列。
- [ ] 报文级解析失败记录 `invalid_payload`；可安全识别的无效业务结果按运营商约定成功应答，日志和 Access Log 不保存完整报文或明文 ICCID。
- [ ] 新 Handler 完成路由注册和两个 OpenAPI 文档生成器接入；脱敏 XML fixture 契约测试覆盖成功、清除、业务失败、非法长度、未找到、冲突和重复成功。
