freedak/TurboHR
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 实现20260730优化方案全部功能

Browse Source 
- AI文件审查：.docx上传提取文本，支持多种文档类型
- 用工办理工作流：WorkProcess页面+后端API，支持入职/续签/终止等流程
- 企业自建文本库：Templates页面Tab切换，企业模板CRUD+渲染+下载Word
- 考勤发布：Attendance发布/取消发布按钮，员工端MyAttendance页面
- 工资条发布：Money发布/定时发送按钮+弹窗，portal端publishStatus过滤
- 合同到期弹窗：Dashboard合同到期预警可点击打开弹窗，支持续签/终止操作
- Prisma schema新增WorkProcess/EnterpriseTemplate/AttendancePublish模型
- 前后端编译验证全部通过
This commit is contained in:
freedakgmail
2026-07-30 10:21:22 +08:00
parent 38b8849332
commit 42e0c650a4
24 changed files with 3639 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/20260730-功能补齐方案.md
+404
View File
@@ -0,0 +1,404 @@
# 企业用工专家 — 功能补齐方案
> 日期：2026-07-30
> 依据：白话用工侠完整运行测试报告对比分析
> 优先级：🔴 高 / 🟡 中
---
## 一、用工办理工作流系统（13类流程）🔴
### 1.1 目标
实现统一的用工办理工作流系统，覆盖员工从录用到离职的全生命周期办理事项。
### 1.2 13类流程定义
| 编号 | 流程名称 | 核心表单字段 | 关联模块 |
|------|---------|------------|---------|
| 1 | 员工录用 | 人员选择、入职时间、公司地址、部门、岗位、直属上级、联系方式、试用期薪酬、转正薪酬、携带材料 | 员工创建+合同起草 |
| 2 | 员工入职 | 入职日期、岗位确认、合同签署方式、材料提交清单 | 员工状态→ACTIVE |
| 3 | 自定义合同签署 | 合同模板选择、变量填充、签署方、期限 | 合同管理 |
| 4 | 员工信息提交 | 信息变更字段、证明材料 | 员工档案更新 |
| 5 | 员工转正 | 转正日期、转正薪资、考核结果 | 员工状态+薪资变更 |
| 6 | 合同变更 | 变更类型、变更内容、生效日期 | 合同管理 |
| 7 | 合同续签 | 续签次数、新期限、新薪资 | 合同管理 |
| 8 | 合同中止 | 中止原因、中止期限、预计恢复日期 | 合同状态 |
| 9 | 开具收入证明 | 用途、收入期间、接收方 | 文本模板渲染 |
| 10 | 合同终止 | 终止原因、终止日期、经济补偿 | 合同状态+离职 |
| 11 | 合同解除 | 解除原因、解除方式、协商/单方 | 已有 Termination 模块复用 |
| 12 | 开具离职证明 | 离职日期、离职原因、接收方 | 文本模板渲染 |
| 13 | 灵活用工 | 人员信息、用工类型、协议期限、计酬方式 | 合同管理(LABOR) |
### 1.3 数据模型设计
```prisma
// 用工办理流程
model WorkProcess {
id String @id @default(cuid())
orgId String
org Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
type String // HIRE/ONBOARD/CUSTOM_CONTRACT/INFO_SUBMIT/CONFIRM/CHANGE/RENEW/SUSPEND/INCOME_CERT/TERMINATE/RESCIND/LEAVING_CERT/FLEXIBLE
title String
employeeId String?
employee Employee? @relation(fields: [employeeId], references: [id])
status String @default("DRAFT") // DRAFT/PENDING_APPROVAL/APPROVED/REJECTED/EXECUTING/COMPLETED/CANCELLED
formData Json // 表单数据 JSON
documents Json? // 生成的文书列表 [{name, content, type}]
approverId String?
approvedAt DateTime?
remark String?
createdBy String
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
@@index([orgId, status])
@@index([orgId, type])
@@index([orgId, createdBy])
}
```
### 1.4 前端架构
**新增页面**：`frontend/src/pages/WorkProcess.tsx`
```
页面结构：
├── 发起办理（13类流程卡片选择）
├── 办理记录（列表+筛选：类型/状态/日期）
├── 办理草稿（仅 DRAFT 状态）
└── 流程详情（步骤条+表单+预览+操作）
```
**流程详情组件**（通用 Wizard）：
- 步骤条：填写信息 → 预览文书 → 存草稿/提交
- 表单根据 `type` 动态渲染字段
- 预览：调用文本模板渲染接口生成文书
- 提交后根据流程类型执行对应业务逻辑
**复用已有模块**：
- 合同解除（#11）→ 复用 `Termination.tsx` 的 Wizard 逻辑
- 合同续签（#7）→ 复用 `Contracts.tsx` 的合同管理逻辑
- 收入证明（#9）/ 离职证明（#12）→ 复用 `Templates.tsx` 的模板渲染
- 员工录用（#1）→ 复用 `roster/modals.tsx` 的添加员工逻辑
### 1.5 后端接口
```
POST /api/v1/work-processes # 创建办理（含草稿）
GET /api/v1/work-processes # 列表查询（支持type/status筛选）
GET /api/v1/work-processes/:id # 详情
PATCH /api/v1/work-processes/:id # 更新草稿
POST /api/v1/work-processes/:id/submit # 提交办理
POST /api/v1/work-processes/:id/approve # 审批通过
POST /api/v1/work-processes/:id/reject # 驳回
POST /api/v1/work-processes/:id/cancel # 撤销
DELETE /api/v1/work-processes/:id # 删除草稿
GET /api/v1/work-processes/:id/preview # 预览生成的文书
```
### 1.6 提交后业务联动
| 流程类型 | 提交后执行 |
|---------|-----------|
| HIRE | 创建员工记录 + 创建劳动合同 |
| ONBOARD | 更新员工状态为 ACTIVE + 记录入职日期 |
| CUSTOM_CONTRACT | 创建劳动合同 |
| INFO_SUBMIT | 更新员工档案字段 |
| CONFIRM | 更新试用期结束 + 调整薪资 |
| CHANGE | 更新合同字段 + 记录变更历史 |
| RENEW | 关闭旧合同 + 创建新合同 |
| SUSPEND | 合同状态改为 SUSPENDED |
| INCOME_CERT | 生成收入证明文书（不改变业务数据） |
| TERMINATE | 合同状态改为 TERMINATED + 触发离职流程 |
| RESCIND | 调用已有 Termination 逻辑 |
| LEAVING_CERT | 生成离职证明文书 |
| FLEXIBLE | 创建劳务协议合同 |
### 1.7 实现优先级
1. **Phase 1**：数据模型 + 基础 CRUD + 列表/草稿页面
2. **Phase 2**：员工录用、员工入职、合同续签、合同终止（4个高频流程）
3. **Phase 3**：剩余9类流程 + 文书预览生成
4. **Phase 4**：审批流程 + 办理记录导出
---
## 二、企业自建文本库 🟡
### 2.1 目标
允许企业创建、管理和复用自己的文本模板（合同、通知、协议等），与系统预置模板库并存。
### 2.2 数据模型设计
```prisma
// 企业自建文本模板
model EnterpriseTemplate {
id String @id @default(cuid())
orgId String
org Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
name String
category String // CONTRACT/RULES/NOTICE/AGREEMENT/OTHER
description String?
content String @db.Text
variables String[] // 变量名列表
status String @default("ACTIVE") // ACTIVE/ARCHIVED
createdBy String
createdAt DateTime @default(now())
updatedAt DateTime @updatedAt
@@index([orgId, category])
}
```
### 2.3 前端方案
**改造页面**：`frontend/src/pages/Templates.tsx`
在现有模板库页面顶部新增 Tab 切换：
- **系统模板库**（现有功能不变）
- **企业文本库**（新增）
企业文本库 Tab 内容：
```
├── 查询栏（名称搜索 + 分类筛选）
├── 新建/编辑弹窗（名称、分类、变量配置、内容编辑）
├── 模板卡片列表（复用现有卡片样式）
├── 详情弹窗（变量填写 → 渲染 → 下载Word/复制）
└── 操作：编辑、复制、删除、归档
```
### 2.4 后端接口
```
# 现有模板路由：/api/v1/templates（系统预置，只读）
# 新增企业模板路由：/api/v1/enterprise-templates
GET /api/v1/enterprise-templates # 列表（支持category/search）
POST /api/v1/enterprise-templates # 新建
GET /api/v1/enterprise-templates/:id # 详情
PUT /api/v1/enterprise-templates/:id # 更新
DELETE /api/v1/enterprise-templates/:id # 删除
POST /api/v1/enterprise-templates/:id/render # 渲染（复用现有 renderTemplate 逻辑）
GET /api/v1/enterprise-templates/:id/download # 下载Word
```
### 2.5 实现要点
- 变量提取：编辑内容时自动扫描 `{{变量名}}` 提取变量列表
- 渲染逻辑：复用 `template.service.ts` 的 `renderTemplate` 函数
- 内容编辑器：使用 textarea + 变量插入按钮（点击插入 `{{变量名}}`）
- 权限：ADMIN/HR 可增删改，VIEWER 只读
---
## 三、考勤/工资条发布流程 🟡
### 3.1 考勤发布
#### 目标
HR 在考勤管理页面将月度考勤数据"发布"给员工，员工在员工端查看并确认。
#### 数据模型
```prisma
// 考勤发布记录
model AttendancePublish {
id String @id @default(cuid())
orgId String
org Organization @relation(fields: [orgId], references: [id], onDelete: Cascade)
month String // 2026-07
title String // 如"2026年7月考勤表"
status String @default("PUBLISHED") // PUBLISHED/CANCELLED
publishDate DateTime @default(now())
createdBy String
createdAt DateTime @default(now())
@@unique([orgId, month])
@@index([orgId, month])
}
```
#### 前端改造：`Attendance.tsx`
在「考勤确认」Tab 工具栏新增：
- **「发布考勤表」按钮**：弹窗确认 → 选择月份 → 发布
- **「发布记录」入口**：查看历史发布记录，可取消发布
#### 后端接口
```
POST /api/v1/attendance/publish # 发布考勤表
GET /api/v1/attendance/publish-records # 发布记录列表
POST /api/v1/attendance/publish/:id/cancel # 取消发布
```
#### 员工端：`portal/` 新增考勤查看页面
```
GET /api/v1/portal/attendance?month=2026-07 # 员工查看自己的月度考勤
```
### 3.2 工资条发布
#### 目标
HR 在薪税管理中将批次工资条"发布"给员工，员工在员工端查看并确认。支持定时发送。
#### 数据模型
复用已有 `Payslip` 模型，新增发布状态字段：
```prisma
// 在 Payslip 模型新增字段
model Payslip {
// ...已有字段
publishStatus String? // UNPUBLISHED/PUBLISHED/SCHEDULED
publishedAt DateTime?
scheduledAt DateTime? // 定时发送时间
confirmedAt DateTime? // 员工确认时间（已有）
}
```
#### 前端改造：`Money.tsx`
在批次详情页新增：
- **「发布工资条」按钮**：将批次内所有工资条标记为 PUBLISHED
- **「定时发送」选项**：选择发送时间，到点自动发布
- **「定时发送记录」入口**：查看定时发送列表，可取消
#### 后端接口
```
POST /api/v1/payroll/batches/:batchId/publish # 发布工资条
POST /api/v1/payroll/batches/:batchId/schedule # 定时发送
GET /api/v1/payroll/schedule-records # 定时发送记录
POST /api/v1/payroll/schedule/:id/cancel # 取消定时发送
```
#### 员工端：已有 `portal/Payslip.tsx`
- 发布前：员工端不显示该月工资条
- 发布后：员工端显示工资条，可查看和确认
- 定时发送：到点后状态从 SCHEDULED → PUBLISHED
#### 定时发送实现
- 使用 `node-cron` 或现有定时任务机制
- 每分钟检查 `scheduledAt <= now && publishStatus = SCHEDULED` 的记录
- 自动更新为 PUBLISHED 并发送通知
---
## 四、AI文件审查上传功能 🔴
### 4.1 目标
在现有合同审查功能基础上，支持上传 doc/docx 文件，自动提取文本后进行 AI 审查。
### 4.2 前端改造：`AIAssistant.tsx` ReviewTab
在现有粘贴文本输入框上方新增文件上传区域：
```
合同审查 Tab 改造：
├── 文件上传区（新增）
│ ├── 文书类型选择（劳动合同/协商解除/劳务协议/实习协议/保密协议）
│ ├── 拖拽或点击上传 .doc/.docx 文件
│ ├── 文件大小限制：100MB
│ └── 上传后自动提取文本并填入下方输入框
├── 文本输入框（现有）
├── 开始审查按钮（现有）
└── 审查结果展示（现有）
```
### 4.3 后端改造
#### 文件上传接口
```
POST /api/v1/ai/review/upload
- multipart/form-data
- 接收 doc/docx 文件
- 提取纯文本
- 返回 { text: "提取的文本内容" }
```
#### 文本提取方案
使用 `mammoth` 库提取 .docx 文本：
```typescript
import mammoth from 'mammoth'
// .docx 文件提取
const result = await mammoth.extractRawText({ buffer: req.file.buffer })
const text = result.value
// .doc 文件（旧格式）
// 方案1：使用 antiword 命令行工具
// 方案2：提示用户转换为 .docx
// 推荐：仅支持 .docx，.doc 提示转换
```
#### 完整审查流程
```typescript
// 1. 上传文件 → 提取文本
POST /ai/review/upload → { text }
// 2. 前端将文本填入输入框（用户可编辑）
// 3. 点击审查 → 调用现有 /ai/review 接口
POST /ai/review { contractText } → 审查结果
```
### 4.4 依赖安装
```bash
cd backend && npm install mammoth
```
### 4.5 安全考虑
- 文件大小限制：100MB（`multer` limits）
- 文件类型校验：仅 `.doc` 和 `.docx`
- 提取后不保存原文件，仅返回文本
- 文本长度截断：超过 50000 字符时截断并提示
---
## 五、实施计划
### 5.1 优先级排序
| 优先级 | 功能 | 预估工作量 | 建议时间 |
|--------|------|-----------|---------|
| 🔴 高 | AI文件审查上传 | 1-2天 | 立即 |
| 🔴 高 | 用工办理工作流 Phase 1-2 | 5-7天 | 本周 |
| 🟡 中 | 企业自建文本库 | 2-3天 | 下周 |
| 🟡 中 | 考勤发布 | 2天 | 下周 |
| 🟡 中 | 工资条发布 | 2-3天 | 下周 |
| 🔴 高 | 用工办理工作流 Phase 3-4 | 5-7天 | 第三周 |
### 5.2 总计
- **总工作量**：约 17-24 个工作日
- **建议分3周完成**：
- 第1周：AI文件审查 + 用工办理Phase 1-2
- 第2周：企业文本库 + 考勤发布 + 工资条发布
- 第3周：用工办理Phase 3-4 + 联调测试
### 5.3 数据库迁移
所有新增模型需要执行 `npx prisma db push` 同步到数据库。
---
## 六、风险与注意事项
1. **用工办理工作流**是最复杂的功能，建议先实现4个高频流程（录用/入职/续签/终止），验证架构后再扩展
2. **企业文本库**的变量提取逻辑需与系统模板保持一致，复用 `renderTemplate` 函数
3. **工资条发布**涉及薪资敏感数据，需确保只有发布后员工端才能看到
4. **AI文件审查**的 .doc 旧格式支持有限，建议仅支持 .docx 并提示用户转换
5. **定时发送**需要确保服务器进程持续运行（PM2 已有保障）
docs/白话用工侠完整运行测试报告.md
+376
View File
@@ -0,0 +1,376 @@
# 白话用工侠完整运行测试报告
## 1. 报告结论
- 测试时间：2026-07-30 08:56—09:12（Asia/Shanghai）
- 测试地址：[https://console.bhygx.com/ent_app_dashboard](https://console.bhygx.com/ent_app_dashboard)
- 测试企业：唐山菲斯克人力资源服务有限公司
- 测试账号：`139****9106`（报告不记录密码）
- 测试方式：使用真实浏览器登录，逐项进入菜单、列表、表单、筛选器、计算器、风险待办和视频播放页面，执行可逆操作并核对页面状态。
- 总体结论：核心菜单和主要业务入口可以正常使用；员工、合同、模板、风险待办等数据可以加载。当前最需要优先处理的是 3 条严重超期合同待办、待办统计口径不一致、医疗期法律依据时效、背景调查额度异常显示，以及频繁出现的前端网络/脚本错误。
本次没有执行任何会正式改变业务数据的操作，包括：发布通知、发送 AI 问题、提交判赔、上传文件、发起背调、保存草稿、办理合同续签/终止、删除合同、提交民主程序、提交诊断问卷、导出人员或下载合同。
## 2. 核心业务数据概览
### 2.1 工作台合规数据
| 指标 | 当前值 |
|---|---:|
| 合规健康度 | 63 / 100，中等风险 |
| 风险点 | 3 |
| 首页待处理 | 4 项 |
| 合同管理评分 | 90 |
| 规章制度评分 | 60 |
| 考勤工时评分 | 80 |
| 员工档案评分 | 52 |
| 社保公积金评分 | 55 |
| 本年度价值贡献 | ¥0 |
| 民主中 / 公示中 / 废弃制度 | 0 / 0 / 0 |
| 用工体检 | 尚未提交问卷 |
### 2.2 人员与合同
| 项目 | 当前值 |
|---|---:|
| 花名册总人数 | 25 |
| 在职 | 21 |
| 正式员工 | 21 |
| 试用期 | 0 |
| 待入职 | 0 |
| 离职 | 4 |
| 其他人员 | 4 |
| 试用期即将到期 | 0 |
| 合同总数 | 70 |
| 首页合同超期待办 | 3 条 |
3 条待办合同分别已经超期约 364、397、411 天。为保护个人信息，本报告不写入员工姓名、手机号和合同文件链接。
### 2.3 内容与业务记录
| 模块 | 当前数据 |
|---|---|
| 考勤管理 | 暂无发布记录 |
| 工资条管理 | 暂无发布记录 |
| 办理记录 | 暂无记录 |
| 办理草稿 | 暂无草稿 |
| 企业文本库 | 暂无企业自建文本 |
| 用工文本模板库 | 87 个模板 |
| 视频中心 | 20 个课程模块；列表第一页展示 12 个 |
| 通知管理 | 暂无通知记录 |
| 民主程序 | 暂无民主/公示记录 |
## 3. 完整菜单与功能测试结果
### 3.1 登录与全局框架
| 检查项 | 结果 | 说明 |
|---|---|---|
| 账号密码登录 | 通过 | 能从登录页正常进入企业工作台 |
| 企业切换 | 通过 | 当前只显示 1 家企业，并提供“全部企业”入口 |
| 左侧菜单 | 通过 | 菜单展开、收起和路由跳转正常 |
| 顶部通知 | 可见 | 页面右上角有通知角标 |
| 返回工作台 | 通过 | 测试结束后已恢复到工作台 |
### 3.2 工作台
已验证：
- 合规健康度及 5 个评分细项正常显示。
- 高优先级风险预警会轮播显示不同员工的合同到期提醒。
- 点击“立即处理”后，会在当前页面打开待办中心。
- 待办中心包含“待办 / 已办”“全部 / 超期未处理 / 今日到期”筛选。
- 进入具体合同待办后，可打开“发送续签通知”处理弹窗。
- 弹窗支持：发送续签通知、已线下续签、终止合同、自定义签署。
- 弹窗展示合同名称、起始日期、到期状态和合同 PDF 查看链接。
- 本次只打开并关闭弹窗，没有选择续签次数，也没有点击提交。
### 3.3 白小侠 AI
#### 智能问答
- 页面正常加载，包含新对话、最近会话、转专家、附件上传和问题输入框。
- 输入测试文字后，发送按钮会启用；清空文字后恢复禁用。
- 未发送测试问题，避免生成外部消息或消耗服务额度。
#### 文件审查
- 页面正常加载，可选择文书类型。
- 已验证类型选择和上传入口联动。
- 当前可见类型包括：劳动合同、协商解除劳动合同协议、劳务协议、实习协议、保密协议。
- 文件限制提示：`doc/docx`，100MB 以内。
- 未上传真实文件，未创建审查任务。
#### 判赔预测器
- 页面正常加载，提供 12 类争议场景。
- 可填写员工/工龄、事实、地区、月薪、制度公示和证据留痕等信息。
- 页面自带演示数据，并明确提示结果仅供决策参考。
- 未点击“预测仲裁结果”，避免调用正式预测或消耗额度。
### 3.4 员工管理
#### 花名册
- 共 25 人，第一页正常展示 10 人。
- 姓名搜索可用，但输入后需要按 Enter 才会触发查询。
- 使用已存在的姓名测试后，结果正确收敛为 1 条；清空并按 Enter 后恢复 25 条。
- 支持部门筛选、添加人员、导出、人事管理、更多操作。
- “添加人员”弹窗可正常打开，包含：
- 添加已入职员工；
- 添加待入职人员；
- 在线创建；
- 二维码邀请；
- 批量导入。
- 本次未新增、导入或导出人员。
#### 考勤管理
- 页面、姓名搜索、日期范围和“发布考勤表”入口正常。
- 当前暂无考勤发布记录。
- 页面说明仅支持平台标准模板。
- 未上传或发布考勤表。
#### 工资条管理
- 页面、姓名搜索、日期范围、“定时发送记录”和“发布工资条”入口正常。
- 当前暂无工资条发布记录。
- 页面说明支持定时发送，且发送前可以取消。
- 未上传或发布工资条。
### 3.5 用工办理
“发起办理”页面可正常进入，当前提供 13 类流程：
1. 员工录用
2. 员工入职
3. 自定义合同签署
4. 员工信息提交
5. 员工转正
6. 合同变更
7. 合同续签
8. 合同中止
9. 开具收入证明
10. 合同终止
11. 合同解除
12. 开具离职证明
13. 灵活用工
已实际打开“员工录用”表单，验证以下区域可以加载：人员选择、入职时间、公司地址、部门、岗位、直属上级、联系方式、试用期薪酬、转正薪酬、携带材料、预览、流程图、存草稿和发布按钮。
办理记录和办理草稿页面的查询、重置和列表结构正常，目前均无记录。本次未保存草稿、未预览生成文书、未发布录用通知。
### 3.6 合同管理
- 合同列表共 70 条，分页正常，第一页展示 10 条。
- 支持合同类型、合同状态、创建日期查询及重置。
- 列表支持查看、下载和删除。
- 同时存在履约中、已到期和无固定期限合同。
- 本次未查看合同正文、未下载、未删除。
### 3.7 用工风控
#### 背景调查
- 工作台显示背景调查入口、人员选择框、免责声明和“发起背调”按钮。
- 当前页面显示“剩余：-1次”，但按钮仍处于可点击状态。
- 未勾选免责声明、未选择人员、未发起调查。
#### 规章制度民主程序
- 页面说明、人员范围、文件选择、标题、截止日期、说明、发布按钮均正常。
- 说明框包含系统预置的 148 字通知模板。
- 当前无民主记录和公示记录。
- 未选择文件、未发布民主程序。
#### 用工体检诊断
- 页面可正常进入，列出劳动合同、规章制度、社保、背景调查、工时加班、竞业限制等诊断维度。
- 点击“开始诊断”会离开平台，跳转到腾讯问卷 `wj.qq.com`。
- 外部问卷能够打开，首题正常显示。
- 外部 URL 携带 `openid` 查询参数；本报告不记录其具体值。
- 未回答或提交问卷，随后返回平台。
### 3.8 知识中心
#### 企业文本库
- 查询、重置、新建入口正常。
- 使用不存在的名称查询后正确显示空结果，重置后输入框清空。
- 当前没有企业自建文本。
- 未新建或上传文本。
#### 用工文本模板库
- 共 87 个模板，包含劳动关系、社保公积金、并购、跨境外派等类别。
- 查询和重置入口正常。
- 未下载或使用模板发起流程。
#### 视频中心
- 课程搜索、课程类型筛选、分页和课程卡片正常。
- 使用不存在的课程名搜索后结果清空；清除关键词并再次搜索后恢复 12 个课程卡片。
- 第一页有 12 个课程，详情页目录总计 20 个模块。
- 已打开第一门课程，视频播放器能够加载并开始播放；随后已暂停。
- 未持续播放、未切换全屏或画中画。
### 3.9 通知管理
- 通知标题搜索、发布通知和列表结构正常。
- 当前暂无通知记录。
- 发布表单可以正常打开，包含标题、正文、目标人群和定时发布。
- 目标人群显示“全体人员（21人）”，与花名册在职人数一致。
- 本次点击取消退出，没有发布通知。
### 3.10 常用计算器
#### 五险一金计算器
已实际运行一次无副作用计算：
- 城市：唐山市
- 社保基数：3920.55
- 公积金基数：2200
- 公积金比例：单位 5% + 个人 5%
- 个人缴纳：570.16
- 企业缴纳：1388.34
- 合计：1958.50
计算明细能够正常展开，养老、医疗、大病、失业、工伤、长期护理和公积金项目均有结果。
#### 医疗期计算器
- 上海 / 全国（非上海）模式切换正常。
- 上海模式包含入职日期、计算截止日期和累计病休天数。
- 全国模式包含入职日期、累计工龄满十年日期、连续/非连续病休、病休起止日期。
- 未填写真实员工日期，未生成正式计算结果。
## 4. 发现的问题与风险
### P0：业务合规风险——3 条合同严重超期
待办中心有 3 条合同到期任务，分别超期约 364、397、411 天。系统本身已经将其标记为高优先级风险，但仍长期未处理。
建议：立即由 HR/法务逐人核实实际劳动关系、线下续签材料、是否已离职、是否应补签或归档。尤其要确认是否已经形成无固定期限劳动合同、事实劳动关系或违法终止风险。
### P1：已离职人员仍出现在续签待办中
3 条合同到期待办中，至少有 1 人在花名册里的员工状态为“离职”，但仍持续出现在“发送续签通知”办理入口。
可能原因：离职流程未闭环、合同终止状态未同步、历史待办未归档，或风控规则没有排除离职人员。
建议：核对员工状态、合同状态和待办状态的同步规则；离职完成后应关闭不再适用的续签待办，或明确标记为“历史遗留待核验”。
### P1：首页待处理数量与待办列表不一致
- 首页显示：4 项待处理。
- 点击“立即处理”后的“全部”待办列表：3 条记录，分页只有 1 页。
建议：确认首页是否混合统计了其他类型任务；如果是，应在待办中心展示分类和总数。如果不是，则修复统计缓存或任务状态同步。
### P1：医疗期计算器展示的上海法规有效期已经过期
页面仍显示相关规定“效期延长至 2025年6月30日”，而测试日期为 2026-07-30。
风险：医疗期属于高敏感劳动合规事项，过期的有效期说明会削弱计算结果可信度，并可能导致错误的人事决定。
建议：立即核对法规是否再次延长、被替代或废止；更新法律依据、有效期和最后校验日期，并在计算结果旁显示政策版本。
### P1：背景调查额度显示为负数
页面显示“剩余：-1次”，同时“发起背调”按钮仍可点击。
可能原因：后端使用 `-1` 表示不限次数，但前端直接展示了内部哨兵值；也可能是额度扣减异常。
建议：如果 `-1` 表示不限次数，前端应显示“无限次”；如果不是，应禁止继续发起并修复额度计算。
### P2：员工风险分布统计口径不清晰
花名册总人数为 25，但初始风险分布显示“高风险 0、中风险 0、健康 10”，三项合计只有 10，恰好等于当前页条数。按姓名筛选到 1 人后，“健康”也变为 1。
建议：明确该统计是“当前页”“当前筛选结果”还是“全体员工”。如果是当前页，应在标题中明确说明；更推荐默认展示全量/筛选结果总计，而不是只统计分页可见数据。
### P2：无固定期限合同在花名册中显示为超长剩余天数
合同管理中，部分记录明确标记为“无固定期限合同”，到期日使用 `2099-12-31`。花名册则显示为“剩余约 2.68 万天”。
建议：花名册应识别无固定期限合同，直接显示“无固定期限”，不要展示由占位日期计算出的剩余天数，以免误导业务人员和风险评分。
### P2：前端错误日志频繁
本次走查期间捕获到站点脚本产生的错误：
| 错误 | 次数 |
|---|---:|
| `Axios Network Error` | 39 |
| `Cannot read properties of undefined (reading 'clientHeight')` | 6 |
| 视频模块 `Cannot read properties of null (reading 'play')` | 1 |
多数页面最终仍能显示，但这些错误可能造成偶发空白、数据加载延迟、视频自动播放失败或隐性接口失败。
建议：在浏览器 Network 面板和服务端日志中定位具体失败接口、HTTP 状态、CORS、超时和重试情况；为异步页面增加加载骨架、错误提示和重试按钮；修复空 DOM 引用。
### P2：用工体检向第三方页面传递标识参数
“开始诊断”会整页跳转到腾讯问卷，并在 URL 中携带 `openid` 参数。
建议：由产品、法务和安全团队确认该参数是否属于个人标识、是否已在隐私政策中说明、腾讯问卷的数据处理角色和留存周期；建议使用短期一次性令牌，避免直接暴露稳定标识，并考虑新标签页打开或增加返回平台入口。
### P3：部分页面首次进入存在短暂空白/延迟加载
员工花名册、合同管理、模板库、通知管理等页面在进入后的约 0.7 秒内可能只显示框架，等待约 1.5—1.8 秒后数据才完整出现。
建议：增加统一加载状态或骨架屏，避免用户误以为“暂无数据”；同时结合上述网络错误排查性能瓶颈。
## 5. 建议的处理优先级
### 立即处理（当天）
1. 核实并处理 3 条超期合同。
2. 核实已离职人员仍出现续签待办的原因。
3. 对比首页 4 项与待办中心 3 项的统计明细。
4. 确认医疗期计算器法律依据是否仍有效。
### 一周内处理
1. 修复背景调查 `-1次` 的展示或额度逻辑。
2. 明确员工风险分布的统计口径。
3. 将无固定期限合同显示为语义化状态，而不是 2099 年和数万天。
4. 排查 Axios 网络错误和 `clientHeight` 空引用。
5. 复核腾讯问卷 `openid` 参数的隐私与安全合规。
### 持续优化
1. 为延迟加载页面增加骨架屏和失败重试。
2. 为关键统计增加“更新时间”和数据来源说明。
3. 对合同、人员、待办三类状态建立每日自动一致性校验。
4. 对法律计算器增加政策版本、适用地区、最后审核日期和免责声明。
## 6. 建议的回归测试用例
1. 离职员工完成离职后，续签待办是否自动关闭。
2. 首页待办总数是否等于各分类待办之和。
3. 背调额度为 0、正数、无限次时，文案和按钮状态是否正确。
4. 无固定期限合同在合同列表和花名册中的显示是否一致。
5. 花名册风险分布在分页、搜索、部门筛选前后是否符合定义。
6. 医疗期政策更新后，上海和全国模式的计算结果是否经过法务复核。
7. 慢网、接口失败、接口超时下是否显示加载/错误/重试状态。
8. 视频详情页首次进入、自动播放被浏览器拦截、切换课程时是否仍有 `play` 空引用。
9. 外部诊断问卷链接是否使用短期令牌，且返回平台流程正常。
## 7. 测试边界
以下项目因可能产生正式业务影响，本次只验证到入口或表单，不执行最终动作：
- AI 问题发送、转专家、判赔预测；
- 文件审查上传；
- 添加/导入/导出员工；
- 发布考勤和工资条；
- 保存或发布各类用工办理流程；
- 合同下载、删除、续签、终止和自定义签署；
- 发起背景调查；
- 发布民主程序和通知；
- 提交腾讯诊断问卷；
- 使用模板正式发起流程。
如需继续做“可产生真实数据”的验收，建议先创建专用测试企业和测试员工，再按上述回归用例执行提交、短信、小程序待办、电子签署和撤销闭环测试。