cma-management/backend/scripts/treasury_ddl.sql

-- ============================================================================
-- CMA 司库（资金）体系 · 阶段一 MVP —— DDL（阶段 1 落盘版）
-- ============================================================================
-- 状态        : 落地版（2026-09-15 阶段 1）。G1 = 放行（有条件），见
--               wecom-project/pending-tasks/_verification/fullstack-202609151735-cma-treasury-g1-review.md
-- 评审稿出处  : wecom-fullstack/pending-tasks/_reports/treasury-stage1-ddl-draft-20260915.sql
--               （md5 3aa4d944691b49cfda9b1f08f6bea549 —— 归档件，不回改）
-- 本版修正    : P2-6 data_status 默认 fail-safe / D-8 submitter 语义 / 调整2 detail 结构化
--               / P2-8 金额纪律注释 / 无物理外键的应用层覆盖声明（§F）
-- 依据        : PRD v1.1 §3.2/§3.3（md5 cc9ca839b7fd6f633f4066ba385819be）
--               财务口径签认 v1（md5 74b43cfdf25abf5b7654eba54e82d099）
--               财务侧前置交付 F1/F2/F3（md5 a49ae4340c05dfa20aba7daad25cc25f）
-- 目标环境    : MySQL 8.0（InnoDB），charset/collation 以只读探针实测为准
-- 范围        : 6 张新表 + cash_plans 加 4 列（向后兼容，只加列不改列）
--              阶段三的 4 张表（pools/pool_members/credits/internal_transfers）不建
-- 幂等契约    : 同一脚本重复执行结果不变（见 §E）
-- 命名约定    : 约束名与 PRD §3.2 字面一致（唯一键 uq_* / 普通索引 ix_*）
-- 执行方式    : 仅由 backend/scripts/treasury_migrate.py --apply 执行（本文件不含裸 ALTER 执行逻辑）
-- ============================================================================


-- ============================================================================
-- §A. 建表（6 张，CREATE TABLE IF NOT EXISTS 天然幂等）
--     应用层软链（不建物理外键，G1 §3-2 裁定）覆盖声明见 §F
-- ============================================================================

-- A1. 资金账户主数据（统一管理：台账唯一入口）
--     tier 口径（财务签认 口径1 / PRD M1）：按【账户性质】判定，禁止按 org_nodes.level 派生
--       hq        : 法人银行户 / 收款通道（1002xx、微信、支付宝、友赞商户）
--       grassroots: 现金 / 备用金 / 备用卡 / 中间账户（100101/100104/100105/100106/100107）
--       platform  : 分公司独立法人账户（当前两实体均无，禁止造虚层级）
CREATE TABLE IF NOT EXISTS treasury_accounts (
  id             INT AUTO_INCREMENT PRIMARY KEY,
  entity_id      INT NOT NULL COMMENT '企业ID（多租户铁律，必带）',
  account_no     VARCHAR(64) NOT NULL COMMENT '账号/虚拟账户号（掩码）',
  account_name   VARCHAR(100) NOT NULL COMMENT '账户名（如 建设银行（货款账户））',
  account_type   VARCHAR(20) NOT NULL COMMENT 'cash现金/bank银行/e_wallet微信支付宝/other',
  bank_name      VARCHAR(100) NULL,
  subject_code   VARCHAR(20) NULL COMMENT '对应科目（1001xx/1002xx）— 流水/头寸归集用',
  currency       VARCHAR(10) DEFAULT 'CNY',
  tier           VARCHAR(20) NOT NULL COMMENT 'hq总部/platform平台/grassroots基层（按账户性质判定）',
  tier_basis     VARCHAR(20) DEFAULT 'nature' COMMENT '[D-1] tier 判定依据：nature账户性质/level派生/manual人工；口径1 要求 accounts 一律 nature',
  owner_node_id  INT NULL COMMENT '使用/保管部门标注 org_nodes.id（不参与 tier 派生、不作授权依据）— 软链，应用层校验见 §F',
  open_balance   FLOAT NULL COMMENT '期初余额(万元)；F2 到位前留 NULL。金额纪律见 §F-1',
  open_period    VARCHAR(20) NULL COMMENT '期初期间 YYYY-MM',
  is_pool_member TINYINT DEFAULT 0 COMMENT '阶段三资金池用',
  status         VARCHAR(20) DEFAULT 'active' COMMENT 'active/inactive/closed',
  remark         VARCHAR(500) NULL,
  created_at     DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at     DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  UNIQUE KEY uq_tacct_entity_no (entity_id, account_no),
  KEY ix_tacct_entity (entity_id, status),
  KEY ix_tacct_subject (entity_id, subject_code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='司库·资金账户主数据';


-- A2. 账户头寸（日/期末）
--     铁律：余额 = 期初 + 流水（期初缺失时 data_status='estimated'）；
--           禁止把 voucher_details 的"流水净额累计"当余额（PRD §2.2-1 实证）
CREATE TABLE IF NOT EXISTS treasury_balances (
  id            INT AUTO_INCREMENT PRIMARY KEY,
  entity_id     INT NOT NULL,
  account_id    INT NOT NULL COMMENT 'treasury_accounts.id（软链，应用层校验见 §F）',
  period        VARCHAR(20) NOT NULL COMMENT 'YYYY-MM-DD 日头寸 / YYYY-MM 月末头寸',
  balance       FLOAT NOT NULL COMMENT '账面余额(万元)。金额纪律见 §F-1',
  available     FLOAT NULL COMMENT '可用余额(万元)（NULL=未采集，勿以 balance 冒充）',
  frozen        FLOAT DEFAULT 0 COMMENT '冻结/在途(万元)',
  source        VARCHAR(30) NOT NULL COMMENT 'ledger期初+流水/import导入/manual手工/pool归集',
  data_status   VARCHAR(20) DEFAULT 'estimated' COMMENT 'verified/estimated —— [P2-6] 默认 estimated（fail-safe）：verified 必须显式写入（仅期初已落定/对账通过）；estimated 头寸禁止 block 规则生效',
  batch         VARCHAR(100) NULL COMMENT '导入批次指纹（幂等用，对齐 cash_vouchers_json._content_fingerprint 范式）',
  created_at    DATETIME DEFAULT CURRENT_TIMESTAMP,
  UNIQUE KEY uq_tbal_acct_period (account_id, period),
  KEY ix_tbal_entity_period (entity_id, period),
  KEY ix_tbal_entity_status (entity_id, data_status)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='司库·账户头寸（日/期末）';


-- A3. 资金内控规则库（P0 核心）
--     params JSON 结构与口径映射：
--       NP-001 budget_required  {"judge":"budget_plans","entity1":"block","entity2":"warn",
--                                "occupancy":"paid+approved+pending_approval+this",
--                                "unmatched":"specify_budget_flow"}
--       AU-001 authorization    {"tiers":[{"from":0,"to":3,"required_approvals":0},...],
--                                "daily_cum_limit":9,"max_strict":true,"bounds":"[from,to)"}
--       BL-001 dual_sign        {"min_amount":30,"distinct_natural_person":true}
--       LQ-001 liquidity        {"target":26,"warn":12,"block":6,"block_enabled":false,
--                                "skip_when":"data_status=estimated"}
CREATE TABLE IF NOT EXISTS treasury_control_rules (
  id          INT AUTO_INCREMENT PRIMARY KEY,
  entity_id   INT NOT NULL,
  rule_code   VARCHAR(20) NOT NULL COMMENT 'NP-001/AU-001/BL-001/LQ-001/LQ-002/TF-001/AC-001',
  rule_name   VARCHAR(100) NOT NULL,
  rule_type   VARCHAR(30) NOT NULL COMMENT 'budget_required/authorization/dual_sign/liquidity/two_funds/account_valid',
  severity    VARCHAR(10) NOT NULL COMMENT 'block拦截/warn预警',
  params      JSON NULL COMMENT '阈值参数（金额段/下限/比例等，不硬编码）',
  rule_version VARCHAR(20) DEFAULT 'v1' COMMENT '[调整2] 规则版本，写入 control_hits.detail.rule_version（审计可自证）',
  enabled     TINYINT DEFAULT 1,
  remark      VARCHAR(500) NULL,
  created_at  DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at  DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  UNIQUE KEY uq_tcr_entity_code (entity_id, rule_code)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='司库·资金内控规则库';


-- A4. 支付单（内控闸门载体）
--     拆单累计穿透（口径2/M4）所需索引：ix_tpay_daysplit（同提交人×同收款方×同自然日累计）
--     [D-8] submitter / created_by 语义（G1 复算发现的未披露增补，追认采纳）：
--           submitter  = 支付单提交人 —— AU-001 拆单累计穿透的"同一提交人"判据（业务语义字段）
--           created_by = 建单人 —— 历史兼容列（与既有表 created_by 命名一致）
--           首版两者同值（提交即建单）；保留双列以便后续"审批链与建单分离"时语义不破坏
CREATE TABLE IF NOT EXISTS treasury_payments (
  id             INT AUTO_INCREMENT PRIMARY KEY,
  entity_id      INT NOT NULL,
  pay_no         VARCHAR(50) NOT NULL COMMENT '支付单号',
  from_account_id INT NOT NULL COMMENT '付款账户（必须已登记，禁未入台账账户）——软链，应用层校验见 §F',
  to_name        VARCHAR(200) NOT NULL COMMENT '收款方',
  to_account_no  VARCHAR(64) NULL,
  amount         FLOAT NOT NULL COMMENT '金额(万元)。金额纪律见 §F-1',
  currency       VARCHAR(10) DEFAULT 'CNY',
  purpose        VARCHAR(500) NOT NULL COMMENT '用途（必填，内控留痕）',
  pay_type       VARCHAR(30) NULL COMMENT '货款/费用/税费/薪酬/融资/内部划转',
  pay_date       DATE NULL COMMENT '业务付款日（拆单累计穿透按此自然日归集；口径2）',
  budget_plan_id INT NULL COMMENT '关联预算计划（NP-001 授权性判据首选）——软链',
  kpi_id         INT NULL,
  related_plan_id INT NULL COMMENT '关联 cash_plans.id（不新建表，复用收付计划）——软链',
  status         VARCHAR(20) DEFAULT 'draft' COMMENT 'draft/precheck/pending_approval/approved/rejected/paid/cancelled',
  check_result   VARCHAR(20) NULL COMMENT 'pass/blocked/warn',
  check_detail   JSON NULL COMMENT '[{rule_code,verdict,detail,matched_scope}] 命中档位写在 matched_scope（口径2-③）',
  required_approvals TINYINT NULL COMMENT '[D-2] 本单实际所需审批级数（取最严档结果，落库便于审计复现）',
  day_cum_amount FLOAT NULL COMMENT '[D-3] 判定时 同提交人×同收款方×同自然日 累计金额(万元，含本单)',
  approvals      JSON NULL COMMENT '[{account,role,person_name,at,comment}] — 双签须记账号+角色+自然人姓名（口径4）',
  dual_sign_effective TINYINT NULL COMMENT 'BL-001：两账号是否不同自然人；0=形式双签（放行无效，审计标红）',
  is_waived      TINYINT DEFAULT 0 COMMENT '[D-4] 是否经豁免通道放行（豁免人/事由落 treasury_control_hits）',
  submitter      VARCHAR(100) NOT NULL COMMENT '[D-8] 提交人（AU-001 拆单累计穿透"同一提交人"判据）',
  submitted_at   DATETIME NULL COMMENT '[D-5] 提交时间（口径2 日累计/占用口径需要审批链时间锚）',
  approved_at    DATETIME NULL COMMENT '[D-5] 放行时间',
  paid_at        DATETIME NULL,
  created_by     VARCHAR(100) NOT NULL COMMENT '[D-8] 建单人（历史兼容列；首版与 submitter 同值）',
  created_at     DATETIME DEFAULT CURRENT_TIMESTAMP,
  updated_at     DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
  UNIQUE KEY uq_tpay_entity_no (entity_id, pay_no),
  KEY ix_tpay_entity_status (entity_id, status),
  KEY ix_tpay_daysplit (entity_id, pay_date, to_name, submitter),
  KEY ix_tpay_acct (entity_id, from_account_id, status)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='司库·支付单（资金内控闸门）';


-- A5. 规则命中留痕（审计，append-only，不可省）
--     [调整2 / D-6] detail 固定结构化字段（规则引擎按此写入，审计追问要能自证）：
--       {"rule_code":..,"rule_version":..,"matched_scope":..,"threshold":..,
--        "cumulative":..,"verdict_basis":".."}
CREATE TABLE IF NOT EXISTS treasury_control_hits (
  id          INT AUTO_INCREMENT PRIMARY KEY,
  entity_id   INT NOT NULL,
  target_type VARCHAR(20) NOT NULL COMMENT 'payment/plan/internal_transfer',
  target_id   INT NOT NULL,
  rule_code   VARCHAR(20) NOT NULL,
  verdict     VARCHAR(20) NOT NULL COMMENT 'pass/blocked/waived/warn',
  detail      JSON NULL COMMENT '[调整2] 结构化判据快照，固定字段 {rule_code, rule_version, matched_scope, threshold, cumulative, verdict_basis}',
  waived_by   VARCHAR(100) NULL COMMENT '豁免审批人（豁免级别不得低于该笔所需审批级别，口径4）',
  waived_reason VARCHAR(500) NULL,
  created_at  DATETIME DEFAULT CURRENT_TIMESTAMP,
  KEY ix_tch_target (target_type, target_id),
  KEY ix_tch_entity_rule (entity_id, rule_code, created_at),
  KEY ix_tch_waived (entity_id, verdict, created_at)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='司库·内控规则命中留痕（append-only 审计）';


-- A6. 分级授权矩阵（不硬编码；A/B 数值生效前需任总过目）
--     边界口径（口径2-④ 左闭右开）：amount_from 含、amount_to 不含；amount_to IS NULL = 无上限
CREATE TABLE IF NOT EXISTS treasury_limits (
  id            INT AUTO_INCREMENT PRIMARY KEY,
  entity_id     INT NOT NULL,
  scope_type    VARCHAR(20) NOT NULL COMMENT 'role/account/tier',
  scope_value   VARCHAR(50) NOT NULL COMMENT 'finance/ceo/…/account_id/tier',
  amount_from   FLOAT NOT NULL COMMENT '段下限(万元,含)。金额纪律见 §F-1',
  amount_to     FLOAT NULL COMMENT '段上限(万元,不含)，NULL=无上限',
  required_approvals TINYINT DEFAULT 1 COMMENT '所需审批级数（≥2=双签）',
  approver_roles JSON NOT NULL COMMENT '["ceo","finance"]（顺序=先复核后批准，口径4）',
  require_budget TINYINT DEFAULT 1,
  daily_cum_limit FLOAT NULL COMMENT '自主档日累计上限（=3×A；超限升一级审批，口径2-②）',
  status        VARCHAR(20) DEFAULT 'active',
  created_at    DATETIME DEFAULT CURRENT_TIMESTAMP COMMENT '[D-9] 审计必需（PRD 该表无此列，G1 追认采纳）',
  UNIQUE KEY uq_tlim_scope (entity_id, scope_type, scope_value, amount_from),
  KEY ix_tlim_entity (entity_id, status)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='司库·分级授权矩阵';


-- ============================================================================
-- §B. 扩展既有表（只加列、不改列、默认 NULL —— 存量数据零影响）
--     注意：MySQL 8.0 不支持 ADD COLUMN IF NOT EXISTS，
--           裸 ALTER 重复执行会报 1060 Duplicate column name。
--           故 §B 由 migrate 脚本按 information_schema 预检结果条件执行（见 §E-②）。
-- ============================================================================

-- B0. 幂等预检（migrate 脚本执行前必跑；输出缺失列清单，全 0 即跳过）
-- SELECT COLUMN_NAME FROM information_schema.COLUMNS
--  WHERE TABLE_SCHEMA = DATABASE() AND TABLE_NAME = 'cash_plans'
--    AND COLUMN_NAME IN ('account_id','tier','pool_id','is_locked');

ALTER TABLE cash_plans
  ADD COLUMN account_id INT NULL COMMENT '资金来源/去向账户 treasury_accounts.id（软链，无物理外键）',
  ADD COLUMN tier      VARCHAR(20) NULL COMMENT 'hq/platform/grassroots（三位一体视角；可由 org_nodes.level 派生）',
  ADD COLUMN pool_id   INT NULL COMMENT '归属资金池（阶段三启用，本阶段恒 NULL）',
  ADD COLUMN is_locked TINYINT DEFAULT 0 COMMENT '是否已被预算/内控锁定';

-- B1. 可选索引 [D-7]（G1 已随 D-1~D-7 全部采纳；与 §B 同批执行）
ALTER TABLE cash_plans ADD KEY ix_cashplans_entity_acct (entity_id, account_id);


-- ============================================================================
-- §C. 数据种子（首版数值 = 财务建议值；任总拍板后只改数据行、不改代码）
--     幂等：INSERT ... ON DUPLICATE KEY UPDATE（唯一键 = uq_tcr_entity_code / uq_tlim_scope）
--     行数契约：规则 8 行（e1 4 + e2 4）+ 授权矩阵 6 行
-- ============================================================================

-- C1. 三条 block 规则 + LQ-001（entity1 / entity2 各一套）
--   NP-001：entity1=block，entity2=warn（分期上线，过渡期 1 个月后切 block）
--   AU-001：tiers 采用签认首版 A/B（酣客 3/30 万；博海 5/50 万）—— 待任总过目
--   BL-001：distinct_natural_person=true（两账号须属不同自然人）
--   LQ-001：首版一律 warn、block_enabled=false（阶段二接预警）
INSERT INTO treasury_control_rules (entity_id, rule_code, rule_name, rule_type, severity, params, rule_version, enabled)
VALUES
 (1,'NP-001','无预算不开支（授权性判据）','budget_required','block',
  JSON_OBJECT('judge','budget_plans','severity','block',
              'occupancy','paid+approved+pending_approval+this',
              'unmatched','specify_budget_flow','transition_until','2026-10-15'),'v1',1),
 (1,'AU-001','超授权拦截（含拆单累计穿透+日累计升级）','authorization','block',
  JSON_OBJECT('tiers',JSON_ARRAY(JSON_OBJECT('from',0,'to',3,'required_approvals',0),
                                 JSON_OBJECT('from',3,'to',30,'required_approvals',1),
                                 JSON_OBJECT('from',30,'to',NULL,'required_approvals',2)),
              'daily_cum_limit',9,'merge_same_payee_same_day',true,'max_strict',true,'bounds','[from,to)'),'v1',1),
 (1,'BL-001','大额支付双签（须不同自然人）','dual_sign','block',
  JSON_OBJECT('min_amount',30,'required_approvals',2,'distinct_natural_person',true,
              'record_fields',JSON_ARRAY('account','role','person_name'),'order','review_then_approve'),'v1',1),
 (1,'LQ-001','流动性下限（首版 warn-only 页面并列对照）','liquidity','warn',
  JSON_OBJECT('target',26,'warn',12,'block',6,'block_enabled',false,
              'skip_when','data_status=estimated'),'v1',1),
 (2,'NP-001','无预算不开支（博海首版 warn+强制补录）','budget_required','warn',
  JSON_OBJECT('judge','budget_plans','severity','warn','occupancy','paid+approved+pending_approval+this',
              'unmatched','specify_budget_flow','transition_until','2026-10-15'),'v1',1),
 (2,'AU-001','超授权拦截（含拆单累计穿透+日累计升级）','authorization','block',
  JSON_OBJECT('tiers',JSON_ARRAY(JSON_OBJECT('from',0,'to',5,'required_approvals',0),
                                 JSON_OBJECT('from',5,'to',50,'required_approvals',1),
                                 JSON_OBJECT('from',50,'to',NULL,'required_approvals',2)),
              'daily_cum_limit',15,'merge_same_payee_same_day',true,'max_strict',true,'bounds','[from,to)'),'v1',1),
 (2,'BL-001','大额支付双签（须不同自然人）','dual_sign','block',
  JSON_OBJECT('min_amount',50,'required_approvals',2,'distinct_natural_person',true,
              'record_fields',JSON_ARRAY('account','role','person_name'),'order','review_then_approve'),'v1',1),
 (2,'LQ-001','流动性下限（博海首版默认 warn/关闭）','liquidity','warn',
  JSON_OBJECT('target',50,'warn',10,'block',5,'block_enabled',false,
              'skip_when','data_status=estimated'),'v1',0)
ON DUPLICATE KEY UPDATE rule_name=VALUES(rule_name), rule_type=VALUES(rule_type),
                        severity=VALUES(severity), params=VALUES(params), rule_version=VALUES(rule_version);

-- C2. 授权矩阵（scope_type='role'，按 entity 生效；双签档 approver_roles 顺序=先复核后批准）
INSERT INTO treasury_limits (entity_id, scope_type, scope_value, amount_from, amount_to,
                             required_approvals, approver_roles, require_budget, daily_cum_limit)
VALUES
 (1,'role','finance',0,   3,   0, JSON_ARRAY(),               1, 9),
 (1,'role','ceo',    3,   30,  1, JSON_ARRAY('ceo'),          1, NULL),
 (1,'role','ceo',    30,  NULL,2, JSON_ARRAY('finance','ceo'),1, NULL),
 (2,'role','finance',0,   5,   0, JSON_ARRAY(),               1, 15),
 (2,'role','ceo',    5,   50,  1, JSON_ARRAY('ceo'),          1, NULL),
 (2,'role','ceo',    50,  NULL,2, JSON_ARRAY('finance','ceo'),1, NULL)
ON DUPLICATE KEY UPDATE amount_to=VALUES(amount_to), required_approvals=VALUES(required_approvals),
                        approver_roles=VALUES(approver_roles), daily_cum_limit=VALUES(daily_cum_limit);


-- ============================================================================
-- §D. 回滚 / DOWN（由 treasury_migrate.py --down 执行；顺序与 UP 相反）
-- ============================================================================
-- D1. 回滚 cash_plans 扩展列：[P1-3] 按列存在性**逐列** DROP（部分态不再 1091）
--     回滚前 [P1-4] 必先 mysqldump cash_plans（写路径账号 + 临时 defaults-file 注入口令，
--     不硬编码、不回显；dump 失败 fail-closed —— 先 dump 成功才允许删列）
-- D2. 回滚新表（先删留痕/引用方，再删主数据）：DROP TABLE IF EXISTS 逐张
-- D3. 回滚安全性：6 张新表首版为空表（DROP 无损）；一旦有业务数据，
--     回滚须经人工确认（--yes），不提供 --force 免确认开关
-- D4. 回滚不触碰 cash.py 既有表结构，11 端点契约不受影响


-- ============================================================================
-- §E. 幂等与验证（由 treasury_migrate.py 逐条实现）
-- ============================================================================
-- E1. 幂等三件套 + 计数口径（[P0-2] 修正）
--     ① CREATE TABLE IF NOT EXISTS（表级幂等）
--     ② §B 列扩展按 information_schema 预检（列级幂等）
--     ③ §C 种子走 ON DUPLICATE KEY UPDATE（数据级幂等）
--     ⇒ 计数口径 = **新增对象数**（apply 前后 information_schema diff），不是"执行语句数"：
--          首跑：created_new=6 / added_cols=4 / 种子 8 规则行 + 6 授权行
--          二跑：created_new=0 / added_cols=0 / 种子行数不变
--     ④ up() 结尾断言 check()["missing_tables"] == []，否则非零退出（禁静默成功）
--     ⑤ 指纹行写入 import_logs(batch=treasury-ddl-<sha1[:10]>)，[P2-7] entity_id=1 为约定：
--        迁移指纹属实体无关元数据，import_logs.entity_id NOT NULL 约束下以 1 占位；
--        幂等按 (import_type,batch) 先查后写，不依赖表上是否有唯一键
-- E2. 表级自检（落库后）
--     SHOW CREATE TABLE treasury_accounts;                  -- 逐表核对 entity_id/唯一键/引擎字符集
--     SELECT TABLE_NAME FROM information_schema.TABLES
--      WHERE TABLE_SCHEMA=DATABASE() AND TABLE_NAME LIKE 'treasury%';        -- 期望 6 行
--     SELECT TABLE_NAME, COLUMN_NAME, IS_NULLABLE FROM information_schema.COLUMNS
--      WHERE TABLE_SCHEMA=DATABASE() AND TABLE_NAME LIKE 'treasury%'
--        AND COLUMN_NAME='entity_id';                                       -- 期望 6 行且全 NOT NULL
-- E3. 存量零影响证明
--     SELECT COUNT(*) FROM cash_plans;                      -- 迁移前后一致（基线以探针实测为准）


-- ============================================================================
-- §F. 应用层约束声明（G1 裁定"不建物理外键"的附条件覆盖说明 + 金额纪律）
-- ============================================================================
-- F-1 金额纪律（[P2-8] / G1 §3-3 附条件）：
--     * 全部金额列为 FLOAT（万元）—— 与 cash_plans.amount / budget_plans.budget_value 同口径；
--       FLOAT 非精确货币类型（技术债登记：迁 DECIMAL(18,4) 须与 cash_plans/budget_plans 同批）
--     * 写库前一律 round(x, 4)；比较一律用容差 TOL=1e-4，禁止浮点等值比较（引擎实现见 treasury.py）
-- F-2 软链的应用层校验覆盖（逐表说明，G1 §3-2 附条件）：
--     ① treasury_balances.account_id        → 写入/查询前校验 account 存在 且 account.entity_id == 传入 entity_id（防跨实体误挂）
--     ② treasury_payments.from_account_id   → AC-001：必须命中 treasury_accounts 且 status='active'（账外账户拦截）
--     ③ treasury_payments.budget_plan_id    → NP-001：命中 budget_plans 且 entity_id 一致；未命中走"指定/补录预算"流程
--     ④ treasury_payments.related_plan_id   → 校验 cash_plans 同 entity_id（只读复用，不改 cash.py 契约）
--     ⑤ treasury_payments.kpi_id            → 校验 kpis 同 entity_id（NP-001 兜底匹配用）
--     ⑥ treasury_control_hits.target_id     → target_type 限定取值域（payment/plan/internal_transfer），
--                                             写入前校验目标单据存在且同 entity_id
--     ⑦ treasury_accounts.owner_node_id     → 校验 org_nodes 同 entity_id（不存在则留空，禁造虚层级）
--     * 唯一键 + 应用层校验 + AC-001 覆盖主要一致性风险；跨实体写入在应用层一律 403/400 拒绝
-- ============================================================================