G7-5 双指标读数口径定义 v1（经营语言×4 + 灵魂语言×4 · 2026-09-16 00:3x 小冈）

判据来源：G7 判据清单 G7-5「双指标可复核：经营语言/灵魂语言 8 项有定义+数据源+阈值」（docs/plans/2026-09-15-G7用户价值门-v1草案.md §三，责任席=小齐+小冈）；指标本体=《产品原则 v2》§四 双指标读数（docs/plans/2026-09-14-产品原则-用户价值与不可售卖清单.md L34-37：只读一组都会看错）。
本文范围：定义/计算公式（字段级）/数据源端点或表/观察窗口/当前可得性。阈值不在本文（见总则 5）。
诚实声明：数据源不足的项如实标「需埋点/需新端点」，不编造字段、不拿近似表充数；连表都没有的项写明「需建表」。

一、口径总则（8 项通用）

  1. 测试数据隔离：所有读数 WHERE is_test = FALSE（staging dev 数据默认 is_test=TRUE 自动出局；无 is_test 列的表接入读数前须补列——health_records 已有此教训，WIP-178 验收记档）。
  2. 目的地维度：读数默认带 destination 维度（D2 契约 §3：隔离域表查询必须带 destination_id 过滤），平台总读数=各目的地汇总。已知结构缺口：analytics_events 无 destination_id（WIP-352 R1 待裁：加字段 or 明定平台级全局数据）——裁决前涉该表读数只能出平台级。
  3. 金额单位：库内分（*_fen），读数出口统一元（2 位小数）；福钥抵扣（key_deduct_fen）单列，不计入现金回款。
  4. 时间口径：库内 TIMESTAMPTZ（UTC），读数展示按 Asia/Shanghai 自然日切窗；观察窗口默认三档=当日/近7日/近30日，旺季窗口（国庆闸门期，原则 §六）按需启用。
  5. 阈值：G7-5 判据要求「定义+数据源+阈值」三件齐——本文只交付前两件；阈值属产品决策，全部「待拍板（刘总）」，候选值不编造。按 G7 门禁四态，阈值缺失=BLOCKED，不得冒充 PASS ⇒ 本文交付后 G7-5 现状仍为 BLOCKED（缺阈值 + 5 项需埋点 + 聚合读数未落地）。
  6. 记录分离（原则纪律 9）：凡涉「平台判断」的读数（如可信）必须区分系统事实/一方陈述/平台判断字段，不混算。

二、经营语言（防猝死）

1. 回款

项内容
定义观察窗口内平台实际收到的现金：1P 线上支付成功 + 3P 线下确认到账 + 服务费记账 + 订阅收款确认；福钥抵扣不计现金
计算公式（字段级）毛回款(分) = Σ orders.total_fen WHERE paid_at IS NOT NULL AND status NOT IN ('refunded') AND is_test=FALSE AND paid_at ∈ 窗口 ＋ Σ service_fee_records.amount_fen WHERE created_at ∈ 窗口 AND is_test=FALSE ＋ Σ 订阅确认 paidFen；净回款 = 毛回款 − 退款冲减（⚠️ 退款金额当前为规则试算、orders 无退款金额列——净额精确口径需退款流水表）
数据源表：orders（008/025：total_fen / key_deduct_fen / paid_at / status）、service_fee_records（049：amount_fen / created_at / is_test）；端点：GET /api/miniapp/admin/distribution/overview（仅佣金面 settleable/settledTotal）、GET /api/miniapp/admin/orders（admin_backend，已接目的地隔离）、POST /service-fee/record
观察窗口当日 / 近7日 / 近30日 + 旺季窗口
当前可得性需新端点——底层数据已有（订单域+服务费域表在位），无统一「回款聚合」读端点；净回款还需退款流水（需埋点子项）
阈值待拍板

2. 成本

项内容
定义观察窗口内平台为履约与运营付出的直接成本（科目待定义：物料/运输/保险/获客等），用于「回款−成本」生存判断
计算公式（字段级）待定——依赖成本科目表设计，字段级公式须先有表才能写（不编造）
数据源无——全库无成本科目表/端点（quotes 系商户报价非平台成本，不充数）
观察窗口月度（经营复盘节奏）
当前可得性需埋点（且需建表+录入端点——比常规埋点重一层，如实标注）
阈值待拍板

3. 采用

项内容
定义真实使用度。B端子口径=近7日活跃主理人商户数（登录+关键写动作）；C端子口径=关键漏斗到达人数（page_view→order_submit）。禁止用注册数冒充采用数
计算公式（字段级）B端 = COUNT(DISTINCT user_id) FROM analytics_events WHERE event_category='merchant' AND created_at ≥ now()-interval '7d' AND is_test=FALSE；C端 = 漏斗各级 COUNT(DISTINCT user_id) WHERE event_name IN (…)（事件清单待定义）
数据源analytics_events（056：event_name / event_category / user_id / created_at / is_test）+ POST /api/miniapp/admin/track/event（匿名可写）；🔴 C端/B端前端均未接线 track/event（miniprogram 与 b-workbench 全库零调用），事件清单未定义
观察窗口周活跃（近7日滚动）
当前可得性需埋点——表与采集端点在位，缺前端接线+事件清单，两件齐才能出数
阈值待拍板

4. 覆盖

项内容
定义「全量先指覆盖范围，不伪装全量已核实」（原则纪律 5）的量化。子口径A 覆盖广度=在售服务对品类/目的地的覆盖；子口径B 内容核实率=信息条目含来源+核验日期+适季的比例
计算公式（字段级）A = COUNT(DISTINCT packages.type WHERE status='active' AND destination_id=X) / 11（品类全集=packages.py VALID_TYPES）；B = COUNT(条目 WHERE verified_at IS NOT NULL) / COUNT(*)——🔴 内容表（site_texts 仅 page/key/value/updated_at 等，064）无 source/verified_at/season 字段，B 公式字段不存在
数据源packages（005，含 destination_id）、GET /api/miniapp/admin/destinations（merchantCount/orderCount 计数）、site_texts（064）
观察窗口季度复核（适季项按季滚动）
当前可得性A=已有端点（计数可出）；B=需埋点（内容表加 source/verified_at/season 列+存量回填=D5 判据落地，属加列迁移级）
阈值待拍板

三、灵魂语言（防空心）

5. 完成

项内容
定义服务兑现度。子口径A 订单完成率=完成单/应履约单（排除未支付即死单，防分母虚增）；子口径B 转山完成=完成证书签发数（「成就对世界」，原则纪律 3）
计算公式（字段级）A = COUNT(orders WHERE status='completed' AND completed_at ∈ 窗口) / COUNT(orders WHERE created_at ∈ 窗口 AND status NOT IN ('pending_payment','cancelled'))——按创建 cohort 算（同窗完成率会被在途单稀释，口径先冻结）；B = COUNT(scene_certificates WHERE issued_at ∈ 窗口 AND is_test=FALSE)
数据源orders（008/025/057 状态机 10 态：completed / completed_at / cancelled）、GET /api/miniapp/admin/orders（已接隔离）；scene_certificates（038：issued_at / is_test）+ GET /scenes/certificate
观察窗口按创建 cohort 月度 + 旺季专项
当前可得性已有端点（两子口径数据面均在位，脚本可算；聚合读数端点可选）
阈值待拍板

6. 分享

项内容
定义「增长不在回头、在传出去」（原则 §二第五步）的行为读数：分享动作数 +（远期）分享回流（带参新客）
计算公式（字段级）COUNT(analytics_events WHERE event_name='share' AND created_at ∈ 窗口 AND is_test=FALSE)——🔴 share 事件未定义、前端 onShareAppMessage 未上报、回流参数无记录
数据源analytics_events 结构可承载（event_name + properties JSONB 自由扩展），但事件定义/上报/回流三件全缺
观察窗口周
当前可得性需埋点
阈值待拍板

7. 公平

项内容
定义机会分配可解释且不内卷（原则纪律 3「炫耀可以攀比不行」+ 深挖2 曝光分配规则 + 深挖5 可解释的机会分配）。读数=商户间曝光分布均衡度（如 Top-N 份额）
计算公式（字段级）待事件流——COUNT(impressions by merchant) / Σ → 份额分布；🔴 曝光/排序无任何日志表（recommendations / feed 端点不打 impression），公式字段不存在
数据源无曝光日志表。注：R3 已验证「现网无竞价机制（非竞价排序冻结）」= 公平底线已成立，但底线成立≠可测
观察窗口月
当前可得性需埋点（曝光事件流先建，均衡度公式后置——勿先造公式后凑数）
阈值待拍板

8. 可信

项内容
定义「说的可信」：评价真实（带凭证+内容安全通过）、纠纷处置、退款履约。记录分离：评价内容=一方陈述，security_passed/status=平台判断，order 关联=系统事实
计算公式（字段级）①评价凭证率 = COUNT(reviews WHERE order_id IS NOT NULL) / COUNT(reviews)——结构保证=100%（reviews.order_id NOT NULL + UNIQUE(order_id,user_id)，015），该子读数意义=防未来放松约束的回归哨兵；②评价通过率 = COUNT(reviews WHERE status='approved' AND security_passed=TRUE) / COUNT(reviews)；③纠纷率 = COUNT(merchant_bills WHERE disputed_at IS NOT NULL) / COUNT(merchant_bills WHERE created_at ∈ 窗口)；④退款率 = COUNT(orders WHERE status IN ('refunded','partial_refunded')) / COUNT(orders WHERE paid_at IS NOT NULL)（精确金额口径同「回款」注）
数据源reviews（015：order_id / status / security_passed / created_at）+ GET /api/miniapp/reviews、review_center；merchant_bills（030：disputed_at / dispute_reason）；orders
观察窗口月
当前可得性已有端点（数据面在位可算；聚合读数端点可选）。注：G7 R1「评价写入无购买凭证校验」系 09-15 评审结论——与 015 结构（order_id NOT NULL）的关系以 G7-4 负向测试当时代码复核为准，本文不替其结案
阈值待拍板

四、可得性总账与 G7-5 现状

#指标组可得性一句话卡点
1回款经营需新端点底层数据在，缺聚合读端点；净额需退款流水
2成本经营需埋点（需建表）连表都没有
3采用经营需埋点表在、前端零接线+事件清单未定义
4覆盖经营A 已有端点 / B 需埋点B 缺 source/verified_at/season 列
5完成灵魂已有端点orders+scene_certificates 可算
6分享灵魂需埋点事件定义/上报/回流三件全缺
7公平灵魂需埋点（需建曝光流）无 impression 日志
8可信灵魂已有端点reviews/bills/orders 可算

G7-5 现状=BLOCKED（按 G7 门禁四态，不冒充 PASS）：阈值 8/8 待拍板 + 5 项需埋点 + 聚合读数未落地。

放行路径（建议序）：

  1. 刘总拍 8 项阈值（可分批：先拍「已有端点」3 项）；
  2. 回款/完成/可信三个「数据已在」项先出读数脚本，挂入 G7 gate 脚本（对位 WIP-352 ② G7 gate 脚本接入，V 系聚合）；
  3. 埋点清单派工：track/event 前端接线+事件清单（采用/分享共用）、内容表加列（覆盖B）、曝光流（公平）、成本表（成本）；
  4. 隔离归属注记：track/event 归属（豁免 vs 加列）R1 待裁中（WIP-352 回执）——裁决前涉该表读数只出平台级，不阻断埋点接线本身。

—— 小冈 2026-09-16 00:3x（G7-5 口径定义件 v1；公式字段均已对 2026-09-16 当前库结构核实；引用表/端点若后续迁移变更，以当时代码为准修订本文）