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

167 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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
d03ddadd1a merge: 合并 M4 阶段报告至 main 2026-10-20 10:19:22 +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
36114745db merge: 合并 M4 工作台与报表修复至 main 2026-10-20 10:18:40 +08:00
liuwenxin
b86eaf2b00 docs: 记录 2026-10-20 全量回归与 e2e 实跑结果 
全量 862 passed（11:32）；e2e role_home 4/4、report_flow 12/12（按业务编号下钻断言）、calc_settlement 8/8；审批开关已还原、无测试账号残留。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 10:10:32 +08:00
liuwenxin
71df9a16ed docs: 修复催办清单行首井号被误判为标题 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 10:05:28 +08:00
liuwenxin
980628bb8f test(e2e): 回款统计改按本次业务编号下钻断言 
历史 e2e 数据会累计到同一回款区间桶，断言桶聚合值在重复运行时必然失败；改为展开目标桶后按本次业务编号定位下钻行并校验金额，脚本可无副作用重跑。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 10:04:42 +08:00
liuwenxin
c8131588bf chore: 忽略 T+12.3 数据字典参考资料 
- docs/**/*.rar、docs/T_12.3数据字典/ 与 __MACOSX/ 不入版本库

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 09:47:41 +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
698df6d31a docs: 同步报表与工作台口径及测试记录 
- backend/README：全公司 5% 每位有聚合行经理各计一次并与月结对拍、
  待办按角色过滤、预警排除终止业务与 total 计数、趋势范围查询
- backend/tests/README：新增修复回归与 e2e 全链路运行记录、缺陷表
- frontend/README：普通用户落地页规则、预警徽标、e2e 实跑结果

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 09:47:03 +08:00
liuwenxin
39a3fa7796 fix(dashboard): 修复普通用户落地页与待办角色过滤 
- 新增 router/access.ts 统一准入与落地页（工作台→业务数据→回款），
  守卫/登录回跳/菜单/面包屑复用；普通用户不再被无限重定向
- 待办按角色映射在途审批节点（财务/领导/admin），admin 不代办但可查全部
- 预警排除已终止业务；WarningBlock.total 为全量命中数；回款趋势改日期范围
- 工作台加载请求序号防竞态；KPI 口径说明补经理分成/调整单
- 新增 role_home_flow e2e，更新 system_management 普通用户断言

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 09:45:03 +08:00
liuwenxin
ebb3a92f25 fix(report): 报表统计修复批次——对账口径、导出审计与月份校验 
- 部门汇总全公司 5% 按每位有台账聚合行的营销经理各计一次，
  团队应发小计取聚合额 + 调整净额；与月结 total_payable 对拍
  （有调整单时 + adjust_net_total），分列舍入差单列
- 人员归属按行类型拆分（普通/经理个人户/仅调整单），调整单全量并入，
  团队与未分配不重复；按经理筛选只汇总展示团队
- 导出改单 sheet 分块签字稿，审计覆盖取数与超限；筛选页眉 ID→名称
- 月份校验抽 core/month，报表/月结/调整单非法月份统一 400；
  岗位只读选项供财务/领导筛选
- 前端修复：部门下钻带入筛选、回款多桶独立状态、打印截断判定、
  summary 请求序号保护

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-20 09:44:43 +08:00
liuwenxin
c91d1db78a Merge feat/m3-increments into main��M4 �� ����̨�� 
����̨������ + V10 Ԥ������
 2026-10-19 21:01:17 -04:00
liuwenxin
294d99a0d3 feat(dashboard): 工作台前端四区块与 ECharts 图表 
- /dashboard 由 Bento 占位升级：KPI 四卡（本月绩效/应付/核算人数/团队数+月结状态）、近 6 个月绩效折线与回款柱状、待办/预警列表与跳转、最近动态时间线（按模块筛选）、常用操作
- ECharts 5.6 按需引入（core + Bar/Line/Grid/Tooltip + SVGRenderer）；textStyle.fontFamily 显式设为思源黑体栈（Windows 默认雅黑，字体商用合规红线）
- 路由 allowedRoles admin/finance/leader，与后端 require_roles 双层
- 新增依赖 echarts@5.6.0

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 18:45:17 +08:00
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
4e54d09ccb Merge feat/m3-increments into main 
M2 ����/ҵ������ + M3 ����/�½�/���� + M4 ����ͳ��
 2026-10-19 04:59:56 -04: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
2a1939d2e7 feat(report): 报表统计四表查询与 Excel 签字导出 
- 四表接口 /api/v1/reports/*：个人明细（全筛选 summary）、部门汇总（团队基数与月结聚合同源、12.5%/5% 分列、零行经理、冻结对照）、业务统计（排除聚合行）、回款统计（8 档区间恒在、回款金额按 receipt_id 去重防分摊拆行翻倍）
- Excel 导出：公司页眉/财务复核栏/领导签字栏/日期/版本、Decimal 原值 + number_format、文本防公式注入、2 万行超限 400、导出行为入操作日志
- manager_share 共享模块：月结聚合与报表部门汇总同源取参与分桶（薄委托保留测试入口）
- 区间元数据落 core/report_meta（repository 需要类型，避免反向依赖 service 层）
- 准入 require_roles(admin/finance/leader)，支持自定义 403 文案

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 16:33:31 +08:00
liuwenxin
cfd2a196f2 style(frontend): 表格操作列统一样式与确认框视觉收敛 
- 新增 table-actions.css：操作列 flex 居中、间距交给 gap、破坏性动作前
  加分组竖线、链接按钮悬停加深并加下划线（默认浅靛蓝在表格底色上对比度
  不足）；包装 span 改 flex，消除行内盒基线导致的约 1.7px 垂直错位
- 11 个列表页操作列套用统一容器与分隔线，列宽按动作自然宽度调整并居中
- 确认框不再传 type:warning（Element Plus 的实心黄圆图标与正文并排成
  两列，标题行反被留空），图标改由全局样式画在标题行左侧，正文与标题
  文字左对齐；图标为 CSS 伪元素，不进无障碍树

验证：pnpm type-check 绿

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 16:33:06 +08:00
liuwenxin
cc4c51359c fix(frontend): M3 台账/月结/审批三页数据加载与分页——e2e 首跑抓出 
calc_settlement_flow e2e 首跑即暴露三处真实缺陷（三页自 2026-10-17 交付
起一直「暂无数据」且翻页失效，此前无 e2e 覆盖）：

- api/{calc,settlements,approvals}.ts 误用默认导出 `request`（axios 实例，
  返回 AxiosResponse 未解包），usePagedList 拿到的 data.list 恒 undefined
  → 三页永远「暂无数据」；改为具名导入 `{ request }`（统一信封解包版）
- 三页均无 onMounted 初始加载 → 进页不取数；补 `onMounted(() => void load())`
- 三页 AppPagination 用 `v-model:page-num` + `@change`（组件无该事件、
  也未实现 update:*）→ 翻页失效；统一为 `:page-num/:page-size` +
  `@page-change/@size-change`
- 并入并行会话的操作列 align="center" 样式与 M4 报表页 README 段落

验证：e2e calc_settlement_flow 8 步全过（API 预置→台账筛选→重算对话框
按回款 ID→版本三态筛选→月结生成→提交锁定→详情抽屉）；type-check 绿

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 16:24:18 +08:00
liuwenxin
036834a1d0 style(backend): 验证码配色切换至 v3 中性色体系 
字符/干扰/噪点/底色改用 --ys-ink / --ys-ink-2 / --ys-ink-3 / --ys-paper
对应色值，与 2026-10-12 后的前端视觉方向一致；识别难度参数未变，
tests/unit/test_captcha.py 12 项通过。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 15:55:02 +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
a2bd3960e1 feat(report): M4 报表基础设施——元数据、查询模型与只读聚合仓储 
- report_meta：回款天数区间桶（含可空/负值兜底桶）、客户类型标签、导出上限
- schemas/report：明细/汇总查询入参与分页响应，金额比例全程 Decimal
- report_repository：报表专用只读聚合，显式排除台账聚合行、口径与月结区分
- constants：新增报表统计模块与导出动作常量

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 13:53:34 +08:00
liuwenxin
fb398c3835 test(e2e): 绩效核算与月度结算端到端用例——台账重算与月结审批链路 
覆盖台账页按回款 ID 重算、版本筛选三态、月结生成/提交审批/明细回显，
用随机远未来月份造数，重复运行互不碰撞。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 13:50:13 +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
a536608b53 docs(tests): 2026-10-19 业务答复落实批次记录与分摊尾差缺陷表更新 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 13:29:37 +08:00
liuwenxin
ccfd20651b feat(calc): 二次分摊拆行与 #12 单笔侧开关——按方案比例拆给参与人、余额归负责人 
- _personal_rate 的 TPL_MANAGER_SHARE 分支读 manager.personal.included：1=按业务员递减公式计提，0=单笔落 0（现状）
- _load_allocations 装载生效方案并防御拦截（合计超 100%、参与人含负责人）
- _persist_ledger 拆行落库：参与人=份额×比例(q2)、负责人=q2 全额−已分累计（行合计守恒防分漂）；快照带 alloc_plan/alloc_role/alloc_ratio
- _prepare_mode 重算改 list_active_by_receipt 作废全部拆分行；uk 三列版支持同回款按人多行
- business_service 保存侧同口径校验（超 100% 400、负责人自分 400、hint 文案定稿）
- 集成用例 +5（拆行守恒/叠加进度登记/重算全作废/双拦截）+保存侧 3 条

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 13:15:59 +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
028a94a6eb refactor(m3): settlement_service 三段收尾——生成/聚合/调整单拆分 
code-review 约定合规项续（calc_receipt 之后的剩余超长函数）：

- generate（~120 行）→ 编排 + 六段私有函数：_guard_regeneration（重生成
  准入）、_release_previous_round（解绑回填+旧聚合作废）、_upsert_draft
  （草稿头表新建/重置）、_build_items（=_bucket_rows + _item_of 记账）与
  _apply_totals（头表三合计）
- _build_manager_aggregates（~110 行）→ _ShareParams 冻结 dataclass +
  _manager_share_params（月末取参/百分数口径/#12 开关同源）/ _collect_team_buckets
  （含 #12「个人户行归经理本人」分支）/ _add_team_performance / _aggregate_row；
  全公司基数循环外算一次（口径逐行固定，行为等价）
- create_adjustment（~90 行）→ _adjustment_amount（恒正）/ _wire_adjustment_approval
  （submit_order 分流与留痕，含「不得手工插 ApprovalStep」外键教训注释）/
  _adjustment_out（出参前置到 commit 之前）

行为零变化；#12 参数化（include_manager_personal 过滤、个人户行按
personnel_id 直归经理、snapshot 的 manager_personal_included）语义原样保留。
验证：重构后月结集成 15 例 + 月结单测 5 例全绿（81s 内无并发干扰的一轮）；
全量回归待 88 会话 calc_service 收口后复跑（其进行中的拆行改动与测试
并发互清导致临时 401，非本重构所致）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 12:52:36 +08:00
liuwenxin
a89d540e3f docs(tests): code-review 修复批次测试记录与缺陷表更新 
- 运行记录：M3 定点 34 例与全量回归 780 passed（2026-10-19）两行
- 缺陷表：补 14 条（聚合 ×100/审批提前锁定/调整单双重缺陷/重算双重计提/
  前端传错 ID/quantize 银行家舍入/锁定拦截 1-4/回填死代码/聚合不落库/
  生成日取参/迁移三处漂移/演练误报与密码明文/金额与 INT 解析与 logo 清理）
- 待补用例：绩效工资核算行更新为 M3-core 已完成（e2e calc_settlement_flow
  与答复回填批次待补）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 12:30:41 +08:00
liuwenxin
7a99994d17 refactor(m3): calc_receipt 五段拆分——218 行收敛为编排 + 私有函数 
code-review 约定合规项（CLAUDE.md「单一职责 ≤50 行」）：原 218 行单函数
把锁行校验、模式预处理、输入装载、逐行折算、计提组成、落库全部内联，
待澄清答复回填时改动回归面大。按原执行顺序拆为四段私有函数 + 两个
冻结 dataclass（_Conversion/_Amounts），主函数只做编排；行为零变化
（M3 全部用例原样通过）：

- _load_and_guard：锁行 + 模式校验 + 月结锁定拦截 + 业务归属校验
- _prepare_mode：重算作废旧版本 / 首算判一次性计提（进度登记提前返回）
- _load_shipment / _load_person / _load_items：输入装载三查
- _convert_items → _Conversion：逐行折算（行级阈值/缺成本标记/行级明细）
- _compose_amounts → _Amounts：比例分派 → 绩效 → 抵顶 → 权重 → 应付
- _persist_ledger：落台账行 + 首算 CAS
- 局部 q2 提为模块级 _q2（新增单测锁定 HALF_UP：2.345→2.35，
  缺省银行家舍入会得 2.34）

验证：全量 780 passed；type-check 绿

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 12:25:36 +08:00
liuwenxin
45c268b146 fix(m3): code-review P2——金额校验、参数解析与运维脚本容错 
- 调整单金额恒正：schema 正则拦格式（非负两位小数、≤12 位整数防
  NUMERIC(14,2) 溢出）+ 服务层 Decimal>0 语义校验——负数会反转补发/
  扣减语义，'abc' 原样入库会以 500 暴露
- 分界天数参数解析：int(parse_fraction(...)) 替代 int(参数原文)——
  '360.0' 是 INT 参数的合法入库值（Fraction 分母为 1），直接 int(str)
  抛 ValueError 会让整月核算 500
- logo 旧文件清理容错：OSError 只记 warning——裸抛会把成功的 logo 更新
  记成失败审计并 500（库中 logo_path 却已是新值，审计与事实相反）
- health_check.sh：Redis 探活改容器内环境变量展开（密码不进宿主进程
  命令行，模式同 backup_full.sh）；compose redis 补 REDIS_PASSWORD
- restore_drill.sh：行数核对扩到全部 32 张业务表（原 16 张漏 V7 四表、
  二次分配等核心表，备份漏表演练全绿）；查询失败回显 '?' 一律判 ✗
  （原 '?'=='?' 判一致，表缺失时误报「备份可恢复」）
- 并入 88 会话的 #12 实现：manager.personal.included 开关消费
  （_build_manager_aggregates 参数化，测试见 828b573）
- 测试：调整单金额恒正 5 稿、INT 参数小数原文核算 200 回归；单测 469

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 12:10:29 +08:00
liuwenxin
828b57350a test(settlement): #12 聚合基数开关用例——经理个人户计入可配置 
默认 0 时聚合 6.84 不变；开关 1 时个人户行按 personnel_id 归经理本人
（不走 manager_id 上溯）、基数 139.11 → 聚合 24.34，两档金标准锁定

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 12:06:07 +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
7a460cb682 feat(formula): 首日计提比例取整 10‰（#14 答复——图示口径覆盖公式） 
- salesperson_rate 首日特判：第 1 天不递减直接取起始值（原公式 9.9889‰ 作废）
- 第 2 天起公式段不变、360 天=6‰ 锚点与 361 天=4‰ 分界不变；preview/核算共用一处
- 用例反转：首日断言改 Fraction(10,1000)，补第 2 天公式段边界

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-19 11:40:07 +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
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
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
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
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
e7e47d88bc feat(settlement): 月度结算快照生成与审批锁定，调整单（补发/扣减）与审批联动 
- settlement_service：generate（确认回款口径 #8 策略点=有效台账行按回款日
  归月、经理聚合 #12 暂口径基数不含经理个人户、月结 uk 一行一月、草稿/
  驳回可重生成、已审定/待审 400）→ submit（审批开关分流，关=自动通过即
  锁定、开=待财务复核）→ approval_service.act 扩 order_type=2/3 钩子
  （通过=mark_locked/调整单生效；驳回=回草稿/作废，延迟导入防循环）
- 锁定拦截：回款新增写路径校验回款月已审定 400（比需求「提示」取硬，
  一期安全侧；M2 已核算禁改防线先于其生效）
- 调整单：新建（TZ 单号，开关分流自动通过留痕/走审批）+ 列表
- schemas settlement：金额 Decimal 声明（str 声明遇 Decimal 入参拒绝）
- 测试 6 例：生成回填/无记录 400/已审定重生成 400/关自动锁定/锁定后回款
  禁改/开两节点流转至锁定（finance→leader）

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-17 00:33:31 +08:00
liuwenxin
22a2872100 feat(calc): 重算授权留痕与批量核算 
- calc_receipt 双模式：recalc_reason 非 None=重算（audit action=重算/
  reason 留痕、作废旧版本行、calc_version 自动递增、CAS 仅首算执行——
  重算状态本就是已核算，误跑 CAS 会误报并发撞车）
- recalc_receipt 薄委托（reason 必填、未核算过 400）；重算授权
  require_roles(admin, finance)，营销后勤不可重算
- batch_calc：逐笔独立事务不开外层 audit（嵌套禁令），逐笔成败清单
  （同业务第二笔回款走 #25 重复分支 ok=True/repeated=True）
- 测试 +5：重算版本对/原因缺失 400/未核算重算 400/越权 403/批量清单
- 修 next_version 空表 max NULL → int(None) TypeError

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-16 21:49:44 +08:00
liuwenxin
df1a3839a1 feat(calc): 单笔回款核算引擎与绩效台账 
- calc_service.calc_receipt：锁回款行→settlement_status=0 校验→发货批次/
  归属前置→resolve_snapshot(回款日)→按 calc_template 分派（与 _preview_rate
  同构，‰÷1000 防线）→items 行级折算（行类别阈值，混合按行汇总）→
  barter/起付/R→台账 v1→CAS 置已核算，单 audit 事务
- 策略点集中：_personal_rate（#12 经理个人户单笔落 0 待答复）、_row_profit
  （#20 不含税原样）；核算粒度 #25 一期口径=业务级一次性计提（重复回款
  repeated=True 仅登记进度）
- 台账仓储：生效行查询/业务级判定/版本号；schemas LedgerOut/Query
- api /api/v1/calc/*：台账分页/详情/核算触发（写限 admin+marketing_ops）
- 测试 8 例：金标准双类别复算到分（DB 锚定 4000.00/39.11/39.11）、
  一次性计提、已核算 400、未指定批次、成本缺失行保守 -3000、负绩效照算、
  准入、列表筛选；行级明细折算两位固化
- conftest 清理顺序修正：V7 台账/月结清理移到回款/人员删除之前
  （RESTRICT 外键不挡序）

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