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

79 Commits

Author SHA1 Message Date
liuwenxin
efed29647c feat(settings): 公司信息配置与 logo 管理（public 端点供登录页） 
- system_settings 单行 CRUD：GET/PUT（AdminUser）+ GET /public（无鉴权，
  SettingPublicOut 白名单仅 company_name/logo_url 两字段，短缓存 300s）
- logo 上传：后缀+magic bytes+2MB 三重校验，固定名覆盖落盘 uploads/logo/
  （不使用上传方文件名，杜绝路径拼接）；旧扩展名文件清理；文件流端点
  no-cache，URL 带 update_time 版本参数破缓存
- logo 存目录不存库：图片入 DB 让每次读取与 mysqldump 放大传输且无法
  独立替换；DB 只持一行相对路径
- 新增依赖 python-multipart（FastAPI UploadFile 必备传输层）；.gitignore
  增 backend/uploads/ 与 db/backups/
- 集成 11 例：单行语义/白名单字段/三重校验/越权 403/匿名 401/审计留痕

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 18:22:12 +08:00
liuwenxin
acf87fdfdc feat(migration): V6 系统设置/二次分配/审批表与角色参数种子 
- 新增 system_settings（公司信息单行）/ business_secondary_allocations（二次
  分配明细，比例不强制合计满额，分摊计算待澄清另批）/ approval_orders+
  approval_steps（三级审批状态机，开关关闭自动通过留痕）
- roles 种子新增营销后勤/财务/领导三职能角色；内置保护改 BUILTIN_ROLE_CODES
  白名单（roles 表无 is_builtin 列，不加列）
- PARAM_REGISTRY 首例 BOOL：两个审批开关（16→18 项，种子双写）
- 双轨同步：V6 导出 SQL + init-dev.sql（表/索引/种子/版本号 79bcc5aa98d4）
- 测试同步：EXPECTED_TABLES 四新表、角色种子断言 5 角色、目录断言 18 项
  八分组、BOOL 校验边界；迁移 downgrade 修 1553（只保留 drop_table）并补
  行级种子反向清理

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 17:25:23 +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
5ef48abf47 test(schema-sync): 迁移链按序重放 ALTER，比对基准由历史并集改为终态 
早前实现把全部 V*.sql 的 CREATE 列做并集：某表日后被 ALTER DROP
COLUMN 时并集里旧列名永存，init-dev.sql 必须保留死列才能过测——
守卫会主动背书一份与生产结构漂移的开发库 DDL。按文件序重放
ADD/DROP COLUMN 后比对基准为迁移链终态；列改名（CHANGE）出现时
重放报差异属人工核对时机（改名同时牵动 init-dev 与 ORM）。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 09:24:34 +08:00
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
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
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
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
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
64c57e9141 fix(no_generator): 编号 MAX 检索改长度优先排序，破解位宽进位后字典序失效 
跨位宽（-9999→-10000）后纯字典序反转，MAX 恒取旧值导致当日建单
持续撞唯一键；同前缀下长度大即数值大，同级同长时字典序与数值一致。
新增跨位宽/同宽/空表三个集成用例。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-14 14:09:30 +08:00
liuwenxin
d77728265b docs(business): M2 收尾——e2e 记录、缺陷表、AI_CONTEXT 摘要更新 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 17:13: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
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
899bf3afa5 docs(test): 基础数据模块测试记录（48 例/审计盲区缺陷/待补用例更新） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 11:24:29 +08:00
liuwenxin
20fcf06f51 feat(business): 新增业务数据七表及 V5 迁移（业务/明细/状态留痕/发货/回款/评级配置） 
- businesses 五项汇总冗余列服务层事务内维护；毛利润不落库（派生值，M3 台账固化）
- 行级 product_category 折算锚点（#14）；回款 settlement_status 预置为 M3 防重锚点
- 评级等级种子四条（迁移+init-dev 双写）；编号前缀常量 YW/SH/HK
- 双轨 SQL 同步（V4/V5 重导，schema_sync+test_models 164 例全绿）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 11:22:34 +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
f22d14e439 feat(base): 新增基础数据六表及 V4 迁移（人员/辐射区域/拓展计划/产品/客户/归属留痕） 
- TPlusSyncMixin 统一 T+ 同步预留四列（可空+普通索引，唯一键待 IT 定键后升级）
- 留痕表实体 ID 无外键冗余固化，删除保护由服务层承担
- init-dev.sql 同步六表 DDL，alembic_version 标记更新

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 09:49:05 +08:00
liuwenxin
8668e58c30 test(system): 补交岗位角色与参数管理集成用例（M1 遗漏入库） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 09:26:08 +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
6219698a39 test(system): M1 参数体系集成用例、e2e 脚本与文档更新 
- 集成用例 26 项：岗位角色（CRUD/内置保护/权限）+ 参数管理（目录回溯/变更生命周期/值校验/预览金标准）
- 361 天分界断言按 Fraction 数值比较（4/1000 自动约分为 1/250，值相等）
- e2e param_management.py：7 步全通过（含预览金标准 27 天/9.7‰/145.5 元）
- 结果卡补「计提比例」精确分数行（对账透明）
- 三份 README 更新：接口职责/AI 摘要/M1 用例清单与运行记录/e2e 记录

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 01:05:07 +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
liuwenxin
5ed5665a54 feat(system): 计提公式模板注册表与精确分数计算函数 
- formula.py 八个纯函数：回款天数（首日计1）、业务员分段递减（360=6‰/361=4‰）、折算毛利润额化简式（防除零）、乘法方向绩效、以物抵顶/R×R/起付
- param_registry.py：16 项参数元数据（与迁移种子同源）+ Fraction 精确解析（4/360 禁截断）+ 类型/取值域/枚举校验
- calc_templates.py：5 个公式模板注册表（岗位绑定的受控集合）
- 新增 43 项单元用例：精确分数断言（899/90000、27 天、9/25），畸形值拒绝

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 16:22:32 +08:00
liuwenxin
bc019cadf5 feat(system): 新增岗位角色与计提参数四表及 V3 迁移 
- business_roles/param_definitions/param_change_batches/param_values 四表 + 种子（3 内置岗位/16 参数定义/19 版本条目/初始批次 P20260101-00）
- 双轨迁移：Alembic bfbda9c3191d + db/migration/V3 导出 + init-dev.sql 同步（schema_sync 校验通过）
- 参数值以 Fraction 可解析字符串存储（4/360 禁 0.011111）；企业户 2‰→3‰ 双种子支持按到账日回溯

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 16:13:13 +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
ad5fe4a411 feat(system): 新增操作日志表与 V2 迁移 
需求 2.5.1 要求记录用户管理操作，先落表结构：

- operation_logs 表：冗余 username 保证账号删除后仍可追溯，
  user_id 外键 ON DELETE SET NULL，success 默认 '0' 与 login_logs 口径一致
- 截断常量（USERNAME/ERROR_MESSAGE/REQUEST_DATA）集中定义，供写入方引用
- 修复既有 V1 迁移与迁移模板的 downgrade：索引是外键唯一支撑索引，
  先 drop_index 会报 errno 1553，改为只 drop_table
- 同步 db/migration/V2 与 init-dev.sql，迁移版本号更新为 a45a8087831b

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-10 10:44:05 +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