优化回款功能

2026-09-13 14:09:34 +08:00
parent aea53e0766
commit 2f6cdbb3cd
13 changed files with 855 additions and 668 deletions
@@ -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"
+}