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

17 Commits

Author SHA1 Message Date
liuwenxin
108bf87225 feat(核算)!: 添加 T+ 正式核算与采集托管 
补齐源快照、资料预演、正式导入及工资核算的依赖链路。
新增版本化输入、逐段 FIFO、生成锁和结构化当月调整，
并提供默认关闭的周期采集、有限重试及 Windows 托管。

原始客户资料、私有配置及首页改动不纳入本次提交。

BREAKING CHANGE: 升级前需应用新增迁移，并通过
PAYROLL_MAKER_USER_ID 绑定实际工资制作人，否则业务只读。
旧单批次核算默认关闭；历史兼容需显式启用
PAYROLL_ALLOW_LEGACY_CALCULATION。生产启用和真实金额待验收。
 2026-11-02 09:42:53 +08:00
liuwenxin
013d6e7a74 docs(测试): 标注 T+ 前端 e2e 待补 
按模块测试约定，T+ 页面验收节点应统一编写 Playwright 用例
并记录运行结果；当前仅有 type-check 验证，显式标注避免遗忘。

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-30 09:58:27 +08:00
liuwenxin
ea989ce9ad feat(tplus): 新增 T+ 同步管理页面与菜单入口 2026-10-28 11:42:51 +08:00
liuwenxin
823d9f02ec docs: 补充文案约定与侧栏层级说明 
- backend/README 新增「面向业务人员的文案」约定：param_registry 的
  description 是唯一显示源、枚举值在页面上必须翻译、报错要给下一步、
  init-dev.sql 种子必须与 registry 同源、模板层禁止出现开发者语汇
- frontend/README 增补侧栏层级口径、最近动态独立分页端点，以及分页的
  两个坑（v-loading 不要罩到分页条上、翻页失败必须退回实际显示页）
- backend/tests/README 记录本轮运行结果

Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-23 16:23:14 +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
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
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
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
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
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
d77728265b docs(business): M2 收尾——e2e 记录、缺陷表、AI_CONTEXT 摘要更新 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 17:13:21 +08:00
liuwenxin
c512cb77fb docs: 后端接口清单补基础/业务数据两节与 M2 关键约定；前端 e2e 清单预登记 
Co-Authored-By: Claude Code <noreply@anthropic.com>
 2026-10-13 13:43:17 +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
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