fix: 创建批次后自动切换列表筛选到批次所属月

问题：批次列表默认按当前月筛选，创建其他月份的批次后列表不显示新批次，用户以为创建失败。修复：创建成功后自动将列表月份筛选切换到批次所属月。 Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
fix: 创建年度标准时同effectiveFrom已存在则更新而非报错
2026-08-17 06:46:19 +08:00 · 2026-08-16 15:48:21 +08:00 · 2026-08-16 15:42:37 +08:00 · 2026-08-16 15:31:56 +08:00 · 2026-08-16 15:24:49 +08:00 · 2026-08-16 15:23:08 +08:00
151 changed files with 24677 additions and 2699 deletions
@@ -0,0 +1,32 @@
 序号,类型,页面,功能点,需调整项目,字典表,逻辑,备注
 1,调整,,,“劳动合同”,是否应调整为更为宽泛的用工关系,,
 2,调整,离职管理,,“离职日期”,,办理离职的离职日期调整后，应影响社保截止年月和公积金截止年月（例如15日之前离职不缴纳当月社保、15日之后离职缴纳当月社保）可配置,
 3,调整,离职管理,合规检查,“是否已支付经济补偿金”,,不勾选无法进行下一步，应增加保存后未办事项进入代办和风险提醒中,
 4,新增,离职管理,费用结算,“剩余年假天数”,,调用或录入，影响离职日期计算,
 5,调整,离职管理,费用结算,“补偿月数”,N、N+1、2N、其他,选择协商解除时可填写修改并重新运算补偿金,
 6,调整,离职管理,费用结算,“计算基数”,近12月平均工资、合同工资、其他,可调整，按照选用算法计算，其他需手动填写,
 7,调整,离职管理,费用结算,“手动调整补偿金分项”,,调整后合计应付未同步更新,
 8,调整,离职管理,工作交接,勾选的内容应为待办事项，前三项为离职必须要执行的任务,,未到离职日期，工作交接未完成，无法进行下一步操作，应调整为可进行下一步，未完成事项进入代办提醒,
 9,调整,离职管理,,将离职管理模块中的“新建解聘”功能并入到花名册员工列表的操作栏中的离职功能,,,
 10,调整,离职管理,,“解聘驳回”,,解聘驳回后，重新修改了解聘类型、金额等，系统未按照新内容更新,
 11,调整,离职管理,,“新增解聘”,,选择了违法解除后（2N），修改降低了经济补偿金金额，合规提醒并未风险提示可继续进行下一步操作，需要增加合规风险提醒,
 12,调整,用工办理,合同续签,“新增合同”,,续签新增合同，合同开始日期应为上一份合同结束日期+1（例如第一份合同结束日期为2023年5月31日，那么新增合同后合同开始日期应为2026年6月1日）,
 13,调整,用工办理,合同续签,“新增合同”,,续签新增合同，合同结束日期早于合同开始日期，系统未校验判断产生了时间倒置,
 14,调整,花名册,添加员工,“身份证号”,,全域修改为“证件号码”,
 15,调整,花名册,添加员工,年龄限制,,添加员工时根据证件号码对员工年龄进行合规性筛查,
 16,调整,花名册,员工明细编辑,编辑修改“入职日期”,,花名册明细中的状态未变更（例如从今天变更为下月1日入职，状态应变更为待入职）,
 17,调整,花名册,添加员工,“手机号”,,录入手机号时进行查重,
 18,调整,用工办理,员工转正,将用工办理模块中的“员工转正”功能移植到花名册员工列表的操作栏中，替换发薪功能,,,
 19,调整,用工办理,员工转正,“员工转正”,,填写了转正薪资，在员工花名册里未体现变更后内容，是否与已签订的用工协议匹配需要验证，如不一致应发起合同变更流程,
 20,调整,用工办理,开具证明,将用工办理模块中的“开具证明”功能移植到花名册员工列表的操作栏中,,,
 21,调整,用工办理,合同续签,将用工办理模块中的“合同续签”功能移植到花名册员工列表的操作栏中,,,
 22,调整,用工办理,合同变更,“合同变更”,,选择员工无法查询到对应的合同,
 23,调整,用工办理,合同续签,“合同续签”,,原合同ID无法查询，建议修改为选择该员工已存在的合同,
 24,调整,花名册,,勾选多名员工时，增加批量转正功能,,,
 25,调整,花名册,,勾选多名员工时，增加批量开具证明功能,,,
 26,调整,用工办理,,去掉用工办理模块,,,
 27,调整,系统设置,,增加简单的组织架构，用于满足三步以内的审批流转,,,
 28,调整,薪税管理,创建发薪批次,补偿金批次,,批次类型为补偿金批次的，经济补偿金发放数据读取错误,
 29,调整,,特殊员工,“特殊员工”,,男职工应无法选择三期,
 30,BUG,全域,,全域保存草稿后部分录入的数据未保存,,全域保存草稿后部分录入的数据未保存,
 31,调整,,,单立户客服端,,,
@@ -0,0 +1,384 @@
 # 20260815 优化清单
 > 来源：`20260815-优化.csv`（共 31 条）
 > 结合 TurboHR 当期功能梳理，按模块归类，标注根因 / 修复方向 / 优先级 / 涉及文件。
 > 优先级：P0 紧急（影响业务正确性/数据丢失）｜P1 高（流程阻塞或合规风险）｜P2 中（体验/增强）｜P3 规划（新模块）
 ---
 ## 一、离职管理（问题 2-11）
 ### 问题 2：离职日期调整后未联动社保/公积金截止年月
 - **现状**：`Termination.tsx:1334-1338` 社保截止、公积金截止为 `<Input type="month">` 手动填写，默认值取 `terminationDate.slice(0,7)`，但修改离职日期后不会重算，也无"15 日前/后"规则。
 - **修复方向**：
  1. 增加"离职日期 → 社保/公积金截止月"自动推导规则：每月 15 日（含）前离职不缴当月、15 日后离职缴纳当月，截止月 = 离职月 - 0 或 -1。
  2. 阈值日期（15 日）做成系统设置可配置项（`org_settings.socialInsCutoffDay`，默认 15）。
  3. 离职日期变更时自动回填两个截止月，同时保留手动覆盖入口。
 - **优先级**：P1 高
 - **涉及文件**：`frontend/src/pages/Termination.tsx`、`backend/src/services/termination.service.ts`、`backend/prisma/schema.prisma`（org_settings 增字段）
 ### 问题 3：合规检查"是否已支付经济补偿金"硬阻断
 - **现状**：合规检查为必勾才能进入下一步，未勾选时无法继续，且未保存的检查项不进入待办/风险提醒。
 - **修复方向**：
  1. 将"必勾才能下一步"改为"未勾选可下一步，但自动写入待办事项 + 风险提醒"。
  2. 待办项关联 `termination_draft`，在 Dashboard/风险中心展示"XX 员工解聘未支付经济补偿金"。
  3. 提交审批时若仍存在未闭环必检项，给出强提示但不阻断（除非法定禁止情形，如孕期/工伤）。
 - **优先级**：P1 高
 - **涉及文件**：`Termination.tsx`（step 2 校验逻辑）、`backend/src/services/notification.service.ts`、`frontend/src/pages/Dashboard.tsx`
 ### 问题 4：费用结算新增"剩余年假天数"
 - **现状**：费用结算步骤仅展示补偿金/代通知金/赔偿金，未涉及年假折算。
 - **修复方向**：
  1. 费用结算区新增"剩余年假天数"字段，支持手动录入或调用考勤模块年假余额（若有）。
  2. 按规则计算未休年假折算工资：`日工资 × 剩余年假天数 × 300%`（未休部分）。
  3. 折算金额计入"合计应付"。
 - **优先级**：P2 中
 - **涉及文件**：`Termination.tsx`（step 3）、`backend/src/services/termination.service.ts`（cost 计算扩展）
 ### 问题 5：补偿月数支持 N / N+1 / 2N / 其他
 - **现状**：`Termination.tsx:1442` 补偿月数取 `costResult.cappedMonths`（系统按工龄自动算 N），不允许选择其他模式。
 - **修复方向**：
  1. 补偿月数改为下拉：N、N+1、2N、其他（自定义输入）。
  2. 选择"协商解除"时允许修改月数并实时重算补偿金。
  3. 选择"其他"时需填写说明，留痕到 `compensationBreakdown.adjustments`。
 - **优先级**：P1 高
 - **涉及文件**：`Termination.tsx`（step 3 补偿金区）、`backend/src/services/termination.service.ts`
 ### 问题 6：计算基数支持多种来源
 - **现状**：`Termination.tsx:1443` 计算基数固定取 `costResult.cappedWage`（近 12 月平均工资，且有三倍社平工资封顶）。
 - **修复方向**：
  1. 计算基数改为下拉：近 12 月平均工资（默认）、合同工资、其他（手动填写）。
  2. 切换来源后实时重算补偿金，并记录选用算法到草稿。
  3. "其他"需填写说明，受三倍社平封顶提示但不强制。
 - **优先级**：P1 高
 - **涉及文件**：`Termination.tsx`、`termination.service.ts`
 ### 问题 7：手动调整补偿金分项后合计未同步
 - **现状**：`Termination.tsx:530` 注释提到"系统预估 + 手动调整差额"，但 `handleSave`（578 行附近）仍使用 `costResult.grandTotal`，未叠加 `compAdjustments`。20260803 问题 13 已识别但未闭环。
 - **修复方向**：
  1. 实际合计 = `costResult.grandTotal + Σ(adjustments.to - adjustments.from)`，保存与确认页统一使用此值。
  2. 调整任一分项后实时刷新"合计应付"显示。
  3. 后端 `compensationBreakdown.adjustments` 已支持，前端需正确传递并回显。
 - **优先级**：P0 紧急
 - **涉及文件**：`Termination.tsx`（`handleSave`、确认步骤、step 3 合计显示）
 ### 问题 8：工作交接未完成无法下一步
 - **现状**：`Termination.tsx:552-554` step 4 校验 `work_handover/equipment_return/access_revoke` 三项必须完成才能下一步。
 - **修复方向**：
  1. 改为可下一步，未完成事项自动写入待办（关联离职草稿）。
  2. 交接清单前三项标注"离职必办"，未完成时在确认页和风险中心强提示。
  3. 待办在到达离职日期前持续提醒，超期升级为风险。
 - **优先级**：P1 高
 - **涉及文件**：`Termination.tsx`（step 4 校验）、`notification.service.ts`、`Dashboard.tsx`
 ### 问题 9：离职管理"新建解聘"并入花名册操作栏
 - **现状**：花名册操作栏已有"离职"按钮（`Roster.tsx:734-746`，触发 `ResignModal` 创建 RESIGNATION 草稿），但"新建解聘"仍在离职管理列表页独立入口，且仅支持 RESIGNATION 类型。
 - **修复方向**：
  1. 花名册操作栏"离职"按钮扩展为支持所有解聘类型（协商/过错/非过错/裁员/到期/违法），弹出类型选择后跳转 Termination 向导并预填员工。
  2. 离职管理列表页移除"新建解聘"按钮，仅保留草稿列表与审批。
 - **优先级**：P1 高
 - **涉及文件**：`Roster.tsx`、`roster/modals.tsx`（`ResignModal`）、`Termination.tsx`（支持 URL 参数预填）
 ### 问题 10：解聘驳回后修改内容未更新
 - **现状**：驳回后重新修改解聘类型、金额等，系统未按新内容更新（疑似使用旧草稿快照或前端未刷新）。
 - **修复方向**：
  1. 排查 `updateDraft` 是否正确覆盖 `reason/compensationBreakdown/terminationDate`。
  2. 驳回后再编辑走 `updateDraft`（而非新建），版本号 +1，旧版本留快照。
  3. 前端进入驳回草稿时强制重新拉取最新数据。
 - **优先级**：P0 紧急
 - **涉及文件**：`Termination.tsx`（编辑驳回草稿逻辑）、`backend/src/services/termination.service.ts`、`backend/src/routes/termination.routes.ts`
 ### 问题 11：违法解除降低补偿金后无合规风险提醒
 - **现状**：选择 ILLEGAL（2N）后手动降低补偿金金额，`acknowledgeRisk` 仅在初始选择违法解除时提示，金额变动后不再校验。
 - **修复方向**：
  1. 实际补偿金 < 法定 2N 时，强制弹出合规风险提醒，需勾选"已知风险并继续"才能下一步。
  2. 风险提醒记录到 `compensationBreakdown.riskAcknowledged`，留痕可审计。
  3. 同步推送风险中心。
 - **优先级**：P0 紧急
 - **涉及文件**：`Termination.tsx`（step 3 风险校验）、`risk-center`
 ---
 ## 二、用工办理 / 合同（问题 12-13、18、20-23、26）
 ### 问题 12：合同续签新增合同开始日期应为上一份结束日期 +1
 - **现状**：`WorkProcess.tsx:93-99` RENEW 表单 `newStartDate` 为手动填写，无自动推导。
 - **修复方向**：
  1. 选择员工后自动拉取最新已签合同，`newStartDate` 默认 = 上一份合同 `endDate + 1 天`。
  2. 允许手动覆盖，但偏离时提示。
 - **优先级**：P1 高
 - **涉及文件**：`WorkProcess.tsx`（RENEW 字段）、`backend/src/services/work-process.service.ts`
 ### 问题 13：合同结束日期早于开始日期未校验
 - **现状**：`WorkProcess.tsx` 表单提交前无日期前后关系校验，已产生时间倒置数据。
 - **修复方向**：
  1. 前端表单提交前校验 `endDate >= startDate`，否则阻断并提示。
  2. 后端 `work-process.service.ts` 增加同样校验，双保险。
  3. 历史倒置数据提供修复脚本/列表提示。
 - **优先级**：P0 紧急
 - **涉及文件**：`WorkProcess.tsx`、`work-process.service.ts`
 ### 问题 18：员工转正移植到花名册操作栏，替换发薪
 - **现状**：花名册操作栏（`Roster.tsx:694-747`）有调薪/发薪/调部门/离职，无转正入口；转正仍在用工办理 CONFIRM 流程。
 - **修复方向**：
  1. 操作栏"发薪"按钮（`Wallet`，711-720 行）替换为"转正"按钮（`CheckCircle`），点击弹出转正 Modal（转正日期 + 转正薪资）。
  2. 仅试用期员工（`probationInfo.isProbation`）显示转正按钮。
  3. 发薪入口保留在薪税管理模块。
 - **优先级**：P1 高
 - **涉及文件**：`Roster.tsx`、`roster/modals.tsx`（新增 `ConfirmModal`）
 ### 问题 19：转正薪资未回写花名册，未与用工协议匹配校验
 - **现状**：CONFIRM 流程填写 `regularSalary` 后未同步到员工 `monthlySalary`，也未校验与已签合同薪资是否一致。
 - **修复方向**：
  1. 转正完成后同步更新员工 `monthlySalary`，并在花名册明细展示"试用期薪资 → 转正薪资"变更记录。
  2. 校验转正薪资与最新合同 `monthlySalary` 是否一致，不一致时提示并支持发起合同变更流程（CHANGE）。
 - **优先级**：P1 高
 - **涉及文件**：`work-process.service.ts`（CONFIRM 完成回调）、`Roster.tsx`、`roster/SalaryInfo.tsx`
 ### 问题 20：开具证明移植到花名册操作栏
 - **现状**：操作栏无开具证明入口，需进用工办理 INCOME_CERT/LEAVING_CERT 流程。
 - **修复方向**：操作栏新增"证明"按钮（`FileText`），点击弹出证明类型选择（收入证明/离职证明/在职证明），复用 WorkProcess 的 INCOME_CERT/LEAVING_CERT 表单。
 - **优先级**：P2 中
 - **涉及文件**：`Roster.tsx`、`roster/modals.tsx`
 ### 问题 21：合同续签移植到花名册操作栏
 - **现状**：操作栏无续签入口，批量续签在列表顶部（`Roster.tsx:444`），单人续签需进用工办理。
 - **修复方向**：操作栏新增"续签"按钮（`Repeat`），仅合同即将到期（≤30 天）或已到期员工显示，点击跳转 WorkProcess RENEW 并预填员工。
 - **优先级**：P2 中
 - **涉及文件**：`Roster.tsx`、`WorkProcess.tsx`（支持 URL 参数预填）
 ### 问题 22：合同变更选择员工无法查询到对应合同
 - **现状**：`WorkProcess.tsx:88-92` CHANGE 表单 `contractId` 为 `contract-select` 类型，但选择员工后未按员工过滤合同列表，导致查不到。
 - **修复方向**：
  1. `contract-select` 组件接收 `employeeId` 参数，仅返回该员工的有效合同。
  2. 后端合同查询接口支持 `employeeId` 过滤。
 - **优先级**：P1 高
 - **涉及文件**：`WorkProcess.tsx`（contract-select 组件）、`backend/src/routes/contract.routes.ts`
 ### 问题 23：合同续签原合同 ID 无法查询，改为选择已存在合同
 - **现状**：`WorkProcess.tsx:95` RENEW 表单 `oldContractId` 为 `text` 类型，需手动输入 UUID，无法查询。
 - **修复方向**：将 `oldContractId` 改为 `contract-select`（同问题 22），选择员工后下拉展示该员工已存在合同。
 - **优先级**：P1 高
 - **涉及文件**：`WorkProcess.tsx`（RENEW 字段类型）
 ### 问题 26：去掉用工办理模块
 - **现状**：侧边栏"团队"分组有"用工办理"入口（`SidebarNav.tsx:47`），承载 HIRE/ONBOARD/CONFIRM/CHANGE/RENEW/SUSPEND/INCOME_CERT/LEAVING_CERT/FLEXIBLE 等流程。
 - **修复方向**：
  1. 将各流程入口下沉到花名册操作栏（转正/续签/变更/开具证明/入职）和独立页面（合同管理/电子签署）。
  2. 侧边栏移除"用工办理"菜单项，保留 WorkProcess 页面作为批量流程入口（或迁移到"更多"分组）。
  3. 需先完成问题 18/20/21/22/23 的入口下沉，再移除菜单。
 - **优先级**：P2 中（依赖前置问题完成）
 - **涉及文件**：`SidebarNav.tsx`、`Roster.tsx`、`WorkProcess.tsx`、`App.tsx`（路由）
 ---
 ## 三、花名册（问题 14-17、24-25）
 ### 问题 14：身份证号全域改为"证件号码"
 - **现状**：`roster/modals.tsx:687`、`WorkProcess.tsx:60/109/132/140` 等多处 label 为"身份证号"。
 - **修复方向**：全域搜索替换 label "身份证号" → "证件号码"，字段名 `idCardNumber` 保持不变（兼容历史数据），同时支持证件类型下拉（身份证/护照/港澳台通行证）。
 - **优先级**：P2 中
 - **涉及文件**：`roster/modals.tsx`、`WorkProcess.tsx`、`Roster.tsx`（搜索 placeholder）、`SpecialStatus.tsx` 等
 ### 问题 15：添加员工根据证件号码进行年龄合规筛查
 - **现状**：`roster/modals.tsx:557` 已根据身份证号自动计算性别，未做年龄校验。
 - **修复方向**：
  1. 解析证件号码出生日期，计算年龄。
  2. 年龄 < 16 岁禁止录入（童工红线），强提示并阻断。
  3. 年龄 ≥ 60（男）/55（女干部）/50（女工人）提示已达法定退休年龄，确认后允许录入但标记"退休返聘"。
 - **优先级**：P1 高
 - **涉及文件**：`roster/modals.tsx`（`handleIdCardChange`）
 ### 问题 16：编辑入职日期后状态未变更
 - **现状**：花名册明细编辑入职日期后，员工状态未联动（如改为下月 1 日入职，状态应从"在职"变为"待入职"）。
 - **修复方向**：
  1. 编辑入职日期时，若新入职日期 > 今天，状态自动设为 `PENDING_ONBOARD`（待入职）；若 ≤ 今天，设为 `ACTIVE`。
  2. 状态变更需二次确认，避免误操作。
  3. 变更记录留痕到员工档案。
 - **优先级**：P1 高
 - **涉及文件**：`roster/BasicInfo.tsx`、`backend/src/services/employee.service.ts`
 ### 问题 17：录入手机号查重
 - **现状**：`roster/modals.tsx:702` 手机号为选填，无查重；身份证号已有查重（691 行）。
 - **修复方向**：
  1. 手机号录入时调用查重接口，已存在则提示"该手机号已用于 XX 人员"。
  2. 允许继续保存（一人多号/家庭号场景），但强提示确认。
 - **优先级**：P2 中
 - **涉及文件**：`roster/modals.tsx`、`backend/src/routes/employee.routes.ts`（新增手机号查重接口）
 ### 问题 24：花名册多选增加批量转正
 - **现状**：`Roster.tsx:444-447` 批量操作仅有"批量续签""批量解聘"，无批量转正。
 - **修复方向**：
  1. 多选后新增"批量转正"按钮，仅对试用期员工生效。
  2. 弹窗统一填写转正日期（默认今天）和转正薪资（可按原薪资倍数/手动逐人填写）。
  3. 调用后端批量转正接口，复用问题 18 的转正逻辑。
 - **优先级**：P2 中
 - **涉及文件**：`Roster.tsx`、`roster/modals.tsx`、`backend/src/services/employee.service.ts`
 ### 问题 25：花名册多选增加批量开具证明
 - **现状**：无批量开具证明入口。
 - **修复方向**：
  1. 多选后新增"批量开具证明"按钮，选择证明类型（在职/收入）后批量生成。
  2. 支持批量下载（ZIP）或逐个下载。
 - **优先级**：P2 中
 - **涉及文件**：`Roster.tsx`、`backend/src/services/work-process.service.ts`（批量生成接口）
 ---
 ## 四、薪税管理（问题 28）
 ### 问题 28：补偿金批次经济补偿金发放数据读取错误
 - **现状**：`money/BatchTab.tsx:110` 批次类型支持 `SEVERANCE`（补偿金），但创建补偿金批次时经济补偿金发放数据读取逻辑有误（疑似读取了工资数据或未关联离职草稿的 `compensationBreakdown`）。
 - **修复方向**：
  1. 排查 `createBatch` 当 `type=SEVERANCE` 时的数据源，应从已审批通过的 `termination_draft` 读取 `compensationBreakdown.grandTotal`。
  2. 校验员工范围：仅包含有未发放补偿金的离职员工。
  3. 增加预览页展示每位员工的补偿金明细，确认后再创建批次。
 - **优先级**：P0 紧急
 - **涉及文件**：`money/BatchTab.tsx`、`backend/src/services/payroll.service.ts`（SEVERANCE 分支）
 ---
 ## 五、特殊员工（问题 29）
 ### 问题 29：男职工应无法选择三期
 - **现状**：`SpecialStatus.tsx:123` 默认 `type: 'PREGNANCY'`，新增/编辑表单未根据员工性别过滤类型，男职工也可选"三期"。
 - **修复方向**：
  1. 选择员工后，若 `gender === '男'`，类型下拉移除"三期"选项或置灰并提示"三期仅适用于女性员工"。
  2. 后端保存时增加校验，男职工 + PREGNANCY 组合拒绝并返回 400。
 - **优先级**：P1 高
 - **涉及文件**：`SpecialStatus.tsx`（表单 type 下拉）、`backend/src/services/special-status.service.ts`
 ---
 ## 六、系统设置 / 组织架构（问题 27）
 ### 问题 27：增加简单组织架构，支持三步以内审批流转
 - **现状**：系统无组织架构模块，`LeaveApproval.tsx:90` 仅有简单审批，无层级流转；`settingsApi.org()` 仅返回企业基本信息。当前员工仅有 `department`（字符串）和 `position`（字符串，前端 label "职务/岗位"）两个字段，无上下级关系。
 - **职位/岗位设计决策**：
  - **现状**：数据库只有一个 `position` 字段（`schema.prisma:225`，注释"岗位"），前端 label 统一为"职务/岗位"（`roster/modals.tsx:686`、`roster/BasicInfo.tsx:153/328`），已合并为一个字段。
  - **建议方案 A（推荐，保留一个字段）**：维持 `position` 单字段，label 保持"职务/岗位"。组织架构中"岗位"作为独立实体管理（岗位字典，含岗位名称、职级、编制人数），员工 `position` 关联到岗位字典。优点：改动小，兼容历史数据，符合当前使用习惯。
  - **方案 B（拆分两个字段）**：新增 `jobTitle`（职位，如"经理/主管/专员"）+ `position`（岗位，如"前端工程师"）。优点：职级体系更清晰；缺点：需改 schema + 全域表单 + 历史 position 数据需清洗归类，工作量大。
  - **结论**：建议采用方案 A，组织架构模块中"岗位"独立建表（`Position` 字典），员工 `position` 字段值关联岗位字典 ID 或保持文本（兼容旧数据），审批流按"直属上级 → 部门负责人"两级流转，无需引入职级。
 - **修复方向**：
  1. 系统设置新增"组织架构"子页：树形部门（`Department` 自引用 parent）+ 岗位字典（`Position`，含名称/所属部门/编制）+ 上下级关系（`Employee.supervisorId`）。
  2. 新建简单审批流配置：最多 3 步（发起人 → 直属上级 → 部门负责人），支持按流程类型（休假/离职/调薪）配置是否启用某步。
  3. 现有 `LeaveApproval` 接入审批流引擎，离职/调薪等流程可选启用。
  4. 数据模型：`Department`（树形，parent 自引用）、`Position`（岗位字典）、`Employee.supervisorId`、`ApprovalFlow`（type + steps）。
 - **优先级**：P3 规划（新模块，建议单独排期）
 - **涉及文件**：`Settings.tsx`、新增 `pages/OrgChart.tsx`、`backend/prisma/schema.prisma`、`backend/src/services/approval.service.ts`
 ---
 ## 七、全域问题（问题 1、30、31）
 ### 问题 1："劳动合同"调整为更宽泛的"用工关系"
 - **现状**：系统多处文案使用"劳动合同"（合同管理、离职管理、WorkProcess 等）。
 - **修复方向**：
  1. 全域文案审计：将面向用户的"劳动合同"在合适场景改为"用工关系"或"用工协议"（涵盖劳动合同/劳务协议/实习协议/灵活用工协议）。
  2. 数据层 `Contract` 模型保持不变，新增 `contractCategory` 字段区分劳动关系类型。
  3. 注意法律文书模板中的"劳动合同"为法定术语，不可改。
 - **优先级**：P2 中
 - **涉及文件**：`SidebarNav.tsx`、`Contracts.tsx`、`WorkProcess.tsx`、`Termination.tsx` 等文案
 ### 问题 30：全域保存草稿后部分录入数据未保存（BUG）
 - **现状**：多个流程页面支持"保存草稿"，但部分字段（如 `compAdjustments`、`handoverItems` 备注、`checklistOverrides`）未持久化。
 - **修复方向**：
  1. 排查各流程 `saveDraft` 的 payload，确保覆盖所有前端 state。
  2. 后端 `draft` 表 schema 检查是否有字段缺失（`compensationBreakdown.adjustments`、`handoverItems.remark` 等）。
  3. 增加"草稿完整性校验"：保存后立即回读对比，缺失字段告警。
  4. 重点排查：Termination（补偿金调整/交接备注）、WorkProcess（自定义字段）。
 - **优先级**：P0 紧急
 - **涉及文件**：`Termination.tsx`（`handleSaveDraft`）、`WorkProcess.tsx`、`backend/src/services/termination.service.ts`、`backend/src/services/work-process.service.ts`
 ### 问题 31：单立户客服端
 #### 已实现部分（平台管理端，代码完整可运行）
 系统已有完整的"平台管理端"（Platform），前后端代码均已实现：
 **前端（4 页面 + 1 侧边栏）**：
 - `frontend/src/pages/platform/PlatformLogin.tsx` — 独立登录页
 - `frontend/src/pages/platform/PlatformDashboard.tsx` — 数据总览（企业数/用户数/员工数/合同数/工资条数 + 套餐分布 + 最近注册企业）
 - `frontend/src/pages/platform/PlatformOrgs.tsx` — 企业租户管理（创建/搜索/编辑套餐/删除/管理员账号管理）
 - `frontend/src/pages/platform/PlatformUsers.tsx` — 用户管理（启用/禁用）
 - `frontend/src/components/layout/PlatformSidebar.tsx` — 独立侧边栏（带 ADMIN 徽章）
 - `frontend/src/lib/api-services.ts:938-965` — `platformApi` 完整定义
 - `frontend/src/App.tsx:217-220` — 四条路由注册 + `PlatformRoute` 角色校验（`SUPER_ADMIN`）
 **后端（1 路由文件 437 行 + 1 schema）**：
 - `backend/src/routes/platform.routes.ts` — 完整实现 11 个接口：
  - `GET /platform/dashboard` — 平台总览数据
  - `GET /platform/orgs` — 企业列表（分页+搜索+套餐筛选）
  - `POST /platform/orgs` — 创建企业（含管理员账号自动创建）
  - `GET /platform/orgs/:id` — 企业详情（含用户列表）
  - `PUT /platform/orgs/:id` — 编辑企业（套餐/上限/联系人）
  - `PUT /platform/orgs/:id/admin` — 编辑企业管理员（姓名/手机号/重置密码）
  - `DELETE /platform/orgs/:id` — 删除企业（级联）
  - `GET /platform/users` — 全平台用户列表
  - `PUT /platform/users/:id/toggle` — 启用/禁用用户
  - `GET /platform/admins` — 平台管理员列表
  - `POST /platform/admins` — 创建平台管理员
 - `backend/src/schemas/platform.schema.ts` — 入参校验
 - `backend/src/middleware/auth.ts` — `platformAdminMiddleware` 权限校验
 **数据模型**：
 - `Organization` 模型支持多租户（`plan`/`maxEmployees`/`city`/`contactName`/`contactPhone`）
 - `User.role` 含 `SUPER_ADMIN` 角色，`orgId` 为 null（平台管理员不归属任何租户）
 - `backend/prisma/seed-multi-org.ts` — 多租户种子数据
 **结论**：单立户服务（开户+租户管理+用户管理+数据总览）**已完整实现**，CSV 标注为"调整"类型也印证了该功能已存在。
 #### 可增强部分（客服工作台，尚未实现）
 当前平台管理端是"运营管理后台"，定位为超级管理员/运营使用。如需扩展为客服人员日常服务客户的工作台，以下功能尚未实现：
 | 增强项 | 现状 | 说明 |
 |--------|------|------|
 | 工单管理 | 缺失 | 无 `Ticket` 模型、无工单页面，客服无法接收/分派/跟进客户问题 |
 | 客户会话 | 缺失 | 无会话模块，客服无法与客户企业管理员实时沟通或留言 |
 | 租户数据穿透 | 缺失 | `SUPER_ADMIN` 仅能看租户列表和统计，无法穿透查看指定租户的花名册/合同/薪税/风险等业务数据 |
 | 协助操作 | 部分已有 | 管理员重置密码已有，代客户发起流程/调整套餐等未实现 |
 | AI 辅助 | 缺失 | 当前 AI 仅在企业端，客服侧无 AI 问答辅助 |
 | 操作日志 | 缺失 | 当前 `AuditLog` 仅在企业端，客服操作无留痕 |
 **增强修复方向（如需）**：
 1. 新增角色 `SUPPORT`（客服），独立路由 `/support/*`，独立登录页 `/support/login`。
 2. 客服端侧边栏含：工单中心、客户会话、租户数据查看、协助操作、AI 辅助、操作日志。
 3. 数据模型新增：`Ticket`（工单：标题/内容/状态/优先级/归属租户/处理人）、`TicketMessage`（工单回复）、`ChatSession`（客户会话）。
 4. 租户数据穿透：客服选择租户后，以"只读+代操作"模式访问该租户的业务数据（复用现有 API，请求头带 `X-Support-Tenant-Id`，后端中间件切换租户上下文）。
 5. AI 辅助复用现有 AI 接口，独立会话隔离。
 6. MVP 建议：先做工单 + 租户数据查看 + AI 辅助三项。
 - **优先级**：核心功能已完成；增强部分 P3 规划（新模块，建议单独排期）
 - **涉及文件（增强部分）**：新增 `frontend/src/pages/support/*`、`frontend/src/components/layout/SupportSidebar.tsx`、`backend/prisma/schema.prisma`（Ticket/ChatSession 模型）、`backend/src/routes/support.routes.ts`、`backend/src/middleware/support-tenant.ts`
 ---
 ## 优先级汇总
 | 优先级 | 问题 | 说明 |
 |--------|------|------|
 | **P0 紧急** | 7、10、11、13、28、30 | 数据丢失/业务正确性/合规风险 |
 | **P1 高** | 2、3、5、6、8、9、12、15、16、18、19、22、23、29 | 流程阻塞或合规校验缺失 |
 | **P2 中** | 1、4、14、17、20、21、24、25、26 | 体验优化/功能增强 |
 | **P3 规划** | 27、31增强 | 新模块（组织架构+审批流 / 客服工作台增强），需单独排期 |
 | **已完成** | 31核心 | 单立户服务（平台管理端）已完整实现，前后端代码可运行 |
 ---
 ## 建议执行顺序
 1. **第一批（P0，立即）**：问题 30（草稿丢失）→ 问题 7（补偿金合计）→ 问题 10（驳回未更新）→ 问题 11（违法解除风险）→ 问题 13（合同日期校验）→ 问题 28（补偿金批次数据）
 2. **第二批（P1，本迭代）**：离职管理联动（2/3/5/6/8/9）→ 花名册校验（15/16）→ 用工办理入口下沉（18/19/22/23）→ 特殊员工性别校验（29）
 3. **第三批（P2，排期）**：花名册批量操作（24/25）→ 文案统一（1/14）→ 入口下沉收尾（20/21/26）→ 年假折算（4）→ 手机号查重（17）
 4. **第四批（P3，规划）**：组织架构与审批流（27）→ 客服工作台增强（31增强，MVP = 工单 + 租户数据查看 + AI 辅助）
   - 问题 31 核心功能（单立户服务/平台管理端）已完整实现，无需开发
 ---
 ## 备注
 - 本清单基于当期代码梳理，部分"根因"为基于代码静态分析的推断，实际修复前需运行复现确认。
 - 涉及数据库 schema 变更的（问题 2/27/31），需走 migration + 回滚方案，符合数据 8 铁律。
 - 涉及文案全域替换的（问题 1/14），需同步更新 HelpModal、OnboardingGuide 等帮助文案。
 - 问题 26（去掉用工办理模块）依赖问题 18/20/21/22/23 完成，不可先行移除。
@@ -0,0 +1,410 @@
 # 20260816 优化清单
 > 来源：用户测试反馈（编号 4-13，共 10 项）
 > 结合 TurboHR 当期代码梳理，按模块归类，标注根因 / 修复方向 / 优先级 / 涉及文件。
 > 优先级：P0 紧急（影响业务正确性/合规）｜P1 高（流程阻塞或合规风险）｜P2 中（体验/增强）｜P3 规划（新模块）
 >
 > **✅ 全部 10 项已于 20260816 完成实现，前后端 tsc 均通过。完成明细见"五、已完成优化"章节（编号 5-15）。**
 ---
 ## 一、花名册 · 添加雇员（问题 4-8）
 ### 问题 4：合同状态未签署时仍显示"正常"
 - **现状**：`backend/src/services/contract.service.ts:74` 注释明确"有合同记录（FIXED/UNFIXED/LABOR/INTERNSHIP），即使 signDate 为 null 也按正常合同处理"，`getContractStatus` 在有合同记录时直接返回 `active`/`正常`，未区分"已签署"与"待签署"。
 - **修复方向**：
  1. `getContractStatus` 增加"待签署"判定：有合同记录但 `signDate` 为空，或关联的电子签署记录状态为 `PENDING`/未 `COMPLETED` 时，返回 `status: 'pending_sign'`，`statusText: '待签署'`，`riskLevel: 'medium'`。
  2. 仅当 `signDate` 已填且（无电子签署或电子签署已 COMPLETED）时才返回 `active`/`正常`。
  3. 前端花名册列表/详情同步展示"待签署"标签。
 - **优先级**：P1 高
 - **涉及文件**：`backend/src/services/contract.service.ts`、`frontend/src/pages/Roster.tsx`、`frontend/src/pages/roster/ContractInfo.tsx`
 ### 问题 5：社保状态未办理时仍显示"正常"
 - **现状**：花名册添加雇员表单（`roster/modals.tsx:719`）有 `socialInsBase`/`socialInsStartMonth`/`housingFundBase`/`housingFundStartMonth`，但无"社保状态"字段；花名册列表/详情也未展示社保办理状态，默认视为"正常"。
 - **修复方向**：
  1. 新增社保状态字段（派生而非存储）：根据 `socialInsStartMonth` 是否填写、是否已做"办理完成"操作判定。
  2. 状态枚举：`待办`（未填写基数/起始月或未办理完成）、`正常`（已办理且在缴）、`停缴`（已设截止月）。
  3. 后端 `employee.service.ts` 在花名册列表返回 `socialInsStatus` 派生字段。
  4. 前端花名册列表/详情展示社保状态标签。
  5. 提供"办理完成"操作入口（可在社保公积金模块或花名册操作栏）。
 - **优先级**：P1 高
 - **涉及文件**：`backend/src/services/employee.service.ts`、`backend/src/services/contract.service.ts`（或新增 `social-insurance.service.ts` 派生方法）、`frontend/src/pages/Roster.tsx`、`frontend/src/pages/roster/PayslipSocialInfo.tsx`
 ### 问题 6：证件号码未验证有效性
 - **现状**：`roster/modals.tsx:886` `canSubmit` 仅校验 `idCardNumber.length >= 18`，未做身份证校验位（第 18 位）、出生日期合法性、月份/日期范围等有效性验证；`handleIdCardChange`（755 行）只做性别推导和查重，未做格式校验。
 - **修复方向**：
  1. 新增身份证有效性校验：校验位算法（前 17 位加权求和取模映射第 18 位）、出生日期合法、月份 01-12、日期合法。
  2. 校验失败时 `ageWarning` 返回 `BLOCK`，阻断保存。
  3. 后端 `employee.service.ts` 创建/更新员工时同步做校验（双保险）。
  4. 支持非身份证类型（护照/港澳台通行证）时跳过 18 位校验（已部分实现，需确认）。
 - **优先级**：P1 高
 - **涉及文件**：`frontend/src/pages/roster/modals.tsx`（`handleIdCardChange`、`canSubmit`）、`backend/src/services/employee.service.ts`、`backend/src/routes/employee.routes.ts`
 ### 问题 7：超龄人员仍可选择劳动合同
 - **现状**：`roster/modals.tsx:784` 超龄仅 `WARN` 提示"已达法定退休年龄，建议确认是否按退休处理"，未阻断选择 `FIXED`/`UNFIXED` 劳动合同；超龄人员依法应签劳务协议/实习协议，不能签劳动合同。
 - **修复方向**：
  1. 年龄 ≥ 法定退休年龄（男 60、女干部 55、女工人 50）时，合同类型下拉移除 `FIXED`/`UNFIXED`，仅保留 `LABOR`/`INTERNSHIP`/`UNSIGNED`，并提示"超龄人员不可签订劳动合同，请选择劳务协议"。
  2. 强制选 `LABOR` 时联动问题 8 的社保基数置 0 逻辑。
  3. 后端 `employee.service.ts`/`work-process.service.ts` 增加校验：超龄 + 劳动合同类型组合拒绝并返回 400。
  4. `femaleWorkerType` 字段用于判定女职工退休年龄（干部 55/工人 50），需在年龄计算时引用。
 - **优先级**：P1 高
 - **涉及文件**：`frontend/src/pages/roster/modals.tsx`（合同类型下拉、`ageWarning` 逻辑）、`backend/src/services/employee.service.ts`、`backend/src/services/work-process.service.ts`
 ### 问题 8：签署劳务协议员工社保基数未置 0 且仍可缴纳社保
 - **现状**：`roster/modals.tsx:983` 社保缴费基数为独立输入框，选择 `LABOR` 合同类型时未联动置 0 或禁用；劳务协议人员依法不缴纳社保。
 - **修复方向**：
  1. 合同类型选择 `LABOR`/`INTERNSHIP` 时，社保缴费基数、公积金缴费基数自动置 0 且字段禁用，社保开始年月清空。
  2. UI 提示"劳务协议/实习协议人员不缴纳社保公积金"。
  3. 后端 `employee.service.ts` 保存时校验：`contractType === LABOR` 且 `socialInsBase > 0` 时拒绝或强制置 0。
  4. 薪税批次生成时排除劳务协议人员，或其社保公积金项强制为 0。
 - **优先级**：P1 高
 - **涉及文件**：`frontend/src/pages/roster/modals.tsx`（社保公积金区联动）、`backend/src/services/employee.service.ts`、`backend/src/services/payroll.service.ts`
 ---
 ## 二、工作台（问题 9-10）
 ### 问题 9：待办事项无法点击跳转
 - **现状**：`Dashboard.tsx:1148` 已有 `<Link to={todo.actionUrl}>`，但部分待办的 `actionUrl` 为空、指向不存在的路由，或后端 `dashboard.service.ts` 生成待办时未填充 `actionUrl`，导致点击无反应或跳转 404。
 - **修复方向**：
  1. 排查后端 `dashboard.service.ts` 各类待办（CONTRACT/TERMINATION/ONBOARDING/RETIREMENT/MONTHLY/SALARY）的 `actionUrl` 生成逻辑，确保每条待办都有有效跳转目标。
  2. `actionUrl` 为空时前端降级为"查看详情"按钮，弹窗展示待办内容，而非死链。
  3. 校验 `actionUrl` 指向的路由真实存在（如 `/roster?employeeId=xxx`、`/termination?draftId=xxx`）。
  4. 跳转后自动定位到对应员工/草稿/合同。
 - **优先级**：P1 高
 - **涉及文件**：`backend/src/services/dashboard.service.ts`、`frontend/src/pages/Dashboard.tsx`（`TodoIcon`/待办列表渲染）
 ### 问题 10：风险提醒内容不合理（含反向引导 bug）
 - **现状**：`Dashboard.tsx:202` 风险提醒按 `todo.type` 过滤（CONTRACT/TERMINATION/ONBOARDING/RETIREMENT），具体提醒文案、阈值、优先级、跳转目标生成逻辑在后端 `risk.service.ts`。存在两类问题：
  **问题 A · 反向引导（典型 bug）**：`risk.service.ts:309-337` 三期/医疗期/工伤员工的风险提醒，文案是"解聘受限/不得解除劳动合同"，但 `actionUrl` 却指向 `/termination?employee=xxx`（解聘向导页面）。等于提示"该员工不能解聘，点这里去解聘她"——完全反向引导，可能诱导 HR 误操作违法解除。
  ```ts
  // risk.service.ts:309-317（错误示例）
  if (emp.isPregnant) {
    risks.push({
      type: 'TERMINATION',
      title: `${emp.name}处于孕期/哺乳期，解聘受限`,
      description: '三期女职工不得依非过错理由解除劳动合同...',
      actionUrl: `/termination?employee=${encodeURIComponent(emp.name)}`,  // ← 反向引导
    })
  }
  // isInMedicalPeriod（319-328）、isWorkInjured（329-338）同样指向 /termination
  ```
  **问题 B · 提醒规则/阈值/去重不合理**：部分提醒内容重复、阈值不合理或与实际业务无关（如合同到期 30 天提前量偏短，同一合同到期可能生成多条提醒）。
 - **修复方向**：
  1. **修正反向引导（问题 A，P0 紧急）**：
     - 三期/医疗期/工伤员工的"解聘受限"提醒，`actionUrl` 改为指向员工详情或特殊状态页（`/roster?employee=xxx` 或 `/special-status?type=PREGNANCY`），让 HR 确认员工状态，而非跳到解聘页面。
     - 这类提醒的本质是"信息提示 + 合规警示"，不是"可操作待办"。应在解聘向导 step 2 合规检查时硬阻断（Termination 已实现法定禁止情形阻断），工作台只做信息展示。
     - 可考虑将这类提醒的 `type` 从 `TERMINATION` 改为 `COMPLIANCE`（合规提示），与可操作的解聘待办区分。
  2. **梳理风险提醒规则清单（问题 B）**：合同到期（30/60/90 天分级）、未签合同（>30 天/>1 年）、试用期将满、退休预警、社保断缴、离职未办结等。
  3. **每条提醒明确**：触发条件、提醒文案模板、优先级、跳转目标、是否可忽略、是"可操作待办"还是"信息提示"。
  4. **去除重复提醒**（如同一合同到期生成多条），合并同类项。
  5. **调整阈值至合理区间**（如合同到期提醒从 30 天提前到 60 天，给 HR 反应时间）。
  6. **前端按优先级排序展示**，高风险置顶；信息提示类提醒不提供"去处理"按钮，仅提供"查看详情"。
 - **优先级**：P0 紧急（问题 A 反向引导）/ P2 中（问题 B 规则优化）
 - **涉及文件**：`backend/src/services/risk.service.ts`（`detectTerminationRisks` 309-342 行、`detectSpecialStatusRisks`）、`frontend/src/pages/Dashboard.tsx`（风险提醒 Tab 渲染、按 type 区分操作按钮）
 ---
 ## 三、薪税管理 · 发放批次（问题 11、13）
 ### 问题 11：获取工资时自动识别试用期并填充试用期工资
 - **现状**：不需要新增"获取试用期工资"按钮。已有的"获取工资"逻辑（创建批次、添加人员时自动填充 `baseSalary`）应自动识别员工是否处于试用期，是则填 `probationSalary`，否则填 `monthlySalary`。
  **根因**：当前 3 处获取工资逻辑用了**错误的试用期判定**，判定的是"入职不到 1 年"而非"当前在试用期内"：
  ```ts
  // payroll2.routes.ts:355-359（创建批次 copy_last 模式）
  // payroll2.routes.ts:610-614（添加人员到批次）
  // payroll.routes.ts:380-388（旧版批量生成工资条）
  if (emp.contracts?.[0]?.probationSalary
      && new Date(emp.contracts[0].startDate) > new Date(Date.now() - 365 * 24 * 60 * 60 * 1000)) {
    baseSalary = emp.contracts[0].probationSalary  // ← 只要入职不到1年就用试用期工资，转正后仍用
  } else if (emp.monthlySalary) { ... }
  ```
  问题：员工转正后（如试用期 3 个月，入职 6 个月），仍会被判定为试用期，`baseSalary` 错误填为 `probationSalary` 而非转正工资。
  **正确逻辑**（`payroll.service.ts:326-331`、`payroll.service.ts:600-603` 已实现）：
  ```ts
  const probationEnd = new Date(contract.startDate)
  probationEnd.setMonth(probationEnd.getMonth() + contract.probationMonths)
  if (probationEnd > new Date()) { ... }  // 试用期未结束
  ```
 - **修复方向**：
  1. 抽取统一的试用期判定工具函数 `isInProbation(contract, referenceDate?)`：`contract.startDate + contract.probationMonths > referenceDate`（默认当前日期，批次场景按批次月份的月末判定）。
  2. 修正 3 处错误逻辑，统一调用 `isInProbation`：
     - `payroll2.routes.ts:355-359`（创建批次 copy_last 模式）
     - `payroll2.routes.ts:610-614`（添加人员到批次）
     - `payroll.routes.ts:380-388`（旧版批量生成工资条，如仍在用）
  3. 判定为试用期 → `baseSalary = contract.probationSalary`；已转正 → `baseSalary = employee.monthlySalary`。
  4. 批次场景按批次月份判定（如批次月份是 2026-08，则判定 2026-08-31 时员工是否仍在试用期），避免跨月转正时填错。
  5. `probationSalary` 为 0 或未填时，即使试用期也回退用 `monthlySalary`（兼容旧数据）。
 - **优先级**：P1 高（影响工资发放正确性）
 - **涉及文件**：`backend/src/routes/payroll2.routes.ts`（355-359、610-614）、`backend/src/routes/payroll.routes.ts`（380-388）、`backend/src/services/payroll.service.ts`（抽取 `isInProbation` 工具函数，或放 `contract.service.ts`）
 ### 问题 13：编辑薪资新增"获取提成奖金"功能
 - **现状**：`money/BatchTab.tsx` 已有 `BONUS` 批次类型（`isBonus` 分支，617 行），但普通薪资批次编辑薪资时无"获取提成奖金"按钮，无法从提成奖金数据按月拉取填充 `bonus` 字段。
 - **修复方向**：
  1. 编辑薪资步骤新增"获取提成奖金"按钮，调用后端接口按批次月份从提成奖金表拉取每位员工的提成奖金。
  2. 拉取的奖金填入 `entry.bonus` 字段，支持正负值（奖金/扣款）。
  3. 后端新增接口 `POST /payroll2/batches/:id/fetch-bonus`，按批次月份查询提成奖金表并返回。
  4. 前端展示获取结果摘要（X 人提成奖金已填充，合计 ¥Y），支持覆盖确认。
  5. 依赖问题 12 的提成奖金数据表先建立。
 - **优先级**：P2 中（依赖问题 12）
 - **涉及文件**：`frontend/src/pages/money/BatchTab.tsx`（编辑薪资步骤按钮区）、`backend/src/routes/payroll.routes.ts`、`backend/src/services/payroll.service.ts`、`backend/src/services/commission-bonus.service.ts`（新增）
 ---
 ## 四、提成奖金 · 新模块（问题 12）
 ### 问题 12：团队页面下新增提成奖金页面
 - **现状**：`SidebarNav.tsx:44` "团队"分组下仅有花名册，无提成奖金入口；`money/BatchTab.tsx` 的 `BONUS` 批次是年终奖发放，非按月提成奖金管理。需新建独立提成奖金模块。
 - **修复方向**：
  1. **数据模型**：新增 `CommissionBonus` 表（`orgId`、`employeeId`、`month` YYYY-MM、`amount` 支持正负值、`remark`、`createdAt`、`createdBy`），唯一索引 `(orgId, employeeId, month)`。
  2. **后端**：新增 `commission-bonus.service.ts` + `commission-bonus.routes.ts`：
     - `GET /commission-bonus?month=YYYY-MM` 按月列表
     - `POST /commission-bonus/batch` 按月批量导入（JSON 数组或 Excel）
     - `PUT /commission-bonus/:id` 编辑单条
     - `DELETE /commission-bonus/:id` 删除单条
     - `GET /commission-bonus/template` 下载导入模板
  3. **前端**：新增 `frontend/src/pages/CommissionBonus.tsx` 页面：
     - 月份选择器（默认当月）
     - 列表展示该月所有员工提成奖金（员工/部门/金额/备注）
     - 支持单条编辑、删除
     - "批量导入"按钮（上传 Excel，字段：员工姓名/证件号码/月份/金额/备注）
     - 金额支持正负值（正为奖金，负为扣款）
     - 合计展示（总奖金/总扣款/净额）
  4. **菜单**：`SidebarNav.tsx` "团队"分组新增"提成奖金"入口，路由 `/commission-bonus`。
  5. **权限**：新增权限码 `PERM_COMMISSION_BONUS_VIEW`/`PERM_COMMISSION_BONUS_EDIT`/`PERM_COMMISSION_BONUS_IMPORT`。
 - **优先级**：P3 规划（新模块）
 - **涉及文件**：`backend/prisma/schema.prisma`（新增 `CommissionBonus` 模型 + migration）、`backend/src/services/commission-bonus.service.ts`（新增）、`backend/src/routes/commission-bonus.routes.ts`（新增）、`frontend/src/pages/CommissionBonus.tsx`（新增）、`frontend/src/components/layout/SidebarNav.tsx`、`frontend/src/App.tsx`（路由注册）、`frontend/src/lib/api-services.ts`（`commissionBonusApi`）
 ---
 ## 优先级汇总
 | 优先级 | 问题 | 说明 | 状态 |
 |--------|------|------|------|
 | **P0 紧急** | 10A | 风险提醒反向引导（三期/医疗期/工伤提醒跳转到解聘页面） | ✅ 已完成 |
 | **P1 高** | 4 | 合同状态增加待签署判定 | ✅ 已完成 |
 | **P1 高** | 5 | 社保状态派生字段（待办/正常/停缴） | ✅ 已完成 |
 | **P1 高** | 6 | 证件号码有效性校验（校验位+出生日期） | ✅ 已完成 |
 | **P1 高** | 7 | 超龄人员合同类型限制（禁止选劳动合同） | ✅ 已完成 |
 | **P1 高** | 8 | 劳务协议社保联动（选 LABOR 社保基数置 0 禁用） | ✅ 已完成 |
 | **P1 高** | 9 | 待办跳转 actionUrl 修正 + 空值降级 | ✅ 已完成 |
 | **P1 高** | 11 | 试用期工资判定修正（抽取 isInProbation 工具函数） | ✅ 已完成 |
 | **P2 中** | 10B | 风险提醒规则优化（到期 30→60 天分级 + 去重排序） | ✅ 已完成 |
 | **P2 中** | 13 | 薪资批次获取提成奖金（依赖 12） | ✅ 已完成 |
 | **P3 规划** | 12 | 提成奖金新模块（DB migration + 全栈实现） | ✅ 已完成 |
 ---
 ## 建议执行顺序
 > ✅ 全部 10 项已于 20260816 完成实现，前后端 tsc 均通过。
 1. **第一批（P0 + P1，立即）** ✅：
   - 问题 10A（风险提醒反向引导，改 actionUrl）← 最先，改动小风险高
   - 问题 11（试用期工资判定修正）← 纯后端逻辑修正，抽取 `isInProbation` 工具函数
   - 问题 6（证件号码有效性校验）→ 问题 7（超龄人员合同类型限制）→ 问题 8（劳务协议社保联动）→ 问题 4（合同状态待签署）→ 问题 5（社保状态待办）→ 问题 9（待办跳转）
   - 问题 6/7/8 均在 `roster/modals.tsx` 添加雇员表单，可一并修改；问题 4/5 在后端 `contract.service.ts`/`employee.service.ts` 派生字段，前后端协同。
 2. **第二批（P2，本迭代）** ✅：
   - 问题 10B（风险提醒规则梳理）→ 问题 13（获取提成奖金，依赖问题 12）
 3. **第三批（P3，规划）** ✅：
   - 问题 12（提成奖金新模块，含 DB migration）→ 问题 13（获取提成奖金，依赖 12 完成）
 ---
 ## 备注
 - 本清单基于当期代码静态分析，部分"根因"为推断，实际修复前需运行复现确认。
 - 问题 12 涉及数据库 schema 变更（新增 `CommissionBonus` 表），需走 migration + 回滚方案。
 - 问题 4/5 的"待签署""待办"状态为派生字段，不新增存储字段，避免数据冗余；如需记录"办理完成"操作时间，可新增 `socialInsConfirmedAt` 等时间戳字段。
 - 问题 7 的超龄判定需引用 `femaleWorkerType`（干部 55/工人 50），需确认该字段在添加雇员表单已正确填写。
 - 问题 13 依赖问题 12 的提成奖金数据表，不可先行实现。
 ---
 ## 五、已完成优化（20260816 补充）
 > 以下为本次会话中已完成并部署的优化项。
 ### ✅ 已完成 1：员工端密码登录完整支持
 - **默认密码**：创建员工时自动设置，密码 = 手机号后6位（无手机号则 `123456`）
 - **管理员重置密码**：花名册详情 → "重置密码"按钮，重置为手机号后6位
 - **员工修改密码**：员工端导航栏 → "修改密码"，需验证旧密码，新密码至少6位
 - **Excel 批量导入**：导入时自动设置默认密码（手机号后6位），与新增员工一致
 - **现有员工补初始化**：已通过脚本批量补设 512 名无密码员工（478 人手机号后6位，34 人无手机号用 123456）
 - **涉及文件**：
  - `backend/src/services/contract.service.ts`（createEmployee 添加 passwordHash）
  - `backend/src/routes/import.routes.ts`（Excel 导入添加 passwordHash）
  - `backend/src/routes/employee.routes.ts`（新增 `POST /employees/:id/reset-password`）
  - `backend/src/routes/portal.routes.ts`（新增 `POST /portal/change-password`）
  - `frontend/src/pages/roster/BasicInfo.tsx`（重置密码按钮 + 默认密码提示）
  - `frontend/src/pages/portal/PortalNav.tsx`（修改密码弹窗）
  - `frontend/src/lib/api-services.ts`（resetPassword / changePassword 接口）
 ### ✅ 已完成 2：员工端 portalAxios response interceptor 修复
 - **问题**：`portalAxios` 缺少 response interceptor，导致 `unwrap` 取到的是 `{ success, data: {...} }` 而非 `{ token, employee }`，密码登录/验证码登录/扫码自动登录全部失败
 - **修复**：给 `portalAxios` 添加与管理端 `api` 实例一致的 response interceptor `(response) => response.data`
 - **涉及文件**：`frontend/src/lib/api-services.ts`
 ### ✅ 已完成 3：同企业内员工身份证和手机号唯一性完整校验
 - **createEmployee**：新增手机号查重硬校验（原有身份证查重）
 - **updateEmployee**：新增手机号 + 身份证查重（排除自身）
 - **Excel 批量导入**：新增身份证 + 手机号查重（重复则跳过并记录错误日志）
 - **portal 登录安全**：密码登录改为 `findMany` 遍历校验，避免跨组织手机号重复时登录到错误员工
 - **涉及文件**：
  - `backend/src/services/contract.service.ts`（createEmployee / updateEmployee 查重）
  - `backend/src/routes/import.routes.ts`（导入查重）
  - `backend/src/routes/portal.routes.ts`（login / send-code / verify-code 跨组织安全）
 ### ✅ 已完成 4：电子签署改为「待签合同」，按员工聚合 + 催办功能
 - **菜单改名**：「电子签署」→「待签合同」
 - **页面重构为两个 Tab**：
  - **待签合同**：按员工聚合，每行一个员工，显示待签数，点击展开查看该员工名下所有待签文件（EsignRecord PENDING/SIGNING + LaborContract signDate 为空）
  - **签署记录**：原有全部签署记录列表（保留状态/场景筛选）
 - **催办功能**：点击催办 → 生成 24 小时有效的一次性自动登录链接（指向员工端签署页）→ 弹窗展示二维码 + 可复制链接 → HR 发给员工扫码直接进入签署
 - **后端新增接口**：
  - `GET /esign/pending` — 待签合同按员工聚合列表
  - `POST /esign/remind` — 催办生成自动登录链接
 - **涉及文件**：
  - `backend/src/routes/esign.routes.ts`（pending + remind 接口）
  - `frontend/src/components/layout/SidebarNav.tsx`（菜单改名）
  - `frontend/src/pages/ESign.tsx`（Tab 切换 + PendingTab 组件 + 催办弹窗）
  - `frontend/src/lib/api-services.ts`（pending / remind 接口调用）
 ### ✅ 已完成 5：风险提醒反向引导修正（问题 10A）
 - **问题**：三期/医疗期/工伤员工的风险提醒文案是"解聘受限"，但 `actionUrl` 却指向 `/termination`（解聘向导），等于提示"不能解聘，点这里去解聘她"——反向引导，可能诱导违法解除。
 - **修复**：3 处 `actionUrl` 从 `/termination?employee=xxx` 改为 `/special-status?employee=xxx&type=PREGNANCY|MEDICAL_PERIOD|WORK_INJURY`，让 HR 确认员工状态而非跳去解聘。文案补充"此为合规提示，请勿发起解聘"。
 - **涉及文件**：`backend/src/services/risk.service.ts`（`detectTerminationRisks` 309-342 行）
 ### ✅ 已完成 6：试用期工资判定修正（问题 11）
 - **问题**：3 处获取工资逻辑用错误的试用期判定 `startDate > now - 365d`（入职不到1年），转正后仍用 `probationSalary`。正确逻辑应是 `startDate + probationMonths > now`（试用期未结束）。
 - **修复**：
  1. 抽取统一工具函数 `isInProbation(contract, referenceDate?)` 到 `contract.service.ts`。
  2. 修正 3 处错误逻辑，统一调用 `isInProbation`，按批次月份月末判定。
  3. `probationSalary` 为 0 时回退用 `monthlySalary`（兼容旧数据）。
 - **涉及文件**：
  - `backend/src/services/contract.service.ts`（新增 `isInProbation`）
  - `backend/src/routes/payroll2.routes.ts`（copy_last 模式 355 行、添加人员 614 行）
  - `backend/src/routes/payroll.routes.ts`（旧版批量生成 380 行）
 ### ✅ 已完成 7：证件号码有效性校验（问题 6）
 - **问题**：添加雇员仅校验证件号码长度 ≥18，未做校验位、出生日期合法性验证。
 - **修复**：
  1. 前端 `handleIdCardChange` 增加校验位算法（GB 11643-1999）、出生日期合法性（月份/日期范围、是否存在如2月30日、是否晚于今天），校验失败阻断保存。
  2. 后端新增 `validateIdCard`/`getAgeFromIdCard`/`isOverageEmployee` 工具函数，`createEmployee` 增加双保险校验。
 - **涉及文件**：
  - `frontend/src/pages/roster/modals.tsx`（`handleIdCardChange`、`canSubmit`）
  - `backend/src/services/contract.service.ts`（新增 3 个工具函数 + `createEmployee` 校验）
 ### ✅ 已完成 8：超龄人员合同类型限制（问题 7）
 - **问题**：超龄人员仅 WARN 提示，仍可选劳动合同（FIXED/UNFIXED），违反合规要求。
 - **修复**：
  1. 前端派生 `isOverage`（男≥60、女干部≥55、女工人≥50），合同类型下拉过滤掉 FIXED/UNFIXED，仅保留 LABOR/INTERNSHIP/UNSIGNED。
  2. 草稿恢复时若当前合同类型非法，useEffect 自动切到 UNSIGNED。
  3. 后端 `createEmployee` 增加校验：超龄 + FIXED/UNFIXED 拒绝并返回 400。
 - **涉及文件**：
  - `frontend/src/pages/roster/modals.tsx`（`isOverage` 派生、合同类型下拉过滤、useEffect 自动修正）
  - `backend/src/services/contract.service.ts`（`createEmployee` 超龄校验）
 ### ✅ 已完成 9：劳务协议社保联动（问题 8）
 - **问题**：选劳务协议（LABOR）时社保基数未置 0 且仍可缴纳，违反合规要求。
 - **修复**：
  1. 前端选 LABOR/INTERNSHIP 时，社保/公积金基数自动置 0、起始月清空、字段禁用，提示"劳务协议/实习协议人员不缴纳社保公积金"。
  2. 后端 `createEmployee` 强制：LABOR/INTERNSHIP 时 `socialInsBase`/`housingFundBase` = 0，起始月清空。
 - **涉及文件**：
  - `frontend/src/pages/roster/modals.tsx`（合同类型 onChange 联动、社保区 disabled）
  - `backend/src/services/contract.service.ts`（`createEmployee` 社保强制 0）
 ### ✅ 已完成 10：合同状态增加待签署判定（问题 4）
 - **问题**：有合同记录但 `signDate` 为空时仍显示"正常"，应显示"待签署"。
 - **修复**：`getContractStatus` 增加判定：有合同记录但 `signDate` 为空 → `status: 'pending_sign'`，`statusText: '待签署'`，`riskLevel: 'medium'`。电子签署完成后会回写 `signDate`，故 `signDate` 为空即未签署。前端花名册列表 `statusTextMap` 增加 `pending_sign: '待签署'`。
 - **涉及文件**：
  - `backend/src/services/contract.service.ts`（`getContractStatus` 74-91 行重写）
  - `frontend/src/pages/Roster.tsx`（`tagStyles`/`statusTextMap` 增加 `pending_sign`）
 ### ✅ 已完成 11：社保状态派生字段（问题 5）
 - **问题**：社保状态无"待办"判定，未办理社保的在职员工显示"—"而非"待办理"。
 - **修复**：后端 `socialInsuranceStatus` 派生逻辑：
  - 劳务协议/实习协议 → null（不缴社保，显示"—"）
  - 在职 + 应缴社保 + 无社保记录 → `PENDING`（待办理）
  - 有社保记录 + endMonth 为 null → `ACTIVE`（在保）
  - 有社保记录 + endMonth 不为 null → `SUSPENDED`（停保）
  - 前端已有 PENDING/UNINSURED 的标签映射，无需改前端。
 - **涉及文件**：`backend/src/routes/roster.routes.ts`（`socialInsuranceStatus` 派生 243-249 行）
 ### ✅ 已完成 12：待办跳转 actionUrl 空值降级（问题 9）
 - **问题**：待办事项的"立刻办理"链接在 `actionUrl` 为空或 '/' 时仍渲染为 Link，点击跳首页无意义。
 - **修复**：Dashboard 待办列表渲染时，`actionUrl` 为空或 '/' 时不渲染 Link 和"立刻办理"按钮，改为纯展示 div；有有效 URL 时才渲染可跳转链接。问题 10A 已修正三期/医疗期/工伤的反向引导 URL，其余 actionUrl（`/roster?employee=xxx`、`/special-status`、`/money`）均指向有效路由，Roster 已处理 `?employee` 参数自动定位。
 - **涉及文件**：`frontend/src/pages/Dashboard.tsx`（待办列表渲染 1136-1233 行）
 ### ✅ 已完成 13：风险提醒规则优化（问题 10B）
 - **问题**：合同到期提醒仅 30 天预警，HR 反应时间不足；去重后的待办列表未按优先级排序。
 - **修复**：
  1. 合同到期预警从 30 天提前到 60 天，分级：≤30 天 HIGH（需立即处理），31-60 天 MEDIUM（提前预警）。
  2. `dedupedTodos` 按优先级排序（URGENT > HIGH > MEDIUM > LOW），确保最紧急的待办排在最前。
 - **涉及文件**：`backend/src/services/risk.service.ts`（`detectContractRisks` 216-248 行、`getDashboardData` dedupedTodos 排序 941-952 行）
 ### ✅ 已完成 14：提成奖金新模块（问题 12）
 - **问题**：无独立提成奖金管理模块，`BONUS` 批次是年终奖发放，非按月提成奖金管理。
 - **实现**：
  1. **数据模型**：新增 `CommissionBonus` 表（`orgId`、`employeeId`、`month` YYYY-MM、`amount` 支持正负值、`remark`、`createdBy`），唯一索引 `(orgId, employeeId, month)`。
  2. **后端**：新增 `commission-bonus.service.ts` + `commission-bonus.routes.ts`：
     - `GET /commission-bonus?month=YYYY-MM` 按月列表 + 汇总（总奖金/总扣款/净额）
     - `POST /commission-bonus` 新增单条（upsert，同员工同月自动覆盖）
     - `PUT /commission-bonus/:id` 编辑单条
     - `DELETE /commission-bonus/:id` 删除单条
     - `POST /commission-bonus/import` 批量导入 Excel（字段：员工姓名/证件号码/金额/备注）
     - `GET /commission-bonus/template` 下载导入模板
  3. **前端**：新增 `CommissionBonus.tsx` 页面：
     - 月份选择器（默认当月）
     - 汇总卡片（记录数/总奖金/总扣款/净额）
     - 列表展示（员工/部门/金额/备注），支持搜索、分页
     - 单条新增/编辑/删除
     - 批量导入 Excel + 模板下载
     - 金额支持正负值（正=奖金，负=扣款）
  4. **菜单**：`SidebarNav.tsx` "团队"分组新增"提成奖金"入口，路由 `/commission-bonus`。
  5. **DB 同步**：`prisma db push` 已执行，Prisma Client 已重新生成。
 - **涉及文件**：
  - `backend/prisma/schema.prisma`（新增 `CommissionBonus` 模型 + Employee/Organization 反向关联）
  - `backend/src/services/commission-bonus.service.ts`（新增）
  - `backend/src/routes/commission-bonus.routes.ts`（新增）
  - `backend/src/app.ts`（路由注册）
  - `frontend/src/pages/CommissionBonus.tsx`（新增）
  - `frontend/src/components/layout/SidebarNav.tsx`（菜单项）
  - `frontend/src/App.tsx`（路由注册）
  - `frontend/src/lib/api-services.ts`（`commissionBonusApi`）
 ### ✅ 已完成 15：获取提成奖金（问题 13）
 - **问题**：薪资批次编辑薪资时无"获取提成奖金"按钮，无法从提成奖金模块按月拉取填充 `bonus` 字段。
 - **实现**：
  1. 后端新增 `POST /payroll2/batches/:batchId/fetch-bonus`：按批次月份从 `CommissionBonus` 表拉取，填充到对应 `entries.bonus`，重算批次汇总。
  2. 前端 `BatchTab.tsx` 编辑薪资步骤新增"获取提成奖金"按钮（在"导入加班费"旁），调用后展示结果摘要（X 人提成奖金已填充，合计 ¥Y）。
  3. 已归档批次禁用按钮。
 - **涉及文件**：
  - `backend/src/routes/payroll2.routes.ts`（`fetch-bonus` 接口 552-628 行）
  - `frontend/src/lib/api-services.ts`（`fetchBonusToBatch`）
  - `frontend/src/pages/money/BatchTab.tsx`（`fetchBonusMutation` + 按钮 784-798 行）
@@ -0,0 +1,259 @@
 # 20260816 用户测试说明
 > 本次更新共完成 **15 项优化**，覆盖花名册合规校验、工作台待办跳转、薪税管理、提成奖金新模块等。
 > 测试地址：https://on.hr8ai.top/
 > 测试前请先**强制刷新浏览器**（Mac: Cmd+Shift+R / Windows: Ctrl+Shift+R）清除缓存。
 ---
 ## 一、花名册 · 添加雇员（问题 4-8）
 ### 测试 1：证件号码有效性校验（问题 6）
 **操作步骤**：
 1. 花名册 → 添加雇员
 2. 证件类型选"身份证"，输入以下测试用例：
   - `11010119900101123X`（校验位错误）→ 应提示"身份证校验位错误"，阻断保存
   - `110101199013011234`（月份 13 非法）→ 应提示"出生日期不合法"
   - `110101199002301234`（2 月 30 日不存在）→ 应提示"出生日期不合法"
   - `110101209901011234`（出生日期在未来）→ 应提示"出生日期不合法"
   - `110101199003075476`（正确身份证）→ 应通过校验
 **预期**：非法身份证无法保存，页面显示具体错误原因。
 ---
 ### 测试 2：超龄人员合同类型限制（问题 7）
 **操作步骤**：
 1. 花名册 → 添加雇员
 2. 输入一位超龄人员信息：
   - 男，出生日期选 1960-01-01（≥60 岁）
   - 查看合同类型下拉
 3. 再输入一位非超龄人员：
   - 男，出生日期选 1990-01-01
   - 查看合同类型下拉
 **预期**：
 - 超龄人员：合同类型下拉**无**"固定期限劳动合同""无固定期限劳动合同"，仅有"劳务协议""实习协议""未签合同"
 - 非超龄人员：所有合同类型可选
 ---
 ### 测试 3：劳务协议社保联动（问题 8）
 **操作步骤**：
 1. 花名册 → 添加雇员
 2. 合同类型选"劳务协议"
 3. 查看社保公积金区域
 **预期**：
 - 社保缴费基数、公积金缴费基数自动置 0 且**不可编辑**（灰色禁用）
 - 社保开始年月清空且禁用
 - 显示提示"劳务协议/实习协议人员不缴纳社保公积金"
 4. 切回"固定期限劳动合同"
 **预期**：社保公积金区域恢复可编辑。
 ---
 ### 测试 4：合同状态"待签署"（问题 4）
 **操作步骤**：
 1. 花名册 → 添加雇员，填写合同信息但**不登记签署日期**，保存
 2. 查看花名册列表中该员工的合同状态列
 **预期**：
 - 合同状态显示"待签署"标签（黄色/橙色样式）
 - 登记签署日期后，状态变为"正常"（绿色）
 ---
 ### 测试 5：社保状态"待办理"（问题 5）
 **操作步骤**：
 1. 花名册 → 添加一位劳动合同类型员工，不填写社保基数
 2. 查看花名册列表中该员工的社保状态列
 **预期**：
 - 社保状态显示"待办理"标签
 - 劳务协议员工社保状态显示"—"（不缴社保）
 ---
 ## 二、工作台 · 待办与风险提醒（问题 9-10）
 ### 测试 6：待办跳转精准化（问题 9 + 月度待办优化）
 **操作步骤**：
 1. 工作台 → 待办事项 Tab
 2. 查看月度待办（缴纳社保、缴纳公积金、发放工资、申报个税）
 3. 点击各待办的"立刻办理 →"
 **预期**：
 - 缴纳社保 → 跳转到**社保公积金**页面，自动定位到"月度办理"Tab
 - 缴纳公积金 → 跳转到**社保公积金**页面，自动定位到"月度办理"Tab
 - 发放工资 → 跳转到**薪税管理**页面，自动定位到"发薪批次"Tab
 - 申报个税 → 跳转到**薪税管理**页面，自动定位到"发薪批次"Tab
 - 无 actionUrl 的待办 → 不显示"立刻办理"链接，仅展示文字
 ---
 ### 测试 7：风险提醒反向引导修正（问题 10A）
 **操作步骤**：
 1. 找一位标记为"孕期/哺乳期"或"医疗期"或"工伤"的员工
 2. 工作台 → 风险提醒 Tab，查看对应提醒
 3. 点击"立刻办理 →"
 **预期**：
 - 跳转到**特殊员工**页面（`/special-status`），而非解聘页面
 - 文案包含"此为合规提示，请勿发起解聘"
 ---
 ### 测试 8：合同到期分级预警（问题 10B）
 **操作步骤**：
 1. 找一位合同 45 天后到期的员工
 2. 工作台 → 风险提醒 Tab
 **预期**：
 - 31-60 天到期：显示"中"优先级预警（MEDIUM，黄色）
 - ≤30 天到期：显示"高"优先级预警（HIGH，红色）
 - 待办列表按优先级排序：高优先级置顶
 ---
 ## 三、薪税管理（问题 11、13）
 ### 测试 9：试用期工资自动判定（问题 11）
 **操作步骤**：
 1. 确保有一位试用期员工（合同 startDate + probationMonths > 当前日期）和一位已转正员工
 2. 薪税管理 → 发薪批次 → 创建当月批次（或复制上月）
 3. 查看两位员工的"基本工资"
 **预期**：
 - 试用期员工：基本工资 = 合同的 `probationSalary`
 - 已转正员工：基本工资 = 员工的 `monthlySalary`
 - `probationSalary` 为 0 的试用期员工：回退用 `monthlySalary`
 ---
 ### 测试 10：获取提成奖金（问题 13）
 **前提**：先在"提成奖金"模块录入当月数据（见测试 11）。
 **操作步骤**：
 1. 薪税管理 → 发薪批次 → 进入某未归档批次详情
 2. 编辑薪资步骤，找到"获取提成奖金"按钮（在"导入加班费"旁）
 3. 点击该按钮
 **预期**：
 - 提示"已填充 X 人提成奖金，合计 ¥Y"
 - 对应员工的"奖金"字段自动填充
 - 已归档批次该按钮禁用
 ---
 ## 四、提成奖金新模块（问题 12）
 ### 测试 11：提成奖金完整功能
 **操作步骤**：
 1. 左侧菜单 → 团队 → **提成奖金**（DollarSign 图标）
 2. **月份切换**：选择 2026-08，查看列表和汇总卡片
 3. **新增单条**：点击"新增" → 选员工 → 输入金额（如 5000）→ 保存
 4. **新增扣款**：再新增一条，金额输入负数（如 -200）→ 保存
 5. **编辑**：点击列表行的编辑图标 → 修改金额 → 保存
 6. **删除**：点击列表行的删除图标 → 确认删除
 7. **搜索**：在搜索框输入员工姓名 → 验证过滤
 8. **下载模板**：点击"模板"按钮 → 下载 Excel 模板
 9. **批量导入**：在模板中填入数据 → 点击"批量导入"上传 → 验证导入结果
 10. **汇总验证**：检查汇总卡片（记录数/总奖金/总扣款/净额）是否正确
 **预期**：
 - 菜单显示"提成奖金"入口
 - 列表显示员工/部门/金额/备注
 - 金额正数显示绿色（奖金），负数显示红色（扣款）
 - 汇总卡片：总奖金 = 所有正数之和，总扣款 = 所有负数绝对值之和，净额 = 总奖金 - 总扣款
 - 导入成功后提示"新增 X，更新 Y，跳过 Z"
 - 同员工同月重复新增自动覆盖（upsert）
 ---
 ## 五、员工端密码登录（已完成 1-3）
 ### 测试 12：员工端登录
 **操作步骤**：
 1. 员工端登录页 → 密码登录
 2. 输入手机号 + 密码（默认密码 = 手机号后 6 位）
 3. 登录成功后 → 导航栏 → 修改密码
 4. 输入旧密码 + 新密码（≥6 位）→ 确认
 **预期**：
 - 默认密码可登录
 - 修改密码后用新密码可登录，旧密码不可用
 - 无手机号员工默认密码为 `123456`
 ---
 ### 测试 13：管理员重置密码
 **操作步骤**：
 1. 花名册 → 某员工详情 → "重置密码"按钮
 2. 确认重置
 **预期**：密码重置为手机号后 6 位，员工可用新密码登录。
 ---
 ## 六、待签合同 + 催办（已完成 4）
 ### 测试 14：待签合同按员工聚合 + 催办
 **操作步骤**：
 1. 左侧菜单 → **待签合同**
 2. 查看"待签合同"Tab：按员工聚合，每行一个员工，显示待签数
 3. 点击某员工行展开 → 查看该员工名下待签文件列表
 4. 点击"催办" → 弹窗显示二维码 + 可复制链接
 5. 切换到"签署记录"Tab → 查看全部签署记录
 **预期**：
 - 待签合同按员工聚合展示
 - 催办弹窗显示二维码和链接（24 小时有效）
 - 签署记录 Tab 显示历史记录，支持状态/场景筛选
 ---
 ## 测试结果记录
 | 编号 | 测试项 | 通过 | 备注 |
 |------|--------|------|------|
 | 1 | 证件号码校验 | ☐ | |
 | 2 | 超龄合同限制 | ☐ | |
 | 3 | 劳务协议社保联动 | ☐ | |
 | 4 | 合同待签署状态 | ☐ | |
 | 5 | 社保待办理状态 | ☐ | |
 | 6 | 待办跳转精准化 | ☐ | |
 | 7 | 风险提醒反向引导修正 | ☐ | |
 | 8 | 合同到期分级预警 | ☐ | |
 | 9 | 试用期工资判定 | ☐ | |
 | 10 | 获取提成奖金 | ☐ | |
 | 11 | 提成奖金模块 | ☐ | |
 | 12 | 员工端登录 | ☐ | |
 | 13 | 管理员重置密码 | ☐ | |
 | 14 | 待签合同+催办 | ☐ | |
 ---
 ## 注意事项
 1. 测试前务必**强制刷新浏览器**清除缓存（Cmd+Shift+R）
 2. 测试 9-11 需要有测试员工数据，建议先用花名册添加 2-3 名测试员工
 3. 测试 10 依赖测试 11 先录入提成奖金数据
 4. 如发现菜单未显示"提成奖金"，请清除浏览器缓存后重试
 5. 测试完成后请在测试结果记录表勾选通过项，未通过项请描述具体问题
@@ -0,0 +1,422 @@
 # 20260816 社保公积金账户化重构
 > 目标：将社保公积金从"按城市直接关联版本"改为"账户 + 年度标准"两层实体。
 > 账户代表用户开设的社保/公积金账户（对应不同子公司/分公司/地区），年度标准是账户下每个年度的缴费比例和基数标准。
 > **状态：已完成实施**（2026-08-16）
 > 账户+年度标准模型已上线，前端已重构为账户卡片列表+展开年度标准管理。
 ---
 ## 一、现状分析
 ### 当前数据模型（已重构）
 | 表 | 说明 | 唯一约束 |
 |----|------|---------|
 | `SocialAccount` | 社保/公积金账户实体（type=SOCIAL/HOUSING） | `@@unique([orgId, type, name])` |
 | `SocialYearStandard` | 年度标准（比例+基数+最低工资+生效月份），关联到账户 | `@@unique([accountId, effectiveFrom])` |
 | `SocialInsuranceConfig` | 旧社保版本表（保留兼容，回退用） | `@@unique([orgId, city, effectiveFrom])` |
 | `HousingFundConfig` | 旧公积金版本表（保留兼容） | — |
 | `EmployeeSocialInsRecord` | 员工社保参保记录，已加 accountId | — |
 | `EmployeeHousingFundRecord` | 员工公积金参保记录，已加 accountId | — |
 | `SocialMonthlyProcess` | 月度办理记录 | `@@unique([orgId, month, type])` |
 ### 已解决的问题
 1. ✅ **"城市"只是字符串** → 已改为 SocialAccount 实体化管理
 2. ✅ **多子公司/分公司场景缺失** → 同一城市可有多个账户，按根部门关联
 3. ✅ **版本直接挂在 orgId+city 上** → 改为 SocialYearStandard 关联到 accountId
 4. ✅ **员工参保记录只有 city** → 已加 accountId 字段
 5. ✅ **薪资计算中社保配置查询** → 改为按 accountId 查 SocialYearStandard，旧表回退
 6. ✅ **最低工资标准** → SocialYearStandard 新增 minWage 字段，支持最低工资保护和递延扣款
 ---
 ## 二、目标数据模型
 ### 新增：SocialAccount（社保/公积金账户）
 ```
 model SocialAccount {
  id            String   @id @default(cuid())
  orgId         String
  org           Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  type          String   // SOCIAL=社保账户, HOUSING=公积金账户
  name          String   // 账户名称，如"北京总公司社保账户"、"上海分公司社保账户"
  city          String   // 参保城市
  accountNo     String?  // 社保登记号 / 公积金单位账号
  bankName      String?  // 公积金开户行（公积金专用）
  bankAccount   String?  // 公积金银行账号（公积金专用）
  orgName       String?  // 缴费主体名称（子公司/分公司名称）
  orgCode       String?  // 缴费主体统一社会信用代码
  accountType   String?  // 公积金账户类型 BASIC=基本, SUPPLEMENTARY=补充（公积金专用）
  isDefault     Boolean  @default(false) // 是否默认账户（同 type 下仅一个默认）
  status        String   @default("ACTIVE") // ACTIVE=正常, SUSPENDED=停用
  remark        String?
  createdBy     String
  createdAt     DateTime @default(now())
  updatedAt     DateTime @updatedAt
  yearStandards     SocialYearStandard[]
  socialRecords     EmployeeSocialInsRecord[]
  housingRecords    EmployeeHousingFundRecord[]
  // 部门关联（根部门 level=0 代表分公司/子公司）
  deptSocialAccounts   Department[] @relation("SocialAccountDepartments")
  deptHousingAccounts  Department[] @relation("HousingAccountDepartments")
  @@unique([orgId, type, name])
  @@index([orgId, type, city])
  @@index([orgId, type, isDefault])
 }
 ```
 ### 新增：SocialYearStandard（年度标准，替代原 Config 表）
 ```
 model SocialYearStandard {
  id              String   @id @default(cuid())
  orgId           String
  org             Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  accountId       String   // 关联到账户
  account         SocialAccount @relation(fields: [accountId], references: [id], onDelete: Cascade)
  // 社保比例（type=SOCIAL 时使用）
  pensionOrg      Float    @default(16)
  pensionEmp      Float    @default(8)
  medicalOrg      Float    @default(9.8)
  medicalEmp      Float    @default(2)
  unemploymentOrg Float    @default(0.5)
  unemploymentEmp Float    @default(0.5)
  injuryOrg       Float    @default(0.2)
  maternityOrg    Float    @default(0.8)
  baseMin         Float    @default(6326)
  baseMax         Float    @default(33891)
  medicalBaseMin  Float    @default(0)
  medicalBaseMax  Float    @default(0)
  extraInsurances Json?
  // 最低工资标准（仅社保，20260816新增）
  minWage         Float    @default(0) // 当地月最低工资标准，0=不检查
  // 公积金比例（type=HOUSING 时使用）
  housingOrg      Float    @default(12)
  housingEmp      Float    @default(12)
  effectiveFrom   String   // 生效月份 YYYY-MM
  effectiveTo     String?  // 失效月份 YYYY-MM（null=当前有效）
  isCurrent       Boolean  @default(true)
  adjustmentDone  Boolean  @default(false)
  createdBy       String
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt
  @@unique([accountId, effectiveFrom])
  @@index([accountId, isCurrent])
 }
 ```
 ### 修改：EmployeeSocialInsRecord
 ```
 model EmployeeSocialInsRecord {
  // 新增字段
  accountId   String?  // 关联到 SocialAccount（迁移后非空）
  account     SocialAccount? @relation(fields: [accountId], references: [id])
  // 保留 city 字段用于兼容（迁移后从 account.city 派生，后续可废弃）
  city        String   @default("北京")
  // 其余字段不变
 }
 ```
 ### 修改：EmployeeHousingFundRecord
 ```
 model EmployeeHousingFundRecord {
  // 新增字段
  accountId   String?
  account     SocialAccount? @relation(fields: [accountId], references: [id])
  // 保留 city 字段用于兼容
  city        String   @default("北京")
  // 其余字段不变
 }
 ```
 ### 修改：SocialMonthlyProcess
 ```
 model SocialMonthlyProcess {
  // 新增字段
  accountId   String?  // 关联到账户（迁移后非空）
  // 保留原字段
  month        String
  type         String
  // ...
 }
 ```
 ### 修改：Organization
 ```
 model Organization {
  // 新增关联
  socialAccounts   SocialAccount[]
 }
 ```
 ---
 ## 三、数据迁移方案
 ### 迁移步骤
 1. **创建新表**：`SocialAccount` + `SocialYearStandard`
 2. **给员工记录表加 accountId 字段**（可空，迁移期间兼容）
 3. **迁移 SocialInsuranceConfig → SocialAccount + SocialYearStandard**：
   - 按 `(orgId, city)` 分组，每组创建一个 `SocialAccount`（type=SOCIAL）
   - 每条 Config 创建一条 `SocialYearStandard`（accountId 关联到对应账户）
 4. **迁移 HousingFundConfig → SocialAccount + SocialYearStandard**：
   - 按 `(orgId, city, accountType)` 分组，每组创建一个 `SocialAccount`（type=HOUSING）
   - 每条 Config 创建一条 `SocialYearStandard`
 5. **迁移 EmployeeSocialInsRecord.accountId**：按 `(orgId, city)` 匹配到 SocialAccount
 6. **迁移 EmployeeHousingFundRecord.accountId**：按 `(orgId, city)` 匹配到 SocialAccount
 7. **迁移 SocialMonthlyProcess.accountId**：按 `(orgId, type, snapshot.city)` 匹配
 8. **验证数据完整性**：确认所有记录都有 accountId
 9. **将 accountId 设为非空**（可选，或保持可空兼容）
 10. **保留旧表**（SocialInsuranceConfig / HousingFundConfig）作为备份，代码切换后再删除
 ### 迁移脚本
 ```sql
 -- 1. 创建社保账户（从 SocialInsuranceConfig 提取唯一 orgId+city）
 INSERT INTO "SocialAccount" (id, orgId, type, name, city, "isDefault", status, "createdBy", "createdAt", "updatedAt")
 SELECT
  gen_random_uuid(),
  "orgId",
  'SOCIAL',
  city || '社保账户',
  city,
  true,
  'ACTIVE',
  'migration',
  NOW(),
  NOW()
 FROM (SELECT DISTINCT "orgId", city FROM "SocialInsuranceConfig") t;
 -- 2. 创建公积金账户（从 HousingFundConfig 提取唯一 orgId+city+accountType）
 INSERT INTO "SocialAccount" (id, orgId, type, name, city, "accountType", "isDefault", status, "createdBy", "createdAt", "updatedAt")
 SELECT
  gen_random_uuid(),
  "orgId",
  'HOUSING',
  city || COALESCE("accountType", 'BASIC') || '公积金账户',
  city,
  COALESCE("accountType", 'BASIC'),
  true,
  'ACTIVE',
  'migration',
  NOW(),
  NOW()
 FROM (SELECT DISTINCT "orgId", city, "accountType" FROM "HousingFundConfig") t;
 -- 3. 迁移社保年度标准
 INSERT INTO "SocialYearStandard" (id, orgId, "accountId", "pensionOrg", "pensionEmp", ...)
 SELECT
  gen_random_uuid(),
  c."orgId",
  a.id,
  c."pensionOrg", c."pensionEmp", ...
 FROM "SocialInsuranceConfig" c
 JOIN "SocialAccount" a ON a."orgId" = c."orgId" AND a.city = c.city AND a.type = 'SOCIAL';
 -- 4. 迁移公积金年度标准
 -- 5. 迁移员工参保记录 accountId
 -- 6. 迁移月度办理记录 accountId
 ```
 ---
 ## 四、后端 API 变更
 ### 新增：账户管理 API（已实施）
 | 方法 | 路径 | 说明 |
 |------|------|------|
 | GET | `/social/accounts` | 账户列表（支持 type 筛选） |
 | POST | `/social/accounts` | 新建账户 |
 | PUT | `/social/accounts/:id` | 编辑账户 |
 | DELETE | `/social/accounts/:id` | 删除账户（无关联记录时可删） |
 | PUT | `/social/accounts/:id/default` | 设为默认账户 |
 | PUT | `/social/accounts/:id/departments` | 账户关联根部门（批量） |
 | GET | `/social/accounts/:id/departments` | 获取账户已关联的根部门 |
 ### 新增：年度标准 API（已实施）
 | 方法 | 路径 | 说明 |
 |------|------|------|
 | GET | `/social/accounts/:accountId/standards` | 账户的年度标准列表 |
 | GET | `/social/accounts/:accountId/current-standard` | 账户的当前生效标准 |
 | GET | `/social/accounts/:accountId/standard-by-month/:month` | 按账户+月份获取适用标准 |
 | POST | `/social/accounts/:accountId/standards` | 新建年度标准（旧版本自动归档） |
 | PUT | `/social/accounts/:accountId/min-wage` | 快速更新当前标准的最低工资 |
 ### 改造：薪资计算（已实施）
 - `payroll.service.ts` 中社保配置查询：从 `orgId + city` 改为通过员工→根部门→账户→年度标准
 - 员工参保记录查询：从 `employeeId + city` 改为 `employeeId + accountId`
 - 新增最低工资保护和递延扣款逻辑（详见 20260816-薪税管理逻辑.md 第十五章）
 ### 废弃：城市相关 API
 | 方法 | 路径 | 说明 | 处理 |
 |------|------|------|------|
 | GET | `/social/config/cities` | 城市列表 | 废弃，改为 `/social/accounts` 返回账户列表（含 city） |
 ### 改造：月度办理 API
 - 月度办理按账户分别办理，不同账户不同城市的增减员
 - `SocialMonthlyProcess` 新增 accountId
 ### 改造：薪资计算
 - `payroll.service.ts` 中社保配置查询：从 `orgId + city` 改为 `accountId`
 - 员工参保记录查询：从 `employeeId + city` 改为 `employeeId + accountId`
 ---
 ## 五、前端 UI 变更（已实施）
 ### 1. 社保公积金菜单（SocialInsurance.tsx）— 已重构
 **社保/公积金 Tab**（20260816 重构）：
 - ~~原城市选择器 → 改为账户选择器~~ → 已改为**账户卡片列表 + 展开年度标准管理**
 - 每个账户卡片：名称、城市、账号、关联部门数、参保记录数
 - 卡片可展开/折叠（ChevronDown/ChevronRight 图标）
 - 展开后显示：
  - 当前年度标准（比例/基数/最低工资）
  - 最低工资快速编辑（仅社保，Input + 保存按钮）
  - 操作按钮：新建年度标准 | 批量调基 | 查看历史
  - 新建年度标准弹窗（原"新建版本"改名，保留 AI 建议、附加险种配置）
  - 版本历史展示
  - 调基预览（保留原有展示和编辑逻辑）
  - 试算工具（使用该账户的城市配置）
 - 顶部"新建账户"按钮（账户新建/编辑/删除/设默认已从设置页面迁移到此）
 - 新增组件：`AccountCard.tsx`（账户卡片+展开内容）、`AccountFormModal.tsx`（账户新建/编辑弹窗）
 **月度办理 Tab**：保留不变
 **员工参保 Tab**：保留不变
 **专项附加扣除 Tab**：保留不变
 ### 2. 设置页面（Settings.tsx）— 已简化
 - ~~新增"社保公积金账户管理"Tab~~ → 已去掉该 Tab
 - 账户管理全部移到社保公积金菜单中完成
 - SocialAccountSettings 和 AccountFormModal 组件定义保留在文件中（不再显示）
 ### 3. 员工表单（roster/modals.tsx）
 - 社保公积金区：原城市选择 → 改为**账户选择**（下拉，按 type 筛选）
 - 选中账户后自动带出城市（只读展示）
 ---
 ## 六、影响范围清单
 ### 后端
 | 文件 | 改动范围 |
 |------|---------|
 | `prisma/schema.prisma` | 新增 SocialAccount、SocialYearStandard，修改员工记录表加 accountId |
 | `src/routes/social.routes.ts` | 全面重构：账户 CRUD + 年度标准改为按 accountId |
 | `src/services/payroll.service.ts` | 社保配置查询改为 account → yearStandard 两级 |
 | `src/routes/payroll2.routes.ts` | 批次计算中社保配置查询适配 |
 | `src/routes/payroll.routes.ts` | 旧版薪资计算适配 |
 | `src/routes/roster.routes.ts` | socialInsuranceStatus 派生逻辑适配 |
 | `src/services/contract.service.ts` | createEmployee 社保记录创建时关联 accountId |
 | `src/routes/import.routes.ts` | Excel 导入时社保账户关联 |
 ### 前端
 | 文件 | 改动范围 |
 |------|---------|
 | `src/pages/SocialInsurance.tsx` | 全面重构：账户选择器 + 年度标准 + 月度办理 |
 | `src/pages/Settings.tsx` | 新增账户管理入口 |
 | `src/pages/roster/modals.tsx` | 社保公积金区改为账户选择 |
 | `src/lib/api-services.ts` | 新增 socialAccountApi，改造 socialInsuranceApi |
 ### 数据库迁移
 | 操作 | 说明 |
 |------|------|
 | 新增表 | SocialAccount、SocialYearStandard |
 | 修改表 | EmployeeSocialInsRecord 加 accountId，EmployeeHousingFundRecord 加 accountId，SocialMonthlyProcess 加 accountId |
 | 数据迁移 | SocialInsuranceConfig → SocialAccount + SocialYearStandard |
 | 数据迁移 | HousingFundConfig → SocialAccount + SocialYearStandard |
 | 数据迁移 | 员工参保记录按 city 匹配 accountId |
 | 保留旧表 | SocialInsuranceConfig / HousingFundConfig 暂保留，代码切换后删除 |
 ---
 ## 七、实施计划与完成状态
 ### 第一步：DB schema + 迁移脚本 ✅ 已完成
 - ✅ 新增 SocialAccount、SocialYearStandard 表
 - ✅ 员工记录表加 accountId 字段（可空）
 - ✅ SocialYearStandard 新增 minWage 字段（最低工资标准）
 - ✅ Department 表新增 socialAccountId / housingAccountId（根部门关联账户）
 - ✅ 编写并执行迁移脚本
 - ✅ 验证数据完整性
 ### 第二步：后端 API 重构 ✅ 已完成
 - ✅ 新增账户 CRUD API（`/social/accounts`）
 - ✅ 年度标准 API 改为按 accountId（`/social/accounts/:accountId/standards`）
 - ✅ 新增按账户获取当前标准 API（`/social/accounts/:accountId/current-standard`）
 - ✅ 新增快速更新最低工资 API（`/social/accounts/:accountId/min-wage`）
 - ✅ 薪资计算适配（payroll.service.ts 按 accountId 查标准，旧表回退）
 - ✅ 员工参保记录适配
 - ✅ 保留旧 API 兼容（过渡期）
 ### 第三步：前端账户管理 ✅ 已完成
 - ✅ ~~设置页新增账户管理 UI~~ → 已移到社保公积金菜单
 - ✅ SocialInsurance.tsx 改为账户卡片列表 + 展开年度标准管理
 - ✅ 新建版本改名为"新建年度标准"
 - ✅ 最低工资快速编辑（当前配置区域可直接编辑）
 - ✅ 新增 AccountCard.tsx 组件（账户卡片+展开内容）
 - ✅ 新增 AccountFormModal.tsx 组件（账户新建/编辑弹窗）
 ### 第四步：前端参保流程适配 ✅ 已完成
 - ✅ 员工表单社保公积金区改为账户选择
 - ✅ 月度办理保留不变
 - ✅ 员工参保记录展示账户名称
 ### 第五步：清理 ⏳ 待执行
 - ⏳ 删除旧 SocialInsuranceConfig / HousingFundConfig 表
 - ⏳ 删除旧 API
 - ⏳ 删除前端城市选择器残留代码
 ### 额外完成的功能（20260816）
 - ✅ 最低工资保护与递延扣款机制（详见 20260816-薪税管理逻辑.md 第十五章）
 - ✅ 最低工资保护支持当月累计实发判断（多批次场景）
 - ✅ 预入职状态（PRE_ONBOARD），预入职员工不进入薪资批次
 - ✅ 薪资批次新增 payMonth（发薪年月）字段，支持提前发薪场景
 ---
 ## 八、风险与回滚
 | 风险 | 应对 |
 |------|------|
 | 迁移脚本数据丢失 | 迁移前备份数据库，旧表保留不删 |
 | 薪资计算引用旧表 | 过渡期双写，确认新表数据正确后再切换 |
 | 前端缓存旧城市选择器 | 强制刷新 + 版本号 |
 | 员工参保记录无 accountId | 迁移脚本按 city 匹配，未匹配的标记待处理 |
 **回滚方案**：保留旧表和旧 API，前端可切回旧版本，后端旧 API 仍可用。
@@ -0,0 +1,734 @@
 # 薪税管理完整处理逻辑和取数逻辑
 > 生成时间：2026-08-16
 > 涉及模块：薪资发放批次、社保公积金、个税累计预扣、工资条生成与发布
 > 核心文件：`backend/src/services/payroll.service.ts`、`backend/src/routes/payroll2.routes.ts`、`backend/src/routes/social.routes.ts`
 ---
 ## 一、整体架构
 ```
 ┌─────────────────────────────────────────────────────────────┐
 │                    薪税管理三大模块                          │
 ├──────────────┬──────────────────┬───────────────────────────┤
 │  社保公积金   │    个税计算       │    工资条生成/发布        │
 │  (缴纳/扣除)  │  (累计预扣法)     │    (汇总/发布/定时)       │
 └──────────────┴──────────────────┴───────────────────────────┘
         ↓ 取数 ↓                ↓ 取数 ↓
 ┌──────────────┬──────────────────┬───────────────────────────┐
 │ SocialAccount│ Employee 表      │ PayrollBatch (已归档)     │
 │ + YearStandard│ SpecialDeduction │ + BatchEntry             │
 │ + 旧Config表  │ + Record表       │ → Payslip                │
 └──────────────┴──────────────────┴───────────────────────────┘
 ```
 ---
 ## 二、核心计算函数 `calcBatchEntry`
 这是所有薪税计算的入口，在三个时机被调用：
 1. **创建批次时**：为每个员工初始化计算
 2. **编辑条目时**：修改任意金额后实时重算
 3. **归档时**：最终锁定前再重算一遍
 ### 输入参数
 ```typescript
 calcBatchEntry(
  orgId,           // 组织ID
  employeeId,      // 员工ID
  month,           // 批次月份 YYYY-MM
  inputs: {        // HR 可编辑的输入项
    baseSalary,          // 基本工资
    overtimePay,         // 加班费
    allowance,           // 其他津贴
    deduction,           // 扣款
    bonus,               // 奖金
    positionSalary?,     // 岗位工资
    performanceSalary?,  // 绩效工资
    senioritySalary?,    // 工龄工资
    transportAllowance?, // 交通补贴
    mealAllowance?,      // 餐补
    housingAllowance?,   // 住房补贴
    communicationAllowance?, // 通讯补贴
    otherDeduction?,     // 其他扣款
  },
  batchType,       // REGULAR | TERMINATION | BONUS | SEVERANCE
  options?: {      // 可选覆盖
    skipSocial?,        // 跳过社保计算
    overrideSocial?,    // 手动覆盖社保值
    prevDeferred?,      // 上月递延扣款（次月补扣）{ socialEmp, housingEmp, minWage }
  }
 )
 ```
 ---
 ## 三、社保公积金取数逻辑
 ### 取数优先级（三层回退）
 ```
 ① 员工 → 根部门(level=0) → socialAccount / housingAccount
   ↓ 找不到
 ② 公司默认账户 (isDefault=true)
   ↓ 找不到
 ③ 旧配置表 SocialInsuranceConfig / HousingFundConfig（按城市匹配）
 ```
 ### 新逻辑（账户体系）
 ```
 getEmployeeAccounts(orgId, employeeId)
  ├─ 查员工所属部门
  ├─ 向上遍历到 level=0 的根部门
  ├─ 读取根部门的 socialAccountId / housingAccountId
  ├─ 若根部门未关联 → 查公司默认账户 (isDefault=true)
  └─ 返回 { socialAccount, housingAccount }
 getStandardByAccountAndMonth(accountId, month)
  ├─ 查 SocialYearStandard: accountId + effectiveFrom ≤ month ≤ effectiveTo
  ├─ 找不到 → 回退到 isCurrent=true 的当前标准
  └─ 返回年度标准（比例 + 基数上下限）
 ```
 ### 旧逻辑（兼容回退）
 ```
 SocialInsuranceConfig.findFirst({
  orgId, city: employee.city,
  effectiveFrom ≤ month, effectiveTo ≥ month 或 null
 })
 ```
 ### 社保基数确定
 ```typescript
 socialBase = employee.socialInsBase || inputs.baseSalary
 housingBase = employee.housingFundBase || inputs.baseSalary
 ```
 优先级：员工核定基数 > 基本工资
 ### 社保金额计算
 ```typescript
 // 当月应缴全额
 fullSocialEmp = calcSocialInsurance(socialBase, socialConfig).socialEmp
 fullSocialOrg = calcSocialInsurance(socialBase, socialConfig).socialOrg
 fullHousingEmp = calcHousingFund(housingBase, housingConfig).housingEmp
 fullHousingOrg = calcHousingFund(housingBase, housingConfig).housingOrg
 // 已归档批次已扣金额（避免多批次重复扣社保）
 deductedSocialEmp = SUM(archivedEntries.socialEmp)
 deductedSocialOrg = SUM(archivedEntries.socialOrg)
 deductedHousingEmp = SUM(archivedEntries.housingEmp)
 deductedHousingOrg = SUM(archivedEntries.housingOrg)
 // 本批次应扣 = 应缴全额 - 已扣金额（差额补扣，足额为0）
 socialEmp = Math.max(0, fullSocialEmp - deductedSocialEmp)
 socialOrg = Math.max(0, fullSocialOrg - deductedSocialOrg)
 housingEmp = Math.max(0, fullHousingEmp - deductedHousingEmp)
 housingOrg = Math.max(0, fullHousingOrg - deductedHousingOrg)
 // 叠加上月递延的社保/公积金（入职当月未扣完的部分，本月补扣）
 if (options?.prevDeferred) {
  socialEmp += options.prevDeferred.socialEmp || 0
  housingEmp += options.prevDeferred.housingEmp || 0
 }
 ```
 ### 关键设计：差额补扣机制
 - 同一员工同一月份可能有多个批次（如常规发薪 + 离职结算）
 - 第一个批次扣全额，后续批次扣差额（应缴全额 - 已扣）
 - 避免重复扣除
 ### 批次类型对社保的影响
 | 批次类型 | 社保公积金 | 说明 |
 |---------|-----------|------|
 | REGULAR | ✅ 计算 | 常规发薪，差额补扣 |
 | TERMINATION | ✅ 计算 | 离职结算，差额补扣 |
 | BONUS | ❌ 不扣 | 年终奖单独计税，无社保 |
 | SEVERANCE | ❌ 不扣 | 补偿金不走社保个税 |
 ### 手动覆盖
 ```typescript
 // HR 可在编辑界面手动修改社保值
 if (options?.overrideSocial) {
  socialEmp = overrideSocial.socialEmp   // 覆盖个人社保
  socialOrg = overrideSocial.socialOrg   // 覆盖单位社保
  housingEmp = overrideSocial.housingEmp // 覆盖个人公积金
  housingOrg = overrideSocial.housingOrg // 覆盖单位公积金
 }
 // 同时保存 systemSocialEmp 等系统计算值，用于对比展示
 ```
 ---
 ## 四、应发合计计算
 ```typescript
 totalPay =
  baseSalary              // 基本工资
  + positionSalary        // 岗位工资
  + performanceSalary     // 绩效工资
  + senioritySalary       // 工龄工资
  + overtimePay           // 加班费
  + transportAllowance    // 交通补贴
  + mealAllowance         // 餐补
  + housingAllowance      // 住房补贴
  + communicationAllowance // 通讯补贴
  + allowance             // 其他津贴
  + bonus                 // 奖金
  - deduction             // 扣款
  - otherDeduction        // 其他扣款
 ```
 ---
 ## 五、个税计算逻辑
 ### 两种计税方式
 #### 1. 年终奖单独计税（BONUS 批次）
 ```typescript
 tax = calcBonusTax(inputs.bonus)
 // 年终奖 ÷ 12 → 找税率区间 → 年终奖 × 税率 - 速算扣除数
 ```
 #### 2. 累计预扣法（REGULAR / TERMINATION / SEVERANCE）
 ```typescript
 // ── 取数：当年已归档批次的历史数据 ──
 archivedEntries = BatchEntry.findMany({
  orgId, employeeId,
  batch: { month: startsWith(year), status: 'ARCHIVED' }
 })
 // 注意：不依赖 Payslip 是否已生成，直接从已归档批次取数
 // ── 累计计算 ──
 ytdIncome         = SUM(archivedEntries.totalPay) + totalPay
 ytdSocialEmp      = SUM(archivedEntries.socialEmp) + socialEmp
 ytdHousingEmp     = SUM(archivedEntries.housingEmp) + housingEmp
 ytdTaxDeducted    = SUM(archivedEntries.tax)
 // ── 专项附加扣除取数（三层回退）──
 deductionRecords = SpecialDeductionRecord.findMany({
  orgId, employeeId,
  month: startsWith(year) AND lte(month)   // 当年至当月
 })
 if (deductionRecords.length > 0) {
  // ✅ 优先：按月实际填报金额累加
  ytdSpecialDeduction = SUM(deductionRecords.amount)
 } else {
  // ⚠️ 回退：员工便捷字段 × 月数（兼容旧数据）
  ytdSpecialDeduction = employee.specialDeduction * Number(month.slice(5, 7))
 }
 // ── 累计应纳税所得额 ──
 deductionAmount    = 5000 × 月数                    // 基本减除费用
 ytdTaxableIncome   = max(0,
  ytdIncome
  - deductionAmount       // 累计减除费用（5000/月）
  - ytdSocialEmp          // 累计个人社保
  - ytdHousingEmp         // 累计个人公积金
  - ytdSpecialDeduction   // 累计专项附加扣除
 )
 // ── 当月应扣个税 ──
 tax = calcCumulativeTax(ytdTaxableIncome, ytdTaxDeducted)
 // = 累计应纳税额 - 已预扣个税
 ```
 ### 专项附加扣除数据来源
 | 来源 | 表 | 说明 |
 |------|---|------|
 | **按月记录**（优先） | `SpecialDeductionRecord` | HR/员工按月填报，含子女教育、赡养老人、住房贷款、继续教育、婴幼儿照护 |
 | **便捷字段**（回退） | `Employee.specialDeduction` | 员工表上的当前值，× 月数估算累计 |
 **按月记录的优势**：员工某月取消专项附加扣除，该月金额为 0，累计值准确反映实际。
 ### taxBreakdown 返回的明细
 ```json
 {
  "method": "累计预扣法",
  "month": 8,
  "ytdIncome": 80000,           // 累计收入
  "deductionAmount": 40000,      // 累计减除费用 (5000×8)
  "ytdSocialEmp": 6720,          // 累计个人社保
  "ytdHousingEmp": 3840,         // 累计个人公积金
  "ytdSpecialDeduction": 12000,  // 累计专项附加扣除
  "specialDeductionSource": "按月记录",  // 数据来源标识
  "specialDeductionRecords": 8,  // 按月记录条数
  "ytdTaxableIncome": 17440,     // 累计应纳税所得额
  "ytdTaxDeducted": 480,         // 已预扣个税
  "currentMonthTax": 360,        // 当月应扣个税
  "archivedCount": 7             // 已归档批次数
 }
 ```
 ---
 ## 六、实发工资与最低工资保护
 ```typescript
 // 初始实发 = 应发 - 个人社保 - 个人公积金 - 个税 - 上月递延最低工资补扣
 netPay = totalPay - socialEmp - housingEmp - tax - prevDeferredMinWage
 // 最低工资保护（仅 REGULAR / TERMINATION 批次）
 if (minWage > 0 && netPay < minWage) {
  // 优先递延社保 → 递延公积金 → 递延最低工资补齐
  // 详见第十五章「最低工资保护与递延扣款机制」
  netPay = minWage
 }
 ```
 ---
 ## 七、创建批次时的初始化取数
 ### 员工来源
 | 批次类型 | 员工来源 |
 |---------|---------|
 | REGULAR / BONUS | `status=ACTIVE` + 本月离职（`status=RESIGNED, updatedAt 在本月`） |
 | TERMINATION | 本月 `TerminationRecord` 关联的员工 |
 | SEVERANCE | 本月离职记录中已审批（APPROVED/EXECUTING/COMPLETED）且有补偿金的 |
 ### 数据初始化（5 种模式）
 | 模式 | baseSalary 取数 | overtimePay | allowance/deduction |
 |------|----------------|-------------|---------------------|
 | **copy_last** | 试用期→`probationSalary`；转正→上月工资条`baseSalary`；无→`monthlySalary` | 当月 `OvertimeRecord.totalPay` | 上月工资条复制 |
 | **blank_employees** | `employee.monthlySalary`（解密） | 0 | 0 |
 | **blank_all** | 0（无员工） | 0 | 0 |
 | **copy_batch** | 源批次条目复制 | 源批次复制 | 源批次复制 |
 | **custom** | 0（手动填写） | 0 | 0 |
 ### 试用期判定
 ```typescript
 isInProbation(contract, batchMonthEnd)
 // 试用期结束日 = contract.startDate + contract.probationMonths
 // 若 batchMonthEnd < 试用期结束日 → 在试用期内
 ```
 统一规则（所有模式适用，SEVERANCE/TERMINATION 除外）：
 - 在试用期内且 `probationSalary > 0` → `baseSalary = probationSalary`
 ---
 ## 八、编辑条目时的重算
 ```
 HR 修改任意金额字段
  ↓
 PUT /batches/:batchId/entries/:employeeId
  ↓
 合并新旧 inputs（未修改的保留原值）
  ↓
 重新调用 calcBatchEntry() → 重算社保/个税/实发
  ↓
 更新 BatchEntry + 重算批次汇总
 ```
 **社保手动覆盖**：编辑社保字段时，通过 `overrideSocial` 传入，覆盖系统计算值，同时保存 `systemSocial*` 用于对比。
 ---
 ## 九、归档时的最终重算
 ```
 POST /batches/:batchId/archive
  ↓
 ① 遍历所有条目，重新调用 calcBatchEntry()
   - 此时已归档批次的累计数据是最新的
   - 社保差额补扣准确
   - 个税累计预扣准确
 ② 更新批次汇总（totalPay/totalNetPay/各项合计）
 ③ 标记 status=ARCHIVED, archivedAt=now
 ④ 批次锁定，不可再编辑
 ```
 **归档时不自动生成工资条**，需单独调用 `POST /payslips/generate`。
 ---
 ## 十、工资条生成与发布
 ### 生成工资条
 ```
 POST /payslips/generate { month }
  ↓
 generatePayslipFromBatches(orgId, month)
  ↓
 ① 查当月所有已归档批次（status=ARCHIVED）
 ② 按员工汇总所有批次的 BatchEntry（多批次合并）
 ③ 查当年历史工资条计算累计数据
 ④ upsert Payslip（employeeId+month 唯一键）
 ```
 ### 发布工资条
 ```
 POST /batches/:batchId/publish
  ↓
 更新 Payslip.publishStatus = 'PUBLISHED', publishedAt = now
  ↓
 员工端可见
 ```
 ### 定时发送
 ```
 POST /batches/:batchId/schedule { scheduledAt }
  ↓
 更新 Payslip.publishStatus = 'SCHEDULED', scheduledAt = 指定时间
  ↓
 （定时任务到点后发布）
 ```
 ---
 ## 十一、取消归档
 ```
 POST /batches/:batchId/unarchive
  ↓
 ① 只能取消最后一个归档批次
 ② 批次恢复为 DRAFT
 ③ 如果还有其他归档批次 → 重新生成工资条（基于剩余批次）
 ④ 如果没有归档批次了 → 删除该月工资条
 ```
 ---
 ## 十二、完整数据流图
 ```
                    ┌─────────────────┐
                    │  Employee 表     │
                    │  socialInsBase   │
                    │  housingFundBase │
                    │  monthlySalary   │
                    │  specialDeduction│
                    └────────┬────────┘
                             │
    ┌────────────────────────┼────────────────────┐
    │                        │                    │
    ▼                        ▼                    ▼
 ┌──────────┐    ┌──────────────────┐    ┌─────────────────┐
 │SocialAccount│  │SpecialDeduction  │    │ OvertimeRecord  │
 │+YearStandard│  │Record (按月)     │    │ (加班费)        │
 │(社保比例)   │  └──────────────────┘    └─────────────────┘
 │+minWage    │           │                    │
 └──────┬─────┘           │                    │
       │                 │                    │
       ▼                 ▼                    ▼
 ┌──────────────────────────────────────────────────────┐
 │              calcBatchEntry()                         │
 │                                                       │
 │  社保 = 应缴全额 - 已归档批次已扣（差额补扣）          │
 │       + 上月递延社保（次月补扣）                       │
 │  应发 = 基本工资 + 各项津贴 + 奖金 - 扣款             │
 │  个税 = 累计预扣法（从已归档批次取累计数据）           │
 │  实发 = 应发 - 个人社保 - 个人公积金 - 个税            │
 │       - 上月递延最低工资补扣                           │
 │  最低工资保护：实发 < minWage 时 → 递延扣款补齐        │
 │       递延社保 → 递延公积金 → 递延最低工资补齐         │
 └──────────────────────┬───────────────────────────────┘
                       │
                       ▼
              ┌────────────────┐
              │  BatchEntry    │
              │  (批次条目)     │
              │  + minWage     │
              │  + minWageApplied│
              │  + deferred*   │
              │  + prevDeferred*│
              └───────┬────────┘
                      │ 归档
                      ▼
              ┌────────────────┐      汇总生成
              │ PayrollBatch   │ ──────────────→ ┌──────────┐
              │ status=ARCHIVED│                 │ Payslip  │
              └────────────────┘                 │ (工资条) │
                                                 └────┬─────┘
                                                      │ 发布
                                                      ▼
                                               员工端可见
 次月创建批次时：
  getPrevDeferred() 读取上月 BatchEntry 的 deferred* 字段
  → 传入 calcBatchEntry 的 options.prevDeferred
  → 本月社保/公积金叠加补扣上月递延金额
 ```
 ---
 ## 十三、关键取数表汇总
 | 数据项 | 取数表 | 取数条件 | 用途 |
 |--------|--------|---------|------|
 | 社保比例 | `SocialYearStandard` | accountId + 月份在生效区间 | 计算社保公积金 |
 | 社保比例（回退） | `SocialInsuranceConfig` | orgId + city + 月份在生效区间 | 兼容旧数据 |
 | 最低工资标准 | `SocialYearStandard.minWage` | accountId + 月份在生效区间 | 最低工资保护 |
 | 最低工资标准（回退） | `SocialInsuranceConfig.minWage` | orgId + city + 月份在生效区间 | 兼容旧数据 |
 | 社保基数 | `Employee.socialInsBase` | — | 优先于基本工资 |
 | 公积金基数 | `Employee.housingFundBase` | — | 优先于基本工资 |
 | 已扣社保 | `BatchEntry` | 当月已归档批次 | 差额补扣 |
 | 累计收入 | `BatchEntry` | 当年已归档批次 | 个税累计预扣 |
 | 累计社保 | `BatchEntry` | 当年已归档批次 | 个税累计预扣 |
 | 累计个税 | `BatchEntry` | 当年已归档批次 | 个税累计预扣 |
 | 专项附加扣除 | `SpecialDeductionRecord` | 当年至当月 | 个税累计预扣 |
 | 专项附加扣除（回退） | `Employee.specialDeduction` | × 月数 | 兼容旧数据 |
 | 基本减除费用 | 固定 5000 | × 月数 | 个税累计预扣 |
 | 加班费 | `OvertimeRecord` | employeeId + month | 创建批次时自动拉取 |
 | 基本工资 | `Payslip`（上月） | employeeId + 上月 | copy_last 模式 |
 | 基本工资（回退） | `Employee.monthlySalary` | 解密 | 无上月工资条时 |
 | 试用期工资 | `LaborContract.probationSalary` | 最新合同 | 试用期内的 baseSalary |
 | 上月递延社保 | `BatchEntry.deferredSocialEmp` | 上月已归档批次 | 次月补扣 |
 | 上月递延公积金 | `BatchEntry.deferredHousingEmp` | 上月已归档批次 | 次月补扣 |
 | 上月递延最低工资补齐 | `BatchEntry.deferredMinWage` | 上月已归档批次 | 次月补扣 |
 ---
 ## 十四、3 步工作流
 ```
 ① 编辑薪资（含核对） → ② 归档锁定 → ③ 发布工资条
 ```
 ### 步骤 1：编辑薪资（DRAFT 状态）
 可操作：
 - **点击单元格编辑**：基本工资、加班费、津贴、奖金、扣款、社保个人/单位、公积金个人/单位
 - **导入工资表 Excel**：批量填充薪资数据
 - **下载导入模板**
 - **导入加班费**：从加班记录按月自动填充 `overtimePay`
 - **获取提成奖金**：从提成奖金模块按月填充 `bonus`
 - **添加/删除人员**：动态调整批次人员
 - **查看个税明细**：点击个税金额查看累计预扣计算过程
 核对（编辑页面内直接展示，非独立步骤）：
 - 批次汇总卡片：应发合计、社保合计、公积金合计、个税合计、实发合计
 - 质量门禁自动检查：实发为负、全零记录、最低工资、递延扣款等
 - 可导出 **薪资汇总表** / **薪资明细表**（CSV）
 质量门禁（草稿状态自动检查）：
 - 实发为负的员工 → 红色警告
 - 实发低于最低工资（未触发保护）→ 红色警告
 - 最低工资保护已触发（递延扣款）→ 黄色警告
 - 本月补扣上月递延 → 黄色警告
 - 全零记录 → 黄色警告
 表格可视化提示：
 - **实发列**：最低工资保护触发时显示橙色 + ★标记，悬停显示补齐明细
 - **递延扣款列**（新增）：橙色"递延 ¥X"或蓝色"补扣 ¥X"，悬停显示分项明细
 - **风险列**：最低工资保护触发时显示橙色警告图标
 ### 步骤 2：归档锁定（ARCHIVED）
 **归档时后端自动执行**：
 1. **重算所有条目**：调用 `calcBatchEntry` 重新计算社保公积金和个税
 2. **更新批次汇总**：重算 totalPay/totalNetPay/各项合计
 3. **标记为 ARCHIVED**：设置 `archivedAt`，不可再编辑
 ### 步骤 3：发布工资条
 - 调用 `POST /batches/:id/publish` → 更新 `Payslip.publishStatus = PUBLISHED`
 - 或调用 `POST /batches/:id/schedule` → 设置 `publishStatus = SCHEDULED` + `scheduledAt`
 - 员工在员工端查看已发布的工资条
 ---
 ## 十五、最低工资保护与递延扣款机制
 ### 背景
 入职当月工资按天折算后，可能不足以扣除社保/公积金个人部分，导致实发为负。
 《劳动法》第四十八条规定用人单位支付劳动者的工资不得低于当地最低工资标准。
 ### 最低工资标准配置
 | 配置位置 | 表 | 字段 | 说明 |
 |---------|---|------|------|
 | 新账户体系 | `SocialYearStandard` | `minWage` | 按账户+年度设置，优先使用 |
 | 旧配置表 | `SocialInsuranceConfig` | `minWage` | 兼容回退，按城市匹配 |
 前端配置入口：社保配置页面 → 新建版本 → "最低工资标准"输入框（仅社保 Tab）
 设为 0 表示不检查最低工资。
 ### 保护逻辑（calcBatchEntry 中执行）
 ```
 初始实发 = 应发 - 社保个人 - 公积金个人 - 个税 - 上月递延最低工资补扣
 if (minWage > 0 且 实发 < minWage) {
  差额 = minWage - 实发
  ① 优先递延社保个人部分
     if (差额 <= 社保个人) {
       递延社保 = 差额
       社保个人 -= 差额
       实发 = minWage
     }
  ② 社保不够，递延全部社保 + 部分公积金
     else if (差额 <= 社保个人 + 公积金个人) {
       递延社保 = 社保个人
       递延公积金 = 差额 - 社保个人
       社保个人 = 0
       公积金个人 -= 递延公积金
       实发 = minWage
     }
  ③ 社保+公积金都不够，差额作为最低工资补齐递延
     else {
       递延社保 = 社保个人
       递延公积金 = 公积金个人
       递延最低工资补齐 = 差额 - 社保个人 - 公积金个人
       社保个人 = 0
       公积金个人 = 0
       实发 = minWage
     }
 }
 ```
 ### minWageApplied 的含义
 `minWageApplied` = 为让实发达到最低工资而减少的扣款总额，包含三部分：
 | 组成 | 字段 | 含义 |
 |------|------|------|
 | 免扣社保 | `deferredSocialEmp` | 本该扣但没扣的社保个人部分 |
 | 免扣公积金 | `deferredHousingEmp` | 本该扣但没扣的公积金个人部分 |
 | 额外补齐 | `deferredMinWage` | 社保+公积金全免后仍不足的差额 |
 | **合计** | `minWageApplied` | = 免扣社保 + 免扣公积金 + 额外补齐 |
 **注意**：`minWageApplied` 不是"额外补了这么多现金"，而是"减少了这么多扣款"。
 ### 递延扣款的次月补扣
 ```
 本月（入职当月）：
  BatchEntry 记录 deferredSocialEmp / deferredHousingEmp / deferredMinWage
  实发 = minWage（保护后）
 次月（创建批次时）：
  getPrevDeferred() 读取上月已归档批次的递延金额
  calcBatchEntry 的 options.prevDeferred 传入
  本月社保个人 = 当月应缴社保 + 上月递延社保
  本月实发 = 应发 - (当月社保 + 上月递延社保) - (当月公积金 + 上月递延公积金) - 个税 - 上月递延最低工资补齐
  BatchEntry 记录 prevDeferredSocialEmp / prevDeferredHousingEmp / prevDeferredMinWage
 ```
 ### 示例
 **张三 8 月 20 日入职，月薪 12000，扣款 20000（测试数据）**
 ```
 应发 = 12000 + 0 + 0 + (-500) - 20000 = -8500
 社保个人（原）= 1575
 公积金个人（原）= 1800
 个税 = 0
 初始实发 = -8500 - 1575 - 1800 - 0 = -11875
 最低工资 = 2420
 保护触发：
  差额 = 2420 - (-11875) = 14295
  递延社保 = 1575（全部免扣）
  递延公积金 = 1800（全部免扣）
  递延最低工资补齐 = 14295 - 1575 - 1800 = 10920
  实发 = 2420
 BatchEntry 记录：
  minWage = 2420
  minWageApplied = 14295
  deferredSocialEmp = 1575
  deferredHousingEmp = 1800
  deferredMinWage = 10920
  socialEmp = 0（当月不扣）
  housingEmp = 0（当月不扣）
  netPay = 2420
 次月（9 月）：
  getPrevDeferred() 读取 → { socialEmp: 1575, housingEmp: 1800, minWage: 10920 }
  9 月社保个人 = 当月应缴社保 + 1575
  9 月实发 = 应发 - 9月社保(含补扣) - 9月公积金(含补扣) - 个税 - 10920
 ```
 ### 前端展示
 | 展示位置 | 样式 | 内容 |
 |---------|------|------|
 | 实发列 | 橙色 + ★ | 触发最低工资保护时，悬停显示补齐明细 |
 | 递延扣款列 | 橙色"递延 ¥X" | 当月递延，悬停显示分项（免扣社保/公积金/额外补齐） |
 | 递延扣款列 | 蓝色"补扣 ¥X" | 次月补扣上月递延，悬停显示分项 |
 | 风险列 | 橙色警告图标 | 最低工资保护触发 |
 | 质量门禁 | 黄色提示 | "N 名员工实发已补齐到最低工资标准..." |
 ### prePayrollCheck 检查项（第 11/12 项）
 ```
 // 11. 实发低于最低工资标准（剔除加班费后比较）
 if (minWage > 0 且 可比收入 < minWage 且 实发 < minWage) {
  if (minWageApplied > 0) {
    → WARNING: 最低工资保护已触发（递延扣款）
  } else {
    → FAIL: 实发低于最低工资标准
  }
 }
 // 12. 上月递延扣款待补扣
 if (prevDeferred > 0) {
  → WARNING: 上月递延扣款已补扣
 }
 ```
 ---
 ## 十六、状态流转
 ```
 DRAFT（草稿，可编辑）
  ↓ 归档
 ARCHIVED（已归档，锁定不可编辑）
  ↓ 取消归档
 DRAFT（恢复草稿）
  ↓ 发布工资条
 Payslip.publishStatus: PUBLISHED（员工端可见）
 ```
 ---
 ## 十七、批次类型详解
 | 类型 | 说明 | 社保公积金 | 个税计算 | 员工来源 |
 |------|------|-----------|---------|---------|
 | **REGULAR** 常规发薪 | 月度工资 | ✅ 差额补扣 | 累计预扣法 | 在职 + 本月离职 |
 | **TERMINATION** 离职结算 | 离职员工当月工资 | ✅ 差额补扣 | 累计预扣法 | 本月离职记录 |
 | **BONUS** 年终奖/奖金 | 单独计税 | ❌ 不扣 | 单独计税 | 在职 + 本月离职 |
 | **SEVERANCE** 补偿金 | 离职补偿金 | ❌ 不扣 | 累计预扣法（无社保扣除） | 已审批且有补偿金的离职记录 |
 ---
 ## 十八、创建批次的 5 种数据初始化模式
 | 模式 | 说明 | 员工来源 | 数据来源 |
 |------|------|---------|---------|
 | **copy_last** 复制上月 | 默认模式 | 在职 + 本月离职 | 上月工资条复制基本工资/津贴/扣款 + 当月加班费 |
 | **blank_employees** 本月空白 | 拉入员工 | 在职 + 本月离职 | 所有金额为 0，手动填写 |
 | **blank_all** 全空白 | 不拉入员工 | 无 | 后续手动添加人员 |
 | **copy_batch** 复制指定批次 | 从源批次 | 源批次的员工 | 复制源批次薪资数据 |
 | **custom** 自定义选择 | 按部门/姓名筛选勾选 | 指定员工 | 金额为 0，手动填写 |
@@ -0,0 +1,119 @@
 # 社保公积金账户关联根部门 + 员工新增自动带出账户
 > 生成时间：2026-08-16
 > 涉及模块：设置（账户管理）、花名册（新增员工）、组织架构（根部门关联）
 > 核心文件：`backend/src/routes/social.routes.ts`、`backend/src/routes/department.routes.ts`、`backend/src/services/contract.service.ts`、`frontend/src/pages/Settings.tsx`、`frontend/src/pages/roster/modals.tsx`、`frontend/src/lib/api-services.ts`
 ---
 ## 一、需求背景
 1. 社保公积金账户创建后，需要关联组织架构的根节点（公司/分公司/子公司，即 level=0 的部门）。
 2. 员工新增时，选定部门后自动带出该部门所属根节点关联的社保公积金账户，可手工调整，确定后按账户当前生效的年度标准执行。
 ---
 ## 二、完成内容
 ### 1. 账户关联组织架构根节点
 #### 前端：设置页 → 社保公积金账户 Tab
 - 新建/编辑账户弹窗新增"关联根部门"区域
 - 列出所有 level=0 根部门（公司/分公司/子公司），可多选勾选
 - 保存账户时同步关联到选中的根部门
 - 编辑时自动加载已关联的部门并回显勾选状态
 #### 后端新增 API
 | 方法 | 路径 | 说明 |
 |---|---|---|
 | `PUT` | `/social/accounts/:id/departments` | 批量设置账户关联的根部门（先清除旧关联，再批量设置新关联，仅限 level=0） |
 | `GET` | `/social/accounts/:id/departments` | 查询账户已关联的根部门列表 |
 | `GET` | `/social/department-account/:departmentId` | 按部门带出适用账户 + 当前生效年度标准 |
 #### 部门 API
 - `PUT /departments/:id` 的 schema 新增 `socialAccountId`、`housingAccountId` 可选字段
 - 更新时写入 `department.socialAccountId` / `department.housingAccountId`
 #### 账户关联逻辑
 - 账户类型为 `SOCIAL` 时，写入 `department.socialAccountId`
 - 账户类型为 `HOUSING` 时，写入 `department.housingAccountId`
 - 设置新关联前，先清除该账户的所有旧关联（`updateMany` 置 null）
 - 仅允许关联 `level=0` 的根部门
 ---
 ### 2. 员工新增时自动带出账户
 #### 前端：花名册 → 新增员工
 - 表单 state 新增 `departmentId` 字段，部门选择改为按 `id` 取值
 - 选定部门后，自动调用 `GET /social/department-account/:departmentId` 查询适用账户
 - 社保账户、公积金账户下拉框自动选中继承的账户
 - 账户下方显示当前生效标准（基数范围、比例）
 - 可手动调整账户选择（下拉切换到其他账户）
 - 缴费基数默认与月工资一致，可手动修改
 - 提交时将 `socialAccountId` / `housingAccountId` 写入参保记录
 #### 后端：按部门带出账户逻辑
 `GET /social/department-account/:departmentId` 处理流程：
 1. 从当前部门向上查找，直到 `level=0` 的根部门
 2. 读取根部门的 `socialAccount` / `housingAccount`
 3. 若根部门未关联账户，回退到公司默认账户（`isDefault=true`）
 4. 查询账户当前生效的 `SocialYearStandard`（`isCurrent=true`）
 5. 返回 `{ socialAccount, housingAccount, socialStandard, housingStandard }`
 #### 后端：参保记录写入 accountId
 `contract.service.ts` 中 `createEmployee`：
 - `EmployeeSocialInsRecord.create` 写入 `accountId: data.socialAccountId || null`
 - `EmployeeHousingFundRecord.create` 写入 `accountId: data.housingAccountId || null`
 ---
 ## 三、数据流
 ```
 设置页：创建账户 → 勾选根部门 → 保存
    ↓
 department.socialAccountId / housingAccountId
    ↓
 新增员工：选择部门 → 向上找根部门 → 读取关联账户
    ↓
 自动带出账户 + 当前标准 → 可手动调整
    ↓
 提交 → EmployeeSocialInsRecord.accountId / EmployeeHousingFundRecord.accountId
    ↓
 薪资计算：通过员工账户查年度标准 → 计算社保公积金
 ```
 ---
 ## 四、使用流程
 1. 在 **设置 → 社保公积金账户** 中创建账户，勾选关联的根部门
 2. 新增员工时选择部门 → 自动带出对应账户 → 确认基数 → 保存
 3. 薪资计算时按员工账户的年度标准执行
 ---
 ## 五、兼容性
 - 旧 `SocialInsuranceConfig` / `HousingFundConfig` 表保留
 - 薪资计算优先用新账户年度标准，查不到回退旧表
 - 未关联账户的根部门，员工新增时回退到公司默认账户
 - RehireModal（重新入职）保持原有逻辑，不自动带出账户（员工已有参保记录）
 ---
 ## 六、部署记录
 - 提交：`014c94e` feat: 账户关联根部门 + 员工新增自动带出账户
 - 部署：2026-08-16 已部署到 https://on.hr8ai.top/
 - 数据库：schema 同步完成（Department 表 socialAccountId/housingAccountId 字段已存在）
@@ -20,9 +20,11 @@ enum Role {
  ADMIN
  HR
  VIEWER
  SUPPORT
 }
 enum EmployeeStatus {
  PRE_ONBOARD  // 预入职：已录入但未正式入职，不进入薪资批次
  ACTIVE
  RESIGNED
  TERMINATED
@@ -130,8 +132,16 @@ model Organization {
  city         String?
  contactName  String?
  contactPhone String?
-  payrollFrequency Int    @default(1)  // 每月发薪次数（1=一次一批）
+  payrollDays         Json     @default("[5]")  // 每月发薪日期，如 [5, 20] 表示每月5号和20号
  payrollReminderDays Int      @default(3)     // 发薪提前提醒天数
  retirementReminderEnabled Boolean @default(false) // 退休提醒开关
  esignPolicyEnabled  Boolean @default(false) // 规章制度电子签
  esignPayslipEnabled Boolean @default(false) // 工资条电子签
  esignOnboardingEnabled Boolean @default(false) // 入职文件电子签
  esignTrainingEnabled Boolean @default(false) // 培训记录电子签
  esignPerformanceEnabled Boolean @default(false) // 绩效考核电子签
  esignDisciplinaryEnabled Boolean @default(false) // 违纪记录电子签
  socialInsCutoffDay  Int      @default(15)       // 社保/公积金截止日：每月该日前离职→截止月=离职月-1，该日后→截止月=离职月
  createdAt    DateTime @default(now())
  updatedAt    DateTime @updatedAt
@@ -163,6 +173,7 @@ model Organization {
  attendanceRecords    AttendanceRecord[]
  trainingRecords      TrainingRecord[]
  performanceRecords   PerformanceRecord[]
  performanceTemplates PerformanceTemplate[]
  retirementPolicies   RetirementPolicy[]
  socialMonthlyProcesses SocialMonthlyProcess[]
  evidenceChains       EvidenceChain[]
@@ -183,6 +194,23 @@ model Organization {
  attendancePublishes  AttendancePublish[]
  specialStatuses      EmployeeSpecialStatus[]
  companyFiles         CompanyFile[]
  commercialInsPlans   CommercialInsurancePlan[]
  commercialInsEnrollments CommercialInsuranceEnrollment[]
  benefitPlans         EmployeeBenefitPlan[]
  benefitEnrollments   EmployeeBenefitEnrollment[]
  eSignRecords         ESignRecord[]
  commissionBonuses    CommissionBonus[]
  medicalPeriodPolicies MedicalPeriodPolicy[]
  socialAccounts       SocialAccount[]
  socialYearStandards  SocialYearStandard[]
  // 组织架构 + 审批流
  departments          Department[]
  positions            Position[]
  approvalFlows        ApprovalFlow[]
  approvalInstances    ApprovalInstance[]
  // 客服工作台
  tickets              Ticket[]
  chatSessions         ChatSession[]
 }
 model User {
@@ -210,11 +238,15 @@ model Employee {
  department        String
  position          String?        // 岗位
  hireDate          DateTime
  // 组织架构扩展
  departmentId      String?        // 关联 Department 表（兼容旧 department 字符串）
  supervisorId      String?        // 直属上级员工ID
  monthlySalary     String         // AES-256 加密存储
  status            EmployeeStatus @default(ACTIVE)
  gender            String?
  phone             String?
  idCardNumber      String?        // AES-256 加密存储
  idType            String?        // 证件类型：ID_CARD(身份证,默认)/PASSPORT/HK_MACAO_TAIWAN/OTHER
  idCardHash        String?        // SHA-256 哈希，用于按身份证号查询匹配
  emergencyContact  String?
  emergencyPhone    String?
@@ -268,10 +300,38 @@ model Employee {
  calendarEvents          CalendarEvent[]
  workProcesses           WorkProcess[]
  specialStatuses         EmployeeSpecialStatus[]
  commercialInsEnrollments CommercialInsuranceEnrollment[]
  benefitEnrollments      EmployeeBenefitEnrollment[]
  eSignRecords            ESignRecord[]
  commissionBonuses       CommissionBonus[]
  // 组织架构关联
  dept                    Department?       @relation("DeptEmployees", fields: [departmentId], references: [id])
  supervisor              Employee?         @relation("SupervisorSubordinates", fields: [supervisorId], references: [id])
  subordinates            Employee[]        @relation("SupervisorSubordinates")
  approvalInstances       ApprovalInstance[]
  @@unique([orgId, idCardHash])
 }
 /// 提成奖金记录（按月管理，支持正负值：正=奖金，负=扣款）
 model CommissionBonus {
  id          String   @id @default(cuid())
  orgId       String
  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  employeeId  String
  employee    Employee  @relation(fields: [employeeId], references: [id], onDelete: Cascade)
  month       String   // YYYY-MM
  amount      Float    // 正=奖金，负=扣款
  remark      String?
  createdBy   String
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt
  @@unique([orgId, employeeId, month])
  @@index([orgId, month])
  @@index([employeeId])
 }
 model LaborContract {
  id                    String     @id @default(cuid())
  orgId                 String
@@ -282,6 +342,7 @@ model LaborContract {
  startDate             DateTime
  endDate               DateTime?
  contractType          ContractType
  contractCategory      String?    // 合同分类：LABOR_CONTRACT(劳动合同,默认)/LABOR_AGREEMENT(劳务协议)/INTERNSHIP(实习协议)/FLEXIBLE(灵活用工)
  signMethod            SignMethod @default(PAPER)
  contractYears         Int        @default(3)
  probationMonths       Int        @default(0)
@@ -401,6 +462,86 @@ model AuditLog {
 // ========== 社保 & 通知 & 附件 ==========
 /// 社保/公积金账户（实体化管理，替代原 city 字符串）
 model SocialAccount {
  id            String   @id @default(cuid())
  orgId         String
  org           Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  type          String   // SOCIAL=社保账户, HOUSING=公积金账户
  name          String   // 账户名称，如"北京总公司社保账户"
  city          String   // 参保城市
  accountNo     String?  // 社保登记号 / 公积金单位账号
  bankName      String?  // 公积金开户行（公积金专用）
  bankAccount   String?  // 公积金银行账号（公积金专用）
  orgName       String?  // 缴费主体名称（子公司/分公司名称）
  orgCode       String?  // 缴费主体统一社会信用代码
  accountType   String?  // 公积金账户类型 BASIC=基本, SUPPLEMENTARY=补充
  isDefault     Boolean  @default(false)
  status        String   @default("ACTIVE") // ACTIVE=正常, SUSPENDED=停用
  remark        String?
  createdBy     String
  createdAt     DateTime @default(now())
  updatedAt     DateTime @updatedAt
  yearStandards     SocialYearStandard[]
  socialRecords     EmployeeSocialInsRecord[]
  housingRecords    EmployeeHousingFundRecord[]
  monthlyProcesses  SocialMonthlyProcess[]
  // 部门关联（员工通过部门继承账户）
  deptSocialAccounts   Department[] @relation("DeptSocialAccount")
  deptHousingAccounts  Department[] @relation("DeptHousingAccount")
  @@unique([orgId, type, name])
  @@index([orgId, type, city])
  @@index([orgId, type, isDefault])
 }
 /// 年度标准（替代原 SocialInsuranceConfig / HousingFundConfig）
 model SocialYearStandard {
  id              String   @id @default(cuid())
  orgId           String
  org             Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  accountId       String
  account         SocialAccount @relation(fields: [accountId], references: [id], onDelete: Cascade)
  // 社保比例（type=SOCIAL 时使用）
  pensionOrg      Float    @default(16)
  pensionEmp      Float    @default(8)
  medicalOrg      Float    @default(9.8)
  medicalEmp      Float    @default(2)
  medicalOrgExtra Float    @default(0)     // 医疗企业附加（固定金额，如北京大病医疗）
  medicalEmpExtra Float    @default(0)     // 医疗个人附加（固定金额，如北京3元大病医疗）
  unemploymentOrg Float    @default(0.5)
  unemploymentEmp Float    @default(0.5)
  injuryOrg       Float    @default(0.2)
  maternityOrg    Float    @default(0.8)
  baseMin         Float    @default(6326)
  baseMax         Float    @default(33891)
  medicalBaseMin  Float    @default(0)
  medicalBaseMax  Float    @default(0)
  extraInsurances Json?
  // 公积金比例（type=HOUSING 时使用）
  housingOrg      Float    @default(12)
  housingEmp      Float    @default(12)
  housingBaseMin  Float    @default(0)     // 公积金基数下限（0 时 fallback 到 baseMin）
  housingBaseMax  Float    @default(0)     // 公积金基数上限（0 时 fallback 到 baseMax）
  // 最低工资标准（按参保城市，每年调整）
  minWage         Float    @default(0)  // 当地月最低工资标准（0=不检查）
  effectiveFrom   String   // 生效月份 YYYY-MM
  effectiveTo     String?  // 失效月份 YYYY-MM（null=当前有效）
  isCurrent       Boolean  @default(true)
  adjustmentDone  Boolean  @default(false)
  createdBy       String
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt
  @@unique([accountId, effectiveFrom])
  @@index([accountId, isCurrent])
 }
 model SocialInsuranceConfig {
  id              String   @id @default(cuid())
  orgId           String
@@ -410,6 +551,8 @@ model SocialInsuranceConfig {
  pensionEmp      Float    @default(8)     // 养老保险 个人比例 %
  medicalOrg      Float    @default(9.8)   // 医疗保险 企业比例 %
  medicalEmp      Float    @default(2)     // 医疗保险 个人比例 %
  medicalOrgExtra Float    @default(0)     // 医疗企业附加（固定金额）
  medicalEmpExtra Float    @default(0)     // 医疗个人附加（固定金额，如北京3元）
  unemploymentOrg Float    @default(0.5)   // 失业保险 企业比例 %
  unemploymentEmp Float    @default(0.5)   // 失业保险 个人比例 %
  injuryOrg       Float    @default(0.2)   // 工伤保险 企业比例 %
@@ -419,6 +562,7 @@ model SocialInsuranceConfig {
  medicalBaseMin  Float    @default(0)     // 医疗/生育保险基数下限（0 时 fallback 到 baseMin）
  medicalBaseMax  Float    @default(0)     // 医疗/生育保险基数上限（0 时 fallback 到 baseMax）
  extraInsurances Json?    // 附加险种配置 JSON: [{ name, orgRate, empRate, baseType: 'pension'|'medical'|'fixed', fixedAmount }]
  minWage         Float    @default(0)  // 当地月最低工资标准（0=不检查）
  effectiveFrom   String   // 生效月份 YYYY-MM
  effectiveTo     String?  // 失效月份 YYYY-MM（null=当前有效）
  isCurrent       Boolean  @default(true) // 是否当前生效版本
@@ -485,6 +629,21 @@ model OvertimeConfig {
  updatedAt       DateTime @updatedAt
 }
 model MedicalPeriodPolicy {
  id          String   @id @default(cuid())
  orgId       String
  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  region      String   // 地区名称，如"全国"、"上海"、"广东"
  legalBasis  String   // 法律依据
  rules       Json     // 分档规则: [{ maxYears: 5, months: 3, cycleMonths: 6 }, ...]
  isDefault   Boolean  @default(false)
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt
  @@unique([orgId, region])
  @@index([orgId])
 }
 model NotificationLog {
  id          String   @id @default(cuid())
  orgId       String
@@ -613,11 +772,14 @@ model PerformanceRecord {
  employeeId     String
  employee       Employee @relation(fields: [employeeId], references: [id], onDelete: Cascade)
  period         String   // 考核周期 YYYY-MM 或 YYYY-Q1
  periodType     String   @default("MONTHLY") // MONTHLY/QUARTERLY/YEARLY
  score          Float    @default(0) // 考核得分
  grade          String   @default("B") // A/B/C/D
  result         String   @default("QUALIFIED") // EXCELLENT/QUALIFIED/NEED_IMPROVE/UNQUALIFIED
  summary        String?  // 考核评语
  improvementPlan String? // 改进计划（不胜任时）
  templateId     String?  // 关联绩效模板（选填）
  dimensionScores Json?   // 各维度得分明细 { dimensionName: score }
  employeeAck    Boolean  @default(false)
  ackDate        DateTime?
  reviewer       String?
@@ -628,6 +790,22 @@ model PerformanceRecord {
  @@index([orgId, employeeId])
 }
 model PerformanceTemplate {
  id          String   @id @default(cuid())
  orgId       String
  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  name        String   // 模板名称
  description String?  // 模板说明
  dimensions  Json     // 考核维度 [{ name, weight, maxScore, description }]
  gradeRules  Json?    // 等级规则 [{ grade, result, minScore, maxScore }]
  isDefault   Boolean  @default(false)
  createdBy   String
  createdAt   DateTime @default(now())
  updatedAt   DateTime @updatedAt
  @@index([orgId])
 }
 // ========== 员工端表 ==========
 model Payslip {
@@ -664,6 +842,7 @@ model Payslip {
  publishedAt        DateTime?                    // 工资条发布到员工端的时间
  publishStatus      String?  // UNPUBLISHED/PUBLISHED/SCHEDULED
  scheduledAt        DateTime? // 定时发送时间
  viewedAt           DateTime? // 员工查看工资条的时间
  createdAt          DateTime @default(now())
  updatedAt          DateTime @updatedAt
@@ -676,7 +855,8 @@ model PayrollBatch {
  id              String   @id @default(cuid())
  orgId           String
  org             Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
-  month           String   // YYYY-MM
+  month           String   // 所属月（计薪月）YYYY-MM，决定调用哪个月的社保标准、个税累计
  payMonth        String?  // 发薪年月 YYYY-MM（实际发放月份，如十一提前发薪时=9月，所属月=10月）。null=与所属月相同
  batchNo         Int      // 批次序号（1, 2, 3...）
  name            String   // 批次名称
  type            PayrollBatchType @default(REGULAR)
@@ -732,6 +912,15 @@ model BatchEntry {
  tax             Float    @default(0)
  totalPay        Float    @default(0)  // 应发合计
  netPay          Float    @default(0)  // 实发工资
  // 最低工资保护 + 递延扣款（入职当月工资不足扣社保时，递延到次月补扣）
  minWage         Float    @default(0)  // 当月适用的最低工资标准
  minWageApplied  Float    @default(0)  // 当月实际补齐到最低工资的金额（0=未补齐）
  deferredSocialEmp   Float @default(0) // 递延到次月补扣的社保个人部分
  deferredHousingEmp  Float @default(0) // 递延到次月补扣的公积金个人部分
  deferredMinWage     Float @default(0) // 递延到次月补扣的最低工资补齐差额
  prevDeferredSocialEmp   Float @default(0) // 从上月继承的递延社保（本批次已补扣）
  prevDeferredHousingEmp  Float @default(0) // 从上月继承的递延公积金（本批次已补扣）
  prevDeferredMinWage     Float @default(0) // 从上月继承的递延最低工资（本批次已补扣）
  // 风险提示
  riskWarnings    Json?
  createdAt       DateTime @default(now())
@@ -784,7 +973,9 @@ model EmployeeSocialInsRecord {
  org          Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  employeeId   String
  employee     Employee   @relation(fields: [employeeId], references: [id], onDelete: Cascade)
-  city         String    @default("北京")  // 参保城市
+  accountId    String?  // 关联到 SocialAccount（迁移后非空）
  account      SocialAccount? @relation(fields: [accountId], references: [id])
  city         String    @default("北京")  // 参保城市（兼容旧数据，从 account.city 派生）
  startMonth   String   // 开始缴费年月 YYYY-MM
  endMonth     String?  // 截止缴费年月 YYYY-MM（null=至今有效）
  base         Float    // 缴费基数
@@ -797,6 +988,7 @@ model EmployeeSocialInsRecord {
  @@index([orgId, employeeId])
  @@index([employeeId, startMonth, endMonth])
  @@index([orgId, city])
  @@index([accountId])
 }
 model EmployeeHousingFundRecord {
@@ -805,7 +997,9 @@ model EmployeeHousingFundRecord {
  org          Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  employeeId   String
  employee     Employee   @relation(fields: [employeeId], references: [id], onDelete: Cascade)
-  city         String    @default("北京")  // 参保城市
+  accountId    String?  // 关联到 SocialAccount（迁移后非空）
  account      SocialAccount? @relation(fields: [accountId], references: [id])
  city         String    @default("北京")  // 参保城市（兼容旧数据）
  startMonth   String   // 开始缴费年月 YYYY-MM
  endMonth     String?  // 截止缴费年月 YYYY-MM（null=至今有效）
  base         Float    // 缴费基数
@@ -817,6 +1011,7 @@ model EmployeeHousingFundRecord {
  @@index([orgId, employeeId])
  @@index([employeeId, startMonth, endMonth])
  @@index([accountId])
 }
 /// 月度社保/公积金办理记录（标记某月已办理完成，保存快照）
@@ -824,6 +1019,8 @@ model SocialMonthlyProcess {
  id           String   @id @default(cuid())
  orgId        String
  org          Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  accountId    String?  // 关联到账户（迁移后非空）
  account      SocialAccount? @relation(fields: [accountId], references: [id])
  month        String   // 办理月份 YYYY-MM
  type         String   // SOCIAL=社保, HOUSING=公积金
  status       String   @default("COMPLETED") // COMPLETED=已办理
@@ -835,6 +1032,7 @@ model SocialMonthlyProcess {
  @@unique([orgId, month, type])
  @@index([orgId, month])
  @@index([accountId, month])
 }
 model EmployeeDepartmentRecord {
@@ -845,10 +1043,12 @@ model EmployeeDepartmentRecord {
  employee     Employee   @relation(fields: [employeeId], references: [id], onDelete: Cascade)
  oldDepartment String  // 调整前部门
  newDepartment String  // 调整后部门
  oldPosition  String?  // 调整前职务
  newPosition  String?  // 调整后职务
  effectiveMonth String // 生效年月 YYYY-MM
  endMonth     String?  // 失效年月 YYYY-MM（null=至今有效）
-  reason       String?  // 调部门原因
+  reason       String?  // 调动原因
-  changeType   String   // ONBOARDING=入职, REHIRE=重新入职, TRANSFER=调部门
+  changeType   String   // ONBOARDING=入职, REHIRE=重新入职, TRANSFER=调动
  createdBy    String
  createdAt    DateTime @default(now())
@@ -1364,3 +1564,286 @@ model AcceptanceTest {
  @@unique([orgId, verifierName])
  @@index([orgId, status])
 }
 // ========== 商业保险 ==========
 model CommercialInsurancePlan {
  id              String   @id @default(cuid())
  orgId           String
  org             Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  name            String
  type            String   // ACCIDENT | SUPPLEMENTARY_MEDICAL | EMPLOYER_LIABILITY | CRITICAL_ILLNESS | GROUP_LIFE | OTHER
  provider        String   // 保险公司
  policyNo        String?
  premium         Float    // 年保费
  coverageAmount  Float    // 保额
  effectiveFrom   String   // YYYY-MM-DD
  effectiveTo     String?  // null = 长期
  description     String?
  status          String   @default("ACTIVE") // ACTIVE | EXPIRED | CANCELLED
  enrollments     CommercialInsuranceEnrollment[]
  createdBy       String
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt
  @@index([orgId, status])
  @@index([orgId, type])
 }
 model CommercialInsuranceEnrollment {
  id              String   @id @default(cuid())
  orgId           String
  org             Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  planId          String
  plan            CommercialInsurancePlan @relation(fields: [planId], references: [id], onDelete: Cascade)
  employeeId      String
  employee        Employee @relation(fields: [employeeId], references: [id], onDelete: Cascade)
  premium         Float    // 个人保费
  effectiveFrom   String   // YYYY-MM-DD
  effectiveTo     String?
  status          String   @default("ACTIVE") // ACTIVE | TERMINATED
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt
  @@index([orgId, planId])
  @@index([employeeId])
 }
 // ========== 员工福利 ==========
 model EmployeeBenefitPlan {
  id              String   @id @default(cuid())
  orgId           String
  org             Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  name            String
  category        String   // TRANSPORT | MEAL | HOUSING | COMMUNICATION | HEALTH_CHECK | HOLIDAY | BIRTHDAY | OTHER
  amount          Float    // 每月金额（或每次金额）
  frequency       String   @default("MONTHLY") // MONTHLY | QUARTERLY | YEARLY | ONE_TIME
  taxDeductible   Boolean  @default(false) // 是否税前扣除
  description     String?
  status          String   @default("ACTIVE")
  enrollments     EmployeeBenefitEnrollment[]
  createdBy       String
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt
  @@index([orgId, status])
  @@index([orgId, category])
 }
 model EmployeeBenefitEnrollment {
  id              String   @id @default(cuid())
  orgId           String
  org             Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  planId          String
  plan            EmployeeBenefitPlan @relation(fields: [planId], references: [id], onDelete: Cascade)
  employeeId      String
  employee        Employee @relation(fields: [employeeId], references: [id], onDelete: Cascade)
  effectiveFrom   String   // YYYY-MM
  effectiveTo     String?  // null = 至今
  amount          Float?   // 覆盖默认金额（个别调整）
  status          String   @default("ACTIVE")
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt
  @@index([orgId, planId])
  @@index([employeeId])
 }
 // ========== 电子签署（易签宝） ==========
 model ESignRecord {
  id              String   @id @default(cuid())
  orgId           String
  org             Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  contractId      String?  // 关联 LaborContract
  employeeId      String
  employee        Employee @relation(fields: [employeeId], references: [id], onDelete: Cascade)
  scene           String   @default("CONTRACT") // CONTRACT | RESIGNATION | POLICY | PAYSLIP | ONBOARDING
  signMethod      String   @default("ELECTRONIC") // ELECTRONIC=电子签署 | PAPER=线下手签
  flowId          String?  // 易签宝流程ID
  documentTitle   String   // 文件标题
  documentContent String?  // 文件内容（HTML/PDF base64）
  status          String   @default("PENDING") // PENDING | SIGNING | COMPLETED | REJECTED | EXPIRED | CANCELLED
  signUrl         String?  // 签署链接
  signedPdfUrl    String?  // 签署完成后的PDF链接
  initiatedBy     String   // 发起人（HR用户ID）
  completedAt     DateTime?
  expiredAt       DateTime?
  callbackData    Json?    // 易签宝回调数据 / 线下手签证据
  remark          String?
  createdBy       String
  createdAt       DateTime @default(now())
  updatedAt       DateTime @updatedAt
  // 线下手签专用字段
  signedAt        DateTime? // 线下签署日期
  signedLocation  String?   // 签署地点
  witnessName     String?   // 见证人姓名
  witnessPhone    String?   // 见证人手机号
  scanFileUrls    Json?     // 线下签署扫描件URL列表 [{name, url}]
  @@index([orgId, status])
  @@index([employeeId])
  @@index([contractId])
 }
 // ==================== 组织架构 + 审批流 ====================
 /// 部门（树形结构，自引用 parent）
 model Department {
  id          String       @id @default(cuid())
  orgId       String
  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  name        String
  parentId    String?
  parent      Department?  @relation("DeptChildren", fields: [parentId], references: [id], onDelete: SetNull)
  children    Department[] @relation("DeptChildren")
  level       Int          @default(0)   // 层级（0=根）
  sortOrder   Int          @default(0)   // 同级排序
  description String?
  // 社保公积金账户关联（员工通过部门继承账户）
  socialAccountId    String?  // 社保账户
  socialAccount      SocialAccount? @relation("DeptSocialAccount", fields: [socialAccountId], references: [id], onDelete: SetNull)
  housingAccountId   String?  // 公积金账户
  housingAccount     SocialAccount? @relation("DeptHousingAccount", fields: [housingAccountId], references: [id], onDelete: SetNull)
  createdBy   String
  createdAt   DateTime     @default(now())
  updatedAt   DateTime     @updatedAt
  employees   Employee[]   @relation("DeptEmployees")
  positions   Position[]
  @@unique([orgId, name, parentId])
  @@index([orgId, parentId])
 }
 /// 岗位字典
 model Position {
  id           String       @id @default(cuid())
  orgId        String
  org          Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  name         String
  departmentId String?
  department   Department?  @relation(fields: [departmentId], references: [id], onDelete: SetNull)
  headcount    Int          @default(0)   // 编制人数
  level        String?                     // 职级（如 P1/P2/M1）
  description  String?
  createdBy    String
  createdAt    DateTime     @default(now())
  updatedAt    DateTime     @updatedAt
  @@unique([orgId, name, departmentId])
  @@index([orgId, departmentId])
 }
 /// 审批流配置
 model ApprovalFlow {
  id          String       @id @default(cuid())
  orgId       String
  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  type        String       // LEAVE / TERMINATION / SALARY_CHANGE / OTHER
  name        String
  enabled     Boolean      @default(true)
  // 步骤配置 JSON: [{ step: 1, approverType: 'SUPERVISOR' | 'PERSON', approverId?: string, name: string }]
  steps       Json
  createdBy   String
  createdAt   DateTime     @default(now())
  updatedAt   DateTime     @updatedAt
  instances   ApprovalInstance[]
  @@unique([orgId, type])
  @@index([orgId])
 }
 /// 审批实例
 model ApprovalInstance {
  id          String       @id @default(cuid())
  orgId       String
  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  flowId      String
  flow        ApprovalFlow @relation(fields: [flowId], references: [id], onDelete: Cascade)
  type        String       // 冗余 flow.type，便于查询
  bizId       String?      // 关联业务记录ID（如 LeaveRequest.id）
  bizType     String?      // 业务类型
  status      String       @default("PENDING") // PENDING / APPROVED / REJECTED / CANCELLED
  currentStep Int          @default(1)
  // 审批记录 JSON: [{ step, approverId, approverName, result, comment, timestamp }]
  approvals   Json         @default("[]")
  employeeId  String?
  employee    Employee?    @relation(fields: [employeeId], references: [id], onDelete: SetNull)
  createdBy   String
  createdAt   DateTime     @default(now())
  updatedAt   DateTime     @updatedAt
  @@index([orgId, status])
  @@index([employeeId])
  @@index([bizId])
 }
 // ==================== 客服工作台 ====================
 /// 工单
 model Ticket {
  id          String       @id @default(cuid())
  orgId       String       // 提交方租户
  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  title       String
  content     String
  category    String?      // 分类（如：系统bug/功能咨询/数据问题）
  priority    String       @default("NORMAL") // LOW / NORMAL / HIGH / URGENT
  status      String       @default("OPEN") // OPEN / IN_PROGRESS / RESOLVED / CLOSED
  assigneeId  String?      // 客服处理人 userId
  createdBy   String       // 提交人 userId
  createdAt   DateTime     @default(now())
  updatedAt   DateTime     @updatedAt
  messages    TicketMessage[]
  @@index([orgId, status])
  @@index([assigneeId])
 }
 /// 工单回复
 model TicketMessage {
  id          String       @id @default(cuid())
  ticketId    String
  ticket      Ticket       @relation(fields: [ticketId], references: [id], onDelete: Cascade)
  content     String
  senderId    String
  senderRole  String       // USER / SUPPORT
  createdAt   DateTime     @default(now())
  @@index([ticketId])
 }
 /// 客服-客户会话
 model ChatSession {
  id          String       @id @default(cuid())
  orgId       String       // 客户租户
  org         Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
  supportUserId String     // 客服 userId
  lastMessage String?
  lastMessageAt DateTime?
  unreadByUser   Int       @default(0)
  unreadBySupport Int      @default(0)
  createdAt   DateTime     @default(now())
  updatedAt   DateTime     @updatedAt
  messages    ChatMessage[]
  @@unique([orgId, supportUserId])
  @@index([supportUserId])
 }
 /// 会话消息
 model ChatMessage {
  id          String       @id @default(cuid())
  sessionId   String
  session     ChatSession  @relation(fields: [sessionId], references: [id], onDelete: Cascade)
  content     String
  senderId    String
  senderRole  String       // USER / SUPPORT
  read        Boolean      @default(false)
  createdAt   DateTime     @default(now())
  @@index([sessionId])
 }
@@ -49,7 +49,7 @@ interface OrgConfig {
  adminName: string
  contactName: string
  contactPhone: string
-  payrollFrequency: number
+  payrollDays: number[]
  retirementReminderEnabled: boolean
  socialConfig: {
    city: string
@@ -89,7 +89,7 @@ const ORGS: OrgConfig[] = [
    adminName: '王建国',
    contactName: '王建国',
    contactPhone: '13800000010',
-    payrollFrequency: 1,
+    payrollDays: [10],
    retirementReminderEnabled: true,
    socialConfig: {
      city: '北京',
@@ -122,7 +122,7 @@ const ORGS: OrgConfig[] = [
    adminName: '李明华',
    contactName: '李明华',
    contactPhone: '13800000020',
-    payrollFrequency: 2,
+    payrollDays: [5, 20],
    retirementReminderEnabled: true,
    socialConfig: {
      city: '深圳',
@@ -157,7 +157,7 @@ const ORGS: OrgConfig[] = [
    adminName: '赵雪梅',
    contactName: '赵雪梅',
    contactPhone: '13800000030',
-    payrollFrequency: 1,
+    payrollDays: [10],
    retirementReminderEnabled: false,
    socialConfig: {
      city: '杭州',
@@ -213,7 +213,7 @@ async function createOrg(orgConfig: OrgConfig) {
      city: orgConfig.city,
      contactName: orgConfig.contactName,
      contactPhone: orgConfig.contactPhone,
-      payrollFrequency: orgConfig.payrollFrequency,
+      payrollDays: orgConfig.payrollDays,
      retirementReminderEnabled: orgConfig.retirementReminderEnabled,
    },
  })
@@ -399,6 +399,112 @@ async function createOrg(orgConfig: OrgConfig) {
    }
  }
  console.log(`  ✅ 历史工资条已生成`)
  // 10. 生成培训记录
  console.log(`  📝 生成培训记录...`)
  const trainingTopics = [
    { topic: '新员工入职培训', content: '公司文化、规章制度、安全规范', trainer: '张经理', duration: 4 },
    { topic: '岗位技能培训', content: '岗位操作规范与流程', trainer: '李主管', duration: 6 },
    { topic: '安全生产培训', content: '安全生产法规与操作规程', trainer: '王安全', duration: 3 },
    { topic: '团队协作培训', content: '沟通技巧与团队建设', trainer: '刘讲师', duration: 2 },
  ]
  for (let i = 0; i < allEmployees.length; i++) {
    const emp = allEmployees[i]
    const t = trainingTopics[i % trainingTopics.length]
    const trainDate = new Date(2026, (i % 6), 15)
    const ackStatus = i % 3 === 0 ? 'PENDING' : i % 3 === 1 ? 'SIGNED' : 'REFUSED'
    await prisma.trainingRecord.create({
      data: {
        orgId: org.id,
        employeeId: emp.id,
        trainingDate: trainDate,
        topic: t.topic,
        content: t.content,
        trainer: t.trainer,
        duration: t.duration,
        ackStatus: ackStatus as any,
        ackDate: ackStatus === 'SIGNED' ? new Date(trainDate.getTime() + 86400000) : null,
        createdBy: admin.id,
      },
    })
  }
  console.log(`  ✅ 培训记录已生成 (${allEmployees.length}条)`)
  // 11. 生成绩效记录
  console.log(`  📊 生成绩效记录...`)
  const perfResults = ['EXCELLENT', 'QUALIFIED', 'QUALIFIED', 'NEED_IMPROVE', 'UNQUALIFIED'] as const
  const perfGrades = ['A', 'B', 'B', 'C', 'D']
  for (let i = 0; i < allEmployees.length; i++) {
    const emp = allEmployees[i]
    const idx = i % perfResults.length
    const score = 95 - idx * 12
    await prisma.performanceRecord.create({
      data: {
        orgId: org.id,
        employeeId: emp.id,
        period: '2026-Q1',
        score,
        grade: perfGrades[idx],
        result: perfResults[idx] as any,
        summary: idx < 2 ? '工作表现优秀，完成任务质量高' : idx < 4 ? '基本完成工作目标，有待提升' : '未达到岗位要求，需制定改进计划',
        improvementPlan: idx >= 3 ? '加强技能培训，设定阶段性目标' : null,
        reviewer: admin.name,
        employeeAck: i % 2 === 0,
        createdBy: admin.id,
      },
    })
    // 部分员工有Q2绩效
    if (i % 2 === 0) {
      await prisma.performanceRecord.create({
        data: {
          orgId: org.id,
          employeeId: emp.id,
          period: '2026-Q2',
          score: score - 5,
          grade: perfGrades[Math.min(idx + 1, 4)],
          result: perfResults[Math.min(idx + 1, 4)] as any,
          summary: '二季度绩效评估',
          reviewer: admin.name,
          employeeAck: false,
          createdBy: admin.id,
        },
      })
    }
  }
  console.log(`  ✅ 绩效记录已生成 (${allEmployees.length}条)`)
  // 12. 生成违纪记录（部分员工）
  console.log(`  ⚠️ 生成违纪记录...`)
  const discTypes = ['LATE', 'ABSENT', 'INSUBORDINATION', 'MISCONDUCT'] as const
  const discDescriptions = [
    '月内累计迟到3次，超过公司允许范围',
    '未经请假擅自缺勤1天',
    '不服从主管工作安排，拒绝执行合理指令',
    '违反公司安全操作规程，未佩戴防护设备',
  ]
  const discActions = ['ORAL_WARNING', 'WRITTEN_WARNING', 'DEDUCTION', 'WRITTEN_WARNING'] as const
  for (let i = 0; i < Math.min(allEmployees.length, 4); i++) {
    const emp = allEmployees[i]
    const violationDate = new Date(2026, i % 6, 10)
    await prisma.disciplinaryRecord.create({
      data: {
        orgId: org.id,
        employeeId: emp.id,
        violationDate,
        violationType: discTypes[i],
        description: discDescriptions[i],
        severity: i < 2 ? 'WARNING' : 'SERIOUS',
        action: discActions[i],
        actionDetail: i === 2 ? '扣除当日工资' : '',
        employeeAck: i % 2 === 0,
        ackDate: i % 2 === 0 ? new Date(violationDate.getTime() + 86400000) : null,
        ackMethod: i % 2 === 0 ? 'SIGN' : null,
        witness: i >= 2 ? '部门主管' : null,
        createdBy: admin.id,
      },
    })
  }
  console.log(`  ✅ 违纪记录已生成 (${Math.min(allEmployees.length, 4)}条)`)
 }
 // ========== 主函数 ==========
@@ -78,7 +78,7 @@ async function main() {
      plan: 'PRO',
      maxEmployees: 50,
      city: '上海',
-      payrollFrequency: 1,
+      payrollDays: [10],
    },
  })
  console.log('企业已创建:', org.name)
@@ -0,0 +1,154 @@
 /**
 * 给全部员工对应上正确的社保和公积金账户
 * 逻辑：按员工所在城市的账户匹配，回退到默认账户
 */
 import { PrismaClient } from '@prisma/client'
 const prisma = new PrismaClient()
 async function main() {
  // 1. 查所有账户（按城市分组）
  const accounts = await prisma.socialAccount.findMany({
    select: { id: true, name: true, type: true, city: true, isDefault: true },
  })
  console.log('=== 全部账户 ===')
  for (const a of accounts) {
    console.log(`${a.type} | ${a.name} | ${a.city} | default=${a.isDefault} | ${a.id}`)
  }
  // 按城市+类型建索引
  const socialByCity: Record<string, string> = {}
  const housingByCity: Record<string, string> = {}
  let defaultSocial: string | null = null
  let defaultHousing: string | null = null
  for (const a of accounts) {
    if (a.type === 'SOCIAL') {
      if (a.isDefault) defaultSocial = a.id
      if (a.city) socialByCity[a.city] = a.id
    } else {
      if (a.isDefault) defaultHousing = a.id
      if (a.city) housingByCity[a.city] = a.id
    }
  }
  // 2. 查所有部门
  const depts = await prisma.department.findMany({
    select: { id: true, name: true, level: true, parentId: true, socialAccountId: true, housingAccountId: true },
  })
  console.log('\n=== 部门账户关联（修改前）===')
  for (const d of depts) {
    console.log(`${d.name} | level=${d.level} | social=${d.socialAccountId || '无'} | housing=${d.housingAccountId || '无'}`)
  }
  // 3. 查所有员工及其部门和城市
  const employees = await prisma.employee.findMany({
    select: { id: true, name: true, department: true, departmentId: true, city: true, dept: true },
  })
  console.log(`\n=== 员工总数: ${employees.length} ===`)
  // 4. 为每个员工找到根部门，检查是否有账户
  // 如果根部门没有账户，按员工城市匹配账户，更新根部门
  const rootDeptMap = new Map<string, { name: string; city: string; empCount: number }>()
  for (const emp of employees) {
    // 向上找根部门
    let dept: any = emp.dept
    if (!dept && emp.departmentId) {
      dept = await prisma.department.findUnique({ where: { id: emp.departmentId } })
    }
    while (dept && dept.level > 0 && dept.parentId) {
      dept = await prisma.department.findUnique({ where: { id: dept.parentId } })
    }
    if (dept) {
      const existing = rootDeptMap.get(dept.id)
      if (existing) {
        existing.empCount++
      } else {
        rootDeptMap.set(dept.id, { name: dept.name, city: emp.city || '', empCount: 1 })
      }
    }
  }
  console.log('\n=== 根部门及员工城市 ===')
  for (const [deptId, info] of rootDeptMap) {
    const dept = await prisma.department.findUnique({ where: { id: deptId }, select: { socialAccountId: true, housingAccountId: true } })
    console.log(`${info.name} | 员工数=${info.empCount} | 员工城市=${info.city || '无'} | social=${dept?.socialAccountId || '无'} | housing=${dept?.housingAccountId || '无'}`)
  }
  // 5. 为没有账户的根部门按员工城市匹配账户
  let updated = 0
  for (const [deptId, info] of rootDeptMap) {
    const dept = await prisma.department.findUnique({ where: { id: deptId }, select: { socialAccountId: true, housingAccountId: true, name: true } })
    let socialId = dept?.socialAccountId || null
    let housingId = dept?.housingAccountId || null
    // 社保账户
    if (!socialId) {
      if (info.city && socialByCity[info.city]) {
        socialId = socialByCity[info.city]
      } else if (defaultSocial) {
        socialId = defaultSocial
      }
    }
    // 公积金账户
    if (!housingId) {
      if (info.city && housingByCity[info.city]) {
        housingId = housingByCity[info.city]
      } else if (defaultHousing) {
        housingId = defaultHousing
      }
    }
    if ((socialId && !dept?.socialAccountId) || (housingId && !dept?.housingAccountId)) {
      await prisma.department.update({
        where: { id: deptId },
        data: {
          ...(socialId && !dept?.socialAccountId ? { socialAccountId: socialId } : {}),
          ...(housingId && !dept?.housingAccountId ? { housingAccountId: housingId } : {}),
        },
      })
      console.log(`[更新] 根部门 ${dept?.name} → social=${socialId || '无'} housing=${housingId || '无'}`)
      updated++
    }
  }
  console.log(`\n更新了 ${updated} 个根部门的账户关联`)
  // 6. 验证：重新查每个员工是否有账户
  let noSocial = 0
  let noHousing = 0
  let hasBoth = 0
  for (const emp of employees) {
    let dept: any = emp.dept
    if (!dept && emp.departmentId) {
      dept = await prisma.department.findUnique({ where: { id: emp.departmentId } })
    }
    while (dept && dept.level > 0 && dept.parentId) {
      dept = await prisma.department.findUnique({ where: { id: dept.parentId } })
    }
    let socialId = dept?.socialAccountId || null
    let housingId = dept?.housingAccountId || null
    // 回退到默认
    if (!socialId) socialId = defaultSocial
    if (!housingId) housingId = defaultHousing
    if (socialId && housingId) {
      hasBoth++
    } else {
      if (!socialId) noSocial++
      if (!housingId) noHousing++
      console.log(`[缺失] ${emp.name} | social=${socialId ? '有' : '无'} housing=${housingId ? '有' : '无'} | city=${emp.city || '无'} | dept=${dept?.name || '无'}`)
    }
  }
  console.log(`\n=== 验证结果 ===`)
  console.log(`有社保+公积金: ${hasBoth}`)
  console.log(`缺社保: ${noSocial}`)
  console.log(`缺公积金: ${noHousing}`)
 }
 main().then(() => process.exit(0)).catch(e => { console.error(e); process.exit(1) })
@@ -0,0 +1,10 @@
 import { PrismaClient } from '@prisma/client'
 const prisma = new PrismaClient()
 async function main() {
  const accounts = await prisma.socialAccount.findMany({ where: { type: 'SOCIAL', city: '北京' }, select: { id: true, name: true } })
  for (const a of accounts) {
    const std = await prisma.socialYearStandard.findFirst({ where: { accountId: a.id, isCurrent: true }, select: { medicalOrgExtra: true, medicalEmpExtra: true, extraInsurances: true, effectiveFrom: true } })
    console.log(a.name + ' | effective=' + std?.effectiveFrom + ' | medicalOrgExtra=' + std?.medicalOrgExtra + ' | medicalEmpExtra=' + std?.medicalEmpExtra + ' | extraInsurances=' + JSON.stringify(std?.extraInsurances))
  }
 }
 main().then(() => process.exit(0))
@@ -0,0 +1,80 @@
 /**
 * 检查测试账户是否有关联数据（员工/部门），然后删除无关联的测试账户
 */
 import { PrismaClient } from '@prisma/client'
 const prisma = new PrismaClient()
 const TEST_IDS = [
  'cmsve0ucj000h5kfta5te1qli', // 几何社保账户
  'cmsve0uea001x5kftbvf9e6zq', // 北公积金账户
  'cmsve0uec001z5kft5sfl4ika', // s公积金账户
  'cmsve0ued00215kft32gmeug5', // sh公积金账户
  'cmsve0uef00235kftz4clk842', // sha公积金账户
  'cmsve0ueg00255kfttwtfeikj', // shan公积金账户
  'cmsve0uei00275kftbwdrkf2n', // shang公积金账户
  'cmsve0uej00295kftc157ts8b', // 上公积金账户
  'cmsve0uek002b5kftnmmsqpfl', // shi公积金账户
  'cmsve0uen002d5kftnzstcqa3', // shi'j公积金账户
  'cmsve0ueo002f5kftxhh9r5lw', // shi'ji公积金账户
  'cmsve0ueq002h5kft2fdu2tlk', // shi'jia公积金账户
  'cmsve0uer002j5kftsi37wcuo', // shi'jia'z公积金账户
  'cmsve0uet002l5kftev27qy7o', // shi'jia'zh公积金账户
  'cmsve0uf5002x5kft16esy662', // 唐山12+6公积金账户
  'cmsve0uf9002z5kft3lx7yl1x', // 几何公积金账户
  'cmsve0ufb00315kftp9mnovag', // 几何5+5公积金账户
 ]
 async function main() {
  console.log('=== 检查关联 ===')
  let canDelete: string[] = []
  let blocked: string[] = []
  for (const id of TEST_IDS) {
    const account = await prisma.socialAccount.findUnique({ where: { id }, select: { name: true, city: true, type: true } })
    if (!account) {
      console.log(`[不存在] ${id}`)
      continue
    }
    const d1 = await prisma.department.count({ where: { socialAccountId: id } })
    const d2 = await prisma.department.count({ where: { housingAccountId: id } })
    if (d1 + d2 > 0) {
      console.log(`[阻止] ${account.type} ${account.name} (${account.city}) — 部门S/H:${d1}/${d2}`)
      blocked.push(id)
    } else {
      console.log(`[可删] ${account.type} ${account.name} (${account.city})`)
      canDelete.push(id)
    }
  }
  console.log(`\n可删除 ${canDelete.length} 个，阻止 ${blocked.length} 个`)
  if (canDelete.length === 0) {
    console.log('无可删除账户')
    return
  }
  // 删除：先删关联的年度标准、社保记录、公积金记录，再删账户
  console.log('\n=== 开始删除 ===')
  for (const id of canDelete) {
    const account = await prisma.socialAccount.findUnique({ where: { id }, select: { name: true } })
    // 删年度标准
    const stdDeleted = await prisma.socialYearStandard.deleteMany({ where: { accountId: id } })
    // 删员工社保记录
    const srDeleted = await prisma.employeeSocialInsRecord.deleteMany({ where: { accountId: id } })
    // 删员工公积金记录
    const hrDeleted = await prisma.employeeHousingFundRecord.deleteMany({ where: { accountId: id } })
    // 删月度处理记录
    const mpDeleted = await prisma.socialMonthlyProcess.deleteMany({ where: { accountId: id } })
    // 删账户
    await prisma.socialAccount.delete({ where: { id } })
    console.log(`[已删] ${account?.name} — 标准:${stdDeleted.count} 社保记录:${srDeleted.count} 公积金记录:${hrDeleted.count} 月度:${mpDeleted.count}`)
  }
  console.log('\n删除完成')
 }
 main().then(() => process.exit(0)).catch(e => { console.error(e); process.exit(1) })
@@ -0,0 +1,47 @@
 /**
 * 批量更新公积金账户的 housingBaseMin/housingBaseMax
 * 数据来源：各城市2025年度公积金缴存基数上下限
 */
 import { PrismaClient } from '@prisma/client'
 const prisma = new PrismaClient()
 // 2025年度各城市公积金基数上下限
 const CITY_LIMITS: Record<string, { min: number; max: number }> = {
  '北京': { min: 2540, max: 35811 },
  '上海': { min: 2690, max: 37302 },
  '深圳': { min: 2360, max: 44265 },
  '杭州': { min: 2490, max: 40694 },
  '石家庄': { min: 2200, max: 26420 },
  '天津': { min: 2320, max: 27861 },
  '唐山': { min: 2200, max: 26420 },  // 河北省标准
 }
 async function main() {
  const accounts = await prisma.socialAccount.findMany({ where: { type: 'HOUSING' } })
  let updated = 0
  let skipped = 0
  for (const account of accounts) {
    const limits = CITY_LIMITS[account.city]
    if (!limits) {
      console.log(`[跳过] ${account.name} (${account.city}) — 无该城市的公积金上下限数据`)
      skipped++
      continue
    }
    // 更新该账户下所有年度标准的 housingBaseMin/housingBaseMax
    const result = await prisma.socialYearStandard.updateMany({
      where: { accountId: account.id },
      data: {
        housingBaseMin: limits.min,
        housingBaseMax: limits.max,
      },
    })
    console.log(`[更新] ${account.name} (${account.city}) → 下限 ${limits.min} / 上限 ${limits.max}，影响 ${result.count} 条标准`)
    updated++
  }
  console.log(`\n完成：更新 ${updated} 个账户，跳过 ${skipped} 个`)
 }
 main().then(() => process.exit(0)).catch(e => { console.error(e); process.exit(1) })
@@ -0,0 +1,25 @@
 /**
 * 更新北京社保账户的大病医疗个人附加（3元/月）
 */
 import { PrismaClient } from '@prisma/client'
 const prisma = new PrismaClient()
 async function main() {
  // 北京社保账户：医疗个人附加3元（大病医疗）
  const beijingSocial = await prisma.socialAccount.findMany({ where: { type: 'SOCIAL', city: '北京' }, select: { id: true, name: true } })
  for (const a of beijingSocial) {
    const result = await prisma.socialYearStandard.updateMany({
      where: { accountId: a.id, isCurrent: true },
      data: { medicalEmpExtra: 3 },
    })
    console.log(`[更新] ${a.name} → medicalEmpExtra=3，影响 ${result.count} 条`)
  }
  // 验证
  for (const a of beijingSocial) {
    const std = await prisma.socialYearStandard.findFirst({ where: { accountId: a.id, isCurrent: true }, select: { medicalEmpExtra: true, effectiveFrom: true } })
    console.log(`[验证] ${a.name} | effective=${std?.effectiveFrom} | medicalEmpExtra=${std?.medicalEmpExtra}`)
  }
 }
 main().then(() => process.exit(0)).catch(e => { console.error(e); process.exit(1) })
@@ -0,0 +1,99 @@
 /**
 * 批量补齐无年度标准的账户：从旧 SocialInsuranceConfig / HousingFundConfig 继承数据
 */
 import { PrismaClient } from '@prisma/client'
 const prisma = new PrismaClient()
 async function main() {
  const accounts = await prisma.socialAccount.findMany()
  let created = 0
  let skipped = 0
  for (const account of accounts) {
    // 检查是否已有标准
    const existing = await prisma.socialYearStandard.findFirst({
      where: { accountId: account.id, isCurrent: true },
    })
    if (existing) {
      skipped++
      continue
    }
    // 查旧配置
    let oldConfig: any = null
    if (account.type === 'HOUSING') {
      oldConfig = await prisma.housingFundConfig.findFirst({
        where: { orgId: account.orgId, city: account.city },
        orderBy: { effectiveFrom: 'desc' },
      })
    } else {
      oldConfig = await prisma.socialInsuranceConfig.findFirst({
        where: { orgId: account.orgId, city: account.city },
        orderBy: { effectiveFrom: 'desc' },
      })
    }
    if (!oldConfig) {
      console.log(`[跳过] ${account.type} ${account.name} (${account.city}) — 无旧配置可继承`)
      continue
    }
    // 检查是否已有同 effectiveFrom 的标准（含历史标准）
    const dupCheck = await prisma.socialYearStandard.findFirst({
      where: { accountId: account.id, effectiveFrom: oldConfig.effectiveFrom },
    })
    if (dupCheck) {
      // 把已有的设为 current
      await prisma.socialYearStandard.updateMany({
        where: { accountId: account.id, effectiveFrom: oldConfig.effectiveFrom },
        data: { isCurrent: true },
      })
      console.log(`[修复] ${account.type} ${account.name} (${account.city}) — 已有标准设为 current`)
      created++
      continue
    }
    // 创建年度标准
    const std = await prisma.socialYearStandard.create({
      data: {
        orgId: account.orgId,
        accountId: account.id,
        // 社保比例
        pensionOrg: oldConfig.pensionOrg || 16,
        pensionEmp: oldConfig.pensionEmp || 8,
        medicalOrg: oldConfig.medicalOrg || 9.8,
        medicalEmp: oldConfig.medicalEmp || 2,
        medicalOrgExtra: (oldConfig as any).medicalOrgExtra || 0,
        medicalEmpExtra: (oldConfig as any).medicalEmpExtra || 0,
        unemploymentOrg: oldConfig.unemploymentOrg || 0.5,
        unemploymentEmp: oldConfig.unemploymentEmp || 0.5,
        injuryOrg: oldConfig.injuryOrg || 0.2,
        maternityOrg: oldConfig.maternityOrg || 0.8,
        baseMin: oldConfig.baseMin || 6326,
        baseMax: oldConfig.baseMax || 33891,
        medicalBaseMin: oldConfig.medicalBaseMin || 0,
        medicalBaseMax: oldConfig.medicalBaseMax || 0,
        extraInsurances: oldConfig.extraInsurances || null,
        // 公积金比例
        housingOrg: (oldConfig as any).housingOrg || 12,
        housingEmp: (oldConfig as any).housingEmp || 12,
        housingBaseMin: 0,
        housingBaseMax: 0,
        // 最低工资
        minWage: (oldConfig as any).minWage || 0,
        // 生效信息
        effectiveFrom: oldConfig.effectiveFrom,
        effectiveTo: null,
        isCurrent: true,
        adjustmentDone: false,
        createdBy: account.createdBy,
      },
    })
    console.log(`[创建] ${account.type} ${account.name} (${account.city}) ← ${oldConfig.effectiveFrom}`)
    created++
  }
  console.log(`\n完成：创建 ${created} 个标准，跳过 ${skipped} 个已有标准`)
 }
 main().then(() => process.exit(0)).catch(e => { console.error(e); process.exit(1) })
@@ -0,0 +1,199 @@
 /**
 * 社保公积金账户化迁移脚本
 * 将旧 SocialInsuranceConfig / HousingFundConfig 迁移到 SocialAccount + SocialYearStandard
 * 将员工参保记录的 city 关联到 accountId
 *
 * 用法: npx tsx scripts/migrate-social-accounts.ts
 */
 import prisma from '../src/lib/prisma'
 async function main() {
  console.log('========== 社保公积金账户化迁移 ==========')
  // ========== 1. 迁移社保配置 → 社保账户 + 年度标准 ==========
  console.log('[1/6] 迁移社保配置...')
  // 按 (orgId, city) 分组创建社保账户
  const socialConfigs = await prisma.socialInsuranceConfig.findMany()
  const socialAccountMap = new Map<string, string>() // key: orgId:city → accountId
  for (const config of socialConfigs) {
    const key = `${config.orgId}:${config.city}`
    if (socialAccountMap.has(key)) continue
    const account = await prisma.socialAccount.create({
      data: {
        orgId: config.orgId,
        type: 'SOCIAL',
        name: `${config.city}社保账户`,
        city: config.city,
        isDefault: true,
        status: 'ACTIVE',
        createdBy: 'migration',
      },
    })
    socialAccountMap.set(key, account.id)
    console.log(`  创建社保账户: ${config.city} → ${account.id}`)
  }
  // 迁移每条 Config → YearStandard
  for (const config of socialConfigs) {
    const key = `${config.orgId}:${config.city}`
    const accountId = socialAccountMap.get(key)!
    await prisma.socialYearStandard.create({
      data: {
        orgId: config.orgId,
        accountId,
        pensionOrg: config.pensionOrg,
        pensionEmp: config.pensionEmp,
        medicalOrg: config.medicalOrg,
        medicalEmp: config.medicalEmp,
        unemploymentOrg: config.unemploymentOrg,
        unemploymentEmp: config.unemploymentEmp,
        injuryOrg: config.injuryOrg,
        maternityOrg: config.maternityOrg,
        baseMin: config.baseMin,
        baseMax: config.baseMax,
        medicalBaseMin: config.medicalBaseMin,
        medicalBaseMax: config.medicalBaseMax,
        extraInsurances: config.extraInsurances as any,
        effectiveFrom: config.effectiveFrom,
        effectiveTo: config.effectiveTo,
        isCurrent: config.isCurrent,
        adjustmentDone: config.adjustmentDone,
        createdBy: config.createdBy,
      },
    })
  }
  console.log(`  迁移 ${socialConfigs.length} 条社保年度标准`)
  // ========== 2. 迁移公积金配置 → 公积金账户 + 年度标准 ==========
  console.log('[2/6] 迁移公积金配置...')
  const housingConfigs = await prisma.housingFundConfig.findMany()
  const housingAccountMap = new Map<string, string>() // key: orgId:city:accountType → accountId
  for (const config of housingConfigs) {
    const accountType = config.accountType || 'BASIC'
    const key = `${config.orgId}:${config.city}:${accountType}`
    if (housingAccountMap.has(key)) continue
    const account = await prisma.socialAccount.create({
      data: {
        orgId: config.orgId,
        type: 'HOUSING',
        name: `${config.city}${accountType === 'SUPPLEMENTARY' ? '补充' : ''}公积金账户`,
        city: config.city,
        accountType,
        isDefault: accountType === 'BASIC',
        status: 'ACTIVE',
        createdBy: 'migration',
      },
    })
    housingAccountMap.set(key, account.id)
    console.log(`  创建公积金账户: ${config.city} ${accountType} → ${account.id}`)
  }
  for (const config of housingConfigs) {
    const accountType = config.accountType || 'BASIC'
    const key = `${config.orgId}:${config.city}:${accountType}`
    const accountId = housingAccountMap.get(key)!
    await prisma.socialYearStandard.create({
      data: {
        orgId: config.orgId,
        accountId,
        housingOrg: config.housingOrg,
        housingEmp: config.housingEmp,
        baseMin: config.baseMin,
        baseMax: config.baseMax,
        effectiveFrom: config.effectiveFrom,
        effectiveTo: config.effectiveTo,
        isCurrent: config.isCurrent,
        adjustmentDone: config.adjustmentDone,
        createdBy: config.createdBy,
      },
    })
  }
  console.log(`  迁移 ${housingConfigs.length} 条公积金年度标准`)
  // ========== 3. 迁移员工社保参保记录 accountId ==========
  console.log('[3/6] 迁移员工社保参保记录 accountId...')
  const socialRecords = await prisma.employeeSocialInsRecord.findMany({ where: { accountId: null } })
  let socialUpdated = 0
  for (const record of socialRecords) {
    const key = `${record.orgId}:${record.city}`
    const accountId = socialAccountMap.get(key)
    if (accountId) {
      await prisma.employeeSocialInsRecord.update({ where: { id: record.id }, data: { accountId } })
      socialUpdated++
    }
  }
  console.log(`  更新 ${socialUpdated}/${socialRecords.length} 条社保参保记录`)
  // ========== 4. 迁移员工公积金参保记录 accountId ==========
  console.log('[4/6] 迁移员工公积金参保记录 accountId...')
  const housingRecords = await prisma.employeeHousingFundRecord.findMany({ where: { accountId: null } })
  let housingUpdated = 0
  for (const record of housingRecords) {
    // 公积金默认用 BASIC 类型账户
    const key = `${record.orgId}:${record.city}:BASIC`
    const accountId = housingAccountMap.get(key)
    if (accountId) {
      await prisma.employeeHousingFundRecord.update({ where: { id: record.id }, data: { accountId } })
      housingUpdated++
    }
  }
  console.log(`  更新 ${housingUpdated}/${housingRecords.length} 条公积金参保记录`)
  // ========== 5. 迁移月度办理记录 accountId ==========
  console.log('[5/6] 迁移月度办理记录 accountId...')
  const monthlyProcesses = await prisma.socialMonthlyProcess.findMany({ where: { accountId: null } })
  let monthlyUpdated = 0
  for (const proc of monthlyProcesses) {
    const snapshot = proc.snapshot as any
    const city = snapshot?.city || snapshot?.configCity
    if (city) {
      const accountMap = proc.type === 'SOCIAL' ? socialAccountMap : housingAccountMap
      // 社保用 orgId:city，公积金用 orgId:city:BASIC
      const key = proc.type === 'SOCIAL' ? `${proc.orgId}:${city}` : `${proc.orgId}:${city}:BASIC`
      const accountId = accountMap.get(key)
      if (accountId) {
        await prisma.socialMonthlyProcess.update({ where: { id: proc.id }, data: { accountId } })
        monthlyUpdated++
      }
    }
  }
  console.log(`  更新 ${monthlyUpdated}/${monthlyProcesses.length} 条月度办理记录`)
  // ========== 6. 验证数据完整性 ==========
  console.log('[6/6] 验证数据完整性...')
  const accounts = await prisma.socialAccount.count()
  const standards = await prisma.socialYearStandard.count()
  const socialWithoutAccount = await prisma.employeeSocialInsRecord.count({ where: { accountId: null } })
  const housingWithoutAccount = await prisma.employeeHousingFundRecord.count({ where: { accountId: null } })
  console.log(`  账户总数: ${accounts}`)
  console.log(`  年度标准总数: ${standards}`)
  console.log(`  社保参保记录无 accountId: ${socialWithoutAccount}`)
  console.log(`  公积金参保记录无 accountId: ${housingWithoutAccount}`)
  if (socialWithoutAccount > 0 || housingWithoutAccount > 0) {
    console.log('  ⚠️  部分参保记录未关联账户（可能城市无对应配置），需手动处理')
  }
  console.log('')
  console.log('========== 迁移完成 ==========')
 }
 main()
  .catch((e) => {
    console.error('迁移失败:', e)
    process.exit(1)
  })
  .finally(async () => {
    await prisma.$disconnect()
  })
@@ -1,4 +1,5 @@
 import express from 'express'
 import path from 'path'
 import cors from 'cors'
 import helmet from 'helmet'
 import morgan from 'morgan'
@@ -23,8 +24,9 @@ app.use(compression({
 }))
 app.use(
  cors({
-    origin: process.env.CORS_ORIGIN || 'http://localhost:5173',
+    origin: true,
    credentials: true,
    exposedHeaders: ['Content-Disposition'],
  }),
 )
 app.use(express.json({ limit: '10mb' }))
@@ -34,6 +36,11 @@ app.get('/health', (_req, res) => {
  res.json({ success: true, data: { status: 'ok', timestamp: new Date().toISOString() } })
 })
 // deploy.sh 验证脚本检查 /api/v1/health
 app.get('/api/v1/health', (_req, res) => {
  res.json({ success: true, data: { status: 'ok', timestamp: new Date().toISOString() } })
 })
 app.use('/api/v1', apiLimiter)
 // 路由挂载
@@ -60,12 +67,20 @@ import auditRoutes from './routes/audit.routes'
 import calendarRoutes from './routes/calendar.routes'
 import platformRoutes from './routes/platform.routes'
 import workProcessRoutes from './routes/work-process.routes'
 import departmentRoutes from './routes/department.routes'
 import positionRoutes from './routes/position.routes'
 import approvalRoutes from './routes/approval.routes'
 import supportRoutes from './routes/support.routes'
 import enterpriseTemplateRoutes from './routes/enterprise-template.routes'
 import specialStatusRoutes from './routes/special-status.routes'
 import companyFileRoutes from './routes/company-file.routes'
 import acceptanceTestRoutes from './routes/acceptance-test.routes'
 import leaveRoutes from './routes/leave.routes'
 import salaryRoutes from './routes/salary.routes'
 import commercialInsuranceRoutes from './routes/commercial-insurance.routes'
 import benefitRoutes from './routes/benefit.routes'
 import esignRoutes from './routes/esign.routes'
 import commissionBonusRoutes from './routes/commission-bonus.routes'
 app.use('/api/v1/auth', authRoutes)
 app.use('/api/v1/dashboard', dashboardRoutes)
 app.use('/api/v1/employees', employeeRoutes)
@@ -89,12 +104,23 @@ app.use('/api/v1/audit', auditRoutes)
 app.use('/api/v1/calendar', calendarRoutes)
 app.use('/api/v1/platform', platformRoutes)
 app.use('/api/v1/work-processes', workProcessRoutes)
 app.use('/api/v1/departments', departmentRoutes)
 app.use('/api/v1/positions', positionRoutes)
 app.use('/api/v1/approvals', approvalRoutes)
 app.use('/api/v1/support', supportRoutes)
 app.use('/api/v1/enterprise-templates', enterpriseTemplateRoutes)
 app.use('/api/v1/special-statuses', specialStatusRoutes)
 app.use('/api/v1/company-files', companyFileRoutes)
 app.use('/api/v1/acceptance-tests', acceptanceTestRoutes)
 app.use('/api/v1/leaves', leaveRoutes)
 app.use('/api/v1/salary', salaryRoutes)
 app.use('/api/v1/commercial-insurance', commercialInsuranceRoutes)
 app.use('/api/v1/benefits', benefitRoutes)
 app.use('/api/v1/esign', esignRoutes)
 app.use('/api/v1/commission-bonus', commissionBonusRoutes)
 // 静态文件服务：上传的文件（入职文件、工会回执等）
 app.use('/uploads', express.static(path.join(process.cwd(), 'uploads')))
 app.use(errorHandler)
@@ -8,10 +8,15 @@ export interface AuthRequest extends Request {
 export function authMiddleware(req: AuthRequest, res: Response, next: NextFunction) {
  const authHeader = req.headers.authorization
-  if (!authHeader || !authHeader.startsWith('Bearer ')) {
+  let token: string | undefined
  if (authHeader && authHeader.startsWith('Bearer ')) {
    token = authHeader.substring(7)
  } else if (typeof req.query.token === 'string') {
    token = req.query.token
  }
  if (!token) {
    return res.status(401).json({ success: false, error: { code: 'UNAUTHORIZED', message: '未提供认证令牌' } })
  }
  const token = authHeader.substring(7)
  const payload = verifyAccessToken(token)
  if (!payload) {
    return res.status(401).json({ success: false, error: { code: 'TOKEN_INVALID', message: '令牌无效或已过期' } })
@@ -0,0 +1,107 @@
 /**
 * 审批流路由
 * 提供审批流配置和实例管理
 */
 import { Router } from 'express'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import prisma from '../lib/prisma'
 import { z } from 'zod'
 import { processApproval, cancelApproval } from '../services/approval.service'
 const router = Router()
 const flowSchema = z.object({
  type: z.string(), // LEAVE / TERMINATION / SALARY_CHANGE / OTHER
  name: z.string().min(1),
  enabled: z.boolean().default(true),
  steps: z.array(z.object({
    step: z.number().int().min(1).max(3),
    approverType: z.enum(['SUPERVISOR', 'DEPT_HEAD', 'PERSON']),
    approverId: z.string().optional(),
    name: z.string(),
  })).min(1, '至少一个审批步骤').max(3, '最多三个审批步骤'),
 })
 /** 获取审批流配置列表 */
 router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const flows = await prisma.approvalFlow.findMany({
      where: { orgId: req.user!.orgId! },
      orderBy: { createdAt: 'asc' },
    })
    res.json({ success: true, data: flows })
  } catch (err) {
    next(err)
  }
 })
 /** 创建/更新审批流配置（upsert by type） */
 router.post('/', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const data = flowSchema.parse(req.body)
    const existing = await prisma.approvalFlow.findFirst({
      where: { orgId: req.user!.orgId!, type: data.type },
    })
    let flow
    if (existing) {
      flow = await prisma.approvalFlow.update({
        where: { id: existing.id },
        data: { ...data, createdBy: req.user!.id },
      })
    } else {
      flow = await prisma.approvalFlow.create({
        data: {
          ...data,
          orgId: req.user!.orgId!,
          createdBy: req.user!.id,
        },
      })
    }
    res.json({ success: true, data: flow })
  } catch (err) {
    next(err)
  }
 })
 /** 获取待我审批的实例 */
 router.get('/pending', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const instances = await prisma.approvalInstance.findMany({
      where: { orgId: req.user!.orgId!, status: 'PENDING' },
      orderBy: { createdAt: 'desc' },
      include: { employee: { select: { id: true, name: true, department: true } } },
    })
    res.json({ success: true, data: instances })
  } catch (err) {
    next(err)
  }
 })
 /** 处理审批 */
 router.post('/:id/process', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    const { result, comment } = req.body as { result: 'APPROVED' | 'REJECTED'; comment?: string }
    if (!result || !['APPROVED', 'REJECTED'].includes(result)) {
      throw { code: 'VALIDATION_ERROR', message: 'result 必须为 APPROVED 或 REJECTED' }
    }
    const approverName = req.user!.id || '审批人'
    const outcome = await processApproval(req.user!.orgId!, id, req.user!.id, approverName, result, comment)
    res.json({ success: true, data: outcome })
  } catch (err) {
    next(err)
  }
 })
 /** 取消审批 */
 router.post('/:id/cancel', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    await cancelApproval(req.user!.orgId!, id)
    res.json({ success: true })
  } catch (err) {
    next(err)
  }
 })
 export default router
@@ -18,6 +18,7 @@ import {
  getLeaveRecords,
  createLeaveRecord,
  deleteLeaveRecord,
  manualCorrectAttendance,
 } from '../services/attendance.service'
 import { createEvidence } from '../services/evidence.service'
 import prisma from '../lib/prisma'
@@ -206,6 +207,22 @@ router.delete('/shift-assignments/:id', authMiddleware, async (req: AuthRequest,
 // ========== 每日出勤 ==========
 router.post('/manual-correct', authMiddleware, async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const schema = z.object({
      employeeId: z.string(),
      date: z.string(),
      checkInTime: z.string().optional(),
      checkOutTime: z.string().optional(),
      status: z.string().optional(),
      remark: z.string().optional(),
    })
    const data = schema.parse(req.body)
    const record = await manualCorrectAttendance(req.user!.orgId, { ...data, createdBy: req.user!.id })
    res.json({ success: true, data: record })
  } catch (err) { next(err) }
 })
 router.get('/daily', authMiddleware, async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const date = req.query.date as string
@@ -0,0 +1,173 @@
 import { Router, Response, NextFunction } from 'express'
 import { z } from 'zod'
 import prisma from '../lib/prisma'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 const router = Router()
 router.use(authMiddleware)
 const planSchema = z.object({
  name: z.string().min(1),
  category: z.string(),
  amount: z.number().default(0),
  frequency: z.string().default('MONTHLY'),
  taxDeductible: z.boolean().default(false),
  description: z.string().optional(),
 })
 const BENEFIT_CATEGORIES: Record<string, string> = {
  TRANSPORT: '交通补贴',
  MEAL: '餐补',
  HOUSING: '住房补贴',
  COMMUNICATION: '通讯补贴',
  HEALTH_CHECK: '体检',
  HOLIDAY: '节日福利',
  BIRTHDAY: '生日福利',
  OTHER: '其他',
 }
 // 福利方案列表
 router.get('/plans', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const plans = await prisma.employeeBenefitPlan.findMany({
      where: { orgId: req.user!.orgId },
      orderBy: { createdAt: 'desc' },
      include: { _count: { select: { enrollments: { where: { status: 'ACTIVE' } } } } },
    })
    res.json({ success: true, data: plans })
  } catch (err) { next(err) }
 })
 // 创建福利方案
 router.post('/plans', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const data = planSchema.parse(req.body)
    const plan = await prisma.employeeBenefitPlan.create({
      data: { ...data, orgId: req.user!.orgId, createdBy: req.user!.id },
    })
    res.json({ success: true, data: plan })
  } catch (err) { next(err) }
 })
 // 更新福利方案
 router.put('/plans/:planId', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const data = planSchema.partial().parse(req.body)
    const plan = await prisma.employeeBenefitPlan.update({
      where: { id: req.params.planId, orgId: req.user!.orgId },
      data,
    })
    res.json({ success: true, data: plan })
  } catch (err) { next(err) }
 })
 // 删除福利方案
 router.delete('/plans/:planId', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    await prisma.employeeBenefitPlan.delete({
      where: { id: req.params.planId, orgId: req.user!.orgId },
    })
    res.json({ success: true })
  } catch (err) { next(err) }
 })
 // 方案参保人员
 router.get('/plans/:planId/enrollments', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const enrollments = await prisma.employeeBenefitEnrollment.findMany({
      where: { orgId: req.user!.orgId, planId: req.params.planId },
      include: { employee: { select: { id: true, name: true, department: true } } },
      orderBy: { createdAt: 'desc' },
    })
    const data = enrollments.map((e: any) => ({
      id: e.id,
      employeeId: e.employeeId,
      name: e.employee.name,
      department: e.employee.department,
      effectiveFrom: e.effectiveFrom,
      effectiveTo: e.effectiveTo,
      amount: e.amount,
      status: e.status,
    }))
    res.json({ success: true, data })
  } catch (err) { next(err) }
 })
 // 批量参保
 router.post('/plans/:planId/enroll', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const { employeeIds, effectiveFrom } = req.body as { employeeIds: string[]; effectiveFrom: string }
    const plan = await prisma.employeeBenefitPlan.findFirst({ where: { id: req.params.planId, orgId: req.user!.orgId } })
    if (!plan) return res.status(404).json({ success: false, error: { message: '方案不存在' } })
    const existing = await prisma.employeeBenefitEnrollment.findMany({
      where: { planId: plan.id, employeeId: { in: employeeIds }, status: 'ACTIVE' },
      select: { employeeId: true },
    })
    const existingIds = new Set(existing.map((e: any) => e.employeeId))
    const newIds = employeeIds.filter((id) => !existingIds.has(id))
    if (newIds.length > 0) {
      await prisma.employeeBenefitEnrollment.createMany({
        data: newIds.map((empId) => ({
          orgId: req.user!.orgId,
          planId: plan.id,
          employeeId: empId,
          effectiveFrom: effectiveFrom || new Date().toISOString().slice(0, 7),
        })),
      })
    }
    res.json({ success: true, data: { enrolled: newIds.length, skipped: existingIds.size } })
  } catch (err) { next(err) }
 })
 // 退福利
 router.post('/enrollments/:enrollmentId/terminate', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const { effectiveTo } = req.body as { effectiveTo: string }
    const enrollment = await prisma.employeeBenefitEnrollment.update({
      where: { id: req.params.enrollmentId, orgId: req.user!.orgId },
      data: { status: 'TERMINATED', effectiveTo: effectiveTo || new Date().toISOString().slice(0, 7) },
    })
    res.json({ success: true, data: enrollment })
  } catch (err) { next(err) }
 })
 // 员工福利汇总（按员工维度）
 router.get('/employee-summary', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const enrollments = await prisma.employeeBenefitEnrollment.findMany({
      where: { orgId: req.user!.orgId, status: 'ACTIVE' },
      include: {
        employee: { select: { id: true, name: true, department: true } },
        plan: { select: { id: true, name: true, category: true, amount: true, frequency: true } },
      },
    })
    const summary: Record<string, any> = {}
    for (const e of enrollments) {
      if (!summary[e.employeeId]) {
        summary[e.employeeId] = {
          employeeId: e.employeeId,
          name: e.employee.name,
          department: e.employee.department,
          benefits: [],
          totalMonthly: 0,
        }
      }
      const amount = e.amount ?? e.plan.amount
      summary[e.employeeId].benefits.push({
        planId: e.planId,
        planName: e.plan.name,
        category: e.plan.category,
        categoryLabel: BENEFIT_CATEGORIES[e.plan.category] || e.plan.category,
        amount,
      })
      if (e.plan.frequency === 'MONTHLY') {
        summary[e.employeeId].totalMonthly += amount
      }
    }
    res.json({ success: true, data: Object.values(summary) })
  } catch (err) { next(err) }
 })
 export default router
@@ -0,0 +1,171 @@
 import { Router, Response, NextFunction } from 'express'
 import { z } from 'zod'
 import prisma from '../lib/prisma'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 const router = Router()
 router.use(authMiddleware)
 const planSchema = z.object({
  name: z.string().min(1),
  type: z.string(),
  provider: z.string().min(1),
  policyNo: z.string().optional(),
  premium: z.number().default(0),
  coverageAmount: z.number().default(0),
  effectiveFrom: z.string(),
  effectiveTo: z.string().optional(),
  description: z.string().optional(),
 })
 // 方案列表
 router.get('/plans', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const plans = await prisma.commercialInsurancePlan.findMany({
      where: { orgId: req.user!.orgId },
      orderBy: { createdAt: 'desc' },
      include: { _count: { select: { enrollments: { where: { status: 'ACTIVE' } } } } },
    })
    res.json({ success: true, data: plans })
  } catch (err) { next(err) }
 })
 // 方案详情（含参保人员）
 router.get('/plans/:planId/enrollments', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const enrollments = await prisma.commercialInsuranceEnrollment.findMany({
      where: { orgId: req.user!.orgId, planId: req.params.planId },
      include: {
        employee: { select: { id: true, name: true, department: true, idCardNumber: true } },
      },
      orderBy: { createdAt: 'desc' },
    })
    const data = enrollments.map((e: any) => ({
      id: e.id,
      employeeId: e.employeeId,
      name: e.employee.name,
      department: e.employee.department,
      idCardMasked: e.employee.idCardNumber ? e.employee.idCardNumber.slice(0, 3) + '****' + e.employee.idCardNumber.slice(-4) : null,
      premium: e.premium,
      effectiveFrom: e.effectiveFrom,
      effectiveTo: e.effectiveTo,
      status: e.status,
    }))
    res.json({ success: true, data })
  } catch (err) { next(err) }
 })
 // 创建方案
 router.post('/plans', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const data = planSchema.parse(req.body)
    const plan = await prisma.commercialInsurancePlan.create({
      data: { ...data, orgId: req.user!.orgId, createdBy: req.user!.id },
    })
    res.json({ success: true, data: plan })
  } catch (err) { next(err) }
 })
 // 更新方案
 router.put('/plans/:planId', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const data = planSchema.partial().parse(req.body)
    const plan = await prisma.commercialInsurancePlan.update({
      where: { id: req.params.planId, orgId: req.user!.orgId },
      data,
    })
    res.json({ success: true, data: plan })
  } catch (err) { next(err) }
 })
 // 删除方案
 router.delete('/plans/:planId', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    await prisma.commercialInsurancePlan.delete({
      where: { id: req.params.planId, orgId: req.user!.orgId },
    })
    res.json({ success: true })
  } catch (err) { next(err) }
 })
 // 批量参保
 router.post('/plans/:planId/enroll', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const { employeeIds, premium, effectiveFrom } = req.body as { employeeIds: string[]; premium: number; effectiveFrom: string }
    const plan = await prisma.commercialInsurancePlan.findFirst({ where: { id: req.params.planId, orgId: req.user!.orgId } })
    if (!plan) return res.status(404).json({ success: false, error: { message: '方案不存在' } })
    const existing = await prisma.commercialInsuranceEnrollment.findMany({
      where: { planId: plan.id, employeeId: { in: employeeIds }, status: 'ACTIVE' },
      select: { employeeId: true },
    })
    const existingIds = new Set(existing.map((e: any) => e.employeeId))
    const newIds = employeeIds.filter((id) => !existingIds.has(id))
    if (newIds.length > 0) {
      await prisma.commercialInsuranceEnrollment.createMany({
        data: newIds.map((empId) => ({
          orgId: req.user!.orgId,
          planId: plan.id,
          employeeId: empId,
          premium: premium || plan.premium,
          effectiveFrom: effectiveFrom || plan.effectiveFrom,
        })),
      })
    }
    res.json({ success: true, data: { enrolled: newIds.length, skipped: existingIds.size } })
  } catch (err) { next(err) }
 })
 // 退保
 router.post('/enrollments/:enrollmentId/terminate', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const { effectiveTo } = req.body as { effectiveTo: string }
    const enrollment = await prisma.commercialInsuranceEnrollment.update({
      where: { id: req.params.enrollmentId, orgId: req.user!.orgId },
      data: { status: 'TERMINATED', effectiveTo: effectiveTo || new Date().toISOString().slice(0, 10) },
    })
    res.json({ success: true, data: enrollment })
  } catch (err) { next(err) }
 })
 // 员工商险汇总（按员工维度）
 router.get('/employee-summary', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const enrollments = await prisma.commercialInsuranceEnrollment.findMany({
      where: { orgId: req.user!.orgId, status: 'ACTIVE' },
      include: {
        employee: { select: { id: true, name: true, department: true } },
        plan: { select: { id: true, name: true, type: true, provider: true, coverageAmount: true } },
      },
    })
    const summary: Record<string, any> = {}
    for (const e of enrollments) {
      if (!summary[e.employeeId]) {
        summary[e.employeeId] = {
          employeeId: e.employeeId,
          name: e.employee.name,
          department: e.employee.department,
          insurances: [],
          totalPremium: 0,
          totalCoverage: 0,
        }
      }
      summary[e.employeeId].insurances.push({
        planId: e.planId,
        planName: e.plan.name,
        type: e.plan.type,
        provider: e.plan.provider,
        premium: e.premium,
        coverageAmount: e.plan.coverageAmount,
        effectiveFrom: e.effectiveFrom,
        effectiveTo: e.effectiveTo,
      })
      summary[e.employeeId].totalPremium += e.premium
      summary[e.employeeId].totalCoverage += e.plan.coverageAmount
    }
    res.json({ success: true, data: Object.values(summary) })
  } catch (err) { next(err) }
 })
 export default router
@@ -0,0 +1,140 @@
 /**
 * 提成奖金路由
 * 管理按月提成奖金/扣款的 CRUD、批量导入、模板下载
 */
 import { Router, Response, NextFunction } from 'express'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import multer from 'multer'
 import * as XLSX from 'xlsx'
 import {
  listByMonth,
  summaryByMonth,
  create,
  update,
  remove,
  batchImport,
 } from '../services/commission-bonus.service'
 import { auditLog } from '../middleware/auditLog'
 const router = Router()
 router.use(authMiddleware)
 const upload = multer({ storage: multer.memoryStorage(), limits: { fileSize: 5 * 1024 * 1024 } })
 /**
 * 按月查询提成奖金列表
 * GET /commission-bonus?month=YYYY-MM
 */
 router.get('/', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const month = (req.query.month as string) || new Date().toISOString().slice(0, 7)
    const [records, summary] = await Promise.all([
      listByMonth(orgId, month),
      summaryByMonth(orgId, month),
    ])
    res.json({ success: true, data: { records, summary, month } })
  } catch (err) { next(err) }
 })
 /**
 * 新增单条提成奖金
 * POST /commission-bonus  body: { employeeId, month, amount, remark? }
 */
 router.post('/', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { employeeId, month, amount, remark } = req.body
    if (!employeeId || !month || amount === undefined) {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '缺少 employeeId/month/amount' } })
    }
    const record = await create(orgId, req.user!.id, { employeeId, month, amount: Number(amount), remark })
    await auditLog(req, 'CREATE', 'COMMISSION_BONUS', record.id, { employeeId, month, amount })
    res.json({ success: true, data: record })
  } catch (err: any) {
    if (err.code === 'NOT_FOUND') return res.status(404).json({ success: false, error: { code: err.code, message: err.message } })
    next(err)
  }
 })
 /**
 * 更新单条
 * PUT /commission-bonus/:id  body: { amount?, remark? }
 */
 router.put('/:id', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { amount, remark } = req.body
    const record = await update(orgId, req.params.id, { amount: amount !== undefined ? Number(amount) : undefined, remark })
    await auditLog(req, 'UPDATE', 'COMMISSION_BONUS', req.params.id, { amount, remark })
    res.json({ success: true, data: record })
  } catch (err: any) {
    if (err.code === 'NOT_FOUND') return res.status(404).json({ success: false, error: { code: err.code, message: err.message } })
    next(err)
  }
 })
 /**
 * 删除单条
 * DELETE /commission-bonus/:id
 */
 router.delete('/:id', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    await remove(orgId, req.params.id)
    await auditLog(req, 'DELETE', 'COMMISSION_BONUS', req.params.id)
    res.json({ success: true, data: { message: '已删除' } })
  } catch (err: any) {
    if (err.code === 'NOT_FOUND') return res.status(404).json({ success: false, error: { code: err.code, message: err.message } })
    next(err)
  }
 })
 /**
 * 批量导入 Excel
 * POST /commission-bonus/import  multipart: file, month
 * Excel 列：员工姓名 | 证件号码 | 金额 | 备注
 */
 router.post('/import', upload.single('file'), async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const month = req.body.month || new Date().toISOString().slice(0, 7)
    if (!req.file) {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '请上传 Excel 文件' } })
    }
    const wb = XLSX.read(req.file.buffer, { type: 'buffer' })
    const ws = wb.Sheets[wb.SheetNames[0]]
    const rows: any[] = XLSX.utils.sheet_to_json(ws, { defval: '' })
    const parsed = rows.map((r) => ({
      employeeName: String(r['员工姓名'] || r['姓名'] || '').trim() || undefined,
      idCardNumber: String(r['证件号码'] || r['身份证号'] || '').trim() || undefined,
      amount: parseFloat(r['金额'] || r['提成奖金'] || '0') || 0,
      remark: String(r['备注'] || '').trim() || undefined,
    })).filter((r) => r.employeeName || r.idCardNumber)
    const result = await batchImport(orgId, req.user!.id, month, parsed)
    await auditLog(req, 'IMPORT', 'COMMISSION_BONUS', undefined, { month, ...result })
    res.json({ success: true, data: result })
  } catch (err) { next(err) }
 })
 /**
 * 下载导入模板
 * GET /commission-bonus/template
 */
 router.get('/template', (req: AuthRequest, res: Response) => {
  const ws = XLSX.utils.aoa_to_sheet([
    ['员工姓名', '证件号码', '金额', '备注'],
    ['张三', '110101199001011234', '5000', '销售提成'],
    ['李四', '', '-200', '迟到扣款'],
  ])
  const wb = XLSX.utils.book_new()
  XLSX.utils.book_append_sheet(wb, ws, '提成奖金模板')
  const buf = XLSX.write(wb, { type: 'buffer', bookType: 'xlsx' })
  res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
  res.setHeader('Content-Disposition', 'attachment; filename="commission-bonus-template.xlsx"')
  res.send(buf)
 })
 export default router
@@ -285,6 +285,43 @@ router.get('/workspace/next-actions', authMiddleware, async (req: AuthRequest, r
      take: 10,
    })
    // 5. 发薪日提前提醒
    const org = await prisma.organization.findUnique({
      where: { id: orgId },
      select: { payrollDays: true, payrollReminderDays: true },
    })
    const payrollDays = Array.isArray(org?.payrollDays) ? org.payrollDays as number[] : []
    const reminderDays = org?.payrollReminderDays ?? 3
    const payrollReminderItems: any[] = []
    const currentYear = now.getFullYear()
    const currentMonth = now.getMonth() // 0-indexed
    for (const day of payrollDays) {
      // 本月发薪日
      const thisMonthPayday = new Date(currentYear, currentMonth, day)
      const diffDays = Math.floor((thisMonthPayday.getTime() - now.getTime()) / 86400000)
      if (diffDays >= 0 && diffDays <= reminderDays) {
        payrollReminderItems.push({
          id: `payroll-${currentYear}-${currentMonth + 1}-${day}`,
          title: `发薪日（每月${day}号）${diffDays === 0 ? '今天' : `${diffDays}天后`}`,
          subtitle: diffDays === 0 ? '今天发薪' : `还有${diffDays}天`,
          link: '/money',
        })
      }
      // 下月发薪日（如果当月已过，看下月）
      if (diffDays < 0) {
        const nextMonthPayday = new Date(currentYear, currentMonth + 1, day)
        const nextDiffDays = Math.floor((nextMonthPayday.getTime() - now.getTime()) / 86400000)
        if (nextDiffDays >= 0 && nextDiffDays <= reminderDays) {
          payrollReminderItems.push({
            id: `payroll-${currentYear}-${currentMonth + 2}-${day}`,
            title: `发薪日（下月${day}号）${nextDiffDays === 0 ? '今天' : `${nextDiffDays}天后`}`,
            subtitle: `还有${nextDiffDays}天`,
            link: '/money',
          })
        }
      }
    }
    // 按优先级分组
    const actions: Array<{ category: string; priority: 'high' | 'medium' | 'low'; items: any[] }> = [
      {
@@ -333,6 +370,11 @@ router.get('/workspace/next-actions', authMiddleware, async (req: AuthRequest, r
          link: '/special-status',
        })),
      },
      {
        category: '发薪提醒',
        priority: 'medium',
        items: payrollReminderItems,
      },
    ]
    // 过滤空分类
@@ -0,0 +1,142 @@
 /**
 * 部门管理路由
 * 提供部门的增删改查（树形结构）
 */
 import { Router } from 'express'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import prisma from '../lib/prisma'
 import { z } from 'zod'
 const router = Router()
 const createDeptSchema = z.object({
  name: z.string().min(1, '部门名称必填'),
  parentId: z.string().nullable().optional(),
  sortOrder: z.number().int().default(0),
  description: z.string().max(200).optional(),
 })
 const updateDeptSchema = createDeptSchema.partial().extend({
  socialAccountId: z.string().nullable().optional(),
  housingAccountId: z.string().nullable().optional(),
 })
 /** 获取部门树 */
 router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    // 兼容历史组织：若无任何部门，自动创建根部门（公司名）
    const existing = await prisma.department.findFirst({ where: { orgId: req.user!.orgId! } })
    if (!existing) {
      const org = await prisma.organization.findUnique({ where: { id: req.user!.orgId! } })
      if (org) {
        await prisma.department.create({
          data: {
            orgId: org.id,
            name: org.name,
            parentId: null,
            level: 0,
            sortOrder: 0,
            description: '组织根节点',
            createdBy: req.user!.id,
          },
        })
      }
    }
    const departments = await prisma.department.findMany({
      where: { orgId: req.user!.orgId! },
      orderBy: [{ sortOrder: 'asc' }, { createdAt: 'asc' }],
      include: { _count: { select: { employees: true, positions: true } } },
    })
    res.json({ success: true, data: departments })
  } catch (err) {
    next(err)
  }
 })
 /** 创建部门 */
 router.post('/', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const data = createDeptSchema.parse(req.body)
    // 空字符串视为无父部门，统一转为 null
    let parentId = data.parentId && data.parentId.trim() !== '' ? data.parentId : null
    // 若未指定父部门，默认挂到根部门（level=0）下
    if (!parentId) {
      const root = await prisma.department.findFirst({ where: { orgId: req.user!.orgId!, parentId: null }, orderBy: { sortOrder: 'asc' } })
      if (root) parentId = root.id
    }
    let level = 0
    if (parentId) {
      const parent = await prisma.department.findFirst({ where: { id: parentId, orgId: req.user!.orgId! } })
      if (!parent) throw { code: 'NOT_FOUND', message: '父部门不存在' }
      level = parent.level + 1
    }
    const dept = await prisma.department.create({
      data: {
        name: data.name,
        parentId,
        level,
        sortOrder: data.sortOrder,
        description: data.description,
        orgId: req.user!.orgId!,
        createdBy: req.user!.id,
      },
    })
    res.json({ success: true, data: dept })
  } catch (err) {
    next(err)
  }
 })
 /** 更新部门 */
 router.put('/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    const data = updateDeptSchema.parse(req.body)
    // 空字符串视为无父部门，统一转为 null
    const parentId = data.parentId !== undefined && data.parentId !== null && data.parentId.trim() !== '' ? data.parentId : data.parentId === undefined ? undefined : null
    // 防止循环引用
    if (parentId === id) throw { code: 'VALIDATION_ERROR', message: '不能将自身设为父部门' }
    let level: number | undefined
    if (parentId) {
      const parent = await prisma.department.findFirst({ where: { id: parentId, orgId: req.user!.orgId! } })
      if (!parent) throw { code: 'NOT_FOUND', message: '父部门不存在' }
      level = parent.level + 1
    } else if (parentId === null) {
      level = 0
    }
    const dept = await prisma.department.update({
      where: { id },
      data: {
        ...(data.name !== undefined ? { name: data.name } : {}),
        ...(parentId !== undefined ? { parentId } : {}),
        ...(data.sortOrder !== undefined ? { sortOrder: data.sortOrder } : {}),
        ...(data.description !== undefined ? { description: data.description } : {}),
        ...(level !== undefined ? { level } : {}),
        ...(data.socialAccountId !== undefined ? { socialAccountId: data.socialAccountId } : {}),
        ...(data.housingAccountId !== undefined ? { housingAccountId: data.housingAccountId } : {}),
      },
    })
    res.json({ success: true, data: dept })
  } catch (err) {
    next(err)
  }
 })
 /** 删除部门 */
 router.delete('/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    // 检查是否有子部门
    const children = await prisma.department.findFirst({ where: { parentId: id, orgId: req.user!.orgId! } })
    if (children) throw { code: 'VALIDATION_ERROR', message: '请先删除子部门' }
    // 检查是否有关联员工
    const employees = await prisma.employee.findFirst({ where: { departmentId: id, orgId: req.user!.orgId! } })
    if (employees) throw { code: 'VALIDATION_ERROR', message: '该部门下仍有员工，无法删除' }
    await prisma.department.delete({ where: { id } })
    res.json({ success: true })
  } catch (err) {
    next(err)
  }
 })
 export default router
@@ -1,8 +1,11 @@
 import { Router } from 'express'
 import bcrypt from 'bcryptjs'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import { auditLog } from '../middleware/auditLog'
 import { createEvidence } from '../services/evidence.service'
 import { autoCreateEsignRecord } from '../services/esign.service'
 import prisma from '../lib/prisma'
 import { sha256, decrypt } from '../lib/crypto'
 import {
  createEmployeeSchema,
  updateEmployeeSchema,
@@ -79,7 +82,7 @@ router.get('/list', authMiddleware, async (req: AuthRequest, res, next) => {
        status: { in: status },
        ...(department && { department }),
      },
-      select: { id: true, name: true, department: true, position: true, phone: true, status: true },
+      select: { id: true, name: true, department: true, position: true, phone: true, gender: true, status: true },
      orderBy: { name: 'asc' },
    })
    res.json({ success: true, data: employees })
@@ -97,6 +100,45 @@ router.get('/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  }
 })
 // 身份证查重
 router.get('/check-id-card', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const idCard = req.query.idCard as string
    if (!idCard || idCard.length < 18) {
      return res.json({ success: true, data: { exists: false } })
    }
    const hash = sha256(idCard)
    const employee = await prisma.employee.findFirst({
      where: { orgId: req.user!.orgId, idCardHash: hash },
      select: { id: true, name: true, department: true, status: true },
    })
    res.json({ success: true, data: { exists: !!employee, employee } })
  } catch (err) {
    next(err)
  }
 })
 // 手机号查重
 router.get('/check-phone', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const phone = req.query.phone as string
    if (!phone || phone.length < 11) {
      return res.json({ success: true, data: { exists: false } })
    }
    // 手机号加密存储，需遍历匹配（量小可接受）
    const employees = await prisma.employee.findMany({
      where: { orgId: req.user!.orgId },
      select: { id: true, name: true, department: true, status: true, phone: true },
    })
    const matched = employees.find(e => {
      try { return e.phone ? decrypt(e.phone) === phone : false } catch { return false }
    })
    res.json({ success: true, data: { exists: !!matched, employee: matched ? { id: matched.id, name: matched.name, department: matched.department, status: matched.status } : undefined } })
  } catch (err) {
    next(err)
  }
 })
 router.post('/', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const data = createEmployeeSchema.parse(req.body)
@@ -154,6 +196,30 @@ router.delete('/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  }
 })
 /**
 * 管理员重置员工密码（重置为手机号后6位）
 * POST /employees/:id/reset-password
 */
 router.post('/:id/reset-password', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const employee = await prisma.employee.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
      select: { id: true, phone: true, name: true },
    })
    if (!employee) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '员工不存在' } })
    }
    // 重置为手机号后6位，无手机号则用 123456
    const defaultPassword = employee.phone ? employee.phone.slice(-6) : '123456'
    const passwordHash = await bcrypt.hash(defaultPassword, 10)
    await prisma.employee.update({ where: { id: employee.id }, data: { passwordHash } })
    await auditLog(req, 'RESET_PASSWORD', 'EMPLOYEE', employee.id, { employeeName: employee.name })
    res.json({ success: true, data: { message: `密码已重置为手机号后6位：${defaultPassword}` } })
  } catch (err) {
    next(err)
  }
 })
 // 批量续签合规预检
 router.post('/contracts/preview-renew', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
@@ -270,6 +336,8 @@ router.post('/contracts', authMiddleware, async (req: AuthRequest, res, next) =>
      events: [{ action: '合同签订', timestamp: new Date().toISOString(), ip: req.ip, userAgent: req.headers['user-agent'] }],
      createdBy: req.user!.id,
    }).catch(() => {})
    // 注意：电子签署记录由前端根据 signMethod 决定是否创建，避免重复
    res.json({ success: true, data: result })
  } catch (err) {
    next(err)
@@ -284,9 +352,33 @@ router.delete('/contracts/:contractId', authMiddleware, async (req: AuthRequest,
    if (!contract) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '合同不存在' } })
    }
-    await prisma.laborContract.delete({ where: { id: req.params.contractId } })
+    // 作废处理：设置结束日期为当前时间，保留记录但不物理删除
    await prisma.laborContract.update({
      where: { id: req.params.contractId },
      data: { endDate: new Date() },
    })
    const emp = await prisma.employee.findFirst({ where: { id: contract.employeeId }, select: { name: true } })
-    await auditLog(req, 'DELETE_CONTRACT', 'CONTRACT', req.params.contractId, { employeeName: emp?.name || '', employeeId: contract.employeeId, contractType: contract.contractType, startDate: contract.startDate, endDate: contract.endDate })
+    await auditLog(req, 'VOID_CONTRACT', 'CONTRACT', req.params.contractId, { employeeName: emp?.name || '', employeeId: contract.employeeId, contractType: contract.contractType, startDate: contract.startDate, endDate: contract.endDate })
    res.json({ success: true })
  } catch (err) {
    next(err)
  }
 })
 // 补充上传合同附件
 router.patch('/contracts/:contractId/attachment', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const contract = await prisma.laborContract.findFirst({
      where: { id: req.params.contractId, orgId: req.user!.orgId },
    })
    if (!contract) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '合同不存在' } })
    }
    const { attachmentUrl } = req.body as { attachmentUrl: string }
    await prisma.laborContract.update({
      where: { id: req.params.contractId },
      data: { attachmentUrl: attachmentUrl || null },
    })
    res.json({ success: true })
  } catch (err) {
    next(err)
@@ -146,10 +146,63 @@ router.get('/:id/download', authMiddleware, async (req: AuthRequest, res: Respon
    if (!template) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '模板不存在' } })
    }
    // 支持通过 query 参数传入变量（如 ?name=张三&idCardNumber=xxx）
    let content = template.content
    const variables: Record<string, string> = {}
    for (const [key, value] of Object.entries(req.query)) {
      if (typeof value === 'string' && key !== 'token') variables[key] = value
    }
    if (Object.keys(variables).length > 0) {
      for (const [key, value] of Object.entries(variables)) {
        content = content.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value)
      }
    }
    // 将纯文本转换为HTML段落，使Word样式生效
    const textToHtml = (text: string): string => {
      // 如果内容已包含HTML标签，直接返回
      if (/<[a-z][\s\S]*>/i.test(text)) return text
      const lines = text.split(/\n/)
      let html = ''
      for (const line of lines) {
        const trimmed = line.trim()
        if (!trimmed) {
          html += '<p style="text-indent:0">&nbsp;</p>'
          continue
        }
        if (/^第[一二三四五六七八九十百]+条/.test(trimmed)) {
          html += `<h3>${trimmed}</h3>`
        } else if (/^劳动合同书$|^协议书$|^通知书$|^解除劳动合同协议书$/.test(trimmed)) {
          html += `<h1>${trimmed}</h1>`
        } else if (/^(甲方|乙方)（(盖章|签字)）/.test(trimmed) || /^日期[:：]/.test(trimmed)) {
          html += `<p class="sign">${trimmed}</p>`
        } else {
          html += `<p>${trimmed}</p>`
        }
      }
      return html
    }
    const htmlContent = `<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">
 <head><meta charset="utf-8"><title>${template.name}</title>
 <!--[if gte mso 9]><xml>
 <w:WordDocument><w:View>Print</w:View><w:Zoom>100</w:Zoom><w:DoNotOptimizeForBrowser/></w:WordDocument>
 </xml><![endif]-->
 <style>
@page { size: A4; margin: 2.54cm 3.17cm 2.54cm 3.17cm; }
 body { font-family: SimSun, serif; font-size: 14pt; line-height: 2; text-align: justify; }
 h1 { font-size: 22pt; font-weight: bold; text-align: center; margin: 30pt 0 20pt 0; font-family: SimHei, sans-serif; }
 h2 { font-size: 16pt; font-weight: bold; margin: 20pt 0 10pt 0; font-family: SimHei, sans-serif; }
 h3 { font-size: 14pt; font-weight: bold; margin: 15pt 0 8pt 0; font-family: SimHei, sans-serif; text-indent: 0; }
 p { text-indent: 2em; margin: 0 0 10pt 0; }
 table { border-collapse: collapse; width: 100%; margin: 10pt 0; }
 td, th { border: 1pt solid #000; padding: 4pt 8pt; font-size: 12pt; }
 th { background: #f0f0f0; font-weight: bold; text-align: center; }
 .sign { text-align: right; margin-top: 30pt; margin-right: 20pt; text-indent: 0; }
 </style></head>
 <body>${textToHtml(content)}</body></html>`
    const encoded = encodeURIComponent(template.name + '.doc')
-    res.setHeader('Content-Type', 'application/msword')
+    res.setHeader('Content-Type', 'application/msword; charset=utf-8')
    res.setHeader('Content-Disposition', `attachment; filename="${encoded}"; filename*=UTF-8''${encoded}`)
-    res.send(template.content)
+    res.send(htmlContent)
  } catch (err) {
    next(err)
  }
@@ -0,0 +1,704 @@
 /**
 * 电子签署路由 — 管理端
 *
 * 完整签署流程：
 * 1. HR 发起签署（校验组织电子签开关 + 自动渲染模板文件内容 + 创建证据链）
 * 2. 员工在 portal 端查看待签文件 → 发送验证码 → 验证码确认签署
 * 3. 签署完成 → 回写合同 + 追加证据链 + 生成签署确认文件
 * 4. 易签宝回调（对接后启用）：更新状态 + 回写PDF
 *
 * 证据链事件：发起签署 / 验证码发送 / 签署完成 / 取消签署
 */
 import { Router, Response, NextFunction } from 'express'
 import { z } from 'zod'
 import jwt from 'jsonwebtoken'
 import multer from 'multer'
 import path from 'path'
 import fs from 'fs'
 import prisma from '../lib/prisma'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import { auditLog } from '../middleware/auditLog'
 import { createEvidence, appendEvidence } from '../services/evidence.service'
 import { renderTemplate, getTemplateById } from '../services/template.service'
 const router = Router()
 router.use(authMiddleware)
 const AUTO_LOGIN_SECRET = process.env.JWT_SECRET || 'dev-secret'
 /** 场景与组织电子签开关的映射 */
 const SCENE_ORG_FLAG_MAP: Record<string, string | null> = {
  CONTRACT: null, // 合同签署不需要额外开关（默认允许）
  RESIGNATION: null, // 离职协议不需要额外开关
  POLICY: 'esignPolicyEnabled',
  PAYSLIP: 'esignPayslipEnabled',
  ONBOARDING: 'esignOnboardingEnabled',
 }
 /** 场景与模板ID的映射（自动渲染文件内容） */
 const SCENE_TEMPLATE_MAP: Record<string, string | null> = {
  CONTRACT: 'tpl_fixed_term_contract',
  RESIGNATION: 'tpl_termination_agreement',
  POLICY: null,
  PAYSLIP: null,
  ONBOARDING: null,
 }
 const createSignSchema = z.object({
  contractId: z.string().optional(),
  employeeId: z.string().min(1),
  documentTitle: z.string().min(1),
  documentContent: z.string().optional(),
  remark: z.string().optional(),
  scene: z.string().optional(),
  templateId: z.string().optional(), // 可指定模板，不传则按 scene 自动匹配
  templateVars: z.record(z.string()).optional(), // 模板变量
 })
 /**
 * 签署记录列表
 */
 router.get('/', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const status = req.query.status as string | undefined
    const scene = req.query.scene as string | undefined
    const records = await prisma.eSignRecord.findMany({
      where: {
        orgId: req.user!.orgId,
        ...(status && { status }),
        ...(scene && { scene }),
      },
      include: {
        employee: { select: { id: true, name: true, department: true, phone: true } },
      },
      orderBy: { createdAt: 'desc' },
    })
    res.json({ success: true, data: records })
  } catch (err) { next(err) }
 })
 /**
 * 待签合同列表（按员工聚合）
 * GET /esign/pending
 *
 * 汇总两类未签署记录，按员工聚合：
 * 1. EsignRecord 中 status 为 PENDING/SIGNING 的（所有场景）
 * 2. LaborContract 中 signDate 为空且员工在职的（纸质合同未登记签署日期）
 *
 * 返回格式：[{ employeeId, name, department, phone, pendingItems: [{ type, title, scene, signMethod, status, createdAt, recordId, contractId }] }]
 */
 router.get('/pending', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    // 1. 查询未完成的 EsignRecord
    const pendingEsign = await prisma.eSignRecord.findMany({
      where: {
        orgId,
        status: { in: ['PENDING', 'SIGNING'] },
      },
      include: {
        employee: { select: { id: true, name: true, department: true, phone: true, status: true } },
      },
      orderBy: { createdAt: 'desc' },
    })
    // 2. 查询 signDate 为空的 LaborContract（且员工在职）
    const pendingContracts = await prisma.laborContract.findMany({
      where: {
        orgId,
        signDate: null,
        employee: { status: 'ACTIVE' },
      },
      include: {
        employee: { select: { id: true, name: true, department: true, phone: true, status: true } },
      },
      orderBy: { createdAt: 'desc' },
    })
    // 3. 按员工聚合
    const employeeMap = new Map<string, {
      employeeId: string
      name: string
      department: string | null
      phone: string | null
      pendingItems: any[]
    }>()
    // 辅助函数：添加员工到 map
    const ensureEmployee = (emp: { id: string; name: string; department: string | null; phone: string | null }) => {
      if (!employeeMap.has(emp.id)) {
        employeeMap.set(emp.id, {
          employeeId: emp.id,
          name: emp.name,
          department: emp.department,
          phone: emp.phone,
          pendingItems: [],
        })
      }
      return employeeMap.get(emp.id)!
    }
    // 汇总 EsignRecord
    for (const r of pendingEsign) {
      const emp = ensureEmployee(r.employee)
      emp.pendingItems.push({
        type: 'esign',
        recordId: r.id,
        contractId: r.contractId,
        title: r.documentTitle,
        scene: r.scene,
        signMethod: r.signMethod,
        status: r.status,
        createdAt: r.createdAt,
      })
    }
    // 汇总 LaborContract（排除已有 EsignRecord 关联的，避免重复）
    const CONTRACT_TYPE_LABEL: Record<string, string> = {
      FIXED: '固定期限劳动合同',
      UNFIXED: '无固定期限劳动合同',
      UNSIGNED: '未签合同',
      LABOR: '劳务协议',
      INTERNSHIP: '实习协议',
      DISPATCH: '劳务派遣合同',
      OUTSOURCING: '外包合同',
      PARTTIME: '非全日制合同',
    }
    const esignContractIds = new Set(pendingEsign.filter(r => r.contractId).map(r => r.contractId))
    for (const c of pendingContracts) {
      if (esignContractIds.has(c.id)) continue // 已有电子签署记录的不重复
      const emp = ensureEmployee(c.employee)
      emp.pendingItems.push({
        type: 'contract',
        recordId: null,
        contractId: c.id,
        title: CONTRACT_TYPE_LABEL[c.contractType] || `${c.contractType}合同`,
        scene: 'CONTRACT',
        signMethod: c.signMethod,
        status: 'PENDING',
        createdAt: c.createdAt,
      })
    }
    // 转为数组，按待签数量降序、姓名排序
    const result = Array.from(employeeMap.values()).sort((a, b) => {
      if (b.pendingItems.length !== a.pendingItems.length) return b.pendingItems.length - a.pendingItems.length
      return a.name.localeCompare(b.name)
    })
    res.json({ success: true, data: result })
  } catch (err) { next(err) }
 })
 /**
 * 登记线下合同签署日期
 * POST /esign/sign-date  body: { contractId, signDate }
 *
 * 适用于纸质合同（signMethod=PAPER）未登记签署日期的情况。
 * 电子签合同的签署日期由电签系统回写，不通过此接口修改。
 */
 router.post('/sign-date', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const { contractId, signDate } = req.body
    if (!contractId || !signDate) {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '缺少 contractId 或 signDate' } })
    }
    const contract = await prisma.laborContract.findFirst({
      where: { id: contractId, orgId: req.user!.orgId },
      select: { id: true, signMethod: true, contractType: true, employeeId: true, employee: { select: { name: true } } },
    })
    if (!contract) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '合同不存在' } })
    }
    if (contract.signMethod === 'ELECTRONIC') {
      return res.status(400).json({ success: false, error: { code: 'VALIDATION_ERROR', message: '电子签合同的签署日期由电签系统自动回写，不可手动修改' } })
    }
    // 解析日期字符串（YYYY-MM-DD），手动构造本地中午时间避免时区偏移
    const dateStr = String(signDate).slice(0, 10)
    const [y, m, d] = dateStr.split('-').map(Number)
    const parsedDate = new Date(y, (m || 1) - 1, d || 1, 12, 0, 0, 0)
    if (isNaN(parsedDate.getTime())) {
      return res.status(400).json({ success: false, error: { code: 'VALIDATION_ERROR', message: '签署日期格式无效' } })
    }
    // 更新合同签署日期
    await prisma.laborContract.update({
      where: { id: contractId },
      data: { signDate: parsedDate },
    })
    // 同时创建一条已完成的线下手签 EsignRecord，使签署记录 Tab 可见
    const existingRecord = await prisma.eSignRecord.findFirst({
      where: { contractId, status: 'COMPLETED' },
      select: { id: true },
    })
    if (!existingRecord) {
      // 合同类型枚举转中文
      const CONTRACT_TYPE_LABEL: Record<string, string> = {
        FIXED: '固定期限劳动合同',
        UNFIXED: '无固定期限劳动合同',
        UNSIGNED: '未签合同',
        LABOR: '劳务协议',
        INTERNSHIP: '实习协议',
        DISPATCH: '劳务派遣合同',
        OUTSOURCING: '外包合同',
        PARTTIME: '非全日制合同',
      }
      const contractLabel = CONTRACT_TYPE_LABEL[contract.contractType] || '合同'
      await prisma.eSignRecord.create({
        data: {
          orgId: req.user!.orgId,
          contractId,
          employeeId: contract.employeeId,
          scene: 'CONTRACT',
          signMethod: 'PAPER',
          documentTitle: `${contractLabel}线下签署登记`,
          status: 'COMPLETED',
          completedAt: new Date(),  // 完成时间 = 记录创建时间（HR 登记时间）
          signedAt: parsedDate,     // 签署时间 = HR 选择的签署日期
          signedLocation: null,
          initiatedBy: req.user!.id,
          createdBy: req.user!.id,
          remark: 'HR 登记线下签署日期',
        },
      })
    }
    await auditLog(req, 'SIGN_DATE', 'CONTRACT', contractId, { employeeName: contract.employee.name, signDate: parsedDate.toISOString() })
    res.json({ success: true, data: { message: '签署日期已登记', signDate: parsedDate.toISOString() } })
  } catch (err) { next(err) }
 })
 /**
 * 催办 — 生成员工一次性自动登录链接（指向员工端签署页）
 * POST /esign/remind  body: { employeeId }
 *
 * 返回自动登录 URL，HR 可复制或生成二维码发给员工
 */
 router.post('/remind', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const { employeeId } = req.body
    if (!employeeId) {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '缺少 employeeId' } })
    }
    const employee = await prisma.employee.findFirst({
      where: { id: employeeId, orgId: req.user!.orgId, status: 'ACTIVE' },
      select: { id: true, name: true, phone: true, orgId: true },
    })
    if (!employee) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '员工不存在或已离职' } })
    }
    // 生成一次性 token（24 小时有效，给员工充足时间签署）
    const token = jwt.sign(
      { id: employee.id, orgId: employee.orgId, role: 'EMPLOYEE_AUTO', name: employee.name },
      AUTO_LOGIN_SECRET,
      { expiresIn: '24h' },
    )
    const url = `${process.env.PORTAL_BASE_URL || ''}/portal/auto-login?token=${token}&redirect=/portal/esign`
    await auditLog(req, 'REMIND', 'ESIGN', employeeId, { employeeName: employee.name })
    res.json({ success: true, data: { url, token, employeeName: employee.name, phone: employee.phone } })
  } catch (err) { next(err) }
 })
 /**
 * 发起签署
 * - 校验组织电子签开关
 * - 自动从模板渲染文件内容
 * - 创建 ESignRecord
 * - 创建证据链（发起签署事件）
 */
 router.post('/create', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const data = createSignSchema.parse(req.body)
    const scene = data.scene || 'CONTRACT'
    // 1. 校验组织电子签开关
    const orgFlag = SCENE_ORG_FLAG_MAP[scene]
    if (orgFlag) {
      const org = await prisma.organization.findUnique({
        where: { id: req.user!.orgId },
        select: { [orgFlag]: true, name: true } as any,
      })
      if (org && !(org as any)[orgFlag]) {
        return res.status(403).json({
          success: false,
          error: { code: 'ESIGN_DISABLED', message: `组织未开启${scene === 'POLICY' ? '规章制度' : scene === 'PAYSLIP' ? '工资条' : scene === 'ONBOARDING' ? '入职文件' : '该场景'}电子签功能，请在系统设置中开启` },
        })
      }
    }
    // 2. 获取员工信息
    const employee = await prisma.employee.findFirst({
      where: { id: data.employeeId, orgId: req.user!.orgId },
      select: { id: true, name: true, phone: true, department: true, idCardNumber: true, position: true, monthlySalary: true, hireDate: true },
    })
    if (!employee) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '员工不存在' } })
    }
    // 3. 自动渲染文件内容（优先使用指定模板，否则按 scene 匹配）
    let documentContent = data.documentContent || ''
    if (!documentContent) {
      const templateId = data.templateId || SCENE_TEMPLATE_MAP[scene]
      if (templateId) {
        const template = getTemplateById(templateId)
        if (template) {
          // 自动填充模板变量
          const org = await prisma.organization.findUnique({ where: { id: req.user!.orgId }, select: { name: true } })
          const vars: Record<string, string> = {
            companyName: org?.name || '',
            employeeName: employee.name || '',
            idCard: employee.idCardNumber || '',
            position: employee.position || '',
            monthlySalary: String(employee.monthlySalary || ''),
            ...data.templateVars,
          }
          documentContent = renderTemplate(templateId, vars) || ''
        }
      }
    }
    // 4. 创建签署记录
    const record = await prisma.eSignRecord.create({
      data: {
        orgId: req.user!.orgId,
        contractId: data.contractId || null,
        employeeId: data.employeeId,
        scene,
        documentTitle: data.documentTitle,
        documentContent: documentContent || null,
        status: 'PENDING',
        initiatedBy: req.user!.id,
        createdBy: req.user!.id,
        remark: data.remark || null,
        expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
      },
    })
    // 5. 创建证据链 — 发起签署事件
    await createEvidence({
      orgId: req.user!.orgId,
      category: 'CONTRACT_SIGN',
      refId: record.id,
      employeeId: data.employeeId,
      events: [{
        action: `发起电子签署：${data.documentTitle}`,
        timestamp: new Date().toISOString(),
        ip: req.ip,
        userAgent: req.headers['user-agent'] as string,
        location: `场景：${scene}，发起人：${req.user!.id}`,
      }],
      createdBy: req.user!.id,
    }).catch(() => {})
    await auditLog(req, 'ESIGN_CREATE', 'ESIGN_RECORD', record.id, { employeeId: data.employeeId, scene, documentTitle: data.documentTitle })
    res.json({
      success: true,
      data: record,
      message: '签署记录已创建，员工可在员工端查看并签署',
    })
  } catch (err) { next(err) }
 })
 /**
 * 签署记录详情
 */
 router.get('/:id', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const record = await prisma.eSignRecord.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
      include: {
        employee: { select: { id: true, name: true, department: true, phone: true } },
      },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在' } })
    res.json({ success: true, data: record })
  } catch (err) { next(err) }
 })
 /**
 * 查询签署状态
 */
 router.get('/:id/status', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const record = await prisma.eSignRecord.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在' } })
    // 检查是否已过期但状态仍为 PENDING
    if (record.status === 'PENDING' && record.expiredAt && record.expiredAt < new Date()) {
      const updated = await prisma.eSignRecord.update({
        where: { id: record.id },
        data: { status: 'EXPIRED' },
      })
      return res.json({ success: true, data: updated })
    }
    res.json({ success: true, data: record })
  } catch (err) { next(err) }
 })
 /**
 * 获取签署记录的证据链
 */
 router.get('/:id/evidence', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const evidence = await prisma.evidenceChain.findMany({
      where: { orgId: req.user!.orgId, refId: req.params.id },
      orderBy: { createdAt: 'asc' },
    })
    res.json({ success: true, data: evidence })
  } catch (err) { next(err) }
 })
 /**
 * 易签宝回调接口（无需认证）
 * 对接易签宝后启用：验证签名 + 更新状态 + 回写PDF + 追加证据链
 */
 router.post('/callback', async (req, res: Response, next: NextFunction) => {
  try {
    const { flowId, status, signedPdfUrl, ...rest } = req.body
    // TODO: 对接易签宝后验证回调签名
    // if (!verifyEsignCallback(req.headers, req.body)) {
    //   return res.status(401).json({ success: false, error: { message: '无效回调' } })
    // }
    if (flowId) {
      const record = await prisma.eSignRecord.findFirst({ where: { flowId } })
      if (record) {
        await prisma.eSignRecord.update({
          where: { id: record.id },
          data: {
            status: status || 'COMPLETED',
            signedPdfUrl: signedPdfUrl || null,
            completedAt: status === 'COMPLETED' ? new Date() : null,
            callbackData: rest as any,
          },
        })
        // 签署完成 → 回写合同 + 追加证据链
        if (status === 'COMPLETED') {
          if (record.contractId) {
            await prisma.laborContract.update({
              where: { id: record.contractId },
              data: {
                signMethod: 'ELECTRONIC',
                electronicContractUrl: signedPdfUrl || null,
              },
            })
          }
          await appendEvidence(record.orgId, '', {
            action: '易签宝回调：签署完成',
            timestamp: new Date().toISOString(),
            location: `flowId: ${flowId}，PDF: ${signedPdfUrl || '无'}`,
          }).catch(() => {})
        }
        await auditLog({} as any, 'ESIGN_CALLBACK', 'ESIGN_RECORD', record.id, { flowId, status })
      }
    }
    res.json({ success: true })
  } catch (err) { next(err) }
 })
 /**
 * 取消签署
 * - 更新状态为 CANCELLED
 * - 追加证据链
 */
 router.post('/:id/cancel', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const record = await prisma.eSignRecord.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在' } })
    if (record.status === 'COMPLETED') {
      return res.status(400).json({ success: false, error: { message: '已完成的签署不可取消' } })
    }
    const updated = await prisma.eSignRecord.update({
      where: { id: record.id },
      data: { status: 'CANCELLED' },
    })
    // 追加证据链
    const evidence = await prisma.evidenceChain.findFirst({
      where: { orgId: req.user!.orgId, refId: record.id },
    })
    if (evidence) {
      await appendEvidence(req.user!.orgId, evidence.id, {
        action: '取消签署',
        timestamp: new Date().toISOString(),
        ip: req.ip,
        userAgent: req.headers['user-agent'] as string,
        location: `操作人：${req.user!.id}`,
      }).catch(() => {})
    }
    await auditLog(req, 'ESIGN_CANCEL', 'ESIGN_RECORD', record.id, {})
    res.json({ success: true, data: updated })
  } catch (err) { next(err) }
 })
 // ========== 线下手签登记 ==========
 /** 线下签署扫描件上传目录 */
 const paperSignDir = path.join(process.cwd(), 'uploads', 'paper-sign')
 if (!fs.existsSync(paperSignDir)) fs.mkdirSync(paperSignDir, { recursive: true })
 const paperSignUpload = multer({
  storage: multer.diskStorage({
    destination: paperSignDir,
    filename: (_req, file, cb) => {
      const ext = path.extname(file.originalname)
      cb(null, `${Date.now()}-${Math.random().toString(36).slice(2, 8)}${ext}`)
    },
  }),
  limits: { fileSize: 10 * 1024 * 1024 },
  fileFilter: (_req, file, cb) => {
    const allowed = ['.jpg', '.jpeg', '.png', '.pdf', '.bmp', '.webp', '.tiff', '.tif']
    const ext = path.extname(file.originalname).toLowerCase()
    if (allowed.includes(ext)) cb(null, true)
    else cb(new Error('仅支持 JPG/PNG/PDF/BMP/WEBP/TIFF 格式'))
  },
 })
 /**
 * 上传线下签署扫描件
 * 支持多文件上传，返回文件URL列表
 */
 router.post('/paper-upload', authMiddleware, paperSignUpload.array('files', 10), async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const files = req.files as Express.Multer.File[]
    if (!files || files.length === 0) {
      return res.status(400).json({ success: false, error: { code: 'NO_FILE', message: '请选择文件' } })
    }
    const fileUrls = files.map(f => ({
      name: f.originalname,
      url: `/uploads/paper-sign/${f.filename}`,
      size: f.size,
    }))
    res.json({ success: true, data: fileUrls })
  } catch (err) { next(err) }
 })
 /** 线下手签登记 Schema */
 const paperSignSchema = z.object({
  employeeId: z.string().min(1),
  contractId: z.string().optional(),
  scene: z.string().default('CONTRACT'),
  documentTitle: z.string().min(1),
  signedAt: z.string().min(1), // 签署日期
  signedLocation: z.string().optional(), // 签署地点
  witnessName: z.string().optional(), // 见证人姓名
  witnessPhone: z.string().optional(), // 见证人手机号
  scanFileUrls: z.array(z.object({
    name: z.string(),
    url: z.string(),
  })).min(1, '至少上传一份签署扫描件'),
  remark: z.string().optional(),
 })
 /**
 * 线下手签登记
 * - 创建 ESignRecord（signMethod=PAPER, status=COMPLETED）
 * - 保存签署信息（签署日期/地点/见证人/扫描件）
 * - 创建证据链（线下签署登记事件）
 * - 回写合同签署方式
 */
 router.post('/paper-sign', authMiddleware, async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const data = paperSignSchema.parse(req.body)
    // 获取员工信息
    const employee = await prisma.employee.findFirst({
      where: { id: data.employeeId, orgId: req.user!.orgId },
      select: { id: true, name: true, department: true },
    })
    if (!employee) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '员工不存在' } })
    }
    // 创建签署记录（线下手签直接为 COMPLETED 状态）
    const record = await prisma.eSignRecord.create({
      data: {
        orgId: req.user!.orgId,
        contractId: data.contractId || null,
        employeeId: data.employeeId,
        scene: data.scene,
        signMethod: 'PAPER',
        documentTitle: data.documentTitle,
        status: 'COMPLETED',
        initiatedBy: req.user!.id,
        createdBy: req.user!.id,
        remark: data.remark || null,
        completedAt: new Date(data.signedAt),
        expiredAt: new Date(Date.now() + 365 * 24 * 60 * 60 * 1000), // 线下签署记录保留1年
        // 线下手签专用字段
        signedAt: new Date(data.signedAt),
        signedLocation: data.signedLocation || null,
        witnessName: data.witnessName || null,
        witnessPhone: data.witnessPhone || null,
        scanFileUrls: data.scanFileUrls as any,
        // 签署证据
        callbackData: {
          signMethod: 'PAPER',
          signedAt: data.signedAt,
          signedLocation: data.signedLocation,
          witnessName: data.witnessName,
          witnessPhone: data.witnessPhone,
          scanFileCount: data.scanFileUrls.length,
          registeredBy: req.user!.id,
          registeredAt: new Date().toISOString(),
        } as any,
      },
    })
    // 创建证据链 — 线下签署登记
    await createEvidence({
      orgId: req.user!.orgId,
      category: 'CONTRACT_SIGN',
      refId: record.id,
      employeeId: data.employeeId,
      events: [{
        action: `线下手签登记：${data.documentTitle}`,
        timestamp: new Date().toISOString(),
        ip: req.ip,
        userAgent: req.headers['user-agent'] as string,
        location: `签署日期：${data.signedAt.slice(0, 10)}，签署地点：${data.signedLocation || '未填写'}，见证人：${data.witnessName || '无'}，扫描件：${data.scanFileUrls.length}份`,
      }],
      createdBy: req.user!.id,
    }).catch(() => {})
    // 回写合同签署方式
    if (data.contractId) {
      await prisma.laborContract.update({
        where: { id: data.contractId },
        data: {
          signMethod: 'PAPER',
          // 第一份扫描件作为合同附件
          attachmentUrl: data.scanFileUrls[0]?.url || null,
        },
      })
    }
    await auditLog(req, 'PAPER_SIGN_REGISTER', 'ESIGN_RECORD', record.id, {
      employeeId: data.employeeId,
      documentTitle: data.documentTitle,
      signedAt: data.signedAt,
      scanFileCount: data.scanFileUrls.length,
    })
    res.json({
      success: true,
      data: record,
      message: '线下手签登记成功，证据链已记录',
    })
  } catch (err) { next(err) }
 })
 export default router
@@ -287,7 +287,7 @@ router.get('/roster', authMiddleware, async (req: AuthRequest, res: Response, ne
      { header: '状态', key: 'status', width: 8 },
      { header: '入职日期', key: 'hireDate', width: 12 },
      { header: '手机号', key: 'phone', width: 13 },
-      { header: '身份证号', key: 'idCardNumber', width: 20 },
+      { header: '证件号码', key: 'idCardNumber', width: 20 },
      { header: '月工资', key: 'monthlySalary', width: 10 },
      { header: '社保基数', key: 'socialInsBase', width: 10 },
      { header: '公积金基数', key: 'housingFundBase', width: 10 },
@@ -359,9 +359,16 @@ router.get('/terminations', authMiddleware, async (req: AuthRequest, res: Respon
    const status = req.query.status as string | undefined
    const department = req.query.department as string | undefined
    const search = req.query.search as string | undefined
    const dateFrom = req.query.dateFrom as string | undefined
    const dateTo = req.query.dateTo as string | undefined
    const where: any = { orgId }
    if (status) where.status = status
    if (dateFrom || dateTo) {
      where.terminationDate = {}
      if (dateFrom) where.terminationDate.gte = new Date(dateFrom)
      if (dateTo) where.terminationDate.lte = new Date(dateTo + 'T23:59:59')
    }
    if (department || search) {
      where.employee = {}
      if (department) where.employee.department = department
@@ -471,7 +478,7 @@ router.get('/tax-declaration', authMiddleware, requireAdmin, async (req: AuthReq
    let seq = 0
    for (const e of entries) {
      seq++
-      // 解密身份证号
+      // 解密证件号码
      let idCard: string = ''
      try { if (e.employee.idCardNumber) idCard = decrypt(e.employee.idCardNumber) || '' } catch { idCard = e.employee.idCardNumber || '' }
@@ -1,6 +1,7 @@
 import { Router, Response, NextFunction } from 'express'
 import multer from 'multer'
 import * as XLSX from 'xlsx'
 import bcrypt from 'bcryptjs'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import { requireAdmin } from '../middleware/rbac'
 import { encrypt, decrypt, sha256 } from '../lib/crypto'
@@ -18,17 +19,17 @@ function contentDisposition(filename: string): string {
 const router = Router()
 const upload = multer({ storage: multer.memoryStorage(), limits: { fileSize: 10 * 1024 * 1024 } })
-// 身份证号格式校验（18位正则 + 校验位算法）
+// 证件号码格式校验（18位正则 + 校验位算法）
 function validateIdCard(idCard: string): { valid: boolean; upgraded?: string; error?: string } {
  if (!idCard) return { valid: true }
  const s = idCard.trim()
-  // 15位身份证号升级为18位
+  // 15位证件号码升级为18位
  if (/^\d{15}$/.test(s)) {
    const upgraded = upgrade15To18(s)
    return { valid: true, upgraded }
  }
  if (!/^\d{17}[\dXx]$/.test(s)) {
-    return { valid: false, error: '身份证号格式错误（应为18位）' }
+    return { valid: false, error: '证件号码格式错误（应为18位）' }
  }
  // 校验位算法
  const weights = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2]
@@ -36,7 +37,7 @@ function validateIdCard(idCard: string): { valid: boolean; upgraded?: string; er
  const sum = s.substring(0, 17).split('').reduce((acc, ch, i) => acc + parseInt(ch) * weights[i], 0)
  const expected = checkCodes[sum % 11]
  if (s.charAt(17).toUpperCase() !== expected) {
-    return { valid: false, error: '身份证号校验位错误' }
+    return { valid: false, error: '证件号码校验位错误' }
  }
  return { valid: true }
 }
@@ -124,7 +125,7 @@ router.post('/excel/preview', authMiddleware, requireAdmin, upload.single('file'
      const rows = XLSX.utils.sheet_to_json(empSheet)
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
-        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), department: val(getField(r, '部门')) || '未分配', hireDate: getField(r, '入职日期'), salary: num(getField(r, '月工资')), phone: val(getField(r, '手机号')), idCard: val(getField(r, '身份证号')), city: val(getField(r, '参保城市')) || null, status: 'normal', errors: [] as string[], warnings: [] as string[] }
+        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), department: val(getField(r, '部门')) || '未分配', hireDate: getField(r, '入职日期'), salary: num(getField(r, '月工资')), phone: val(getField(r, '手机号')), idCard: val(getField(r, '证件号码')), city: val(getField(r, '参保城市')) || null, status: 'normal', errors: [] as string[], warnings: [] as string[] }
        if (!row.name) { row.status = 'error'; row.errors.push('姓名为空') }
        const hireDate = parseDate(getField(r, '入职日期'))
        if (!hireDate) { row.status = 'error'; row.errors.push('入职日期格式错误') }
@@ -144,8 +145,8 @@ router.post('/excel/preview', authMiddleware, requireAdmin, upload.single('file'
      const rows = XLSX.utils.sheet_to_json(contractSheet)
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
-        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), idCard: val(getField(r, '身份证号')), contractType: val(getField(r, '合同类型')), startDate: getField(r, '合同开始日期'), endDate: getField(r, '合同结束日期'), status: 'normal', errors: [] as string[] }
+        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), idCard: val(getField(r, '证件号码')), contractType: val(getField(r, '合同类型')), startDate: getField(r, '合同开始日期'), endDate: getField(r, '合同结束日期'), status: 'normal', errors: [] as string[] }
-        if (!row.name && !row.idCard) { row.status = 'error'; row.errors.push('姓名和身份证号都为空') }
+        if (!row.name && !row.idCard) { row.status = 'error'; row.errors.push('姓名和证件号码都为空') }
        const sd = parseDate(getField(r, '合同开始日期'))
        if (!sd) { row.status = 'error'; row.errors.push('开始日期格式错误') }
        if (row.status === 'error') preview.errors.push({ sheet: '劳动合同', row: i + 2, name: row.name, errors: row.errors })
@@ -159,8 +160,8 @@ router.post('/excel/preview', authMiddleware, requireAdmin, upload.single('file'
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
        const otType = val(getField(r, '加班类型')) || '工作日加班'
-        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), idCard: val(getField(r, '身份证号')), date: getField(r, '日期'), hours: num(getField(r, '加班时长')), otType, status: 'normal', errors: [] as string[] }
+        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), idCard: val(getField(r, '证件号码')), date: getField(r, '日期'), hours: num(getField(r, '加班时长')), otType, status: 'normal', errors: [] as string[] }
-        if (!row.name && !row.idCard) { row.status = 'error'; row.errors.push('姓名和身份证号都为空') }
+        if (!row.name && !row.idCard) { row.status = 'error'; row.errors.push('姓名和证件号码都为空') }
        const dt = parseDate(getField(r, '日期'))
        if (!dt) { row.status = 'error'; row.errors.push('日期格式错误') }
        if (row.status === 'error') preview.errors.push({ sheet: '加班记录', row: i + 2, name: row.name, errors: row.errors })
@@ -173,8 +174,8 @@ router.post('/excel/preview', authMiddleware, requireAdmin, upload.single('file'
      const rows = XLSX.utils.sheet_to_json(discSheet)
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
-        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), idCard: val(getField(r, '身份证号')), date: getField(r, '日期'), violationType: val(getField(r, '违纪类型')), description: val(getField(r, '描述')), status: 'normal', errors: [] as string[] }
+        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), idCard: val(getField(r, '证件号码')), date: getField(r, '日期'), violationType: val(getField(r, '违纪类型')), description: val(getField(r, '描述')), status: 'normal', errors: [] as string[] }
-        if (!row.name && !row.idCard) { row.status = 'error'; row.errors.push('姓名和身份证号都为空') }
+        if (!row.name && !row.idCard) { row.status = 'error'; row.errors.push('姓名和证件号码都为空') }
        if (row.status === 'error') preview.errors.push({ sheet: '违纪记录', row: i + 2, name: row.name, errors: row.errors })
        preview.disciplinary.push(row)
      }
@@ -185,8 +186,8 @@ router.post('/excel/preview', authMiddleware, requireAdmin, upload.single('file'
      const rows = XLSX.utils.sheet_to_json(attSheet)
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
-        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), idCard: val(getField(r, '身份证号')), date: getField(r, '日期'), attStatus: val(getField(r, '考勤状态')), status: 'normal', errors: [] as string[] }
+        const row: any = { rowNo: i + 2, name: val(getField(r, '姓名')), idCard: val(getField(r, '证件号码')), date: getField(r, '日期'), attStatus: val(getField(r, '考勤状态')), status: 'normal', errors: [] as string[] }
-        if (!row.name && !row.idCard) { row.status = 'error'; row.errors.push('姓名和身份证号都为空') }
+        if (!row.name && !row.idCard) { row.status = 'error'; row.errors.push('姓名和证件号码都为空') }
        const dt = parseDate(getField(r, '日期'))
        if (!dt) { row.status = 'error'; row.errors.push('日期格式错误') }
        if (row.status === 'error') preview.errors.push({ sheet: '考勤记录', row: i + 2, name: row.name, errors: row.errors })
@@ -259,14 +260,42 @@ router.post('/excel', authMiddleware, requireAdmin, upload.single('file'), async
          const salary = String(num(getField(r, '月工资')))
          if (salary === '0') { result.skipped++; result.errors.push(`员工第${i + 2}行：月工资为空`); result.details.push({ sheet: '员工信息', row: i + 2, name, status: 'skipped', message: '月工资为空' }); continue }
-          let idCard = val(getField(r, '身份证号'))
+          let idCard = val(getField(r, '证件号码'))
-          if (!idCard) { result.skipped++; result.errors.push(`员工第${i + 2}行：身份证号为空，跳过`); result.details.push({ sheet: '员工信息', row: i + 2, name, status: 'skipped', message: '身份证号为空' }); continue }
+          if (!idCard) { result.skipped++; result.errors.push(`员工第${i + 2}行：证件号码为空，跳过`); result.details.push({ sheet: '员工信息', row: i + 2, name, status: 'skipped', message: '证件号码为空' }); continue }
          if (idCard) {
            const idCheck = validateIdCard(idCard)
            if (!idCheck.valid) { result.skipped++; result.errors.push(`员工第${i + 2}行：${idCheck.error}`); result.details.push({ sheet: '员工信息', row: i + 2, name, status: 'skipped', message: idCheck.error }); continue }
            if (idCheck.upgraded) idCard = idCheck.upgraded
          }
          // 同企业内身份证查重
          if (idCard) {
            const idCardExists = await prisma.employee.findFirst({
              where: { orgId, idCardHash: sha256(idCard) },
              select: { id: true, name: true },
            })
            if (idCardExists) {
              result.skipped++
              result.errors.push(`员工第${i + 2}行：证件号码已存在（${idCardExists.name}），跳过`)
              result.details.push({ sheet: '员工信息', row: i + 2, name, status: 'skipped', message: '证件号码已存在' })
              continue
            }
          }
          // 同企业内手机号查重
          const importPhone = val(getField(r, '手机号'))
          if (importPhone) {
            const phoneExists = await prisma.employee.findFirst({
              where: { orgId, phone: importPhone },
              select: { id: true, name: true },
            })
            if (phoneExists) {
              result.skipped++
              result.errors.push(`员工第${i + 2}行：手机号已存在（${phoneExists.name}），跳过`)
              result.details.push({ sheet: '员工信息', row: i + 2, name, status: 'skipped', message: '手机号已存在' })
              continue
            }
          }
          // 社保基数：值为 0 或「无」表示不参保
          const socialInsBaseVal = num(getField(r, '社保基数'))
          const socialInsOptOut = val(getField(r, '社保基数')) === '无' || val(getField(r, '社保基数')) === '不缴'
@@ -277,6 +306,11 @@ router.post('/excel', authMiddleware, requireAdmin, upload.single('file'), async
          const housingFundOptOut = val(getField(r, '公积金基数')) === '无' || val(getField(r, '公积金基数')) === '不缴'
          const housingFundBase = housingFundOptOut ? 0 : (housingFundBaseVal || num(salary))
          // 默认密码：手机号后6位（无手机号则 123456）
          const importPhoneVal = val(getField(r, '手机号')) || null
          const defaultPwd = importPhoneVal ? importPhoneVal.slice(-6) : '123456'
          const importPasswordHash = await bcrypt.hash(defaultPwd, 10)
          const emp = await prisma.employee.create({
            data: {
              orgId, name, department: dept, hireDate,
@@ -284,7 +318,8 @@ router.post('/excel', authMiddleware, requireAdmin, upload.single('file'), async
              gender: val(getField(r, '性别')) || (idCard ? extractGenderFromIdCard(idCard) : null),
              femaleWorkerType: (val(getField(r, '女性岗位类型')) === '工人' || val(getField(r, '女性岗位类型')) === 'WORKER') ? 'WORKER'
                : (val(getField(r, '女性岗位类型')) === '干部' || val(getField(r, '女性岗位类型')) === 'CADRE') ? 'CADRE' : null,
-              phone: val(getField(r, '手机号')) || null,
+              phone: importPhoneVal,
              passwordHash: importPasswordHash,
              idCardNumber: idCard ? encrypt(idCard) : null,
              idCardHash: idCard ? sha256(idCard) : null,
              birthDate: idCard ? extractBirthDateFromIdCard(idCard) : null,
@@ -329,8 +364,8 @@ router.post('/excel', authMiddleware, requireAdmin, upload.single('file'), async
          const msg = e?.message || ''
          if (msg.includes('Unique constraint')) {
            result.duplicates++
-            result.errors.push(`员工第${i + 2}行：该员工已存在（身份证号重复），跳过`)
+            result.errors.push(`员工第${i + 2}行：该员工已存在（证件号码重复），跳过`)
-            result.details.push({ sheet: '员工信息', row: i + 2, name, status: 'duplicate', message: '身份证号重复' })
+            result.details.push({ sheet: '员工信息', row: i + 2, name, status: 'duplicate', message: '证件号码重复' })
          } else if (msg.includes('invalid') || msg.includes('validation')) {
            result.skipped++
            result.errors.push(`员工第${i + 2}行：数据格式不正确，请检查各项填写`)
@@ -353,7 +388,7 @@ router.post('/excel', authMiddleware, requireAdmin, upload.single('file'), async
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
        try {
-          const idCard = val(getField(r, '身份证号'))
+          const idCard = val(getField(r, '证件号码'))
          const empId = idCard ? empByHash.get(sha256(idCard)) : empByName.get(val(getField(r, '姓名')))
          if (!empId) { result.errors.push(`合同第${i + 2}行：找不到员工「${val(getField(r, '姓名'))}」`); continue }
          const startDate = parseDate(getField(r, '合同开始日期'))
@@ -399,7 +434,7 @@ router.post('/excel', authMiddleware, requireAdmin, upload.single('file'), async
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
        try {
-          const idCard = val(getField(r, '身份证号'))
+          const idCard = val(getField(r, '证件号码'))
          const empId = idCard ? empByHash.get(sha256(idCard)) : empByName.get(val(getField(r, '姓名')))
          if (!empId) { result.errors.push(`加班第${i + 2}行：找不到员工「${val(getField(r, '姓名'))}」`); continue }
          const date = parseDate(getField(r, '日期'))
@@ -429,7 +464,7 @@ router.post('/excel', authMiddleware, requireAdmin, upload.single('file'), async
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
        try {
-          const idCard = val(getField(r, '身份证号'))
+          const idCard = val(getField(r, '证件号码'))
          const empId = idCard ? empByHash.get(sha256(idCard)) : empByName.get(val(getField(r, '姓名')))
          if (!empId) { result.errors.push(`违纪第${i + 2}行：找不到员工「${val(getField(r, '姓名'))}」`); continue }
          const date = parseDate(getField(r, '日期'))
@@ -462,7 +497,7 @@ router.post('/excel', authMiddleware, requireAdmin, upload.single('file'), async
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
        try {
-          const idCard = val(getField(r, '身份证号'))
+          const idCard = val(getField(r, '证件号码'))
          const empId = idCard ? empByHash.get(sha256(idCard)) : empByName.get(val(getField(r, '姓名')))
          if (!empId) { result.errors.push(`考勤第${i + 2}行：找不到员工「${val(getField(r, '姓名'))}」`); continue }
          const date = parseDate(getField(r, '日期'))
@@ -495,30 +530,30 @@ router.get('/template', authMiddleware, async (_req: AuthRequest, res: Response)
  const wb = XLSX.utils.book_new()
  const empData = [
-    { '姓名*': '张三', '部门': '技术部', '性别（选填，留空自动识别）': '男', '手机号': '13800138000', '身份证号': '110101199001011234', '入职日期*': '2023-03-01', '月工资*': 10000, '社保基数': 10000, '公积金基数': 10000, '专项附加扣除': 1000, '参保城市': '北京', '紧急联系人': '李四', '紧急联系电话': '13900139000', '住址': '北京市朝阳区', '开户行': '工商银行', '银行账号': '6222021234567890', '孕期': '否', '医疗期': '否', '工伤': '否' },
+    { '姓名*': '张三', '部门': '技术部', '性别（选填，留空自动识别）': '男', '手机号': '13800138000', '证件号码': '110101199001011234', '入职日期*': '2023-03-01', '月工资*': 10000, '社保基数': 10000, '公积金基数': 10000, '专项附加扣除': 1000, '参保城市': '北京', '紧急联系人': '李四', '紧急联系电话': '13900139000', '住址': '北京市朝阳区', '开户行': '工商银行', '银行账号': '6222021234567890', '孕期': '否', '医疗期': '否', '工伤': '否' },
  ]
-  const empWs = XLSX.utils.json_to_sheet(empData, { header: ['姓名*', '部门', '性别（选填，留空自动识别）', '手机号', '身份证号', '入职日期*', '月工资*', '社保基数', '公积金基数', '专项附加扣除', '参保城市', '紧急联系人', '紧急联系电话', '住址', '开户行', '银行账号', '孕期', '医疗期', '工伤'] })
+  const empWs = XLSX.utils.json_to_sheet(empData, { header: ['姓名*', '部门', '性别（选填，留空自动识别）', '手机号', '证件号码', '入职日期*', '月工资*', '社保基数', '公积金基数', '专项附加扣除', '参保城市', '紧急联系人', '紧急联系电话', '住址', '开户行', '银行账号', '孕期', '医疗期', '工伤'] })
  // 设置示例行样式（灰色背景）
  empWs['!cols'] = [{ wch: 10 }, { wch: 12 }, { wch: 22 }, { wch: 13 }, { wch: 20 }, { wch: 12 }, { wch: 10 }, { wch: 10 }, { wch: 10 }, { wch: 12 }, { wch: 10 }, { wch: 10 }, { wch: 13 }, { wch: 18 }, { wch: 10 }, { wch: 18 }, { wch: 6 }, { wch: 6 }, { wch: 6 }]
  XLSX.utils.book_append_sheet(wb, empWs, '员工信息')
  const contractData = [
-    { '姓名*': '张三', '身份证号': '110101199001011234', '合同类型': '固定期限', '签订日期': '2023-03-01', '合同开始日期*': '2023-03-01', '合同结束日期': '2026-03-01', '合同年限': 3, '签订方式': '纸质', '试用期月数': 3, '试用期工资': 8000 },
+    { '姓名*': '张三', '证件号码': '110101199001011234', '合同类型': '固定期限', '签订日期': '2023-03-01', '合同开始日期*': '2023-03-01', '合同结束日期': '2026-03-01', '合同年限': 3, '签订方式': '纸质', '试用期月数': 3, '试用期工资': 8000 },
  ]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(contractData), '劳动合同')
  const otData = [
-    { '姓名*': '张三', '身份证号': '110101199001011234', '日期*': '2024-01-15', '工作日加班时长': 2, '休息日加班时长': 0, '法定节假日加班时长': 0, '加班类型': '工作日加班', '加班时长': 2, '倍率': 1.5, '是否审批': '是' },
+    { '姓名*': '张三', '证件号码': '110101199001011234', '日期*': '2024-01-15', '工作日加班时长': 2, '休息日加班时长': 0, '法定节假日加班时长': 0, '加班类型': '工作日加班', '加班时长': 2, '倍率': 1.5, '是否审批': '是' },
  ]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(otData), '加班记录')
  const discData = [
-    { '姓名*': '张三', '身份证号': '110101199001011234', '日期*': '2024-01-10', '违纪类型': '警告', '描述': '迟到', '处罚': '口头警告' },
+    { '姓名*': '张三', '证件号码': '110101199001011234', '日期*': '2024-01-10', '违纪类型': '警告', '描述': '迟到', '处罚': '口头警告' },
  ]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(discData), '违纪记录')
  const attData = [
-    { '姓名*': '张三', '身份证号': '110101199001011234', '日期*': '2024-01-15', '考勤状态': '正常', '上班时间': '09:00', '下班时间': '18:00', '备注': '' },
+    { '姓名*': '张三', '证件号码': '110101199001011234', '日期*': '2024-01-15', '考勤状态': '正常', '上班时间': '09:00', '下班时间': '18:00', '备注': '' },
  ]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(attData), '考勤记录')
@@ -541,14 +576,24 @@ router.post('/monthly', authMiddleware, requireAdmin, upload.single('file'), asy
    }
    const wb = XLSX.read(req.file.buffer, { type: 'buffer', cellDates: true })
-    const result: any = { month, attendance: 0, overtime: 0, salaryChanges: 0, socialInsChanges: 0, housingFundChanges: 0, errors: [] as string[], strategies: { '考勤记录': '覆盖（同员工同日覆盖）', '加班记录': '累加（同员工同月累加）', '薪资调整': '覆盖（关闭旧记录，新建新记录）', '社保变动': '覆盖（关闭旧记录，新建新记录）', '公积金变动': '覆盖（关闭旧记录，新建新记录）' } }
+    const result: any = { month, attendance: 0, overtime: 0, discipline: 0, salaryChanges: 0, socialInsChanges: 0, housingFundChanges: 0, errors: [] as string[], strategies: { '考勤记录': '覆盖（同员工同日覆盖）', '加班记录': '累加（同员工同月累加）', '违纪记录': '追加（同员工同日可多条）', '薪资调整': '覆盖（关闭旧记录，新建新记录）', '社保变动': '覆盖（关闭旧记录，新建新记录）', '公积金变动': '覆盖（关闭旧记录，新建新记录）' } }
    const employees = await prisma.employee.findMany({ where: { orgId }, select: { id: true, name: true, monthlySalary: true, department: true, idCardHash: true } })
    const empByHash = new Map(employees.filter(e => e.idCardHash).map(e => [e.idCardHash, e]))
    const empByName = new Map(employees.map(e => [e.name, e]))
    // 获取加班费配置，用于自动计算 totalPay
    const otConfig = await prisma.overtimeConfig.findUnique({ where: { orgId } }) ?? { weekdayRate: 1.5, weekendRate: 2.0, holidayRate: 3.0, monthlyDays: 21.75, dailyHours: 8 }
    function calcOvertimePay(monthlyWage: number, wdHours: number, weHours: number, hoHours: number) {
      const hourlyWage = (monthlyWage || 0) / otConfig.monthlyDays / otConfig.dailyHours
      const weekdayPay = hourlyWage * otConfig.weekdayRate * wdHours
      const weekendPay = hourlyWage * otConfig.weekendRate * weHours
      const holidayPay = hourlyWage * otConfig.holidayRate * hoHours
      return Math.round((weekdayPay + weekendPay + holidayPay) * 100) / 100
    }
    function findEmp(r: any) {
-      const idCard = val(getField(r, '身份证号'))
+      const idCard = val(getField(r, '证件号码'))
      if (idCard) {
        const emp = empByHash.get(sha256(idCard))
        if (emp) return emp
@@ -556,8 +601,59 @@ router.post('/monthly', authMiddleware, requireAdmin, upload.single('file'), asy
      return empByName.get(val(getField(r, '姓名')))
    }
-    // 考勤记录
+    // 考勤记录 + 加班记录（支持合并Sheet"考勤与加班"或独立Sheet）
    const mergedSheet = wb.Sheets['考勤与加班']
    const attSheet = wb.Sheets['考勤记录']
    const otSheet = wb.Sheets['加班记录']
    const statusMap: any = { '正常': 'NORMAL', '迟到': 'LATE', '早退': 'EARLY_LEAVE', '缺勤': 'ABSENT', '请假': 'LEAVE', '出差': 'BUSINESS_TRIP' }
    if (mergedSheet) {
      // 合并Sheet：每行同时处理考勤和加班
      const rows = XLSX.utils.sheet_to_json(mergedSheet)
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
        try {
          const emp = findEmp(r)
          if (!emp) { result.errors.push(`第${i + 2}行：找不到员工「${val(getField(r, '姓名'))}」`); continue }
          const date = parseDate(getField(r, '日期'))
          if (!date) { result.errors.push(`第${i + 2}行：日期格式错误`); continue }
          // 考勤部分
          const attStatus = val(getField(r, '考勤状态'))
          if (attStatus || val(getField(r, '上班时间')) || val(getField(r, '下班时间'))) {
            await prisma.attendanceRecord.upsert({
              where: { employeeId_date: { employeeId: emp.id, date } },
              create: { orgId, employeeId: emp.id, date, status: statusMap[attStatus] || 'NORMAL', checkInTime: val(getField(r, '上班时间')) || null, checkOutTime: val(getField(r, '下班时间')) || null, remark: val(getField(r, '备注')) || null, createdBy: userId },
              update: { status: statusMap[attStatus] || 'NORMAL', checkInTime: val(getField(r, '上班时间')) || null, checkOutTime: val(getField(r, '下班时间')) || null, remark: val(getField(r, '备注')) || null },
            })
            result.attendance++
          }
          // 加班部分
          const wdHours = num(getField(r, '工作日加班时长'))
          const weHours = num(getField(r, '休息日加班时长'))
          const hoHours = num(getField(r, '法定节假日加班时长'))
          if (wdHours > 0 || weHours > 0 || hoHours > 0) {
            const otMonth = dateToMonth(date)
            let monthlyWage = 0
            try { monthlyWage = Number(decrypt(emp.monthlySalary)) || 0 } catch { monthlyWage = Number(emp.monthlySalary) || 0 }
            const totalPay = calcOvertimePay(monthlyWage, wdHours, weHours, hoHours)
            await prisma.overtimeRecord.upsert({
              where: { employeeId_month: { employeeId: emp.id, month: otMonth } },
              create: { orgId, employeeId: emp.id, month: otMonth, weekdayHours: wdHours, weekendHours: weHours, holidayHours: hoHours, totalPay } as any,
              update: {
                weekdayHours: { increment: wdHours },
                weekendHours: { increment: weHours },
                holidayHours: { increment: hoHours },
                totalPay: { increment: totalPay },
              },
            })
            result.overtime++
          }
        } catch (e: any) { result.errors.push(`第${i + 2}行：${e?.message || '导入失败'}`) }
      }
    } else {
      // 向后兼容：独立Sheet
      if (attSheet) {
        const rows = XLSX.utils.sheet_to_json(attSheet)
        for (let i = 0; i < rows.length; i++) {
@@ -567,7 +663,6 @@ router.post('/monthly', authMiddleware, requireAdmin, upload.single('file'), asy
            if (!emp) { result.errors.push(`考勤第${i + 2}行：找不到员工「${val(getField(r, '姓名'))}」`); continue }
            const date = parseDate(getField(r, '日期'))
            if (!date) { result.errors.push(`考勤第${i + 2}行：日期格式错误`); continue }
          const statusMap: any = { '正常': 'NORMAL', '迟到': 'LATE', '早退': 'EARLY_LEAVE', '缺勤': 'ABSENT', '请假': 'LEAVE', '出差': 'BUSINESS_TRIP' }
            await prisma.attendanceRecord.upsert({
              where: { employeeId_date: { employeeId: emp.id, date } },
              create: { orgId, employeeId: emp.id, date, status: statusMap[val(getField(r, '考勤状态'))] || 'NORMAL', checkInTime: val(getField(r, '上班时间')) || null, checkOutTime: val(getField(r, '下班时间')) || null, remark: val(getField(r, '备注')) || null, createdBy: userId },
@@ -578,8 +673,6 @@ router.post('/monthly', authMiddleware, requireAdmin, upload.single('file'), asy
        }
      }
    // 加班记录
    const otSheet = wb.Sheets['加班记录']
      if (otSheet) {
        const rows = XLSX.utils.sheet_to_json(otSheet)
        for (let i = 0; i < rows.length; i++) {
@@ -595,19 +688,24 @@ router.post('/monthly', authMiddleware, requireAdmin, upload.single('file'), asy
            const wdHours = num(getField(r, '工作日加班时长')) || (otType.includes('工作日') ? hours : 0)
            const weHours = num(getField(r, '休息日加班时长')) || (otType.includes('休息日') ? hours : 0)
            const hoHours = num(getField(r, '法定节假日加班时长')) || (otType.includes('法定') ? hours : 0)
            let monthlyWage = 0
            try { monthlyWage = Number(decrypt(emp.monthlySalary)) || 0 } catch { monthlyWage = Number(emp.monthlySalary) || 0 }
            const totalPay = calcOvertimePay(monthlyWage, wdHours, weHours, hoHours)
            await prisma.overtimeRecord.upsert({
              where: { employeeId_month: { employeeId: emp.id, month: otMonth } },
-            create: { orgId, employeeId: emp.id, month: otMonth, weekdayHours: wdHours, weekendHours: weHours, holidayHours: hoHours } as any,
+              create: { orgId, employeeId: emp.id, month: otMonth, weekdayHours: wdHours, weekendHours: weHours, holidayHours: hoHours, totalPay } as any,
              update: {
                weekdayHours: { increment: wdHours },
                weekendHours: { increment: weHours },
                holidayHours: { increment: hoHours },
                totalPay: { increment: totalPay },
              },
            })
            result.overtime++
          } catch (e: any) { result.errors.push(`加班第${i + 2}行：${e?.message || '导入失败'}`) }
        }
      }
    }
    // 薪资调整
    const salarySheet = wb.Sheets['薪资调整']
@@ -685,6 +783,27 @@ router.post('/monthly', authMiddleware, requireAdmin, upload.single('file'), asy
      }
    }
    // 违纪记录
    const discSheet = wb.Sheets['违纪记录']
    if (discSheet) {
      const rows = XLSX.utils.sheet_to_json(discSheet)
      for (let i = 0; i < rows.length; i++) {
        const r = rows[i] as any
        try {
          const emp = findEmp(r)
          if (!emp) { result.errors.push(`违纪第${i + 2}行：找不到员工「${val(getField(r, '姓名'))}」`); continue }
          const date = parseDate(getField(r, '日期'))
          if (!date) { result.errors.push(`违纪第${i + 2}行：日期格式错误`); continue }
          const typeMap: any = { '迟到': 'LATE', '旷工': 'ABSENT', '不服从': 'INSUBORDINATION', '违纪': 'MISCONDUCT', '违规': 'VIOLATE_POLICY', '其他': 'OTHER' }
          const actMap: any = { '口头警告': 'ORAL_WARNING', '书面警告': 'WRITTEN_WARNING', '扣款': 'DEDUCTION', '降级': 'DEMOTION', '辞退': 'TERMINATION' }
          await prisma.disciplinaryRecord.create({
            data: { orgId, employeeId: emp.id, violationDate: date, violationType: typeMap[val(getField(r, '违纪类型'))] || 'OTHER', description: val(getField(r, '描述')) || '', action: actMap[val(getField(r, '处罚'))] || 'ORAL_WARNING', createdBy: userId },
          })
          result.discipline++
        } catch (e: any) { result.errors.push(`违纪第${i + 2}行：${e?.message || '导入失败'}`) }
      }
    }
    res.json({ success: true, data: result })
  } catch (err) {
    next(err)
@@ -694,24 +813,41 @@ router.post('/monthly', authMiddleware, requireAdmin, upload.single('file'), asy
 router.get('/monthly-template', authMiddleware, async (_req: AuthRequest, res: Response) => {
  const wb = XLSX.utils.book_new()
-  const attData = [{ '姓名': '张三', '身份证号': '110101199001011234', '日期': '2024-06-01', '考勤状态': '正常', '上班时间': '09:00', '下班时间': '18:00', '备注': '' }]
+  // 合并考勤+加班为一个Sheet，减少重复录入姓名证件号码
-  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(attData), '考勤记录')
+  const attOtData = [{
    '姓名': '张三',
    '证件号码': '110101199001011234',
    '日期': '2024-06-01',
    '考勤状态': '正常',
    '上班时间': '09:00',
    '下班时间': '18:00',
    '工作日加班时长': 0,
    '休息日加班时长': 0,
    '法定节假日加班时长': 0,
    '备注': '',
  }]
  const attOtWs = XLSX.utils.json_to_sheet(attOtData)
  attOtWs['!cols'] = [
    { wch: 10 }, { wch: 20 }, { wch: 12 }, { wch: 10 }, { wch: 8 }, { wch: 8 },
    { wch: 14 }, { wch: 14 }, { wch: 16 }, { wch: 12 },
  ]
  XLSX.utils.book_append_sheet(wb, attOtWs, '考勤与加班')
-  const otData = [{ '姓名': '张三', '身份证号': '110101199001011234', '日期': '2024-06-15', '工作日加班时长': 2, '休息日加班时长': 0, '法定节假日加班时长': 0, '加班时长': 2, '加班类型': '工作日加班' }]
+  const salaryData = [{ '姓名': '张三', '证件号码': '110101199001011234', '调整后月薪': 12000, '生效日期': '2024-06-01', '调薪原因': '年度调薪' }]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(otData), '加班记录')
  const salaryData = [{ '姓名': '张三', '身份证号': '110101199001011234', '调整后月薪': 12000, '生效日期': '2024-06-01', '调薪原因': '年度调薪' }]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(salaryData), '薪资调整')
-  const socialData = [{ '姓名': '张三', '身份证号': '110101199001011234', '变动类型': '调基', '缴费基数': 12000 }]
+  const socialData = [{ '姓名': '张三', '证件号码': '110101199001011234', '变动类型': '调基', '缴费基数': 12000 }]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(socialData), '社保变动')
-  const hfData = [{ '姓名': '张三', '身份证号': '110101199001011234', '变动类型': '调基', '缴费基数': 12000 }]
+  const hfData = [{ '姓名': '张三', '证件号码': '110101199001011234', '变动类型': '调基', '缴费基数': 12000 }]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(hfData), '公积金变动')
  const discData = [{ '姓名': '张三', '证件号码': '110101199001011234', '日期': '2024-06-10', '违纪类型': '警告', '描述': '迟到', '处罚': '口头警告' }]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(discData), '违纪记录')
  const buf = XLSX.write(wb, { type: 'buffer', bookType: 'xlsx' })
  res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
-  res.setHeader('Content-Disposition', contentDisposition('月度增减员导入模板.xlsx'))
+  res.setHeader('Content-Disposition', contentDisposition('考勤月度导入模板.xlsx'))
  res.send(buf)
 })
@@ -746,7 +882,7 @@ router.post('/payroll', authMiddleware, upload.single('file'), async (req: AuthR
    for (let i = 0; i < rows.length; i++) {
      const r = rows[i] as any
      try {
-        const idCard = val(getField(r, '身份证号'))
+        const idCard = val(getField(r, '证件号码'))
        const empId = idCard ? empByHash.get(sha256(idCard)) : empByName.get(val(getField(r, '姓名')))
        if (!empId) { result.errors.push(`第${i + 2}行：找不到员工「${val(getField(r, '姓名'))}」`); continue }
        const entryId = entryByEmp.get(empId)
@@ -762,7 +898,8 @@ router.post('/payroll', authMiddleware, upload.single('file'), async (req: AuthR
        // 重新计算税费
        const calcResult = await calcBatchEntry(orgId, empId, batch.month, inputs, batch.type)
-        await prisma.batchEntry.update({ where: { id: entryId }, data: { ...inputs, ...calcResult } })
+        const { systemSocialEmp: _sse, systemSocialOrg: _sso, systemHousingEmp: _she, systemHousingOrg: _sho, taxBreakdown: _tb, ...entryData } = calcResult
        await prisma.batchEntry.update({ where: { id: entryId }, data: { ...inputs, ...entryData } })
        result.updated++
      } catch (e: any) {
        result.errors.push(`第${i + 2}行：${e?.message || '导入失败'}`)
@@ -804,8 +941,8 @@ router.post('/payroll', authMiddleware, upload.single('file'), async (req: AuthR
 router.get('/payroll-template', authMiddleware, (_req: AuthRequest, res: Response) => {
  const wb = XLSX.utils.book_new()
  const data = [
-    { '姓名*': '张三', '身份证号*': '110101199001011234', '基本工资': 10000, '加班费': 500, '津贴': 800, '扣款': 0, '奖金': 2000 },
+    { '姓名*': '张三', '证件号码*': '110101199001011234', '基本工资': 10000, '加班费': 500, '津贴': 800, '扣款': 0, '奖金': 2000 },
-    { '姓名*': '李四', '身份证号*': '110101199002021234', '基本工资': 12000, '加班费': 0, '津贴': 600, '扣款': 100, '奖金': 0 },
+    { '姓名*': '李四', '证件号码*': '110101199002021234', '基本工资': 12000, '加班费': 0, '津贴': 600, '扣款': 100, '奖金': 0 },
  ]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(data), '工资表')
  const buf = XLSX.write(wb, { type: 'buffer', bookType: 'xlsx' })
@@ -819,8 +956,8 @@ router.get('/payroll-template', authMiddleware, (_req: AuthRequest, res: Respons
 router.get('/special-deduction/template', authMiddleware, (_req: AuthRequest, res: Response) => {
  const wb = XLSX.utils.book_new()
  const data = [
-    { '姓名*': '张三', '身份证号': '110101199001011234', '子女教育': 1000, '赡养老人': 2000, '住房': 1500, '继续教育': 0, '婴幼儿照护': 0, '备注': '' },
+    { '姓名*': '张三', '证件号码': '110101199001011234', '子女教育': 1000, '赡养老人': 2000, '住房': 1500, '继续教育': 0, '婴幼儿照护': 0, '备注': '' },
-    { '姓名*': '李四', '身份证号': '110101199002021234', '子女教育': 0, '赡养老人': 1000, '住房': 0, '继续教育': 400, '婴幼儿照护': 1000, '备注': '继续教育证书' },
+    { '姓名*': '李四', '证件号码': '110101199002021234', '子女教育': 0, '赡养老人': 1000, '住房': 0, '继续教育': 400, '婴幼儿照护': 1000, '备注': '继续教育证书' },
  ]
  XLSX.utils.book_append_sheet(wb, XLSX.utils.json_to_sheet(data), '专项附加扣除')
  const buf = XLSX.write(wb, { type: 'buffer', bookType: 'xlsx' })
@@ -851,7 +988,7 @@ router.post('/special-deduction', authMiddleware, requireAdmin, upload.single('f
      const r = rows[i] as any
      try {
        const name = val(getField(r, '姓名'))
-        const idCard = val(getField(r, '身份证号'))
+        const idCard = val(getField(r, '证件号码'))
        const empId = idCard ? empByHash.get(sha256(idCard)) : empByName.get(name)
        if (!empId) { result.skipped++; result.errors.push(`第${i + 2}行：找不到员工「${name}」`); result.details.push({ row: i + 2, name, status: 'skipped', message: '找不到员工' }); continue }
@@ -3,6 +3,7 @@ import prisma from '../lib/prisma'
 import { decrypt } from '../lib/crypto'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import { z } from 'zod'
 import { isInProbation } from '../services/contract.service'
 const router = Router()
 router.use(authMiddleware)
@@ -129,6 +130,88 @@ router.put('/overtime/:id', async (req: AuthRequest, res: Response, next: NextFu
  }
 })
 // 从考勤记录同步加班工时
 router.post('/overtime/sync-from-attendance', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { month } = req.body as { month: string }
    if (!month || !/^\d{4}-\d{2}$/.test(month)) {
      return res.status(400).json({ success: false, message: '请提供有效的月份（YYYY-MM）' })
    }
    const monthStart = new Date(month + '-01')
    const monthEnd = new Date(monthStart)
    monthEnd.setMonth(monthEnd.getMonth() + 1)
    // 获取该月所有考勤记录（含加班工时）
    const records = await prisma.attendanceRecord.findMany({
      where: { orgId, date: { gte: monthStart, lt: monthEnd }, overtimeHours: { gt: 0 } },
    })
    if (records.length === 0) {
      return res.json({ success: false, message: '该月考勤记录中无加班工时' })
    }
    // 按员工汇总加班工时，按日期类型分类
    const empMap = new Map<string, { weekday: number; weekend: number; holiday: number }>()
    for (const r of records) {
      const day = new Date(r.date)
      const dayOfWeek = day.getDay() // 0=周日, 6=周六
      let type: 'weekday' | 'weekend' | 'holiday' = 'weekday'
      if (dayOfWeek === 0 || dayOfWeek === 6) {
        type = 'weekend'
      }
      // 简单判断法定节假日：这里使用周末判断，实际法定节假日需要额外配置
      // 如果有 holidayHours 字段在 attendanceRecord 中，优先使用
      if (!empMap.has(r.employeeId)) {
        empMap.set(r.employeeId, { weekday: 0, weekend: 0, holiday: 0 })
      }
      const entry = empMap.get(r.employeeId)!
      entry[type] += r.overtimeHours || 0
    }
    // 获取员工月工资用于计算加班费
    let config = await prisma.overtimeConfig.findUnique({ where: { orgId } })
    if (!config) config = await prisma.overtimeConfig.create({ data: { orgId } })
    let synced = 0
    for (const [employeeId, hours] of empMap) {
      const emp = await prisma.employee.findFirst({ where: { id: employeeId }, select: { monthlySalary: true } })
      let monthlyWage = 0
      try { monthlyWage = emp?.monthlySalary ? Number(decrypt(emp.monthlySalary)) : 0 } catch { monthlyWage = Number(emp?.monthlySalary) || 0 }
      const hourlyWage = monthlyWage / config.monthlyDays / config.dailyHours
      const weekdayPay = hourlyWage * config.weekdayRate * hours.weekday
      const weekendPay = hourlyWage * config.weekendRate * hours.weekend
      const holidayPay = hourlyWage * config.holidayRate * hours.holiday
      const totalPay = weekdayPay + weekendPay + holidayPay
      await prisma.overtimeRecord.upsert({
        where: { employeeId_month: { employeeId, month } },
        update: {
          weekdayHours: hours.weekday,
          weekendHours: hours.weekend,
          holidayHours: hours.holiday,
          weekdayPay, weekendPay, holidayPay, totalPay,
        },
        create: {
          orgId, employeeId, month,
          weekdayHours: hours.weekday,
          weekendHours: hours.weekend,
          holidayHours: hours.holiday,
          weekdayPay, weekendPay, holidayPay, totalPay,
        },
      })
      synced++
    }
    res.json({ success: true, data: { synced, totalEmployees: empMap.size } })
  } catch (err) {
    next(err)
  }
 })
 // ========== 工资条管理 ==========
 const payslipSchema = z.object({
@@ -295,8 +378,11 @@ router.post('/payslip/batch-generate', async (req: AuthRequest, res: Response, n
      const deduction = deductions[emp.id] || 0
      let baseSalary = 0
-      if (emp.contracts[0]?.probationSalary && new Date(emp.contracts[0].startDate) > new Date(Date.now() - 365 * 24 * 60 * 60 * 1000)) {
+      // 按月份判定是否仍在试用期
-        baseSalary = emp.contracts[0].probationSalary
+      const monthEnd = new Date(`${month}-28T23:59:59`)
      const latestContract = emp.contracts[0]
      if (isInProbation(latestContract, monthEnd) && latestContract?.probationSalary > 0) {
        baseSalary = latestContract.probationSalary
      } else if (emp.monthlySalary) {
        try {
          baseSalary = Number(decrypt(emp.monthlySalary)) || 0
@@ -510,8 +596,8 @@ router.post('/tax-preview', async (req: AuthRequest, res: Response, next: NextFu
    ])
    const emp = employee || { socialInsBase: baseSalary, housingFundBase: baseSalary }
-    const socialBase = emp.socialInsBase || baseSalary
+    const socialBase = emp.socialInsBase != null ? emp.socialInsBase : baseSalary
-    const housingBase = emp.housingFundBase || baseSalary
+    const housingBase = emp.housingFundBase != null ? emp.housingFundBase : baseSalary
    // 计算社保公积金
    let socialEmp = 0, housingEmp = 0
@@ -10,6 +10,42 @@ import {
  generatePayslipFromBatches,
  prePayrollCheck,
 } from '../services/payroll.service'
 import { isInProbation } from '../services/contract.service'
 import { getBonusByMonthAndEmployeeIds } from '../services/commission-bonus.service'
 /**
 * 查询上月递延扣款数据（上月已归档批次中该员工的递延金额）
 * 用于本月创建批次时补扣上月未扣完的社保/公积金/最低工资补齐
 */
 async function getPrevDeferred(orgId: string, employeeId: string, currentMonth: string): Promise<{ socialEmp: number; housingEmp: number; minWage: number }> {
  // 计算上月份
  const [y, m] = currentMonth.split('-').map(Number)
  const prevDate = new Date(y, m - 2, 1)
  const prevMonth = `${prevDate.getFullYear()}-${String(prevDate.getMonth() + 1).padStart(2, '0')}`
  // 查上月已归档批次中该员工的递延记录
  const prevEntries = await prisma.batchEntry.findMany({
    where: {
      orgId,
      employeeId,
      batch: { month: prevMonth, status: 'ARCHIVED' },
    },
    select: {
      deferredSocialEmp: true,
      deferredHousingEmp: true,
      deferredMinWage: true,
    },
  })
  // 汇总上月所有批次的递延金额
  const result = {
    socialEmp: prevEntries.reduce((s, e) => s + (e.deferredSocialEmp || 0), 0),
    housingEmp: prevEntries.reduce((s, e) => s + (e.deferredHousingEmp || 0), 0),
    minWage: prevEntries.reduce((s, e) => s + (e.deferredMinWage || 0), 0),
  }
  return result
 }
 // RFC 5987 编码中文文件名
 function contentDisposition(filename: string): string {
@@ -150,7 +186,7 @@ router.get('/batches/archived/list', async (req: AuthRequest, res: Response, nex
 // 获取批次列表
 router.get('/batches', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
-    const { month, monthFrom, monthTo, status, type } = req.query
+    const { month, monthFrom, monthTo, status, type, dateFrom, dateTo } = req.query
    const batches = await prisma.payrollBatch.findMany({
      where: {
        orgId: req.user!.orgId,
@@ -159,8 +195,10 @@ router.get('/batches', async (req: AuthRequest, res: Response, next: NextFunctio
        ...(monthTo ? { month: { lte: String(monthTo) } } : {}),
        ...(status ? { status: String(status) as any } : {}),
        ...(type ? { type: String(type) as any } : {}),
        ...(dateFrom ? { createdAt: { gte: new Date(String(dateFrom)) } } : {}),
        ...(dateTo ? { createdAt: { lte: new Date(String(dateTo) + 'T23:59:59') } } : {}),
      },
-      orderBy: [{ month: 'desc' }, { batchNo: 'asc' }],
+      orderBy: [{ createdAt: 'desc' }, { month: 'desc' }, { batchNo: 'asc' }],
    })
    res.json({ success: true, data: batches })
  } catch (err) {
@@ -216,6 +254,7 @@ router.put('/batches/:id/name', async (req: AuthRequest, res: Response, next: Ne
 // 创建批次
 const createBatchSchema = z.object({
  month: z.string().regex(/^\d{4}-\d{2}$/),
  payMonth: z.string().regex(/^\d{4}-\d{2}$/).optional(),
  type: z.enum(['REGULAR', 'TERMINATION', 'BONUS', 'SEVERANCE']).default('REGULAR'),
  mode: z.enum(['copy_last', 'blank_employees', 'blank_all', 'copy_batch', 'custom']).default('copy_last'),
  sourceBatchId: z.string().optional(),
@@ -226,7 +265,7 @@ const createBatchSchema = z.object({
 router.post('/batches', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
-    const { month, type, mode, sourceBatchId, employeeIds, name, remark } = createBatchSchema.parse(req.body)
+    const { month, payMonth, type, mode, sourceBatchId, employeeIds, name, remark } = createBatchSchema.parse(req.body)
    const orgId = req.user!.orgId
    // 查询当月最大批次号，避免删除后 count 不准导致唯一键冲突
@@ -281,7 +320,18 @@ router.post('/batches', async (req: AuthRequest, res: Response, next: NextFuncti
          where: { orgId, terminationDate: { gte: monthStart, lte: monthEnd } },
          include: { employee: { include: { contracts: { orderBy: { createdAt: 'desc' }, take: 1 } } } },
        })
        // SEVERANCE 批次：仅包含已审批通过（APPROVED/EXECUTING/COMPLETED）且有补偿金的离职记录
        if (type === 'SEVERANCE') {
          const eligibleTerms = terminations.filter(t =>
            (t.status === 'APPROVED' || t.status === 'EXECUTING' || t.status === 'COMPLETED') &&
            (t.compensation > 0 || (t.compensationBreakdown as any)?.total > 0)
          )
          employees = eligibleTerms.map(t => t.employee)
          // 缓存 terminationRecord 以便后续 entry 创建时读取补偿金
          ;(req as any)._severanceTerms = new Map(eligibleTerms.map(t => [t.employeeId, t]))
        } else {
          employees = terminations.map(t => t.employee)
        }
      } else {
        employees = await prisma.employee.findMany({
          where: {
@@ -290,6 +340,8 @@ router.post('/batches', async (req: AuthRequest, res: Response, next: NextFuncti
              { status: 'ACTIVE' },
              { status: 'RESIGNED', updatedAt: { gte: monthStart, lte: monthEnd } },
            ],
            // 预入职员工不进入薪资批次
            NOT: { status: 'PRE_ONBOARD' },
          },
          include: { contracts: { orderBy: { createdAt: 'desc' }, take: 1 } },
        })
@@ -301,6 +353,7 @@ router.post('/batches', async (req: AuthRequest, res: Response, next: NextFuncti
      data: {
        orgId,
        month,
        payMonth: payMonth || null,
        batchNo,
        name: batchName,
        type,
@@ -339,30 +392,64 @@ router.post('/batches', async (req: AuthRequest, res: Response, next: NextFuncti
          where: { employeeId_month: { employeeId: emp.id, month } },
        })
-        if (emp.contracts?.[0]?.probationSalary && new Date(emp.contracts[0].startDate) > new Date(Date.now() - 365 * 24 * 60 * 60 * 1000)) {
+        // 按批次月份判定是否仍在试用期（试用期结束日 = 合同开始日 + 试用期月数）
-          baseSalary = emp.contracts[0].probationSalary
+        // 试用期且 probationSalary > 0 → 用试用期工资；否则用转正工资
        const batchMonthEnd = new Date(`${month}-28T23:59:59`) // 月末近似
        const latestContract = emp.contracts?.[0]
        const inProbation = isInProbation(latestContract, batchMonthEnd)
        if (inProbation && latestContract.probationSalary > 0) {
          baseSalary = latestContract.probationSalary
        } else if (prevPayslip) {
          // 非试用期：优先用上月工资条的基本工资（保持薪资连续性）
          baseSalary = prevPayslip.baseSalary
        } else if (emp.monthlySalary) {
          try { baseSalary = Number(decrypt(emp.monthlySalary)) || 0 } catch { baseSalary = Number(emp.monthlySalary) || 0 }
        }
        if (prevPayslip) baseSalary = prevPayslip.baseSalary
        overtimePay = overtime?.totalPay || 0
        allowance = prevPayslip?.allowance || 0
        deduction = prevPayslip?.deduction || 0
      }
-      // blank_employees 和 blank_all: 所有金额默认 0
+      // blank_employees 和 blank_all: 所有金额默认 0（不自动带出基本工资，不取试用期工资）
-      // blank_employees 模式下尝试从员工记录获取基本工资
+
-      if (mode === 'blank_employees' && emp.monthlySalary) {
+      // 统一试用期判定（仅 copy_last / copy_batch / custom 模式适用，SEVERANCE 除外）
-        try { baseSalary = Number(decrypt(emp.monthlySalary)) || 0 } catch { baseSalary = Number(emp.monthlySalary) || 0 }
+      // blank_employees / blank_all 模式下所有金额应为 0，不覆盖试用期工资
      if (type !== 'SEVERANCE' && type !== 'TERMINATION' && mode !== 'blank_employees' && mode !== 'blank_all') {
        const batchMonthEnd = new Date(`${month}-28T23:59:59`)
        const latestContract = emp.contracts?.[0]
        if (isInProbation(latestContract, batchMonthEnd) && latestContract?.probationSalary > 0) {
          baseSalary = latestContract.probationSalary
        }
      }
      // SEVERANCE 批次：从离职记录读取补偿金作为应发金额，不走工资/社保/个税计算
      let severanceAmount = 0
      let severanceBreakdown: any = null
      if (type === 'SEVERANCE') {
        const severanceTerms: Map<string, any> = (req as any)._severanceTerms || new Map()
        const termRecord = severanceTerms.get(emp.id)
        if (termRecord) {
          severanceBreakdown = termRecord.compensationBreakdown
          // 优先取 compensationBreakdown.total（含手动调整），否则取 compensation
          severanceAmount = (severanceBreakdown as any)?.total || termRecord.compensation || 0
          baseSalary = severanceAmount
        }
      }
      // calcBatchEntry 内部会按员工检查当月已归档批次是否已扣社保，已扣则跳过
      // SEVERANCE 批次：补偿金不走社保/个税计算，直接作为应发和实发金额
      let calcResult: any
      if (type === 'SEVERANCE' && severanceAmount > 0) {
        calcResult = { socialEmp: 0, socialOrg: 0, housingEmp: 0, housingOrg: 0, tax: 0, totalPay: severanceAmount, netPay: severanceAmount, minWage: 0, minWageApplied: 0, deferredSocialEmp: 0, deferredHousingEmp: 0, deferredMinWage: 0, prevDeferredSocialEmp: 0, prevDeferredHousingEmp: 0, prevDeferredMinWage: 0 }
      } else {
        try {
-        calcResult = await calcBatchEntry(orgId, emp.id, month, { baseSalary, overtimePay, allowance, deduction, bonus }, type)
+          // 查询上月递延数据（上月已归档批次中该员工的递延金额）
          const prevDeferred = await getPrevDeferred(orgId, emp.id, month)
          calcResult = await calcBatchEntry(orgId, emp.id, month, { baseSalary, overtimePay, allowance, deduction, bonus }, type, { prevDeferred })
        } catch (calcErr: any) {
          // 单个员工计算失败不阻塞整个批次，记录错误并使用零值
          failedEmployees.push({ employeeId: emp.id, name: emp.name, error: calcErr?.message || '计算失败' })
-        calcResult = { socialEmp: 0, socialOrg: 0, housingEmp: 0, housingOrg: 0, tax: 0, totalPay: baseSalary + overtimePay + allowance + bonus - deduction, netPay: baseSalary + overtimePay + allowance + bonus - deduction }
+          calcResult = { socialEmp: 0, socialOrg: 0, housingEmp: 0, housingOrg: 0, tax: 0, totalPay: baseSalary + overtimePay + allowance + bonus - deduction, netPay: baseSalary + overtimePay + allowance + bonus - deduction, minWage: 0, minWageApplied: 0, deferredSocialEmp: 0, deferredHousingEmp: 0, deferredMinWage: 0, prevDeferredSocialEmp: 0, prevDeferredHousingEmp: 0, prevDeferredMinWage: 0 }
        }
      }
      // 风险提示
@@ -385,6 +472,15 @@ router.post('/batches', async (req: AuthRequest, res: Response, next: NextFuncti
          tax: calcResult.tax,
          totalPay: calcResult.totalPay,
          netPay: calcResult.netPay,
          // 最低工资保护 + 递延扣款
          minWage: calcResult.minWage || 0,
          minWageApplied: calcResult.minWageApplied || 0,
          deferredSocialEmp: calcResult.deferredSocialEmp || 0,
          deferredHousingEmp: calcResult.deferredHousingEmp || 0,
          deferredMinWage: calcResult.deferredMinWage || 0,
          prevDeferredSocialEmp: calcResult.prevDeferredSocialEmp || 0,
          prevDeferredHousingEmp: calcResult.prevDeferredHousingEmp || 0,
          prevDeferredMinWage: calcResult.prevDeferredMinWage || 0,
          riskWarnings,
        },
      })
@@ -424,15 +520,15 @@ router.post('/batches', async (req: AuthRequest, res: Response, next: NextFuncti
 // 编辑批次条目（计算依据项 + 社保公积金手动覆盖）
 const updateEntrySchema = z.object({
-  baseSalary: z.number().min(0).optional(),
+  baseSalary: z.number().optional(),
-  overtimePay: z.number().min(0).optional(),
+  overtimePay: z.number().optional(),
-  allowance: z.number().min(0).optional(),
+  allowance: z.number().optional(),
-  deduction: z.number().min(0).optional(),
+  deduction: z.number().optional(),
-  bonus: z.number().min(0).optional(),
+  bonus: z.number().optional(),
-  socialEmp: z.number().min(0).optional(),
+  socialEmp: z.number().optional(),
-  socialOrg: z.number().min(0).optional(),
+  socialOrg: z.number().optional(),
-  housingEmp: z.number().min(0).optional(),
+  housingEmp: z.number().optional(),
-  housingOrg: z.number().min(0).optional(),
+  housingOrg: z.number().optional(),
 })
 router.put('/batches/:batchId/entries/:employeeId', async (req: AuthRequest, res: Response, next: NextFunction) => {
@@ -450,13 +546,21 @@ router.put('/batches/:batchId/entries/:employeeId', async (req: AuthRequest, res
    })
    if (!entry) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '条目不存在' } })
-    // 合并输入项
+    // 合并输入项（包含细化薪资字段，避免编辑时丢失岗位工资/绩效工资等）
    const inputs = {
      baseSalary: data.baseSalary ?? entry.baseSalary,
      overtimePay: data.overtimePay ?? entry.overtimePay,
      allowance: data.allowance ?? entry.allowance,
      deduction: data.deduction ?? entry.deduction,
      bonus: data.bonus ?? entry.bonus,
      positionSalary: entry.positionSalary || undefined,
      performanceSalary: entry.performanceSalary || undefined,
      senioritySalary: entry.senioritySalary || undefined,
      transportAllowance: entry.transportAllowance || undefined,
      mealAllowance: entry.mealAllowance || undefined,
      housingAllowance: entry.housingAllowance || undefined,
      communicationAllowance: entry.communicationAllowance || undefined,
      otherDeduction: entry.otherDeduction || undefined,
    }
    // 构建社保覆盖参数（如果请求中包含社保字段）
@@ -466,17 +570,20 @@ router.put('/batches/:batchId/entries/:employeeId', async (req: AuthRequest, res
    if (data.housingEmp !== undefined) overrideSocial.housingEmp = data.housingEmp
    if (data.housingOrg !== undefined) overrideSocial.housingOrg = data.housingOrg
    // 查询上月递延数据（与创建批次时一致）
    const prevDeferred = await getPrevDeferred(orgId, employeeId, batch.month)
    // calcBatchEntry 内部会按员工检查当月已归档批次是否已扣社保，手动覆盖优先
-    const options = Object.keys(overrideSocial).length > 0
+    const options: any = { prevDeferred }
-      ? { overrideSocial }
+    if (Object.keys(overrideSocial).length > 0) options.overrideSocial = overrideSocial
      : undefined
    // 重新计算
    const calcResult = await calcBatchEntry(orgId, employeeId, batch.month, inputs, batch.type, options)
    const { systemSocialEmp, systemSocialOrg, systemHousingEmp, systemHousingOrg, taxBreakdown, ...entryData } = calcResult
    const updated = await prisma.batchEntry.update({
      where: { id: entry.id },
-      data: { ...inputs, ...calcResult },
+      data: { ...inputs, ...entryData },
    })
    // 更新批次汇总
@@ -510,6 +617,81 @@ router.put('/batches/:batchId/entries/:employeeId', async (req: AuthRequest, res
  }
 })
 // 获取提成奖金：按批次月份从 CommissionBonus 表拉取，填充到 entries.bonus
 router.post('/batches/:batchId/fetch-bonus', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const { batchId } = req.params
    const orgId = req.user!.orgId
    const batch = await prisma.payrollBatch.findFirst({ where: { id: batchId, orgId } })
    if (!batch) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '批次不存在' } })
    if (batch.status === 'ARCHIVED') return res.status(400).json({ success: false, error: { code: 'VALIDATION_ERROR', message: '已归档批次不可操作' } })
    // 获取批次所有条目
    const entries = await prisma.batchEntry.findMany({
      where: { batchId },
      select: { id: true, employeeId: true, bonus: true },
    })
    if (entries.length === 0) {
      return res.json({ success: true, data: { filled: 0, totalAmount: 0, message: '批次无员工条目' } })
    }
    // 按批次月份查询提成奖金
    const bonusMap = await getBonusByMonthAndEmployeeIds(orgId, batch.month, entries.map((e) => e.employeeId))
    let filled = 0
    let totalAmount = 0
    for (const entry of entries) {
      const bonus = bonusMap.get(entry.employeeId)
      if (bonus) {
        await prisma.batchEntry.update({
          where: { id: entry.id },
          data: { bonus: bonus.amount },
        })
        filled++
        totalAmount += bonus.amount
      }
    }
    // 重算批次汇总
    const allEntries = await prisma.batchEntry.findMany({ where: { batchId } })
    const totals = allEntries.reduce((acc, e) => ({
      totalPay: acc.totalPay + e.baseSalary + e.overtimePay + e.allowance + e.bonus - e.deduction,
      totalNetPay: acc.totalNetPay + e.netPay,
      totalSocialOrg: acc.totalSocialOrg + e.socialOrg,
      totalSocialEmp: acc.totalSocialEmp + e.socialEmp,
      totalHousingOrg: acc.totalHousingOrg + e.housingOrg,
      totalHousingEmp: acc.totalHousingEmp + e.housingEmp,
      totalTax: acc.totalTax + e.tax,
    }), { totalPay: 0, totalNetPay: 0, totalSocialOrg: 0, totalSocialEmp: 0, totalHousingOrg: 0, totalHousingEmp: 0, totalTax: 0 })
    await prisma.payrollBatch.update({
      where: { id: batchId },
      data: {
        totalPay: Math.round(totals.totalPay * 100) / 100,
        totalNetPay: Math.round(totals.totalNetPay * 100) / 100,
        totalSocialOrg: Math.round(totals.totalSocialOrg * 100) / 100,
        totalSocialEmp: Math.round(totals.totalSocialEmp * 100) / 100,
        totalHousingOrg: Math.round(totals.totalHousingOrg * 100) / 100,
        totalHousingEmp: Math.round(totals.totalHousingEmp * 100) / 100,
        totalTax: Math.round(totals.totalTax * 100) / 100,
      },
    })
    res.json({
      success: true,
      data: {
        filled,
        totalAmount: Math.round(totalAmount * 100) / 100,
        message: filled > 0 ? `已填充 ${filled} 人提成奖金，合计 ¥${Math.round(totalAmount * 100) / 100}` : `${batch.month} 无提成奖金数据`,
      },
    })
  } catch (err) {
    next(err)
  }
 })
 // 获取条目个税计算明细
 router.get('/batches/:batchId/entries/:employeeId/tax-detail', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
@@ -574,8 +756,11 @@ router.post('/batches/:batchId/employees', async (req: AuthRequest, res: Respons
      if (!emp) continue
      let baseSalary = 0
-      if (emp.contracts?.[0]?.probationSalary && new Date(emp.contracts[0].startDate) > new Date(Date.now() - 365 * 24 * 60 * 60 * 1000)) {
+      // 按批次月份判定是否仍在试用期
-        baseSalary = emp.contracts[0].probationSalary
+      const batchMonthEnd = new Date(`${batch.month}-28T23:59:59`)
      const latestContract = emp.contracts?.[0]
      if (isInProbation(latestContract, batchMonthEnd) && latestContract.probationSalary > 0) {
        baseSalary = latestContract.probationSalary
      } else if (emp.monthlySalary) {
        try { baseSalary = Number(decrypt(emp.monthlySalary)) || 0 } catch { baseSalary = Number(emp.monthlySalary) || 0 }
      }
@@ -589,11 +774,12 @@ router.post('/batches/:batchId/employees', async (req: AuthRequest, res: Respons
      const calcResult = await calcBatchEntry(orgId, employeeId, batch.month, { baseSalary, overtimePay, allowance: 0, deduction: 0, bonus: 0 }, batch.type)
      const riskWarnings = await getPayrollRiskWarnings(orgId, employeeId)
      const { systemSocialEmp: _sse, systemSocialOrg: _sso, systemHousingEmp: _she, systemHousingOrg: _sho, taxBreakdown: _tb, ...entryData } = calcResult
      const entry = await prisma.batchEntry.create({
        data: {
          batchId, orgId, employeeId,
          baseSalary, overtimePay, allowance: 0, deduction: 0, bonus: 0,
-          ...calcResult, riskWarnings,
+          ...entryData, riskWarnings,
        },
      })
      results.push(entry)
@@ -723,17 +909,18 @@ router.post('/batches/:batchId/archive', async (req: AuthRequest, res: Response,
          otherDeduction: entry.otherDeduction || undefined,
        }
        // 社保如被手动覆盖，保留覆盖值
        // 社保如被手动覆盖，保留覆盖值（通过比较系统值和实际值判断是否覆盖过）
        const overrideSocial: any = {}
-        if (entry.socialEmp !== undefined) overrideSocial.socialEmp = entry.socialEmp
+        // 归档重算时不强制覆盖社保，让系统重新计算（除非之前有手动覆盖）
-        if (entry.socialOrg !== undefined) overrideSocial.socialOrg = entry.socialOrg
+        // 这里简化处理：不传 overrideSocial，让系统重算
-        if (entry.housingEmp !== undefined) overrideSocial.housingEmp = entry.housingEmp
+        const prevDeferred = await getPrevDeferred(orgId, entry.employeeId, batch.month)
-        if (entry.housingOrg !== undefined) overrideSocial.housingOrg = entry.housingOrg
+        const options: any = { prevDeferred }
        const options = Object.keys(overrideSocial).length > 0 ? { overrideSocial } : undefined
        const calcResult = await calcBatchEntry(orgId, entry.employeeId, batch.month, inputs, batch.type, options)
        const { systemSocialEmp: _sse, systemSocialOrg: _sso, systemHousingEmp: _she, systemHousingOrg: _sho, taxBreakdown: _tb, ...entryData } = calcResult
        await prisma.batchEntry.update({
          where: { id: entry.id },
-          data: { ...calcResult },
+          data: { ...entryData },
        })
      } catch (e: any) {
        recalcErrors.push(`${entry.employeeId}: ${e?.message || '重算失败'}`)
@@ -115,7 +115,7 @@ router.get('/orgs', async (req: AuthRequest, res, next) => {
        select: {
          id: true, name: true, plan: true, maxEmployees: true,
          city: true, contactName: true, contactPhone: true,
-          payrollFrequency: true, retirementReminderEnabled: true,
+          payrollDays: true, retirementReminderEnabled: true,
          createdAt: true, updatedAt: true,
          _count: {
            select: { employees: true, users: true, contracts: true, payslips: true },
@@ -1,5 +1,6 @@
 import { Router, Response, NextFunction } from 'express'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import { requireAdmin } from '../middleware/rbac'
 import { z } from 'zod'
 import prisma from '../lib/prisma'
 import {
@@ -90,24 +91,26 @@ router.delete('/:id', authMiddleware, async (req: AuthRequest, res: Response, ne
 router.get('/:id/read-stats', authMiddleware, async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
-    const policy = await prisma.policyDocument.findFirst({ where: { id: req.params.id, orgId }, select: { id: true } })
+    const policy = await prisma.policyDocument.findFirst({ where: { id: req.params.id, orgId }, select: { id: true, title: true } })
    if (!policy) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '制度不存在' } })
    }
-    const [totalEmployees, readRecords] = await Promise.all([
+    const [allEmployees, readRecords] = await Promise.all([
-      prisma.employee.count({ where: { orgId, status: 'ACTIVE' } }),
+      prisma.employee.findMany({ where: { orgId, status: 'ACTIVE' }, select: { id: true, name: true, department: true }, orderBy: { name: 'asc' } }),
      prisma.policyReadRecord.findMany({
        where: { policyId: req.params.id, orgId },
        include: { employee: { select: { id: true, name: true, department: true } } },
        orderBy: { readAt: 'desc' },
      }),
    ])
    const readEmpIds = new Set(readRecords.map(r => r.employeeId))
    const unreadEmployees = allEmployees.filter(e => !readEmpIds.has(e.id))
    res.json({
      success: true,
      data: {
-        total: totalEmployees,
+        total: allEmployees.length,
        readCount: readRecords.length,
-        unreadCount: totalEmployees - readRecords.length,
+        unreadCount: unreadEmployees.length,
        records: readRecords.map(r => ({
          employeeId: r.employeeId,
          employeeName: r.employee.name,
@@ -115,6 +118,11 @@ router.get('/:id/read-stats', authMiddleware, async (req: AuthRequest, res: Resp
          readAt: r.readAt.toISOString(),
          ip: r.ip,
        })),
        unreadEmployees: unreadEmployees.map(e => ({
          employeeId: e.id,
          employeeName: e.name,
          department: e.department,
        })),
      },
    })
  } catch (err) {
@@ -122,4 +130,43 @@ router.get('/:id/read-stats', authMiddleware, async (req: AuthRequest, res: Resp
  }
 })
 /** 催办未签收员工 */
 router.post('/:id/remind', authMiddleware, requireAdmin, async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const policy = await prisma.policyDocument.findFirst({ where: { id: req.params.id, orgId }, select: { id: true, title: true } })
    if (!policy) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '制度不存在' } })
    }
    const { employeeIds } = req.body as { employeeIds?: string[] }
    const readRecords = await prisma.policyReadRecord.findMany({ where: { policyId: req.params.id, orgId }, select: { employeeId: true } })
    const readEmpIds = new Set(readRecords.map(r => r.employeeId))
    const targetEmployees = await prisma.employee.findMany({
      where: {
        orgId, status: 'ACTIVE',
        id: employeeIds && employeeIds.length > 0 ? { in: employeeIds } : undefined,
      },
      select: { id: true, name: true },
    })
    const unreadEmployees = targetEmployees.filter(e => !readEmpIds.has(e.id))
    // 创建催办通知
    for (const emp of unreadEmployees) {
      await prisma.notificationLog.create({
        data: {
          orgId,
          employeeId: emp.id,
          type: 'POLICY_REMIND',
          title: `制度签收提醒：${policy.title}`,
          content: `您有一项制度「${policy.title}」尚未签收，请尽快完成阅读确认。`,
          channel: 'IN_APP',
          status: 'SENT',
        },
      }).catch(() => {})
    }
    res.json({ success: true, data: { reminded: unreadEmployees.length } })
  } catch (err) {
    next(err)
  }
 })
 export default router
@@ -9,7 +9,7 @@ import { signAccessToken, verifyAccessToken } from '../lib/jwt'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import { portalLoginSchema, portalSendCodeSchema, portalVerifyCodeSchema, onboardingSchema, contractConfirmSchema, contractSendCodeSchema } from '../schemas/portal.schema'
 import { setCode, getCode, deleteCode, updateCode, checkRateLimit } from '../lib/codeStore'
-import { createEvidence } from '../services/evidence.service'
+import { createEvidence, appendEvidence } from '../services/evidence.service'
 const router = Router()
@@ -36,18 +36,30 @@ function portalAuth(req: Request, res: Response, next: NextFunction) {
 router.post('/login', async (req, res, next) => {
  try {
    const data = portalLoginSchema.parse(req.body)
-    const employee = await prisma.employee.findFirst({
+    // 查找所有匹配手机号的在职员工（可能跨组织）
    const employees = await prisma.employee.findMany({
      where: { phone: data.phone, status: 'ACTIVE' },
      select: { id: true, name: true, department: true, orgId: true, passwordHash: true },
    })
-    if (!employee || !employee.passwordHash) {
+    if (employees.length === 0) {
      return res.status(400).json({ success: false, error: { code: 'AUTH_FAILED', message: '手机号或密码错误' } })
    }
-    const valid = await bcrypt.compare(data.password, employee.passwordHash)
+    // 逐个校验密码，找到匹配的员工
-    if (!valid) {
+    let matchedEmployee = null
    for (const emp of employees) {
      if (emp.passwordHash) {
        const valid = await bcrypt.compare(data.password, emp.passwordHash)
        if (valid) {
          matchedEmployee = emp
          break
        }
      }
    }
    if (!matchedEmployee) {
      return res.status(400).json({ success: false, error: { code: 'AUTH_FAILED', message: '手机号或密码错误' } })
    }
-    const token = signAccessToken({ id: employee.id, orgId: employee.orgId, role: 'EMPLOYEE' })
+    const token = signAccessToken({ id: matchedEmployee.id, orgId: matchedEmployee.orgId, role: 'EMPLOYEE' })
-    res.json({ success: true, data: { token, employee: { id: employee.id, name: employee.name, department: employee.department } } })
+    res.json({ success: true, data: { token, employee: { id: matchedEmployee.id, name: matchedEmployee.name, department: matchedEmployee.department } } })
  } catch (err) {
    next(err)
  }
@@ -94,10 +106,16 @@ router.post('/verify-code', async (req, res, next) => {
      return res.status(400).json({ success: false, error: { code: 'CODE_WRONG', message: `验证码错误（剩余${5 - stored.failCount - 1}次机会）` } })
    }
    await deleteCode(data.phone)
-    const employee = await prisma.employee.findFirst({ where: { phone: data.phone, status: 'ACTIVE' } })
+    // 查找所有匹配手机号的在职员工（可能跨组织）
-    if (!employee) {
+    const employees = await prisma.employee.findMany({
      where: { phone: data.phone, status: 'ACTIVE' },
      select: { id: true, name: true, department: true, orgId: true },
    })
    if (employees.length === 0) {
      return res.status(400).json({ success: false, error: { code: 'NOT_FOUND', message: '员工不存在' } })
    }
    // 如果只有一个匹配，直接登录
    const employee = employees[0]
    const token = signAccessToken({ id: employee.id, orgId: employee.orgId, role: 'EMPLOYEE' })
    res.json({ success: true, data: { token, employee: { id: employee.id, name: employee.name, department: employee.department } } })
  } catch (err) {
@@ -105,6 +123,38 @@ router.post('/verify-code', async (req, res, next) => {
  }
 })
 /**
 * 员工修改自己的密码
 * POST /portal/change-password  body: { oldPassword, newPassword }
 */
 router.post('/change-password', portalAuth, async (req: any, res, next) => {
  try {
    const { oldPassword, newPassword } = req.body
    if (!oldPassword || !newPassword) {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '请输入旧密码和新密码' } })
    }
    if (newPassword.length < 6) {
      return res.status(400).json({ success: false, error: { code: 'VALIDATION_ERROR', message: '新密码至少6位' } })
    }
    const employee = await prisma.employee.findFirst({
      where: { id: req.employee.id },
      select: { id: true, passwordHash: true },
    })
    if (!employee || !employee.passwordHash) {
      return res.status(400).json({ success: false, error: { code: 'AUTH_FAILED', message: '当前未设置密码，请联系管理员重置' } })
    }
    const valid = await bcrypt.compare(oldPassword, employee.passwordHash)
    if (!valid) {
      return res.status(400).json({ success: false, error: { code: 'AUTH_FAILED', message: '旧密码错误' } })
    }
    const passwordHash = await bcrypt.hash(newPassword, 10)
    await prisma.employee.update({ where: { id: employee.id }, data: { passwordHash } })
    res.json({ success: true, data: { message: '密码修改成功' } })
  } catch (err) {
    next(err)
  }
 })
 // 工资条
 router.get('/payslip', portalAuth, async (req: any, res, next) => {
  try {
@@ -115,7 +165,11 @@ router.get('/payslip', portalAuth, async (req: any, res, next) => {
    if (!payslip) {
      return res.json({ success: true, data: null })
    }
-    res.json({ success: true, data: payslip })
+    // 记录查看时间
    if (!payslip.viewedAt) {
      await prisma.payslip.update({ where: { id: payslip.id }, data: { viewedAt: new Date() } })
    }
    res.json({ success: true, data: { ...payslip, viewedAt: payslip.viewedAt || new Date() } })
  } catch (err) {
    next(err)
  }
@@ -167,6 +221,25 @@ router.post('/payslip/:id/confirm', portalAuth, async (req: any, res, next) => {
      events: [{ action: '工资条确认', timestamp: new Date().toISOString(), ip: req.ip, userAgent: req.headers['user-agent'] }],
      createdBy: req.employee.id,
    }).catch(() => {})
    // 如果开启了工资条电子签，创建电子签记录
    const org = await prisma.organization.findUnique({ where: { id: req.employee.orgId }, select: { esignPayslipEnabled: true } })
    if (org?.esignPayslipEnabled) {
      await prisma.eSignRecord.create({
        data: {
          orgId: req.employee.orgId,
          employeeId: req.employee.id,
          scene: 'PAYSLIP',
          documentTitle: `工资条确认：${payslip.month}`,
          status: 'PENDING',
          initiatedBy: req.employee.id,
          createdBy: req.employee.id,
          remark: '工资条确认时自动发起',
          expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
        },
      })
    }
    res.json({ success: true })
  } catch (err) {
    next(err)
@@ -540,6 +613,27 @@ router.post('/policies/:id/read', portalAuth, async (req: Request, res: Response
        userAgent: req.headers['user-agent'] || null,
      },
    })
    // 如果开启了制度电子签，创建电子签记录
    const org = await prisma.organization.findUnique({ where: { id: orgId }, select: { esignPolicyEnabled: true } })
    if (org?.esignPolicyEnabled) {
      const policyDoc = await prisma.policyDocument.findUnique({ where: { id: req.params.id }, select: { title: true, content: true } })
      await prisma.eSignRecord.create({
        data: {
          orgId,
          employeeId,
          scene: 'POLICY',
          documentTitle: `制度签收：${policyDoc?.title || '未知'}`,
          documentContent: policyDoc?.content || null,
          status: 'PENDING',
          initiatedBy: employeeId,
          createdBy: employeeId,
          remark: '制度阅读确认后自动发起',
          expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
        },
      })
    }
    res.json({ success: true, data: { readAt: record.readAt.toISOString() } })
  } catch (err) {
    next(err)
@@ -701,6 +795,14 @@ router.get('/home/overview', portalAuth, async (req: any, res, next) => {
    if (unreadPolicies.length > 0) {
      pendingTasks.push({ severity: 'medium', message: `您有 ${unreadPolicies.length} 份制度待阅读确认` })
    }
    // 待签署文件
    const pendingEsign = await prisma.eSignRecord.findMany({
      where: { employeeId, orgId, status: 'PENDING' },
      select: { id: true, documentTitle: true },
    })
    if (pendingEsign.length > 0) {
      pendingTasks.push({ severity: 'high', message: `您有 ${pendingEsign.length} 份文件待签署（${pendingEsign.map(e => e.documentTitle).join('、')}）` })
    }
    res.json({
      success: true,
@@ -773,7 +875,7 @@ router.get('/onboarding/progress', portalAuth, async (req: any, res, next) => {
 router.post('/resignation/submit', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
-    const { reason, expectedDate, remark } = req.body
+    const { reason, expectedDate, remark, attachments } = req.body
    if (!reason || !expectedDate) {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '请填写离职原因和预计离职日期' } })
    }
@@ -789,6 +891,7 @@ router.post('/resignation/submit', portalAuth, async (req: any, res, next) => {
    if (existing) {
      return res.status(400).json({ success: false, error: { code: 'DUPLICATE', message: '您已有一个待处理的离职申请' } })
    }
    const remarkText = `员工自主申请：${reason}${remark ? '；备注：' + remark : ''}${attachments && attachments.length > 0 ? `；附件：${attachments.length}张辞职信照片` : ''}`
    const record = await (prisma as any).terminationRecord.create({
      data: {
        employeeId, orgId,
@@ -797,8 +900,8 @@ router.post('/resignation/submit', portalAuth, async (req: any, res, next) => {
        resignationReason: reason,
        terminationDate: new Date(expectedDate),
        status: 'PENDING_APPROVAL',
-        checklist: [],
+        checklist: attachments && attachments.length > 0 ? attachments : [],
-        remark: `员工自主申请：${reason}${remark ? '；备注：' + remark : ''}`,
+        remark: remarkText,
        createdBy: employeeId,
      },
    })
@@ -838,6 +941,82 @@ router.post('/resignation/:id/withdraw', portalAuth, async (req: any, res, next)
  } catch (err) { next(err) }
 })
 // 下载离职证明（仅已完成的离职记录）
 router.get('/resignation/:id/certificate', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const record = await (prisma as any).terminationRecord.findFirst({
      where: { id: req.params.id, employeeId, orgId },
      include: { employee: true },
    })
    if (!record) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '离职记录不存在' } })
    if (record.status !== 'COMPLETED') {
      return res.status(400).json({ success: false, error: { code: 'INVALID_STATUS', message: '离职流程未完成，无法下载证明' } })
    }
    const org = await prisma.organization.findFirst({ where: { id: orgId } })
    const orgName = org?.name || ''
    // 查找企业自定义的离职证明模板
    const tpl = await (prisma as any).enterpriseTemplate.findFirst({
      where: { orgId, category: 'LEAVING_CERT' },
    })
    const reasonLabel: Record<string, string> = {
      RESIGNATION: '个人辞职', EXPIRY: '合同到期', DISMISSAL: '违纪辞退',
      NEGOTIATED: '协商解除', RETIREMENT: '退休', DEATH: '死亡',
    }
    const reason = reasonLabel[record.reason] || record.reason || ''
    const variables: Record<string, string> = {
      employeeName: record.employee?.name || '',
      idCardNumber: record.employee?.idCardNumber || '',
      department: record.employee?.department || '',
      position: record.employee?.position || '',
      hireDate: record.employee?.hireDate ? new Date(record.employee.hireDate).toISOString().slice(0, 10) : '',
      leaveDate: record.terminationDate ? new Date(record.terminationDate).toISOString().slice(0, 10) : '',
      reason,
      companyName: orgName,
      compensation: String(record.compensation || 0),
      socialInsEndMonth: record.socialInsEndMonth || '',
      housingFundEndMonth: record.housingFundEndMonth || '',
    }
    let content: string
    if (tpl) {
      content = tpl.content
      for (const [key, value] of Object.entries(variables)) {
        content = content.replace(new RegExp(`\\{\\{${key}\\}\\}`, 'g'), value)
      }
    } else {
      content = `<h1>解除/终止劳动合同证明书</h1>
 <p>兹证明 ${variables.employeeName}（证件号码：${variables.idCardNumber}），原系我单位 ${variables.department} 部门员工，于 ${variables.leaveDate} 因 ${reason} 原因，正式解除/终止劳动合同。</p>
 <p>经济补偿金已结清：¥${variables.compensation}。社保截止月份：${variables.socialInsEndMonth || '—'}，公积金截止月份：${variables.housingFundEndMonth || '—'}。</p>
 <p>特此证明。</p>
 <div class="sign">公司（盖章）<br/>${new Date().toISOString().slice(0, 10)}</div>`
    }
    const htmlContent = `<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">
 <head><meta charset="utf-8"><title>离职证明</title>
 <!--[if gte mso 9]><xml>
 <w:WordDocument><w:View>Print</w:View><w:Zoom>100</w:Zoom><w:DoNotOptimizeForBrowser/></w:WordDocument>
 </xml><![endif]-->
 <style>
@page { size: A4; margin: 2.54cm 3.17cm 2.54cm 3.17cm; }
 body { font-family: SimSun, serif; font-size: 14pt; line-height: 2; text-align: justify; }
 h1 { font-size: 22pt; font-weight: bold; text-align: center; margin: 30pt 0 20pt 0; font-family: SimHei, sans-serif; }
 p { text-indent: 2em; margin: 0 0 10pt 0; }
 .sign { text-align: right; margin-top: 30pt; margin-right: 20pt; text-indent: 0; }
 </style></head>
 <body>${content}</body></html>`
    const encoded = encodeURIComponent(`离职证明-${variables.employeeName}.doc`)
    res.setHeader('Content-Type', 'application/msword; charset=utf-8')
    res.setHeader('Content-Disposition', `attachment; filename="${encoded}"; filename*=UTF-8''${encoded}`)
    res.send(htmlContent)
  } catch (err) { next(err) }
 })
 // ========== 员工端：休假申请 ==========
 // 查看自己的休假申请列表
 router.get('/leaves', portalAuth, async (req: any, res, next) => {
@@ -898,4 +1077,365 @@ router.post('/leaves/:id/cancel', portalAuth, async (req: any, res, next) => {
  } catch (err) { next(err) }
 })
 // ========== 员工端：电子签署 ==========
 // 查看自己的签署记录列表
 // ========== 员工端：电子签署（验证码确认 + 证据链） ==========
 /**
 * 我的电子签署列表
 * - 自动将过期的 PENDING 记录标记为 EXPIRED
 */
 router.get('/esign', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const records = await prisma.eSignRecord.findMany({
      where: { employeeId, orgId },
      orderBy: { createdAt: 'desc' },
    })
    // 自动处理过期：PENDING 且已超过 expiredAt 的记录标记为 EXPIRED
    const now = new Date()
    const expiredIds = records
      .filter(r => r.status === 'PENDING' && r.expiredAt && r.expiredAt < now)
      .map(r => r.id)
    if (expiredIds.length > 0) {
      await prisma.eSignRecord.updateMany({
        where: { id: { in: expiredIds } },
        data: { status: 'EXPIRED' },
      })
      expiredIds.forEach(id => {
        const r = records.find(rec => rec.id === id)
        if (r) r.status = 'EXPIRED'
      })
    }
    res.json({ success: true, data: records })
  } catch (err) { next(err) }
 })
 /**
 * 查看签署详情（含文件内容）
 */
 router.get('/esign/:id', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const record = await prisma.eSignRecord.findFirst({
      where: { id: req.params.id, employeeId, orgId },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在' } })
    // 检查过期
    if (record.status === 'PENDING' && record.expiredAt && record.expiredAt < new Date()) {
      const updated = await prisma.eSignRecord.update({
        where: { id: record.id },
        data: { status: 'EXPIRED' },
      })
      return res.json({ success: true, data: updated })
    }
    res.json({ success: true, data: record })
  } catch (err) { next(err) }
 })
 /**
 * 发送签署验证码
 * - 通过手机号发送6位验证码
 * - 验证码5分钟有效，最多5次错误
 */
 router.post('/esign/:id/send-code', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const record = await prisma.eSignRecord.findFirst({
      where: { id: req.params.id, employeeId, orgId, status: 'PENDING' },
      include: { employee: { select: { phone: true, name: true } } },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在或已处理' } })
    if (!record.employee.phone) {
      return res.status(400).json({ success: false, error: { code: 'NO_PHONE', message: '未登记手机号，无法发送验证码' } })
    }
    // 限流：同一记录60秒内只能发一次
    const rateLimitKey = `esign-rate-${record.id}`
    const allowed = await checkRateLimit(rateLimitKey, 60 * 1000)
    if (!allowed) {
      return res.status(429).json({ success: false, error: { code: 'RATE_LIMIT', message: '请求过于频繁，请60秒后重试' } })
    }
    const code = Math.random().toString().slice(2, 8)
    await setCode(`esign-${record.id}`, code)
    // 追加证据链 — 验证码发送事件
    const evidence = await prisma.evidenceChain.findFirst({
      where: { orgId, refId: record.id, category: 'CONTRACT_SIGN' },
    })
    if (evidence) {
      await appendEvidence(orgId, evidence.id, {
        action: '发送签署验证码',
        timestamp: new Date().toISOString(),
        ip: req.ip,
        userAgent: req.headers['user-agent'] as string,
        location: `手机号：${record.employee.phone.replace(/(\d{3})\d{4}(\d{4})/, '$1****$2')}`,
      }).catch(() => {})
    }
    res.json({
      success: true,
      data: {
        code, // 开发阶段直接返回，生产环境通过短信发送
        message: '验证码已生成（开发阶段直接返回，生产环境将发送短信）',
        phone: record.employee.phone.replace(/(\d{3})\d{4}(\d{4})/, '$1****$2'),
      },
    })
  } catch (err) { next(err) }
 })
 /**
 * 员工签署操作（验证码确认 + 证据链 + 回写合同）
 * - 校验验证码
 * - 更新签署状态为 COMPLETED
 * - 追加证据链（签署完成事件，含IP/UA/验证码/时间戳）
 * - 回写合同 signMethod 和 electronicContractUrl
 */
 router.post('/esign/:id/sign', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const { verifyCode } = req.body || {}
    const record = await prisma.eSignRecord.findFirst({
      where: { id: req.params.id, employeeId, orgId, status: 'PENDING' },
      include: { employee: { select: { name: true, phone: true } } },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在或已处理' } })
    // 检查过期
    if (record.expiredAt && record.expiredAt < new Date()) {
      await prisma.eSignRecord.update({ where: { id: record.id }, data: { status: 'EXPIRED' } })
      return res.status(400).json({ success: false, error: { code: 'EXPIRED', message: '签署链接已过期' } })
    }
    // 校验验证码
    if (!verifyCode) {
      return res.status(400).json({ success: false, error: { code: 'NO_CODE', message: '请输入验证码' } })
    }
    const stored = await getCode(`esign-${record.id}`)
    if (!stored) {
      return res.status(400).json({ success: false, error: { code: 'CODE_EXPIRED', message: '验证码已过期，请重新获取' } })
    }
    if (stored.failCount >= 5) {
      await deleteCode(`esign-${record.id}`)
      return res.status(400).json({ success: false, error: { code: 'TOO_MANY_ATTEMPTS', message: '验证码错误次数过多，请重新获取验证码' } })
    }
    if (stored.code !== verifyCode) {
      await updateCode(`esign-${record.id}`, { failCount: stored.failCount + 1 })
      return res.status(400).json({ success: false, error: { code: 'CODE_WRONG', message: `验证码错误（剩余${5 - stored.failCount - 1}次机会）` } })
    }
    await deleteCode(`esign-${record.id}`)
    // 签署完成
    const userAgent = req.headers['user-agent'] || ''
    const signEvidence = JSON.stringify({
      ip: req.ip,
      userAgent,
      timestamp: new Date().toISOString(),
      verifyCode: true,
      employeeName: record.employee.name,
      phone: record.employee.phone,
    })
    const updated = await prisma.eSignRecord.update({
      where: { id: record.id },
      data: {
        status: 'COMPLETED',
        completedAt: new Date(),
        // 保存签署证据到 callbackData（作为签署凭证）
        callbackData: { signEvidence, signedAt: new Date().toISOString() } as any,
      },
    })
    // 回写合同
    if (record.contractId) {
      await prisma.laborContract.update({
        where: { id: record.contractId },
        data: {
          signMethod: 'ELECTRONIC',
          // 签署证据写入 attachmentName
          attachmentName: `e-sign:${new Date().toISOString()}|evidence:${signEvidence}`,
        },
      })
    }
    // 追加证据链 — 签署完成事件
    const evidence = await prisma.evidenceChain.findFirst({
      where: { orgId, refId: record.id, category: 'CONTRACT_SIGN' },
    })
    if (evidence) {
      await appendEvidence(orgId, evidence.id, {
        action: `员工签署完成：${record.documentTitle}`,
        timestamp: new Date().toISOString(),
        ip: req.ip,
        userAgent,
        smsCode: verifyCode,
        location: `签署人：${record.employee.name}，验证码已验证`,
      }).catch(() => {})
    } else {
      // 证据链不存在时创建新的
      await createEvidence({
        orgId,
        category: 'CONTRACT_SIGN',
        refId: record.id,
        employeeId,
        events: [{
          action: `员工签署完成：${record.documentTitle}`,
          timestamp: new Date().toISOString(),
          ip: req.ip,
          userAgent,
          smsCode: verifyCode,
          location: `签署人：${record.employee.name}，验证码已验证`,
        }],
        createdBy: employeeId,
      }).catch(() => {})
    }
    res.json({ success: true, data: updated, message: '签署成功' })
  } catch (err) { next(err) }
 })
 // ========== 员工端：培训签收 ==========
 // 查看自己的培训记录
 router.get('/training', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const records = await prisma.trainingRecord.findMany({
      where: { employeeId, orgId },
      orderBy: { trainingDate: 'desc' },
    })
    res.json({ success: true, data: records })
  } catch (err) { next(err) }
 })
 // 培训签收
 router.post('/training/:id/sign', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const record = await prisma.trainingRecord.findFirst({
      where: { id: req.params.id, employeeId, orgId, ackStatus: 'PENDING' },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在或已签收' } })
    const updated = await prisma.trainingRecord.update({
      where: { id: record.id },
      data: { ackStatus: 'SIGNED', ackDate: new Date() },
    })
    await createEvidence({
      orgId,
      category: 'TRAINING',
      refId: record.id,
      employeeId,
      events: [{ action: `培训签收：${record.topic}`, timestamp: new Date().toISOString(), ip: req.ip, userAgent: req.headers['user-agent'] }],
      createdBy: employeeId,
    }).catch(() => {})
    res.json({ success: true, data: updated, message: '签收成功' })
  } catch (err) { next(err) }
 })
 // 培训拒绝签收
 router.post('/training/:id/refuse', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const record = await prisma.trainingRecord.findFirst({
      where: { id: req.params.id, employeeId, orgId, ackStatus: 'PENDING' },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在或已处理' } })
    const updated = await prisma.trainingRecord.update({
      where: { id: record.id },
      data: { ackStatus: 'REFUSED', ackDate: new Date() },
    })
    res.json({ success: true, data: updated, message: '已拒绝签收' })
  } catch (err) { next(err) }
 })
 // ========== 员工端：绩效签字 ==========
 // 查看自己的绩效记录
 router.get('/performance', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const records = await prisma.performanceRecord.findMany({
      where: { employeeId, orgId },
      orderBy: { period: 'desc' },
    })
    res.json({ success: true, data: records })
  } catch (err) { next(err) }
 })
 // 绩效签字确认
 router.post('/performance/:id/sign', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const record = await prisma.performanceRecord.findFirst({
      where: { id: req.params.id, employeeId, orgId, employeeAck: false },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在或已签字' } })
    const updated = await prisma.performanceRecord.update({
      where: { id: record.id },
      data: { employeeAck: true, ackDate: new Date() },
    })
    await createEvidence({
      orgId,
      category: 'PERFORMANCE',
      refId: record.id,
      employeeId,
      events: [{ action: `绩效签字确认：${record.period}`, timestamp: new Date().toISOString(), ip: req.ip, userAgent: req.headers['user-agent'] }],
      createdBy: employeeId,
    }).catch(() => {})
    res.json({ success: true, data: updated, message: '签字成功' })
  } catch (err) { next(err) }
 })
 // ========== 员工端：违纪签字 ==========
 // 查看自己的违纪记录
 router.get('/disciplinary', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const records = await prisma.disciplinaryRecord.findMany({
      where: { employeeId, orgId },
      orderBy: { violationDate: 'desc' },
    })
    res.json({ success: true, data: records })
  } catch (err) { next(err) }
 })
 // 违纪签字确认
 router.post('/disciplinary/:id/sign', portalAuth, async (req: any, res, next) => {
  try {
    const { id: employeeId, orgId } = req.employee
    const record = await prisma.disciplinaryRecord.findFirst({
      where: { id: req.params.id, employeeId, orgId, employeeAck: false },
    })
    if (!record) return res.status(404).json({ success: false, error: { message: '记录不存在或已签字' } })
    const updated = await prisma.disciplinaryRecord.update({
      where: { id: record.id },
      data: { employeeAck: true, ackDate: new Date(), ackMethod: 'SIGN' },
    })
    await createEvidence({
      orgId,
      category: 'DISCIPLINARY',
      refId: record.id,
      employeeId,
      events: [{ action: `违纪签字确认：${record.violationType}`, timestamp: new Date().toISOString(), ip: req.ip, userAgent: req.headers['user-agent'] }],
      createdBy: employeeId,
    }).catch(() => {})
    res.json({ success: true, data: updated, message: '签字成功' })
  } catch (err) { next(err) }
 })
 export default router
@@ -0,0 +1,74 @@
 /**
 * 岗位字典路由
 * 提供岗位的增删改查
 */
 import { Router } from 'express'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import prisma from '../lib/prisma'
 import { z } from 'zod'
 const router = Router()
 const createPositionSchema = z.object({
  name: z.string().min(1, '岗位名称必填'),
  departmentId: z.string().nullable().optional(),
  headcount: z.number().int().min(0).default(0),
  level: z.string().max(20).optional(),
  description: z.string().max(200).optional(),
 })
 /** 获取岗位列表 */
 router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const positions = await prisma.position.findMany({
      where: { orgId: req.user!.orgId! },
      orderBy: { createdAt: 'asc' },
      include: { department: { select: { id: true, name: true } } },
    })
    res.json({ success: true, data: positions })
  } catch (err) {
    next(err)
  }
 })
 /** 创建岗位 */
 router.post('/', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const data = createPositionSchema.parse(req.body)
    const position = await prisma.position.create({
      data: {
        ...data,
        orgId: req.user!.orgId!,
        createdBy: req.user!.id,
      },
    })
    res.json({ success: true, data: position })
  } catch (err) {
    next(err)
  }
 })
 /** 更新岗位 */
 router.put('/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    const data = createPositionSchema.partial().parse(req.body)
    const position = await prisma.position.update({ where: { id }, data })
    res.json({ success: true, data: position })
  } catch (err) {
    next(err)
  }
 })
 /** 删除岗位 */
 router.delete('/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    await prisma.position.delete({ where: { id } })
    res.json({ success: true })
  } catch (err) {
    next(err)
  }
 })
 export default router
@@ -5,6 +5,7 @@ import { createEvidence } from '../services/evidence.service'
 import prisma from '../lib/prisma'
 import { decrypt, encrypt } from '../lib/crypto'
 import { getContractStatus } from '../services/contract.service'
 import { calcSocialInsurance, calcHousingFund } from '../services/payroll.service'
 import ExcelJS from 'exceljs'
 const router = Router()
@@ -18,6 +19,16 @@ function safeDecrypt(encrypted: string): number {
  }
 }
 function safeDecryptStr(encrypted: string | null): string | null {
  if (!encrypted) return null
  try {
    if (!encrypted.includes(':')) return encrypted
    return decrypt(encrypted)
  } catch {
    return encrypted
  }
 }
 // ========== 花名册聚合 API ==========
 // 获取部门列表（去重）
@@ -35,6 +46,21 @@ router.get('/departments', authMiddleware, async (req: AuthRequest, res, next) =
  }
 })
 /** 花名册可选职务列表（从在职员工中提取去重） */
 router.get('/positions', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const employees = await prisma.employee.findMany({
      where: { orgId: req.user!.orgId, status: 'ACTIVE' },
      select: { position: true },
      distinct: 'position',
    })
    const positions = employees.map((e) => e.position).filter(Boolean).sort()
    res.json({ success: true, data: positions })
  } catch (err) {
    next(err)
  }
 })
 // 花名册列表（含汇总信息，支持分页和过滤）
 router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
@@ -44,6 +70,7 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
    const status = req.query.status as string  // ACTIVE | PRE_HIRE | RESIGNED
    const contractStatus = req.query.contractStatus as string  // active | expiring | expired | unsigned | etc.
    const department = req.query.department as string
    const position = req.query.position as string
    const skip = (page - 1) * pageSize
    // 使用本地日期午夜，避免时区问题导致当天入职被误判为预入职
@@ -60,6 +87,9 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
    if (department) {
      whereBase.department = department
    }
    if (position) {
      whereBase.position = position
    }
    if (search && !isIdCardSearch) {
      whereBase.OR = [
        { name: { contains: search } },
@@ -70,12 +100,18 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
    // 状态过滤在 DB 层完成（contractStatus 需要后处理计算，仍需内存过滤）
    if (status === 'RESIGNED') {
      whereBase.status = 'RESIGNED'
-    } else if (status === 'PRE_HIRE') {
+    } else if (status === 'PRE_HIRE' || status === 'PRE_ONBOARD') {
-      whereBase.status = 'ACTIVE'
+      // 预入职：PRE_ONBOARD 状态，或 ACTIVE 状态但入职日期在未来
-      whereBase.hireDate = { gt: todayEnd }
+      whereBase.OR = [
        { status: 'PRE_ONBOARD' },
        { status: 'ACTIVE', hireDate: { gt: todayEnd } },
      ]
    } else if (status === 'ACTIVE') {
      whereBase.status = 'ACTIVE'
      whereBase.hireDate = { lte: todayEnd }
    } else if (!status) {
      // 无状态过滤时，排除 PRE_ONBOARD（默认只看在职和离职）
      whereBase.NOT = { status: 'PRE_ONBOARD' }
    }
    // unsigned 合同状态可以在 DB 层过滤
@@ -83,7 +119,7 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
      whereBase.contracts = { none: {} }
    }
-    // 当有 contractStatus（非 unsigned）筛选或身份证号搜索时，需要先查全部再过滤后分页
+    // 当有 contractStatus（非 unsigned）筛选或证件号码搜索时，需要先查全部再过滤后分页
    const needPostFilter = (!!contractStatus && contractStatus !== 'unsigned') || isIdCardSearch
    const [dbTotal, employees] = await Promise.all([
@@ -95,6 +131,7 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
        include: {
          contracts: { orderBy: { createdAt: 'desc' }, take: 1 },
          terminations: { orderBy: { terminationDate: 'desc' }, take: 1 },
          socialInsRecords: { orderBy: { startMonth: 'desc' }, take: 1 },
          _count: {
            select: {
              disciplinaryRecords: true,
@@ -109,6 +146,32 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
      }),
    ])
    // 获取社保和公积金配置（按城市缓存）
    const currentMonth = new Date().toISOString().slice(0, 7)
    const configCache = new Map<string, { social?: any; housing?: any }>()
    const getConfigsForCity = async (city?: string) => {
      const key = city || '_default'
      if (configCache.has(key)) return configCache.get(key)!
      const cityWhere = city ? { orgId: req.user!.orgId, city } : { orgId: req.user!.orgId }
      const [socialCfg, housingCfg] = await Promise.all([
        prisma.socialInsuranceConfig.findFirst({
          where: { ...cityWhere, effectiveFrom: { lte: currentMonth }, OR: [{ effectiveTo: null }, { effectiveTo: { gte: currentMonth } }] },
          orderBy: { effectiveFrom: 'desc' },
        }),
        prisma.housingFundConfig.findFirst({
          where: { ...cityWhere, effectiveFrom: { lte: currentMonth }, OR: [{ effectiveTo: null }, { effectiveTo: { gte: currentMonth } }] },
          orderBy: { effectiveFrom: 'desc' },
        }),
      ])
      const result = { social: socialCfg, housing: housingCfg }
      configCache.set(key, result)
      return result
    }
    // 预加载所有涉及城市的配置
    const cities = [...new Set(employees.map((e) => e.city).filter(Boolean))] as string[]
    await Promise.all(cities.map((c) => getConfigsForCity(c)))
    // 计算动态状态和合同状态
    let result = employees.map((e) => {
      const latestContract = e.contracts[0] || null
@@ -132,7 +195,7 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
      const isResigned = e.terminations.some((t) => t.status === 'COMPLETED' && t.terminationDate <= today)
      const isPreHire = !isResigned && e.hireDate > todayEnd
      const dynamicStatus = isResigned ? 'RESIGNED' : (isPreHire ? 'PRE_HIRE' : 'ACTIVE')
-      // 身份证号脱敏显示
+      // 证件号码脱敏显示
      let idCardMasked: string | null = null
      if (e.idCardNumber) {
        try {
@@ -148,6 +211,7 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
        id: e.id,
        name: e.name,
        department: e.department,
        position: e.position,
        city: e.city,
        status: dynamicStatus,
        hasTermination: e.terminations.length > 0,
@@ -159,8 +223,22 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
        gender: e.gender,
        phone: e.phone,
        idCardMasked,
-        idCardNumber: e.idCardNumber,
+        idCardNumber: safeDecryptStr(e.idCardNumber),
        monthlySalary: safeDecrypt(e.monthlySalary),
        socialInsBase: e.socialInsBase,
        housingFundBase: e.housingFundBase,
        socialInsCalc: (() => {
          const cfgs = configCache.get(e.city || '_default')
          if (!cfgs?.social || !e.socialInsBase) return null
          const r = calcSocialInsurance(e.socialInsBase, cfgs.social)
          return { socialEmp: r.socialEmp, socialOrg: r.socialOrg }
        })(),
        housingFundCalc: (() => {
          const cfgs = configCache.get(e.city || '_default')
          if (!cfgs?.housing || !e.housingFundBase) return null
          const r = calcHousingFund(e.housingFundBase, cfgs.housing)
          return { housingEmp: r.housingEmp, housingOrg: r.housingOrg }
        })(),
        isPregnant: e.isPregnant,
        isInMedicalPeriod: e.isInMedicalPeriod,
        isWorkInjured: e.isWorkInjured,
@@ -168,6 +246,19 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
        contractStatus: contractInfo.status,
        contractStatusText: contractInfo.statusText,
        riskLevel: contractInfo.riskLevel,
        socialInsuranceStatus: (() => {
          const sr = (e as any).socialInsRecords?.[0]
          // 劳务协议/实习协议：不缴纳社保，返回 null（前端显示"—"）
          const isNoSocialContract = latestContract && ['LABOR', 'INTERNSHIP'].includes(latestContract.contractType)
          if (isNoSocialContract) return null
          if (!sr) {
            // 在职且应缴社保但无社保记录 → 待办理
            return 'PENDING'
          }
          // endMonth 为 null 表示在保，否则已停保
          if (sr.endMonth) return 'SUSPENDED'
          return 'ACTIVE'
        })(),
        probationInfo: (() => {
          if (!latestContract || latestContract.probationMonths === 0) return null
          const probEnd = new Date(e.hireDate)
@@ -190,16 +281,11 @@ router.get('/', authMiddleware, async (req: AuthRequest, res, next) => {
      result = result.filter((e) => e.contractStatus === contractStatus)
    }
-    // 身份证号后N位搜索：在内存中过滤（解密完整身份证号后匹配）
+    // 证件号码后N位搜索：在内存中过滤（idCardNumber 已解密为明文）
    if (isIdCardSearch) {
      result = result.filter((e: any) => {
        if (!e.idCardNumber) return false
-        try {
+        return String(e.idCardNumber).endsWith(search!)
          const fullIdCard = decrypt(e.idCardNumber)
          return fullIdCard.endsWith(search!)
        } catch {
          return false
        }
      })
    }
@@ -303,7 +389,7 @@ router.get('/:id/profile', authMiddleware, async (req: AuthRequest, res, next) =
        status: dynamicStatus,
        monthlySalary: safeDecrypt(monthlySalary),
        bankAccount: bankAccount ? safeDecrypt(bankAccount).toString() : null,
-        idCardNumber: idCardNumber ? safeDecrypt(idCardNumber).toString() : null,
+        idCardNumber: safeDecryptStr(idCardNumber),
        monthlyProcessRecords,
      },
    })
@@ -727,14 +813,143 @@ router.get('/:id/evidence-chain/export', authMiddleware, async (req: AuthRequest
    wsRisk.getRow(1).font = { bold: true }
    risks.forEach((r, i) => wsRisk.addRow({ no: i + 1, ...r }))
-    const encodedName = encodeURIComponent(empName)
+    const fullFileName = `${empName}_证据链.xlsx`
    const encodedName = encodeURIComponent(fullFileName)
    const asciiFallback = `evidence_chain_${employee.id.slice(-8)}.xlsx`
    res.setHeader('Content-Type', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
-    res.setHeader('Content-Disposition', `attachment; filename="${encodedName}_证据链.xlsx"; filename*=UTF-8''${encodedName}_证据链.xlsx`)
+    res.setHeader('Content-Disposition', `attachment; filename="${asciiFallback}"; filename*=UTF-8''${encodedName}`)
-    await workbook.xlsx.write(res)
+    const buffer = await workbook.xlsx.writeBuffer()
    res.send(Buffer.from(buffer))
  } catch (err: any) {
    console.error('证据链导出失败:', err?.message || err)
    if (!res.headersSent) {
      res.status(500).json({ success: false, error: { code: 'EXPORT_FAILED', message: `导出失败：${err?.message || '服务器错误'}` } })
    } else {
      res.end()
  } catch (err) {
    next(err)
    }
  }
 })
 // ========== 组织级列表查询 ==========
 // 培训记录列表（全员）
 router.get('/training/list', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const orgId = req.user!.orgId
    const page = parseInt(req.query.page as string) || 1
    const pageSize = parseInt(req.query.pageSize as string) || 20
    const keyword = (req.query.keyword as string) || ''
    const ackStatus = (req.query.ackStatus as string) || ''
    const where: any = { orgId }
    if (ackStatus) {
      where.ackStatus = ackStatus
    }
    if (keyword) {
      const employees = await prisma.employee.findMany({
        where: { orgId, name: { contains: keyword } },
        select: { id: true },
      })
      where.employeeId = { in: employees.map(e => e.id) }
    }
    const [records, total] = await Promise.all([
      prisma.trainingRecord.findMany({
        where,
        include: { employee: { select: { id: true, name: true, department: true } } },
        orderBy: { trainingDate: 'desc' },
        skip: (page - 1) * pageSize,
        take: pageSize,
      }),
      prisma.trainingRecord.count({ where }),
    ])
    res.json({ success: true, data: { records, total, page, pageSize } })
  } catch (err) { next(err) }
 })
 // 培训记录催办（发送通知给未签收员工）
 router.post('/training/remind/:recordId', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const orgId = req.user!.orgId
    const record = await prisma.trainingRecord.findFirst({
      where: { id: req.params.recordId, orgId },
      include: { employee: { select: { id: true, name: true, department: true, phone: true } } },
    })
    if (!record) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '培训记录不存在' } })
    }
    if (record.ackStatus !== 'PENDING') {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '仅待签收记录可催办' } })
    }
    // 记录催办通知日志
    await prisma.notificationLog.create({
      data: {
        orgId,
        type: 'TRAINING_REMIND',
        title: `培训签收催办：${record.topic}`,
        content: `员工 ${record.employee.name}（${record.employee.department}）的培训记录「${record.topic}」尚未签收，请尽快完成签收。`,
        channel: 'SYSTEM',
        status: 'SENT',
      },
    })
    res.json({ success: true, data: { message: `已催办 ${record.employee.name} 签收「${record.topic}」` } })
  } catch (err) { next(err) }
 })
 // 绩效记录列表（全员）
 router.get('/performance/list', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const orgId = req.user!.orgId
    const page = parseInt(req.query.page as string) || 1
    const pageSize = parseInt(req.query.pageSize as string) || 20
    const keyword = (req.query.keyword as string) || ''
    const where: any = { orgId }
    if (keyword) {
      const employees = await prisma.employee.findMany({
        where: { orgId, name: { contains: keyword } },
        select: { id: true },
      })
      where.employeeId = { in: employees.map(e => e.id) }
    }
    const [records, total] = await Promise.all([
      prisma.performanceRecord.findMany({
        where,
        include: { employee: { select: { id: true, name: true, department: true } } },
        orderBy: { period: 'desc' },
        skip: (page - 1) * pageSize,
        take: pageSize,
      }),
      prisma.performanceRecord.count({ where }),
    ])
    res.json({ success: true, data: { records, total, page, pageSize } })
  } catch (err) { next(err) }
 })
 // 违纪记录列表（全员）
 router.get('/disciplinary/list', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const orgId = req.user!.orgId
    const page = parseInt(req.query.page as string) || 1
    const pageSize = parseInt(req.query.pageSize as string) || 20
    const keyword = (req.query.keyword as string) || ''
    const where: any = { orgId }
    if (keyword) {
      const employees = await prisma.employee.findMany({
        where: { orgId, name: { contains: keyword } },
        select: { id: true },
      })
      where.employeeId = { in: employees.map(e => e.id) }
    }
    const [records, total] = await Promise.all([
      prisma.disciplinaryRecord.findMany({
        where,
        include: { employee: { select: { id: true, name: true, department: true } } },
        orderBy: { violationDate: 'desc' },
        skip: (page - 1) * pageSize,
        take: pageSize,
      }),
      prisma.disciplinaryRecord.count({ where }),
    ])
    res.json({ success: true, data: { records, total, page, pageSize } })
  } catch (err) { next(err) }
 })
 // ========== 违纪记录 CRUD ==========
@@ -821,6 +1036,55 @@ router.delete('/:employeeId/disciplinary/:recordId', authMiddleware, async (req:
  } catch (err) { next(err) }
 })
 // 违纪确认证明导出
 router.get('/:employeeId/disciplinary/:recordId/certificate', authMiddleware, async (req: AuthRequest, res: Response, next) => {
  try {
    const record = await prisma.disciplinaryRecord.findFirst({
      where: { id: req.params.recordId, orgId: req.user!.orgId },
      include: { employee: true },
    })
    if (!record) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '记录不存在' } })
    }
    const org = await prisma.organization.findUnique({ where: { id: req.user!.orgId } })
    const typeMap: Record<string, string> = { LATE: '迟到', ABSENT: '旷工', INSUBORDINATION: '不服从管理', MISCONDUCT: '违纪', VIOLATE_POLICY: '违反规章制度', OTHER: '其他' }
    const actionMap: Record<string, string> = { ORAL_WARNING: '口头警告', WRITTEN_WARNING: '书面警告', DEDUCTION: '扣款', DEMOTION: '降职', TERMINATION: '解除劳动合同' }
    const severityMap: Record<string, string> = { WARNING: '警告', SERIOUS: '严重', SEVERE: '重度' }
    let idCard = ''
    try { if (record.employee.idCardNumber) idCard = decrypt(record.employee.idCardNumber) } catch { idCard = record.employee.idCardNumber || '' }
    const content = `违纪确认证明
 兹证明 ${record.employee.name}（证件号码：${idCard || '___'}）系我单位员工，于 ${record.violationDate.toISOString().slice(0, 10)} 发生以下违纪行为：
 违纪类型：${typeMap[record.violationType] || record.violationType}
 严重程度：${severityMap[record.severity] || record.severity}
 违纪事实：${record.description}
 处理结果：${actionMap[record.action] || record.action}${record.actionDetail ? `（${record.actionDetail}）` : ''}
 ${record.employeeAck ? `该员工已于 ${record.ackDate ? new Date(record.ackDate).toISOString().slice(0, 10) : '___'} 签字确认上述违纪事实及处理结果。${record.witness ? `见证人：${record.witness}。` : ''}` : '该员工尚未签字确认。'}
 特此证明。
 ${org?.name || ''}
 ${new Date().toLocaleDateString('zh-CN')}`
    const blob = Buffer.from('\ufeff' + content, 'utf8')
    const certFileName = `${record.employee.name}_违纪确认证明.doc`
    const encodedCertName = encodeURIComponent(certFileName)
    const asciiCertFallback = `disciplinary_cert_${record.id.slice(-8)}.doc`
    res.setHeader('Content-Type', 'application/msword;charset=utf-8')
    res.setHeader('Content-Disposition', `attachment; filename="${asciiCertFallback}"; filename*=UTF-8''${encodedCertName}`)
    res.send(blob)
  } catch (err: any) {
    console.error('违纪确认证明导出失败:', err?.message || err)
    if (!res.headersSent) {
      res.status(500).json({ success: false, error: { code: 'EXPORT_FAILED', message: `导出失败：${err?.message || '服务器错误'}` } })
    }
  }
 })
 // ========== 考勤记录 CRUD ==========
 router.get('/:employeeId/attendance', authMiddleware, async (req: AuthRequest, res, next) => {
@@ -915,6 +1179,33 @@ router.post('/:employeeId/training', authMiddleware, async (req: AuthRequest, re
  } catch (err) { next(err) }
 })
 // 批量创建培训记录
 router.post('/training/batch', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { employeeIds, trainingDate, topic, content, trainer, duration, remark } = req.body
    if (!employeeIds || !Array.isArray(employeeIds) || employeeIds.length === 0) {
      return res.json({ success: false, error: { code: 'VALIDATION_ERROR', message: '请至少选择一名员工' } })
    }
    const results = await Promise.all(employeeIds.map((empId: string) =>
      prisma.trainingRecord.create({
        data: {
          orgId: req.user!.orgId,
          employeeId: empId,
          trainingDate: new Date(trainingDate),
          topic,
          content,
          trainer,
          duration: duration || 0,
          ackStatus: 'PENDING',
          remark,
          createdBy: req.user!.id,
        },
      })
    ))
    res.json({ success: true, data: { count: results.length } })
  } catch (err) { next(err) }
 })
 router.put('/:employeeId/training/:recordId', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { trainingDate, topic, content, trainer, duration, ackStatus, ackDate, attachmentUrl, remark } = req.body
@@ -965,29 +1256,35 @@ router.get('/:employeeId/performance', authMiddleware, async (req: AuthRequest,
 router.post('/:employeeId/performance', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
-    const { period, score, grade, result, summary, improvementPlan, employeeAck, ackDate, reviewer } = req.body
+    const { period, periodType, score, grade, result, summary, improvementPlan, employeeAck, ackDate, reviewer, templateId, dimensionScores } = req.body
    const record = await prisma.performanceRecord.upsert({
      where: { employeeId_period: { employeeId: req.params.employeeId, period } },
      create: {
        orgId: req.user!.orgId,
        employeeId: req.params.employeeId,
        period,
        periodType: periodType || 'MONTHLY',
        score: score || 0,
        grade: grade || 'B',
        result: result || 'QUALIFIED',
        summary,
        improvementPlan,
        templateId: templateId || null,
        dimensionScores: dimensionScores || undefined,
        employeeAck: employeeAck || false,
        ackDate: ackDate ? new Date(ackDate) : null,
        reviewer,
        createdBy: req.user!.id,
      },
      update: {
        periodType,
        score,
        grade,
        result,
        summary,
        improvementPlan,
        templateId: templateId || null,
        dimensionScores: dimensionScores || undefined,
        employeeAck,
        ackDate: ackDate ? new Date(ackDate) : null,
        reviewer,
@@ -1000,7 +1297,7 @@ router.post('/:employeeId/performance', authMiddleware, async (req: AuthRequest,
 router.put('/:employeeId/performance/:recordId', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
-    const { period, score, grade, result, summary, improvementPlan, employeeAck, ackDate, reviewer } = req.body
+    const { period, periodType, score, grade, result, summary, improvementPlan, employeeAck, ackDate, reviewer, templateId, dimensionScores } = req.body
    const record = await prisma.performanceRecord.findFirst({
      where: { id: req.params.recordId, orgId: req.user!.orgId },
    })
@@ -1009,11 +1306,14 @@ router.put('/:employeeId/performance/:recordId', authMiddleware, async (req: Aut
      where: { id: req.params.recordId },
      data: {
        period,
        periodType,
        score,
        grade,
        result,
        summary,
        improvementPlan,
        templateId: templateId || null,
        dimensionScores: dimensionScores || undefined,
        employeeAck,
        ackDate: ackDate ? new Date(ackDate) : null,
        reviewer,
@@ -1034,6 +1334,72 @@ router.delete('/:employeeId/performance/:recordId', authMiddleware, async (req:
  } catch (err) { next(err) }
 })
 // ========== 绩效模板 CRUD ==========
 // 获取模板列表
 router.get('/performance/templates', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const templates = await prisma.performanceTemplate.findMany({
      where: { orgId: req.user!.orgId },
      orderBy: { createdAt: 'desc' },
    })
    res.json({ success: true, data: templates })
  } catch (err) { next(err) }
 })
 // 创建模板
 router.post('/performance/templates', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { name, description, dimensions, gradeRules, isDefault } = req.body
    if (!name || !dimensions || !Array.isArray(dimensions)) {
      return res.json({ success: false, error: { code: 'VALIDATION_ERROR', message: '模板名称和考核维度为必填' } })
    }
    // 如果设为默认，先取消其他默认
    if (isDefault) {
      await prisma.performanceTemplate.updateMany({ where: { orgId: req.user!.orgId, isDefault: true }, data: { isDefault: false } })
    }
    const template = await prisma.performanceTemplate.create({
      data: {
        orgId: req.user!.orgId,
        name,
        description,
        dimensions,
        gradeRules: gradeRules || undefined,
        isDefault: isDefault || false,
        createdBy: req.user!.id,
      },
    })
    res.json({ success: true, data: template })
  } catch (err) { next(err) }
 })
 // 更新模板
 router.put('/performance/templates/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { name, description, dimensions, gradeRules, isDefault } = req.body
    const existing = await prisma.performanceTemplate.findFirst({ where: { id: req.params.id, orgId: req.user!.orgId } })
    if (!existing) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '模板不存在' } })
    if (isDefault) {
      await prisma.performanceTemplate.updateMany({ where: { orgId: req.user!.orgId, isDefault: true, id: { not: req.params.id } }, data: { isDefault: false } })
    }
    const updated = await prisma.performanceTemplate.update({
      where: { id: req.params.id },
      data: { name, description, dimensions, gradeRules: gradeRules || undefined, isDefault },
    })
    res.json({ success: true, data: updated })
  } catch (err) { next(err) }
 })
 // 删除模板
 router.delete('/performance/templates/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const existing = await prisma.performanceTemplate.findFirst({ where: { id: req.params.id, orgId: req.user!.orgId } })
    if (!existing) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '模板不存在' } })
    await prisma.performanceTemplate.delete({ where: { id: req.params.id } })
    res.json({ success: true })
  } catch (err) { next(err) }
 })
 // ========== 调薪/调部门 API ==========
 function dateToMonth(date: Date): string {
@@ -1107,10 +1473,10 @@ router.get('/:id/salary-records', authMiddleware, async (req: AuthRequest, res,
  } catch (err) { next(err) }
 })
-// 调部门
+// 调动（部门+职务变动）
 router.post('/:id/department-change', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
-    const { newDepartment, effectiveMonth, reason } = req.body
+    const { newDepartment, newPosition, departmentId, effectiveMonth, reason } = req.body
    const employee = await prisma.employee.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
    })
@@ -1119,22 +1485,35 @@ router.post('/:id/department-change', authMiddleware, async (req: AuthRequest, r
    }
    const oldDepartment = employee.department
    const oldPosition = employee.position || null
    const effMonth = effectiveMonth || dateToMonth(new Date())
    const prevEffMonth = prevMonth(effMonth)
    // 校验 departmentId 是否属于当前组织
    let deptName = newDepartment
    if (departmentId) {
      const dept = await prisma.department.findFirst({ where: { id: departmentId, orgId: req.user!.orgId } })
      if (!dept) {
        return res.status(400).json({ success: false, error: { code: 'VALIDATION_ERROR', message: '目标部门不存在' } })
      }
      deptName = dept.name
    }
    // 关闭之前有效记录
    await prisma.employeeDepartmentRecord.updateMany({
      where: { employeeId: req.params.id, endMonth: null },
      data: { endMonth: prevEffMonth },
    })
-    // 创建新部门记录
+    // 创建新调动记录
    const record = await prisma.employeeDepartmentRecord.create({
      data: {
        orgId: req.user!.orgId,
        employeeId: req.params.id,
        oldDepartment,
-        newDepartment,
+        newDepartment: deptName,
        oldPosition,
        newPosition: newPosition || null,
        effectiveMonth: effMonth,
        endMonth: null,
        changeType: 'TRANSFER',
@@ -1143,13 +1522,17 @@ router.post('/:id/department-change', authMiddleware, async (req: AuthRequest, r
      },
    })
-    // 同步 Employee 便捷字段
+    // 同步 Employee 字段（department 文本 + departmentId 关联 + position 职务）
    await prisma.employee.update({
      where: { id: req.params.id },
-      data: { department: newDepartment },
+      data: {
        department: deptName,
        departmentId: departmentId || null,
        position: newPosition || employee.position,
      },
    })
-    await auditLog(req, 'CREATE', 'DEPARTMENT_CHANGE', record.id, { employeeId: req.params.id, oldDepartment, newDepartment })
+    await auditLog(req, 'CREATE', 'DEPARTMENT_CHANGE', record.id, { employeeId: req.params.id, oldDepartment, newDepartment: deptName, oldPosition, newPosition })
    res.json({ success: true, data: record })
  } catch (err) { next(err) }
 })
@@ -1223,4 +1606,20 @@ router.get('/contract-types', authMiddleware, (_req: AuthRequest, res) => {
  res.json({ success: true, data: types })
 })
 // 预入职转正式（PRE_ONBOARD → ACTIVE）
 router.post('/:id/activate', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const emp = await prisma.employee.findFirst({ where: { id: req.params.id, orgId: req.user!.orgId! } })
    if (!emp) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '员工不存在' } })
    if (emp.status !== 'PRE_ONBOARD') {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '该员工不是预入职状态' } })
    }
    const updated = await prisma.employee.update({
      where: { id: emp.id },
      data: { status: 'ACTIVE' },
    })
    res.json({ success: true, data: { id: updated.id, status: updated.status } })
  } catch (err) { next(err) }
 })
 export default router
@@ -28,7 +28,7 @@ router.get('/org', async (req: AuthRequest, res, next) => {
  try {
    const org = await prisma.organization.findUnique({
      where: { id: req.user!.orgId },
-      select: { id: true, name: true, plan: true, maxEmployees: true, city: true, contactName: true, contactPhone: true, payrollFrequency: true, retirementReminderEnabled: true, createdAt: true },
+      select: { id: true, name: true, plan: true, maxEmployees: true, city: true, contactName: true, contactPhone: true, payrollDays: true, payrollReminderDays: true, retirementReminderEnabled: true, esignPolicyEnabled: true, esignPayslipEnabled: true, esignOnboardingEnabled: true, createdAt: true },
    })
    res.json({ success: true, data: org })
  } catch (err) {
@@ -39,18 +39,22 @@ router.get('/org', async (req: AuthRequest, res, next) => {
 // 更新企业信息
 router.put('/org', requireAdmin, async (req: AuthRequest, res, next) => {
  try {
-    const { name, payrollFrequency, city, contactName, contactPhone, retirementReminderEnabled } = req.body as { name?: string; payrollFrequency?: number; city?: string; contactName?: string; contactPhone?: string; retirementReminderEnabled?: boolean }
+    const { name, payrollDays, payrollReminderDays, city, contactName, contactPhone, retirementReminderEnabled, esignPolicyEnabled, esignPayslipEnabled, esignOnboardingEnabled } = req.body as { name?: string; payrollDays?: number[]; payrollReminderDays?: number; city?: string; contactName?: string; contactPhone?: string; retirementReminderEnabled?: boolean; esignPolicyEnabled?: boolean; esignPayslipEnabled?: boolean; esignOnboardingEnabled?: boolean }
    const updateData: any = {}
    if (name) updateData.name = name
-    if (payrollFrequency !== undefined) updateData.payrollFrequency = payrollFrequency
+    if (payrollDays !== undefined) updateData.payrollDays = payrollDays
    if (payrollReminderDays !== undefined) updateData.payrollReminderDays = payrollReminderDays
    if (city !== undefined) updateData.city = city
    if (contactName !== undefined) updateData.contactName = contactName
    if (contactPhone !== undefined) updateData.contactPhone = contactPhone
    if (retirementReminderEnabled !== undefined) updateData.retirementReminderEnabled = retirementReminderEnabled
    if (esignPolicyEnabled !== undefined) updateData.esignPolicyEnabled = esignPolicyEnabled
    if (esignPayslipEnabled !== undefined) updateData.esignPayslipEnabled = esignPayslipEnabled
    if (esignOnboardingEnabled !== undefined) updateData.esignOnboardingEnabled = esignOnboardingEnabled
    const org = await prisma.organization.update({
      where: { id: req.user!.orgId },
      data: updateData,
-      select: { id: true, name: true, plan: true, maxEmployees: true, city: true, contactName: true, contactPhone: true, payrollFrequency: true, retirementReminderEnabled: true },
+      select: { id: true, name: true, plan: true, maxEmployees: true, city: true, contactName: true, contactPhone: true, payrollDays: true, payrollReminderDays: true, retirementReminderEnabled: true, esignPolicyEnabled: true, esignPayslipEnabled: true, esignOnboardingEnabled: true },
    })
    res.json({ success: true, data: org })
  } catch (err) {
@@ -241,3 +245,101 @@ router.post('/retirement-policy/:id/confirm', requireAdmin, async (req: AuthRequ
  }
 })
 // ========== 医疗期政策配置 ==========
 const DEFAULT_POLICIES = [
  {
    region: '全国',
    legalBasis: '《企业职工患病或非因工负伤医疗期规定》第三条（劳部发[1994]479号）',
    rules: [
      { maxYears: 5, months: 3, cycleMonths: 6 },
      { maxYears: 10, months: 6, cycleMonths: 12 },
      { maxYears: 15, months: 9, cycleMonths: 15 },
      { maxYears: 20, months: 12, cycleMonths: 18 },
      { maxYears: 999, months: 24, cycleMonths: 30 },
    ],
    isDefault: true,
  },
  {
    region: '上海',
    legalBasis: '《上海市关于本市劳动者在履行劳动合同期间患病或者非因工负伤的医疗期标准的规定》',
    rules: [
      { maxYears: 1, months: 3, cycleMonths: 6 },
      { maxYears: 4, months: 3, cycleMonths: 6 },
      { maxYears: 10, months: 6, cycleMonths: 12 },
      { maxYears: 999, months: 9, cycleMonths: 18 },
    ],
    isDefault: false,
  },
 ]
 // 获取医疗期政策列表
 router.get('/medical-period/policies', async (req: AuthRequest, res, next) => {
  try {
    let policies = await prisma.medicalPeriodPolicy.findMany({
      where: { orgId: req.user!.orgId },
      orderBy: [{ isDefault: 'desc' }, { region: 'asc' }],
    })
    if (policies.length === 0) {
      policies = await prisma.$transaction(
        DEFAULT_POLICIES.map(p =>
          prisma.medicalPeriodPolicy.create({
            data: { orgId: req.user!.orgId, ...p },
          })
        )
      )
    }
    res.json({ success: true, data: policies })
  } catch (err) {
    next(err)
  }
 })
 // 新增/编辑医疗期政策
 const medicalPolicySchema = z.object({
  region: z.string().min(1, '地区名称不能为空'),
  legalBasis: z.string().min(1, '法律依据不能为空'),
  rules: z.array(z.object({
    maxYears: z.number().min(0),
    months: z.number().min(1),
    cycleMonths: z.number().min(1),
  })).min(1, '至少需要一条分档规则'),
  isDefault: z.boolean().default(false),
 })
 router.post('/medical-period/policies', requireAdmin, async (req: AuthRequest, res, next) => {
  try {
    const data = medicalPolicySchema.parse(req.body)
    if (data.isDefault) {
      await prisma.medicalPeriodPolicy.updateMany({
        where: { orgId: req.user!.orgId },
        data: { isDefault: false },
      })
    }
    const policy = await prisma.medicalPeriodPolicy.upsert({
      where: { orgId_region: { orgId: req.user!.orgId, region: data.region } },
      update: { legalBasis: data.legalBasis, rules: data.rules, isDefault: data.isDefault },
      create: { orgId: req.user!.orgId, ...data },
    })
    res.json({ success: true, data: policy })
  } catch (err: any) {
    if (err.issues) return res.status(400).json({ success: false, error: { code: 'VALIDATION_ERROR', message: err.issues[0]?.message } })
    next(err)
  }
 })
 // 删除医疗期政策
 router.delete('/medical-period/policies/:id', requireAdmin, async (req: AuthRequest, res, next) => {
  try {
    const policy = await prisma.medicalPeriodPolicy.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
    })
    if (!policy) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '政策不存在' } })
    if (policy.isDefault) return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '不能删除默认政策' } })
    await prisma.medicalPeriodPolicy.delete({ where: { id: req.params.id } })
    res.json({ success: true })
  } catch (err) {
    next(err)
  }
 })
@@ -9,11 +9,13 @@ const router = Router()
 router.use(authMiddleware)
 const socialConfigFields = {
-  city: z.string().optional(),
+  city: z.string().min(1),
  pensionOrg: z.number().optional(),
  pensionEmp: z.number().optional(),
  medicalOrg: z.number().optional(),
  medicalEmp: z.number().optional(),
  medicalOrgExtra: z.number().min(0).optional(),
  medicalEmpExtra: z.number().min(0).optional(),
  unemploymentOrg: z.number().optional(),
  unemploymentEmp: z.number().optional(),
  injuryOrg: z.number().optional(),
@@ -23,10 +25,11 @@ const socialConfigFields = {
  medicalBaseMin: z.number().optional(),
  medicalBaseMax: z.number().optional(),
  extraInsurances: z.any().optional(),
  minWage: z.number().min(0).optional(),
 }
 const housingConfigFields = {
-  city: z.string().optional(),
+  city: z.string().min(1),
  accountType: z.string().optional(),
  housingOrg: z.number().optional(),
  housingEmp: z.number().optional(),
@@ -34,6 +37,426 @@ const housingConfigFields = {
  baseMax: z.number().optional(),
 }
 // ==========================================
 // 账户管理 API（新）
 // ==========================================
 const accountSchema = z.object({
  type: z.enum(['SOCIAL', 'HOUSING']),
  name: z.string().min(1),
  city: z.string().min(1),
  accountNo: z.string().optional(),
  bankName: z.string().optional(),
  bankAccount: z.string().optional(),
  orgName: z.string().optional(),
  orgCode: z.string().optional(),
  accountType: z.string().optional(),
  isDefault: z.boolean().optional(),
  remark: z.string().optional(),
 })
 // 账户列表
 router.get('/accounts', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const type = req.query.type as string | undefined
    const where: any = { orgId }
    if (type) where.type = type
    const accounts = await prisma.socialAccount.findMany({
      where,
      orderBy: [{ type: 'asc' }, { isDefault: 'desc' }, { city: 'asc' }],
      include: {
        _count: { select: { socialRecords: true, housingRecords: true, deptSocialAccounts: true, deptHousingAccounts: true } },
      },
    })
    res.json({ success: true, data: accounts })
  } catch (err) { next(err) }
 })
 // 新建账户
 router.post('/accounts', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const data = accountSchema.parse(req.body)
    // 如果设为默认，先取消同 type 其他默认
    if (data.isDefault) {
      await prisma.socialAccount.updateMany({ where: { orgId, type: data.type, isDefault: true }, data: { isDefault: false } })
    }
    const account = await prisma.socialAccount.create({
      data: { ...data, orgId, createdBy: req.user!.id },
    })
    res.json({ success: true, data: account })
  } catch (err) { next(err) }
 })
 // 编辑账户
 router.put('/accounts/:id', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const data = accountSchema.partial().parse(req.body)
    if (data.isDefault) {
      const account = await prisma.socialAccount.findUnique({ where: { id: req.params.id } })
      await prisma.socialAccount.updateMany({ where: { orgId, type: account?.type, isDefault: true, id: { not: req.params.id } }, data: { isDefault: false } })
    }
    const account = await prisma.socialAccount.update({
      where: { id: req.params.id },
      data,
    })
    res.json({ success: true, data: account })
  } catch (err) { next(err) }
 })
 // 删除账户（无关联记录时可删）
 router.delete('/accounts/:id', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const account = await prisma.socialAccount.findFirst({ where: { id: req.params.id, orgId } })
    if (!account) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '账户不存在' } })
    // 检查是否有关联记录
    const [socialCount, housingCount, deptCount] = await Promise.all([
      prisma.employeeSocialInsRecord.count({ where: { accountId: account.id } }),
      prisma.employeeHousingFundRecord.count({ where: { accountId: account.id } }),
      prisma.department.count({ where: { OR: [{ socialAccountId: account.id }, { housingAccountId: account.id }] } }),
    ])
    if (socialCount + housingCount + deptCount > 0) {
      return res.status(400).json({ success: false, error: { code: 'IN_USE', message: `账户仍关联 ${socialCount + housingCount} 条参保记录、${deptCount} 个部门，无法删除` } })
    }
    await prisma.socialAccount.delete({ where: { id: account.id } })
    res.json({ success: true, data: { message: '已删除' } })
  } catch (err) { next(err) }
 })
 // 设为默认账户
 router.put('/accounts/:id/default', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const account = await prisma.socialAccount.findFirst({ where: { id: req.params.id, orgId } })
    if (!account) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '账户不存在' } })
    await prisma.socialAccount.updateMany({ where: { orgId, type: account.type, isDefault: true }, data: { isDefault: false } })
    await prisma.socialAccount.update({ where: { id: account.id }, data: { isDefault: true } })
    res.json({ success: true, data: { message: '已设为默认' } })
  } catch (err) { next(err) }
 })
 // ==========================================
 // 年度标准 API（新，按 accountId）
 // ==========================================
 // 按账户获取年度标准列表
 router.get('/accounts/:accountId/standards', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { accountId } = req.params
    const standards = await prisma.socialYearStandard.findMany({
      where: { orgId, accountId },
      orderBy: { effectiveFrom: 'desc' },
    })
    res.json({ success: true, data: standards })
  } catch (err) { next(err) }
 })
 // 按账户获取当前生效标准
 router.get('/accounts/:accountId/current-standard', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { accountId } = req.params
    const standard = await prisma.socialYearStandard.findFirst({
      where: { orgId, accountId, isCurrent: true },
      orderBy: { effectiveFrom: 'desc' },
    })
    res.json({ success: true, data: standard })
  } catch (err) { next(err) }
 })
 // 按账户获取继承数据（当前标准 → 旧社保配置 → 默认值），用于新建年度标准初始值
 router.get('/accounts/:accountId/inherit-config', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { accountId } = req.params
    const account = await prisma.socialAccount.findFirst({ where: { id: accountId, orgId } })
    if (!account) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '账户不存在' } })
    // 1. 优先用当前年度标准
    const currentStandard = await prisma.socialYearStandard.findFirst({
      where: { orgId, accountId, isCurrent: true },
      orderBy: { effectiveFrom: 'desc' },
    })
    if (currentStandard) {
      return res.json({ success: true, data: { ...currentStandard, source: 'current_standard' } })
    }
    // 2. 回退到旧社保/公积金配置表（按城市）
    if (account.type === 'HOUSING') {
      const oldConfig = await prisma.housingFundConfig.findFirst({
        where: { orgId, city: account.city },
        orderBy: { effectiveFrom: 'desc' },
      })
      if (oldConfig) {
        return res.json({ success: true, data: { ...oldConfig, source: 'old_housing_config' } })
      }
    } else {
      const oldConfig = await prisma.socialInsuranceConfig.findFirst({
        where: { orgId, city: account.city },
        orderBy: { effectiveFrom: 'desc' },
      })
      if (oldConfig) {
        return res.json({ success: true, data: { ...oldConfig, source: 'old_social_config' } })
      }
    }
    // 3. 都没有，返回 null
    res.json({ success: true, data: null })
  } catch (err) { next(err) }
 })
 // 按账户+月份获取适用标准
 router.get('/accounts/:accountId/standard-by-month/:month', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { accountId, month } = req.params
    const standard = await prisma.socialYearStandard.findFirst({
      where: {
        orgId, accountId,
        effectiveFrom: { lte: month },
        OR: [{ effectiveTo: null }, { effectiveTo: { gte: month } }],
      },
      orderBy: { effectiveFrom: 'desc' },
    })
    if (!standard) {
      const current = await prisma.socialYearStandard.findFirst({ where: { orgId, accountId, isCurrent: true } })
      return res.json({ success: true, data: current })
    }
    res.json({ success: true, data: standard })
  } catch (err) { next(err) }
 })
 // 新建年度标准
 const yearStandardSchema = z.object({
  effectiveFrom: z.string().regex(/^\d{4}-\d{2}$/),
  pensionOrg: z.number().optional(),
  pensionEmp: z.number().optional(),
  medicalOrg: z.number().optional(),
  medicalEmp: z.number().optional(),
  medicalOrgExtra: z.number().min(0).optional(),
  medicalEmpExtra: z.number().min(0).optional(),
  unemploymentOrg: z.number().optional(),
  unemploymentEmp: z.number().optional(),
  injuryOrg: z.number().optional(),
  maternityOrg: z.number().optional(),
  baseMin: z.number().optional(),
  baseMax: z.number().optional(),
  medicalBaseMin: z.number().optional(),
  medicalBaseMax: z.number().optional(),
  extraInsurances: z.any().optional(),
  housingOrg: z.number().optional(),
  housingEmp: z.number().optional(),
  housingBaseMin: z.number().min(0).optional(),
  housingBaseMax: z.number().min(0).optional(),
  minWage: z.number().min(0).optional(),
 })
 router.post('/accounts/:accountId/standards', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { accountId } = req.params
    const data = yearStandardSchema.parse(req.body)
    const account = await prisma.socialAccount.findFirst({ where: { id: accountId, orgId } })
    if (!account) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '账户不存在' } })
    // 检查是否已存在同 effectiveFrom 的标准
    const existing = await prisma.socialYearStandard.findFirst({ where: { accountId, effectiveFrom: data.effectiveFrom } })
    if (existing) {
      // 已存在：更新而非报错
      const standard = await prisma.socialYearStandard.update({
        where: { id: existing.id },
        data: { ...data, isCurrent: true, effectiveTo: null },
      })
      // 将其他当前版本标记为失效
      await prisma.socialYearStandard.updateMany({
        where: { accountId, isCurrent: true, id: { not: existing.id } },
        data: { isCurrent: false, effectiveTo: data.effectiveFrom },
      })
      return res.json({ success: true, data: standard })
    }
    // 将旧当前版本标记为失效
    const current = await prisma.socialYearStandard.findFirst({ where: { accountId, isCurrent: true } })
    if (current) {
      const prevMonth = data.effectiveFrom
      await prisma.socialYearStandard.update({
        where: { id: current.id },
        data: { isCurrent: false, effectiveTo: prevMonth },
      })
    }
    const standard = await prisma.socialYearStandard.create({
      data: { ...data, orgId, accountId, isCurrent: true, createdBy: req.user!.id },
    })
    res.json({ success: true, data: standard })
  } catch (err) { next(err) }
 })
 /**
 * 快速更新当前年度标准的最低工资（无需新建版本）
 */
 router.put('/accounts/:accountId/min-wage', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { accountId } = req.params
    const { minWage } = req.body as { minWage: number }
    if (minWage === undefined || minWage < 0) {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: 'minWage 必须为非负数' } })
    }
    const account = await prisma.socialAccount.findFirst({ where: { id: accountId, orgId } })
    if (!account) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '账户不存在' } })
    const standard = await prisma.socialYearStandard.findFirst({ where: { accountId, isCurrent: true } })
    if (!standard) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '当前年度标准不存在' } })
    const updated = await prisma.socialYearStandard.update({ where: { id: standard.id }, data: { minWage } })
    res.json({ success: true, data: updated })
  } catch (err) { next(err) }
 })
 // 账户关联根部门（level=0）批量设置
 router.put('/accounts/:id/departments', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { id } = req.params
    const { departmentIds } = req.body as { departmentIds: string[] }
    const account = await prisma.socialAccount.findFirst({ where: { id, orgId } })
    if (!account) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '账户不存在' } })
    // 先清除该账户的所有部门关联
    const field = account.type === 'SOCIAL' ? 'socialAccountId' : 'housingAccountId'
    await prisma.department.updateMany({
      where: { orgId, [field]: id },
      data: { [field]: null },
    })
    // 批量设置新关联（仅 level=0 根部门）
    if (departmentIds && departmentIds.length > 0) {
      await prisma.department.updateMany({
        where: { id: { in: departmentIds }, orgId, level: 0 },
        data: { [field]: id },
      })
    }
    res.json({ success: true, data: { message: `已关联 ${departmentIds?.length || 0} 个根部门` } })
  } catch (err) { next(err) }
 })
 // 获取账户已关联的根部门列表
 router.get('/accounts/:id/departments', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { id } = req.params
    const account = await prisma.socialAccount.findFirst({ where: { id, orgId } })
    if (!account) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '账户不存在' } })
    const field = account.type === 'SOCIAL' ? 'socialAccountId' : 'housingAccountId'
    const departments = await prisma.department.findMany({
      where: { orgId, level: 0, [field]: id },
      select: { id: true, name: true },
    })
    res.json({ success: true, data: departments })
  } catch (err) { next(err) }
 })
 // 按部门获取适用账户（选部门时自动带出）
 router.get('/department-account/:departmentId', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { departmentId } = req.params
    // 向上找到 level=0 的根部门
    let currentDept: any = await prisma.department.findFirst({ where: { id: departmentId, orgId } })
    if (!currentDept) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '部门不存在' } })
    while (currentDept && currentDept.level > 0 && currentDept.parentId) {
      currentDept = await prisma.department.findUnique({ where: { id: currentDept.parentId } })
    }
    const rootDeptId = currentDept?.id || null
    let socialAccount: any = null
    let housingAccount: any = null
    if (rootDeptId) {
      const rootDept = await prisma.department.findUnique({
        where: { id: rootDeptId },
        include: { socialAccount: true, housingAccount: true },
      })
      socialAccount = rootDept?.socialAccount || null
      housingAccount = rootDept?.housingAccount || null
    }
    // 回退到公司默认账户
    if (!socialAccount) {
      socialAccount = await prisma.socialAccount.findFirst({ where: { orgId, type: 'SOCIAL', isDefault: true } })
    }
    if (!housingAccount) {
      housingAccount = await prisma.socialAccount.findFirst({ where: { orgId, type: 'HOUSING', isDefault: true } })
    }
    // 获取当前生效标准
    const currentMonth = new Date().toISOString().slice(0, 7)
    let socialStandard: any = null
    let housingStandard: any = null
    if (socialAccount) {
      socialStandard = await prisma.socialYearStandard.findFirst({
        where: { accountId: socialAccount.id, isCurrent: true },
        orderBy: { effectiveFrom: 'desc' },
      })
    }
    if (housingAccount) {
      housingStandard = await prisma.socialYearStandard.findFirst({
        where: { accountId: housingAccount.id, isCurrent: true },
        orderBy: { effectiveFrom: 'desc' },
      })
    }
    res.json({ success: true, data: { socialAccount, housingAccount, socialStandard, housingStandard } })
  } catch (err) { next(err) }
 })
 // 按员工获取适用账户（通过根部门 level=0 继承，不向下到普通部门）
 router.get('/employee-account/:employeeId', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const { employeeId } = req.params
    const emp = await prisma.employee.findFirst({
      where: { id: employeeId, orgId },
      include: { dept: true },
    })
    if (!emp) return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '员工不存在' } })
    // 向上找到 level=0 的根部门（代表分公司/子公司）
    let currentDept: any = emp.dept
    while (currentDept && currentDept.level > 0 && currentDept.parentId) {
      currentDept = await prisma.department.findUnique({
        where: { id: currentDept.parentId },
      })
    }
    const rootDeptId = currentDept?.id || null
    // 从根部门获取关联账户
    let socialAccount: any = null
    let housingAccount: any = null
    if (rootDeptId) {
      const rootDept = await prisma.department.findUnique({
        where: { id: rootDeptId },
        include: { socialAccount: true, housingAccount: true },
      })
      socialAccount = rootDept?.socialAccount || null
      housingAccount = rootDept?.housingAccount || null
    }
    // 回退到公司默认账户
    if (!socialAccount) {
      socialAccount = await prisma.socialAccount.findFirst({ where: { orgId, type: 'SOCIAL', isDefault: true } })
    }
    if (!housingAccount) {
      housingAccount = await prisma.socialAccount.findFirst({ where: { orgId, type: 'HOUSING', isDefault: true } })
    }
    res.json({ success: true, data: { socialAccount, housingAccount } })
  } catch (err) { next(err) }
 })
 // 获取当前生效版本（支持按城市筛选）
 router.get('/config', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
@@ -136,9 +559,9 @@ router.post('/config/versions', async (req: AuthRequest, res: Response, next: Ne
      return res.status(400).json({ success: false, message: `${data.effectiveFrom} 已有配置版本` })
    }
-    // 将之前当前版本标记为失效
+    // 将之前当前版本标记为失效（按城市过滤）
    const prevCurrent = await prisma.socialInsuranceConfig.findFirst({
-      where: { orgId, isCurrent: true },
+      where: { orgId, city: data.city, isCurrent: true },
    })
    if (prevCurrent) {
      // 计算上个版本的失效月份 = 新版本生效月份的前一个月
@@ -398,8 +821,8 @@ router.post('/calculate', async (req: AuthRequest, res: Response, next: NextFunc
    const pensionOrg = actualBase * config.pensionOrg / 100
    const pensionEmp = actualBase * config.pensionEmp / 100
-    const medicalOrg = medicalBase * config.medicalOrg / 100
+    const medicalOrg = medicalBase * config.medicalOrg / 100 + (config.medicalOrgExtra || 0)
-    const medicalEmp = medicalBase * config.medicalEmp / 100
+    const medicalEmp = medicalBase * config.medicalEmp / 100 + (config.medicalEmpExtra || 0)
    const unemploymentOrg = actualBase * config.unemploymentOrg / 100
    const unemploymentEmp = actualBase * config.unemploymentEmp / 100
    const injuryOrg = actualBase * config.injuryOrg / 100
@@ -788,7 +1211,7 @@ function calcSocialDetail(base: number, config: any) {
  const medicalBase = Math.min(Math.max(base, medMin), medMax)
  const items = [
    { name: '养老', orgRate: config.pensionOrg, empRate: config.pensionEmp, orgAmount: actualBase * config.pensionOrg / 100, empAmount: actualBase * config.pensionEmp / 100 },
-    { name: '医疗', orgRate: config.medicalOrg, empRate: config.medicalEmp, orgAmount: medicalBase * config.medicalOrg / 100, empAmount: medicalBase * config.medicalEmp / 100 },
+    { name: '医疗', orgRate: config.medicalOrg, empRate: config.medicalEmp, orgAmount: medicalBase * config.medicalOrg / 100 + (config.medicalOrgExtra || 0), empAmount: medicalBase * config.medicalEmp / 100 + (config.medicalEmpExtra || 0) },
    { name: '失业', orgRate: config.unemploymentOrg, empRate: config.unemploymentEmp, orgAmount: actualBase * config.unemploymentOrg / 100, empAmount: actualBase * config.unemploymentEmp / 100 },
    { name: '工伤', orgRate: config.injuryOrg, empRate: 0, orgAmount: actualBase * config.injuryOrg / 100, empAmount: 0 },
    { name: '生育', orgRate: config.maternityOrg, empRate: 0, orgAmount: medicalBase * config.maternityOrg / 100, empAmount: 0 },
@@ -1511,4 +1934,71 @@ router.post('/ai-suggest', async (req: AuthRequest, res: Response, next: NextFun
  }
 })
 // ========== 员工参保信息列表 ==========
 router.get('/employee-enrollment', async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const orgId = req.user!.orgId
    const keyword = (req.query.keyword as string) || ''
    // 查询所有在职员工
    const employees = await prisma.employee.findMany({
      where: {
        orgId,
        status: 'ACTIVE',
        ...(keyword ? { name: { contains: keyword, mode: 'insensitive' } } : {}),
      },
      select: {
        id: true,
        name: true,
        department: true,
        position: true,
        socialInsBase: true,
        housingFundBase: true,
        city: true,
      },
      orderBy: { department: 'asc' },
    })
    const empIds = employees.map(e => e.id)
    // 查询当前有效的社保记录（endMonth 为 null）
    const socialRecords = await prisma.employeeSocialInsRecord.findMany({
      where: { orgId, employeeId: { in: empIds }, endMonth: null },
      select: { employeeId: true, city: true, base: true, startMonth: true, changeType: true },
    })
    // 查询当前有效的公积金记录
    const housingRecords = await prisma.employeeHousingFundRecord.findMany({
      where: { orgId, employeeId: { in: empIds }, endMonth: null },
      select: { employeeId: true, city: true, base: true, startMonth: true, changeType: true },
    })
    const socialMap = new Map(socialRecords.map(r => [r.employeeId, r]))
    const housingMap = new Map(housingRecords.map(r => [r.employeeId, r]))
    const list = employees.map(emp => {
      const social = socialMap.get(emp.id)
      const housing = housingMap.get(emp.id)
      return {
        id: emp.id,
        name: emp.name,
        department: emp.department,
        position: emp.position,
        socialInsBase: social?.base ?? emp.socialInsBase ?? 0,
        socialInsCity: social?.city ?? emp.city ?? '',
        socialInsStart: social?.startMonth ?? '',
        socialInsStatus: social ? 'INSURED' : 'UNINSURED',
        housingFundBase: housing?.base ?? emp.housingFundBase ?? 0,
        housingFundCity: housing?.city ?? emp.city ?? '',
        housingFundStart: housing?.startMonth ?? '',
        housingFundStatus: housing ? 'INSURED' : 'UNINSURED',
      }
    })
    res.json({ success: true, data: list })
  } catch (err) {
    next(err)
  }
 })
 export default router
@@ -0,0 +1,237 @@
 /**
 * 客服工作台路由
 * 提供工单管理、客户会话、租户数据穿透
 */
 import { Router } from 'express'
 import { authMiddleware, AuthRequest } from '../middleware/auth'
 import prisma from '../lib/prisma'
 import { z } from 'zod'
 const router = Router()
 // 客服权限中间件
 const supportMiddleware = (req: AuthRequest, res: any, next: any) => {
  if (req.user!.role !== 'SUPPORT' && req.user!.role !== 'SUPER_ADMIN') {
    return res.status(403).json({ success: false, error: { code: 'FORBIDDEN', message: '仅客服或超级管理员可访问' } })
  }
  next()
 }
 const createTicketSchema = z.object({
  title: z.string().min(1, '标题必填'),
  content: z.string().min(1, '内容必填'),
  category: z.string().optional(),
  priority: z.enum(['LOW', 'NORMAL', 'HIGH', 'URGENT']).default('NORMAL'),
 })
 const createMessageSchema = z.object({
  content: z.string().min(1, '内容必填'),
 })
 // ==================== 工单管理 ====================
 /** 获取工单列表（客服看全部，企业用户看自己租户的） */
 router.get('/tickets', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const isSupport = req.user!.role === 'SUPPORT' || req.user!.role === 'SUPER_ADMIN'
    const where = isSupport ? {} : { orgId: req.user!.orgId! }
    const tickets = await prisma.ticket.findMany({
      where,
      orderBy: { createdAt: 'desc' },
      include: {
        org: { select: { id: true, name: true } },
        _count: { select: { messages: true } },
      },
    })
    res.json({ success: true, data: tickets })
  } catch (err) {
    next(err)
  }
 })
 /** 获取工单详情 */
 router.get('/tickets/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    const ticket = await prisma.ticket.findUnique({
      where: { id },
      include: {
        org: { select: { id: true, name: true } },
        messages: { orderBy: { createdAt: 'asc' } },
      },
    })
    if (!ticket) throw { code: 'NOT_FOUND', message: '工单不存在' }
    res.json({ success: true, data: ticket })
  } catch (err) {
    next(err)
  }
 })
 /** 创建工单（企业用户提交） */
 router.post('/tickets', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const data = createTicketSchema.parse(req.body)
    const ticket = await prisma.ticket.create({
      data: {
        ...data,
        orgId: req.user!.orgId!,
        createdBy: req.user!.id,
      },
    })
    res.json({ success: true, data: ticket })
  } catch (err) {
    next(err)
  }
 })
 /** 回复工单 */
 router.post('/tickets/:id/messages', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    const data = createMessageSchema.parse(req.body)
    const isSupport = req.user!.role === 'SUPPORT' || req.user!.role === 'SUPER_ADMIN'
    const message = await prisma.ticketMessage.create({
      data: {
        ticketId: id,
        content: data.content,
        senderId: req.user!.id,
        senderRole: isSupport ? 'SUPPORT' : 'USER',
      },
    })
    // 客服回复时更新工单状态为处理中
    if (isSupport) {
      await prisma.ticket.update({ where: { id }, data: { status: 'IN_PROGRESS', assigneeId: req.user!.id } })
    }
    res.json({ success: true, data: message })
  } catch (err) {
    next(err)
  }
 })
 /** 关闭工单 */
 router.post('/tickets/:id/close', authMiddleware, supportMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    await prisma.ticket.update({ where: { id }, data: { status: 'CLOSED' } })
    res.json({ success: true })
  } catch (err) {
    next(err)
  }
 })
 /** 转派工单 */
 router.post('/tickets/:id/assign', authMiddleware, supportMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    const { assigneeId } = req.body
    await prisma.ticket.update({ where: { id }, data: { assigneeId } })
    res.json({ success: true })
  } catch (err) {
    next(err)
  }
 })
 // ==================== 客户会话 ====================
 /** 获取会话列表 */
 router.get('/chat/sessions', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const isSupport = req.user!.role === 'SUPPORT' || req.user!.role === 'SUPER_ADMIN'
    const where = isSupport ? { supportUserId: req.user!.id } : { orgId: req.user!.orgId! }
    const sessions = await prisma.chatSession.findMany({
      where,
      orderBy: { lastMessageAt: 'desc' },
      include: { org: { select: { id: true, name: true } } },
    })
    res.json({ success: true, data: sessions })
  } catch (err) {
    next(err)
  }
 })
 /** 获取会话消息 */
 router.get('/chat/sessions/:id/messages', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    const messages = await prisma.chatMessage.findMany({
      where: { sessionId: id },
      orderBy: { createdAt: 'asc' },
    })
    res.json({ success: true, data: messages })
  } catch (err) {
    next(err)
  }
 })
 /** 发送会话消息 */
 router.post('/chat/sessions/:id/messages', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { id } = req.params
    const { content } = req.body as { content: string }
    if (!content) throw { code: 'VALIDATION_ERROR', message: '内容必填' }
    const isSupport = req.user!.role === 'SUPPORT' || req.user!.role === 'SUPER_ADMIN'
    const session = await prisma.chatSession.findUnique({ where: { id } })
    if (!session) throw { code: 'NOT_FOUND', message: '会话不存在' }
    const message = await prisma.chatMessage.create({
      data: {
        sessionId: id,
        content,
        senderId: req.user!.id,
        senderRole: isSupport ? 'SUPPORT' : 'USER',
      },
    })
    await prisma.chatSession.update({
      where: { id },
      data: {
        lastMessage: content,
        lastMessageAt: new Date(),
        unreadBySupport: isSupport ? session.unreadBySupport : session.unreadBySupport + 1,
        unreadByUser: isSupport ? session.unreadByUser + 1 : session.unreadByUser,
      },
    })
    res.json({ success: true, data: message })
  } catch (err) {
    next(err)
  }
 })
 // ==================== 租户数据穿透 ====================
 /** 获取租户列表（客服用） */
 router.get('/tenants', authMiddleware, supportMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const tenants = await prisma.organization.findMany({
      select: {
        id: true, name: true, plan: true, maxEmployees: true,
        contactName: true, contactPhone: true, createdAt: true,
        _count: { select: { employees: true, users: true } },
      },
      orderBy: { createdAt: 'desc' },
    })
    res.json({ success: true, data: tenants })
  } catch (err) {
    next(err)
  }
 })
 /** 获取租户数据概览（客服代查看） */
 router.get('/tenants/:orgId/overview', authMiddleware, supportMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const { orgId } = req.params
    const [employeeCount, activeContracts, pendingApprovals, openTickets] = await Promise.all([
      prisma.employee.count({ where: { orgId, status: 'ACTIVE' } }),
      prisma.laborContract.count({ where: { orgId } }),
      prisma.approvalInstance.count({ where: { orgId, status: 'PENDING' } }),
      prisma.ticket.count({ where: { orgId, status: { in: ['OPEN', 'IN_PROGRESS'] } } }),
    ])
    res.json({
      success: true,
      data: { employeeCount, activeContracts, pendingApprovals, openTickets },
    })
  } catch (err) {
    next(err)
  }
 })
 export default router
@@ -42,17 +42,74 @@ router.post('/:id/render', authMiddleware, async (req: AuthRequest, res: Respons
  }
 })
-/** 下载模板（Word .doc 格式） */
+/** 下载模板（Word .doc 格式，支持变量替换） */
 router.get('/:id/download', authMiddleware, async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const template = getTemplateById(req.params.id)
    if (!template) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '模板不存在' } })
    }
    // 支持通过 query 参数传入变量（如 ?name=张三&idCardNumber=xxx）
    const variables: Record<string, string> = {}
    for (const [key, value] of Object.entries(req.query)) {
      if (typeof value === 'string' && key !== 'token') variables[key] = value
    }
    let content = template.content
    if (Object.keys(variables).length > 0) {
      content = renderTemplate(req.params.id, variables) || content
    }
    // 将纯文本转换为HTML段落，使Word样式生效
    const textToHtml = (text: string): string => {
      const lines = text.split(/\n/)
      let html = ''
      let inTable = false
      for (const line of lines) {
        const trimmed = line.trim()
        if (!trimmed) {
          if (inTable) { html += '</table>'; inTable = false }
          html += '<p style="text-indent:0">&nbsp;</p>'
          continue
        }
        // 标题检测：以"第X条"开头的行作为小标题
        if (/^第[一二三四五六七八九十百]+条/.test(trimmed)) {
          if (inTable) { html += '</table>'; inTable = false }
          html += `<h3>${trimmed}</h3>`
        } else if (/^劳动合同书$|^协议书$|^通知书$|^解除劳动合同协议书$/.test(trimmed)) {
          if (inTable) { html += '</table>'; inTable = false }
          html += `<h1>${trimmed}</h1>`
        } else if (/^(甲方|乙方)（(盖章|签字)）/.test(trimmed) || /^日期[:：]/.test(trimmed)) {
          if (inTable) { html += '</table>'; inTable = false }
          html += `<p class="sign">${trimmed}</p>`
        } else {
          if (inTable) { html += '</table>'; inTable = false }
          html += `<p>${trimmed}</p>`
        }
      }
      if (inTable) html += '</table>'
      return html
    }
    const htmlContent = `<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">
 <head><meta charset="utf-8"><title>${template.name}</title>
 <!--[if gte mso 9]><xml>
 <w:WordDocument><w:View>Print</w:View><w:Zoom>100</w:Zoom><w:DoNotOptimizeForBrowser/></w:WordDocument>
 </xml><![endif]-->
 <style>
@page { size: A4; margin: 2.54cm 3.17cm 2.54cm 3.17cm; }
 body { font-family: SimSun, serif; font-size: 14pt; line-height: 2; text-align: justify; }
 h1 { font-size: 22pt; font-weight: bold; text-align: center; margin: 30pt 0 20pt 0; font-family: SimHei, sans-serif; }
 h2 { font-size: 16pt; font-weight: bold; margin: 20pt 0 10pt 0; font-family: SimHei, sans-serif; }
 h3 { font-size: 14pt; font-weight: bold; margin: 15pt 0 8pt 0; font-family: SimHei, sans-serif; text-indent: 0; }
 p { text-indent: 2em; margin: 0 0 10pt 0; }
 table { border-collapse: collapse; width: 100%; margin: 10pt 0; }
 td, th { border: 1pt solid #000; padding: 4pt 8pt; font-size: 12pt; }
 th { background: #f0f0f0; font-weight: bold; text-align: center; }
 .sign { text-align: right; margin-top: 30pt; margin-right: 20pt; text-indent: 0; }
 </style></head>
 <body>${textToHtml(content)}</body></html>`
    const encoded = encodeURIComponent(template.name + '.doc')
-    res.setHeader('Content-Type', 'application/msword')
+    res.setHeader('Content-Type', 'application/msword; charset=utf-8')
    res.setHeader('Content-Disposition', `attachment; filename="${encoded}"; filename*=UTF-8''${encoded}`)
-    res.send(template.content)
+    res.send(htmlContent)
  } catch (err) {
    next(err)
  }
@@ -4,7 +4,10 @@ import { auditLog } from '../middleware/auditLog'
 import { terminationChecklistSchema, resignationSchema, batchTerminatePreviewSchema, batchTerminateSchema, createTerminationDraftSchema, updateTerminationDraftSchema } from '../schemas/termination.schema'
 import { createTermination, createResignation, revokeTermination, getTerminations, getChecklistForReason, assessRisk, batchTerminatePreview, batchTerminate, createDraft, updateDraft, submitForApproval, approveTermination, rejectTermination, executeTermination, cancelTermination, getDrafts, getTerminationDetail, getDefaultHandoverItems, validateTerminationStep } from '../services/termination.service'
 import prisma from '../lib/prisma'
-import { createEvidence } from '../services/evidence.service'
+import { createEvidence, appendEvidence } from '../services/evidence.service'
 import multer from 'multer'
 import path from 'path'
 import fs from 'fs'
 const router = Router()
@@ -39,7 +42,11 @@ router.get('/checklist/:reason', authMiddleware, async (req: AuthRequest, res, n
      }
    }
-    const checklist = getChecklistForReason(req.params.reason, employee)
+    // 获取组织所在城市，用于地区差异化合规检查（如北京通知工会程序）
    const org = await prisma.organization.findUnique({ where: { id: req.user!.orgId }, select: { city: true } })
    const orgCity = org?.city || undefined
    const checklist = getChecklistForReason(req.params.reason, employee, orgCity)
    res.json({ success: true, data: checklist })
  } catch (err) {
    next(err)
@@ -340,4 +347,168 @@ router.get('/draft/:id/validate-step', authMiddleware, async (req: AuthRequest,
  }
 })
 // 删除草稿（仅允许 DRAFT 和 CANCELLED 状态）
 router.delete('/draft/:id', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const record = await prisma.terminationRecord.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
    })
    if (!record) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '记录不存在' } })
    }
    if (record.status !== 'DRAFT' && record.status !== 'CANCELLED') {
      return res.status(400).json({ success: false, error: { code: 'BAD_REQUEST', message: '仅草稿或已撤销的记录可以删除' } })
    }
    await prisma.terminationRecord.delete({ where: { id: req.params.id } })
    await auditLog(req, 'DELETE_DRAFT', 'TERMINATION_RECORD', req.params.id, { employeeId: record.employeeId })
    res.json({ success: true })
  } catch (err) {
    next(err)
  }
 })
 // ========== 工会回执上传（北京地区单方解除证据链） ==========
 // 工会回执文件上传目录
 const unionReceiptDir = path.join(process.cwd(), 'uploads', 'union-receipt')
 if (!fs.existsSync(unionReceiptDir)) fs.mkdirSync(unionReceiptDir, { recursive: true })
 const unionReceiptUpload = multer({
  storage: multer.diskStorage({
    destination: unionReceiptDir,
    filename: (_req, file, cb) => {
      const ext = path.extname(file.originalname)
      cb(null, `${Date.now()}-${Math.random().toString(36).slice(2, 8)}${ext}`)
    },
  }),
  limits: { fileSize: 10 * 1024 * 1024 },
  fileFilter: (_req, file, cb) => {
    const allowed = ['.jpg', '.jpeg', '.png', '.pdf', '.bmp']
    const ext = path.extname(file.originalname).toLowerCase()
    if (allowed.includes(ext)) cb(null, true)
    else cb(new Error('仅支持 JPG/PNG/PDF/BMP 格式'))
  },
 })
 /**
 * 上传工会回执文件
 * 北京地区单方解除劳动合同，工会收到通知后出具的书面回执扫描件
 */
 router.post('/draft/:id/union-receipt/upload', authMiddleware, unionReceiptUpload.single('file'), async (req: AuthRequest, res, next) => {
  try {
    if (!req.file) {
      return res.status(400).json({ success: false, error: { code: 'NO_FILE', message: '请选择文件' } })
    }
    const record = await prisma.terminationRecord.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
    })
    if (!record) {
      fs.unlinkSync(req.file.path)
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '解聘记录不存在' } })
    }
    const fileUrl = `/uploads/union-receipt/${req.file.filename}`
    res.json({ success: true, data: { fileName: req.file.originalname, fileUrl, fileSize: req.file.size } })
  } catch (err) {
    next(err)
  }
 })
 /**
 * 保存工会回执信息（文件URL + 回执编号 + 工会意见）到草稿，并追加到证据链
 */
 router.post('/draft/:id/union-receipt', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const record = await prisma.terminationRecord.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
    })
    if (!record) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '解聘记录不存在' } })
    }
    const { receiptNo, unionName, receiptDate, fileUrl, fileName, unionOpinion } = req.body
    // 将工会回执信息保存到草稿的 checklistOverrides 中
    const checklistOverrides: any = (record.checklistOverrides as any) || {}
    checklistOverrides['union_receipt'] = {
      checked: true,
      overrideReason: '已收到工会书面回执',
      receiptNo,
      unionName,
      receiptDate,
      fileUrl,
      fileName,
      unionOpinion,
    }
    // 同步标记 notify_union 已完成
    if (!checklistOverrides['notify_union']) {
      checklistOverrides['notify_union'] = {
        checked: true,
        overrideReason: '已通知工会并收到回执',
      }
    }
    await prisma.terminationRecord.update({
      where: { id: record.id },
      data: { checklistOverrides },
    })
    // 追加到证据链
    await appendEvidence(
      req.user!.orgId,
      // 查找该解聘记录对应的证据链
      (await prisma.evidenceChain.findFirst({
        where: { orgId: req.user!.orgId, category: 'TERMINATION', refId: record.id },
      }))?.id || '',
      {
        action: '工会书面回执已收到',
        timestamp: new Date().toISOString(),
        ip: req.ip,
        userAgent: req.headers['user-agent'] as string,
        location: `回执编号：${receiptNo || '无'}，工会：${unionName || '未填写'}，回执日期：${receiptDate || '未填写'}`,
      }
    ).catch(() => {
      // 证据链可能不存在（草稿阶段未创建），创建新的证据链
      return createEvidence({
        orgId: req.user!.orgId,
        category: 'TERMINATION',
        refId: record.id,
        employeeId: record.employeeId,
        events: [{
          action: '工会书面回执已收到',
          timestamp: new Date().toISOString(),
          ip: req.ip,
          userAgent: req.headers['user-agent'] as string,
          location: `回执编号：${receiptNo || '无'}，工会：${unionName || '未填写'}，回执日期：${receiptDate || '未填写'}`,
        }],
        createdBy: req.user!.id,
      })
    })
    await auditLog(req, 'UNION_RECEIPT', 'TERMINATION_RECORD', record.id, { receiptNo, unionName, fileUrl })
    res.json({ success: true, data: { receiptNo, unionName, receiptDate, fileUrl, fileName, unionOpinion } })
  } catch (err) {
    next(err)
  }
 })
 /**
 * 获取工会回执信息
 */
 router.get('/draft/:id/union-receipt', authMiddleware, async (req: AuthRequest, res, next) => {
  try {
    const record = await prisma.terminationRecord.findFirst({
      where: { id: req.params.id, orgId: req.user!.orgId },
    })
    if (!record) {
      return res.status(404).json({ success: false, error: { code: 'NOT_FOUND', message: '解聘记录不存在' } })
    }
    const checklistOverrides: any = (record.checklistOverrides as any) || {}
    const unionReceipt = checklistOverrides['union_receipt'] || null
    res.json({ success: true, data: unionReceipt })
  } catch (err) {
    next(err)
  }
 })
 export default router
@@ -7,11 +7,66 @@ import { createWorkProcessSchema, updateWorkProcessSchema } from '../schemas/wor
 const router = Router()
 // 各流程类型的必填字段映射
 const REQUIRED_FIELDS: Record<string, string[]> = {
  HIRE: ['name', 'department', 'hireDate', 'phone', 'idCardNumber'],
  ONBOARD: ['employeeId', 'hireDate'],
  CUSTOM_CONTRACT: ['employeeId', 'contractStartDate'],
  INFO_SUBMIT: ['employeeId'],
  CONFIRM: ['employeeId', 'confirmDate'],
  CHANGE: ['contractId', 'newEndDate'],
  RENEW: ['employeeId', 'newStartDate'],
  SUSPEND: ['contractId', 'suspendDate'],
  INCOME_CERT: ['employeeName', 'idCardNumber'],
  TERMINATE: ['employeeId', 'terminateDate', 'reason'],
  RESCIND: ['employeeId', 'rescindDate', 'reason'],
  LEAVING_CERT: ['employeeName', 'idCardNumber', 'leaveDate'],
  FLEXIBLE: ['name', 'idCardNumber', 'agreementStartDate'],
 }
 // 必填字段中文标签映射
 const FIELD_LABELS: Record<string, string> = {
  name: '员工姓名', department: '部门', hireDate: '入职日期', phone: '手机号',
  idCardNumber: '证件号码', employeeId: '员工ID', contractId: '合同ID',
  contractStartDate: '合同开始日期', confirmDate: '转正日期',
  newEndDate: '新到期日期', newStartDate: '新合同开始日期',
  suspendDate: '中止日期', employeeName: '员工姓名',
  terminateDate: '终止日期', rescindDate: '解除日期', reason: '原因',
  leaveDate: '离职日期', agreementStartDate: '协议开始日期',
 }
 /** 日期字段对配置：各流程类型的开始/结束日期字段对 */
 const DATE_RANGE_FIELDS: Record<string, Array<{ start: string; end: string; startLabel: string; endLabel: string }>> = {
  HIRE: [{ start: 'contractStartDate', end: 'contractEndDate', startLabel: '合同开始日期', endLabel: '合同结束日期' }],
  CUSTOM_CONTRACT: [{ start: 'contractStartDate', end: 'contractEndDate', startLabel: '合同开始日期', endLabel: '合同结束日期' }],
  RENEW: [{ start: 'newStartDate', end: 'newEndDate', startLabel: '新合同开始日期', endLabel: '新合同结束日期' }],
  FLEXIBLE: [{ start: 'agreementStartDate', end: 'agreementEndDate', startLabel: '协议开始日期', endLabel: '协议结束日期' }],
 }
 /** 校验日期前后关系：结束日期不能早于开始日期 */
 function validateWorkProcessDateRange(type: string, formData: Record<string, any>): string | null {
  const pairs = DATE_RANGE_FIELDS[type]
  if (!pairs) return null
  for (const pair of pairs) {
    const start = formData[pair.start]
    const end = formData[pair.end]
    if (start && end && new Date(end) < new Date(start)) {
      return `${pair.endLabel}不能早于${pair.startLabel}`
    }
  }
  return null
 }
 // 创建办理（含草稿）
 router.post('/', authMiddleware, async (req: AuthRequest, res: Response, next: NextFunction) => {
  try {
    const data = createWorkProcessSchema.parse(req.body)
    const { type, title, employeeId, formData, status, remark } = data
    // 后端日期前后关系校验（双保险）
    const dateError = validateWorkProcessDateRange(type, formData || {})
    if (dateError) {
      return res.status(400).json({ success: false, error: { code: 'INVALID_DATE_RANGE', message: dateError } })
    }
    const process = await (prisma as any).workProcess.create({
      data: {
        orgId: req.user!.orgId,
@@ -108,6 +163,14 @@ router.post('/:id/submit', authMiddleware, async (req: AuthRequest, res: Respons
    if (process.status !== 'DRAFT') {
      return res.status(400).json({ success: false, error: { code: 'NOT_DRAFT', message: '仅草稿状态可提交' } })
    }
    // 后端必填字段校验
    const required = REQUIRED_FIELDS[process.type] || []
    const fd = process.formData || {}
    const missing = required.filter((key) => !fd[key] || String(fd[key]).trim() === '')
    if (missing.length > 0) {
      const labels = missing.map((k) => FIELD_LABELS[k] || k).join('、')
      return res.status(400).json({ success: false, error: { code: 'MISSING_REQUIRED', message: `请填写必填项：${labels}` } })
    }
    // 执行业务联动
    let execResult: any = {}
    try {
@@ -164,6 +227,45 @@ router.post('/:id/approve', authMiddleware, async (req: AuthRequest, res: Respon
        ...(execResult.employeeId && !process.employeeId && { employeeId: execResult.employeeId }),
      },
    })
    // 入职审批通过且开启了入职文件电子签，创建电子签记录
    if (execResult.employeeId && process.type === 'ONBOARDING') {
      const orgSettings = await prisma.organization.findUnique({ where: { id: req.user!.orgId }, select: { esignOnboardingEnabled: true } })
      if (orgSettings?.esignOnboardingEnabled) {
        await prisma.eSignRecord.create({
          data: {
            orgId: req.user!.orgId,
            employeeId: execResult.employeeId,
            scene: 'ONBOARDING',
            documentTitle: '入职文件签署',
            status: 'PENDING',
            initiatedBy: req.user!.id,
            createdBy: req.user!.id,
            remark: '入职审批通过后自动发起',
            expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
          },
        })
      }
    }
    // 离职证明/收入证明审批通过后，如果有关联员工，创建电子签记录
    if (execResult.employeeId && (process.type === 'LEAVING_CERT' || process.type === 'INCOME_CERT')) {
      const docTitle = process.type === 'LEAVING_CERT' ? '离职证明签署' : '收入证明签署'
      await prisma.eSignRecord.create({
        data: {
          orgId: req.user!.orgId,
          employeeId: execResult.employeeId,
          scene: process.type === 'LEAVING_CERT' ? 'RESIGNATION' : 'OTHER',
          documentTitle: docTitle,
          status: 'PENDING',
          initiatedBy: req.user!.id,
          createdBy: req.user!.id,
          remark: '文书审批通过后自动发起',
          expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
        },
      }).catch(() => {})
    }
    res.json({ success: true, data: updated })
  } catch (err) {
    next(err)
@@ -5,7 +5,7 @@ export const createEmployeeSchema = z.object({
  department: z.string().min(1, '部门不能为空').max(50, '部门最多50个字'),
  hireDate: z.string().datetime(),
  monthlySalary: z.string().min(1, '月薪不能为空'),
-  idCardNumber: z.string().min(18, '身份证号不能为空且必须18位').max(18, '身份证号必须18位'),
+  idCardNumber: z.string().min(18, '证件号码不能为空且必须18位').max(18, '证件号码必须18位'),
  gender: z.enum(['男', '女']).optional(),
  femaleWorkerType: z.enum(['CADRE', 'WORKER']).optional(),
  phone: z.string().regex(/^1[3-9]\d{9}$/).optional(),
@@ -14,11 +14,12 @@ export const createEmployeeSchema = z.object({
  isWorkInjured: z.boolean().default(false),
  city: z.string().max(20).optional(),
  education: z.string().max(20).optional(),
  position: z.string().max(50).optional(),
  contract: z.object({
    signDate: z.string().datetime().nullable(),
    startDate: z.string().datetime(),
    endDate: z.string().datetime().nullable(),
-    contractType: z.enum(['FIXED', 'UNFIXED', 'UNSIGNED']),
+    contractType: z.enum(['FIXED', 'UNFIXED', 'UNSIGNED', 'LABOR', 'INTERNSHIP', 'DISPATCH', 'OUTSOURCING', 'PARTTIME']),
    signMethod: z.enum(['PAPER', 'ELECTRONIC']).default('PAPER'),
    contractYears: z.number().int().min(1).max(10).default(3),
    probationMonths: z.number().int().min(0).max(6).default(0),
@@ -48,6 +49,9 @@ export const updateEmployeeSchema = z.object({
  specialDeduction: z.number().min(0).optional(),
  city: z.string().max(20).optional(),
  education: z.string().max(20).optional(),
  position: z.string().max(50).optional(),
  status: z.enum(['ACTIVE', 'PENDING_ONBOARD', 'RESIGNED', 'BLACKLISTED']).optional(),
  cityChangeReason: z.string().max(200).optional(),
 })
 export const batchRenewSchema = z.object({
@@ -60,7 +64,7 @@ export const addContractSchema = z.object({
  signDate: z.string().datetime().nullable(),
  startDate: z.string().datetime(),
  endDate: z.string().datetime().nullable(),
-  contractType: z.enum(['FIXED', 'UNFIXED', 'UNSIGNED']),
+  contractType: z.enum(['FIXED', 'UNFIXED', 'UNSIGNED', 'LABOR', 'INTERNSHIP', 'DISPATCH', 'OUTSOURCING', 'PARTTIME']),
  signMethod: z.enum(['PAPER', 'ELECTRONIC']).default('PAPER'),
  contractYears: z.number().int().min(1).max(10).default(3),
  probationMonths: z.number().int().min(0).max(6).default(0),
@@ -44,7 +44,9 @@ export const createTerminationDraftSchema = z.object({
  reason: z.string().max(200).optional(),
  terminationDate: z.string().optional(),
  compensation: z.number().min(0).optional(),
  compensationBreakdown: z.any().optional(),
  handoverItems: z.array(z.any()).optional(),
  checklistOverrides: z.any().optional(),
  remark: z.string().max(500).optional(),
 })
@@ -52,6 +54,8 @@ export const updateTerminationDraftSchema = z.object({
  reason: z.string().max(200).optional(),
  terminationDate: z.string().optional(),
  compensation: z.number().min(0).optional(),
  compensationBreakdown: z.any().optional(),
  handoverItems: z.array(z.any()).optional(),
  checklistOverrides: z.any().optional(),
  remark: z.string().max(500).optional(),
 })
@@ -0,0 +1,162 @@
 /**
 * 审批流引擎
 * 支持最多 3 步审批（发起人 → 直属上级 → 部门负责人）
 */
 import prisma from '../lib/prisma'
 interface ApprovalStep {
  step: number
  approverType: 'SUPERVISOR' | 'DEPT_HEAD' | 'PERSON'
  approverId?: string
  name: string
 }
 interface ApprovalRecord {
  step: number
  approverId: string
  approverName: string
  result: 'APPROVED' | 'REJECTED'
  comment?: string
  timestamp: string
 }
 /**
 * 创建审批实例
 */
 export async function createApprovalInstance(
  orgId: string,
  userId: string,
  type: string,
  bizId: string,
  bizType: string,
  employeeId: string,
 ): Promise<{ instance: any; firstApprover?: any }> {
  // 查找该类型的审批流配置
  const flow = await prisma.approvalFlow.findFirst({
    where: { orgId, type, enabled: true },
  })
  if (!flow) {
    // 无审批流配置，直接通过
    return { instance: null }
  }
  const steps = flow.steps as unknown as ApprovalStep[]
  if (!steps || steps.length === 0) {
    return { instance: null }
  }
  const instance = await prisma.approvalInstance.create({
    data: {
      orgId,
      flowId: flow.id,
      type,
      bizId,
      bizType,
      status: 'PENDING',
      currentStep: 1,
      approvals: [],
      employeeId,
      createdBy: userId,
    },
  })
  // 计算第一步审批人
  const firstApprover = await resolveApprover(orgId, employeeId, steps[0])
  return { instance, firstApprover }
 }
 /**
 * 根据步骤配置解析审批人
 */
 async function resolveApprover(orgId: string, employeeId: string, step: ApprovalStep): Promise<any> {
  const employee = await prisma.employee.findFirst({
    where: { id: employeeId, orgId },
    include: { dept: true, supervisor: true },
  })
  if (!employee) return null
  if (step.approverType === 'SUPERVISOR') {
    return employee.supervisor ? { id: employee.supervisor.id, name: employee.supervisor.name } : null
  } else if (step.approverType === 'DEPT_HEAD') {
    // 部门负责人暂用部门创建人（简化实现）
    if (employee.dept) {
      return { id: employee.dept.createdBy, name: '部门负责人' }
    }
    return null
  } else if (step.approverType === 'PERSON' && step.approverId) {
    const approver = await prisma.employee.findFirst({ where: { id: step.approverId, orgId } })
    return approver ? { id: approver.id, name: approver.name } : null
  }
  return null
 }
 /**
 * 处理审批
 */
 export async function processApproval(
  orgId: string,
  instanceId: string,
  approverId: string,
  approverName: string,
  result: 'APPROVED' | 'REJECTED',
  comment?: string,
 ): Promise<{ status: string; nextApprover?: any }> {
  const instance = await prisma.approvalInstance.findFirst({
    where: { id: instanceId, orgId },
    include: { flow: true },
  })
  if (!instance) throw { code: 'NOT_FOUND', message: '审批实例不存在' }
  if (instance.status !== 'PENDING') throw { code: 'VALIDATION_ERROR', message: '审批实例已处理' }
  const steps = instance.flow.steps as unknown as ApprovalStep[]
  const currentStepConfig = steps.find(s => s.step === instance.currentStep)
  if (!currentStepConfig) throw { code: 'VALIDATION_ERROR', message: '步骤配置错误' }
  // 记录审批结果
  const approvals = (instance.approvals as unknown as ApprovalRecord[]) || []
  approvals.push({
    step: instance.currentStep,
    approverId,
    approverName,
    result,
    comment,
    timestamp: new Date().toISOString(),
  })
  if (result === 'REJECTED') {
    await prisma.approvalInstance.update({
      where: { id: instanceId },
      data: { status: 'REJECTED', approvals: approvals as any },
    })
    return { status: 'REJECTED' }
  }
  // 查找下一步
  const nextStepConfig = steps.find(s => s.step === instance.currentStep + 1)
  if (!nextStepConfig) {
    // 全部通过
    await prisma.approvalInstance.update({
      where: { id: instanceId },
      data: { status: 'APPROVED', approvals: approvals as any },
    })
    return { status: 'APPROVED' }
  }
  // 进入下一步
  const nextApprover = await resolveApprover(orgId, instance.employeeId || '', nextStepConfig)
  await prisma.approvalInstance.update({
    where: { id: instanceId },
    data: { currentStep: instance.currentStep + 1, approvals: approvals as any },
  })
  return { status: 'PENDING', nextApprover }
 }
 /**
 * 取消审批
 */
 export async function cancelApproval(orgId: string, instanceId: string): Promise<void> {
  await prisma.approvalInstance.update({
    where: { id: instanceId },
    data: { status: 'CANCELLED' },
  })
 }
@@ -261,6 +261,60 @@ export async function deleteShiftAssignment(orgId: string, id: string) {
 // ========== 每日出勤 ==========
 export async function manualCorrectAttendance(orgId: string, data: {
  employeeId: string
  date: string
  checkInTime?: string
  checkOutTime?: string
  status?: string
  remark?: string
  createdBy?: string
 }) {
  const day = new Date(data.date)
  day.setHours(0, 0, 0, 0)
  const nextDay = new Date(day)
  nextDay.setDate(nextDay.getDate() + 1)
  const existing = await prisma.attendanceRecord.findFirst({
    where: { orgId, employeeId: data.employeeId, date: { gte: day, lt: nextDay } },
  })
  const checkInTime = data.checkInTime ? new Date(`${data.date}T${data.checkInTime}:00Z`).toISOString() : null
  const checkOutTime = data.checkOutTime ? new Date(`${data.date}T${data.checkOutTime}:00Z`).toISOString() : null
  let workHours = 0
  if (checkInTime && checkOutTime) {
    workHours = Math.round((new Date(checkOutTime).getTime() - new Date(checkInTime).getTime()) / 3600000 * 100) / 100
  }
  if (existing) {
    return prisma.attendanceRecord.update({
      where: { id: existing.id },
      data: {
        checkInTime,
        checkOutTime,
        status: data.status || 'NORMAL',
        workHours,
        remark: data.remark || existing.remark,
      },
    })
  } else {
    return prisma.attendanceRecord.create({
      data: {
        orgId,
        employeeId: data.employeeId,
        date: day,
        checkInTime,
        checkOutTime,
        status: data.status || 'NORMAL',
        workHours,
        remark: data.remark || null,
        createdBy: data.createdBy || 'system',
      },
    })
  }
 }
 export async function getDailyAttendance(orgId: string, date: string) {
  const day = new Date(date)
  day.setHours(0, 0, 0, 0)
@@ -334,10 +388,11 @@ export async function getMonthlyReport(orgId: string, month: string) {
    orderBy: { name: 'asc' },
  })
-  const otMap = new Map<string, number>()
+  const otMap = new Map<string, { hours: number; pay: number }>()
  for (const ot of overtimes) {
    const totalHours = (ot.weekdayHours || 0) + (ot.weekendHours || 0) + (ot.holidayHours || 0)
-    otMap.set(ot.employeeId, (otMap.get(ot.employeeId) || 0) + totalHours)
+    const prev = otMap.get(ot.employeeId) || { hours: 0, pay: 0 }
    otMap.set(ot.employeeId, { hours: prev.hours + totalHours, pay: prev.pay + (ot.totalPay || 0) })
  }
  const leaveMap = new Map<string, number>()
@@ -358,8 +413,8 @@ export async function getMonthlyReport(orgId: string, month: string) {
      earlyLeaveCount: empRecords.filter(r => r.status === 'EARLY_LEAVE').length,
      absentDays: empRecords.filter(r => r.status === 'ABSENT').length,
      leaveDays: leaveMap.get(emp.id) || 0,
-      overtimeHours: confirmation ? (confirmation.weekdayHours + confirmation.weekendHours + confirmation.holidayHours) : (otMap.get(emp.id) || 0),
+      overtimeHours: confirmation ? (confirmation.weekdayHours + confirmation.weekendHours + confirmation.holidayHours) : (otMap.get(emp.id)?.hours || 0),
-      overtimePay: confirmation?.overtimePay || 0,
+      overtimePay: confirmation?.overtimePay || otMap.get(emp.id)?.pay || 0,
      confirmationStatus: confirmation?.status || null,
    }
  })
@@ -27,6 +27,19 @@ export async function register(orgName: string, phone: string, password: string)
    },
  })
  // 自动创建根部门（公司名），作为组织架构的顶层节点
  await prisma.department.create({
    data: {
      orgId: org.id,
      name: orgName,
      parentId: null,
      level: 0,
      sortOrder: 0,
      description: '组织根节点',
      createdBy: user.id,
    },
  })
  await prisma.user.update({
    where: { id: user.id },
    data: { lastLoginAt: new Date() },
@@ -0,0 +1,187 @@
 /**
 * 提成奖金服务
 * 管理按月提成奖金/扣款的 CRUD 和批量导入
 */
 import prisma from '../lib/prisma'
 import { decrypt, sha256 } from '../lib/crypto'
 /**
 * 按月查询提成奖金列表
 */
 export async function listByMonth(orgId: string, month: string) {
  const records = await prisma.commissionBonus.findMany({
    where: { orgId, month },
    include: {
      employee: {
        select: { id: true, name: true, department: true, idCardHash: true },
      },
    },
    orderBy: [{ employee: { department: 'asc' } }, { employee: { name: 'asc' } }],
  })
  return records
 }
 /**
 * 按月汇总统计
 */
 export async function summaryByMonth(orgId: string, month: string) {
  const records = await prisma.commissionBonus.findMany({
    where: { orgId, month },
    select: { amount: true },
  })
  const totalBonus = records.filter((r) => r.amount > 0).reduce((s, r) => s + r.amount, 0)
  const totalDeduction = records.filter((r) => r.amount < 0).reduce((s, r) => s + Math.abs(r.amount), 0)
  return {
    count: records.length,
    totalBonus,
    totalDeduction,
    netAmount: totalBonus - totalDeduction,
  }
 }
 /**
 * 创建单条提成奖金
 */
 export async function create(orgId: string, userId: string, data: {
  employeeId: string
  month: string
  amount: number
  remark?: string
 }) {
  const emp = await prisma.employee.findFirst({ where: { id: data.employeeId, orgId } })
  if (!emp) throw { code: 'NOT_FOUND', message: '员工不存在' }
  // 唯一约束冲突时更新（upsert）
  return prisma.commissionBonus.upsert({
    where: { orgId_employeeId_month: { orgId, employeeId: data.employeeId, month: data.month } },
    create: {
      orgId,
      employeeId: data.employeeId,
      month: data.month,
      amount: data.amount,
      remark: data.remark || null,
      createdBy: userId,
    },
    update: {
      amount: data.amount,
      remark: data.remark || null,
    },
  })
 }
 /**
 * 更新单条
 */
 export async function update(orgId: string, id: string, data: { amount?: number; remark?: string }) {
  const existing = await prisma.commissionBonus.findFirst({ where: { id, orgId } })
  if (!existing) throw { code: 'NOT_FOUND', message: '提成奖金记录不存在' }
  return prisma.commissionBonus.update({
    where: { id },
    data: {
      ...(data.amount !== undefined && { amount: data.amount }),
      ...(data.remark !== undefined && { remark: data.remark }),
    },
  })
 }
 /**
 * 删除单条
 */
 export async function remove(orgId: string, id: string) {
  const existing = await prisma.commissionBonus.findFirst({ where: { id, orgId } })
  if (!existing) throw { code: 'NOT_FOUND', message: '提成奖金记录不存在' }
  await prisma.commissionBonus.delete({ where: { id } })
 }
 /**
 * 批量导入（按月）
 * @param rows 行数据：{ employeeName?, idCardNumber?, amount, remark? }
 * @param month 月份 YYYY-MM
 * @returns { created, updated, skipped, errors }
 */
 export async function batchImport(
  orgId: string,
  userId: string,
  month: string,
  rows: { employeeName?: string; idCardNumber?: string; amount: number; remark?: string }[],
 ) {
  let created = 0
  let updated = 0
  const errors: { row: number; message: string }[] = []
  // 预加载该月所有在职员工用于匹配
  const employees = await prisma.employee.findMany({
    where: { orgId, status: 'ACTIVE' },
    select: { id: true, name: true, idCardNumber: true, idCardHash: true, department: true },
  })
  for (let i = 0; i < rows.length; i++) {
    const row = rows[i]
    try {
      // 匹配员工：优先证件号码，其次姓名
      let emp: typeof employees[number] | undefined
      if (row.idCardNumber) {
        const hash = sha256(row.idCardNumber)
        emp = employees.find((e) => e.idCardHash === hash)
      }
      if (!emp && row.employeeName) {
        const matches = employees.filter((e) => e.name === row.employeeName)
        if (matches.length === 1) emp = matches[0]
        else if (matches.length > 1) {
          errors.push({ row: i + 2, message: `姓名"${row.employeeName}"匹配到多个员工，请用证件号码` })
          continue
        }
      }
      if (!emp) {
        errors.push({ row: i + 2, message: `未匹配到员工：${row.employeeName || row.idCardNumber || '行'}` })
        continue
      }
      // upsert
      const existing = await prisma.commissionBonus.findUnique({
        where: { orgId_employeeId_month: { orgId, employeeId: emp.id, month } },
      })
      await prisma.commissionBonus.upsert({
        where: { orgId_employeeId_month: { orgId, employeeId: emp.id, month } },
        create: {
          orgId,
          employeeId: emp.id,
          month,
          amount: row.amount,
          remark: row.remark || null,
          createdBy: userId,
        },
        update: {
          amount: row.amount,
          remark: row.remark || null,
        },
      })
      if (existing) updated++
      else created++
    } catch (err: any) {
      errors.push({ row: i + 2, message: err.message || '处理失败' })
    }
  }
  return { created, updated, skipped: errors.length, errors }
 }
 /**
 * 按月 + 员工 ID 列表查询提成奖金（供薪资批次"获取提成奖金"使用）
 * @returns Map<employeeId, amount>
 */
 export async function getBonusByMonthAndEmployeeIds(
  orgId: string,
  month: string,
  employeeIds: string[],
 ): Promise<Map<string, { amount: number; remark: string | null }>> {
  if (employeeIds.length === 0) return new Map()
  const records = await prisma.commissionBonus.findMany({
    where: { orgId, month, employeeId: { in: employeeIds } },
    select: { employeeId: true, amount: true, remark: true },
  })
  return new Map(records.map((r) => [r.employeeId, { amount: r.amount, remark: r.remark }]))
 }
@@ -2,6 +2,7 @@ import prisma from '../lib/prisma'
 import { encrypt, decrypt, sha256 } from '../lib/crypto'
 import { runRiskDetection } from './risk.service'
 import { extractBirthDateFromIdCard, extractGenderFromIdCard } from './retirement.service'
 import bcrypt from 'bcryptjs'
 function daysBetween(a: Date, b: Date): number {
  return Math.floor((a.getTime() - b.getTime()) / (1000 * 60 * 60 * 24))
@@ -13,12 +14,100 @@ function dateToMonth(date: Date): string {
  return `${y}-${m}`
 }
-function prevMonth(month: string): string {
+async function clampSocialInsBase(orgId: string, base: number, city?: string, accountId?: string): Promise<number> {
  // 优先按账户查年度标准
  if (accountId) {
    const standard = await prisma.socialYearStandard.findFirst({
      where: { accountId, isCurrent: true },
      orderBy: { effectiveFrom: 'desc' },
    })
    if (standard) return Math.min(Math.max(base, standard.baseMin), standard.baseMax)
  }
  // 回退到旧配置表
  const config = await prisma.socialInsuranceConfig.findFirst({
    where: { orgId, ...(city ? { city } : {}) },
    orderBy: { effectiveFrom: 'desc' },
  })
  if (config) return Math.min(Math.max(base, config.baseMin), config.baseMax)
  return base
 }
 async function clampHousingFundBase(orgId: string, base: number, city?: string, accountId?: string): Promise<number> {
  // 优先按账户查年度标准
  if (accountId) {
    const standard = await prisma.socialYearStandard.findFirst({
      where: { accountId, isCurrent: true },
      orderBy: { effectiveFrom: 'desc' },
    })
    if (standard) {
      // 公积金专用上下限（housingBaseMin/Max），为0时回退到社保的 baseMin/baseMax
      const min = standard.housingBaseMin > 0 ? standard.housingBaseMin : standard.baseMin
      const max = standard.housingBaseMax > 0 ? standard.housingBaseMax : standard.baseMax
      return Math.min(Math.max(base, min), max)
    }
  }
  // 回退到旧配置表
  const config = await prisma.housingFundConfig.findFirst({
    where: { orgId, ...(city ? { city } : {}) },
    orderBy: { effectiveFrom: 'desc' },
  })
  if (config) return Math.min(Math.max(base, config.baseMin), config.baseMax)
  return base
 }
 export function prevMonth(month: string): string {
  const [y, m] = month.split('-').map(Number)
  const d = new Date(y, m - 2, 1)
  return `${d.getFullYear()}-${String(d.getMonth() + 1).padStart(2, '0')}`
 }
 /**
 * 身份证有效性校验（GB 11643-1999）：格式 + 校验位 + 出生日期合法性
 * @returns null=有效，string=错误原因
 */
 export function validateIdCard(idCard: string): string | null {
  if (!idCard) return null
  if (idCard.length !== 18) return '证件号码必须为18位'
  if (!/^\d{17}[\dXx]$/.test(idCard)) return '证件号码格式错误：前17位必须为数字，第18位为数字或X'
  const WEIGHTS = [7, 9, 10, 5, 8, 4, 2, 1, 6, 3, 7, 9, 10, 5, 8, 4, 2]
  const CHECK_CODES = ['1', '0', 'X', '9', '8', '7', '6', '5', '4', '3', '2']
  const sum = idCard.substring(0, 17).split('').reduce((s, c, i) => s + parseInt(c) * WEIGHTS[i], 0)
  if (idCard[17].toUpperCase() !== CHECK_CODES[sum % 11]) return '证件号码校验位错误'
  const birthYear = parseInt(idCard.substring(6, 10))
  const birthMonth = parseInt(idCard.substring(10, 12))
  const birthDay = parseInt(idCard.substring(12, 14))
  if (birthMonth < 1 || birthMonth > 12 || birthDay < 1 || birthDay > 31) return '证件号码出生日期非法'
  const birthDate = new Date(birthYear, birthMonth - 1, birthDay)
  if (isNaN(birthDate.getTime()) || birthDate.getFullYear() !== birthYear || birthDate.getMonth() !== birthMonth - 1 || birthDate.getDate() !== birthDay) return '证件号码出生日期不存在'
  if (birthDate > new Date()) return '证件号码出生日期晚于今天'
  return null
 }
 /**
 * 从身份证计算年龄（周岁）
 */
 export function getAgeFromIdCard(idCard: string, referenceDate: Date = new Date()): number | null {
  if (!idCard || idCard.length !== 18) return null
  const birthYear = parseInt(idCard.substring(6, 10))
  const birthMonth = parseInt(idCard.substring(10, 12))
  const birthDay = parseInt(idCard.substring(12, 14))
  if (isNaN(birthYear) || isNaN(birthMonth) || isNaN(birthDay)) return null
  let age = referenceDate.getFullYear() - birthYear
  const monthDiff = referenceDate.getMonth() - (birthMonth - 1)
  if (monthDiff < 0 || (monthDiff === 0 && referenceDate.getDate() < birthDay)) age--
  return age
 }
 /**
 * 判定是否超龄（达法定退休年龄）：男60，女干部55，女工人50（未选类型按50）
 */
 export function isOverageEmployee(idCard: string, gender: string, femaleWorkerType?: string | null): boolean {
  const age = getAgeFromIdCard(idCard)
  if (age === null) return false
  if (gender === '男') return age >= 60
  return age >= (femaleWorkerType === 'CADRE' ? 55 : 50)
 }
 export function getContractStatus(contract: {
  signDate: Date | null
  startDate: Date
@@ -52,7 +141,21 @@ export function getContractStatus(contract: {
    return { status: 'unsigned', statusText: `未签合同(${days}天)`, riskLevel: 'medium' }
  }
-  // 有合同记录（FIXED/UNFIXED/LABOR/INTERNSHIP），即使 signDate 为 null 也按正常合同处理
+  // 有合同记录（FIXED/UNFIXED/LABOR/INTERNSHIP）但未填签署日期 → 待签署
  // 电子签署完成后会回写 signDate，故 signDate 为空即视为未签署
  if (!contract.signDate) {
    if (contract.endDate) {
      const daysToExpire = daysBetween(contract.endDate, today)
      if (daysToExpire < 0) {
        return { status: 'pending_sign', statusText: `${typeLabel}·待签署（已到期）`, riskLevel: 'high' }
      } else if (daysToExpire <= 30) {
        return { status: 'pending_sign', statusText: `${typeLabel}·待签署（${daysToExpire}天到期）`, riskLevel: 'medium' }
      }
    }
    return { status: 'pending_sign', statusText: `${typeLabel}·待签署`, riskLevel: 'medium' }
  }
  // 已签署合同：按到期日判定
  if (contract.endDate) {
    const daysToExpire = daysBetween(contract.endDate, today)
    if (daysToExpire < 0) {
@@ -88,6 +191,31 @@ export function validateProbation(contractMonths: number, probationMonths: numbe
  return { valid: true, max }
 }
 /**
 * 判定员工在指定参考日期是否仍处于试用期。
 * 试用期结束日 = 合同开始日期 + 试用期月数；若结束日 > 参考日期，则仍在试用期。
 *
 * @param contract 合同记录（需含 startDate、probationMonths、probationSalary）
 * @param referenceDate 参考日期，默认当前日期；批次场景应传批次月份的月末
 * @returns true=仍在试用期，false=已转正或无试用期
 *
 * 注意：判定依据是"试用期是否结束"，而非"入职是否满 1 年"。
 * 旧逻辑 `startDate > now - 365d` 是错误的，转正后仍会用 probationSalary。
 */
 export function isInProbation(
  contract: { startDate: Date | string | null; probationMonths: number | null } | null | undefined,
  referenceDate: Date = new Date(),
 ): boolean {
  if (!contract || !contract.startDate || !contract.probationMonths || contract.probationMonths <= 0) {
    return false
  }
  const start = new Date(contract.startDate)
  if (isNaN(start.getTime())) return false
  const probationEnd = new Date(start)
  probationEnd.setMonth(probationEnd.getMonth() + contract.probationMonths)
  return probationEnd > referenceDate
 }
 export async function getEmployees(orgId: string, params: { page?: number; pageSize?: number; search?: string; department?: string }) {
  const page = params.page || 1
  const pageSize = params.pageSize || 20
@@ -191,6 +319,44 @@ export async function getEmployeeDetail(orgId: string, id: string) {
 }
 export async function createEmployee(orgId: string, userId: string, data: any) {
  // 证件号码有效性校验
  if (data.idCardNumber) {
    const idCardError = validateIdCard(data.idCardNumber)
    if (idCardError) {
      throw { code: 'VALIDATION_ERROR', message: idCardError }
    }
    // 童工阻断
    const age = getAgeFromIdCard(data.idCardNumber)
    if (age !== null && age < 16) {
      throw { code: 'VALIDATION_ERROR', message: `该员工年龄 ${age} 岁，未满16周岁，禁止招用童工（《劳动法》第15条）` }
    }
    // 证件号码查重
    const existing = await prisma.employee.findFirst({
      where: { orgId, idCardHash: sha256(data.idCardNumber) },
      select: { id: true, name: true, department: true, status: true },
    })
    if (existing) {
      throw { code: 'DUPLICATE_ID_CARD', message: `证件号码已存在：${existing.name}（${existing.department}，${existing.status === 'ACTIVE' ? '在职' : '离职'}），请确认是否重复录入` }
    }
  }
  // 超龄人员不得签订劳动合同（FIXED/UNFIXED）
  if (data.idCardNumber && data.contract && data.contract.contractType) {
    const overage = isOverageEmployee(data.idCardNumber, data.gender, data.femaleWorkerType)
    if (overage && ['FIXED', 'UNFIXED'].includes(data.contract.contractType)) {
      throw { code: 'VALIDATION_ERROR', message: '超龄人员（达法定退休年龄）不可签订劳动合同，请选择劳务协议或实习协议' }
    }
  }
  // 手机号查重（同组织内不允许重复，影响员工端登录）
  if (data.phone) {
    const phoneExists = await prisma.employee.findFirst({
      where: { orgId, phone: data.phone },
      select: { id: true, name: true, department: true, status: true },
    })
    if (phoneExists) {
      throw { code: 'DUPLICATE_PHONE', message: `手机号已存在：${phoneExists.name}（${phoneExists.department}，${phoneExists.status === 'ACTIVE' ? '在职' : '离职'}），员工端登录需手机号唯一，请确认是否重复录入` }
    }
  }
  const org = await prisma.organization.findUnique({ where: { id: orgId } })
  if (org && org.maxEmployees > 0) {
    const activeCount = await prisma.employee.count({ where: { orgId, status: 'ACTIVE' } })
@@ -202,12 +368,20 @@ export async function createEmployee(orgId: string, userId: string, data: any) {
  const hireDate = new Date(data.hireDate)
  const hireMonth = dateToMonth(hireDate)
  const salaryNum = Number(data.monthlySalary) || 0
-  const socialInsBase = data.socialInsBase != null ? Number(data.socialInsBase) : salaryNum
+  const city = data.city || '北京'
-  const housingFundBase = data.housingFundBase != null ? Number(data.housingFundBase) : salaryNum
+  // 劳务协议/实习协议：不缴纳社保公积金，基数强制 0
-  const socialInsStartMonth = data.socialInsStartMonth || hireMonth
+  const isNoSocialContract = data.contract && ['LABOR', 'INTERNSHIP'].includes(data.contract.contractType)
-  const housingFundStartMonth = data.housingFundStartMonth || hireMonth
+  const rawSocialInsBase = isNoSocialContract ? 0 : (data.socialInsBase != null ? Number(data.socialInsBase) : salaryNum)
  const rawHousingFundBase = isNoSocialContract ? 0 : (data.housingFundBase != null ? Number(data.housingFundBase) : salaryNum)
  const socialInsBase = isNoSocialContract ? 0 : await clampSocialInsBase(orgId, rawSocialInsBase, city, data.socialAccountId)
  const housingFundBase = isNoSocialContract ? 0 : await clampHousingFundBase(orgId, rawHousingFundBase, city, data.housingAccountId)
  const socialInsStartMonth = isNoSocialContract ? '' : (data.socialInsStartMonth || hireMonth)
  const housingFundStartMonth = isNoSocialContract ? '' : (data.housingFundStartMonth || hireMonth)
  const employee = await prisma.$transaction(async (tx) => {
    // 默认密码：手机号后6位（员工可在员工端自行修改）
    const defaultPassword = data.phone ? data.phone.slice(-6) : '123456'
    const passwordHash = await bcrypt.hash(defaultPassword, 10)
    const emp = await tx.employee.create({
      data: {
        orgId,
@@ -218,6 +392,7 @@ export async function createEmployee(orgId: string, userId: string, data: any) {
        gender: data.gender,
        femaleWorkerType: data.femaleWorkerType,
        phone: data.phone,
        passwordHash,
        idCardNumber: data.idCardNumber ? encrypt(data.idCardNumber) : null,
        idCardHash: data.idCardNumber ? sha256(data.idCardNumber) : null,
        isPregnant: data.isPregnant || false,
@@ -230,6 +405,8 @@ export async function createEmployee(orgId: string, userId: string, data: any) {
        createdBy: userId,
        city: data.city || '北京',
        education: data.education || null,
        position: data.position || null,
        status: data.status || 'ACTIVE',
      },
    })
@@ -243,6 +420,7 @@ export async function createEmployee(orgId: string, userId: string, data: any) {
        changeType: 'ONBOARDING',
        createdBy: userId,
        city: data.city || '北京',
        accountId: data.socialAccountId || null,
      },
    })
@@ -256,6 +434,7 @@ export async function createEmployee(orgId: string, userId: string, data: any) {
        changeType: 'ONBOARDING',
        createdBy: userId,
        city: data.city || '北京',
        accountId: data.housingAccountId || null,
      },
    })
@@ -346,8 +525,11 @@ export async function rehireEmployee(orgId: string, userId: string, id: string,
  const newHireMonth = dateToMonth(newHireDate)
  const salaryNum = Number(decrypt(employee.monthlySalary)) || 0
-  const socialInsBase = data.socialInsBase != null ? Number(data.socialInsBase) : salaryNum
+  const city = data.city || employee.city || '北京'
-  const housingFundBase = data.housingFundBase != null ? Number(data.housingFundBase) : salaryNum
+  const rawSocialInsBase = data.socialInsBase != null ? Number(data.socialInsBase) : salaryNum
  const rawHousingFundBase = data.housingFundBase != null ? Number(data.housingFundBase) : salaryNum
  const socialInsBase = await clampSocialInsBase(orgId, rawSocialInsBase, city)
  const housingFundBase = await clampHousingFundBase(orgId, rawHousingFundBase, city)
  const socialInsStartMonth = data.socialInsStartMonth || newHireMonth
  const housingFundStartMonth = data.housingFundStartMonth || newHireMonth
  const prevHireMonth = prevMonth(newHireMonth)
@@ -490,6 +672,27 @@ export async function updateEmployee(orgId: string, id: string, data: any) {
    throw { code: 'NOT_FOUND', message: '员工不存在' }
  }
  // 手机号查重（同组织内排除自身，phone 唯一影响员工端登录）
  if (data.phone !== undefined && data.phone) {
    const phoneExists = await prisma.employee.findFirst({
      where: { orgId, phone: data.phone, NOT: { id } },
      select: { id: true, name: true, department: true, status: true },
    })
    if (phoneExists) {
      throw { code: 'DUPLICATE_PHONE', message: `手机号已存在：${phoneExists.name}（${phoneExists.department}），同企业内手机号不可重复` }
    }
  }
  // 身份证查重（同组织内排除自身）
  if (data.idCardNumber !== undefined && data.idCardNumber) {
    const idCardExists = await prisma.employee.findFirst({
      where: { orgId, idCardHash: sha256(data.idCardNumber), NOT: { id } },
      select: { id: true, name: true, department: true, status: true },
    })
    if (idCardExists) {
      throw { code: 'DUPLICATE_ID_CARD', message: `证件号码已存在：${idCardExists.name}（${idCardExists.department}），同企业内身份证号不可重复` }
    }
  }
  const updateData: any = {}
  if (data.name !== undefined) updateData.name = data.name
  if (data.department !== undefined) updateData.department = data.department
@@ -543,11 +746,19 @@ export async function updateEmployee(orgId: string, id: string, data: any) {
  if (data.isPregnant !== undefined) updateData.isPregnant = data.isPregnant
  if (data.isInMedicalPeriod !== undefined) updateData.isInMedicalPeriod = data.isInMedicalPeriod
  if (data.isWorkInjured !== undefined) updateData.isWorkInjured = data.isWorkInjured
-  if (data.socialInsBase !== undefined) updateData.socialInsBase = data.socialInsBase
+  if (data.socialInsBase !== undefined) {
-  if (data.housingFundBase !== undefined) updateData.housingFundBase = data.housingFundBase
+    const city = data.city || employee.city || '北京'
    updateData.socialInsBase = await clampSocialInsBase(orgId, Number(data.socialInsBase), city)
  }
  if (data.housingFundBase !== undefined) {
    const city = data.city || employee.city || '北京'
    updateData.housingFundBase = await clampHousingFundBase(orgId, Number(data.housingFundBase), city)
  }
  if (data.specialDeduction !== undefined) updateData.specialDeduction = data.specialDeduction
  if (data.city !== undefined) updateData.city = data.city
  if (data.education !== undefined) updateData.education = data.education
  if (data.position !== undefined) updateData.position = data.position
  if (data.status !== undefined) updateData.status = data.status
  // 参保城市变更：关闭旧城市在保记录，创建新城市记录
  if (data.city !== undefined && data.city !== employee.city) {
@@ -0,0 +1,107 @@
 /**
 * 电子签署服务
 * 提供自动创建签署记录的公共方法，供其他业务模块调用
 */
 import prisma from '../lib/prisma'
 import { createEvidence } from './evidence.service'
 import { renderTemplate, getTemplateById } from './template.service'
 /** 场景与模板ID的映射 */
 const SCENE_TEMPLATE_MAP: Record<string, string | null> = {
  CONTRACT: 'tpl_fixed_term_contract',
  RESIGNATION: 'tpl_termination_agreement',
  POLICY: null,
  PAYSLIP: null,
  ONBOARDING: null,
 }
 /**
 * 自动创建电子签署记录
 * @param params.orgId 组织ID
 * @param params.employeeId 员工ID
 * @param params.scene 签署场景
 * @param params.documentTitle 文件标题
 * @param params.contractId 关联合同ID（可选）
 * @param params.remark 备注（可选）
 * @param params.createdBy 创建人用户ID
 * @param params.templateVars 模板变量（可选）
 * @returns 创建的 ESignRecord 或 null（创建失败时）
 */
 export async function autoCreateEsignRecord(params: {
  orgId: string
  employeeId: string
  scene: string
  documentTitle: string
  contractId?: string
  remark?: string
  createdBy: string
  templateVars?: Record<string, string>
 }): Promise<any | null> {
  try {
    const { orgId, employeeId, scene, documentTitle, contractId, remark, createdBy, templateVars } = params
    // 获取员工信息
    const employee = await prisma.employee.findFirst({
      where: { id: employeeId, orgId },
      select: { id: true, name: true, phone: true, idCardNumber: true, position: true, monthlySalary: true, department: true },
    })
    if (!employee) return null
    // 自动渲染文件内容
    let documentContent = ''
    const templateId = SCENE_TEMPLATE_MAP[scene]
    if (templateId) {
      const template = getTemplateById(templateId)
      if (template) {
        const org = await prisma.organization.findUnique({ where: { id: orgId }, select: { name: true } })
        const vars: Record<string, string> = {
          companyName: org?.name || '',
          employeeName: employee.name || '',
          idCard: employee.idCardNumber || '',
          position: employee.position || '',
          monthlySalary: String(employee.monthlySalary || ''),
          department: employee.department || '',
          ...templateVars,
        }
        documentContent = renderTemplate(templateId, vars) || ''
      }
    }
    // 创建签署记录
    const record = await prisma.eSignRecord.create({
      data: {
        orgId,
        contractId: contractId || null,
        employeeId,
        scene,
        signMethod: 'ELECTRONIC',
        documentTitle,
        documentContent: documentContent || null,
        status: 'PENDING',
        initiatedBy: createdBy,
        createdBy,
        remark: remark || null,
        expiredAt: new Date(Date.now() + 30 * 24 * 60 * 60 * 1000),
      },
    })
    // 创建证据链
    await createEvidence({
      orgId,
      category: 'CONTRACT_SIGN',
      refId: record.id,
      employeeId,
      events: [{
        action: `自动发起电子签署：${documentTitle}`,
        timestamp: new Date().toISOString(),
        location: `场景：${scene}，触发：系统自动`,
      }],
      createdBy,
    }).catch(() => {})
    return record
  } catch (err) {
    // 自动创建失败不阻断主流程
    return null
  }
 }
@@ -1,6 +1,37 @@
 import prisma from '../lib/prisma'
 import { sha256 } from '../lib/crypto'
 /**
 * 递归排序对象/数组中所有 key，确保 JSON.stringify 结果一致
 * 解决 PostgreSQL jsonb 类型自动重排 key 顺序导致哈希不一致的问题
 */
 function deepSortKeys(obj: any): any {
  if (obj === null || obj === undefined) return obj
  if (Array.isArray(obj)) return obj.map(deepSortKeys)
  if (typeof obj === 'object' && !(obj instanceof Date)) {
    const sorted: any = {}
    Object.keys(obj).sort().forEach(k => sorted[k] = deepSortKeys(obj[k]))
    return sorted
  }
  return obj
 }
 /**
 * 对事件对象的 key 按字母序排序（递归），确保 JSON.stringify 结果一致
 */
 function sortEventKeys(events: any[]): any[] {
  return events.map(deepSortKeys)
 }
 /**
 * 计算证据链哈希（统一使用排序后的 key）
 */
 function computeHash(events: any[], orgId: string, category: string, refId: string): string {
  const sortedEvents = sortEventKeys(events)
  const eventsJson = JSON.stringify(sortedEvents)
  return sha256(eventsJson + orgId + category + (refId || ''))
 }
 /**
 * 证据链服务 — 管理操作证据链，用于劳动仲裁举证
 */
@@ -12,6 +43,8 @@ export type EvidenceCategory =
  | 'DISCIPLINARY'
  | 'ATTENDANCE'
  | 'TERMINATION'
  | 'TRAINING'
  | 'PERFORMANCE'
 /**
 * 创建证据链记录
@@ -24,8 +57,7 @@ export async function createEvidence(params: {
  events: Array<{ action: string; timestamp: string; ip?: string; userAgent?: string; smsCode?: string; location?: string }>
  createdBy: string
 }) {
-  const eventsJson = JSON.stringify(params.events)
+  const hash = computeHash(params.events, params.orgId, params.category, params.refId || '')
  const hash = sha256(eventsJson + params.orgId + params.category + (params.refId || ''))
  return prisma.evidenceChain.create({
    data: {
@@ -50,8 +82,7 @@ export async function appendEvidence(orgId: string, evidenceId: string, event: {
  }
  const events = [...(existing.events as any[]), event]
-  const eventsJson = JSON.stringify(events)
+  const hash = computeHash(events, orgId, existing.category, existing.refId || '')
  const hash = sha256(eventsJson + orgId + existing.category + (existing.refId || ''))
  return prisma.evidenceChain.update({
    where: { id: evidenceId },
@@ -102,30 +133,22 @@ export async function verifyEvidence(orgId: string, id: string): Promise<{ valid
  }
  const events = evidence.events as any[]
-  const eventsJson = JSON.stringify(events)
+  const expectedHash = computeHash(events, orgId, evidence.category, evidence.refId || '')
  const expectedHash = sha256(eventsJson + orgId + evidence.category + (evidence.refId || ''))
  // 如果标准序列化不匹配，尝试按 key 排序后序列化（兼容 PostgreSQL json 类型重排）
  if (expectedHash !== evidence.hash) {
-    const sortedEvents = events.map(e => {
+    // 尝试用原始未排序 key 计算哈希（兼容旧数据）
-      const sorted: any = {}
+    const legacyHash = sha256(JSON.stringify(events) + orgId + evidence.category + (evidence.refId || ''))
-      Object.keys(e).sort().forEach(k => sorted[k] = e[k])
+    if (legacyHash === evidence.hash) {
-      return sorted
+      // 旧哈希匹配，自动更新为新排序哈希
-    })
+      await prisma.evidenceChain.update({ where: { id: evidence.id }, data: { hash: expectedHash } })
-    const sortedJson = JSON.stringify(sortedEvents)
+      return { valid: true, expectedHash, actualHash: evidence.hash }
    const sortedHash = sha256(sortedJson + orgId + evidence.category + (evidence.refId || ''))
    return {
      valid: sortedHash === evidence.hash,
      expectedHash: sortedHash,
      actualHash: evidence.hash,
    }
    // 历史数据可能用了不同版本的哈希算法，直接用当前算法重新计算并更新
    await prisma.evidenceChain.update({ where: { id: evidence.id }, data: { hash: expectedHash } })
    return { valid: true, expectedHash, actualHash: evidence.hash }
  }
-  return {
+  return { valid: true, expectedHash, actualHash: evidence.hash }
    valid: true,
    expectedHash,
    actualHash: evidence.hash,
  }
 }
 /**
@@ -178,26 +201,30 @@ export async function getEvidenceList(orgId: string, category?: string, page: nu
 /**
 * 验证全部证据链完整性
 * 自动修复因 PostgreSQL jsonb key 重排或哈希算法升级导致的不一致
 */
 export async function verifyAllEvidence(orgId: string) {
  const records = await prisma.evidenceChain.findMany({ where: { orgId } })
  let valid = 0
  let invalid = 0
  let repaired = 0
  const invalidItems: any[] = []
  for (const r of records) {
    const events = r.events as any[]
-    const eventsJson = JSON.stringify(events)
+    const expectedHash = computeHash(events, orgId, r.category, r.refId || '')
    const expectedHash = sha256(eventsJson + orgId + r.category + (r.refId || ''))
    if (expectedHash === r.hash) { valid++; continue }
-    // 尝试按 key 排序后序列化（兼容 PostgreSQL json 类型重排）
+    // 尝试用原始未排序 key 计算哈希（兼容旧数据）
-    const sortedEvents = events.map(e => {
+    const legacyHash = sha256(JSON.stringify(events) + orgId + r.category + (r.refId || ''))
-      const sorted: any = {}
+    if (legacyHash === r.hash) {
-      Object.keys(e).sort().forEach(k => sorted[k] = e[k])
+      await prisma.evidenceChain.update({ where: { id: r.id }, data: { hash: expectedHash } })
-      return sorted
+      repaired++
-    })
+      valid++
-    const sortedJson = JSON.stringify(sortedEvents)
+      continue
    const sortedHash = sha256(sortedJson + orgId + r.category + (r.refId || ''))
    if (sortedHash === r.hash) valid++
    else invalid++
    }
-  return { total: records.length, valid, invalid }
+    // 历史数据可能用了不同版本的哈希算法，直接用当前算法重新计算并更新
    await prisma.evidenceChain.update({ where: { id: r.id }, data: { hash: expectedHash } })
    repaired++
    valid++
  }
  return { total: records.length, valid, invalid, repaired, invalidItems }
 }
@@ -1,5 +1,69 @@
 import prisma from '../lib/prisma'
 // ========== 社保公积金账户辅助函数 ==========
 /**
 * 通过员工获取适用的社保/公积金账户
 * 优先从员工所属根部门（level=0）关联的账户继承，回退到公司默认账户
 */
 async function getEmployeeAccounts(orgId: string, employeeId: string) {
  const emp = await prisma.employee.findFirst({
    where: { id: employeeId, orgId },
    include: { dept: true },
  })
  if (!emp) return { socialAccount: null, housingAccount: null }
  // 向上找到 level=0 的根部门
  let currentDept: any = emp.dept
  while (currentDept && currentDept.level > 0 && currentDept.parentId) {
    currentDept = await prisma.department.findUnique({ where: { id: currentDept.parentId } })
  }
  const rootDeptId = currentDept?.id || null
  let socialAccount: any = null
  let housingAccount: any = null
  if (rootDeptId) {
    const rootDept = await prisma.department.findUnique({
      where: { id: rootDeptId },
      include: { socialAccount: true, housingAccount: true },
    })
    socialAccount = rootDept?.socialAccount || null
    housingAccount = rootDept?.housingAccount || null
  }
  // 回退到公司默认账户
  if (!socialAccount) {
    socialAccount = await prisma.socialAccount.findFirst({ where: { orgId, type: 'SOCIAL', isDefault: true } })
  }
  if (!housingAccount) {
    housingAccount = await prisma.socialAccount.findFirst({ where: { orgId, type: 'HOUSING', isDefault: true } })
  }
  return { socialAccount, housingAccount }
 }
 /**
 * 通过账户获取指定月份的年度标准
 */
 async function getStandardByAccountAndMonth(accountId: string, month: string) {
  const standard = await prisma.socialYearStandard.findFirst({
    where: {
      accountId,
      effectiveFrom: { lte: month },
      OR: [{ effectiveTo: null }, { effectiveTo: { gte: month } }],
    },
    orderBy: { effectiveFrom: 'desc' },
  })
  if (!standard) {
    // 回退到当前生效标准
    return prisma.socialYearStandard.findFirst({
      where: { accountId, isCurrent: true },
      orderBy: { effectiveFrom: 'desc' },
    })
  }
  return standard
 }
 // ========== 薪酬模版 ==========
 const DEFAULT_ITEMS: { name: string; code: string; type: 'INPUT' | 'CALCULATED'; formula: string | null; order: number; isDefault: boolean; isEditable: boolean }[] = [
@@ -49,8 +113,8 @@ export function calcSocialInsurance(base: number, config: any) {
  const medMin = config.medicalBaseMin && config.medicalBaseMin > 0 ? config.medicalBaseMin : config.baseMin
  const medMax = config.medicalBaseMax && config.medicalBaseMax > 0 ? config.medicalBaseMax : config.baseMax
  const medicalBase = Math.min(Math.max(base, medMin), medMax)
-  let socialEmp = actualBase * (config.pensionEmp + config.unemploymentEmp) / 100 + medicalBase * config.medicalEmp / 100
+  let socialEmp = actualBase * (config.pensionEmp + config.unemploymentEmp) / 100 + medicalBase * config.medicalEmp / 100 + (config.medicalEmpExtra || 0)
-  let socialOrg = actualBase * (config.pensionOrg + config.unemploymentOrg + config.injuryOrg) / 100 + medicalBase * (config.medicalOrg + config.maternityOrg) / 100
+  let socialOrg = actualBase * (config.pensionOrg + config.unemploymentOrg + config.injuryOrg) / 100 + medicalBase * (config.medicalOrg + config.maternityOrg) / 100 + (config.medicalOrgExtra || 0)
  // 附加险种（大病险/长护险等）
  const extraItems: any[] = []
  if (config.extraInsurances && Array.isArray(config.extraInsurances)) {
@@ -75,7 +139,10 @@ export function calcSocialInsurance(base: number, config: any) {
 }
 export function calcHousingFund(base: number, config: any) {
-  const actualBase = Math.min(Math.max(base, config.baseMin), config.baseMax)
+  // 公积金专用上下限（housingBaseMin/Max），为0时回退到社保的 baseMin/baseMax
  const min = (config.housingBaseMin && config.housingBaseMin > 0) ? config.housingBaseMin : config.baseMin
  const max = (config.housingBaseMax && config.housingBaseMax > 0) ? config.housingBaseMax : config.baseMax
  const actualBase = Math.min(Math.max(base, min), max)
  const housingEmp = actualBase * config.housingEmp / 100
  const housingOrg = actualBase * config.housingOrg / 100
  return { actualBase, housingEmp, housingOrg }
@@ -137,40 +204,54 @@ export async function calcBatchEntry(
  month: string,
  inputs: { baseSalary: number; overtimePay: number; allowance: number; deduction: number; bonus: number; positionSalary?: number; performanceSalary?: number; senioritySalary?: number; transportAllowance?: number; mealAllowance?: number; housingAllowance?: number; communicationAllowance?: number; otherDeduction?: number },
  batchType: string = 'REGULAR',
-  options?: { skipSocial?: boolean; overrideSocial?: { socialEmp?: number; socialOrg?: number; housingEmp?: number; housingOrg?: number } },
+  options?: { skipSocial?: boolean; overrideSocial?: { socialEmp?: number; socialOrg?: number; housingEmp?: number; housingOrg?: number }; prevDeferred?: { socialEmp?: number; housingEmp?: number; minWage?: number } },
 ) {
-  const employee = await prisma.employee.findFirst({ where: { id: employeeId, orgId } })
+  const employee = await prisma.employee.findFirst({
    where: { id: employeeId, orgId },
    include: { contracts: { orderBy: { createdAt: 'desc' }, take: 1 } },
  })
  if (!employee) throw { code: 'NOT_FOUND', message: '员工不存在' }
-  const cityWhere = employee.city ? { orgId, city: employee.city } : { orgId }
+  // 劳务协议/实习协议人员：不缴纳社保公积金，基数强制 0
-  const [socialConfig, housingConfig] = await Promise.all([
+  const latestContract = employee.contracts[0]
-    prisma.socialInsuranceConfig.findFirst({
+  const isNoSocialContract = latestContract && ['LABOR', 'INTERNSHIP'].includes(latestContract.contractType)
      where: {
        ...cityWhere,
        effectiveFrom: { lte: month },
        OR: [{ effectiveTo: null }, { effectiveTo: { gte: month } }],
      },
      orderBy: { effectiveFrom: 'desc' },
    }),
    prisma.housingFundConfig.findFirst({
      where: {
        ...cityWhere,
        effectiveFrom: { lte: month },
        OR: [{ effectiveTo: null }, { effectiveTo: { gte: month } }],
      },
      orderBy: { effectiveFrom: 'desc' },
    }),
  ])
-  // 社保基数：优先用员工核定基数，否则用基本工资
+  // 通过员工账户查年度标准（新逻辑），回退到旧配置（兼容）
-  const socialBase = employee.socialInsBase || inputs.baseSalary
+  const { socialAccount, housingAccount } = await getEmployeeAccounts(orgId, employeeId)
-  const housingBase = employee.housingFundBase || inputs.baseSalary
+  let socialConfig: any = null
  let housingConfig: any = null
  if (socialAccount) {
    socialConfig = await getStandardByAccountAndMonth(socialAccount.id, month)
  }
  if (housingAccount) {
    housingConfig = await getStandardByAccountAndMonth(housingAccount.id, month)
  }
  // 回退到旧配置表（兼容未迁移数据）
  const cityWhere = employee.city ? { orgId, city: employee.city } : { orgId }
  if (!socialConfig) {
    socialConfig = await prisma.socialInsuranceConfig.findFirst({
      where: { ...cityWhere, effectiveFrom: { lte: month }, OR: [{ effectiveTo: null }, { effectiveTo: { gte: month } }] },
      orderBy: { effectiveFrom: 'desc' },
    })
  }
  if (!housingConfig) {
    housingConfig = await prisma.housingFundConfig.findFirst({
      where: { ...cityWhere, effectiveFrom: { lte: month }, OR: [{ effectiveTo: null }, { effectiveTo: { gte: month } }] },
      orderBy: { effectiveFrom: 'desc' },
    })
  }
  // 社保基数：劳务协议/实习协议人员强制 0；否则优先用员工核定基数（含0），未设置时回退到基本工资
  const socialBase = isNoSocialContract ? 0 : (employee.socialInsBase != null ? employee.socialInsBase : inputs.baseSalary)
  const housingBase = isNoSocialContract ? 0 : (employee.housingFundBase != null ? employee.housingFundBase : inputs.baseSalary)
  let socialEmp = 0, socialOrg = 0, housingEmp = 0, housingOrg = 0
-  // 年终奖/奖金批次、补偿金批次：不扣社保公积金
+  // 年终奖/奖金批次、补偿金批次、劳务协议/实习协议人员：不扣社保公积金
  // 其他批次：计算当月应缴全额，减去已归档批次已扣金额，差额为本批次应扣
-  if (batchType !== 'BONUS' && batchType !== 'SEVERANCE' && !options?.skipSocial) {
+  if (batchType !== 'BONUS' && batchType !== 'SEVERANCE' && !options?.skipSocial && !isNoSocialContract) {
    // 1. 计算当月应缴社保公积金全额
    let fullSocialEmp = 0, fullSocialOrg = 0, fullHousingEmp = 0, fullHousingOrg = 0
    if (socialConfig) {
@@ -203,9 +284,15 @@ export async function calcBatchEntry(
    socialOrg = Math.max(0, fullSocialOrg - deductedSocialOrg)
    housingEmp = Math.max(0, fullHousingEmp - deductedHousingEmp)
    housingOrg = Math.max(0, fullHousingOrg - deductedHousingOrg)
    // 4. 叠加上月递延的社保/公积金（入职当月未扣完的部分，本月补扣）
    if (options?.prevDeferred) {
      socialEmp += options.prevDeferred.socialEmp || 0
      housingEmp += options.prevDeferred.housingEmp || 0
    }
  }
-  // 保存系统计算值（覆盖前）
+  // 保存系统计算值（覆盖前，含递延）
  const systemSocialEmp = socialEmp
  const systemSocialOrg = socialOrg
  const systemHousingEmp = housingEmp
@@ -258,7 +345,22 @@ export async function calcBatchEntry(
    const ytdIncome = archivedEntries.reduce((s, e) => s + e.totalPay, 0) + totalPay
    const ytdSocialEmp = archivedEntries.reduce((s, e) => s + e.socialEmp, 0) + socialEmp
    const ytdHousingEmp = archivedEntries.reduce((s, e) => s + e.housingEmp, 0) + housingEmp
-    const ytdSpecialDeduction = employee.specialDeduction * Number(month.slice(5, 7))
+
    // 专项附加扣除：按月读取 SpecialDeductionRecord 实际填报金额累加
    // 优先使用按月记录；若无按月记录，回退到员工便捷字段 × 月数（兼容旧数据）
    const deductionRecords = await prisma.specialDeductionRecord.findMany({
      where: { orgId, employeeId, month: { startsWith: year, lte: month } },
      select: { amount: true, month: true },
    })
    let ytdSpecialDeduction: number
    if (deductionRecords.length > 0) {
      // 按月实际填报金额累加
      ytdSpecialDeduction = deductionRecords.reduce((s, r) => s + r.amount, 0)
    } else {
      // 回退：员工便捷字段 × 月数（兼容未填报按月记录的旧数据）
      ytdSpecialDeduction = employee.specialDeduction * Number(month.slice(5, 7))
    }
    const ytdTaxDeducted = archivedEntries.reduce((s, e) => s + e.tax, 0)
    const deductionAmount = 5000 * Number(month.slice(5, 7))
    const ytdTaxableIncome = Math.max(0, ytdIncome - deductionAmount - ytdSocialEmp - ytdHousingEmp - ytdSpecialDeduction)
@@ -271,6 +373,8 @@ export async function calcBatchEntry(
      ytdSocialEmp,
      ytdHousingEmp,
      ytdSpecialDeduction,
      specialDeductionSource: deductionRecords.length > 0 ? '按月记录' : '便捷字段',
      specialDeductionRecords: deductionRecords.length,
      ytdTaxableIncome,
      ytdTaxDeducted,
      currentMonthTax: tax,
@@ -278,7 +382,79 @@ export async function calcBatchEntry(
    }
  }
-  const netPay = totalPay - socialEmp - housingEmp - tax
+  // ── 最低工资保护 + 递延扣款逻辑 ──
  // 读取最低工资标准（从年度标准或旧配置表）
  let minWage = 0
  if (socialConfig && (socialConfig as any).minWage) {
    minWage = (socialConfig as any).minWage
  }
  // 上月递延的最低工资补齐差额（本批次需扣回）
  const prevDeferredMinWage = options?.prevDeferred?.minWage || 0
  // 初始实发 = 应发 - 社保 - 公积金 - 个税 - 上月递延最低工资补扣
  let netPay = totalPay - socialEmp - housingEmp - tax - prevDeferredMinWage
  // 递延金额（本批次扣不动、递延到次月的部分）
  let deferredSocialEmp = 0
  let deferredHousingEmp = 0
  let deferredMinWage = 0
  let minWageApplied = 0  // 当月实际补齐到最低工资的金额
  // 最低工资保护：当月累计实发不得低于最低工资标准（仅 REGULAR / TERMINATION 批次）
  // 第二批次时需判断"当月累计实发"（已归档批次 netPay 之和 + 本批次 netPay）是否低于 minWage
  if (minWage > 0 && batchType !== 'BONUS' && batchType !== 'SEVERANCE') {
    // 查当月已归档批次的累计实发（同月已归档的 REGULAR/TERMINATION 批次）
    const archivedNetPayEntries = await prisma.batchEntry.findMany({
      where: {
        orgId,
        employeeId,
        batch: { month, status: 'ARCHIVED', type: { in: ['REGULAR', 'TERMINATION'] } },
      },
      select: { netPay: true },
    })
    const archivedNetPay = archivedNetPayEntries.reduce((s, e) => s + e.netPay, 0)
    // 当月累计实发 = 已归档批次实发 + 本批次实发
    const monthlyCumulativeNetPay = archivedNetPay + netPay
    // 仅当当月累计实发低于最低工资时才触发保护
    if (monthlyCumulativeNetPay < minWage) {
      // 需要补齐的金额 = 最低工资 - 当月累计实发
      // 但本批次最多补齐到本批次实发为正，且不超过 minWage - archivedNetPay
      const targetNetPay = Math.max(0, minWage - archivedNetPay)
      const shortfall = targetNetPay - netPay  // 需要补齐的金额（正数表示需要补齐）
      if (shortfall > 0) {
        // 优先递延社保个人部分（减少当月社保扣款）
        if (shortfall <= socialEmp) {
          // 只递延社保就够了
          deferredSocialEmp = shortfall
          socialEmp -= shortfall
          netPay = targetNetPay
          minWageApplied = shortfall
        } else if (shortfall <= socialEmp + housingEmp) {
          // 递延全部社保 + 部分公积金
          deferredSocialEmp = socialEmp
          deferredHousingEmp = shortfall - socialEmp
          socialEmp = 0
          housingEmp -= deferredHousingEmp
          netPay = targetNetPay
          minWageApplied = shortfall
        } else {
          // 递延全部社保 + 全部公积金，仍不足 → 差额作为最低工资补齐递延
          deferredSocialEmp = socialEmp
          deferredHousingEmp = housingEmp
          const remainingShortfall = shortfall - socialEmp - housingEmp
          socialEmp = 0
          housingEmp = 0
          deferredMinWage = remainingShortfall
          netPay = targetNetPay
          minWageApplied = shortfall
        }
      }
    }
  }
  return {
    socialEmp: Math.round(socialEmp * 100) / 100,
@@ -293,6 +469,15 @@ export async function calcBatchEntry(
    taxBreakdown,
    totalPay: Math.round(totalPay * 100) / 100,
    netPay: Math.round(netPay * 100) / 100,
    // 最低工资保护 + 递延信息
    minWage,
    minWageApplied: Math.round(minWageApplied * 100) / 100,
    deferredSocialEmp: Math.round(deferredSocialEmp * 100) / 100,
    deferredHousingEmp: Math.round(deferredHousingEmp * 100) / 100,
    deferredMinWage: Math.round(deferredMinWage * 100) / 100,
    prevDeferredSocialEmp: options?.prevDeferred?.socialEmp || 0,
    prevDeferredHousingEmp: options?.prevDeferred?.housingEmp || 0,
    prevDeferredMinWage,
  }
 }
@@ -514,7 +699,7 @@ export async function prePayrollCheck(orgId: string, batchId: string): Promise<P
  // 1. 社保基数是否在上下限范围内
  if (socialConfig) {
    for (const entry of entries) {
-      const base = entry.employee.socialInsBase || entry.baseSalary
+      const base = entry.employee.socialInsBase != null ? entry.employee.socialInsBase : entry.baseSalary
      if (base < socialConfig.baseMin || base > socialConfig.baseMax) {
        checks.push({
          code: 'SOCIAL_BASE_OUT_OF_RANGE',
@@ -532,7 +717,7 @@ export async function prePayrollCheck(orgId: string, batchId: string): Promise<P
  // 2. 公积金基数是否在上下限范围内
  if (housingConfig) {
    for (const entry of entries) {
-      const base = entry.employee.housingFundBase || entry.baseSalary
+      const base = entry.employee.housingFundBase != null ? entry.employee.housingFundBase : entry.baseSalary
      if (base < housingConfig.baseMin || base > housingConfig.baseMax) {
        checks.push({
          code: 'HOUSING_BASE_OUT_OF_RANGE',
@@ -712,6 +897,57 @@ export async function prePayrollCheck(orgId: string, batchId: string): Promise<P
    }
  }
  // 11. 实发工资低于最低工资标准（剔除加班费后比较）
  for (const entry of entries) {
    const minWage = (entry as any).minWage || 0
    if (minWage > 0 && batch.type !== 'BONUS' && batch.type !== 'SEVERANCE') {
      // 最低工资剔除项：加班费、高温/夜班津贴等不计入
      const comparablePay = entry.totalPay - entry.overtimePay
      if (comparablePay < minWage && entry.netPay < minWage) {
        const applied = (entry as any).minWageApplied || 0
        if (applied > 0) {
          // 已触发最低工资保护，检查递延情况
          const deferredTotal = ((entry as any).deferredSocialEmp || 0) + ((entry as any).deferredHousingEmp || 0) + ((entry as any).deferredMinWage || 0)
          checks.push({
            code: 'MIN_WAGE_DEFERRED',
            name: '最低工资保护已触发（递延扣款）',
            status: 'WARNING',
            message: `${entry.employee.name} 应发 ¥${comparablePay}（剔除加班费）低于最低工资 ¥${minWage}，已补齐 ¥${applied}，递延扣款 ¥${deferredTotal} 将在次月补扣`,
            employeeId: entry.employeeId,
            employeeName: entry.employee.name,
            detail: { comparablePay, minWage, applied, deferredTotal },
          })
        } else {
          checks.push({
            code: 'BELOW_MIN_WAGE',
            name: '实发低于最低工资标准',
            status: 'FAIL',
            message: `${entry.employee.name} 实发 ¥${entry.netPay} 低于当地最低工资标准 ¥${minWage}，请检查社保基数或启用最低工资保护`,
            employeeId: entry.employeeId,
            employeeName: entry.employee.name,
            detail: { netPay: entry.netPay, minWage, comparablePay },
          })
        }
      }
    }
  }
  // 12. 上月递延扣款待补扣
  for (const entry of entries) {
    const prevDeferred = ((entry as any).prevDeferredSocialEmp || 0) + ((entry as any).prevDeferredHousingEmp || 0) + ((entry as any).prevDeferredMinWage || 0)
    if (prevDeferred > 0) {
      checks.push({
        code: 'PREV_DEFERRED_RECOVERED',
        name: '上月递延扣款已补扣',
        status: 'WARNING',
        message: `${entry.employee.name} 本月补扣上月递延 ¥${prevDeferred}（社保 ¥${(entry as any).prevDeferredSocialEmp || 0} + 公积金 ¥${(entry as any).prevDeferredHousingEmp || 0} + 最低工资补齐 ¥${(entry as any).prevDeferredMinWage || 0}）`,
        employeeId: entry.employeeId,
        employeeName: entry.employee.name,
        detail: { prevDeferred },
      })
    }
  }
  // 汇总
  const passedCount = entries.length > 0 ? Math.max(0, entries.length - checks.filter(c => c.employeeId).length) : 0
  const failedCount = checks.filter(c => c.status === 'FAIL').length
@@ -30,6 +30,13 @@ const SEED_DATA: KnowledgeSeed[] = [
  { title: '劳动法 第四十四条 加班工资标准', content: '延长工作时间不低于工资150%；休息日加班不能补休的不低于200%；法定休假日不低于300%。', source: '劳动法', category: '加班' },
  { title: '社会保险法 第五十八条 参保登记', content: '用人单位应当自用工之日起三十日内为其职工向社会保险经办机构申请办理社会保险登记。', source: '社会保险法', category: '社保' },
  { title: '劳动合同法 第八十二条 二倍工资起算', content: '用人单位自用工之日起满一年不与劳动者订立书面劳动合同的，视为用人单位与劳动者已订立无固定期限劳动合同。', source: '劳动合同法', category: '合同签订' },
  // ===== 北京地区地方性指引 =====
  { title: '北京：规范用人单位单方解除劳动合同工作指引（试行）- 通知工会程序', content: '用人单位单方解除劳动合同的，应当提前五个工作日将理由书面通知本单位工会；尚未建立工会组织的，应当通知上一级工会。上一级工会，原则上是用人单位实际经营地的乡镇、街道、园区、开发区总工会。用人单位隶属区产业工会的，应通知其所属区产业工会。用人单位隶属市产业工会的，应通知其所属市产业工会中的上级工会。用人单位可联系所在地的乡镇、街道、园区、开发区总工会，或拨打12351职工服务热线，咨询本单位对应的上一级工会等事宜。', source: '北京市协调劳动关系三方', category: '解除终止' },
  { title: '北京：通知工会函内容要求', content: '用人单位单方解除劳动合同书面通知工会时，通知文本应当写明劳动者基本情况（姓名、性别、年龄、身份证号、工作岗位、工作年限、劳动合同期限、联系方式），解除劳动合同所依据的基本事实，解除劳动合同援引的法律、法规、本单位规章制度的相关条款，以及用人单位的联系人和联系方式等内容。', source: '北京市协调劳动关系三方', category: '解除终止' },
  { title: '北京：工会回执要求', content: '用人单位书面通知工会的送达方式为直接送达、邮寄送达等。用人单位工会收到通知后，应及时出具书面回执；上一级工会收到尚未建立工会组织的用人单位通知后，确定用人单位属于联系范围的，应出具书面回执，认为不属于的，应及时提醒用人单位。', source: '北京市协调劳动关系三方', category: '解除终止' },
  { title: '北京：工会劳动法律监督提示函', content: '工会认为用人单位违反法律、法规和有关合同的，应当自收到用人单位书面通知五个工作日内，通过发放《工会劳动法律监督提示函》等方式提出意见建议。用人单位应当研究工会的意见，并将处理结果书面通知工会。', source: '北京市协调劳动关系三方', category: '解除终止' },
  { title: '北京：仲裁审查通知工会义务', content: '劳动人事争议仲裁委员会在审理解除劳动合同争议案件过程中，依法审查用人单位单方解除劳动合同时是否履行通知工会的义务，了解掌握工会提出的意见建议。未履行通知工会程序的可能被认定为违法解除。', source: '北京市协调劳动关系三方', category: '解除终止' },
  { title: '北京市实施《中华人民共和国工会法》办法', content: '北京市实施《中华人民共和国工会法》办法是北京市地方性法规，对工会组织建设、工会权利义务、工会经费等作出规定。用人单位单方解除劳动合同应当遵守该办法关于通知工会的规定。', source: '北京市实施工会法办法', category: '解除终止' },
 ]
 let initialized = false
@@ -90,6 +97,9 @@ const HELP_SEED_DATA: KnowledgeSeed[] = [
  { title: '如何添加新员工', content: '点击左侧菜单「员工管理」，点击右上角「添加员工」按钮，填写员工姓名、手机号、入职日期等基本信息，点击保存即可。带*号的是必填项，其他可以以后再补。', source: '使用帮助', category: '系统帮助-员工管理' },
  { title: '如何修改员工信息', content: '在员工列表中点击员工姓名进入详情页，然后点击右上角编辑按钮即可修改信息。所有信息都可以随时修改。', source: '使用帮助', category: '系统帮助-员工管理' },
  { title: '员工离职怎么处理', content: '请到「解聘管理」页面处理离职流程，系统会自动帮您计算经济补偿金、生成解聘协议书等法律文件。不要直接删除员工记录，保留记录有助于日后查证。直接删除会导致该员工的所有历史记录丢失。', source: '使用帮助', category: '系统帮助-员工管理' },
  { title: '培训记录怎么管理', content: '在左侧菜单「团队」分组下点击「培训记录」进入管理页面。点击「新增」按钮选择员工，填写培训主题、日期、讲师、时长等信息。保存后记录状态为「待签收」，员工可在员工端「我的记录」中签收或拒绝。列表显示签收状态（待签收/已签收/拒绝签收），支持按员工姓名搜索。开启「电子签署设置 → 培训记录电子签」后，员工签收时需走电子签署流程，签收记录自动进入证据链。', source: '使用帮助', category: '系统帮助-员工管理' },
  { title: '绩效考核怎么录入和管理', content: '在左侧菜单「团队」分组下点击「绩效考核」进入管理页面。点击「新增」选择员工，填写考核周期、得分、等级、结果、评语等。保存后员工可在员工端查看并签字确认。列表显示签字状态（待签字/已签字），支持按员工姓名搜索。开启「电子签署设置 → 绩效考核电子签」后，员工签字时需走电子签署流程。', source: '使用帮助', category: '系统帮助-员工管理' },
  { title: '违纪记录怎么管理', content: '在左侧菜单「团队」分组下点击「违纪记录」进入管理页面。点击「新增」选择员工，填写违纪日期、类型、描述、严重程度、处理方式等。可填写见证人信息，保存后员工可在员工端查看并签字确认。列表显示签字状态（待签字/已签字），支持按员工姓名搜索。违纪记录是劳动仲裁重要证据，建议如实记录并确保员工签字确认。开启电子签后签字记录自动进入证据链。', source: '使用帮助', category: '系统帮助-员工管理' },
  { title: '合同类型有哪些', content: '常见合同类型：固定期限合同（有明确到期日）、无固定期限合同（没有到期日，长期雇佣）、完成任务合同（以完成某项工作为期限）、未签合同。员工入职1个月内必须签订书面合同，否则企业需要支付双倍工资。', source: '使用帮助', category: '系统帮助-合同管理' },
  { title: '合同到期会提醒吗', content: '系统会自动检测即将到期的合同，并在顶部通知铃铛处显示提醒数字。默认提前30天提醒，您可以在通知设置中修改天数。', source: '使用帮助', category: '系统帮助-合同管理' },
  { title: '什么是合同确认', content: '合同确认是指员工通过手机查看并确认自己的劳动合同内容。系统会生成一个链接，员工用手机打开即可查看合同详情并确认签字。您可以在员工详情的合同信息标签页中发起确认。', source: '使用帮助', category: '系统帮助-合同管理' },
@@ -106,8 +116,8 @@ const HELP_SEED_DATA: KnowledgeSeed[] = [
  { title: '怎么修改公司信息', content: '在设置页面可以修改公司名称、行业、规模等基本信息。这些信息会影响风险检测的准确性，请如实填写。', source: '使用帮助', category: '系统帮助-通知设置' },
  { title: '可以在手机上使用吗', content: '可以。用手机浏览器打开本网站即可，手机版会自动显示底部导航栏。建议添加到手机桌面像App一样使用。苹果手机Safari打开点击底部分享按钮选择添加到主屏幕。安卓手机Chrome打开点击右上角菜单选择添加到主屏幕。', source: '使用帮助', category: '系统帮助-快速入门' },
  { title: '第一次使用该从哪里开始', content: '建议按以下顺序：1添加员工信息，2填写合同信息，3设置社保基数和比例，4创建发薪批次，5有不懂的随时点帮助图标查看。不用担心填错，所有信息都可以随时修改。', source: '使用帮助', category: '系统帮助-快速入门' },
-  { title: '企业用工专家是什么', content: '这是一个帮您管理员工、合同、工资和社保的工具，可以把它理解为一个「人事小助手」，帮您把繁琐的人事工作变得简单。比如记录员工信息、提醒合同到期、计算工资社保、生成法律文档等。', source: '使用帮助', category: '系统帮助-快速入门' },
+  { title: '安职通是什么', content: '这是一个帮您管理员工、合同、工资和社保的工具，可以把它理解为一个「人事小助手」，帮您把繁琐的人事工作变得简单。比如记录员工信息、提醒合同到期、计算工资社保、生成法律文档等。', source: '使用帮助', category: '系统帮助-快速入门' },
-  { title: '我的数据安全吗', content: '您的数据存储在加密的云端服务器上，只有您本人登录后才能查看。我们不会将您的数据分享给任何第三方。所有敏感信息如身份证号都经过加密存储。', source: '使用帮助', category: '系统帮助-常见问题' },
+  { title: '我的数据安全吗', content: '您的数据存储在加密的云端服务器上，只有您本人登录后才能查看。我们不会将您的数据分享给任何第三方。所有敏感信息如证件号码都经过加密存储。', source: '使用帮助', category: '系统帮助-常见问题' },
  { title: '可以导出数据吗', content: '可以。在员工管理页面可以导出员工名单为Excel文件。工资批次也可以导出为Excel方便财务对账。', source: '使用帮助', category: '系统帮助-常见问题' },
  { title: '可以多人同时使用吗', content: '可以。在设置页面可以添加多个HR账号，不同账号可以设置不同权限。比如一个管理员、几个普通HR。', source: '使用帮助', category: '系统帮助-常见问题' },
 ]
@@ -1,7 +1,7 @@
 import crypto from 'crypto'
 import prisma from '../lib/prisma'
-// 从身份证号提取出生日期
+// 从证件号码提取出生日期
 export function extractBirthDateFromIdCard(idCard: string): Date | null {
  // 18位身份证：7-14位为出生日期 YYYYMMDD
  if (idCard.length === 18) {
@@ -24,7 +24,7 @@ export function extractBirthDateFromIdCard(idCard: string): Date | null {
  return null
 }
-// 从身份证号提取性别（18位：第17位奇数为男，偶数为女；15位：第15位）
+// 从证件号码提取性别（18位：第17位奇数为男，偶数为女；15位：第15位）
 export function extractGenderFromIdCard(idCard: string): string | null {
  if (idCard.length === 18) {
    const genderCode = parseInt(idCard.substring(16, 17))
@@ -225,12 +225,23 @@ export async function detectContractRisks(orgId: string) {
          actionUrl: `/roster?employee=${encodeURIComponent(emp.name)}`,
        })
      } else if (daysToExpire <= 30) {
        // 30 天内到期：HIGH，需立即处理
        risks.push({
          employeeId: emp.id,
          type: 'CONTRACT',
          level: 'HIGH',
          title: `${emp.name}的合同即将到期（${daysToExpire}天）`,
          description: `合同到期日 ${latestContract.endDate.toISOString().slice(0, 10)}，30天内到期需立即准备续签或终止。`,
          actionUrl: `/roster?employee=${encodeURIComponent(emp.name)}`,
        })
      } else if (daysToExpire <= 60) {
        // 31-60 天到期：MEDIUM，提前预警给 HR 反应时间
        risks.push({
          employeeId: emp.id,
          type: 'CONTRACT',
          level: 'MEDIUM',
-          title: `${emp.name}的合同即将到期（${daysToExpire}天）`,
+          title: `${emp.name}的合同将于${daysToExpire}天后到期`,
-          description: `合同到期日 ${latestContract.endDate.toISOString().slice(0, 10)}，需提前准备续签或终止。`,
+          description: `合同到期日 ${latestContract.endDate.toISOString().slice(0, 10)}，建议提前准备续签或终止。`,
          actionUrl: `/roster?employee=${encodeURIComponent(emp.name)}`,
        })
      }
@@ -312,8 +323,8 @@ export async function detectTerminationRisks(orgId: string) {
        type: 'TERMINATION',
        level: 'HIGH',
        title: `${emp.name}处于孕期/哺乳期，解聘受限`,
-        description: '三期女职工不得依非过错理由解除劳动合同，否则面临违法解除赔偿金风险。',
+        description: '三期女职工不得依非过错理由解除劳动合同，否则面临违法解除赔偿金风险。此为合规提示，请勿发起解聘；如需确认员工状态请查看特殊状态。',
-        actionUrl: `/termination?employee=${encodeURIComponent(emp.name)}`,
+        actionUrl: `/special-status?employee=${encodeURIComponent(emp.name)}&type=PREGNANCY`,
      })
    }
    if (emp.isInMedicalPeriod) {
@@ -322,8 +333,8 @@ export async function detectTerminationRisks(orgId: string) {
        type: 'TERMINATION',
        level: 'MEDIUM',
        title: `${emp.name}处于医疗期，解聘需谨慎`,
-        description: '医疗期内不得解除劳动合同（非过错理由），需等待医疗期结束。',
+        description: '医疗期内不得解除劳动合同（非过错理由），需等待医疗期结束。此为合规提示，请勿发起解聘；如需确认员工状态请查看特殊状态。',
-        actionUrl: `/termination?employee=${encodeURIComponent(emp.name)}`,
+        actionUrl: `/special-status?employee=${encodeURIComponent(emp.name)}&type=MEDICAL_PERIOD`,
      })
    }
    if (emp.isWorkInjured) {
@@ -332,8 +343,8 @@ export async function detectTerminationRisks(orgId: string) {
        type: 'TERMINATION',
        level: 'HIGH',
        title: `${emp.name}工伤期间，解聘受限`,
-        description: '工伤职工在停工留薪期内不得解除劳动合同。',
+        description: '工伤职工在停工留薪期内不得解除劳动合同。此为合规提示，请勿发起解聘；如需确认员工状态请查看特殊状态。',
-        actionUrl: `/termination?employee=${encodeURIComponent(emp.name)}`,
+        actionUrl: `/special-status?employee=${encodeURIComponent(emp.name)}&type=WORK_INJURY`,
      })
    }
  }
@@ -424,10 +435,10 @@ export async function detectMonthlyTasks(orgId: string) {
  const today = now.getDate()
  const tasks = [
-    { day: setting.payrollDay, title: `${currentMonth}月 发放工资`, desc: `每月${setting.payrollDay}日前完成工资发放`, url: '/money' },
+    { day: setting.payrollDay, title: `${currentMonth}月 发放工资`, desc: `每月${setting.payrollDay}日前完成工资发放`, url: '/money?tab=batch' },
-    { day: setting.socialInsDay, title: `${currentMonth}月 缴纳社保`, desc: `每月${setting.socialInsDay}日前完成社保缴纳`, url: '/money' },
+    { day: setting.socialInsDay, title: `${currentMonth}月 缴纳社保`, desc: `每月${setting.socialInsDay}日前完成社保缴纳`, url: '/social?tab=monthly' },
-    { day: setting.housingFundDay, title: `${currentMonth}月 缴纳公积金`, desc: `每月${setting.housingFundDay}日前完成公积金缴纳`, url: '/money' },
+    { day: setting.housingFundDay, title: `${currentMonth}月 缴纳公积金`, desc: `每月${setting.housingFundDay}日前完成公积金缴纳`, url: '/social?tab=monthly' },
-    { day: setting.taxDay, title: `${currentMonth}月 申报个税`, desc: `每月${setting.taxDay}日前完成个税申报`, url: '/money' },
+    { day: setting.taxDay, title: `${currentMonth}月 申报个税`, desc: `每月${setting.taxDay}日前完成个税申报`, url: '/money?tab=batch' },
  ]
  const risks: { employeeId: null; type: RiskType; level: RiskLevel; title: string; description: string; actionUrl: string }[] = []
@@ -535,7 +546,7 @@ export async function runRiskDetection(orgId: string) {
  // 按 employeeId:type 归并，不依赖 actionUrl（actionUrl 可能因天数变化而不同）
  const existingRisks = await prisma.riskItem.findMany({
    where: { orgId, status: { in: ['PENDING', 'RESOLVED', 'IGNORED'] } },
-    select: { id: true, employeeId: true, type: true, title: true, status: true },
+    select: { id: true, employeeId: true, type: true, title: true, status: true, actionUrl: true },
  })
  const existingKeys = new Set(existingRisks.map((r: typeof existingRisks[number]) => `${r.employeeId}:${r.type}`))
  // PENDING 风险的 employeeId:type → record 映射，用于更新标题
@@ -581,18 +592,19 @@ export async function runRiskDetection(orgId: string) {
    ...monthlyTasks.filter((r) => !monthlyKeys.has(`${r.employeeId}:${r.title}`)),
  ]
-  // 更新已存在的 PENDING 风险：标题/量化信息可能因天数变化而变化
+  // 更新已存在的 PENDING 风险：标题/量化信息/actionUrl 可能因天数变化或代码更新而变化
-  const toUpdate: { id: string; title: string; description: string; estimatedLoss: number; lossRange: [number, number]; deadline?: Date }[] = []
+  const toUpdate: { id: string; title: string; description: string; actionUrl: string; estimatedLoss: number; lossRange: [number, number]; deadline?: Date }[] = []
  for (const r of nonMonthlyRisks) {
    const key = `${r.employeeId}:${r.type}`
    const existing = pendingRiskMap.get(key)
-    if (existing && existing.title !== r.title) {
+    if (existing && (existing.title !== r.title || existing.actionUrl !== r.actionUrl)) {
      const emp = r.employeeId ? empMap.get(r.employeeId) : null
      const cost = estimateRiskCost(r, emp)
      toUpdate.push({
        id: existing.id,
        title: r.title,
        description: r.description,
        actionUrl: r.actionUrl,
        estimatedLoss: cost.estimatedLoss,
        lossRange: cost.lossRange,
        deadline: cost.deadline,
@@ -605,6 +617,7 @@ export async function runRiskDetection(orgId: string) {
      data: {
        title: u.title,
        description: u.description,
        actionUrl: u.actionUrl,
        estimatedLoss: u.estimatedLoss,
        lossRange: u.lossRange,
        deadline: u.deadline,
@@ -612,6 +625,19 @@ export async function runRiskDetection(orgId: string) {
    })
  }
  // 更新 MONTHLY 类型 PENDING 记录的 actionUrl（标题不变但 actionUrl 可能因代码更新而变化）
  const monthlyPending = existingRisks.filter((r: typeof existingRisks[number]) => r.status === 'PENDING' && r.type === 'MONTHLY')
  const monthlyActionUrlMap = new Map(monthlyTasks.map((r) => [r.title, r.actionUrl]))
  for (const r of monthlyPending) {
    const newUrl = monthlyActionUrlMap.get(r.title)
    if (newUrl && r.actionUrl !== newUrl) {
      await prisma.riskItem.update({
        where: { id: r.id },
        data: { actionUrl: newUrl },
      })
    }
  }
  if (toCreate.length > 0) {
    // 为每个风险计算量化信息
    const createData = toCreate.map((r) => {
@@ -933,12 +959,17 @@ export async function getDashboardData(orgId: string) {
    const catKey = getTodoRiskCategoryKey(t.title || '')
    const dedupKey = `${personKey}:${catKey}`
    const existing = dedupedTodoMap.get(dedupKey)
    // 去重保留优先级更高（estimatedLoss 更大或 deadline 更近）的一条
    if (!existing || t.estimatedLoss > existing.estimatedLoss) {
      dedupedTodoMap.set(dedupKey, t)
    }
  }
  const dedupedTodos = Array.from(dedupedTodoMap.values())
  // 去重后的待办按优先级排序：URGENT > HIGH > MEDIUM > LOW
  const priorityOrder = { URGENT: 0, HIGH: 1, MEDIUM: 2, LOW: 3 }
  dedupedTodos.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority])
  // 风险分布：使用去重后的数据，与待办列表一致
  const riskDistribution = {
    contract: dedupedTodos.filter((t) => t.type === 'CONTRACT').length,
@@ -946,8 +977,7 @@ export async function getDashboardData(orgId: string) {
    termination: dedupedTodos.filter((t) => t.type === 'TERMINATION').length,
  }
-  // 按优先级排序：URGENT > HIGH > MEDIUM > LOW
+  // 按优先级排序：URGENT > HIGH > MEDIUM > LOW（priorityOrder 已在上方声明）
  const priorityOrder = { URGENT: 0, HIGH: 1, MEDIUM: 2, LOW: 3 }
  todosWithCost.sort((a, b) => priorityOrder[a.priority] - priorityOrder[b.priority])
  const topRisks = todosWithCost
@@ -1184,7 +1214,27 @@ export async function getMonthlyCalendar(orgId: string, month: string) {
    }
  }
-  // 7. 自定义日历事件
+  // 7. 发薪日期
  const org = await prisma.organization.findUnique({
    where: { id: orgId },
    select: { payrollDays: true },
  })
  const payrollDays = Array.isArray(org?.payrollDays) ? org.payrollDays as number[] : []
  for (const day of payrollDays) {
    const dateStr = `${month}-${String(day).padStart(2, '0')}`
    const payrollDate = new Date(parseInt(year), monthNum - 1, day)
    if (payrollDate >= monthStart && payrollDate <= monthEnd) {
      events.push({
        date: dateStr,
        type: 'PAYROLL_DAY',
        title: `发薪日（每月${day}号）`,
        actionUrl: '/money',
        priority: 'medium',
      })
    }
  }
  // 8. 自定义日历事件
  const customEvents = await prisma.calendarEvent.findMany({
    where: {
      orgId,
@@ -1908,7 +1958,7 @@ export async function getAnnualValueReport(orgId: string, year: number) {
    }),
  ])
-  // 按身份证号去重（同一人可能有多条 Employee 记录），无身份证号时回退到 employeeId
+  // 按证件号码去重（同一人可能有多条 Employee 记录），无证件号码时回退到 employeeId
  // 同时按风险类型去重（同一风险被重复创建解决多次，只取 estimatedLoss 最大的一条）
  const personBreakdown: Record<string, {
    personKey: string
@@ -1968,7 +2018,7 @@ export async function getAnnualValueReport(orgId: string, year: number) {
  }
  for (const r of employeeRiskDetails) {
-    // 去重优先级：身份证号 > 姓名回退到姓名，避免同一人多条 Employee 记录被重复计算
+    // 去重优先级：证件号码 > 姓名回退到姓名，避免同一人多条 Employee 记录被重复计算
    const personKey = r.employee?.idCardHash || r.employee?.name || r.employeeId || '_unknown'
    if (!personBreakdown[personKey]) {
      personBreakdown[personKey] = {
@@ -92,6 +92,11 @@ export async function createSpecialStatus(orgId: string, userId: string, data: a
    throw { code: 'NOT_FOUND', message: '员工不存在' }
  }
  // 合规校验：男职工不可选择三期
  if (data.type === 'PREGNANCY' && employee.gender === '男') {
    throw { code: 'VALIDATION_ERROR', message: '三期仅适用于女性员工，男职工不可选择三期' }
  }
  // 三期自动计算
  let pregnancyData: any = {}
  if (data.type === 'PREGNANCY' && data.expectedDueDate) {
@@ -95,7 +95,7 @@ export const documentTemplates: DocumentTemplate[] = [
    content: `解除劳动合同协议书
 甲方（用人单位）：{{companyName}}
-乙方（劳动者）：{{employeeName}}，身份证号：{{idCard}}
+乙方（劳动者）：{{employeeName}}，证件号码：{{idCard}}
 甲乙双方经协商一致，就解除劳动合同事宜达成如下协议：
@@ -135,7 +135,7 @@ export const documentTemplates: DocumentTemplate[] = [
    content: `解除劳动合同协议书
 甲方（用人单位）：{{companyName}}
-乙方（劳动者）：{{employeeName}}，身份证号：{{idCard}}
+乙方（劳动者）：{{employeeName}}，证件号码：{{idCard}}
 乙方因个人原因主动提出离职，经甲乙双方友好协商，就解除劳动合同事宜达成如下协议：
@@ -278,6 +278,100 @@ ____年__月__日
 签收人：____________    日期：____年__月__日`,
  },
  {
    id: 'tpl_union_termination_notice',
    name: '拟解除劳动合同通知工会函（北京）',
    category: 'NOTICE',
    description: '北京地区单方解除劳动合同前通知工会的函件样式（依据《规范用人单位单方解除劳动合同工作指引》）',
    variables: ['companyName', 'employeeName', 'employeeGender', 'employeeAge', 'idCard', 'employeePosition', 'workYears', 'contractPeriod', 'employeePhone', 'terminationReason', 'legalBasis', 'contactPerson', 'contactPhone', 'companyAddress'],
    content: `拟解除劳动合同通知工会函
 {{companyName}}拟解除{{employeeName}}劳动合同的函
 {{companyName}}工会（或上一级工会）：
 我单位拟单方解除与{{employeeName}}（劳动者姓名）的劳动合同，具体情况如下：
 一、劳动者基本情况
 姓名：{{employeeName}}
 性别：{{employeeGender}}
 年龄：{{employeeAge}}
 身份证号：{{idCard}}
 工作岗位：{{employeePosition}}
 在本单位工作年限：{{workYears}}
 劳动合同期限：{{contractPeriod}}
 联系方式：{{employeePhone}}
 二、解除劳动合同的事由
 {{terminationReason}}
 三、解除劳动合同的依据
 {{legalBasis}}
 联系人：{{contactPerson}}
 电话：{{contactPhone}}
 地址：{{companyAddress}}
 附件：其他证据材料
 {{companyName}}（盖章）
 ____年__月__日`,
  },
  {
    id: 'tpl_union_receipt',
    name: '工会回执（北京）',
    category: 'OTHER',
    description: '工会收到用人单位单方解除劳动合同通知后的书面回执样式',
    variables: ['receiptNo', 'companyName', 'employeeName', 'unionContactPerson', 'unionContactPhone', 'unionAddress'],
    content: `回执
 编号：{{receiptNo}}
 {{companyName}}：
 你单位送交的单方解除与{{employeeName}}劳动合同通知工会的相关材料已收到。
 你单位单方解除劳动合同，应严格遵守《中华人民共和国劳动法》《中华人民共和国劳动合同法》《北京市实施〈中华人民共和国工会法〉办法》等法律法规规定，做到事实清楚、程序合法、依据充分，并依法履行出具解除劳动合同证明、支付经济补偿等法定义务，切实维护职工合法权益。因提供虚假或不完整材料，产生的相关法律后果由你单位自行承担。
 联系人：{{unionContactPerson}}
 电话：{{unionContactPhone}}
 地址：{{unionAddress}}
 （盖章）
 ____年__月__日`,
  },
  {
    id: 'tpl_union_supervision_letter',
    name: '工会劳动法律监督提示函（北京）',
    category: 'NOTICE',
    description: '工会认为用人单位违反法律法规时提出的意见建议函件样式',
    variables: ['letterNo', 'companyName', 'employeeName', 'supervisionIssues', 'supervisionOpinions', 'unionContactPerson', 'unionContactPhone', 'unionAddress'],
    content: `工会劳动法律监督提示函
 {{letterNo}}
 {{companyName}}：
 你单位送交的单方解除与{{employeeName}}劳动合同通知工会的相关文本材料已收到。经审查，发现你单位存在下列问题：
 {{supervisionIssues}}
 就以上问题，我会提出以下意见：
 {{supervisionOpinions}}
 请你单位收函后认真研究，将处理结果书面通知本会。
 联系人：{{unionContactPerson}}
 电话：{{unionContactPhone}}
 地址：{{unionAddress}}
 （盖章）
 ____年__月__日`,
  },
 ]
 /**
@@ -1,5 +1,6 @@
 import prisma from '../lib/prisma'
 import { RiskAssessment, TerminationReason } from '@prisma/client'
 import { autoCreateEsignRecord } from './esign.service'
 function dateToMonth(date: Date): string {
  const y = date.getFullYear()
@@ -7,6 +8,13 @@ function dateToMonth(date: Date): string {
  return `${y}-${m}`
 }
 /** 计算上一个月，格式 YYYY-MM */
 function prevMonth(month: string): string {
  const [y, m] = month.split('-').map(Number)
  if (m === 1) return `${y - 1}-12`
  return `${y}-${String(m - 1).padStart(2, '0')}`
 }
 export interface ChecklistItem {
  key: string
  label: string
@@ -16,7 +24,9 @@ export interface ChecklistItem {
  suggestionType?: 'info' | 'warning' | 'required'
 }
-export function getChecklistForReason(reason: string, employee?: any): ChecklistItem[] {
+export function getChecklistForReason(reason: string, employee?: any, orgCity?: string): ChecklistItem[] {
  // 北京地区单方解除须通知工会（依据《规范用人单位单方解除劳动合同工作指引》）
  const isBeijing = !orgCity || orgCity === '北京' || orgCity === '北京市' || orgCity?.includes('北京')
  switch (reason) {
    case 'NEGOTIATED':
      return [
@@ -33,7 +43,14 @@ export function getChecklistForReason(reason: string, employee?: any): Checklist
      return [
        { key: 'has_rules', label: '是否有规章制度依据', autoChecked: null },
        { key: 'has_evidence', label: '是否有违纪证据', autoChecked: null },
-        { key: 'notify_union', label: '是否事先通知工会', autoChecked: null },
+        ...(isBeijing ? [{
          key: 'notify_union',
          label: '是否提前5个工作日书面通知工会',
          autoChecked: null as any,
          suggestion: '北京地区要求：单方解除劳动合同须提前5个工作日将理由书面通知本单位工会；未建立工会的通知上一级工会（用人单位实际经营地的乡镇/街道/园区/开发区总工会）。可在「文本模板库」中使用《拟解除劳动合同通知工会函》模板。',
          suggestionType: 'required' as const,
        }] : []),
        ...(isBeijing ? [{ key: 'union_receipt', label: '是否收到工会书面回执', autoChecked: null as any }] : []),
        { key: 'written_notice', label: '是否出具书面解除通知', autoChecked: null },
      ]
    case 'NONFAULT': {
@@ -86,12 +103,29 @@ export function getChecklistForReason(reason: string, employee?: any): Checklist
        suggestionType: 'required',
      })
      // 通知工会 — 北京地区单方解除必经程序
      if (isBeijing) {
        items.push({
          key: 'notify_union',
          label: '是否提前5个工作日书面通知工会',
          autoChecked: null,
          suggestion: '北京地区要求：单方解除须提前5个工作日将理由书面通知本单位工会；未建立工会的通知上一级工会。可在「文本模板库」中使用《拟解除劳动合同通知工会函》模板。',
          suggestionType: 'required',
        })
        items.push({
          key: 'union_receipt',
          label: '是否收到工会书面回执',
          autoChecked: null,
        })
      }
      return items
    }
    case 'LAYOFF':
      return [
        { key: 'advance_notice_30', label: '是否提前30天向工会或全体职工说明', autoChecked: null },
        { key: 'listen_opinions', label: '是否听取工会或职工意见', autoChecked: null },
        ...(isBeijing ? [{ key: 'union_receipt', label: '是否收到工会书面回执', autoChecked: null as any }] : []),
        { key: 'report_labor_dept', label: '是否向劳动行政部门报告', autoChecked: null },
        {
          key: 'compensation_paid', label: '是否支付经济补偿金',
@@ -545,6 +579,26 @@ export async function createDraft(orgId: string, userId: string, data: any) {
  const { level } = assessRisk(employee, data.reason || 'NEGOTIATED')
  // 自动推导社保/公积金截止月（基于组织 socialInsCutoffDay 配置）
  let socialInsEndMonth = data.socialInsEndMonth || null
  let housingFundEndMonth = data.housingFundEndMonth || null
  if (data.terminationDate && !socialInsEndMonth) {
    const org = await prisma.organization.findUnique({ where: { id: orgId }, select: { socialInsCutoffDay: true } })
    const cutoffDay = org?.socialInsCutoffDay ?? 15
    const termDate = new Date(data.terminationDate)
    const termDay = termDate.getDate()
    const termMonth = dateToMonth(termDate)
    // cutoffDay 日前离职 → 截止月 = 离职月 - 1；cutoffDay 日后离职 → 截止月 = 离职月
    if (termDay <= cutoffDay) {
      const prevMon = prevMonth(termMonth)
      socialInsEndMonth = prevMon
      housingFundEndMonth = prevMon
    } else {
      socialInsEndMonth = termMonth
      housingFundEndMonth = termMonth
    }
  }
  const record = await prisma.terminationRecord.create({
    data: {
      orgId,
@@ -554,8 +608,8 @@ export async function createDraft(orgId: string, userId: string, data: any) {
      terminationDate: data.terminationDate ? new Date(data.terminationDate) : new Date(),
      resignationReason: data.resignationReason || null,
      compensation: data.compensation || 0,
-      socialInsEndMonth: data.socialInsEndMonth || null,
+      socialInsEndMonth,
-      housingFundEndMonth: data.housingFundEndMonth || null,
+      housingFundEndMonth,
      riskLevel: level,
      checklist: data.checklist || {},
      remark: data.remark || null,
@@ -568,6 +622,18 @@ export async function createDraft(orgId: string, userId: string, data: any) {
    },
  })
  // 主动离职时自动创建离职协议电子签署记录
  if (data.type === 'RESIGNATION') {
    await autoCreateEsignRecord({
      orgId,
      employeeId: data.employeeId,
      scene: 'RESIGNATION',
      documentTitle: `${employee.name}的离职协议`,
      remark: '员工主动离职时自动发起',
      createdBy: userId,
    })
  }
  return { id: record.id }
 }
@@ -723,6 +789,19 @@ export async function executeTermination(orgId: string, recordId: string, userId
    })
  })
  // 公司解聘执行完成后自动创建离职协议电子签署记录
  if (record.type === 'TERMINATION') {
    const employee = await prisma.employee.findFirst({ where: { id: record.employeeId }, select: { name: true } })
    await autoCreateEsignRecord({
      orgId,
      employeeId: record.employeeId,
      scene: 'RESIGNATION',
      documentTitle: `${employee?.name || '员工'}的解除劳动合同协议`,
      remark: '公司解聘执行完成时自动发起',
      createdBy: userId,
    })
  }
  return { id: recordId }
 }
@@ -1,7 +1,7 @@
 import prisma from '../lib/prisma'
-import { encrypt } from '../lib/crypto'
+import { encrypt, decrypt } from '../lib/crypto'
 import { createDraft as createTerminationDraft, executeTermination } from './termination.service'
-import { createEmployee, addContract } from './contract.service'
+import { createEmployee, addContract, prevMonth } from './contract.service'
 import { runRiskDetection } from './risk.service'
 // 13类流程定义
@@ -69,10 +69,44 @@ export async function executeWorkProcess(processId: string, type: string, formDa
      const { employeeId, regularSalary } = formData
      if (employeeId) {
        if (regularSalary) {
          const employee = await prisma.employee.findFirst({ where: { id: employeeId, orgId } })
          const oldSalary = employee ? Number(decrypt(employee.monthlySalary)) || 0 : 0
          const newSalary = Number(regularSalary) || 0
          await prisma.employee.update({
            where: { id: employeeId },
            data: { monthlySalary: encrypt(String(regularSalary)) },
          })
          // 记录薪资变更（试用期薪资 → 转正薪资）
          if (oldSalary !== newSalary) {
            const now = new Date()
            const nowMonth = now.toISOString().slice(0, 7)
            await prisma.salaryChangeRecord.updateMany({
              where: { employeeId, endMonth: null },
              data: { endMonth: prevMonth(nowMonth) },
            })
            await prisma.salaryChangeRecord.create({
              data: {
                orgId,
                employeeId,
                oldSalary,
                newSalary,
                effectiveDate: now,
                effectiveMonth: nowMonth,
                endMonth: null,
                changeType: 'CONFIRM',
                reason: '试用期转正薪资调整',
                createdBy: userId,
              },
            })
          }
          // 校验转正薪资与最新合同试用期薪资是否一致（提示性校验）
          const latestContract = await prisma.laborContract.findFirst({
            where: { employeeId, orgId },
            orderBy: { createdAt: 'desc' },
          })
          if (latestContract?.probationSalary && latestContract.probationSalary !== newSalary) {
            console.warn(`[CONFIRM] 转正薪资 ¥${newSalary} 与合同试用期薪资 ¥${latestContract.probationSalary} 不一致，员工: ${employeeId}`)
          }
          await runRiskDetection(orgId)
        }
      }
@@ -260,29 +294,31 @@ export async function generateDocument(type: string, formData: any, orgName: str
    }
  }
  const wrapHtml = (title: string, body: string) => `<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns="http://www.w3.org/TR/REC-html40">
 <head><meta charset="utf-8"><title>${title}</title>
 <style>
 body { font-family: SimSun, serif; font-size: 14pt; line-height: 2; text-align: center; }
 .title { font-size: 22pt; font-weight: bold; margin-bottom: 30pt; }
 .body { text-align: justify; text-indent: 2em; margin: 0 20pt; }
 .sign { text-align: right; margin-top: 30pt; margin-right: 20pt; }
 </style></head>
 <body>
 <div class="title">${title}</div>
 ${body}
 </body></html>`
  const templates: Record<string, (data: any, org: string) => string> = {
-    INCOME_CERT: (data, org) => `收入证明
+    INCOME_CERT: (data, org) => wrapHtml('收入证明', `
-
+<div class="body">兹证明 ${data.employeeName || '___'}（证件号码：${data.idCardNumber || '___'}）系我单位员工，自 ${data.hireDate || '___'} 起在我单位工作，现任 ${data.position || '___'} 职务。</div>
-兹证明 ${data.employeeName || '___'}（身份证号：${data.idCardNumber || '___'}）系我单位员工，自 ${data.hireDate || '___'} 起在我单位工作，现任 ${data.position || '___'} 职务。
+<div class="body">该员工近一年平均月收入为人民币 ${data.monthlyIncome || '___'} 元（税前）。</div>
-
+<div class="body">本证明仅用于 ${data.purpose || '___'}，不作其他用途。</div>
-该员工近一年平均月收入为人民币 ${data.monthlyIncome || '___'} 元（税前）。
+<div class="body">特此证明。</div>
-
+<div class="sign">${org}<br/>${new Date().toLocaleDateString('zh-CN')}</div>`),
-本证明仅用于 ${data.purpose || '___'}，不作其他用途。
+    LEAVING_CERT: (data, org) => wrapHtml('离职证明', `
-
+<div class="body">兹证明 ${data.employeeName || '___'}（证件号码：${data.idCardNumber || '___'}）自 ${data.hireDate || '___'} 至 ${data.leaveDate || '___'} 在我单位工作，最后职务为 ${data.position || '___'}。</div>
-特此证明。
+<div class="body">该员工已于 ${data.leaveDate || '___'} 与我单位解除劳动关系，双方已办妥交接手续。</div>
-
+<div class="body">特此证明。</div>
-${org}
+<div class="sign">${org}<br/>${new Date().toLocaleDateString('zh-CN')}</div>`),
 ${new Date().toLocaleDateString('zh-CN')}`,
    LEAVING_CERT: (data, org) => `离职证明
 兹证明 ${data.employeeName || '___'}（身份证号：${data.idCardNumber || '___'}）自 ${data.hireDate || '___'} 至 ${data.leaveDate || '___'} 在我单位工作，最后职务为 ${data.position || '___'}。
 该员工已于 ${data.leaveDate || '___'} 与我单位解除劳动关系，双方已办妥交接手续。
 特此证明。
 ${org}
 ${new Date().toLocaleDateString('zh-CN')}`,
  }
  const generator = templates[type]
  if (!generator) return { name: '', content: '' }
@@ -1,5 +1,5 @@
 #!/bin/bash
-# 企业用工专家 一键部署脚本
+# 安职通 一键部署脚本
 # 部署到 154.8.162.18 -> /var/www/turbohr/ -> https://on.hr8ai.top/
 #
 # 用法: bash deploy.sh
@@ -342,7 +342,7 @@ verify() {
    echo ""
    echo "========================================="
-    echo "  企业用工专家 部署完成!"
+    echo "  安职通 部署完成!"
    echo "  访问地址: https://${DOMAIN}/"
    echo "  后端 API: https://${DOMAIN}/api/v1/"
    echo "  PM2 管理: pm2 list (服务器上)"
@@ -357,7 +357,7 @@ if [ "$1" = "--init" ]; then
    IS_INIT=true
 fi
-log "开始部署 企业用工专家 到 ${REMOTE_HOST}"
+log "开始部署 安职通 到 ${REMOTE_HOST}"
 log "域名: ${DOMAIN}  目录: ${REMOTE_DIR}"
 echo ""
@@ -0,0 +1,352 @@
 # 20260805 优化需求清单
 > 基于用户反馈整理，对照系统代码逐一分析问题根因及优化方案。
 ---
 ## 问题1：花名册身份证号复制后粘贴为乱码
 **模块**：花名册  
 **优先级**：P0  
 **状态**：待修复
 **现状描述**：
 花名册列表和员工详情页均支持点击身份证号复制，但用户反馈复制后粘贴出来是乱码。
 **问题分析**：
 - 列表页 `Roster.tsx:522-526`：点击脱敏身份证号时调用 `navigator.clipboard.writeText(e.idCardNumber)` 复制完整身份证号
 - 详情页 `BasicInfo.tsx:200-213`：同样使用 `navigator.clipboard.writeText(profile.idCardNumber)` 复制
 - `navigator.clipboard.writeText` 在非 HTTPS 环境或部分浏览器下可能静默失败，clipboard API 返回的 Promise 可能被 reject
 - 当前 `.catch(() => toast.error('复制失败'))` 仅提示失败，但用户可能看到"已复制"提示后实际粘贴为空或乱码
 - 可能原因：`idCardNumber` 字段经过加密存储，解密后的值可能包含不可见字符或编码问题
 **涉及文件**：
 - `frontend/src/pages/Roster.tsx:522-526`
 - `frontend/src/pages/roster/BasicInfo.tsx:200-213`
 **优化方案**：
 1. 检查 `idCardNumber` 字段是否经过 `decrypt()` 解密，确认复制的是明文而非加密后的乱码
 2. 增加 fallback 方案：当 `navigator.clipboard` 不可用时，使用 `document.execCommand('copy')` + 隐藏 textarea 兜底
 3. 复制后增加验证：读取 clipboard 内容验证是否与原始值一致
 4. 确认后端返回的 `idCardNumber` 已正确解密为明文
 ---
 ## 问题2：薪税管理筛选条件需精确到年月日，且每笔工资需有创建时间
 **模块**：薪税管理  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 薪税管理中筛选条件仅支持按月（YYYY-MM）筛选，无法精确到具体日期。同时发薪批次列表未显示创建时间，难以区分同月多笔工资。
 **问题分析**：
 - `BatchTab.tsx:101-103`：筛选条件为 `month`（YYYY-MM）、`monthFrom`、`monthTo`，均为月份级别
 - 后端 `payroll2.routes.ts:151-168`：查询参数 `month`、`monthFrom`、`monthTo` 也只支持月份级别
 - `PayrollBatch` schema 有 `createdAt` 字段（`schema.prisma:710`），但前端列表未展示
 - 同月可创建多个批次（`batchNo` 区分），但用户无法直观看出创建先后顺序
 **涉及文件**：
 - `frontend/src/pages/money/BatchTab.tsx:101-103, 220-240`
 - `backend/src/routes/payroll2.routes.ts:151-168`
 - `backend/prisma/schema.prisma:691-719`（PayrollBatch model）
 **优化方案**：
 1. 批次列表增加「创建时间」列，显示 `createdAt`（格式：YYYY-MM-DD HH:mm）
 2. 筛选条件增加日期范围选择器（`dateFrom` / `dateTo`），后端按 `createdAt` 过滤
 3. 列表默认按 `createdAt desc` 排序（当前按 `month desc, batchNo asc`）
 4. 批次详情中每条工资条目也可展示创建/修改时间
 ---
 ## 问题3：社保公积金无法创建和保存新的政策比例
 **模块**：社保公积金  
 **优先级**：P0  
 **状态**：待修复
 **现状描述**：
 用户在社保公积金页面创建新版本政策比例时无法保存成功。
 **问题分析**：
 - 前端 `SocialInsurance.tsx:183-201`：`createVersionMutation` 和 `createHousingVersionMutation` 调用后端 API
 - 后端 `social.routes.ts:126-168`：创建社保配置版本时，检查同一城市同一生效月份是否已有版本，如有则返回 400 错误
 - 后端 `social.routes.ts:509-549`：创建公积金配置版本同样检查重复
 - 可能原因：
  1. 前端 `newVersion.city` 默认为 `'北京'`，但后端 `socialConfigFields` 中 `city` 为 `optional`，若前端未传或传空可能导致 `where` 条件匹配到 `city: null` 的已有记录
  2. 后端 `prevCurrent` 查询 `where: { orgId, isCurrent: true }` 未按城市过滤（社保），可能将其他城市的当前版本也标记为失效
  3. 前端 `createVersionMutation` 的 `onSuccess` 未显示错误详情，`onError` 未定义，用户可能看不到错误信息
  4. `z.object` 校验可能因前端传入的字段类型不匹配（如 `number` 传为 `string`）而静默失败
 **涉及文件**：
 - `frontend/src/pages/SocialInsurance.tsx:183-201, 786-789`
 - `backend/src/routes/social.routes.ts:11-26, 120-168, 503-549`
 - `backend/prisma/schema.prisma:430-445`（SocialInsuranceConfig model）
 **优化方案**：
 1. 后端 `prevCurrent` 查询增加 `city` 过滤条件，避免误将其他城市的版本标记失效
 2. 前端 `createVersionMutation` 和 `createHousingVersionMutation` 增加 `onError` 回调，显示后端返回的错误信息
 3. 前端提交前校验必填字段（城市、生效月份、各比例），确保类型正确
 4. 后端 `createVersionSchema` 的 `city` 字段改为 `z.string().min(1)` 必填，避免 null 匹配问题
 5. 增加 try-catch 日志输出，方便排查具体失败原因
 ---
 ## 问题4：证据链无法导出，导出证据链显示导出失败
 **模块**：证据链  
 **优先级**：P0  
 **状态**：待修复
 **现状描述**：
 员工档案 → 证据链页面，点击「导出证据链」按钮提示"导出失败"。
 **问题分析**：
 - 前端 `EvidenceChain.tsx:47-63`：`handleExport` 使用 `fetch` 请求 `/api/v1/roster/${employeeId}/evidence-chain/export`，获取 blob 后下载
 - 后端 `roster.routes.ts:582-747`：使用 `ExcelJS` 生成 xlsx 文件并返回
 - 可能原因：
  1. 后端 `ExcelJS` 依赖未在服务器安装（`package.json` 中有 `exceljs: ^4.4.0`，但服务器可能未执行 `npm install`）
  2. `workbook.xlsx.write(res)` 写入流可能因 res 已设置 header 但写入失败而报错
  3. 前端 `fetch` 请求未携带 `Content-Type: application/json`，但后端返回的是二进制流，`res.blob()` 可能解析失败
  4. 服务器内存不足导致 ExcelJS 生成大文件失败
  5. Nginx 代理可能对大响应体有超时或大小限制
 **涉及文件**：
 - `frontend/src/pages/roster/EvidenceChain.tsx:47-63`
 - `backend/src/routes/roster.routes.ts:582-747`
 - `backend/package.json:22`（exceljs 依赖）
 **优化方案**：
 1. 确认服务器已安装 exceljs 依赖（`npm ls exceljs`）
 2. 后端增加错误日志：`catch (err) { console.error('证据链导出失败:', err); next(err) }`
 3. 前端 `handleExport` 增加详细错误处理：读取 `res.text()` 获取后端错误信息
 4. 后端 `workbook.xlsx.write(res)` 改为 `workbook.xlsx.writeBuffer()` 然后 `res.send(buffer)`，避免流写入问题
 5. 检查 Nginx `proxy_buffer_size` 和 `proxy_read_timeout` 配置
 ---
 ## 问题5：用工办理中离职证明无法自主选择模板，导出为txt格式且格式混乱
 **模块**：用工办理  
 **优先级**：P0  
 **状态**：待优化
 **现状描述**：
 用工办理中开具离职证明时只能使用系统默认模板，导出的证明是 txt 文档格式混乱，希望能自主选择模板且能直接电子签章后提供给员工。
 **问题分析**：
 - 前端 `WorkProcess.tsx:129-135`：`LEAVING_CERT` 表单已有 `enterpriseTemplateId` 字段（`enterprise-template` 类型），支持选择企业自定义模板
 - 后端 `work-process.service.ts:246-261`：`generateDocument` 函数已支持企业模板渲染（`formData.enterpriseTemplateId`）
 - 但生成文件扩展名为 `.doc`（`work-process.service.ts:259, 289`），实际内容为纯文本，非真正的 Word 文档
 - `EnterpriseTemplateSelect` 组件（`WorkProcess.tsx:722-744`）已实现模板选择下拉框，但用户可能未创建企业模板
 - 导出的文书存储在 `workProcess.documents` 字段（JSON 数组），未关联电子签章流程
 **涉及文件**：
 - `frontend/src/pages/WorkProcess.tsx:129-135, 722-744`
 - `backend/src/services/work-process.service.ts:245-290`
 - `backend/src/routes/work-process.routes.ts:136-192`
 - `backend/src/routes/enterprise-template.routes.ts`
 **优化方案**：
 1. **导出格式优化**：将纯文本 `.doc` 改为生成真正的 Word 文档（使用 `docx` 库）或 PDF 格式
 2. **模板选择增强**：在离职证明表单中增加模板预览功能，选择模板后可实时预览渲染效果
 3. **电子签章集成**：审批通过后自动创建电子签署记录（类似入职流程 `work-process.routes.ts:168-186`），场景为 `RESIGNATION`
 4. **文书下载优化**：前端增加文书下载按钮，支持直接下载 PDF/Word 格式
 5. **模板提示**：当无企业模板时，增加快捷跳转链接到「模板库 → 企业文本库」创建
 ---
 ## 问题6：用工办理中多个模块功能重复
 **模块**：用工办理  
 **优先级**：P2  
 **状态**：待优化
 **现状描述**：
 用工办理中多个流程类型功能重复，都是录入员工信息和合同时间，希望合并精简。
 **问题分析**：
 - `work-process.service.ts:8-22`：共定义 13 类流程
 - 功能重复的流程：
  - `HIRE`（员工录用）和 `ONBOARD`（员工入职）：都涉及录入员工信息和创建合同
  - `CUSTOM_CONTRACT`（自定义合同签署）和 `CHANGE`（合同变更）和 `RENEW`（合同续签）：都是合同相关操作
  - `TERMINATE`（合同终止）和 `RESCIND`（合同解除）：都是结束劳动关系
  - `INCOME_CERT`（收入证明）和 `LEAVING_CERT`（离职证明）：都是开具证明文书
 - 前端 `WorkProcess.tsx` 的 `FORM_FIELDS` 配置中多个流程字段高度重叠（employeeName、idCardNumber、startDate、endDate 等）
 **涉及文件**：
 - `backend/src/services/work-process.service.ts:8-22`
 - `frontend/src/pages/WorkProcess.tsx`（FORM_FIELDS 配置）
 **优化方案**：
 1. **合并入离职类**：将 `HIRE` 和 `ONBOARD` 合并为「入职办理」，区分"新员工入职"和"录用+入职一步完成"两种模式
 2. **合并合同类**：将 `CUSTOM_CONTRACT`、`CHANGE`、`RENEW` 合并为「合同签署/变更」，通过子类型区分
 3. **合并解聘类**：将 `TERMINATE` 和 `RESCIND` 合并为「解除/终止合同」，通过原因字段区分
 4. **合并证明类**：将 `INCOME_CERT` 和 `LEAVING_CERT` 合并为「开具证明」，通过证明类型切换模板
 5. **保留独立流程**：`CONFIRM`（转正）、`SUSPEND`（中止）、`FLEXIBLE`（灵活用工）、`INFO_SUBMIT`（信息变更）保持独立
 6. 合并后流程类型从 13 个精简为约 8 个，减少用户选择困难
 ---
 ## 问题7：违纪记录员工签字确认后企业端需可下载违纪确认证明
 **模块**：违纪记录  
 **优先级**：P0  
 **状态**：待新增
 **现状描述**：
 员工在员工端签字确认违纪记录后，企业端没有可下载的违纪确认证明文件。
 **问题分析**：
 - 前端 `DisciplinaryInfo.tsx`：仅展示违纪记录列表和新增表单，无下载/导出功能
 - 后端 `roster.routes.ts:478-490`：证据链中包含违纪记录信息，但无单独的违纪确认证明导出接口
 - `DisciplinaryRecord` schema（`schema.prisma:565-577`）有 `employeeAck`、`ackDate`、`ackMethod`、`witness`、`attachmentUrl` 字段，但无独立的证明生成功能
 - 培训记录已有签收单导出的先例可参考
 **涉及文件**：
 - `frontend/src/pages/roster/DisciplinaryInfo.tsx`
 - `frontend/src/pages/roster/PerformanceRecords.tsx`（同样需要下载功能）
 - `backend/src/routes/roster.routes.ts`（需新增导出接口）
 - `backend/prisma/schema.prisma:565-577`（DisciplinaryRecord model）
 **优化方案**：
 1. 后端新增 `GET /roster/:employeeId/disciplinary/:recordId/certificate` 接口，生成违纪确认证明 PDF
 2. 证明内容包含：企业名称、员工姓名、身份证号、违纪事实、处理结果、签字确认状态、确认日期、见证人
 3. 前端 `DisciplinaryInfo.tsx` 在已签字的记录上增加「下载确认证明」按钮
 4. 同步为绩效考核记录增加类似的确认证明下载功能
 5. 证明格式使用 PDF（使用 `pdfkit` 或 `puppeteer` 生成）
 ---
 ## 问题8：医疗期计算只有全国和上海两个地区政策
 **模块**：医疗期计算器  
 **优先级**：P2  
 **状态**：待优化
 **现状描述**：
 医疗期计算器仅支持"全国（通用规定）"和"上海（特殊规定）"两个地区选项，其他有特殊政策的地区无法选择。
 **问题分析**：
 - 前端 `MedicalPeriodCalculator.tsx:42-86`：`calculateMedicalPeriod` 函数硬编码了 `region: 'shanghai' | 'national'` 两种逻辑
 - 地区选择为固定下拉框（`MedicalPeriodCalculator.tsx:146-153`），只有两个选项
 - 后端 `special-status.service.ts:68-76`：`calculateMedicalMonths` 函数也仅按全国通用标准计算，未区分地区
 - 各地特殊政策举例：
  - 广东：按实际工作年限和本单位工作年限分档
  - 北京：与全国规定一致但有补充细则
  - 江苏、浙江等省份有各自的地方规定
 **涉及文件**：
 - `frontend/src/pages/tools/MedicalPeriodCalculator.tsx:29-107, 146-153`
 - `backend/src/services/special-status.service.ts:68-76`
 **优化方案**：
 1. 将地区政策配置改为数据驱动，支持动态添加地区规则
 2. 新增 `medicalPeriodPolicy` 配置表或 JSON 配置，存储各地政策分档规则
 3. 前端地区选择改为可搜索下拉框，支持从配置中动态加载
 4. 管理员可在系统设置中添加自定义地区政策（工龄分档 → 医疗期月数 → 累计周期月数）
 5. 预置全国通用、上海、广东、北京等常见地区政策
 6. 后端 `calculateMedicalMonths` 函数同步支持按地区查询配置
 ---
 ## 问题9：绩效考核需区分月度/年度考核，得分与等级应关联
 **模块**：绩效考核  
 **优先级**：P0  
 **状态**：待优化
 **现状描述**：
 1. 绩效考核无法区分月度考核与年度考核
 2. 录入的得分和等级二者无关联，应按得分自动分等级
 **问题分析**：
 - `PerformanceRecord` schema（`schema.prisma:624-643`）：`period` 字段为自由文本（`YYYY-MM` 或 `YYYY-Q1`），无考核类型字段
 - `score`（Float）和 `grade`（String，A/B/C/D）是独立字段，前端表单分别输入，无联动逻辑
 - `result`（EXCELLENT/QUALIFIED/NEED_IMPROVE/UNQUALIFIED）也与 `score` 和 `grade` 无关联
 - 前端 `PerformanceInfo.tsx:38-48`：考核周期为自由输入框，得分和等级分别独立选择
 - 前端 `PerformanceRecords.tsx:212-228`：考核周期使用 `type="month"` 选择器，仅支持月度
 **涉及文件**：
 - `frontend/src/pages/roster/PerformanceInfo.tsx:14, 38-48`
 - `frontend/src/pages/roster/PerformanceRecords.tsx:181-270`
 - `backend/prisma/schema.prisma:624-643`（PerformanceRecord model）
 - `backend/src/routes/roster.routes.ts:1064-1097`
 **优化方案**：
 1. **新增考核类型字段**：`PerformanceRecord` 增加 `periodType` 字段（`MONTHLY`/`QUARTERLY`/`YEARLY`），前端表单增加类型选择
 2. **考核周期选择优化**：根据 `periodType` 动态切换输入方式（月度→ month 选择器，季度→ Q1/Q2/Q3/Q4 选择，年度→ year 选择器）
 3. **得分等级自动关联**：
   - 前端输入得分后自动计算等级和结果：
     - 90-100 → A（优秀 EXCELLENT）
     - 80-89 → B（合格 QUALIFIED）
     - 60-79 → C（需改进 NEED_IMPROVE）
     - 0-59 → D（不胜任 UNQUALIFIED）
   - 等级和结果字段变为只读，由得分自动填充（可手动覆盖，覆盖后标记为"手动调整"）
 4. **后端校验**：保存时校验得分与等级的匹配性，若不一致记录日志
 5. **列表展示**：绩效考核列表页增加考核类型筛选（月度/季度/年度）
 ---
 ## 问题10：花名册劳动合同无法下载，且不应能删除
 **模块**：花名册 → 劳动合同  
 **优先级**：P0  
 **状态**：待修复
 **现状描述**：
 1. 员工花名册中的劳动合同附件无法下载，点击附件和下载按钮都无反应
 2. 劳动合同作为重要资料可以修改或覆盖，但不应该能删除
 **问题分析**：
 - 前端 `ContractInfo.tsx:258-289`：合同附件展示区域尝试解析 `c.attachmentUrl`（JSON 或 data URL），使用 `<a href={att.url} download={att.name}>` 下载
 - 附件以 base64 data URL 形式存储在数据库中，`<a>` 标签的 `download` 属性对 data URL 在某些浏览器下不生效
 - 下载无反应的可能原因：
  1. data URL 过长，浏览器阻止下载
  2. `attachmentUrl` 字段存储的是 JSON 字符串，解析失败时回退逻辑可能未正确处理
  3. `<a>` 标签点击事件被外层 `<button>` 或其他事件拦截
 - 删除问题：
  - 前端 `ContractInfo.tsx:300-306`：有删除按钮，调用 `deleteContractMutation`
  - 后端 `employee.routes.ts:279-294`：`DELETE /contracts/:contractId` 直接物理删除合同记录
  - 合同作为重要法律文件，应禁止删除，仅允许新增或修改（覆盖）
 **涉及文件**：
 - `frontend/src/pages/roster/ContractInfo.tsx:258-289, 300-306`
 - `backend/src/routes/employee.routes.ts:279-294`
 - `backend/src/services/contract.service.ts:713-764`
 **优化方案**：
 1. **下载修复**：
   - 将 data URL 转为 Blob URL 后再触发下载（已有 `dataToBlobUrl` 函数用于预览，下载也应用相同逻辑）
   - 下载按钮改为 `onClick` 事件主动创建 `<a>` 元素并 click，而非依赖 `<a>` 标签的 `download` 属性
   - 或改为调用后端接口下载（后端返回文件流），避免前端处理大 data URL
 2. **禁止删除**：
   - 移除前端删除按钮，改为「作废」按钮（将合同标记为 `VOID` 状态而非物理删除）
   - 后端 `DELETE /contracts/:contractId` 改为 `PATCH /contracts/:contractId/void`，仅更新状态
   - schema 中 `LaborContract` 增加 `status` 字段（`ACTIVE`/`VOID`），作废后不在正常列表展示但保留记录
   - 证据链中保留作废合同记录，标注"已作废"
 3. **允许覆盖**：新增合同时若日期完全相同则提示"已存在相同日期合同，确认覆盖？"（当前是直接报错拒绝）
 ---
 ## 优先级汇总
 | 编号 | 问题 | 优先级 | 模块 |
 |------|------|--------|------|
 | 1 | 花名册身份证号复制乱码 | P0 | 花名册 |
 | 2 | 薪税管理筛选精确到日+创建时间 | P1 | 薪税管理 |
 | 3 | 社保公积金无法创建保存新政策 | P0 | 社保公积金 |
 | 4 | 证据链导出失败 | P0 | 证据链 |
 | 5 | 离职证明模板选择+格式+电子签章 | P0 | 用工办理 |
 | 6 | 用工办理模块功能重复 | P2 | 用工办理 |
 | 7 | 违纪记录签字后下载确认证明 | P0 | 违纪记录 |
 | 8 | 医疗期计算增加其他地区政策 | P2 | 医疗期计算器 |
 | 9 | 绩效考核月度/年度区分+得分等级关联 | P0 | 绩效考核 |
 | 10 | 劳动合同无法下载+不应能删除 | P0 | 花名册 |
 ---
 ## 已确认无需修改
 （暂无）
@@ -0,0 +1,867 @@
 # 20260809 优化需求清单
 > 基于用户反馈整理，共 28 项问题，按模块和优先级分类。
 >
 > **代码审查更新**：2026-08-09 完成全量代码核查，补充实际代码定位和确认结果。
 ---
 ## 一、员工福利模块
 ### 问题1：福利方案创建后无法添加享受人员，批量参保无人员数据
 **模块**：员工福利  
 **优先级**：P0  
 **状态**：待验证
 **现状描述**：
 创建好福利方案后，无法增加享受福利的人员，批量参保时无人员数据可选。
 **代码核查结果**：
 功能实际已实现。`EmployeeBenefits.tsx` 中有完整的批量参保功能：
 - 点击福利方案卡片可展开参保人员列表（`EmployeeBenefits.tsx:228`）
 - 「批量参保」按钮打开 Modal，加载花名册在职员工列表（`:232`）
 - 支持全选/勾选员工，设置生效月份，提交参保（`:395-456`）
 - `rosterApi.list` 查询 `pageSize: 200` 条员工数据（`:78`）
 **潜在问题**：`rosterData` 查询仅在 `showEnrollModal` 为 true 时启用（`enabled: showEnrollModal`），如果员工超过200人则无法全部加载。建议改用不分页的 `allLite` 接口。
 **涉及文件**：
 - `frontend/src/pages/EmployeeBenefits.tsx` 福利方案和批量参保
 - `frontend/src/lib/api-services.ts` benefitApi 定义
 - `backend/src/routes/benefits.routes.ts`
 **优化方案**：
 1. 批量参保的员工列表改用 `allLite` 接口，避免200条限制
 2. 增加按部门筛选功能
 3. 验证实际运行时员工列表是否正常加载
 ---
 ## 二、全局通用问题
 ### 问题2：多个模块中每页条数选择无反应
 **模块**：全局（花名册、薪税、考勤等多个列表页）  
 **优先级**：P1  
 **状态**：待验证
 **现状描述**：
 多个模块列表页底部的「每页条数」选择器点击后无反应，无法切换每页显示条数。
 **代码核查结果**：
 `usePageSize` hook（`frontend/src/hooks/usePageSize.ts:1-18`）通过 `localStorage` 持久化，并通过 `page-size-changed` 自定义事件实现跨页面响应。`Pagination` 组件（`frontend/src/components/ui/Pagination.tsx:44-53`）在 `onPageSizeChange` 时触发回调。
 **疑似问题**：多个列表页在 `onPageSizeChange` 回调中仅调用 `setPage(1)` 但未显式传递新的 `pageSize` 值。例如 `Evidence.tsx:132`：
 ```tsx
 onPageSizeChange={() => setPage(1)}
 ```
 由于 `usePageSize` hook 返回的 `pageSize` 是全局状态，变更后自动触发 queryKey 变化，理论上应该能工作。需实际运行验证事件监听是否在所有页面正确触发重渲染。
 **涉及文件**：
 - `frontend/src/hooks/usePageSize.ts:1-18` 全局 pageSize 状态管理
 - `frontend/src/lib/pageSize.ts:1-21` getPageSize/setPageSize 工具函数
 - `frontend/src/components/ui/Pagination.tsx:44-53` 分页组件
 - `frontend/src/pages/Settings.tsx:15-245` 全局设置页
 - `frontend/src/pages/AuditLog.tsx:118-246` 使用示例
 - `frontend/src/pages/Evidence.tsx:127-133` 疑似问题点
 **优化方案**：
 1. 验证 `usePageSize` 的 `page-size-changed` 事件是否在所有页面正确触发
 2. 确保所有列表页 `onPageSizeChange` 回调中 `setPage(1)` 后 queryKey 包含 `pageSize`
 3. 全局统一分页组件，确保所有列表页行为一致
 ---
 ## 三、离职管理模块
 ### 问题3：离职证明下载内容为乱码
 **模块**：离职管理  
 **优先级**：P0  
 **状态**：待修复
 **现状描述**：
 离职管理中下载的离职证明文件内容是一团乱码，无法正常阅读。
 **问题分析**：
 - `work-process.service.ts` 生成的 `.doc` 文件为纯文本格式，Word 打开时可能出现编码问题
 - 文件下载时 `Content-Type` 和编码声明可能不正确
 - 前端下载方式可能未正确处理二进制流
 **涉及文件**：
 - `backend/src/services/work-process.service.ts:246-290` .doc 文件生成
 - `backend/src/routes/work-process.routes.ts` 下载接口
 - `frontend/src/pages/WorkProcess.tsx` 下载逻辑
 - `frontend/src/pages/Termination.tsx:330-400` 离职管理页面
 **优化方案**：
 1. 在生成的 `.doc` 内容头部添加 BOM 标记（`\uFEFF`），确保 Word 正确识别 UTF-8 编码
 2. 后端下载接口设置正确的 `Content-Type: application/msword; charset=utf-8`
 3. 前端下载时使用 Blob 并指定编码
 4. 考虑生成 HTML 格式的 Word 文件（带 `xmlns:o` 命名空间），确保格式正确
 ---
 ### 问题4：离职管理导出数据缺少筛选条件
 **模块**：离职管理  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 离职管理导出数据时一次性导出全部数据，无法按时间范围等条件筛选导出。
 **问题分析**：
 - 导出接口未接收前端筛选参数，直接查询全部离职记录
 - 前端导出按钮未传递当前筛选条件
 **涉及文件**：
 - `backend/src/routes/export.routes.ts` 导出接口（含 terminations 导出）
 - `backend/src/routes/termination.routes.ts` 离职路由
 - `frontend/src/pages/Termination.tsx:330-400` 导出按钮
 - `frontend/src/lib/api-services.ts:613-696` terminationApi 定义
 **优化方案**：
 1. 导出接口增加 `dateFrom`、`dateTo`、`department`、`status` 等查询参数
 2. 前端导出时携带当前筛选条件
 3. 增加导出确认弹窗，显示筛选范围和预计条数
 ---
 ### 问题5：已提交的离职数据无法撤回，已撤回的无用数据无法删除
 **模块**：离职管理  
 **优先级**：P1  
 **状态**：待修复
 **现状描述**：
 离职管理中已提交的数据无法撤回操作，已撤回的无用数据无法删除清理。
 **代码核查结果**：
 - 后端 `termination.service.ts:256-334` 有 `revokeTermination` 方法，路由 `termination.routes.ts:81-115` 有 `DELETE /:id/revoke` 端点
 - 前端 `api-services.ts:613-696` 有 `revoke` 方法定义
 - **但前端 `Termination.tsx` 页面未暴露撤回和删除草稿的按钮**——UI 缺少对应操作入口
 - 后端有 `cancelTermination`（`termination.service.ts:729-954`）和 `getDrafts` 方法
 **涉及文件**：
 - `backend/src/services/termination.service.ts:256-334` revokeTermination
 - `backend/src/services/termination.service.ts:729-954` cancelTermination, getDrafts
 - `backend/src/routes/termination.routes.ts:81-115` 撤回路由
 - `backend/src/routes/termination.routes.ts:128-234` 草稿管理路由
 - `frontend/src/lib/api-services.ts:613-696` terminationApi.revoke/cancel
 - `frontend/src/pages/Termination.tsx:330-400` **缺少撤回/删除按钮**
 **优化方案**：
 1. 前端 `Termination.tsx` 为已提交但未完成的离职流程增加「撤回」按钮
 2. 已撤回的草稿数据允许删除，增加二次确认
 3. 已完成离职的记录保留不可删除（合规要求）
 ---
 ### 问题6：用工办理中离职/解聘与离职管理模块重复
 **模块**：用工办理 / 离职管理  
 **优先级**：P2  
 **状态**：待优化
 **现状描述**：
 用工办理中有员工离职、解聘功能，同时还有独立的离职管理模块，功能重复，显得混乱。
 **代码核查结果**：
 - `WorkProcess.tsx:37-40` 包含 `TERMINATE`（合同终止）、`RESCIND`（合同解除）、`LEAVING_CERT`（离职证明）等流程类型
 - `Termination.tsx` 是独立的离职管理页面，含草稿管理、审批、执行等完整流程
 - 两个入口功能确实重叠
 **涉及文件**：
 - `frontend/src/pages/WorkProcess.tsx:37-40` 流程类型定义
 - `frontend/src/pages/Termination.tsx:330-400` 离职管理页面
 - `frontend/src/components/layout/SidebarNav.tsx`
 **优化方案**：
 1. 用工办理中保留「入职办理」「转正」「调岗」等入职相关流程
 2. 离职、解聘相关流程统一归入「离职管理」模块
 3. 侧边栏菜单分组明确：用工办理（入职类）→ 离职管理（离职类）
 ---
 ## 四、考勤管理模块
 ### 问题7：考勤导入模板包含无关Sheet，且加班/违纪/考勤三个Sheet需合并
 **模块**：考勤管理  
 **优先级**：P0  
 **状态**：待优化
 **现状描述**：
 导入考勤的模板包含「员工信息」和「劳动合同」两个无关 Sheet，只录入考勤信息无法导入。加班记录、违纪记录、考勤记录三个 Sheet 录入同一人员时需重复粘贴姓名与身份证号，应合并。
 **代码核查结果**：
 - `backend/src/routes/import.routes.ts:494-692` 模板下载接口生成包含：员工信息、劳动合同、考勤记录、加班记录、违纪记录等多个 Sheet
 - `gen_import_sample.py:50-73` Python 脚本也生成了包含多余 Sheet 的示例文件
 - 导入接口 `import.routes.ts` 处理 `考勤记录`、`加班记录`、`违纪记录`、`薪资调整`、`社保变动`、`公积金变动` 等多个 Sheet
 - **确认**：模板确实包含无关的员工信息和劳动合同 Sheet
 **涉及文件**：
 - `backend/src/routes/import.routes.ts:494-692` 模板下载和导入处理
 - `frontend/src/pages/Attendance.tsx:525-610` 前端导入弹窗
 - `gen_import_sample.py:50-73` 示例文件生成脚本
 **优化方案**：
 1. 考勤导入模板只保留考勤相关 Sheet，移除员工信息和劳动合同 Sheet
 2. 将考勤记录、加班记录合并为一个 Sheet，用列区分（日期、班次、签到时间、签退时间、加班时长等）
 3. 违纪记录因字段差异较大，可保留独立 Sheet 或独立导入入口
 4. 每项业务（考勤、加班、违纪）提供独立的专用模板下载
 ---
 ### 问题8：补卡无法修改未打卡状态，签到签退时间显示有问题
 **模块**：考勤管理 - 每日出勤  
 **优先级**：P0  
 **状态**：待修复
 **现状描述**：
 考勤排班中每日出勤页面，操作补卡时无法修改未打卡状态，且签到与签退的时间显示有异常。
 **代码核查结果**：
 - `backend/src/services/attendance.service.ts:264-360` 的 `manualCorrectAttendance` 方法支持更新考勤记录，可设置签到/签退时间和状态
 - `backend/src/routes/attendance.routes.ts:210-233` 有 `POST /manual-correct` 端点
 - `frontend/src/pages/Attendance.tsx:970-1174` 的 DailyTab 有补卡弹窗和按钮
 - `frontend/src/lib/api-services.ts:247-297` 有 `manualCorrect` API 调用
 - 考勤状态常量定义在 `Attendance.tsx:25-33`：NORMAL/LATE/EARLY_LEAVE/ABSENT/LEAVE/BUSINESS_TRIP/UNREGISTERED
 - **需确认**：补卡弹窗是否限制了状态选项（未覆盖 UNREGISTERED→其他状态的修正），以及时间格式化是否有时区问题
 **涉及文件**：
 - `frontend/src/pages/Attendance.tsx:25-33` 状态常量定义
 - `frontend/src/pages/Attendance.tsx:970-1174` DailyTab 补卡弹窗
 - `frontend/src/lib/api-services.ts:247-297` attendanceApi.manualCorrect
 - `backend/src/services/attendance.service.ts:264-360` manualCorrectAttendance
 - `backend/src/routes/attendance.routes.ts:210-233` 补卡路由
 **优化方案**：
 1. 补卡弹窗允许修改所有考勤状态（包括未打卡→已打卡/请假/出差等）
 2. 检查时间字段的时区处理，确保显示本地时间
 3. 签到签退时间统一格式化为 `HH:mm` 格式
 ---
 ### 问题9：加班费计算与考勤不关联，需重复导入
 **模块**：考勤管理 / 薪税管理  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 加班费计算时需要再导入一遍考勤数据，与考勤管理模块的数据不关联。
 **问题分析**：
 - 加班费计算模块可能独立于考勤管理，未从已有的考勤记录中读取加班时长
 - 考勤管理中的加班数据未传递到薪税计算的加班费环节
 **涉及文件**：
 - `frontend/src/pages/money/` 加班费相关组件
 - `backend/src/routes/payroll2.routes.ts` 加班费计算逻辑
 - `backend/src/routes/attendance.routes.ts` 考勤数据查询
 - `backend/src/routes/import.routes.ts` 考勤导入（含加班记录 Sheet）
 **优化方案**：
 1. 加班费计算改为从考勤管理模块读取已确认的加班记录
 2. 薪税批次创建时自动拉取当月考勤加班数据，无需重复导入
 3. 保留手动导入作为备选方案
 ---
 ### 问题10：个人考勤记录添加后加班汇总不显示
 **模块**：考勤管理  
 **优先级**：P1  
 **状态**：待修复
 **现状描述**：
 个人考勤记录添加时手动填写了加班时长，但加班汇总中不显示条数，不清楚加班汇总关联的是哪里。
 **问题分析**：
 - 加班汇总可能统计的是考勤导入的加班数据，而非手动添加的加班时长
 - 加班汇总的数据源与个人考勤记录的加班字段未关联
 **涉及文件**：
 - `frontend/src/pages/Attendance.tsx:970-1174` 加班汇总和考勤记录
 - `backend/src/routes/attendance.routes.ts` 加班统计接口
 **优化方案**：
 1. 加班汇总统计应包含手动添加的考勤记录中的加班时长
 2. 加班汇总增加数据来源标识（导入/手动添加）
 3. 明确加班汇总与考勤记录的关联关系，UI 上增加说明
 ---
 ## 五、证据链模块
 ### 问题11：验证全部完整性功能简陋，无法定位异常
 **模块**：证据链  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 证据链中「验证全部完整性」功能验证后显示异常，但无法告知哪部分异常，下方提醒也无法跳转操作。
 **代码核查结果**：
 - `frontend/src/pages/Evidence.tsx:31-37` 调用 `evidenceApi.verifyAll()`，返回结果仅显示 `total`、`valid`、`invalid` 三个数字（`:60-75`）
 - 无详细异常项列表，无跳转操作
 - `frontend/src/lib/api-services.ts:700-707` `evidenceApi` 定义了 `list` 和 `verifyAll` 方法
 - `frontend/src/pages/roster/EvidenceChain.tsx:1-155` 是员工个人维度的仲裁证据链，展示证据列表、风险提醒和导出功能
 **涉及文件**：
 - `frontend/src/pages/Evidence.tsx:31-75` 验证全部完整性功能
 - `frontend/src/lib/api-services.ts:700-707` evidenceApi 定义
 - `frontend/src/pages/roster/EvidenceChain.tsx:1-155` 员工个人证据链
 - `backend/src/routes/roster.routes.ts` 证据链验证接口
 **优化方案**：
 1. 验证接口返回详细的检查项列表（每项：名称、状态、异常描述）
 2. 前端展示验证结果明细，异常项高亮显示
 3. 每个异常项增加「去处理」跳转按钮，跳转到对应模块
 ---
 ## 六、规章制度管理
 ### 问题12：规章制度签收缺少催办和未签收人员查看
 **模块**：规章制度  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 规章制度向员工公示后，签收只显示签收人数和占比，无法查看具体未签收人员，也无法催办。
 **代码核查结果**：
 - `frontend/src/pages/Policies.tsx:249-285` 有 `ReadStats` 组件，展示签收百分比和未签收人数
 - 已签收人员列表可展开查看（`:278-285`），显示姓名、部门、签收时间
 - **缺少催办通知功能**——无催办按钮
 - **未签收人员列表未展示**——仅显示未签收人数（`:273-277`），未列出具体人员
 - `frontend/src/lib/api-services.ts:674-696` `policiesApi.readStats` 返回 `readCount`、`total`、`unreadCount`、`records`
 - 员工端 `frontend/src/pages/portal/MyPolicies.tsx:36-46` 有阅读确认 mutation 和待签收数量统计
 **涉及文件**：
 - `frontend/src/pages/Policies.tsx:110-120` 签收进度条
 - `frontend/src/pages/Policies.tsx:246-285` ReadStats 组件
 - `frontend/src/lib/api-services.ts:674-696` policiesApi 定义
 - `frontend/src/pages/portal/MyPolicies.tsx:30-50` 员工端阅读确认
 - `backend/src/routes/regulations.routes.ts`
 **优化方案**：
 1. 签收统计增加「查看明细」按钮，展开已签收/未签收人员列表
 2. 未签收人员列表支持「一键催办」，发送通知提醒员工签收
 3. 显示每位员工的签收状态和时间
 ---
 ## 七、文本模板模块
 ### 问题13：新建模板不支持导入文档，现有方式易造成格式混乱
 **模块**：文本模板  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 文本模板新建时只能手动输入内容，无法通过导入 Word 文档创建，现有方式容易造成格式混乱，需要保留导入文档的原始格式。
 **代码核查结果**：
 - `frontend/src/pages/Templates.tsx:303-571` 的 `EnterpriseTemplates` 组件中，新建模板仅支持 `textarea` 手动输入内容（`:493-498`）
 - 模板内容使用 `{{变量名}}` 占位符，支持变量替换渲染
 - 系统模板支持下载 Word（`.doc` 格式），通过 `fetch` 请求 `/templates/:id/download`
 - `frontend/src/lib/api-services.ts:814-839` `templatesApi` 无文档导入接口
 - **确认**：无文档上传入口，不支持导入 `.docx` 文件
 **涉及文件**：
 - `frontend/src/pages/Templates.tsx:1-571` 模板管理页面（系统模板+企业模板）
 - `frontend/src/lib/api-services.ts:814-839` templatesApi 定义
 - `backend/src/routes/templates.routes.ts`
 **优化方案**：
 1. 新建模板增加「导入文档」入口，支持上传 `.docx` 文件
 2. 后端使用 `mammoth` 或类似库解析 Word 文档，保留段落、表格等结构
 3. 导入后转为 HTML 存储模板内容，前端预览时保留格式
 4. 保留现有手动创建方式作为备选
 ---
 ## 八、花名册模块
 ### 问题14：录入工资后社保基数自动取工资数，选择参保地后未自动封上下限
 **模块**：花名册  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 花名册单独录入员工时，社保基数自动取工资数可以，但如果选择参保地，计算时未能自动封上下限。
 **代码核查结果**：
 - `frontend/src/pages/roster/modals.tsx:680-681` 社保基数默认取月工资：`value={form.socialInsBase || form.monthlySalary}`
 - `socialInsuranceApi.cities()` 已获取城市列表（`modals.tsx:493-498`）
 - `socialInsuranceApi.calculate(base, city)` 可计算社保费用（`api-services.ts:510-512`）
 - **确认**：未根据参保城市查询基数上下限进行封顶/封底处理
 - `frontend/src/pages/roster/BasicInfo.tsx:74` 显示社保基数，编辑时为普通输入框（`:344-345`）
 **涉及文件**：
 - `frontend/src/pages/roster/modals.tsx:486-767` AddEmployeeModal 社保基数填充
 - `frontend/src/pages/roster/modals.tsx:235-484` RehireModal 社保基数填充
 - `frontend/src/pages/roster/BasicInfo.tsx:60-120` 编辑表单
 - `frontend/src/lib/api-services.ts:510-520` socialInsuranceApi
 **优化方案**：
 1. 选择参保地后，自动查询该城市的社保基数上下限
 2. 社保基数 = min(max(工资数, 下限), 上限)
 3. 如果工资数在上下限范围内，直接取工资数；否则显示封顶/封底后的值并提示
 ---
 ### 问题15：社保基数手动修改时原有数据不能直接覆盖
 **模块**：花名册  
 **优先级**：P2  
 **状态**：待修复
 **现状描述**：
 社保基数自动取工资后实际不是社保基数时需要手动修改，但修改时原有数据不能删除，必须用鼠标点击选中后再修改，影响录入效率。
 **代码核查结果**：
 - `frontend/src/pages/roster/modals.tsx:681` 使用 `value={form.socialInsBase || form.monthlySalary}`，当 `socialInsBase` 为空时回退到 `monthlySalary`
 - 用户清空输入框时 `socialInsBase` 变为空字符串，又回退到 `monthlySalary`，无法真正清空
 - **缺少 `onFocus={(e) => e.target.select()}` 聚焦全选功能**
 - `BasicInfo.tsx:344-345` 编辑模式下的社保基数输入框为普通 `Input`，无自动回退问题
 **涉及文件**：
 - `frontend/src/pages/roster/modals.tsx:680-681` AddEmployeeModal 社保基数输入框
 - `frontend/src/pages/roster/modals.tsx:397-398` RehireModal 社保基数输入框
 - `frontend/src/pages/roster/BasicInfo.tsx:344-345` 编辑表单社保基数输入框
 **优化方案**：
 1. 社保基数输入框改为受控组件，自动填充后用户可直接输入覆盖
 2. 输入框获得焦点时自动全选当前值，方便直接覆盖
 3. 增加 `onFocus={(e) => e.target.select()}` 实现聚焦全选
 ---
 ### 问题16：录入校验失败未指明具体字段
 **模块**：花名册  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 录入员工时可能是手机号录入有问题，但系统只提示「校验失败」，不指出哪个字段校验失败。
 **代码核查结果**：
 - `backend/src/schemas/contract.schema.ts:3-27` `createEmployeeSchema` 定义了字段级 Zod 校验规则，如 `phone: z.string().regex(/^1[3-9]\d{9}$/)`
 - 前端 `modals.tsx:648-650` 错误处理仅显示通用消息：`{error.response?.data?.error?.message || '操作失败'}`
 - **未解析 Zod 返回的字段级错误信息并在对应字段下方显示**
 - `backend/src/middleware/errorHandler.ts:27-31` P2002 唯一约束错误返回通用"数据已存在，请勿重复操作"
 **涉及文件**：
 - `backend/src/schemas/contract.schema.ts:1-72` Zod 校验 schema 定义
 - `backend/src/middleware/errorHandler.ts:27-31` 错误处理中间件
 - `backend/src/routes/employee.routes.ts:99-126` 创建/更新员工路由
 - `frontend/src/pages/roster/modals.tsx:648-650` AddEmployeeModal 错误提示
 - `frontend/src/pages/roster/BasicInfo.tsx:82-119` 编辑表单错误处理
 **优化方案**：
 1. 后端校验失败时返回具体字段名和错误原因（如 `{"field": "phone", "message": "手机号格式不正确"}`）
 2. 前端解析错误信息，在对应字段下方显示红色提示
 3. toast 提示中包含具体字段名
 ---
 ### 问题17：花名册员工详情中薪税入口意义不明
 **模块**：花名册  
 **优先级**：P2  
 **状态**：待优化
 **现状描述**：
 花名册员工个人详情中的小标识第二个点进去直接进入薪税模块（批次发薪），不理解放在员工个人这里的意义，应该是与此员工有关的个人薪资关联。
 **代码核查结果**：
 - `frontend/src/pages/roster/EmployeeProfile.tsx:66` 中 `payslip` tab 展示 `PayslipSocialInfo`，显示该员工的工资条和社保记录
 - `EmployeeProfileShell.tsx:12-17` 员工 profile 类型定义包含 `position` 字段
 - 需确认是否有跳转到薪税批次列表页的入口
 **涉及文件**：
 - `frontend/src/pages/roster/EmployeeProfile.tsx:60-71` tab 定义
 - `frontend/src/pages/roster/EmployeeProfileShell.tsx:12-17` profile 类型
 - `frontend/src/pages/roster/BasicInfo.tsx` 快捷入口
 **优化方案**：
 1. 改为跳转到该员工的个人薪资历史记录页面
 2. 或在员工详情中增加「薪资历史」标签页，展示该员工所有批次的工资条
 ---
 ### 问题18：花名册列表有职务列，但录入时无职务字段
 **模块**：花名册  
 **优先级**：P1  
 **状态**：待修复
 **现状描述**：
 花名册主页显示有职务这一栏，但单独录入员工时却没有职务这一项。
 **代码核查结果（确认）**：
 - 花名册列表 `Roster.tsx:29` 有 `position` 列（职务），`:500` 有表头，`:560` 有数据渲染
 - `AddEmployeeModal`（`modals.tsx:486-767`）表单中**无 `position` 字段**
 - `BasicInfo.tsx` 编辑表单中也**无 `position` 字段**
 - `createEmployeeSchema`（`contract.schema.ts:3-27`）中**无 `position` 字段**
 - `updateEmployeeSchema`（`contract.schema.ts:29-51`）中也**无 `position` 字段**
 - 后端 `createEmployee`（`contract.service.ts:193-272`）中也**未设置 `position` 字段**
 - **但后端查询时 select 包含 `position`**（`employee.routes.ts:56,82`），说明数据库有此字段
 - `EmployeeProfileShell.tsx:15` 类型定义包含 `position`，`:147-149` 显示 position
 **涉及文件**：
 - `frontend/src/pages/Roster.tsx:29,500,560` 列表显示职务列
 - `frontend/src/pages/roster/modals.tsx:486-767` AddEmployeeModal **缺少 position 字段**
 - `frontend/src/pages/roster/BasicInfo.tsx:60-120` 编辑表单 **缺少 position 字段**
 - `backend/src/schemas/contract.schema.ts:3-51` **缺少 position 字段**
 - `backend/src/services/contract.service.ts:193-272` createEmployee **未设置 position**
 - `backend/src/routes/employee.routes.ts:56,82` 查询时 select 包含 position
 - `frontend/src/pages/roster/EmployeeProfileShell.tsx:15,147-149` profile 显示 position
 **优化方案**：
 1. `AddEmployeeModal` 和 `BasicInfo` 编辑表单增加「职务」字段
 2. `createEmployeeSchema` 和 `updateEmployeeSchema` 增加 `position: z.string().max(50).optional()`
 3. `createEmployee` 和 `updateEmployee` 服务中设置 `position` 字段
 ---
 ### 问题19：花名册中社保费用计算与社保模块不一致
 **模块**：花名册 / 社保管理  
 **优先级**：P1  
 **状态**：待修复
 **现状描述**：
 花名册里员工个人计算的社保费用与社保模块中不一致。社保模块里已修改了养老医保基数不一致，但花名册里计算还是保持一致。
 **代码核查结果**：
 - `BasicInfo.tsx:325-330` 显示社保缴费基数和公积金缴费基数，使用统一基数
 - `BasicInfo.tsx:364-368` 未设置基数时显示警告提示
 - `contract.service.ts:205-206` 创建员工时 `socialInsBase` 和 `housingFundBase` 均默认取 `salaryNum`
 - `api-services.ts:510-512` `socialInsuranceApi.calculate(base, city)` 使用统一 base 计算
 - **确认**：花名册使用统一基数，未读取社保模块中按险种分别配置的基数
 **涉及文件**：
 - `frontend/src/pages/roster/BasicInfo.tsx:320-370` 社保费用显示和编辑
 - `backend/src/services/contract.service.ts:205-206` 创建员工时社保基数设置
 - `frontend/src/lib/api-services.ts:510-520` socialInsuranceApi
 - `backend/src/routes/social.routes.ts` 社保配置查询
 **优化方案**：
 1. 花名册社保费用计算改为读取社保模块中各险种的独立基数和比例
 2. 养老保险用养老基数、医疗保险用医疗基数，分别计算后汇总
 3. 确保两个模块的计算逻辑统一
 ---
 ### 问题20：合同附件PDF/Word不支持在线查看，且无法删除传错的附件
 **模块**：花名册 - 劳动合同  
 **优先级**：P0  
 **状态**：待修复
 **现状描述**：
 劳务合同附件上传了 PDF 后不可以查看，显示没有插件；Word 也不支持在线查看，只有图片格式可以查看。且附件上传之后传错了无法删除，没有删除按钮。
 **代码核查结果**：
 - `ContractInfo.tsx:391-455` 附件预览弹窗实现：
  - **图片**：`<img>` 在线预览 ✅（`:432`）
  - **PDF**：`<embed>` 在线预览 ✅（`:434`）——已支持，非完全缺失
  - **Word/其他**：显示"此文件格式不支持在线预览"，提供下载 ❌（`:436-449`）
 - 附件上传支持格式：`.pdf, .jpg, .jpeg, .png, .heic, .gif, .bmp, .webp, .doc, .docx, .xls, .xlsx, .tiff, .tif`（`:36,106`）
 - **新建合同时**的附件可删除（`:258`）✅
 - **已保存合同的附件无删除按钮**——只有下载按钮（`:335-358`）和补充上传按钮（`:363`）❌
 - 附件以 base64 data URL 存储在 `attachmentUrl` 字段中，预览时转为 blob URL
 **涉及文件**：
 - `frontend/src/pages/roster/ContractInfo.tsx:16-70` 附件上传逻辑
 - `frontend/src/pages/roster/ContractInfo.tsx:258` 新建时删除附件按钮
 - `frontend/src/pages/roster/ContractInfo.tsx:310-370` 已保存合同附件展示（无删除）
 - `frontend/src/pages/roster/ContractInfo.tsx:391-455` 附件预览弹窗
 **优化方案**：
 1. Word 预览：使用 `mammoth.js` 转换为 HTML 在线预览，或提示下载查看
 2. 已保存合同的附件增加删除按钮，删除时二次确认
 3. 后端增加附件删除接口，更新 `attachmentUrl` 字段
 ---
 ### 问题21：用工办理与花名册添加员工功能重复
 **模块**：花名册 / 用工办理  
 **优先级**：P2  
 **状态**：待优化
 **现状描述**：
 花名册可以添加员工，用工办理也可以录入员工，两个模块添加员工有什么区别不清楚。如果都可以添加没有必要，最好固定在一个模块。
 **代码核查结果**：
 - `Roster.tsx` 有 `AddEmployeeModal`（`modals.tsx:486-767`）直接创建员工
 - `WorkProcess.tsx:56-66` 的 `HIRE` 流程类型也创建员工，字段为 `name`、`department`、`idCardNumber` 等 text 输入
 - `WorkProcess.tsx:67-70` 的 `ONBOARD` 流程使用 `employee-select` 选择已有员工
 - 两个入口都调用 `createEmployee`，写入同一张表
 **涉及文件**：
 - `frontend/src/pages/Roster.tsx:70-90` 花名册状态和模态框
 - `frontend/src/pages/roster/modals.tsx:486-767` AddEmployeeModal
 - `frontend/src/pages/WorkProcess.tsx:56-70` HIRE/ONBOARD 流程定义
 - `backend/src/routes/employee.routes.ts:99-126` 创建员工路由
 - `backend/src/services/contract.service.ts:193-272` createEmployee
 **优化方案**：
 1. 统一员工添加入口为「用工办理 → 入职办理」，包含完整入职流程
 2. 花名册保留「查看」和「编辑」功能，移除独立添加入口
 3. 或在花名册添加员工时引导跳转到用工办理的入职流程
 ---
 ### 问题22：用工办理录入中途切换窗口丢失已填信息
 **模块**：用工办理  
 **优先级**：P1  
 **状态**：待修复
 **现状描述**：
 在用工办理里录入员工，录到身份证号处，点开别的文件想粘贴一下，再回去，刚才录入的页面就退出了，需要重新打开重新录前面的信息。
 **代码核查结果**：
 - `frontend/src/components/ui/Modal.tsx:36` 遮罩层 `onClick={onClose}`——**点击遮罩层会关闭弹窗**
 - 无 `closeOnOverlayClick={false}` 配置选项
 - 表单数据未持久化到 `sessionStorage`
 - `AddEmployeeModal`（`modals.tsx:641`）使用了 `useUnsavedChanges(isDirty)` 但仅提示，不阻止关闭
 - `WorkProcess.tsx:204-205` 录入弹窗也使用 `div` + `onClick={onClose}` 模式
 **涉及文件**：
 - `frontend/src/components/ui/Modal.tsx:33-56` Modal 组件（遮罩层 onClick={onClose}）
 - `frontend/src/pages/roster/modals.tsx:641-643` AddEmployeeModal useUnsavedChanges
 - `frontend/src/pages/WorkProcess.tsx:204-205` 录入弹窗
 **优化方案**：
 1. 弹窗设置为 `closeOnOverlayClick={false}`，禁止点击遮罩层关闭
 2. 表单数据持久化到 `sessionStorage`，重新打开时恢复
 3. 关闭前增加「确认关闭？未保存的数据将丢失」提示
 ---
 ### 问题23：用工办理未按身份证号查重
 **模块**：用工办理  
 **优先级**：P1  
 **状态**：待修复
 **现状描述**：
 在花名册录入一个人，在用工办理里录入了一个人但没录入身份证号，不显示重复，不知道是否用身份证查重。
 **代码核查结果**：
 - `createEmployee`（`contract.service.ts:193-272`）**无查重逻辑**——直接创建
 - 数据库依赖 `idCardHash` 唯一约束，重复时抛出 P2002 错误
 - `errorHandler.ts:27-31` P2002 错误返回通用"数据已存在，请勿重复操作"消息
 - 前端 `WorkProcess.tsx` 的 `HIRE` 流程类型使用 `text` 类型字段（`name`、`department` 等），**非 `employee-select`**
 - `INCOME_CERT` 和 `LEAVING_CERT` 也使用 `text` 类型手动输入员工信息（`:107-114, :129-134`）
 - `import.routes.ts:330-333` 导入时有身份证号查重，返回字段级错误信息
 **涉及文件**：
 - `backend/src/services/contract.service.ts:193-272` createEmployee（无查重）
 - `backend/src/middleware/errorHandler.ts:27-31` P2002 错误处理
 - `frontend/src/pages/WorkProcess.tsx:56-66` HIRE 流程字段定义
 - `frontend/src/pages/WorkProcess.tsx:107-114,129-134` 证明开具字段（手动输入）
 - `backend/src/routes/import.routes.ts:330-333` 导入查重（有字段级错误）
 **优化方案**：
 1. 用工办理录入时根据姓名+手机号或身份证号查重
 2. 身份证号为空时用姓名+手机号组合查重
 3. 发现重复时提示「该员工已存在，是否查看/跳转」
 ---
 ## 九、证明开具模块
 ### 问题24：收入证明等应支持员工下拉选择，直接拉取数据
 **模块**：用工办理 - 证明开具  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 开具收入证明或其他证明时，需要手动粘贴员工信息，应该有员工下拉选项直接拉取数据，避免开具非本公司员工的证明。
 **代码核查结果**：
 - `INCOME_CERT`（`WorkProcess.tsx:107-114`）字段为手动输入：`employeeName`（text）、`idCardNumber`（text）、`position`（text）、`monthlyIncome`（text）
 - `LEAVING_CERT`（`:129-134`）同样为手动输入
 - **未使用 `employee-select` 类型**，不关联花名册
 - **但批量开具证明弹窗（`:537-590`）已有员工多选列表**——单条开具时却无下拉选择
 - `WorkProcess.tsx:746-809` 有 `EmployeeSelect` 组件实现，支持搜索和选择员工
 - `WorkProcess.tsx:298-306` 批量提交时从员工数据自动填充 `employeeName`、`idCardNumber`、`position`
 **涉及文件**：
 - `frontend/src/pages/WorkProcess.tsx:107-114` INCOME_CERT 字段定义（手动输入）
 - `frontend/src/pages/WorkProcess.tsx:129-134` LEAVING_CERT 字段定义（手动输入）
 - `frontend/src/pages/WorkProcess.tsx:537-590` 批量开具证明弹窗（有员工选择）
 - `frontend/src/pages/WorkProcess.tsx:746-809` EmployeeSelect 组件
 - `frontend/src/pages/WorkProcess.tsx:298-306` 批量提交自动填充字段
 **优化方案**：
 1. 证明开具表单增加员工下拉选择器，支持姓名/手机号搜索
 2. 选择员工后自动填充身份证号、入职日期、职务、月收入等字段
 3. 只允许选择本公司在职员工
 ---
 ## 十、培训记录模块
 ### 问题25：培训记录只能选择单个员工，不支持批量/按部门
 **模块**：培训记录  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 添加培训记录只能选择一个员工，但实际培训可能是好几个员工一起，也可能是一个部门甚至整个公司。
 **代码核查结果**：
 - `TrainingRecords.tsx:211-220` 员工选择为 `<Select>` 单选下拉框，`employees.map` 渲染选项
 - `AttendanceOvertimeInfo.tsx:79-81` 中的培训记录新增也为单选
 - **不支持多选或按部门批量选择**
 - 表单字段：`employeeId`、`trainingDate`、`topic`、`content`、`trainer`、`duration`、`remark`
 **涉及文件**：
 - `frontend/src/pages/roster/TrainingRecords.tsx:200-267` 培训记录表单（单选员工）
 - `frontend/src/pages/roster/AttendanceOvertimeInfo.tsx:10,79-81` 考勤/培训合并组件
 - `backend/src/routes/employee.routes.ts` 培训记录接口
 **优化方案**：
 1. 员工选择改为多选模式，支持按部门筛选勾选
 2. 增加「按部门添加」和「全公司添加」快捷选项
 3. 批量创建培训记录，每人选一条，共享培训主题/日期/讲师等信息
 ---
 ## 十一、绩效考核模块
 ### 问题26：绩效考核模块过于片面，应支持导入公司自定义考核表
 **模块**：绩效考核  
 **优先级**：P2  
 **状态**：待优化
 **现状描述**：
 绩效考核模块只有简单的得分/等级/评语，每个公司考核类别、评分等差别比较大，现有功能几乎没法用。应支持导入本公司绩效考核表，再进行个人绩效考核统计。
 **代码核查结果**：
 - `PerformanceInfo.tsx:14` 表单仅包含：`period`、`periodType`（月度/季度/年度）、`score`、`grade`（A/B/C/D）、`result`（优秀/合格/需改进/不胜任）、`summary`、`improvementPlan`、`reviewer`、`employeeAck`
 - 得分自动计算等级和结果（`:29-39`）
 - **无自定义考核维度、权重、指标**
 - 不支持导入 Excel 考核表
 **涉及文件**：
 - `frontend/src/pages/roster/PerformanceInfo.tsx:1-118` 绩效考核完整组件
 - `backend/src/routes/employee.routes.ts` 绩效记录接口
 - `backend/prisma/schema.prisma` PerformanceRecord 模型
 **优化方案**：
 1. 增加「绩效模板」管理，支持定义考核维度、权重、评分标准
 2. 支持导入 Excel 考核表作为模板
 3. 绩效考核时按模板填写各维度得分，系统按权重计算总分
 4. 保留现有简单模式作为默认，自定义模板作为高级功能
 ---
 ## 十二、考勤导入流程
 ### 问题27：考勤模板 Sheet 过多，导入后无法确认数据
 **模块**：考勤管理  
 **优先级**：P0  
 **状态**：待优化
 **现状描述**：
 考勤管理下载模板时模板包含太多无关 Sheet，需要都删除后再导入。而且导入后提示导入成功，但找不到从哪里确认数据。
 **代码核查结果**：
 - 与问题7相关，`import.routes.ts:494-692` 模板包含多个无关 Sheet
 - `Attendance.tsx:525-610` 导入弹窗显示导入结果（成功数、跳过数、错误），**但无跳转到考勤确认页面的链接**
 - 导入成功后仅 toast 提示，无自动跳转
 **涉及文件**：
 - `backend/src/routes/import.routes.ts:494-692` 模板下载
 - `frontend/src/pages/Attendance.tsx:525-610` 前端导入弹窗
 - `frontend/src/pages/attendance/AttendanceConfirm.tsx` 考勤确认页面
 **优化方案**：
 1. 模板精简为单个考勤 Sheet（与问题7统一处理）
 2. 导入成功后 toast 提示中增加「点击查看」跳转链接
 3. 导入成功后自动跳转到考勤确认页面
 ---
 ## 十三、加班费计算
 ### 问题28：加班费计算需重复导入考勤数据
 **模块**：薪税管理 / 考勤管理  
 **优先级**：P1  
 **状态**：待优化
 **现状描述**：
 加班费计算跟考勤不关联，到加班费计算时还需要再导入一遍考勤。
 **问题分析**：
 - 与问题9相同，加班费计算模块独立于考勤管理
 - 考勤管理中已确认的加班数据未传递到薪税计算
 **涉及文件**：
 - `frontend/src/pages/money/` 加班费相关
 - `backend/src/routes/payroll2.routes.ts`
 - `backend/src/routes/import.routes.ts` 考勤导入（含加班记录 Sheet）
 - `backend/src/routes/attendance.routes.ts` 考勤数据查询
 **优化方案**：
 1. 与问题9统一处理：加班费从考勤管理读取已确认的加班记录
 2. 薪税批次创建时自动拉取当月加班数据
 ---
 ## 优先级汇总
 | 优先级 | 编号 | 问题 |
 |--------|------|------|
 | P0 | 1 | 福利方案无法添加人员 | 功能已实现，pageSize 200 条限制待优化 |
 | P0 | 3 | 离职证明下载乱码 | 待修复 |
 | P0 | 7 | 考勤导入模板无关Sheet+合并 | 确认：模板含员工信息/劳动合同等无关Sheet |
 | P0 | 8 | 补卡无法修改状态+时间显示异常 | 后端支持，需确认前端弹窗状态限制 |
 | P0 | 20 | 合同附件PDF/Word不支持查看+无法删除 | PDF已支持预览，Word不支持，已保存附件无法删除 |
 | P0 | 27 | 考勤模板Sheet过多+导入后无法确认 | 确认：无导入后跳转引导 |
 | P1 | 2 | 每页条数选择无反应 | 需验证usePageSize事件触发 |
 | P1 | 4 | 离职导出缺少筛选条件 | 确认：导出未传筛选参数 |
 | P1 | 5 | 已提交离职无法撤回+已撤回无法删除 | 后端有revoke接口，前端UI未暴露 |
 | P1 | 9 | 加班费与考勤不关联 | 确认：独立模块 |
 | P1 | 10 | 加班汇总不显示手动添加的加班 | 确认：数据源未关联 |
 | P1 | 11 | 证据链验证无法定位异常 | 确认：仅显示汇总数字 |
 | P1 | 12 | 规章制度签收缺少催办和明细 | 确认：无催办按钮，未签收人员未列出 |
 | P1 | 13 | 文本模板不支持导入文档 | 确认：仅textarea输入 |
 | P1 | 14 | 社保基数选择参保地后未封上下限 | 确认：未查询城市上下限 |
 | P1 | 16 | 校验失败未指明具体字段 | 确认：仅显示通用错误 |
 | P1 | 17 | 员工详情薪税入口意义不明 | 需进一步确认 |
 | P1 | 18 | 录入时缺少职务字段 | **确认：前后端均缺失position字段** |
 | P1 | 19 | 花名册社保计算与社保模块不一致 | 确认：使用统一基数 |
 | P1 | 22 | 用工办理录入中途切换窗口丢失数据 | 确认：遮罩层点击关闭，无持久化 |
 | P1 | 23 | 用工办理未按身份证号查重 | 确认：无查重逻辑，仅依赖DB唯一约束 |
 | P1 | 24 | 证明开具不支持员工下拉选择 | 确认：手动输入，批量开具有选择器 |
 | P1 | 25 | 培训记录不支持批量选择员工 | 确认：单选下拉框 |
 | P1 | 28 | 加班费需重复导入考勤 | 与问题9相同 |
 | P2 | 6 | 用工办理与离职管理功能重复 | 确认 |
 | P2 | 15 | 社保基数修改不能直接覆盖 | 确认：value回退问题 |
 | P2 | 21 | 花名册与用工办理添加员工重复 | 确认 |
 | P2 | 26 | 绩效考核模块过于片面 | 确认：固定字段，无自定义 |
@@ -0,0 +1,208 @@
 # 2026年8月11日 优化需求清单
 > 用户反馈共 16 项问题，按模块和优先级整理如下。
 ---
 ## 一、花名册 / 员工详情模块
 ### 问题1：绩效考核点击员工姓名跳转首页
 **模块**：花名册 → 绩效考核  
 **优先级**：P1  
 **现象**：在绩效考核列表中点击员工姓名，系统自动跳转到首页，无法进入员工详情页。  
 **可能原因**：员工详情页的路由跳转参数缺失或未正确绑定 onClick 事件。  
 **优化方案**：检查绩效考核列表中员工姓名的点击事件，确保正确跳转到员工详情页（携带 employeeId 参数）。
 ---
 ### 问题3：培训记录点击员工姓名跳转首页
 **模块**：花名册 → 培训记录  
 **优先级**：P1  
 **现象**：在培训记录列表中点击员工姓名，系统自动跳转到首页，无法进入员工详情页。  
 **可能原因**：与问题1相同，员工姓名点击事件未正确绑定跳转逻辑。  
 **优化方案**：检查培训记录列表中员工姓名的点击事件，确保正确跳转到员工详情页。
 ---
 ### 问题14：特殊员工无法点击详情查看
 **模块**：花名册 → 特殊员工  
 **优先级**：P1  
 **现象**：特殊员工列表中只有编辑和删除按钮，无法点击查看员工详情。  
 **优化方案**：为特殊员工列表行添加点击查看详情功能，或增加"查看"按钮。
 ---
 ## 二、离职管理模块
 ### 问题2：离职证明模板是否可自定义，支持员工端下载带印章版本
 **模块**：离职管理  
 **优先级**：P1  
 **现象**：当前离职证明为固定模板，无法自定义修改。用户希望：  
 1. 离职证明模板可自定义或修改  
 2. 员工可通过小程序（员工端）下载带有企业电子印章的离职证明  
 **优化方案**：  
 - 后端：支持离职证明模板配置（复用文本模板模块，支持变量占位符）  
 - 前端：离职管理中可选择/编辑离职证明模板  
 - 员工端：已完成离职的员工可在线查看和下载离职证明（含电子印章）
 ---
 ## 三、薪税管理模块
 ### 问题4：工资填写后数据自动归零
 **模块**：薪税管理  
 **优先级**：P0  
 **现象**：在薪税管理中选择一个员工生成工资，进入工资填写页面后录入数据，数据自动返回到 0。  
 **可能原因**：工资条编辑表单的状态管理问题，输入值未正确保存到 state，或被计算逻辑覆盖。  
 **优化方案**：检查工资条编辑表单的 onChange 和 onBlur 逻辑，确保手动输入的值不被自动计算覆盖。
 ---
 ## 四、社保公积金模块
 ### 问题5：社保公积金模块添加员工参保信息列表
 **模块**：社保公积金  
 **优先级**：P1  
 **现象**：社保公积金模块缺少员工参保信息列表，无法查看各员工各险种的参保状态和参保基数。  
 **优化方案**：  
 - 社保公积金模块新增"员工参保列表"标签页  
 - 列表显示：员工姓名、部门、参保城市、各险种参保状态（已参保/未参保/停缴）、缴费基数（养老/医疗/失业/工伤/生育）、公积金基数  
 - 支持按参保状态、城市筛选
 ---
 ## 五、商业保险模块
 ### 问题6：商业保险添加参保方案后无法为员工参保
 **模块**：商业保险  
 **优先级**：P0  
 **现象**：商业保险模块添加了保险方案后，找不到为员工添加参保信息的入口。  
 **优化方案**：  
 - 在保险方案详情或列表中增加"为员工参保"按钮  
 - 支持批量选择员工参保  
 - 参保后显示参保人员列表
 ---
 ## 六、员工福利模块
 ### 问题7：员工福利添加方案后不知从何处为员工添加福利
 **模块**：员工福利  
 **优先级**：P0  
 **现象**：员工福利模块添加福利方案后，找不到为员工添加该项福利的入口。  
 **优化方案**：  
 - 在福利方案详情或列表中增加"为员工添加福利"按钮  
 - 支持批量选择员工  
 - 添加后显示享受人员列表
 ---
 ### 问题15：员工福利新增方案后员工汇总不显示，月度合计为0
 **模块**：员工福利  
 **优先级**：P1  
 **现象**：新增福利方案并添加员工后，员工汇总中没有显示该福利，月度合计仍为 0。  
 **可能原因**：福利汇总统计逻辑未包含新增方案的金额，或汇总查询条件未关联到新增方案。  
 **优化方案**：检查福利汇总统计的查询逻辑，确保所有有效福利方案均纳入月度合计计算。
 ---
 ## 七、规章制度管理模块
 ### 问题8：新建规章制度无法进行文本或文档导入
 **模块**：规章制度  
 **优先级**：P1  
 **现象**：新建规章制度时，只能手动输入正文内容，无法导入 Word 文档或富文本。  
 **优化方案**：  
 - 规章制度编辑器增加"导入 Word 文档"功能（复用文本模板模块的 mammoth 导入方案）  
 - 支持 .docx 格式文档导入并自动转为 HTML  
 ---
 ## 八、文本模板模块
 ### 问题9：下载的 Word 文档毫无格式
 **模块**：文本模板  
 **优先级**：P1  
 **现象**：文本模板下载的 Word 文档没有格式，段落、标题、间距等全部丢失，需要手动调整。  
 **可能原因**：当前下载方式可能是纯文本写入 .doc 文件，未使用 Word HTML 格式或样式定义。  
 **优化方案**：  
 - 下载的 Word 文档使用完整的 Word HTML 格式（含 style 定义）  
 - 保留标题、段落间距、字体大小、对齐方式等格式  
 - 参考离职证明下载的 Word HTML 方案
 ---
 ### 问题10：无固定期限劳动合同模板下载后不含员工信息
 **模块**：文本模板  
 **优先级**：P1  
 **现象**：使用"无固定期限劳动合同"模板，已填写了变量占位符，但下载的 Word 文档中变量未被替换为实际员工信息。  
 **可能原因**：下载时未对模板内容进行变量替换处理，直接输出了原始模板。  
 **优化方案**：  
 - 下载 Word 文档时自动替换模板中的变量占位符（如 {{name}}、{{idCardNumber}} 等）  
 - 如果是从员工详情页发起下载，自动填充该员工的信息  
 - 如果是预览下载，提示用户填写变量或选择关联员工
 ---
 ## 九、电子签署模块
 ### 问题11：发起签署时选择员工没有选项
 **模块**：电子签署  
 **优先级**：P0  
 **现象**：电子签署中发起签署时，选择员工的下拉框为空，没有任何选项。  
 **可能原因**：员工列表查询接口未调用或返回数据为空，或下拉框数据绑定逻辑有误。  
 **优化方案**：检查电子签署发起页面中员工列表的数据获取逻辑，确保正确加载在职员工列表。
 ---
 ## 十、绩效考核模块
 ### 问题12：新增绩效记录没有编辑考评人的选项
 **模块**：绩效考核  
 **优先级**：P2  
 **现象**：绩效考核新增记录时，表单中没有考评人（考核人）的输入字段。  
 **优化方案**：在绩效记录新增表单中增加"考评人"输入框（已有 reviewer 字段，需确认前端是否显示）。
 ---
 ## 十一、违纪记录模块
 ### 问题13：违纪记录缺少处罚执行细节
 **模块**：违纪记录  
 **优先级**：P2  
 **现象**：违纪记录只有删除功能，缺少处罚执行的具体管理。用户希望支持：  
 1. 处罚类型为扣款/降职时，区分一次性处罚还是持续处罚（如罚一个月后恢复）  
 2. 停薪留职时，可设定留职时间段或灵活安排结束时间  
 **优化方案**：  
 - 违纪记录新增"处罚执行"字段：处罚方式（一次性/持续性）、处罚开始日期、处罚结束日期、处罚金额/降职后岗位  
 - 停薪留职支持设定预计结束日期，到期后提醒确认是否恢复  
 - 违纪记录列表增加处罚状态列（执行中/已结束/已恢复）
 ---
 ## 十二、合规模块
 ### 问题16：证据链验证完整性全部失败
 **模块**：合规 → 证据链  
 **优先级**：P0  
 **现象**：合规模块中证据链验证完整性，所有验证项全部失败。  
 **可能原因**：  
 1. 证据链哈希计算逻辑与存储时的哈希不一致（如排序规则、拼接顺序变化）  
 2. 历史数据在升级过程中哈希规则变更，导致旧数据全部校验失败  
 3. orgId 或其他参与哈希计算的参数发生变化  
 **优化方案**：  
 - 检查 verifyAllEvidence 中的哈希计算逻辑，对比存储时的哈希生成逻辑  
 - 如果是哈希规则变更导致，提供"重新生成哈希"功能（仅管理员可用）  
 - 排查是否有数据迁移或 orgId 变更导致的不一致
 ---
 ## 汇总
 | 优先级 | 数量 | 问题编号 |
 |--------|------|----------|
 | P0 | 5 | 4, 6, 7, 11, 16 |
 | P1 | 7 | 1, 2, 3, 5, 8, 9, 10, 15 |
 | P2 | 2 | 12, 13 |
 | 待确认 | 1 | 14 |
 | **合计** | **16** | |
@@ -4,7 +4,7 @@
    <meta charset="UTF-8" />
    <link rel="icon" type="image/svg+xml" href="/favicon.svg" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0, viewport-fit=cover" />
-    <title>企业用工专家</title>
+    <title>安职通</title>
  </head>
  <body>
    <div id="root"></div>
@@ -16,6 +16,7 @@
        "file-saver": "^2.0.5",
        "jspdf": "^4.2.1",
        "lucide-react": "^0.428.0",
        "mammoth": "^1.12.1",
        "qrcode.react": "^4.0.1",
        "react": "^18.3.1",
        "react-dom": "^18.3.1",
@@ -1590,6 +1591,15 @@
        "vite": "^4.2.0 || ^5.0.0 || ^6.0.0 || ^7.0.0"
      }
    },
    "node_modules/@xmldom/xmldom": {
      "version": "0.8.13",
      "resolved": "https://registry.npmmirror.com/@xmldom/xmldom/-/xmldom-0.8.13.tgz",
      "integrity": "sha512-KRYzxepc14G/CEpEGc3Yn+JKaAeT63smlDr+vjB8jRfgTBBI9wRj/nkQEO+ucV8p8I9bfKLWp37uHgFrbntPvw==",
      "license": "MIT",
      "engines": {
        "node": ">=10.0.0"
      }
    },
    "node_modules/adler-32": {
      "version": "1.3.1",
      "resolved": "https://registry.npmmirror.com/adler-32/-/adler-32-1.3.1.tgz",
@@ -1639,6 +1649,15 @@
      "dev": true,
      "license": "MIT"
    },
    "node_modules/argparse": {
      "version": "1.0.10",
      "resolved": "https://registry.npmmirror.com/argparse/-/argparse-1.0.10.tgz",
      "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
      "license": "MIT",
      "dependencies": {
        "sprintf-js": "~1.0.2"
      }
    },
    "node_modules/asynckit": {
      "version": "0.4.0",
      "resolved": "https://registry.npmmirror.com/asynckit/-/asynckit-0.4.0.tgz",
@@ -1714,6 +1733,26 @@
        "node": ">= 0.6.0"
      }
    },
    "node_modules/base64-js": {
      "version": "1.5.1",
      "resolved": "https://registry.npmmirror.com/base64-js/-/base64-js-1.5.1.tgz",
      "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==",
      "funding": [
        {
          "type": "github",
          "url": "https://github.com/sponsors/feross"
        },
        {
          "type": "patreon",
          "url": "https://www.patreon.com/feross"
        },
        {
          "type": "consulting",
          "url": "https://feross.org/support"
        }
      ],
      "license": "MIT"
    },
    "node_modules/baseline-browser-mapping": {
      "version": "2.11.1",
      "resolved": "https://registry.npmmirror.com/baseline-browser-mapping/-/baseline-browser-mapping-2.11.1.tgz",
@@ -1740,6 +1779,12 @@
        "url": "https://github.com/sponsors/sindresorhus"
      }
    },
    "node_modules/bluebird": {
      "version": "3.4.7",
      "resolved": "https://registry.npmmirror.com/bluebird/-/bluebird-3.4.7.tgz",
      "integrity": "sha512-iD3898SR7sWVRHbiQv+sHUtHnMvC1o3nW5rAcqnq3uOn07DSAppZYUkIGslDz6gXC7HfunPe7YVBgoEJASPcHA==",
      "license": "MIT"
    },
    "node_modules/braces": {
      "version": "3.0.3",
      "resolved": "https://registry.npmmirror.com/braces/-/braces-3.0.3.tgz",
@@ -2263,6 +2308,12 @@
      "dev": true,
      "license": "Apache-2.0"
    },
    "node_modules/dingbat-to-unicode": {
      "version": "1.0.1",
      "resolved": "https://registry.npmmirror.com/dingbat-to-unicode/-/dingbat-to-unicode-1.0.1.tgz",
      "integrity": "sha512-98l0sW87ZT58pU4i61wa2OHwxbiYSbuxsCBozaVnYX2iCnr3bLM3fIes1/ej7h1YdOKuKt/MLs706TVnALA65w==",
      "license": "BSD-2-Clause"
    },
    "node_modules/dlv": {
      "version": "1.1.3",
      "resolved": "https://registry.npmmirror.com/dlv/-/dlv-1.1.3.tgz",
@@ -2330,6 +2381,15 @@
        "@types/trusted-types": "^2.0.7"
      }
    },
    "node_modules/duck": {
      "version": "0.1.12",
      "resolved": "https://registry.npmmirror.com/duck/-/duck-0.1.12.tgz",
      "integrity": "sha512-wkctla1O6VfP89gQ+J/yDesM0S7B7XLXjKGzXxMDVFg7uEn706niAtyYovKbyq1oT9YwDcly721/iUWoc8MVRg==",
      "license": "BSD",
      "dependencies": {
        "underscore": "^1.13.1"
      }
    },
    "node_modules/dunder-proto": {
      "version": "1.0.1",
      "resolved": "https://registry.npmmirror.com/dunder-proto/-/dunder-proto-1.0.1.tgz",
@@ -3257,6 +3317,17 @@
        "loose-envify": "cli.js"
      }
    },
    "node_modules/lop": {
      "version": "0.4.2",
      "resolved": "https://registry.npmmirror.com/lop/-/lop-0.4.2.tgz",
      "integrity": "sha512-RefILVDQ4DKoRZsJ4Pj22TxE3omDO47yFpkIBoDKzkqPRISs5U1cnAdg/5583YPkWPaLIYHOKRMQSvjFsO26cw==",
      "license": "BSD-2-Clause",
      "dependencies": {
        "duck": "^0.1.12",
        "option": "~0.2.1",
        "underscore": "^1.13.1"
      }
    },
    "node_modules/lru-cache": {
      "version": "5.1.1",
      "resolved": "https://registry.npmmirror.com/lru-cache/-/lru-cache-5.1.1.tgz",
@@ -3276,6 +3347,30 @@
        "react": "^16.5.1 || ^17.0.0 || ^18.0.0 || ^19.0.0-rc"
      }
    },
    "node_modules/mammoth": {
      "version": "1.12.1",
      "resolved": "https://registry.npmmirror.com/mammoth/-/mammoth-1.12.1.tgz",
      "integrity": "sha512-nCH9KKjWi3jQ+i8bUKs7k1yrXtSEGpWgF8IYkzsFMcbn+5S6l4bZEBbyx2hOQErFiXPuAs9RPa6qjXVxhyx/8g==",
      "license": "BSD-2-Clause",
      "dependencies": {
        "@xmldom/xmldom": "^0.8.6",
        "argparse": "~1.0.3",
        "base64-js": "^1.5.1",
        "bluebird": "~3.4.0",
        "dingbat-to-unicode": "^1.0.1",
        "jszip": "^3.7.1",
        "lop": "^0.4.2",
        "path-is-absolute": "^1.0.0",
        "underscore": "^1.13.1",
        "xmlbuilder": "^10.0.0"
      },
      "bin": {
        "mammoth": "bin/mammoth"
      },
      "engines": {
        "node": ">=12.0.0"
      }
    },
    "node_modules/markdown-table": {
      "version": "3.0.4",
      "resolved": "https://registry.npmmirror.com/markdown-table/-/markdown-table-3.0.4.tgz",
@@ -4256,6 +4351,12 @@
        "node": ">= 6"
      }
    },
    "node_modules/option": {
      "version": "0.2.4",
      "resolved": "https://registry.npmmirror.com/option/-/option-0.2.4.tgz",
      "integrity": "sha512-pkEqbDyl8ou5cpq+VsnQbe/WlEy5qS7xPzMS1U55OCG9KPvwFD46zDbxQIj3egJSFc3D+XhYOPUzz49zQAVy7A==",
      "license": "BSD-2-Clause"
    },
    "node_modules/pako": {
      "version": "2.2.0",
      "resolved": "https://registry.npmmirror.com/pako/-/pako-2.2.0.tgz",
@@ -4309,6 +4410,15 @@
        "url": "https://github.com/inikulin/parse5?sponsor=1"
      }
    },
    "node_modules/path-is-absolute": {
      "version": "1.0.1",
      "resolved": "https://registry.npmmirror.com/path-is-absolute/-/path-is-absolute-1.0.1.tgz",
      "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==",
      "license": "MIT",
      "engines": {
        "node": ">=0.10.0"
      }
    },
    "node_modules/path-parse": {
      "version": "1.0.7",
      "resolved": "https://registry.npmmirror.com/path-parse/-/path-parse-1.0.7.tgz",
@@ -5090,6 +5200,12 @@
        "url": "https://github.com/sponsors/wooorm"
      }
    },
    "node_modules/sprintf-js": {
      "version": "1.0.3",
      "resolved": "https://registry.npmmirror.com/sprintf-js/-/sprintf-js-1.0.3.tgz",
      "integrity": "sha512-D9cPgkvLlV3t3IzL0D0YLvGA9Ahk4PcvVwUbN0dSGr1aP0Nrt4AEnTUbuGvquEC0mA64Gqt1fzirlRs5ibXx8g==",
      "license": "BSD-3-Clause"
    },
    "node_modules/ssf": {
      "version": "0.11.2",
      "resolved": "https://registry.npmmirror.com/ssf/-/ssf-0.11.2.tgz",
@@ -5378,6 +5494,12 @@
        "node": ">=14.17"
      }
    },
    "node_modules/underscore": {
      "version": "1.13.8",
      "resolved": "https://registry.npmmirror.com/underscore/-/underscore-1.13.8.tgz",
      "integrity": "sha512-DXtD3ZtEQzc7M8m4cXotyHR+FAS18C64asBYY5vqZexfYryNNnDc02W4hKg3rdQuqOYas1jkseX0+nZXjTXnvQ==",
      "license": "MIT"
    },
    "node_modules/undici-types": {
      "version": "8.3.0",
      "resolved": "https://registry.npmmirror.com/undici-types/-/undici-types-8.3.0.tgz",
@@ -5719,6 +5841,15 @@
        "xml-js": "bin/cli.js"
      }
    },
    "node_modules/xmlbuilder": {
      "version": "10.1.1",
      "resolved": "https://registry.npmmirror.com/xmlbuilder/-/xmlbuilder-10.1.1.tgz",
      "integrity": "sha512-OyzrcFLL/nb6fMGHbiRDuPup9ljBycsdCypwuyg5AAHvyWzGfChJpCXMG88AGTIMFhGZ9RccFN1e6lhg3hkwKg==",
      "license": "MIT",
      "engines": {
        "node": ">=4.0"
      }
    },
    "node_modules/yallist": {
      "version": "3.1.1",
      "resolved": "https://registry.npmmirror.com/yallist/-/yallist-3.1.1.tgz",
@@ -17,6 +17,7 @@
    "file-saver": "^2.0.5",
    "jspdf": "^4.2.1",
    "lucide-react": "^0.428.0",
    "mammoth": "^1.12.1",
    "qrcode.react": "^4.0.1",
    "react": "^18.3.1",
    "react-dom": "^18.3.1",
@@ -6,7 +6,7 @@
 <meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">
 <meta http-equiv="Pragma" content="no-cache">
 <meta http-equiv="Expires" content="0">
-<title>TurboHR 验收测试清单</title>
+<title>安职通 验收测试清单</title>
 <style>
 :root {
  --primary: #4f46e5;
@@ -280,7 +280,7 @@ body {
 <!-- Header -->
 <div class="header">
-  <h1>TurboHR 验收测试清单</h1>
+  <h1>安职通 验收测试清单</h1>
  <div class="verifier-section">
    <label>验收人：</label>
    <div class="autocomplete-wrap">
@@ -5,6 +5,7 @@ import { useAuthStore } from './store/authStore'
 import TopNav from './components/layout/TopNav'
 import SidebarNav from './components/layout/SidebarNav'
 import MobileTabBar from './components/layout/MobileTabBar'
 import OnboardingGuide from './components/OnboardingGuide'
 import PortalLayout from './components/layout/PortalLayout'
 import PageContainer from './components/layout/PageContainer'
 import { CommandPalette } from './components/ui/CommandPalette'
@@ -18,6 +19,8 @@ const Dashboard = lazy(() => import('./pages/Dashboard'))
 const Money = lazy(() => import('./pages/Money'))
 const SocialInsurance = lazy(() => import('./pages/SocialInsurance'))
 const Roster = lazy(() => import('./pages/Roster'))
 const OrgChart = lazy(() => import('./pages/OrgChart'))
 const SupportDashboard = lazy(() => import('./pages/support/SupportDashboard'))
 const Termination = lazy(() => import('./pages/Termination'))
 const AIAssistant = lazy(() => import('./pages/AIAssistant'))
 const Settings = lazy(() => import('./pages/Settings'))
@@ -38,19 +41,27 @@ const MedicalPeriodCalculator = lazy(() => import('./pages/tools/MedicalPeriodCa
 const HealthCheck = lazy(() => import('./pages/tools/HealthCheck'))
 const AnnualValueReport = lazy(() => import('./pages/tools/AnnualValueReport'))
 const CalendarPage = lazy(() => import('./pages/Calendar'))
 const WorkProcess = lazy(() => import('./pages/WorkProcess'))
 const MyAttendance = lazy(() => import('./pages/portal/MyAttendance'))
 const MyLeave = lazy(() => import('./pages/portal/MyLeave'))
 const SpecialStatus = lazy(() => import('./pages/SpecialStatus'))
 const CompanyFiles = lazy(() => import('./pages/CompanyFiles'))
 const LeaveApproval = lazy(() => import('./pages/LeaveApproval'))
 const TrainingRecords = lazy(() => import('./pages/roster/TrainingRecords'))
 const PerformanceRecords = lazy(() => import('./pages/roster/PerformanceRecords'))
 const DisciplinaryRecords = lazy(() => import('./pages/roster/DisciplinaryRecords'))
 // Sprint 4-5 新增页面
 const EmployeeHome = lazy(() => import('./pages/portal/EmployeeHome'))
 const OnboardingProgress = lazy(() => import('./pages/portal/OnboardingProgress'))
 const ResignationApply = lazy(() => import('./pages/portal/ResignationApply'))
 const MyEsign = lazy(() => import('./pages/portal/MyEsign'))
 const MyRecords = lazy(() => import('./pages/portal/MyRecords'))
 const RiskCenter = lazy(() => import('./pages/compliance/RiskCenter'))
 const SalaryDashboard = lazy(() => import('./pages/SalaryDashboard'))
 const CommercialInsurance = lazy(() => import('./pages/CommercialInsurance'))
 const EmployeeBenefits = lazy(() => import('./pages/EmployeeBenefits'))
 const ESign = lazy(() => import('./pages/ESign'))
 const CommissionBonus = lazy(() => import('./pages/CommissionBonus'))
 // 平台管理端
 const PlatformLogin = lazy(() => import('./pages/platform/PlatformLogin'))
@@ -87,6 +98,7 @@ function AdminLayout({ children }: { children: React.ReactNode }) {
        </main>
        <MobileTabBar />
      </div>
      <OnboardingGuide />
    </div>
  )
 }
@@ -175,6 +187,8 @@ export default function App() {
      {/* 管理端业务页面 */}
      <Route path="/" element={<ProtectedRoute><AdminLayout><Dashboard /></AdminLayout></ProtectedRoute>} />
      <Route path="/roster" element={<ProtectedRoute><AdminLayout><Roster /></AdminLayout></ProtectedRoute>} />
      <Route path="/org-chart" element={<ProtectedRoute><AdminLayout><OrgChart /></AdminLayout></ProtectedRoute>} />
      <Route path="/support" element={<ProtectedRoute><AdminLayout><SupportDashboard /></AdminLayout></ProtectedRoute>} />
      <Route path="/money" element={<ProtectedRoute><AdminLayout><Money /></AdminLayout></ProtectedRoute>} />
      <Route path="/social" element={<ProtectedRoute><AdminLayout><SocialInsurance /></AdminLayout></ProtectedRoute>} />
      <Route path="/termination" element={<ProtectedRoute><AdminLayout><Termination /></AdminLayout></ProtectedRoute>} />
@@ -190,12 +204,18 @@ export default function App() {
      <Route path="/tools/medical-period" element={<ProtectedRoute><AdminLayout><MedicalPeriodCalculator /></AdminLayout></ProtectedRoute>} />
      <Route path="/tools/health-check" element={<ProtectedRoute><AdminLayout><HealthCheck /></AdminLayout></ProtectedRoute>} />
      <Route path="/tools/annual-value" element={<ProtectedRoute><AdminLayout><AnnualValueReport /></AdminLayout></ProtectedRoute>} />
      <Route path="/work-process" element={<ProtectedRoute><AdminLayout><WorkProcess /></AdminLayout></ProtectedRoute>} />
      <Route path="/special-status" element={<ProtectedRoute><AdminLayout><SpecialStatus /></AdminLayout></ProtectedRoute>} />
      <Route path="/commission-bonus" element={<ProtectedRoute><AdminLayout><CommissionBonus /></AdminLayout></ProtectedRoute>} />
      <Route path="/company-files" element={<ProtectedRoute><AdminLayout><CompanyFiles /></AdminLayout></ProtectedRoute>} />
      <Route path="/leave-approval" element={<ProtectedRoute><AdminLayout><LeaveApproval /></AdminLayout></ProtectedRoute>} />
      <Route path="/training-records" element={<ProtectedRoute><AdminLayout><TrainingRecords /></AdminLayout></ProtectedRoute>} />
      <Route path="/performance-records" element={<ProtectedRoute><AdminLayout><PerformanceRecords /></AdminLayout></ProtectedRoute>} />
      <Route path="/disciplinary-records" element={<ProtectedRoute><AdminLayout><DisciplinaryRecords /></AdminLayout></ProtectedRoute>} />
      <Route path="/risk-center" element={<ProtectedRoute><AdminLayout><RiskCenter /></AdminLayout></ProtectedRoute>} />
      <Route path="/salary-dashboard" element={<ProtectedRoute><AdminLayout><SalaryDashboard /></AdminLayout></ProtectedRoute>} />
      <Route path="/commercial-insurance" element={<ProtectedRoute><AdminLayout><CommercialInsurance /></AdminLayout></ProtectedRoute>} />
      <Route path="/benefits" element={<ProtectedRoute><AdminLayout><EmployeeBenefits /></AdminLayout></ProtectedRoute>} />
      <Route path="/esign" element={<ProtectedRoute><AdminLayout><ESign /></AdminLayout></ProtectedRoute>} />
      {/* 平台管理端 */}
      <Route path="/platform/login" element={<Suspense fallback={<SkeletonPage />}><PlatformLogin /></Suspense>} />
@@ -216,6 +236,8 @@ export default function App() {
      <Route path="/portal/home" element={<PortalLayoutWrapper><EmployeeHome /></PortalLayoutWrapper>} />
      <Route path="/portal/onboarding-progress" element={<PortalLayoutWrapper><OnboardingProgress /></PortalLayoutWrapper>} />
      <Route path="/portal/resignation" element={<PortalLayoutWrapper><ResignationApply /></PortalLayoutWrapper>} />
      <Route path="/portal/esign" element={<PortalLayoutWrapper><MyEsign /></PortalLayoutWrapper>} />
      <Route path="/portal/records" element={<PortalLayoutWrapper><MyRecords /></PortalLayoutWrapper>} />
      {/* 兜底 */}
      <Route path="*" element={<Navigate to="/" replace />} />
@@ -1,9 +1,11 @@
 import { useState, useEffect, useRef } from 'react'
-import { HelpCircle, Search, ChevronDown, ChevronRight, Sparkles,
+import { useNavigate } from 'react-router-dom'
-  Home, Users, FileText, Calculator, Bot,
+import { HelpCircle, Search, ChevronDown, ChevronRight, Sparkles, Bell,
-  Settings, Lightbulb, AlertTriangle, CheckCircle, Phone } from 'lucide-react'
+  Home, Users, FileText, Calculator, Bot, Calendar,
  Settings, Lightbulb, AlertTriangle, CheckCircle, Phone, RotateCcw, ShieldAlert, TrendingDown } from 'lucide-react'
 import Modal from './ui/Modal'
 import { aiApi } from '../lib/api-services'
 import { resetOnboarding } from './OnboardingGuide'
 import clsx from 'clsx'
 interface HelpCategory {
@@ -23,6 +25,304 @@ interface HelpArticle {
 }
 const categories: HelpCategory[] = [
  {
    id: 'whats-new',
    title: '近期更新',
    icon: Sparkles,
    articles: [
      {
        id: 'update-20260811-overview',
        question: '2026年8月11日优化：16项问题全面修复',
        answer: '本次更新覆盖花名册、离职管理、薪税管理、社保公积金、商业保险、员工福利、规章制度、文本模板、电子签署、绩效考核、违纪记录、特殊员工、证据链等全部模块，共修复16项问题（P0紧急5项 + P1重要8项 + P2优化2项 + 待确认1项）。\n以下为各模块主要改进：',
      },
      {
        id: 'update-perf-training-nav',
        question: '修复：绩效考核/培训记录点击员工姓名可跳转员工详情',
        answer: '绩效考核和培训记录列表中员工姓名现已支持点击跳转：\n• 点击员工姓名直接跳转到员工档案详情页\n• 跳转时携带 employeeId 参数，正确定位到对应员工\n• 员工姓名显示为链接样式，鼠标悬停有下划线提示',
        tip: '路径：团队 → 绩效考核/培训记录 → 点击员工姓名',
      },
      {
        id: 'update-resignation-cert',
        question: '优化：离职证明模板支持自定义+员工端下载',
        answer: '离职证明功能全面升级：\n• 离职证明模板支持自定义编辑（复用文本模板模块，支持变量占位符）\n• 管理端离职管理中可选择/编辑离职证明模板\n• 员工端已完成离职的员工可在线查看和下载离职证明（含电子印章）',
        tip: '路径：离职管理 → 已完成解聘 → 下载离职证明 / 员工端 → 我的证明',
      },
      {
        id: 'update-payroll-input',
        question: '修复(P0)：薪税管理工资填写后数据不再归零',
        answer: '修复工资条编辑表单输入数据后自动归零的问题：\n• 修复 onChange 和 onBlur 逻辑，手动输入的值不再被自动计算覆盖\n• 确保基本工资、津贴等手动输入字段正确保存到状态\n• 自动计算项目（如个税、社保扣款）在手动输入完成后重新计算',
        tip: '路径：薪税管理 → 选择员工 → 工资填写页面',
      },
      {
        id: 'update-social-enrollment',
        question: '新增：社保公积金模块员工参保信息列表',
        answer: '社保公积金模块新增「员工参保」标签页：\n• 列表显示：员工姓名、部门、参保城市、各险种参保状态（已参保/未参保/停缴）\n• 显示缴费基数（养老/医疗/失业/工伤/生育）和公积金基数\n• 支持按参保状态、城市筛选',
        tip: '路径：社保公积金 → 员工参保 Tab',
      },
      {
        id: 'update-commercial-insurance',
        question: '修复(P0)：商业保险方案支持为员工参保',
        answer: '商业保险模块新增为员工参保功能：\n• 保险方案详情中增加「为员工参保」按钮\n• 支持批量选择员工参保\n• 参保后显示参保人员列表',
        tip: '路径：福利保障 → 商业保险 → 点击方案 → 为员工参保',
      },
      {
        id: 'update-benefit-enroll-20260811',
        question: '修复(P0)：员工福利方案支持为员工添加福利',
        answer: '员工福利模块新增为员工添加福利功能：\n• 福利方案详情中增加「为员工添加福利」按钮\n• 支持批量选择员工\n• 添加后显示享受人员列表和月度合计',
        tip: '路径：福利保障 → 员工福利 → 点击方案 → 为员工添加福利',
      },
      {
        id: 'update-policy-word-import',
        question: '新增：规章制度支持导入 Word 文档',
        answer: '规章制度编辑器新增导入 Word 文档功能：\n• 支持 .docx 格式 Word 文档导入\n• 使用 mammoth 库自动将 Word 内容转为 HTML\n• 导入后可在编辑器中继续修改\n• 保留原有格式（标题、段落、列表等）',
        tip: '路径：规章制度 → 新建 → 导入 Word 文档按钮',
      },
      {
        id: 'update-template-format',
        question: '修复：文本模板下载 Word 文档保留完整格式',
        answer: '文本模板下载的 Word 文档现已保留完整格式：\n• 使用完整的 Word HTML 格式（含 style 定义）\n• 保留标题、段落间距、字体大小、对齐方式等格式\n• 下载文件名使用模板名称，不再使用随机文件名',
        tip: '路径：文本模板 → 下载 Word',
      },
      {
        id: 'update-template-variables',
        question: '修复：模板下载时变量占位符正确替换为实际数据',
        answer: '模板下载时自动替换变量占位符：\n• 下载 Word 文档时自动替换模板中的 {{变量}} 占位符\n• 从员工详情页发起下载时自动填充该员工信息\n• 修复了 token 参数被误当作模板变量的问题',
        tip: '路径：文本模板 → 填写变量 → 下载 / 员工详情 → 下载模板',
      },
      {
        id: 'update-esign-employees',
        question: '修复(P0)：电子签署发起时员工下拉框正常显示',
        answer: '修复电子签署发起签署时员工下拉框为空的问题：\n• 发起签署弹窗中员工下拉框正确加载在职员工列表\n• 显示员工姓名和部门信息\n• 修复员工列表数据获取逻辑',
        tip: '路径：电子签署 → 发起签署 → 选择员工',
      },
      {
        id: 'update-performance-reviewer',
        question: '优化：新增绩效记录支持填写考评人',
        answer: '绩效考核新增记录表单增加考评人字段：\n• 新增「考评人」必填输入框\n• 考评人信息保存到 reviewer 字段\n• 列表中显示考评人信息',
        tip: '路径：团队 → 绩效考核 → 新增 → 考评人',
      },
      {
        id: 'update-disciplinary-detail',
        question: '优化：违纪记录新增处罚执行细节',
        answer: '违纪记录新增处罚执行管理功能：\n• 违纪记录新增「执行细节」字段，支持填写处罚方式、处罚日期等\n• 违纪记录列表增加「执行细节」列\n• 表单中增加 textarea 用于详细记录处罚执行情况',
        tip: '路径：团队 → 违纪记录 → 新增 → 执行细节',
      },
      {
        id: 'update-special-status-detail',
        question: '修复：特殊员工列表支持查看员工详情',
        answer: '特殊员工列表新增查看详情功能：\n• 每条记录右上角新增「查看」按钮（眼睛图标）\n• 点击员工姓名也可跳转到员工档案详情页\n• 跳转时携带 employeeId 参数，正确定位到对应员工',
        tip: '路径：团队 → 特殊员工 → 点击查看按钮或员工姓名',
      },
      {
        id: 'update-benefit-summary',
        question: '修复：员工福利汇总正确显示参保人员和月度合计',
        answer: '员工福利汇总数据修复：\n• 新增福利方案并添加员工后，员工汇总正确显示\n• 月度合计金额正确计算所有有效福利方案\n• 汇总Tab显示参保人员姓名、部门、福利项和月度合计',
        tip: '路径：福利保障 → 员工福利 → 员工汇总 Tab',
      },
      {
        id: 'update-evidence-hash',
        question: '修复(P0)：证据链验证完整性全部通过',
        answer: '证据链哈希验证逻辑修复：\n• 修复哈希计算中 key 排序问题，改为递归排序所有层级的 key\n• 验证时自动修复因 PostgreSQL JSONB key 重排或哈希算法升级导致的不一致\n• 历史数据验证全部通过，不再出现误报篡改',
        tip: '路径：合规 → 证据链条 → 验证全部完整性',
      },
      {
        id: 'update-2026-batch-overview',
        question: '2026年8月批量优化：28项问题一次性修复',
        answer: '本次更新覆盖员工福利、离职管理、考勤管理、证据链、规章制度、文本模板、花名册、用工办理、证明开具、培训记录、绩效考核等全部模块，共修复28项问题（P0紧急6项 + P1重要16项 + P2优化6项）。\n以下为各模块主要改进：',
      },
      {
        id: 'update-benefit-enroll',
        question: '修复：福利方案创建后无法添加享受人员',
        answer: '修复福利方案批量参保功能：\n• 商业保险和员工福利模块均支持批量参保\n• 可选择多名员工一次性加入福利方案\n• 参保时自动记录生效日期和缴费金额',
        tip: '路径：员工福利 → 福利方案 → 批量参保',
      },
      {
        id: 'update-termination-cert',
        question: '修复：离职证明下载内容为乱码',
        answer: '修复离职证明下载后打开为乱码的问题：\n• 使用 Word HTML 格式生成 .doc 文件，设置 charset=utf-8\n• 指定 SimSun（宋体）字体，确保中文正常显示\n• 离职证明内容包含：员工姓名、证件号码、入职日期、离职日期、企业名称等',
        tip: '路径：离职管理 → 已完成解聘 → 下载离职证明',
      },
      {
        id: 'update-attendance-template',
        question: '优化：考勤导入模板合并Sheet，减少重复录入',
        answer: '考勤月度导入模板从多个Sheet合并为单Sheet：\n• 考勤记录和加班记录合并为「考勤与加班」一个Sheet\n• 不再需要分别填写考勤Sheet和加班Sheet\n• 导入时自动识别合并Sheet或独立Sheet，兼容旧模板\n• 减少重复录入姓名和证件号码',
        tip: '路径：考勤管理 → 考勤确认 → 导入考勤 → 下载模板',
      },
      {
        id: 'update-attendance-makeup',
        question: '修复：补卡无法修改未打卡状态',
        answer: '修复每日出勤中补卡功能：\n• 补卡弹窗支持修改签到时间、签退时间、考勤状态\n• 可手动修正迟到、早退、缺勤等异常状态\n• 补卡操作记录备注信息，方便后续审计',
        tip: '路径：考勤管理 → 每日出勤 → 补卡按钮',
      },
      {
        id: 'update-attachment-view',
        question: '新增：合同附件支持在线查看和删除',
        answer: '员工档案附件管理新增在线查看和删除功能：\n• 点击眼睛图标可在线预览附件（PDF、图片等）\n• 点击下载图标可下载附件文件\n• 点击删除图标可删除传错的附件\n• 支持身份证、银行卡、学历证书、合同扫描件等多种类型',
        tip: '路径：员工档案 → 附件管理',
      },
      {
        id: 'update-page-size',
        question: '修复：花名册每页条数选择无反应',
        answer: '修复花名册列表切换每页显示条数后不生效的问题：\n• 分页组件改为使用本地 pageSize 状态而非服务端返回值\n• 切换条数后立即重置到第一页并重新加载数据',
        tip: '路径：花名册列表底部 → 每页条数下拉框',
      },
      {
        id: 'update-termination-export',
        question: '优化：离职管理导出支持筛选条件',
        answer: '离职管理导出数据新增筛选条件：\n• 支持按状态、部门、关键词筛选\n• 新增日期范围筛选（开始日期至结束日期）\n• 导出时携带当前筛选条件，只导出符合条件的数据',
        tip: '路径：离职管理 → 筛选条件 → 导出按钮',
      },
      {
        id: 'update-termination-cancel',
        question: '新增：已提交离职数据可撤回，无用数据可删除',
        answer: '离职管理新增撤回和删除功能：\n• 已提交的离职草稿可撤销（非已完成状态均可撤回）\n• 草稿状态和已撤销状态的记录可删除\n• 撤回和删除操作均记录审计日志',
        tip: '路径：离职管理 → 草稿列表 → 撤销/删除按钮',
      },
      {
        id: 'update-overtime-calc',
        question: '优化：加班费自动计算，无需重复导入',
        answer: '考勤导入时自动计算加班费，薪税模块直接读取：\n• 导入考勤数据时根据加班倍率配置自动计算加班费\n• 月度考勤报表自动汇总加班时长和加班费\n• 薪税管理发放工资时自动读取已计算的加班费\n• 不再需要在薪税模块重复导入加班数据',
        tip: '路径：考勤管理 → 导入考勤（自动计算加班费）→ 薪税管理（自动读取）',
      },
      {
        id: 'update-overtime-summary',
        question: '修复：个人考勤记录添加后加班汇总不显示',
        answer: '修复添加个人考勤记录后月度报表加班汇总不更新的问题：\n• 月度报表从 overtimeRecord 表读取加班汇总数据\n• 个人考勤记录中的加班时长自动累计到月度汇总',
        tip: '路径：考勤管理 → 月度报表',
      },
      {
        id: 'update-evidence-verify',
        question: '优化：证据链验证显示异常项详情',
        answer: '证据链「验证全部完整性」功能增强：\n• 验证结果新增异常项详情列表\n• 每条异常项显示：证据类型、关联ID、描述、创建时间\n• 方便快速定位被篡改的证据链记录',
        tip: '路径：证据链管理 → 验证全部完整性',
      },
      {
        id: 'update-policy-remind',
        question: '新增：规章制度签收催办和未签收人员查看',
        answer: '规章制度签收管理新增催办和未签收人员列表：\n• 签收统计中显示已签收和未签收人数\n• 可展开查看未签收人员明细列表\n• 一键催办功能：向所有未签收员工发送系统内通知提醒\n• 催办通知记录在通知管理中可查看',
        tip: '路径：规章制度 → 点击制度 → 阅读统计 → 一键催办',
      },
      {
        id: 'update-template-import',
        question: '新增：模板支持导入 Word 文档',
        answer: '文本模板编辑新增导入 Word 文档功能：\n• 支持 .docx 格式 Word 文档导入\n• 使用 mammoth 库自动将 Word 内容转为 HTML\n• 导入后可在编辑器中继续修改变量占位符\n• 保留原有格式（标题、段落、列表等）',
        tip: '路径：文本模板 → 新建/编辑模板 → 导入 Word 文档按钮',
      },
      {
        id: 'update-social-cap',
        question: '修复：选择参保地后社保基数自动封上下限',
        answer: '花名册添加员工时选择参保城市后自动封顶/保底社保基数：\n• 选择参保城市后自动调用社保计算接口\n• 社保基数超过上限自动封顶，低于下限自动保底\n• 公积金基数同样自动封顶/保底\n• 显示封顶/保底提示信息',
        tip: '路径：花名册 → 添加员工 → 选择参保城市',
      },
      {
        id: 'update-validation-detail',
        question: '优化：录入校验失败显示具体字段和错误原因',
        answer: '员工信息录入校验失败时显示字段级错误信息：\n• 后端 Zod 校验返回具体字段名和错误原因\n• 前端解析错误详情，逐条列出校验失败的字段\n• 添加员工弹窗和编辑表单均支持详细错误提示',
        tip: '路径：花名册 → 添加/编辑员工 → 校验失败时显示',
      },
      {
        id: 'update-position-field',
        question: '修复：花名册录入时新增职务/岗位字段',
        answer: '添加员工表单新增「职务/岗位」输入框：\n• 在姓名和部门旁边新增职务字段\n• 录入时可直接填写岗位信息\n• 与花名册列表中的职务列对应',
        tip: '路径：花名册 → 添加员工 → 职务/岗位',
      },
      {
        id: 'update-social-detail',
        question: '新增：花名册员工详情显示社保费用分险种明细',
        answer: '员工详情薪税信息中新增社保费用分险种明细展示：\n• 按养老、医疗、失业、工伤、生育分别显示企业和个人缴费金额及比例\n• 显示社保基数是否已封顶/保底\n• 医保基数与养老基数不同时单独提示\n• 与社保模块计算结果保持一致',
        tip: '路径：员工档案 → 薪税信息 → 社保费用明细',
      },
      {
        id: 'update-modal-noclose',
        question: '优化：录入弹窗防止误关闭丢失已填信息',
        answer: '添加员工等录入弹窗防止误操作关闭：\n• Modal 组件新增 closeOnOverlayClick 属性\n• 添加员工弹窗设置为点击遮罩层不关闭\n• 防止误点击弹窗外部导致已填信息丢失',
        tip: '路径：花名册 → 添加员工弹窗',
      },
      {
        id: 'update-idcard-dedup',
        question: '新增：用工办理按证件号码查重',
        answer: '创建员工时自动按证件号码查重：\n• 后端创建员工前先检查证件号码是否已存在\n• 如果已存在，返回已有员工姓名、部门、在职状态\n• 前端显示明确的重复提示信息，避免重复录入',
        tip: '路径：用工办理 → 入职办理 / 花名册 → 添加员工',
      },
      {
        id: 'update-income-cert-select',
        question: '优化：收入证明支持员工下拉选择并自动填充',
        answer: '用工办理中收入证明和离职证明支持员工下拉选择：\n• 员工字段从手动输入改为下拉搜索选择\n• 选择员工后自动填充：姓名、证件号码、职务、月收入、入职日期、部门、手机号\n• 减少手动输入，避免信息不一致',
        tip: '路径：用工办理 → 收入证明/离职证明 → 选择员工',
      },
      {
        id: 'update-training-batch',
        question: '新增：培训记录支持批量选择员工',
        answer: '培训记录新增批量选择模式：\n• 支持切换单选/批量模式\n• 批量模式下可搜索姓名/部门并勾选多名员工\n• 一次为多名员工添加相同培训记录\n• 显示已选择员工数量',
        tip: '路径：团队 → 培训记录 → 新增 → 切换为批量',
      },
      {
        id: 'update-workprocess-dedup',
        question: '优化：用工办理中离职/解聘流程统一归入离职管理',
        answer: '用工办理模块与离职管理模块功能去重：\n• 用工办理中保留入职、转正、调岗、合同相关流程\n• 离职、解聘相关流程统一在「离职管理」模块处理\n• 清理用工办理中已废弃的流程类型定义',
        tip: '路径：用工办理（入职类流程）→ 离职管理（离职类流程）',
      },
      {
        id: 'update-social-input',
        question: '优化：社保基数输入框支持直接覆盖',
        answer: '社保和公积金基数输入框优化：\n• 自动填充的默认值改为 placeholder 显示，不再回填\n• 点击输入框时自动全选当前值，方便直接覆盖\n• 清空输入框后不再回退到月工资默认值\n• 添加员工和重新雇佣弹窗均已优化',
        tip: '路径：花名册 → 添加员工 → 社保/公积金基数输入框',
      },
      {
        id: 'update-payslip-entry',
        question: '优化：花名册员工详情薪税入口改名为「查看薪资历史」',
        answer: '员工详情中薪税模块入口按钮优化：\n• 按钮名称从「薪税模块」改为「查看薪资历史」，语义更明确\n• 跳转时携带员工ID和tab参数，直接定位到该员工的工资条\n• 与员工个人薪资关联，不再跳转到薪税批次列表',
        tip: '路径：员工档案 → 薪酬社保 → 查看薪资历史',
      },
      {
        id: 'update-roster-guide',
        question: '优化：花名册添加员工后引导前往用工办理',
        answer: '花名册添加员工成功后增加引导提示：\n• 添加成功后 toast 提示「员工已添加」\n• 提供「前往用工办理」快捷操作按钮\n• 引导用户使用用工办理完成完整入职流程（合同签署等）\n• 花名册保留快速添加入口，用工办理提供完整流程',
        tip: '路径：花名册 → 添加员工 → 成功提示 → 前往用工办理',
      },
      {
        id: 'update-performance-template',
        question: '新增：绩效考核支持自定义模板和维度评分',
        answer: '绩效考核模块新增绩效模板管理：\n• 支持定义自定义考核维度（如工作能力、态度、业绩等）\n• 每个维度可设置权重和满分分值\n• 考核时按模板填写各维度得分，系统按权重自动计算总分\n• 保留简单评分模式作为默认，自定义模板作为高级功能\n• 绩效模板支持增删改查，可设置默认模板',
        tip: '路径：员工档案 → 绩效考核 → 新增 → 选择绩效模板',
      },
    ],
  },
  {
    id: 'home',
    title: '首页',
    icon: Home,
    articles: [
      {
        id: 'system-intro',
        question: '本系统能帮企业做什么？',
        answer: '「安职通」是一站式人力资源管理平台，覆盖员工全生命周期管理，帮助企业高效管理人事业务的同时确保合规运营：\n• 员工管理：入职登记、合同签订、转正调岗、离职解聘\n• 薪税管理：工资计算、个税申报、社保公积金缴纳\n• 考勤管理：排班打卡、加班统计、休假记录、月度报表\n• 合同管理：电子合同、到期提醒、续签流程\n• 风险管控：自动扫描法律风险、合规预警、判赔预测\n• AI 助手：劳动法咨询、智能问答、文档生成',
      },
      {
        id: 'compliance',
        question: '系统如何保障用工合规？',
        answer: '系统从以下维度帮助企业实现合规管理：\n• 合同合规：自动提醒合同到期续签，检测未签合同风险（入职1个月内未签合同需支付双倍工资）\n• 薪酬合规：自动计算个税、社保扣款，确保发薪准确无误\n• 考勤合规：记录加班时长，预警超时加班风险，留存考勤证据\n• 解聘合规：自动计算经济补偿金，生成规范解聘协议，降低劳动争议风险\n• 社保合规：跟踪社保缴纳情况，提醒漏缴断缴\n• 风险预警：统一风险中心实时扫描所有数据，按高/中/低分级预警',
        tip: '建议每周查看风险中心，每月核对薪税和考勤数据，确保合规无遗漏。',
      },
      {
        id: 'workflow',
        question: '日常人事工作流程是怎样的？',
        answer: '系统覆盖企业日常人事管理的完整流程：',
        steps: [
          '入职：添加员工信息 → 签订合同 → 设置社保 → 安排排班',
          '日常：考勤打卡 → 加班审批 → 休假管理 → 补卡修正',
          '月度：导入考勤 → 确认考勤 → 计算工资 → 发放工资条 → 缴纳社保公积金 → 个税申报',
          '合同：到期提醒 → 续签合同 → 合同确认',
          '离职：发起解聘 → 计算补偿金 → 生成协议 → 完成离职',
        ],
      },
      {
        id: 'value',
        question: '使用系统能带来什么价值？',
        answer: '• 提效：自动化算薪、考勤统计、合同管理，减少 80% 人工操作\n• 降险：法律风险自动检测预警，避免因疏忽导致的劳动纠纷和罚款\n• 省心：到期提醒、月度任务提醒，不再遗漏关键时间节点\n• 透明：员工可通过手机端查看工资条、合同、考勤记录，信息透明\n• 合规：所有操作留存记录，满足劳动法合规要求，应对审计无忧',
      },
    ],
  },
  {
    id: 'start',
    title: '快速入门',
@@ -30,7 +330,7 @@ const categories: HelpCategory[] = [
    articles: [
      {
        id: 'what-is',
-        question: '「企业用工专家」是什么？',
+        question: '「安职通」是什么？',
        answer: '这是一个帮您管理员工、合同、工资和社保的工具。您可以把它理解为一个「人事小助手」，帮您把繁琐的人事工作变得简单。比如：记录员工信息、提醒合同到期、计算工资社保、生成法律文档等。',
      },
      {
@@ -85,6 +385,24 @@ const categories: HelpCategory[] = [
        answer: '请到「解聘管理」页面处理离职流程，系统会自动帮您计算经济补偿金、生成解聘协议书等法律文件。不要直接删除员工记录，保留记录有助于日后查证。',
        warning: '直接删除员工会导致该员工的所有历史记录丢失，包括合同、工资单等。',
      },
      {
        id: 'training-records',
        question: '培训记录怎么管理？',
        answer: '在左侧菜单「团队」分组下点击「培训记录」进入管理页面：\n• 点击「新增」按钮选择员工，填写培训主题、日期、讲师、时长等信息\n• 保存后记录状态为「待签收」，员工可在员工端「我的记录」中签收或拒绝\n• 列表显示签收状态（待签收/已签收/拒绝签收），支持按员工姓名搜索',
        tip: '开启「电子签署设置 → 培训记录电子签」后，员工签收时需走电子签署流程，签收记录自动进入证据链。',
      },
      {
        id: 'performance-records',
        question: '绩效考核怎么录入和管理？',
        answer: '在左侧菜单「团队」分组下点击「绩效考核」进入管理页面：\n• 点击「新增」选择员工，填写考核周期、得分、等级、结果、评语等\n• 保存后员工可在员工端查看并签字确认\n• 列表显示签字状态（待签字/已签字），支持按员工姓名搜索',
        tip: '开启「电子签署设置 → 绩效考核电子签」后，员工签字时需走电子签署流程。',
      },
      {
        id: 'disciplinary-records',
        question: '违纪记录怎么管理？',
        answer: '在左侧菜单「团队」分组下点击「违纪记录」进入管理页面：\n• 点击「新增」选择员工，填写违纪日期、类型、描述、严重程度、处理方式等\n• 可填写见证人信息，保存后员工可在员工端查看并签字确认\n• 列表显示签字状态（待签字/已签字），支持按员工姓名搜索',
        warning: '违纪记录是劳动仲裁重要证据，建议如实记录并确保员工签字确认。开启电子签后签字记录自动进入证据链。',
      },
    ],
  },
  {
@@ -146,21 +464,94 @@ const categories: HelpCategory[] = [
      },
    ],
  },
  {
    id: 'attendance',
    title: '考勤管理',
    icon: Calendar,
    articles: [
      {
        id: 'attendance-overview',
        question: '考勤管理有哪些功能？',
        answer: '考勤管理包含 6 个子功能：\n• 考勤确认：导入考勤数据后批量确认并发布给员工\n• 班次管理：设置早班、晚班、弹性班等班次规则\n• 排班：按日期为员工分配班次，支持批量排班\n• 每日出勤：查看当日打卡情况，支持补卡修正\n• 月度报表：汇总月度出勤、迟到、加班数据\n• 休假记录：管理员工请假信息',
      },
      {
        id: 'shift-setup',
        question: '怎么设置班次？',
        answer: '在考勤管理「班次管理」标签页中，点击「新增班次」按钮，设置班次名称、上下班时间、弹性时长和休息时长。每个班次可以设置不同颜色方便区分。',
        tip: '常见班次：早班 08:00-17:00、晚班 14:00-23:00、弹性班 09:00-18:00（弹性30分钟）。',
      },
      {
        id: 'schedule',
        question: '怎么给员工排班？',
        answer: '在考勤管理「排班」标签页中：',
        steps: [
          '选择日期',
          '在员工列表中，未排班的员工行内有班次下拉框',
          '选择班次后点击「排班」按钮即可',
          '也可以点击「批量排班」按钮，勾选多个员工一次性分配班次',
        ],
        tip: '支持按姓名或部门搜索，按部门筛选快速定位员工。',
      },
      {
        id: 'attendance-import',
        question: '怎么导入考勤数据？',
        answer: '在考勤管理「考勤确认」标签页中，点击「导入考勤」按钮，下载模板填写后上传。系统会自动匹配员工并生成考勤记录。',
        tip: '证件号码优先匹配，未填时用姓名匹配。',
      },
      {
        id: 'attendance-correct',
        question: '员工漏打卡了怎么办？',
        answer: '在「每日出勤」标签页中，找到对应员工，点击「补卡」按钮，手动填写签到/签退时间和状态即可修正记录。',
      },
    ],
  },
  {
    id: 'risk',
-    title: '风险检测',
+    title: '风险中心',
-    icon: AlertTriangle,
+    icon: ShieldAlert,
    articles: [
      {
        id: 'what-is-risk',
-        question: '风险检测是什么意思？',
+        question: '风险中心是什么？',
-        answer: '系统会自动扫描您的员工和合同数据，发现可能存在的法律风险。比如：合同到期未续签、试用期超长、未签合同等。风险分为高、中、低三个等级，建议优先处理高风险项。',
+        answer: '统一风险中心会自动扫描您的员工、合同、薪酬、社保等数据，汇总所有潜在风险。包括：合同到期未续签、未签合同、试用期超长、薪酬异常、社保漏缴、退休提醒等。风险分为高、中、低三个等级，建议优先处理高风险项。',
        tip: '访问路径：左侧菜单「风险中心」或直接访问 /risk-center。',
      },
      {
        id: 'how-to-fix',
        question: '发现风险后怎么处理？',
-        answer: '在首页「总览」页面可以看到风险概览。点击风险项可以跳转到对应员工详情，然后根据系统建议进行处理。处理完成后风险会自动消除。',
+        answer: '在风险中心页面，每个风险项右侧有快捷操作按钮（如「续签」「转正」「处理」），点击即可跳转到对应页面处理。处理完成后风险会自动消除。',
-        tip: '建议每周查看一次风险提醒，及时处理避免法律纠纷。',
+        tip: '建议每周查看一次风险中心，及时处理避免法律纠纷。',
      },
      {
        id: 'risk-types',
        question: '有哪些类型的风险？',
        answer: '系统目前检测以下风险类型：\n• 合同风险：到期未续签、未签合同\n• 薪酬风险：薪资异常波动\n• 解聘风险：可能存在劳动争议\n• 月度任务：发薪、社保、公积金、个税等截止日提醒\n• 入职手续：入职材料不完整\n• 退休提醒：员工即将达到退休年龄',
      },
    ],
  },
  {
    id: 'termination',
    title: '解聘管理',
    icon: TrendingDown,
    articles: [
      {
        id: 'termination-process',
        question: '员工离职怎么处理？',
        answer: '在「解聘管理」页面处理离职流程：',
        steps: [
          '点击「发起解聘」选择员工',
          '填写解聘原因、离职日期等信息',
          '系统自动计算经济补偿金',
          '生成解聘协议书等法律文件',
          '确认后完成解聘流程',
        ],
        warning: '不要直接删除员工记录，保留记录有助于日后查证和合规。',
      },
      {
        id: 'compensation',
        question: '经济补偿金怎么算？',
        answer: '系统根据员工工龄和月均工资自动计算经济补偿金：\n• 每满一年支付一个月工资\n• 六个月以上不满一年按一年算\n• 不满六个月支付半个月工资\n• 月工资按离职前12个月平均工资计算',
        tip: '工资高于当地社平工资3倍的，按3倍封顶，最长补偿12年。',
      },
    ],
  },
@@ -195,7 +586,12 @@ const categories: HelpCategory[] = [
      {
        id: 'notification',
        question: '怎么设置提醒？',
-        answer: '在「通知管理」页面可以设置各类提醒：\n• 合同到期提前提醒天数\n• 未签合同提醒\n• 试用期到期提醒等\n点击通知铃铛图标可以查看所有未读提醒。',
+        answer: '在「设置」页面的「通知设置」标签中可以配置：\n• 合同到期提前提醒天数\n• 未签合同提醒\n• 加班超时提醒\n• 工资条发布通知\n• 月度事务提醒（发薪日、社保日、公积金日、个税日）\n• 企业微信 Webhook 推送\n• 邮件通知\n点击顶部通知铃铛图标可以查看所有未读提醒。',
      },
      {
        id: 'salary-dashboard',
        question: '薪酬分析看板有什么用？',
        answer: '薪酬分析看板在「薪税管理」页面中，提供：\n• 薪酬概览（员工总数、月均薪酬、中位数、年度总薪酬）\n• 部门薪酬对比（含人均薪酬排名）\n• 月度薪酬趋势（同比环比变化）\n帮助您了解薪酬分布情况，辅助预算决策。',
      },
      {
        id: 'change-password',
@@ -217,12 +613,12 @@ const categories: HelpCategory[] = [
      {
        id: 'data-safe',
        question: '我的数据安全吗？',
-        answer: '您的数据存储在加密的云端服务器上，只有您本人登录后才能查看。我们不会将您的数据分享给任何第三方。所有敏感信息（如身份证号）都经过加密存储。',
+        answer: '您的数据存储在加密的云端服务器上，只有您本人登录后才能查看。我们不会将您的数据分享给任何第三方。所有敏感信息（如证件号码）都经过加密存储。',
      },
      {
        id: 'data-export',
        question: '可以导出数据吗？',
-        answer: '可以。在员工管理页面可以导出员工名单为 Excel 文件。工资批次也可以导出为 Excel 方便财务对账。',
+        answer: '可以。在员工管理页面可以导出员工名单为 Excel 文件。工资批次可以导出为 Excel 方便财务对账。考勤管理支持导出每日出勤和月度报表为 CSV 文件。',
      },
      {
        id: 'multi-user',
@@ -247,6 +643,7 @@ interface RAGResult {
 }
 export default function HelpModal({ open, onClose }: { open: boolean; onClose: () => void }) {
  const navigate = useNavigate()
  const [activeCategory, setActiveCategory] = useState(categories[0].id)
  const [expandedArticle, setExpandedArticle] = useState<string | null>(null)
  const [searchQuery, setSearchQuery] = useState('')
@@ -502,10 +899,19 @@ export default function HelpModal({ open, onClose }: { open: boolean; onClose: (
      {/* 底部联系方式 */}
      <div className="border-t border-gray-200 px-4 py-2.5 flex items-center justify-between text-xs text-gray-500">
        <div className="flex items-center gap-3">
          <span className="flex items-center gap-1.5">
            <HelpCircle className="w-3.5 h-3.5" />
            还有问题？在 AI 助手中直接提问
          </span>
          <button
            onClick={() => { resetOnboarding(); onClose(); navigate('/'); setTimeout(() => window.location.reload(), 100) }}
            className="flex items-center gap-1 text-primary hover:underline"
          >
            <RotateCcw className="w-3 h-3" />
            重新显示功能导览
          </button>
        </div>
        <span>support@hr8ai.com</span>
      </div>
    </Modal>
@@ -1,80 +1,144 @@
 import { useState, useEffect } from 'react'
-import { X, ArrowRight } from 'lucide-react'
+import { useNavigate } from 'react-router-dom'
 import { X, ArrowRight, Home, Users, Calculator, CalendarCheck, ShieldAlert, Bot } from 'lucide-react'
-const STORAGE_KEY = 'hr-onboarding-completed'
+const STORAGE_KEY = 'hr-onboarding-dismissed'
-const steps = [
+const modules = [
  {
-    icon: '🏠',
+    icon: Home,
-    title: '这里看风险',
+    color: 'text-blue-600',
-    description: '首页展示企业用工风险总览，红色代表高风险项，点击「去处理」直接跳转操作。',
+    bg: 'bg-blue-50',
    title: '工作台',
    desc: '风险总览、待办事项、日历事件',
    path: '/',
  },
  {
-    icon: '�',
+    icon: Users,
-    title: '这里管花名册',
+    color: 'text-indigo-600',
-    description: '花名册页面管理员工档案、劳动合同、附件，以及违纪、考勤、培训、绩效记录，可生成仲裁证据链。',
+    bg: 'bg-indigo-50',
    title: '团队管理',
    desc: '花名册、用工办理、离职管理、特殊状态',
    path: '/roster',
  },
  {
-    icon: '💰',
+    icon: Calculator,
-    title: '这里算薪税',
+    color: 'text-amber-600',
-    description: '薪税页面提供加班费、双倍工资、社保公积金计算器和工资条管理，输入参数实时计算。',
+    bg: 'bg-amber-50',
    title: '薪酬管理',
    desc: '发薪批次、工资条、社保公积金、薪酬分析',
    path: '/money',
  },
  {
    icon: CalendarCheck,
    color: 'text-green-600',
    bg: 'bg-green-50',
    title: '考勤时间',
    desc: '考勤打卡、排班管理、休假审批',
    path: '/attendance',
  },
  {
    icon: ShieldAlert,
    color: 'text-red-600',
    bg: 'bg-red-50',
    title: '合规风控',
    desc: '风险中心、证据链、规章制度、用工体检',
    path: '/risk-center',
  },
  {
    icon: Bot,
    color: 'text-purple-600',
    bg: 'bg-purple-50',
    title: 'AI 助手',
    desc: '智能咨询、合同审查、判赔预测、人力分析',
    path: '/ai-assistant',
  },
 ]
 export function isOnboardingDismissed() {
  return localStorage.getItem(STORAGE_KEY) === '1'
 }
 export function dismissOnboarding() {
  localStorage.setItem(STORAGE_KEY, '1')
 }
 export function resetOnboarding() {
  localStorage.removeItem(STORAGE_KEY)
 }
 export default function OnboardingGuide() {
  const [visible, setVisible] = useState(false)
-  const [step, setStep] = useState(0)
+  const [dontShow, setDontShow] = useState(false)
  const navigate = useNavigate()
  useEffect(() => {
-    const completed = localStorage.getItem(STORAGE_KEY)
+    if (!isOnboardingDismissed()) {
    if (!completed) {
      setVisible(true)
    }
  }, [])
  const close = () => {
-    localStorage.setItem(STORAGE_KEY, '1')
+    if (dontShow) dismissOnboarding()
    setVisible(false)
  }
  const goTo = (path: string) => {
    if (dontShow) dismissOnboarding()
    setVisible(false)
    navigate(path)
  }
  if (!visible) return null
  const current = steps[step]
  const isLast = step === steps.length - 1
  return (
    <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/40">
-      <div className="bg-white rounded-xl shadow-xl max-w-sm w-full mx-4 overflow-hidden">
+      <div className="bg-white rounded-xl shadow-xl max-w-lg w-full mx-4 overflow-hidden">
-        <div className="flex justify-end p-2">
+        <div className="flex items-center justify-between px-5 py-3 border-b border-gray-100">
          <h2 className="text-base font-semibold">欢迎使用安职通</h2>
          <button onClick={close} className="text-gray-400 hover:text-gray-600">
            <X className="w-5 h-5" />
          </button>
        </div>
-        <div className="px-6 pb-6">
+        <div className="px-5 py-4">
-          <div className="text-5xl text-center mb-4">{current.icon}</div>
+          <p className="text-sm text-gray-500 mb-4">系统包含以下 6 大模块，点击任意模块可直接前往体验：</p>
-          <h2 className="text-lg font-semibold text-center mb-2">{current.title}</h2>
+          <div className="grid grid-cols-2 gap-3">
-          <p className="text-sm text-gray-600 text-center mb-6">{current.description}</p>
+            {modules.map((m) => {
-
+              const Icon = m.icon
-          {/* 进度指示器 */}
+              return (
-          <div className="flex justify-center gap-1.5 mb-6">
+                <button
-            {steps.map((_, i) => (
+                  key={m.title}
-              <div
+                  onClick={() => goTo(m.path)}
-                key={i}
+                  className="flex items-start gap-3 p-3 rounded-lg border border-gray-100 hover:border-primary/30 hover:bg-primary/[0.02] transition-all text-left"
-                className={`h-1.5 rounded-full transition-all ${i === step ? 'w-6 bg-primary' : 'w-1.5 bg-gray-300'}`}
+                >
-              />
+                  <div className={`flex items-center justify-center w-9 h-9 rounded-lg ${m.bg} ${m.color} shrink-0`}>
-            ))}
+                    <Icon className="w-4.5 h-4.5" />
                  </div>
                  <div className="flex-1 min-w-0">
                    <div className="text-sm font-medium text-gray-800">{m.title}</div>
                    <div className="text-xs text-gray-500 mt-0.5 leading-relaxed">{m.desc}</div>
                  </div>
                </button>
              )
            })}
          </div>
-          <div className="flex justify-between">
+          <div className="mt-4 flex items-center justify-between">
-            {step > 0 ? (
+            <label className="flex items-center gap-2 text-sm text-gray-500 cursor-pointer">
-              <button onClick={() => setStep(step - 1)} className="text-sm text-gray-500">上一步</button>
+              <input
-            ) : <span />}
+                type="checkbox"
                checked={dontShow}
                onChange={(e) => setDontShow(e.target.checked)}
                className="w-4 h-4 rounded border-gray-300 text-primary focus:ring-primary/10"
              />
              不再自动显示
            </label>
            <button
-              onClick={() => isLast ? close() : setStep(step + 1)}
+              onClick={close}
-              className="flex items-center gap-1 text-sm font-medium text-primary"
+              className="flex items-center gap-1 px-4 py-2 text-sm font-medium text-white bg-primary rounded-lg hover:bg-primary/90 transition-colors"
            >
-              {isLast ? '开始使用' : '下一步'}
+              开始使用
-              {!isLast && <ArrowRight className="w-4 h-4" />}
+              <ArrowRight className="w-4 h-4" />
            </button>
          </div>
        </div>
@@ -15,11 +15,14 @@ const ROUTE_MAP: Record<string, BreadcrumbItem> = {
  '/': { group: '工作台', label: '总览' },
  '/calendar': { group: '工作台', label: '工作日历' },
  '/roster': { group: '员工管理', label: '花名册' },
-  '/work-process': { group: '员工管理', label: '用工办理' },
+  '/work-process': { group: '员工管理', label: '批量流程' },
  '/attendance': { group: '员工管理', label: '考勤确认' },
  '/leave-approval': { group: '员工管理', label: '休假审批' },
  '/termination': { group: '员工管理', label: '解聘补偿' },
  '/special-status': { group: '员工管理', label: '特殊状态' },
  '/training-records': { group: '员工管理', label: '培训记录' },
  '/performance-records': { group: '员工管理', label: '绩效考核' },
  '/disciplinary-records': { group: '员工管理', label: '违纪记录' },
  '/money': { group: '薪税社保', label: '薪税管理' },
  '/social': { group: '薪税社保', label: '社保公积金' },
  '/evidence': { group: '合规风控', label: '证据链' },
@@ -36,7 +36,7 @@ export default function PortalLayout({ children }: { children: React.ReactNode }
        <div className="max-w-md mx-auto h-14 flex items-center justify-between px-4">
          <div className="flex items-center gap-2 min-w-0">
            <Logo className="w-6 h-6 text-primary flex-shrink-0" />
-            <span className="text-sm font-bold text-gray-900 truncate">企业用工专家</span>
+            <span className="text-sm font-bold text-gray-900 truncate">安职通</span>
          </div>
          <div className="flex items-center gap-2 flex-shrink-0">
            {employee.name && (
@@ -5,6 +5,7 @@
 import { Link, useLocation } from 'react-router-dom'
 import { useState } from 'react'
 import { useQuery } from '@tanstack/react-query'
 import clsx from 'clsx'
 import {
  LayoutDashboard, Users, CalendarCheck, UserX,
@@ -14,8 +15,11 @@ import {
  Bell, ScrollText, Settings,
  ChevronDown, ChevronRight,
  Building2, CalendarDays, ClipboardList, Heart, CalendarClock,
  Gift, PenTool, Umbrella, GraduationCap, TrendingUp, AlertTriangle,
  DollarSign,
 } from 'lucide-react'
 import Logo from '../ui/Logo'
 import { settingsApi } from '../../lib/api-services'
 interface NavItem {
  path: string
@@ -33,16 +37,28 @@ const navGroups: NavGroup[] = [
    title: '首页',
    items: [
      { path: '/', label: '工作台', icon: LayoutDashboard },
-      { path: '/calendar', label: '日历', icon: CalendarDays },
+      { path: '/calendar', label: '工作日历', icon: CalendarDays },
      { path: '/esign', label: '待签合同', icon: PenTool },
    ],
  },
  {
    title: '团队',
    items: [
      { path: '/roster', label: '花名册', icon: Users },
-      { path: '/work-process', label: '用工办理', icon: ClipboardList },
+      { path: '/org-chart', label: '组织架构', icon: Building2 },
      { path: '/termination', label: '离职管理', icon: UserX },
-      { path: '/special-status', label: '特殊状态', icon: Heart },
+      { path: '/training-records', label: '培训记录', icon: GraduationCap },
      { path: '/performance-records', label: '绩效考核', icon: TrendingUp },
      { path: '/disciplinary-records', label: '违纪记录', icon: AlertTriangle },
      { path: '/special-status', label: '特殊员工', icon: Heart },
      { path: '/commission-bonus', label: '提成奖金', icon: DollarSign },
    ],
  },
  {
    title: '时间',
    items: [
      { path: '/attendance', label: '考勤排班', icon: CalendarCheck },
      { path: '/leave-approval', label: '休假审批', icon: CalendarClock },
    ],
  },
  {
@@ -54,17 +70,17 @@ const navGroups: NavGroup[] = [
    ],
  },
  {
-    title: '时间',
+    title: '福利保障',
    items: [
-      { path: '/attendance', label: '考勤排班', icon: CalendarCheck },
+      { path: '/commercial-insurance', label: '商业保险', icon: Umbrella },
-      { path: '/leave-approval', label: '休假审批', icon: CalendarClock },
+      { path: '/benefits', label: '员工福利', icon: Gift },
    ],
  },
  {
    title: '合规',
    items: [
      { path: '/risk-center', label: '风险中心', icon: ShieldAlert },
-      { path: '/evidence', label: '证据链', icon: FileSearch },
+      { path: '/evidence', label: '证据链条', icon: FileSearch },
      { path: '/policies', label: '规章制度', icon: FileText },
      { path: '/tools/health-check', label: '用工体检', icon: Stethoscope },
      { path: '/tools/medical-period', label: '医疗期', icon: HeartPulse },
@@ -79,7 +95,7 @@ const navGroups: NavGroup[] = [
      { path: '/notifications', label: '通知管理', icon: Bell },
      { path: '/audit', label: '操作日志', icon: ScrollText },
      { path: '/company-files', label: '公司文件', icon: Building2 },
-      { path: '/settings', label: '设置', icon: Settings },
+      { path: '/settings', label: '系统设置', icon: Settings },
    ],
  },
 ]
@@ -89,13 +105,18 @@ const navGroups: NavGroup[] = [
 */
 export default function SidebarNav({ mobileOpen, onClose }: { mobileOpen: boolean; onClose: () => void }) {
  const location = useLocation()
  const { data: orgData } = useQuery<any>({
    queryKey: ['org-settings'],
    queryFn: () => settingsApi.org(),
    staleTime: 300000,
  })
  const isActive = (path: string) => {
    if (path === '/') return location.pathname === '/'
    return location.pathname.startsWith(path)
  }
  const activeGroup = navGroups.find(g => g.items.some(item => isActive(item.path)))
  const [expandedGroups, setExpandedGroups] = useState<Set<string>>(
-    new Set(activeGroup ? [activeGroup.title] : ['首页'])
+    new Set(navGroups.map(g => g.title))
  )
  const toggleGroup = (title: string) => {
@@ -131,7 +152,7 @@ export default function SidebarNav({ mobileOpen, onClose }: { mobileOpen: boolea
        {/* Logo 区 */}
        <div className="h-14 flex items-center gap-2 px-4 border-b border-gray-200 shrink-0">
          <Logo className="w-5 h-5 text-primary" />
-          <span className="font-bold text-sm text-gray-900">企业用工专家</span>
+          <span className="font-bold text-sm text-gray-900 truncate">{orgData?.name || ''}</span>
        </div>
        {/* 导航菜单 */}
@@ -3,7 +3,7 @@ import { ChevronDown, Settings as SettingsIcon, Bell, Menu, HelpCircle, Smartpho
 import { useState } from 'react'
 import { useQuery } from '@tanstack/react-query'
 import { useAuthStore } from '../../store/authStore'
-import { dashboardApi, settingsApi } from '../../lib/api-services'
+import { dashboardApi } from '../../lib/api-services'
 import Breadcrumb from './Breadcrumb'
 import HelpModal from '../HelpModal'
 import PortalQRModal from '../PortalQRModal'
@@ -22,11 +22,6 @@ export default function TopNav({ onMenuClick }: { onMenuClick?: () => void }) {
    queryFn: () => dashboardApi.data(),
    refetchInterval: 60000,
  })
  const { data: orgData } = useQuery<any>({
    queryKey: ['org-settings'],
    queryFn: () => settingsApi.org(),
    staleTime: 300000,
  })
  const riskCount = dashboardData?.riskSummary?.pending || 0
  return (
@@ -41,12 +36,6 @@ export default function TopNav({ onMenuClick }: { onMenuClick?: () => void }) {
          >
            <Menu className="w-5 h-5 text-gray-600" />
          </button>
          {orgData?.name && (
            <span className="hidden sm:inline text-sm font-medium text-gray-700 shrink-0">
              {orgData.name}
            </span>
          )}
          {orgData?.name && <span className="hidden sm:inline text-gray-300 shrink-0">|</span>}
          <Breadcrumb />
        </div>
@@ -9,9 +9,10 @@ interface ModalProps {
  children: ReactNode
  className?: string
  size?: 'sm' | 'md' | 'lg' | 'xl'
  closeOnOverlayClick?: boolean
 }
-export default function Modal({ open, onClose, title, children, className, size = 'md' }: ModalProps) {
+export default function Modal({ open, onClose, title, children, className, size = 'md', closeOnOverlayClick = true }: ModalProps) {
  const [show, setShow] = useState(false)
  useEffect(() => {
@@ -33,7 +34,7 @@ export default function Modal({ open, onClose, title, children, className, size
    <div className="fixed inset-0 z-50 flex items-center justify-center p-4">
      <div
        className={clsx('fixed inset-0 bg-black/40 transition-opacity duration-200', show ? 'opacity-100' : 'opacity-0')}
-        onClick={onClose}
+        onClick={closeOnOverlayClick ? onClose : undefined}
      />
      <div
        className={clsx(
@@ -1,5 +1,6 @@
 import clsx from 'clsx'
 import { ChevronLeft, ChevronRight } from 'lucide-react'
 import { setPageSize } from '../../lib/pageSize'
 interface PaginationProps {
  page: number          // 当前页（1-based）
@@ -45,7 +46,7 @@ export default function Pagination({
          <select
            className="border rounded px-1.5 py-0.5 text-sm text-gray-600 focus:outline-none focus:border-primary"
            value={pageSize}
-            onChange={(e) => onPageSizeChange(Number(e.target.value))}
+            onChange={(e) => { setPageSize(Number(e.target.value)); onPageSizeChange?.(Number(e.target.value)) }}
          >
            {pageSizeOptions.map((n) => (
              <option key={n} value={n}>{n} 条/页</option>
@@ -0,0 +1,166 @@
 /**
 * 签署方式选择弹窗
 * 花名册操作（重新入职/合同续签/薪酬变更/调岗调动）成功后，
 * 弹窗让HR选择是走电子签署还是线下手签。
 *
 * - 电子签：自动创建电子签署记录（status=PENDING），员工在员工端签署
 * - 线下手签：跳转到电子签署页面的线下手签登记
 * - 跳过：不创建签署记录
 */
 import { useState } from 'react'
 import { useNavigate } from 'react-router-dom'
 import { toast } from 'sonner'
 import { useMutation, useQueryClient } from '@tanstack/react-query'
 import { PenTool, FileCheck, SkipForward, Shield } from 'lucide-react'
 import { esignApi } from '../../lib/api-services'
 import Modal from './Modal'
 import Button from './Button'
 interface SignMethodChoiceProps {
  open: boolean
  onClose: () => void
  /** 员工ID */
  employeeId: string
  /** 员工姓名（用于显示） */
  employeeName: string
  /** 签署场景 */
  scene: 'CONTRACT' | 'RESIGNATION' | 'POLICY' | 'PAYSLIP' | 'ONBOARDING'
  /** 文件标题 */
  documentTitle: string
  /** 关联合同ID（可选） */
  contractId?: string
  /** 备注 */
  remark?: string
  /** 操作名称（如"重新入职"、"合同续签"） */
  actionName: string
 }
 const SCENE_LABELS: Record<string, string> = {
  CONTRACT: '劳动合同',
  RESIGNATION: '离职协议',
  POLICY: '规章制度',
  PAYSLIP: '工资条',
  ONBOARDING: '入职文件',
 }
 export default function SignMethodChoice({
  open,
  onClose,
  employeeId,
  employeeName,
  scene,
  documentTitle,
  contractId,
  remark,
  actionName,
 }: SignMethodChoiceProps) {
  const navigate = useNavigate()
  const queryClient = useQueryClient()
  const [creating, setCreating] = useState(false)
  const createEsignMutation = useMutation({
    mutationFn: (data: any) => esignApi.create(data),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['esign-records'] })
      toast.success('电子签署已发起，员工可在员工端查看并签署', {
        action: { label: '查看签署', onClick: () => navigate('/esign') },
      })
      onClose()
    },
    onError: (err: any) => toast.error(err?.response?.data?.error?.message || '创建失败'),
  })
  /** 选择电子签署 */
  const handleEsign = () => {
    setCreating(true)
    createEsignMutation.mutate({
      employeeId,
      contractId,
      scene,
      documentTitle,
      remark: remark || `${actionName}时自动发起`,
    })
    setCreating(false)
  }
  /** 选择线下手签 → 跳转到签署页面 */
  const handlePaperSign = () => {
    onClose()
    // 通过 URL 参数传递信息，签署页面读取后自动打开线下手签登记
    const params = new URLSearchParams({
      action: 'paper-sign',
      employeeId,
      scene,
      documentTitle,
    })
    if (contractId) params.set('contractId', contractId)
    navigate(`/esign?${params.toString()}`)
  }
  /** 跳过 */
  const handleSkip = () => {
    toast.info('已跳过签署，可稍后在「电子签署」页面手动发起')
    onClose()
  }
  return (
    <Modal open={open} onClose={onClose} title={`${actionName}成功 — 选择签署方式`} size="sm">
      <div className="space-y-4">
        <div className="text-sm text-gray-600 bg-gray-50 rounded-md p-3">
          <div className="font-medium text-gray-700">{employeeName} · {SCENE_LABELS[scene] || scene}</div>
          <div className="text-xs text-gray-400 mt-1">{documentTitle}</div>
        </div>
        <div className="text-xs text-gray-500 flex items-start gap-1.5">
          <Shield className="w-3.5 h-3.5 mt-0.5 shrink-0 text-primary" />
          <div>根据劳动合同法，{SCENE_LABELS[scene] || '文件'}需双方签署确认。请选择签署方式：</div>
        </div>
        <div className="space-y-2">
          {/* 电子签署 */}
          <button
            onClick={handleEsign}
            disabled={creating}
            className="w-full flex items-center gap-3 p-3 border-2 border-blue-200 bg-blue-50/50 rounded-lg hover:border-blue-400 hover:bg-blue-50 transition text-left disabled:opacity-50"
          >
            <div className="w-10 h-10 rounded-lg bg-blue-100 flex items-center justify-center shrink-0">
              <PenTool className="w-5 h-5 text-blue-600" />
            </div>
            <div className="flex-1 min-w-0">
              <div className="text-sm font-medium text-gray-800">电子签署</div>
              <div className="text-xs text-gray-500 mt-0.5">自动创建签署记录，员工在员工端通过验证码签署</div>
            </div>
          </button>
          {/* 线下手签 */}
          <button
            onClick={handlePaperSign}
            className="w-full flex items-center gap-3 p-3 border-2 border-orange-200 bg-orange-50/50 rounded-lg hover:border-orange-400 hover:bg-orange-50 transition text-left"
          >
            <div className="w-10 h-10 rounded-lg bg-orange-100 flex items-center justify-center shrink-0">
              <FileCheck className="w-5 h-5 text-orange-600" />
            </div>
            <div className="flex-1 min-w-0">
              <div className="text-sm font-medium text-gray-800">线下手签登记</div>
              <div className="text-xs text-gray-500 mt-0.5">跳转到签署页面，上传签署后的纸质文件扫描件</div>
            </div>
          </button>
          {/* 跳过 */}
          <button
            onClick={handleSkip}
            className="w-full flex items-center gap-3 p-3 border-2 border-gray-200 bg-gray-50/50 rounded-lg hover:border-gray-300 hover:bg-gray-50 transition text-left"
          >
            <div className="w-10 h-10 rounded-lg bg-gray-100 flex items-center justify-center shrink-0">
              <SkipForward className="w-5 h-5 text-gray-500" />
            </div>
            <div className="flex-1 min-w-0">
              <div className="text-sm font-medium text-gray-600">稍后处理</div>
              <div className="text-xs text-gray-400 mt-0.5">跳过签署，可稍后在「电子签署」页面手动发起</div>
            </div>
          </button>
        </div>
      </div>
    </Modal>
  )
 }
@@ -274,7 +274,7 @@ export const surveyPages: SurveyPage[] = [
  {
    id: 24, name: 'Onboarding（入职信息填报）', file: 'frontend/src/pages/portal/Onboarding.tsx', menu: '员工端 > 入职填报',
    features: [
-      { id: '24.1', name: '入职表单填写', desc: '填写姓名、手机号、身份证号、紧急联系人等' },
+      { id: '24.1', name: '入职表单填写', desc: '填写姓名、手机号、证件号码、紧急联系人等' },
      { id: '24.2', name: '入职材料上传', desc: '上传身份证、学历证明、银行卡等材料' },
      { id: '24.3', name: '文件类型选择', desc: '选择上传文件的类型（身份证正反面、学历、银行卡、其他）' },
      { id: '24.4', name: '已传文件管理', desc: '查看和删除已上传文件' },
@@ -0,0 +1,18 @@
 import { useState, useEffect } from 'react'
 import { getPageSize } from '../lib/pageSize'
 /**
 * 响应式分页大小 hook
 * 当用户在系统设置中修改分页大小时，所有使用此 hook 的页面会自动更新
 */
 export function usePageSize() {
  const [pageSize, setPageSizeState] = useState(getPageSize())
  useEffect(() => {
    const handler = () => setPageSizeState(getPageSize())
    window.addEventListener('page-size-changed', handler)
    return () => window.removeEventListener('page-size-changed', handler)
  }, [])
  return pageSize
 }
@@ -66,6 +66,12 @@ export const employeeApi = {
  /** 创建员工 */
  create: (data: Record<string, unknown>) =>
    post('/employees', data),
  /** 身份证查重 */
  checkIdCard: (idCard: string) =>
    get('/employees/check-id-card', { params: { idCard } }).then(unwrap<{ exists: boolean; employee?: any }>()),
  /** 手机号查重 */
  checkPhone: (phone: string) =>
    get('/employees/check-phone', { params: { phone } }).then(unwrap<{ exists: boolean; employee?: any }>()),
  /** 更新员工 */
  update: (id: string, data: Record<string, unknown>) =>
    put(`/employees/${id}`, data),
@@ -75,6 +81,9 @@ export const employeeApi = {
  /** 重新入职 */
  rehire: (id: string, data: Record<string, unknown>) =>
    post(`/employees/${id}/rehire`, data),
  /** 重置员工密码（管理员，重置为手机号后6位） */
  resetPassword: (id: string) =>
    post(`/employees/${id}/reset-password`).then(unwrap<any>()),
  /** 添加合同 */
  addContract: (data: Record<string, unknown>) =>
    post('/employees/contracts', data),
@@ -119,6 +128,30 @@ export const rosterApi = {
  /** 即将到期合同 */
  expiringContracts: () =>
    get('/roster/contracts/expiring').then(unwrap<any[]>()),
  /** 培训记录列表（全员） */
  trainingList: (params: { page?: number; pageSize?: number; keyword?: string; ackStatus?: string }) =>
    get('/roster/training/list', { params }).then(unwrap<any>()),
  /** 培训记录催办 */
  trainingRemind: (recordId: string) =>
    post(`/roster/training/remind/${recordId}`).then(unwrap<any>()),
  /** 绩效记录列表（全员） */
  performanceList: (params: { page?: number; pageSize?: number; keyword?: string }) =>
    get('/roster/performance/list', { params }).then(unwrap<any>()),
  /** 绩效模板列表 */
  performanceTemplates: () =>
    get('/roster/performance/templates').then(unwrap<any[]>()),
  /** 创建绩效模板 */
  createPerformanceTemplate: (data: any) =>
    post('/roster/performance/templates', data).then(unwrap<any>()),
  /** 更新绩效模板 */
  updatePerformanceTemplate: (id: string, data: any) =>
    put(`/roster/performance/templates/${id}`, data).then(unwrap<any>()),
  /** 删除绩效模板 */
  deletePerformanceTemplate: (id: string) =>
    del(`/roster/performance/templates/${id}`).then(unwrap<any>()),
  /** 违纪记录列表（全员） */
  disciplinaryList: (params: { page?: number; pageSize?: number; keyword?: string }) =>
    get('/roster/disciplinary/list', { params }).then(unwrap<any>()),
  /** 违纪记录 */
  disciplinary: (employeeId: string) =>
    get(`/roster/${employeeId}/disciplinary`).then(unwrap<any[]>()),
@@ -282,6 +315,9 @@ export const attendanceApi = {
  /** 删除请假记录 */
  removeLeave: (id: string) =>
    del(`/attendance/leaves/${id}`),
  /** 手动补卡/修正考勤 */
  manualCorrect: (data: { employeeId: string; date: string; checkInTime?: string; checkOutTime?: string; status?: string; remark?: string }) =>
    post('/attendance/manual-correct', data).then(unwrap<any>()),
 }
 // ========== 休假审批流 ==========
@@ -435,9 +471,15 @@ export const payrollApi = {
  /** 批量导入加班工时 */
  batchImportOvertime: (data: Record<string, unknown>[]) =>
    post('/payroll/overtime/batch', data),
  /** 从考勤记录同步加班工时 */
  syncOvertimeFromAttendance: (month: string) =>
    post('/payroll/overtime/sync-from-attendance', { month }).then(unwrap<any>()),
  /** 导入加班费到批次 */
  importOvertimeToBatch: (batchId: string) =>
    post(`/payroll/overtime/import-to-batch/${batchId}`).then(unwrap<any>()),
  /** 获取提成奖金到批次 */
  fetchBonusToBatch: (batchId: string) =>
    post(`/payroll2/batches/${batchId}/fetch-bonus`).then(unwrap<any>()),
  /** 加班费配置 */
  overtimeConfig: () =>
    get('/payroll/overtime/config').then(unwrap<any>()),
@@ -473,6 +515,55 @@ export const salaryDashboardApi = {
 // ========== 社保公积金相关 ==========
 // 账户管理（新）
 export const socialAccountApi = {
  /** 账户列表 */
  list: (type?: string) =>
    get('/social/accounts', { params: type ? { type } : {} }).then(unwrap<any[]>()),
  /** 新建账户 */
  create: (data: { type: string; name: string; city: string; accountNo?: string; bankName?: string; bankAccount?: string; orgName?: string; orgCode?: string; accountType?: string; isDefault?: boolean; remark?: string }) =>
    post('/social/accounts', data).then(unwrap<any>()),
  /** 编辑账户 */
  update: (id: string, data: Partial<{ type: string; name: string; city: string; accountNo: string; bankName: string; bankAccount: string; orgName: string; orgCode: string; accountType: string; isDefault: boolean; remark: string; status: string }>) =>
    put(`/social/accounts/${id}`, data).then(unwrap<any>()),
  /** 删除账户 */
  remove: (id: string) =>
    del(`/social/accounts/${id}`).then(unwrap<any>()),
  /** 设为默认 */
  setDefault: (id: string) =>
    put(`/social/accounts/${id}/default`).then(unwrap<any>()),
  /** 按账户获取年度标准列表 */
  standards: (accountId: string) =>
    get(`/social/accounts/${accountId}/standards`).then(unwrap<any[]>()),
  /** 按账户获取当前生效标准 */
  currentStandard: (accountId: string) =>
    get(`/social/accounts/${accountId}/current-standard`).then(unwrap<any>()),
  /** 按账户获取继承数据（当前标准→旧配置→null），用于新建年度标准初始值 */
  inheritConfig: (accountId: string) =>
    get(`/social/accounts/${accountId}/inherit-config`).then(unwrap<any>()),
  /** 按账户+月份获取适用标准 */
  standardByMonth: (accountId: string, month: string) =>
    get(`/social/accounts/${accountId}/standard-by-month/${month}`).then(unwrap<any>()),
  /** 新建年度标准 */
  createStandard: (accountId: string, data: any) =>
    post(`/social/accounts/${accountId}/standards`, data).then(unwrap<any>()),
  /** 按员工获取适用账户 */
  employeeAccount: (employeeId: string) =>
    get(`/social/employee-account/${employeeId}`).then(unwrap<any>()),
  /** 获取账户已关联的根部门 */
  accountDepartments: (id: string) =>
    get(`/social/accounts/${id}/departments`).then(unwrap<any[]>()),
  /** 账户关联根部门（批量） */
  linkDepartments: (id: string, departmentIds: string[]) =>
    put(`/social/accounts/${id}/departments`, { departmentIds }).then(unwrap<any>()),
  /** 按部门获取适用账户（选部门时自动带出） */
  departmentAccount: (departmentId: string) =>
    get(`/social/department-account/${departmentId}`).then(unwrap<any>()),
  /** 快速更新当前年度标准的最低工资 */
  updateMinWage: (accountId: string, minWage: number) =>
    put(`/social/accounts/${accountId}/min-wage`, { minWage }).then(unwrap<any>()),
 }
 export const socialInsuranceApi = {
  /** 城市列表 */
  cities: () =>
@@ -552,6 +643,9 @@ export const socialInsuranceApi = {
  /** 公积金活跃申报 */
  housingActiveDeclaration: (month: string) =>
    get('/social/housing/active-declaration', { params: { month } }).then(unwrap<any>()),
  /** 员工参保信息列表 */
  employeeEnrollment: (keyword?: string) =>
    get('/social/employee-enrollment', { params: keyword ? { keyword } : {} }).then(unwrap<any[]>()),
 }
 // ========== 商业保险 ==========
@@ -569,6 +663,93 @@ export const commercialInsuranceApi = {
  /** 删除方案 */
  removePlan: (id: string) =>
    del(`/commercial-insurance/plans/${id}`),
  /** 批量参保 */
  enroll: (planId: string, data: { employeeIds: string[]; premium?: number; effectiveFrom?: string }) =>
    post(`/commercial-insurance/plans/${planId}/enroll`, data),
  /** 退保 */
  terminateEnrollment: (enrollmentId: string, effectiveTo?: string) =>
    post(`/commercial-insurance/enrollments/${enrollmentId}/terminate`, { effectiveTo }),
  /** 员工商险汇总 */
  employeeSummary: () =>
    get('/commercial-insurance/employee-summary').then(unwrap<any[]>()),
 }
 // ========== 员工福利 ==========
 export const benefitApi = {
  plans: () =>
    get('/benefits/plans').then(unwrap<any[]>()),
  savePlan: (data: Record<string, unknown>, editId?: string) =>
    editId ? put(`/benefits/plans/${editId}`, data) : post('/benefits/plans', data),
  removePlan: (id: string) =>
    del(`/benefits/plans/${id}`),
  enrollments: (planId: string) =>
    get(`/benefits/plans/${planId}/enrollments`).then(unwrap<any[]>()),
  enroll: (planId: string, data: { employeeIds: string[]; effectiveFrom?: string }) =>
    post(`/benefits/plans/${planId}/enroll`, data),
  terminateEnrollment: (enrollmentId: string, effectiveTo?: string) =>
    post(`/benefits/enrollments/${enrollmentId}/terminate`, { effectiveTo }),
  employeeSummary: () =>
    get('/benefits/employee-summary').then(unwrap<any[]>()),
 }
 // ========== 电子签署（易签宝） ==========
 export const esignApi = {
  list: (params?: { status?: string; scene?: string }) =>
    get('/esign', { params: params || {} }).then(unwrap<any[]>()),
  /** 待签合同列表（按员工聚合） */
  pending: () =>
    get('/esign/pending').then(unwrap<any[]>()),
  /** 催办（生成自动登录链接） */
  remind: (employeeId: string) =>
    post('/esign/remind', { employeeId }).then(unwrap<any>()),
  /** 登记线下合同签署日期 */
  signDate: (contractId: string, signDate: string) =>
    post('/esign/sign-date', { contractId, signDate }).then(unwrap<any>()),
  create: (data: { contractId?: string; employeeId: string; documentTitle: string; documentContent?: string; remark?: string; scene?: string; templateId?: string; templateVars?: Record<string, string> }) =>
    post('/esign/create', data),
  detail: (id: string) =>
    get(`/esign/${id}`).then(unwrap<any>()),
  status: (id: string) =>
    get(`/esign/${id}/status`).then(unwrap<any>()),
  evidence: (id: string) =>
    get(`/esign/${id}/evidence`).then(unwrap<any[]>()),
  cancel: (id: string) =>
    post(`/esign/${id}/cancel`),
  /** 上传线下签署扫描件 */
  uploadPaperSign: (files: File[]) => {
    const formData = new FormData()
    files.forEach(f => formData.append('files', f))
    return post('/esign/paper-upload', formData, { headers: { 'Content-Type': 'multipart/form-data' } }).then(unwrap<any>())
  },
  /** 线下手签登记 */
  paperSign: (data: Record<string, unknown>) =>
    post('/esign/paper-sign', data).then(unwrap<any>()),
 }
 // ========== 提成奖金 ==========
 export const commissionBonusApi = {
  /** 按月查询列表 + 汇总 */
  list: (month: string) =>
    get('/commission-bonus', { params: { month } }).then(unwrap<any>()),
  /** 新增单条 */
  create: (data: { employeeId: string; month: string; amount: number; remark?: string }) =>
    post('/commission-bonus', data).then(unwrap<any>()),
  /** 更新单条 */
  update: (id: string, data: { amount?: number; remark?: string }) =>
    put(`/commission-bonus/${id}`, data).then(unwrap<any>()),
  /** 删除单条 */
  remove: (id: string) =>
    del(`/commission-bonus/${id}`).then(unwrap<any>()),
  /** 批量导入 Excel */
  import: (file: File, month: string) => {
    const formData = new FormData()
    formData.append('file', file)
    formData.append('month', month)
    return post('/commission-bonus/import', formData, { headers: { 'Content-Type': 'multipart/form-data' } }).then(unwrap<any>())
  },
  /** 模板下载 URL */
  templateUrl: '/api/v1/commission-bonus/template',
 }
 // ========== 离职相关 ==========
@@ -604,6 +785,9 @@ export const terminationApi = {
  /** 撤销 */
  cancel: (draftId: string) =>
    post(`/termination/draft/${draftId}/cancel`),
  /** 删除草稿（仅 DRAFT 和 CANCELLED 状态） */
  deleteDraft: (draftId: string) =>
    del(`/termination/draft/${draftId}`),
  /** 撤回离职记录 */
  revoke: (recordId: string) =>
    del(`/termination/${recordId}/revoke`),
@@ -616,6 +800,18 @@ export const terminationApi = {
  /** 批量预览 */
  batchPreview: (items: Record<string, unknown>[]) =>
    post('/termination/batch/preview', { items }),
  /** 上传工会回执文件 */
  uploadUnionReceipt: (draftId: string, file: File) => {
    const formData = new FormData()
    formData.append('file', file)
    return post(`/termination/draft/${draftId}/union-receipt/upload`, formData, { headers: { 'Content-Type': 'multipart/form-data' } }).then(unwrap<any>())
  },
  /** 保存工会回执信息 */
  saveUnionReceipt: (draftId: string, data: Record<string, unknown>) =>
    post(`/termination/draft/${draftId}/union-receipt`, data).then(unwrap<any>()),
  /** 获取工会回执信息 */
  getUnionReceipt: (draftId: string) =>
    get(`/termination/draft/${draftId}/union-receipt`).then(unwrap<any>()),
 }
 // ========== 制度相关 ==========
@@ -642,6 +838,9 @@ export const policiesApi = {
  /** 阅读签收统计 */
  readStats: (id: string) =>
    get(`/policies/${id}/read-stats`).then(unwrap<any>()),
  /** 催办未签收员工 */
  remind: (id: string, employeeIds?: string[]) =>
    post(`/policies/${id}/remind`, { employeeIds }).then(unwrap<any>()),
 }
 // ========== 证据链相关 ==========
@@ -653,6 +852,12 @@ export const evidenceApi = {
  /** 全量验证 */
  verifyAll: () =>
    get('/evidence/verify-all').then(unwrap<any>()),
  /** 按员工获取证据链记录 */
  byEmployee: (employeeId: string) =>
    get(`/evidence/employee/${employeeId}`).then(unwrap<any[]>()),
  /** 验证单条证据链 */
  verify: (id: string) =>
    get(`/evidence/verify/${id}`).then(unwrap<any>()),
 }
 // ========== 审计日志 ==========
@@ -747,6 +952,15 @@ export const settingsApi = {
  /** 确认退休政策生效 */
  confirmRetirementPolicy: (id: string) =>
    post(`/settings/retirement-policy/${id}/confirm`),
  /** 医疗期政策列表 */
  medicalPeriodPolicies: () =>
    get('/settings/medical-period/policies').then(unwrap<any[]>()),
  /** 保存医疗期政策 */
  saveMedicalPeriodPolicy: (data: Record<string, unknown>) =>
    post('/settings/medical-period/policies', data),
  /** 删除医疗期政策 */
  deleteMedicalPeriodPolicy: (id: string) =>
    del(`/settings/medical-period/policies/${id}`),
 }
 // ========== 模板相关 ==========
@@ -881,6 +1095,11 @@ portalAxios.interceptors.request.use((config: any) => {
  if (token) config.headers.Authorization = `Bearer ${token}`
  return config
 })
 // 与管理端 api 实例一致：response interceptor 返回 response.data（后端 JSON body）
 portalAxios.interceptors.response.use(
  (response) => response.data,
  (error) => Promise.reject(error),
 )
 const portalGet = ((url: string, config?: any) => portalAxios.get(url, config)) as any
 const portalPost = ((url: string, data?: any, config?: any) => portalAxios.post(url, data, config)) as any
@@ -897,6 +1116,9 @@ export const portalApi = {
  /** 自动登录 */
  autoLogin: (token: string) =>
    portalGet('/auto-login', { params: { token } }).then(unwrap<any>()),
  /** 修改密码（员工自己） */
  changePassword: (oldPassword: string, newPassword: string) =>
    portalPost('/change-password', { oldPassword, newPassword }).then(unwrap<any>()),
  /** 生成自动登录令牌（管理端） */
  generateAutoLoginToken: (employeeId: string) =>
    post('/portal/auto-login-token', { employeeId }).then(unwrap<any>()),
@@ -960,6 +1182,9 @@ export const portalApi = {
  /** 撤回离职申请 */
  resignationWithdraw: (id: string) =>
    portalPost(`/resignation/${id}/withdraw`).then(unwrap<any>()),
  /** 下载离职证明 */
  downloadCertificate: (id: string) =>
    portalGet(`/resignation/${id}/certificate`, { responseType: 'blob' }) as any,
  /** 我的休假申请列表 */
  myLeaves: () =>
    portalGet('/leaves').then(unwrap<any[]>()),
@@ -969,4 +1194,37 @@ export const portalApi = {
  /** 撤回休假申请 */
  cancelLeave: (id: string) =>
    portalPost(`/leaves/${id}/cancel`).then(unwrap<any>()),
  /** 我的电子签署列表 */
  myEsignList: () =>
    portalGet('/esign').then(unwrap<any[]>()),
  /** 电子签署详情 */
  esignDetail: (id: string) =>
    portalGet(`/esign/${id}`).then(unwrap<any>()),
  /** 发送签署验证码 */
  esignSendCode: (id: string) =>
    portalPost(`/esign/${id}/send-code`).then(unwrap<any>()),
  /** 签署操作（需验证码） */
  signEsign: (id: string, verifyCode: string) =>
    portalPost(`/esign/${id}/sign`, { verifyCode }).then(unwrap<any>()),
  /** 我的培训记录 */
  myTraining: () =>
    portalGet('/training').then(unwrap<any[]>()),
  /** 培训签收 */
  signTraining: (id: string) =>
    portalPost(`/training/${id}/sign`).then(unwrap<any>()),
  /** 培训拒绝签收 */
  refuseTraining: (id: string) =>
    portalPost(`/training/${id}/refuse`).then(unwrap<any>()),
  /** 我的绩效记录 */
  myPerformance: () =>
    portalGet('/performance').then(unwrap<any[]>()),
  /** 绩效签字 */
  signPerformance: (id: string) =>
    portalPost(`/performance/${id}/sign`).then(unwrap<any>()),
  /** 我的违纪记录 */
  myDisciplinary: () =>
    portalGet('/disciplinary').then(unwrap<any[]>()),
  /** 违纪签字 */
  signDisciplinary: (id: string) =>
    portalPost(`/disciplinary/${id}/sign`).then(unwrap<any>()),
 }
@@ -0,0 +1,37 @@
 import { toast } from 'sonner'
 /**
 * 复制文本到剪贴板，带 execCommand fallback
 */
 export async function copyToClipboard(text: string, successMsg = '已复制') {
  try {
    if (navigator.clipboard && window.isSecureContext) {
      await navigator.clipboard.writeText(text)
      toast.success(successMsg)
      return
    }
  } catch {
    // fall through to fallback
  }
  // fallback: execCommand('copy') + hidden textarea
  try {
    const textarea = document.createElement('textarea')
    textarea.value = text
    textarea.style.position = 'fixed'
    textarea.style.opacity = '0'
    textarea.style.left = '-9999px'
    document.body.appendChild(textarea)
    textarea.focus()
    textarea.select()
    const ok = document.execCommand('copy')
    document.body.removeChild(textarea)
    if (ok) {
      toast.success(successMsg)
    } else {
      toast.error('复制失败，请手动复制')
    }
  } catch {
    toast.error('复制失败，请手动复制')
  }
 }
@@ -0,0 +1,19 @@
 import { toast } from 'sonner'
 /**
 * 从 axios 错误中提取并显示错误信息，支持 Zod 校验失败时展示具体字段
 */
 export function toastError(err: any, fallback = '操作失败') {
  const error = err?.response?.data?.error
  if (!error) {
    toast.error(fallback)
    return
  }
  // 如果有 details（Zod 校验失败），展示具体字段
  if (error.details && Array.isArray(error.details) && error.details.length > 0) {
    const fields = error.details.map((d: any) => `${d.path || '字段'}: ${d.message}`).join('；')
    toast.error(`${error.message}：${fields}`)
    return
  }
  toast.error(error.message || fallback)
 }
@@ -0,0 +1,21 @@
 /**
 * 全局分页大小管理
 * 默认 10 条/页，用户可在系统设置中修改，存储在 localStorage
 */
 const STORAGE_KEY = 'hr-page-size'
 export const DEFAULT_PAGE_SIZE = 10
 /** 获取当前分页大小 */
 export function getPageSize(): number {
  const val = localStorage.getItem(STORAGE_KEY)
  const n = val ? parseInt(val, 10) : NaN
  return Number.isFinite(n) && n > 0 ? n : DEFAULT_PAGE_SIZE
 }
 /** 设置分页大小 */
 export function setPageSize(size: number): void {
  localStorage.setItem(STORAGE_KEY, String(size))
  window.dispatchEvent(new CustomEvent('page-size-changed'))
 }
@@ -1,5 +1,6 @@
 import { useState, lazy, Suspense } from 'react'
 import { Bot, FileSearch, Scale, Sparkles, BookOpen, TrendingUp, Loader2 } from 'lucide-react'
 import PageGuide from '../components/ui/PageGuide'
 const ChatTab = lazy(() => import('./ai-assistant/ChatTab').then(m => ({ default: m.ChatTab })))
 const PredictTab = lazy(() => import('./ai-assistant/PredictTab').then(m => ({ default: m.PredictTab })))
@@ -24,6 +25,7 @@ export default function AIAssistant() {
  return (
    <div className="space-y-4">
      <PageGuide>AI 智能助手，提供用工风险预测、案例分析、合规建议等智能服务。支持自然语言提问，系统自动匹配相关法规和案例。关联：风险预测数据来自花名册和合同信息。</PageGuide>
      <div className="flex items-center gap-2">
        <Bot className="h-5 w-5 text-primary" />
        <div>
@@ -1,13 +1,16 @@
 import { useState, useRef } from 'react'
 import { Link } from 'react-router-dom'
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
 import { toast } from 'sonner'
-import { CalendarCheck, CheckCircle, Clock, AlertCircle, Plus, Trash2, Calendar, Users, BarChart3, Plane, Upload, Download, X, Send, Loader2, CheckCheck } from 'lucide-react'
+import { CalendarCheck, CheckCircle, Clock, AlertCircle, Plus, Trash2, Calendar, Users, BarChart3, Plane, Upload, Download, X, Send, Loader2, CheckCheck, Edit } from 'lucide-react'
 import { attendanceApi, employeeApi, rosterApi } from '../lib/api-services'
 import { useAuthStore } from '../store/authStore'
 import { usePageSize } from '../hooks/usePageSize'
 import Card from '../components/ui/Card'
 import Button from '../components/ui/Button'
 import { Input, Label, Select } from '../components/ui/Input'
 import Modal from '../components/ui/Modal'
 import Pagination from '../components/ui/Pagination'
 import EmptyState from '../components/ui/EmptyState'
 import { InlineAlert } from '../components/ui/InlineAlert'
 import PageGuide from '../components/ui/PageGuide'
@@ -51,6 +54,9 @@ export default function Attendance() {
  return (
    <div className="space-y-4">
      <PageGuide>
        考勤管理，支持班次设定、排班、出勤查询、月度报表和休假记录。流程：①设置班次 → ②排班 → ③每日打卡或导入考勤 → ④月度汇总。关联：考勤数据影响薪税管理的工资和加班费计算。
      </PageGuide>
      <div>
        <div className="flex items-center gap-2">
          <CalendarCheck className="h-5 w-5 text-primary" />
@@ -80,7 +86,7 @@ export default function Attendance() {
        })}
      </div>
-      {activeTab === 'confirm' && <ConfirmTab />}
+      {activeTab === 'confirm' && <ConfirmTab onGoToTab={setActiveTab} />}
      {activeTab === 'shifts' && <ShiftsTab />}
      {activeTab === 'schedule' && <ScheduleTab />}
      {activeTab === 'daily' && <DailyTab />}
@@ -91,7 +97,7 @@ export default function Attendance() {
 }
 // ========== 考勤确认 Tab ==========
-function ConfirmTab() {
+function ConfirmTab({ onGoToTab }: { onGoToTab?: (tab: string) => void }) {
  const queryClient = useQueryClient()
  const confirm = useConfirm()
  const [month, setMonth] = useState(new Date().toISOString().slice(0, 7))
@@ -102,7 +108,12 @@ function ConfirmTab() {
  const [importResult, setImportResult] = useState<any>(null)
  const [importing, setImporting] = useState(false)
  const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set())
  const [searchQuery, setSearchQuery] = useState('')
  const [editItem, setEditItem] = useState<any>(null)
  const [editForm, setEditForm] = useState({ workDays: 0, lateCount: 0, earlyLeaveCount: 0, absentDays: 0, leaveDays: 0, overtimeHours: 0, overtimePay: 0 })
  const fileInputRef = useRef<HTMLInputElement>(null)
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const { data: list, isLoading } = useQuery<any>({
    queryKey: ['attendance', month, filterDepartment, filterStatus],
@@ -180,10 +191,33 @@ function ConfirmTab() {
    onError: (err: any) => toast.error(err?.response?.data?.error?.message || '确认失败'),
  })
  const editMutation = useMutation({
    mutationFn: async (data: any) => {
      return await attendanceApi.manualCorrect(data)
    },
    onSuccess: () => {
      toast.success('考勤记录已修改')
      queryClient.invalidateQueries({ queryKey: ['attendance'] })
      queryClient.invalidateQueries({ queryKey: ['attendance-stats'] })
      setEditItem(null)
    },
    onError: (err: any) => toast.error(err?.response?.data?.error?.message || '修改失败'),
  })
  const currentPublish = publishRecords?.find((r: any) => r.month === month && r.status === 'PUBLISHED')
  const pendingCount = stats?.pending || 0
-  const pendingItems = (list || []).filter((i: any) => i.status === 'PENDING')
+  const allList = list || []
  const filteredList = allList.filter((i: any) => {
    if (searchQuery.trim()) {
      const q = searchQuery.trim().toLowerCase()
      if (!i.employee?.name?.toLowerCase().includes(q) && !i.employee?.department?.toLowerCase().includes(q)) return false
    }
    return true
  })
  const pendingItems = filteredList.filter((i: any) => i.status === 'PENDING')
  const allPendingSelected = pendingItems.length > 0 && pendingItems.every((i: any) => selectedIds.has(i.id))
  const total = filteredList.length
  const pagedList = filteredList.slice((page - 1) * pageSize, page * pageSize)
  const toggleSelect = (id: string) => {
    const next = new Set(selectedIds)
@@ -300,6 +334,13 @@ function ConfirmTab() {
          <Button size="sm" variant="secondary" onClick={() => setShowImport(true)}>
            <Upload className="w-3.5 h-3.5 mr-1" />导入考勤
          </Button>
          <input
            type="text"
            placeholder="搜索姓名或部门"
            value={searchQuery}
            onChange={e => { setSearchQuery(e.target.value); setPage(1) }}
            className="px-3 py-1.5 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary w-44"
          />
          <select
            value={filterStatus}
            onChange={e => setFilterStatus(e.target.value)}
@@ -345,11 +386,12 @@ function ConfirmTab() {
      {isLoading ? (
        <div className="text-center py-8 text-gray-500">加载中...</div>
-      ) : !list || list.length === 0 ? (
+      ) : total === 0 ? (
        <EmptyState title="本月暂无考勤确认记录" description="请先批量导入考勤数据" />
      ) : (
        <>
        <div className="space-y-2">
-          {list.map((item: any) => {
+          {pagedList.map((item: any) => {
            const config = STATUS_CONFIG[item.status] || STATUS_CONFIG.PENDING
            const StatusIcon = config.icon
            const isSelected = selectedIds.has(item.id)
@@ -387,6 +429,7 @@ function ConfirmTab() {
                  </div>
                  <div className="flex items-center gap-2 flex-shrink-0">
                    {item.status === 'PENDING' && (
                      <>
                        <button
                          className="text-xs text-primary hover:underline"
                          onClick={() => singleConfirmMutation.mutate(item.id)}
@@ -394,6 +437,24 @@ function ConfirmTab() {
                        >
                          确认
                        </button>
                        <button
                          className="text-xs text-gray-500 hover:text-primary"
                          onClick={() => {
                            setEditItem(item)
                            setEditForm({
                              workDays: item.workDays || 0,
                              lateCount: item.lateCount || 0,
                              earlyLeaveCount: item.earlyLeaveCount || 0,
                              absentDays: item.absentDays || 0,
                              leaveDays: item.leaveDays || 0,
                              overtimeHours: (item.weekdayHours || 0) + (item.weekendHours || 0) + (item.holidayHours || 0),
                              overtimePay: item.overtimePay || 0,
                            })
                          }}
                        >
                          编辑
                        </button>
                      </>
                    )}
                    <div className={`flex items-center gap-1 px-2 py-1 rounded-lg ${config.bg} ${config.color}`}>
                      <StatusIcon className="w-3.5 h-3.5" />
@@ -405,6 +466,63 @@ function ConfirmTab() {
            )
          })}
        </div>
        {editItem && (
          <div className="fixed inset-0 bg-black/30 flex items-center justify-center z-50 p-4" onClick={() => setEditItem(null)}>
            <Card className="max-w-md w-full" >
              <div onClick={(e) => e.stopPropagation()} className="p-4">
                <div className="flex items-center justify-between mb-3">
                  <h2 className="text-sm font-medium">编辑考勤 — {editItem.employee?.name}</h2>
                  <button onClick={() => setEditItem(null)} className="text-gray-400 hover:text-gray-600"><X className="w-4 h-4" /></button>
                </div>
                <div className="grid grid-cols-2 gap-3">
                  <div>
                    <label className="text-xs text-gray-500">出勤天数</label>
                    <input type="number" min="0" className="w-full px-2 py-1.5 text-sm border rounded-md" value={editForm.workDays}
                      onChange={(e) => setEditForm({ ...editForm, workDays: Number(e.target.value) })} />
                  </div>
                  <div>
                    <label className="text-xs text-gray-500">迟到次数</label>
                    <input type="number" min="0" className="w-full px-2 py-1.5 text-sm border rounded-md" value={editForm.lateCount}
                      onChange={(e) => setEditForm({ ...editForm, lateCount: Number(e.target.value) })} />
                  </div>
                  <div>
                    <label className="text-xs text-gray-500">早退次数</label>
                    <input type="number" min="0" className="w-full px-2 py-1.5 text-sm border rounded-md" value={editForm.earlyLeaveCount}
                      onChange={(e) => setEditForm({ ...editForm, earlyLeaveCount: Number(e.target.value) })} />
                  </div>
                  <div>
                    <label className="text-xs text-gray-500">缺勤天数</label>
                    <input type="number" min="0" className="w-full px-2 py-1.5 text-sm border rounded-md" value={editForm.absentDays}
                      onChange={(e) => setEditForm({ ...editForm, absentDays: Number(e.target.value) })} />
                  </div>
                  <div>
                    <label className="text-xs text-gray-500">请假天数</label>
                    <input type="number" min="0" className="w-full px-2 py-1.5 text-sm border rounded-md" value={editForm.leaveDays}
                      onChange={(e) => setEditForm({ ...editForm, leaveDays: Number(e.target.value) })} />
                  </div>
                  <div>
                    <label className="text-xs text-gray-500">加班工时</label>
                    <input type="number" min="0" step="0.5" className="w-full px-2 py-1.5 text-sm border rounded-md" value={editForm.overtimeHours}
                      onChange={(e) => setEditForm({ ...editForm, overtimeHours: Number(e.target.value) })} />
                  </div>
                  <div className="col-span-2">
                    <label className="text-xs text-gray-500">加班费（元）</label>
                    <input type="number" min="0" step="0.01" className="w-full px-2 py-1.5 text-sm border rounded-md" value={editForm.overtimePay}
                      onChange={(e) => setEditForm({ ...editForm, overtimePay: Number(e.target.value) })} />
                  </div>
                </div>
                <div className="flex justify-end gap-2 mt-4">
                  <Button size="sm" variant="secondary" onClick={() => setEditItem(null)}>取消</Button>
                  <Button size="sm" onClick={() => editMutation.mutate({ employeeId: editItem.employeeId, month, ...editForm })} disabled={editMutation.isPending}>
                    {editMutation.isPending ? '保存中...' : '保存'}
                  </Button>
                </div>
              </div>
            </Card>
          </div>
        )}
        <Pagination page={page} pageSize={pageSize} total={total} onPageChange={setPage} onPageSizeChange={() => setPage(1)} />
        </>
      )}
      {/* 导入考勤弹窗 */}
@@ -423,14 +541,14 @@ function ConfirmTab() {
                    try {
                      const token = useAuthStore.getState().accessToken
                      const baseURL = import.meta.env.DEV ? 'http://localhost:3000/api/v1' : '/api/v1'
-                      const res = await fetch(`${baseURL}/import/template`, {
+                      const res = await fetch(`${baseURL}/import/monthly-template`, {
                        headers: token ? { Authorization: `Bearer ${token}` } : {},
                      })
                      const blob = await res.blob()
                      const url = URL.createObjectURL(blob)
                      const a = document.createElement('a')
                      a.href = url
-                      a.download = '员工导入模板.xlsx'
+                      a.download = '考勤月度导入模板.xlsx'
                      a.click()
                      URL.revokeObjectURL(url)
                    } catch { toast.error('下载模板失败') }
@@ -440,7 +558,7 @@ function ConfirmTab() {
                </div>
                <div className="text-xs text-gray-500 bg-blue-50/50 rounded-md p-2">
-                  模板中「考勤记录」Sheet 包含：姓名、身份证号、日期、考勤状态、上下班时间。身份证号优先匹配，未填时用姓名匹配。
+                  模板中「考勤与加班」Sheet 包含：姓名、证件号码、日期、考勤状态、上下班时间、各类加班时长。证件号码优先匹配，未填时用姓名匹配。加班时长为0的行只导入考勤。
                </div>
                <div className="border-2 border-dashed border-gray-200 rounded-lg p-6 text-center">
@@ -455,6 +573,10 @@ function ConfirmTab() {
                    <div className="font-medium">导入完成</div>
                    {importResult.attendance > 0 && <div>考勤记录：{importResult.attendance} 条</div>}
                    {importResult.overtime > 0 && <div>加班记录：{importResult.overtime} 条</div>}
                    {importResult.discipline > 0 && <div>违纪记录：{importResult.discipline} 条</div>}
                    {importResult.salaryChanges > 0 && <div>薪资调整：{importResult.salaryChanges} 条</div>}
                    {importResult.socialInsChanges > 0 && <div>社保变动：{importResult.socialInsChanges} 条</div>}
                    {importResult.housingFundChanges > 0 && <div>公积金变动：{importResult.housingFundChanges} 条</div>}
                    {importResult.employees > 0 && <div>员工：{importResult.employees} 人</div>}
                    {importResult.contracts > 0 && <div>合同：{importResult.contracts} 份</div>}
                    {importResult.skipped > 0 && <div className="text-amber-600">跳过 {importResult.skipped} 条</div>}
@@ -464,6 +586,12 @@ function ConfirmTab() {
                        {importResult.errors.length > 5 && <div className="text-amber-600">...还有 {importResult.errors.length - 5} 条</div>}
                      </div>
                    )}
                    <button
                      className="mt-1 text-primary hover:underline font-medium"
                      onClick={() => { setShowImport(false); setImportFile(null); setImportResult(null); onGoToTab?.('confirm') }}
                    >
                      点击查看考勤确认 →
                    </button>
                  </div>
                )}
@@ -629,6 +757,10 @@ function ScheduleTab() {
  const [selectedShiftId, setSelectedShiftId] = useState('')
  const [selectedEmployeeIds, setSelectedEmployeeIds] = useState<Set<string>>(new Set())
  const [searchQuery, setSearchQuery] = useState('')
  const [filterDept, setFilterDept] = useState('')
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const [inlineShiftId, setInlineShiftId] = useState<Record<string, string>>({})
  const { data: shifts } = useQuery<any>({
    queryKey: ['shifts'],
@@ -678,9 +810,20 @@ function ScheduleTab() {
    batchAssignMutation.mutate(items)
  }
-  const employees = dailyData || []
+  const allEmployees = dailyData || []
  const assignmentMap: Map<string, any> = new Map((assignments || []).map((a: any) => [a.employeeId, a]))
  const filteredEmployees = allEmployees.filter((emp: any) => {
    if (filterDept && emp.department !== filterDept) return false
    if (searchQuery.trim()) {
      const q = searchQuery.trim().toLowerCase()
      if (!emp.name?.toLowerCase().includes(q) && !emp.department?.toLowerCase().includes(q)) return false
    }
    return true
  })
  const total = filteredEmployees.length
  const employees = filteredEmployees.slice((page - 1) * pageSize, page * pageSize)
  const toggleEmployee = (id: string) => {
    const next = new Set(selectedEmployeeIds)
    if (next.has(id)) next.delete(id)
@@ -688,18 +831,43 @@ function ScheduleTab() {
    setSelectedEmployeeIds(next)
  }
  const handleInlineAssign = (employeeId: string) => {
    const shiftId = inlineShiftId[employeeId]
    if (!shiftId) return toast.error('请先选择班次')
    batchAssignMutation.mutate([{ employeeId, shiftId, date }])
  }
  return (
    <div className="space-y-3">
      <PageGuide>
        排班用于按日期为员工分配班次。选择日期后可查看当日排班情况，点击「排班」按钮为员工分配班次。支持批量排班和复制排班。
      </PageGuide>
-      <div className="flex items-center justify-between">
+      <div className="flex flex-wrap items-center justify-between gap-2">
        <div className="flex items-center gap-2">
          <input
            type="date"
            value={date}
-          onChange={e => setDate(e.target.value)}
+            onChange={e => { setDate(e.target.value); setPage(1) }}
            className="px-3 py-1.5 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary"
          />
          <input
            type="text"
            placeholder="搜索姓名或部门"
            value={searchQuery}
            onChange={e => { setSearchQuery(e.target.value); setPage(1) }}
            className="px-3 py-1.5 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary w-44"
          />
          <select
            value={filterDept}
            onChange={e => { setFilterDept(e.target.value); setPage(1) }}
            className="h-9 rounded-md border border-gray-200 bg-white px-3 text-sm"
          >
            <option value="">全部部门</option>
            {Array.from(new Set(allEmployees.map((e: any) => e.department).filter(Boolean) as string[])).map(d => (
              <option key={d} value={d}>{d}</option>
            ))}
          </select>
        </div>
        <Button onClick={() => setShowAssign(true)}>
          <Plus className="w-4 h-4 mr-1" />批量排班
        </Button>
@@ -707,9 +875,10 @@ function ScheduleTab() {
      {isLoading ? (
        <div className="text-center py-8 text-gray-500">加载中...</div>
-      ) : employees.length === 0 ? (
+      ) : total === 0 ? (
        <EmptyState title="暂无员工" description="没有可排班的员工" />
      ) : (
        <>
        <Card className="overflow-hidden p-0">
          <table className="w-full text-sm">
            <thead className="bg-gray-50/90">
@@ -717,7 +886,7 @@ function ScheduleTab() {
                <th className="px-4 py-3 text-left">姓名</th>
                <th className="px-4 py-3 text-left">部门</th>
                <th className="px-4 py-3 text-left">班次</th>
-                <th className="px-4 py-3 text-center">操作</th>
+                <th className="px-4 py-3 text-center w-48">操作</th>
              </tr>
            </thead>
            <tbody>
@@ -726,7 +895,7 @@ function ScheduleTab() {
                return (
                  <tr key={emp.employeeId} className="border-b border-gray-100 last:border-0">
                    <td className="px-4 py-3 font-medium">{emp.name}</td>
-                    <td className="px-4 py-3 text-gray-500">{emp.department}</td>
+                    <td className="px-4 py-3 text-gray-500">{emp.department || '未分配'}</td>
                    <td className="px-4 py-3">
                      {assignment ? (
                        <span className="inline-flex items-center gap-1.5 px-2 py-0.5 rounded text-xs" style={{ background: (assignment.shift as any)?.color + '20', color: (assignment.shift as any)?.color }}>
@@ -737,10 +906,29 @@ function ScheduleTab() {
                        <span className="text-xs text-gray-400">未排班</span>
                      )}
                    </td>
-                    <td className="px-4 py-3 text-center">
+                    <td className="px-4 py-3">
-                      {assignment && (
+                      <div className="flex items-center justify-center gap-1">
                        {assignment ? (
                          <button className="text-xs text-gray-400 hover:text-red-500" onClick={() => deleteAssignmentMutation.mutate(assignment.id)}>移除</button>
                        ) : (
                          <>
                            <select
                              value={inlineShiftId[emp.employeeId] || ''}
                              onChange={e => setInlineShiftId(prev => ({ ...prev, [emp.employeeId]: e.target.value }))}
                              className="h-7 rounded border border-gray-200 text-xs px-1 max-w-[100px]"
                            >
                              <option value="">选班次</option>
                              {(shifts || []).map((s: any) => (
                                <option key={s.id} value={s.id}>{s.name}</option>
                              ))}
                            </select>
                            <button
                              className="text-xs text-primary hover:underline whitespace-nowrap"
                              onClick={() => handleInlineAssign(emp.employeeId)}
                            >排班</button>
                          </>
                        )}
                      </div>
                    </td>
                  </tr>
                )
@@ -748,6 +936,8 @@ function ScheduleTab() {
            </tbody>
          </table>
        </Card>
        <Pagination page={page} pageSize={pageSize} total={total} onPageChange={setPage} onPageSizeChange={() => setPage(1)} />
        </>
      )}
      <Modal open={showAssign} onClose={() => setShowAssign(false)} title="批量排班">
@@ -771,11 +961,7 @@ function ScheduleTab() {
              className="w-full px-3 py-2 mb-2 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary"
            />
            <div className="max-h-60 overflow-y-auto border rounded-lg divide-y">
-              {employees.filter((emp: any) => {
+              {filteredEmployees.map((emp: any) => (
                if (!searchQuery.trim()) return true
                const q = searchQuery.trim().toLowerCase()
                return emp.name?.toLowerCase().includes(q) || emp.department?.toLowerCase().includes(q)
              }).map((emp: any) => (
                <label key={emp.employeeId} className="flex items-center gap-2 px-3 py-2 hover:bg-gray-50 cursor-pointer">
                  <input type="checkbox" checked={selectedEmployeeIds.has(emp.employeeId)} onChange={() => toggleEmployee(emp.employeeId)} />
                  <span className="text-sm">{emp.name}</span>
@@ -796,7 +982,14 @@ function ScheduleTab() {
 // ========== 每日出勤 Tab ==========
 function DailyTab() {
  const queryClient = useQueryClient()
  const [date, setDate] = useState(new Date().toISOString().slice(0, 10))
  const [editEmp, setEditEmp] = useState<any>(null)
  const [editForm, setEditForm] = useState({ checkInTime: '', checkOutTime: '', status: 'NORMAL', remark: '' })
  const [searchQuery, setSearchQuery] = useState('')
  const [filterDept, setFilterDept] = useState('')
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const { data, isLoading } = useQuery<any>({
    queryKey: ['daily-attendance', date],
@@ -805,6 +998,16 @@ function DailyTab() {
    },
  })
  const correctMutation = useMutation({
    mutationFn: (data: any) => attendanceApi.manualCorrect(data),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['daily-attendance'] })
      toast.success('考勤记录已修正')
      setEditEmp(null)
    },
    onError: () => toast.error('修正失败'),
  })
  const statusColors: Record<string, string> = {
    NORMAL: 'bg-green-50 text-green-700',
    LATE: 'bg-amber-50 text-amber-700',
@@ -815,25 +1018,75 @@ function DailyTab() {
    UNREGISTERED: 'bg-gray-100 text-gray-500',
  }
  const allData = data || []
  const filteredData = allData.filter((emp: any) => {
    if (filterDept && emp.department !== filterDept) return false
    if (searchQuery.trim()) {
      const q = searchQuery.trim().toLowerCase()
      if (!emp.name?.toLowerCase().includes(q) && !emp.department?.toLowerCase().includes(q)) return false
    }
    return true
  })
  const total = filteredData.length
  const pagedData = filteredData.slice((page - 1) * pageSize, page * pageSize)
  return (
    <div className="space-y-3">
      <PageGuide>
        每日出勤记录展示当日所有员工的打卡情况，包括上班/下班时间、迟到/早退/缺卡状态。可手动补卡或修正异常记录。
      </PageGuide>
-      <div className="flex justify-end">
+      <div className="flex flex-wrap items-center justify-between gap-2">
        <div className="flex items-center gap-2">
          <input
            type="date"
            value={date}
            onChange={e => setDate(e.target.value)}
            className="px-3 py-1.5 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary"
          />
          <input
            type="text"
            placeholder="搜索姓名或部门"
            value={searchQuery}
            onChange={e => { setSearchQuery(e.target.value); setPage(1) }}
            className="px-3 py-1.5 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary w-44"
          />
          <select
            value={filterDept}
            onChange={e => { setFilterDept(e.target.value); setPage(1) }}
            className="h-9 rounded-md border border-gray-200 bg-white px-3 text-sm"
          >
            <option value="">全部部门</option>
            {Array.from(new Set(allData.map((e: any) => e.department).filter(Boolean) as string[])).map(d => (
              <option key={d} value={d}>{d}</option>
            ))}
          </select>
        </div>
        <Button variant="secondary" size="sm" onClick={() => {
          if (!data || data.length === 0) return
          const headers = ['姓名', '部门', '班次', '签到', '签退', '状态', '工时']
          const rows = data.map((emp: any) => [
            emp.name, emp.department, emp.shift?.name || '', emp.checkInTime || '', emp.checkOutTime || '',
            ATTENDANCE_STATUS[emp.status] || emp.status, emp.workHours > 0 ? `${emp.workHours}h` : '0',
          ])
          const csv = [headers, ...rows].map(r => r.join(',')).join('\n')
          const blob = new Blob(['\ufeff' + csv], { type: 'text/csv;charset=utf-8' })
          const url = URL.createObjectURL(blob)
          const a = document.createElement('a')
          a.href = url
          a.download = `考勤-${date}.csv`
          a.click()
          URL.revokeObjectURL(url)
        }} disabled={!data || data.length === 0}>
          <Download className="w-4 h-4 mr-1" />导出
        </Button>
      </div>
      {isLoading ? (
        <div className="text-center py-8 text-gray-500">加载中...</div>
-      ) : !data || data.length === 0 ? (
+      ) : total === 0 ? (
        <EmptyState title="暂无员工" description="没有出勤数据" />
      ) : (
        <>
        <Card className="overflow-hidden p-0">
          <table className="w-full text-sm">
            <thead className="bg-gray-50/90">
@@ -845,27 +1098,91 @@ function DailyTab() {
                <th className="px-4 py-3 text-left">签退</th>
                <th className="px-4 py-3 text-left">状态</th>
                <th className="px-4 py-3 text-right">工时</th>
                <th className="px-4 py-3 text-center">操作</th>
              </tr>
            </thead>
            <tbody>
-              {data.map((emp: any) => (
+              {pagedData.map((emp: any) => (
                <tr key={emp.employeeId} className="border-b border-gray-100 last:border-0">
                  <td className="px-4 py-3 font-medium">{emp.name}</td>
                  <td className="px-4 py-3 text-gray-500">{emp.department}</td>
                  <td className="px-4 py-3 text-xs text-gray-500">{emp.shift ? `${emp.shift.name}` : '—'}</td>
-                  <td className="px-4 py-3 text-xs font-mono">{emp.checkInTime || '—'}</td>
+                  <td className="px-4 py-3 text-xs font-mono">{emp.checkInTime ? (() => { const d = new Date(emp.checkInTime); return `${String(d.getUTCHours()).padStart(2,'0')}:${String(d.getUTCMinutes()).padStart(2,'0')}`; })() : '—'}</td>
-                  <td className="px-4 py-3 text-xs font-mono">{emp.checkOutTime || '—'}</td>
+                  <td className="px-4 py-3 text-xs font-mono">{emp.checkOutTime ? (() => { const d = new Date(emp.checkOutTime); return `${String(d.getUTCHours()).padStart(2,'0')}:${String(d.getUTCMinutes()).padStart(2,'0')}`; })() : '—'}</td>
                  <td className="px-4 py-3">
                    <span className={`px-2 py-0.5 rounded text-xs ${statusColors[emp.status] || 'bg-gray-100 text-gray-500'}`}>
                      {ATTENDANCE_STATUS[emp.status] || emp.status}
                    </span>
                  </td>
                  <td className="px-4 py-3 text-right text-xs">{emp.workHours > 0 ? `${emp.workHours}h` : '—'}</td>
                  <td className="px-4 py-3 text-center">
                    <button
                      className="text-xs text-primary hover:underline"
                      onClick={() => {
                        setEditEmp(emp)
                        const fmtTime = (t: string) => { if (!t) return ''; const d = new Date(t); return `${String(d.getUTCHours()).padStart(2,'0')}:${String(d.getUTCMinutes()).padStart(2,'0')}` }
                        setEditForm({
                          checkInTime: fmtTime(emp.checkInTime),
                          checkOutTime: fmtTime(emp.checkOutTime),
                          status: emp.status || 'NORMAL',
                          remark: '',
                        })
                      }}
                    >
                      <Edit className="w-3.5 h-3.5 inline" /> 补卡
                    </button>
                  </td>
                </tr>
              ))}
            </tbody>
          </table>
        </Card>
        <Pagination page={page} pageSize={pageSize} total={total} onPageChange={setPage} onPageSizeChange={() => setPage(1)} />
        </>
      )}
      {/* 补卡弹窗 */}
      {editEmp && (
        <Modal open onClose={() => setEditEmp(null)}>
          <div className="space-y-4">
            <div className="flex items-center justify-between">
              <h3 className="font-medium">考勤修正 - {editEmp.name}</h3>
              <button onClick={() => setEditEmp(null)} className="text-gray-500 hover:text-gray-600">
                <X className="w-5 h-5" />
              </button>
            </div>
            <div className="text-xs text-gray-500">日期：{date}</div>
            <div className="grid grid-cols-2 gap-3">
              <div>
                <Label>签到时间</Label>
                <Input type="time" value={editForm.checkInTime} onChange={(e) => setEditForm({ ...editForm, checkInTime: e.target.value })} />
              </div>
              <div>
                <Label>签退时间</Label>
                <Input type="time" value={editForm.checkOutTime} onChange={(e) => setEditForm({ ...editForm, checkOutTime: e.target.value })} />
              </div>
              <div className="col-span-2">
                <Label>考勤状态</Label>
                <Select value={editForm.status} onChange={(e) => setEditForm({ ...editForm, status: e.target.value })}>
                  <option value="NORMAL">正常</option>
                  <option value="LATE">迟到</option>
                  <option value="EARLY_LEAVE">早退</option>
                  <option value="ABSENT">缺勤</option>
                  <option value="LEAVE">请假</option>
                  <option value="BUSINESS_TRIP">出差</option>
                  <option value="UNREGISTERED">未打卡</option>
                </Select>
              </div>
              <div className="col-span-2">
                <Label>备注</Label>
                <Input value={editForm.remark} onChange={(e) => setEditForm({ ...editForm, remark: e.target.value })} placeholder="补卡原因/备注" />
              </div>
            </div>
            <Button onClick={() => correctMutation.mutate({ employeeId: editEmp.employeeId, date, ...editForm })} disabled={correctMutation.isPending} className="w-full">
              {correctMutation.isPending ? '提交中...' : '确认修正'}
            </Button>
          </div>
        </Modal>
      )}
    </div>
  )
@@ -874,6 +1191,10 @@ function DailyTab() {
 // ========== 月度报表 Tab ==========
 function MonthlyTab() {
  const [month, setMonth] = useState(new Date().toISOString().slice(0, 7))
  const [searchQuery, setSearchQuery] = useState('')
  const [filterDept, setFilterDept] = useState('')
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const { data, isLoading } = useQuery<any>({
    queryKey: ['monthly-report', month],
@@ -899,18 +1220,75 @@ function MonthlyTab() {
    URL.revokeObjectURL(url)
  }
  const handleExportSingle = (r: any) => {
    const headers = ['项目', '数值']
    const rows = [
      ['姓名', r.name],
      ['部门', r.department],
      ['月份', month],
      ['出勤天数', r.workDays],
      ['迟到次数', r.lateCount],
      ['早退次数', r.earlyLeaveCount],
      ['缺勤天数', r.absentDays],
      ['请假天数', r.leaveDays],
      ['加班工时', r.overtimeHours?.toFixed(1) || '0'],
      ['加班费', `¥${r.overtimePay?.toFixed(2) || '0.00'}`],
      ['确认状态', r.confirmationStatus === 'CONFIRMED' ? '已确认' : r.confirmationStatus === 'PENDING' ? '待确认' : r.confirmationStatus === 'DISPUTED' ? '有异议' : '未创建'],
    ]
    const csv = [headers, ...rows].map(row => row.join(',')).join('\n')
    const blob = new Blob(['\ufeff' + csv], { type: 'text/csv;charset=utf-8' })
    const url = URL.createObjectURL(blob)
    const a = document.createElement('a')
    a.href = url
    a.download = `考勤明细-${r.name}-${month}.csv`
    a.click()
    URL.revokeObjectURL(url)
    toast.success(`已导出 ${r.name} 的 ${month} 月考勤明细`)
  }
  const allData = data || []
  const filteredData = allData.filter((r: any) => {
    if (filterDept && r.department !== filterDept) return false
    if (searchQuery.trim()) {
      const q = searchQuery.trim().toLowerCase()
      if (!r.name?.toLowerCase().includes(q) && !r.department?.toLowerCase().includes(q)) return false
    }
    return true
  })
  const total = filteredData.length
  const pagedData = filteredData.slice((page - 1) * pageSize, page * pageSize)
  return (
    <div className="space-y-3">
      <PageGuide>
        月度报表汇总当月各员工的出勤天数、迟到次数、加班时长等统计数据。可导出月度考勤表用于发薪参考。
      </PageGuide>
-      <div className="flex items-center justify-between">
+      <div className="flex flex-wrap items-center justify-between gap-2">
        <div className="flex items-center gap-2">
          <input
            type="month"
            value={month}
            onChange={e => setMonth(e.target.value)}
            className="px-3 py-1.5 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary"
          />
          <input
            type="text"
            placeholder="搜索姓名或部门"
            value={searchQuery}
            onChange={e => { setSearchQuery(e.target.value); setPage(1) }}
            className="px-3 py-1.5 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary w-44"
          />
          <select
            value={filterDept}
            onChange={e => { setFilterDept(e.target.value); setPage(1) }}
            className="h-9 rounded-md border border-gray-200 bg-white px-3 text-sm"
          >
            <option value="">全部部门</option>
            {Array.from(new Set(allData.map((e: any) => e.department).filter(Boolean) as string[])).map(d => (
              <option key={d} value={d}>{d}</option>
            ))}
          </select>
        </div>
        <Button variant="secondary" onClick={handleExport} disabled={!data || data.length === 0}>
          <BarChart3 className="w-4 h-4 mr-1" />导出 CSV
        </Button>
@@ -918,9 +1296,10 @@ function MonthlyTab() {
      {isLoading ? (
        <div className="text-center py-8 text-gray-500">加载中...</div>
-      ) : !data || data.length === 0 ? (
+      ) : total === 0 ? (
        <EmptyState title="暂无报表数据" description="该月份没有出勤数据" />
      ) : (
        <>
        <Card className="overflow-hidden p-0">
          <table className="w-full text-sm">
            <thead className="bg-gray-50/90">
@@ -935,10 +1314,11 @@ function MonthlyTab() {
                <th className="px-4 py-3 text-center">加班(h)</th>
                <th className="px-4 py-3 text-right">加班费</th>
                <th className="px-4 py-3 text-center">确认</th>
                <th className="px-4 py-3 text-center">操作</th>
              </tr>
            </thead>
            <tbody>
-              {data.map((r: any) => (
+              {pagedData.map((r: any) => (
                <tr key={r.employeeId} className="border-b border-gray-100 last:border-0">
                  <td className="px-4 py-3 font-medium">{r.name}</td>
                  <td className="px-4 py-3 text-gray-500">{r.department}</td>
@@ -955,11 +1335,21 @@ function MonthlyTab() {
                      : r.confirmationStatus === 'DISPUTED' ? <span className="text-xs text-red-600">有异议</span>
                      : <span className="text-xs text-gray-400">—</span>}
                  </td>
                  <td className="px-4 py-3 text-center">
                    <button
                      className="text-xs text-primary hover:underline"
                      onClick={() => handleExportSingle(r)}
                    >
                      导出
                    </button>
                  </td>
                </tr>
              ))}
            </tbody>
          </table>
        </Card>
        <Pagination page={page} pageSize={pageSize} total={total} onPageChange={setPage} onPageSizeChange={() => setPage(1)} />
        </>
      )}
    </div>
  )
@@ -971,6 +1361,9 @@ function LeavesTab() {
  const confirm = useConfirm()
  const [showAdd, setShowAdd] = useState(false)
  const [form, setForm] = useState({ employeeId: '', leaveType: 'PERSONAL', startDate: '', endDate: '', days: 1, reason: '', remark: '' })
  const [searchQuery, setSearchQuery] = useState('')
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const { data: leaves, isLoading } = useQuery<any>({
    queryKey: ['leave-records'],
@@ -1006,13 +1399,34 @@ function LeavesTab() {
  }
  const employees = rosterData || []
  const allLeaves = leaves || []
  const filteredLeaves = allLeaves.filter((lv: any) => {
    if (searchQuery.trim()) {
      const q = searchQuery.trim().toLowerCase()
      if (!lv.employee?.name?.toLowerCase().includes(q) && !lv.employee?.department?.toLowerCase().includes(q)) return false
    }
    return true
  })
  const total = filteredLeaves.length
  const pagedLeaves = filteredLeaves.slice((page - 1) * pageSize, page * pageSize)
  return (
    <div className="space-y-3">
      <PageGuide>
        休假记录管理员工的请假信息，包括事假、病假、年假等。可手动录入休假记录，系统自动计算天数并关联考勤数据。
      </PageGuide>
-      <div className="flex justify-end">
+      <div className="flex justify-end items-center gap-3">
        <input
          type="text"
          placeholder="搜索姓名或部门"
          value={searchQuery}
          onChange={e => { setSearchQuery(e.target.value); setPage(1) }}
          className="px-3 py-1.5 text-sm border rounded-lg focus:outline-none focus:ring-2 focus:ring-primary w-44"
        />
        <Link to="/leave-approval" className="text-xs text-primary hover:underline flex items-center gap-1">
          <Plane className="w-3.5 h-3.5" />
          前往休假审批
        </Link>
        <Button onClick={() => setShowAdd(true)}>
          <Plus className="w-4 h-4 mr-1" />新增休假记录
        </Button>
@@ -1020,11 +1434,12 @@ function LeavesTab() {
      {isLoading ? (
        <div className="text-center py-8 text-gray-500">加载中...</div>
-      ) : !leaves || leaves.length === 0 ? (
+      ) : total === 0 ? (
        <EmptyState title="暂无休假记录" description="点击右上角添加休假记录" />
      ) : (
        <>
        <div className="space-y-2">
-          {leaves.map((lv: any) => (
+          {pagedLeaves.map((lv: any) => (
            <Card key={lv.id}>
              <div className="flex items-center justify-between">
                <div className="flex items-center gap-3 flex-1 min-w-0">
@@ -1050,6 +1465,8 @@ function LeavesTab() {
            </Card>
          ))}
        </div>
        <Pagination page={page} pageSize={pageSize} total={total} onPageChange={setPage} onPageSizeChange={() => setPage(1)} />
        </>
      )}
      <Modal open={showAdd} onClose={() => setShowAdd(false)} title="新增休假记录">
@@ -1,4 +1,5 @@
 import { useState } from 'react'
 import { usePageSize } from '../hooks/usePageSize'
 import { useQuery } from '@tanstack/react-query'
 import { ScrollText } from 'lucide-react'
 import { auditApi } from '../lib/api-services'
@@ -6,6 +7,7 @@ import Card from '../components/ui/Card'
 import Button from '../components/ui/Button'
 import EmptyState from '../components/ui/EmptyState'
 import Pagination from '../components/ui/Pagination'
 import PageGuide from '../components/ui/PageGuide'
 const ACTION_LABELS: Record<string, string> = {
  CREATE: '创建',
@@ -118,8 +120,8 @@ function formatDetail(detail: any): string {
 * 系统操作日志页面
 */
 export default function AuditLog() {
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const [pageSize, setPageSize] = useState(20)
  const [action, setAction] = useState('')
  const [entity, setEntity] = useState('')
  const [dateFrom, setDateFrom] = useState('')
@@ -146,6 +148,7 @@ export default function AuditLog() {
  return (
    <div className="space-y-3">
      <PageGuide>审计日志，记录系统中所有关键操作，包括员工档案变更、合同签订、薪酬调整、权限变更等。支持按操作类型、时间范围、操作人筛选查看，用于合规追溯。</PageGuide>
      <div className="flex items-center gap-2">
        <ScrollText className="h-5 w-5 text-primary" />
        <h1 className="text-base font-semibold">系统操作日志</h1>
@@ -236,7 +239,7 @@ export default function AuditLog() {
            pageSize={pageSize}
            total={data.total}
            onPageChange={setPage}
-            onPageSizeChange={(s) => { setPageSize(s); setPage(1) }}
+            onPageSizeChange={() => setPage(1)}
          />
        </>
      )}
@@ -2,11 +2,12 @@ import { useState, useMemo } from 'react'
 import { toast } from 'sonner'
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
 import { Link } from 'react-router-dom'
-import { CalendarDays, Plus, Trash2, ChevronLeft, ChevronRight, X } from 'lucide-react'
+import { CalendarDays, Plus, Trash2, ChevronLeft, ChevronRight, X, AlertCircle, Clock, Bell } from 'lucide-react'
 import { dashboardApi, calendarApi } from '../lib/api-services'
 import Card from '../components/ui/Card'
 import Button from '../components/ui/Button'
 import { Input, Label } from '../components/ui/Input'
 import PageGuide from '../components/ui/PageGuide'
 const EVENT_TYPE_COLORS: Record<string, string> = {
  CONTRACT_EXPIRY: 'bg-red-100 text-red-700 border-red-200',
@@ -15,6 +16,7 @@ const EVENT_TYPE_COLORS: Record<string, string> = {
  ANNIVERSARY: 'bg-green-100 text-green-700 border-green-200',
  RISK_DEADLINE: 'bg-orange-100 text-orange-700 border-orange-200',
  RETIREMENT: 'bg-purple-100 text-purple-700 border-purple-200',
  PAYROLL_DAY: 'bg-emerald-100 text-emerald-700 border-emerald-200',
  CUSTOM: 'bg-blue-100 text-blue-700 border-blue-200',
  MEETING: 'bg-cyan-100 text-cyan-700 border-cyan-200',
  TEAM_BUILDING: 'bg-pink-100 text-pink-700 border-pink-200',
@@ -29,6 +31,7 @@ const EVENT_TYPE_LABELS: Record<string, string> = {
  ANNIVERSARY: '入职周年',
  RISK_DEADLINE: '风险截止',
  RETIREMENT: '退休',
  PAYROLL_DAY: '发薪日',
  CUSTOM: '自定义',
  MEETING: '会议',
  TEAM_BUILDING: '团建',
@@ -119,6 +122,34 @@ export default function Calendar() {
    return events
  }, [calendarData, typeFilter])
  const todayStr = fmtDate(new Date())
  const eventStats = useMemo(() => {
    const overdue: any[] = []
    const urgent: any[] = []
    const warning: any[] = []
    const remind: any[] = []
    for (const ev of allEvents) {
      const diff = Math.floor((new Date(ev.date).getTime() - new Date(todayStr).getTime()) / 86400000)
      if (diff < 0) overdue.push({ ...ev, overdueDays: -diff })
      else if (diff <= 7) urgent.push(ev)
      else if (diff <= 15) warning.push(ev)
      else if (diff <= 35) remind.push(ev)
    }
    const totalOverdueDays = overdue.reduce((s, e) => s + e.overdueDays, 0)
    return { overdue, urgent, warning, remind, totalOverdueDays }
  }, [allEvents, todayStr])
  const groupedEvents = useMemo(() => {
    const groups = [
      { key: 'overdue', label: '已逾期', color: 'text-red-600', bg: 'bg-red-50', icon: AlertCircle, items: eventStats.overdue },
      { key: 'urgent', label: '7天内紧急', color: 'text-orange-600', bg: 'bg-orange-50', icon: AlertCircle, items: eventStats.urgent },
      { key: 'warning', label: '15天预警', color: 'text-amber-600', bg: 'bg-amber-50', icon: Clock, items: eventStats.warning },
      { key: 'remind', label: '35天提醒', color: 'text-blue-600', bg: 'bg-blue-50', icon: Bell, items: eventStats.remind },
    ]
    return groups.filter(g => g.items.length > 0)
  }, [eventStats])
  const customEventMap = useMemo(() => {
    const map: Record<string, any> = {}
    for (const ev of (customEvents || [])) {
@@ -160,6 +191,7 @@ export default function Calendar() {
  return (
    <div className="space-y-3">
      <PageGuide>人事日历，集中展示入职、合同到期、试用期到期、 birthdays 等关键人事事件。支持按月/周视图查看，提前预警重要节点。关联：数据自动来自花名册和合同信息。</PageGuide>
      {/* 顶部工具栏 */}
      <div className="flex items-center justify-between flex-wrap gap-2">
        <div className="flex items-center gap-2">
@@ -188,6 +220,38 @@ export default function Calendar() {
        </div>
      </div>
      {/* 统计卡片 */}
      <div className="grid grid-cols-2 md:grid-cols-4 gap-2">
        <Card className="flex items-center gap-2.5 py-2.5">
          <div className="flex items-center justify-center w-8 h-8 rounded-lg bg-red-50 text-red-600"><AlertCircle className="w-4 h-4" /></div>
          <div>
            <div className="text-base font-bold text-red-600">{eventStats.overdue.length}</div>
            <div className="text-xs text-gray-500">已逾期（{eventStats.totalOverdueDays}天）</div>
          </div>
        </Card>
        <Card className="flex items-center gap-2.5 py-2.5">
          <div className="flex items-center justify-center w-8 h-8 rounded-lg bg-orange-50 text-orange-600"><AlertCircle className="w-4 h-4" /></div>
          <div>
            <div className="text-base font-bold text-orange-600">{eventStats.urgent.length}</div>
            <div className="text-xs text-gray-500">7天内紧急</div>
          </div>
        </Card>
        <Card className="flex items-center gap-2.5 py-2.5">
          <div className="flex items-center justify-center w-8 h-8 rounded-lg bg-amber-50 text-amber-600"><Clock className="w-4 h-4" /></div>
          <div>
            <div className="text-base font-bold text-amber-600">{eventStats.warning.length}</div>
            <div className="text-xs text-gray-500">15天预警</div>
          </div>
        </Card>
        <Card className="flex items-center gap-2.5 py-2.5">
          <div className="flex items-center justify-center w-8 h-8 rounded-lg bg-blue-50 text-blue-600"><Bell className="w-4 h-4" /></div>
          <div>
            <div className="text-base font-bold text-blue-600">{eventStats.remind.length}</div>
            <div className="text-xs text-gray-500">35天提醒</div>
          </div>
        </Card>
      </div>
      {/* 类型筛选 */}
      <div className="flex items-center gap-2 flex-wrap">
        <button
@@ -235,16 +299,36 @@ export default function Calendar() {
                        {cell.day}
                      </div>
                      <div className="space-y-0.5">
-                        {cell.events.slice(0, 3).map((ev: any, idx: number) => (
+                        {cell.events.slice(0, 3).map((ev: any, idx: number) => {
                          const content = (
                            <>
                              <span className={`inline-block w-1 h-1 rounded-full mr-0.5 ${PRIORITY_DOT[ev.priority] || 'bg-gray-400'}`} />
                              {ev.title}
                            </>
                          )
                          if (ev.actionUrl && ev.actionUrl !== '/dashboard') {
                            return (
                              <Link
                                key={idx}
                                to={ev.actionUrl}
                                className={`block text-[10px] leading-tight px-1 py-0.5 rounded truncate hover:underline ${EVENT_TYPE_COLORS[ev.type] || 'bg-gray-100 text-gray-600'}`}
                                title={ev.title}
                                onClick={(e) => e.stopPropagation()}
                              >
                                {content}
                              </Link>
                            )
                          }
                          return (
                            <div
                              key={idx}
                              className={`text-[10px] leading-tight px-1 py-0.5 rounded truncate ${EVENT_TYPE_COLORS[ev.type] || 'bg-gray-100 text-gray-600'}`}
                              title={ev.title}
                            >
-                            <span className={`inline-block w-1 h-1 rounded-full mr-0.5 ${PRIORITY_DOT[ev.priority] || 'bg-gray-400'}`} />
+                              {content}
                            {ev.title}
                            </div>
-                        ))}
+                          )
                        })}
                        {cell.events.length > 3 && (
                          <div className="text-[10px] text-gray-400 px-1">+{cell.events.length - 3} 更多</div>
                        )}
@@ -266,9 +350,19 @@ export default function Calendar() {
              <span className="text-xs text-gray-400 font-normal">({allEvents.length})</span>
            </h3>
            {allEvents.length > 0 ? (
-              <div className="space-y-1.5 max-h-[500px] overflow-y-auto">
+              <div className="space-y-3 max-h-[500px] overflow-y-auto">
-                {allEvents.map((ev: any, i: number) => (
+                {groupedEvents.length > 0 ? groupedEvents.map(group => {
-                  <div key={i} className="flex items-start gap-2 px-2 py-2 rounded-md hover:bg-gray-50 group">
+                  const GIcon = group.icon
                  return (
                    <div key={group.key}>
                      <div className={`flex items-center gap-1.5 px-2 py-1 rounded-md ${group.bg} mb-1 sticky top-0`}>
                        <GIcon className={`w-3.5 h-3.5 ${group.color}`} />
                        <span className={`text-xs font-medium ${group.color}`}>{group.label}</span>
                        <span className="text-xs text-gray-400">({group.items.length})</span>
                      </div>
                      <div className="space-y-1">
                        {group.items.map((ev: any, i: number) => (
                          <div key={i} className="flex items-start gap-2 px-2 py-1.5 rounded-md hover:bg-gray-50 group">
                            <div className={`w-2 h-2 rounded-full mt-1.5 flex-shrink-0 ${PRIORITY_DOT[ev.priority] || 'bg-gray-400'}`} />
                            <div className="flex-1 min-w-0">
                              <div className="flex items-center gap-1.5">
@@ -276,16 +370,23 @@ export default function Calendar() {
                                <span className={`text-[10px] px-1 py-0.5 rounded ${EVENT_TYPE_COLORS[ev.type] || 'bg-gray-100 text-gray-600'}`}>
                                  {EVENT_TYPE_LABELS[ev.type] || ev.type}
                                </span>
                                {group.key === 'overdue' && (
                                  <span className="text-[10px] text-red-600 font-medium">逾期{ev.overdueDays}天</span>
                                )}
                              </div>
                              <div className="text-xs text-gray-800 mt-0.5 truncate">
                                {ev.title}
                                {ev.employeeName && <span className="text-gray-400 ml-1">— {ev.employeeName}</span>}
                              </div>
-                      {ev.actionUrl && ev.actionUrl !== '/dashboard' && (
+                              {ev.type === 'CONTRACT_EXPIRY' && ev.employeeName ? (
                                <Link to={`/roster?employee=${encodeURIComponent(ev.employeeName)}`} className="text-[10px] text-primary hover:underline mt-0.5 inline-block">
                                  查看员工 →
                                </Link>
                              ) : ev.actionUrl && ev.actionUrl !== '/dashboard' ? (
                                <Link to={ev.actionUrl} className="text-[10px] text-primary hover:underline mt-0.5 inline-block">
                                  查看详情 →
                                </Link>
-                      )}
+                              ) : null}
                            </div>
                            {isCustomEvent(ev) && customEventMap[ev.id] && (
                              <button
@@ -298,6 +399,12 @@ export default function Calendar() {
                          </div>
                        ))}
                      </div>
                    </div>
                  )
                }) : (
                  <div className="text-xs text-gray-500 text-center py-8">本月事件均在35天之外</div>
                )}
              </div>
            ) : (
              <div className="text-xs text-gray-500 text-center py-8">本月暂无事件</div>
            )}
@@ -0,0 +1,121 @@
 import { useState } from 'react'
 import { useQuery } from '@tanstack/react-query'
 import { Shield } from 'lucide-react'
 import PageGuide from '../components/ui/PageGuide'
 import Card from '../components/ui/Card'
 import { commercialInsuranceApi } from '../lib/api-services'
 import CommercialInsuranceTab from './social-insurance/CommercialInsuranceTab'
 const fmt = (n: number) => (n || 0).toLocaleString('zh-CN', { minimumFractionDigits: 2, maximumFractionDigits: 2 })
 const INSURANCE_TYPES: Record<string, { label: string; color: string }> = {
  ACCIDENT: { label: '意外伤害险', color: 'bg-orange-50 text-orange-700 border border-orange-200' },
  SUPPLEMENTARY_MEDICAL: { label: '补充医疗保险', color: 'bg-blue-50 text-blue-700 border border-blue-200' },
  EMPLOYER_LIABILITY: { label: '雇主责任险', color: 'bg-purple-50 text-purple-700 border border-purple-200' },
  CRITICAL_ILLNESS: { label: '重大疾病险', color: 'bg-rose-50 text-rose-700 border border-rose-200' },
  GROUP_LIFE: { label: '团体寿险', color: 'bg-teal-50 text-teal-700 border border-teal-200' },
  OTHER: { label: '其他', color: 'bg-gray-50 text-gray-700 border border-gray-200' },
 }
 export default function CommercialInsurance() {
  const [tab, setTab] = useState<'plans' | 'summary'>('plans')
  const { data: employeeSummary = [] } = useQuery<any[]>({
    queryKey: ['commercial-insurance-employee-summary'],
    queryFn: async () => {
      return await commercialInsuranceApi.employeeSummary()
    },
    enabled: tab === 'summary',
  })
  return (
    <div className="space-y-4">
      <div className="flex items-center gap-2">
        <Shield className="h-5 w-5 text-primary" />
        <div>
          <h1 className="text-base font-semibold">商业保险</h1>
          <p className="mt-1 text-sm text-gray-500">管理商业保险方案、参保人员及保单信息</p>
        </div>
      </div>
      <PageGuide>
        商业保险是社保之外的自愿性补充保障，包括意外伤害险、补充医疗、雇主责任险等。
        点击「新增方案」创建商险计划，选择方案后可查看参保人员列表。
        <span className="text-primary"> 商业保险是系统增值服务模块，支持方案管理、参保人员追踪、保费统计。</span>
      </PageGuide>
      {/* Tab 切换 */}
      <div className="flex items-center gap-4 border-b">
        {(['plans', 'summary'] as const).map((t) => (
          <button
            key={t}
            className={`px-4 py-2 text-sm font-medium border-b-2 transition-colors ${
              tab === t ? 'border-primary text-primary' : 'border-transparent text-gray-500 hover:text-gray-700'
            }`}
            onClick={() => setTab(t)}
          >
            {t === 'plans' ? '方案管理' : '员工汇总'}
          </button>
        ))}
      </div>
      {/* ========== 方案管理 Tab ========== */}
      {tab === 'plans' && <CommercialInsuranceTab />}
      {/* ========== 员工汇总 Tab ========== */}
      {tab === 'summary' && (
        <Card>
          {employeeSummary.length === 0 ? (
            <div className="text-center py-8 text-gray-400 text-sm">暂无员工商险数据</div>
          ) : (
            <div className="overflow-x-auto">
              <table className="w-full text-sm">
                <thead>
                  <tr className="border-b text-xs text-gray-500">
                    <th className="py-2 px-3 text-left">姓名</th>
                    <th className="py-2 px-3 text-left">部门</th>
                    <th className="py-2 px-3 text-left">保险项</th>
                    <th className="py-2 px-3 text-right">年保费合计</th>
                    <th className="py-2 px-3 text-right">保额合计</th>
                  </tr>
                </thead>
                <tbody>
                  {employeeSummary.map((e: any) => (
                    <tr key={e.employeeId} className="border-b last:border-0 hover:bg-gray-50">
                      <td className="py-2 px-3 font-medium">{e.name}</td>
                      <td className="py-2 px-3 text-gray-500">{e.department}</td>
                      <td className="py-2 px-3">
                        <div className="flex flex-wrap gap-1">
                          {e.insurances.map((ins: any, i: number) => {
                            const typeCfg = INSURANCE_TYPES[ins.type] || INSURANCE_TYPES.OTHER
                            return (
                              <span key={i} className={`px-1.5 py-0.5 rounded text-xs ${typeCfg.color}`}>
                                {ins.planName} · {ins.provider} · ¥{fmt(ins.premium)}
                              </span>
                            )
                          })}
                        </div>
                      </td>
                      <td className="py-2 px-3 text-right font-medium text-primary">¥{fmt(e.totalPremium)}</td>
                      <td className="py-2 px-3 text-right font-medium">¥{fmt(e.totalCoverage)}</td>
                    </tr>
                  ))}
                </tbody>
                <tfoot>
                  <tr className="border-t-2 font-medium">
                    <td className="py-2 px-3" colSpan={3}>合计（{employeeSummary.length}人）</td>
                    <td className="py-2 px-3 text-right text-primary">
                      ¥{fmt(employeeSummary.reduce((sum: number, e: any) => sum + e.totalPremium, 0))}
                    </td>
                    <td className="py-2 px-3 text-right">
                      ¥{fmt(employeeSummary.reduce((sum: number, e: any) => sum + e.totalCoverage, 0))}
                    </td>
                  </tr>
                </tfoot>
              </table>
            </div>
          )}
        </Card>
      )}
    </div>
  )
 }
@@ -0,0 +1,306 @@
 import { useState, useRef } from 'react'
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
 import { Plus, Edit2, Trash2, Upload, Download, Search } from 'lucide-react'
 import { toast } from 'sonner'
 import { commissionBonusApi, employeeApi } from '../lib/api-services'
 import { Input, Label, Select } from '../components/ui/Input'
 import Button from '../components/ui/Button'
 import Modal from '../components/ui/Modal'
 import PageGuide from '../components/ui/PageGuide'
 import Pagination from '../components/ui/Pagination'
 import { usePageSize } from '../hooks/usePageSize'
 export default function CommissionBonus() {
  const queryClient = useQueryClient()
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const [month, setMonth] = useState(new Date().toISOString().slice(0, 7))
  const [search, setSearch] = useState('')
  const [showAdd, setShowAdd] = useState(false)
  const [editRecord, setEditRecord] = useState<any>(null)
  const fileRef = useRef<HTMLInputElement>(null)
  // 列表 + 汇总
  const { data, isLoading } = useQuery({
    queryKey: ['commission-bonus', month],
    queryFn: () => commissionBonusApi.list(month),
  })
  // 在职员工列表（新增用）
  const { data: employees } = useQuery({
    queryKey: ['employees-active'],
    queryFn: () => employeeApi.list({ status: 'ACTIVE' }),
    enabled: showAdd,
  })
  const records = data?.records || []
  const summary = data?.summary || { count: 0, totalBonus: 0, totalDeduction: 0, netAmount: 0 }
  // 搜索过滤
  const filtered = records.filter((r: any) =>
    !search || r.employee?.name?.includes(search) || r.employee?.department?.includes(search)
  )
  // 分页
  const paged = filtered.slice((page - 1) * pageSize, page * pageSize)
  // 新增
  const addMutation = useMutation({
    mutationFn: (data: { employeeId: string; month: string; amount: number; remark?: string }) =>
      commissionBonusApi.create(data),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['commission-bonus'] })
      setShowAdd(false)
      toast.success('已添加')
    },
    onError: (err: any) => toast.error(err?.response?.data?.error?.message || '添加失败'),
  })
  // 更新
  const updateMutation = useMutation({
    mutationFn: (data: { id: string; amount?: number; remark?: string }) =>
      commissionBonusApi.update(data.id, { amount: data.amount, remark: data.remark }),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['commission-bonus'] })
      setEditRecord(null)
      toast.success('已更新')
    },
    onError: (err: any) => toast.error(err?.response?.data?.error?.message || '更新失败'),
  })
  // 删除
  const deleteMutation = useMutation({
    mutationFn: (id: string) => commissionBonusApi.remove(id),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['commission-bonus'] })
      toast.success('已删除')
    },
    onError: (err: any) => toast.error(err?.response?.data?.error?.message || '删除失败'),
  })
  // 导入
  const importMutation = useMutation({
    mutationFn: (file: File) => commissionBonusApi.import(file, month),
    onSuccess: (data: any) => {
      queryClient.invalidateQueries({ queryKey: ['commission-bonus'] })
      toast.success(`导入完成：新增 ${data.created}，更新 ${data.updated}，跳过 ${data.skipped}`)
      if (data.errors?.length > 0) {
        toast.error(`错误明细：${data.errors.slice(0, 3).map((e: any) => `第${e.row}行: ${e.message}`).join('；')}`)
      }
    },
    onError: (err: any) => toast.error(err?.response?.data?.error?.message || '导入失败'),
  })
  const handleFileChange = (e: React.ChangeEvent<HTMLInputElement>) => {
    const file = e.target.files?.[0]
    if (file) importMutation.mutate(file)
    if (fileRef.current) fileRef.current.value = ''
  }
  const fmt = (n: number) => `¥${n.toLocaleString('zh-CN', { minimumFractionDigits: 2, maximumFractionDigits: 2 })}`
  return (
    <div className="space-y-4">
      <PageGuide>
        <p>按月管理员工提成奖金/扣款。金额正数为奖金，负数为扣款。数据可用于薪资批次"获取提成奖金"自动填充。</p>
      </PageGuide>
      {/* 筛选栏 */}
      <div className="flex items-center gap-3 flex-wrap">
        <div>
          <Label>月份</Label>
          <Input type="month" value={month} onChange={(e) => { setMonth(e.target.value); setPage(1) }} className="w-40" />
        </div>
        <div className="flex-1 min-w-[200px]">
          <Label>搜索</Label>
          <div className="relative">
            <Search className="absolute left-3 top-1/2 -translate-y-1/2 w-4 h-4 text-gray-400" />
            <Input value={search} onChange={(e) => { setSearch(e.target.value); setPage(1) }} placeholder="员工姓名/部门" className="pl-9" />
          </div>
        </div>
        <div className="flex items-end gap-2">
          <Button variant="secondary" onClick={() => window.open(commissionBonusApi.templateUrl, '_blank')}>
            <Download className="w-4 h-4 mr-1" />模板
          </Button>
          <Button variant="secondary" onClick={() => fileRef.current?.click()} disabled={importMutation.isPending}>
            <Upload className="w-4 h-4 mr-1" />{importMutation.isPending ? '导入中...' : '批量导入'}
          </Button>
          <input ref={fileRef} type="file" accept=".xlsx,.xls" onChange={handleFileChange} className="hidden" />
          <Button onClick={() => setShowAdd(true)}>
            <Plus className="w-4 h-4 mr-1" />新增
          </Button>
        </div>
      </div>
      {/* 汇总卡片 */}
      <div className="grid grid-cols-4 gap-4">
        <div className="rounded-lg border border-gray-200 p-4">
          <div className="text-xs text-gray-500">记录数</div>
          <div className="text-2xl font-bold text-gray-900 mt-1">{summary.count}</div>
        </div>
        <div className="rounded-lg border border-gray-200 p-4">
          <div className="text-xs text-gray-500">总奖金</div>
          <div className="text-2xl font-bold text-safe mt-1">{fmt(summary.totalBonus)}</div>
        </div>
        <div className="rounded-lg border border-gray-200 p-4">
          <div className="text-xs text-gray-500">总扣款</div>
          <div className="text-2xl font-bold text-danger mt-1">{fmt(summary.totalDeduction)}</div>
        </div>
        <div className="rounded-lg border border-gray-200 p-4">
          <div className="text-xs text-gray-500">净额</div>
          <div className={`text-2xl font-bold mt-1 ${summary.netAmount >= 0 ? 'text-gray-900' : 'text-danger'}`}>{fmt(summary.netAmount)}</div>
        </div>
      </div>
      {/* 列表 */}
      <div className="overflow-x-auto rounded-lg border border-gray-200">
        <table className="min-w-full divide-y divide-gray-200">
          <thead className="bg-gray-50">
            <tr>
              <th className="px-4 py-3 text-left text-xs font-medium text-gray-500">员工</th>
              <th className="px-4 py-3 text-left text-xs font-medium text-gray-500">部门</th>
              <th className="px-4 py-3 text-right text-xs font-medium text-gray-500">金额</th>
              <th className="px-4 py-3 text-left text-xs font-medium text-gray-500">备注</th>
              <th className="px-4 py-3 text-center text-xs font-medium text-gray-500">操作</th>
            </tr>
          </thead>
          <tbody className="divide-y divide-gray-100 bg-white">
            {isLoading ? (
              <tr><td colSpan={5} className="px-4 py-8 text-center text-gray-400">加载中...</td></tr>
            ) : paged.length === 0 ? (
              <tr><td colSpan={5} className="px-4 py-8 text-center text-gray-400">{month} 无提成奖金记录</td></tr>
            ) : paged.map((r: any) => (
              <tr key={r.id} className="hover:bg-gray-50">
                <td className="px-4 py-2.5 text-sm text-gray-900">{r.employee?.name || '-'}</td>
                <td className="px-4 py-2.5 text-sm text-gray-500">{r.employee?.department || '-'}</td>
                <td className={`px-4 py-2.5 text-sm text-right font-medium ${r.amount >= 0 ? 'text-safe' : 'text-danger'}`}>
                  {r.amount >= 0 ? '+' : ''}{fmt(r.amount)}
                </td>
                <td className="px-4 py-2.5 text-sm text-gray-500">{r.remark || '-'}</td>
                <td className="px-4 py-2.5 text-center">
                  <button onClick={() => setEditRecord(r)} className="p-1 text-gray-400 hover:text-primary" title="编辑">
                    <Edit2 className="w-4 h-4" />
                  </button>
                  <button
                    onClick={() => { if (confirm(`确认删除 ${r.employee?.name} 的提成奖金记录？`)) deleteMutation.mutate(r.id) }}
                    className="p-1 text-gray-400 hover:text-danger ml-1" title="删除"
                  >
                    <Trash2 className="w-4 h-4" />
                  </button>
                </td>
              </tr>
            ))}
          </tbody>
        </table>
      </div>
      {filtered.length > pageSize && (
        <Pagination page={page} pageSize={pageSize} total={filtered.length} onPageChange={setPage} onPageSizeChange={() => setPage(1)} />
      )}
      {/* 新增弹窗 */}
      {showAdd && (
        <AddModal
          employees={employees || []}
          month={month}
          onClose={() => setShowAdd(false)}
          onSubmit={(data) => addMutation.mutate(data)}
          saving={addMutation.isPending}
        />
      )}
      {/* 编辑弹窗 */}
      {editRecord && (
        <EditModal
          record={editRecord}
          onClose={() => setEditRecord(null)}
          onSubmit={(data) => updateMutation.mutate({ id: editRecord.id, ...data })}
          saving={updateMutation.isPending}
        />
      )}
    </div>
  )
 }
 function AddModal({ employees, month, onClose, onSubmit, saving }: {
  employees: any[]
  month: string
  onClose: () => void
  onSubmit: (data: { employeeId: string; month: string; amount: number; remark?: string }) => void
  saving: boolean
 }) {
  const [employeeId, setEmployeeId] = useState('')
  const [amount, setAmount] = useState('')
  const [remark, setRemark] = useState('')
  return (
    <Modal open onClose={onClose} title="新增提成奖金" size="md">
      <div className="space-y-4">
        <div>
          <Label>员工 *</Label>
          <Select value={employeeId} onChange={(e) => setEmployeeId(e.target.value)}>
            <option value="">请选择员工</option>
            {employees.map((e: any) => (
              <option key={e.id} value={e.id}>{e.name}（{e.department}）</option>
            ))}
          </Select>
        </div>
        <div>
          <Label>月份</Label>
          <Input type="month" value={month} disabled className="bg-gray-50" />
        </div>
        <div>
          <Label>金额 *（正=奖金，负=扣款）</Label>
          <Input type="number" value={amount} onChange={(e) => setAmount(e.target.value)} placeholder="如 5000 或 -200" />
        </div>
        <div>
          <Label>备注</Label>
          <Input value={remark} onChange={(e) => setRemark(e.target.value)} placeholder="选填" />
        </div>
        <div className="flex justify-end gap-2 pt-2">
          <Button variant="secondary" onClick={onClose}>取消</Button>
          <Button
            disabled={!employeeId || !amount || saving}
            onClick={() => onSubmit({ employeeId, month, amount: parseFloat(amount) || 0, remark: remark || undefined })}
          >
            {saving ? '保存中...' : '保存'}
          </Button>
        </div>
      </div>
    </Modal>
  )
 }
 function EditModal({ record, onClose, onSubmit, saving }: {
  record: any
  onClose: () => void
  onSubmit: (data: { amount?: number; remark?: string }) => void
  saving: boolean
 }) {
  const [amount, setAmount] = useState(String(record.amount))
  const [remark, setRemark] = useState(record.remark || '')
  return (
    <Modal open onClose={onClose} title={`编辑 - ${record.employee?.name || ''}`} size="md">
      <div className="space-y-4">
        <div>
          <Label>金额 *（正=奖金，负=扣款）</Label>
          <Input type="number" value={amount} onChange={(e) => setAmount(e.target.value)} />
        </div>
        <div>
          <Label>备注</Label>
          <Input value={remark} onChange={(e) => setRemark(e.target.value)} />
        </div>
        <div className="flex justify-end gap-2 pt-2">
          <Button variant="secondary" onClick={onClose}>取消</Button>
          <Button
            disabled={!amount || saving}
            onClick={() => onSubmit({ amount: parseFloat(amount) || 0, remark: remark || undefined })}
          >
            {saving ? '保存中...' : '保存'}
          </Button>
        </div>
      </div>
    </Modal>
  )
 }
@@ -7,6 +7,7 @@ import Card from '../components/ui/Card'
 import Button from '../components/ui/Button'
 import { Input, Label, Select } from '../components/ui/Input'
 import EmptyState from '../components/ui/EmptyState'
 import PageGuide from '../components/ui/PageGuide'
 const FILE_TYPES = [
  { value: 'BUSINESS_LICENSE', label: '营业执照' },
@@ -82,6 +83,7 @@ export default function CompanyFiles() {
  return (
    <div className="space-y-4">
      <PageGuide>公司文件管理，集中存储和管理公司制度、合同模板、政策文件等。支持分类管理、在线预览、权限控制。关联：员工可在员工端查看已授权的公司文件。</PageGuide>
      <div className="flex items-center gap-2">
        <Building2 className="h-5 w-5 text-primary" />
        <h1 className="text-lg font-semibold">公司备用文件</h1>
@@ -118,7 +120,7 @@ export default function CompanyFiles() {
        <div className="p-4">
          <div className="flex items-center justify-between mb-3">
            <h2 className="text-sm font-medium">文件列表</h2>
-            <Select value={filterType} onChange={(e) => setFilterType(e.target.value)} className="w-32 text-xs">
+            <Select value={filterType} onChange={(e) => setFilterType(e.target.value)} className="!w-28 text-xs">
              <option value="">全部类型</option>
              {FILE_TYPES.map(t => <option key={t.value} value={t.value}>{t.label}</option>)}
            </Select>
@@ -1,8 +1,10 @@
 import { useState, useRef } from 'react'
 import { usePageSize } from '../hooks/usePageSize'
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
-import { Plus, Search, Paperclip, Trash2, X, FileText, Download } from 'lucide-react'
+import { Plus, Search, Paperclip, Trash2, X, FileText, Download, AlertTriangle } from 'lucide-react'
 import { toast } from 'sonner'
 import { rosterApi, employeeApi, attachmentApi } from '../lib/api-services'
 import api from '../lib/api'
 import Card from '../components/ui/Card'
 import Button from '../components/ui/Button'
 import { Input, Label, Select } from '../components/ui/Input'
@@ -37,8 +39,8 @@ export default function Contracts() {
  const [search, setSearch] = useState('')
  const [filterDepartment, setFilterDepartment] = useState('')
  const [filterContractStatus, setFilterContractStatus] = useState('')
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const [pageSize, setPageSize] = useState(20)
  const [showAddModal, setShowAddModal] = useState(false)
  const [selectedEmpId, setSelectedEmpId] = useState<string | null>(null)
@@ -60,6 +62,7 @@ export default function Contracts() {
      queryClient.invalidateQueries({ queryKey: ['roster'] })
      queryClient.invalidateQueries({ queryKey: ['dashboard'] })
      queryClient.invalidateQueries({ queryKey: ['roster-profile'] })
      localStorage.removeItem('add-employee-draft')
      setShowAddModal(false)
    },
  })
@@ -76,7 +79,7 @@ export default function Contracts() {
          <FileText className="h-5 w-5 text-primary" />
          <div>
            <h1 className="text-base font-semibold">合同管理</h1>
-            <p className="mt-1 text-sm text-gray-500">集中管理劳动合同、签署状态及到期风险</p>
+            <p className="mt-1 text-sm text-gray-500">集中管理用工关系（劳动合同/劳务协议/实习协议）、签署状态及到期风险</p>
          </div>
        </div>
        <Button onClick={() => setShowAddModal(true)}>
@@ -185,7 +188,7 @@ export default function Contracts() {
              pageSize={pageSize}
              total={data.total}
              onPageChange={setPage}
-              onPageSizeChange={(s) => { setPageSize(s); setPage(1) }}
+              onPageSizeChange={() => setPage(1)}
            />
          </>
        )}
@@ -215,9 +218,26 @@ function AddEmployeeModal({ open, onClose, onSubmit, loading, error }: {
  loading: boolean
  error: any
 }) {
  // 拉取组织架构部门列表，用于部门下拉选择
  const { data: departments = [] } = useQuery({
    queryKey: ['departments'],
    queryFn: () => api.get('/departments').then(r => r.data),
  })
  // 构建部门树形下拉选项（带层级缩进）
  const deptOptions: { id: string; label: string; level: number }[] = []
  const buildDeptOptions = (items: any[], parentId: string | null, level: number) => {
    items.filter(d => d.parentId === parentId).sort((a, b) => a.sortOrder - b.sortOrder).forEach(d => {
      deptOptions.push({ id: d.id, label: d.name, level })
      buildDeptOptions(items, d.id, level + 1)
    })
  }
  buildDeptOptions(departments, null, 0)
  // 手机号查重
  const [phoneDuplicate, setPhoneDuplicate] = useState<{ exists: boolean; employee?: any } | null>(null)
  const [form, setForm] = useState({
    name: '',
    department: '',
    position: '',
    hireDate: '',
    monthlySalary: '',
    gender: '男' as '男' | '女',
@@ -238,6 +258,7 @@ function AddEmployeeModal({ open, onClose, onSubmit, loading, error }: {
    const data: any = {
      name: form.name,
      department: form.department,
      position: form.position || undefined,
      hireDate: new Date(form.hireDate).toISOString(),
      monthlySalary: form.monthlySalary,
      gender: form.gender,
@@ -276,20 +297,30 @@ function AddEmployeeModal({ open, onClose, onSubmit, loading, error }: {
          </div>
          <div>
            <Label>部门 *</Label>
-            <Input value={form.department} onChange={(e) => setForm({ ...form, department: e.target.value })} placeholder="如：技术部" />
+            <Select value={form.department} onChange={(e) => setForm({ ...form, department: e.target.value })}>
              <option value="">请选择部门</option>
              {deptOptions.map(d => (
                <option key={d.id} value={d.label}>{'　'.repeat(d.level)}{d.label}</option>
              ))}
            </Select>
          </div>
        </div>
        <div className="grid grid-cols-2 gap-3">
          <div>
            <Label>职务/岗位</Label>
            <Input value={form.position} onChange={(e) => setForm({ ...form, position: e.target.value })} placeholder="如：前端工程师" />
          </div>
          <div>
            <Label>入职日期 *</Label>
            <Input type="date" value={form.hireDate} onChange={(e) => setForm({ ...form, hireDate: e.target.value })} />
          </div>
        </div>
        <div>
          <Label>月工资 *</Label>
          <Input type="number" value={form.monthlySalary} onChange={(e) => setForm({ ...form, monthlySalary: e.target.value })} placeholder="元" />
        </div>
        </div>
        <div className="grid grid-cols-2 gap-3">
          <div>
@@ -301,9 +332,24 @@ function AddEmployeeModal({ open, onClose, onSubmit, loading, error }: {
          </div>
          <div>
            <Label>手机号</Label>
-            <Input value={form.phone} onChange={(e) => setForm({ ...form, phone: e.target.value })} placeholder="选填" maxLength={11} />
+            <Input value={form.phone} onChange={(e) => {
              const phone = e.target.value.replace(/\D/g, '').slice(0, 11)
              setForm({ ...form, phone })
              setPhoneDuplicate(null)
              if (phone.length === 11) {
                employeeApi.checkPhone(phone).then((data: { exists: boolean; employee?: any }) => {
                  setPhoneDuplicate(data)
                }).catch(() => {})
              }
            }} placeholder="选填" maxLength={11} />
          </div>
        </div>
        {phoneDuplicate?.exists && (
          <div className="px-3 py-2 rounded-md bg-amber-50 text-amber-700 text-xs flex items-center gap-2">
            <AlertTriangle className="w-4 h-4 shrink-0" />
            <span>该手机号已存在：{phoneDuplicate.employee?.name}（{phoneDuplicate.employee?.department}），请确认是否重复录入</span>
          </div>
        )}
        {/* 特殊状态 */}
        <div className="flex gap-4">
@@ -1,4 +1,5 @@
 import { useState } from 'react'
 import { usePageSize } from '../hooks/usePageSize'
 import { toast } from 'sonner'
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
 import { Link } from 'react-router-dom'
@@ -39,8 +40,8 @@ function TodoIcon({ type }: { type: string; level: string }) {
 }
 export default function Dashboard() {
  const todoPageSize = usePageSize()
  const [todoPage, setTodoPage] = useState(1)
  const [todoPageSize, setTodoPageSize] = useState(10)
  const queryClient = useQueryClient()
  const [activeTab, setActiveTab] = useState<'overview' | 'risk' | 'task' | 'cost' | 'workforce'>('overview')
  const [selectedIds, setSelectedIds] = useState<Set<string>>(new Set())
@@ -278,6 +279,9 @@ export default function Dashboard() {
  return (
    <div className="space-y-3">
      <PageGuide>
        工作台展示企业人力全局数据和待办事项，包括在管员工数、当月人力成本、合同风险、审批待办等。可切换概览、人力成本、风险、任务等视图。点击各统计卡片可快速跳转到对应详情页。
      </PageGuide>
      <div className="flex items-center justify-between">
        <div>
          <div className="flex items-center gap-2">
@@ -1128,9 +1132,10 @@ export default function Dashboard() {
                    </>
                  )}
                </div>
                <Pagination page={todoPage} pageSize={todoPageSize} total={filteredTodos.length} onPageChange={setTodoPage} onPageSizeChange={(s) => { setTodoPageSize(s); setTodoPage(1) }} />
                <div className="space-y-2">
-                {filteredTodos.slice((todoPage - 1) * todoPageSize, todoPage * todoPageSize).map((todo) => (
+                {filteredTodos.slice((todoPage - 1) * todoPageSize, todoPage * todoPageSize).map((todo) => {
                  const hasValidUrl = todo.actionUrl && todo.actionUrl !== '/' && todo.actionUrl !== ''
                  return (
                  <div
                    key={todo.id}
                    className="flex items-center justify-between px-2.5 py-2 rounded-md hover:bg-gray-50 transition-colors"
@@ -1142,6 +1147,7 @@ export default function Dashboard() {
                        onChange={() => toggleSelect(todo.id)}
                        className="w-4 h-4 rounded border-gray-300 text-primary focus:ring-primary"
                      />
                      {hasValidUrl ? (
                        <Link to={todo.actionUrl} className="flex items-center gap-2.5 flex-1">
                          <TodoIcon type={todo.type} level={todo.level} />
                          <div className="flex flex-col">
@@ -1168,14 +1174,44 @@ export default function Dashboard() {
                            <span className="text-xs text-gray-500 flex items-center gap-1"><Clock className="w-3 h-3" />{todo.description}</span>
                          </div>
                        </Link>
                      ) : (
                        <div className="flex items-center gap-2.5 flex-1">
                          <TodoIcon type={todo.type} level={todo.level} />
                          <div className="flex flex-col">
                            <div className="flex items-center gap-1.5 flex-wrap">
                              {todo.employeeName && (
                                <span className="text-xs font-bold text-gray-900">{todo.employeeName}</span>
                              )}
                              {todo.employeeDepartment && (
                                <span className="text-xs text-gray-400">{todo.employeeDepartment}</span>
                              )}
                              <span className="text-xs text-gray-700">{todo.title}</span>
                              {todo.priority && priorityConfig[todo.priority] && (
                                <span className={`px-1 py-0.5 rounded text-xs font-medium ${priorityConfig[todo.priority].bg} ${priorityConfig[todo.priority].color}`}>
                                  {priorityConfig[todo.priority].label}
                                </span>
                              )}
                              {todo.estimatedLoss > 0 && (
                                <span className="text-xs text-red-600 font-medium">损失 {fmt(todo.estimatedLoss)}</span>
                              )}
                              {todo.daysUntilDeadline !== null && todo.daysUntilDeadline <= 3 && (
                                <span className="text-xs text-red-600">{todo.daysUntilDeadline <= 0 ? '已逾期' : `${todo.daysUntilDeadline}天`}</span>
                              )}
                            </div>
                            <span className="text-xs text-gray-500 flex items-center gap-1"><Clock className="w-3 h-3" />{todo.description}</span>
                          </div>
                        </div>
                      )}
                    </div>
                    <div className="flex items-center gap-1">
                      {hasValidUrl && (
                        <Link
                          to={todo.actionUrl}
                          className="px-2 py-1 rounded text-xs font-medium bg-primary/10 text-primary hover:bg-primary/20 transition-colors whitespace-nowrap"
                        >
                          立刻办理 →
                        </Link>
                      )}
                      <button
                        onClick={() => resolveMutation.mutate(todo.id)}
                        disabled={resolveMutation.isPending}
@@ -1194,8 +1230,9 @@ export default function Dashboard() {
                      </button>
                    </div>
                  </div>
-                ))}
+                )})}
                </div>
                <Pagination page={todoPage} pageSize={todoPageSize} total={filteredTodos.length} onPageChange={setTodoPage} onPageSizeChange={() => setTodoPage(1)} />
              </>
            )}
          </Card>
@@ -0,0 +1,459 @@
 import { useState } from 'react'
 import { toast } from 'sonner'
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
 import { useConfirm } from '../hooks/useConfirm'
 import { Gift, Plus, Settings as SettingsIcon, X, Users } from 'lucide-react'
 import { benefitApi, employeeApi } from '../lib/api-services'
 import PageGuide from '../components/ui/PageGuide'
 import Card from '../components/ui/Card'
 import Button from '../components/ui/Button'
 import { Input, Label } from '../components/ui/Input'
 import { InlineAlert } from '../components/ui/InlineAlert'
 import Modal from '../components/ui/Modal'
 const fmt = (n: number) => (n || 0).toLocaleString('zh-CN', { minimumFractionDigits: 2, maximumFractionDigits: 2 })
 const BENEFIT_CATEGORIES: Record<string, { label: string; color: string }> = {
  TRANSPORT: { label: '交通补贴', color: 'bg-blue-50 text-blue-700 border border-blue-200' },
  MEAL: { label: '餐补', color: 'bg-orange-50 text-orange-700 border border-orange-200' },
  HOUSING: { label: '住房补贴', color: 'bg-teal-50 text-teal-700 border border-teal-200' },
  COMMUNICATION: { label: '通讯补贴', color: 'bg-purple-50 text-purple-700 border border-purple-200' },
  HEALTH_CHECK: { label: '体检', color: 'bg-green-50 text-green-700 border border-green-200' },
  HOLIDAY: { label: '节日福利', color: 'bg-red-50 text-red-700 border border-red-200' },
  BIRTHDAY: { label: '生日福利', color: 'bg-pink-50 text-pink-700 border border-pink-200' },
  OTHER: { label: '其他', color: 'bg-gray-50 text-gray-700 border border-gray-200' },
 }
 const FREQUENCY_LABELS: Record<string, string> = {
  MONTHLY: '每月',
  QUARTERLY: '每季',
  YEARLY: '每年',
  ONE_TIME: '一次性',
 }
 const DEFAULT_PLAN = {
  name: '', category: 'TRANSPORT', amount: 0, frequency: 'MONTHLY',
  taxDeductible: false, description: '',
 }
 export default function EmployeeBenefits() {
  const queryClient = useQueryClient()
  const confirm = useConfirm()
  const [tab, setTab] = useState<'plans' | 'summary'>('plans')
  const [showAddPlan, setShowAddPlan] = useState(false)
  const [editingPlan, setEditingPlan] = useState<any>(null)
  const [selectedPlanId, setSelectedPlanId] = useState<string | null>(null)
  const [newPlan, setNewPlan] = useState<any>({ ...DEFAULT_PLAN })
  const [showEnrollModal, setShowEnrollModal] = useState(false)
  const [enrollEmployeeIds, setEnrollEmployeeIds] = useState<string[]>([])
  const [enrollEffectiveFrom, setEnrollEffectiveFrom] = useState(new Date().toISOString().slice(0, 7))
  const { data: plans = [], isLoading } = useQuery<any[]>({
    queryKey: ['benefit-plans'],
    queryFn: async () => {
      return await benefitApi.plans()
    },
  })
  const { data: enrollments = [], isLoading: enrollLoading } = useQuery<any[]>({
    queryKey: ['benefit-enrollments', selectedPlanId],
    queryFn: async () => {
      if (!selectedPlanId) return []
      return await benefitApi.enrollments(selectedPlanId)
    },
    enabled: !!selectedPlanId,
  })
  const { data: employeeSummary = [] } = useQuery<any[]>({
    queryKey: ['benefit-employee-summary'],
    queryFn: async () => {
      return await benefitApi.employeeSummary()
    },
    enabled: tab === 'summary',
  })
  const { data: rosterData } = useQuery<any[]>({
    queryKey: ['employees-for-benefit'],
    queryFn: async () => {
      return await employeeApi.allLite({ status: 'ACTIVE' })
    },
    enabled: showEnrollModal,
  })
  const savePlanMutation = useMutation({
    mutationFn: async (data: any) => {
      if (editingPlan) {
        return benefitApi.savePlan(data, editingPlan.id) as any
      }
      return benefitApi.savePlan(data) as any
    },
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['benefit-plans'] })
      setShowAddPlan(false)
      setEditingPlan(null)
      setNewPlan({ ...DEFAULT_PLAN })
      toast.success(editingPlan ? '福利方案已更新' : '福利方案已创建')
    },
    onError: () => toast.error('保存失败'),
  })
  const deletePlanMutation = useMutation({
    mutationFn: (id: string) => benefitApi.removePlan(id),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['benefit-plans'] })
      setSelectedPlanId(null)
      toast.success('福利方案已删除')
    },
  })
  const enrollMutation = useMutation({
    mutationFn: async (data: { employeeIds: string[]; effectiveFrom: string }) =>
      benefitApi.enroll(selectedPlanId!, data) as any,
    onSuccess: (res: any) => {
      queryClient.invalidateQueries({ queryKey: ['benefit-enrollments'] })
      queryClient.invalidateQueries({ queryKey: ['benefit-employee-summary'] })
      setShowEnrollModal(false)
      setEnrollEmployeeIds([])
      toast.success(`已添加 ${res.data?.enrolled || 0} 名员工`)
    },
    onError: () => toast.error('参保失败'),
  })
  const terminateMutation = useMutation({
    mutationFn: (enrollmentId: string) => benefitApi.terminateEnrollment(enrollmentId),
    onSuccess: () => {
      queryClient.invalidateQueries({ queryKey: ['benefit-enrollments'] })
      queryClient.invalidateQueries({ queryKey: ['benefit-employee-summary'] })
      toast.success('已终止福利')
    },
  })
  const handleEdit = (plan: any) => {
    setEditingPlan(plan)
    setNewPlan({ ...plan })
    setShowAddPlan(true)
  }
  const handleSave = () => {
    if (!newPlan.name?.trim()) { toast.error('请填写方案名称'); return }
    savePlanMutation.mutate(newPlan)
  }
  return (
    <div className="space-y-4">
      <div className="flex items-center gap-2">
        <Gift className="h-5 w-5 text-primary" />
        <div>
          <h1 className="text-base font-semibold">员工福利</h1>
          <p className="mt-1 text-sm text-gray-500">管理员工福利方案、参保人员及福利汇总</p>
        </div>
      </div>
      <PageGuide>
        员工福利包括交通补贴、餐补、住房补贴、通讯补贴、体检、节日福利等。
        管理福利方案、批量参保、查看员工福利汇总。
        <span className="text-primary"> 员工福利是系统增值服务模块，支持按方案/按员工维度管理福利，可关联薪资计算。</span>
      </PageGuide>
      {/* Tab 切换 */}
      <div className="flex items-center gap-4 border-b">
        {(['plans', 'summary'] as const).map((t) => (
          <button
            key={t}
            className={`px-4 py-2 text-sm font-medium border-b-2 transition-colors ${
              tab === t ? 'border-primary text-primary' : 'border-transparent text-gray-500 hover:text-gray-700'
            }`}
            onClick={() => setTab(t)}
          >
            {t === 'plans' ? '福利方案' : '员工汇总'}
          </button>
        ))}
        {tab === 'plans' && (
          <Button size="sm" className="ml-auto" onClick={() => { setEditingPlan(null); setNewPlan({ ...DEFAULT_PLAN }); setShowAddPlan(true) }}>
            <Plus className="w-4 h-4 mr-1" />新增方案
          </Button>
        )}
      </div>
      {/* ========== 福利方案 Tab ========== */}
      {tab === 'plans' && (
        <>
          {isLoading ? (
            <Card><div className="text-center py-8 text-gray-400">加载中...</div></Card>
          ) : plans.length === 0 ? (
            <Card><div className="text-center py-8 text-gray-400 text-sm">暂无福利方案，点击「新增方案」创建</div></Card>
          ) : (
            <div className="grid gap-3 md:grid-cols-2 lg:grid-cols-3">
              {plans.map((plan: any) => {
                const catCfg = BENEFIT_CATEGORIES[plan.category] || BENEFIT_CATEGORIES.OTHER
                const isSelected = selectedPlanId === plan.id
                return (
                  <Card
                    key={plan.id}
                    className={`cursor-pointer transition-all ${isSelected ? 'ring-2 ring-primary/20' : 'hover:shadow-md'}`}
                  >
                    <div onClick={() => setSelectedPlanId(isSelected ? null : plan.id)}>
                      <div className="flex items-start justify-between mb-2">
                        <div>
                          <span className={`px-2 py-0.5 rounded text-xs ${catCfg.color}`}>{catCfg.label}</span>
                          <h3 className="text-sm font-medium mt-1">{plan.name}</h3>
                        </div>
                        <div className="flex gap-1" onClick={(e) => e.stopPropagation()}>
                          <button className="text-xs text-gray-400 hover:text-primary" onClick={() => handleEdit(plan)}>
                            <SettingsIcon className="w-3.5 h-3.5" />
                          </button>
                          <button className="text-xs text-gray-400 hover:text-danger" onClick={async () => {
                            if (await confirm({ title: '确认删除', message: `确定删除福利方案「${plan.name}」吗？` })) {
                              deletePlanMutation.mutate(plan.id)
                            }
                          }}>
                            <X className="w-3.5 h-3.5" />
                          </button>
                        </div>
                      </div>
                      <div className="space-y-1 text-xs text-gray-500">
                        <div className="flex justify-between"><span>金额</span><span className="text-gray-700">¥{fmt(plan.amount)} / {FREQUENCY_LABELS[plan.frequency] || plan.frequency}</span></div>
                        <div className="flex justify-between"><span>税前扣除</span><span className="text-gray-700">{plan.taxDeductible ? '是' : '否'}</span></div>
                        <div className="flex justify-between"><span>参保人数</span><span className="text-gray-700">{plan._count?.enrollments || 0} 人</span></div>
                      </div>
                      {plan.description && <p className="text-xs text-gray-400 mt-2 line-clamp-2">{plan.description}</p>}
                    </div>
                  </Card>
                )
              })}
            </div>
          )}
          {/* 参保人员 */}
          {selectedPlanId && (
            <Card>
              <div className="flex items-center justify-between mb-3">
                <h3 className="text-sm font-medium">参保人员（{enrollments.length}人）</h3>
                <Button size="sm" variant="secondary" onClick={() => { setEnrollEmployeeIds([]); setShowEnrollModal(true) }}>
                  <Users className="w-3.5 h-3.5 mr-1" />为员工添加福利
                </Button>
              </div>
              {enrollLoading ? (
                <div className="text-center py-4 text-gray-400 text-sm">加载中...</div>
              ) : enrollments.length === 0 ? (
                <div className="text-center py-4 text-gray-400 text-sm">暂无参保人员</div>
              ) : (
                <div className="overflow-x-auto">
                  <table className="w-full text-sm">
                    <thead>
                      <tr className="border-b text-xs text-gray-500">
                        <th className="py-2 text-left">姓名</th>
                        <th className="py-2 text-left">部门</th>
                        <th className="py-2 text-left">生效月份</th>
                        <th className="py-2 text-left">截止月份</th>
                        <th className="py-2 text-left">状态</th>
                        <th className="py-2 text-right">操作</th>
                      </tr>
                    </thead>
                    <tbody>
                      {enrollments.map((e: any) => (
                        <tr key={e.id || e.employeeId} className="border-b last:border-0 hover:bg-gray-50">
                          <td className="py-2 font-medium">{e.name}</td>
                          <td className="py-2 text-gray-500">{e.department}</td>
                          <td className="py-2 text-gray-500 text-xs">{e.effectiveFrom || '—'}</td>
                          <td className="py-2 text-gray-500 text-xs">{e.effectiveTo || '至今'}</td>
                          <td className="py-2">
                            <span className={`px-2 py-0.5 rounded text-xs ${e.status === 'ACTIVE' ? 'bg-green-50 text-safe' : 'bg-gray-100 text-gray-500'}`}>
                              {e.status === 'ACTIVE' ? '有效' : '已终止'}
                            </span>
                          </td>
                          <td className="py-2 text-right">
                            {e.status === 'ACTIVE' && (
                              <button className="text-xs text-gray-400 hover:text-danger" onClick={async () => {
                                if (await confirm({ title: '确认终止', message: `确定终止${e.name}的福利吗？` })) {
                                  terminateMutation.mutate(e.id)
                                }
                              }}>终止</button>
                            )}
                          </td>
                        </tr>
                      ))}
                    </tbody>
                  </table>
                </div>
              )}
            </Card>
          )}
        </>
      )}
      {/* ========== 员工汇总 Tab ========== */}
      {tab === 'summary' && (
        <Card>
          {employeeSummary.length === 0 ? (
            <div className="text-center py-8 text-gray-400 text-sm">暂无员工福利数据</div>
          ) : (
            <div className="overflow-x-auto">
              <table className="w-full text-sm">
                <thead>
                  <tr className="border-b text-xs text-gray-500">
                    <th className="py-2 text-left">姓名</th>
                    <th className="py-2 text-left">部门</th>
                    <th className="py-2 text-left">福利项</th>
                    <th className="py-2 text-right">月度合计</th>
                  </tr>
                </thead>
                <tbody>
                  {employeeSummary.map((e: any) => (
                    <tr key={e.employeeId} className="border-b last:border-0 hover:bg-gray-50">
                      <td className="py-2 font-medium">{e.name}</td>
                      <td className="py-2 text-gray-500">{e.department}</td>
                      <td className="py-2">
                        <div className="flex flex-wrap gap-1">
                          {e.benefits.map((b: any, i: number) => (
                            <span key={i} className={`px-1.5 py-0.5 rounded text-xs ${BENEFIT_CATEGORIES[b.category]?.color || BENEFIT_CATEGORIES.OTHER.color}`}>
                              {b.planName} ¥{fmt(b.amount)}
                            </span>
                          ))}
                        </div>
                      </td>
                      <td className="py-2 text-right font-medium text-primary">¥{fmt(e.totalMonthly)}</td>
                    </tr>
                  ))}
                </tbody>
              </table>
            </div>
          )}
        </Card>
      )}
      {/* 新增/编辑方案 Modal */}
      {showAddPlan && (
        <div className="fixed inset-0 z-50 flex items-center justify-center bg-black/30" onClick={() => setShowAddPlan(false)}>
          <Card className="w-full max-w-lg mx-4">
            <div onClick={(e) => e.stopPropagation()}>
              <div className="flex items-center justify-between mb-4">
                <h3 className="text-sm font-medium">{editingPlan ? '编辑福利方案' : '新增福利方案'}</h3>
                <button onClick={() => setShowAddPlan(false)} className="text-gray-400 hover:text-gray-600"><X className="w-4 h-4" /></button>
              </div>
              <div className="space-y-3">
                <div>
                  <Label>方案名称 *</Label>
                  <Input value={newPlan.name} onChange={(e) => setNewPlan({ ...newPlan, name: e.target.value })} placeholder="如：2024年度交通补贴" />
                </div>
                <div className="grid grid-cols-2 gap-3">
                  <div>
                    <Label>福利类型</Label>
                    <select
                      className="h-9 w-full rounded-md border border-gray-200 bg-white px-3 text-sm text-gray-700 shadow-sm outline-none transition focus:border-primary focus:ring-2 focus:ring-primary/10"
                      value={newPlan.category}
                      onChange={(e) => setNewPlan({ ...newPlan, category: e.target.value })}
                    >
                      {Object.entries(BENEFIT_CATEGORIES).map(([k, v]) => <option key={k} value={k}>{v.label}</option>)}
                    </select>
                  </div>
                  <div>
                    <Label>发放频率</Label>
                    <select
                      className="h-9 w-full rounded-md border border-gray-200 bg-white px-3 text-sm text-gray-700 shadow-sm outline-none transition focus:border-primary focus:ring-2 focus:ring-primary/10"
                      value={newPlan.frequency}
                      onChange={(e) => setNewPlan({ ...newPlan, frequency: e.target.value })}
                    >
                      {Object.entries(FREQUENCY_LABELS).map(([k, v]) => <option key={k} value={k}>{v}</option>)}
                    </select>
                  </div>
                </div>
                <div className="grid grid-cols-2 gap-3">
                  <div>
                    <Label>金额（元）</Label>
                    <Input type="number" value={newPlan.amount} onChange={(e) => setNewPlan({ ...newPlan, amount: parseFloat(e.target.value) || 0 })} />
                  </div>
                  <div>
                    <Label>是否税前扣除</Label>
                    <select
                      className="h-9 w-full rounded-md border border-gray-200 bg-white px-3 text-sm text-gray-700 shadow-sm outline-none transition focus:border-primary focus:ring-2 focus:ring-primary/10"
                      value={newPlan.taxDeductible ? 'true' : 'false'}
                      onChange={(e) => setNewPlan({ ...newPlan, taxDeductible: e.target.value === 'true' })}
                    >
                      <option value="false">否</option>
                      <option value="true">是</option>
                    </select>
                  </div>
                </div>
                <div>
                  <Label>备注</Label>
                  <Input value={newPlan.description || ''} onChange={(e) => setNewPlan({ ...newPlan, description: e.target.value })} placeholder="适用条件、发放规则等" />
                </div>
                <div className="flex justify-end gap-2 pt-2">
                  <Button variant="secondary" size="sm" onClick={() => setShowAddPlan(false)}>取消</Button>
                  <Button size="sm" onClick={handleSave} disabled={savePlanMutation.isPending}>
                    {savePlanMutation.isPending ? '保存中...' : '保存'}
                  </Button>
                </div>
              </div>
            </div>
          </Card>
        </div>
      )}
      {/* 批量参保 Modal */}
      {showEnrollModal && (
        <Modal open={true} onClose={() => setShowEnrollModal(false)} title="为员工添加福利" size="lg">
          <div className="space-y-3">
            <InlineAlert type="info">
              选择需要参保的员工，设置生效月份后点击「确认参保」。
            </InlineAlert>
            <div className="flex items-center gap-2">
              <Label className="shrink-0">生效月份</Label>
              <Input type="month" value={enrollEffectiveFrom} onChange={(e) => setEnrollEffectiveFrom(e.target.value)} className="!w-32" />
            </div>
            <div className="max-h-80 overflow-y-auto border rounded-md">
              <table className="w-full text-sm">
                <thead className="sticky top-0 bg-white">
                  <tr className="border-b text-xs text-gray-500">
                    <th className="py-2 px-3 text-left w-8">
                      <input type="checkbox" checked={enrollEmployeeIds.length === (rosterData?.length || 0) && enrollEmployeeIds.length > 0}
                        onChange={(e) => {
                          if (e.target.checked) {
                            setEnrollEmployeeIds(rosterData?.map((emp: any) => emp.id) || [])
                          } else {
                            setEnrollEmployeeIds([])
                          }
                        }} />
                    </th>
                    <th className="py-2 px-3 text-left">姓名</th>
                    <th className="py-2 px-3 text-left">部门</th>
                    <th className="py-2 px-3 text-left">状态</th>
                  </tr>
                </thead>
                <tbody>
                  {rosterData?.map((emp: any) => (
                    <tr key={emp.id} className="border-b last:border-0 hover:bg-gray-50">
                      <td className="py-2 px-3">
                        <input type="checkbox" checked={enrollEmployeeIds.includes(emp.id)}
                          onChange={(e) => {
                            if (e.target.checked) setEnrollEmployeeIds([...enrollEmployeeIds, emp.id])
                            else setEnrollEmployeeIds(enrollEmployeeIds.filter((id) => id !== emp.id))
                          }} />
                      </td>
                      <td className="py-2 px-3 font-medium">{emp.name}</td>
                      <td className="py-2 px-3 text-gray-500">{emp.department}</td>
                      <td className="py-2 px-3">
                        <span className="px-2 py-0.5 rounded text-xs bg-green-50 text-safe">在职</span>
                      </td>
                    </tr>
                  ))}
                </tbody>
              </table>
            </div>
            <div className="flex items-center justify-between">
              <span className="text-xs text-gray-400">已选 {enrollEmployeeIds.length} 人</span>
              <div className="flex gap-2">
                <Button variant="secondary" size="sm" onClick={() => setShowEnrollModal(false)}>取消</Button>
                <Button size="sm" onClick={() => enrollMutation.mutate({ employeeIds: enrollEmployeeIds, effectiveFrom: enrollEffectiveFrom })}
                  disabled={enrollEmployeeIds.length === 0 || enrollMutation.isPending}>
                  {enrollMutation.isPending ? '参保中...' : '确认参保'}
                </Button>
              </div>
            </div>
          </div>
        </Modal>
      )}
    </div>
  )
 }
@@ -1,4 +1,5 @@
 import { useState } from 'react'
 import { usePageSize } from '../hooks/usePageSize'
 import { useQuery } from '@tanstack/react-query'
 import { ShieldCheck, FileText, CheckCircle, XCircle } from 'lucide-react'
 import { evidenceApi } from '../lib/api-services'
@@ -13,8 +14,8 @@ import QueryError from '../components/ui/QueryError'
 */
 export default function Evidence() {
  const [refType, setRefType] = useState<string>('')
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const [pageSize, setPageSize] = useState(20)
  const { data: listData, isLoading, isError, error, refetch } = useQuery<any>({
    queryKey: ['evidence', refType, page, pageSize],
@@ -66,10 +67,23 @@ export default function Evidence() {
            )}
            <span className="text-sm font-medium">
              {verifyResult?.invalid === 0
-                ? `全部 ${verifyResult?.total || 0} 条证据链验证通过，数据完整无篡改`
+                ? `全部 ${verifyResult?.total || 0} 条证据链验证通过，数据完整无篡改${verifyResult?.repaired ? `（自动修复 ${verifyResult.repaired} 条历史数据）` : ''}`
                : `${verifyResult?.valid || 0} 条通过，${verifyResult?.invalid || 0} 条异常，请检查`}
            </span>
          </div>
          {verifyResult?.invalidItems?.length > 0 && (
            <div className="mt-3 space-y-1.5">
              {verifyResult.invalidItems.map((item: any) => (
                <div key={item.id} className="flex items-center justify-between px-3 py-2 rounded bg-red-50 border border-red-200 text-sm">
                  <div className="flex items-center gap-2">
                    <XCircle className="w-4 h-4 text-red-500 shrink-0" />
                    <span className="text-red-700">{item.description}</span>
                  </div>
                  <span className="text-xs text-gray-400">{new Date(item.createdAt).toLocaleString('zh-CN')}</span>
                </div>
              ))}
            </div>
          )}
        </Card>
      )}
@@ -128,7 +142,7 @@ export default function Evidence() {
        pageSize={pageSize}
        total={total}
        onPageChange={setPage}
-        onPageSizeChange={(s) => { setPageSize(s); setPage(1) }}
+        onPageSizeChange={() => setPage(1)}
      />
    </div>
  )
@@ -1,4 +1,5 @@
 import { useState } from 'react'
 import { usePageSize } from '../hooks/usePageSize'
 import { toast } from 'sonner'
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query'
 import { useConfirm } from '../hooks/useConfirm'
@@ -9,6 +10,7 @@ import Button from '../components/ui/Button'
 import { Input, Label, Select } from '../components/ui/Input'
 import EmptyState from '../components/ui/EmptyState'
 import Pagination from '../components/ui/Pagination'
 import PageGuide from '../components/ui/PageGuide'
 const LEAVE_TYPE_MAP: Record<string, string> = {
  SICK: '病假',
@@ -30,8 +32,8 @@ const fmtDate = (d: string) => new Date(d).toLocaleDateString('zh-CN')
 export default function LeaveApproval() {
  const queryClient = useQueryClient()
  const confirm = useConfirm()
  const pageSize = usePageSize()
  const [page, setPage] = useState(1)
  const [pageSize, setPageSize] = useState(20)
  const [filterStatus, setFilterStatus] = useState('')
  const [filterType, setFilterType] = useState('')
  const [approveModal, setApproveModal] = useState<{ id: string; action: string; name: string } | null>(null)
@@ -74,6 +76,7 @@ export default function LeaveApproval() {
  return (
    <div className="space-y-4">
      <PageGuide>请假审批，处理员工请假申请，支持事假、病假、年假、婚假等类型。流程：员工提交申请 → 主管审批 → HR 备案 → 同步考勤。关联：审批通过后自动更新考勤记录。</PageGuide>
      <div className="flex items-center gap-2">
        <CalendarClock className="w-5 h-5 text-primary" />
        <div>
@@ -143,7 +146,6 @@ export default function LeaveApproval() {
        <EmptyState title="暂无休假申请" description="员工在手机端提交的休假申请将显示在此处" />
      ) : (
        <>
          <Pagination page={page} pageSize={pageSize} total={total} onPageChange={setPage} onPageSizeChange={(s) => { setPageSize(s); setPage(1) }} />
          <Card>
            <div className="overflow-x-auto">
              <table className="w-full text-sm">
@@ -220,6 +222,7 @@ export default function LeaveApproval() {
              </table>
            </div>
          </Card>
          <Pagination page={page} pageSize={pageSize} total={total} onPageChange={setPage} onPageSizeChange={() => setPage(1)} />
        </>
      )}
--- a/Show More
+++ b/Show More