freedak/TurboHR
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
231 Commits 2 Branches 0 Tags
b5aa5552ffc7d515a94e15eaf54f75f64153cd01
Commit Graph

231 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
selfrelease b5aa5552ff chore: 添加社保公积金账户数据修复脚本 
- fix-missing-standards.ts: 补齐无年度标准的账户
- fix-housing-base-limits.ts: 更新各城市公积金基数上下限
- check-test-accounts.ts: 删除不完整的测试账户
- assign-accounts.ts: 为全部员工按城市匹配社保公积金账户

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:42:37 +08:00
selfrelease 38075420f4 feat: 社保年度标准完善 — 医疗附加 + 继承旧配置 + 公积金独立上下限 
1. 医疗附加金额：SocialYearStandard 和 SocialInsuranceConfig 新增
   medicalOrgExtra/medicalEmpExtra 字段（如北京3元大病医疗）
   - calcSocialInsurance 计算时加上医疗附加
   - 前端年度标准表单加医疗企业/个人附加输入

2. 新建年度标准继承：新增 /inherit-config API
   - 优先用当前年度标准
   - 回退到旧 SocialInsuranceConfig/HousingFundConfig
   - 前端点击"新建年度标准"时自动继承填充

3. 公积金独立上下限：SocialYearStandard 新增 housingBaseMin/housingBaseMax
   - calcHousingFund 优先用公积金专用上下限，为0时回退到社保
   - 前端公积金年度标准表单加公积金基数上下限输入

4. blank_employees/blank_all 模式跳过试用期工资覆盖

5. 劳务协议/实习协议人员 calcBatchEntry 强制社保公积金为0

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:31:56 +08:00
selfrelease 3ac333891c fix: 劳务协议/实习协议人员薪资计算强制社保公积金为0 
calcBatchEntry 查询员工时 include contracts，判断合同类型：
- LABOR（劳务协议）/ INTERNSHIP（实习协议）→ 社保公积金基数强制0，跳过社保计算
- 其他合同类型 → 正常计算

无论哪种批次创建模式（copy_last/blank_employees/custom等），
劳务协议人员的社保公积金都为0。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:24:49 +08:00
selfrelease c3ca2c9f50 fix: 公积金基数上下限独立于社保 
问题：SocialYearStandard 只有一套 baseMin/baseMax，社保和公积金
共用，但公积金下限通常是最低工资标准（如北京2420），远低于社保
下限（如北京6326）。

修复：
- SocialYearStandard 新增 housingBaseMin/housingBaseMax 字段
- clampHousingFundBase 优先用公积金专用上下限，为0时回退到社保
- calcHousingFund 同样优先用公积金专用上下限
- 前端公积金年度标准表单加公积金基数上下限输入
- 前端公积金当前标准展示用公积金专用上下限

同时修复 blank_employees/blank_all 模式跳过试用期工资覆盖

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:23:08 +08:00
selfrelease 94959522df fix: blank_employees/blank_all 模式跳过试用期工资覆盖 
blank_employees 和 blank_all 模式下所有金额应为 0，但统一试用期
判定逻辑会把 probationSalary 覆盖到 baseSalary，导致有试用期合同
的员工基本工资不为 0。

修复：试用期判定仅对 copy_last / copy_batch / custom 模式执行，
blank_employees / blank_all 模式跳过。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:20:05 +08:00
selfrelease 2f1e339413 fix: 劳务协议人员社保基数为0时仍按基本工资计算的bug 
根因：socialInsBase || baseSalary 中 0 是 falsy，导致基数为0
的劳务协议/实习人员回退到基本工资计算社保。

修复：改为 nullish check（!= null），区分"明确设置为0"
和"未设置(null)"：
- socialInsBase = 0 → 用 0（劳务协议不交社保）
- socialInsBase = null → 用 baseSalary（回退）
- socialInsBase = 5000 → 用 5000（核定基数）

涉及文件：
- payroll.service.ts calcBatchEntry + prePayrollCheck
- payroll.routes.ts 旧版薪资计算

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:12:07 +08:00
selfrelease 54d138cc73 ux: 新建账户按钮移到社保/公积金Tab内部，按类型显示 
按钮从页面顶部移到Tab内容区顶部，文案改为"新建社保账户"/"新建公积金账户"，
明确表示新建的是当前Tab对应类型的账户。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:10:38 +08:00
selfrelease de4f8c90fb feat: 最低工资保护按当月累计判断 + 预入职员工 + 发薪年月 
1. 最低工资保护：第二批次递延时判断当月累计实发（已归档批次
   netPay 之和 + 本批次 netPay）是否低于 minWage，仅累计低于
   时才触发递延补齐，补齐目标 = minWage - 已归档累计实发

2. 预入职员工：EmployeeStatus 新增 PRE_ONBOARD 状态
   - 新增员工表单加"入职状态"选择器（正式入职/预入职）
   - 薪资批次创建排除 PRE_ONBOARD 员工
   - 花名册支持按预入职状态过滤
   - 新增 POST /:id/activate API 转正式

3. 发薪年月：PayrollBatch 新增 payMonth 字段
   - 所属月（计薪月）决定社保标准、个税累计
   - 发薪年月=实际发放月份（如十一提前发薪：所属月=10月，发薪月=9月）
   - 创建批次表单加所属月和发薪年月输入
   - 批次列表显示所属月/发薪月

4. blank_employees 模式不再自动带出基本工资

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:06:58 +08:00
selfrelease 8391c123fc refactor: 社保公积金Tab重构为账户卡片列表+展开年度标准管理 
1. 社保/公积金Tab从"选账户→展示配置"改为"账户卡片列表+展开管理"
2. 每个账户卡片可展开显示：当前标准/最低工资编辑/新建年度标准/版本历史/调基/试算
3. 账户新建/编辑/删除/设默认从设置页面迁移到社保公积金菜单
4. 设置页面去掉"社保公积金账户"Tab
5. "新建版本"改名为"新建年度标准"
6. 新增AccountCard组件独立管理每个账户的展开状态和数据查询

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 15:05:06 +08:00
selfrelease a5911d1874 fix: blank_employees 模式不再自动带出基本工资 
本月空白模式应所有金额默认 0，去掉从 emp.monthlySalary 自动填充
基本工资的逻辑，保持与"空白"语义一致。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 14:57:10 +08:00
selfrelease 63a0a6934b fix: 优化最低工资保护tooltip文案，明确免扣社保/公积金与额外补齐的区分 
minWageApplied 包含免扣社保+免扣公积金+额外补齐三部分，
原tooltip统称"补齐"容易误解为额外补了这么多现金。
改为分项显示：免扣社保 ¥X + 免扣公积金 ¥Y + 额外补齐 ¥Z

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 14:35:25 +08:00
selfrelease 904c9c6369 feat: 薪资表格增加最低工资保护和递延扣款的可视化提示 
1. 实发列：最低工资保护触发时显示橙色 + ★标记 + tooltip
2. 新增「递延扣款」列：显示递延金额（橙色）或补扣金额（蓝色）
3. 风险列：最低工资保护触发时显示橙色警告图标 + tooltip
4. 工作流步骤从4步改为3步（编辑薪资→归档锁定→发布工资条）

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 14:30:08 +08:00
selfrelease 2875965113 fix: 修复薪资编辑保存失败 + 应发计算丢失细化字段 
两个问题：
1. 编辑保存 422 错误：updateEntrySchema 要求 min(0)，但 bonus
   可能为负数（如扣款），导致 Zod 验证失败。放宽为 z.number().optional()
2. 应发不随编辑变化：编辑条目时 inputs 只合并 5 个基本字段，
   丢失了 positionSalary/performanceSalary 等细化字段，
   导致 calcBatchEntry 计算的 totalPay 不包含细化薪资项。
   修复：从 entry 中补全所有细化字段

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 14:19:43 +08:00
selfrelease ea2dfe3b4b feat: 最低工资保护 + 社保/最低工资递延补扣机制 
新增功能：
1. SocialYearStandard / SocialInsuranceConfig 增加 minWage 字段
2. BatchEntry 增加递延扣款字段（deferredSocialEmp/HousingEmp/MinWage）
3. calcBatchEntry 增加最低工资保护逻辑：
   - 实发 < 最低工资时，优先递延社保 → 递延公积金 → 递延最低工资补齐
   - 递延金额记录到 BatchEntry，次月创建批次时自动补扣
4. prePayrollCheck 增加最低工资检查（第 11/12 项）
5. 前端社保配置增加最低工资输入框
6. 前端 BatchTab 质量门禁增加最低工资/递延扣款提示

处理场景：
- 入职当月工资不足扣社保个人部分 → 递延到次月补扣
- 实发低于最低工资 → 补齐到最低工资，差额递延次月扣
- 次月创建批次时自动读取上月递延金额并补扣

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 14:15:39 +08:00
selfrelease fe427ef13f refactor: 新增员工去掉参保城市选择器，城市从社保账户继承 
- 前端：参保城市改为只读显示，从选中的社保账户自动继承
- 前端：去掉参保城市下拉选择器和 cities 查询
- 后端：clampSocialInsBase/clampHousingFundBase 改为优先按 accountId
  查年度标准裁剪基数，回退旧配置表
- 后端：createEmployee 传入 socialAccountId/housingAccountId 给 clamp 函数

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 14:08:11 +08:00
selfrelease 014c94e482 feat: 账户关联根部门 + 员工新增自动带出账户 
1. 账户管理：新建/编辑时可勾选关联 level=0 根部门（公司/分公司/子公司）
2. 后端新增 API：
   - PUT /social/accounts/:id/departments 批量关联根部门
   - GET /social/accounts/:id/departments 查询已关联部门
   - GET /social/department-account/:departmentId 按部门带出适用账户+标准
3. 部门更新 API 支持 socialAccountId/housingAccountId 字段
4. 员工新增表单：选定部门后自动带出社保公积金账户，可手动调整
5. 参保记录创建时写入 accountId

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 13:59:06 +08:00
selfrelease 63b6c9dcc7 feat: 社保公积金账户化重构 
新增 SocialAccount（账户）+ SocialYearStandard（年度标准）两层实体，
替代原 SocialInsuranceConfig/HousingFundConfig 按城市管理的方式。

- DB: 新增 SocialAccount、SocialYearStandard 表，Department 加账户关联
- 迁移: 旧 Config 表数据迁移到 Account + YearStandard
- 后端: 新增账户 CRUD + 年度标准 API，薪资计算适配 accountId
- 前端: 设置页新增账户管理 Tab，组织架构提示 level=0 可关联账户
- 前端: SocialInsurance.tsx 城市选择器改为账户选择器
- 兼容: 旧 Config 表保留，薪资计算回退旧表

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 13:50:15 +08:00
selfrelease 454b3d4b05 fix: 个税累计预扣中专项附加扣除改为按月读取实际填报金额 
原逻辑用 employee.specialDeduction（便捷字段）× 月数计算累计
专项附加扣除，未按月读取 SpecialDeductionRecord 实际金额。
若员工某月填报/取消专项附加扣除，累计值会不准。

修复：
- 优先按月查询 SpecialDeductionRecord（当年至当月）累加实际金额
- 无按月记录时回退到便捷字段 × 月数（兼容旧数据）
- taxBreakdown 增加 specialDeductionSource 字段标识数据来源

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 13:36:02 +08:00
selfrelease ce1670d171 fix: 所有批次模式统一试用期工资判定 
之前只有copy_last模式有试用期判定，copy_batch和blank_employees模式
未判定试用期，试用期员工baseSalary错误填为转正工资。

修复: 在所有模式赋值后统一加试用期覆盖逻辑（SEVERANCE/TERMINATION除外），
试用期且probationSalary>0时强制覆盖baseSalary为试用期工资。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 13:20:50 +08:00
selfrelease 37649419c4 fix: copy_last模式试用期工资被上月工资条覆盖 
bug: copy_last模式下试用期判定后被prevPayslip.baseSalary无条件覆盖，
导致试用期员工复制上月批次时仍用转正工资而非probationSalary。

修复: 试用期判定优先，仅非试用期时才用上月工资条baseSalary。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 13:16:42 +08:00
selfrelease 83b4b37de0 docs: 新增20260816用户测试说明 
包含14个测试项，覆盖花名册合规校验、工作台待办跳转、薪税管理、
提成奖金新模块、员工端登录、待签合同催办等15项优化功能。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 13:09:14 +08:00
selfrelease 5ef18cb05b fix: 风险检测同步更新actionUrl+MONTHLY类型actionUrl修正 
- runRiskDetection 更新逻辑增加 actionUrl 变化检测（非月度风险）
- 新增 MONTHLY 类型 PENDING 记录的 actionUrl 同步更新逻辑
- existingRisks 查询补充 actionUrl 字段
- 修复存量月度待办跳转目标不更新问题

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 13:00:33 +08:00
selfrelease 851557729f fix: 月度待办跳转精准化+优化清单状态同步 
- 社保/公积金待办 actionUrl 从 /money 改为 /social?tab=monthly（跳到社保公积金月度办理 Tab）
- 工资/个税待办 actionUrl 从 /money 改为 /money?tab=batch（跳到薪税管理发薪批次 Tab）
- SocialInsurance.tsx 支持 ?tab= 参数初始化 Tab
- Money.tsx 支持 ?tab= 参数初始化 Tab
- 已更新存量 PENDING 记录的 actionUrl
- 优化清单全部 10 项标注 ✅ 已完成

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 12:55:05 +08:00
selfrelease 327a41d619 fix: 线下签署登记完成时间改为记录创建时间 
completedAt 之前用签署日期（12:00:00），早于发起时间（12:23:52），
逻辑不合理。改为 completedAt = 当前时间（HR 登记时间），
signedAt = 签署日期（HR 选择的日子）。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 12:33:30 +08:00
selfrelease 5a9d440339 fix: 线下签署登记标题英文转中文+完成时间时区+签署记录角标 
1. documentTitle 中 contractType 枚举值转中文
   （LABOR→劳务协议、FIXED→固定期限劳动合同等）
2. 签署日期解析改为本地时区构造（new Date(y,m-1,d,12)），
   避免 new Date('2026-08-16') 被解析为 UTC 00:00 导致
   本地 +8 显示为 08:00:00
3. 签署记录 Tab 增加数字角标显示总记录数

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 12:26:13 +08:00
selfrelease 72a6eab3bd fix: risk.service.ts priorityOrder 重复声明导致后端启动失败 
用户手动修改 risk.service.ts 时在第 966 行重复声明了
priorityOrder（第 955 行已声明），导致 esbuild 报错
"The symbol priorityOrder has already been declared"，
后端 502 Bad Gateway。删除重复声明。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 12:22:00 +08:00
selfrelease ef6d4591be fix: 登记线下签署日期时同步创建 EsignRecord 
登记签署日期后，签署记录 Tab 中也能看到这条记录。
创建一条 status=COMPLETED 的线下手签 EsignRecord，
避免已签合同在签署记录中无痕可查。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 12:17:39 +08:00
selfrelease 040c5a3ab9 feat: 待签合同支持登记线下签署日期 
- 线下手签合同：展开后可点击「登记签署日期」选择日期并保存
  保存后合同从待签列表移除（signDate 已填写）
- 电子签合同：签署日期由电签系统自动回写，不可手动修改
- 后端新增 POST /esign/sign-date 接口
  电子签合同拒绝手动修改签署日期

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 12:13:07 +08:00
selfrelease 79145b47b9 fix: 待签合同列表中合同类型英文改为中文 
LaborContract.contractType 枚举值（FIXED/UNFIXED/LABOR等）
转为中文显示（固定期限劳动合同/劳务协议等）。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 12:08:06 +08:00
selfrelease 8c7fb99219 ux: 待签合同列表新增「待签内容」列，展示场景标签+签署方式 
每行员工直接显示待签文件的类型（劳动合同/离职协议/规章制度等）
和签署方式（电子签/线下手签），无需展开即可看出是什么待签。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 12:06:15 +08:00
selfrelease 71f0619d18 feat: 电子签署改为「待签合同」，按员工聚合+催办功能 
1. 菜单「电子签署」改名为「待签合同」
2. 页面重构为两个 Tab：
   - 待签合同：按员工聚合展示所有未签文件（EsignRecord
     PENDING/SIGNING + LaborContract signDate 为空），展开可
     查看该员工名下所有待签文件详情
   - 签署记录：原有全部签署记录列表（保留筛选功能）
3. 催办功能：点击催办生成一次性自动登录链接（24h有效），
   指向员工端签署页，弹窗展示二维码+可复制链接，HR 发给
   员工扫码直接进入签署
4. 后端新增接口：
   - GET /esign/pending 待签合同按员工聚合列表
   - POST /esign/remind 催办生成自动登录链接

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 11:57:43 +08:00
selfrelease ebd47e4500 fix: Excel 批量导入员工时自动设置默认密码（手机号后6位） 
与 createEmployee 保持一致，导入时自动生成 passwordHash，
无需管理员再手动重置。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 11:34:58 +08:00
selfrelease d7fdec49fa feat: 员工端密码登录完整支持 
1. createEmployee 创建员工时自动设置默认密码（手机号后6位）
2. 管理员重置密码接口 POST /employees/:id/reset-password
   （重置为手机号后6位）
3. 员工自己修改密码接口 POST /portal/change-password
   （需验证旧密码，新密码至少6位）
4. 花名册详情添加"重置密码"按钮，显示默认密码提示
5. 员工端导航栏添加"修改密码"入口，弹窗修改密码

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 11:28:56 +08:00
selfrelease 26d0b7070d fix: 员工端 portalAxios 缺少 response interceptor 导致登录失败 
问题：portalAxios 没有 response interceptor，axios 返回完整的
response 对象，unwrap 取 res.data 得到的是 { success, data: {...} }
而非 { token, employee }，导致前端 data.token 为 undefined，
自动登录/密码登录/验证码登录全部失败。

修复：给 portalAxios 添加与管理端 api 实例一致的 response
interceptor：(response) => response.data，使 unwrap 能正确
解包到 { token, employee }。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 11:11:43 +08:00
selfrelease 94b85d5c36 fix: 同企业内员工身份证和手机号唯一性完整校验 
补充以下场景的查重：
1. updateEmployee：编辑员工信息时手机号/身份证查重
   （排除自身，同组织内不可与其他员工重复）
2. import.routes.ts：Excel 批量导入时身份证和手机号查重
   （重复则跳过并记录错误日志）

至此同企业内身份证和手机号唯一性校验覆盖全部入口：
- createEmployee（新增员工）
- updateEmployee（编辑员工）
- Excel 导入（批量导入）
- work-process（走 createEmployee）

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 10:59:38 +08:00
selfrelease 6b3e1f9d46 fix: 手机号查重硬校验 + portal 登录跨组织安全 
问题：
1. 后端 createEmployee 只有身份证查重，没有手机号查重，
   同组织内可重复录入相同手机号，导致员工端登录混乱
2. portal 登录用 findFirst 按 phone 查，未考虑跨组织重复，
   多组织同手机号时会登录到错误员工
3. Contracts.tsx 的 AddEmployeeModal 完全没有手机号查重

修复：
1. contract.service.ts createEmployee 添加手机号查重硬校验
   （同组织内 phone 唯一，抛 DUPLICATE_PHONE 错误）
2. portal.routes.ts 密码登录改为 findMany 遍历校验密码，
   验证码登录改为 findMany 取第一个匹配
3. Contracts.tsx AddEmployeeModal 添加手机号查重和警告提示

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 10:57:06 +08:00
selfrelease 13f485a049 fix: contractType zod 枚举与 Prisma/前端对齐 
zod schema 只允许 FIXED|UNFIXED|UNSIGNED 三种，但 Prisma 枚举和
前端 /contract-types 接口返回 8 种（含 LABOR/INTERNSHIP/DISPATCH/
OUTSOURCING/PARTTIME），导致选择劳务协议等类型时校验失败。

扩展 createEmployeeSchema 和 addContractSchema 的 contractType
枚举为全部 8 种，与 Prisma ContractType 枚举一致。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 09:28:58 +08:00
selfrelease dd0e84a219 ux: 部门字段统一改为下拉选择（组织架构部门树） 
将以下页面的部门输入框从 Input 改为 Select 下拉选择，
数据源为组织架构部门树（带层级缩进）：

1. roster/modals.tsx - RehireModal 重新入职弹窗
2. roster/modals.tsx - AddEmployeeModal 添加员工弹窗
3. roster/BasicInfo.tsx - 编辑员工基本信息
4. Contracts.tsx - 合同管理新增员工弹窗

下拉选项从 /departments 接口获取，按树形结构展示，
提交时传部门名称字符串（保持后端兼容）。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 09:23:24 +08:00
selfrelease 9a826c16b0 fix: 组织架构根部门自动创建为公司名 
1. 注册时自动创建根部门（公司名，level=0），作为组织架构顶层节点
2. 部门列表查询时兼容历史组织：若无任何部门，自动补建根部门
3. 创建部门时若未指定父部门，默认挂到根部门下
4. 前端 OrgChart：
   - 根部门显示"公司"标签，不可编辑/删除
   - 新增部门时默认父部门为根部门
   - 上级部门下拉移除"无（根部门）"选项，改为列出所有可选部门

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 09:16:31 +08:00
selfrelease c2c99126be fix: 部门创建/更新时 parentId 空字符串导致外键约束违反 
前端选择"无（根部门）"时传 parentId=""，空字符串是 falsy 跳过了
父部门存在性检查，但 ...data 展开后 Prisma 尝试创建 parentId=""
的部门，数据库外键约束违反（无 id="" 的部门）。

修复：创建/更新时将空字符串统一转为 null，并显式传字段而非展开。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-16 09:12:40 +08:00
selfrelease aa8189f571 docs: 新增 20260815 优化批次用户测试指南 
面向测试人员的功能验证手册，覆盖 5 个批次共 43 项任务的完整测试用例：
- P0 紧急（6 项）：草稿保存、补偿金合计、驳回更新、违法解除风险、日期校验、批次数据源
- P1 高（14 项）：社保联动、合规软阻断、补偿月数、年龄校验、转正、三期性别等
- P2 中（9 项）：文案调整、年假折算、证件号码、手机查重、批量操作、菜单调整
- P3 规划（2 项）：组织架构+审批流、客服工作台
- 电子签署（12 项）：发起签署、验证码签署、证据链、线下手签、花名册联动

每个测试用例含前置条件、详细测试步骤、预期结果，附测试结果记录模板。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 17:34:44 +08:00
selfrelease 1f545fb489 fix: 补充社保截止月自动推导+草稿schema字段+面包屑文案 
测试验证发现3个问题并修复：

1. TASK-007 社保联动：Organization.socialInsCutoffDay 字段缺失，
   createDraft 未自动推导社保/公积金截止月。
   - 新增 Organization.socialInsCutoffDay 字段（默认15日）
   - createDraft 中根据离职日期与截止日比较，自动推导截止月
   - cutoffDay 日前离职 → 截止月=离职月-1，日后 → 截止月=离职月

2. TASK-002 补偿金合计：createTerminationDraftSchema 缺少
   compensationBreakdown 和 checklistOverrides 字段，导致 zod parse
   时被过滤。已补充字段声明。

3. TASK-028 去掉用工办理：Breadcrumb 中 /work-process 标签仍为
   "用工办理"，已改为"批量流程"。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 17:26:14 +08:00
selfrelease 101cfcf508 fix: 补充缺失的DB字段 idType + contractCategory 
测试验证发现两个字段声明在优化计划中标记完成但实际未添加到schema：
- Employee.idType：证件类型（ID_CARD/PASSPORT/HK_MACAO_TAIWAN/OTHER）
- LaborContract.contractCategory：合同分类（LABOR_CONTRACT/LABOR_AGREEMENT/INTERNSHIP/FLEXIBLE）

已通过 prisma db push 应用到数据库，历史数据为NULL（兼容）

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 17:12:56 +08:00
selfrelease fa0dc82d38 docs: 优化计划补充第五批电子签署任务（TASK-031~042） 
新增12项电子签署优化任务：
- P0：后端路由重写+模板渲染、验证码确认、证据链体系
- P1：回写合同、组织开关校验、线下手签、花名册联动、转正联动
- P2：scene模板填充、管理端UI、员工端UI

更新执行状态总览（31→43条）、批次总览、依赖关系图、风险注意事项

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 16:56:24 +08:00
selfrelease 8fcc7ae143 feat: 转正弹窗显示原薪资 + 薪资变化时联动签署 
- ConfirmModal 显示原薪资（¥xxx），转正薪资默认填入原薪资
- 转正薪资与原薪资不同时，提示"将发起薪酬调整确认书签署"
- confirmMutation onSuccess：薪资变化时弹出签署方式选择弹窗
  - scene=POLICY，文件标题为"转正薪酬调整确认书"
  - 备注记录薪资变化：¥原薪资 → ¥新薪资

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 16:51:41 +08:00
selfrelease 3da61d5a09 feat: 花名册操作联动电子签署 + 修复重复创建 
## 修复
- POST /contracts 不再自动创建签署记录（由前端根据signMethod决定），避免与ContractInfo重复创建

## 新增 SignMethodChoice 通用组件
- 花名册操作成功后弹窗选择签署方式：电子签/线下手签/稍后处理
- 电子签：自动创建ESignRecord（PENDING），员工在员工端签署
- 线下手签：跳转签署页面，预填员工/场景/标题，上传扫描件登记
- 稍后处理：跳过，可后续在签署页面手动发起

## 花名册4项操作联动签署方式选择
- 重新入职：操作成功后弹窗（scene=CONTRACT，劳动合同）
- 合同续签：操作成功后弹窗（scene=CONTRACT，续签劳动合同）
- 薪酬变更：操作成功后弹窗（scene=POLICY，薪酬调整确认书）
- 调岗调动：操作成功后弹窗（scene=POLICY，调岗确认书）

## ESign页面支持URL参数
- 读取 ?action=paper-sign 自动打开线下手签登记Modal
- 预填employeeId/scene/documentTitle

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 16:45:53 +08:00
selfrelease 434c63c6d3 feat: 线下手签完整流程 + 证据链体系 
## 数据库
- ESignRecord 增加 signMethod 字段（ELECTRONIC/PAPER）
- 增加线下手签专用字段：signedAt、signedLocation、witnessName、witnessPhone、scanFileUrls

## 后端
- esign.routes.ts 新增线下手签接口：
  - POST /esign/paper-upload：上传签署扫描件（multer多文件，10MB限制）
  - POST /esign/paper-sign：线下手签登记（创建COMPLETED记录+证据链+回写合同）
- esign.service.ts：autoCreateEsignRecord 设置 signMethod=ELECTRONIC
- 静态文件服务复用 /uploads 统一映射

## 前端管理端
- ESign.tsx 新增"线下手签登记"按钮和 Modal：
  - 选择员工、文件类型、签署日期、地点、见证人
  - 上传签署扫描件（多文件）
  - 登记后自动创建证据链
- 列表增加"签署方式"列（电子签/线下手签标签）
- 详情页增加签署方式标签 + 线下手签信息卡片 + 扫描件列表

## 前端员工端
- MyEsign.tsx 列表增加线下手签标签
- 详情页增加线下手签信息卡片（签署日期/地点/见证人/扫描件）
- 签署操作区域：线下手签记录显示"线下手签已登记"，不显示验证码签署

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 16:36:46 +08:00
selfrelease 12f1cde7c5 feat: 花名册操作自动创建电子签署流程 
## 新增 esign.service.ts
- autoCreateEsignRecord 公共方法，供其他业务模块调用
- 自动渲染模板文件内容 + 创建证据链

## 自动触发签署
- 增加员工（创建合同时）：自动创建劳动合同电子签署记录（scene=CONTRACT）
- 主动离职（createDraft type=RESIGNATION）：自动创建离职协议签署（scene=RESIGNATION）
- 公司解聘（executeTermination type=TERMINATION）：执行完成后自动创建离职协议签署

## 前端提示
- 添加员工成功后提示"劳动合同电子签署已自动发起"，可跳转签署页面
- 主动离职成功后提示"离职协议电子签署已自动发起"

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 16:27:15 +08:00
selfrelease b6fc93cc61 feat: 电子签署完整流程 + 证据链体系 
## 后端
- esign.routes.ts 重写：
  - 发起签署时校验组织电子签开关（POLICY/PAYSLIP/ONBOARDING）
  - 自动从模板渲染文件内容（CONTRACT→劳动合同模板，RESIGNATION→离职协议模板）
  - 创建签署记录时自动创建证据链（发起签署事件）
  - 新增签署详情接口、证据链查看接口
  - 取消签署追加证据链事件
  - 签署状态查询自动处理过期记录
- portal.routes.ts 员工端 esign 重写：
  - 新增验证码发送接口（/esign/:id/send-code）
  - 签署操作增加验证码校验（5次错误限制）
  - 签署完成追加证据链（IP/UA/时间戳/验证码/签署人）
  - 签署完成回写合同 signMethod + attachmentName（签署证据）
  - 列表和详情接口自动处理过期记录

## 前端
- ESign.tsx 管理端重写：
  - 发起签署增加场景选择（5种场景）
  - 场景选择后自动填充默认文件标题
  - 新增签署详情页（文件内容预览 + 证据链时间线）
  - 签署流程说明
- MyEsign.tsx 员工端重写：
  - 签署操作增加验证码确认流程
  - 60秒倒计时限制
  - 文件内容预览
  - 签署完成状态展示
- api-services.ts：
  - esignApi 增加 detail/evidence 接口
  - portalApi 增加 esignSendCode 接口
  - signEsign 增加 verifyCode 参数

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 16:19:37 +08:00
selfrelease d216e4a57a fix: AI助手页面输入框超出屏幕（适配PageGuide高度） 
ChatTab 高度从 calc(100vh - 220px) 调整为 calc(100vh - 250px)，
补偿新增 PageGuide 操作说明占用的高度，避免输入框被挤出屏幕。

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 16:04:46 +08:00