优化回款功能

go/models/init.go

@@ -85,6 +85,7 @@ func Init(_ string) {
 		new(TenantCrmOperateLog),
 		new(TenantCrmContract),
 		new(TenantCrmPayback),
+		new(TenantCrmPaybackRecord),
 		new(ErpAccountSet),
 		new(ErpNormalSetting),
 		new(ErpCompanyContact),
@@ -151,6 +152,7 @@ func Init(_ string) {
 	EnsureCrmContractTechDateColumn()
 	EnsureCrmProjectProductsColumn()
 	EnsureCrmPaybackTable()
+	EnsureCrmPaybackRecordTable()
 	EnsureCrmProductDevColumns()
 }
 
@@ -193,6 +195,37 @@ func EnsureCrmPaybackTable() {
 	}
 }
 
+// EnsureCrmPaybackRecordTable 回款记录表建表（CREATE TABLE IF NOT EXISTS，可重复执行）。
+// 回款记录 = 回款进度流水：每次「新建回款」追加一条，以回款计划（payback_id）为先导条件。
+func EnsureCrmPaybackRecordTable() {
+	sql := `CREATE TABLE IF NOT EXISTS yz_backend_crm_payback_record (
+  id bigint(20) NOT NULL AUTO_INCREMENT COMMENT '自增主键ID',
+  tenant_id varchar(64) NOT NULL COMMENT '租户ID',
+  contract_id bigint(20) DEFAULT NULL COMMENT '关联合同ID（yz_backend_crm_contract.id）',
+  payback_id bigint(20) NOT NULL DEFAULT '0' COMMENT '关联回款计划ID（yz_backend_crm_payback.id）',
+  amount decimal(14,2) NOT NULL DEFAULT '0.00' COMMENT '本次回款金额',
+  received_date varchar(20) NOT NULL DEFAULT '' COMMENT '回款日期 YYYY-MM-DD',
+  pay_method tinyint(4) NOT NULL DEFAULT '1' COMMENT '回款方式：1对公/2网银/3现金/4支票/5支付宝/6微信/7其他',
+  receipt_url varchar(512) DEFAULT NULL COMMENT '流水回执文件地址',
+  receipt_name varchar(255) DEFAULT NULL COMMENT '流水回执文件名',
+  remark text COMMENT '备注',
+  owner_user_id varchar(64) NOT NULL DEFAULT '' COMMENT '负责人用户ID',
+  owner_user_name varchar(128) NOT NULL DEFAULT '' 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_contract (tenant_id,contract_id),
+  KEY idx_payback (tenant_id,payback_id),
+  KEY idx_delete_time (delete_time)
+) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='租户CRM回款记录表（回款进度流水）'`
+	if _, err := Orm.Raw(sql).Exec(); err != nil {
+		// 表已存在或执行失败时忽略
+		return
+	}
+}
+
 // EnsureCrmContractOurRoleColumn 补齐合同表的我方角色字段（存量表已建时新增；
 // 旧版「合同性质 contract_nature」字段弃用但保留不动，表不存在或列已存在时忽略错误）。
 func EnsureCrmContractOurRoleColumn() {

go/models/tenant_crm_payback_record.go

@@ -0,0 +1,34 @@
+package models
+
+import "time"
+
+// TenantCrmPaybackRecord 回款记录（回款进度流水）: yz_backend_crm_payback_record
+//
+// 说明：
+//   - 以「回款计划」为先导：payback_id 关联 yz_backend_crm_payback.id；
+//     contract_id 冗余存储，便于按合同直接查询进度列表；
+//   - 每次「新建回款」追加一条记录，构成回款进度（一笔笔实际到账），
+//     与计划内的 items（计划分期）区分开：前者是实际发生，后者是计划安排；
+//   - 计划表 received_amount 由本表记录金额汇总回写（refreshPlanReceived）。
+type TenantCrmPaybackRecord struct {
+	ID            uint64     `orm:"column(id);pk;auto" json:"id"`
+	TenantID      string     `orm:"column(tenant_id);size(64)" json:"tenant_id"`
+	ContractID    *uint64    `orm:"column(contract_id);null" json:"contract_id"` // 关联合同ID
+	PaybackID     uint64     `orm:"column(payback_id)" json:"payback_id"`         // 关联回款计划ID
+	Amount        float64    `orm:"column(amount);digits(14);decimals(2);default(0)" json:"amount"` // 本次回款金额
+	ReceivedDate  string     `orm:"column(received_date);size(20)" json:"received_date"`            // 回款日期 YYYY-MM-DD
+	PayMethod     int8       `orm:"column(pay_method);default(1)" json:"pay_method"`                // 回款方式：1对公/2网银/3现金/4支票/5支付宝/6微信/7其他
+	ReceiptURL    string     `orm:"column(receipt_url);size(512);null" json:"receipt_url"`          // 流水回执文件地址
+	ReceiptName   string     `orm:"column(receipt_name);size(255);null" json:"receipt_name"`        // 流水回执文件名
+	Remark        string     `orm:"column(remark);type(text);null" json:"remark"`                   // 备注
+	OwnerUserID   string     `orm:"column(owner_user_id);size(64)" json:"owner_user_id"`
+	OwnerUserName string     `orm:"column(owner_user_name);size(128)" json:"owner_user_name"`
+	CreateUserID  string     `orm:"column(create_user_id);size(64)" json:"create_user_id"`
+	CreateTime    time.Time  `orm:"column(create_time);auto_now_add;type(datetime)" json:"create_time"`
+	UpdateTime    time.Time  `orm:"column(update_time);auto_now;type(datetime)" json:"update_time"`
+	DeleteTime    *time.Time `orm:"column(delete_time);type(datetime);null" json:"delete_time"`
+}
+
+func (m *TenantCrmPaybackRecord) TableName() string {
+	return "yz_backend_crm_payback_record"
+}