|
|
|
|
@ -0,0 +1,300 @@
|
|
|
|
|
# 合同变更功能设计方案
|
|
|
|
|
|
|
|
|
|
## 一、需求理解（通俗说明）
|
|
|
|
|
|
|
|
|
|
- **谁能变更**：只有「已激活」的合同可以发起变更。即：合同状态=可用（contract_status='3'）且 激活标识=是（active_flag='1'）。
|
|
|
|
|
- **做什么**：
|
|
|
|
|
1. 做一个「合同变更」列表页，风格和合同信息列表类似，能新增；点新增就跳到「合同变更申请」页。
|
|
|
|
|
2. 在「合同变更申请」页里先选一个合同，选完后把该合同的信息、物料等查出来填到页面，用户可修改后提交（暂存或走审批）。
|
|
|
|
|
3. 要能按合同查「合同变更历史」——某合同共发生过几次变更、每次变更单号、时间、状态、是否已回写等。
|
|
|
|
|
4. 变更审批通过后，要把「变更后的内容」写回正式表：合同表（erp_contract_info）、合同物料表（erp_contract_material）。
|
|
|
|
|
|
|
|
|
|
下面按「表结构」和「业务逻辑」分开说，不写具体代码，只讲逻辑与 SQL 表结构。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 二、表结构设计（MySQL）
|
|
|
|
|
|
|
|
|
|
思路：**一次变更 = 一张变更单 + 变更后的合同信息快照 + 变更后的物料快照**。
|
|
|
|
|
审批通过后，用快照表的数据去更新正式合同表、合同物料表，并标记「已回写」，便于查历史、防重复回写。
|
|
|
|
|
|
|
|
|
|
### 1. 合同变更主表：erp_contract_change
|
|
|
|
|
|
|
|
|
|
存「一次变更申请」的公共信息，关联原合同。
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 字段名 | 类型 | 说明 |
|
|
|
|
|
| ------------------ | -------------- | --------------------------------------- |
|
|
|
|
|
| contract_change_id | bigint, PK, 自增 | 合同变更ID |
|
|
|
|
|
| tenant_id | varchar(20) | 租户编号 |
|
|
|
|
|
| contract_id | bigint | 原合同ID（关联 erp_contract_info.contract_id） |
|
|
|
|
|
| contract_code | varchar(64) | 原合同编号（冗余，列表展示用） |
|
|
|
|
|
| contract_name | varchar(255) | 原合同名称（冗余，列表展示用） |
|
|
|
|
|
| change_code | varchar(64) | 变更单编号（如：HTBG-2025-001） |
|
|
|
|
|
| change_reason | varchar(500) | 变更原因 |
|
|
|
|
|
| change_status | varchar(32) | 变更状态：1暂存 2审批中 3可用 |
|
|
|
|
|
| flow_status | varchar(32) | 流程状态（与工作流一致） |
|
|
|
|
|
| apply_time | datetime | 申请时间 |
|
|
|
|
|
| write_back_flag | char(1) | 是否已回写：0否 1是 |
|
|
|
|
|
| write_back_time | datetime | 回写时间 |
|
|
|
|
|
| remark | varchar(255) | 备注 |
|
|
|
|
|
| active_flag | char(1) | 激活标识（1是 0否） |
|
|
|
|
|
| del_flag | char(1) | 删除标志（0存在 1删除） |
|
|
|
|
|
| create_dept | bigint | 创建部门 |
|
|
|
|
|
| create_by | bigint | 创建人 |
|
|
|
|
|
| create_time | datetime | 创建时间 |
|
|
|
|
|
| update_by | bigint | 更新人 |
|
|
|
|
|
| update_time | datetime | 更新时间 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
**说明**：
|
|
|
|
|
|
|
|
|
|
- 列表页、历史记录都查这张表；按 contract_id 查即该合同的变更历史。
|
|
|
|
|
- write_back_flag 防止重复回写；只有 change_status='3'（可用）且流程通过后才执行回写并置为 1。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 2. 合同变更信息快照表：erp_contract_change_info
|
|
|
|
|
|
|
|
|
|
存「变更后的合同主信息」快照，字段与 erp_contract_info 对齐（去掉合同主键 contract_id，改为关联变更单）。
|
|
|
|
|
|
|
|
|
|
- **主键**：change_info_id（bigint, 自增）。
|
|
|
|
|
- **关联**：contract_change_id（bigint，关联 erp_contract_change.contract_change_id）。
|
|
|
|
|
- **其余字段**：与 erp_contract_info 一致（如 contract_code、contract_name、total_price、contract_date、contract_manager_id 等所有业务字段），但这里表示的是「变更后」要写回合同表的值。
|
|
|
|
|
- 公共字段：tenant_id, remark, del_flag, create_dept, create_by, create_time, update_by, update_time。
|
|
|
|
|
|
|
|
|
|
**约束**：一个变更单对应一条快照（1:1）。回写时：用这条记录 UPDATE erp_contract_info SET ... WHERE contract_id = 主表中的 contract_id。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 3. 合同变更物料快照表：erp_contract_change_material
|
|
|
|
|
|
|
|
|
|
存「变更后的合同物料」快照，字段与 erp_contract_material 对齐。
|
|
|
|
|
|
|
|
|
|
- **主键**：change_material_id（bigint, 自增）。
|
|
|
|
|
- **关联**：contract_change_id（bigint），不存 contract_id（回写时再填原 contract_id）。
|
|
|
|
|
- **其余字段**：与 erp_contract_material 一致（如 material_flag, product_name, specification_description, material_id, amount, unit_id, before_price, tax_rate, including_price, subtotal, remark 等）。
|
|
|
|
|
- 公共字段：tenant_id, active_flag, del_flag, create_dept, create_by, create_time, update_by, update_time。
|
|
|
|
|
|
|
|
|
|
**回写逻辑**：
|
|
|
|
|
|
|
|
|
|
- 先按原 contract_id 删除 erp_contract_material 中该合同下所有物料；
|
|
|
|
|
- 再把本变更单下 erp_contract_change_material 的记录插入到 erp_contract_material，contract_id 填原合同ID。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
### 4. 合同变更付款方式快照表：erp_contract_change_payment_method
|
|
|
|
|
|
|
|
|
|
存「变更后的合同付款方式」快照，字段与 erp_contract_payment_method 一一对齐。
|
|
|
|
|
|
|
|
|
|
- **主键**：change_payment_id（bigint, 自增）。
|
|
|
|
|
- **关联**：contract_change_id（bigint），关联 erp_contract_change.contract_change_id；不存 contract_id（回写时再填原 contract_id）。
|
|
|
|
|
- **业务字段**（与 erp_contract_payment_method 一致）：sort_order、payment_stage_id、payment_deadline、payment_percentage、invoice_percentage、payment_amount、payment_description、remark。
|
|
|
|
|
- **公共字段**：tenant_id、active_flag、del_flag、create_dept、create_by、create_time、update_by、update_time。
|
|
|
|
|
|
|
|
|
|
**回写逻辑**：
|
|
|
|
|
|
|
|
|
|
- 先按原 contract_id 删除 erp_contract_payment_method 中该合同下所有付款方式；
|
|
|
|
|
- 再把本变更单下 erp_contract_change_payment_method 的记录插入到 erp_contract_payment_method，contract_id 填原合同ID，其他字段从快照表拷贝。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 三、建表 SQL 示例
|
|
|
|
|
|
|
|
|
|
```sql
|
|
|
|
|
-- 合同变更主表
|
|
|
|
|
DROP TABLE IF EXISTS `erp_contract_change`;
|
|
|
|
|
CREATE TABLE `erp_contract_change` (
|
|
|
|
|
`contract_change_id` bigint NOT NULL AUTO_INCREMENT COMMENT '合同变更ID',
|
|
|
|
|
`tenant_id` varchar(20) DEFAULT '000000' COMMENT '租户编号',
|
|
|
|
|
`contract_id` bigint NOT NULL COMMENT '原合同ID',
|
|
|
|
|
`contract_code` varchar(64) DEFAULT NULL COMMENT '原合同编号',
|
|
|
|
|
`contract_name` varchar(255) DEFAULT NULL COMMENT '原合同名称',
|
|
|
|
|
`change_code` varchar(64) DEFAULT NULL COMMENT '变更单编号',
|
|
|
|
|
`change_reason` varchar(500) DEFAULT NULL COMMENT '变更原因',
|
|
|
|
|
`change_status` varchar(32) DEFAULT NULL COMMENT '变更状态(1暂存 2审批中 3可用)',
|
|
|
|
|
`flow_status` varchar(32) DEFAULT NULL COMMENT '流程状态',
|
|
|
|
|
`apply_time` datetime DEFAULT NULL COMMENT '申请时间',
|
|
|
|
|
`write_back_flag` char(1) DEFAULT '0' COMMENT '是否已回写(0否 1是)',
|
|
|
|
|
`write_back_time` datetime DEFAULT NULL COMMENT '回写时间',
|
|
|
|
|
`remark` varchar(255) DEFAULT NULL COMMENT '备注',
|
|
|
|
|
`active_flag` char(1) DEFAULT '1' COMMENT '激活标识(1是 0否)',
|
|
|
|
|
`del_flag` char(1) DEFAULT '0' COMMENT '删除标志(0存在 1删除)',
|
|
|
|
|
`create_dept` bigint DEFAULT NULL COMMENT '创建部门',
|
|
|
|
|
`create_by` bigint DEFAULT NULL COMMENT '创建人',
|
|
|
|
|
`create_time` datetime DEFAULT NULL COMMENT '创建时间',
|
|
|
|
|
`update_by` bigint DEFAULT NULL COMMENT '更新人',
|
|
|
|
|
`update_time` datetime DEFAULT NULL COMMENT '更新时间',
|
|
|
|
|
PRIMARY KEY (`contract_change_id`),
|
|
|
|
|
KEY `idx_contract_id` (`contract_id`),
|
|
|
|
|
KEY `idx_change_status` (`change_status`),
|
|
|
|
|
KEY `idx_change_code` (`change_code`)
|
|
|
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='合同变更主表';
|
|
|
|
|
|
|
|
|
|
-- 合同变更信息快照表（字段与 erp_contract_info 对齐，此处仅列关键字段，其余按 erp_contract_info 补全）
|
|
|
|
|
DROP TABLE IF EXISTS `erp_contract_change_info`;
|
|
|
|
|
CREATE TABLE `erp_contract_change_info` (
|
|
|
|
|
`change_info_id` bigint NOT NULL AUTO_INCREMENT COMMENT '变更信息快照ID',
|
|
|
|
|
`tenant_id` varchar(20) DEFAULT '000000' COMMENT '租户编号',
|
|
|
|
|
`contract_change_id` bigint NOT NULL COMMENT '合同变更ID',
|
|
|
|
|
`contract_flag` char(1) DEFAULT NULL COMMENT '有无合同(1有 2无)',
|
|
|
|
|
`customer_contract_code` varchar(128) DEFAULT NULL COMMENT '客户合同编号',
|
|
|
|
|
`contract_code` varchar(64) DEFAULT NULL COMMENT '合同编号',
|
|
|
|
|
`contract_name` varchar(255) DEFAULT NULL COMMENT '合同名称',
|
|
|
|
|
`contract_category` varchar(32) DEFAULT NULL COMMENT '合同大类',
|
|
|
|
|
`contract_type` varchar(32) DEFAULT NULL COMMENT '合同类型',
|
|
|
|
|
`business_direction` varchar(16) DEFAULT NULL COMMENT '业务方向',
|
|
|
|
|
`contract_dept_id` bigint DEFAULT NULL COMMENT '部门',
|
|
|
|
|
`contract_date` datetime DEFAULT NULL COMMENT '合同签订日期',
|
|
|
|
|
`total_price` decimal(16,2) DEFAULT NULL COMMENT '合同总价',
|
|
|
|
|
`one_customer_id` bigint DEFAULT NULL COMMENT '甲方公司',
|
|
|
|
|
`one_represent` varchar(128) DEFAULT NULL COMMENT '甲方授权代表',
|
|
|
|
|
`one_date` datetime DEFAULT NULL COMMENT '甲方签字日期',
|
|
|
|
|
`two_customer_id` bigint DEFAULT NULL COMMENT '乙方公司',
|
|
|
|
|
`two_represent` varchar(128) DEFAULT NULL COMMENT '乙方授权代表',
|
|
|
|
|
`two_date` datetime DEFAULT NULL COMMENT '乙方签字日期',
|
|
|
|
|
`contract_manager_id` bigint DEFAULT NULL COMMENT '合同负责人',
|
|
|
|
|
`template_id` bigint DEFAULT NULL COMMENT '合同模板ID',
|
|
|
|
|
`oss_id` varchar(512) DEFAULT NULL COMMENT '附件ID',
|
|
|
|
|
`payment_account_id` bigint DEFAULT NULL COMMENT '付款账户ID',
|
|
|
|
|
`payment_method` varchar(128) DEFAULT NULL COMMENT '付款方式',
|
|
|
|
|
`signature_appendix` bigint DEFAULT NULL COMMENT '签字合同附件',
|
|
|
|
|
`warranty_period` int DEFAULT NULL COMMENT '质保期(天)',
|
|
|
|
|
`internal_contract_code` varchar(128) DEFAULT NULL COMMENT '内部合同号',
|
|
|
|
|
`external_contract_code` varchar(128) DEFAULT NULL COMMENT '外部合同号',
|
|
|
|
|
`order_contract_code` varchar(128) DEFAULT NULL COMMENT '订单号',
|
|
|
|
|
`project_contract_code` varchar(128) DEFAULT NULL COMMENT '项目号',
|
|
|
|
|
`delivery_start` int DEFAULT NULL COMMENT '交付启动期限',
|
|
|
|
|
`warranty_period_description` varchar(128) DEFAULT '' COMMENT '质保期描述',
|
|
|
|
|
`delivery_location` varchar(255) DEFAULT '' COMMENT '交货地点',
|
|
|
|
|
`ship_method` varchar(128) DEFAULT '' COMMENT '运输方式',
|
|
|
|
|
`tax_rate` decimal(16,2) DEFAULT NULL COMMENT '合同税率',
|
|
|
|
|
`signing_place` varchar(200) DEFAULT '' COMMENT '签订地点',
|
|
|
|
|
`material_remark` varchar(500) DEFAULT '' COMMENT '合同物料备注',
|
|
|
|
|
`contract_template_flag` char(1) DEFAULT NULL COMMENT '合同模板标识',
|
|
|
|
|
`capitalized_amount` varchar(128) DEFAULT NULL COMMENT '合同大写金额',
|
|
|
|
|
`remark` varchar(255) DEFAULT NULL COMMENT '备注',
|
|
|
|
|
`del_flag` char(1) DEFAULT '0' COMMENT '删除标志',
|
|
|
|
|
`create_dept` bigint DEFAULT NULL COMMENT '创建部门',
|
|
|
|
|
`create_by` bigint DEFAULT NULL COMMENT '创建人',
|
|
|
|
|
`create_time` datetime DEFAULT NULL COMMENT '创建时间',
|
|
|
|
|
`update_by` bigint DEFAULT NULL COMMENT '更新人',
|
|
|
|
|
`update_time` datetime DEFAULT NULL COMMENT '更新时间',
|
|
|
|
|
PRIMARY KEY (`change_info_id`),
|
|
|
|
|
UNIQUE KEY `uk_contract_change_id` (`contract_change_id`)
|
|
|
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='合同变更信息快照';
|
|
|
|
|
|
|
|
|
|
-- 合同变更物料快照表（字段与 erp_contract_material 对齐）
|
|
|
|
|
DROP TABLE IF EXISTS `erp_contract_change_material`;
|
|
|
|
|
CREATE TABLE `erp_contract_change_material` (
|
|
|
|
|
`change_material_id` bigint NOT NULL AUTO_INCREMENT COMMENT '变更物料快照ID',
|
|
|
|
|
`tenant_id` varchar(20) DEFAULT '000000' COMMENT '租户编号',
|
|
|
|
|
`contract_change_id` bigint NOT NULL COMMENT '合同变更ID',
|
|
|
|
|
`material_flag` char(1) DEFAULT NULL COMMENT '标准物料标识',
|
|
|
|
|
`product_name` varchar(255) DEFAULT NULL COMMENT '产品名称',
|
|
|
|
|
`specification_description` varchar(255) DEFAULT NULL COMMENT '规格描述',
|
|
|
|
|
`material_id` bigint DEFAULT NULL COMMENT '物料ID',
|
|
|
|
|
`relation_material_id` bigint DEFAULT NULL COMMENT '销售物料ID',
|
|
|
|
|
`amount` decimal(16,2) DEFAULT NULL COMMENT '数量',
|
|
|
|
|
`unit_id` bigint DEFAULT NULL COMMENT '单位ID',
|
|
|
|
|
`before_price` decimal(16,2) DEFAULT NULL COMMENT '未税单价',
|
|
|
|
|
`tax_rate` decimal(16,2) DEFAULT NULL COMMENT '税率',
|
|
|
|
|
`including_price` decimal(16,2) DEFAULT NULL COMMENT '含税单价',
|
|
|
|
|
`subtotal` decimal(16,2) DEFAULT NULL COMMENT '小计',
|
|
|
|
|
`remark` varchar(255) DEFAULT NULL COMMENT '备注',
|
|
|
|
|
`sort_order` int DEFAULT 0 COMMENT '排序号',
|
|
|
|
|
`active_flag` char(1) DEFAULT '1' COMMENT '激活标识',
|
|
|
|
|
`del_flag` char(1) DEFAULT '0' COMMENT '删除标志',
|
|
|
|
|
`create_dept` bigint DEFAULT NULL COMMENT '创建部门',
|
|
|
|
|
`create_by` bigint DEFAULT NULL COMMENT '创建人',
|
|
|
|
|
`create_time` datetime DEFAULT NULL COMMENT '创建时间',
|
|
|
|
|
`update_by` bigint DEFAULT NULL COMMENT '更新人',
|
|
|
|
|
`update_time` datetime DEFAULT NULL COMMENT '更新时间',
|
|
|
|
|
PRIMARY KEY (`change_material_id`),
|
|
|
|
|
KEY `idx_contract_change_id` (`contract_change_id`)
|
|
|
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='合同变更物料快照';
|
|
|
|
|
|
|
|
|
|
-- 合同变更付款方式快照表（字段与 erp_contract_payment_method 对齐）
|
|
|
|
|
DROP TABLE IF EXISTS `erp_contract_change_payment_method`;
|
|
|
|
|
CREATE TABLE `erp_contract_change_payment_method` (
|
|
|
|
|
`change_payment_id` bigint NOT NULL AUTO_INCREMENT COMMENT '变更付款方式快照ID',
|
|
|
|
|
`tenant_id` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT '000000' COMMENT '租户编号',
|
|
|
|
|
`contract_change_id` bigint NOT NULL COMMENT '合同变更ID',
|
|
|
|
|
`sort_order` int NULL DEFAULT NULL COMMENT '排序号',
|
|
|
|
|
`payment_stage_id` bigint NULL DEFAULT NULL COMMENT '付款节点ID',
|
|
|
|
|
`payment_deadline` decimal(8, 0) NULL DEFAULT NULL COMMENT '支付期限',
|
|
|
|
|
`payment_percentage` decimal(8, 0) NULL DEFAULT NULL COMMENT '支付比例',
|
|
|
|
|
`invoice_percentage` decimal(8, 0) NULL DEFAULT NULL COMMENT '发票比例',
|
|
|
|
|
`payment_amount` decimal(16, 2) NULL DEFAULT NULL COMMENT '支付金额',
|
|
|
|
|
`payment_description` varchar(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '付款条款',
|
|
|
|
|
`remark` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT NULL COMMENT '备注',
|
|
|
|
|
`active_flag` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT '1' COMMENT '激活标识（1是 0否）',
|
|
|
|
|
`del_flag` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NULL DEFAULT '0' COMMENT '删除标志（0代表存在 1代表删除）',
|
|
|
|
|
`create_dept` bigint NULL DEFAULT NULL COMMENT '创建部门',
|
|
|
|
|
`create_by` bigint NULL DEFAULT NULL COMMENT '创建人',
|
|
|
|
|
`create_time` datetime NULL DEFAULT NULL COMMENT '创建时间',
|
|
|
|
|
`update_by` bigint NULL DEFAULT NULL COMMENT '更新人',
|
|
|
|
|
`update_time` datetime NULL DEFAULT NULL COMMENT '更新时间',
|
|
|
|
|
PRIMARY KEY (`change_payment_id`) USING BTREE,
|
|
|
|
|
KEY `idx_contract_change_id` (`contract_change_id`) USING BTREE
|
|
|
|
|
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci COMMENT='合同变更付款方式快照' ROW_FORMAT=DYNAMIC;
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
说明：erp_contract_change_info 若与现有 erp_contract_info 字段有新增，需在快照表里同步增加一列，保证回写时能完整覆盖。erp_contract_change_payment_method 与 erp_contract_payment_method 字段保持一致，便于回写时逐字段拷贝。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 四、业务逻辑（通俗描述）
|
|
|
|
|
|
|
|
|
|
### 1. 合同变更列表页（类似合同信息）
|
|
|
|
|
|
|
|
|
|
- **数据来源**：查表 erp_contract_change（可加 del_flag=0、按租户等条件）。
|
|
|
|
|
- **能力**：列表展示变更单号、关联合同、变更状态、申请时间、是否已回写等；支持按合同、状态、时间筛选。
|
|
|
|
|
- **新增**：点「新增」跳转到「合同变更申请」页（不传变更单 id，即新建）。
|
|
|
|
|
|
|
|
|
|
### 2. 合同变更申请页
|
|
|
|
|
|
|
|
|
|
- **选合同**：
|
|
|
|
|
- 下拉/选择器只查「可变更」的合同：`erp_contract_info` 中 `contract_status = '3'` 且 `active_flag = '1'`（已激活）。
|
|
|
|
|
- 若已有合同变更单 id（编辑/查看），则直接带出已选的 contract_id。
|
|
|
|
|
- **带出合同信息**：
|
|
|
|
|
- 选好合同后，后端根据 contract_id 查 erp_contract_info、erp_contract_material、**erp_contract_payment_method**，返回前端。
|
|
|
|
|
- 前端把合同主信息、物料列表、**付款方式列表**展示在表单中，允许编辑。
|
|
|
|
|
- **保存/提交**：
|
|
|
|
|
- **暂存**：插入或更新 erp_contract_change（change_status=1），并插入/更新 erp_contract_change_info 一条、erp_contract_change_material 多条、**erp_contract_change_payment_method 多条**。
|
|
|
|
|
- **提交审批**：同上，但 change_status=2，并走工作流（flow_status 由流程更新）。
|
|
|
|
|
|
|
|
|
|
### 3. 合同变更历史
|
|
|
|
|
|
|
|
|
|
- **入口**：可在合同变更列表页增加「按合同查历史」；或在合同信息详情/列表中提供「变更历史」入口。
|
|
|
|
|
- **查询**：按 contract_id 查 erp_contract_change，按申请时间倒序，得到该合同下全部变更单。
|
|
|
|
|
- **展示**：变更单号、申请时间、变更状态、是否已回写、变更原因等；点某条可进详情，详情从 erp_contract_change_info、erp_contract_change_material、**erp_contract_change_payment_method** 取数据展示（只读即可）。
|
|
|
|
|
|
|
|
|
|
### 4. 变更通过后回写合同表、合同物料表与合同付款方式表
|
|
|
|
|
|
|
|
|
|
- **触发时机**：流程审批通过且 change_status 更新为 '3'（可用）时（可在流程监听/回调里做）。
|
|
|
|
|
- **前置条件**：write_back_flag = '0'，避免重复回写。
|
|
|
|
|
- **回写步骤**：
|
|
|
|
|
1. 用 erp_contract_change 的 contract_id 找到原合同。
|
|
|
|
|
2. **合同主信息**：用 erp_contract_change_info 中该 contract_change_id 的唯一一条记录，按字段更新 erp_contract_info（WHERE contract_id = 原 contract_id）。注意：不更新 contract_id、合同状态等由系统控制的字段，只更新业务可变更字段。
|
|
|
|
|
3. **合同物料**：
|
|
|
|
|
- 删除：DELETE FROM erp_contract_material WHERE contract_id = 原 contract_id；
|
|
|
|
|
- 插入：把 erp_contract_change_material 中该 contract_change_id 下的记录逐条 INSERT 到 erp_contract_material，contract_id 填原 contract_id，其他字段从快照表拷贝。
|
|
|
|
|
4. **合同付款方式**：
|
|
|
|
|
- 删除：DELETE FROM erp_contract_payment_method WHERE contract_id = 原 contract_id；
|
|
|
|
|
- 插入：把 erp_contract_change_payment_method 中该 contract_change_id 下的记录逐条 INSERT 到 erp_contract_payment_method，contract_id 填原 contract_id，其他字段从快照表拷贝。
|
|
|
|
|
5. 更新 erp_contract_change：write_back_flag='1', write_back_time=当前时间。
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
## 五、小结
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 项目 | 说明 |
|
|
|
|
|
| ----- | ------------------------------------------------------------------------------------------------------------------------ |
|
|
|
|
|
| 可变更范围 | 仅合同状态=可用 且 激活标识=是 的合同 |
|
|
|
|
|
| 列表与申请 | 列表查 erp_contract_change；申请页选合同后查 erp_contract_info + erp_contract_material + erp_contract_payment_method 带出并编辑，保存到变更主表+三张快照表 |
|
|
|
|
|
| 历史 | 按 contract_id 查 erp_contract_change，详情用 change_info、change_material、change_payment_method |
|
|
|
|
|
| 回写 | 审批通过后，用 change_info 更新 contract_info，用 change_material 全量替换该 contract_id 下物料，用 change_payment_method 全量替换该 contract_id 下付款方式，并标记已回写 |
|
|
|
|
|
|
|
|
|
|
按上述表结构与逻辑实现即可满足「只有合同激活后可变更、可查变更历史、变更后内容回写合同表、合同物料表与合同付款方式表」的需求。
|
yinq
2 days ago