liuwenxin/PayrollManagementSystem
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
128 Commits 9 Branches 0 Tags 9 MiB
5ece9f6dab
Commit Graph

8 Commits

Author SHA1 Message Date
liuwenxin
5ece9f6dab refactor(backend): 仓储层散参数收敛为查询 DTO 
仓储层的 list_*/count_* 此前以 keyword/status/offset/limit 四五个散参数
传参，调用点重复铺开、易漏传且不可扩展；按项目「参数 >4 封装 DTO」的
约定统一收敛为各模块的 Query 对象（如 RoleQuery、BusinessQuery），
服务层与测试调用同步调整，行为不变。

- repositories 层查询方法签名改为 (session, query)，分页与筛选条件
  由 Query 承载，_apply_filters 同步收口
- schemas 层补齐各模块 Query 模型（approval/business_role/report 等）
- services 层调用点同步改为传 Query
- tests 随之调整；新增用例：待办角色流转（财务通过后领导出现待办）、
  参数预览顺序稳定

验证：全量 pytest 900 passed（11:08）；单元 526 passed；ruff check 绿。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-22 19:43:20 +08:00
liuwenxin
a5c86640e2 feat(migration): V7 核算台账/月结/调整单四表与核算纯函数 
- V7 四表：performance_ledgers（append-only 版本行，uk(receipt_id,calc_version)
  库级防重兜底）/monthly_settlements（月份 uk，通过即锁定终态）/
  settlement_items（按人固化可负工资，uk 三列）/adjustment_orders（TZ 单号）
- registry +1：approval.adjustment.enabled（19 项，BOOL 首组扩至三开关）
- formula 补核算纯函数：clamp_weight_r（从预览内联提取共用）/monthly_salary
  三口径/probation_annual_note/manager_team_share（#12 暂口径：基数不含
  经理个人户业绩，聚合集中一处答复后只改）
- 迁移 downgrade 只保留 drop_table+alter 回滚+种子行反向 DELETE；
  performance_ledgers 表名复数（test_models 红线断言）
- 断言同步：EXPECTED_TABLES 四新表/registry 19/BOOL 三开关/conftest
  清理四新表与 ParamValue 边界 22
- schema_sync+全量单测 460 passed

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-16 16:32:32 +08:00
liuwenxin
f75a9d534e refactor(test): 集成工厂上提共用，submit_change 拆校验段，审计重试断言对齐全局兜底 
- tests/integration/factories.py：回款/发货两文件逐字重复的
  _customer/_bitem/_bpayload/_create_business 上提（t_ 前缀与默认行
  口径单点维护）；test_audit_retry 的持续冲突断言由 500 更新为
  400「数据完整性冲突」——全局 IntegrityError handler（批 6）收敛
  行为属预期改进，非回归
- param_service.submit_change 拆出 _normalize_items（校验段独立，
  主函数降至 50 行约定内）；e2e 六个列表页 helper 收口 common.py
  （base_data 版为准：分组参数化、:text-is 精确匹配），两脚本变薄
- 全量回归 625 passed（基线 603 + 新增 22）；e2e 四链路（登录 8/
  系统管理 13/基础数据 13/业务 16）全过
- 测试 README 补 2026-10-15 运行记录与 10 条评审缺陷（预览千分比/
  审计假成功/字典序 MAX/无锁编辑/删产品 500/schema 口径/quantize/
  负天数外插/评级并发/大小写不对称）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 10:58:44 +08:00
liuwenxin
409e26614f refactor(business): 编辑出参取校验返回值省重查，submit_change 批量预载 
- update_receipt 取 _ensure_shipment_of_business 返回值组装出参
  （shipment_id 已赋为 payload 新值，与 get_with_refs 重查同源），
  省一次三表 join；update_shipment 同理取锁定行的 business_no
- 删 business_repository.count_items（无任何调用的死代码，删除保护
  实际走 has_docs）
- submit_change 校验段定义与岗位各一条 IN 批量预载（逐条查询在批次
  扩大时是写侧 N+1）；岗位字典键 casefold 归一保持与单条版 ci 校对
  等价的命中语义；旧值留痕保持逐条（窗口函数优化留待 M3 一并设计）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 09:32:35 +08:00
liuwenxin
cb977979da fix(param): 预览千分比换算/版本号复用 next_no/维度规范值落库/冗余提交清理 
- 企业户与信息员预览分支把 ‰ 存储值当纯比例直接相乘，绩效金额放大
  1000 倍；补两个岗位路径的精确数值用例（既有用例仅覆盖业务员路径）
- 批次版本号改用 no_generator.next_no（MAX FOR UPDATE 锁当日区间），
  移除无锁全拉重造的 _next_version_no（依赖前一笔的长度优先排序）
- 岗位维度值经 ci 校对命中后以库里规范 role_code 落库，防快照字典
  精确匹配静默不命中；变形大小写提交补回读断言
- 删正常路径冗余双 commit；支付权重 R 封底封顶口径注释声明

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 14:20:05 +08:00
liuwenxin
fbf044f240 fix(system): code-review 15 项修复（预览基数/维度校验/脱敏穿透/并发版本号等） 
- 信息员预览基数改用本人销售额（原误用折算毛利润额，金额算错且口径自相矛盾）
- 产品类别入参与维度值加存在性校验（拼错静默回退默认阈值 30% 会算错轨交工资）
- submit 校验顺序前置查库（未注册 param_code 由 500 修正为 400）
- 金额拒绝 NaN/Infinity（比较抛 InvalidOperation、计算抛溢出均穿透为 500）
- version_no 并发冲突翻译为 400（对齐 user/role service 的 IntegrityError 处理）
- 旧值留痕改取条目生效日时点的值（多未来批次下留痕链不再错位）
- 脱敏红线：phone/mobile/id_card 键名整值抹除 + 手机号正则兼容分隔符写法
- 前端：撤回按钮与导出文件名改本地日期（UTC/本地混算）、维度行内精确「改」入口、
  detailOf 补 catch、抽屉分页 size 生效、blob 错误读出真实 message
- e2e 密码移除硬编码 fallback（缺失即报错退出）；按钮文案同步「改」
- 全量回归：后端 406 + 集成 104 + 前端 type-check/build + e2e 7 步 全绿

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 02:28:20 +08:00
liuwenxin
8ad3650dd3 feat(system): 计提参数版本管理、变更留痕与计算预览接口 
- 9 个端点：目录快照(asOf)/单参数历史/变更批次提交与撤回/批次分页与明细/两日期对比/Excel 导出/计算预览
- submit_change 全量前置校验（注册表/维度岗位/取值域/同批去重）→ 建批次 → 逐项留痕（旧值取提交时生效值）
- 撤回：FOR UPDATE 锁行 + 已生效禁撤，删除后解析自然回退；同日多次变更取最新留痕
- 预览按岗位模板分派公式（经理聚合口径明确拒绝），出参含所用参数与生效时点；导出走 openpyxl
- ECharts 决策记录：前端统计图使用 echarts（用户指定）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 20:24:17 +08:00
liuwenxin
1b3509b20f feat(system): 计提参数按业务日期时点化取值服务 
- param_repository.resolve_values：窗口函数一条 SQL 取全量快照（同日多次变更取 effective_date DESC, id DESC 首条）
- param_service.ParamSnapshot：冻结快照 + 覆盖链（角色 > 产品类别 > 默认行）+ 注册表默认值兜底；fraction/integer/boolean/text 类型化取值
- 12 项单元用例：覆盖链优先级、兜底、同日取最新、冻结不可变

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 16:27:56 +08:00