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

220 Commits

This Branch
This Branch
All Branches
Author SHA1 Message Date
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
selfrelease 7e720d9bfc feat: 北京解聘合规增强 — 政策法规库+地区过滤+工会回执证据链 
1. 政策法规库（RAG知识库）：
   - 新增6条北京地区单方解除劳动合同工作指引种子数据
   - 涵盖通知工会程序、函件内容要求、回执要求、监督提示函、仲裁审查等
   - 企业用户通过AI问答可检索到北京地区工会通知规定

2. 地区差异化合规检查：
   - getChecklistForReason 增加 orgCity 参数
   - 工会通知检查项仅北京地区显示（FAULT/NONFAULT/LAYOFF）
   - 前端解聘方式说明中北京工会提示仅北京地区动态显示
   - 非北京地区不显示工会通知检查项，避免误导

3. 工会回执上传+证据链留存：
   - 后端新增3个接口：上传回执文件、保存回执信息、获取回执信息
   - 回执信息保存到草稿 checklistOverrides
   - 自动追加到证据链（appendEvidence），作为劳动仲裁举证材料
   - 前端合规检查步骤增加工会回执上传区域
   - 确认提交步骤展示回执文件链接
   - 新增 uploads 静态文件服务

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 16:01:02 +08:00
selfrelease e8c6d27979 feat: 增加北京解聘合规性环节（通知工会程序+文档样本） 
依据《规范用人单位单方解除劳动合同工作指引（试行）》

后端：
- 合规检查增加"通知工会"和"工会回执"检查项（FAULT/NONFAULT/LAYOFF）
- 检查项标注北京地区要求：提前5个工作日书面通知工会
- 模板系统新增3个文档样本：
  · 拟解除劳动合同通知工会函（附件1样式）
  · 工会回执（附件2样式）
  · 工会劳动法律监督提示函（附件3样式）

前端：
- 过错解除/非过错解除/裁员三种方式的步骤说明增加工会通知程序
- 确认提交步骤展示工会通知状态（已通知/未通知/已收到回执）

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:51:45 +08:00
selfrelease f8dca2f22c fix: 修复TASK-024/025/026/027验收标准 + 更新优化计划文档 
- TASK-024: 证明Modal增加类型选择（收入/在职/离职证明）
- TASK-025: 续签按钮增加合同到期状态过滤（仅expiring/expired显示）
- TASK-026: 批量转正增加弹窗填写转正日期和薪资
- TASK-027: 批量开具证明增加类型选择弹窗
- 更新20260815-优化计划.md，标注复查结果

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:43:23 +08:00
selfrelease 75e08b90c0 ux: 统一PageGuide位置到页面最顶部 + 侧边栏不显示品牌名 
- SalaryDashboard/ESign: PageGuide 从标题下方移到标题上方
- Termination: PageGuide 从列表视图块内移到页面顶部
- SocialInsurance/Dashboard/Attendance: 页面顶部新增总览 PageGuide
- 侧边栏左上角不再回退显示品牌名，仅显示企业名称

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:34:51 +08:00
selfrelease 456cd91a83 brand: 软件名称从"企业用工专家/TurboHR"统一改为"安职通" 
- 登录/注册/忘记密码页标题
- 侧边栏和员工端布局默认名称
- 新手引导欢迎语
- 帮助中心问答
- 验收测试页面标题
- 后端 RAG 知识库
- 部署脚本日志输出

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:29:13 +08:00
selfrelease f523f84c18 ux: 全部页面添加操作说明 PageGuide 
为以下17个缺少操作说明的页面添加 PageGuide 组件：
- OrgChart: 组织架构管理
- SupportDashboard: 客服工作台
- Money: 薪酬管理
- AIAssistant: AI 智能助手
- Settings: 系统设置
- Calendar: 人事日历
- Templates: 模板管理
- AuditLog: 审计日志
- Notifications: 通知中心
- MedicalPeriodCalculator: 医疗期计算器
- HealthCheck: 用工健康检查
- AnnualValueReport: 年度价值报表
- CompanyFiles: 公司文件管理
- LeaveApproval: 请假审批
- TrainingRecords: 培训记录
- PerformanceRecords: 绩效记录
- DisciplinaryRecords: 违纪记录

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:26:02 +08:00
selfrelease 5c3f3503ea feat: 花名册增加职务筛选 + 去掉解聘页新建按钮 
- 后端：roster list 接口增加 position 筛选参数
- 后端：新增 /roster/positions 接口返回在职员工职务去重列表
- 前端：花名册筛选栏增加"全部职务"下拉框
- 前端：导出也支持 position 参数
- 前端：去掉解聘补偿页面的"新建解聘"按钮，解聘统一从花名册发起
- 前端：空状态提示改为"请在花名册中选择员工发起解聘"

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:22:06 +08:00
selfrelease 81e1cd0f72 ux: 花名册列表两行记录样式美化 
- 姓名列：姓名加粗深色 + 证件号码淡灰小字，紧凑行间距
- 社保缴费列：个人/企业改为右对齐标签式，字号区分主次
- 操作列：两行按钮间增加分隔线，按钮间距收紧
- 全行 padding 从 py-3 调整为 py-2.5，行高更紧凑
- 行间分隔线变淡（gray-100 → gray-50），hover 效果加 group

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:14:13 +08:00
selfrelease 34b82bdbe7 feat: 建立部门和职务关联关系，调动时按部门过滤可选职务 
- 17个部门专属职务绑定到对应部门（如工人→项目运营中心、会计→财务部）
- 8个通用职务保持不绑定（部门经理/主管/组长等，所有部门可用）
- 前端调动弹窗优化职务过滤：通用职务 + 该部门专属 + 父部门专属（子部门继承）

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:06:23 +08:00
selfrelease e3d46d9142 feat: 调部门改为调动，使用组织架构部门和职务下拉选择 
- 后端：EmployeeDepartmentRecord 增加 oldPosition/newPosition 字段
- 后端：department-change 接口支持 departmentId 关联 + position 职务变动
- 后端：同步更新 Employee.departmentId 和 Employee.position
- 前端：DeptChangeModal 改为从组织架构下拉选择目标部门（树形）和职务
- 前端：选择部门后自动过滤该部门下的职务
- 前端：按钮文案从"调部门"改为"调动"

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

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
 2026-08-15 15:00:38 +08:00
selfrelease e8470e7bb4 fix: 组织架构页面无数据 - 响应拦截器已剥离一层data，无需再取r.data.data 
api.ts 响应拦截器 (response) => response.data 已剥离 axios response，
OrgChart 中 api.get().then(r => r.data.data) 多取了一层导致返回 undefined。
改为 .then(r => r.data) 即可正确获取部门/岗位数组。

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

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