docs: 实名记录与二次实名接口登记到 OpenAPI 文档

openspec/changes/add-realname-time-history/tasks.md

@@ -13,7 +13,7 @@
 
 - [x] 3.1 领域纯函数 `DecideRealnameTime`：上游优先 → 保持 → 首次读到；相同不写；未实名不写；二次实名新旧判定；表驱动测试覆盖 spec 全部场景
 - [x] 3.2 `ApplyCardObservation` 事务内锁定 / 创建当前实名记录，按决定更新并追加历史；二次实名 pending 时拦截旧实名观测
-- [ ] 3.3 集成测试：重复轮询不写历史、上游更正 migrated 时间、逆转后再实名不写历史
+- [x] 3.3 集成测试：重复轮询不写历史、上游更正 migrated 时间、逆转后再实名不写历史
 
 ## 4. 沉默期与展示切换
 
@@ -32,7 +32,7 @@
 
 ## 6. 验证与部署
 
-- [ ] 6.1 `go build ./...`、`go vet`、相关包测试通过
+- [x] 6.1 `go build ./...`、`go vet`、相关包测试通过
 - [ ] 6.2 部署测试环境（网关只读保持开启），用 89860885192590574640 验证当前实名时间被更正为 2026-07-16 19:43:39 且只写一条历史
 - [ ] 6.3 测试环境演练二次实名清除与撤销，确认 C 端显示未实名、无二次实名字样
-- [ ] 6.4 更新 `docs/` 前端对接说明（实名记录、二次实名接口与权限）
+- [x] 6.4 更新 `docs/` 前端对接说明（实名记录、二次实名接口与权限）

pkg/openapi/handlers.go

@@ -68,6 +68,7 @@ func BuildDocHandlers() *bootstrap.Handlers {
 		PollingConcurrency:            admin.NewPollingConcurrencyHandler(nil),
 		PollingMonitoring:             admin.NewPollingMonitoringHandler(nil),
 		PollingAlert:                  admin.NewPollingAlertHandler(nil),
+		CardRealname:                  admin.NewCardRealnameHandler(nil, nil, nil),
 		PollingCleanup:                admin.NewPollingCleanupHandler(nil),
 		PollingManualTrigger:          admin.NewPollingManualTriggerHandler(nil),
 		PollingPriority:               admin.NewPriorityPollingHandler(nil, nil, nil),