# 可研对照差距清单（V3-8.12 · 补齐后复核）

> 对照《可行性研究报告 V3-8.12》§5.1。  
> **排除**：5.1.10.1 权限管理、5.1.10.3 用户管理。  
> **判定规则**：仅当 UI+API 均能对上原文才标 DONE；外部桩边界单独注明。  
> **复核日期**：2026-08-12（高优先级 8 项补齐后）。

## 汇总

| 状态 | 约计数（不含 SKIP） | 说明 |
|------|---------------------|------|
| DONE | ~86 | 本轮补齐高优先级缺口后主功能已对齐 |
| PARTIAL | ~24 | 催办/站内通知/工单化告警等仍弱 |
| MISSING | ~0（高优先级） | 原 8 项高优先级已闭合 |
| SKIP | 8 条 | 10.1 / 10.3 |

## 本轮已闭合（原高优先级）

| # | 条款 | 落实要点 | 验证 |
|---|------|----------|------|
| 1 | **5.1.1.2** 待办 | 各角色工作台统一待办面板；点击跳转；`markWorkbenchTodoRead` | API：todos + read；前端 Dashboard |
| 2 | **5.1.9.2/.3** 专题/报表 | ReportsView 接线 topics；导出 CSV；打印本页 | `_smoke_gap_fix.py` topics/export |
| 3 | **5.1.6.4-4** 退款统计 | 特殊业务「多发退款」页展示 `refund-stats` 卡片 | API + SpecialBusinessView |
| 4 | **5.1.4.1** 居保任务 | 匹配后展示成功/失败/待确认；失败原因表；`/task-logs` | InsuranceMatchView + API |
| 5 | **5.1.5.1-2** 增减标注 | NEW/KEEP + REMOVE（上月有本月无，首页附带） | 明细页「减少」标签 |
| 6 | **5.1.8.1-4** 校验规则 | `idCardValidate` 消费于：新增/改证号、居保匹配、出盘校验 | validate-rules + 业务流 |
| 7 | **5.1.9.4** 区级看板 | `/reports/yoy` 含环比/同比/季/年；报表页区级展示 | yoy keys 冒烟 |
| 8 | **5.1.10.2-1** 登录日志 | 后端补 IP（X-Forwarded-For）；支持登出审计；关页 pagehide 上报 | login_ip_logout 冒烟 |

## 仍为 PARTIAL（非阻断，可后续迭代）

- 审批催办站内通知（超时告警有，主动催办 UI 弱）
- 出盘前完整预览（已有二次校验，预览交互可加强）
- 告警工单模型（站内告警列表有，非完整工单流转）
- 短信/政务消息、真人社居保、财政 N7C 实联 → **外部桩**

## 外部依赖桩（明确不做实联调）

- 真人社居保接口 → 规则模拟  
- 财政私有 N7C → 文本桩 + CSV 回盘  
- 短信/政务消息推送 → 仅站内告警  

## 验证脚本

- `_smoke_812.py`：字典/角色/继承人门禁/进度/校验规则  
- `_smoke_gap_fix.py`：本轮缺口 API 全量冒烟  

## 并发策略（落地摘要）

- **人员编辑**：前端带回 `updateTimeMs` → `expectedUpdateTime`；后端比对 `update_time`，冲突返回业务码 **409**（「数据已被他人修改」）。
- **短互斥**：领导批审批、特殊业务审批、单人资格审批使用 JVM 内 `ConcurrentBizLock`；拿不到锁同样 **409**。多实例部署时仍依赖乐观锁，不能单靠本地锁。
- **前端**：统一拦截里对 4xx（含 409）用警告提示，无需页面单独分支。

## 说明

此前矩阵存在「后端有 / 前端未接线仍算 DONE」。以本文件为准；高优先级 8 项已在前后端同时闭合并冒烟通过。