fix(profit-caliber): 博海口径 §4-1/§4-2/§4-5 落地 —— 固定成本仅借方 + 6403 进变动 + 财务收益单列 + 批次备注

ASK-20261014-04（任总 2026-10-14 11:20「放行4」）批后口径：
- §4-1 博海固定成本弃净额：6601/6602/6603 仅借方（133.98 万，2026-01..09）；2026-03 单月由 -9.02 万转正；
  6603 贷方（现金折扣收益 64.40 万）改 finance_income_terms 单列备查，不进固定成本/末行/勾稽。
- §4-2 博海变动成本追加 6403 营业税金及附加（530.17 万）。
- §4-3/§4-4 维持现行（酣客收入/边际贡献基数不动）。
- §4-5 管理利润表页加「数据批次/导入时刻」纯展示备注（import_logs）。
- 口径唯一源仍为 bep_caliber.ENTITY_CALIBERS；报表/卡面/派生器一律经 fixed_cost_spec() 解析（读口写口一致）。

backend/app/utils/bep_caliber.py

@@ -9,11 +9,12 @@
 
 | 项 | entity 1 陕西酣客 | entity 2 博海 |
 |---|---|---|
-| 变动成本（分子） | **(Σ5401借 + Σ5403借 + Σ571103借 − Σ530103贷)**〔⑤口径统一〕 | Σ6401 借方（主营业务成本） |
-| 收入基数（分母） | Σ5001 贷方（主营业务收入） | Σ6001 贷方（主营业务收入） |
-| 变动成本率 | 上式 ÷ Σ5001贷（**完整口径**，非渠补率） | Σ6401借 ÷ Σ6001贷（主营业务成本率） |
+| 变动成本（分子） | **(Σ5401借 + Σ5403借 + Σ571103借 − Σ530103贷)**〔⑤口径统一〕 | **Σ6401借 + Σ6403借**〔ASK-20261014-04 §4-2 批后口径〕 |
+| 收入基数（分母） | Σ5001 贷方（主营业务收入） | Σ6001 贷方（主营业务收入，**不含** 6051）〔§4-4 维持现行〕 |
+| 变动成本率 | 上式 ÷ Σ5001贷（**完整口径**，非渠补率） | 上式 ÷ Σ6001贷（主营业务成本率 ＋ 税金及附加） |
 | 实测渠补率（F_BEP_REBATE） | Σ571103借 ÷ Σ5001贷（**保留**为渠补单一事实源，**不再**充当变动成本率） | 无（None） |
-| 固定成本 | `5601%` + `5602%` + `5603%` 借−贷净额〔⑤扩容〕 | `6601+6602+6603`（销售/管理/财务费用）借−贷净额 |
+| 固定成本 | `5601%` + `5602%` + `5603%` 借−贷净额〔⑤扩容〕 | `6601` + `6602` + `6603` **仅借方**〔ASK-20261014-04 §4-1 批后口径〕 |
+| 财务收益（单列备查，**不进**固定成本） | 无（`560303` 利息收入 2026 零发生） | `6603` **贷方**（现金折扣收益等 64.40 万）〔§4-1〕 |
 | 折旧剔除（现金口径） | `560213`（管理费用-折旧叶子） | `1602` 累计折旧**当期贷方发生额**（见下） |
 | 本期利润结转科目 | `3103` 本年利润 | `4103` 本年利润 |
 | 结账信号次选（落盘） | `/root/WB_WS/_data/zxt-hanke/{YYYY.MM}/check.md` | 无（只用 DB 信号） |
@@ -33,6 +34,17 @@
 损益类科目「借−贷」净额在已结账月份恒为 0，会把指标静默清零
 （口径见 `/srv/hermes/wisdom/_decisions/cma-expense-profit-net-caliber-20261002.md`）。
 故博海口径 `exclude_closing=True`。
+
+⑥ ASK-20261014-04 批后口径（任总 2026-10-14 11:20「放行4」= 放行 4-1 / 4-2 / 4-5；4-3 / 4-4 维持现行）：
+  · §4-1（放行）博海固定成本**弃「借−贷净额」**：`6601` / `6602` / `6603` **仅借方**进固定成本
+    （2026-01..09 = 86.95 + 39.09 + 7.95 = **133.98 万**；净额口径为 69.58 万）；
+    `6603` **贷方**（现金折扣收益等 64.40 万）**作收益项单列**，`finance_income_terms`，**不再冲减固定成本**
+    —— 净额口径的病灶是 2026-03 单月固定成本被折扣收益打成 **−9.02 万**（负值），批后为正值。
+  · §4-2（放行）博海变动成本追加 `6403 营业税金及附加`（2026-01..09 = 0.37 万）⇒ 530.17 万。
+  · §4-3 / §4-4（维持现行）`571112 商品折扣` 不冲减酣客收入；边际贡献收入基数维持 e1=`5001` /
+    e2=`6001`（**不含** e2 `6051`）。
+  · 落点唯一：本表 `ENTITY_CALIBERS`（含本头注）；报表层 / 卡面 / 派生器**一律**经
+    `fixed_cost_spec()` 解析，不得另写科目集。酣客（e1）本次**未改**，仍走 `fixed_filters` 净额。
 """
 CLOSING_SUMMARY_LIKE = "%结转%"
 
@@ -54,7 +66,10 @@ ENTITY_CALIBERS = {
         rebate_terms=[("+", "571103", "debit")],
         revenue_field="credit_amount", revenue_filter=("eq", "5001"),
         fixed_filters=[("like", "5601"), ("like", "5602"), ("like", "5603")],
-        fixed_label="固定成本(5601+5602+5603)",
+        # §4-1 未改酣客：仍走「借−贷净额」前缀口径 ⇒ fixed_terms 显式 None（不隐式继承）
+        fixed_terms=None,
+        finance_income_terms=None,   # 酣客 560303 利息收入 2026 零发生 ⇒ 无单列财务收益项
+        fixed_label="固定成本(5601+5602+5603 借−贷净额)",
         dep_field="net", dep_filter=("eq", "560213"),
         closing_subject="3103",
         landing_dir=ZXT_LANDING_DIR_HANKE,
@@ -63,13 +78,18 @@ ENTITY_CALIBERS = {
     ),
     2: dict(
         name="博海",
-        margin_label="变动成本率(主营业务成本率)",
-        margin_desc="Σ6401借方 ÷ Σ6001贷方",
-        varcost_terms=[("+", "6401", "debit")],
+        margin_label="变动成本率(主营成本率+税金及附加)",
+        margin_desc="(Σ6401借+Σ6403借) ÷ Σ6001贷",
+        # §4-2（放行）：追加 6403 营业税金及附加（与 e1 含 5403 对齐）
+        varcost_terms=[("+", "6401", "debit"), ("+", "6403", "debit")],
         rebate_terms=None,         # 博海无渠补科目
         revenue_field="credit_amount", revenue_filter=("eq", "6001"),
-        fixed_filters=[("like", "6601"), ("like", "6602"), ("like", "6603")],
-        fixed_label="固定成本(6601+6602+6603)",
+        # §4-1（放行）：弃「借−贷净额」⇒ 带号科目项 + field=debit（仅借方）；
+        #   6603 贷方（现金折扣收益）改走 finance_income_terms 单列，不再冲减固定成本
+        fixed_terms=[("+", "6601", "debit"), ("+", "6602", "debit"), ("+", "6603", "debit")],
+        fixed_filters=None,        # 显式置空：禁止两套口径并存（fixed_cost_spec 以 terms 优先）
+        finance_income_terms=[("+", "6603", "credit")],
+        fixed_label="固定成本(6601+6602+6603 借方)",
         dep_field="credit_amount", dep_filter=("eq", "1602"),
         closing_subject="4103",
         landing_dir=None,
@@ -90,3 +110,33 @@ def caliber_for(entity_id: int) -> dict:
     if cal is None:
         raise KeyError(f"entity={entity_id} 未注册 BEP 口径（见 app/utils/bep_caliber.py）")
     return cal
+
+
+# ── 固定成本 / 财务收益：**唯一解析口** ──────────────────────────────────────
+# 报表层（app/utils/profit_lines.py）、卡面（app/api/dashboard.py）、派生器
+# （scripts/kpi_bep_deriver.py）三处一律经本函数取科目构成，禁各自写一套（防「卡面新口径 /
+# KPI 旧口径」）。§4-1 后：e2 走 terms（`6601/6602/6603` 仅借方），e1 走 filters（借−贷净额）。
+
+def fixed_cost_spec(cal: dict):
+    """固定成本取数规格 → (mode, spec)。
+
+    mode='terms'   ⇒ spec = [(sign, code, field), ...]（带号科目项；§4-1 后博海形态）
+    mode='filters' ⇒ spec = [(kind, code), ...]（前缀/精确 OR + 借−贷净额；酣客形态）
+    """
+    terms = cal.get("fixed_terms")
+    if terms:
+        return "terms", [tuple(t) for t in terms]
+    return "filters", [tuple(f) for f in (cal.get("fixed_filters") or [])]
+
+
+def finance_income_terms(cal: dict) -> list:
+    """财务收益（单列备查，**不进**固定成本）带号科目项；无则空列表（§4-1 只涉博海）。"""
+    return [tuple(t) for t in (cal.get("finance_income_terms") or [])]
+
+
+def caliber_digest() -> str:
+    """口径指纹（证据用）：ENTITY_CALIBERS 的 md5 —— 口径一改指纹即变，便于「改前/改后」取证。"""
+    import hashlib
+    import json
+    blob = json.dumps(ENTITY_CALIBERS, sort_keys=True, ensure_ascii=False, default=str)
+    return hashlib.md5(blob.encode("utf-8")).hexdigest()

backend/app/utils/profit_lines.py

@@ -5,7 +5,11 @@
   · 收入       ：`caliber['revenue_field']` + `caliber['revenue_filter']`（e1=5001 贷方 / e2=6001 贷方）
   · 变动成本   ：`caliber['varcost_terms']`（带号科目项；e1 = 5401借 + 5403借 + 571103借 − 530103贷）
   · 固定成本   ：`caliber['fixed_terms']`（带号科目项，**优先**）否则 `caliber['fixed_filters']`
-                 （前缀元组 → 派生为 `('+', '<前缀>%', 'net')` 借−贷净额；口径升级为 `fixed_terms` 后本层零改动自动跟随）
+                 （前缀元组 → 派生为 `('+', '<前缀>%', 'net')` 借−贷净额）；两者一律经
+                 `bep_caliber.fixed_cost_spec()` **唯一解析口**解析（报表/卡面/派生器同源）。
+                 §4-1 批后：博海走 terms（`6601/6602/6603` **仅借方**），酣客仍走 filters（净额）。
+  · 财务收益   ：`caliber['finance_income_terms']`（§4-1：博海 `6603` **贷方**）—— **单列备查**，
+                 **不进**固定成本、不进末行、不参与勾稽（纯展示项）。
   · 期间行域   ：`carry_forward == 0` + `caliber['exclude_closing']`（结转腿未标账套须显式剔 `summary LIKE '%结转%'`）
   · 作废行域   ：`apply_voucher_guard`（`voucher_void_marks`，全库唯一实现）
 
@@ -28,8 +32,10 @@ from typing import Dict, List, Optional, Tuple
 
 from sqlalchemy import func, or_
 
-from app.models import VoucherDetail
-from app.utils.bep_caliber import CLOSING_SUMMARY_LIKE, caliber_or_none
+from app.models import ImportLog, VoucherDetail
+from app.utils.bep_caliber import (CLOSING_SUMMARY_LIKE, caliber_or_none,
+                                   finance_income_terms as cal_finance_income_terms,
+                                   fixed_cost_spec)
 from app.utils.voucher_guard import apply_voucher_guard
 
 # ── 展示口径 ────────────────────────────────────────────────────────────────
@@ -166,14 +172,16 @@ def revenue_terms(cal: dict) -> list:
 
 
 def fixed_cost_terms(cal: dict) -> Tuple[list, str]:
-    """固定成本科目项：优先 `fixed_terms`（带号项），否则由 `fixed_filters` 派生（前缀 + 借−贷净额）。
+    """固定成本科目项：**经 `bep_caliber.fixed_cost_spec()` 唯一解析口**。
 
+    优先 `fixed_terms`（带号项，§4-1 后博海形态：仅借方），否则由 `fixed_filters` 派生
+    （前缀 + 借−贷净额，酣客形态）。
     返回 (terms, mode)；mode 供报表标注当前口径形态（`fixed_terms` / `fixed_filters(net)`）。
     """
-    terms = cal.get("fixed_terms")
-    if terms:
-        return [tuple(t) for t in terms], "fixed_terms"
-    derived = [("+", str(code) + "%", "net") for _kind, code in (cal.get("fixed_filters") or [])]
+    mode, spec = fixed_cost_spec(cal)
+    if mode == "terms":
+        return [tuple(t) for t in spec], "fixed_terms"
+    derived = [("+", str(code) + "%", "net") for _kind, code in spec]
     return derived, "fixed_filters(net)"
 
 
@@ -224,6 +232,7 @@ def compute_lines(db, entity_id: int, period_from: str, period_to: str) -> dict:
     exclude_closing = bool(cal.get("exclude_closing"))
     fix_terms, fix_mode = fixed_cost_terms(cal)
     rev_terms = revenue_terms(cal)
+    fin_terms = cal_finance_income_terms(cal)
     out["caliber"] = {
         "entity_id": entity_id,
         "name": cal.get("name"),
@@ -233,6 +242,7 @@ def compute_lines(db, entity_id: int, period_from: str, period_to: str) -> dict:
         "varcost_terms": [list(t) for t in (cal.get("varcost_terms") or [])],
         "fixed_cost_terms": [list(t) for t in fix_terms],
         "fixed_mode": fix_mode,
+        "finance_income_terms": [list(t) for t in fin_terms],
         "exclude_closing": exclude_closing,
         "closing_subject": cal.get("closing_subject"),
         "digest": caliber_digest(cal),
@@ -248,6 +258,10 @@ def compute_lines(db, entity_id: int, period_from: str, period_to: str) -> dict:
     var = sum_terms(db, entity_id, period_from, period_to, cal.get("varcost_terms") or [],
                     exclude_closing=exclude_closing)
     fix = sum_terms(db, entity_id, period_from, period_to, fix_terms, exclude_closing=exclude_closing)
+    # 财务收益（§4-1：博海 6603 贷方）—— 单列备查，**不进**固定成本/末行，不参与勾稽
+    fin = (sum_terms(db, entity_id, period_from, period_to, fin_terms,
+                     exclude_closing=exclude_closing) if fin_terms
+           else {"total_yuan": 0.0, "parts": []})
 
     rev_y = rev["total_yuan"]
     var_y = var["total_yuan"]
@@ -255,7 +269,8 @@ def compute_lines(db, entity_id: int, period_from: str, period_to: str) -> dict:
     con_y = rev_y - var_y          # 边际贡献
     res_y = con_y - fix_y          # 末行（营业利润）
 
-    out["rows"] = {"revenue": rev, "variable_cost": var, "fixed_cost": fix}
+    out["rows"] = {"revenue": rev, "variable_cost": var, "fixed_cost": fix,
+                   "finance_income": fin}
     out["raw_yuan"] = {"revenue": round(rev_y, 2), "variable_cost": round(var_y, 2),
                        "contribution": round(con_y, 2), "fixed_cost": round(fix_y, 2),
                        "result": round(res_y, 2)}
@@ -265,10 +280,39 @@ def compute_lines(db, entity_id: int, period_from: str, period_to: str) -> dict:
                      "contribution": round(con_y / YUAN_PER_WAN, ROUND_DP),
                      "fixed_cost": round(fix_y / YUAN_PER_WAN, ROUND_DP),
                      "result": round(res_y / YUAN_PER_WAN, ROUND_DP)}
+    out["finance_income"] = {
+        "value": round(fin["total_yuan"] / YUAN_PER_WAN, ROUND_DP),
+        "raw_yuan": round(fin["total_yuan"], ROUND_DP),
+        "terms": fin["parts"], "unit": UNIT,
+        "name": "财务收益（单列备查）",
+        "basis": ("ENTITY_CALIBERS[entity]['finance_income_terms']（§4-1：6603 贷方 = 现金折扣收益等）"
+                  "；单列备查，不进固定成本、不参与勾稽"),
+    }
     out["available"] = True
     return out
 
 
+def import_batches(db, entity_id: int, period: str, limit: int = 5) -> list:
+    """数据批次 / 导入时刻（**纯展示备注**，4-5）—— 不参与任何计算。
+
+    取自 `import_logs`（该账套 + 该期间），倒序最多 `limit` 条：批次号 / 行数 / 导入时刻。
+    无记录 ⇒ 空列表（页面不显示备注，不编造批次）。
+    """
+    try:
+        rows = (db.query(ImportLog)
+                  .filter(ImportLog.entity_id == entity_id, ImportLog.period == period)
+                  .order_by(ImportLog.id.desc()).limit(limit).all())
+    except Exception:  # noqa: BLE001 —— 展示项：取数失败不得影响报表主体
+        return []
+    return [{"batch": r.batch,
+             "rows": int(r.success_rows if r.success_rows is not None else (r.total_rows or 0)),
+             "total_rows": int(r.total_rows or 0),
+             "failed_rows": int(r.failed_rows or 0),
+             "import_type": r.import_type,
+             "imported_at": r.created_at.strftime("%Y-%m-%d %H:%M") if r.created_at else None,
+             "filename": r.filename} for r in rows]
+
+
 def reconcile(revenue: Optional[float], variable_cost: Optional[float],
               fixed_cost: Optional[float], result: Optional[float],
               tol: float = RECON_TOL_WAN) -> dict:
@@ -358,7 +402,10 @@ def build_items(cur: dict, prev: dict, bottom_label: str = BOTTOM_LABEL) -> list
          "ratio": ratio_of("fixed_cost", cv),
          "raw_yuan": raw("fixed_cost"), "prev_raw_yuan": raw_prev("fixed_cost"),
          "terms": terms_of("fixed_cost", cur), "prev_terms": terms_of("fixed_cost", prev),
-         "unit": UNIT, "basis": "ENTITY_CALIBERS[entity]['fixed_terms'|'fixed_filters']（借−贷净额）"},
+         "unit": UNIT,
+         "basis": ("ENTITY_CALIBERS[entity] 经 bep_caliber.fixed_cost_spec() 解析："
+                   "fixed_terms=带号科目项（§4-1 博海 6601/6602/6603 仅借方）/ "
+                   "fixed_filters=前缀借−贷净额（酣客 5601/5602/5603）")},
         {"name": f"＝ {bottom_label}", "line_key": "operating_profit", "is_total": True,
          "value": cv.get("result"), "prev_value": pv.get("result"),
          "change_rate": _calc_chg(cv.get("result"), pv.get("result")),