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

26 Commits

Author SHA1 Message Date
liuwenxin
fb398c3835 test(e2e): 绩效核算与月度结算端到端用例——台账重算与月结审批链路 
覆盖台账页按回款 ID 重算、版本筛选三态、月结生成/提交审批/明细回显，
用随机远未来月份造数，重复运行互不碰撞。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 13:50:13 +08:00
liuwenxin
cb4f38dfd9 fix(m3): code-review P0 六项——算错钱与不可用 
- 经理聚合分成放大 100 倍：参数按百分数存储（12.5=12.5%），parse_fraction
  后调用方又 ×100、函数内部再 ÷100，净效应「绩效×12.5」；去掉调用方
  ×100，rate_text 改用实际参数原文（原硬编码 12.5%+5% 参数调整后失真）
- 审批联动只认终审：财务节点通过（1→2）不再提前 mark_locked/调整单生效，
  否则领导驳回后 locked_at/locked_by 残留、两级审批形同虚设；驳回在任何
  节点即时联动；mark_rejected 补清锁定字段
- 调整单新建不可用：ENABLE_CODE_BY_TYPE 未登记 type=3 → is_enabled 恒 400；
  补登记 approval.adjustment.enabled。另修复叠加缺陷——开关关闭分支手工
  ApprovalStep(order_id=调整单id)，而该外键指向 approval_orders，必然
  errno 1452；统一改走 submit_order（自动通过留痕由它负责）
- 重算双重计提：业务级一次性计提的「进度登记」回款无生效台账行，重算会
  凭空落新行；无旧行一律 400
- 前端重算传错 id：台账行主键当 receipt_id 传给重算接口，会作废无关回款
  的台账；改传 row.receipt_id（聚合行防御）
- quantize 显式 ROUND_HALF_UP：9 处金额 quantize 缺省银行家舍入，
  x.xx5 与四舍五入口径差 1 分（docstring 却声称 HALF_UP）

测试：显式控制审批开关（V8 起种子默认开启，用例不再依赖默认值）；
新增回归 4 例（经理聚合比例/调整单即生效/进度登记重算 400/财务节点不提前
锁定），test_calc+test_settlements 22 passed

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 11:25:21 +08:00
liuwenxin
7008de0c69 feat(api): 计提参数查看放开登录用户、修改仅管理员（#17/#6 答复） 
- deps 新增 LoginUser 依赖；params 只读七端点改登录即可，写（提交/撤回）保持 AdminUser
- 前端 params 路由 requiresAdmin → allowedRoles（admin/finance/leader）；页面写按钮按角色显隐
- 权限用例分层：普通用户目录 200、提交/撤回 403、未登录拦截

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 11:19:16 +08:00
liuwenxin
238a38c356 test(m3-core): 核算/月结用例收口，目录断言 19 项，测试记录更新 
- 金标准金额断言锚定 DB 事实源（NUMERIC(14,2) 读回恒两位）；行级明细
  折算两位固化；全量回归 756 passed（701+核算 13/月结 6/公式 12 等）
- 目录断言 18→19（V7 调整单开关）；tests/README 增 M3-core 节与运行记录；
  frontend/README 增核算与月结两页

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-17 01:08:31 +08:00
liuwenxin
a1217f4482 feat(frontend): 绩效台账与月度结算两页接入（新组绩效工资） 
- 绩效台账页（order17）：月/版本筛选 + 行展开计算快照 + 重算（原因
  对话框，管理员/财务）；核算入口在回款管理页（每笔回款行内触发）
- 月结页（order18）：生成快照（月份输入）+ 状态筛选 + 提交审批 +
  详情抽屉（按人明细三口径/试用期说明/审批单号关联）
- 均复用 usePagedList/AppPagination/--ys-* 惯例；金额 str 直出
- type-check 零错误；build 通过

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-17 00:54:51 +08:00
liuwenxin
fc8a42bcd9 test(m3): 集成/e2e 增补三模块用例并更新测试记录 
- 新增 e2e：settings_flow（改名→登出→登录页即时生效→finally 还原防污染）、
  secondary_allocation_flow（建客户/员→录两行 30%+40%→编辑回显与合计条
  余额提示→删除清理；宽视口防弹窗遮挡、alloc-table 专属类防选择器错位）
- 修复 e2e 首跑抓出的两处缺陷：① public 端点 300s 响应缓存让登录页拿旧
  公司名（登录页改时间戳 fetch + cache:no-store，手动解包信封）② logo 同
  扩展名覆盖时先写后删（清理移到写入前且仅异扩展名执行）
- 分配表加 alloc-table 专属类（与产品明细 items-table 区分）
- 全量回归 697 passed（基线 625 + 72）；e2e 七脚本全过（既有五脚本回归 +
  两个新增）；pnpm type-check 零错误
- tests/README.md 增 M3 节（44 例明细）/运行记录/缺陷 3 行；frontend/
  README.md 增 M3 e2e 节

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-16 12:01:52 +08:00
liuwenxin
927592b472 feat(frontend): 公司设置/二次分配/审批三页接入，参数页编码中文化 
- 公司信息页（设置 order7）：名称编辑 + logo 上传（png/jpg ≤2MB
  前端先拦）+ 签名元素「登录页实景预览」（缩比登录卡，品牌名/logo
  即时反映，所见即所得）
- 审批管理页（order8）：列表筛选（关键词/状态/类型）+ 签名元素
  「竖排节点时间线」（财务复核→领导审核，人工/自动/驳回色区分）+
  在途单通过/驳回动作（驳回必填意见，经 useConfirmAction 确认流）
- 路由扩展 allowedRoles 元数据：菜单按任一列入角色可见 + 守卫双
  过滤（admin 须显式列入集合，不天然放行）；审批页对 admin/
  finance/leader 可见（营销后勤待权限清单 #6）
- 业务表单二次分配区：参与人下拉（离职禁用）+比例输入+实时合计条
  （合计≠100% 提示余额归属待业务确认，满额高亮）；编辑全量替换、
  空行自动忽略；校验（人员非重/比例两位小数）与后端 NUMERIC(5,2)
  同口径
- 登录页接 /system/settings/public：品牌名与页脚动态，logo 展示，
  失败静默回退默认（登录页必须可用）
- 参数页中文化：维度角色名映射（营销员/营销经理/信息员）、枚举值
  中文（当月全额/余额、含/扣/不计基本工资、开/关）、预览「所用参数」
  由编码直出改中文名（编码括注）
- 验证：pnpm type-check 零错误；pnpm build 通过

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-16 09:38:05 +08:00
liuwenxin
74f1ef1cf9 feat(frontend): 审批与系统设置模块页面接入及业务列表调整 2026-10-16 09:32:12 +08:00
liuwenxin
94c49138bf refactor(e2e): 六个列表页 UI helper 收口 common.py 
open_menu 时分组参数化、fill_filter :text-is 精确匹配、messagebox 带
:visible（base_data 实现为准）——两脚本此前各持一份且匹配精度漂移
（has_text 子串 vs :text-is），使用者误以为两者等价；登录/系统管理/
基础数据/业务数据四链路 e2e 复跑全过。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 11:01:31 +08:00
liuwenxin
0ef3adec21 refactor(frontend): 金额正则/分页/抽屉状态/行编辑与下拉收口 
- 金额形态正则收进 utils/validate.ts 单点导出（此前四页各写，精度
  调整漏改一页即「A 页拦得住 B 页放行后端 400」或历史行无法编辑）
- params 版本/历史两抽屉的手写分页五件套换 usePagedList（白得请求
  序号防竞态——快速翻页旧响应覆盖新页的手写坑不再复现）
- 业务抽屉三份 id 状态收为 drawerRowId computed（单一状态源，消除
  「标题 A 业务、留痕表 B 业务」的失同步面）
- useEditingRow（三页逐字相同的 computed）与 useDropdownOptions
  （取数失败不阻断列表的骨架）收口，映射函数由调用方给出
- e2e 冒烟：基础数据 13 步 + 业务全链路 16 步全过

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 10:08:24 +08:00
liuwenxin
7f8f88c148 fix(frontend): 错误提示单一化/成功提示后置/日志页首次成功拉取 
- request.ts blob 失败分支：先解析真实文案再统一提示——此前先弹兜底
  「导出失败」再异步补弹真实 message（双提示），401 时跳转提示与
  实际原因错位；401 语义文案在导出场景不再失真
- useConfirmAction：收尾（列表刷新）成功后才弹成功提示——此前先弹
  「已删除」再刷新，after 失败被吞时成功/失败提示同屏矛盾
- 日志页登录 tab 首次成功加载后不再重复拉取（loginLoadedOk 由
  fetcher 成功返回置位，失败切回可重拉，不复活「失败停空表」旧坑）
- login_flow.py 密码改从 E2E_ADMIN_PASSWORD 读（与 system_management
  同一约定），硬编码默认值在他机上会假绿为「凭据错误」
- e2e 冒烟：登录 8 项 + 系统管理 13 项全过（拦截器全局改动验证）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-15 09:22:12 +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
d77728265b docs(business): M2 收尾——e2e 记录、缺陷表、AI_CONTEXT 摘要更新 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 17:13:21 +08:00
liuwenxin
8c4acb82fe fix(business): e2e 链路验证与两处修复 
- wait_toast 超时返回最后见到的非空提示（错误 toast 一闪而过时诊断信息全丢）
- 业务/发货明细行单价类字段放行 4 位小数（与后端 DECIMAL(14,4) 对齐）
- 清理步骤适配删除保护（被终态业务/引用拦截时留档而非失败）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 17:06:46 +08:00
liuwenxin
299b72483c test(business): M2 基础数据与业务数据两个 e2e 链路脚本（13+16 步） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 14:17:28 +08:00
liuwenxin
c512cb77fb docs: 后端接口清单补基础/业务数据两节与 M2 关键约定；前端 e2e 清单预登记 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 13:43:17 +08:00
liuwenxin
77e578085a feat(business): 操作日志模块词表补业务数据四模块（与后端 MODULE_* 同步） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:51:20 +08:00
liuwenxin
06cdf4141f feat(business): 前端业务/发货/回款管理三页 
- 业务页：明细行编辑器、详情抽屉五分区（含状态时间线与毛利润卡片）
- 回款页：业务→发货批次级联指定（可清空）、已核算行禁改禁删
- 金额/比率字符串直出；毛利润卡片注明不含运费口径

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:50:10 +08:00
liuwenxin
5207d14daa feat(base): 前端基础数据三页与客户评级计算器（人员/产品/客户/评级） 
- 人员页：编辑抽屉内区域/计划子表编辑；产品页：类别阈值提示条；
  客户页：归属变更二次确认含「不回溯历史」+变更记录抽屉
- 评级页：五项评分实时出等级（纯前端判定，不落库 #25）+ 等级映射维护抽屉
- 菜单两组：基础数据（8-10）/业务数据（14）；金额字符串直出禁 float

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 12:25:45 +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
d7fbec1177 feat(system): 登录页重做、布局白化与首页 Bento 仪表盘（视觉体系统一落地） 
- 登录页：雾灰点阵底 + 右上涟漪同心圆 + 顶部靛蓝天光；居中纸白卡片（品牌区/欢迎回来/表单）；逻辑不变
- BasicLayout：侧栏深色面板改为中性灰微渐变 + 白底浮起当前项（左 2px 靛蓝条）；logo 区水线；内容区雾灰点阵
- 首页：Bento Grid 仪表盘（参数 16 项/岗位 3 个为真实数据；绩效/回款/待办为业务上线前的精致空态）
- AppMenu：激活项白底浮起样式，菜单变量随浅色侧栏调整

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 00:09:41 +08:00
liuwenxin
4c442b8cf2 feat(system): 前端岗位角色与计提参数配置页面 
- 岗位角色页：列表/新增/编辑/启停/删除，内置岗位保护、模板受控下拉（含声明参数引导）
- 计提参数页：分组目录（多维度生效值）→ 修改入「待提交」→ 批次提交（立即/指定日期 + 二次确认）；
  版本管理抽屉（记录分页/明细旧值→新值/两日期对比/撤回未生效/xlsx 导出）；计算预览抽屉（按回款到账日取参数）
- request.ts 对 responseType=blob 直通（导出文件流非统一信封）
- 路由注册岗位角色/计提参数（系统管理组 order 5/6）；日志模块词表补两处

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 21:48:00 +08:00
liuwenxin
fd801455f0 feat(system): 全局品牌 token 迁移到靛蓝轻质感视觉体系 
- 主色改靛蓝 #2E4BA8（白字对比 7.5:1），EP 色阶按混合公式重算
- 中性灰白体系：雾灰底/纸白/半透明界线/三级墨色文字
- 旧 token 名保留映射（深水青→冷墨、金色→靛蓝），存量引用平滑过渡，迁移完成后移除
- 设计依据：docs/design/视觉方向预览.html（2026-10-12 确认）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-12 21:47:59 +08:00
liuwenxin
8355e0cc7d feat(system): 完成前端系统管理（布局框架、三个管理页面、e2e） 
- BasicLayout：侧边栏/顶栏/面包屑/移动端抽屉；菜单从路由表派生；
  路由守卫新增 requiresAdmin 层（菜单隐藏 + 直连 URL 弹回）
- 用户/角色/日志三个页面：分页请求序号防竞态、确认动作流抽 useConfirmAction、
  时间范围配 default-time、日志详情按需懒加载并缓存
- 空 catch 统一改 handledError 显式声明；词表/选项常量集中（与后端对齐），
  「停用」文案全站统一为「禁用」
- 品牌色提升为全局 token，Element Plus 主色指向赭金
- e2e：公共工具抽 common.py；系统管理 13 项（含详情懒加载脱敏断言），
  管理员密码改 E2E_ADMIN_PASSWORD 环境变量；login_flow 8 项回归通过

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