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

28 Commits

Author SHA1 Message Date
liuwenxin
a00fca942d refactor(frontend): 侧栏层级与表单页版式调整 
侧栏层级口径改版（视觉稿 v4.2）：组标题与菜单项同字号 13px，层级改由
「折叠箭头 + 组间留白 + 子项缩进」表达，不靠字号/字重压过父级。
- 去掉组标题的靛蓝竖标与激活项左侧 2px 竖条（竖条只能落在侧栏内边缘、
  与白底悬空，是重复的第二个信号），激活只留白底浮起 + 靛蓝字
- 子项缩进 30px 收到 22px，图标父子统一 16px
- AppMenu 的 .app-menu 提供横向 10px 留白，BasicLayout 的 .app-aside__menu
  只写上下内距——两处都用 padding 简写会同权重靠注入顺序决胜，横向留白
  会被整条抹掉、条目贴到侧栏边缘

公司信息页字段自适应分列：卡片够宽时两字段并排，窄时折回单列；说明文字
紧贴控件下方，不再顶到卡片最右缘（宽屏下与输入框隔上千像素，视线关联断掉）。

设计稿同步升 v4.2。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-23 16:21:19 +08:00
liuwenxin
b9781f7d3f docs(design): 视觉稿升 v4.1 并新增表单页章节 
承接 10-23 浏览器实测验收，把三处实测偏差与新增的表单页口径写回设计稿（代码为视觉权威，稿为描述）：

- §03 新增「表格 · 行高」卡：单元格行高定 1.5（组件库默认 23px 会把单行数据行撑到 51px）
- §05 工作台：卡片内空态改为在剩余高度内垂直居中
- §09 月结：生命周期条四段圆点改为按阶段着色（草稿中性 / 待审批琥珀 / 已审定靛蓝 / 已驳回砖红，与选中态解耦），并补条右侧操作提示
- §10 新增「表单页（公司信息）」：两列版式（左 1fr + 右 480px 实景预览，≤1200px 折单列）、控件与说明同行（≥1600px 说明靠卡片右缘右对齐）、实景预览按真实登录页 1:1 复刻、独立的「生效范围」卡
- 封面与文件头注释同步 v4.1 变更说明

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-23 10:24:41 +08:00
liuwenxin
8e8bcaa5fb feat(frontend): 视觉规范 v4 全站落地与实测修复 
token 补齐与 EP 形体基准、全站版式工具类（.page-head/.card 系/.filter-bar/.ys-pill 等）、布局与登录页、工作台 Bento 与图表主题、打印稿纸、全部业务页统一到全局类；StatusTag 改 pill、AppPagination 加 background。

浏览器实测修复：表格行高收到 1.5；月结生命周期条圆点按阶段着色并加操作提示；工作台空态垂直居中；状态/结果列宽按胶囊内容给足（96/108/120），消除 Element Plus 省略号伪『小点』。设计稿反向同步圆点着色与流程条提示。
 2026-10-23 09:58:48 +08:00
liuwenxin
1f65913002 docs: 更新视觉方向预览页与部署组件需求说明 
- 设计/视觉方向预览.html 同步当前视觉体系（品牌色、语义三色、菜单
  图标），作为前端视觉落地的对照稿
- 部署组件需求说明.docx 精简冗余章节

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-22 19:47:19 +08:00
liuwenxin
94e2957359 docs: T+ 清单升至 v1.7 并清理过期版本文件 
- 新增 docs/T+对接数据需求清单_v1.7_2026-10-20.xlsx（v1.6 可读性改造
  的进一步结构重构：结论总览首屏、业务列前置、技术列后置分区）
- 保留 v1.6 供对照；删除已被替代的 T+ 清单 2026-10-15/v1.4/v1.5、
  待澄清问题清单 2026-10-15（两份）、待确认事项排序表 2026-10-16
  （两份）与 2026-10-13 阶段报告（均有 10-19/10-20 后继文档）
- 新增部署硬件需求（txt 源文与 docx 说明）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-22 13:31:57 +08:00
liuwenxin
4c32a556de feat(approval): 审批单内容快照与二次分配方案版本化 
补齐 code-review 遗留 2 项：审批单此前只固化 ref_id/refer_no 指针，复核者看到
的是业务当前内容；二次分配方案在编辑替换与驳回清空时一律物理删除，方案事实
无处回溯。

- 审批单加 version_no 与 snapshot_json（信封 schema_version/order_type/
  captured_at/data）；二次分配、月结、调整单三类提交均固化送审内容，开关关闭
  的自动通过路径同样写快照；详情按 snapshot/live/missing 三态回显，历史单
  只读回退当前内容并显式告警，不回填历史快照
- 二次分配方案行改 append-only 版本化（version_no/is_active，唯一键扩为
  business+version+personnel）：编辑替换与驳回清空只置历史，核算与详情默认
  只取生效行，业务详情新增 allocation_history
- 送审内容未变不重提、方案未变不新增版本：判据统一为送审内容，两个
  version_no 语义解耦（方案版本=内容第几版，审批单版本=第几次送审）
- 审批单列表、工作台待办、审批超时预警三处 defer 快照列，避免整列拉取
- 月结提交取行加 for_update，防并发提交算出重复的审批单版本号
- 修复审批类型筛选上界 le=2（调整单无法筛选）、快照金额把空值写成 0.00
- V11 迁移三件套同步（Alembic / db/migration / init-dev.sql）

测试：单元 +16（方案内容比较 10、审批入参 6）、集成 +12；全量 891 passed。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 18:30:51 +08:00
liuwenxin
2e0c64849b docs(tplus): 收敛 IT 待确认事项并更新催办清单 
原 18 项收敛为 13 项 IT 待确认 + 1 组业务裁决，每项附字典候选字段与来源；同步更新待确认汇总第三节与文档待办。字段级证据见映射草案 v0.1。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 10:56:07 +08:00
liuwenxin
33b9b00bb0 docs(tplus): 新增 T+12.3 六类字段映射草案与需求清单 v1.5 
全量解析 T+12.3 数据字典（1,457 页 / 931 表 / 21,019 字段，0 失败），按 v1.4 的 75 项逐项回填 T+ 候选字段、类型、枚举与系统目标列；必须项候选覆盖率 91.4%。v1.5 补齐 IT 收敛表（13 项 + 1 组业务裁决）与不覆盖字段 12 条，并修复 v1.4 单 sheet 与 21 项/#20 笔误。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 10:55:57 +08:00
liuwenxin
c319a6a428 docs: M4 阶段报告（2026-10-20） 
汇总报表统计与工作台交付范围、关键口径、测试证据与遗留事项。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 10:19:15 +08:00
liuwenxin
71df9a16ed docs: 修复催办清单行首井号被误判为标题 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 10:05:28 +08:00
liuwenxin
b6d84033ce docs(plan): 回填里程碑完成状态与开放问题结论 
- 开发计划：M3/M4 ⑤⑧/⑦⑨ 标记完成，依赖图与里程碑状态同步
- 开放问题表补 2026-10-20 结论映射；补充需求已随 SRS V2.1 回填
- 待确认事项汇总与催办清单同步当前状态

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 09:47:41 +08:00
liuwenxin
b7cfdfa50a docs: 需求规格说明书升 V2.1（2026-10-19） 
回填 2026-10-16 业务方 24 项澄清答复（12 确认默认 / 4 项与默认不同已落实 / 仍开放三态）、
AC-12 口径修正、二次分摊拆行与月末取参实现口径；FR 42 条 / AC 12 条结构校验通过，
作废口径仅出现在修订对照与作废声明语境。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 16:34:05 +08:00
liuwenxin
04a1a0d307 feat(report): 报表四页与打印视图 
- 个人绩效明细/部门绩效汇总/业务统计/回款统计四页，路由组「报表统计」order19-22（allowedRoles admin/finance/leader）
- 明细分页页脚全筛选合计；部门汇总成员内联与跨页下钻；业务统计展开回款/台账；回款统计 8 档区间（档位由后端下发）与桶下钻
- 打印视图独立顶层路由（不挂 BasicLayout）：公司页眉走 public 端点、循环翻页取全量（2000 行截断提示）、@media print A4 横版每页表头、签字栏
- AppPagination 只派发 page-change/size-change，四页按事件绑定并补初始加载（@change/v-model 不生效的同类缺陷）
- e2e report_flow.py：四页筛选与导出下载、打印视图 window.print 桩断言

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 16:33:37 +08:00
liuwenxin
8903a194c9 style(frontend): 字体商用合规——移除微软雅黑，统一思源黑体开源栈 
- index.css 两处字体栈移除 Microsoft YaHei：品牌字与正文统一思源黑体（OFL）
  + HarmonyOS Sans 开源序列，Helvetica/Arial 仅作西文回退
- README 视觉章节对齐 v3 靛蓝体系：配色表/质感来源/落地方式/签名元素/构图
  更新，旧「宋体品牌字」「两档金」表述修正并写明商用字体禁用约定
- 设计预览页字体栈与品牌字候选卡同步，echarts chartFont 去雅黑

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 15:54:59 +08:00
liuwenxin
c5f219423b docs: 2026-10-19 业务答复与需求留档——T+ 清单 v1.4、排序表、催办清单与 M4 计划 
- T+ 对接数据需求清单 v1.4 与业务方答复回执
- 待确认事项排序表两版、待答复催办清单
- 剩余开发计划回填 3.3.1 答复落定状态
- 新增 M4 报表统计实施计划

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 13:49:42 +08:00
liuwenxin
48c0a86279 docs: 推送状态补正——feat/m3-increments 已推送至远端 e48cfb7 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 13:13:23 +08:00
liuwenxin
e48cfb752d docs: 待确认事项汇总更新至 2026-10-19（答复落实/code-review/远端恢复） 
- 立即待办：远端 Git 服务已恢复（ls-remote 实测连通）；标注远端已到
  35fe37f、本地领先 8 提交
- 业务方澄清：#12 经理个人户基数 → 已落实为参数 manager.personal.included
  （默认 0=不计入）；#5/#7 审批开关默认开启、#14 首日整 10‰（A 口径）、
  #16 试用期参数撤销、#17 参数查看放开、#19 增量备份 → 均已落实（2026-10-19）
- 里程碑：M3 剩余改为已完成主体 + 余项（二次分摊待 #1–#3、答复回填批次
  收口）；杂项收口标注 calc_receipt 与 settlement_service 拆分进度
- T+ 小节：清单已升 v1.4（2026-10-19），本节口径待收编
- 新增修复批次口径记录：月结聚合/月工资按月月末取参（单笔行按回款日）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 13:01:50 +08:00
liuwenxin
35fe37fb0c feat(ops): 增量备份——binlog 归档脚本与全量位点记录（#19 答复） 
- backup_incremental.sh：归档已写完 binlog（tar 拷出+gzip），状态文件对齐序号，有更新才产出，保留 30 天
- backup_full.sh：补 .pos 位点文件（SHOW MASTER STATUS），增量重放的起点锚
- 手册新增增量章节：恢复顺序=全量→binlog 重放，含 mysqlbinlog 缺席镜像的说明

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 11:22:39 +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
30a179fc4c docs: 新增待确认事项汇总（立即待办/业务 24 项/IT 18 项/里程碑分层） 
- 立即待办：推送被远端 Git 服务阻塞（服务器侧重启）、M2 分支合并 main
- 业务澄清 24 项按高/中/低分层（含建议默认），IT 18 项按优先级分层
- 里程碑待办（M3 剩余/M4/评审遗留 2 项）与文档待办

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-16 15:08:03 +08:00
liuwenxin
b5e27810fd feat(backup): mysqldump 定时备份/恢复演练/健康检查脚本与手册 
- scripts/backup_full.sh：容器内 mysqldump --single-transaction，gzip 落盘
  db/backups/，保留 30 天；凭据 source docker/.env 不硬编码；实测备份成功
- scripts/restore_drill.sh：恢复到临时库 payroll_drill_* 并逐表核对行数
  （16 张关键表），默认不 DROP、--drop-exec 才删——绝不覆盖生产库；
  实测 16 表全 ✓。规避嵌套 shell 吞反引号（mysqladmin create/drop、
  双引号包裹表名）
- scripts/health_check.sh：六项检查（容器健康×2/磁盘水位/备份新鲜度/
  Redis 探活/24h 登录失败阈值），PASS/WARN/FAIL 报告，退出码供监控；
  Redis 密码经宿主机 .env 验证（容器内无该环境变量），实测六项全 PASS
- docs/备份恢复手册.md：备份/演练/生产恢复七步/定时 schtasks 两则，
  db/backups/ 已入 .gitignore

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-16 09:44:50 +08:00
liuwenxin
74f1ef1cf9 feat(frontend): 审批与系统设置模块页面接入及业务列表调整 2026-10-16 09:32:12 +08:00
liuwenxin
d8dba27fb2 docs(requirements): 模块页面功能清单（开发交付视角：14 页面已交付/M3+M4 待开发） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 18:00:23 +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
4552f2e703 docs(plan): M2 基础数据与业务数据实施计划（表结构评审定稿） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 09:26:39 +08:00
liuwenxin
e568ebde61 docs(requirements): 需求裁决对照表 v2、功能模块清单与 M1 设计产物入库（移除被 v2 取代的旧清单） 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 09:26:21 +08:00
liuwenxin
c7212cd93f chore: 修正 gitignore 并同步项目文档 
- .gitignore：logs/ 收窄为 /backend/logs/ —— 原规则（无前导斜杠）匹配任意
  层级同名目录，曾把 frontend/src/views/system/logs 整个吞出版本库
- 同步根/frontend README（进度、e2e 运行方式与环境变量）
- 收录业务确认问题清单（完整版）

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