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

20 Commits

Author SHA1 Message Date
liuwenxin
c2b462df3b fix(rating): 区间重叠判定改用锁定读取，防并发重叠双提交 
先查后写无锁时，两管理员并发提交重叠区间互判不重叠而双双入库
（区间重叠无唯一键可拦，同一总分命中多等级且结果取决于插入顺序）；
判重叠的 list_all 加 for_update 锁全表行串行化并发判定，只读直出
list_grades 不加锁。SQL 形态用例锁定两条口径。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 19:01:11 +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
9a70264b51 style(backend): ruff format 统一此前批次的排版残留 
纯排版无行为变化（ruff format 重排 7 个此前批次的文件），
涉及模块集成回归全绿（67 passed）。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 18:46:43 +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
fba8cfc215 fix(business): 删除保护补齐与单价小数位口径修复（e2e 发现） 
- 客户删除保护：被业务引用 → 400（T4 占位注释在业务表就位后漏补，FK 500 暴露）
- 人员删除保护：业务归属（负责/协助）引用纳入检查（同样漏检 500）
- schema 单价类列（DECIMAL 14,4）小数位放行至 4 位：回显 '5000.0000'
  原样提交被两位校验永久拒收（编辑任何带精度单价的历史行都失败）
- 补 2 个集成用例锁定；文案同步「客户归属或业务归属引用」

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 17:06:46 +08:00
liuwenxin
a02b6c3ec8 feat(business): 回款管理接口（批次号/手动指定批次/已核算禁改/合计回写） 
- 批次 HK 生成；shipment_id 同业务强校验（统一失败面防探测）
- 已核算回款禁改禁删（M3 防重锚点）；payment_days 派生（发货日首日=第 1 天）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:25:34 +08:00
liuwenxin
4aea2be103 feat(business): 发货管理接口（发货单/明细/运费/汇总回写/删除保护） 
- FOR UPDATE 锁业务行防发货/回款并发丢失更新；终态业务禁新发货
- 行金额服务层按数量×单价固化；明细行 remark 按设计定稿移除（冒烟修复）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:25:33 +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
liuwenxin
1625907380 feat(business): 客户评级等级映射配置接口（区间重叠判定/名称唯一） 
- 判定=按 sort_order 升序首个 min_score≤总分，边界相邻不算重叠
- 新增同样执行重叠判定（判定表语义下插出重叠即脏配置）
- 等级配置无下游引用（评级为纯计算器，对照表 #25），允许清空

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:01:47 +08:00
liuwenxin
ca88ee7a0b test(base): 基础数据管理模块集成用例（48 例）与审计盲区修复 
- 覆盖：401/引用校验/删除保护/子表全量替换/类别与组合唯一/归属变更留痕/审计双记录
- 缺陷修复：personnel/product/customer 三 service 的前置校验移入审计上下文，
  校验失败（400）同样留痕（成功与失败都记的既定原则）
- conftest 兜底清理扩展到 M2 五表（留痕无外键，按 operator_name + 前缀双轨清理）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 11:22:34 +08:00
liuwenxin
b8ba9e4626 feat(base): 客户管理接口与归属变更留痕（不回溯历史） 
- 归属变更同事务更新主表+插留痕；归属调整唯一入口防旁路

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 10:35:04 +08:00
liuwenxin
7eeed85c96 feat(base): 产品管理接口（类别校验/组合唯一/启停） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 10:35:03 +08:00
liuwenxin
a694570dd1 feat(base): 人员管理接口（岗位/工资标准/团队/辐射区域/拓展计划） 
- 删除保护：被团队成员/客户归属引用禁删，引导改离职
- 子表全量替换采用 clear 后立即 flush 防御写法
- 工资标准字符串进出，超两位小数拒绝而非静默舍入

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 10:35:02 +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
7a0f3f4b98 feat(system): 业务岗位角色管理接口与保护规则 
- 四层实现：仓储（FOR UPDATE 锁行 + 引用计数钩子预留）/ schemas / service / api 共 7 个端点
- 保护规则：内置岗位禁删禁停、编码创建后不可改、模板须在注册表内（未注册 400）
- 写操作全走审计上下文；冒烟验证 7 项（含成功/失败双路径落日志）
- 端点：列表/新增/详情/编辑/删除/启停 + meta/templates 模板下拉

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 16:39:08 +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
liuwenxin
c83287819a feat(system): 完成后端系统管理（审计/角色/操作日志/日志查询） 
- 操作日志审计机制：audit 上下文（成功与失败都记、独立提交、操作人标量
  固化、commit 后查询前置约定），用户/角色全部写操作接入；request_data
  按键名的结构化脱敏 + UTF-8 字节边界截断
- 角色管理：CRUD 与启停；admin 禁删禁停、有绑定禁删（FOR UPDATE 锁行）、
  编码创建后不可改、停用角色不可再分配
- 日志查询：操作/登录两端点，列表与详情两段式（详情含已脱敏请求参数）；
  时间参数统一转本地 naive（修混用时区 500 与偏移丢弃）
- 用户管理：补齐 reset_password 操作人、编辑空串归一 NULL、并发唯一键兜底 400
- 测试 301 例全绿（单元 223 / 集成 78）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-10 16:28:04 +08:00
liuwenxin
e22c4bcdc9 feat(system): 实现用户管理接口 
需求 2.5.1 用户账号管理，全部要求管理员权限（require_admin 依赖）：

- 接口：列表/详情/新增/编辑/删除/重置密码/启停/角色下拉，
  角色下拉放 /users/meta/roles 以避开 /{user_id} 的路由匹配冲突
- 删除、禁用、改角色三处自我保护：不允许对当前登录账号执行，
  避免管理员误操作后立刻失去全部管理权限且无法自行恢复
- 重置密码与禁用均提升 token_version，使已签发令牌立即失效，
  不依赖 Redis 黑名单
- 密码按字节数校验（bcrypt 5.0 硬上限 72 字节，中文一字 3 字节）
- 用户列表按 id 倒序：create_time 为秒级精度，同秒数据分页结果不确定
- 修复 replace_roles 未同步关系集合的缺陷：改用 user.user_roles
  集合追加，此前 session.add(UserRole(...)) 会表现为保存成功但返回空角色
- update_user 的自我保护原先依赖返回 None 的占位函数，恒不生效，
  改为显式传入 operator_id

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-10 10:44:13 +08:00
liuwenxin
273ebf4657 chore: 初始化项目结构与登录鉴权模块 
后端 FastAPI 六层结构（api/services/repositories/models/schemas/core），
统一响应信封、全局异常、日志脱敏；6 张表经 Alembic 迁移建库，SQL 留存
db/migration；登录鉴权含图形验证码（Redis GETDEL 防重放）、JWT、登录限流、
登出黑名单（TTL=令牌剩余有效期）、登录日志。

前端 Vue3 + TS + Element Plus 骨架，含登录页、路由守卫、请求封装与 Vite 代理。

工程配置：uv 锁定 Python 3.12、ruff 检查与格式化、editorconfig、gitattributes。

测试 184 项（单元 155 / 集成 29）全绿，浏览器端到端 8 项通过。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-09 18:46:36 +08:00