新增合同管理相关功能

go/models/init.go

@@ -81,6 +81,7 @@ func Init(_ string) {
 		new(TenantCrmAttach),
 		new(TenantCrmEntityContact),
 		new(TenantCrmOperateLog),
+		new(TenantCrmContract),
 		new(ErpAccountSet),
 		new(ErpNormalSetting),
 		new(ErpCompanyContact),
@@ -142,6 +143,63 @@ func Init(_ string) {
 	EnsureCrmCustomerPoolColumns()
 	EnsureCrmCreateUserColumn()
 	EnsureCrmProjectDocColumn()
+	EnsureCrmContractTable()
+	EnsureCrmContractOurRoleColumn()
+}
+
+// EnsureCrmContractOurRoleColumn 补齐合同表的我方角色字段（存量表已建时新增；
+// 旧版「合同性质 contract_nature」字段弃用但保留不动，表不存在或列已存在时忽略错误）。
+func EnsureCrmContractOurRoleColumn() {
+	sql := "ALTER TABLE " + new(TenantCrmContract).TableName() +
+		" ADD COLUMN our_role tinyint NOT NULL DEFAULT 2 COMMENT '我方角色：1甲方/2乙方/3丙方/4丁方'"
+	_, _ = Orm.Raw(sql).Exec()
+}
+
+// EnsureCrmContractTable 合同表建表（CREATE TABLE IF NOT EXISTS，可重复执行；
+// 建表失败（如表已存在但结构不一致）时静默忽略，可用 sql/yz_backend_crm_contract.sql 手动修复）。
+func EnsureCrmContractTable() {
+	sql := `CREATE TABLE IF NOT EXISTS yz_backend_crm_contract (
+  id bigint(20) NOT NULL AUTO_INCREMENT COMMENT '自增主键ID',
+  tenant_id varchar(64) NOT NULL COMMENT '租户ID',
+  contract_no varchar(50) NOT NULL DEFAULT '' COMMENT '合同编号',
+  contract_name varchar(100) NOT NULL COMMENT '合同名称',
+  contract_category varchar(20) NOT NULL DEFAULT '' COMMENT '合同分类：1开发/2服务/3销售/4租赁/5采购/6运维/7咨询/8其他',
+  our_role tinyint(4) NOT NULL DEFAULT '2' COMMENT '我方角色：1甲方/2乙方/3丙方/4丁方',
+  party_count tinyint(4) NOT NULL DEFAULT '2' COMMENT '合同形式：2/3/4方',
+  project_id bigint(20) DEFAULT NULL COMMENT '关联项目ID，空=无头合同',
+  project_name varchar(100) NOT NULL DEFAULT '' COMMENT '项目名称',
+  owner_user_id varchar(64) NOT NULL DEFAULT '' COMMENT '项目负责人用户ID',
+  owner_user_name varchar(128) NOT NULL DEFAULT '' COMMENT '项目负责人姓名',
+  sign_date date DEFAULT NULL COMMENT '签订日期',
+  effective_date date DEFAULT NULL COMMENT '生效日期',
+  expire_date date DEFAULT NULL COMMENT '结束日期',
+  parties text COMMENT '各方签约主体JSON',
+  products text COMMENT '产品清单JSON',
+  hardware_amount decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '硬件部分金额',
+  software_amount decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '软件部分金额',
+  other_amount decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '其他部分金额',
+  total_amount decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '合同总金额',
+  total_cost decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '产品总成本',
+  total_profit decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '合同总利润',
+  status tinyint(4) NOT NULL DEFAULT '1' COMMENT '状态：1草稿/2已完成/3已作废/4履约中/5执行异常',
+  step tinyint(4) NOT NULL DEFAULT '1' COMMENT '进度步骤：1合同信息/2产品清单',
+  remark text COMMENT '备注',
+  create_user_id varchar(64) NOT NULL DEFAULT '' COMMENT '创建人用户ID',
+  create_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
+  update_time datetime NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
+  delete_time datetime DEFAULT NULL COMMENT '删除时间（软删除）',
+  PRIMARY KEY (id),
+  KEY idx_tenant_id (tenant_id),
+  KEY idx_contract_name (tenant_id,contract_name),
+  KEY idx_contract_no (tenant_id,contract_no),
+  KEY idx_project (tenant_id,project_id),
+  KEY idx_status (tenant_id,status),
+  KEY idx_delete_time (delete_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='租户CRM合同表'`
+	if _, err := Orm.Raw(sql).Exec(); err != nil {
+		// 表已存在或执行失败时忽略（完整表结构见 sql/yz_backend_crm_contract.sql）
+		return
+	}
 }
 
 // EnsureCrmProjectDocColumn 补齐项目表的文档库文件夹分类字段（项目文档绑定 OA 文档库）。