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

12 Commits

Author SHA1 Message Date
liuwenxin
6ff202d637 feat(dashboard): 工作台四区块实时聚合与风险预警参数 
- 后端 /api/v1/dashboard 单端点返回四区块：经营总览（绩效/应付/人数/团队数/月结状态/近 6 个月趋势）、待办（待审批 + 回款未指定批次 + 同步显式降级）、风险预警（回款逾期/审批超时，阈值参数化）、最近动态（操作日志）
- dashboard_service 实时派生（不落表、不引调度器）；参数快照一次解析；总览只做 SQL 聚合，不复用报表的重查询
- V10 迁移新增预警参数三项（warning.enabled / warning.receipt.overdue.days=90 / warning.approval.timeout.days=3），参数注册表 19→22，init-dev 与 V10 SQL 双轨同步
- 测试：test_dashboard 5 例（权限文案/总览对账+非法月份 400/待办三类/预警命中与参数关闭/动态来源）；全量 852 passed
- 依赖闭包并入：core/month.py 月份校验、api/v1/base/business_roles.py（router 已挂载的岗位只读端点）、test_month_validation
- 修复：alembic --sql 在 Windows 按控制台 GBK 输出，V10 SQL 以 UTF-8 重新导出（README 已记）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 18:44:15 +08:00
liuwenxin
76ded6d5ec fix(m3): code-review P1——锁定不变量、入结回填与双轨漂移 
- 月结锁定拦截补全：原仅新增回款一处，现覆盖回款编辑（原月+新月，防跨月
  搬数）/删除、发货新增（按发货日）/编辑（原月+新月）/删除、核算与重算
  （已审定月份金额只走调整单）；拦截先于「被引用/已核算」判定
- 台账 settlement_id 回填落地：generate 在 replace_items 后回填纳入行、
  重生成前先解绑（clear_ledger_settlement_id）——不回填/不解绑会让
  「未入结」判据失效：重生成漏算整月或把已固化行反复计入
- 经理聚合行落库：原只进内存参与 items 汇总，台账表永远无 calc_type=2
  行、报表下钻落空；重生成先作废旧聚合行（deactivate_month_aggregates），
  _confirm_scope 限定计算类型避免聚合行混入单笔池
- 月结取参锚定所属月月末（_month_end）：原用 date.today()，补生成历史
  月份时分成/月工资口径随生成日漂移；聚合行 receipt_date 同步为月末
- generate/submit 出参固化前置到 commit 之前（commit 后 SELECT 失败会把
  已生成的月结记成失败审计，与库中事实相反）
- V9 迁移：business_secondary_allocations 唯一键条件式补齐（幂等裸 SQL，
  临时库验证「无键→补」「有键→跳过」两分支），修复旧 V6 升级库拿不到
  V6 就地加入的约束；V8 迁移 revision 声明补类型注解（原格式漂移使
  schema 同步测试的 head 推断静默漏检 V8）；init-dev 版本号推进至 V9
- V7 留存 SQL 约束/索引名单数改复数（与 alembic op.f 与 init-dev 对齐，
  消除 SHOW CREATE TABLE 双轨漂移）
- 测试：显式控制审批开关（不依赖 V8 翻转后的种子默认值）；新增回归 8 例
  （回填落库/聚合不重复/月末取参/月末纯函数 5 例/锁定拦截回款与发货与
  核算）；全量 773 passed

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 11:59:49 +08:00
liuwenxin
2652397720 chore(migration): 收敛重复 V8 SQL——保留英文名版本（与并行会话对账，内容等价） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 11:13:28 +08:00
liuwenxin
0e8c5713fa feat(migration): V8 业务答复口径落实——审批开关默认开启、撤试用期统一参数、经理基数开关、台账分摊唯一键 
- #5/#7 答复默认开启：两审批开关 default 翻 1，插 10-19 生效行保时点历史
- #16 答复逐人维护：撤 probation.salary.basic（无业务消费点，月结已读 personnel.salary_standard）
- #12 答复参数化：新增 manager.personal.included（默认 0=不计入聚合基数）
- #1 答复分配绩效铺路：台账 uk 扩为 (receipt_id, calc_version, personnel_id) 支持分摊拆行
- schema_sync 解析器过滤 ADD CONSTRAINT 误捕获

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 11:09:05 +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
1c93ea0a4b fix(m3): code-review 15 项修复（13 项落地，2 项依赖分摊语义记待办） 
- 审批：删 _flush_order 撞键内部重试（rollback 会回掉同事务业务行造成
  静默丢数据，异常改由 create 外层重试整体重来/update 路径审计收敛）；
  act() 出参固化前置到 commit 之前（commit 后查询失败会把已通过的审批
  记成失败审计）；驳回/撤回清空方案生效行（防被否决方案进 M3 快照）；
  keyword 改 contains(autoescape=True) 对齐全库转义口径；撤单抽
  withdraw_pending_orders 供编辑清空方案时显式调用
- 业务：删业务遇在途审批单禁删 400、终态审批单随 _hard_delete 清理；
  编辑清空方案同步撤回在途单；历史离职参与人编辑放行（冗余姓名固化
  语义，仅新增参与人做在职校验）
- 迁移：business_secondary_allocations 补 uk(business_id, personnel_id)
  （模型/迁移 py/导出 SQL/init-dev 四方同步，开发库往返重放验证）
- 设置：upload_logo 改同步 def（阻塞操作不卡事件循环）+ file.size 先拦；
  company_name schema 剥空白防全空白入库；logo 旧文件清理移到 commit
  成功后（防库指旧路径而文件已删断链）；uploadLogo 走 request() 解包
  （原直发 service.post 不解包信封，logoUrl 会被置 undefined）
- 备份：restore_drill --drop-exec 先清全部历史 drill 库再演练并即删本轮
  （原语义永远删错对象，每轮净增一份整库拷贝）
- 测试：conftest 清理补 system_settings 种子行与 uploads/logo 文件；
  新增 5 例（驳回清方案/清空撤单/在途禁删终态随删/离职放行/BOOL 边界）；
  全量回归 701 passed
- 遗留 2 项记 AI_CONTEXT（方案版本承载、审批单快照，依赖 ④ 分摊语义）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-16 14:23:53 +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
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
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
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
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