PayrollManagementSystem/tasks/archive/2026-10-27-tplus-sync-todo.md

T+ 关联核验与同步管理任务清单

所有任务依照 tasks/plan.md。本轮已完成；真正 2008 R2 验收与客户业务确认保留为下一阶段门槛。

1. 真实枚举与关联核验

• 固化 SQL Server 2008 R2 语法的只读核验查询，按单据类型区分销货、费用、期初应收和收入。
• 对收款行 → 销货单/明细 → 订单进行覆盖、悬空和歧义计数，不按名称/金额拼接。
• 真实副本执行并生成映射 v0.3、客户确认单；仅记录系统字典和汇总。
• 验证：源查询实跑，报告无凭据或客户个人信息。依赖：无。预计 3–5 文件。

2. 批次元数据迁移

• 记录实体范围、跳过数量、幂等键、父批次、请求人和核验结果，旧批次可读。
• 同步 Alembic、V15、初始化脚本和模型；空库迁移及旧库升级通过。
• 验证：模型与 DDL 测试、隔离库迁移。依赖：无。预计 5 文件。

3. 队列、串行执行与重试

• READ/AUDIT 任务持久化排队；同键同意图复用，同键异意图拒绝。
• 共用命名锁防并发，worker 支持 once/watch，原 CLI 入口保持可用。
• 锁定父批次防重复重试；中断记录仅在无执行者时恢复，异常不泄漏源参数。
• 验证：先失败测试再实现；真实隔离 MySQL 并发与 worker 定点核验。依赖：1、2。分服务/CLI 两批实施。

检查点 A

• 核验、迁移与执行服务定点通过；工资业务表写入仍关闭。

4. 管理查询与接口

• 分页查询批次、详情和异常，列表不加载核验 JSON/原始 payload。
• 管理员接口与创建/重试审计完成，参数校验和源配置关闭行为明确。
• 汇总能区分暂存完成与 2008 R2/业务口径待确认。
• 验证：隔离 API 测试覆盖 401/403/400/404、分页、幂等和重试。依赖：3。分查询层、API 两批实施。

5. 同步管理页面

• 管理员菜单、概况、批次表、异常详情和关联结果接入实际 API。
• 创建读取/核验、失败重试、刷新与筛选可用；状态均为业务中文。
• 空态、加载、异常、配置关闭、权限与小屏布局可验证。
• 验证：Vue 类型检查、生产构建、真实浏览器。依赖：4。分 API/路由、页面两批实施。

检查点 B

• “排队 → 执行 → 查看 → 重试”完整流程有实际运行证据。

6. 完整验证与文档

• 真实副本关联核验与人员重读通过，重复快照不新增；非管理员被拒绝。
• 定点及必要回归、迁移、Ruff、类型检查、构建和浏览器检查通过。
• 模块 README、字段确认材料、AI_CONTEXT、PROJECT_PROGRESS 和本清单更新。
• 完成逐项验收；未完成的 2008 R2 环境和业务确认明确列为交付前置，不计入本轮已完成项。
• 依赖：1–5。

验收证据（2026-10-27）

• 单元 602 项，管理/并发/结构定点 18 项，Ruff、类型检查、构建通过；完整回归中的环境覆盖影响已独立复验。
• D 盘 reports/management_verification_2026-10-27.json：人员去重、关联检查、六类业务表行数不变。
• ai-aux/preview/tplus/verification.json：浏览器真实流程与四档宽度；模拟状态另见 state-verification.json。
• V15 隔离库回滚/升级通过；head=e5f607a8b9c0。运行步骤、映射和客户确认材料均已更新。