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

38 Commits

Author SHA1 Message Date
liuwenxin
ea989ce9ad feat(tplus): 新增 T+ 同步管理页面与菜单入口 2026-10-28 11:42:51 +08:00
liuwenxin
678db0499d fix(frontend): 分页失败回滚到实际显示页 
records 只在请求成功时更新，而分页器高亮绑的是 pageNum，失败不回滚就会
出现「高亮第 1 页、列表是第 2 页的数据」的永久错位，用户来回点才恢复。
- 用 shownPageNum / shownPageSize 记录实际显示的页，失败时 restoreShownPage
  退回该页
- 回滚本身也要防竞态：只有本次请求仍是最新请求（seq === requestSeq）才回滚，
  否则连点时旧请求失败会把用户刚点出的新页码覆盖掉，表现为页码自己跳回去
- 页码与条数在 await 之前取快照，避免等待期间被别的点击改动后记错「显示的页」

对外接口不变（load / search / onPageChange / onSizeChange / reloadAfterDelete），
现有调用方无需改动。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-23 16:22:19 +08:00
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
61965e0b60 feat(ui): 面向客户的文案中文化 
系统由财务与营销人员日常使用，不是给开发者看的。本批把会渲染到页面上的
文本统一改成业务语言：
- param_registry 的 22 条参数说明重写为「管什么、钱怎么变、何时该调它」，
  去掉英文枚举名、需求编号、内部阶段号与精度约束
- 前端补 formatByCode：变更记录、版本历史、快照对比只给裸 value_text，
  需回目录按编码补 value_type 与 unit 才能翻译枚举，否则这些位置仍显示
  INCLUDE/FULL/1；编辑弹窗 BOOL 改为开启/关闭下拉
- 后端错误文案：模板报错用中文模板名并给出下一步，产品类别不再甩
  municipal_water / rail_transit
- 台账与预览落库的计提说明口语化（rate_note / strategy_note / 聚合行 note），
  去掉「基数开关=1」「#12 参数化」「9.8 方案公式」

分数原文 11/1125 与「聚合:20%+5%」不动——那是金额口径的可复核原文，
不是说明文案。init-dev.sql 种子 description 与 registry 同源。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-23 16:20:05 +08:00
liuwenxin
111ac5425a feat(customer): 客户列表展示等级徽标并统一等级不落库口径 
评级计算器并入客户管理后，列表只有分数看不出档位，本批补上等级徽标：
- 抽出 utils/rating.ts 的 resolveGrade（按 sort_order 升序取首个
  min_score ≤ 总分的等级，单边判定避免区间边界歧义），列表页与弹窗共用
- 等级映射按需拉取并缓存在内存，等级配置改动后回调父页重拉，避免
  「同一分数在弹窗是 B、在列表是 C」的两处口径分歧
- 徽标色调按等级名首字母映射，自定义等级名落回中性灰（等级名可配置，
  不能靠写死枚举判语义色）
- 悬浮提示给出等级区间与评级时间

同时订正三处与实现不符的注释：rate_customer 实际只写 rating_score 与
rating_time，等级由分数按当前映射实时推导，三处却写成「后端判定并固化等级
名快照」，v13 迁移 docstring 还引用了并不存在的 v14（d5b8f2a46c71）。
纯注释改动，无逻辑变更。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-23 16:18:47 +08:00
liuwenxin
61fe5cca98 feat(dashboard): 最近动态改服务端分页 
工作台「最近动态」原为聚合端点内嵌、固定截断前 20 条，操作日志变长后
既撑大响应又只能看到头部。改为独立分页端点：
- GET /api/v1/dashboard/activities，支持 pageNum/pageSize/module 筛选
- 模块筛选项与列表同源返回（全量模块名，不随翻页变化），前端不必再取一次全量
- 聚合端点去掉内嵌 activities，避免同一份数据两处查询

前端改用 usePagedList + 统一 AppPagination（每页 10/20/50），模块筛选由
本地过滤改为服务端筛选。集成测试 13 例（含翻页不重不漏 / 模块筛选 / 越权 403）。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-23 16:15:09 +08:00
liuwenxin
32b7940067 feat(customer): 客户评级并入客户管理并落库 
- customers 表新增 rating_score/rating_time（V13 迁移 + V10 SQL + init-dev 同步）
- 新端点 PUT /customers/{id}/rating：评分是档案属性，只存总分与评级时间（五项明细不落库）
- 列表排序 order_by=rating_score，未评分客户升序/降序都垫底，id desc 兜底稳定分页
- 前端 RatingCalculatorDialog 并入客户管理（评分列 + 评级计算按钮），删除独立页与路由
- 测试：评级保存/越界/排序垫底 3 例，test_customers.py 18 passed；schema 同步 216 passed
 2026-10-23 10:59:33 +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
e61800dcdc feat(frontend): 菜单图标与视觉设计系统落地 
- 引入 @element-plus/icons-vue 官方图标库，菜单项按模块配图标，消除
  纯文字导航的辨识成本（新增依赖已评估：Element Plus 官方同源维护）
- AppMenu/BasicLayout/router 同步：图标渲染、菜单结构与路由 meta 对齐
- index.css 视觉系统化：品牌色、语义三色（ok/warn/danger 及其 wash 层次）、
  形体与材质（圆角、缓动、阴影、等宽字体）统一为 CSS 变量，并覆盖
  Element Plus 主色
- 登录页、业务页、结算页、工作台、审批页等视图随新变量适配

验证：pnpm type-check 与 pnpm build 均通过；后端接口契约未变。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-22 19:45:54 +08:00
liuwenxin
ebc9595de2 feat(approval): 审批详情展示内容采集时间 
- 快照单显示「内容采集时间（送审版本）」；live 单显示「打开详情时实时
  读取（非送审版本）」，让复核者明确看到的是哪个时点的内容
- live 分支不展示 new Date() 生成的时刻：渲染函数里的时间非响应式，
  且 toISOString 为 UTC 会差 8 小时

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