liuwenxin/PayrollManagementSystem
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
63 Commits 9 Branches 0 Tags 9 MiB
8ef26e22fb
Commit Graph

10 Commits

Author SHA1 Message Date
liuwenxin
8ef26e22fb feat(approval): 审批单/节点状态机与二次分配接入（开关自动通过） 
- approval_orders/approval_steps 服务层：submit_order（不 commit 不嵌套
  audit，业务写路径统一收口）+ act 节点动作 + 分页/详情
- 开关关闭=提单即两级「自动通过」留痕（action=3，operator 记系统）；
  开启=财务→领导流转，一驳全驳，驳回必填意见
- 节点准入严格按角色（status=1 仅财务、status=2 仅领导），admin 不代办；
  模块准入 require_roles 依赖工厂（admin/finance/leader，营销后勤待
  澄清 #6 后放开）
- 业务接入：创建/编辑带方案即提单（空方案不提单）；再编辑自动撤回旧
  在途单（node=0/action=4 留痕）；AP 编号冲突 create 内可重取（外层
  重试兜底）、update 直接抛出防静默丢失
- conftest 兜底清理增审批单（AP 前缀）与开关参数种子基线恢复
- 集成 11 例：自动通过/两节点流转/驳回留痕/缺意见 400/节点准入 403/
  admin 不代办/重复操作 400/撤旧建新/模块准入

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 18:50:38 +08:00
liuwenxin
680661a80b feat(allocation): 二次分配方案录入/替换/终态门槛（分摊计算待澄清另批） 
- SecondaryAllocationIn/Out：比例走金额红线口径（str 入参、两位小数、
  超 100 拒绝不静默舍入）；参与人 schema 层去重（uk 前置友好提示）
- create/update 同事务写入（replace_allocations，先删后 flush 再插——
  uk 表防御写法）；create 放编号重试循环内，rollback 后方案随业务重来
- 人员在职复用 ensure_active（label=分摊参与），personnel_name 冗余固化；
  FK RESTRICT：被方案引用人员禁删，方案回显不静默失联
- 合计不强制 100%（需求原文）：详情 allocation_hint 只展示合计/余额，
  余额归属待澄清 #2 不落库
- 单测 13 例（比例边界/去重）+ 集成 9 例（回显/替换清空/离职 400/
  终态禁改/RESTRICT 保护）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 18:31:27 +08:00
liuwenxin
60f6af6494 refactor(repos): 归属留痕共享数据访问，人员在职校验收口单点 
- ownership_log_repository：客户/业务两侧逐行同构的 list/count/add
  收口（owner_type 与引用列参数化），双键倒序与被删人员兜底口径
  单点维护；两侧 repository 变薄包装，service 层零改动
- PERSONNEL_STATUS_ACTIVE 单点导出于 models/personnel（对照
  BUSINESS_STATUS_* 先例）；业务/客户两侧的「存在且在职」校验收口
  于 personnel_service.ensure_active——此前两份常量+校验仅靠注释
  维持同步，在职判定调整时会两入口口径分叉；校验放 service 层遵守
  「repositories 不抛业务异常」红线

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 09:49:53 +08:00
liuwenxin
e6c2c71d1b fix(business): 行金额乘积显式两位固化，计提比例对负天数钳制 
- 明细行金额（数量2位×单价4位可产 6 位小数）直写 DECIMAL(14,2) 被
  MySQL 静默舍入且回显漂移（创建响应读内存值、复查读库值不一致）；
  显式 quantize HALF_UP 固化，舍入方向与 MySQL 一致（业务/发货同改）
- 先款后货回款（payment_days 为负）线性外插会算出高于起始值的计提
  比例（多算绩效）；钳制到 0 天按起始比例计提，payment_days 出参仍
  照实输出负值（口径：2026-10-14 用户裁决）
- 新增 formula 负天数钳制单测与 quantize 回显/库值一致性集成用例

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 18:58:30 +08:00
liuwenxin
91fc6f6293 fix(product): 删除引用保护/单价小数位校验，IntegrityError 全局兜底转 400 
- delete_product 补 count_refs 引用检查（业务明细+发货明细 RESTRICT
  外键）与并发窗口 IntegrityError→400 兜底（customer 先例同构），
  docstring 与两个 api 层过时注释同步更新
- 产品 schema 复用 schemas/business._check_amount：sale_price 走
  (PRICE_MAX, scale=4)、stock_quantity 走 AMOUNT_MAX——此前私写
  _parse_non_negative 不查小数位与容量，5 位小数被 Numeric(14,4)
  静默截断（舍入即算错钱）；新增 6 个秒级 schema 单测锁定口径
- 全局注册 IntegrityError handler：漏补引用保护的删除类操作收敛为
  400 通用文案（e2e 撞见一个补一个的模式无法保证全覆盖），完整
  异常记日志；rating/customer 的「非 1062 按 500」注释同步更正

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 18:48:32 +08:00
liuwenxin
6d612daf30 fix(business): 编辑/流转/归属加锁与终态编辑门槛，has_docs 单点收口 
- get_with_names 加 for_update 参数：update/change_status/change_ownership
  以锁定读取行，与发货/回款写路径同一锁口径——「有发货禁换客户」的
  快照读校验不再被并发新增发货旁路（此前 delete 有锁、唯独编辑无锁）
- update_business 补终态门槛（明细/汇总是 M3 核算基线，与发货/回款
  服务禁写终态同口径）；前端编辑按钮按终态禁用并加 tooltip
- 新增 business_repository.has_docs（单条 OR exists）：替换 update
  换客户与 delete 两处内联双查询，M3 新增挂靠单据类型时只改一处
- 出参组装复用首查 row：change_ownership 的姓名侧按「变更项取校验
  函数返回的新人名、未变项沿用首查名」处理（首查名是变更前快照）
- 新增终态编辑 400 且明细未动的集成用例

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 17:30:21 +08:00
liuwenxin
a0086554b1 refactor(core): 1062 唯一键冲突判定收口至 core/db_errors 
六个 service 各自复制的 _is_duplicate_entry（口径已漂移：rating/product
用 _ERR_DUP_ENTRY 常量、其余四处写字面量 1062）收敛为共享函数；
is_duplicate_entry 语义与文案注释各处保留，非 1062 完整性错误仍原样
上抛由全局处理器收敛。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 15:17:00 +08:00
liuwenxin
5a3778a424 fix(business): 唯一键冲突重试改为审计上下文内循环，单条审计无递归 
三处 create（业务/发货/回款）的 return _retry_create 是吞异常后正常
退出：外层审计把已回滚的首次尝试记成 success（假成功），重入整个
create_* 违反 audit_service「不支持嵌套」约定，且 _NO_RETRY 死常量
导致持续冲突时无界递归至 RecursionError。改为 audit 内 for 循环
（上限 _NO_RETRY），rollback 后重新锁行与取号，成功/最终失败各恰好
一条审计。新增集成用例锁定两条路径的日志增量。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 15:09:05 +08:00
liuwenxin
ca4cc72eea test(business): 业务数据管理模块集成用例（70 例）与两处缺陷修复 
- 覆盖：编号格式与序号递增/状态机终态拦截/三处汇总冗余一致性/跨业务批次
  400/已核算禁改禁删/毛利润金标准与防除零/asOf 回溯/评级重叠/审计双记录
- 缺陷修复①：change_status 留痕 old_status 取到赋值后属性（时间线失真 3→3）
- 缺陷修复②：freight_amount 漏金额校验（负数/三位小数可落库污染运费合计）
- conftest 扩展业务六表清理（编号前缀 + FK 逆序收口）与评级种子基线恢复
- 全量回归 603 passed（单元 381 / 集成 222）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 13:39:09 +08:00
liuwenxin
0cdc6246c4 feat(business): 业务管理接口（编号生成/明细/状态机/归属留痕/毛利润视图） 
- 编号 YW{日期}-{序号}：MAX+FOR UPDATE 并发安全 + 1062 兜底重试（no_generator 三单据共用）
- 明细全量替换重算五项汇总冗余；销售额服务层按数量×单价固化不信任前端
- 状态机终态拦截、终止必填原因、创建写首条留痕；归属变更同事务留痕防旁路
- 毛利润视图按行实时计算（不含运费 #2），阈值按 asOf 取 M1 快照，率输出
  Fraction 分数字符串同 M1 预览口径；成本缺失行标注无法计算
- 入参契约统一为蛇形直出（撤回 customer/business 的驼峰 alias，与前端
  businessRoles.ts 模式对齐）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:01:48 +08:00