|
|
# 合同管理
|
|
|
|
|
|
> 模块编码: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 |
|