Rogeeandrogee
c922460649
* H-60: harden Captain migration rollback and concurrency * chore(agent): baseline — uncommitted work from the local directory * fix: route Shangwutong events by display id --------- Co-authored-by: Rogee <rogee@ipao.vip>
3.2 KiB
审查结论：不通过，有阻断项；不能批准 H-23 当前实现。
-
P0：kind=52 的 cid 实际不会持久化，反写闭环不可达。
channels/shangwutong/internal/delivery/mapping.go:170-172只设置ContactCID，但仍保持RawOnly=true且RequiresContact=false；随后channels/shangwutong/internal/delivery/inbound.go:106-108直接完成事件，根本不会执行ensureResources的ChannelMetadata写入（:165-167）。即使只把 kind=52 标成需联系人，:168的needsContactWrite也没有包含ContactCID，已有联系人仍不会发 PATCH。结果是contact_inboxes.channel_metadata.cid为空，监听器永远不会创建contact_updatedjob。最小修复：kind=52 走仅写渠道元数据的路径，并将 CID 变化纳入写入条件；保留不改变 Contact 可编辑字段的约束。 -
P1：公共 Contact Create 的已有 source 分支丢弃 cid。
backend/internal/service/widget_service.go:769-784调用setContactInboxChannelMetadata后只修改内存对象，没有contactInboxRepo.Update；新建分支:798-807才会落库。只要 CID 到达已有 contact_inbox，就会静默丢失。应在 metadata 实际变化时持久化，并覆盖回归测试。 -
P1：公共 API 接受客户端可编辑的 cid，存在错误访客反写风险。
backend/internal/handler/widget/widget_handler.go:1394-1430从 public 请求绑定channel_metadata，backend/internal/service/widget_service.go:821-845在 PublicUpdateContact 中写入它。HMAC 可配置为非 mandatory；此时知道 source_id 的访客可提交任意 cid，客服后续改名会按该 cid 调用 changecname.aspx，可能修改错误商务通客户。这也违反“cid 不作为可编辑业务属性”。应将 cid 写入限制到受信任的 Connector 内部接口/强制 HMAC 路径，公共 Contact API 不接受该字段。 -
P1：durable job 入队错误被吞掉，更新成功但反写任务可永久丢失。
backend/internal/handler/api/v1/contact_handler.go:293-297忽略channelDispatcher.Dispatch错误。数据库/worker 暂时不可用时 Contact 已提交，HTTP 仍返回 200，且没有重试或补偿。应把更新与 durable enqueue 放进同一事务，或至少传播失败并提供可靠补偿。 -
P2：Connector 回滚迁移会删除所有姓名反写 operation。
channels/shangwutong/db/migrations/002_add_rename_operation.down.sql:1-21只复制operation='end_conversation'的行，随后 drop 原表；pending、delivered、uncertain 的change_contact_name记录都会被静默删除。回滚应拒绝存在这类数据，或先保留/迁移这些记录，不能无提示丢任务。
测试证据：cd channels/shangwutong && go test ./... 通过；相关后端 handler/widget、channel、service 定向测试通过。cd backend && go test ./... 仍失败于 internal/database/TestRollbackMigrations_EmptyPath_Cov8 和 internal/service/TestMessageService_Create，两项在父提交 4bf6ba6b 也可复现，非本改动引入。Connector 的 ChangeContactName 使用本地 httptest 验证了 form 与 r: ok，但没有覆盖 cid 从 kind=52 到 contact_inbox、跨 inbox、重复 contact_updated webhook 的端到端假服务测试。