优化：完善广告收益看板展示与导航体验

2026-07-26 19:42:50 +08:00
5 changed files with 101 additions and 152 deletions
@@ -82,20 +82,12 @@ const PLAYBACK_STATUS_TAG: Record<string, { color: string; label: string }> = {
  unknown: { color: 'default', label: '未知' },
 };

-const ZERO_REVENUE_REWARD_VIDEO_STATUSES = new Set(['closed_early', 'too_short']);
-
 function rewardStatuses(row: AdRevenueRow): string[] {
  if (row.sub_rewards?.length) return row.sub_rewards.map((reward) => reward.status);
  return row.status ? [row.status] : [];
 }

 function effectiveRevenueYuan(row: AdRevenueRow): number {
-  if (
-    row.ad_type === 'reward_video'
-    && rewardStatuses(row).some((status) => ZERO_REVENUE_REWARD_VIDEO_STATUSES.has(status))
-  ) {
-    return 0;
-  }
  return row.row_revenue_yuan ?? row.revenue_yuan;
 }

@@ -196,39 +188,22 @@ type AdRevenueDetailRow = AdRevenueRecord & {
  is_impression_only?: boolean;
 };

-const FORMULA_EMPTY_STATUS_LABEL: Record<string, string> = {
-  capped: '次数超限',
-  ecpm_missing: 'eCPM 缺失',
-  too_short: '观看时长不足',
-  closed_early: '提前关闭',
-  impression_only: '仅展示',
-};
-
-// 未发奖记录用可读状态代替空值，避免误认为数据丢失；悬停时说明为何没有计算因子。
+// 未发奖记录保留「-」以避免把潜在奖励误读为实际计算结果；悬停时说明为何没有因子。
 function renderFormulaValue(value: string | number, row: AdRevenueDetailRow) {
-  if (value !== '-') return value;
-  const isGrantedButMissing = row.status === 'granted';
-  const reason = isGrantedButMissing
-    ? '该记录标记为已发奖，但计算因子缺失，需要进一步排查'
-    : row.is_impression_only
-      ? '该记录只有广告展示，没有对应发奖记录'
-      : REWARD_STATUS_HINT[row.status] ?? `发奖状态为 ${row.status || '未知'}`;
-  const statusLabel = isGrantedButMissing
-    ? '计算数据缺失'
-    : (FORMULA_EMPTY_STATUS_LABEL[row.status] ?? row.status) || '未进入计算';
+  if (value !== '-' || row.status === 'granted') return value;
+  const reason = row.is_impression_only
+    ? '该记录只有广告展示，没有对应发奖记录'
+    : REWARD_STATUS_HINT[row.status] ?? `发奖状态为 ${row.status}`;
  return (
-    <Tooltip
-      title={isGrantedButMissing
-        ? reason
-        : `${reason}；未进入金币计算，不占用 LT 累计条数，因此不展示因子。`}
-    >
-      <span>{statusLabel}</span>
+    <Tooltip title={`${reason}；未进入金币计算，不占用 LT 累计条数，因此不展示因子。`}>
+      <span>-</span>
    </Tooltip>
  );
 }

 function impressionOnlyDetail(row: AdRevenueRow): AdRevenueDetailRow {
  return {
+    // 每个展开表只有这一条纯展示明细，使用稳定的本行唯一键即可。
    record_id: 0,
    created_at: row.created_at,
    status: 'impression_only',
@@ -278,36 +253,36 @@ const DETAIL_COLUMNS: ColumnsType<AdRevenueDetailRow> = [
    title: '因子1',
    dataIndex: 'ecpm_factor',
    width: 70,
-    render: (v: number | null, row: AdRevenueDetailRow) => renderFormulaValue(v ?? '-', row),
+    render: (v: number | null, r: AdRevenueDetailRow) => renderFormulaValue(v ?? '-', r),
  },
  {
    title: '因子2',
    key: 'lt_factor',
    width: 90,
-    render: (_: unknown, row: AdRevenueDetailRow) =>
-      renderFormulaValue(fmtFactorRange(row.lt_factor_start, row.lt_factor_end), row),
+    render: (_: unknown, r: AdRevenueDetailRow) =>
+      renderFormulaValue(fmtFactorRange(r.lt_factor_start, r.lt_factor_end), r),
  },
  {
    title: 'LT累计条数',
    key: 'lt_index',
    width: 100,
-    render: (_: unknown, row: AdRevenueDetailRow) =>
-      renderFormulaValue(fmtIndexRange(row.lt_index_start, row.lt_index_end), row),
+    render: (_: unknown, r: AdRevenueDetailRow) =>
+      renderFormulaValue(fmtIndexRange(r.lt_index_start, r.lt_index_end), r),
  },
 ];

 // 趋势图(纯 SVG,零依赖):柱=展示条数(左轴),橙线=客户端预估收益元(右轴),
-// 绿线=穿山甲后台预估收益元(右轴,仅按天且有数据时出现)。x 轴按传入点序。
+// 绿线=GroMore 排序价预估元(右轴,仅按天且有数据时出现)。x 轴按传入点序。
 const CHART_BAR = '#69b1ff';
 const CHART_LINE = '#fa8c16';
-const CHART_LINE2 = '#52c41a'; // 穿山甲后台收益线
+const CHART_LINE2 = '#52c41a'; // GroMore 排序价预估线

 interface TrendPoint {
  label: string; // x 轴刻度文案(小时数 / MM-DD)
  tip: string; // hover 原生 tooltip 全文
  impressions: number;
  revenue: number;
-  pangleRevenue: number | null; // 穿山甲后台预估收益(元);无则 null(不画绿线点)
+  pangleRevenue: number | null; // GroMore 排序价预估(元);无则 null(不画绿线点)
 }

 // 按小时聚合(0–23),数据源是 hourly(后端全量聚合,不受分页影响)。穿山甲为天级,小时视图无该线。
@@ -328,7 +303,7 @@ function aggregateHourly(rows: AdRevenueHourly[]): TrendPoint[] {
 }

 // 按天聚合,数据源是 daily(全量,不受 limit 影响);用 from..to 补齐空缺日为 0,轴连续。
-// 穿山甲收益(pangle_revenue_yuan)为 null 时该日不画绿线点(T+1 未出/非全量视图)。
+// GroMore 排序价预估(pangle_revenue_yuan)为 null 时该日不画绿线点(T+1 未出/非全量视图)。
 function aggregateDaily(dateFrom: string, dateTo: string, daily: AdRevenueDaily[]): TrendPoint[] {
  const map = new Map(daily.map((d) => [d.date, d]));
  const out: TrendPoint[] = [];
@@ -417,7 +392,7 @@ function TrendChart({ points }: { points: TrendPoint[] }) {
          <title>{p.tip}</title>
        </circle>
      ))}
-      {/* 穿山甲后台收益线(绿,仅非 null 的天画;按天且已同步 T+1 数据时出现) */}
+      {/* GroMore 排序价预估线(绿,仅非 null 的天画;按天且已同步 T+1 数据时出现) */}
      {(() => {
        const pp = points
          .map((p, i) => ({ i, v: p.pangleRevenue, tip: p.tip }))
@@ -631,7 +606,6 @@ export default function AdRevenueReportPage() {
      width: 110,
      align: 'right',
      // 一次比价/领券聚合行用 row_revenue_yuan(该次发奖广告 eCPM 折算之和),其它行用展示侧 revenue_yuan
-      // 激励视频提前关闭/时长不足时防御性显示 0，与后端有效收益口径一致。
      render: (_v: number, r: AdRevenueRow) => effectiveRevenueYuan(r).toFixed(4),
    },
    {
@@ -710,6 +684,8 @@ export default function AdRevenueReportPage() {
  // 应发实发差额(金币)= 应发−实发(正=少发/负=多发);ARPU = 区间预估收益÷区间活跃用户(见 dau)。
  const derived = data
    ? {
+        // ADN Reporting API 只覆盖已配置回传的广告源，不能据此推导全量 ARPU / 毛利。
+        // 在接入最终结算单前，核心经营指标始终使用 SDK 展示预估，并明确标注其性质。
        payoutYuan: data.total_actual_coin / COIN_PER_YUAN,
        grossProfit: data.total_revenue_yuan - data.total_actual_coin / COIN_PER_YUAN,
        payoutRatioPct:
@@ -717,7 +693,6 @@ export default function AdRevenueReportPage() {
            ? (data.total_actual_coin / COIN_PER_YUAN / data.total_revenue_yuan) * 100
            : null,
        coinGap: data.total_expected_coin - data.total_actual_coin,
-        // ARPU = 区间预估广告收益 ÷ 区间去重活跃用户(dau,口径同数据大盘);dau 为 0 时不可算 → null,显示「-」。
        arpu: data.dau && data.dau > 0 ? data.total_revenue_yuan / data.dau : null,
      }
    : null;
@@ -734,19 +709,15 @@ export default function AdRevenueReportPage() {
        : data.date_from
      : `${data.date_from} ~ ${data.date_to}`;

-  // 第二行大盘「分广告类型」：看视频包含福利视频与提现视频；
-  // eCPM 使用合并后的总收益 ÷ 总展示数 × 1000，避免只读取 reward_video 而漏算提现视频。
-  const drawStat = data?.type_stats?.draw;
-  const rewardVideoStat = data?.type_stats?.reward_video;
-  const withdrawalVideoStat = data?.type_stats?.withdrawal_video;
-  const videoStat: AdRevenueTypeStat = {
-    impressions:
-      (rewardVideoStat?.impressions ?? 0) + (withdrawalVideoStat?.impressions ?? 0),
-    revenue_yuan:
-      (rewardVideoStat?.revenue_yuan ?? 0) + (withdrawalVideoStat?.revenue_yuan ?? 0),
-  };
-  const ecpmOf = (s?: AdRevenueTypeStat) =>
-    s && s.impressions > 0 ? (s.revenue_yuan / s.impressions) * 1000 : 0;
+  // 经营分类由后端统一：Draw = draw + 历史 feed；看视频 = 福利视频 + 提现视频。
+  // eCPM 同时按每次展示的 SDK 原始值加权，不能从前端漏项后再临时平均。
+  const drawStat = data?.category_stats?.draw;
+  const videoStat = data?.category_stats?.video;
+  const videoLabel = adType === 'withdrawal_video'
+    ? '提现看视频'
+    : adType === 'reward_video'
+      ? '福利看视频'
+      : '看视频（福利+提现）';

  // 明细直接用后端返回的当前页 items(「场景」已由后端 feed_scene 全局过滤,前端不再二次筛)。
  const items = data?.items ?? [];
@@ -785,14 +756,19 @@ export default function AdRevenueReportPage() {
              逐条展示不单独占行(其展示数 / eCPM / 预估收益已计入上方合计与大盘),点行左侧「+」展开看该次金币复算。
              <br />
              <br />
-              「预估收益」为客户端在广告展示(onAdShow)时上报 eCPM 折算的预估值(每千次展示 ÷1000
-              累加);<b>激励视频提前关闭或播放时长不足时按 0 计</b>,其他有效展示按 eCPM 折算。穿山甲仍可能过滤无效曝光,
-              <b>实际收益一律以穿山甲后台结算为准</b>。测试应用多为 0。「广告位ID / 来源应用」为本期新增,历史记录留空。
+              「客户端 SDK 展示预估」按广告展示(onAdShow)后端留存的 eCPM 折算(每千次展示 ÷1000
+              累加；不足 1 秒的异常曝光沿用采集规则记 0)。是否看满只影响金币发放；发奖防作弊的 eCPM 上限不参与收入计算。
+              <b>最终收入仍以各 ADN 结算单为准</b>。
              <br />
              <br />
-              核心指标里的<b>「穿山甲后台收益(T+1)」</b>来自穿山甲 GroMore 数据 API(后台结算口径,次日出数):
-              <b>穿山甲预估收益</b>=接口 revenue、<b>收益API</b>=各 ADN 回传更接近结算。穿山甲不提供分用户/类型/场景维度,
-              故仅在<b>可对账视图</b>(未按用户/类型/场景筛选)展示;环境和数据范围会同时作用于客户端与穿山甲汇总。
+              <b>GroMore 排序价预估</b>来自接口 revenue，只是排序价/竞价实时价估算，不是结算收入；
+              <b>ADN Reporting API 收益</b>来自已配置广告源的 api_revenue 回传；每天 14:00 后仅代表同步窗口完成，
+              不代表覆盖全部广告源或最终结算，因此不用于自动计算全量毛利和 ARPU。
+              <br />
+              <br />
+              分类卡口径：<b>Draw 信息流 = draw + 历史 feed</b>；<b>看视频 = 福利视频 + 提现视频</b>。
+              两者的 eCPM 都由后端按每次展示的 SDK eCPM 加权计算（eCPM 总和 ÷ 展示次数），不从分页明细或单一子类型取值。
+              GroMore 不提供分用户/类型/场景维度，故仅在<b>可对账视图</b>(未按用户/类型/场景筛选)展示。
              默认“正式 + 业务代码位”用于同口径对账;切到“全部代码位”会包含广告测试等非业务曝光。
            </div>
          }
@@ -937,16 +913,16 @@ export default function AdRevenueReportPage() {
          </Divider>
          <Row gutter={[16, 12]}>
            <Col flex="1 1 0">
-              <Statistic title="预估收益合计(元)" value={data.total_revenue_yuan} precision={4} />
+              <Statistic title="客户端 SDK 展示预估(元)" value={data.total_revenue_yuan} precision={4} />
            </Col>
            <Col flex="1 1 0">
              <Statistic
                title={
                  <Tooltip
-                    title={`每活跃用户广告预估收入 = 区间预估收益 ÷ 区间去重活跃用户(口径同数据大盘)。统计区间:${dauRangeLabel || '—'}`}
+                    title={`客户端 SDK 展示预估 ÷ 区间去重活跃用户。ADN Reporting API 可能只覆盖已配置回传的广告源，不能作为全量 ARPU。统计区间:${dauRangeLabel || '—'}`}
                  >
                    <span>
-                      {dauRangeIsToday ? 'ARPU(今日)' : 'ARPU'}
+                      SDK 预估 ARPU
                      <InfoCircleOutlined style={{ marginLeft: 4 }} />
                    </span>
                  </Tooltip>
@@ -975,7 +951,7 @@ export default function AdRevenueReportPage() {
            </Col>
            <Col flex="1 1 0">
              <Statistic
-                title="预估广告毛利(元)"
+                title="SDK 预估广告毛利(元)"
                value={derived.grossProfit}
                precision={4}
                prefix={derived.grossProfit >= 0 ? <RiseOutlined /> : <FallOutlined />}
@@ -988,9 +964,9 @@ export default function AdRevenueReportPage() {
            </Col>
          </Row>
          <Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
-            <Tooltip title="来自穿山甲 GroMore 数据 API(后台结算口径,T+1 次日出数)。穿山甲不提供分用户/类型/场景维度,故仅在「全量视图」(未按用户/类型/场景筛选)展示;按代码位×应用×日期汇总。revenue=预估收益、收益API=各 ADN 回传更接近结算。">
+            <Tooltip title="来自 GroMore 天级数据 API。revenue 是排序价/竞价实时价预估；api_revenue 是已配置 ADN 的 Reporting 回传收益。D+1 14:00 后仅表示 API 同步窗口完成，不代表全部广告源或最终结算。">
              <Typography.Text type="secondary" style={{ fontSize: 12 }}>
-                穿山甲后台收益(T+1)
+                GroMore / ADN 收益对账(T+1)
                <InfoCircleOutlined style={{ marginLeft: 4 }} />
              </Typography.Text>
            </Tooltip>
@@ -999,29 +975,41 @@ export default function AdRevenueReportPage() {
            <Row gutter={[16, 12]}>
              <Col flex="1 1 0">
                <Statistic
-                  title="穿山甲预估收益(元)"
+                  title="GroMore 排序价预估(元)"
                  value={data.total_pangle_revenue_yuan ?? 0}
                  precision={4}
                />
              </Col>
              <Col flex="1 1 0">
                <Statistic
-                  title="穿山甲收益API(元)"
+                  title="ADN Reporting API 收益(元)"
                  value={data.total_pangle_api_revenue_yuan ?? '-'}
                  precision={data.total_pangle_api_revenue_yuan == null ? undefined : 4}
                />
-                {data.total_pangle_api_revenue_yuan == null && (
+                {data.total_pangle_api_revenue_yuan == null ? (
                  <Typography.Text type="secondary" style={{ fontSize: 12 }}>
-                    未配 Reporting / 当天无
+                    未配置 Reporting、当天未出数或所选维度不可对账
+                  </Typography.Text>
+                ) : (
+                  <Typography.Text
+                    type={data.pangle_api_revenue_complete ? 'success' : 'warning'}
+                    style={{ fontSize: 12 }}
+                  >
+                    {data.pangle_api_revenue_complete
+                      ? '已完成 API 同步（不代表全量结算）'
+                      : '暂估，等待 14:30 API 同步'}
+                    {data.pangle_latest_synced_at
+                      ? ` · 同步于 ${formatUtcTime(data.pangle_latest_synced_at)}`
+                      : ''}
                  </Typography.Text>
                )}
              </Col>
              <Col flex="1 1 0">
                <Statistic
                  title={
-                    <Tooltip title="客户端预估相对穿山甲预估的高估幅度 =(客户端预估 − 穿山甲预估)÷ 穿山甲预估;客户端按 onAdShow 计、不滤无效曝光,通常偏高">
+                    <Tooltip title="客户端 SDK 展示预估相对 GroMore 排序价预估的差异；两者都是估算，只用于检查埋点和排序价口径，不代表结算差异">
                      <span>
-                        客户端预估偏差
+                        SDK / GroMore 预估差
                        <InfoCircleOutlined style={{ marginLeft: 4 }} />
                      </span>
                    </Tooltip>
@@ -1046,8 +1034,7 @@ export default function AdRevenueReportPage() {
            </Row>
          ) : (
            <Typography.Text type="secondary" style={{ fontSize: 13 }}>
-              本视图无穿山甲后台收益:仅「全量视图」(未按用户/类型/场景筛选)且对应日期已同步到数据时展示。
-              穿山甲 T+1 出数,可由 <Typography.Text code>scripts/sync_pangle_revenue</Typography.Text> 每日拉取入库。
+              本视图无 GroMore/ADN 对账收益：仅未按用户、类型、场景筛选且对应日期已同步时展示。
            </Typography.Text>
          )}
          <Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
@@ -1060,19 +1047,19 @@ export default function AdRevenueReportPage() {
              <Statistic title="Draw 信息流收益(元)" value={drawStat?.revenue_yuan ?? 0} precision={4} />
            </Col>
            <Col span={4}>
-              <Statistic title="Draw 信息流 eCPM(元/千次)" value={ecpmOf(drawStat)} precision={2} />
+              <Statistic title="Draw 信息流 eCPM(元/千次)" value={drawStat?.ecpm_yuan ?? 0} precision={2} />
            </Col>
            <Col span={4}>
              <Statistic title="Draw 信息流条数" value={drawStat?.impressions ?? 0} />
            </Col>
            <Col span={4}>
-              <Statistic title="看视频收益(元)" value={videoStat.revenue_yuan} precision={4} />
+              <Statistic title={`${videoLabel}收益(元)`} value={videoStat?.revenue_yuan ?? 0} precision={4} />
            </Col>
            <Col span={4}>
-              <Statistic title="看视频 eCPM(元/千次)" value={ecpmOf(videoStat)} precision={2} />
+              <Statistic title={`${videoLabel} eCPM(元/千次)`} value={videoStat?.ecpm_yuan ?? 0} precision={2} />
            </Col>
            <Col span={4}>
-              <Statistic title="看视频条数" value={videoStat.impressions} />
+              <Statistic title={`${videoLabel}条数`} value={videoStat?.impressions ?? 0} />
            </Col>
          </Row>
          <Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
@@ -1137,7 +1124,7 @@ export default function AdRevenueReportPage() {
                      verticalAlign: 'middle',
                    }}
                  />
-                  穿山甲后台收益(元)
+                  GroMore 排序价预估(元)
                </span>
              )}
            </Space>
@@ -1183,7 +1170,7 @@ export default function AdRevenueReportPage() {
                  columns={DETAIL_COLUMNS}
                  dataSource={r.sub_rewards.map((detail) => ({
                    ...detail,
-                    // 一次比价/领券可能由不同 ADN 连续填充，优先显示本条发奖记录的来源。
+                    // 一次比价/领券可能由不同 ADN 连续填充，必须优先显示本条发奖记录的来源。
                    source_adn: detail.adn ?? r.adn,
                  }))}
                  pagination={false}
@@ -1193,9 +1180,9 @@ export default function AdRevenueReportPage() {
              </div>
            ) : r.reward_detail ? (
              <div>
-                <Typography.Text strong>金币复算明细</Typography.Text>{' '}
+                <Typography.Text strong>本次广告逐条明细</Typography.Text>{' '}
                <Typography.Text type="secondary">
-                  (本条广告 应发 {r.reward_detail.expected_coin} / 实发 {r.reward_detail.actual_coin})
+                  (共 1 条 · 应发 {r.reward_detail.expected_coin} / 实发 {r.reward_detail.actual_coin})
                </Typography.Text>
                <Table<AdRevenueDetailRow>
                  style={{ marginTop: 8 }}
@@ -1213,9 +1200,7 @@ export default function AdRevenueReportPage() {
            ) : (
              <div>
                <Typography.Text strong>本次广告逐条明细</Typography.Text>{' '}
-                <Typography.Text type="secondary">
-                  (共 1 条 · 应发 0 / 实发 0；仅展示，未单独发奖)
-                </Typography.Text>
+                <Typography.Text type="secondary">(共 1 条 · 应发 0 / 实发 0；仅展示，未单独发奖)</Typography.Text>
                <Table<AdRevenueDetailRow>
                  style={{ marginTop: 8 }}
                  rowKey="record_id"
@@ -237,9 +237,9 @@ export default function ComparisonRecordsPage() {
      key: 'user',
      width: 140,
      render: (_, r) => (
-        <div style={{ color: '#1677ff' }}>
+        <div>
          <div>{r.phone || `#${r.user_id}`}</div>
-          {r.nickname && <div style={{ fontSize: 12 }}>{r.nickname}</div>}
+          {r.nickname && <div style={{ color: '#999', fontSize: 12 }}>{r.nickname}</div>}
        </div>
      ),
    },
@@ -298,14 +298,6 @@ export default function ComparisonRecordsPage() {
          <b style={{ color: r.saved_amount_cents > 0 ? '#3f8600' : '#999' }}>{yuan(r.saved_amount_cents)}</b>
        ),
    },
-    {
-      title: '是否下单',
-      dataIndex: 'ordered',
-      width: 84,
-      render: (ordered: boolean) => (
-        <Tag color={ordered ? 'green' : 'default'}>{ordered ? '已下单' : '未下单'}</Tag>
-      ),
-    },
    { title: 'LLM', dataIndex: 'llm_call_count', width: 56, render: (v) => v ?? '-' },
    {
      title: 'TOKEN',
@@ -122,31 +122,13 @@ const renderReview = (f: Feedback) => {

 // 机型 / OS版本(提交反馈时的端环境;改版前历史反馈无 → -)
 const renderDeviceOs = (f: Feedback) => {
-  const modelName = f.device_model_name || f.device_model;
-  const rawModel =
-    f.device_model_name && f.device_model_name !== f.device_model ? f.device_model : null;
-  const romHasVersion = /\d/.test(f.rom_name || '');
-  const vendorOs = [
-    f.rom_name,
-    f.rom_version && !romHasVersion ? f.rom_version : null,
-  ]
-    .filter(Boolean)
-    .join(' ');
-  const os = [
-    vendorOs || null,
-    f.android_version ? `Android ${f.android_version}` : null,
-  ]
+  const os = [f.android_version ? `Android ${f.android_version}` : null, f.rom_name]
    .filter(Boolean)
    .join(' · ');
-  if (!modelName && !os) return <Text type="secondary">-</Text>;
+  if (!f.device_model && !os) return <Text type="secondary">-</Text>;
  return (
    <Space direction="vertical" size={0}>
-      <Text>{modelName || '-'}</Text>
-      {rawModel ? (
-        <Text type="secondary" style={{ fontSize: 12 }}>
-          {[f.device_manufacturer, rawModel].filter(Boolean).join(' · ')}
-        </Text>
-      ) : null}
+      <Text>{f.device_model || '-'}</Text>
      {os ? (
        <Text type="secondary" style={{ fontSize: 12 }}>
          {os}
@@ -370,7 +352,7 @@ export default function FeedbacksPage() {
    {
      title: '机型 / OS版本',
      key: 'device',
-      width: 180,
+      width: 150,
      render: (_: unknown, f: Feedback) => renderDeviceOs(f),
    },
    {
@@ -91,7 +91,6 @@ const NAV_GROUPS: NavGroup[] = [
      { key: '/users', icon: <UserOutlined />, label: '用户管理' },
    ],
  },
-  { key: '/admins', icon: <TeamOutlined />, label: '权限管理' },
  {
    key: 'monitoring-audit',
    icon: <FileSearchOutlined />,
@@ -104,6 +103,7 @@ const NAV_GROUPS: NavGroup[] = [
      { key: '/audit-logs', icon: <FileSearchOutlined />, label: '审计日志' },
    ],
  },
+  { key: '/admins', icon: <TeamOutlined />, label: '权限管理' },
 ];

 // 导航项 key(/dashboard)→ 权限页 key(dashboard),与后端 permissions.py 目录对齐
@@ -223,7 +223,8 @@ export default function MainLayout({ children }: { children: React.ReactNode })
          position: 'sticky',
          top: 0,
          height: '100vh',
-          overflow: 'hidden',
+          overflowY: 'auto',
+          overflowX: 'hidden',
        }}
      >
        <nav className={`side-nav${collapsed ? ' side-nav-collapsed' : ''}`} aria-label="后台导航">
@@ -313,19 +314,8 @@ export default function MainLayout({ children }: { children: React.ReactNode })
        .side-nav {
          display: flex;
          flex-direction: column;
-          box-sizing: border-box;
          gap: 4px;
-          height: calc(100vh - 48px);
-          min-height: 0;
-          overflow-x: hidden;
-          overflow-y: auto;
-          overscroll-behavior: contain;
-          padding: 0 10px 20px;
-          scrollbar-gutter: stable;
-          -webkit-overflow-scrolling: touch;
-        }
-        .side-nav:focus-within {
-          scroll-behavior: smooth;
+          padding: 0 10px 14px;
        }
        .nav-group {
          padding: 6px 0 8px;
@@ -377,10 +377,7 @@ export interface Feedback {
  // 提交端环境快照:提交版本号 / 机型OS版本;改版前的历史反馈为 null
  app_version: string | null;
  device_model: string | null;
-  device_model_name: string | null;
-  device_manufacturer: string | null;
  rom_name: string | null;
-  rom_version: number | null;
  android_version: string | null;
  // 联表瞬态:展示完整手机号(点手机号查该用户全部反馈)
  phone: string | null;
@@ -449,7 +446,6 @@ export interface ComparisonRecordListItem {
  source_price_cents: number | null;
  best_price_cents: number | null;
  saved_amount_cents: number | null;
-  ordered: boolean;
  total_ms: number | null;
  step_count: number | null;
  llm_call_count: number | null;
@@ -546,8 +542,8 @@ export interface AdRevenueRecord {
  expected_coin: number;
  actual_coin: number;
  matched: boolean;
-  adn: string | null; // 本条发奖对应的实际填充 ADN
-  slot_id: string | null; // 本条发奖对应的底层 mediation rit
+  adn: string | null; // 本条发奖的实际填充 ADN（不能只取整场聚合父行）
+  slot_id: string | null; // 本条发奖的底层 mediation rit
 }

 // 广告收益报表:按日期汇总的一天(按天趋势图用;全量,不受分页影响)
@@ -555,8 +551,8 @@ export interface AdRevenueDaily {
  date: string; // 北京时间 YYYY-MM-DD
  impressions: number;
  revenue_yuan: number; // 客户端预估收益(eCPM 折算)
-  pangle_revenue_yuan: number | null; // 穿山甲后台预估收益(GroMore revenue);非全量视图/无数据为 null
-  pangle_api_revenue_yuan: number | null; // 穿山甲收益API(更接近结算);未配/当天/无数据为 null
+  pangle_revenue_yuan: number | null; // GroMore 排序价预估(revenue);非全量视图/无数据为 null
+  pangle_api_revenue_yuan: number | null; // ADN Reporting API 收益;未配/当天/无数据为 null
  expected_coin: number;
  actual_coin: number;
 }
@@ -570,10 +566,11 @@ export interface AdRevenueHourly {
  actual_coin: number;
 }

-// 广告收益报表:按广告类型(ad_type)的小计(展示条数 + 预估收益;eCPM 前端用 收益÷展示×1000 算)
+// 广告收益报表:展示条数、SDK 展示预估收益与按展示次数加权的 SDK eCPM。
 export interface AdRevenueTypeStat {
  impressions: number; // 该类型展示条数合计
  revenue_yuan: number; // 该类型预估收益合计(元)
+  ecpm_yuan: number; // 加权 SDK eCPM(元/千次)
 }

 // 广告收益报表:一次广告事件(逐条一行)。激励视频展示+发奖按 ad_session_id 合并;信息流展示/发奖各自成行。
@@ -592,10 +589,10 @@ export interface AdRevenueRow {
  has_impression: boolean; // 是否有广告展示(信息流逐条展示=true,纯发奖行=false)
  impressions: number; // 本行展示条数 1/0(供日汇总、趋势图复用)
  ecpm: string | null; // 分/千次;展示行取展示值,纯发奖行取发奖采用值
-  revenue_yuan: number; // 本次有效展示预估收益(元);纯发奖、激励视频提前关闭/时长不足=0
+  revenue_yuan: number; // 本次 SDK 展示预估收益(元);是否满足发奖条件不改变已产生的展示收入预估
  row_revenue_yuan?: number | null; // 主表逐行显示用:一次比价/领券聚合行=该次发奖广告 eCPM 折算之和;其它行空(回退 revenue_yuan)
-  adn: string | null; // 实际填充 ADN;纯发奖行为空
-  slot_id: string | null; // 底层 mediation rit;纯发奖行为空
+  adn: string | null; // 实际填充 ADN;历史或未上报展示来源为空
+  slot_id: string | null; // 底层 mediation rit;历史或未上报展示来源为空
  // ── 发奖侧 ──
  has_reward: boolean; // 是否有发奖(激励视频合并行/信息流整场发奖行=true;纯展示=false)
  status: string | null; // 发奖状态 granted/closed_early/…;纯展示为空
@@ -612,7 +609,8 @@ export interface AdRevenueReport {
  date_to: string; // 结束日 北京时间 YYYY-MM-DD(闭区间;单日时与 date_from 相同)
  daily: AdRevenueDaily[]; // 按日期汇总序列(全量,供按天趋势图)
  hourly: AdRevenueHourly[]; // 按小时汇总序列(全量,供按小时趋势图;按天查询时为空)
-  type_stats: Record<string, AdRevenueTypeStat>; // 按广告类型小计;前端取 draw / reward_video
+  type_stats: Record<string, AdRevenueTypeStat>; // 按原始广告类型小计
+  category_stats?: Record<string, AdRevenueTypeStat>; // draw=draw+历史feed；video=福利视频+提现视频（兼容后端滚动发布）
  // 按信息流场景小计(comparison/coupon/welfare;全量,不受分页截断)。数据大盘「领券广告/比价广告」卡
  // 优先读它:2026-07-02 后端起 items 不再含信息流逐条展示行(唯一带收益+场景的行),按 items 现算恒 0。
  // 可选(`?.` 探测)以兼容未升级后端,缺失时回退 items 现算。
@@ -627,10 +625,12 @@ export interface AdRevenueReport {
  total: number; // 当前筛选下的分页总条数(全量,不受分页影响)
  truncated: boolean; // 当前页之后是否还有更多事件(分页后前端不再据此报警)
  total_impressions: number;
-  total_revenue_yuan: number; // 客户端预估收益合计(eCPM 折算)
-  total_pangle_revenue_yuan: number | null; // 穿山甲后台预估收益合计(GroMore revenue);非全量视图/无数据为 null
-  total_pangle_api_revenue_yuan: number | null; // 穿山甲收益API合计(更接近结算);未配/当天/非全量视图为 null
-  pangle_revenue_available: boolean; // 本次结果是否带穿山甲后台收益(全量视图且已同步到数据)
+  total_revenue_yuan: number; // 客户端 SDK 展示预估合计(后端留存 eCPM 折算)
+  total_pangle_revenue_yuan: number | null; // GroMore 排序价预估合计(revenue);非全量视图/无数据为 null
+  total_pangle_api_revenue_yuan: number | null; // ADN Reporting API 收益合计;未配/当天/非全量视图为 null
+  pangle_api_revenue_complete: boolean; // 每一天均在 D+1 14:00 后完成 API 同步窗口，不代表全量结算
+  pangle_latest_synced_at: string | null; // GroMore 日报最近同步时间
+  pangle_revenue_available: boolean; // 本次结果是否带 GroMore/ADN 收益(全量视图且已同步到数据)
  total_expected_coin: number;
  total_actual_coin: number;
  mismatch_count: number; // 应发≠实发的发奖条数