# 【合同】合同信息、模板
合同模块,由 xcmd-module-asset 后端模块的 contract 包实现,主要有合同列表、合同模板等功能。如下图所示:

# 合同列表
合同列表,由 AppContractController 提供接口。
# 1.表结构
省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段
CREATE TABLE `contract` (
`id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
`org_id` bigint DEFAULT '0' COMMENT '机构ID',
`park_id` bigint DEFAULT NULL COMMENT '园区id',
`build_id` bigint DEFAULT '0' COMMENT '楼宇id(建筑id)',
`owner_id` bigint DEFAULT '0' COMMENT '租客id',
`industry` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '行业id',
`status` char(2) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '合同状态0=新建1=正常执行中2=变更待审核3=变更待修改4=退租待审批5=退租待执行6=已退租7=作废待审批8=作废待修改9=到期未处理10=已驳回11=已作废12=已撤回13=待执行14=续租待审批15=已到期 16=新建待审核',
`legal_person` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '法人姓名',
`signed_name` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '签订人姓名',
`followup_uid` bigint NOT NULL DEFAULT '0' COMMENT '跟进人uid',
`template_id` bigint DEFAULT '0' COMMENT '合同打印模板id',
`contract_number` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '合同编号',
`operator_id` bigint DEFAULT NULL COMMENT '经办人id',
`signing_date` datetime DEFAULT NULL COMMENT '签订日期',
`unit_price_point` int DEFAULT NULL COMMENT '单价保留小数点几位',
`calculation_accuracy` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '计算精度0=精确计算结果保留两位1=每步计算保留两位',
`calculation_order` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '计算顺序0=单价*面积*时间1=单价*时间*面积',
`is_receivable_integer` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '应收整数是否四舍五入0=否1=是',
`starting_late_fee_day` int DEFAULT NULL COMMENT '滞纳金起算天数',
`late_fee_ratio` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '滞纳金比例%',
`upper_limit_late_fee` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '滞纳金上限%',
`build_name` varchar(100) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '楼宇名称',
`room_number` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '房号id,多个用英文逗号拼接;例:101,103',
`lease_square` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '租赁数(单位㎡/个)',
`contract_start_time` date DEFAULT NULL COMMENT '合同开始时间',
`contract_end_time` date DEFAULT NULL COMMENT '合同结束时间',
`lease_retreat_time` date DEFAULT NULL COMMENT '退租时间',
`followup_uname` varchar(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '跟进人名称',
`lease_unit_price` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '租赁条款单价(取第一个条款)',
`property_unit_price` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '物业条款单价(取第一个条款)',
`lease_unit_realprice` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '租赁条款实时单价;若存在实时变更,可关联查询楼宇实时单价',
`property_unit_realprice` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '物业条款实时单价;若存在实时变更,可关联查询楼宇实时单价',
`lease_price` decimal(19,2) DEFAULT NULL COMMENT '总计租金;保留两位小数',
`total_margin` decimal(19,2) DEFAULT NULL COMMENT '总保证金',
`scene` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '合同类型/合同应用场景;普通租赁合同(normal)/退租合同(retreat)/物业合同(property)等等 多个用英文逗号连接',
`clause` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '条款类型;普通租赁条款(normal)/退租条款(retreat)/物业条款(property)等等 多个用英文逗号连接',
`is_whether_lease` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '是否续租0=否1=是',
`pdf_file_url` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '生成的pdf合同路径',
`lease_area` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '租赁面积',
`data_source` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '合同来源0=新建1=导入',
`checked_build` json DEFAULT NULL COMMENT '已选中楼宇资源',
`is_bill_overdue` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '账单明细是否存在预期0=否1=是',
`renewal_contract_id` bigint DEFAULT NULL COMMENT '续租合同Id',
`account_id` bigint DEFAULT NULL COMMENT '收款账户',
`type` int DEFAULT NULL COMMENT '合同类型 0-普通合同 1-成本合同',
`landlord_id` bigint DEFAULT NULL COMMENT '业主id',
`org_branch_id` bigint DEFAULT '0' COMMENT '所属公司',
`is_branch_account` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT '0' COMMENT '是否指定分公司账户支付,0否 1是',
`discount_amount` decimal(10,2) DEFAULT NULL COMMENT '优惠金额',
`discount_type` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '优惠类型',
`purpose_receive` decimal(10,2) DEFAULT NULL COMMENT '意向金应付金额',
`purpose_pay_date` date DEFAULT NULL COMMENT '意向金应付时间',
`purpose_unlock_date` date DEFAULT NULL COMMENT '意向合同房屋锁定时间',
`purpose_pay_method` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '意向金支付方式',
`purpose_is_return` bit(1) DEFAULT NULL COMMENT '意向金是否可退',
`purpose_rent_detail` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '意向金租金明细',
`purpose_is_timeout` bit(1) DEFAULT NULL COMMENT '意向合同是否逾期',
`formal_status` int DEFAULT '0' COMMENT '转正状态 0-未转正 1-审批中 2-已转正',
`purpose_contract_id` bigint DEFAULT NULL COMMENT '意向合同id',
`create_template_id` bigint DEFAULT NULL COMMENT '合同创建模板id',
PRIMARY KEY (`id`) USING BTREE,
KEY `idx_org_id` (`org_id`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=259 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC COMMENT='机构合同表';
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# 2.管理后台
对应 [资产管理系统 -> 合同 -> 合同列表] 菜单,对应 xhrt-admin 项目的 @/views/contract/contractList 目录。

# 合同模板
合同模板,由 ContractTemplateController 提供接口。
# 1.表结构
省略 creator/create_time/updater/update_time/deleted/tenant_id 等通用字段
CREATE TABLE `contract_template` (
`id` bigint unsigned NOT NULL AUTO_INCREMENT COMMENT '编号',
`org_id` bigint DEFAULT '0' COMMENT '机构ID',
`watermark_id` bigint DEFAULT NULL COMMENT '水印模板id',
`scene` varchar(30) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '应用场景;普通合同(normal)/退租合同(retreat)等等',
`template_name` varchar(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL COMMENT '模板名称',
`template_path` varchar(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci DEFAULT NULL COMMENT '模板文件',
`basic_clause` json DEFAULT NULL COMMENT '模板主条款信息',
`number_rule` json DEFAULT NULL COMMENT '模板合同编号规则',
`latefee_clause` json DEFAULT NULL COMMENT '滞纳金条款',
`multiple_clause` json DEFAULT NULL COMMENT '综合条款',
`relation_builds` text CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci COMMENT '楼宇id,多个id使用逗号隔开',
`table_fields` json DEFAULT NULL COMMENT '模板变量自定义表头集合',
`date_flag` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '0' COMMENT '永久标识;1=永久',
`timeout_time` datetime DEFAULT NULL COMMENT '过期时间',
`status` char(1) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL DEFAULT '1' COMMENT '模板使用状态;1=启用;0=关闭',
`availability` json DEFAULT NULL COMMENT '房源信息',
PRIMARY KEY (`id`) USING BTREE,
KEY `idx_org_id` (`org_id`) USING BTREE,
KEY `idx_watermark_id` (`watermark_id`) USING BTREE,
KEY `idx_scene` (`scene`) USING BTREE,
KEY `idx_template_name` (`template_name`) USING BTREE,
KEY `idx_date_flag` (`date_flag`) USING BTREE,
KEY `idx_timeout_time` (`timeout_time`) USING BTREE,
KEY `idx_status` (`status`) USING BTREE,
KEY `idx_oss_updated_at` (`org_id`,`scene`,`status`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=712 DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci ROW_FORMAT=DYNAMIC COMMENT='机构合同模板配置表';
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
# 2.管理后台
对应 [资产管理系统 -> 合同 -> 合同设置 -> 合同创建模板] 菜单,对应 xhrt-admin 项目的 @/views/contract/setting/templateContractList 目录
