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

53 lines
3.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# T+ 关联核验与同步管理任务清单
所有任务依照 `tasks/plan.md`。本轮已完成;真正 2008 R2 验收与客户业务确认保留为下一阶段门槛。
## 1. 真实枚举与关联核验
- [x] 固化 SQL Server 2008 R2 语法的只读核验查询,按单据类型区分销货、费用、期初应收和收入。
- [x] 对收款行 → 销货单/明细 → 订单进行覆盖、悬空和歧义计数,不按名称/金额拼接。
- [x] 真实副本执行并生成映射 v0.3、客户确认单;仅记录系统字典和汇总。
- 验证:源查询实跑,报告无凭据或客户个人信息。依赖:无。预计 3–5 文件。
## 2. 批次元数据迁移
- [x] 记录实体范围、跳过数量、幂等键、父批次、请求人和核验结果,旧批次可读。
- [x] 同步 Alembic、V15、初始化脚本和模型;空库迁移及旧库升级通过。
- 验证:模型与 DDL 测试、隔离库迁移。依赖:无。预计 5 文件。
## 3. 队列、串行执行与重试
- [x] READ/AUDIT 任务持久化排队;同键同意图复用,同键异意图拒绝。
- [x] 共用命名锁防并发,worker 支持 once/watch,原 CLI 入口保持可用。
- [x] 锁定父批次防重复重试;中断记录仅在无执行者时恢复,异常不泄漏源参数。
- 验证:先失败测试再实现;真实隔离 MySQL 并发与 worker 定点核验。依赖:1、2。分服务/CLI 两批实施。
## 检查点 A
- [x] 核验、迁移与执行服务定点通过;工资业务表写入仍关闭。
## 4. 管理查询与接口
- [x] 分页查询批次、详情和异常,列表不加载核验 JSON/原始 payload。
- [x] 管理员接口与创建/重试审计完成,参数校验和源配置关闭行为明确。
- [x] 汇总能区分暂存完成与 2008 R2/业务口径待确认。
- 验证:隔离 API 测试覆盖 401/403/400/404、分页、幂等和重试。依赖:3。分查询层、API 两批实施。
## 5. 同步管理页面
- [x] 管理员菜单、概况、批次表、异常详情和关联结果接入实际 API。
- [x] 创建读取/核验、失败重试、刷新与筛选可用;状态均为业务中文。
- [x] 空态、加载、异常、配置关闭、权限与小屏布局可验证。
- 验证:Vue 类型检查、生产构建、真实浏览器。依赖:4。分 API/路由、页面两批实施。
## 检查点 B
- [x] “排队 → 执行 → 查看 → 重试”完整流程有实际运行证据。
## 6. 完整验证与文档
- [x] 真实副本关联核验与人员重读通过,重复快照不新增;非管理员被拒绝。
- [x] 定点及必要回归、迁移、Ruff、类型检查、构建和浏览器检查通过。
- [x] 模块 README、字段确认材料、AI_CONTEXT、PROJECT_PROGRESS 和本清单更新。
- [x] 完成逐项验收;未完成的 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。运行步骤、映射和客户确认材料均已更新。