【合同】合同管理、合同提醒

合同模块，由 yudao-module-crm 后端模块的 contract 包实现，已经和 BPM 工作流 打通审批。

# 1. 合同

合同，由 yudao-module-crm 后端模块的 business 包的 CrmContractController 实现。表关系如下：

# 1. 表结构

【合同表】省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 CREATE TABLE crm_contract ( id bigint NOT NULL AUTO_INCREMENT COMMENT '编号，主键自增', name varchar(128) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '合同名称', no varchar(128) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '合同编号', customer_id bigint NOT NULL COMMENT '客户编号', business_id bigint DEFAULT NULL COMMENT '商机编号', contact_last_time datetime DEFAULT NULL COMMENT '最后跟进时间', owner_user_id bigint DEFAULT NULL COMMENT '负责人的用户编号', process_instance_id varchar(64) COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '工作流编号', audit_status tinyint NOT NULL DEFAULT '0' COMMENT '审批状态', total_product_price decimal(24,6) DEFAULT NULL COMMENT '产品总金额', discount_percent decimal(24,6) DEFAULT NULL COMMENT '整单折扣', total_price decimal(10,2) DEFAULT NULL COMMENT '合同总金额', order_date datetime DEFAULT NULL COMMENT '下单日期', start_time datetime DEFAULT NULL COMMENT '开始时间', end_time datetime DEFAULT NULL COMMENT '结束时间', sign_contact_id bigint DEFAULT NULL COMMENT '联系人编号', sign_user_id bigint DEFAULT NULL COMMENT '公司签约人', PRIMARY KEY (id) USING BTREE ) ENGINE=InnoDB AUTO_INCREMENT=8 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='CRM 合同表'; ① no 字段：合同编号，系统自动生成的，目前格式是 {prefix}{yyyyMMdd}{6 位自增}。具体可见 ErpNoRedisDAO 类。 ② customer_id 字段：客户编号，对应 crm_customer 表的 id 字段，必填。 ③ business_id 字段：商机编号，对应 crm_business 表的 id 字段，选填。在选择商机时，会自动带出商机的 crm_business_product 表的产品信息，稍后会看到 ④ contact_last_time 字段：跟进相关，和线索类似。不重复赘述，详细可见 《【通用】跟进记录》 文档。 ⑤ owner_user_id 字段：合同的负责人编号，和线索类似。不重复赘述，详细可见 《【通用】数据权限》 文档。 ⑥ process_instance_id 字段：工作流编号，用于和 BPM 工作流 打通审批。提交审批后，会自动创建一个工作流实例，并记录到该字段。 audit_status 字段：审批结果，目前由 CrmAuditStatusEnum 枚举，目前有 5 个状态：未提交、审批中、审批通过、审批不通过、已取消。 ⑤ total_product_price、discount_percent、total_price 字段：合同的金额相关，关系是 total_price = total_product_price * discount_percent。 其中，total_product_price 字段是 crm_contract_product 表的 total_price * count 的累加。 ⑥ 从 order_date 到 sign_user_id 字段：合同的信息字段，比较简单，不重复赘述。 【合同产品表】省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 CREATE TABLE crm_contract_product ( id bigint NOT NULL AUTO_INCREMENT COMMENT '主键', contract_id bigint NOT NULL COMMENT '合同编号', product_id bigint NOT NULL COMMENT '产品编号', product_price decimal(24,6) NOT NULL COMMENT '产品单价', contract_price decimal(24,6) NOT NULL COMMENT '合同价格', count decimal(24,6) NOT NULL COMMENT '数量', total_price decimal(24,6) NOT NULL COMMENT '总计价格', PRIMARY KEY (id) USING BTREE ) ENGINE=InnoDB AUTO_INCREMENT=39 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC COMMENT='CRM 合同产品关联表'; 友情提示：整体和商机产品表 crm_business_product 类似。因为本身商机进一步转化后，就是合同。 ① contract_id 字段：合同编号，对应 crm_contract 表的 id 字段。 product_id 字段：产品编号，对应 crm_product 表的 id 字段。 ② product_price 字段：产品单价，冗余，来自 crm_product 表的 price 字段。目的是，和 contract_price 字段比较，看看是否有折扣。 count、total_price 字段：数量、总计价格。

# 2. 管理后台

对应 [CRM 系统 -> 合同管理] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/crm/contract 目录。 ① 点击【新增】按钮，随便填写一些信息，点击「确认」按钮，即可新增一条合同。如下图所示： ② 点击【提交审批】按钮，可以提交审批。如下图所示： 友情提示： 合同对应的审批流程，需要自己在 [工作流程 -> 流程管理 -> 流程模型] 菜单，配置一个流程标识为 crm-contract-audit 的流程模型。如下图所示： 如果不了解怎么配置的同学，可以学习下 《BPM 工作流》 的文档。 提交完成后，会自动创建一个工作流实例，并记录到 process_instance_id 字段。之后可点击【查看审批】按钮，查看审批详情。如下图所示： 点击审批【通过】按钮，将合同审批通过，此时它会回调 CrmContractResultListener 监听器，更新合同的 audit_status 字段为审批通过。如下图所示： ③ 点击“合同名称”，进入合同详情页，可以查看合同的详细信息，如下图所示：

# 2. 合同配置

客户公海配置，由 yudao-module-crm 后端模块的 contract 包的 CrmContractConfigController 实现。

# 2.1 表结构

省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段 CREATE TABLE crm_contract_config ( id bigint NOT NULL AUTO_INCREMENT COMMENT '编号', notify_enabled tinyint(1) DEFAULT NULL COMMENT '是否开启提前提醒', notify_days int DEFAULT NULL COMMENT '提前提醒天数', PRIMARY KEY (id) USING BTREE ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='CRM 合同配置表'; 目前主要是合同提醒功能。 notify_enabled 字段：是否开启提前提醒。如果开启，合同的结束时间 end_time 超过今天，并且小于 notify_days 天的，可以在 [CRM 系统 -> 待办事项] 菜单中，看到提醒。如下图所示：

# 2.2 管理后台

对应 [CRM 系统 -> 系统配置 -> 合同配置] 菜单，对应 yudao-ui-admin-vue3 项目的 @/views/contract/config 目录。

# 666. 社区贡献相关

• 《Pull Request：编码规则配置，根据配置的规则生成业务单据编号》 .pageB img{width:80px!important;} .wwads-horizontal .wwads-text, .wwads-content .wwads-text{line-height:1;} 【商机】商机管理、商机状态 【回款】回款管理、回款计划 ← 【商机】商机管理、商机状态 【回款】回款管理、回款计划→ Theme by Vdoing | Copyright © 2019-2026 芋道源码 | MIT License
• 跟随系统
• 浅色模式
• 深色模式
• 阅读模式 × .windowRB{ padding: 0;} .windowRB .wwads-img{margin-top: 10px;} .windowRB .wwads-content{margin: 0 10px 10px 10px;} .custom-html-window-rb .close-but{ display: none; }