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

17 Commits

Author SHA1 Message Date
liuwenxin
15de81dd2c feat(base): 挂载基础数据路由 /api/v1/base/* 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 10:35:04 +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
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
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
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
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
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