PayrollManagementSystem/tasks/plan.md

# 下一阶段开发计划：T+ 数据导入与同版本验收

日期：2026-10-28。基于关联核验与同步管理轮次完成后的实际情况制定；上一轮计划与任务清单已归档至 `tasks/archive/2026-10-27-tplus-sync-*.md`。

## 当前实际状况

- 同步管理已完成：批次/异常/重试/锁/页面验收通过；staging 累计 933,203 行，六类工资业务表尚未接入写入。
- 口径进展：澄清清单 24 项答复基本到齐；对照表 v2 已裁决经理个人户（#7）、协助 25%（#6/#15）、信息员（#9）、企业户 3‰（#20）等冲突。9.8 方案中蓝色字体标注的原方案算法作废，毛利润率按不含运费口径执行。
- 仍未确认：含税取数、预收/保证金/代收、二次分配三项、三级角色职权，连同 T+ 口径 13 项与环境接入 5 项，已整理于 `docs/待确认事项清单_2026-10-28_v2.xlsx`（L1–L7）。
- 经理个人户：微信沟通确定按 9.8 方案执行、不计个人户部分，客户群确认中；系统参数已预留，确认后调整参数即可，无需开发。
- 环境差距：合法 Windows 与 SQL Server 2008 R2 安装介质未到位，D 盘虚拟机仅有外壳；当前分支约 65 个文件未提交。

## 目标与顺序

先收口工程，再并行推进同版本环境验收与客户口径确认；口径闭环后实施 staging 到工资业务表的导入，最后交付托管与部署。

### P0 工程收口（无外部依赖，立即执行）

1. 将本轮 T+ 同步管理成果按迁移、后端服务、前端页面、文档拆分为规范提交；合入前本地构建与测试通过。

### 轨道 A：同版本验收环境（外部依赖：安装介质）

- A1 先行细化 `docs/SQLServer2008R2测试环境.md`：装机步骤、恢复步骤，以及驱动、只读权限、六类查询、中文/日期/金额、断连超时、重复同步的验收清单。
- A2 取得合法介质后，在 `D:\work\app\tplus-vm` 完成系统与数据库安装。
- A3 恢复原始备份并执行完整验收，产出报告，关闭同版本兼容 PENDING 状态。

### 轨道 B：业务口径确认（外部依赖：客户填写）

- B1 发送 v2 清单：客户填「客户确认单-精简版」，IT/服务商填材料项；L1（含税取数）、L2（预收等）与确认单 #1/#3/#6 一并答复，避免重复提问。
- B2 跟进客户群对经理个人户的反馈，回填 L6。
- B3 答复回收后更新字段映射文档与暂定口径记录：二次分配三项（L3–L5）追认、三级角色职权（L7）在页面验收时核对。

### 轨道 C：T+ 数据导入开发（依赖轨道 B 闭环；设计可先行）

- C1 先行起草「staging → 业务表写入」设计：表映射、金额精度（金额用 Decimal、比例和日斜率用 Fraction）、幂等与重算授权留痕、人工字段保护（回款/发货批次由系统人工指定，业务归属变更不回溯历史）、事务边界；明确标注等待确认的差异点，口径闭环后评审定稿。
- C2 主数据导入（人员、客户、产品）：依赖 #9、#10、#11。
- C3 订单 → 发货 → 回款导入：依赖 #1–#8、#13（成本、日期、分摊、核销、初始化）。
- C4 负向事件处理（退货、红冲、负绩效）：依赖 #8；口径已定为负绩效照公式出数、不归零。
- C5 增量变更发现：依赖 #13；收付款表无 `updated` 字段，需验证 rowversion 与删除/作废的发现方式，在此之前时间水位保持禁用。

### 轨道 D：交付收尾（依赖 A3 与轨道 C 完成）

- D1 `tplus-worker` 服务托管（Windows 服务方案）。
- D2 每周同步任务编排与失败告警。
- D3 客户内网独立部署与最终验收。

## 验收与保留门槛

- 未确认项不进入正式核算；确认单未闭环前不实施业务表写入。
- 导入保护人工字段；每笔回款只核算一次；重算须授权并留痕。
- 2008 R2 验收未完成前，2022 恢复副本的结果不作为同版本兼容证据。
- 每个任务先完成定点测试再进入依赖任务；回归使用隔离的 MySQL/Redis。

## 项目后续路线

轨道 C 完成、A3 通过后进入轨道 D；部署验收通过即转入运维期（每周同步、参数调整走系统设置与版本管理）。