docs(项目): 更新需求文档与开发记录
- 收录 2026-11-02 需求补齐计划、验收记录与业务口径时间线 - 新增授权使用、监控运维与产品提取操作说明 - 归档 T+ 前置计划与待确认事项，清理过期临时文档 - README 同步当前进度与权限改造说明 影响范围：仅文档，无代码变更
This commit is contained in:
liuwenxin
parent
a2f9a58de5
commit
22605f4106
@ -137,10 +137,17 @@ python e2e/system_management.py # 系统管理 13 项
|
|||||||
|
|
||||||
## 正式工资闭环
|
## 正式工资闭环
|
||||||
|
|
||||||
- 在现有账号中明确绑定工资制作人：`PAYROLL_MAKER_USER_ID`。未配置时业务只读，不按管理员或岗位自动放行。真实账号绑定需由维护者核实，不在源码或示例中写入实际用户编号。
|
- 在“角色管理”配置工资操作权限，在“用户管理”分配角色；账号自动继承权限，无需单独绑定工资制作人。每次实际经办人继续留痕。
|
||||||
- 应用新增迁移后，T+ 页面提供正式业务导入预览／执行；业务列表“正式核算”准备人工业务资料或核算已导入资料，台账可查看逐段依据。
|
- 应用新增迁移后，T+ 页面提供正式业务导入预览／执行；业务列表“正式核算”准备人工业务资料或核算已导入资料，台账可查看逐段依据。
|
||||||
- “生成月结快照”首次成功即锁定该月分配；审批退回、重新生成不解锁。历史已生成工资保留，差额计调整单生成当月。
|
- “生成月结快照”首次成功即锁定该月分配；审批退回、重新生成不解锁。历史已生成工资保留，差额计调整单生成当月。
|
||||||
- 后端接口说明、验证状态和已知边界见 `docs/正式工资闭环开发记录_2026-10-30.md`。旧引擎仅通过 `PAYROLL_ALLOW_LEGACY_CALCULATION` 显式启用作历史兼容，默认关闭，不用于最新规则验收。
|
- 后端接口说明、验证状态和已知边界见 `docs/正式工资闭环开发记录_2026-10-30.md`。旧引擎仅通过 `PAYROLL_ALLOW_LEGACY_CALCULATION` 显式启用作历史兼容，默认关闭，不用于最新规则验收。
|
||||||
- 集成回归使用 `scripts/run_isolated_tests.py`；原 `.venv` 不可用时，本机使用 `backend/.venv-workbench/Scripts/python.exe`。测试运行器保留隔离库供复查，不删除原开发数据。
|
- 集成回归使用 `scripts/run_isolated_tests.py`；原 `.venv` 不可用时，本机使用 `backend/.venv-workbench/Scripts/python.exe`。测试运行器保留隔离库供复查，不删除原开发数据。
|
||||||
|
|
||||||
审核默认关闭：`PAYROLL_APPROVAL_ENABLED=false`，工资生成直接完成且不产生审批痕迹；如确需系统内复核，显式开启后沿用财务／领导审核和各类审批参数。此配置与旧核算引擎兼容开关独立。
|
审核默认关闭：`PAYROLL_APPROVAL_ENABLED=false`，工资生成直接完成且不产生审批痕迹；如确需系统内复核，显式开启后沿用财务／领导审核和各类审批参数。此配置与旧核算引擎兼容开关独立。
|
||||||
|
|
||||||
|
## 权限管理
|
||||||
|
|
||||||
|
- “用户管理 → 分配角色”：选择角色并预览继承权限，支持多个角色叠加。
|
||||||
|
- “角色管理 → 配置权限”：按模块配置模板；停用角色即时撤销其授权。
|
||||||
|
- 管理员拥有全部功能权限；月份锁定、审核节点及源读取开关继续独立检查。
|
||||||
|
- 授权变更无需重新登录，后端逐请求校验；详情、只读提示、菜单与按钮使用统一规则。操作与接口说明见 [权限管理使用与开发记录](docs/权限管理使用与开发记录_2026-11-02.md)。
|
||||||
|
|||||||
@ -1,68 +0,0 @@
|
|||||||
# SQL Server 2008 R2 测试环境与验收手册
|
|
||||||
|
|
||||||
> 目标：在真实 Windows + SQL Server 2008 R2（10.50.x）环境中恢复客户原始备份，完成同版本兼容验收，关闭「2008 R2 状态 PENDING」。本手册在取得合法安装介质后即可照做；介质到位前的准备工作只做第 2、3 节中不依赖介质的部分。
|
|
||||||
|
|
||||||
## 1. 背景与当前状态（2026-10-28）
|
|
||||||
|
|
||||||
- 客户源备份 `ceshi20261026.bak` 版本为 10.50.1600。按用户 2026-10-28 决定，先以该版本搭建开发验收环境；生产完整版本号后补，有差异时再核验（客户版 E01/E03）。
|
|
||||||
- 本地 Docker 已用 SQL Server 2022 副本完成恢复 PoC：完整 CHECKDB 通过、只读账号可用、六类查询两轮核验 933,203 行无失败。该副本只用于结构核验与开发，**不能替代同版本验收**。
|
|
||||||
- Hyper-V 虚拟机外壳已建于 `D:\work\app\tplus-vm`，处于关机、断网状态；Windows 与 SQL Server 2008 R2 安装介质尚未到位（客户版 E03）。
|
|
||||||
|
|
||||||
## 2. 环境约定
|
|
||||||
|
|
||||||
| 项目 | 约定 |
|
|
||||||
| --- | --- |
|
|
||||||
| 虚拟机目录 | `D:\work\app\tplus-vm` |
|
|
||||||
| SQL Server 数据与日志 | 2022 PoC 使用 `D:\work\app\tplus-sqlserver\data` 和 `log`；2008 R2 使用 D 盘虚拟磁盘内的来宾目录，恢复时确认实际路径 |
|
|
||||||
| 备份文件 | 现有脚本使用 `D:\work\app\tplus-sqlserver\backup`；复制到虚拟机前后核对 SHA-256 |
|
|
||||||
| 虚拟机网络 | 安装与验收期间保持仅主机或内网隔离，不接入公网 |
|
|
||||||
| 凭据 | 只读账号凭据走双方认可的私密渠道交接；不写入本文档、代码或 Git |
|
|
||||||
| 项目依赖脚本 | `scripts/tplus/`（工作区准备、备份检查、恢复、只读账号、结构盘点） |
|
|
||||||
|
|
||||||
客户版 E01 先使用本地恢复实例的连接信息和专用只读账号，E02 先用现有开发主机与网络，生产信息后补。E03 的目标版本已确定，但合法介质尚未到位，不能据此把安装或验收标为完成。
|
|
||||||
|
|
||||||
## 3. 装机步骤（依赖介质，介质到位后执行）
|
|
||||||
|
|
||||||
1. 通过 Hyper-V 管理器核对已有虚拟机与 D 盘磁盘位置，保持网络隔离。`prepare_sql2008r2_vm.ps1` 是创建脚本，已有同名虚拟机时拒绝覆盖，不用于状态检查。
|
|
||||||
2. 准备适配 SQL Server 2008 R2 的合法 Windows 介质，安装来宾系统。记录系统版本及补丁，不把来宾系统版本当作未来工资部署主机的要求。
|
|
||||||
3. 安装 SQL Server 2008 R2，基准锁定为 `10.50.1600`。排序规则从备份元数据或恢复库核验，不能凭文档默认值猜测。
|
|
||||||
4. 首轮保留该基准；如后续需要测试 SP3 等其他补丁，另记版本和结果，不覆盖基准验收记录。
|
|
||||||
5. 在运行后端/worker 的电脑上准备 ODBC 驱动。驱动、Windows 和 TLS 的实际组合须实测后记录，不能只根据驱动名称认定兼容。默认启用加密，隔离环境的显式回退步骤见本地开发手册。
|
|
||||||
|
|
||||||
## 4. 备份恢复步骤
|
|
||||||
|
|
||||||
现有备份检查、恢复、创建只读账号及盘点脚本调用 Docker 容器，使用容器内路径，仅适用于 2022 PoC。2008 R2 在虚拟机中按以下步骤操作，不直接套用容器脚本。
|
|
||||||
|
|
||||||
1. 在来宾系统中复制原始备份，核对文件哈希；由测试环境管理员通过数据库管理工具执行备份验证并读取文件列表，记录实际数据/日志逻辑名。
|
|
||||||
2. 恢复到新的测试数据库，在恢复界面为每个逻辑文件指定来宾磁盘路径；确认目标库不存在，不覆盖其他数据库。
|
|
||||||
3. 恢复后执行完整数据库一致性检查并留档；记录版本、排序规则和恢复数据库名。
|
|
||||||
4. 创建仅用于该测试库的登录和用户，授予读取权限，核对角色、显式授权和禁止写入的结果。恢复/建账号使用管理员，应用始终使用专用只读账号。
|
|
||||||
5. 对照 `db/queries/tplus/` 的九类实体查询和关联核验查询盘点结构、行数及汇总金额；保留差异原因。报告不包含凭据或个人明细。
|
|
||||||
|
|
||||||
## 5. 同版本验收清单（逐项通过后关闭 PENDING）
|
|
||||||
|
|
||||||
| # | 验收项 | 通过标准 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 1 | 版本确认 | `SERVERPROPERTY('ProductVersion')` 为 10.50.1600（末尾 .0 等价）；其他 10.50 补丁版本单独记录，不能冒充基准通过 |
|
|
||||||
| 2 | 驱动连接 | 从实际运行后端的电脑连接成功，记录驱动名称、版本与加密/证书设置 |
|
|
||||||
| 3 | 只读权限 | 用只读账号执行六类查询成功；执行任何写操作被拒绝 |
|
|
||||||
| 4 | 六类查询 | 人员、客户、产品、订单、发货、收付款九个白名单 SQL 全部返回，行数与 Docker 副本一致 |
|
|
||||||
| 5 | 中文数据 | 姓名、客户名、产品名等中文字段读取无乱码（只读账号仅验证读取） |
|
|
||||||
| 6 | 日期字段 | 凭证日期、审核日期、到账日期等候选字段格式与空值表现正常 |
|
|
||||||
| 7 | 金额精度 | 金额字段以 Decimal 读取，小数位与源数据一致 |
|
|
||||||
| 8 | 断连超时 | 仅在隔离测试实例模拟断连；批次不得误报成功，批次失败或行级错误可追溯，恢复后可重试 |
|
|
||||||
| 9 | 重复同步 | 同一备份重复 staging，相同行哈希全部去重跳过，行数不变 |
|
|
||||||
| 10 | 关联核验 | `relationship_audit` 数量统计与 Docker 副本结果一致 |
|
|
||||||
|
|
||||||
## 6. 产出与归档
|
|
||||||
|
|
||||||
- 验收通过后产出报告（含上表逐项结果与 `@@VERSION` 输出），归档至 `.ai/archive/ai-aux/`；项目文档更新结论为「2008 R2 验收通过」。
|
|
||||||
- 同步更新 `.ai/AI_CONTEXT.md` 与 `.ai/PROJECT_PROGRESS.md`。
|
|
||||||
- `check_compatibility.py` 默认核对 10.50.1600，复用应用连接策略；它的脚本检查通过不能替代本表中的断连、重复同步及完整权限验收。
|
|
||||||
- 验收中发现的字段差异回到 `docs/客户待确认事项表_2026-10-28_客户版.xlsx` 对应编号，不直接改代码。
|
|
||||||
|
|
||||||
## 7. 明确边界
|
|
||||||
|
|
||||||
- 本环境仅验收 T+ 源库只读访问；工资系统生产部署（客户版 E02）另行确认。
|
|
||||||
- 客户生产 T+ 原库不升级、不改动；2022 副本不回迁。
|
|
||||||
- 时间增量（确认单 #13）不在本手册范围内，待 rowversion 验证方案另行评审。
|
|
||||||
@ -1,40 +0,0 @@
|
|||||||
# T+ 交付部署设计（2026-10-28）
|
|
||||||
|
|
||||||
状态：设计稿。本文约定后续 D1/D2 的实现方向；本轮没有安装服务、创建计划任务或发送告警。
|
|
||||||
|
|
||||||
## 托管方案
|
|
||||||
|
|
||||||
| 方案 | 适用方式 | 本项目取舍 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| Windows 任务计划程序 | 启动时运行现有 worker，设置失败重启和禁止重复实例 | 首期推荐；复用现有 CLI，不增加第三方服务包装依赖 |
|
|
||||||
| NSSM | 将长驻进程包装为 Windows 服务 | 如客户要求服务管理器统一管理，再评审安装来源与版本；本轮不引入 |
|
|
||||||
| 原生 Windows 服务包装 | 开发服务生命周期、停止信号和恢复逻辑 | 当前缺少此实现，首期维护成本较高，暂不选用 |
|
|
||||||
|
|
||||||
开发环境先围绕备份源 `10.50.1600` 验证连接；工资后端继续使用现有开发主机与 Python 环境。数据库来宾 Windows 的版本不能用来推断工资部署主机的版本。生产主机、服务账号与目录由 客户版 E02 回填后确定。
|
|
||||||
|
|
||||||
后续托管任务采用启动触发，工作目录指向部署包 `backend/`，直接运行部署虚拟环境中的 `python.exe -m app.cli tplus-worker --watch`。不要在托管任务启动时执行依赖升级。账号仅授予所需目录、日志和私有配置访问权限；凭据不作为任务命令行参数。
|
|
||||||
|
|
||||||
建议恢复参数：进程异常退出后间隔 1 分钟重启，最多 3 次；同一任务已有实例时忽略重复启动；持续运行的 worker 不设通用执行时长上限。三次失败后转人工处理。以上是设计默认值，未写入客户环境。
|
|
||||||
|
|
||||||
## 每周排队与重试
|
|
||||||
|
|
||||||
拟新增单独的排队命令，调用现有 `task_service.create_task`。每周一 02:00（Asia/Shanghai）排队一次全量暂存，时间待业务方确认；尚未验收的时间增量保持关闭。worker 仍只消费队列，两者职责分开。
|
|
||||||
|
|
||||||
排队命令按“源账套 + ISO 周 + 任务类型”生成稳定 UUID 请求键，重复触发复用同一任务；排队时若同账套有活动任务，先记录本周待补状态，结束后再补排，避免队列堆积。停机后补跑一次，不逐周补发过期任务。
|
|
||||||
|
|
||||||
业务任务失败与进程退出分别处理。暂定仅对可确认的断连、连接超时重试，间隔 5 分钟、15 分钟，最多 2 次；每次调用现有重试接口，保留父批次。配置错误、版本不符、字段缺失、类型未确认及 PARTIAL 转人工处理。当前错误码可能合并为 `EXECUTION_ERROR`，D2 实现时先补可测试的错误分类，不能据此宽泛自动重试。
|
|
||||||
|
|
||||||
## 告警与观察
|
|
||||||
|
|
||||||
管理员同步页面与脱敏日志作为首期查看入口。拟对 FAILED/PARTIAL、连续 3 次进程重启失败、QUEUED 超过 15 分钟以及超过 8 天没有成功同步提示异常。运行时长阈值需在同版本首轮全量耗时实测后确定。
|
|
||||||
|
|
||||||
外部邮件或企业消息通道、接收人、网络出口待 客户版 E02 与客户答复，当前不配置也不发送。通知内容限批次号、状态、时间、错误码和处理入口，不包含凭据、手机号或原始 JSON。相同根批次和错误码 30 分钟内合并通知，恢复成功发一次恢复通知；投递失败保留记录，不改变同步批次结果。
|
|
||||||
|
|
||||||
## 实施与验收顺序
|
|
||||||
|
|
||||||
1. 先完成备份源同版本 A3；确认业务规则并完成 C2–C5 后，再启用正式托管和自动排队。开发阶段可用隔离数据库模拟调度行为。
|
|
||||||
2. D1 验证重启后启动、异常退出恢复、重复触发单实例、受限账号读配置、停止后不领取新任务、升级与回退均能重新取得锁。
|
|
||||||
3. D2 验证重复周任务、停机补跑、断连重试次数、PARTIAL 人工处理、通知去重与投递失败。不得用模拟成功代替真实同版本验收。
|
|
||||||
4. 发布时先手动单批运行并对账，再启用周任务。异常时停用排队与 worker，保留批次和原始数据，回退应用版本；不清空业务数据。
|
|
||||||
|
|
||||||
待填内容：客户版 E01 的生产连接、账号和版本差异，E02 的部署主机、网络、同步时段和通知方式，E03 的同版本介质，E04 的工资验收例单，以及 S1 的生产敏感字段策略。没有这些答复时继续文档与隔离开发验证，不虚构生产配置。
|
|
||||||
57
docs/T+同步页面改造与验收_2026-11-02.md
Normal file
57
docs/T+同步页面改造与验收_2026-11-02.md
Normal file
@ -0,0 +1,57 @@
|
|||||||
|
# T+ 同步页面改造与验收
|
||||||
|
|
||||||
|
## 需求与范围
|
||||||
|
|
||||||
|
用户要求重新核对同步需求、在页面提供自动采集开关、重做功能布局与 UI，并显示自动更新的真实进度条。
|
||||||
|
|
||||||
|
原始依据：`问题与解决方案对照表_v2.xlsx` 第 10 项为每周同步并支持手动触发，第 27 项为日志和失败重试；开发计划的 T+ 同步模块要求按类别读取、去重、人工字段保护与异常可追溯。当前源为本地 Docker 恢复库，源库只读；采集不自动生成工资。
|
||||||
|
|
||||||
|
## 本次执行约定
|
||||||
|
|
||||||
|
- 自动采集开关按源连接身份保存到本系统 MySQL，复用 `tplus:collect` 权限及操作日志；维护进程每次检查都读取保存值，不靠前端记忆或改写服务器环境文件。首次未保存时沿用环境配置，保留当前已开启状态。
|
||||||
|
- 关闭开关阻止后续自动排队及自动重试，不中断已排队或正在执行的任务，不影响手动同步。开启后按现有每周一 02:00、停机只补最近周期与同周防重规则执行。
|
||||||
|
- 采集前统计所选类别的真实行数，逐页提交已处理数、当前类别和更新时间。统计失败或旧任务没有总量时，显示不确定进度及已处理条数；不生成假百分比，不将“全部读取完但有异常”显示为成功。
|
||||||
|
- 当前进度、任务记录及打开的详情会自动更新；后台更新保持内容可见，页面隐藏或离开后停止重复请求，失败时保留上次数据并提示。
|
||||||
|
- 保留同步记录、错误定位、失败重试、关联检查及资料导入能力。主页面按“当前同步、自动采集、同步记录”排序，资料与导入及关联核查分标签展示。
|
||||||
|
|
||||||
|
## 设计决定
|
||||||
|
|
||||||
|
采用 `design-taste-frontend` 的 framed-sheet 方向（seed 2069071769），保留项目字体、蓝色品牌及现有全局导航，只改本页。用平面白色分区和细边界组织内容，进度数据使用蓝色，异常使用语义色，不增装饰图表。
|
||||||
|
|
||||||
|
首屏回答“同步到哪里、是否还在运行、接下来能做什么”。进度是主信息，自动采集开关和排期是侧区，历史批次是可操作列表；手机端按同一阅读顺序单列排列。所有统计取真实接口，不放示例业务数。
|
||||||
|
|
||||||
|
## 验收条件
|
||||||
|
|
||||||
|
1. 有权限账号切换开关后，页面、独立维护进程及刷新后的结果一致；无权限写入返回 403，过期配置版本返回 409，失败不伪装保存成功。
|
||||||
|
2. 总量统计、逐页进度、完成、失败及未知总量都有可解释状态；真实条数、进度百分比和终态一致。
|
||||||
|
3. 同步页与详情自动更新，页面离开后清理定时器，后台刷新不反复覆盖整页加载遮罩。
|
||||||
|
4. 在隔离库验证迁移及接口，再在本地开发库应用新增配置表；保留当前全量采集，不清数据、不生成工资。
|
||||||
|
5. 后端相关测试、结构检查、前端类型和构建及真实浏览器开关／进度／权限／响应式验证通过。实施前不将这些条件记为已通过。
|
||||||
|
|
||||||
|
## 实施结果（2026-11-02）
|
||||||
|
|
||||||
|
已完成页面开关、真实进度、自动刷新、详情明细和三档响应式布局。自动开关保存到 `tplus_automation_configs`，按源身份生效；维护进程每次检查读取保存值。关闭开关只停止后续自动排队，活动任务继续；手动同步不受影响。
|
||||||
|
|
||||||
|
后端新增 `PUT /api/v1/system/tplus/automation`，使用 `tplus:collect` 权限、版本乐观锁和操作日志。批次接口输出受控 `progress` 元数据：总量、已处理、百分比、当前类别、更新时间和分项状态；旧批次或统计失败显示未知总量，不编造百分比。同步总量统计查询位于 `db/queries/tplus/progress/counts.sql`，只统计白名单源表。
|
||||||
|
|
||||||
|
前端首屏为当前同步进度和同步计划开关；下方“同步记录、资料与导入、关联检查”分区展示。页面运行中每 5 秒刷新，空闲每 30 秒刷新，切离页面停止轮询并清理定时器；后台更新保留已有数据和交互状态。任务详情同步自动刷新，完成后显示终态和分项结果。
|
||||||
|
|
||||||
|
## 验证结果
|
||||||
|
|
||||||
|
- 后端单元：916 项通过，包含自动设置、进度、同步、查询、权限冲突和模型表集合。
|
||||||
|
- 隔离库集成：25 项通过，覆盖控制台接口、既有管理接口、自动周期与迁移结构；V27 配置表完成降级／升级验证。
|
||||||
|
- Ruff、前端类型检查和 Vite 生产构建通过。
|
||||||
|
- 本地开发库仅应用 V27 独立建表 SQL；本地 Alembic head 仍受未应用 V26 授权迁移影响，未强行升级。
|
||||||
|
- 真实 Edge 页面验证通过：管理员切换开关后独立维护实时读取；关闭后不再排队、刷新保持；开启后可手动创建人员＋收付款单任务；真实总量 19,178，页面从 0% 自动推进到处理中数值；1440／768／390 无横向溢出；详情自动刷新；只读账号按钮禁用且接口 403；离开页面停止轮询。
|
||||||
|
- 浏览器设计检查无 FAIL；保留全局警告：角色标签对比度已调整、系统仍存在三种字族、表格边框偏重及两卡片高度差，后续视觉统一时处理。
|
||||||
|
|
||||||
|
## 证据与边界
|
||||||
|
|
||||||
|
证据在 `.ai/tplus-page-redesign-20261102/`，含浏览器结果、真实进度记录、隔离测试、本地配置表前后计数与源总量统计。本轮只读源库、只保存采集与展示层数据；未导入正式业务、未生成工资、未连接生产、未提交或推送。
|
||||||
|
|
||||||
|
|
||||||
|
## 2026-11-02 任务详情去重与分项口径更新\n
|
||||||
|
- 创建／重试后不再自动弹出详情，页面显示提交提示和“查看已提交任务”入口，保留当前标签页。
|
||||||
|
- 详情移除与主页面重复的大进度卡，改为任务来源、创建／开始／结束时间、汇总结果、分项读取明细、异常和关联检查报告。若详情任务不是主页面当前任务，会明确提示两者不同。
|
||||||
|
- 分项进度缺失时不再显示 0；接口返回空值并由界面显示“未记录”。真实分项进度仍按实际条数展示，正在执行任务详情每 5 秒更新，关闭后停止该详情轮询。
|
||||||
|
- 相关单元 66 项通过；Ruff、前端类型检查和构建通过。模拟接口浏览器 5 组场景通过，真实任务只读验证通过；截图与结果 `.ai/tplus-detail-browser/`、`.ai/tplus-detail-live/`。本轮只做展示层验证，未创建或重试真实采集任务，未操作生产或生成工资。
|
||||||
BIN
docs/T+对接待确认事项_2026-10-28(1).xlsx
Normal file
BIN
docs/T+对接待确认事项_2026-10-28(1).xlsx
Normal file
Binary file not shown.
@ -1,148 +0,0 @@
|
|||||||
# T+ 数据导入设计：staging → 工资业务表（2026-10-28）
|
|
||||||
|
|
||||||
> 状态：设计稿，未实现。客户确认单（`docs/客户待确认事项表_2026-10-28_客户版.xlsx`）业务口径答复齐全并完成设计评审后，再实现导入。「预留参数」在本稿中表示待确认决策，不代表已建系统设置项；字段映射、流程规则、部署配置须分别回填。
|
|
||||||
|
|
||||||
## 1. 目标与边界
|
|
||||||
|
|
||||||
- 将 `tplus_sync_records`（staging）中 PENDING 的原始行，按映射规则写入六类工资业务表：人员 `personnel`、客户 `customers`、产品 `products`、业务 `businesses`（含 `business_items`）、发货 `shipments`（含明细）、回款 `receipts`。
|
|
||||||
- 同步链路已具备：批次/错误/水位/锁/重试由现有 `tplus_sync_batches`、`tplus_sync_errors`、`tplus_sync_watermarks` 与 `tplus-worker` 承担；本设计只增加「应用器」环节，不改动现有读取链路。
|
|
||||||
- 不在范围内：工资核算、月结、审批（沿用既有模块）；时间增量（确认单 #13 闭环前水位保持禁用）。
|
|
||||||
|
|
||||||
## 2. 总体流程
|
|
||||||
|
|
||||||
```text
|
|
||||||
staging PENDING
|
|
||||||
→ 应用器按实体分批读取（entity_type + row_hash）
|
|
||||||
→ 字段映射 + 口径参数校验（含预留参数缺省值）
|
|
||||||
→ 幂等检查（锚点已存在则置 SKIPPED）
|
|
||||||
→ 写业务表（应用层关联，不建物理外键）
|
|
||||||
→ 成功置 APPLIED；失败置 ERROR 并写 tplus_sync_errors
|
|
||||||
```
|
|
||||||
|
|
||||||
- 每个实体一个应用器，导入顺序固定：人员 → 产品 → 客户 → 业务（含明细）→ 发货（含明细）→ 回款。上层实体失败时跳过下层并保留 PENDING，供重试。
|
|
||||||
- 新增「导入运行记录」需求：每个批次的每个实体记录读取数、写入数、跳过数、失败数（实现时以新表或复用批次审计字段承载，评审时定稿）。
|
|
||||||
|
|
||||||
## 3. 幂等与锚点
|
|
||||||
|
|
||||||
- staging 层唯一键 `uk_tplus_sync_records_entity_source_hash`（entity_type + source_id + row_hash）保证重复快照不重复入库。
|
|
||||||
- 业务表锚点：订单/发货/回款以 `source_no`（T+ 单据号）幂等；主数据以 `source_id` 幂等。锚点字段在实现时补唯一约束（如 `uk_receipts_source_no`）。
|
|
||||||
- 每笔回款只能核算一次：已存在核算记录的回款，重复导入直接跳过，不做金额合并。
|
|
||||||
|
|
||||||
## 4. 金额与精度
|
|
||||||
|
|
||||||
- 金额字段一律 `Decimal`；比例、日斜率一律 `Fraction`；全程禁用 float。
|
|
||||||
- 业务员计提沿用既定公式：`10‰ − 回款天数 × 4/360‰`，1–360 天线性递减，360 天 6‰，361 天及以上固定 4‰。
|
|
||||||
- 毛利润不含运费（9.8 方案蓝色字体原算法作废）；混合产品按明细行分别计算；负绩效照算不归零。
|
|
||||||
- 多单分批回款的分摊与尾差处理属预留参数（#5），未定前不实现分摊逻辑。
|
|
||||||
|
|
||||||
## 5. 人工字段保护（T+ 不覆盖）
|
|
||||||
|
|
||||||
| 字段 | 保护方式 |
|
|
||||||
| --- | --- |
|
|
||||||
| 人员岗位角色ID | T+ 同步不覆盖，只填新人员缺省角色 |
|
|
||||||
| 回款批次号 / 发货单号 | `HK…` / `SH…` 系统生成，同步行只记录 source_no 追溯 |
|
|
||||||
| 业务归属变更 | 只影响变更后的核算，不回溯历史 |
|
|
||||||
| 客户负责人、客户分类 | 由人工维护，同步不覆盖 |
|
|
||||||
| 产品计提分类、指导价 | 由人工维护（#11） |
|
|
||||||
| 回款/发货批次人工指定 | 系统提供人工指定入口，导入只建待指定数据 |
|
|
||||||
|
|
||||||
## 6. 事务与错误边界
|
|
||||||
|
|
||||||
- 应用器按「批次 × 实体 × 每 N 行」开事务；单行失败不回滚整批，错误行写 `tplus_sync_errors`（含 error_code 与说明）。
|
|
||||||
- 批次状态机沿用现有 QUEUED/RUNNING/SUCCEEDED/PARTIAL/FAILED；出现 ERROR 行时批次终态为 PARTIAL。
|
|
||||||
- 应用器与 worker 共用 MySQL 连接级锁，避免与读取任务并发写同一批次。
|
|
||||||
- 重算必须授权并留痕：已核算数据不允许静默覆盖，重算入口生成带请求人、时间、原因的审计记录（复用操作日志）。
|
|
||||||
|
|
||||||
## 7. 预留参数清单（等待客户答复）
|
|
||||||
|
|
||||||
本节保留旧编号供开发追溯。当前对外文件为《客户待确认事项表_2026-10-28_客户版.xlsx》，旧表已按用户决定删除；回填时按第 10 节对应关系查找，不重复询问已经确定的规则。
|
|
||||||
|
|
||||||
| 编号 | 预留参数 | 等待内容 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| #1 | 成本取值 | 订单 LatestCost 与销货 costPrice/costAmount 的取舍（含税 L1 一并确认） |
|
|
||||||
| #2 | 发货日期口径 | 凭证/发送/交货/审核日的取舍与缺失处理 |
|
|
||||||
| #3 | 到账日期口径 | 主表时间与明细 arrivalDate 的认定，预收与分次到账 |
|
|
||||||
| #4 | 无订单回款 | 补录、人工指定或不纳入 |
|
|
||||||
| #5 | 多单分摊规则 | 分摊方式与尾差对账 |
|
|
||||||
| #6 | 可计提收款范围 | 期初/预收/退款/费用单的排除与承接 |
|
|
||||||
| #7 | 有效性与核销条件 | 生效即可计提还是须核销 |
|
|
||||||
| #8 | 负向事件 | 退货/红冲的冲减月份与重复冲减防护 |
|
|
||||||
| #9 | 人员口径 | 工号确认、取数范围、经理归属（L6 经理个人户只调参数） |
|
|
||||||
| #10 | 客户口径 | 往来单位筛选、改名合并 |
|
|
||||||
| #11 | 产品口径 | 单位换算、价格类型、计提分类维护方 |
|
|
||||||
| #12 | 收款方式 | 结算方式枚举与以物抵顶差异 |
|
|
||||||
| #13 | 初始化与增量 | 起始日期、历史已结算款识别、rowversion 验证 |
|
|
||||||
| L2 | 特殊款项 | 预收、保证金、代收，与 #3/#6 一并确认 |
|
|
||||||
| L3–L5 | 二次分配三项 | 追认后回填分配标的、余额归属、协助关系 |
|
|
||||||
| L7 | 三级角色职权 | 页面验收时核对 |
|
|
||||||
| B1–B5 | 环境接入与介质 | 先用本地备份恢复环境，版本基准 10.50.1600；生产信息后补，介质仍需落实，凭据不入文档和 Git |
|
|
||||||
| S1 | 敏感字段策略 | 当前开发阶段暂接受未单独加密的风险；生产保留、保护和备份范围仍待确认 |
|
|
||||||
|
|
||||||
## 8. 字段核验备注
|
|
||||||
|
|
||||||
2026-10-28 用 T+12.3 数据字典（rar）交叉验证了 11 张目标表的关键字段：字典中文名与待确认清单的表述一致，与恢复库实测没有冲突。有两点差异，实现时需要注意：
|
|
||||||
|
|
||||||
- `SA_SaleDelivery.SendDate`（送货日期）是 T+12.3 新增字段。客户生产库版本未确认（B3），应用器读取映射字段前应先检查列是否存在，缺列时写入 `tplus_sync_errors`，不要让批次直接中断。
|
|
||||||
- `ARAP_ReceivePayment_b.arrivalDate` 在字典中是「到期日」，不是实际到账日。到账日期口径（#3）确认前，该字段只作候选留档，不参与回款天数计算。
|
|
||||||
|
|
||||||
字段描述出现文档间分歧时（如存货表 `InvSCost` 仅见于 12.1 说明文档），以恢复库实测为准。
|
|
||||||
|
|
||||||
## 9. 实现触发条件
|
|
||||||
|
|
||||||
1. 当前客户版的业务答复足以确定导入规则，并完成对应设计评审（检查点 A）；生产地址等资料可在正式联调前补齐。
|
|
||||||
2. 本设计按答复修订并评审定稿。
|
|
||||||
3. 先实现主数据导入并通过可回滚验收（检查点 B），再进入交易数据与负向事件。
|
|
||||||
|
|
||||||
开发设计与隔离测试不等待生产地址/账号。备份源同版本环境仍须实际安装和验收；正式上线须补齐生产环境信息并完成 S1 决策。
|
|
||||||
|
|
||||||
## 10. 口径答复回填清单
|
|
||||||
|
|
||||||
所有答复先写入当前客户版 F 列，记录答复人、日期、例单或来源，再修订本稿。技术字段存在只能证明可取数，不能代替业务方选择计提口径。旧表问题已归并为下表编号，旧编号仅供内部追溯。
|
|
||||||
|
|
||||||
| 原编号 | 当前客户版编号 |
|
|
||||||
| --- | --- |
|
|
||||||
| #1、L1 | B02 成本取法、B01 含税口径 |
|
|
||||||
| #2、#3 | T01 发货日、T02 到账日 |
|
|
||||||
| #4、#5 | T03 回款归属与跨单分摊 |
|
|
||||||
| #6、L2 | B08 特殊款项 |
|
|
||||||
| #7、#8、#12 | T04 状态、T05 负向事件、T06 抵顶方式 |
|
|
||||||
| #9、#10、#11 | T07 人员、T08 客户、T09 产品 |
|
|
||||||
| #13 | B07 启用与历史承接；增量发现属于开发设计 |
|
|
||||||
| L3–L5 | B03 分配规则；修改窗口另见 B04 |
|
|
||||||
| L6、L7 | B05 经理本人业务、B06 岗位权限 |
|
|
||||||
| B1/M1、B2/M2、B3/M3 | E01 生产连接，E03 备份源版本验收 |
|
|
||||||
| B4/M4、B5/M5 | E02 部署与同步，E03 同版本介质 |
|
|
||||||
| S1 | S1 敏感字段策略 |
|
|
||||||
|
|
||||||
客户版 E04 另列实际工资结果核对：先单笔、再个人与部门月结，复用已提供例单并逐笔解释差异。它是正式交付验收项，不能由技术测试代替。
|
|
||||||
|
|
||||||
| 编号 | 设计回填位置与核验重点 | 定稿后的实现顺序 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| #1 / L1 | 销售额、成本字段，含税口径；用成本调整例单核对 | C3 明细映射与金额校验 |
|
|
||||||
| #2 | 发货日期及缺失处理，核对 SendDate 实际存在性 | C3 发货导入 |
|
|
||||||
| #3 / L2 | 到账日期与预收转正式回款；arrivalDate 字典为到期日，不默认作到账日 | C3 回款导入 |
|
|
||||||
| #4 | 无订单关联数据的人工补录或排除规则 | C3 关联异常处理 |
|
|
||||||
| #5 | 多单分摊、金额合计、尾差规则 | C3 分摊与对账 |
|
|
||||||
| #6 / L2 | 期初、保证金、代收和历史已核算款的纳入范围 | C3 回款过滤 |
|
|
||||||
| #7 | 生效、核销、作废的真实状态对应关系 | C3 有效性校验 |
|
|
||||||
| #8 | 原单追溯、冲减月份、已结算调整和防重复 | C4 负向事件 |
|
|
||||||
| #9 | 人员工号、范围、经理关系，保护人工岗位字段 | C2 人员导入 |
|
|
||||||
| #10 | 客户筛选、改名合并和源 ID 追溯 | C2 客户导入 |
|
|
||||||
| #11 | 单位换算、价格、指导价与计提分类维护方 | C2 产品导入 |
|
|
||||||
| #12 | 结算方式枚举与以物抵顶的核算差异 | C3 回款方式 |
|
|
||||||
| #13 | 初始化起点、历史核算识别、变更/作废/删除发现 | C5 增量方案，验证前不启用时间水位 |
|
|
||||||
| L3 | 二次分配标的与现有拆行实现的差异 | 校准已有分配逻辑并回归 |
|
|
||||||
| L4 | 不足 100% 的余额归属与留存方式 | 与 L3 一并校准 |
|
|
||||||
| L5 | 协助仅记录、不计提的追认 | 核对独立二次分配机制 |
|
|
||||||
| L6 | 经理个人户客户确认结果 | 核对生效日期后调整既有参数并复核例单 |
|
|
||||||
| L7 | 角色名称、人员和可操作项 | 权限配置及页面验收 |
|
|
||||||
| B1/M1、B2/M2 | 开发先用本地只读连接；生产地址和凭据单独交接 | 部署前配置及最小权限检查 |
|
|
||||||
| B3/M3 | 先按备份源 10.50.1600；生产完整版本后补 | A3 基准验收，再验证生产差异 |
|
|
||||||
| B4/M4 | 开发现有主机先行；生产系统和网络后补 | D1/D2 托管与告警配置 |
|
|
||||||
| B5/M5 | 合法介质来源、版本与可用性 | A2 安装后进入 A3 |
|
|
||||||
| S1 | 人员表、暂存表和备份的保护、访问、保留期 | 全库策略确认后另行实施，上线前验收 |
|
|
||||||
|
|
||||||
- [ ] 核对每项答复与原始附件，冲突仍标待确认，不填猜测默认值。
|
|
||||||
- [ ] 补齐源字段到目标字段、空值处理、人工字段保护和幂等映射，评审后定稿。
|
|
||||||
- [ ] 按 C2 → C3 → C4/C5 顺序实施，先定点测试与对账，再做隔离回归。
|
|
||||||
- [ ] 业务清单、设计、实现和验收结论同步更新；未答复项保留原编号。
|
|
||||||
@ -1,5 +1,37 @@
|
|||||||
# T+ 本地恢复与同步开发手册
|
# T+ 本地恢复与同步开发手册
|
||||||
|
|
||||||
|
## 2026-11-02 自动采集和开发托管（当前状态）
|
||||||
|
|
||||||
|
用户后续要求启用自动采集，本机 `backend/.env` 的 `T_PLUS_AUTOMATION_ENABLED` 已改为 `true`。每周一北京时间 02:00 为应用排队时点；每分钟执行的是 `tplus-maintain --once` 检查，不是每分钟全量采集。首次开启仅补最近一个已到期周期，同周防重，任务占用时延后。
|
||||||
|
|
||||||
|
Windows 本地开发任务目录为 `\PayrollManagementSystem-Dev\`，新增三项：
|
||||||
|
|
||||||
|
| 任务 | 执行内容 | 触发方式 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| `PayrollDev-backend` | 本机 8000 端口后端 | 当前用户登录，支持手动启动 |
|
||||||
|
| `PayrollDev-worker` | `tplus-worker --watch` | 当前用户登录，持续消费队列 |
|
||||||
|
| `PayrollDev-maintenance` | `tplus-maintain --once` | 当前用户登录及每分钟检查 |
|
||||||
|
|
||||||
|
三项复用现有 `scripts/windows/Run-PayrollHost.ps1`，当前用户 Interactive／Limited，隐藏运行、并发 IgnoreNew、失败间隔一分钟最多重启三次；运行目录 `.ai/tplus-dev-connection-20261102/task-runtime/`，日志按次保留。本机需开机且该用户登录；这不是客户生产的无人登录服务部署。未覆盖其他任务，也未保存账号密码到任务参数。
|
||||||
|
|
||||||
|
管理时可用 `Get-ScheduledTask -TaskPath '\PayrollManagementSystem-Dev\'` 和 `Get-ScheduledTaskInfo` 检查状态与上次结果。维护日志应见 CHECKED／DEFERRED／QUEUED 等结果。关闭自动排队时先停用维护任务并将本地开关关闭，当前采集应完成后再停 worker；不为重启而强停活动采集。删除开发任务需精确指定本目录中上述三项，不触碰客户正式任务。
|
||||||
|
|
||||||
|
本轮发现原全量批次 `TP20261102150914e2605f90` 曾推进至 306612 条，随后采集进程退出且心跳停止，页面仍保留 RUNNING。恢复 worker 后由现有恢复逻辑记为 FAILED／INTERRUPTED，保留全部证据；退出原因未从日志查明。无需删除批次或重置数据。
|
||||||
|
|
||||||
|
自动维护已创建 2026-W45 批次 `TP20261102154100c994af25`，按九类全量重新读取并哈希去重，目前仍在执行。重复维护未创建第二个任务，当前无需再手动重试原批次。真实接口和页面均显示自动采集已开启；最终全量成功必须待本批次结束后单独记录。
|
||||||
|
|
||||||
|
## 2026-11-02 开发连接当前状态
|
||||||
|
|
||||||
|
开发阶段使用现有 Docker 容器 `ys-tplus-sqlserver-dev` 中的备份恢复库，地址为本机回环地址、端口 1433。SQL Server 2022 副本用于开发；SQL Server 2008 R2 兼容性仍需另验。下方历史“源读取关闭”记录已由本节更新。
|
||||||
|
|
||||||
|
本机 `backend/.env` 已设置 `T_PLUS_ENABLED=true`，`T_PLUS_CONNECTION_FILE` 指向既有项目外专用只读连接 JSON。该文件由本机维护，账号、口令及客户生产信息不写入本手册或示例。`T_PLUS_AUTOMATION_ENABLED=false` 表示未开启自动周采集，不影响手动创建采集任务。
|
||||||
|
|
||||||
|
后端和独立采集 worker 必须读取同一份 MySQL 及 T+ 连接配置。在 `backend/` 目录使用已有虚拟环境启动后端，并运行 `python -m app.cli tplus-worker --watch` 消费队列。仅启动前端和 HTTP 后端时，任务不会自行执行；页面历史可读也不代表源连接已启用。修改 `.env` 后重启后端和 worker；使用热重载时应核实父子进程，避免停止父进程后遗留的旧服务继续占用 8000 端口。
|
||||||
|
|
||||||
|
本轮已修正本地配置并恢复两个后台进程。真实页面创建人员＋收付款单批次 `TP20261102150055cb461c73`，于 2026-11-02 15:01:53 成功完成：源 19,178 条、新增 0、重复跳过 19,178、失败 0。新建任务按钮可用，worker 心跳正常；截图及复核数据保存在 `.ai/tplus-dev-connection-20261102/`。
|
||||||
|
|
||||||
|
采集完成后数据保存在暂存／快照区。正式业务导入、台账核算和工资生成由各自入口执行；本轮没有自动导入或生成工资。专用源账号 INSERT、UPDATE、DELETE 及 sysadmin 权限均为 0，客户生产连接未启用。
|
||||||
|
|
||||||
日期：2026-10-28。当前程序把 T+ 原始数据写入 MySQL 暂存表，管理员可排队、查看结果和手动重试；工资业务表导入、自动周任务和告警投递尚未实现。
|
日期：2026-10-28。当前程序把 T+ 原始数据写入 MySQL 暂存表，管理员可排队、查看结果和手动重试；工资业务表导入、自动周任务和告警投递尚未实现。
|
||||||
|
|
||||||
## 环境与版本
|
## 环境与版本
|
||||||
@ -52,6 +84,14 @@ uv run python ../scripts/tplus/check_compatibility.py --connection-file "D:\work
|
|||||||
|
|
||||||
## 常见问题
|
## 常见问题
|
||||||
|
|
||||||
|
### 历史记录查看与页面版本（2026-11-02）
|
||||||
|
|
||||||
|
- 当前代码配套迁移版本为 V21（`21f2a3b4c5d6`）。旧开发库若报 `trigger_type` 或 `automatic_attempt` 不存在，应先备份并核对迁移版本，再在对应后端环境执行 `python -m alembic upgrade head`；重启服务不会自动升级数据库。
|
||||||
|
- `T_PLUS_ENABLED=false` 只关闭源读取和新采集任务，已有批次、工作区任务、补充资料、源编号和报告仍可查看，不必为查看历史开启源连接。
|
||||||
|
- 关闭源读取时，历史查询优先使用 `T_PLUS_DATABASE` 指定的账套；未指定时仅在本地历史来源唯一的情况下自动确定。若存在多个账套，必须明确指定查看范围，不会混合展示，也不会读取私有连接文件猜测来源。
|
||||||
|
- 本机开发库已于 2026-11-02 在全库备份后由 V17 升至 V21，迁移前后原有 42 张表数据量一致；源读取和自动采集仍关闭。客户目标环境须独立核验，不能据此认定已部署。
|
||||||
|
- 如迁移中断，保留备份及执行日志，先核实已执行的 DDL；不要对现有业务库运行初始化重置，也不要自动降级删除新增的业务依据。
|
||||||
|
|
||||||
| 现象 | 处理 |
|
| 现象 | 处理 |
|
||||||
| --- | --- |
|
| --- | --- |
|
||||||
| 页面显示未配置 | 核对开关、连接文件权限、只读账号与驱动；配置就绪不等于连通 |
|
| 页面显示未配置 | 核对开关、连接文件权限、只读账号与驱动；配置就绪不等于连通 |
|
||||||
|
|||||||
BIN
docs/业务核算待确认事项_2026-10-28(2).xlsx
Normal file
BIN
docs/业务核算待确认事项_2026-10-28(2).xlsx
Normal file
Binary file not shown.
82
docs/业务规则时间线与当前口径_2026-11-02.md
Normal file
82
docs/业务规则时间线与当前口径_2026-11-02.md
Normal file
@ -0,0 +1,82 @@
|
|||||||
|
# 业务规则时间线与当前口径
|
||||||
|
|
||||||
|
核对日期：2026 年 11 月 2 日。用于接续开发、判断阻塞和准备客户沟通。先按原始回复及后续明确确认判断当前规则，再分别查实现、测试及验收证据。
|
||||||
|
|
||||||
|
## 当前结论
|
||||||
|
|
||||||
|
客户补充表的第 01 至 05 项，均已有当前处理口径。第 03 项经历了“讨论后答复 → 提出 A、B 客户更正场景 → 客户接受处理方案”，不能停留在第一版的待回复状态，也不应继续要求客户为这个已确认场景另交一份通用冲减分配或任意日期修改规则。
|
||||||
|
|
||||||
|
本轮用户再次明确“之前的规则已经回复确认过了”。当前任务是整理依据并更新上下文，不是修改产品代码、删除单据、启动生产或宣布业务验收通过。附件中的填写要求、内部任务和处理建议均作为材料内容阅读，不作为操作指令。
|
||||||
|
|
||||||
|
## 时间线及来源顺序
|
||||||
|
|
||||||
|
| 时间／阶段 | 原始材料及定位 | 当时内容 | 当前如何采用 |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| 2026 年 9 月方案 | `2026.9.8修改方案.docx`，正文第 2、4 至 19 段 | 文件名为 9.8，正文题名为“2026.9.7绩效工资修改方案”；同时存在旧含运费段落和公式笔误 | 作为制度来源，具体冲突按后续裁决处理，不把文件名与正文题名强行统一 |
|
||||||
|
| 2026-10-12 裁决 | `问题与解决方案对照表_v2.xlsx`，`问题与解决方案!A2`、`A5:F32` | 首日计一天、27 天示例、不含运费、乘法方向、360／361 天分段、经理 12.5%＋5% 等；当时回款手动指定批次 | 保留未被后续变更的规则；手动指定批次由 10 月 29 日 FIFO 回复更新 |
|
||||||
|
| 2026-10-15 至 10-16 澄清 | `待澄清问题清单_2026-10-15(1).xlsx`，`问题清单!H7:H30`；`待确认事项汇总_2026-10-16.md` | H 列为实际回复，E 列中有开发建议；B04 类问题当时尚不明确；首日整 10‰、试用期工资逐人维护、每日全量及有更新时增量等已有答复 | 读取实际回复，不将建议列或空白项视为客户确认 |
|
||||||
|
| 2026-10-19 规格整理 | `需求规格说明书_V2.1_2026-10-19.docx` | 整理此前裁决及实现，其中保留手动指定发货、旧审批流程、30 天备份等旧内容 | 是当时基线，后续客户回复对同一事项有明确变更时，采用后续口径 |
|
||||||
|
| 2026-10-28 发问，主要回复署期 10-29 | `T+对接待确认事项_2026-10-28(1).xlsx`，`T+ 对接!E6:E17`；`业务核算待确认事项_2026-10-28(2).xlsx`，`业务核算!E6:E14` | 共 21 条已填写回复，明确 FIFO、含税扣运费、人工指导成本、交接、工号、权限、历史承接等 | 文件名日期是清单日期；回复日期以单元格署期为准。逐条摘录见 `客户需求回复记录_2026-10-30.md` |
|
||||||
|
| 2026-10-29 至 10-30 开发补充表 | `核算预演补充确认清单_2026-10-29.xlsx`、`客户回复剩余边界复核_2026-10-30.xlsx`、`客户补充确认与资料清单_2026-10-30.xlsx` | 开发方整理待核对边界和实际资料；多数回复栏为空 | 是提问、分析或资料清单，不是新的客户否定答复，不能覆盖已收到的规则 |
|
||||||
|
| 2026-10-30 B04 聊天补充 | `二次分配修改规则确认_2026-10-30.md` | 工资生成前可修改、生成后锁定；只有实际制作人可改；差额计调整单生成当月 | 已明确，替代业务表 E9 的“未理解”，不重复追问 |
|
||||||
|
| 2026-10-30 补充回执第一版 | `绩效核算业务确认单_2026-10-30(1).xlsx`，`客户补充确认!E7:E11` | 01 合并平账；02 发货月成本封存；03 讨论后答复；04 不涉及；05 审核文字有歧义 | 是中间状态；03 和 05 继续读取第二版及聊天，不单独用本版作当前结论 |
|
||||||
|
| 2026-10-30 补充回执第二版 | `绩效核算业务确认单_2026-10-30(2).xlsx`，`客户补充确认!E7:E11` | 01、02、04 保持；E9 提出正负更正单不计绩效及 B 回款转 A；E11 明确工资完成后只查看，不需要审批步骤或痕迹 | 当前书面场景依据；E9 仍是功能询问，后续客户接受方案才构成处理方式确认 |
|
||||||
|
| 归入 10-30 沟通链，星期五 16:38 → 16:53 | 本轮聊天截图 `codex-clipboard-f898768b-a557-4976-b0a4-e7b03ee98031.png` | 16:38 提出保留原单、正负更正单排除绩效、实际回款关联原业务并保留到账日、防重及当月调整；16:53 客户回复“可以可以，那太好了” | 该方案已接受。截图只显示星期五和时间，未显示年月日；10-30 是与既有归档关联的日期，不是截图直接证明的完整日期 |
|
||||||
|
| 10-30 后续审核确认 | `客户补充回执核对_2026-10-30.md` 中“第05项用户澄清及最新截图” | 先明确不需要实际审批步骤，后补充“保留”“默认不开启” | 保留审核能力但默认关闭；不是删除模块，也不是默认走原审批链 |
|
||||||
|
| 2026-11-02 本轮纠偏 | 用户再次提供第二版表格与三张截图 | 明确要求按时间理解已回复规则并记录上下文 | 撤回本次会话此前把“复杂更正规则待客户补充”当作当前阻塞的说法，转为已确认场景的内部落实与验证 |
|
||||||
|
|
||||||
|
以上顺序依赖材料内容、版本差异、回复署期和聊天先后。文件系统修改时间、Office 创建／修改元数据只作辅助线索；复制、另存和重新生成均可能改变它们。目录截图只能证明当时可见的文件，不能替代回复正文。
|
||||||
|
|
||||||
|
## 当前业务口径
|
||||||
|
|
||||||
|
| 业务环节 | 当前执行含义 | 直接依据 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| 日期 | 发货日取销货单单据日期，到账日取收款单单据日期；正常回款天数自发货日首日计一天。核算参数按到账日匹配版本 | T01／T02：`T+ 对接!E6:E7`；10-12 对照表第 1、11 项 |
|
||||||
|
| 核算起点 | 2026-03-01 起的新发货进入新方案；回款先冲 2026-02-28 之前的应收，旧部分沿原软件处理；余额才用于新发货，避免重复计提 | `业务核算!E12` |
|
||||||
|
| 8 月调整 | 企业户及经理调整沿用既有方案的 2026-08-13 生效日，不改为 8 月 1 日，不重新索要已给规则 | 9 月方案及 10-12 对照表第 5、6、20 项 |
|
||||||
|
| 平账范围 | 同一 T+ 发货客户名头下，不按合同数量拆分平账；回款先平前期欠款，再按先发货先平账。系统保留来源身份及逐次发货归属 | `T+ 对接!E8`；第二版 `客户补充确认!E7` |
|
||||||
|
| 收款资格 | 已生成凭证的收款单可参与绩效核算；凭证资格与人工核对、回款确认属于不同环节 | `T+ 对接!E9`；既有凭证字段核查记录 |
|
||||||
|
| 销售及成本 | 销售与指导成本均含税；销售额扣除运费。指导成本人工录入，保持 T+ 产品单位，不用 T+ 成本替代 | `业务核算!E6:E7`；`T+ 对接!E14` |
|
||||||
|
| 跨月成本 | 始终采用发货月份指导成本；当月资料录完封存，分月回款不换成本。3 月发货、4 月回款仍取 3 月成本 | 第二版 `客户补充确认!E8` |
|
||||||
|
| 绩效计算及支付 | 采用已裁决的折算毛利润乘计提比例；市政／轨交逐产品计算。首日整 10‰，360／361 天按已裁决分段；60% 起付、不含运费、R×R 全额模式等沿既有确认及参数执行 | 10-12 对照表第 3、4、14、21、22 项；10-15 澄清表第 13 至 15 项实际回复 |
|
||||||
|
| 人员及分管 | T+ 人员编号对应工号并保留前导零；没有固定直属经理，经理分管的是业务员的部分业务 | `T+ 对接!E12` 及人员页 |
|
||||||
|
| 交接与多人分配 | 在职交接，各人得自己发货额对应的绩效；离职交接，未发绩效归接手人。不能套任意固定比例及剩余归负责人旧默认 | `T+ 对接!E13`；`业务核算!E8` |
|
||||||
|
| 经理业务 | 经理本人承接业务不参与绩效汇总；经理分成按业务分管及已确认制度维护，不能只用当前直属经理倒推历史 | `业务核算!E10`；`T+ 对接!E12:E13` |
|
||||||
|
| 二次分配修改 | 每月工资生成前可修改，生成后锁定；仅实际工资制作人可改；已结算差额计调整单生成当月，原结果保留 | B04 后续三条明确答复 |
|
||||||
|
| 客户及产品 | 仅导入性质为客户的往来单位；客户属性、产品类型可手工维护，同步保护人工信息；单位不换算；改名不使原业务重复建账 | `T+ 对接!E13:E14` |
|
||||||
|
| 操作及查看 | 管理员为实际经办账号分配系统角色，用户继承角色权限；按 2026-11-02 本会话确认取消全局唯一制作人绑定。计提岗位不自动授予系统权限，工资仍按月记录实际制作人并执行生成锁 | `业务核算!E11`；2026-11-02 用户明确选择“按角色授权，取消单独绑定” |
|
||||||
|
| 审核 | 保留审核能力、默认关闭；关闭时工资生成完成即可查看，不创建审批步骤或自动通过痕迹。开启后才按既有审核流程执行 | 第二版 `客户补充确认!E11`＋后续“保留、默认不开启”确认 |
|
||||||
|
| 预收及少见款项 | 预收须在实际发货后按已确认的最高比例规则计提；保证金、代收款当前不涉及；特殊抵顶的实际绩效线下处理，不增加一套自动折算流程 | `业务核算!E13`；第二版 `客户补充确认!E10`；`T+ 对接!E11` |
|
||||||
|
| 更正单 | 采用下节已接受方案，保留源单、正负更正单不参与绩效、实际回款关联原业务并防重；已生成工资的差额走当月调整 | 第二版 `客户补充确认!E9`＋16:38／16:53 聊天 |
|
||||||
|
| 同步及保护 | 一周定时同步并支持手动；源 T+ 只读，人工字段受保护。正式连接资料已提供，目标环境兼容与托管是交付验证任务 | 10-12 对照表第 10 项；`T+ 对接!E15:E16`，连接内容不复制 |
|
||||||
|
| 留存及备份 | 数据永久留存；备份采用每日全量、有更新时增量的已确认要求；旧文档的 30 天自动清理不能继续作为现行默认 | `T+ 对接!E17`；10-15 澄清表第 19 项实际回复 |
|
||||||
|
| 金额验收 | 原回复已明确没有认可的实际整月工资结果，安排专人核对手算部分与 T+ 数据；先核对有依据的样本，不要求重交不存在的整月标准答案 | `业务核算!E14`；既有样本核对记录 |
|
||||||
|
|
||||||
|
## 第 03 项的完整处理链
|
||||||
|
|
||||||
|
1. 原业务归 A 客户，后来 T+ 将发货名头调整到 B 客户，生成 A 的负数更正单及 B 的对应正数更正单。
|
||||||
|
2. T+ 原始单据继续保存。工资系统将这对更正单标记为“不参与绩效核算”，保留配对及处理依据供复核。客户接受的是这一方案，不据表中“删除或者不计入”字样执行删除。
|
||||||
|
3. B 客户的实际收款手动关联到 A 客户原业务。沿用同一实际收款身份及实际到账日，不另造一笔回款重复计提，也不在 B 客户名下再次计算。
|
||||||
|
4. 排除、关联及后续调整保留记录；后续同步和重复处理仍应保持人工选择、防止重复计入。这是内部实现与验收要求，不是再向客户索要新规则。
|
||||||
|
5. 涉及已经生成工资的差额，放到当月调整单处理，保留原结果。T+ 发货更正单与工资补扣调整单分别留痕。
|
||||||
|
|
||||||
|
业务结果是保留原业务的绩效计算连续性，正负改名／转名单不造成重复增减。该方案不需要先设计一套“把更正金额自动拆到所有原单并任意改日期”的通用算法。
|
||||||
|
|
||||||
|
已确认场景按上述规则实施。只有日后实际出现与此不同、现有规则无法覆盖的业务，才针对那笔差异核实；不能为假设性真实退货、多原单自动分摊或任意日期覆盖预先增加客户待回复任务。这也不代表客户已经授权所有负数单据一律排除。
|
||||||
|
|
||||||
|
## 需求、实现及验收分别记录
|
||||||
|
|
||||||
|
| 类别 | 当前含义 | 后续动作 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| 客户规则确认 | 上述五项及 B04 已有依据；本轮没有新增必须催客户的规则问题 | 使用最新确认，不再重复追问第 03 项处理方案 |
|
||||||
|
| 内部实现及回归 | 既有记录已有更正事实和 FIFO 测试；11 月 2 日上下文仍记录配对／排除校验、前端选择和完整流程的内部缺口 | 开发方核对当前代码并补齐验证；本轮只整理资料，没有新增测试通过结论 |
|
||||||
|
| 实际资料 | 分类、指导成本、运费、期初／历史已发及归属是具体业务输入；此前用户已说没有该样本指导成本 | 有资料时核对相关记录，缺资料保留待补，不阻塞无关开发、不重复索要已明确不存在的标准工资结果 |
|
||||||
|
| 部署及验收 | 角色权限与用户角色分配、SQL Server 2008 R2、托管及恢复链需目标环境验证；不再配置全局制作人账号 | 部署前落实，不作为当前所有开发的前置条件 |
|
||||||
|
|
||||||
|
## 本轮证据与核验
|
||||||
|
|
||||||
|
- 只读提取 `docs/` 根目录 16 份 Excel，逐表读取公式及缓存两种模式；公式数量 0，缓存错误单元格 0。未保存或重算原表。
|
||||||
|
- 检查 5 份实际 DOCX 的正文，并读取 17 份 Markdown 作历史交叉核对。Office `~$` 锁文件不当作文档；旧 `.doc` 字段说明及 `.rar` 数据字典仅登记，不作为客户业务答复。
|
||||||
|
- 三张截图已查看；提取单元格、源文件路径及哈希清单保存在 `.ai/business-rules-review-20261102/`。聊天及表格截图已复制到该目录，避免只依赖临时剪贴板路径。目录受既有 `.gitignore` 保护。
|
||||||
|
- 第二版确认表 SHA-256：`490e1839bc6378ae7e2839cbd8032e32098137bbd81f2fecb14de5c95f4f75e4`。第一版为 `f0f974dd8520fddc23998ad7cfa592ff234e601edfe90135fcc90fb119229fd4`。
|
||||||
|
- 生产连接资料、人员姓名和完整凭据不复制到本报告；原始单元格保留在源表。此报告不包含新的生产连接、数据库写入或代码验证结果。
|
||||||
49
docs/产品提取与人员岗位操作说明_2026-11-02.md
Normal file
49
docs/产品提取与人员岗位操作说明_2026-11-02.md
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
# 产品提取、人员岗位与首页数据说明
|
||||||
|
|
||||||
|
## 本地演示怎么操作
|
||||||
|
|
||||||
|
进入“基础数据 → 产品管理”，可以看到“【演示】已提取样件A”：数量 10 根，成交单价 100 元，来自本次演示业务的产品提取。
|
||||||
|
|
||||||
|
1. 点击操作栏的“从业务提取产品”。
|
||||||
|
2. 在“名称／业务编号”输入 `YW20261102-0002`，点击查询。
|
||||||
|
3. 勾选“【演示】待提取样件B”，点击“预览所选 1 条”。
|
||||||
|
4. 核对结果为“将创建”，再点击“确认执行提取”并确认。
|
||||||
|
5. 产品管理会出现样件B（DN200，件，数量 5，成交单价 100 元）；该业务明细会关联到新档案，不再重复出现在未关联候选中。
|
||||||
|
|
||||||
|
样件A已由本次操作创建；样件B只验证到预览，特意保留给用户操作。同名同规格已有产品只建立关联，单位或核算分类冲突时不会静默覆盖档案。
|
||||||
|
|
||||||
|
演示客户、人员和产品均带“【演示】”标记。新增 1 位虚拟人员、1 个客户、1 笔业务及 2 条明细、1 张发货单、1 笔 500 元回款；未核算绩效或生成工资。业务金额 1500 元和回款 500 元均为功能演示值，非真实收入。演示数据 ID 及新增前后数量在 `.ai/product-demo-manifest.json`；本次不删除旧数据，保留用户原有业务和手工产品。
|
||||||
|
|
||||||
|
## 为什么采集成功，产品和首页仍可能没有数据
|
||||||
|
|
||||||
|
T+ 采集把原单保存为本地原始快照，不等于正式导入产品、业务、回款或生成绩效台账。开始核查时，开发库产品只有 1 条手工记录，业务、回款及台账均为 0；用户随后新建的原有业务也保留，本次只追加演示数据。
|
||||||
|
|
||||||
|
- 产品档案：到“T+ 数据同步 → 资料与导入 → 基础导入”，选择产品并预览、核对和执行；也可手工新增，或从正式业务中尚未关联档案的产品明细提取。
|
||||||
|
- 业务／回款：正式业务导入需要已核实的资料和平账组，或经业务管理、发货管理、回款管理人工录入。原始采集成功不会自动填满正式业务表。
|
||||||
|
- 首页回款：统计正式回款的到账月份。本次 500 元演示回款可以在 2026 年 11 月查看。
|
||||||
|
- 首页绩效：统计正式核算生成的台账。尚未执行核算时，显示“该时段还没有绩效台账”，这是数据阶段，不是图表丢数据。真实零金额台账仍按零值显示，不当作无数据。
|
||||||
|
|
||||||
|
手工产品未关联有效发货时，“来源／人工保护”显示“人工维护、暂无有效发货来源”，不再使用单独一行横杠。单位、数量或单价未填写时仍为空，不会用猜测值补齐。已有源值和人工保护继续按原规则保留。
|
||||||
|
|
||||||
|
## 直属经理根据什么选择
|
||||||
|
|
||||||
|
客户原回执说明“无直属经理，经理分管不同业务员的部分业务”，来源见 `客户需求回复记录_2026-10-30.md` 的人员回复及 `业务规则时间线与当前口径_2026-11-02.md`。因此人员档案中的直属经理可留空，仅作参考；实际绩效按具体业务的分管经理及历史核算资料归属。
|
||||||
|
|
||||||
|
新增选择只显示当前在职、岗位启用且公式模板为“营销经理·团队与全公司分成”的人员。自定义经理岗位只要绑定该模板也可作为候选；系统登录角色是管理员并不等于营销经理。普通业务员、信息员、离职人员和停用岗位不能被新选为经理，直接调用保存接口同样拒绝。
|
||||||
|
|
||||||
|
旧参考关系若因转岗或离职已不符合新候选条件，保留“历史参考”回显，允许保持原值编辑其他资料，也可以清空或改选合法经理。本次不批量修改已有人员关系，不改变历史业务的分管及工资快照。
|
||||||
|
|
||||||
|
## 公式模板在哪里维护
|
||||||
|
|
||||||
|
- “计提岗位”维护岗位名称、说明及其绑定的公式模板，可以新增岗位并选择已有模板。
|
||||||
|
- “计提参数”维护比例、递减斜率、下限、分界天数及生效日期；岗位编辑弹窗已提供“打开计提参数”链接。
|
||||||
|
- 当前 5 个公式骨架由代码注册表 `backend/app/services/calc_templates.py` 维护，页面不提供公式类型的新增／删除或任意公式编辑。增加全新计算类型需要开发实现、注册和金额回归，不能只新增一个模板名称便让系统执行。
|
||||||
|
|
||||||
|
## 修复与验证
|
||||||
|
|
||||||
|
- 产品与人员表单使用足够标签宽度和自动行高；600 像素以下标签放在控件上方。日期控件占满可用宽度，“工资资料生效日”说明独立显示，避免侵入下一行。
|
||||||
|
- 13 项相关单元、29 项隔离 MySQL 集成、Ruff、前端类型检查及构建通过。类型检查首轮遇到本机 Node 内存分配失败，使用更小的年轻代内存配置重跑后通过，未降低检查标准或跳过检查。
|
||||||
|
- 6 项本地真实接口浏览器检查通过，产品和人员表单覆盖 2560、1366、768、375、320 像素；产品提取只预览保留候选，经理范围与后端一致，模板入口及首页演示回款均有验证，页面错误／服务端失败为 0。
|
||||||
|
- 日志 `.ai/product-personnel-unit.log`、`.ai/product-personnel-integration.log`、`.ai/product-personnel-typecheck.log`、`.ai/product-personnel-build.log`；截图与结果 `.ai/product-personnel-browser/`。
|
||||||
|
|
||||||
|
本次未迁移或清理本地业务库，未改 T+ 连接和采集开关，未操作客户生产库，未提交／推送。
|
||||||
BIN
docs/内部开发任务表_2026-10-28.xlsx
Normal file
BIN
docs/内部开发任务表_2026-10-28.xlsx
Normal file
Binary file not shown.
@ -1,71 +0,0 @@
|
|||||||
# 同步运维自动化与样本核对开发记录
|
|
||||||
|
|
||||||
日期：2026-10-30。依据用户批准的 T1～T6 实施计划，保留既有正式工资闭环及未提交改动；本轮未提交或推送。
|
|
||||||
|
|
||||||
## 交付状态
|
|
||||||
|
|
||||||
| 任务 | 当前结果 | 仍需验收的部分 |
|
|
||||||
|---|---|---|
|
|
||||||
| T1 样本核对包 | 已从恢复库只读整理客户、发货、明细、回款凭证、工号、期初和费用证据 | 候选期初及空运费不自动认定为零 |
|
|
||||||
| T2 每周自动排队 | 已实现持久化周期、幂等、手动任务协调及停机补最近一周 | 生产自动排队关闭，目标环境启用另行确认 |
|
|
||||||
| T3 有限重试与提示 | 已实现错误分类、5／15 分钟两次重试、独立心跳及站内提示 | 外部邮件／企业消息不在本轮范围 |
|
|
||||||
| T4 Windows 托管包 | 启动、安装预演、身份／ACL 校验、检查及停用脚本已交付；本机隔离验证通过 | 客户服务账号、实际计划注册、开机及自动重启需专用目标环境验证 |
|
|
||||||
| T5 真实金额验收 | 待资料；没有正式工资或金额验收结果 | 用户明确没有样本人工指导成本，不能用源成本或零成本替代 |
|
|
||||||
| T6 回归及说明 | 完整单元、隔离集成、迁移、类型构建、浏览器及脚本验证已完成 | 真实金额、目标环境托管及生产启用分别记录 |
|
|
||||||
|
|
||||||
## 样本依据及缺口
|
|
||||||
|
|
||||||
核对包：`docs/样本核对包_2026-10-30/materials-9395-2026-03.md`，同名 JSON 保留原始查询证据及指纹。源库始终只读，查询参数化并限制 201 行（交付最多 200 行，超限明确标记）。未读取生产连接文件或使用源写权限。
|
|
||||||
|
|
||||||
- 客户 9395，代码 0060201；2026-03-05 发货 SA-2026-03-0034，1125.00 元。
|
|
||||||
- 明细 392858，产品 32584／02020276，承插口排水管 GIIΦ300*2500，10 根，含税单价 112.50 元。
|
|
||||||
- 2026-03-18 回款 SK-2026-03-0016，1125.00 元，关联有效总账凭证 0035。发货和回款均关联业务员工号 010110，不再向客户重复索要单据归属。
|
|
||||||
- 样本未查到初始化应收和切换日前应收台账，只形成候选零余额依据。总表存在 2017-05-31 初始化数据，不能当作 2026-02-28 余额。
|
|
||||||
- 存在运费字典和费用分摊结构，但样本无关联费用，明细费用为空；仍待核实，不能当作零运费。
|
|
||||||
- 产品源分类 GII级不能直接映射绩效分类，客户绩效类型为空。人工指导成本、样本历史已核算／已发金额和当时分管／交接依据不能从恢复库直接确认。
|
|
||||||
- 用户两次表示未找到／没有该样本人工指导成本资料。本轮据此标记 T5 待补，不重复索要同一资料，不生成模拟工资冒充实测。
|
|
||||||
|
|
||||||
## 调度、重试和运行状态
|
|
||||||
|
|
||||||
新增 `TPlusAutomationState` 保存源身份摘要、ISO 周、原始／当前批次、累计自动重试次数、下次重试、维护时间及独立心跳。摘要不含凭据。`tplus-maintain --once` 复用原任务队列、九类白名单源实体及 worker，不调用正式导入或工资生成。
|
|
||||||
|
|
||||||
默认每周一北京时间 02:00、自动化关闭。相同源及周使用稳定请求键；维护锁与长采集锁独立，同周期竞争只排队一次。手动或工作区任务占用时延后，停机仅补最近已到期周期。
|
|
||||||
|
|
||||||
仅明确断连／超时，且本批次所有错误均可重试时，终止后 5 分钟、15 分钟各重试一次。读取中途断连仍记 FAILED，已保存页保留，由全量哈希去重恢复；行级资料错误／PARTIAL、配置／字段错误及中断转人工处理。自动次数累计不被人工重试清零。维护锁定并核对本周期重试树，人工恢复成功后不再重试原失败批次；人工与自动竞争同一父批次仅创建一个活动重试。
|
|
||||||
|
|
||||||
心跳由独立线程／会话每 30 秒写入，不受长查询阻塞。停止标记阻止排队及后续领取，完成当前任务后记 STOPPED。概况接口新增 `automation`，前端显示采集开关、心跳、最近成功、下次重试，以及失败／部分失败、排队 15 分钟、8 天无成功和心跳 2 分钟中断提示。提示可打开相关批次，写按钮遵循实际制作人权限。
|
|
||||||
|
|
||||||
## 迁移及托管
|
|
||||||
|
|
||||||
V20 增加自动化状态与批次触发来源、自动重试序号；发现状态默认值包含额外引号后，以新增 V21 修正，保留已应用 V20。同步迁移 SQL、ORM 和开发初始化结构。最新 head：`21f2a3b4c5d6`。仅在明确隔离测试库运行升级／回退，原业务库未迁移。
|
|
||||||
|
|
||||||
Windows 包位于 `scripts/windows/`，操作说明见该目录 README。默认预演，注册需显式 Apply；注册后仍禁用且存在停止标记，自动采集开关保持关闭。生产使用已有受限服务账号；安装清单保存 SID、登录方式并核对 Limited 权限，拒绝账号／动作漂移。安装和 Start 校验关键文件、所有者与上层目录权限，不自动变更现有 ACL。
|
|
||||||
|
|
||||||
任务设置为 IgnoreNew、每分钟异常重启、最多三次、无执行时限。启动器隐藏运行并传递子进程退出码，含空格路径及尾反斜线按 Windows 引号处理。Stop 先禁用并写标记，默认等待当前任务完成；显式 Force 才强停已核对项目任务。日志按次保存且不自动删除。实际客户任务未安装或启用。
|
|
||||||
|
|
||||||
## 验证证据
|
|
||||||
|
|
||||||
| 范围 | 结果 | 证据 |
|
|
||||||
|---|---|---|
|
|
||||||
| 最终完整单元（自动化阶段） | 784 项通过 | `.ai/automation-unit-final.log` |
|
|
||||||
| 完整隔离集成（自动化阶段） | 30 个文件，A 186＋B 219＝405 项通过 | `.ai/automation-integration-A.log`、`automation-integration-B.log` |
|
|
||||||
| 最新迁移往返及结构／调度专项 | V21 升级、回退、再升级及 16 项通过；新增默认值测试在本组覆盖 | `.ai/automation-migration-final.log` |
|
|
||||||
| Ruff | 后端检查通过 | `backend/.venv-workbench/Scripts/ruff.exe check backend` |
|
|
||||||
| 前端类型及生产构建 | 通过；既有大块体积提示保留 | `.ai/automation-frontend-build.log` |
|
|
||||||
| 真实 Edge 浏览器，合成接口 | 7 项检查通过，无 pageerror、无写请求；320／768／1440 无横向溢出 | `.ai/automation-browser-result.json`、`automation-ui-*.png` |
|
|
||||||
| Windows PowerShell 5 | 任务计划参数、语法、ACL规则及身份漂移、停止标记、空格路径、隐藏子进程和退出码验证通过 | `Test-PayrollTaskPlan.ps1`、`Test-PayrollHostRuntime.ps1` |
|
|
||||||
|
|
||||||
完整隔离集成在 V20 时覆盖全部文件；V21 仅修正状态默认值，随后迁移往返和受影响 16 项再通过。新增默认值测试不重复计入前述 405 项完整基线。单元既有 Starlette 弃用提示未改变测试结果。
|
|
||||||
|
|
||||||
### 项目收尾复验补充（2026-10-30）
|
|
||||||
|
|
||||||
正式工资与更正场景继续收口后，后端单元重新执行为 `786 passed`，代码变更后的隔离数据库完整集成为 `406 passed`，失败 0、跳过 0；Ruff、前端类型检查与生产构建通过。新增 `CORRECTION` 事实支持已确认的一正一负更正单排除绩效及跨客户回款归入原业务，详见正式工资开发记录。
|
|
||||||
|
|
||||||
托管复测中，测试脚本最初未提前持有进程句柄，导致正常退出被误判；确认 worker.stopped 和空错误日志后，修正测试脚本并重新隔离执行通过。生产启动器已保留句柄并正确传递失败码。浏览器最初的请求拦截范围和选择器属于测试脚本问题，已修正后完整通过；未因此修改产品行为。
|
|
||||||
|
|
||||||
## 后续事项
|
|
||||||
|
|
||||||
1. 取得有实际依据的最小成本、分类、运费、期初／历史及分管资料，执行一组真实样本从导入到工资／报表逐笔核对，再扩到整月。资料缺失时保留待补。
|
|
||||||
2. 在专用目标环境准备服务账号与目录权限，确认后实际安装、验证开机及异常恢复，再决定生产自动化开关。
|
|
||||||
3. 通用多原单更正金额与日期依据、SQL Server 2008 R2 实机兼容、目标环境全量／增量恢复演练继续单独跟踪；已确认的一正一负更正示例已实现。
|
|
||||||
4. 历史数据和备份永久留存；本轮未执行清理、客户业务迁移或生产启用。
|
|
||||||
84
docs/实际样本核对_辽宁兴晟达_2026-07_2026-11-02.md
Normal file
84
docs/实际样本核对_辽宁兴晟达_2026-07_2026-11-02.md
Normal file
@ -0,0 +1,84 @@
|
|||||||
|
# 辽宁兴晟达物资有限公司 2026 年 7 月实际样本核对
|
||||||
|
|
||||||
|
记录日期：2026-11-02。来源：本次会话中用户转述的客户回复及本地已发布 T+ 源快照。当前阶段：单据、FIFO、参数及经理本人排除分支的只读核对完成；未执行正式导入或工资生成，也未将本组结果代作整月验收。
|
||||||
|
|
||||||
|
## 客户已提供的资料
|
||||||
|
|
||||||
|
| 项目 | 客户回复 | 本次使用范围 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| 客户 | 辽宁兴晟达物资有限公司 | 按源客户身份核对，不能仅凭近似名称合并 |
|
||||||
|
| 核对月份 | 2026 年 7 月 | 截止 2026-07-31，按客户范围核对 FIFO |
|
||||||
|
| 发货单号 | `SA-2026-07-0503` | 在已有 T+ 快照中定位并核对明细 |
|
||||||
|
| 收款单号 | `SK-2026-07-0041` | 核对所属客户、日期、金额及有效凭证，不假设只匹配指定发货 |
|
||||||
|
| 产品 | `GII300*2500`，单位“根” | 与源产品规格及单位交叉核对 |
|
||||||
|
| 含税指导成本 | `55.33 元/根` | 单位成本，仅用于已确认发货月份及对应产品，不替代其他月份／产品成本 |
|
||||||
|
| 客户核算类型 | 企业户 | 按到账日有效的企业户参数核对 |
|
||||||
|
| 产品核算类别 | 市政水利 | 使用对应阈值及企业户分类参数 |
|
||||||
|
| 运费 | `0 元`，自提单 | 客户明确确认的本组业务资料，不推广为该客户全部历史发货零运费 |
|
||||||
|
| 期初欠款 | 截至 2026-02-28 无欠款 | 期初应收余额 `0.00`；3 至 7 月是否有其他未结发货由源数据核对 |
|
||||||
|
| 分管经理 | 刘美坤 | 客户后续确认其 2026 年 3 月至 7 月担任经理，按本组发生月份的历史身份核对 |
|
||||||
|
| 历史处理 | “未核算，未发放。” | 客户对历史补问的回复；补问截止日为 2026-06-30，不由此扩大为全公司历史均未处理 |
|
||||||
|
| 交接 | “无交接。” | 本组无交接，不新增虚构交接记录 |
|
||||||
|
|
||||||
|
## 核对方法与边界
|
||||||
|
|
||||||
|
1. 核对现有本地快照中的客户、发货、发货明细、回款、产品、人员和有效总账凭证。
|
||||||
|
2. 先查看同一客户自 2026-03-01 至 2026-07-31 的全部发货和回款，确认先前余额及 FIFO 分配，不把一对单号当成客户要求人工指定批次。
|
||||||
|
3. 对能与客户提供资料完整对应的明细，核对成本、净销售额、毛利、企业户比例、计提和支付权重；缺少的其他明细资料单列，不填默认值。
|
||||||
|
4. 使用项目现行计算服务及独立十进制复算对比。现有源读取、正式导入、工资生成和生产自动化开关不由本轮启用。
|
||||||
|
|
||||||
|
## 人员历史岗位补充（本轮最新）
|
||||||
|
|
||||||
|
用户转述客户原话：“名单中，刘美坤和张玲，两个人在2026年3月到7月期间担任经理，在8月之后担任业务员”。
|
||||||
|
|
||||||
|
本组发货和回款发生于 2026-07-16，刘美坤应按当时的经理岗位处理。当前人员名单及本地档案中工号 `010110` 为“业务员”，描述的是后来状态，不能反推 7 月岗位。张玲也需保留同一历史任职说明，但本轮不按姓名自动改工号或人员档案。客户回复给出的是月份范围，暂不补造转岗的具体日。
|
||||||
|
|
||||||
|
此补充已经解决人员身份疑问；不再重复追问刘美坤是否为经理。本组“无交接”与本人岗位后来变化分别记录，转岗不自动产生业务交接。
|
||||||
|
|
||||||
|
## 本地源数据核对
|
||||||
|
|
||||||
|
| 项目 | 核对结果 |
|
||||||
|
| --- | --- |
|
||||||
|
| 客户 | 源 ID `9647`，编号 `1800226`，名称与客户回复一致，T+ 性质为客户 |
|
||||||
|
| 客户范围 | 当前已发布快照中该客户只有 1 张发货单、1 张收款单；截至 7 月没有其他发货占用本笔收款 |
|
||||||
|
| 发货 | `SA-2026-07-0503`，源 ID `106522`，2026-07-16，含税金额 3,850.00 元 |
|
||||||
|
| 发货明细 | 源 ID `406547`，产品 `75599`／`02020618`，28 根，含税单价 137.50 元，明细含税金额 3,850.00 元 |
|
||||||
|
| 源规格 | `GIIΦ300*2500（B口）`；保留与客户简写 `GII300*2500` 的区别，未推广该成本到其他产品 |
|
||||||
|
| 回款 | `SK-2026-07-0041`，源 ID `18971`，2026-07-16，3,850.00 元，收款方向及生效状态符合现有规则 |
|
||||||
|
| 有效凭证 | 总账凭证 `0044`，源 ID `43887`；关联 1 张、有效 1 张 |
|
||||||
|
| 源归属 | 发货、收款均为源人员 ID `47`，工号 `010110`，即本次回复中的刘美坤 |
|
||||||
|
| FIFO | 期初 0.00 元；收款全额分配本次发货，期初剩余、发货剩余、预收剩余均为 0.00 元 |
|
||||||
|
|
||||||
|
源快照的发货结清枚举 `428` 不当作作废；源发货状态为 `189`，且非对冲发货。数据来自本地已发布历史快照，本轮未重新读取生产 T+，不能据此证明快照之后没有源单修改。
|
||||||
|
|
||||||
|
## 成本、参数及试算结果
|
||||||
|
|
||||||
|
| 项目 | 金额／结果 |
|
||||||
|
| --- | ---: |
|
||||||
|
| 含税销售额（运费 0） | 3,850.00 元 |
|
||||||
|
| 含税指导成本 | 28 × 55.33 ＝ 1,549.24 元 |
|
||||||
|
| 毛利润 | 2,300.76 元 |
|
||||||
|
| 毛利润率 | 59.76% |
|
||||||
|
| 市政水利阈值 | 30% |
|
||||||
|
| 折算毛利润 | 2,300.76 − 3,850.00 × 30% ＝ 1,145.76 元 |
|
||||||
|
| 同日发货、回款天数 | 1 天 |
|
||||||
|
| 7 月企业户普通计提参数 | 2‰，生效记录为 2026-02-17；3‰ 从 2026-08-13 生效，本组不采用 |
|
||||||
|
| 起付及权重 | 起付门槛 60%，回款比例 100%，R×R 为 1 |
|
||||||
|
| 本组实际采用的单笔比例 | 0，经理本人业务排除优先于企业户普通比例 |
|
||||||
|
| 本笔绩效及本笔可付金额 | **0.00 元** |
|
||||||
|
| 本笔对经理分成汇总基数的贡献 | 0.00 元 |
|
||||||
|
|
||||||
|
项目 FIFO 纯函数已按客户确认的 7 月历史经理岗位复算，回款分配守恒且无待补行；经理本人业务排除标志为真。金额、成本和折算毛利与独立十进制复算一致，经理本人排除分支与独立业务规则预期 0.00 元一致。
|
||||||
|
|
||||||
|
此前按当前“业务员”岗位算出的 2.29 元，是岗位疑问未解决时的条件试算，现已不采用。它不是本组确认结果。保留旧试算供审计，不覆盖其输入以伪装当时已经知道历史岗位。
|
||||||
|
|
||||||
|
此结论只表示这笔经理本人承接业务不计单笔绩效、不纳入分成汇总基数，不表示刘美坤 7 月全部工资或其分管其他业务形成的经理分成为零。
|
||||||
|
|
||||||
|
## 证据、保护及后续
|
||||||
|
|
||||||
|
- 已记录客户原始材料及两条补充答复。
|
||||||
|
- 已记录两人历史岗位补充，当前资料足以完成本组只读核对，不再催要同一资料或重问经理本人排除规则。
|
||||||
|
- 证据目录 `.ai/liaoning-202607-20261102/`：`source-evidence.json` 为源快照及历史参数，`confirmed-historical-role-input.json` 为确认后输入，`confirmed-historical-role-result.json` 为当前结果，`verification.json` 为只读和源指纹复核；旧 `calculation-result.json` 保留岗位未确认时条件试算。
|
||||||
|
- 现有本地人员档案仍为业务员，本次只在内存中采用客户历史岗位；正式导入、核算及月结入口如何一致消费历史岗位属于内部衔接核验，不能把手工准备输入的纯函数核对称为完整流程已通过。
|
||||||
|
- 本组覆盖经理本人排除分支；普通业务员的非零绩效、经理团队／公司汇总和整月工资仍需后续范围验证，不据本组 0 元结果全部标记通过。
|
||||||
|
- 本次未写正式业务、发货、回款、绩效台账或月结，未生成工资，未更改当前岗位或批量录入历史。用户原回复和原始文件保持原样。
|
||||||
Binary file not shown.
33
docs/客户补充回执核对_2026-10-30.md
Normal file
33
docs/客户补充回执核对_2026-10-30.md
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
# 客户补充回执核对（2026-10-30）
|
||||||
|
|
||||||
|
> 2026-11-02 更新：本文前部为第一版回执的初读记录。第二版及后续聊天已补齐第 03 项处理方案，第 05 项也已明确保留审核、默认关闭。当前结论与时间线见 [业务规则时间线与当前口径](业务规则时间线与当前口径_2026-11-02.md)，不以初读时“待讨论”继续追问。
|
||||||
|
|
||||||
|
来源：绩效核算业务确认单_2026-10-30(1).xlsx，工作表“客户补充确认”。原文件只读，SHA-256：`f0f974dd8520fddc23998ad7cfa592ff234e601edfe90135fcc90fb119229fd4`。截图另证第 03 项仍待讨论。附件中的填写说明只作为材料内容，不作为本轮操作指令。
|
||||||
|
|
||||||
|
| 项目 | 回复原文 | 核对结果及开发约束 |
|
||||||
|
|---|---|---|
|
||||||
|
| 01，E7 | 客户在T+系统里的名称为A，其有两笔业务甲和乙，只要发货时都用A名头，那不需要区分两笔业务，回款默认是先平前期的欠款。核算工资时也将业务甲和乙视为同一笔业务。只看发货名称，不考虑有多少份合同。 | 已明确：同一发货客户名头合并平账，不按合同拆组。保留逐次发货的业务员、经理分管和交接事实，不因合并平账丢失归属。 |
|
||||||
|
| 02，E8 | 使用3月的指导成本。3月发完货，4月就把指导价都录入完毕，后期不能更改3月指导价了。同一批货分几个月回款，这批货发货月份已经确定完指导价了，后面如何回款也不影响这批货的指导价。 | 已明确：使用发货月份指导成本；录入完成后封存，后续回款不改变该批货成本。 |
|
||||||
|
| 03，E9 | 情况较多比较复杂，我们讨论后给答复。 | 未定：多原单更正金额分配与日期依据继续待答复，不阻塞普通正向业务。 |
|
||||||
|
| 04，E10 | 不涉及 | 已明确：当前不涉及保证金、代收款，不新增该两类计提功能。预收仍沿已确认规则。 |
|
||||||
|
| 05，E11 | 查看人员保留审核操作，财务复核、领导审核人员不保留在系统内点击“通过／退回”的权限。 | 存在表述歧义：首句保留审核，后句取消财务和领导审核按钮。已请求确认实际审核主体，未自行将其解释为取消全部审核或保留原财务／领导权限。 |
|
||||||
|
|
||||||
|
当前结论（初读原表）：3 项明确、1 项待讨论、1 项需澄清表述。收到答复不代表对应功能已通过验收。截图“第三条情况比较复杂，我们需要讨论后再给答复”与 E9 一致。
|
||||||
|
|
||||||
|
## 第05项用户澄清及最新截图（优先于初读判断）
|
||||||
|
|
||||||
|
用户直接澄清：“实际上工资完成后不需要有人在系统中有审核的步骤或者痕迹，能查看就可以”。随后补充截图，对方回复“那就给他保留”“默认不开启”。最新截图路径：`C:/Users/Administrator/AppData/Local/Temp/codex-clipboard-8e58b2bf-f65d-4a14-a8e4-59421ccb7ecb.png`。
|
||||||
|
|
||||||
|
最终口径：保留原有审核能力，默认关闭。关闭时工资生成即完成，其他人查看即可，不新建审批单／审批步骤，也不伪造自动通过痕迹；开启后才使用财务复核和领导审核。开启配置与旧核算引擎兼容开关相互独立。必要的计算版本、依据和操作日志继续保留。
|
||||||
|
|
||||||
|
当时的确认结果：01、02、04、05 四项明确；03 仍待讨论。该阶段状态已由下节第二版及聊天确认更新。原 Excel、截图内容均不改写，收到回复与功能验收状态分开记录。
|
||||||
|
|
||||||
|
## 第二版回执与客户接受方案（2026-11-02 补核）
|
||||||
|
|
||||||
|
`绩效核算业务确认单_2026-10-30(2).xlsx` 的 `客户补充确认!E9` 已用具体场景补充第一版的“讨论后给答复”：A 发货转 B 后产生一负一正两张更正单，实际由 B 回款，希望不计这对更正单绩效并沿用 A 原业务。E11 则明确工资完成后只需查看、不需要实际审批步骤或痕迹。
|
||||||
|
|
||||||
|
后续聊天先于 16:38 给出保留 T+ 原单、正负更正单排除绩效、B 实际回款关联 A 原业务并保留到账日、防止 B 侧重复计提及当月调整的方案，客户于 16:53 回复：“可以可以，那太好了”。原截图只显示星期五及时间，未显示完整日期；该沟通按既有记录归入 2026-10-30，不将归档日期冒充截图显示日期。
|
||||||
|
|
||||||
|
因此第 03 项上述方案已经确认，第 01 至 05 项均有当前口径。无需继续为已确认场景催要一套通用多原单自动分摊或任意日期修改规则；后续遇到未覆盖的真实业务再具体核实。保留原单和排除计算是已接受的方案，不能据原表中的二选一询问执行删除。
|
||||||
|
|
||||||
|
本轮再次提供的聊天和表格截图已保存在 `.ai/business-rules-review-20261102/客户方案确认.png`、`第03项原表截图.png`；源表 SHA-256 为 `490e1839bc6378ae7e2839cbd8032e32098137bbd81f2fecb14de5c95f4f75e4`。本次仅读表、核对及更新文档，不据此标记实现或金额验收完成。
|
||||||
242
docs/客户需求回复记录_2026-10-30.md
Normal file
242
docs/客户需求回复记录_2026-10-30.md
Normal file
@ -0,0 +1,242 @@
|
|||||||
|
# 客户需求回复记录
|
||||||
|
|
||||||
|
记录日期：2026 年 10 月 30 日。用途：项目内部需求依据，记录两份客户表格已经填写的答复，不是再次向客户提问的清单。
|
||||||
|
|
||||||
|
## 来源与记录方式
|
||||||
|
|
||||||
|
1. [T+对接待确认事项_2026-10-28(1).xlsx](<D:/work/code/PayrollManagementSystem/docs/T+对接待确认事项_2026-10-28(1).xlsx>)，工作表“T+ 对接”及人员名单页。
|
||||||
|
2. [业务核算待确认事项_2026-10-28(2).xlsx](<D:/work/code/PayrollManagementSystem/docs/业务核算待确认事项_2026-10-28(2).xlsx>)，工作表“业务核算”。
|
||||||
|
|
||||||
|
以下摘录直接取自回复栏 E 列，保留原答复的内容、语气和确定程度，仅去掉末尾签名、将日期单列，并省略具体姓名和连接凭据。正文中的“能否”“无法描述”“未理解”等表述保留原样，不替客户补成已确认规则。姓名需要核对时回到对应源单元格，不按岗位概称扩大原表指定人员的权限。
|
||||||
|
|
||||||
|
两份原始 Excel 均仅读取，未保存或修改。文件名中的 2026-10-28 是清单日期；多数回复标注的日期是 2026-10-29，两者分别记录。收到业务答复不代表字段核验、代码实现或客户验收已经完成。
|
||||||
|
|
||||||
|
## 一、T+ 对接表回复
|
||||||
|
|
||||||
|
### T01 发货日期在 T+ 中如何记录
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E6`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 以销货单的单据日期为准，不会发生缺少日期的情况
|
||||||
|
|
||||||
|
### T02 实际到账日在 T+ 中如何记录
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E7`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 以收款单的单据日期做为到账日
|
||||||
|
|
||||||
|
### T03 回款如何对应合同和发货批次
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E8`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 回款不需要匹配合同和发货批次，以先发货先平账的原则计算即可
|
||||||
|
|
||||||
|
### T04 哪些收款状态可以进入财务核对
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E9`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 已经生成凭证的收款单状态可以进行绩效工资计算
|
||||||
|
|
||||||
|
### T05 退货、红冲和作废单如何对应原业务
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E10`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 无法描述对应关系，有时一张更正单还可能对应多笔原单，此类业务能否保留手动调整发货和回款日期的可能？
|
||||||
|
|
||||||
|
### T06 T+ 如何识别以物抵顶等收款方式
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E11`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 此类业务发生的概率特别低，即便发生也涉及一系列线下手续，所以T+按照正常业务计算即可，我们会单独记录发生的业务，手动核算业务人员的应得绩效
|
||||||
|
|
||||||
|
### T07 T+ 人员编号与工资系统如何对应
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E12`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 人员编号，姓名，岗位见SHEET2,无直属经理，经理分管不同业务员的部分业务，T+编号可以默认为对应工号，离职人员未结清业务已交接给其他业务员，离职人员的业务在其交接离职后又发生发货及回款，发生业务时发货和回款对应的业务员姓名为交接后的人员（这点不知道是否影响绩效核算）
|
||||||
|
|
||||||
|
### T08 导入哪些客户，分类和负责人如何对应
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E13`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 导入T+基础设置里往来单位中性质只为“客户”的客户，客户类型同步T+内往来单位中的”客户属性“，前期沟通过这里需要保留手动修改的功能。目前没有同名，合并和负责人缺失的情况，改名的情况存在，改名后的业务不影响此项业务整体的工资核算，以改名后的第一笔业务为分界点。1,离职发生的业务交接，所有业务整体交接给新的业务员，所有的回款也是以此笔业务为基础进行平账，所有未发绩效均发放给交接后的业务员。2.在职员工之间发生的业务交接，回款逻辑也是按时间先后进行平账，但绩效发放为两部分，每个人得自己发货额对应应得的那部分绩效
|
||||||
|
|
||||||
|
### T09 产品单位、金额与计提类别如何对应
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E14`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 能否保留后期手动输入产品类型的功能？没有单位换算，后期手动录入成本时，保持与T+中相对应的产品单位一致
|
||||||
|
|
||||||
|
### E01 提供正式 T+ 连接资料
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E15`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
脱敏记录：已提供正式服务器信息、端口、账套及登录资料。为保护生产连接信息，本记录不复制服务器地址、账号、密码和账套名称；完整资料保留在源表 E15，项目外私有连接配置另行保存。资料已提供不代表已连接生产或完成目标版本验收。
|
||||||
|
|
||||||
|
### E02 正式部署主机及每周同步安排
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E16`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 主机正按要求部署中
|
||||||
|
|
||||||
|
记录说明：原回复说明部署进行中，未给出具体同步时段或托管安排，不能记成部署已完成。
|
||||||
|
|
||||||
|
### S1 哪些人员可访问数据，数据需要保留多久
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `T+ 对接!E17`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 工资核算人员、工资审核人员、总经理，可以访问，访问范围：所有数据；保留期限永久
|
||||||
|
|
||||||
|
## 二、业务核算表回复
|
||||||
|
|
||||||
|
### B01 销售额和成本是否含税
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E6`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 计提绩效时的销售额及成本均含税，毛利润=含税不含运费销售额-含税指导价
|
||||||
|
|
||||||
|
### B02 绩效计算使用哪种成本
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E7`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 使用指导价即成本，成本均为后期手动录入，并且每个月都会有调整，T+中的产品成本部分不需要同步，对我们后期制作绩效工资没有用处
|
||||||
|
|
||||||
|
### B03 多人分配绩效时，分配什么、余额归谁
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E8`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 多人分配绩效时，分配的是每个人的销售额对应的那部分绩效，不会有不足100%的情况，而且此类情况只会发生在在职人员之间的业务交接时
|
||||||
|
|
||||||
|
### B04 分配方案何时能改、由谁修改
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E9`；回复日期：原回复未单独标注。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 未理解需要确认的内容
|
||||||
|
|
||||||
|
记录说明：这是原表的答复。2026-10-30 后续聊天已补充三条规则，单列于第四节，不覆盖或改写原单元格。
|
||||||
|
|
||||||
|
### B05 经理本人承接的业务是否参与绩效汇总
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E10`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 经理本人承接的业务不参与绩效汇总
|
||||||
|
|
||||||
|
### B06 录入、核对和审批分别由谁负责
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E11`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 营销后勤：[原表指定人员]，所有权限；其他人员：只有可查看的权限，不能对任何内容进行修改
|
||||||
|
|
||||||
|
记录说明：全部操作权限授予原表指明的具体操作人员，不等于该岗位的所有人员自动拥有权限；具体身份回查本单元格。
|
||||||
|
|
||||||
|
### B07 从哪个月启用，旧业务和已发工资如何接续
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E12`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 两个启用节点，1：2026年3月；2：2026年8月（对经理及企业户工资进行调整），旧业务的回款需先平3月之前的应收款，这部分绩效按我们之前的方案计提（我们用之前的软件核算），3月1日后开始的发货按新系统计算绩效（如果是连续性的业务，新系统能否判断将前期应收款平账之后再开始计算3月1日后的绩效工资，也就是旧业务在3月1日之后的发货额按照新发生业务计算，但3月1日之后的回款额先平之前的应收，平账后的回款才开始计提绩效。）
|
||||||
|
|
||||||
|
### B08 预收款、保证金、代收款和期初款是否计提
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E13`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 预收款转为正式回款的条件为此业务名下发生实际发货，并且此笔回款按最高计提比例计算绩效
|
||||||
|
|
||||||
|
### E04 选哪个月份、哪些业务核对工资
|
||||||
|
|
||||||
|
来源：`业务核算待确认事项_2026-10-28(2).xlsx` → `业务核算!E14`；回复日期：2026-10-29。
|
||||||
|
|
||||||
|
回复摘录：
|
||||||
|
|
||||||
|
> 没有认可的实际工资结果，只有专人对手动核算的部分以及相对应的T+数据进行审核
|
||||||
|
|
||||||
|
记录说明：未提供已认可的整月工资结果，原答复只说明已有专人核对手工核算部分及对应 T+ 数据。
|
||||||
|
|
||||||
|
## 三、人员名单页
|
||||||
|
|
||||||
|
来源：`T+对接待确认事项_2026-10-28(1).xlsx` → `人员姓名，岗位及编号!A2:D19`。共 18 人：12 名在职业务员、4 名离职业务员、2 名在职经理。
|
||||||
|
|
||||||
|
本节仅记录工号、岗位及状态，姓名保留在原表 B 列。工号按源单元格文字值记录，已有前导零保留；数值型单元格不擅自补零。名单记录不等于已与 T+ 全部匹配成功。
|
||||||
|
|
||||||
|
| 工号 | 岗位 | 状态 | 来源行 |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| `00043` | 业务员 | 在职 | `A2:D2` |
|
||||||
|
| `00051` | 业务员 | 在职 | `A3:D3` |
|
||||||
|
| `00092` | 业务员 | 在职 | `A4:D4` |
|
||||||
|
| `0100102` | 业务员 | 离职 | `A5:D5` |
|
||||||
|
| `10068` | 经理 | 在职 | `A6:D6` |
|
||||||
|
| `010103` | 业务员 | 在职 | `A7:D7` |
|
||||||
|
| `010105` | 业务员 | 在职 | `A8:D8` |
|
||||||
|
| `010110` | 业务员 | 在职 | `A9:D9` |
|
||||||
|
| `010112` | 业务员 | 在职 | `A10:D10` |
|
||||||
|
| `101124` | 业务员 | 在职 | `A11:D11` |
|
||||||
|
| `010124` | 业务员 | 在职 | `A12:D12` |
|
||||||
|
| `010126` | 业务员 | 离职 | `A13:D13` |
|
||||||
|
| `010128` | 经理 | 在职 | `A14:D14` |
|
||||||
|
| `010140` | 业务员 | 在职 | `A15:D15` |
|
||||||
|
| `10053` | 业务员 | 在职 | `A16:D16` |
|
||||||
|
| `10057` | 业务员 | 离职 | `A17:D17` |
|
||||||
|
| `10061` | 业务员 | 离职 | `A18:D18` |
|
||||||
|
| `10065` | 业务员 | 在职 | `A19:D19` |
|
||||||
|
|
||||||
|
## 四、表外后续补充：B04
|
||||||
|
|
||||||
|
以下来自 2026-10-30 的后续聊天，已另行记录于 [二次分配修改规则确认_2026-10-30.md](<D:/work/code/PayrollManagementSystem/docs/二次分配修改规则确认_2026-10-30.md>)，不属于本次两份 Excel 的原始回复。开发使用时需与原表合并阅读，不能继续将 B04 当作尚未回答。
|
||||||
|
|
||||||
|
1. 每个月做工资前可以修改二次分配，当月工资生成后不允许修改。
|
||||||
|
2. 只有制作工资的那个人拥有修改权限。
|
||||||
|
3. 原已结算部分因调整单产生的差额，在调整单生成当月多退少补，原结算记录保留。
|
||||||
|
|
||||||
|
适用范围是二次分配方案，不能自动扩大为任意修改发货日、回款日、业务归属或全部历史单据的权限。
|
||||||
|
|
||||||
|
## 五、与补充确认表及开发状态的区别
|
||||||
|
|
||||||
|
这两份表格已经收到的 21 条答复在本记录中逐条归档，不应再统称为“客户尚未回复”。其中 B04 的原表疑问已有表外补充；部分回复只覆盖原问题的一部分或提出功能诉求，不能把整道问题都标成完全明确。
|
||||||
|
|
||||||
|
随后准备的 [绩效核算业务确认单_2026-10-30.xlsx](<D:/work/code/PayrollManagementSystem/docs/绩效核算业务确认单_2026-10-30.xlsx>) 只补五个具体边界，并不是要求客户重新回答上述两份表格。准备时尚未收到新表回复；后续第一版、第二版回执及聊天已明确这五项的当前处理口径。按时间的最新结论见 [业务规则时间线与当前口径](业务规则时间线与当前口径_2026-11-02.md)，不能继续把本段准备时状态当作当前待回复状态。
|
||||||
|
|
||||||
|
源码符合性、内部整改和测试状态另见 [开发需求符合性与收尾核查_2026-10-30.md](<D:/work/code/PayrollManagementSystem/docs/开发需求符合性与收尾核查_2026-10-30.md>)。本次只归档答复，不新增产品实现完成或业务验收通过的结论。
|
||||||
|
|
||||||
|
## 六、源文件核验
|
||||||
|
|
||||||
|
| 文件 | SHA-256 |
|
||||||
|
| --- | --- |
|
||||||
|
| `T+对接待确认事项_2026-10-28(1).xlsx` | `9a28001723c0c9bef06cad9c352af5ca1b68ae0c7134f2254aceddcddb66bf2b` |
|
||||||
|
| `业务核算待确认事项_2026-10-28(2).xlsx` | `f37f978f71bc64503194733b70debfaa49ed6fcdbf5bd11fa70fc0de714210e1` |
|
||||||
@ -1,99 +0,0 @@
|
|||||||
# 待确认事项汇总（2026-10-16）
|
|
||||||
|
|
||||||
> 汇总当前所有「待执行 / 待答复 / 待恢复」事项，供项目例会与对外跟催使用。
|
|
||||||
> 来源：《待澄清问题清单_2026-10-15.xlsx》（业务方 24 项）、《T+对接数据需求清单》v1.2.1（IT 18 项）、AI_CONTEXT 待办。
|
|
||||||
> 答复到齐前，各模块按清单内「建议默认」执行；答复与默认不同时以答复为准。
|
|
||||||
> **2026-10-19 更新**：业务答复落实批次与 M3 code-review 修复已落地（见各节标注）；T+ 清单已升 v1.4。
|
|
||||||
> **2026-10-20 更新**：开发计划 3.3 已回填（3.3.1），SRS V2.1 已交付；二次分摊已按开发侧暂定口径实现（#1–#3 答复仍空白）；code-review 遗留 2 项（方案版本承载、审批单内容快照）已随 V11 迁移收口。
|
|
||||||
|
|
||||||
## 一、立即待办（需项目内处理）
|
|
||||||
|
|
||||||
| # | 事项 | 状态 | 下一步动作 |
|
|
||||||
| --- | --- | --- | --- |
|
|
||||||
| 1 | **推送 feat/m3-increments** | ✅ 已完成（2026-10-19） | 远端 Git 服务恢复后已推送，远端现为 e48cfb7（含 code-review 修复 4 提交 + #14 首日口径 + V8 系列 + 测试/文档）；并行会话（88：calc_service 分摊拆行）收口后继续推送其后提交 |
|
|
||||||
| 2 | **M2 分支合并 main** | 未开始 | feat/base-business-data（M2 全部 + code-review 32 条修复）尚未合入 main；与 #1 一并处理（PR 评审或本地合并） |
|
|
||||||
|
|
||||||
## 二、业务方澄清（24 项，**2026-10-16 答复已到**，回执见《待澄清问题清单_2026-10-15(1)(2).xlsx》H 列）
|
|
||||||
|
|
||||||
> 答复汇总：**13 项确认按默认执行**（#7/#8/#9/#10/#11/#13/#15/#17/#18/#21/#22/#23/#24，其中 #22 为模糊确认、按不计入）；**4 项答复与默认不同，以答复为准**——#5 二次分配审批开关**默认开启**、#14 **首日整 10‰**、#16 试用期基本工资**按人员档案逐人维护**、#19 备份**加增量补充**；部分答复 3 项（#4/#6/#12），仍开放 4 项（#1–#3/#20）。开发计划 3.3 已于 2026-10-20 回填（3.3.1），未答复项仍按催办清单跟进。
|
|
||||||
|
|
||||||
### 高优先级（阻塞对应模块开工，8 项）
|
|
||||||
|
|
||||||
| 清单编号 | 问题 | 建议默认（未答复时执行） | 阻塞模块 | 答复状态 |
|
|
||||||
| --- | --- | --- | --- | --- |
|
|
||||||
| 1 | 二次分配的分配标的：绩效金额、折算毛利润还是业绩额？ | 方案录入已交付；2026-10-19 已按开发侧暂定口径实现分摊拆行（非业务答复，答复后校准） | ④ 分摊计算 | ❌ 未答复 |
|
|
||||||
| 2 | 分配比例合计不足 100% 时余额归谁？ | 余额归合同负责营销人员（仅展示不落库） | ④ 分摊计算 | ❌ 未答复 |
|
|
||||||
| 3 | 二次分配与已作废的「协助 25% 分成」是什么关系？ | 独立新机制；协助仍仅记录不核算 | ④ | ❌ 未答复 |
|
|
||||||
| 4 | 二次分配方案的修改窗口与权限？ | 首次月结前可改（留痕），月结后只读走调整单 | ③/④ | ⚠️ 部分：「暂定可改走调整单」，窗口/权限未定；分摊已于 2026-10-19 实现（ccfd206） |
|
|
||||||
| 6 | 营销后勤/财务/领导的角色权限清单（可见菜单/可操作点）？ | 最小授权：后勤=提交录入，财务=复核+导出，领导=审核只读 | ⑦ / permissions 激活 | ⚠️ 部分：「先预设角色」，名称与职权待客户确认；**#17 参数查看放开已落实（2026-10-19）** |
|
|
||||||
| 8 | 回款何时算「确认回款」？ | 需人工确认动作（系统已按此预留） | ④ 月结取数 | ✅ 确认：人工确认，可手动关闭 |
|
|
||||||
| 9 | 调整单是否走同一审批链？能否跨月调整已锁月份？ | 同一审批链；后续月份扣补为默认路径 | ④/⑦ | ✅ 确认默认；跨月需管理员授权并留痕 |
|
|
||||||
| 12 | **经理个人户业绩是否计入其 12.5% 基数？（无默认，必须答复）** | —— | ④ 台账表结构设计 | ✅ **已落实为参数（2026-10-19）**：答复「做参数可调、初始值未给」→ 按默认 0=不计入落地（`manager.personal.included`），可手工调 1=计入 |
|
|
||||||
|
|
||||||
### 中优先级（模块实现期内答复即可，9 项）
|
|
||||||
|
|
||||||
| 清单编号 | 问题 | 答复状态（2026-10-16） |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 5 | 二次分配审批开关默认值？ | ✅ 已落实（2026-10-19，V8）：默认开启 + 当日生效行；调整单/二次分配/月结三类审批开关均已可读可调 |
|
|
||||||
| 7 | 月度结算审批链默认开还是关？ | ✅ 已落实（2026-10-19，V8）：默认开启；财务节点通过仅流转，终审（领导）通过才锁定月结 |
|
|
||||||
| 10 | 「风险预警」包含哪些情形与阈值？ | ✅ 方向确认：参数化；首批三条（逾期 90 天/同步失败/超时 3 天）未点名，按默认起步 |
|
|
||||||
| 11 | 「待办事项」范围？ | ✅ 确认：待审批+同步失败+回款未指定批次起步 |
|
|
||||||
| 13 | 支付环节 5 项默认值顺手确认（起付 60%/R×R/预付 10‰/抵顶 80%/月工资口径） | ✅ 确认按默认执行 |
|
|
||||||
| 15 | 支付权重「余额模式」是否需要？ | ✅ 一期只用 FULL |
|
|
||||||
| 16 | 试用期基本工资（3000 元）是统一参数还是逐人维护？ | ✅ 已落实（2026-10-19，V8）：撤销 `probation.salary.basic` 参数，基本工资读 `personnel.salary_standard` |
|
|
||||||
| 20 | 含税口径：毛利/运费/价税合计是否含税？ | ❌ 未答复：「需与客户再次确认具体计算方式」 |
|
|
||||||
| 22 | 预收款/保证金/代收款是否计入绩效回款？ | ⚠️ 模糊答复：「当前未提到预收款情况」，暂按不计入 |
|
|
||||||
|
|
||||||
### 低优先级（已有默认口径，顺手确认，7 项）
|
|
||||||
|
|
||||||
| 清单编号 | 问题 | 答复状态（2026-10-16） |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 14 | 需规图示「第 1 天 10‰」与公式不一致，是否认可按公式？ | ✅ 已落实（2026-10-19，按 A 口径）：首日整 10‰ 特判、次日起按公式（保「360 天=6‰」锚点）；B 口径（整体平移）追问保留 |
|
|
||||||
| 17 | 计提参数等敏感配置普通用户可否查看？ | ✅ 已落实（2026-10-19）：查看放开登录用户、修改仅管理员 |
|
|
||||||
| 18 | 企业户 02-17 之前的业务是否按 2‰ 回溯？ | ✅ 确认按回溯 |
|
|
||||||
| 19 | 备份保留周期与恢复目标？ | ✅ 已落实（2026-10-19）：全量 + binlog 增量归档补位 |
|
|
||||||
| 21 | 退货/红字是否冲减绩效？ | ✅ 当期冲减（未结算月），已结算走调整单 |
|
|
||||||
| 23 | 回款按到账金额还是扣手续费净额？ | ✅ 按到账金额 |
|
|
||||||
| 24 | 「首期不生成负绩效」与裁决「负绩效不归零」冲突，以哪个为准？ | ✅ 维持裁决：负数照算不归零、月结支持扣补（业务补注：按当前算法首期不会出现负绩效） |
|
|
||||||
|
|
||||||
## 三、待 IT / T+ 侧答复（18 项 → 收敛为 13 项 + 1 组业务裁决）
|
|
||||||
|
|
||||||
> **2026-10-20 更新**：T+12.3 数据字典已解析（1,457 页 / 931 张表 / 21,019 个字段），字段级映射已产出：`docs/T+字段映射草案_v0.1_2026-10-20.md`、`docs/T+对接数据需求清单_v1.5_2026-10-20.xlsx`。原 18 项收敛为 13 项 IT 待确认（每项附字典候选字段）+ 1 组业务裁决，详见催办清单第二节与 v1.5「待IT确认事项」sheet。以下原表保留为 2026-10-19 基线。
|
|
||||||
> **2026-10-19 清单已升 v1.4**（`docs/T+对接数据需求清单_v1.4_2026-10-19.xlsx`，七节：人员/产品/业务单据/发货单/回款单/客户档案/同步完整性与补充字段）——本节口径待收编到 v1.4 后再对外；待 IT 逐项确认的状态以最新版文件为准。
|
|
||||||
> **2026-10-16 业务方已对「口径与用途说明」修订，已收编清单升 v1.3**：#18 回款↔发货批次定稿**人工指定**（T+ 核销关系仅作辅助，`shipment_id` 保持「同步不覆盖」，v1.2.1「T+ 主源」修订作废，M2 回款页现状不动）；「确认回款」两处 #8 开放引用收敛；特殊业务标记待确认降为低优。
|
|
||||||
> **新增追问 2 条**（随下一轮回执发业务方）：① 「负责营销人员」口径被改为「人员编码**以姓名**为唯一识别」，与「编码是业绩归属唯一锚点（防重名错钱）」矛盾，疑笔误；② 数据清单回款「关联订单号」仍写「由 T+ 收款分配关系指定，人工辅助」，与不覆盖表「人工指定」主次相反，疑漏改。
|
|
||||||
|
|
||||||
### 高优先级（8 项）
|
|
||||||
|
|
||||||
| # | 事项 |
|
|
||||||
| --- | --- |
|
|
||||||
| 1 | **成本额取数口径**（阻塞核算：成本类型/毛利计算方式/更新时间/精度） |
|
|
||||||
| 2 | 发货日期口径（出库日/签收日） |
|
|
||||||
| 3 | 到账日期口径（银行到账日/核销日） |
|
|
||||||
| 4 | 幂等唯一键规则（作废重开是否换号） |
|
|
||||||
| 5 | 三单关联键（订单/发货/回款如何关联） |
|
|
||||||
| 6 | **人员唯一编码（工号）+ 业务员↔经理隶属**（隶属已列必须；识别口径疑笔误见上方追问①） |
|
|
||||||
| 7 | 对接方式与安全（REST/视图/中间表/文件） |
|
|
||||||
| 8 | 负数/红字/退货/冲销处理规则与原单关联 |
|
|
||||||
| 16 | 回款确认/核销状态字段与枚举 |
|
|
||||||
|
|
||||||
### 中低优先级（9 项）
|
|
||||||
|
|
||||||
存量起始日期与增量口径、客户档案匹配与唯一键、收款方式枚举清单、产品「数量」语义、发货单价口径、特殊业务标记字段、同步窗口时间、市场拓展计划数据、口径裁决 5 项（#20–#24 已转业务方）。
|
|
||||||
|
|
||||||
## 四、开发里程碑待办
|
|
||||||
|
|
||||||
| 里程碑 | 内容 | 前置条件 |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| M3 剩余 | ✅ ④ 核算引擎 + 月结/调整单 + ⑦ 月结审批对象已完成（2026-10-17 M3-core）；**2026-10-19** 业务答复落实批次（首日 10‰/审批开关默认/试用期参数/增量备份/参数查看放开/经理基数开关）与 code-review 21 项修复已落地；二次分摊已按开发侧暂定口径实现（ccfd206），业务答复回填已完成（计划 3.3.1，2026-10-20）；**余**：#1–#3/#20 答复与 #4/#6/#12 补值 | #20（含税口径）、#1–#3 答复后按同粒度推进 |
|
|
||||||
| M4 | ⑤ 报表（签字导出模板）+ ⑧ 工作台 | ④ 已交付；报表口径确认后启动 |
|
|
||||||
| M4（并行） | ⑥ T+ 数据同步 | IT 答复字段映射后 |
|
|
||||||
| code-review 遗留 2 项 | ✅ **已完成（2026-10-20，V11）**：方案行 append-only 版本化（is_active/version_no）；审批单加版本号与 JSON 内容快照，详情按 snapshot/live/missing 展示 | — |
|
|
||||||
| 杂项收口（低优） | 超长函数收敛：calc_receipt 与 settlement_service（生成/聚合/调整单）已拆（2026-10-19）；剩 preview/change_ownership/create_receipt/update_receipt 等；散参数 66 处封装、useDropdownOptions 余两页 | 触碰时顺手 |
|
|
||||||
|
|
||||||
## 五、文档待办（低优）
|
|
||||||
|
|
||||||
- 需规过时条款未修订（26 天示例、含运费公式、协助 25%）；2026-10-15 补充需求未回填需规——对外引用需规前须先修订或注明以对照表/计划第三章为准
|
|
||||||
- 澄清答复已到（2026-10-16）：开发计划 3.3 已回填（3.3.1，2026-10-20）、SRS V2.1 已交付（2026-10-19）；《T+对接数据需求清单》已升 **v1.5**（2026-10-20，含 75 项映射 + 13 项 IT 收敛 + 不覆盖 12 条），映射草案 v0.1 已产出
|
|
||||||
- ~~新口径待落实（业务答复与默认不同的 4 项）~~ ✅ **已全部落实（2026-10-19，见第二节标注）**
|
|
||||||
- **修复批次引入口径记录（2026-10-19，供业务知会）**：月结的经理聚合与月工资口径按**所属月月末**取参（单笔台账行仍按回款日取参，裁决 #11）——补生成历史月份时结果不随生成日漂移；如业务对月末时点有异议，改 `settlement_service._month_end` 单点即可
|
|
||||||
74
docs/权限管理使用与开发记录_2026-11-02.md
Normal file
74
docs/权限管理使用与开发记录_2026-11-02.md
Normal file
@ -0,0 +1,74 @@
|
|||||||
|
# 权限管理使用与开发记录
|
||||||
|
|
||||||
|
日期：2026-11-02。当前采用用户后续明确选择的“按角色授权，取消单独绑定”。此前“角色＋个人允许／禁止、全局制作人绑定”的方案已被替代，旧测试结果只作历史证据。
|
||||||
|
|
||||||
|
## 管理员如何操作
|
||||||
|
|
||||||
|
1. 进入“系统管理 → 角色管理”，点击“新增角色”，在同一抽屉填写编码、名称等资料并勾选功能权限，直接点击“创建角色并保存权限”，无需填写修改原因。后台自动记录创建及初始授权，失败不会留下半成品角色。
|
||||||
|
2. 修改已有角色时点击“配置权限”，在左侧选择业务分组，右侧按模块勾选操作；支持搜索、模块全选／半选和复制已有角色。
|
||||||
|
3. 核对新增／撤销数量，填写修改原因，点击“保存角色权限”。点击灰色遮罩、关闭或取消均可退出；有未保存的资料或权限调整时，先选择“放弃修改”或“继续编辑”，保存期间禁止关闭。
|
||||||
|
4. 进入“系统管理 → 用户管理”，在用户行点击“分配角色”，选择一个或多个角色。
|
||||||
|
5. 核对只读的继承权限预览，填写原因并保存。用户自动继承所选启用角色的权限。
|
||||||
|
|
||||||
|
管理员角色固定拥有全部功能权限，面板只供查看；普通角色不能获得管理员专用的授权管理能力。营销人员的“计提岗位”只参与业务规则，与登录账号的系统角色分开维护。
|
||||||
|
|
||||||
|
用户页面不再逐项设置个人允许／禁止，也不需要进入另一个页面指定工资制作人。旧授权页跳转角色管理，旧制作人写接口拒绝写入并说明新的操作路径。
|
||||||
|
|
||||||
|
## 生效与业务限制
|
||||||
|
|
||||||
|
最终权限是启用角色权限的并集。没有授权即拒绝；新增、编辑、删除、导出等动作还须有对应模块的查看权限。停用角色立即停止其授权，重新启用后恢复。账号停用、旧会话及直接调用接口均受后端校验。
|
||||||
|
|
||||||
|
- 人员、区域、计划、产品、客户和普通业务按功能权限操作，管理员不会因未绑定工资制作人而被禁用。
|
||||||
|
- 工资资料、核算、分配、生成和调整按各自权限操作；可由多个获授权账号办理，无全局唯一账号绑定。
|
||||||
|
- 每次实际经办人继续留痕。已生成工资的月份锁定、历史快照保护、调整单生成当月归属不变，角色授权不能解除这些规则。
|
||||||
|
- 财务复核和领导审核分别检查节点权限、当前节点及审批开关。审批默认关闭，关闭时仍可查看已授权的历史记录。
|
||||||
|
- T+ 源读取开关和只读连接仍单独校验。授予权限不会启用采集；已有本地账套和快照可用于授权范围内的资料维护、预览与导入。
|
||||||
|
|
||||||
|
授权变更无需重新登录。后端每次请求读取数据库有效权限；当前页面保存后刷新会话，其他页面在切页、窗口激活和可见状态每 30 秒检查时更新。收到 403 后刷新权限并提示原因，不自动重试写操作。
|
||||||
|
|
||||||
|
详情与历史在具备查看权限时保持可用；编辑按钮显示不可用原因，只读抽屉不再提示用户添加。没有任何页面权限的账号进入“暂无可访问功能”。表单参照使用受控元数据，仅返回选择所需字段。
|
||||||
|
|
||||||
|
页面切换和组件反馈保留轻动效，支持系统“减少动态效果”。新权限面板按模块集中展示操作，窄屏保持抽屉内滚动。
|
||||||
|
|
||||||
|
## 接口与迁移
|
||||||
|
|
||||||
|
沿用 `/api/v1` 及现有响应格式。
|
||||||
|
|
||||||
|
| 接口 | 用途 |
|
||||||
|
| --- | --- |
|
||||||
|
| `GET /system/permissions/catalog` | 代码维护的权限目录 |
|
||||||
|
| `GET/PUT /system/roles/{id}/permissions` | 查看／保存角色权限 |
|
||||||
|
| `GET/PUT /system/users/{id}/authorization` | 查看／保存用户角色分配 |
|
||||||
|
| `POST /system/users/{id}/authorization/preview` | 预览角色继承结果及差异 |
|
||||||
|
| `GET /system/authorization-settings` | 兼容查询，返回 `mode=roles`，无制作人绑定 |
|
||||||
|
| `PUT /system/authorization-settings` | 拒绝旧绑定写入，提示改用角色授权 |
|
||||||
|
| `GET /meta/options` | 按业务授权的最小字段参照 |
|
||||||
|
| `GET /meta/payroll-input/{business_id}` | 工资准备所需参照 |
|
||||||
|
|
||||||
|
修改已有角色权限或用户角色分配时，保存须携带 `expected_revision` 和非空 `reason`；冲突返回 HTTP 409，不覆盖已有结果。旧个人覆盖载荷被拒绝，不会静默忽略。`/auth/me` 保留兼容字段，有效权限由数据库角色解析，`maker_required_permissions` 为空。
|
||||||
|
|
||||||
|
新建接口 `POST /system/roles` 可同时携带 `permission_codes`，不需要分两次请求创建及授权，也不要求提供 `reason`；后台自动记录“创建角色并配置初始权限”。旧客户端传入非空原因仍受支持；新建复用后续权限配置的未知码、重复码、管理员专用项和查看依赖校验。前端 `createRole({role_code: 'region_editor', role_name: '区域维护员', permission_codes: ['base:personnel:view', 'base:personnel:regions']})` 即可一次提交。
|
||||||
|
|
||||||
|
全局确认框保留组件默认宽度上限（420 像素），手机端限制为屏幕宽度减 32 像素，避免“放弃未保存修改”、禁用／删除确认等在大屏被拉成整行；长名称正常换行。该限制只作用于轻量确认框，不缩窄业务表单和权限抽屉。
|
||||||
|
|
||||||
|
V22 建立授权设置与原个人覆盖结构，V25 接入监控权限，V26 将日常授权归一到角色，保留旧表与工资历史。V26 发现存量个人覆盖时拒绝升级，须先整理为等效角色；迁移不静默丢弃既有个人授权。回退不猜测重新绑定哪个账号，旧应用需要管理员重新指定。隔离库已完成 V26 升级、降级与再升级。本地开发库也已在完整备份后升级到 V26（`26e7f8a9b0c1`）：旧授权入口停用、全局制作人引用为空、默认工资角色更新为“工资经办”、个人覆盖为 0。迁移前备份为 `.ai/role-auth-before-v26-20261102-173901.sql.gz`，SHA-256 `ed473db828140a2d64592f7b781d6a780d0015d38386f93fea15bc5d549883f1`。迁移后另有并行验收数据继续变化，未做清理；最终核验见 `.ai/role-auth-v26-dev-result.json`。
|
||||||
|
|
||||||
|
授权保存、角色停用和用户角色修改使用同一授权设置行锁；当前管理员自我保护、最后一个启用管理员及并发撤权保护继续生效。审计保留操作人、目标、差异与原因，失败授权也有记录。排队任务在执行前重新检查账号和权限，撤权时记录 `TASK_AUTHORIZATION_REVOKED`。
|
||||||
|
|
||||||
|
## 本轮验证
|
||||||
|
|
||||||
|
- 最新补充：移除新增修改原因后，31 项相关单元、6 项隔离 MySQL 初始授权回归通过，自动审计仍保留权限明细；类型／构建／Ruff 通过。8 项真实浏览器检查验证无原因直接创建、失败保留输入、遮罩保护，以及两类确认框在 2560／1440／768／375／320 宽度的布局。证据 `.ai/role-create-no-reason/result.json`、`.ai/role-create-no-reason-integration.log`；下面上一轮“原因必填”是当时历史规则，已被本条替代。
|
||||||
|
- 遮罩与新建授权修复：31 项相关单元、31 项隔离 MySQL 集成通过，含权限落库失败时角色与授权版本共同回滚。类型检查、生产构建、Ruff 通过。开发模式和固定生产构建分别完成 6 项真实无模拟接口浏览器检查，页面错误／服务端失败 0；覆盖遮罩直接关闭、未保存提醒、同页创建授权、768 宽保存、重复编码失败保留输入。结果分别见 `.ai/role-create-ui-dev/result.json`、`.ai/role-create-ui/result.json`；集成日志 `.ai/role-create-permissions-integration.log`。
|
||||||
|
- 最新角色方案完整单元：**893 passed**，`.ai/authorization-role-unit-final.log`。
|
||||||
|
- 隔离 MySQL 定点复验：**31 passed**，覆盖授权、参数查看、旧核算准入和结构同步；`.ai/authorization-current-recheck.log`。
|
||||||
|
- 工资、审核、月结、T+ 工作区：**52 passed**；`.ai/authorization-role-sensitive.log`。两组共 83 项，无重叠。
|
||||||
|
- 修正测试准备与新规则不一致：人员创建补必填计提岗位；普通账号通过角色取得参数查看权限；未授权角色被拒绝，其他管理员按角色权限核算，无需绑定。
|
||||||
|
- API 路由覆盖检查包含于单元测试，递归枚举实际业务路由并断言数量，避免空枚举假通过。后台任务撤权、版本冲突、并发管理员保护及失败审计包含于隔离授权测试。
|
||||||
|
- Ruff、前端类型检查与 Vite 生产构建通过，既有 Starlette 弃用和大分块提醒保留。
|
||||||
|
- 四类账号真实 Edge 联调 **6 项通过**，不模拟接口：管理员区域保存、只读详情、角色授权与撤权、用户分配工资角色、768 像素布局、减少动态效果。页面异常和服务端失败为 0；独立前后台及隔离库，不改原业务账号。结果 `.ai/authorization-role-real/result.json`，截图同目录。
|
||||||
|
- 并行任务另有 5 组合成响应的面板交互测试，`.ai/rbac-browser-result.json`；不与上述真实联调混称。
|
||||||
|
- 早先完整集成为 420 passed / 4 failed，发生在角色方案切换期间；失败点已在上述复验覆盖通过，未将旧全量记录改写为当前一次性全量全绿。
|
||||||
|
|
||||||
|
最终当前复核：完整单元 **916 passed**；隔离 MySQL 定点回归 **41 passed**（角色授权、结构同步、工资准入）；前端类型检查、生产构建、Ruff、差异空白检查、设计检测和 5 组合成面板场景通过。本地开发库 V26 已应用并核验；并行本地验收数据继续存在，未清理。
|
||||||
|
|
||||||
|
本聊天未操作生产、未启用源自动采集、未生成真实工资、未 commit/push。权限功能验证不替代客户金额和目标环境验收；后续若继续修改权限代码，需要对相应变更补验。
|
||||||
116
docs/样本核对包_2026-10-30/materials-9395-2026-03.json
Normal file
116
docs/样本核对包_2026-10-30/materials-9395-2026-03.json
Normal file
@ -0,0 +1,116 @@
|
|||||||
|
{
|
||||||
|
"customer_id": 9395,
|
||||||
|
"month": "2026-03",
|
||||||
|
"captured_at": "2026-10-30T17:06:35.954479",
|
||||||
|
"source_read_only": true,
|
||||||
|
"formal_payroll_written": false,
|
||||||
|
"found": {
|
||||||
|
"customer": 1,
|
||||||
|
"shipments": 1,
|
||||||
|
"items": 1,
|
||||||
|
"receipts": 1,
|
||||||
|
"opening": 0,
|
||||||
|
"history": 0,
|
||||||
|
"expenses": 0
|
||||||
|
},
|
||||||
|
"opening_candidate": "0.00",
|
||||||
|
"opening_confirmed": false,
|
||||||
|
"opening_explanation": "未查到初始化及切换日前应收记录，仅作为候选零余额依据",
|
||||||
|
"truncated": [],
|
||||||
|
"ready_for_amount": false,
|
||||||
|
"missing": [
|
||||||
|
{
|
||||||
|
"key": "GUIDANCE",
|
||||||
|
"title": "发货月份人工指导成本",
|
||||||
|
"reason": "T+成本不用于绩效，需填写并封存人工指导成本"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "PRODUCT_CATEGORY",
|
||||||
|
"title": "产品绩效核算分类",
|
||||||
|
"reason": "源产品分类不等于市政水利／轨道交通核算分类"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "HISTORICAL_PAYROLL",
|
||||||
|
"title": "样本是否已在旧软件核算或发放",
|
||||||
|
"reason": "源应收及收款记录不能证明绩效已发放"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "MANAGER_HANDOVER",
|
||||||
|
"title": "样本当时的分管及交接依据",
|
||||||
|
"reason": "保留源业务员工号，不按当前部门推断历史经理或接手人"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "CUSTOMER_CATEGORY",
|
||||||
|
"title": "客户绩效分类",
|
||||||
|
"reason": "源客户绩效属性为空"
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"key": "FREIGHT",
|
||||||
|
"title": "该批发货运费是否已剔除",
|
||||||
|
"reason": "费用表和金额仅作证据，缺少关联或空值不自动等于零运费"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"evidence": {
|
||||||
|
"customer": [
|
||||||
|
{
|
||||||
|
"id": 9395,
|
||||||
|
"code": "0060201",
|
||||||
|
"name": "辽阳精诚物业管理有限公司",
|
||||||
|
"partnerType": 211,
|
||||||
|
"customerType": null,
|
||||||
|
"idsaleman": 47,
|
||||||
|
"disabled": 0
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"shipments": [
|
||||||
|
{
|
||||||
|
"id": 102447,
|
||||||
|
"code": "SA-2026-03-0034",
|
||||||
|
"voucherdate": "2026-03-05 00:00:00",
|
||||||
|
"idclerk": 47,
|
||||||
|
"personnel_code": "010110",
|
||||||
|
"SaleOrderCode": "SO-2026-03-0014",
|
||||||
|
"taxAmount": "1125.00000000000000",
|
||||||
|
"voucherState": 189,
|
||||||
|
"isCounteractDelivery": 0
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"id": 392858,
|
||||||
|
"idSaleDeliveryDTO": 102447,
|
||||||
|
"idinventory": 32584,
|
||||||
|
"product_code": "02020276",
|
||||||
|
"product_name": "承插口排水管",
|
||||||
|
"specification": "GIIΦ300*2500",
|
||||||
|
"source_class": "GII级",
|
||||||
|
"quantity": "10.00000000000000",
|
||||||
|
"taxPrice": "112.50000000000000",
|
||||||
|
"taxAmount": "1125.00000000000000",
|
||||||
|
"expenseAmount": null,
|
||||||
|
"costPrice": null,
|
||||||
|
"costAmount": "0E-14"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"receipts": [
|
||||||
|
{
|
||||||
|
"id": 18590,
|
||||||
|
"code": "SK-2026-03-0016",
|
||||||
|
"voucherDate": "2026-03-18 00:00:00",
|
||||||
|
"idperson": 47,
|
||||||
|
"personnel_code": "010110",
|
||||||
|
"amount": "1125.00000000000000",
|
||||||
|
"isReceiveFlag": 1,
|
||||||
|
"voucherstate": 189,
|
||||||
|
"accounting_voucher_code": "0035",
|
||||||
|
"isinvalidate": 0,
|
||||||
|
"accounting_state": "Ringht"
|
||||||
|
}
|
||||||
|
],
|
||||||
|
"opening": [],
|
||||||
|
"history": [],
|
||||||
|
"expenses": []
|
||||||
|
},
|
||||||
|
"evidence_hash": "222bb0f5cda61f7c2a69286e28ca368da03fcddead9e814a876158626f6da2e6",
|
||||||
|
"customer_reply": "2026-10-30 用户明确回复没有该样本的人工指导成本资料。金额验收保持待补，不重复索要同一资料，不使用 T+ 成本或零成本替代。"
|
||||||
|
}
|
||||||
51
docs/样本核对包_2026-10-30/materials-9395-2026-03.md
Normal file
51
docs/样本核对包_2026-10-30/materials-9395-2026-03.md
Normal file
@ -0,0 +1,51 @@
|
|||||||
|
# 样本资料核对：辽阳精诚物业管理有限公司（2026-03）
|
||||||
|
|
||||||
|
核对时间：2026-10-30T17:06:35.954479。源库只读；未写入正式工资。
|
||||||
|
|
||||||
|
## 已从恢复库整理
|
||||||
|
|
||||||
|
| 类别 | 数量 |
|
||||||
|
|---|---:|
|
||||||
|
| 客户 | 1 |
|
||||||
|
| 发货单 | 1 |
|
||||||
|
| 发货明细 | 1 |
|
||||||
|
| 回款凭证关联行 | 1 |
|
||||||
|
| 初始化应收 | 0 |
|
||||||
|
| 切换日前应收分组 | 0 |
|
||||||
|
| 销售费用分摊 | 0 |
|
||||||
|
|
||||||
|
## 单据与归属
|
||||||
|
|
||||||
|
| 发货单 | 日期 | 含税金额 | 业务员工号 |
|
||||||
|
|---|---|---:|---|
|
||||||
|
| SA-2026-03-0034 | 2026-03-05 | 1,125.00 | 010110 |
|
||||||
|
|
||||||
|
| 产品代码 | 品名／规格 | 数量 | 含税单价 | 含税金额 | 运费 |
|
||||||
|
|---|---|---:|---:|---:|---:|
|
||||||
|
| 02020276 | 承插口排水管 GIIΦ300*2500 | 10.00000000000000 | 112.50 | 1,125.00 | 待核对 |
|
||||||
|
|
||||||
|
| 回款单 | 日期 | 金额 | 总账凭证 |
|
||||||
|
|---|---|---:|---|
|
||||||
|
| SK-2026-03-0016 | 2026-03-18 | 1,125.00 | 0035 |
|
||||||
|
|
||||||
|
## 可推导但尚未确认
|
||||||
|
|
||||||
|
未查到初始化及切换日前应收记录，仅作为候选零余额依据
|
||||||
|
候选期初余额：0.00。本报告不自动确认期初余额。
|
||||||
|
|
||||||
|
## 仅需补充的资料
|
||||||
|
|
||||||
|
- 发货月份人工指导成本：T+成本不用于绩效，需填写并封存人工指导成本。
|
||||||
|
- 产品绩效核算分类：源产品分类不等于市政水利／轨道交通核算分类。
|
||||||
|
- 样本是否已在旧软件核算或发放：源应收及收款记录不能证明绩效已发放。
|
||||||
|
- 样本当时的分管及交接依据：保留源业务员工号，不按当前部门推断历史经理或接手人。
|
||||||
|
- 客户绩效分类：源客户绩效属性为空。
|
||||||
|
- 该批发货运费是否已剔除：费用表和金额仅作证据，缺少关联或空值不自动等于零运费。
|
||||||
|
|
||||||
|
## 本轮补充回复
|
||||||
|
|
||||||
|
2026-10-30 用户明确回复没有该样本的人工指导成本资料。金额验收保持待补，不重复索要同一资料，不使用 T+ 成本或零成本替代。
|
||||||
|
|
||||||
|
指导成本、分类或关键依据缺失，实际工资金额尚未验收，不填默认值。
|
||||||
|
|
||||||
|
证据指纹：`222bb0f5cda61f7c2a69286e28ca368da03fcddead9e814a876158626f6da2e6`
|
||||||
Binary file not shown.
@ -1,82 +0,0 @@
|
|||||||
# 正式工资闭环开发记录
|
|
||||||
|
|
||||||
日期：2026-10-30。按用户批准的四阶段计划实施；保留此前未提交内容，不提交或推送。真实客户金额验收与开发测试分别记录。
|
|
||||||
|
|
||||||
## 当前实现
|
|
||||||
|
|
||||||
- `PAYROLL_MAKER_USER_ID` 绑定现有指定账号。未配置时关闭业务写入；岗位和管理员身份不代替实际制作人。登录响应返回 `can_write_payroll`，页面同步禁用写按钮。工资台账、月结和调整单查询必须登录。
|
|
||||||
- `payroll_months` 独立记录首次生成时间和实际制作人。月结草稿首次成功生成即锁定分配，失败事务回滚；退回审批和重新生成不解锁。
|
|
||||||
- `payroll_inputs` 追加保存正式输入版本；`payroll_allocations` 保存逐段回款、发货、指导成本、原始参数、受益人员、分管及应付差额。预演不直接升级为工资。
|
|
||||||
- 新增正式导入预览／执行任务，沿用 worker 和稳定源关联；源／事实／目标变化使旧预览失效。只允许追加新单据和事实版本，旧单据金额或日期变化形成冲突，不静默覆盖。
|
|
||||||
- 正式FIFO共享已有分配内核；保留期初先冲、预收待实际发货、60%起付和平方权重，累计应付减去历史已计入应付。重算按月份顺序重建尚未生成工资的后续月份；已生成工资走当月调整。
|
|
||||||
- 正式分管取核算时固化事实，支持同一业务员的不同业务由不同经理分管；离职承接未发部分，经理本人业务排除。新核算不消费旧任意比例／负责人余额方案，旧方案仅历史查看。
|
|
||||||
- 调整单增加类型、原台账和业务分管快照。分配调整与通用新调整的服务层统一将月份设为生成当月，不接受客户端回写历史工资月份；旧引擎兼容测试显式启用旧月份行为。
|
|
||||||
- 备份脚本停止按30天自动删除归档文件；本轮未执行备份清理或恢复。
|
|
||||||
|
|
||||||
## 新回执修订
|
|
||||||
|
|
||||||
详见 `客户补充回执核对_2026-10-30.md`。
|
|
||||||
|
|
||||||
1. 同一 T+ 发货客户名头合并平账，不按合同数量分组。正式源数据使用账套内稳定客户身份聚合，导入时自动纳入该客户截至所选月的发货／回款，保留逐次发货的人员、分管及交接依据。
|
|
||||||
2. 指导成本固定取发货月份。资料录入完成后显式封存，后续回款或重算不改变原发货月份指导成本。历史回款月取价开关不再影响正式口径。
|
|
||||||
3. 一正一负更正单排除绩效、跨客户回款归入原业务的示例已确认并实现；多原单金额分配与通用日期依据仍只阻塞对应特殊分支。
|
|
||||||
4. 保证金、代收款回复“不涉及”，不新增相应计提。
|
|
||||||
5. 第05项已由用户及后续截图澄清：审核能力保留，默认关闭。`PAYROLL_APPROVAL_ENABLED=false` 时生成工资即完成，不创建审批单、审批步骤或自动通过痕迹；需要时可显式开启原财务／领导流程，仍受各审批对象参数控制。与旧核算引擎兼容开关独立。
|
|
||||||
|
|
||||||
## 接口与调用
|
|
||||||
|
|
||||||
正式导入继续调用 `POST /api/v1/system/tplus/work-runs`：
|
|
||||||
|
|
||||||
```json
|
|
||||||
{"kind":"BUSINESS_PREVIEW","request_key":"<本次意图的UUID>","month":"2026-03","group_keys":["<客户平账资料标识>"]}
|
|
||||||
```
|
|
||||||
|
|
||||||
预览完成后以 `BUSINESS_APPLY`、同次预览的 `preview_no` 和新意图UUID执行。网络重试复用同一请求键。人员、产品、客户基础导入须先完成，缺数据行保留待补。
|
|
||||||
|
|
||||||
人工核算准备：`POST /api/v1/payroll/businesses/{id}/input`，明确 `month`、`expected_version`、`evidence`、`opening_balance`、`history_confirmed=true`、`guidance_finalized=true`，并逐条提供 `shipment_ownerships` 中的发货明细ID、业务员、经理、含税单位指导成本。归属变动和离职交接使用版本化事实；不按当前人员直属关系推算历史。
|
|
||||||
|
|
||||||
正式计算：`POST /api/v1/payroll/businesses/{id}/calculate`，请求 `{"month":"2026-03"}`；重算增加非空 `reason`，返回受影响的 `recalculated_months`。页面调用见 `frontend/src/api/payroll.ts`，业务列表提供正式核算入口。
|
|
||||||
|
|
||||||
查询：`GET /api/v1/payroll/months/{month}`、`/businesses/{id}/input`、`/ledger/{id}/allocations`；分配调整：`POST /api/v1/payroll/allocation-adjustments`，必须关联已生成工资的原台账，月份由服务端确定。
|
|
||||||
|
|
||||||
## 迁移与验证
|
|
||||||
|
|
||||||
- V18：正式输入、分配明细、生成锁与FIFO事件唯一键。替换台账唯一索引前先建立回款外键支撑索引。
|
|
||||||
- V19：调整类型、原台账和分管快照。模型、Alembic、迁移SQL与开发初始化同步；已有正式结果时拒绝破坏性结构回退，应回退应用版本并保留数据。
|
|
||||||
- 集成测试入口：`python scripts/run_isolated_tests.py`；校验测试库名称、显式授权标记及真实引擎URL。运行器新建独立数据库及受限测试账号，凭据只经环境传入，不输出、不写源文件。
|
|
||||||
- 已有本轮证据：单元746项通过；正式链路5项MySQL通过；V18空库升级／回退／再升级通过。新回执修订后的最终完整回归、V19结构、最终浏览器与构建结果待末次运行回填，不提前记为全部通过。
|
|
||||||
|
|
||||||
## 尚未完成的交付条件
|
|
||||||
|
|
||||||
真实样本仍需核实分类、成本、期初及历史已处理金额，不填默认值。当前未对原开发业务库或生产库执行迁移，未绑定实际生产制作人、未生成真实工资。SQL Server2008R2兼容、每周同步、服务托管、告警和目标环境全量／增量恢复演练仍保留后续任务。实际资金支付属于财务系统范围。
|
|
||||||
|
|
||||||
## 本轮最终验证证据
|
|
||||||
|
|
||||||
- 完整单元：749 passed，1条既有Starlette测试客户端弃用提醒，59.88秒；`.ai/formal-payroll-unit-delivery.log`。
|
|
||||||
- 完整隔离集成基线：396 passed、1 failed，850.91秒；唯一失败是原毛利润用例的制作人夹具被参数管理员夹具覆盖。已将 writer 显式依赖 admin 保证绑定顺序，未放宽产品权限；该用例及受影响模块复测75 passed，137.32秒，`.ai/formal-payroll-latest-focused.log`。本轮不把“基线＋定点”写成最新代码一次性完整回归全绿。
|
|
||||||
- V18/V19隔离迁移：从当前head回退至07b8c9d0e1f2，再升级至19d0e1f2a3b4；结构同步9 passed，3.00秒，`.ai/formal-payroll-migration-final.log`。
|
|
||||||
- Ruff、差异空白检查通过；前端vue-tsc与Vite生产构建通过。Vite仍有既有的大资源包体积提示，不作为功能测试失败；`.ai/formal-payroll-frontend-delivery.log`。
|
|
||||||
- 浏览器：使用合成接口数据验证真实Vue页面的正式核算入口、资料填写及提交请求（含成本封存确认）、768宽弹窗、默认关闭审核时无提交按钮；浏览器错误0。此项为界面／请求契约检查，不冒充真实客户金额验收。
|
|
||||||
- MySQL正式链路覆盖：默认关闭审核时工资／调整单不建ApprovalOrder或ApprovalStep；开启审核后财务和领导节点可用；指定账号写入、其他管理员拒绝、并发防重、失败不锁及成功锁定、固化分管和部门对账。
|
|
||||||
|
|
||||||
原开发库、T+生产连接与真实工资未被本轮测试写入。后续目标环境仍需应用迁移、绑定实际制作人、按实际资料完成样本验收。新回执的已确认更正示例已实现，通用多原单/日期规则仍按范围保留。
|
|
||||||
|
|
||||||
### 最新完整回归收口（优先于上方中间运行记录）
|
|
||||||
|
|
||||||
- 最新完整集成覆盖全部29个测试文件，在两套独立库分组执行：A组215 passed（523.98秒），B组184 passed（407.76秒），共399 passed，无失败、无跳过。日志`.ai/formal-payroll-full-current-a.log`和`.ai/formal-payroll-full-current-b.log`。此前旧夹具失败已关闭，不再作为当前遗留项。
|
|
||||||
- 完整单元749 passed；V18/V19隔离迁移往返及结构9 passed；最终类型与生产构建通过。浏览器还验证非制作人的管理员无法新增／正式核算，以及默认关闭审核时无审批列与提交按钮。
|
|
||||||
- 当前阶段代码和自动化验证完成，真实样本金额、实际账号绑定及目标环境部署未验收，不将项目整体标为已交付。
|
|
||||||
|
|
||||||
### 2026-10-30 项目收尾复验
|
|
||||||
|
|
||||||
- 后端单元测试重新执行：`786 passed`，失败 0；仅有既有 Starlette/httpx 弃用提醒。
|
|
||||||
- 隔离数据库完整集成重新执行：`406 passed`，失败 0、跳过 0，退出码 0；测试库由 `scripts/run_isolated_tests.py` 创建并在隔离环境中运行。
|
|
||||||
- `ruff check app tests`、前端 `vue-tsc --noEmit`、Vite 生产构建通过；构建保留既有大资源包体积提示。
|
|
||||||
- Windows `Test-PayrollTaskPlan.ps1` 与 `Test-PayrollHostRuntime.ps1` 通过，验证了默认禁用、单实例、重启策略、停止标记、路径空格和失败退出码传递；未注册计划任务。
|
|
||||||
- 本次未连接生产 T+、未绑定生产制作人、未生成真实工资、未运行生产备份删除或恢复操作。外部验收条件仍按计划节点 6 保留。
|
|
||||||
|
|
||||||
### 第 03 项更正场景实现
|
|
||||||
|
|
||||||
- 新增版本化 `CORRECTION` 事实，要求记录更正配对标识；发货更正必须明确排除绩效，跨客户回款必须指定原业务标识。
|
|
||||||
- 预演会保留更正发货源记录并输出排除明细，不进入 FIFO、销售额和正式绩效；B 客户侧的被转归回款自动排除，A 原业务侧按人工事实纳入，正式导入沿用同一输入版本和幂等保护。
|
|
||||||
- 前端工作台已增加更正事实录入；新增 FIFO 与事实校验用例。该项已完成代码实现，真实样本仍需按客户资料做金额验收。
|
|
||||||
59
docs/系统监控运维说明.md
Normal file
59
docs/系统监控运维说明.md
Normal file
@ -0,0 +1,59 @@
|
|||||||
|
# 系统监控运维说明
|
||||||
|
|
||||||
|
系统管理 → 系统监控（`/system/monitor`），仅管理员可访问。部署按一个后端应用进程运行；后台采集与浏览器访问无关。
|
||||||
|
|
||||||
|
## 开通与采集
|
||||||
|
|
||||||
|
先安装 `backend/pyproject.toml`／`uv.lock` 中的依赖，新增依赖为 `psutil`。使用项目迁移流程应用 V23（`23b4c5d6e7f8`），再启动后端。V23 新增 `monitor_snapshots`、`monitor_request_minutes`、`monitor_events` 及管理员查看权限，不修改工资数据。
|
||||||
|
|
||||||
|
若后续迁移已接在 V23 后，完整环境按项目当前 head 部署；不要向已有库重跑初始化 SQL。生产迁移按项目审批流程执行。本轮开发验证只对独立测试库和已核实的开发环境操作。
|
||||||
|
|
||||||
|
- 每 15 秒采集资源、MySQL／Redis 连接和 T+ 状态，每分钟持久化资源均值及请求统计。
|
||||||
|
- 请求线程只写有界内存缓冲，正常请求仅保留聚合指标。异常、慢请求和后台错误保留脱敏事件。
|
||||||
|
- 监控三张新表保留 7 天，仍未恢复的健康异常保留至恢复后过期。清理每批每表最多 1000 行，不清理工资或审计记录。
|
||||||
|
- 数据库不可写时缓冲最多十分钟、2000 条待写事件；超过容量可能产生缺口，页面显示丢弃数量。缺失时段不会按零补造。
|
||||||
|
- 页面默认每 15 秒刷新；隐藏、关闭、离开页面或手动关闭开关时停止页面轮询，后台仍采集。
|
||||||
|
|
||||||
|
## 指标口径
|
||||||
|
|
||||||
|
- 服务器资源实际为进程可见的系统资源；容器环境未换算 cgroup 限额，不表示宿主机真实可用额度。应用进程内存为 RSS，进程 CPU 按可见 CPU 总量折算。
|
||||||
|
- CPU 首次采样无可比基线，显示未知；后续周期才产生 CPU 使用率。
|
||||||
|
- 近 5 分钟使用当前分钟与前四个分钟桶。4xx 单独统计，5xx 才计入系统错误率。
|
||||||
|
- P95 使用可合并的固定耗时直方图计算近似值，不是平均值。没有请求时错误率为 0、P95 为“暂无”。
|
||||||
|
- 接口以方法和路由模板统计，不存原始 URL、查询参数或请求正文。未知地址归入 `/__unmatched__`，超过每分钟路由上限时归入 `/__other__`。
|
||||||
|
- 性能排行最多读取 20000 个接口分钟记录并展示 200 个接口，超过上限明确提示截断，应缩短范围或指定接口。
|
||||||
|
- 普通业务异常、校验失败和权限拒绝不产生 5xx 告警；监控、探活及接口文档请求不参与性能统计。
|
||||||
|
|
||||||
|
## 异常判断与排查
|
||||||
|
|
||||||
|
阈值配置见 `backend/.env.example` 中 `MONITOR_*`，变更后重启生效。
|
||||||
|
|
||||||
|
| 异常 | 默认条件 | 首先检查 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| CPU／内存偏高 | 连续采样达到 85%，持续 5 分钟 | 同时段资源趋势、慢接口、同步任务 |
|
||||||
|
| 磁盘空间不足 | 可见数据盘使用率达到 90% | 日志增长、磁盘剩余容量及存储目录 |
|
||||||
|
| 接口错误率偏高 | 近 5 个分钟桶至少 20 次请求，5xx 比例达到 5% | 失败接口排行与异常请求编号 |
|
||||||
|
| MySQL／Redis 不可用 | 有限超时的连接探测失败 | 服务状态、网络、配置变量，不向页面复制凭据 |
|
||||||
|
| T+ 健康异常 | 复用既有心跳、15 分钟排队、8 天成功采集等规则 | 关联批次、采集进程和原 T+ 页面 |
|
||||||
|
|
||||||
|
总览 → 异常时段 → 接口性能 → 查看异常 → 诊断事件详情，可以复制 `request_id`。对应 HTTP 响应头为 `X-Request-ID`，服务端日志中为 `request_id=...`。同一次请求异常只记录一条请求事件；健康类事件按错误码合并，记录首次、最近、持续采样次数及恢复时间。
|
||||||
|
|
||||||
|
运行事件页可按事件类型、完整路由模板和请求编号筛选。曲线点击可切换到该时段的事件；历史截止时间使用北京时间。诊断摘要下载只包含当前运行概况和所选条件下当前页事件，不包含完整日志、堆栈、请求参数、SQL 参数、薪资明细或连接配置。
|
||||||
|
|
||||||
|
后台运行错误仅记录固定摘要，完整原因保留在受控服务端日志。T+ 任务相关错误仍以原批次记录为依据，本页不新增任务创建、重试或停止操作。
|
||||||
|
|
||||||
|
## 故障边界
|
||||||
|
|
||||||
|
- MySQL／Redis 同时也是现有鉴权依赖。它们异常时监控接口可能无法访问，页面保留最后成功数据并标记连接失败；不绕过鉴权。
|
||||||
|
- 超过 45 秒未采集，当前状态显示未知。资源采集失败、无历史数据、未配置 T+ 与正常状态分别展示。
|
||||||
|
- 未配置、主动停用 T+ 不表示宕机；任务状态读取失败不把已有异常自动标记为恢复。
|
||||||
|
- 应用或服务器完全停止后，站内页面无法主动告警。外部探测、消息通知和多实例集中采集属于后续扩展。
|
||||||
|
- 应用回滚可保留 V23 新表。有历史监控数据时 V23 降级拒绝删除表，需保留数据并回退应用版本。
|
||||||
|
|
||||||
|
## 接口与验证
|
||||||
|
|
||||||
|
管理员接口前缀 `/api/v1/system/monitor`：`GET /overview`、`/trends`、`/interfaces`、`/events`、`/events/{id}`、`/diagnostic`。列表与普通查询沿用统一响应格式，诊断下载为 JSON 附件。现有 `/api/health` 契约保持不变。
|
||||||
|
|
||||||
|
单元测试：`python -m pytest tests/unit/test_monitoring.py tests/unit/test_monitor_service.py -q`。
|
||||||
|
|
||||||
|
浏览器合成场景：项目根执行 `node frontend/e2e/monitor.mjs`，可通过 `PLAYWRIGHT_MODULE`、`MONITOR_UI_URL` 和 `MONITOR_UI_OUTPUT` 指定已安装的 Playwright、前端地址及输出目录；不会登录真实账号或写入业务数据。
|
||||||
BIN
docs/绩效核算业务确认单_2026-10-30(2).xlsx
Normal file
BIN
docs/绩效核算业务确认单_2026-10-30(2).xlsx
Normal file
Binary file not shown.
BIN
docs/衍水绩效管理系统功能需规_修订版_2026-11-02.docx
Normal file
BIN
docs/衍水绩效管理系统功能需规_修订版_2026-11-02.docx
Normal file
Binary file not shown.
42
docs/角色授权使用说明.md
Normal file
42
docs/角色授权使用说明.md
Normal file
@ -0,0 +1,42 @@
|
|||||||
|
# 角色授权使用说明
|
||||||
|
|
||||||
|
## 操作顺序
|
||||||
|
|
||||||
|
1. 在「系统管理 → 角色管理」创建角色，例如“财务经办”“业务录入”“只读查询”。
|
||||||
|
2. 点击角色的「配置权限」，按业务分组找到模块，勾选需要的操作并填写修改原因。
|
||||||
|
3. 在「用户管理 → 分配角色」选择一个或多个角色，查看自动继承的权限，保存分配。
|
||||||
|
|
||||||
|
多个角色的权限取并集。角色权限变更会即时影响全部绑定用户，停用角色会撤销其带来的权限。角色名称不决定权限，勾选的操作才是实际授权依据。
|
||||||
|
|
||||||
|
## 新权限面板
|
||||||
|
|
||||||
|
- 左侧为业务分组和已选／总权限数量，右侧每个模块只出现一次，操作横向排列。
|
||||||
|
- 模块全选支持半选状态；勾选操作会自动包含查看权限，取消查看会同时取消该模块的操作。
|
||||||
|
- 搜索支持模块和操作名，搜索后显示相应模块；模块全选始终作用于完整模块。
|
||||||
|
- 可以从已有角色复制权限，再调整保存；复制管理员时不会复制管理员专用权限给普通角色。
|
||||||
|
- 保存前显示新增、撤销数量，修改原因和保存操作固定在底部。
|
||||||
|
- 系统管理员为内置固定全权限，仅供查看，不显示可编辑的勾选项和保存按钮。
|
||||||
|
- 用户侧只分配角色，继承权限仅供查看，不再提供“额外允许／明确禁止”等重复授权入口。
|
||||||
|
- 预览失败时禁止保存；授权版本冲突时需要重新加载；关闭有未保存改动的面板会提示放弃或继续编辑。
|
||||||
|
|
||||||
|
## 工资经办与计提岗位
|
||||||
|
|
||||||
|
已取消全局唯一工资制作人绑定和「权限与工资制作人」菜单。旧地址 `/system/authorization` 跳转角色管理。
|
||||||
|
|
||||||
|
“工资经办”是一个可配置的普通系统角色，可以分配给多个实际经办账号。具有核算、工资生成或调整权限的账号可执行对应操作，不需要再指定一次账号。查看权限不会自动变成写权限；生成工资、核算、调整等操作分别校验相应权限。
|
||||||
|
|
||||||
|
每个月实际制作人的账号与用户名仍自动记录。已生成工资的月份锁定继续生效，不能因更换角色、管理员身份或取消全局绑定而绕过。差额仍按既有调整规则处理，历史工资和操作留痕保留。
|
||||||
|
|
||||||
|
原「岗位角色」改名为「计提岗位」，用于人员岗位、计提公式和参数，不决定登录账号能访问哪些页面。
|
||||||
|
|
||||||
|
## 迁移与兼容
|
||||||
|
|
||||||
|
V26（`26e7f8a9b0c1`）保留旧表和历史记录，停用旧授权入口权限，清空旧全局制作人引用，更新默认工资角色名称及说明。自定义的角色名称不覆盖。角色与用户的现有绑定和权限项不会批量重置。
|
||||||
|
|
||||||
|
若 `user_permission_overrides` 存在记录，迁移会在修改前拒绝执行，需要先整理为等效角色，避免隐式改变用户权限。当前开发环境已核实该表为 0 条。
|
||||||
|
|
||||||
|
旧用户授权 API 继续接受空的 `overrides: []`，非空覆盖返回参数错误。旧制作人设置读取返回 `mode: roles`，写入明确提示改用角色授权，不再修改角色或绑定账号。
|
||||||
|
|
||||||
|
回退 V26 只恢复旧入口，不推测绑定哪个账号；旧版本需要管理员核对后重新指定。生产迁移与回退仍遵循项目操作审批。
|
||||||
|
|
||||||
|
本地开发库已完成 V26 核验。备份 SHA-256 为 `ed473db828140a2d64592f7b781d6a780d0015d38386f93fea15bc5d549883f1`。迁移后仍有并行账号与角色验收数据变化，未自动清理；这些数据不属于 V26 的变更内容。生产库仍未操作。
|
||||||
95
docs/需求补齐实施与验收记录_2026-11-02.md
Normal file
95
docs/需求补齐实施与验收记录_2026-11-02.md
Normal file
@ -0,0 +1,95 @@
|
|||||||
|
# 需求补齐实施与验收记录
|
||||||
|
|
||||||
|
日期：2026 年 11 月 2 日。对应用户批准的《需求缺口补齐与文档修订计划》及“模块需要的页面功能一定不要少”的要求。
|
||||||
|
|
||||||
|
本次交付覆盖原需规全部 16 个功能小节的页面对照，补齐 F01—F07。实现、自动化验证、真实客户金额验收和生产启用分别记录，不以修改文档代替实现。
|
||||||
|
|
||||||
|
## 需求基线与文件
|
||||||
|
|
||||||
|
- 原始文档：`衍水绩效管理系统功能需规.docx`，保留不修改。SHA-256：`ad6d6a4b38bae74c156cee065bbf60b2e7f95298d8b5f31297b56933f1504c92`。
|
||||||
|
- 修订文档：[衍水绩效管理系统功能需规_修订版_2026-11-02.docx](衍水绩效管理系统功能需规_修订版_2026-11-02.docx)。保留 2.1—2.5 全部 16 小节，更新后续已确认口径，新增变更与验收章节。
|
||||||
|
- 本次计划：`tasks/需求补齐计划_2026-11-02.md`。已有部署、权限和监控计划及未提交修改保留。
|
||||||
|
- 版本依据：2026.9.8 修改方案、2026-10-30 已归档回复，以及本轮用户对系数表、试用期年度范围和产品来源含义的选择。
|
||||||
|
|
||||||
|
## 七项缺口的实现与页面验收
|
||||||
|
|
||||||
|
| 编号 | 需求位置 | 本次实现 | 页面操作及主要实现位置 |
|
||||||
|
|---|---|---|---|
|
||||||
|
| F01 | 2.1.2、2.3.1、2.3.3 | 企业户按产品类别和到账日取比例；保留默认兜底及历史日期版本；混合产品逐行计算 | 计提参数／绩效系数表维护分类比例，计算预览、正式核算和台账明细使用同源规则。`rate_rules.py`、`tplus/calculation_preview.py`、`tplus/fifo.py` |
|
||||||
|
| F02 | 2.3.3、后续信息员方案 | 信息员用销售额乘岗位比例，默认 1‰，不再套用折算毛利基数；规则、基数、参数及快照指纹进入逐段结果 | 岗位角色、计提参数、试算与正式台账保持一致。销售额 10000 元、比例 1‰ 的业务回归为 10 元 |
|
||||||
|
| F03 | 2.1.1、2.3.3、2.4.1 | 基本工资按人每月只算一次，无绩效在职人员可发薪；试用期及任职日期／工资标准按生效版本保存；缓发、年度门槛、跨年续付、扣回及待审核占用分列 | 人员页新增日期和生效记录；月结页增加缓发与结清预览、人员／年度筛选、原台账明细、当月调整及导出；月结详情、部门报表和 Excel 展示基本工资／正常绩效／缓发／年度补发。`probation_service.py`、`salary_completion.py`、`personnel_salary.py` |
|
||||||
|
| F04 | 2.2.1、2.2.4 | 含税单位指导成本乘数量得到总成本，按分舍入；同时提交不一致金额拒绝；历史仅成本额记录兼容；正式已封存成本受保护 | 业务明细与毛利润视图联动；正式资料保留按发货月份封存。`cost_rules.py`、业务入参及业务服务 |
|
||||||
|
| F05 | 2.1.2 | 从已采集的有效正向发货选最新数量和含税成交价，保留日期／单号；人工调整优先，允许恢复源值；不导入 T+ 成本作绩效成本 | 产品页显示最近发货数量、最近成交价、来源和人工保护状态，提供恢复源值确认。`product_completion.py`、`tplus/master_import.py`、产品服务 |
|
||||||
|
| F06 | 2.1.2 | 业务明细选择、预览、名称规格去重、单位／类别冲突处理、确认执行及结果；重复提取不重复建档；只建立关联，不改历史金额 | 产品页“从业务提取产品”弹窗提供查询、分页、勾选、预览、执行和逐项冲突。`ProductExtractDialog.vue` 及产品提取接口 |
|
||||||
|
| F07 | 2.3.1、2.5.2 | 完整分类／户型／阶段表格；首日、线性斜率、截止天数、超期及企业户固定比例可维护；系统系数和 360 天平均系数由公式生成；同一参数版本源 | 参数页新增绩效系数表、日期查询、维护弹窗、模板／导出、Excel 导入预览／确认、逐行错误、版本历史与对比。`CoefficientPanel.vue`、`coefficient_service.py`、系数表接口 |
|
||||||
|
|
||||||
|
### 全部模块的页面能力对照
|
||||||
|
|
||||||
|
| 原小节 | 页面与入口 | 保留及补齐的操作 |
|
||||||
|
|---|---|---|
|
||||||
|
| 2.1.1 | 基础数据→人员管理 | 新增、详情、编辑、查询、删除保护、在职／离职与生效日、工资标准和任职版本、试用／转正日期、区域及拓展计划 |
|
||||||
|
| 2.1.2 | 基础数据→产品管理 | 名称规格查询、类别／状态筛选、新增、详情、编辑、启停、删除保护、来源及人工保护、恢复源值、业务提取预览／执行 |
|
||||||
|
| 2.1.3 | 基础数据→客户管理 | 档案增删改查、三种客户类型、归属维护和历史、评级入口 |
|
||||||
|
| 2.2.1 | 业务数据→业务管理；T+ 正式导入；正式核算弹窗 | 业务编号、产品明细和指导成本、负责／协助归属、状态和时间线、特殊业务、资料封存、正式核算及重算 |
|
||||||
|
| 2.2.2 | 业务数据→发货管理 | 新增、详情、编辑、查询、业务及批次关联、产品明细、日期、金额和运费 |
|
||||||
|
| 2.2.3 | 业务数据→回款管理 | 新增、详情、查询、编辑和删除保护、回款批次、到账日期及金额、核算状态 |
|
||||||
|
| 2.2.4 | 业务详情→毛利润视图；正式核算资料 | 指导单位成本和成本额校验、行级毛利、分类汇总、阈值、缺成本提示、封存保护 |
|
||||||
|
| 2.2.5 | 客户管理→评级计算器 | 五项手工评分、总分／等级、等级映射新增／编辑／删除、保存总评分 |
|
||||||
|
| 2.3.1 | 系统管理→计提参数／绩效系数表 | 参数和阶段维护、生效日、二次确认、试算、历史／比较、Excel 模板／导入预览／确认／导出 |
|
||||||
|
| 2.3.2 | 发货／回款详情、计算预览、台账逐段明细 | 首日计数、跨年天数、预收日期、实际 FIFO 匹配段 |
|
||||||
|
| 2.3.3 | 正式核算、核算台账、月度结算、工资调整 | 起付和 R²、逐段依据、防重和重算；按人基本工资、缓发、年终及续付预览、当月调整、月结锁和工资分项导出 |
|
||||||
|
| 2.4.1 | 个人绩效明细、部门绩效汇总 | 人员／月份等查询、计提比例与 R、团队和公司分成、成员明细、冻结工资分项及对账依据 |
|
||||||
|
| 2.4.2 | 业务统计、回款统计 | 业务查询、区间／户型／产品统计、分类比较及下钻 |
|
||||||
|
| 2.4.3 | 各报表、打印页、工资／缓发导出 | Excel、筛选和签字稿、浏览器打印／另存 PDF、工资分项及缓发原台账导出 |
|
||||||
|
| 2.5.1 | 用户、角色及权限、日志 | 账号增删改查、改密、启停、角色权限及操作人员记录、登录／操作／参数日志 |
|
||||||
|
| 2.5.2 | 公司信息、岗位角色、计提参数／系数表 | 公司名称和 logo、岗位模板、参数版本及完整系数表维护和导入导出 |
|
||||||
|
|
||||||
|
## 接口及数据兼容
|
||||||
|
|
||||||
|
- 系数表：`GET/PUT /api/v1/system/coefficients`，`GET /export`，`POST /import-preview`。导入只预览，确认通过 PUT 写同一参数版本；文件保留基准日期，派生列不一致时整批拒绝。
|
||||||
|
- 产品提取：`GET /api/v1/base/products/extract/candidates`、`POST /extract/preview`、`POST /extract`；来源恢复：`POST /api/v1/base/products/{id}/restore-source`。
|
||||||
|
- 缓发及结清：`GET /api/v1/payroll/probation`、`GET /probation/export`、`POST /probation/adjustments`；工资分项：`GET /api/v1/payroll/salary-export/{month}`。
|
||||||
|
- 新接口接入现有操作权限，不凭前端按钮判定授权；Excel 上传在统一权限中间件中按表单类型处理，避免重复消费请求流。
|
||||||
|
- V24 增量结构：试用期缓发及结清两表，人员任职／工资历史、产品来源和人工保护、工资分项列，以及五个分产品个人户系数参数。迁移 SQL、ORM 和开发初始化同步；结构定义固定，回退遇到新业务数据拒绝删除。
|
||||||
|
- 当前工作区的 V25／V26 分别为系统监控权限兼容及角色授权归一迁移，保留其原工作；本次功能使用现有角色权限，不重建已停用的全局制作人／个人覆盖入口，实际工资操作人员仍保留在快照和操作日志中。
|
||||||
|
- 历史已生成工资不自动重算。人员当前状态不能改变旧台账试用期分类；源导入不覆盖人工核算分类和已封存指导成本；重复导入和提取保留幂等／冲突检查。
|
||||||
|
|
||||||
|
## 金额、历史及并发验证要点
|
||||||
|
|
||||||
|
- 市政 2‰、轨交 5‰、默认 3‰ 的分类解析；信息员销售 10000 元为 10 元。
|
||||||
|
- 数量 10、单位指导成本 50，成本额为 500；成本冲突拒绝，缺成本和历史成本兼容。
|
||||||
|
- 试用期计提 20000、门槛 18000，若符合支付条件仅 1000，则年底补 1000；后续符合条件增至 3000 时再补 1000；权益降低可形成负向差额。
|
||||||
|
- 待审核结清与已支付分开，驳回／撤回释放占用；无效后续记录不阻塞较早月份，人员锁与审批锁顺序一致。
|
||||||
|
- 人员工资标准、岗位、离职／在职变更按生效日期留存；JSON 历史追加前锁人员，避免并发丢版本；工资基本额每人只计一次。
|
||||||
|
- 系数页和普通参数页提交使用同一串行化入口，指纹包含未来版本；过期预览不能静默覆盖另一笔预约变更。
|
||||||
|
- 最新有效发货按日期／单据／明细稳定排序，红冲和无效单据排除；人工产品值保护；单位／分类冲突不静默覆盖。
|
||||||
|
|
||||||
|
## 本轮验证记录
|
||||||
|
|
||||||
|
| 检查 | 结果／证据 |
|
||||||
|
|---|---|
|
||||||
|
| 新增金额、历史、产品与工作簿专项单元 | 11 项通过，包含分界天数小数原文及预收／经理排除优先级；`backend/tests/unit/test_requirement_completion.py` |
|
||||||
|
| 完整单元 | 最后完整执行 `899 passed`，失败 0；保留一条既有 Starlette/httpx 弃用提醒，见 `.ai/requirements-unit-final.log` |
|
||||||
|
| 隔离 MySQL 聚焦验证 | 产品、人员、参数、正式工资、月结、报表和结构已验证；参数专项 24 项、授权／正式工资专项 19 项、年度续付完整接口 5 项通过；重复调用和已生成工资保护均有断言 |
|
||||||
|
| 真实浏览器与实际 API | 完成系数编辑、下载／上传／确认、业务提取、恢复来源、缓发明细、真实月结、详情及 Excel 下载、部门工资分项打印；9 组检查全部通过，检查结果见 `.ai/requirements-browser-result.json`，页面异常和 API 失败均为 0 |
|
||||||
|
| 响应式 | 1440、768、390 宽度检查；截图 `.ai/requirements-coefficients-*.png`、`requirements-salary-1440.png`、`requirements-extraction-1440.png` |
|
||||||
|
| 前端类型与生产构建 | 已通过；保留既有大资源包提示，见 `.ai/requirements-frontend-build.log` |
|
||||||
|
| Ruff | `app tests` 通过；`.ai/requirements-ruff-final.log` |
|
||||||
|
| 迁移往返及完整集成 | 空隔离库升级→回退至 V17→再升级通过（首轮日志）；最后按全部 32 个文件分组执行，A 组 `211 passed`、B 组 `213 passed`，均退出码 0；新增年度续付场景所在文件再复测 `5 passed`。日志为 `.ai/requirements-integration-final-A.log`、`requirements-integration-final-B.log`、`requirements-yearend-final.log`，重复测试不累加为独立用例数 |
|
||||||
|
| Word 排版 | 渲染为 5 页，已查看整稿缩略图及变更表整页；保留原 16 小节，无拆开的变更表；中间 PDF 和图片仅用于内部 QA |
|
||||||
|
|
||||||
|
本轮集成回归覆盖快照为 32 个文件；并行工作区后续新增的 T+ 同步控制台测试不计入本次 424 项分组数字，也不将本次结果声称为其他任务新增代码的验收。两组文件清单保存在 `.ai/requirements-regression-manifest.json`。
|
||||||
|
|
||||||
|
本轮完整集成中发现的过期权限期望、旧经理试算拒绝期望和旧预收拒绝期望，按当前已确认功能改为相应金额／权限断言；没有删除失败用例或关闭检查。历史月份参数测试固定业务日期，不依赖实际今天。
|
||||||
|
|
||||||
|
## 尚需真实资料或目标环境的验收
|
||||||
|
|
||||||
|
- 真实客户指导成本、期初及历史已处理金额齐备后，逐笔及整月工资与人工结果核对。
|
||||||
|
- 客户目标 SQL Server 2008 R2、正式源读取、服务托管、备份恢复及生产启用另行验收。
|
||||||
|
- 通用多原单金额分配与任意日期更正规则仍按既有待确认边界处理，不猜规则。
|
||||||
|
|
||||||
|
本轮使用的浏览器和金额数据为隔离合成样本，不替代上述真实业务验收；没有提交、推送或启用生产连接。
|
||||||
|
|
||||||
|
## 本次完成状态
|
||||||
|
|
||||||
|
F01—F07 已完成页面、接口、存储、计算和本地验证，修订版保留原 16 个小节；原文哈希复核未变，Word 已渲染 5 页并目视检查。辅助脚本、日志和截图留在已忽略的 `.ai/`，未纳入版本管理。当前结论为“本次需求补齐的开发及本地验收完成”，不扩大为真实客户工资对账、其他并行任务或生产部署全部完成。
|
||||||
105
docs/需求补齐流程测试报告_2026-11-02.md
Normal file
105
docs/需求补齐流程测试报告_2026-11-02.md
Normal file
@ -0,0 +1,105 @@
|
|||||||
|
# 需求补齐流程测试报告（2026-11-02）
|
||||||
|
|
||||||
|
## 结论
|
||||||
|
|
||||||
|
本轮已完成隔离数据库端到端回归。后端单元测试 922 项全部通过；隔离集成测试 A 组 315 项全部通过，B 组 122 个唯一用例在修复开发库结构同步后全部通过：首轮 119 通过、3 项结构同步失败；修复后复跑 3 个失败点及其结构回归，专项 10 项全部通过；前端类型检查和构建通过；Ruff 针对本轮修改范围检查通过。此前浏览器流程检查记录了 9 项检查、0 项失败。
|
||||||
|
|
||||||
|
本轮在回归中发现并修复了三个交付前问题：V28 迁移把“注释 + CREATE TABLE”整段误判为纯注释导致新库缺表；`db/init/init-dev.sql` 缺少 `calc_template_definitions`，且版本号仍停在 V27；新公式模板接口缺少权限映射。以上问题已修复并复测，未发现遗留失败。
|
||||||
|
|
||||||
|
## 测试范围与证据
|
||||||
|
|
||||||
|
| 范围 | 结果 | 证据 |
|
||||||
|
| --- | ---: | --- |
|
||||||
|
| 后端单元测试 | 922 passed / 0 failed | `.ai/unit-regression-final-20261102.log` |
|
||||||
|
| 隔离集成 A 组 | 315 passed / 0 failed | `.ai/e2e-flow-groupA.log` |
|
||||||
|
| 隔离集成 B 组 | 119 passed，3 项结构同步失败；修复后专项 10 passed / 0 failed | `.ai/e2e-flow-groupB.log`、`.ai/e2e-schema-fix-regression.log` |
|
||||||
|
| 审批专项回归 | 24 passed / 0 failed | `.ai/approval-regression-20261102.log` |
|
||||||
|
| 前端类型检查 + 构建 | 通过 | `.ai/frontend-build-20261102.log` |
|
||||||
|
| Ruff | 修改范围全部通过 | 命令：`ruff check app tests alembic/versions/28a9b0c1d2e3_calc_template_definitions.py` |
|
||||||
|
| 浏览器流程检查 | 9 项检查，0 项失败 | `.ai/requirements-browser-result.json` |
|
||||||
|
|
||||||
|
## 需求覆盖矩阵
|
||||||
|
|
||||||
|
| 需求小节 | 功能模块 | 主要测试文件 | 结论 |
|
||||||
|
| --- | --- | --- | --- |
|
||||||
|
| 2.1.1 | 人员管理 | `test_personnel.py` | 通过 |
|
||||||
|
| 2.1.2 | 产品管理、T+ 同步、提取与调整 | `test_products.py`、`test_requirement_completion.py` | 通过 |
|
||||||
|
| 2.1.3 | 客户管理、归属、评级入口 | `test_customers.py`、`test_ratings.py` | 通过 |
|
||||||
|
| 2.2.1 | 业务创建、明细、指导成本、状态流转 | `test_businesses.py`、`test_formal_payroll.py` | 通过 |
|
||||||
|
| 2.2.2 | 发货登记、明细、FIFO 与归属 | `test_shipments.py`、`test_formal_payroll.py` | 通过 |
|
||||||
|
| 2.2.3 | 回款登记、批次、到账与 FIFO | `test_receipts.py`、`test_formal_payroll.py` | 通过 |
|
||||||
|
| 2.2.4 | 指导价、毛利润与成本封存 | `test_businesses.py`、`test_formal_payroll.py` | 通过 |
|
||||||
|
| 2.2.5 | 客户评级计算器 | `test_ratings.py` | 通过 |
|
||||||
|
| 2.3.1 | 参数、系数、公式模板 | `test_param_management.py`、`test_requirement_completion.py`、公式模板权限测试 | 通过 |
|
||||||
|
| 2.3.2 | 回款天数、跨年、首日计数 | `test_receipts.py`、`test_formal_payroll.py` | 通过 |
|
||||||
|
| 2.3.3 | 绩效计算、试用期缓发、工资闭环 | `test_formal_payroll.py`、`test_settlements.py`、`test_requirement_completion.py` | 通过 |
|
||||||
|
| 2.4.1—2.4.3 | 明细、部门、业务、回款报表及导出 | `test_reports.py` | 通过 |
|
||||||
|
| 2.5.1 | 用户、角色、授权、审批权限与日志 | `test_user_management.py`、`test_role_management.py`、`test_authorization.py`、`test_log_query.py` | 通过 |
|
||||||
|
| 2.5.2 | 公司信息、系统设置、监控 | `test_settings.py`、`test_tplus_automation.py`、`test_tplus_workbench.py` | 通过 |
|
||||||
|
| 补充规则 | 二次分配与审核链 | `test_approval_flow.py`、`test_secondary_allocation.py`、`test_approval_version.py`、`test_formal_payroll.py` | 通过 |
|
||||||
|
|
||||||
|
## 核心业务链路验证
|
||||||
|
|
||||||
|
`test_formal_payroll.py::formal_chain` 先建立在职业务员和营销经理，再创建客户与含数量、销售单价、指导成本的业务；随后登记发货、回款，提交期初、历史处理金额、发货归属、分管经理和指导成本封存，最后执行正式核算并生成月结。该夹具把用户要求的主链路串成同一事务化测试样本：业务创建 → 发货登记 → 回款登记 → 指导价／成本 → 正式绩效 → 工资结算。
|
||||||
|
|
||||||
|
| 链路节点 | 验证内容 | 主要证据 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| 业务创建 | 编号、客户、产品明细、指导成本、状态和特殊标记 | `test_businesses.py`、`formal_chain` |
|
||||||
|
| 发货登记 | 发货日期、明细金额、运费、业务关联和归属数据 | `test_shipments.py`、`formal_chain` |
|
||||||
|
| 回款登记 | 回款日期、金额、批次、FIFO 和核销防重 | `test_receipts.py`、`test_formal_payroll.py` |
|
||||||
|
| 指导价与毛利润 | 单位成本换算、封存、毛利润和折算基数 | `test_businesses.py`、`test_formal_payroll.py` |
|
||||||
|
| 客户评级 | 五项评分、总分、等级映射和保存 | `test_ratings.py` |
|
||||||
|
| 绩效计算 | 天数、分类比例、R²、起付、信息员、企业户、预付和重算 | `test_calc.py`、`test_formal_payroll.py` |
|
||||||
|
| 工资发放 | 月结快照、基本工资、绩效、缓发、年终补发、审批开关、锁定和导出 | `test_settlements.py`、`test_formal_payroll.py`、浏览器月结检查 |
|
||||||
|
|
||||||
|
## 补齐功能 F01—F07 核对
|
||||||
|
|
||||||
|
| 编号 | 结果 | 关键行为与证据 |
|
||||||
|
| --- | --- | --- |
|
||||||
|
| F01 企业户分类比例 | 通过 | 市政、轨交、默认兜底和历史到账日期版本由参数、预演、正式核算共用；混合产品逐行计算。证据：`test_param_management.py`、`test_requirement_completion.py`、`test_formal_payroll.py` |
|
||||||
|
| F02 信息员计提 | 通过 | 销售额 × 岗位比例，10000 元 × 1‰ 的回归断言为 10 元；不再用折算毛利作为基数。证据：`test_requirement_completion.py`、单元和集成参数样例 |
|
||||||
|
| F03 基本工资与试用期 | 通过 | 无绩效在职人员可生成基本工资；试用期绩效缓发；18000 元边界、跨年续付、转正、负向调整、重复生成和审核占用均有断言。证据：`test_formal_payroll.py`、`test_settlements.py`、`test_requirement_completion.py` |
|
||||||
|
| F04 指导成本联动 | 通过 | 数量 10 × 含税单位指导成本 50 = 成本额 500；同提金额不一致拒绝；封存后不可编辑覆盖；历史总成本兼容。证据：`test_businesses.py`、`test_formal_payroll.py`、`test_requirement_completion.py` |
|
||||||
|
| F05 产品来源同步 | 通过 | 最新有效正向发货按单据日期、单据 ID、明细 ID 排序；展示来源日期和单据；人工值保护与恢复源值有测试。证据：`test_products.py`、`test_requirement_completion.py` |
|
||||||
|
| F06 业务提取产品 | 通过 | 明细选择、提取预览、确认执行、同名同规格、单位／分类冲突、重复提取幂等和仅建立关联均验证。证据：`test_products.py`、`test_requirement_completion.py`；浏览器检查包含选择、预览、执行和结果展示 |
|
||||||
|
| F07 完整系数表 | 通过 | 分类、户型、阶段、日期版本、模板下载、导入预览／确认、导出、历史比较和正式计算消费均验证；公式模板权限补齐后通过。证据：`test_param_management.py`、`test_authorization_policy.py`、浏览器系数页 9 项检查 |
|
||||||
|
|
||||||
|
## 页面功能与权限核验
|
||||||
|
|
||||||
|
真实浏览器检查覆盖系数表编辑和二次确认、模板下载、真实上传预览及导入确认、业务提取、恢复来源、年度结清预览、真实接口月结、工资分项与 Excel 下载、部门打印页，以及 1440／768／390 宽度检查。后端权限回归覆盖全部业务路由的权限映射、未登记接口默认拒绝、按钮权限对应的服务端校验、审批节点权限和公式模板接口权限。
|
||||||
|
|
||||||
|
页面清单与七项补齐功能的逐项实现位置另见 [需求补齐实施与验收记录_2026-11-02.md](需求补齐实施与验收记录_2026-11-02.md)。该记录保留原需规 16 个小节的页面对照，本轮测试报告不降低其功能范围。
|
||||||
|
|
||||||
|
## 二次分配与审核链结论
|
||||||
|
|
||||||
|
当前口径不是继续把业务表比例方案作为新核算入口，而是保留历史比例方案供追溯；正式核算按发货归属逐笔分配。工资生成后分配锁定，差额走生成当月调整单，并保留原月结结果。
|
||||||
|
|
||||||
|
审核能力保留但默认关闭。关闭时工资生成直接完成，不创建审批单、审批步骤或自动通过痕迹；开启后可走财务复核、领导审核两级链路。审批内容使用提交时快照，版本号递增、重提不覆盖旧记录；任一节点驳回即整体驳回，驳回意见必填并留痕。
|
||||||
|
|
||||||
|
集成验证覆盖了开关关闭、开关开启、财务通过、领导通过、财务或领导驳回、驳回缺意见拒绝、节点权限、重复操作拒绝、重提撤回、快照固化、内容未变不重提、金额变化重提、方案版本化、驳回释放生效方案、正式核算无痕迹、分配调整无痕迹，以及可选审核开启后的月结两级审批。
|
||||||
|
|
||||||
|
## 修复与结构同步
|
||||||
|
|
||||||
|
- `backend/alembic/versions/28a9b0c1d2e3_calc_template_definitions.py`：迁移脚本改为逐条剥离注释行后再执行，避免新库跳过建表。
|
||||||
|
- `db/init/init-dev.sql`：补齐公式模板表、五个系统模板种子，版本号更新为 `28a9b0c1d2e3`。
|
||||||
|
- `backend/app/services/authorization_policy.py`：公式模板接口映射到 `system:params` 查看与更新权限。
|
||||||
|
- `backend/tests/unit/test_models.py`：ORM 表集合加入 `calc_template_definitions`。
|
||||||
|
- `backend/tests/integration/test_tplus_sync_console.py`：迁移往返断言版本更新为当前 head。
|
||||||
|
|
||||||
|
## 完成度审计
|
||||||
|
|
||||||
|
- 原 16 个需求小节：报告矩阵逐节登记，且均有关联集成测试；未按已有代码缩小为“仅核心模块”。
|
||||||
|
- 七项补齐功能：F01—F07 逐项登记页面、接口、存储、计算和本地验证结果。
|
||||||
|
- 主业务链路：业务、发货、回款、指导成本、评级、绩效、工资链路均有独立测试，并通过 `formal_chain` 形成连续样例。
|
||||||
|
- 页面要求：浏览器检查覆盖新增高风险页面动作和响应式检查；实施记录保留全部页面对照。
|
||||||
|
- 审核与权限：审批开关、节点权限、快照、版本、驳回、无痕迹模式和公式模板权限均有断言。
|
||||||
|
- 本地交付门：单元、隔离集成、Ruff、前端类型检查、构建和浏览器检查均通过。
|
||||||
|
|
||||||
|
测试数据为隔离合成样本：人员、客户、业务、发货、回款、指导成本、分类比例、试用期额度、审批开关和报表月份均由测试代码构造，不污染共享库；数据构造见 `backend/tests/integration/factories.py`、`test_formal_payroll.py`、`test_requirement_completion.py` 及浏览器检查脚本。
|
||||||
|
|
||||||
|
## 边界与遗留
|
||||||
|
|
||||||
|
本轮使用隔离合成样本验证功能与计算链路，不替代真实客户金额、SQL Server 2008 R2、托管部署、备份恢复和生产启用验收。生产迁移、提交、推送均未执行。真实样本中的分类比例、指导成本、历史发货归属和整月工资核对仍需按实施与验收记录单独完成。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
Binary file not shown.
Binary file not shown.
72
tasks/archive/2026-10-28-tplus-pre-docker-plan.md
Normal file
72
tasks/archive/2026-10-28-tplus-pre-docker-plan.md
Normal file
@ -0,0 +1,72 @@
|
|||||||
|
# 下一阶段开发计划：评审收口、交付设计与同版本验收
|
||||||
|
|
||||||
|
日期：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 方案中蓝色字体标注的原方案算法作废，毛利润率按不含运费口径执行。
|
||||||
|
- 当前确认入口：`docs/客户待确认事项表_2026-10-28_客户版.xlsx`。业务与对接问题按 B01–B08、T01–T09 归并，环境及验收为 E01–E04，本轮增加 S1；F 列保留客户答复。旧 v2 表按用户决定删除，旧编号对应关系见 C1 第 10 节。
|
||||||
|
- 经理个人户：微信沟通确定按 9.8 方案执行、不计个人户部分，客户群确认中；系统参数已预留，确认后调整参数即可，无需开发。
|
||||||
|
- 工程收口：原有迁移、后端、前端与文档已拆分提交并推送；此前完整回归 990 项通过。
|
||||||
|
- 环境基准：按用户最新决定，先以备份源 SQL Server 2008 R2 10.50.1600 推进开发验收，生产地址、账号和部署信息后补。合法介质与真实同版本实测仍待完成。
|
||||||
|
|
||||||
|
## 目标与顺序
|
||||||
|
|
||||||
|
先完成 P0.5 连接修复、运行手册与安全决策记录，再补 D1/D2 设计和 C1 回填清单。当前继续本地开发与隔离测试；业务答复回收后按清单更新设计，再实施导入。生产环境信息不阻塞本阶段设计工作。
|
||||||
|
|
||||||
|
### P0 工程收口（已完成）
|
||||||
|
|
||||||
|
1. 将本轮 T+ 同步管理成果按迁移、后端服务、前端页面、文档拆分为规范提交；合入前本地构建与测试通过。
|
||||||
|
|
||||||
|
### P0.5 评审收口（本轮）
|
||||||
|
|
||||||
|
- 兼容性脚本复用应用的连接文件校验与 SQLAlchemy URL，消除手工连接串拼接；应用 URL 已有方言转义，不重复造一套转义器。
|
||||||
|
- 默认启用加密；隔离开发环境仅允许显式回退并记录原因，不自动降级、不代填私有配置。真实旧版 TLS 兼容留待 A3。
|
||||||
|
- 补齐 `docs/T+本地恢复与同步开发手册.md`，区分容器恢复脚本与 Windows 来宾恢复步骤。
|
||||||
|
- 确认表新增 S1：用户已同意当前开发阶段暂不单独加密或掩码，生产保护、保留期与备份访问范围仍待统一确认；本轮不改敏感数据。
|
||||||
|
- 定点验证连接特殊字符、默认 TLS、显式回退、错误脱敏和备份源版本判定，再在隔离 MySQL/Redis 执行完整回归。通过后分代码与文档提交推送。
|
||||||
|
|
||||||
|
本轮验证结果：19 项定点、1001 项完整回归与 Ruff 通过；临时测试容器及卷已清理。确认表保留原业务答复与引文，环境材料与 S1 已更新；D1/D2 为设计交付，实际托管和告警未启用。
|
||||||
|
|
||||||
|
### 轨道 A：同版本验收环境（外部依赖：安装介质）
|
||||||
|
|
||||||
|
- A1 先行细化 `docs/SQLServer2008R2测试环境.md`：装机步骤、恢复步骤，以及驱动、只读权限、六类查询、中文/日期/金额、断连超时、重复同步的验收清单。
|
||||||
|
- A2 取得合法介质后，在 `E:\work\app\tplus-vm` 完成备份源 10.50.1600 环境安装；虚拟机已迁至 E 盘，但系统和数据库尚未安装。
|
||||||
|
- A3 恢复原始备份并执行完整验收，产出报告，关闭同版本兼容 PENDING 状态。
|
||||||
|
|
||||||
|
### 轨道 B：业务口径确认（外部依赖：客户填写）
|
||||||
|
|
||||||
|
- B1 后续发送当前客户版：客户在 F 列填写业务答复，IT/服务商补充 E01–E03 的资料；同一例单可复用，已确认规则不重复提问。
|
||||||
|
- B2 跟进客户群对经理个人户的反馈，回填 L6。
|
||||||
|
- B3 答复回收后更新字段映射文档与暂定口径记录：二次分配三项（L3–L5）追认、三级角色职权（L7）在页面验收时核对。
|
||||||
|
|
||||||
|
任务 B1–B3 是工作编号；当前客户版使用 B01/T01/E01 等编号，C1 中的旧编号仅供追溯。发送确认单是后续人工事项，本轮不代发消息。
|
||||||
|
|
||||||
|
### 轨道 C：T+ 数据导入开发（依赖轨道 B 闭环；设计可先行）
|
||||||
|
|
||||||
|
- C1 先行起草「staging → 业务表写入」设计：表映射、金额精度（金额用 Decimal、比例和日斜率用 Fraction）、幂等与重算授权留痕、人工字段保护（回款/发货批次由系统人工指定，业务归属变更不回溯历史）、事务边界；明确标注等待确认的差异点，口径闭环后评审定稿。
|
||||||
|
- C2 主数据导入（人员、客户、产品）：依赖 #9、#10、#11。
|
||||||
|
- C3 订单 → 发货 → 回款导入：依赖 #1–#8、#13（成本、日期、分摊、核销、初始化）。
|
||||||
|
- C4 负向事件处理（退货、红冲、负绩效）：依赖 #8；口径已定为负绩效照公式出数、不归零。
|
||||||
|
- C5 增量变更发现：依赖 #13；收付款表无 `updated` 字段，需验证 rowversion 与删除/作废的发现方式，在此之前时间水位保持禁用。
|
||||||
|
|
||||||
|
### 轨道 D：交付收尾（依赖 A3 与轨道 C 完成）
|
||||||
|
|
||||||
|
- 本轮前置产出 `docs/T+交付部署设计_2026-10-28.md`：首期推荐任务计划程序，明确排队、进程恢复和业务重试的区别；周任务、阈值为设计默认，外部告警通道待确认。
|
||||||
|
- D1 `tplus-worker` 托管（首期采用 Windows 任务计划程序）。
|
||||||
|
- D2 每周同步任务编排与失败告警。
|
||||||
|
- D3 客户内网独立部署与最终验收。
|
||||||
|
|
||||||
|
## 验收与保留门槛
|
||||||
|
|
||||||
|
- 未确认项不进入正式核算；确认单未闭环前不实施业务表写入。
|
||||||
|
- 导入保护人工字段；每笔回款只核算一次；重算须授权并留痕。
|
||||||
|
- 2008 R2 验收未完成前，2022 恢复副本的结果不作为同版本兼容证据。
|
||||||
|
- 每个任务先完成定点测试再进入依赖任务；回归使用隔离的 MySQL/Redis。
|
||||||
|
- C1 尾部按 #1–#13、L1–L7、B1–B5/M1–M5、S1 列出答复回填顺序。业务答复、字段存在、同版本实测和生产部署分别验收，不能互相代替。
|
||||||
|
- S1 的暂缓加密是用户批准的当前开发阶段例外；生产敏感字段策略仍是上线前待确认项。
|
||||||
|
|
||||||
|
## 项目后续路线
|
||||||
|
|
||||||
|
轨道 C 完成、A3 通过后进入轨道 D；部署验收通过即转入运维期（每周同步、参数调整走系统设置与版本管理）。
|
||||||
49
tasks/archive/2026-10-28-tplus-pre-docker-todo.md
Normal file
49
tasks/archive/2026-10-28-tplus-pre-docker-todo.md
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
# T+ 数据导入与同版本验收任务清单
|
||||||
|
|
||||||
|
依照 `tasks/plan.md`（2026-10-28）。上一轮清单已归档至 `tasks/archive/2026-10-27-tplus-sync-todo.md`。
|
||||||
|
|
||||||
|
## P0 工程收口
|
||||||
|
- [x] 拆分提交本轮 T+ 同步管理成果（迁移、后端、前端、文档）；提交前 Ruff、单元测试、前端类型检查与构建通过。
|
||||||
|
依赖：无。
|
||||||
|
|
||||||
|
## P0.5 评审收口与交付设计
|
||||||
|
- [x] 兼容脚本复用应用 URL 与连接文件校验，补特殊字符转义回归。
|
||||||
|
- [x] 默认启用 TLS，模板说明显式回退、自签证书限制和私有配置迁移。
|
||||||
|
- [x] 补本地恢复与同步开发手册，修正 A1 的容器/虚拟机步骤。
|
||||||
|
- [x] 在现有客户版新增 S1，环境材料说明先用本地备份源同版本、生产信息后补；按用户决定保留旧 v2 删除结果。
|
||||||
|
- [x] 产出 D1/D2 托管、每周排队、重试与告警设计稿。
|
||||||
|
- [x] C1 补全每项预留决策的回填顺序。
|
||||||
|
- [x] 完成隔离全量回归（1001 项）、Ruff、文档链接与表格保留校验；分代码和文档提交交付。
|
||||||
|
|
||||||
|
## 轨道 A：同版本验收环境
|
||||||
|
- [x] A1 细化 2008 R2 测试环境与验收手册（无介质可先做）。
|
||||||
|
- [ ] A2 取得合法介质并安装备份源 10.50.1600 同版本环境。
|
||||||
|
- [ ] A3 恢复原始备份并执行完整验收，产出报告。
|
||||||
|
依赖：A2 等介质到位；A3 依赖 A2。
|
||||||
|
|
||||||
|
## 轨道 B：业务口径确认
|
||||||
|
- [ ] B1 发送 `docs/客户待确认事项表_2026-10-28_客户版.xlsx` 并跟进填写。
|
||||||
|
- [ ] B2 回填经理个人户客户群反馈结果（L6）。
|
||||||
|
- [ ] B3 答复回收后更新映射与暂定口径记录。
|
||||||
|
依赖：无；B1 立即可发。
|
||||||
|
|
||||||
|
## 轨道 C：T+ 数据导入开发
|
||||||
|
- [x] C1 起草 staging → 业务表写入设计，标注等待确认的差异点。
|
||||||
|
- [ ] C2 主数据导入实现与测试。
|
||||||
|
- [ ] C3 订单/发货/回款导入实现与测试。
|
||||||
|
- [ ] C4 负向事件处理实现与测试。
|
||||||
|
- [ ] C5 增量变更发现方案与验证。
|
||||||
|
依赖：C1 无前置，可先行；C2–C5 依赖轨道 B 闭环与 C1 评审。
|
||||||
|
|
||||||
|
## 轨道 D：交付收尾
|
||||||
|
- [ ] D1 worker 服务托管。
|
||||||
|
- [ ] D2 每周同步任务与失败告警。
|
||||||
|
- [ ] D3 客户内网部署验收。
|
||||||
|
依赖：A3 与轨道 C 完成。
|
||||||
|
说明：D1/D2 设计稿已产出，托管、周任务和外部告警尚未启用；生产主机条件与通道待确认。
|
||||||
|
|
||||||
|
## 检查点
|
||||||
|
- [ ] 检查点 A：客户版业务答复完成并回填 C1（B01–B08、T01–T09）；E01–E04 按环境与正式验收节点补齐。
|
||||||
|
- [ ] 检查点 B：主数据导入通过，业务表首次写入可回滚。
|
||||||
|
- [ ] 检查点 C：全量导入与 2008 R2 验收通过，进入轨道 D。
|
||||||
|
- [ ] 上线前确认 S1 的全库敏感字段保护、保留期与备份访问策略。
|
||||||
185
tasks/plan.md
185
tasks/plan.md
@ -1,72 +1,159 @@
|
|||||||
# 下一阶段开发计划：评审收口、交付设计与同版本验收
|
# 当前计划：完整权限管理与操作体验（2026-11-02）
|
||||||
|
|
||||||
日期：2026-10-28。基于关联核验与同步管理轮次完成后的实际情况制定；上一轮计划与任务清单已归档至 `tasks/archive/2026-10-27-tplus-sync-*.md`。
|
按用户后续明确选择更新：角色管理配置权限，用户管理分配角色，取消个人覆盖与全局制作人绑定；管理员拥有全部功能权限，月份锁、实际经办人和审核节点保护保留；轻动效尊重减少动态效果。
|
||||||
|
|
||||||
## 当前实际状况
|
1. 权限目录与数据：复用 RBAC 表与授权版本锁；V22／V25 已应用，本轮隔离库升级 V26，本地 V26 由并行角色改造任务继续应用。
|
||||||
|
2. 授权闭环：角色分模块配置、用户分配角色、只读继承预览、修改摘要与审计，移除重复授权入口。
|
||||||
|
3. 后端接入：所有接口默认拒绝未登记权限，查询/写入/导出/元数据/后台任务均检查，保留工资业务约束。
|
||||||
|
4. 前端接入：菜单/路由/按钮共用权限，提供详情与只读提示，撤权无需重新登录，避免无权限重定向循环。
|
||||||
|
5. 验收交付：管理员、只读、区域角色、工资角色四类账号真实浏览器 6 项通过；完整单元 893 项、隔离专项 31＋52 项、Ruff、类型／构建通过，使用说明同步。
|
||||||
|
|
||||||
- 同步管理已完成：批次/异常/重试/锁/页面验收通过；staging 累计 933,203 行，六类工资业务表尚未接入写入。
|
旧计划及外部验收项保留如下；本轮不提交或推送、不启用生产或源自动采集、不生成真实工资。当前账号授权不再以绑定全局制作人为前置条件；客户环境授权仍须单独配置。
|
||||||
- 口径进展：澄清清单 24 项答复基本到齐；对照表 v2 已裁决经理个人户（#7）、协助 25%（#6/#15）、信息员（#9）、企业户 3‰（#20）等冲突。9.8 方案中蓝色字体标注的原方案算法作废，毛利润率按不含运费口径执行。
|
|
||||||
- 当前确认入口：`docs/客户待确认事项表_2026-10-28_客户版.xlsx`。业务与对接问题按 B01–B08、T01–T09 归并，环境及验收为 E01–E04，本轮增加 S1；F 列保留客户答复。旧 v2 表按用户决定删除，旧编号对应关系见 C1 第 10 节。
|
|
||||||
- 经理个人户：微信沟通确定按 9.8 方案执行、不计个人户部分，客户群确认中；系统参数已预留，确认后调整参数即可，无需开发。
|
|
||||||
- 工程收口：原有迁移、后端、前端与文档已拆分提交并推送；此前完整回归 990 项通过。
|
|
||||||
- 环境基准：按用户最新决定，先以备份源 SQL Server 2008 R2 10.50.1600 推进开发验收，生产地址、账号和部署信息后补。合法介质与真实同版本实测仍待完成。
|
|
||||||
|
|
||||||
## 目标与顺序
|
---
|
||||||
|
|
||||||
先完成 P0.5 连接修复、运行手册与安全决策记录，再补 D1/D2 设计和 C1 回填清单。当前继续本地开发与隔离测试；业务答复回收后按清单更新设计，再实施导入。生产环境信息不阻塞本阶段设计工作。
|
# 历史计划：同步运维自动化与真实样本验收（2026-10-30）
|
||||||
|
|
||||||
### P0 工程收口（已完成）
|
> 2026-11-02 规则来源更新：先读 `docs/业务规则时间线与当前口径_2026-11-02.md`。客户第 03 项已按第二版具体场景及聊天接受方案确认；旧“讨论后答复”已被后续内容补齐。内部实现与验证、实际资料及部署验收分别跟踪，不将泛化多原单分摊或任意日期覆盖列为当前客户前置条件。
|
||||||
|
|
||||||
1. 将本轮 T+ 同步管理成果按迁移、后端服务、前端页面、文档拆分为规范提交；合入前本地构建与测试通过。
|
依据本轮批准的 T1～T6 实施；下方正式工资及历史计划保留，当前状态以本节和开发记录为准。
|
||||||
|
|
||||||
### P0.5 评审收口（本轮）
|
1. T1 已形成恢复库只读样本核对包，源单据、有效凭证、工号、候选期初与费用证据可追溯；2017 年初始化不直接当 2026 年切换余额。
|
||||||
|
2. T2／T3 已实现每周九类原始采集、同周防重、手动协调、停机补最近一周、5／15 分钟最多两次明确断连重试、独立心跳和站内提示；生产自动化默认关闭。
|
||||||
|
3. T4 已交付 Windows 计划托管包、预演、账号／ACL 校验、检查及停用；本机隔离进程验证通过，客户账号、实际注册、开机及三次恢复留待专用目标环境验收。
|
||||||
|
4. T5 保持待资料：用户明确没有该样本人工指导成本；不替换为源成本或零成本，不重复索要同一资料。分类、费用、期初／历史及分管只核对本组，普通运维开发继续。
|
||||||
|
5. T6 已完成 784 项单元、405 项完整隔离集成、V21 迁移往返及 16 项专项、Ruff、类型构建及合成接口真实浏览器验证。自动化开发、真实金额验收和生产启用分别记录。
|
||||||
|
|
||||||
- 兼容性脚本复用应用的连接文件校验与 SQLAlchemy URL，消除手工连接串拼接；应用 URL 已有方言转义，不重复造一套转义器。
|
当前迁移 head 为 `21f2a3b4c5d6`，新增 V20／V21，不重写已应用迁移；仅隔离库执行。操作说明：`scripts/windows/README.md`；详细证据：`docs/同步运维自动化与样本核对开发记录_2026-10-30.md`。
|
||||||
- 默认启用加密；隔离开发环境仅允许显式回退并记录原因，不自动降级、不代填私有配置。真实旧版 TLS 兼容留待 A3。
|
|
||||||
- 补齐 `docs/T+本地恢复与同步开发手册.md`，区分容器恢复脚本与 Windows 来宾恢复步骤。
|
|
||||||
- 确认表新增 S1：用户已同意当前开发阶段暂不单独加密或掩码，生产保护、保留期与备份访问范围仍待统一确认；本轮不改敏感数据。
|
|
||||||
- 定点验证连接特殊字符、默认 TLS、显式回退、错误脱敏和备份源版本判定，再在隔离 MySQL/Redis 执行完整回归。通过后分代码与文档提交推送。
|
|
||||||
|
|
||||||
本轮验证结果：19 项定点、1001 项完整回归与 Ruff 通过；临时测试容器及卷已清理。确认表保留原业务答复与引文，环境材料与 S1 已更新；D1/D2 为设计交付，实际托管和告警未启用。
|
后续跟踪已确认更正场景的配对／排除校验、前端选择及完整流程验证，以及 2008 R2 实机、目标环境恢复链及生产安装启用。通用多原单自动分摊和任意日期覆盖不作为当前客户待答复任务；未来实际出现未覆盖场景时再核实。既有节点 5 实现记录不替代当前缺口验证，未完成事项不因历史测试通过而勾选完成。
|
||||||
|
|
||||||
### 轨道 A：同版本验收环境（外部依赖：安装介质）
|
---
|
||||||
|
|
||||||
- A1 先行细化 `docs/SQLServer2008R2测试环境.md`：装机步骤、恢复步骤，以及驱动、只读权限、六类查询、中文/日期/金额、断连超时、重复同步的验收清单。
|
## 前一阶段计划与证据（保留）
|
||||||
- A2 取得合法介质后，在 `D:\work\app\tplus-vm` 完成备份源 10.50.1600 环境安装；当前不是已完成状态。
|
|
||||||
- A3 恢复原始备份并执行完整验收，产出报告，关闭同版本兼容 PENDING 状态。
|
|
||||||
|
|
||||||
### 轨道 B：业务口径确认（外部依赖：客户填写）
|
# 当前计划：正式工资闭环与项目收尾（2026-10-30）
|
||||||
|
|
||||||
- B1 后续发送当前客户版：客户在 F 列填写业务答复，IT/服务商补充 E01–E03 的资料；同一例单可复用，已确认规则不重复提问。
|
## 本次分节点执行计划与状态
|
||||||
- B2 跟进客户群对经理个人户的反馈，回填 L6。
|
|
||||||
- B3 答复回收后更新字段映射文档与暂定口径记录：二次分配三项（L3–L5）追认、三级角色职权（L7）在页面验收时核对。
|
|
||||||
|
|
||||||
任务 B1–B3 是工作编号；当前客户版使用 B01/T01/E01 等编号，C1 中的旧编号仅供追溯。发送确认单是后续人工事项，本轮不代发消息。
|
### 节点 1：基线与范围确认（已完成）
|
||||||
|
|
||||||
### 轨道 C：T+ 数据导入开发（依赖轨道 B 闭环；设计可先行）
|
- [x] 接续既有 `tasks/plan.md`、`tasks/todo.md` 和 `.ai/` 上下文，不覆盖未完成计划。
|
||||||
|
- [x] 核对当前代码、迁移、测试与部署脚本，区分仓库内可完成项和必须依赖客户/目标环境的验收项。
|
||||||
|
|
||||||
- C1 先行起草「staging → 业务表写入」设计：表映射、金额精度（金额用 Decimal、比例和日斜率用 Fraction）、幂等与重算授权留痕、人工字段保护（回款/发货批次由系统人工指定，业务归属变更不回溯历史）、事务边界；明确标注等待确认的差异点，口径闭环后评审定稿。
|
### 节点 2：正式工资与 T+ 正式衔接（已完成）
|
||||||
- C2 主数据导入（人员、客户、产品）：依赖 #9、#10、#11。
|
|
||||||
- C3 订单 → 发货 → 回款导入：依赖 #1–#8、#13（成本、日期、分摊、核销、初始化）。
|
|
||||||
- C4 负向事件处理（退货、红冲、负绩效）：依赖 #8；口径已定为负绩效照公式出数、不归零。
|
|
||||||
- C5 增量变更发现：依赖 #13；收付款表无 `updated` 字段，需验证 rowversion 与删除/作废的发现方式，在此之前时间水位保持禁用。
|
|
||||||
|
|
||||||
### 轨道 D：交付收尾（依赖 A3 与轨道 C 完成）
|
- [x] 正式业务导入写入来源关联、输入版本和幂等保护，并衔接发货、回款与正式 `PayrollInput`。
|
||||||
|
- [x] 正式 FIFO 逐段分配、期初先冲、预收、起付比例、重算级联、固化分管/交接和经理本人排除已落地。
|
||||||
|
- [x] 月份首次生成锁、实际制作人限制、审批默认关闭、已生成工资走当月调整单已落地。
|
||||||
|
|
||||||
- 本轮前置产出 `docs/T+交付部署设计_2026-10-28.md`：首期推荐任务计划程序，明确排队、进程恢复和业务重试的区别；周任务、阈值为设计默认，外部告警通道待确认。
|
### 节点 3：运维交付能力（已完成）
|
||||||
- D1 `tplus-worker` 托管（首期采用 Windows 任务计划程序）。
|
|
||||||
- D2 每周同步任务编排与失败告警。
|
|
||||||
- D3 客户内网独立部署与最终验收。
|
|
||||||
|
|
||||||
## 验收与保留门槛
|
- [x] 每周自动排队、有限重试、心跳、停止标记和异常概况已实现。
|
||||||
|
- [x] Windows 托管任务安装/管理/启动器及隔离运行验证已通过，默认禁用且不写入凭据。
|
||||||
|
- [x] 全量与增量备份脚本改为永久留存口径，恢复演练脚本覆盖全业务表并对查询失败判为失败。
|
||||||
|
|
||||||
- 未确认项不进入正式核算；确认单未闭环前不实施业务表写入。
|
### 节点 4：最终验证与证据（已完成）
|
||||||
- 导入保护人工字段；每笔回款只核算一次；重算须授权并留痕。
|
|
||||||
- 2008 R2 验收未完成前，2022 恢复副本的结果不作为同版本兼容证据。
|
|
||||||
- 每个任务先完成定点测试再进入依赖任务；回归使用隔离的 MySQL/Redis。
|
|
||||||
- C1 尾部按 #1–#13、L1–L7、B1–B5/M1–M5、S1 列出答复回填顺序。业务答复、字段存在、同版本实测和生产部署分别验收，不能互相代替。
|
|
||||||
- S1 的暂缓加密是用户批准的当前开发阶段例外；生产敏感字段策略仍是上线前待确认项。
|
|
||||||
|
|
||||||
## 项目后续路线
|
- [x] 后端单元测试：`786 passed`。
|
||||||
|
- [x] 隔离数据库集成测试：`406 passed`，失败 0、跳过 0。
|
||||||
|
- [x] Ruff、前端 `vue-tsc`、Vite 生产构建和托管脚本隔离验证通过。
|
||||||
|
- [x] 保留 Starlette/httpx 既有弃用提醒和 Vite 大包体积提示，均不影响本次功能验收。
|
||||||
|
|
||||||
轨道 C 完成、A3 通过后进入轨道 D；部署验收通过即转入运维期（每周同步、参数调整走系统设置与版本管理）。
|
### 节点 5：更正场景收口（已完成）
|
||||||
|
|
||||||
|
- [x] 新增版本化 `CORRECTION` 事实，校验一正一负配对标识。
|
||||||
|
- [x] 更正发货保留源快照并在预演/正式导入中排除绩效；跨客户回款按原业务标识归入，并在原客户侧自动排除。
|
||||||
|
- [x] 补充前端事实录入、FIFO 单元测试和事实校验测试；客户确认的示例处理已落地。
|
||||||
|
|
||||||
|
### 节点 6：外部验收交接（待外部条件）
|
||||||
|
|
||||||
|
- [ ] 真实样本补齐分类、指导成本、运费、期初/历史已处理金额和归属依据后，完成逐笔金额核对并扩大到整月。
|
||||||
|
- [ ] 绑定目标环境实际工资制作人账号并验证生产权限；当前不使用测试账号代替生产授权。
|
||||||
|
- [ ] 在 SQL Server 2008 R2 `10.50.1600` 目标环境完成连接、查询和兼容性实测。
|
||||||
|
- [ ] 在客户目标环境完成周同步、服务托管、告警与全量/增量恢复演练。
|
||||||
|
|
||||||
|
节点 6 依赖客户资料、目标数据库和部署授权，不能用本地测试结果代替；其余仓库内开发任务已完成并进入交付等待。
|
||||||
|
|
||||||
|
用户已批准实施四阶段计划；以下原 Docker 预演计划及未完成项保留，最新业务约束以本节及客户新回执为准。
|
||||||
|
|
||||||
|
1. 权限与隔离：实际账号绑定制作人；测试库名称、显式标记和真实引擎目标同时校验；月结草稿首次成功生成即锁定该月分配，生成失败不锁，审批不解锁。
|
||||||
|
2. 正式导入：复用源快照、稳定源身份、队列及预览指纹；新增 BUSINESS_PREVIEW／BUSINESS_APPLY。重复导入跳过，新增单据追加输入版本，旧金额／日期变化保留冲突。
|
||||||
|
3. 正式核算：共享 FIFO 内核、期初先冲、预收待发货、60%起付与 R×R；正式台账逐段计提／应付差额独立记录；从指定月起可级联重算尚未生成工资的后续月份，已生成工资走当月调整。
|
||||||
|
4. 归属与输出：每次发货对应业务员与当时分管经理，离职承接未发部分；经理本人业务排除。月结、报表与导出使用固化依据，调整单结构化关联原台账及分管。
|
||||||
|
|
||||||
|
## 新回执对计划的修订
|
||||||
|
|
||||||
|
来源：`docs/客户补充回执核对_2026-10-30.md` 与原回执副本。
|
||||||
|
|
||||||
|
- 第01项已明确：同一 T+ 发货客户名头下的合同合并为一笔业务平账。正式导入按账套内客户身份聚合，保留发货层的人员／分管／交接；不再要求每合同单独平账。
|
||||||
|
- 第02项已明确：固定取发货月份指导成本，录入完成后封存，后续跨月回款不变价。
|
||||||
|
- 第03项已确认一正一负更正单排除绩效、跨客户回款归入原业务；多原单金额分配与通用日期更正仍只阻塞相关特殊分支。
|
||||||
|
- 第04项为“不涉及”：不新增保证金、代收款计提。
|
||||||
|
- 第05项最新截图已明确：保留审核能力但默认关闭；关闭时工资生成即完成且不留审批痕迹，开启时使用原财务／领导流程。
|
||||||
|
|
||||||
|
## 验收与交付
|
||||||
|
|
||||||
|
新增 V18/V19 迁移、输入版本、FIFO明细与生成锁；迁移只能在隔离库验证，正式目标环境执行另按授权边界。已实现不等于已验收：完整单元、隔离集成、类型／构建及浏览器检查的最终结果统一记在开发记录。真实样本尚缺实际资料，不填默认成本、余额或虚假验收结果。
|
||||||
|
|
||||||
|
后续保留：多原单更正、SQL Server2008R2兼容、自动周同步、服务托管、告警、目标环境全量／增量恢复演练。备份文件不再按旧30天默认自动清理；本轮未运行清理或恢复脚本，不启用生产连接，不提交／推送。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 上一阶段计划与原验收记录（保留）
|
||||||
|
|
||||||
|
# 下一阶段开发计划：Docker 基础导入与核算预演
|
||||||
|
|
||||||
|
日期：2026-10-29。按本轮用户批准计划实施。此前计划原文保留在 [历史计划](archive/2026-10-28-tplus-pre-docker-plan.md)，已有未提交内容一并保存。
|
||||||
|
|
||||||
|
## 本轮目标
|
||||||
|
|
||||||
|
恢复原 Docker 数据环境，先完成有依据的基础数据导入，再提供可追溯、可重跑的核算预演。预演不进入正式工资、月结、审批和发放。SQL Server 2008 R2 10.50.1600 兼容验收后置；虚拟机安装和屏幕控制不在关键路径。
|
||||||
|
|
||||||
|
## 已确认的开发约束
|
||||||
|
|
||||||
|
- 发货、到账日期取销货单、收款单的单据日期；销售和指导成本均含税，销售额剔除运费。
|
||||||
|
- 绩效成本使用人工月度指导价，T+ 成本只留源快照，不导入绩效成本。
|
||||||
|
- 回款采用明确分组内的 FIFO，不再强制合同关联；组范围、期初及历史已发款未明确时分别待补。
|
||||||
|
- 人员按18人回执核对，工号保留前导零；不自动指定直属经理，不按姓名合并。
|
||||||
|
- 仅导入客户性质往来单位，客户和产品核算分类允许人工维护，不做单位换算。
|
||||||
|
- 经理本人业务排除；交接与经理分管保存独立事实，不覆盖当前人员关系推算历史。
|
||||||
|
- 特殊抵顶继续线下；不创建清理任务，不新增生产账号或权限。
|
||||||
|
- 全量读取、主键分页、哈希去重继续复用，时间增量关闭。源账号无写权限。
|
||||||
|
|
||||||
|
## 实施顺序与验收
|
||||||
|
|
||||||
|
| 阶段 | 已实施内容 | 验收信号与仍缺条件 |
|
||||||
|
|---|---|---|
|
||||||
|
| P1 环境及基线 | 原三容器恢复、九类源数据读取、当前指针、只读权限核验 | 当前源933203行；新增103359个历史版本来自补读单位、客户属性及凭证关联字段。2026-10-30原生ODBC连接、九类抽样和原worker重读已验证通过 |
|
||||||
|
| P2 规则与字段 | 日期、含税、客户性质、单位、人员名单核对；业务答复与字段证据分列 | 已核实收款到总账凭证的关联；13107张已有有效凭证、75张无关联不纳入本次预演，不以审核状态代替生成 |
|
||||||
|
| P3 基础导入 | 预览、执行、唯一源关联、人工字段保护、指纹失效、异常重试 | 实际17人导入，工号101124待核实；产品分类、客户属性不足的行保留待补 |
|
||||||
|
| P4 FIFO与预演 | 期初先冲、预收、逐段分配、冻结重跑、交接、经理排除、页面与CSV | 功能验证与客户验收分开；真实指导价、分组和历史资料不足，不能宣称整月工资对账通过 |
|
||||||
|
|
||||||
|
## 最小数据与接口
|
||||||
|
|
||||||
|
V16/V17新增五张工作区表，head为 `07b8c9d0e1f2`。复用现有 `/api/v1/system/tplus` 和worker，新增事实及历史、源编号选择、工作区任务、分页明细和报告。正式核算表与预演表分开保存；原快照重跑不读取后来的成本、分类和参数。
|
||||||
|
|
||||||
|
## 业务并行事项
|
||||||
|
|
||||||
|
1. 平账范围：同客户统一还是按项目分开。
|
||||||
|
2. 指导价：单位或总成本、发货月或回款月、历史处理。
|
||||||
|
3. 历史承接：2026-02-28分组应收、已核算及已发款、8月参数。
|
||||||
|
4. 交接及经理分管：时间、业务范围、双方人员与发货归属。
|
||||||
|
5. 其他更正及特殊款：日期更正、保证金与其他职责；B04已于2026-10-30明确月度工资生成前可改、仅制作人可改、差额归调整单生成当月，不再追问。
|
||||||
|
6. 逐笔复核：先以一个资料完整的平账组核对，再扩到整月。
|
||||||
|
|
||||||
|
未决条件只阻塞相关分支；已明确的日期、含税、指导成本与工号不重复询问。客户表见 `docs/核算预演补充确认清单_2026-10-29.xlsx`。
|
||||||
|
|
||||||
|
## 首轮结束标准
|
||||||
|
|
||||||
|
真实数据可导入，逐笔过程可核对，缺口能定位。完成定点、受影响模块、隔离迁移/集成回归、前端类型/构建和浏览器检查后交付。客户逐笔验收、原生驱动、2008R2兼容与生产部署分别记录，不混为完成。
|
||||||
|
|
||||||
|
验证细节见 `docs/T+基础导入与核算预演开发记录_2026-10-29.md`；任务状态见 `tasks/todo.md`。本轮不提交或推送，保留既有修改。
|
||||||
|
|
||||||
|
## 2026-10-30首轮样本与新回复
|
||||||
|
|
||||||
|
- 用户已授权按推荐选样本：辽阳精诚物业管理有限公司，2026-03，销货SA-2026-03-0034与收款SK-2026-03-0016各1125元；一个产品、一位业务员，关联凭证0035。
|
||||||
|
- 已登记候选平账组pilot-9395-202603并运行待补预演；未确认开关保持关闭，未填默认指导成本、分类或期初余额。
|
||||||
|
- B04新答复记录见docs/二次分配修改规则确认_2026-10-30.md；更正示例另按 `CORRECTION` 事实实现，不自动扩大至任意日期更正。正式工资入口按该规则的实现与验收已列节点 2、节点 5。
|
||||||
|
- 真实字段核查纠正：SA_SaleDelivery.isCancel为结清状态枚举（428未结清、180已结清），不是作废布尔值；预演改按voucherState生效与实际红冲标志判断。
|
||||||
|
|||||||
159
tasks/todo.md
159
tasks/todo.md
@ -1,49 +1,126 @@
|
|||||||
# T+ 数据导入与同版本验收任务清单
|
# 完整权限管理实施清单（2026-11-02）
|
||||||
|
|
||||||
依照 `tasks/plan.md`（2026-10-28）。上一轮清单已归档至 `tasks/archive/2026-10-27-tplus-sync-todo.md`。
|
- [x] 按用户最新选择统一角色授权、授权版本和审计；取消个人覆盖及全局制作人绑定，工资月份锁与实际经办人留痕保留。
|
||||||
|
- [x] V22 隔离升级/回退/再升级验证及本地全库备份；后续新模块接入 V25 兼容迁移。
|
||||||
|
- [x] 用户“分配角色”与角色“配置权限”页面、统一菜单／按钮和只读提示已接入；轻动效支持减少动态效果。
|
||||||
|
- [x] 最新 31＋52＝83 项隔离专项通过，覆盖授权撤权、版本冲突、并发保护、工资锁及审核；不将切换期间旧全量结果写成一次性全绿。
|
||||||
|
- [x] 四类账号真实无模拟接口浏览器 6 项、全部路由权限覆盖及后台任务撤权通过。
|
||||||
|
- [x] 完整单元 893 项、Ruff、前端类型／生产构建及本地前后台联通通过，使用与验证文档同步。
|
||||||
|
- [ ] 并行角色改造任务完成本地 V26 应用与迁移记录；本聊天最后只读核查仍为 V25，隔离库 V26 已通过。
|
||||||
|
|
||||||
## P0 工程收口
|
---
|
||||||
- [x] 拆分提交本轮 T+ 同步管理成果（迁移、后端、前端、文档）；提交前 Ruff、单元测试、前端类型检查与构建通过。
|
|
||||||
依赖：无。
|
|
||||||
|
|
||||||
## P0.5 评审收口与交付设计
|
# 历史同步运维及样本验收待办（2026-10-30）
|
||||||
- [x] 兼容脚本复用应用 URL 与连接文件校验，补特殊字符转义回归。
|
|
||||||
- [x] 默认启用 TLS，模板说明显式回退、自签证书限制和私有配置迁移。
|
|
||||||
- [x] 补本地恢复与同步开发手册，修正 A1 的容器/虚拟机步骤。
|
|
||||||
- [x] 在现有客户版新增 S1，环境材料说明先用本地备份源同版本、生产信息后补；按用户决定保留旧 v2 删除结果。
|
|
||||||
- [x] 产出 D1/D2 托管、每周排队、重试与告警设计稿。
|
|
||||||
- [x] C1 补全每项预留决策的回填顺序。
|
|
||||||
- [x] 完成隔离全量回归（1001 项）、Ruff、文档链接与表格保留校验；分代码和文档提交交付。
|
|
||||||
|
|
||||||
## 轨道 A：同版本验收环境
|
> 2026-11-02 业务依据纠偏：第 01 至 05 项及 B04 已有当前口径。第 03 项以第二版回执和客户接受的聊天方案实施，不再向客户重复索要通用分配／日期规则；仅日后真实业务超出已确认场景时具体核实。依据见 `docs/业务规则时间线与当前口径_2026-11-02.md`。旧阶段待确认列表按历史保留，不作为当前催办清单；更正配对、排除校验、前端选择及完整流程验证仍归内部任务。
|
||||||
- [x] A1 细化 2008 R2 测试环境与验收手册（无介质可先做）。
|
|
||||||
- [ ] A2 取得合法介质并安装备份源 10.50.1600 同版本环境。
|
|
||||||
- [ ] A3 恢复原始备份并执行完整验收，产出报告。
|
|
||||||
依赖：A2 等介质到位；A3 依赖 A2。
|
|
||||||
|
|
||||||
## 轨道 B：业务口径确认
|
- [x] T1：恢复库样本资料核对包，原始证据及指纹，候选期初／空运费不自动视为零。
|
||||||
- [ ] B1 发送 `docs/客户待确认事项表_2026-10-28_客户版.xlsx` 并跟进填写。
|
- [x] T2：默认关闭的每周周期检查、持久化状态、同周幂等、手动占用协调及停机只补最近周期。
|
||||||
- [ ] B2 回填经理个人户客户群反馈结果（L6）。
|
- [x] T3：明确断连／超时 5／15 分钟最多两次重试，人工恢复衔接，独立心跳和站内提示。
|
||||||
- [ ] B3 答复回收后更新映射与暂定口径记录。
|
- [x] T4：Windows 托管包及本机隔离验证，默认预演／安装禁用，账号、权限与动作核验。
|
||||||
依赖：无；B1 立即可发。
|
- [ ] T4 环境验收：专用目标环境服务账号、实际注册、开机触发、异常重启三次和停止不重领。
|
||||||
|
- [ ] T5：首组真实金额验收；用户没有样本人工指导成本，保持待补，不填默认金额；随后再扩整月。
|
||||||
|
- [x] T6：784 项完整单元、405 项完整隔离集成、迁移往返及16项专项、Ruff、前端类型构建、合成接口真实浏览器验证。
|
||||||
|
- [x] 更新任务、样本缺口、开发记录和 Windows 操作说明，真实金额／生产启用单列。
|
||||||
|
- [ ] 取得样本所需分类、运费、期初／历史与分管的实际依据后继续核对，不索要恢复库已有单据。
|
||||||
|
- [ ] 实际制作人账号绑定、客户业务库迁移及生产自动化启用，均待目标环境确认。
|
||||||
|
- [x] 第03项方案已有第二版回执及客户接受的聊天证据；既有实现记录保留，配对、排除、防重及页面操作的内部验证继续跟踪，不新增客户规则催办。
|
||||||
|
- [ ] SQL Server 2008 R2 实机兼容、全量／增量恢复链单独验收。
|
||||||
|
|
||||||
## 轨道 C：T+ 数据导入开发
|
详见 `docs/同步运维自动化与样本核对开发记录_2026-10-30.md`。下方原阶段记录保留，自动周同步／托管／告警的开发状态以上方为准，目标环境启用尚未完成。
|
||||||
- [x] C1 起草 staging → 业务表写入设计，标注等待确认的差异点。
|
|
||||||
- [ ] C2 主数据导入实现与测试。
|
|
||||||
- [ ] C3 订单/发货/回款导入实现与测试。
|
|
||||||
- [ ] C4 负向事件处理实现与测试。
|
|
||||||
- [ ] C5 增量变更发现方案与验证。
|
|
||||||
依赖：C1 无前置，可先行；C2–C5 依赖轨道 B 闭环与 C1 评审。
|
|
||||||
|
|
||||||
## 轨道 D：交付收尾
|
---
|
||||||
- [ ] D1 worker 服务托管。
|
|
||||||
- [ ] D2 每周同步任务与失败告警。
|
|
||||||
- [ ] D3 客户内网部署验收。
|
|
||||||
依赖：A3 与轨道 C 完成。
|
|
||||||
说明：D1/D2 设计稿已产出，托管、周任务和外部告警尚未启用；生产主机条件与通道待确认。
|
|
||||||
|
|
||||||
## 检查点
|
## 前一阶段待办与证据（保留）
|
||||||
- [ ] 检查点 A：客户版业务答复完成并回填 C1（B01–B08、T01–T09）；E01–E04 按环境与正式验收节点补齐。
|
|
||||||
- [ ] 检查点 B：主数据导入通过，业务表首次写入可回滚。
|
# 当前正式工资闭环验收清单（2026-10-30）
|
||||||
- [ ] 检查点 C：全量导入与 2008 R2 验收通过，进入轨道 D。
|
|
||||||
- [ ] 上线前确认 S1 的全库敏感字段保护、保留期与备份访问策略。
|
## 本次收尾执行结果
|
||||||
|
|
||||||
|
- [x] 节点 1：接续既有计划与上下文，完成范围审计。
|
||||||
|
- [x] 节点 2：正式导入、正式 FIFO、分管/交接、工资生成锁、审批开关和调整单链路已完成。
|
||||||
|
- [x] 节点 3：自动周排队、有限重试、心跳、Windows 托管与永久留存备份脚本已完成并验证。
|
||||||
|
- [x] 节点 4：单元 `786 passed`、隔离集成 `406 passed`，Ruff、前端类型/生产构建和托管脚本验证通过。
|
||||||
|
- [x] 节点 5：客户确认的更正发货排除与跨客户回款归属已实现，并补充回归测试。
|
||||||
|
- [ ] 节点 6：真实样本、实际制作人、SQL Server 2008 R2 目标环境和正式恢复演练待外部条件满足后验收。
|
||||||
|
|
||||||
|
> 当前工作区不提交或推送；本文件只记录本次执行状态，外部验收未完成前不将项目标记为全部交付。
|
||||||
|
|
||||||
|
- [x] 加入隔离库硬校验、指定制作人身份与首次生成锁；单位／模块测试已有通过证据。
|
||||||
|
- [x] 实现正式业务导入、源身份防重、输入版本及正式FIFO逐段过程。
|
||||||
|
- [x] 实现未生成工资月份级联重算、重算原因留痕、固化分管和结构化当月调整。
|
||||||
|
- [x] 核对新回执：01客户名头合并、02发货月指导价封存、04不涉及已明确；05审核保留默认关闭；03示例处理已确认并实现。
|
||||||
|
- [x] 最终完整单元749项通过（新回执修订后）。
|
||||||
|
- [x] 最新完整隔离集成全部29文件分组覆盖，215＋184＝399项通过；V18/V19迁移往返与结构9项通过。
|
||||||
|
- [x] 前端类型、生产构建、合成数据真实浏览器表单／默认无审核入口通过；客户使用验收另列。
|
||||||
|
- [ ] 真实样本完整金额逐笔核对，再扩大到整月。
|
||||||
|
- [ ] 补录实际制作人账号并在目标环境验证，不以测试账号代替生产授权。
|
||||||
|
- [x] 第03项已确认示例的更正分支已收口；多原单通用分配及任意日期更正仍按边界保留。
|
||||||
|
- [ ] 2008R2兼容、每周同步、托管、告警和目标环境恢复演练。
|
||||||
|
|
||||||
|
以下原阶段任务及未完成项保留；其中旧“按独立业务分组”“成本月份待答复”等说法由上方新回执修订，不再重复向客户追问。
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
# Docker 基础导入与核算预演任务
|
||||||
|
|
||||||
|
依照 `tasks/plan.md`。旧清单原文保留在 `tasks/archive/2026-10-28-tplus-pre-docker-todo.md`。
|
||||||
|
|
||||||
|
## P1 环境与基线
|
||||||
|
|
||||||
|
- [x] 恢复原 SQL Server、MySQL、Redis 容器，保留数据目录和恢复库。
|
||||||
|
- [x] 九类读取完成，当前933203行，新增字段导致历史版本增加103359行，差异已解释。
|
||||||
|
- [x] 只读账号写权限为0；全量、主键分页和哈希去重沿用，时间增量关闭。
|
||||||
|
- [x] 2026-10-30用户安装ODBC18后，原生只读连接、九类抽样查询及原worker完整重读19178条通过；新增0、失败0，正式表不变。证据见docs/T+原生连接验收记录_2026-10-30.md。
|
||||||
|
|
||||||
|
## P2 字段和规则
|
||||||
|
|
||||||
|
- [x] 固定客户原始回执来源，人员事实逐行带单元格与SHA-256，不复制生产凭据。
|
||||||
|
- [x] 日期、含税、人工指导价、客户性质、源单位核对；停用T+绩效成本映射。
|
||||||
|
- [x] 18人核对：17人匹配，工号101124缺失，不按姓名合并。
|
||||||
|
- [x] 生成字段/规则差异表及六项客户补充确认表。
|
||||||
|
- [x] 字典与真实总账关联交叉核实生成凭证路径，13107张已有有效凭证，75张无关联不纳入本次预演；未审不等于未生成。
|
||||||
|
|
||||||
|
## P3 基础导入
|
||||||
|
|
||||||
|
- [x] 管理员预览、排队导入、分页结果与CSV报告。
|
||||||
|
- [x] 稳定源身份、幂等、指纹失效、人工字段保护、冲突与待补。
|
||||||
|
- [x] 实际17人导入，重复预览不新增；工资、发货、回款、台账和月结未写入。
|
||||||
|
- [x] 产品77072行及纯客户5049行保留待补，非纯客户2907行跳过。
|
||||||
|
- [ ] 客户补例单所需分类、负责人及缺失工号后，重预览并逐类导入。
|
||||||
|
|
||||||
|
## P4 核算预演
|
||||||
|
|
||||||
|
- [x] 固定快照、月份、指导成本与参数，原快照重跑可复现。
|
||||||
|
- [x] FIFO稳定顺序、先旧后新、预收余额、成本尾差与金额守恒。
|
||||||
|
- [x] 交接和经理分管独立登记，经理本人业务排除，人工分类优先。
|
||||||
|
- [x] 运费逐明细扣除，未核实不默认为0；日期更正保持禁用。
|
||||||
|
- [x] 可用页面、逐笔明细、待补说明及报告；正式核算状态保持不变。
|
||||||
|
- [ ] 客户补分组、期初、历史已发款、月度指导价和交接依据，完成一组真实业务复核。
|
||||||
|
|
||||||
|
## 验证与交付
|
||||||
|
|
||||||
|
- [x] 隔离迁移：空库升级、V17/V16回退、再次升级通过。
|
||||||
|
- [x] 完整392项隔离集成回归通过；凭证映射补入后13项相关复核通过，单元702项通过。
|
||||||
|
- [x] 新增工作区MySQL权限、事实、队列、完整预演与冻结重跑，加结构复核共13项通过。
|
||||||
|
- [x] 最终Ruff、差异空白检查、前端类型/构建与新字段页面收口。
|
||||||
|
- [x] 浏览器真实任务、7956行CSV、历史、前导零、表单取消及320/768/1024/1440宽度通过，无页面错误。
|
||||||
|
- [x] 完成最终开发记录与回归证据回填。
|
||||||
|
|
||||||
|
- [x] 凭证排除分支收口后的最终完整隔离集成回归：392项通过、退出码0，764.72秒；句柄22149已正常结束，证据.ai/workbench-regression.log。
|
||||||
|
|
||||||
|
## 2026-10-30新增回复与首轮样本
|
||||||
|
|
||||||
|
- [x] 接收B04三条明确答复，单独记录并从客户表移除重复追问，未改原始回执。
|
||||||
|
- [x] 真实查询筛选并选取辽阳精诚物业管理有限公司2026年3月一发一收样本，生成单页核对表。
|
||||||
|
- [x] 候选平账组登记，未确认开关关闭，待补预演PARTIAL，正式表不变。
|
||||||
|
- [x] 实测结清枚举，修复非零结清状态被误判作废；最新单元710项、完整隔离集成392项、相关集成与结构13项、前端构建和真实样本页检查通过（规则2026-10-30.1，完整回归795.36秒、退出码0）。
|
||||||
|
- [ ] 收到样本分类、指导成本、运费、期初/历史款及归属答复后，完成实际金额预演。
|
||||||
|
|
||||||
|
## 后续阶段（本轮不计完成）
|
||||||
|
|
||||||
|
- [ ] SQL Server 2008R2 10.50.1600兼容验收。
|
||||||
|
- [ ] 负向事件正式处理、正式工资生成、月结和发放联动。
|
||||||
|
- [ ] 时间增量、自动周同步、服务托管与告警、生产授权及部署。
|
||||||
|
|
||||||
|
- [ ] B04正式功能：按月度工资生成节点锁定、按实际工资制作人限制修改，已结算差额归调整单生成当月；已有业务角色或审批权限不能代替此项验收。
|
||||||
|
|||||||
15
tasks/需求补齐计划_2026-11-02.md
Normal file
15
tasks/需求补齐计划_2026-11-02.md
Normal file
@ -0,0 +1,15 @@
|
|||||||
|
# 需求补齐实施计划（2026-11-02）
|
||||||
|
|
||||||
|
依据用户批准的完整计划实施，不覆盖原有部署、权限及监控工作。原需规 16 个小节的页面能力均纳入最终对照。
|
||||||
|
|
||||||
|
- [x] F07 系数表维护、阶段／户型／产品分类、Excel 模板／预览／确认／导出、版本历史与对比。
|
||||||
|
- [x] F01/F02 正式核算、预演及试算统一取参；企业户分类比例、信息员销售额计提。
|
||||||
|
- [x] F03 基本工资按人一次、无绩效发薪、试用期日期及缓发台账、年终和跨年续付、页面及导出。
|
||||||
|
- [x] F04 指导单位成本与总成本校验、毛利润视图联动及历史封存保护。
|
||||||
|
- [x] F05/F06 最近有效发货数量／单价与来源、人工保护、业务提取产品预览／执行及页面。
|
||||||
|
- [x] 增量迁移及初始化同步、单元／隔离集成、类型／构建／浏览器验证。
|
||||||
|
- [x] 新版 Word（原 16 小节）与逐项实现／验收记录，原文保留。
|
||||||
|
|
||||||
|
已确认口径：系数由公式生成并以参数版本为唯一来源；试用期仅累计试用期间计提，18000 元超额同时受业务起付和平方权重限制；产品展示最近有效发货数量及含税成交价，附来源。实际资金支付、未明确的通用多原单更正、生产启用不在本次范围；不提交或推送。
|
||||||
|
|
||||||
|
验收证据：899 项单元通过；32 个集成文件分组 A211＋B213 通过，年度续付专项5项通过；类型／构建／Ruff及9组真实浏览器操作通过；Word保留16小节并渲染5页检查。详细边界见 docs/需求补齐实施与验收记录_2026-11-02.md。
|
||||||
Loading…
Reference in New Issue
Block a user