改成只由脚本来合并余额和欠款

biz-ghs/custom/classes/AccountMoneyClass.php

@@ -15,7 +15,9 @@ use Yii;
  * 合并（客户/批发关系行）：balance = 原 balance - 原 debtAmount，debtAmount 置 0，balanceMerged=1。
  * 合并（ghsApp 采购供货商行，ownPtStyle=ghs/kmGhs）：按待结采购单 actPrice 合计重算净 balance，debtAmount 置 0。
  * 合并（hd 花店侧供货商行，ownPtStyle=hd）：balance -= debtAmount 旧逻辑（mergeGhsDebtIntoBalanceIfNeeded）；二者不可混用。
- * 写业务前调 ensureCustomMoneyReady / ensureGhsMoneyReady；列表/详情返回前调 formatMoneyForClient。
+ * 写业务前调 ensureCustomMoneyReady / ensureGhsMoneyReady（仅行锁，不触发合并）。
+ * 批量合并仅由控制台脚本调用 mergeCustomMoneyForScript / mergeGhsMoneyForScript 等。
+ * 列表/详情返回前调 formatMoneyForClient。
  * 旧 App（appVersion<3）由 formatMoneyForClient 拆回待结+余额双字段；新 App 只读净 balance。
  *
  * 充值销账（合并后来款 FIFO 销单）：bizGhs\custom\services\GhsRechargeSettleService
@@ -195,7 +197,7 @@ class AccountMoneyClass
 
     /**
      * 【用途】对 xhGhs（花店↔供货商关系行）执行与上相同的挂账并入余额。
-     * 【调用时机】ensureCustomMoneyReady 会顺带处理 custom.ghsId；hd 采购-only 场景用 ensureGhsMoneyReady。
+     * 【调用时机】mergeCustomMoneyForScript 会顺带处理 custom.ghsId；脚本侧 mergeGhsMoneyForScript 处理仅 ghs 行。
      * 【说明】充值等场景要求 custom 与 ghs 两边净额一致，故成对合并。
      */
     public static function mergeGhsDebtIntoBalanceIfNeeded($ghs, $writeBalanceChange = true)
@@ -317,13 +319,26 @@ class AccountMoneyClass
     }
 
     /**
-     * 【用途】客户侧金额业务的前置入口（最重要，绝大多数写操作应先调此方法）。
-     * 【做什么】行锁客户 → 未合并则合并客户 → 再合并其 ghsId 对应 xhGhs 行。
-     * 【调用时机】开单挂账、结账、退款、充值、余额消费结账、清分改客户金额等。
-     * 【参数】$writeMergeChange false 可关闭合并说明流水（极少用）；默认 true
-     * 【返回值】已合并、可安全读写 balance 的客户 AR
+     * 【用途】客户侧金额写操作前置：仅对客户行加锁，不执行挂账并入余额。
+     * 【调用时机】开单、结账、退款、充值等写 balance 前。
      */
     public static function ensureCustomMoneyReady($custom, $writeMergeChange = true)
+    {
+        if (empty($custom)) {
+            return $custom;
+        }
+        $customId = is_array($custom) ? ($custom['id'] ?? 0) : ($custom->id ?? 0);
+        if (!is_object($custom) || !self::isMerged($custom)) {
+            $custom = CustomClass::getLockById($customId);
+        }
+        return $custom;
+    }
+
+    /**
+     * 【用途】控制台批量合并：客户行 + 其 ghsId 关系行一次性并入净 balance。
+     * 【调用时机】仅 php yii balance-merge/run 等脚本，禁止在 HTTP 业务里调用。
+     */
+    public static function mergeCustomMoneyForScript($custom, $writeMergeChange = true)
     {
         if (empty($custom)) {
             return $custom;
@@ -374,8 +389,8 @@ class AccountMoneyClass
     }
 
     /**
-     * 【用途】仅处理 xhGhs 关系行（无 custom 对象时），逻辑同 ensureCustomMoneyReady 的 ghs 部分。
-     * 【调用时机】hd 采购挂账/结账/退款、ghs 采购单改供货商金额、CgRefund 等只拿到 $ghs 的场景。
+     * 【用途】供货商关系行写操作前置：仅加行锁，不执行挂账并入余额。
+     * 【调用时机】hd 采购挂账/结账/退款、ghs 采购改金额等写 balance 前。
      */
     public static function ensureGhsMoneyReady($ghs, $writeMergeChange = true)
     {
@@ -386,30 +401,29 @@ class AccountMoneyClass
         if (!is_object($ghs) || !self::isMerged($ghs)) {
             $ghs = BizGhsClass::getLockById($ghsId);
         }
-        if (empty($ghs)) {
-            return $ghs;
-        }
-        if (!self::isMerged($ghs) && self::isGhsAppPurchaseSupplierRow($ghs)) {
-            return self::mergeOwnShopGhsBalanceFromPurchaseOrdersIfNeeded($ghs, $writeMergeChange);
-        }
-        return self::mergeGhsDebtIntoBalanceIfNeeded($ghs, $writeMergeChange);
+        return $ghs;
     }
 
     /**
-     * 【用途】客户列表分页时，对「仍有 debtAmount 未合并」的单户触发懒合并（读路径补刀）。
-     * 【调用时机】CustomClass::groupBaseInfo 循环里发现 debtAmount>0 且 balanceMerged=0。
-     * 【说明】避免客户长期无交易一直显示旧双字段；合并后会刷新该行再 formatMoneyForClient。
-     * 【参数】$customId 客户主键
+     * 【用途】控制台批量合并：单条 xhGhs（hd 走 debtAmount 合并，ghsApp 采购行走采购单重算）。
+     * 【调用时机】仅 php yii balance-merge/run；ghsApp 采购行请用 ghs-purchase-balance-merge/run。
      */
-    public static function mergeCustomRowFromListIfNeeded($customId)
+    public static function mergeGhsMoneyForScript($ghs, $writeMergeChange = true)
     {
-        if (empty($customId)) {
-            return;
+        if (empty($ghs)) {
+            return $ghs;
+        }
+        $ghsId = is_array($ghs) ? ($ghs['id'] ?? 0) : ($ghs->id ?? 0);
+        if (!is_object($ghs) || !self::isMerged($ghs)) {
+            $ghs = BizGhsClass::getLockById($ghsId);
+        }
+        if (empty($ghs)) {
+            return $ghs;
         }
-        $custom = CustomClass::getLockById($customId);
-        if (!empty($custom)) {
-            self::ensureCustomMoneyReady($custom, true);
+        if (!self::isMerged($ghs) && self::isGhsAppPurchaseSupplierRow($ghs)) {
+            return self::mergeOwnShopGhsBalanceFromPurchaseOrdersIfNeeded($ghs, $writeMergeChange);
         }
+        return self::mergeGhsDebtIntoBalanceIfNeeded($ghs, $writeMergeChange);
     }
 
     /**
@@ -630,24 +644,4 @@ class AccountMoneyClass
             GhsBalanceChangeClass::add($gbData, true);
         }
     }
-
-    /**
-     * 【用途】供货商列表分页时的读路径懒合并：ghsApp 采购行按采购单重算，hd 花店行走 debtAmount 合并。
-     * 【调用时机】bizGhs\ghs\classes\GhsClass::groupBaseInfo。
-     */
-    public static function mergeGhsRowFromListIfNeeded($ghsId)
-    {
-        if (empty($ghsId)) {
-            return;
-        }
-        $ghs = BizGhsClass::getLockById($ghsId);
-        if (empty($ghs)) {
-            return;
-        }
-        if (self::isGhsAppPurchaseSupplierRow($ghs)) {
-            self::mergeOwnShopGhsBalanceFromPurchaseOrdersIfNeeded($ghs, true);
-            return;
-        }
-        self::mergeGhsDebtIntoBalanceIfNeeded($ghs, true);
-    }
 }

biz-ghs/custom/classes/CustomClass.php

@@ -565,17 +565,7 @@ class CustomClass extends BaseClass
             $level = $val['level'] ?? 1;
             $levelName = $levelMap[$level] ?? '';
             $list[$key]['levelName'] = $levelName;
-            // 列表读：未合并的挂账先懒合并，再按 appVersion 格式化金额字段
-            $customId = $val['id'] ?? 0;
-            if (!empty($customId) && bccomp($val['debtAmount'] ?? '0', '0', 2) != 0 && empty($val['balanceMerged'])) {
-                AccountMoneyClass::mergeCustomRowFromListIfNeeded($customId);
-                $fresh = self::getById($customId);
-                if (!empty($fresh)) {
-                    $val = is_array($fresh) ? $fresh : $fresh->getAttributes();
-                    $list[$key] = array_merge($list[$key], $val);
-                }
-            }
-            // 按 appVersion 输出净 balance 或旧版待结+余额字段
+            // 按 appVersion 输出净 balance 或旧版待结+余额字段（合并仅由控制台脚本执行）
             $list[$key] = AccountMoneyClass::formatMoneyForClient($list[$key]);
 
             //前端使用，走播，预订客户添加新客户

biz-ghs/ghs/classes/GhsClass.php

@@ -97,18 +97,6 @@ class GhsClass extends BaseClass
         $ids = array_column($list, 'shopId');
         $shopInfo = ShopClass::getByIds($ids, null, 'id');
         foreach ($list as $key => $val) {
-            // 列表读：未合并行懒合并（ghsApp 采购行按采购单重算，hd 行走 debtAmount 合并）
-            $ghsId = $val['id'] ?? 0;
-            if (!empty($ghsId) && empty($val['balanceMerged'])) {
-                AccountMoneyClass::mergeGhsRowFromListIfNeeded($ghsId);
-                $fresh = self::getById($ghsId);
-                if (!empty($fresh)) {
-                    $freshAttrs = is_array($fresh) ? $fresh : $fresh->getAttributes();
-                    $list[$key] = array_merge($list[$key], $freshAttrs);
-                    $val = $list[$key];
-                }
-            }
-
             $avatar = $val['avatar'] ?? '';
             $list[$key]['shortAvatar'] = $avatar;
             $list[$key]['avatar'] = imgUtil::groupImg($avatar);

biz-hd/ghs/classes/GhsClass.php

@@ -5,7 +5,7 @@ namespace bizHd\ghs\classes;
 /**
  * 花店侧 xhGhs 关系账户（与 xhGhsCustom 成对，custom.ghsId 关联）
  *
- * 金额与 bizGhs\custom\classes\AccountMoneyClass 一致：写前 ensureGhsMoneyReady；
+ * 金额与 bizGhs\custom\classes\AccountMoneyClass 一致：写前 ensureGhsMoneyReady（仅行锁）；
  * 挂账=balance 减少，结账/退款=balance 增加；只记 GhsBalanceChange，不再新增 GhsDebtChange（历史仍可查）。
  */
 use bizGhs\custom\classes\AccountMoneyClass;

console/controllers/BalanceMergeController.php

@@ -11,7 +11,7 @@ use yii\console\Controller;
  * 挂账并入余额 — 控制台补漏（休眠账户批量处理）
  *
  * 【用途】处理长期未触发「开单/充值/结账」等入口、仍未 merge 的历史账户。
- * 【与线上一致】内部调用 AccountMoneyClass::ensureCustomMoneyReady / ensureGhsMoneyReady。
+ * 内部调用 AccountMoneyClass::mergeCustomMoneyForScript / mergeGhsMoneyForScript（线上业务不再自动合并）。
  *
  * 用法：php yii balance-merge/run  或  --dryRun=1 仅预览
  */
@@ -38,7 +38,7 @@ class BalanceMergeController extends Controller
     }
 
     /**
-     * 【用途】扫 xhGhsCustom：debtAmount>0 且（有 balanceMerged 列时）balanceMerged=0，逐条 ensureCustomMoneyReady。
+     * 【用途】扫 xhGhsCustom：debtAmount>0 且（有 balanceMerged 列时）balanceMerged=0，逐条脚本合并。
      */
     protected function mergeCustomRows($dry)
     {
@@ -54,14 +54,14 @@ class BalanceMergeController extends Controller
                 $count++;
                 continue;
             }
-            AccountMoneyClass::ensureCustomMoneyReady($custom, true);
+            AccountMoneyClass::mergeCustomMoneyForScript($custom, true);
             $count++;
         }
         return $count;
     }
 
     /**
-     * 【用途】扫 xhGhs：条件同上，逐条 ensureGhsMoneyReady（不自动带 custom，休眠 ghs 单独处理）。
+     * 【用途】扫 xhGhs：条件同上，逐条 mergeGhsMoneyForScript（不自动带 custom，休眠 ghs 单独处理）。
      */
     protected function mergeGhsRows($dry)
     {
@@ -77,7 +77,7 @@ class BalanceMergeController extends Controller
                 $count++;
                 continue;
             }
-            AccountMoneyClass::ensureGhsMoneyReady($ghs, true);
+            AccountMoneyClass::mergeGhsMoneyForScript($ghs, true);
             $count++;
         }
         return $count;

console/controllers/GhsController.php

@@ -58,8 +58,7 @@ class GhsController extends Controller
             return;
         }
 
-        // 与线上一致：巡检前先合并历史 debtAmount → 净 balance
-        AccountMoneyClass::ensureGhsMoneyReady($ghs, true);
+        // 巡检只读比对，不触发合并（合并请用 balance-merge / ghs-purchase-balance-merge 脚本）
         $ghs = GhsClass::getById($ghsId, true);
         if (empty($ghs)) {
             return;
@@ -67,7 +66,6 @@ class GhsController extends Controller
 
         $custom = CustomClass::getByCondition(['ghsId' => $ghsId], true);
         if (!empty($custom)) {
-            AccountMoneyClass::ensureCustomMoneyReady($custom, true);
             $custom = CustomClass::getById($custom->id ?? 0, true);
             $customNet = AccountMoneyClass::getNetBalanceFromRow($custom);
             $ghsNet = AccountMoneyClass::getNetBalanceFromRow($ghs);