10 Migration Scorecard

本文件记录 10-service-to-module-migration 的当前完成度，用于支持 M5 的持续追踪。

状态定义：

legacy
- handler/runtime 仍主要依赖旧 services/*
mixed
- 已部分接入 modules/*，但 HTTP 或 runtime 主入口尚未收口
contracted
- handler-facing 或 runtime-facing 主入口已收口到 modules/*/delivery
stabilized
- 已收口，且有 CI / 文档 / 兼容职责规则持续守护

判定补充：

若某能力已经收口，但尚未进入 scripts/module-boundaries.rules，不能标记为 stabilized
若文档已声明收口，但 CI 规则尚未覆盖，最多只能标记为 contracted

Scorecard

Capability	Handler Entry	Runtime Entry	Legacy Service Role	Status	Notes
`ticket`	`modules/ticket/delivery.HandlerService`	`ticketdelivery.NewHandlerServiceAdapter(...)`	compatibility facade + orchestration side effects	`stabilized`	handler/router/runtime 已收口，边界脚本已覆盖
`agent`	`modules/agent/delivery.HandlerService`	`services.AgentService` as contract impl	compatibility facade + runtime state holder	`stabilized`	handler DTO 与 transfer runtime contract 已回收到 module delivery；运行态内存状态仍在 legacy service；runtime surface 收窄已纳入边界脚本守护
`analytics`	`modules/analytics/delivery.HandlerService`	`services.StatisticsService` as contract impl	compatibility facade + event bus glue	`stabilized`	DTO 已抽到 module contract，handler 不再直连 concrete service
`routing / session transfer`	`modules/routing/delivery.HandlerService`	`services.NewSessionTransferServiceWithAdapters(...)`	compatibility facade + runtime glue	`stabilized`	session 读取/assignment/system message 已走 conversation runtime adapter，waiting queue/transfer record 已走 routing module，ticket assignment 已走 ticket module runtime adapter，agent load 调整已走 agent module runtime adapter；websocket 通知依赖已收窄为接口，主运行时也已切到显式 adapter 装配，setter 式注入已移出活跃路径
`conversation / websocket runtime`	n/a	`modules/conversation/delivery.WebSocketMessageWriter`	runtime connection hub	`stabilized`	主 runtime 与 lightweight realtime runtime 都已走 adapter 注入
`ai`	`modules/ai/delivery.HandlerService`	`AIAssembly.RuntimeService`	runtime compatibility surface for websocket/router/transfer	`stabilized`	handler 主路径已切到 orchestrated enhanced AI；assembly 不再暴露 legacy concrete AI service
`customer`	`modules/customer/delivery.HandlerService`	`modules/customer/delivery.NewHandlerService(db)`	compatibility facade + DTO mapping for old callers	`stabilized`	handler/router/runtime 主路径已直接走 module delivery，集成测试与边界脚本已守护
`automation`	`modules/automation/delivery.HandlerService`	`modules/automation/delivery.NewHandlerService(db)`	compatibility facade + event bus glue	`stabilized`	handler/router/runtime 主路径已直接走 module delivery；subscriber 仍在 legacy service，但 HTTP 入口与测试已收口
`knowledge`	`modules/knowledge/delivery.HandlerService`	`modules/knowledge/delivery.NewHandlerServiceWithProvider(db, ...)`	compatibility facade retained for old callers	`stabilized`	handler/router/runtime 的主路径已走 module delivery；index job 仓储与 WeKnora provider 装配已纳入 runtime 主路径，并进入边界脚本守护
`voice`	already module coordinator	module coordinator	not primarily legacy	`mixed`	已较模块化，但不属于本轮 `services -> modules` 的典型迁移样式

当前结论

ticket、agent、analytics、routing、conversation runtime、ai、customer、automation、knowledge 已具备持续守护条件
customer 的旧 facade 仅保留历史调用兼容与 DTO 映射职责
automation 的旧 facade 仅保留 event bus subscriber 与少量兼容 glue
knowledge 已完成 handler/runtime 收口，索引任务仓储与 provider 集成已纳入 module delivery 主路径
一批尚未模块化的薄 handler 能力已完成 app/server 装配面收口：satisfaction、macro、app integration、custom field、shift、suggestion、gamification
message router 已完成 runtime/router/handler 装配面收口，保留 concrete 生命周期实现于 services.MessageRouter
sla 已完成 handler/runtime/router 的装配面收口，但 service 本体仍保留 automation glue 与 runtime 组装职责
realtime runtime 已去掉 WebSocketHub / WebRTCService 的顶层 concrete 暴露，仅保留 gateway contract 与内部启动细节
上述 stabilized 条目都已进入 scripts/module-boundaries.rules，其中 customer / automation / knowledge 的 handler 集成测试也已切到 module delivery 主路径
旧 services/* 仍然存在，但对这些能力来说，已不再是 HTTP 默认入口
下一阶段重点不再是“再找一个模块收口”，而是：
- 扩大 scorecard 覆盖范围
- 持续压缩剩余 legacy 状态条目，并补齐 knowledge 的 indexing/runtime 策略
- 为 legacy 条目明确冻结策略与退役条件