修复：补齐纯展示广告明细类型字段

在纯展示明细中透传广告网络和广告位字段，满足 AdRevenueRecord 的必填类型要求，恢复生产构建。
优化用户反馈设备信息展示 (#85 )
2026-07-27 14:04:08 +08:00 · 2026-07-27 13:33:53 +08:00 · 2026-07-27 11:51:18 +08:00 · 2026-07-27 11:36:50 +08:00 · 2026-07-27 11:36:36 +08:00 · 2026-07-27 11:36:20 +08:00
5 changed files with 143 additions and 101 deletions
@@ -82,12 +82,20 @@ 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;
 }

@@ -188,22 +196,39 @@ 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 !== '-' || row.status === 'granted') return value;
-  const reason = row.is_impression_only
-    ? '该记录只有广告展示，没有对应发奖记录'
-    : REWARD_STATUS_HINT[row.status] ?? `发奖状态为 ${row.status}`;
+  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) || '未进入计算';
  return (
-    <Tooltip title={`${reason}；未进入金币计算，不占用 LT 累计条数，因此不展示因子。`}>
-      <span>-</span>
+    <Tooltip
+      title={isGrantedButMissing
+        ? reason
+        : `${reason}；未进入金币计算，不占用 LT 累计条数，因此不展示因子。`}
+    >
+      <span>{statusLabel}</span>
    </Tooltip>
  );
 }

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

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

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

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

 // 按天聚合,数据源是 daily(全量,不受 limit 影响);用 from..to 补齐空缺日为 0,轴连续。
-// GroMore 排序价预估(pangle_revenue_yuan)为 null 时该日不画绿线点(T+1 未出/非全量视图)。
+// 穿山甲收益(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[] = [];
@@ -392,7 +417,7 @@ function TrendChart({ points }: { points: TrendPoint[] }) {
          <title>{p.tip}</title>
        </circle>
      ))}
-      {/* GroMore 排序价预估线(绿,仅非 null 的天画;按天且已同步 T+1 数据时出现) */}
+      {/* 穿山甲后台收益线(绿,仅非 null 的天画;按天且已同步 T+1 数据时出现) */}
      {(() => {
        const pp = points
          .map((p, i) => ({ i, v: p.pangleRevenue, tip: p.tip }))
@@ -606,6 +631,7 @@ export default function AdRevenueReportPage() {
      width: 110,
      align: 'right',
      // 一次比价/领券聚合行用 row_revenue_yuan(该次发奖广告 eCPM 折算之和),其它行用展示侧 revenue_yuan
+      // 激励视频提前关闭/时长不足时防御性显示 0，与后端有效收益口径一致。
      render: (_v: number, r: AdRevenueRow) => effectiveRevenueYuan(r).toFixed(4),
    },
    {
@@ -684,8 +710,6 @@ 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:
@@ -693,6 +717,7 @@ 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;
@@ -709,15 +734,19 @@ export default function AdRevenueReportPage() {
        : data.date_from
      : `${data.date_from} ~ ${data.date_to}`;

-  // 经营分类由后端统一：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'
-      ? '福利看视频'
-      : '看视频（福利+提现）';
+  // 第二行大盘「分广告类型」：看视频包含福利视频与提现视频；
+  // 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;

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

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

 // 导航项 key(/dashboard)→ 权限页 key(dashboard),与后端 permissions.py 目录对齐
@@ -223,8 +223,7 @@ export default function MainLayout({ children }: { children: React.ReactNode })
          position: 'sticky',
          top: 0,
          height: '100vh',
-          overflowY: 'auto',
-          overflowX: 'hidden',
+          overflow: 'hidden',
        }}
      >
        <nav className={`side-nav${collapsed ? ' side-nav-collapsed' : ''}`} aria-label="后台导航">
@@ -314,8 +313,19 @@ export default function MainLayout({ children }: { children: React.ReactNode })
        .side-nav {
          display: flex;
          flex-direction: column;
+          box-sizing: border-box;
          gap: 4px;
-          padding: 0 10px 14px;
+          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;
        }
        .nav-group {
          padding: 6px 0 8px;
@@ -377,7 +377,10 @@ 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;
@@ -542,8 +545,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
 }

 // 广告收益报表:按日期汇总的一天(按天趋势图用;全量,不受分页影响)
@@ -551,8 +554,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; // ADN Reporting API 收益;未配/当天/无数据为 null
+  pangle_revenue_yuan: number | null; // 穿山甲后台预估收益(GroMore revenue);非全量视图/无数据为 null
+  pangle_api_revenue_yuan: number | null; // 穿山甲收益API(更接近结算);未配/当天/无数据为 null
  expected_coin: number;
  actual_coin: number;
 }
@@ -566,11 +569,10 @@ export interface AdRevenueHourly {
  actual_coin: number;
 }

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

 // 广告收益报表:一次广告事件(逐条一行)。激励视频展示+发奖按 ad_session_id 合并;信息流展示/发奖各自成行。
@@ -589,10 +591,10 @@ export interface AdRevenueRow {
  has_impression: boolean; // 是否有广告展示(信息流逐条展示=true,纯发奖行=false)
  impressions: number; // 本行展示条数 1/0(供日汇总、趋势图复用)
  ecpm: string | null; // 分/千次;展示行取展示值,纯发奖行取发奖采用值
-  revenue_yuan: number; // 本次 SDK 展示预估收益(元);是否满足发奖条件不改变已产生的展示收入预估
+  revenue_yuan: number; // 本次有效展示预估收益(元);纯发奖、激励视频提前关闭/时长不足=0
  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/…;纯展示为空
@@ -609,8 +611,7 @@ export interface AdRevenueReport {
  date_to: string; // 结束日 北京时间 YYYY-MM-DD(闭区间;单日时与 date_from 相同)
  daily: AdRevenueDaily[]; // 按日期汇总序列(全量,供按天趋势图)
  hourly: AdRevenueHourly[]; // 按小时汇总序列(全量,供按小时趋势图;按天查询时为空)
-  type_stats: Record<string, AdRevenueTypeStat>; // 按原始广告类型小计
-  category_stats?: Record<string, AdRevenueTypeStat>; // draw=draw+历史feed；video=福利视频+提现视频（兼容后端滚动发布）
+  type_stats: Record<string, AdRevenueTypeStat>; // 按广告类型小计;前端取 draw / reward_video
  // 按信息流场景小计(comparison/coupon/welfare;全量,不受分页截断)。数据大盘「领券广告/比价广告」卡
  // 优先读它:2026-07-02 后端起 items 不再含信息流逐条展示行(唯一带收益+场景的行),按 items 现算恒 0。
  // 可选(`?.` 探测)以兼容未升级后端,缺失时回退 items 现算。
@@ -625,12 +626,10 @@ export interface AdRevenueReport {
  total: number; // 当前筛选下的分页总条数(全量,不受分页影响)
  truncated: boolean; // 当前页之后是否还有更多事件(分页后前端不再据此报警)
  total_impressions: number;
-  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_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_expected_coin: number;
  total_actual_coin: number;
  mismatch_count: number; // 应发≠实发的发奖条数
Author	SHA1	Message	Date
linkeyu	6281ba81da	修复：补齐纯展示广告明细类型字段在纯展示明细中透传广告网络和广告位字段，满足 AdRevenueRecord 的必填类型要求，恢复生产构建。	2026-07-27 14:04:08 +08:00
linkeyu	10b82ad564	优化用户反馈设备信息展示 (#85 ) ## 改动说明 - 反馈列表优先展示可读手机型号 - 同时展示原始硬件编码与厂商信息 - 厂商系统版本和 Android 版本分层展示 ## 验证 - Next.js 生产构建通过 --------- Co-authored-by: linkeyu <798648091@qq.com> Reviewed-on: #85 Co-authored-by: linkeyu <linkeyu@wonderable.ai> Co-committed-by: linkeyu <linkeyu@wonderable.ai>	2026-07-27 13:33:53 +08:00
linkeyu	f76440cdbf	优化：将空计算因子显示为可读状态 (#82 ) ## 本次改动 - 因子1、因子2、LT累计条数为空时显示对应的可读发奖状态 - 支持“观看时长不足”“提前关闭”“次数超限”“eCPM 缺失”“仅展示”等状态 - 已发奖但计算字段异常缺失时显示“计算数据缺失” - 将纯展示事件统一为逐条明细表，避免空值被误认为数据丢失 ## 说明只改变后台展示，不改变金币公式、实发结果或 LT 累计规则。 ## 验证 TypeScript `--noEmit` 检查通过。 --------- Co-authored-by: linkeyu <798648091@qq.com> Reviewed-on: #82 Co-authored-by: linkeyu <linkeyu@wonderable.ai> Co-committed-by: linkeyu <linkeyu@wonderable.ai>	2026-07-27 11:51:18 +08:00
linkeyu	5373e3735c	优化比价记录用户信息显示颜色 (#83 ) ## 改动说明 - 比价记录列表中的手机号和用户名改为蓝色文本 - 保留原有整行点击行为，继续打开比价记录侧边栏 - 不新增用户详情页跳转 ## 验证 - TypeScript 类型检查通过 - 本地确认用户信息为蓝色且不包含详情页链接 --------- Co-authored-by: linkeyu <798648091@qq.com> Reviewed-on: #83 Co-authored-by: linkeyu <linkeyu@wonderable.ai> Co-committed-by: linkeyu <linkeyu@wonderable.ai>	2026-07-27 11:36:50 +08:00
linkeyu	590f59dee9	修复：看视频统计包含提现视频 (#79 ) ## 本次改动 - “看视频收益”合并福利视频与提现视频收益 - “看视频条数”合并两类视频展示记录 - “看视频 eCPM”按合并后的总收益和总展示数计算 ## 范围仅修改 `src/app/(main)/ad-revenue-report/page.tsx`；服务端已分别提供两类 `type_stats`，无需改动。 --------- Co-authored-by: guke <guke@wonderable.ai> Co-authored-by: linkeyu <798648091@qq.com> Reviewed-on: #79 Co-authored-by: linkeyu <linkeyu@wonderable.ai> Co-committed-by: linkeyu <linkeyu@wonderable.ai>	2026-07-27 11:36:36 +08:00
linkeyu	dd28307413	优化：修复侧栏滚动与权限管理位置 (#77 ) ## 本次改动 - 修复小屏时左侧导航无法滚动、末尾菜单不可见的问题 - 将“权限管理”调整至“监控审计”板块之前 ## 范围仅修改 `src/app/(main)/layout.tsx`。 --------- Co-authored-by: linkeyu <798648091@qq.com> Reviewed-on: #77 Co-authored-by: linkeyu <linkeyu@wonderable.ai> Co-committed-by: linkeyu <linkeyu@wonderable.ai>	2026-07-27 11:36:20 +08:00
linkeyu	c055cd705d	优化：完善广告收益顶部筛选默认值 (#78 ) ## 本次改动 - 类型和场景筛选增加明确的“全部”选项 - 将默认每页记录数从 1000 调整为 50 ## 范围仅修改 `src/app/(main)/ad-revenue-report/page.tsx`。 --------- Co-authored-by: linkeyu <798648091@qq.com> Reviewed-on: #78 Co-authored-by: linkeyu <linkeyu@wonderable.ai> Co-committed-by: linkeyu <linkeyu@wonderable.ai>	2026-07-27 11:36:10 +08:00
linkeyu	8d7f36ddac	修复：展示收益明细广告网络来源 (#81 ) ## 本次改动 - 展开聚合收益记录时优先展示每条明细自身的 ADN - 单条发奖明细同样读取明细级来源 - 无唯一来源证据的历史记录明确显示“未上报” ## 验证 TypeScript `--noEmit` 检查通过。依赖服务端 PR：WonderableAI/shaguabijia-app-server#179。 --------- Co-authored-by: linkeyu <798648091@qq.com> Reviewed-on: #81 Co-authored-by: linkeyu <linkeyu@wonderable.ai> Co-committed-by: linkeyu <linkeyu@wonderable.ai>	2026-07-27 10:24:12 +08:00