-- =====================================================================
-- 客户余额核销应收账单 V1.0  2026-09-16
-- 1) 余额核销单表 ar_balance_writeoff（资金来源：customer_account.balance）
-- 2) 存量账单未核销金额重算 customer_account.used_credit 占用
-- 3) 菜单与授权：客户账单(2435) / 账单详情(2436) / 余额核销(2437) / 反核销(2438)
-- =====================================================================

-- 余额核销单：用客户账户余额核销应收账单，
-- 与客户账户余额流水配合，共享 ar_bill.written_off_amount / unwritten_amount 缓存字段
CREATE TABLE IF NOT EXISTS ar_balance_writeoff (
  writeoff_id        BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '余额核销ID',
  writeoff_no        VARCHAR(50) NOT NULL COMMENT '核销单号(BWO开头)',
  ar_bill_id         BIGINT(20) NOT NULL COMMENT '应收账单ID',
  bill_no            VARCHAR(50) NOT NULL COMMENT '账单号快照',
  customer_id        BIGINT(20) NOT NULL COMMENT '客户ID',
  account_id         BIGINT(20) DEFAULT NULL COMMENT '客户账户ID',
  currency           VARCHAR(10) NOT NULL DEFAULT 'CNY' COMMENT '币种',
  writeoff_amount    DECIMAL(18,2) NOT NULL DEFAULT 0.00 COMMENT '本次核销金额',
  balance_flow_id    BIGINT(20) DEFAULT NULL COMMENT '核销扣余额流水ID',
  reverse_flow_id    BIGINT(20) DEFAULT NULL COMMENT '反核销回补余额流水ID',
  writeoff_date      DATE NOT NULL COMMENT '核销日期',
  status             VARCHAR(30) NOT NULL COMMENT '状态：EFFECTIVE=有效（已扣减客户余额），CANCELLED=已反核销（已回补客户余额）',
  remark             VARCHAR(500) DEFAULT NULL COMMENT '核销备注',
  create_by          VARCHAR(64) NOT NULL COMMENT '创建人',
  create_time        DATETIME NOT NULL COMMENT '创建时间',
  cancel_by          VARCHAR(64) DEFAULT NULL COMMENT '反核销人',
  cancel_time        DATETIME DEFAULT NULL COMMENT '反核销时间',
  cancel_remark      VARCHAR(500) DEFAULT NULL COMMENT '反核销原因',
  PRIMARY KEY (writeoff_id),
  UNIQUE KEY uk_ar_balance_writeoff_no (writeoff_no),
  KEY idx_abw_bill (ar_bill_id, status),
  KEY idx_abw_customer (customer_id, status),
  KEY idx_abw_account (account_id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci COMMENT='应收账单余额核销表';

-- 存量数据：为仅有账单、没有账户的客户补建账户（理论上CNY账户均已自动开户）
INSERT INTO customer_account (customer_id, currency, balance, frozen_balance, total_credit, extra_credit, used_credit, tax, version, create_by, create_time, del_flag)
SELECT b.customer_id, b.currency, 0, 0, 0, 0, 0, 0, 0, 'system', NOW(), '0'
FROM (
  SELECT customer_id, currency FROM ar_bill
  WHERE status IN ('CONFIRMED','PARTIAL_WRITTEN_OFF')
  GROUP BY customer_id, currency
) b
LEFT JOIN customer_account a
  ON a.customer_id = b.customer_id
 AND a.currency COLLATE utf8mb4_general_ci = b.currency
 AND a.del_flag = '0'
WHERE a.id IS NULL;

-- 已用额度 = 该客户该币种 已确认/部分核销账单的未核销金额合计
UPDATE customer_account a
JOIN (
  SELECT customer_id, currency, SUM(unwritten_amount) AS used_total
  FROM ar_bill
  WHERE status IN ('CONFIRMED','PARTIAL_WRITTEN_OFF')
  GROUP BY customer_id, currency
) t ON t.customer_id = a.customer_id
   AND t.currency COLLATE utf8mb4_general_ci = a.currency
SET a.used_credit = t.used_total,
    a.version = a.version + 1,
    a.update_by = 'system',
    a.update_time = NOW()
WHERE a.del_flag = '0';

-- 菜单（父菜单 2309 = 客户/供应商管理；如环境ID不同请自行调整）
INSERT INTO sys_menu (menu_id, menu_name, parent_id, order_num, path, component, query, is_frame, is_cache, menu_type, visible, status, perms, icon, create_by, create_time, remark)
VALUES
(2435, '客户账单', 2309, 3, 'customerbill', 'customersuppliermanagement/customerinfo/customerbill/index', '', 1, 0, 'C', '0', '0', 'customer:bill:list', 'documentation', 'admin', NOW(), '客户应收账单只读查询'),
(2436, '账单详情', 2435, 1, '', NULL, '', 1, 0, 'F', '0', '0', 'customer:bill:query', '#', 'admin', NOW(), ''),
(2437, '余额核销', 2435, 2, '', NULL, '', 1, 0, 'F', '0', '0', 'customer:bill:writeoff', '#', 'admin', NOW(), '用客户账户余额核销应收账单'),
(2438, '取消余额核销', 2435, 3, '', NULL, '', 1, 0, 'F', '0', '0', 'customer:bill:writeoff:cancel', '#', 'admin', NOW(), '反核销');

-- 普通角色授权（按实际角色调整）
INSERT INTO sys_role_menu (role_id, menu_id) VALUES
(2, 2435), (2, 2436), (2, 2437), (2, 2438);