feat(config): 增加两套引导视频奖励配置

2026-07-27 15:14:47 +08:00
7 changed files with 144 additions and 277 deletions
@@ -9,6 +9,7 @@ import {
  Card,
  Col,
  DatePicker,
+  Descriptions,
  Divider,
  InputNumber,
  Modal,
@@ -42,8 +43,6 @@ import type {
 import UserAdRevenueDrawer from './UserAdRevenueDrawer';

 const { RangePicker } = DatePicker;
-const DEFAULT_PAGE_SIZE = 50;
-const ALL_FILTER_VALUE = '__all__';

 // 广告类型标签
 const TYPE_TAG: Record<string, { color: string; label: string }> = {
@@ -191,63 +190,7 @@ const LT_FACTOR_ROWS = [
  { key: '5', lt: '第 11 条及以后', factor: 1.0 },
 ];

-type AdRevenueDetailRow = AdRevenueRecord & {
-  source_adn?: string | null;
-  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) || '未进入计算';
-  return (
-    <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',
-    ecpm: row.ecpm,
-    ecpm_factor: null,
-    units: 0,
-    lt_index_start: null,
-    lt_index_end: null,
-    lt_factor_start: null,
-    lt_factor_end: null,
-    expected_coin: 0,
-    actual_coin: 0,
-    matched: true,
-    adn: row.adn,
-    slot_id: row.slot_id,
-    source_adn: row.adn,
-    is_impression_only: true,
-  };
-}
+type AdRevenueDetailRow = AdRevenueRecord & { source_adn?: string | null };

 // 展开行(逐条事件展开)- 该条的发奖复算明细(还原金币审计的 eCPM/因子1/份数/LT/因子2 等列)
 const DETAIL_COLUMNS: ColumnsType<AdRevenueDetailRow> = [
@@ -274,25 +217,18 @@ const DETAIL_COLUMNS: ColumnsType<AdRevenueDetailRow> = [
    render: (v: string | null) => (v == null || Number.isNaN(Number(v)) ? '-' : (Number(v) / 100 / 1000).toFixed(4)),
  },
  { title: '实发金币数', dataIndex: 'actual_coin', width: 100 },
-  {
-    title: '因子1',
-    dataIndex: 'ecpm_factor',
-    width: 70,
-    render: (v: number | null, row: AdRevenueDetailRow) => renderFormulaValue(v ?? '-', row),
-  },
+  { title: '因子1', dataIndex: 'ecpm_factor', width: 70, render: (v: number | null) => v ?? '-' },
  {
    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) => fmtFactorRange(r.lt_factor_start, r.lt_factor_end),
  },
  {
    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) => fmtIndexRange(r.lt_index_start, r.lt_index_end),
  },
 ];

@@ -460,13 +396,13 @@ export default function AdRevenueReportPage() {
  const [scene, setScene] = useState<string | undefined>();
  const [granularity, setGranularity] = useState<'day' | 'hour'>('day');
  const [sortBy, setSortBy] = useState<'time' | 'ecpm'>('time'); // 明细排序:time=时间倒序 / ecpm=eCPM 倒序
-  const [limit, setLimit] = useState<number>(DEFAULT_PAGE_SIZE);
+  const [limit, setLimit] = useState<number>(1000); // 默认拉满接口单页上限，供单次流程广告数分位统计
  const [page, setPage] = useState<number>(1); // 当前页码(后端分页;1 起)
  const [queriedGranularity, setQueriedGranularity] = useState<'day' | 'hour'>('day'); // 本次结果对应的粒度,决定是否显示「小时」列
  const [queriedMultiDay, setQueriedMultiDay] = useState(false); // 本次结果是否跨多天,决定显示「日期」列 + 按天/按小时图
  const [data, setData] = useState<AdRevenueReport | null>(null);
  const [allFlowItems, setAllFlowItems] = useState<AdRevenueRow[]>([]);
-  const [queriedLimit, setQueriedLimit] = useState<number>(DEFAULT_PAGE_SIZE);
+  const [queriedLimit, setQueriedLimit] = useState<number>(1000);
  const [loading, setLoading] = useState(false);
  const [formulaOpen, setFormulaOpen] = useState(false);
  // 点用户手机号弹出的「用户广告收益详情」半屏抽屉(userId + 手机号;null=关闭)
@@ -734,17 +670,9 @@ export default function AdRevenueReportPage() {
        : data.date_from
      : `${data.date_from} ~ ${data.date_to}`;

-  // 第二行大盘「分广告类型」：看视频包含福利视频与提现视频；
-  // eCPM 使用合并后的总收益 ÷ 总展示数 × 1000，避免只读取 reward_video 而漏算提现视频。
+  // 第二行大盘「分广告类型」:draw / 激励视频 各自 收益 / eCPM / 展示条数;eCPM = 收益÷展示×1000。
  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 rvStat = data?.type_stats?.reward_video;
  const ecpmOf = (s?: AdRevenueTypeStat) =>
    s && s.impressions > 0 ? (s.revenue_yuan / s.impressions) * 1000 : 0;

@@ -856,11 +784,12 @@ export default function AdRevenueReportPage() {
          <Space size={6}>
            <Typography.Text type="secondary">类型</Typography.Text>
            <Select
-              value={adType ?? ALL_FILTER_VALUE}
-              onChange={(value) => setAdType(value === ALL_FILTER_VALUE ? undefined : value)}
+              placeholder="全部"
+              value={adType}
+              onChange={setAdType}
+              allowClear
              style={{ width: 150 }}
              options={[
-                { value: ALL_FILTER_VALUE, label: '全部' },
                { value: 'reward_video', label: '看视频' },
                { value: 'draw', label: 'Draw 信息流' },
                { value: 'withdrawal_video', label: '提现看视频' },
@@ -870,11 +799,12 @@ export default function AdRevenueReportPage() {
          <Space size={6}>
            <Typography.Text type="secondary">场景</Typography.Text>
            <Select
-              value={scene ?? ALL_FILTER_VALUE}
-              onChange={(value) => setScene(value === ALL_FILTER_VALUE ? undefined : value)}
+              placeholder="全部"
+              value={scene}
+              onChange={setScene}
+              allowClear
              style={{ width: 130 }}
              options={[
-                { value: ALL_FILTER_VALUE, label: '全部' },
                { value: 'comparison', label: '比价' },
                { value: 'coupon', label: '领券' },
                { value: 'welfare', label: '福利' },
@@ -1066,13 +996,13 @@ export default function AdRevenueReportPage() {
              <Statistic title="Draw 信息流条数" value={drawStat?.impressions ?? 0} />
            </Col>
            <Col span={4}>
-              <Statistic title="看视频收益(元)" value={videoStat.revenue_yuan} precision={4} />
+              <Statistic title="看视频收益(元)" value={rvStat?.revenue_yuan ?? 0} precision={4} />
            </Col>
            <Col span={4}>
-              <Statistic title="看视频 eCPM(元/千次)" value={ecpmOf(videoStat)} precision={2} />
+              <Statistic title="看视频 eCPM(元/千次)" value={ecpmOf(rvStat)} precision={2} />
            </Col>
            <Col span={4}>
-              <Statistic title="看视频条数" value={videoStat.impressions} />
+              <Statistic title="看视频条数" value={rvStat?.impressions ?? 0} />
            </Col>
          </Row>
          <Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
@@ -1212,19 +1142,24 @@ export default function AdRevenueReportPage() {
              </div>
            ) : (
              <div>
-                <Typography.Text strong>本次广告逐条明细</Typography.Text>{' '}
-                <Typography.Text type="secondary">
-                  (共 1 条 · 应发 0 / 实发 0；仅展示，未单独发奖)
-                </Typography.Text>
-                <Table<AdRevenueDetailRow>
-                  style={{ marginTop: 8 }}
-                  rowKey="record_id"
-                  columns={DETAIL_COLUMNS}
-                  dataSource={[impressionOnlyDetail(r)]}
-                  pagination={false}
-                  size="small"
-                  scroll={{ x: 900 }}
-                />
+                <Typography.Text strong>展示明细</Typography.Text>{' '}
+                <Typography.Text type="secondary">(纯展示事件,未单独发奖,无金币复算)</Typography.Text>
+                <Descriptions size="small" column={3} bordered style={{ marginTop: 8 }}>
+                  <Descriptions.Item label="时间">{formatUtcTime(r.created_at)}</Descriptions.Item>
+                  <Descriptions.Item label="eCPM（分）">{r.ecpm ?? '-'}</Descriptions.Item>
+                  <Descriptions.Item label="eCPM（元）">
+                    {r.ecpm != null && !Number.isNaN(Number(r.ecpm))
+                      ? (Number(r.ecpm) / 100).toFixed(2)
+                      : '-'}
+                  </Descriptions.Item>
+                  <Descriptions.Item label="预估收益(元)">
+                    {r.has_impression ? r.revenue_yuan.toFixed(4) : '-'}
+                  </Descriptions.Item>
+                  <Descriptions.Item label="底层 ADN">{r.adn ?? '-'}</Descriptions.Item>
+                  <Descriptions.Item label="底层代码位(rit)">{r.slot_id ?? '-'}</Descriptions.Item>
+                  <Descriptions.Item label="我方代码位">{r.our_code_id ?? '-'}</Descriptions.Item>
+                  <Descriptions.Item label="来源应用">{r.app_env ?? '-'}</Descriptions.Item>
+                </Descriptions>
              </div>
            ),
        }}
@@ -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',
@@ -1,7 +1,7 @@
 'use client';

 import { useEffect, useState } from 'react';
-import { Button, Card, Space, Spin, Switch, Tag, Typography, Upload, message } from 'antd';
+import { Button, Card, InputNumber, Space, Spin, Switch, Tag, Typography, Upload, message } from 'antd';
 import { DeleteOutlined, UploadOutlined } from '@ant-design/icons';
 import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
@@ -9,55 +9,58 @@ import { mediaUrl } from '@/lib/media';
 import type { GuideVideoConfig as GuideCfg } from '@/lib/types';

 const { Text } = Typography;
-
-/** 后端 media.save_guide_video 只认 MP4 魔数;这里先在浏览器挡一道,省得白传 100MB。 */
 const MAX_BYTES = 100 * 1024 * 1024;
+type Scene = 'coupon' | 'comparison';

-/**
- * 领券等候浮层的「新手引导视频」配置。
- *
- * 用户点首页「一键自动领取」→ 出等候浮层,浮层下方那块位置**前 3 次**放这支引导视频
- * (而不是广告),每次固定发 120 金币;播完若浮层还开着,自动接着放广告(原逻辑)。
- * 「系统配置 → 领券引导视频」tab 的一个区块。
- *
- * 后台只管两件事:**开关** 和 **换片**。次数(3)/ 金币(120)走服务端默认值,产品已拍板不再
- * 开放配置,所以这里不渲染输入框、PATCH 也不带这两个字段(后端仍保留字段与默认值)。
- */
-export default function GuideVideoConfig() {
+const META: Record<Scene, { title: string; action: string }> = {
+  coupon: { title: '一键自动领取引导视频', action: '一键自动领取' },
+  comparison: { title: '开始比价引导视频', action: '开始比价' },
+};
+
+function SceneConfig({ scene }: { scene: Scene }) {
+  const meta = META[scene];
  const [cfg, setCfg] = useState<GuideCfg | null>(null);
  const [loading, setLoading] = useState(true);
  const [saving, setSaving] = useState(false);
  const [uploading, setUploading] = useState(false);
-
-  // 本地编辑态,保存时一次性 PATCH
  const [enabled, setEnabled] = useState(true);
-
+  const [maxPlays, setMaxPlays] = useState(3);
+  const [rewardCoin, setRewardCoin] = useState(100);
  const canEdit = canDo(['operator']);

-  const sync = (c: GuideCfg) => {
-    setCfg(c);
-    setEnabled(c.enabled);
+  const sync = (value: GuideCfg) => {
+    setCfg(value);
+    setEnabled(value.enabled);
+    setMaxPlays(value.max_plays);
+    setRewardCoin(value.reward_coin);
  };

  const load = async () => {
    setLoading(true);
    try {
-      const { data } = await api.get<GuideCfg>('/admin/api/guide-video');
+      const { data } = await api.get<GuideCfg>('/admin/api/guide-video', { params: { scene } });
      sync(data);
+    } catch (e) {
+      message.error(errMsg(e));
    } finally {
      setLoading(false);
    }
  };
+
  useEffect(() => {
-    load();
-  }, []);
+    void load();
+  }, [scene]);

  const save = async () => {
    setSaving(true);
    try {
-      const { data } = await api.patch<GuideCfg>('/admin/api/guide-video', { enabled });
+      const { data } = await api.patch<GuideCfg>(
+        '/admin/api/guide-video',
+        { enabled, max_plays: maxPlays, reward_coin: rewardCoin },
+        { params: { scene } },
+      );
      sync(data);
-      message.success('已保存，用户下一次进入领券浮层即生效');
+      message.success(`${meta.title}配置已保存，下次触发即生效`);
    } catch (e) {
      message.error(errMsg(e));
    } finally {
@@ -65,11 +68,27 @@ export default function GuideVideoConfig() {
    }
  };

-  // antd Upload:beforeUpload 里自行 POST(multipart),返回 false 阻止其默认上传。
+  const uploadVideo = async (file: File) => {
+    const form = new FormData();
+    form.append('file', file);
+    setUploading(true);
+    try {
+      const { data } = await api.post<GuideCfg>(
+        '/admin/api/guide-video/video',
+        form,
+        { params: { scene } },
+      );
+      sync(data);
+      message.success(`${meta.title}已更新`);
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setUploading(false);
+    }
+  };
+
  const beforeUpload = (file: File) => {
-    // 有些系统给 .mp4 的 type 是空串,不能只看 type,再兜一层扩展名。
-    const looksMp4 = file.type === 'video/mp4' || /\.mp4$/i.test(file.name);
-    if (!looksMp4) {
+    if (file.type !== 'video/mp4' && !/\.mp4$/i.test(file.name)) {
      message.error('仅支持 MP4 视频（H.264 编码）');
      return Upload.LIST_IGNORE;
    }
@@ -81,27 +100,15 @@ export default function GuideVideoConfig() {
    return false;
  };

-  const uploadVideo = async (file: File) => {
-    const form = new FormData();
-    form.append('file', file);
-    setUploading(true);
-    try {
-      const { data } = await api.post<GuideCfg>('/admin/api/guide-video/video', form);
-      sync(data);
-      message.success('引导视频已更新，用户下一次进入领券浮层即生效');
-    } catch (e) {
-      message.error(errMsg(e));
-    } finally {
-      setUploading(false);
-    }
-  };
-
  const removeVideo = async () => {
    setUploading(true);
    try {
-      const { data } = await api.delete<GuideCfg>('/admin/api/guide-video/video');
+      const { data } = await api.delete<GuideCfg>(
+        '/admin/api/guide-video/video',
+        { params: { scene } },
+      );
      sync(data);
-      message.success('已移除引导视频，领券浮层恢复为只放广告');
+      message.success(`已移除${meta.title}`);
    } catch (e) {
      message.error(errMsg(e));
    } finally {
@@ -112,82 +119,48 @@ export default function GuideVideoConfig() {
  return (
    <Card
      size="small"
-      title="领券引导视频（App 领券等候浮层，前 3 次替代广告）"
+      title={meta.title}
      style={{ marginBottom: 16 }}
-      extra={
-        cfg?.updated_at ? (
-          <Text type="secondary" style={{ fontSize: 12 }}>
-            更新于 {new Date(cfg.updated_at).toLocaleString('zh-CN')}
-          </Text>
-        ) : null
-      }
+      extra={cfg?.updated_at ? <Text type="secondary">更新于 {new Date(cfg.updated_at).toLocaleString('zh-CN')}</Text> : null}
    >
-      <p style={{ color: '#999', marginTop: 0 }}>
-        用户点「一键自动领取」后出现的等候浮层，下方那块广告位<b>前 3 次</b>改放这支引导视频。
-        视频<b>不可快进</b>；播完或中途关闭都算看完，各发一次 <b>120 金币</b>；播完若浮层还开着，会自动接着放广告。
-        次数<b>按账号</b>计（换设备不重置），<b>视频一开播就算用掉一次</b>。
-        次数与金币走固定值、后台不开放调整；这里只管<b>开关</b>和<b>换片</b>，每次改动进审计日志。
+      <p style={{ color: '#777', marginTop: 0 }}>
+        Android 用户点击「{meta.action}」后，前若干次在等候浮层广告位播放本视频并奖励金币。
+        次数按账号、按功能分别计算；开播即计次，播完或中途关闭均发放当次配置的金币。
      </p>
      {loading || !cfg ? (
        <Spin style={{ display: 'block', margin: '24px 0' }} />
      ) : (
        <Space align="start" size={32} wrap>
-          {/* 左:视频预览 */}
-          <div>
-            <Text type="secondary" style={{ fontSize: 12 }}>
-              当前引导视频
-            </Text>
-            <div style={{ marginTop: 8, width: 240 }}>
-              {cfg.video_url ? (
-                // eslint-disable-next-line jsx-a11y/media-has-caption
-                <video
-                  src={mediaUrl(cfg.video_url)}
-                  controls
-                  style={{
-                    width: 240,
-                    maxHeight: 420,
-                    borderRadius: 12,
-                    background: '#000',
-                    border: '1px solid #f0f0f0',
-                  }}
-                />
-              ) : (
-                <div
-                  style={{
-                    width: 240,
-                    height: 320,
-                    borderRadius: 12,
-                    border: '1px dashed #d9d9d9',
-                    display: 'flex',
-                    alignItems: 'center',
-                    justifyContent: 'center',
-                    color: '#bbb',
-                    fontSize: 13,
-                    textAlign: 'center',
-                    padding: 16,
-                  }}
-                >
-                  未上传视频
-                  <br />
-                  （领券浮层照旧只放广告）
-                </div>
-              )}
-            </div>
-            {!enabled && cfg.video_url && (
-              <div style={{ color: '#fa8c16', fontSize: 12, marginTop: 6 }}>
-                当前为「关闭」：浮层不放引导视频，直接放广告
+          <div style={{ width: 240 }}>
+            {cfg.video_url ? (
+              // eslint-disable-next-line jsx-a11y/media-has-caption
+              <video
+                src={mediaUrl(cfg.video_url)}
+                controls
+                style={{ width: 240, maxHeight: 420, borderRadius: 12, background: '#000' }}
+              />
+            ) : (
+              <div style={{ height: 280, border: '1px dashed #d9d9d9', borderRadius: 12, display: 'grid', placeItems: 'center', color: '#aaa' }}>
+                未上传视频
              </div>
            )}
          </div>
-
-          {/* 右:编辑控件 */}
-          <Space direction="vertical" size="middle" style={{ minWidth: 360 }}>
+          <Space direction="vertical" size="middle" style={{ minWidth: 390 }}>
            <Space>
-              <span>启用引导视频：</span>
+              <span>启用：</span>
              <Switch checked={enabled} disabled={!canEdit} onChange={setEnabled} />
              {!enabled && <Tag color="orange">已关闭</Tag>}
            </Space>
-
+            <Space>
+              <span>播放次数：</span>
+              <InputNumber min={0} max={50} precision={0} value={maxPlays} disabled={!canEdit} onChange={(v) => setMaxPlays(v ?? 0)} />
+              <Text type="secondary">每个账号前 N 次（默认 3）</Text>
+            </Space>
+            <Space>
+              <span>每次金币：</span>
+              <InputNumber min={0} max={10000} precision={0} value={rewardCoin} disabled={!canEdit} onChange={(v) => setRewardCoin(v ?? 0)} />
+              <Text type="secondary">默认 100</Text>
+            </Space>
            <Space wrap>
              <Upload accept="video/mp4,.mp4" showUploadList={false} beforeUpload={beforeUpload} disabled={!canEdit}>
                <Button icon={<UploadOutlined />} loading={uploading} disabled={!canEdit}>
@@ -195,28 +168,26 @@ export default function GuideVideoConfig() {
                </Button>
              </Upload>
              {cfg.video_url && (
-                <Button
-                  icon={<DeleteOutlined />}
-                  danger
-                  loading={uploading}
-                  disabled={!canEdit}
-                  onClick={removeVideo}
-                >
+                <Button icon={<DeleteOutlined />} danger loading={uploading} disabled={!canEdit} onClick={removeVideo}>
                  移除视频
                </Button>
              )}
-              <Text type="secondary" style={{ fontSize: 12 }}>
-                MP4（H.264），≤100MB
-              </Text>
+              <Text type="secondary">MP4（H.264），≤100MB</Text>
            </Space>
-
-            <Button type="primary" loading={saving} disabled={!canEdit} onClick={save}>
-              保存开关
-            </Button>
-            {!canEdit && <Text type="secondary">仅 operator / super_admin 可修改</Text>}
+            <Button type="primary" loading={saving} disabled={!canEdit} onClick={save}>保存配置</Button>
+            <Text type="secondary">累计播放 {cfg.total_plays} 次，已发币 {cfg.granted_plays} 次</Text>
          </Space>
        </Space>
      )}
    </Card>
  );
 }
+
+export default function GuideVideoConfig() {
+  return (
+    <>
+      <SceneConfig scene="coupon" />
+      <SceneConfig scene="comparison" />
+    </>
+  );
+}
@@ -165,7 +165,7 @@ export default function ConfigPage() {
          },
          { key: 'welfare', label: '福利页', children: welfareConfig },
          { key: 'feedback-qr', label: '反馈二维码', children: <FeedbackQrConfig /> },
-          { key: 'guide-video', label: '领券引导视频', children: <GuideVideoConfig /> },
+          { key: 'guide-video', label: '引导视频奖励', children: <GuideVideoConfig /> },
        ]}
      />
    </div>
@@ -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;
@@ -409,6 +406,7 @@ export interface FeedbackQrConfig {
 /** 领券等候浮层的「新手引导视频」配置(前 3 次用它替代广告,每次固定 120 金币)。
 *  后台只开放 enabled + 换片;下面几个字段接口仍返回,但页面不展示、也不回传。 */
 export interface GuideVideoConfig {
+  scene: 'coupon' | 'comparison';
  enabled: boolean;
  video_url: string | null; // /media/guide_video/xxx.mp4;null = 未配片(浮层照旧只放广告)
  max_plays: number; // 每个账号前 N 次浮层放引导视频(服务端默认 3,后台不开放调整)
@@ -449,7 +447,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;