# 合同管理

> 模块编码：contract
> 端侧：Web专属（仅医院账号）
> 关联文档：01-模块划分 §4.1 / 02-功能清单-医院 §1 / 03-业务流转逻辑-医院 §1 / 05-接口规范 §9.2

## 功能概览

| 项目 | 说明 |
|------|------|
| 菜单名称 | 合同管理 |
| 子菜单 | 合同台账、合同录入、合同详情、合同审批、付款管理、变更管理、到期预警、续签管理、合同导出 |
| 功能编号 | HO-CT-01 ~ HO-CT-11 |
| 权限编码前缀 | contract:list:* / contract:approve:* / contract:payment:* / contract:change:* |

> **重要**：合同管理仅医院账号可用，物业公司不可操作此模块。

---

## 页面1：合同台账页

**页面编号**：HO-CT-01-P01
**端侧归属**：Web专属
**页面路径**：/contract/list

### 界面布局

```
┌──────────────────────────────────────────────────────────────────┐
│ [面包屑] 合同管理 > 合同台账                                       │
├──────────────────────────────────────────────────────────────────┤
│ [查询条件区]                                                      │
│ 合同名称[____] 合同类型[▼] 状态[▼] 物业公司[▼]                    │
│ 签约日期[起始]~[结束]                               [查询] [重置]  │
├──────────────────────────────────────────────────────────────────┤
│ [操作栏]  [新增合同] [导出Excel]                                   │
├──────────────────────────────────────────────────────────────────┤
│ [列表区]                                                          │
│ 序号| 合同名称   | 类型   | 物业公司 | 金额   | 状态   | 到期日   │
│ 1  | 2026年保洁 | 保洁   | XX物业   | 120万  | 履约中 | 2027-04  │
│ 2  | 2026年维修 | 维修   | XX物业   | 80万   | 审批中 | —        │
│ 3  | 2025年安保 | 安保   | YY物业   | 60万   | 即将到期| 2026-05 │
├──────────────────────────────────────────────────────────────────┤
│ [分页]  共25条  每页[20▼]  < 1 2 >                                │
└──────────────────────────────────────────────────────────────────┘
```

### 查询条件

| 字段名 | 控件类型 | 必填 | 默认值 | 说明 |
|--------|----------|------|--------|------|
| 合同名称 | 文本输入 | 否 | — | 模糊匹配 |
| 合同类型 | 下拉单选 | 否 | 全部 | 保洁/维修/安保/综合/其他 |
| 状态 | 下拉单选 | 否 | 全部 | 审批中/履约中/变更审批中/即将到期/已终止 |
| 物业公司 | 下拉单选 | 否 | 全部 | 关联物业公司 |
| 签约日期 | 日期范围 | 否 | — | — |

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 序号 | 60px | — | 自增 |
| 2 | 合同名称 | 180px | 是 | 点击跳转详情 |
| 3 | 合同类型 | 80px | 否 | 标签样式 |
| 4 | 物业公司 | 120px | 是 | — |
| 5 | 合同金额 | 100px | 是 | — |
| 6 | 状态 | 90px | 是 | 彩色标签 |
| 7 | 服务期限 | 120px | 否 | 起始~结束 |
| 8 | 到期日 | 100px | 是 | 即将到期=橙色 |
| 9 | 操作 | 140px | — | 查看/审批 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 新增合同 | contract:list:create | 操作栏 | 始终 | — |
| 导出Excel | contract:list:export | 操作栏 | 始终 | — |
| 查看 | contract:list:view | 行操作 | 始终 | — |
| 审批 | contract:approve:* | 行操作 | 状态=审批中 | — |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 列表查询 | /api/v1/contracts | GET | 分页查询 |
| 导出 | /api/v1/contracts/export | GET | — |

---

## 页面2：合同录入页

**页面编号**：HO-CT-02-P01
**端侧归属**：Web专属
**页面路径**：/contract/create

### 表单字段

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 合同名称 | 文本输入 | 是 | — | 自填 | 最大100字 |
| 合同类型 | 下拉单选 | 是 | — | 字典管理-合同类型 | — |
| 关联物业公司 | 下拉单选 | 是 | — | 本医院关联的物业公司 | — |
| 关联院区 | 下拉多选 | 是 | — | 本医院院区列表 | — |
| 合同金额 | 数字输入 | 是 | — | 自填 | >0 |
| 服务期限(起) | 日期选择 | 是 | — | 自填 | — |
| 服务期限(止) | 日期选择 | 是 | — | 自填 | 晚于起始日期 |
| 付款方式 | 下拉单选 | 是 | — | 固定选项 | 一次性/分期/按节点 |
| 合同描述 | 多行文本 | 否 | — | 自填 | 最大500字 |
| 合同附件 | 文件上传 | 是 | — | 上传 | ≤10个文件，支持PDF/Word/图片 |

### 付款节点（分期付款时）

| 字段名 | 控件类型 | 必填 | 默认值 | 数据来源 | 校验规则 |
|--------|----------|------|--------|----------|----------|
| 节点名称 | 文本输入 | 是 | — | 自填 | — |
| 节点金额 | 数字输入 | 是 | — | 自填 | — |
| 预计付款日期 | 日期选择 | 是 | — | 自填 | — |
| 付款条件 | 多行文本 | 否 | — | 自填 | — |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 保存草稿 | contract:list:create | 底部 | 始终 | — |
| 提交审批 | contract:list:create | 底部 | 始终 | 状态→审批中 |

### 通知触发

| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|----------|----------|----------|----------|----------|
| 提交审批 | 审批人 | Web提醒 | 合同审批待办 | 03-医院 §1.2 |

### API端点

| 页面操作 | API路径 | 方法 | 说明 |
|----------|---------|------|------|
| 新增 | /api/v1/contracts | POST | — |
| 提交审批 | /api/v1/contracts/{id}/submit | POST | — |

---

## 页面3：合同详情页

**页面编号**：HO-CT-03-P01
**端侧归属**：Web专属
**页面路径**：/contract/:id

### 标签页内容

| 标签页 | 内容 | 说明 |
|--------|------|------|
| 基本信息 | 合同名称、类型、金额、服务期限、物业公司、院区 | — |
| 付款节点 | 付款计划列表、各节点状态 | — |
| 变更记录 | 合同变更历史 | — |
| 关联项目 | 关联的招标项目 | — |
| 附件 | 合同文件、补充文件 | — |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 审批通过 | contract:approve:* | 底部 | 状态=审批中 | — |
| 审批驳回 | contract:approve:* | 底部 | 状态=审批中 | 填写驳回原因 |
| 申请变更 | contract:change:create | 底部 | 状态=履约中 | — |
| 终止合同 | contract:list:update | 底部 | 状态=履约中 | 二次确认 |

---

## 页面4：付款管理页

**页面编号**：HO-CT-05-P01
**端侧归属**：Web专属
**页面路径**：/contract/payments

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 合同名称 | 150px | 否 | — |
| 2 | 节点名称 | 120px | 否 | — |
| 3 | 节点金额 | 100px | 是 | — |
| 4 | 预计付款日期 | 120px | 是 | — |
| 5 | 实际付款日期 | 120px | 否 | — |
| 6 | 状态 | 80px | 否 | 待付款/已付款/逾期 |
| 7 | 操作 | 100px | — | 确认付款 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 确认付款 | contract:payment:update | 行操作 | 状态=待付款 | 填写实际付款信息 |

### 通知触发

| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|----------|----------|----------|----------|----------|
| 付款节点到期提醒 | 医院账号 | Web提醒 | 付款节点即将到期 | 03-医院 §1.2 |

---

## 页面5：变更管理页

**页面编号**：HO-CT-07-P01
**端侧归属**：Web专属
**页面路径**：/contract/changes

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 合同名称 | 150px | 否 | — |
| 2 | 变更类型 | 80px | 否 | 金额变更/期限变更/条款变更 |
| 3 | 变更原因 | 200px | 否 | — |
| 4 | 申请人 | 80px | 否 | — |
| 5 | 申请时间 | 140px | 是 | 默认倒序 |
| 6 | 审批状态 | 90px | 否 | 待审批/已通过/已驳回 |
| 7 | 操作 | 100px | — | 审批/查看 |

### 操作按钮

| 按钮 | 权限编码 | 位置 | 显示条件 | 说明 |
|------|----------|------|----------|------|
| 审批 | contract:change:approve | 行操作 | 审批状态=待审批 | 通过/驳回 |

---

## 页面6：到期预警页

**页面编号**：HO-CT-09-P01
**端侧归属**：Web专属
**页面路径**：/contract/expiring

### 列表字段

| 序号 | 字段名 | 列宽 | 支持排序 | 说明 |
|------|--------|------|----------|------|
| 1 | 合同名称 | 150px | 否 | — |
| 2 | 物业公司 | 120px | 否 | — |
| 3 | 到期日期 | 120px | 是 | — |
| 4 | 剩余天数 | 80px | 是 | 红色标记 |
| 5 | 操作 | 120px | — | 续签/终止 |

### 通知触发

| 触发操作 | 通知对象 | 通知方式 | 消息模板 | 文档来源 |
|----------|----------|----------|----------|----------|
| 合同到期前30天 | 医院账号 | Web提醒 | 合同即将到期 | 03-医院 §1.2 / 05 §5.2 (CONTRACT_EXPIRING) |
| 合同到期前15天 | 医院账号 | Web提醒 | 合同即将到期 | — |
| 合同到期前7天 | 医院账号 | Web提醒 | 合同即将到期 | — |

---

## 需求追溯

| 功能点编号 | 功能名称 | 文档来源 | 后续服务 | 关联功能 |
|------------|----------|----------|----------|----------|
| HO-CT-01 | 合同台账 | 02-医院 §1 / 03-医院 §1.2 | — | — |
| HO-CT-02 | 合同录入 | 02-医院 §1 / 03-医院 §1.2 | 录入→提交审批 | — |
| HO-CT-03 | 合同详情 | 02-医院 §1 / 03-医院 §1.2 | — | 招标管理(关联项目) |
| HO-CT-04 | 合同审批 | 02-医院 §1 / 03-医院 §1.2 | 审批→履约中 | 操作日志 |
| HO-CT-05 | 付款管理 | 02-医院 §1 / 03-医院 §1.2 | 节点到期→提醒 | — |
| HO-CT-06 | 付款确认 | 02-医院 §1 / 03-医院 §1.2 | 确认→更新付款状态 | — |
| HO-CT-07 | 变更管理 | 02-医院 §1 / 03-医院 §1.2 | 变更→审批 | — |
| HO-CT-08 | 变更审批 | 02-医院 §1 / 03-医院 §1.2 | 通过→变更生效 | 操作日志 |
| HO-CT-09 | 到期预警 | 02-医院 §1 / 03-医院 §1.2 | 到期→提醒→续签/终止 | 通知机制 |
| HO-CT-10 | 续签管理 | 02-医院 §1 / 03-医院 §1.2 | 续签→审批流程 | 合同审批 |
| HO-CT-11 | 合同导出 | 02-医院 §1 | — | 操作日志 |

## 业务规则

1. **仅医院账号可用**：物业公司不可操作此模块（来源：01 §4.1 / 02-医院 §1）
2. **合同审批流程**：录入→审批中→审批通过(履约中)/审批驳回(需修改重新提交)（来源：03-医院 §1.2）
3. **到期预警**：合同到期前30/15/7天自动提醒（来源：02-医院 HO-CT-09 / 03-医院 §1.2）
4. **付款节点提醒**：付款节点到期前自动提醒医院账号（来源：03-医院 §1.2）
5. **变更需审批**：合同变更申请需审批通过后才生效（来源：03-医院 §1.2）
6. **所有操作记录日志**：合同录入、审批、付款、变更等操作自动记录（来源：06 §4.5）

## 状态流转

```
合同录入 ──▶ 审批中 ──▶ 履约中 ──▶ 到期预警 ──▶ 续签/终止
                 │          │
            审批驳回    变更管理(可选) ──▶ 变更审批中
            (需修改)                       │
                                   变更审批通过/驳回
```

| 当前状态 | 操作 | 目标状态 | 执行角色 | 端侧 |
|----------|------|----------|----------|------|
| — | 合同录入 | 审批中 | 医院账号 | Web |
| 审批中 | 审批通过 | 履约中 | 医院账号 | Web |
| 审批中 | 审批驳回 | — | 医院账号 | Web |
| 履约中 | 付款确认 | 履约中 | 医院账号 | Web |
| 履约中 | 变更申请 | 变更审批中 | 医院账号 | Web |
| 变更审批中 | 变更审批通过 | 履约中 | 医院账号 | Web |
| 变更审批中 | 变更审批驳回 | 履约中 | 医院账号 | Web |
| 履约中 | 续签 | 履约中 | 医院账号 | Web |
| 履约中 | 终止 | 已终止 | 医院账号 | Web |