yunzerwebsiteallinone/go/services/payback_overdue_scheduler.go

package services

import (
	"encoding/json"
	"strings"
	"time"

	"server/models"
)

// ============================== 回款逾期联动 ==============================
// 规则：回款计划存在「未收齐且已过计划回款日期」的明细（即逾期）时，
//   - 对应合同状态置为「异常」(5)；已作废(3)合同不标记，已是异常(5)时幂等跳过；
//   - 合同关联的项目状态联动置为「异常」(5)；已是异常(5)时幂等跳过。
//
// 已收齐判定与「新建回款」机制一致：
//   - 回款记录按 item_seq 汇总（当前机制）；
//   - 明细行内 received_amount（历史「进度登记」机制）。
//
// 说明：回款补齐后不自动恢复状态（无法区分「逾期导致的异常」与人工标注），
// 需要恢复时在「状态流转」中手动调整即可。

// paybackSchedulerItem 回款计划明细（items JSON 元素，仅取判定所需字段）。
type paybackSchedulerItem struct {
	Seq            int     `json:"seq"`
	Amount         float64 `json:"amount"`
	PlanDate       string  `json:"plan_date"`
	ReceivedAmount float64 `json:"received_amount"` // 历史「进度登记」机制写入的已回款
}

// StartPaybackOverdueScheduler 启动回款逾期联动调度器：
// 启动 30 秒后执行首次扫描（尽快让历史逾期数据生效），此后每 10 分钟扫描一次。
func StartPaybackOverdueScheduler(stopChan chan struct{}) {
	go func() {
		select {
		case <-time.After(30 * time.Second):
			syncPaybackOverdueStatuses()
		case <-stopChan:
			return
		}
		ticker := time.NewTicker(10 * time.Minute)
		defer ticker.Stop()
		for {
			select {
			case <-ticker.C:
				syncPaybackOverdueStatuses()
			case <-stopChan:
				return
			}
		}
	}()
}

// syncPaybackOverdueStatuses 扫描全部未收齐的回款计划并执行逾期联动，返回 (合同更新数, 项目更新数)。
func syncPaybackOverdueStatuses() (int, int) {
	if models.Orm == nil {
		return 0, 0
	}
	today := time.Now().Format("2006-01-02")
	// 未收齐的计划（status=2 已完成跳过；items 为空时无逾期概念）
	var plans []models.TenantCrmPayback
	if _, err := models.Orm.QueryTable(new(models.TenantCrmPayback)).
		Filter("delete_time__isnull", true).
		Filter("status__ne", 2).
		All(&plans, "id", "tenant_id", "contract_id", "items"); err != nil {
		return 0, 0
	}
	contractUpdated, projectUpdated := 0, 0
	now := time.Now()
	handledContracts := make(map[uint64]bool) // 同一合同只处理一次
	for _, plan := range plans {
		if plan.ContractID == nil || *plan.ContractID == 0 {
			continue
		}
		contractID := *plan.ContractID
		if handledContracts[contractID] {
			continue
		}
		if !paybackPlanOverdueFor(plan, today) {
			continue
		}
		handledContracts[contractID] = true
		cu, pu := applyContractOverdue(plan.TenantID, contractID, now)
		contractUpdated += cu
		projectUpdated += pu
	}
	return contractUpdated, projectUpdated
}

// SyncPaybackOverdueForContract 立即检查指定合同的回款逾期联动
// （供回款计划 / 回款记录变更后调用，让状态即时生效，无需等待定时扫描）。
func SyncPaybackOverdueForContract(tenantID string, contractID uint64) {
	if models.Orm == nil || contractID == 0 {
		return
	}
	today := time.Now().Format("2006-01-02")
	var plans []models.TenantCrmPayback
	if _, err := models.Orm.QueryTable(new(models.TenantCrmPayback)).
		Filter("tenant_id", tenantID).
		Filter("contract_id", contractID).
		Filter("delete_time__isnull", true).
		Filter("status__ne", 2).
		All(&plans, "id", "tenant_id", "contract_id", "items"); err != nil {
		return
	}
	for _, plan := range plans {
		if paybackPlanOverdueFor(plan, today) {
			applyContractOverdue(tenantID, contractID, time.Now())
			return
		}
	}
}

// paybackPlanOverdueFor 计划是否逾期：存在「未收齐」明细且计划回款日期已过。
func paybackPlanOverdueFor(plan models.TenantCrmPayback, today string) bool {
	items := make([]paybackSchedulerItem, 0)
	if raw := strings.TrimSpace(plan.Items); raw != "" {
		if err := json.Unmarshal([]byte(raw), &items); err != nil {
			return false
		}
	}
	if len(items) == 0 {
		return false
	}
	// 回款记录按明细序号汇总（item_seq=0 视为整单登记，不计入任何明细）
	receivedBySeq := make(map[int]float64)
	var recs []models.TenantCrmPaybackRecord
	_, _ = models.Orm.QueryTable(new(models.TenantCrmPaybackRecord)).
		Filter("payback_id", plan.ID).
		Filter("delete_time__isnull", true).
		All(&recs, "item_seq", "amount")
	for _, r := range recs {
		if r.ItemSeq > 0 {
			receivedBySeq[r.ItemSeq] += r.Amount
		}
	}
	for _, it := range items {
		received := receivedBySeq[it.Seq]
		if it.ReceivedAmount > received {
			received = it.ReceivedAmount
		}
		if it.Amount > 0 && received >= it.Amount {
			continue // 已收齐
		}
		planDate := strings.TrimSpace(it.PlanDate)
		if len(planDate) > 10 {
			planDate = planDate[:10]
		}
		if planDate != "" && planDate < today {
			return true
		}
	}
	return false
}

// applyContractOverdue 合同置「异常」(5)，并联动项目置「异常」(5)。
// 返回 (合同是否更新, 项目是否更新)。
func applyContractOverdue(tenantID string, contractID uint64, now time.Time) (int, int) {
	var contract models.TenantCrmContract
	if err := models.Orm.QueryTable(new(models.TenantCrmContract)).
		Filter("id", contractID).Filter("tenant_id", tenantID).
		Filter("delete_time__isnull", true).One(&contract); err != nil {
		return 0, 0
	}
	// 已作废合同不参与逾期提醒
	if contract.Status == 3 {
		return 0, 0
	}
	contractUpdated := 0
	if contract.Status != 5 {
		if _, err := models.Orm.QueryTable(new(models.TenantCrmContract)).
			Filter("id", contractID).Filter("tenant_id", tenantID).
			Update(map[string]interface{}{"status": int8(5), "update_time": now}); err != nil {
			return 0, 0
		}
		contractUpdated = 1
	}
	// 合同关联项目联动置异常
	projectUpdated := 0
	if contract.ProjectID != nil && *contract.ProjectID > 0 {
		var proj models.TenantCrmProject
		if err := models.Orm.QueryTable(new(models.TenantCrmProject)).
			Filter("id", *contract.ProjectID).Filter("tenant_id", tenantID).
			Filter("delete_time__isnull", true).One(&proj); err == nil && proj.Status != 5 {
			if _, err := models.Orm.QueryTable(new(models.TenantCrmProject)).
				Filter("id", proj.ID).Filter("tenant_id", tenantID).
				Update(map[string]interface{}{"status": int8(5), "update_time": now}); err == nil {
				projectUpdated = 1
			}
		}
	}
	return contractUpdated, projectUpdated
}