lingniu-vehicle-ingest/vehicle-data-platform/docs/design/access-identity-governance-continuity-20260723/README.md

接入身份治理连续性审计

结论

本轮把接入管理中原本只读的“来源身份待绑定”卡片改造成可完成、可恢复、可审计的处置任务。管理员现在可以在同一个治理工作面中核对来源证据、搜索并选择现有权威车辆、明确确认风险、提交绑定、取得审计回执，并根据车辆档案缺口继续补全主档。

关键变化

1. 治理列表新增“开始认领”，不再只描述问题。
2. 认领任务沿用既有治理 SideSheet：桌面 640 px 宽，移动端为近全高 bottom sheet；内容独立滚动，返回与确认操作固定。
3. 认领分为核对来源、选择主车辆、确认并留痕三步；候选项只来自现有权威车辆，不允许手填或猜测 VIN。
4. 保存前必须勾选证据确认；说明支持最多 500 字，冲突和失效来源均有可见反馈。
5. accessGovernance=claim&accessIdentity=... 保存任务位置；失效深链会解释可能原因并返回治理列表。
6. 后端事务同时校验来源注册、权威 VIN 和既有手机号绑定，更新 vehicle_identity_binding 与 jt808_registration，并写入不可变 vehicle_access_identity_audit。
7. 成功回执显示操作者、时间、审计编号、目标 VIN 和车辆档案完整度；档案不完整时直达 /vehicles/:vin#vehicle-archive-panel。
8. 认领完成后未解析队列即时从 1 归零；关闭工作面后键盘焦点返回治理入口。

浏览器证据

• 桌面：1440 × 1000，验证治理列表、认领入口、三步任务、候选车辆、预览和固定操作区。
• 移动：390 × 844，验证近全高 bottom sheet、单一内容滚动、固定底栏、提交回执和档案补全入口。
• 失效深链：能展示“待认领来源已失效”及返回动作。
• 焦点：关闭治理抽屉后 document.activeElement 恢复为 aria-label="打开接入治理" 的按钮。

截图：

• before/02-desktop-governance.png、before/04-mobile-governance.png：只读基线。
• after/01-desktop-governance.png、after/03-mobile-governance.png：同状态下新增明确认领入口。
• after/02-desktop-claim-review.png、after/04-mobile-claim-review.png：桌面与移动端确认状态。
• after/05-mobile-claim-success.png：审计回执和 7 项档案待补结果。
• comparison-before-after.png：同视口基线与结果的组合审阅图。

回归

• Go：go test ./...。
• Web 定向：生产入口、API 客户端与接入页面 51 项测试通过。
• Web 全量：78 个测试文件、485 项测试通过。
• 构建：tsc -b、Vite production build、发布资产校验通过；接入页产物约 44.22 kB / gzip 13.94 kB。

无障碍边界

已验证对话框名称、步骤/候选列表语义、必选确认、禁用提交、状态回执、失效恢复和关闭后的焦点返回。当前自动化仍会报告 Semi UI 内部 findDOMNode 弃用警告；尚未完成 VoiceOver 人工通读、强制色彩模式和浏览器缩放 200% 的整轮人工验收，这些不作为本轮已完成能力声明。