员工合同管理 - 前端联调方案

涉及页面

• 新增「员工合同」管理页：views/hrm/employee/contract/index.vue
• 新增「员工合同」菜单（已配置后端菜单，挂载在 HRM → 人力资源 下、与「员工管理」平级，component = hrm/employee/contract/index；不要挂到「员工管理」下，否则该菜单会变成目录导致员工列表页无法直达）
• 选择员工下拉：复用现有员工精简列表接口
• 员工详情页：新增「员工合同」Tab，展示该员工签订的全部合同（复用 /hrm/employee-contract/page，按 employeeId 过滤）

业务流程与数据带入

1. 创建合同：员工从 /hrm/employee/simple-list 下拉选择 → 自动带入员工（无需再选部门/岗位）
2. 续签合同：合同列表操作列「续签」按钮 → 自动带入该员工 + 上份合同的类型/期限/签约主体/工资，日期需重新填写；提交时显式传 parentId 指向被续签合同
3. 合同列表：按合同编号、员工、合同类型、期限类型、合同状态、到期类型筛选
4. 解除/终止：仅对"待生效/生效中/即将到期"的合同可操作，弹出确认框填写解除日期与原因
5. 到期提醒：列表支持「即将到期 / 已到期」快捷筛选；HRM 首页可调用 expiring-count 展示即将到期合同数量

API

创建/修改合同

请求参数（create/update 共用）：

校验规则（后端强制）：
- 期限类型 ≠ 无固定期限(2) 时，endDate 必填
- startDate 不能晚于 endDate；试用期开始不能晚于试用期结束
- 合同编号由后端自动生成（HT + 日期 + 序号），前端无需填写、不可修改

响应示例：

{
  "code": 0,
  "data": 1
}

解除/终止合同

请求参数：

响应： { "code": 0, "data": true }

合同分页

请求参数（筛选）：

响应字段新增：

响应示例：

{
  "code": 0,
  "data": {
    "list": [
      {
        "id": 1,
        "contractNo": "HT202608100001",
        "employeeId": 1,
        "employeeName": "张三",
        "employeeNo": "EMP202401010001",
        "deptName": "研发部",
        "contractType": 1,
        "contractTermType": 1,
        "startDate": "2026-01-01",
        "endDate": "2027-01-01",
        "status": 2,
        "terminateStatus": 0
      }
    ],
    "total": 1
  }
}

字段展示规则

| 合同状态 | ✅ 标签 | - | ✅ | 动态计算，按颜色区分：生效中(绿)/即将到期(橙)/已到期(灰)/已解除·已终止(红)/待生效(蓝) |
| 附件 | - | 上传 | ✅ | 走系统附件上传 |
| 操作 | ✅ | - | - | 编辑 / 解除/终止 / 删除 |

附件对接流程

1. 上传：调用 POST /system/storage-blob/upload 获取 blobId
2. 保存合同：表单 blobIds 字段传 blobId 数组，后端绑定
3. 查询：详情接口返回 attachmentList；列表页如需单独刷新附件，可调用 GET /system/storage-attachment/list?recordType=hrm_employee_contract&recordId=xxx
4. 业务表不存文件地址，禁止在前端调用 /infra/file/* 旧接口

业务规则说明

多合同设计：一个员工可签订多次合同（续签/换签）。数据表通过 parent_id（续签上一份合同ID）形成续签链，通过 is_current（是否当前生效合同）标识员工当前合同；同一员工任意时刻仅一份 is_current=true 的合同。

注意事项

• 合同编号唯一，由后端生成，前端不能修改
• 新增/编辑合同的校验（固定期限必须填结束日期、日期先后）由后端返回明确错误提示，前端表单校验可同步加上
• 列表状态列需根据 status 值映射字典 hrm_contract_status 展示中文与颜色
• 解除/终止操作需二次确认，避免误操作
• 分页查询附件列表为空时不返回该字段，前端需做空值兼容