在比价记录中展示是否下单 (#88)

## 改动说明
- 在“省”列后新增“是否下单”列
- 使用“已下单/未下单”标签展示
- 同步补充前端接口类型

## 验证
- Next.js 生产构建和类型检查通过

---------

Co-authored-by: linkeyu <798648091@qq.com>
Reviewed-on: #88
Co-authored-by: linkeyu <linkeyu@wonderable.ai>
Co-committed-by: linkeyu <linkeyu@wonderable.ai>

src/app/(main)/ad-revenue-report/UserAdRevenueDrawer.tsx

@@ -15,6 +15,8 @@ interface UserOverviewResp {
     id: number;
     phone: string;
     nickname: string | null;
+    is_high_risk: boolean;
+    high_risk_note: string | null;
     status: string;
     wechat_nickname: string | null;
     created_at: string;
@@ -49,6 +51,8 @@ export default function UserAdRevenueDrawer({ open, onClose, userId, phone }: Pr
           id: o.user.id,
           phone: o.user.phone,
           nickname: o.user.nickname,
+          is_high_risk: o.user.is_high_risk,
+          high_risk_note: o.user.high_risk_note,
           status: o.user.status,
           wechat_nickname: o.user.wechat_nickname, // 概览接口已返回微信昵称
           wechat_avatar_url: null,

src/app/(main)/ad-revenue-report/page.tsx

@@ -9,7 +9,6 @@ import {
   Card,
   Col,
   DatePicker,
-  Descriptions,
   Divider,
   InputNumber,
   Modal,
@@ -43,6 +42,8 @@ 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 }> = {
@@ -190,11 +191,76 @@ const LT_FACTOR_ROWS = [
   { key: '5', lt: '第 11 条及以后', factor: 1.0 },
 ];
 
-type AdRevenueDetailRow = AdRevenueRecord & { source_adn?: string | null };
+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,
+  };
+}
 
 // 展开行(逐条事件展开)- 该条的发奖复算明细(还原金币审计的 eCPM/因子1/份数/LT/因子2 等列)
 const DETAIL_COLUMNS: ColumnsType<AdRevenueDetailRow> = [
-  { title: '来源广告网络', dataIndex: 'source_adn', width: 110, render: (value: string | null) => value || '-' },
+  {
+    title: '来源广告网络',
+    dataIndex: 'source_adn',
+    width: 110,
+    render: (value: string | null) => value?.trim() || (
+      <Tooltip title="该历史记录没有可唯一确认的 SDK 广告来源，未猜测填充。">
+        <span>未上报</span>
+      </Tooltip>
+    ),
+  },
   {
     title: 'eCPM（元）',
     dataIndex: 'ecpm',
@@ -208,18 +274,25 @@ 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) => v ?? '-' },
+  {
+    title: '因子1',
+    dataIndex: 'ecpm_factor',
+    width: 70,
+    render: (v: number | null, row: AdRevenueDetailRow) => renderFormulaValue(v ?? '-', row),
+  },
   {
     title: '因子2',
     key: 'lt_factor',
     width: 90,
-    render: (_: unknown, r: AdRevenueDetailRow) => fmtFactorRange(r.lt_factor_start, r.lt_factor_end),
+    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) => fmtIndexRange(r.lt_index_start, r.lt_index_end),
+    render: (_: unknown, row: AdRevenueDetailRow) =>
+      renderFormulaValue(fmtIndexRange(row.lt_index_start, row.lt_index_end), row),
   },
 ];
 
@@ -387,13 +460,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>(1000); // 默认拉满接口单页上限，供单次流程广告数分位统计
+  const [limit, setLimit] = useState<number>(DEFAULT_PAGE_SIZE);
   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>(1000);
+  const [queriedLimit, setQueriedLimit] = useState<number>(DEFAULT_PAGE_SIZE);
   const [loading, setLoading] = useState(false);
   const [formulaOpen, setFormulaOpen] = useState(false);
   // 点用户手机号弹出的「用户广告收益详情」半屏抽屉(userId + 手机号;null=关闭)
@@ -661,11 +734,21 @@ export default function AdRevenueReportPage() {
         : data.date_from
       : `${data.date_from} ~ ${data.date_to}`;
 
-  // 第二行大盘「分广告类型」:draw / 激励视频 各自 收益 / eCPM / 展示条数;eCPM = 收益÷展示×1000。
+  // 第二行大盘「分广告类型」：看视频包含福利视频与提现视频；
+  // eCPM 优先使用后端按真实展示加权的经营分类口径；兼容旧后端时才用合并收益÷展示数回退。
   const drawStat = data?.type_stats?.draw;
-  const rvStat = data?.type_stats?.reward_video;
+  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 drawEcpmStat = data?.category_stats?.draw ?? drawStat;
+  const videoEcpmStat = data?.category_stats?.video ?? videoStat;
   const ecpmOf = (s?: AdRevenueTypeStat) =>
-    s && s.impressions > 0 ? (s.revenue_yuan / s.impressions) * 1000 : 0;
+    s?.ecpm_yuan ?? (s && s.impressions > 0 ? (s.revenue_yuan / s.impressions) * 1000 : 0);
 
   // 明细直接用后端返回的当前页 items(「场景」已由后端 feed_scene 全局过滤,前端不再二次筛)。
   const items = data?.items ?? [];
@@ -775,12 +858,11 @@ export default function AdRevenueReportPage() {
           <Space size={6}>
             <Typography.Text type="secondary">类型</Typography.Text>
             <Select
-              placeholder="全部"
-              value={adType}
-              onChange={setAdType}
-              allowClear
+              value={adType ?? ALL_FILTER_VALUE}
+              onChange={(value) => setAdType(value === ALL_FILTER_VALUE ? undefined : value)}
               style={{ width: 150 }}
               options={[
+                { value: ALL_FILTER_VALUE, label: '全部' },
                 { value: 'reward_video', label: '看视频' },
                 { value: 'draw', label: 'Draw 信息流' },
                 { value: 'withdrawal_video', label: '提现看视频' },
@@ -790,12 +872,11 @@ export default function AdRevenueReportPage() {
           <Space size={6}>
             <Typography.Text type="secondary">场景</Typography.Text>
             <Select
-              placeholder="全部"
-              value={scene}
-              onChange={setScene}
-              allowClear
+              value={scene ?? ALL_FILTER_VALUE}
+              onChange={(value) => setScene(value === ALL_FILTER_VALUE ? undefined : value)}
               style={{ width: 130 }}
               options={[
+                { value: ALL_FILTER_VALUE, label: '全部' },
                 { value: 'comparison', label: '比价' },
                 { value: 'coupon', label: '领券' },
                 { value: 'welfare', label: '福利' },
@@ -981,19 +1062,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={ecpmOf(drawEcpmStat)} precision={2} />
             </Col>
             <Col span={4}>
               <Statistic title="Draw 信息流条数" value={drawStat?.impressions ?? 0} />
             </Col>
             <Col span={4}>
-              <Statistic title="看视频收益(元)" value={rvStat?.revenue_yuan ?? 0} precision={4} />
+              <Statistic title="看视频收益(元)" value={videoStat.revenue_yuan} precision={4} />
             </Col>
             <Col span={4}>
-              <Statistic title="看视频 eCPM(元/千次)" value={ecpmOf(rvStat)} precision={2} />
+              <Statistic title="看视频 eCPM(元/千次)" value={ecpmOf(videoEcpmStat)} precision={2} />
             </Col>
             <Col span={4}>
-              <Statistic title="看视频条数" value={rvStat?.impressions ?? 0} />
+              <Statistic title="看视频条数" value={videoStat.impressions} />
             </Col>
           </Row>
           <Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
@@ -1102,7 +1183,11 @@ export default function AdRevenueReportPage() {
                   style={{ marginTop: 8 }}
                   rowKey="record_id"
                   columns={DETAIL_COLUMNS}
-                  dataSource={r.sub_rewards.map((detail) => ({ ...detail, source_adn: r.adn }))}
+                  dataSource={r.sub_rewards.map((detail) => ({
+                    ...detail,
+                    // 一次比价/领券可能由不同 ADN 连续填充，优先显示本条发奖记录的来源。
+                    source_adn: detail.adn ?? r.adn,
+                  }))}
                   pagination={false}
                   size="small"
                   scroll={{ x: 900 }}
@@ -1118,7 +1203,10 @@ export default function AdRevenueReportPage() {
                   style={{ marginTop: 8 }}
                   rowKey="record_id"
                   columns={DETAIL_COLUMNS}
-                  dataSource={[{ ...r.reward_detail, source_adn: r.adn }]}
+                  dataSource={[{
+                    ...r.reward_detail,
+                    source_adn: r.reward_detail.adn ?? r.adn,
+                  }]}
                   pagination={false}
                   size="small"
                   scroll={{ x: 900 }}
@@ -1126,24 +1214,19 @@ export default function AdRevenueReportPage() {
               </div>
             ) : (
               <div>
-                <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>
+                <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 }}
+                />
               </div>
             ),
         }}

src/app/(main)/comparison-records/page.tsx

@@ -46,6 +46,41 @@ const fmtTok = (inTok: number | null, outTok: number | null) =>
   inTok == null && outTok == null ? '-' : `${inTok ?? 0}/${outTok ?? 0}`;
 const fmtRate = (value: number | null) => (value == null ? '-' : `${(value * 100).toFixed(1)}%`);
 
+function deviceName(record: ComparisonRecordListItem): string {
+  return record.device_model_name || record.device_model || '-';
+}
+
+function romName(record: ComparisonRecordListItem): string {
+  return [
+    record.rom_vendor,
+    record.rom_name,
+    record.rom_version != null ? String(record.rom_version) : null,
+  ]
+    .filter(Boolean)
+    .join(' ') || '-';
+}
+
+function renderDevice(record: ComparisonRecordListItem): ReactNode {
+  const readableName = deviceName(record);
+  const showRawModel =
+    record.device_model_name
+    && record.device_model
+    && record.device_model_name !== record.device_model;
+  return (
+    <Space direction="vertical" size={0}>
+      <span>{readableName}</span>
+      {showRawModel ? (
+        <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+          {record.device_model}
+        </Typography.Text>
+      ) : null}
+      <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+        {romName(record)}
+      </Typography.Text>
+    </Space>
+  );
+}
+
 // LLM 价格快照只展示 prices 里各模型的单价(元/每百万 token),忽略 mode/_source 等元字段。
 function llmPriceRows(snapshot: Record<string, unknown> | null): string[] {
   const prices = snapshot?.prices;
@@ -237,9 +272,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>
       ),
     },
@@ -298,6 +333,14 @@ 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',
@@ -308,9 +351,9 @@ export default function ComparisonRecordsPage() {
     {
       title: '机型/ROM',
       key: 'device',
-      width: 150,
+      width: 180,
       ellipsis: true,
-      render: (_, r) => [r.device_model, r.rom_name].filter(Boolean).join(' / ') || '-',
+      render: (_, r) => renderDevice(r),
     },
     {
       title: 'traceid',
@@ -499,8 +542,15 @@ export default function ComparisonRecordsPage() {
 
             <Card size="small" title="设备环境">
               <Descriptions size="small" column={2}>
-                <Descriptions.Item label="机型">{detail.device_model || '-'}（{detail.device_manufacturer || '-'}）</Descriptions.Item>
-                <Descriptions.Item label="ROM">{[detail.rom_vendor, detail.rom_name, detail.rom_version].filter(Boolean).join(' ') || '-'}</Descriptions.Item>
+                <Descriptions.Item label="机型">
+                  {deviceName(detail)}
+                  {detail.device_model_name && detail.device_model_name !== detail.device_model
+                    ? `（${[detail.device_manufacturer, detail.device_model].filter(Boolean).join(' · ')}）`
+                    : detail.device_manufacturer
+                      ? `（${detail.device_manufacturer}）`
+                      : ''}
+                </Descriptions.Item>
+                <Descriptions.Item label="ROM">{romName(detail)}</Descriptions.Item>
                 <Descriptions.Item label="Android">{detail.android_version || '-'}（SDK {detail.android_sdk ?? '-'}）</Descriptions.Item>
                 <Descriptions.Item label="App 版本">{detail.app_version || '-'}（{detail.app_version_code ?? '-'}）</Descriptions.Item>
                 <Descriptions.Item label="源 App 版本" span={2}>{detail.source_app_version || '-'}</Descriptions.Item>

src/app/(main)/feedbacks/page.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useEffect, useState } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
 import type { ColumnsType } from 'antd/es/table';
 import type { SorterResult } from 'antd/es/table/interface';
 import {
@@ -35,6 +35,7 @@ import UserRecordsDrawer from '@/components/UserRecordsDrawer';
 const { Text, Paragraph } = Typography;
 const { RangePicker } = DatePicker;
 const REWARD_MAX = 10000;
+const REVIEW_PAGE_POLL_INTERVAL_MS = 60_000;
 
 // 截图是 app-server 的 /media 相对路径,本地由 :8770 提供(NEXT_PUBLIC_MEDIA_BASE);生产同域走 nginx 代理。
 const MEDIA_BASE = process.env.NEXT_PUBLIC_MEDIA_BASE || '';
@@ -122,13 +123,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}
@@ -178,6 +197,10 @@ export default function FeedbacksPage() {
   const filters: Record<string, unknown> = { ...applied, sort_by: sortBy, sort_order: sortOrder };
   const { items, total, page, pageSize, loading, onChange: onPageChange, reload } =
     usePagedList<Feedback>('/admin/api/feedbacks', filters);
+  const reloadRef = useRef(reload);
+  useEffect(() => {
+    reloadRef.current = reload;
+  }, [reload]);
 
   const canReview = canDo(['operator']);
   const [selectedRowKeys, setSelectedRowKeys] = useState<number[]>([]);
@@ -195,18 +218,40 @@ export default function FeedbacksPage() {
   }, [items]);
 
   const [summary, setSummary] = useState<FeedbackSummary | null>(null);
-  const loadSummary = async () => {
+  const loadSummary = useCallback(async () => {
     try {
       const { data } = await api.get<FeedbackSummary>('/admin/api/feedbacks/summary');
       setSummary(data);
     } catch {
       /* 统计失败不阻塞列表 */
     }
-  };
-  useEffect(() => {
-    loadSummary();
   }, []);
 
+  const refreshPageData = useCallback(() => {
+    void reloadRef.current();
+    void loadSummary();
+  }, [loadSummary]);
+
+  useEffect(() => {
+    void loadSummary();
+
+    const onWindowFocus = () => refreshPageData();
+    const onVisibilityChange = () => {
+      if (document.visibilityState === 'visible') refreshPageData();
+    };
+    const pollTimer = window.setInterval(() => {
+      if (document.visibilityState === 'visible') refreshPageData();
+    }, REVIEW_PAGE_POLL_INTERVAL_MS);
+
+    window.addEventListener('focus', onWindowFocus);
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    return () => {
+      window.clearInterval(pollTimer);
+      window.removeEventListener('focus', onWindowFocus);
+      document.removeEventListener('visibilitychange', onVisibilityChange);
+    };
+  }, [loadSummary, refreshPageData]);
+
   // 审核/查看抽屉(采纳发金币 / 拒绝填原因 + 看该用户历史反馈)
   const [drawerFb, setDrawerFb] = useState<Feedback | null>(null);
   const [drawerOpen, setDrawerOpen] = useState(false);
@@ -352,7 +397,7 @@ export default function FeedbacksPage() {
     {
       title: '机型 / OS版本',
       key: 'device',
-      width: 150,
+      width: 180,
       render: (_: unknown, f: Feedback) => renderDeviceOs(f),
     },
     {

src/app/(main)/invite-withdraws/page.tsx

@@ -0,0 +1,5 @@
+import { WithdrawReviewPage } from '../withdraws/WithdrawReviewPage';
+
+export default function InviteWithdrawsPage() {
+  return <WithdrawReviewPage mode="invite" />;
+}

src/app/(main)/layout.tsx

@@ -37,6 +37,8 @@ import type {
   WithdrawSummary,
 } from '@/lib/types';
 
+const REVIEW_BADGE_POLL_INTERVAL_MS = 60_000;
+
 const { Sider, Header, Content } = Layout;
 
 type NavItem = {
@@ -75,7 +77,8 @@ const NAV_GROUPS: NavGroup[] = [
     icon: <MoneyCollectOutlined />,
     label: '奖励审核',
     children: [
-      { key: '/withdraws', icon: <MoneyCollectOutlined />, label: '提现审核' },
+      { key: '/invite-withdraws', icon: <MoneyCollectOutlined />, label: '邀请提现审核' },
+      { key: '/withdraws', icon: <MoneyCollectOutlined />, label: '其他提现审核' },
       { key: '/price-reports', icon: <FlagOutlined />, label: '低价审核' },
       { key: '/feedbacks', icon: <MessageOutlined />, label: '用户反馈' },
     ],
@@ -91,6 +94,7 @@ const NAV_GROUPS: NavGroup[] = [
       { key: '/users', icon: <UserOutlined />, label: '用户管理' },
     ],
   },
+  { key: '/admins', icon: <TeamOutlined />, label: '权限管理' },
   {
     key: 'monitoring-audit',
     icon: <FileSearchOutlined />,
@@ -103,7 +107,6 @@ const NAV_GROUPS: NavGroup[] = [
       { key: '/audit-logs', icon: <FileSearchOutlined />, label: '审计日志' },
     ],
   },
-  { key: '/admins', icon: <TeamOutlined />, label: '权限管理' },
 ];
 
 // 导航项 key(/dashboard)→ 权限页 key(dashboard),与后端 permissions.py 目录对齐
@@ -144,8 +147,13 @@ export default function MainLayout({ children }: { children: React.ReactNode })
       const version = (reviewRefreshVersion.current[key] ?? 0) + 1;
       reviewRefreshVersion.current[key] = version;
       let count: number;
-      if (key === '/withdraws') {
-        count = (await api.get<WithdrawSummary>('/admin/api/withdraws/summary')).data.reviewing_count;
+      if (key === '/withdraws' || key === '/invite-withdraws') {
+        const source = key === '/invite-withdraws' ? 'invite_cash' : 'coin_cash';
+        count = (
+          await api.get<WithdrawSummary>('/admin/api/withdraws/summary', {
+            params: { source },
+          })
+        ).data.reviewing_count;
       } else if (key === '/price-reports') {
         count = (await api.get<PriceReportSummary>('/admin/api/price-reports/summary')).data.pending;
       } else {
@@ -156,21 +164,39 @@ export default function MainLayout({ children }: { children: React.ReactNode })
     };
 
     const refreshSafely = (key: ReviewBadgeKey) => refresh(key).catch(() => {});
-    void Promise.all([
-      refreshSafely('/withdraws'),
-      refreshSafely('/price-reports'),
-      refreshSafely('/feedbacks'),
-    ]);
+    const refreshAll = () => {
+      void Promise.all([
+        refreshSafely('/withdraws'),
+        refreshSafely('/invite-withdraws'),
+        refreshSafely('/price-reports'),
+        refreshSafely('/feedbacks'),
+      ]);
+    };
+
+    refreshAll();
 
     const onReviewCompleted = (event: Event) => {
       const key = (event as CustomEvent<ReviewBadgeKey>).detail;
       if (key) void refreshSafely(key);
     };
-    window.addEventListener(REVIEW_BADGE_REFRESH_EVENT, onReviewCompleted);
-    return () => {
-      window.removeEventListener(REVIEW_BADGE_REFRESH_EVENT, onReviewCompleted);
+    const onWindowFocus = () => refreshAll();
+    const onVisibilityChange = () => {
+      if (document.visibilityState === 'visible') refreshAll();
     };
-  }, [admin]);
+    const pollTimer = window.setInterval(() => {
+      if (document.visibilityState === 'visible') refreshAll();
+    }, REVIEW_BADGE_POLL_INTERVAL_MS);
+
+    window.addEventListener(REVIEW_BADGE_REFRESH_EVENT, onReviewCompleted);
+    window.addEventListener('focus', onWindowFocus);
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    return () => {
+      window.clearInterval(pollTimer);
+      window.removeEventListener(REVIEW_BADGE_REFRESH_EVENT, onReviewCompleted);
+      window.removeEventListener('focus', onWindowFocus);
+      document.removeEventListener('visibilitychange', onVisibilityChange);
+    };
+  }, [admin, pathname]);
 
   if (!admin) return null; // 守卫期间不闪烁内容
 
@@ -223,8 +249,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 +339,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;

src/app/(main)/price-reports/page.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useEffect, useState } from 'react';
+import { useCallback, useEffect, useRef, useState } from 'react';
 import {
   App,
   Button,
@@ -30,6 +30,7 @@ import type { PriceReport, PriceReportSummary } from '@/lib/types';
 import UserRecordsDrawer from '@/components/UserRecordsDrawer';
 
 const { Text } = Typography;
+const REVIEW_PAGE_POLL_INTERVAL_MS = 60_000;
 
 // 后端 created_at/reviewed_at 存的是北京 wall-clock(naive,同 savings/comparison),
 // 直接本地解析、不加 Z(否则会差 8h)。
@@ -150,6 +151,10 @@ export default function PriceReportsPage() {
 
   const { items, total, page, pageSize, loading, onChange: onPageChange, reload } =
     usePagedList<PriceReport>('/admin/api/price-reports', filters);
+  const reloadRef = useRef(reload);
+  useEffect(() => {
+    reloadRef.current = reload;
+  }, [reload]);
 
   const sortOrderOf = (field: SortField) =>
     sortBy === field ? (sortOrder === 'asc' ? 'ascend' : 'descend') : null;
@@ -181,18 +186,40 @@ export default function PriceReportsPage() {
     setSelectedRowKeys((keys) => keys.filter((id) => visiblePendingIds.has(id)));
   }, [items]);
 
-  const loadSummary = async () => {
+  const loadSummary = useCallback(async () => {
     try {
       const { data } = await api.get<PriceReportSummary>('/admin/api/price-reports/summary');
       setSummary(data);
     } catch {
       /* 统计失败不阻塞列表 */
     }
-  };
-  useEffect(() => {
-    loadSummary();
   }, []);
 
+  const refreshPageData = useCallback(() => {
+    void reloadRef.current();
+    void loadSummary();
+  }, [loadSummary]);
+
+  useEffect(() => {
+    void loadSummary();
+
+    const onWindowFocus = () => refreshPageData();
+    const onVisibilityChange = () => {
+      if (document.visibilityState === 'visible') refreshPageData();
+    };
+    const pollTimer = window.setInterval(() => {
+      if (document.visibilityState === 'visible') refreshPageData();
+    }, REVIEW_PAGE_POLL_INTERVAL_MS);
+
+    window.addEventListener('focus', onWindowFocus);
+    document.addEventListener('visibilitychange', onVisibilityChange);
+    return () => {
+      window.clearInterval(pollTimer);
+      window.removeEventListener('focus', onWindowFocus);
+      document.removeEventListener('visibilitychange', onVisibilityChange);
+    };
+  }, [loadSummary, refreshPageData]);
+
   const refreshAfterChange = () => {
     reload();
     loadSummary();

src/app/(main)/users/page.tsx

@@ -13,6 +13,11 @@ import { formatUtcTime } from '@/lib/format';
 import { usePagedList } from '@/lib/usePagedList';
 import { AdjustCashModal, AdjustCoinModal } from '@/components/AdjustBalanceModals';
 import { DeleteUserModal } from '@/components/DeleteUserModal';
+import {
+  clearUserRisk,
+  UserRiskModal,
+  type RiskUser,
+} from '@/components/UserRiskModal';
 import type { UserListItem } from '@/lib/types';
 
 const { RangePicker } = DatePicker;
@@ -49,6 +54,7 @@ export default function UsersPage() {
   const [coinUser, setCoinUser] = useState<UserListItem | null>(null);
   const [cashUser, setCashUser] = useState<UserListItem | null>(null);
   const [delUser, setDelUser] = useState<UserListItem | null>(null);
+  const [riskUser, setRiskUser] = useState<RiskUser | null>(null);
   const [selectedRowKeys, setSelectedRowKeys] = useState<Key[]>([]);
 
   // 筛选/排序变化后清空已选(避免选中项跨筛选错位)
@@ -134,6 +140,22 @@ export default function UsersPage() {
     });
   };
 
+  const markNormalRisk = (u: UserListItem) => {
+    modal.confirm({
+      title: `确认将用户 ${u.phone} 标记为非高风险？`,
+      content: '确认后将清空当前高风险备注。',
+      onOk: async () => {
+        try {
+          await clearUserRisk(u.id);
+          message.success('已标记为非高风险');
+          reload();
+        } catch (error) {
+          message.error(errMsg(error));
+        }
+      },
+    });
+  };
+
   // 一次性操作:点一下把该用户标记为「未看过引导」,下次打开 App 重看一遍,看完后端自动恢复(只触发这一次)。
   // 用户尚未重看前可「撤销」(把 force_onboarding 置回 false),纠正误点。
   const setForceOnboarding = (u: UserListItem, enable: boolean) => {
@@ -213,26 +235,38 @@ export default function UsersPage() {
   };
 
   const columns: ColumnsType<UserListItem> = [
-    { title: 'ID', dataIndex: 'id', width: 80, sorter: true, sortOrder: sortOrderOf('id') },
-    { title: '手机号', dataIndex: 'phone', width: 130 },
+    { title: 'ID', dataIndex: 'id', width: 60, sorter: true, sortOrder: sortOrderOf('id') },
+    { title: '手机号', dataIndex: 'phone', width: 115 },
     {
       title: '昵称',
       dataIndex: 'nickname',
-      width: 150,
+      width: 130,
       ellipsis: true,
       render: (v: string | null) => v || '-',
     },
-    { title: '渠道', dataIndex: 'register_channel', width: 90 },
+    {
+      title: '用户标识',
+      dataIndex: 'is_high_risk',
+      width: 95,
+      render: (_: boolean, user: UserListItem) => (
+        <Tooltip title={user.is_high_risk ? user.high_risk_note || '暂无高风险备注' : undefined}>
+          <Tag color={user.is_high_risk ? 'red' : 'default'}>
+            {user.is_high_risk ? '高风险' : '非高风险'}
+          </Tag>
+        </Tooltip>
+      ),
+    },
+    { title: '渠道', dataIndex: 'register_channel', width: 70 },
     {
       title: '状态',
       dataIndex: 'status',
-      width: 90,
+      width: 80,
       render: (s: string) => <Tag color={STATUS_COLOR[s]}>{s}</Tag>,
     },
     {
       title: '注册时间',
       dataIndex: 'created_at',
-      width: 160,
+      width: 140,
       sorter: true,
       sortOrder: sortOrderOf('created_at'),
       render: (v: string) => formatUtcTime(v),
@@ -245,7 +279,7 @@ export default function UsersPage() {
         </Tooltip>
       ),
       dataIndex: 'last_active_at',
-      width: 160,
+      width: 140,
       sorter: true,
       // 关掉 antd 默认的「点击升序/降序」表头提示,否则与上面自定义口径 Tooltip 同时弹出互相遮挡
       showSorterTooltip: false,
@@ -256,9 +290,14 @@ export default function UsersPage() {
       title: '操作',
       key: 'op',
       fixed: 'right',
-      width: 340,
+      width: 540,
       render: (_: unknown, u: UserListItem) => (
-        <Space wrap={false} onClick={(e) => e.stopPropagation()}>
+        <Space
+          size={6}
+          wrap={false}
+          style={{ whiteSpace: 'nowrap' }}
+          onClick={(e) => e.stopPropagation()}
+        >
           <a onClick={() => router.push(`/users/${u.id}`)}>详情</a>
           {canCoins && <a onClick={() => setCoinUser(u)}>调金币</a>}
           {canCoins && <a onClick={() => setCashUser(u)}>调现金</a>}
@@ -270,6 +309,16 @@ export default function UsersPage() {
               {u.debug_trace_enabled ? '关调试链接' : '开调试链接'}
             </a>
           )}
+          {canStatus &&
+            u.status !== 'deleted' &&
+            (u.is_high_risk ? (
+              <>
+                <a onClick={() => setRiskUser(u)}>修改高风险备注</a>
+                <a onClick={() => markNormalRisk(u)}>标记为非高风险</a>
+              </>
+            ) : (
+              <a onClick={() => setRiskUser(u)}>标记为高风险</a>
+            ))}
           {canStatus &&
             u.status !== 'deleted' &&
             (u.force_onboarding ? (
@@ -392,7 +441,7 @@ export default function UsersPage() {
           showTotal: (t) => `共 ${t} 个用户`,
           onChange: onPageChange,
         }}
-        scroll={{ x: 1200 }}
+        scroll={{ x: 1400 }}
         onChange={onTableChange}
       />
 
@@ -404,6 +453,12 @@ export default function UsersPage() {
         onClose={() => setDelUser(null)}
         onDone={reload}
       />
+      <UserRiskModal
+        user={riskUser}
+        open={!!riskUser}
+        onClose={() => setRiskUser(null)}
+        onDone={reload}
+      />
     </div>
   );
 }

src/app/(main)/withdraws/UserRewardPanel.tsx

@@ -4,11 +4,13 @@ import { useCallback, useEffect, useState } from 'react';
 import {
   DatePicker,
   Descriptions,
+  Input,
   Radio,
   Space,
   Table,
   Tag,
   Typography,
+  Tooltip,
   message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
@@ -39,12 +41,18 @@ const PAGE_SIZE = 10; // 金币记录每页条数
 interface Props {
   userId: number;
   user: WithdrawUserSnapshot | null;
+  withdrawSource?: 'coin_cash' | 'invite_cash';
   // 统计区字段集:withdraw(默认,提现详情:含提现细分) / ad(广告收益详情:只看看广告观看统计,对齐参考图 6 项)
   statsVariant?: 'withdraw' | 'ad';
 }
 
 /** 用户看广告/提现详情:基本信息 + 互斥时间筛选 + 统计区(按 statsVariant 取字段集)+ 金币发放记录表。 */
-export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw' }: Props) {
+export default function UserRewardPanel({
+  userId,
+  user,
+  withdrawSource,
+  statsVariant = 'withdraw',
+}: Props) {
   const [mode, setMode] = useState<'all' | 'range'>('all'); // all=注册至今 / range=自定义区间
   const [range, setRange] = useState<[Dayjs, Dayjs] | null>(null);
   const [stats, setStats] = useState<UserRewardStats | null>(null);
@@ -69,7 +77,10 @@ export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw
     setStatsLoading(true);
     try {
       const { data } = await api.get<UserRewardStats>(`/admin/api/users/${userId}/reward-stats`, {
-        params: JSON.parse(paramsKey),
+        params: {
+          ...JSON.parse(paramsKey),
+          ...(withdrawSource ? { withdraw_source: withdrawSource } : {}),
+        },
       });
       setStats(data);
     } catch (e) {
@@ -77,7 +88,7 @@ export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw
     } finally {
       setStatsLoading(false);
     }
-  }, [userId, paramsKey]);
+  }, [userId, paramsKey, withdrawSource]);
 
   const loadRecords = useCallback(
     async (p: number) => {
@@ -135,6 +146,13 @@ export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw
         <Space size="large" wrap>
           <span>
             手机号 <Text strong>{user?.phone || '-'}</Text>
+            {user && (
+              <Tooltip title={user.is_high_risk ? user.high_risk_note || '暂无高风险备注' : undefined}>
+                <Tag color={user.is_high_risk ? 'red' : 'default'} style={{ marginInlineStart: 8 }}>
+                  {user.is_high_risk ? '高风险' : '非高风险'}
+                </Tag>
+              </Tooltip>
+            )}
           </span>
           <span>
             昵称 <Text strong>{user?.nickname || '-'}</Text>
@@ -160,6 +178,7 @@ export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw
           <RangePicker
             size="small"
             disabled={mode !== 'range'}
+            allowEmpty={[true, true]}
             value={range}
             onChange={(v) => setRange(v as [Dayjs, Dayjs] | null)}
           />
@@ -168,7 +187,7 @@ export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw
 
       {/* 统计区(受时间筛选;现金余额为当前快照)。ad 视图只保留看广告观看统计(对齐参考图 6 项) */}
       <Descriptions bordered size="small" column={2} style={{ marginBottom: 8 }}>
-        <Descriptions.Item label="累计提现">
+        <Descriptions.Item label="累计成功提现">
           {stats ? yuan(stats.withdraw_success_cents) : '-'}
         </Descriptions.Item>
         <Descriptions.Item label="现金余额">
@@ -176,40 +195,40 @@ export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw
         </Descriptions.Item>
         {statsVariant === 'ad' ? (
           <>
-            <Descriptions.Item label="激励视频观看数">
+            <Descriptions.Item label="激励视频成功发奖次数">
               {stats?.reward_video_count ?? '-'}
             </Descriptions.Item>
             {/* eCPM 均按元展示(reward_video / feed avg_ecpm 原始为分/千次,÷100 转元) */}
-            <Descriptions.Item label="平均激励视频ECPM">
+            <Descriptions.Item label="预估平均激励视频ECPM">
               {stats ? `${(stats.reward_video_avg_ecpm / 100).toFixed(2)} 元/千` : '-'}
             </Descriptions.Item>
-            <Descriptions.Item label="draw信息流视频观看数">
+            <Descriptions.Item label="Draw信息流奖励份数">
               {stats?.feed_count ?? '-'}
             </Descriptions.Item>
-            <Descriptions.Item label="平均draw信息流ECPM">
+            <Descriptions.Item label="预估平均Draw信息流ECPM">
               {stats ? `${(stats.feed_avg_ecpm / 100).toFixed(2)} 元/千` : '-'}
             </Descriptions.Item>
           </>
         ) : (
           <>
-            <Descriptions.Item label="提现总次数">{stats?.withdraw_total ?? '-'}</Descriptions.Item>
-            <Descriptions.Item label="传统任务提现">
+            <Descriptions.Item label="提现申请总次数">{stats?.withdraw_total ?? '-'}</Descriptions.Item>
+            <Descriptions.Item label="传统任务累计收益">
               {stats ? yuan(stats.traditional_task_cash_cents) : '-'}
             </Descriptions.Item>
-            <Descriptions.Item label="累计激励视频数">
+            <Descriptions.Item label="激励视频成功发奖次数">
               {stats?.reward_video_count ?? '-'}
             </Descriptions.Item>
-            <Descriptions.Item label="平均激励视频ECPM">
+            <Descriptions.Item label="预估平均激励视频ECPM">
               {stats ? `${stats.reward_video_avg_ecpm} 分/千` : '-'}
             </Descriptions.Item>
-            <Descriptions.Item label="激励视频提现">
+            <Descriptions.Item label="激励视频累计收益">
               {stats ? yuan(stats.reward_video_cash_cents) : '-'}
             </Descriptions.Item>
-            <Descriptions.Item label="累计信息流广告数">{stats?.feed_count ?? '-'}</Descriptions.Item>
-            <Descriptions.Item label="平均信息流广告ECPM">
+            <Descriptions.Item label="信息流奖励份数">{stats?.feed_count ?? '-'}</Descriptions.Item>
+            <Descriptions.Item label="预估平均信息流广告ECPM">
               {stats ? `${stats.feed_avg_ecpm} 分/千` : '-'}
             </Descriptions.Item>
-            <Descriptions.Item label="信息流广告提现">
+            <Descriptions.Item label="信息流广告累计收益">
               {stats ? yuan(stats.feed_cash_cents) : '-'}
             </Descriptions.Item>
           </>
@@ -217,12 +236,24 @@ export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw
       </Descriptions>
       <Text type="secondary" style={{ fontSize: 12 }}>
         {statsVariant === 'ad'
-          ? '统计随上方时间筛选(现金余额除外,为当前快照);eCPM 均按元展示(原始分/千次 ÷100)。'
-          : '统计随上方时间筛选(现金余额除外,为当前快照);eCPM 单位分/千次,同金币审计。'}
+          ? '统计随上方时间筛选(现金余额除外,为当前快照);次数仅统计成功发奖记录,信息流按奖励份数统计;eCPM 为预估值。'
+          : '统计随上方时间筛选(现金余额除外,为当前快照);提现按申请提交时间统计;累计收益为已发金币按当前汇率折算,不代表实际已提现金额;eCPM 为预估值。'}
       </Text>
 
-      {/* 金币记录 */}
-      <h4 style={{ margin: '16px 0 8px' }}>金币记录</h4>
+      {user?.is_high_risk && (
+        <div style={{ marginTop: 16 }}>
+          <Text strong>高风险备注</Text>
+          <Input.TextArea
+            readOnly
+            value={user.high_risk_note || ''}
+            rows={3}
+            style={{ marginTop: 8 }}
+          />
+        </div>
+      )}
+
+      {/* 主要金币发放记录 */}
+      <h4 style={{ margin: '16px 0 8px' }}>主要金币发放记录</h4>
       <Table
         rowKey={(r) => `${r.source}-${r.created_at}-${r.coin}-${r.ecpm ?? ''}`}
         size="small"

src/app/page.tsx

@@ -1,13 +1,26 @@
 'use client';
 
 import { useEffect } from 'react';
-import { useRouter } from 'next/navigation';
 import { getToken } from '@/lib/auth';
 
 export default function Home() {
-  const router = useRouter();
   useEffect(() => {
-    router.replace(getToken() ? '/dashboard' : '/login');
-  }, [router]);
-  return null;
+    window.location.replace(getToken() ? '/dashboard' : '/login');
+  }, []);
+
+  return (
+    <main
+      style={{
+        minHeight: '100vh',
+        display: 'flex',
+        alignItems: 'center',
+        justifyContent: 'center',
+        background: '#f0f2f5',
+        color: '#595959',
+        fontFamily: 'system-ui, sans-serif',
+      }}
+    >
+      正在进入运营后台…
+    </main>
+  );
 }

src/components/UserRiskModal.tsx

@@ -0,0 +1,81 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import { App, Input, Modal } from 'antd';
+import { api, errMsg } from '@/lib/api';
+
+export type RiskUser = {
+  id: number;
+  phone: string;
+  is_high_risk: boolean;
+  high_risk_note: string | null;
+};
+
+type Props = {
+  user: RiskUser | null;
+  open: boolean;
+  onClose: () => void;
+  onDone: () => void | Promise<void>;
+};
+
+export function UserRiskModal({ user, open, onClose, onDone }: Props) {
+  const { message } = App.useApp();
+  const [note, setNote] = useState('');
+  const [saving, setSaving] = useState(false);
+
+  useEffect(() => {
+    if (open) setNote(user?.high_risk_note ?? '');
+  }, [open, user]);
+
+  const save = async () => {
+    if (!user) return;
+    const trimmed = note.trim();
+    if (!trimmed) {
+      message.warning('请输入标记为高风险的原因');
+      return;
+    }
+    setSaving(true);
+    try {
+      await api.post(`/admin/api/users/${user.id}/risk`, {
+        is_high_risk: true,
+        note: trimmed,
+      });
+      message.success(user.is_high_risk ? '高风险备注已更新' : '已标记为高风险');
+      await onDone();
+      onClose();
+    } catch (error) {
+      message.error(errMsg(error));
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  return (
+    <Modal
+      title="高风险备注"
+      open={open}
+      okText="保存"
+      confirmLoading={saving}
+      onOk={save}
+      onCancel={onClose}
+      destroyOnHidden
+    >
+      <Input.TextArea
+        autoFocus
+        rows={5}
+        maxLength={500}
+        showCount
+        value={note}
+        placeholder="请输入标记为高风险的原因"
+        onChange={(event) => setNote(event.target.value)}
+      />
+    </Modal>
+  );
+}
+
+export async function clearUserRisk(userId: number) {
+  await api.post(`/admin/api/users/${userId}/risk`, {
+    is_high_risk: false,
+    note: null,
+  });
+}

src/lib/reviewBadge.ts

@@ -1,4 +1,8 @@
-export type ReviewBadgeKey = '/withdraws' | '/price-reports' | '/feedbacks';
+export type ReviewBadgeKey =
+  | '/invite-withdraws'
+  | '/withdraws'
+  | '/price-reports'
+  | '/feedbacks';
 
 export const REVIEW_BADGE_REFRESH_EVENT = 'review-badge-refresh';
 

src/lib/types.ts

@@ -52,6 +52,8 @@ export interface UserListItem {
   status: string;
   // 调试链接权限:开了的用户在 App 比价结果页/记录页可复制 price.shaguabijia.com 的 trace 调试链接
   debug_trace_enabled: boolean;
+  is_high_risk: boolean;
+  high_risk_note: string | null;
   // 运营「一键开启新手引导」:true = 该用户下次打开 App 会被强制重走新手引导,走完自动取消
   force_onboarding: boolean;
   wechat_openid: string | null;
@@ -143,7 +145,6 @@ export interface WithdrawOrder {
   amount_cents: number;
   // 提现类型:coin_cash(福利页提现,金币兑换现金) / invite_cash(邀请提现,邀请奖励金)
   source: string;
-  user_name: string | null;
   status: string; // reviewing / pending / success / failed / rejected
   wechat_state: string | null;
   transfer_bill_no: string | null;
@@ -157,6 +158,8 @@ export interface WithdrawOrder {
 export interface WithdrawListItem extends WithdrawOrder {
   phone: string | null;
   nickname: string | null;
+  is_high_risk: boolean;
+  high_risk_note: string | null;
   cumulative_success_cents: number; // 累计成功提现(分)
 }
 
@@ -164,7 +167,10 @@ export interface WithdrawSummary {
   reviewing_count: number;
   reviewing_amount_cents: number;
   pending_count: number;
+  success_count: number;
+  rejected_count: number;
   failed_count: number;
+  total_count: number;
   today_success_count: number;
   today_success_amount_cents: number;
   today_rejected_count: number;
@@ -174,6 +180,8 @@ export interface WithdrawUserSnapshot {
   id: number;
   phone: string;
   nickname: string | null;
+  is_high_risk: boolean;
+  high_risk_note: string | null;
   status: string;
   wechat_nickname: string | null;
   wechat_avatar_url: string | null;
@@ -184,14 +192,34 @@ export interface WithdrawUserSnapshot {
   withdraw_success_cents: number;
 }
 
+export interface InviteeDetail {
+  user_id: number;
+  phone: string;
+  registered_at: string;
+  invite_success: boolean;
+  first_compare_store: string | null;
+  first_compare_products: string | null;
+  first_order_store: string | null;
+  first_order_products: string | null;
+  first_order_amount_cents: number | null;
+}
+
+export interface InviteOverview {
+  invite_total: number;
+  invite_success_total: number;
+  items: InviteeDetail[];
+}
+
 export interface WithdrawDetail {
   order: WithdrawOrder;
   user: WithdrawUserSnapshot | null;
+  cumulative_success_cents: number;
   risk_flags: string[];
   risk_score: number;
   recent_withdraws: WithdrawOrder[];
   recent_cash_transactions: CashTxn[];
   audit_logs: AuditLog[];
+  invite_overview: InviteOverview | null;
 }
 
 // 提现详情抽屉「用户统计区」:按时间窗口算的提现 + 看广告行为统计。
@@ -318,26 +346,6 @@ export interface WithdrawBulkResult {
   items: WithdrawBulkItemResult[];
 }
 
-export interface WithdrawLedgerCheck {
-  ok: boolean;
-  // 普通现金账(coin_cash)
-  cash_balance_total_cents: number;
-  cash_transaction_total_cents: number;
-  balance_diff_cents: number;
-  missing_withdraw_txn_count: number;
-  missing_refund_txn_count: number;
-  duplicate_refund_txn_count: number;
-  refund_txn_on_non_terminal_count: number;
-  // 邀请奖励金账(invite_cash:与普通现金物理隔离,各自对账)
-  invite_cash_balance_total_cents: number;
-  invite_cash_transaction_total_cents: number;
-  invite_balance_diff_cents: number;
-  invite_missing_withdraw_txn_count: number;
-  invite_missing_refund_txn_count: number;
-  invite_duplicate_refund_txn_count: number;
-  invite_refund_txn_on_non_terminal_count: number;
-}
-
 export interface WxpayHealthCheck {
   ok: boolean;
   wxpay_configured: boolean;
@@ -377,7 +385,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;
@@ -446,6 +457,7 @@ 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;
@@ -454,8 +466,10 @@ export interface ComparisonRecordListItem {
   output_tokens: number | null;
   llm_cost_yuan: number | null;   // 后端按「当时价」冻结的实际成本(元);旧记录 null → 「成本」列回退估算
   device_model: string | null;
+  device_model_name: string | null;
   rom_vendor: string | null;
   rom_name: string | null;
+  rom_version: number | null;
   android_version: string | null;
   app_version: string | null;
   ad_revenue_yuan: number; // 本次比价看的信息流广告预估收益(元)
@@ -506,7 +520,6 @@ export interface ComparisonRecordDetail extends ComparisonRecordListItem {
   comparison_results: Record<string, unknown>[];
   skipped_dish_names: string[];
   device_manufacturer: string | null;
-  rom_version: number | null;
   android_sdk: number | null;
   app_version_code: number | null;
   source_app_version: string | null;
@@ -542,6 +555,8 @@ export interface AdRevenueRecord {
   expected_coin: number;
   actual_coin: number;
   matched: boolean;
+  adn: string | null; // 本条发奖对应的实际填充 ADN
+  slot_id: string | null; // 本条发奖对应的底层 mediation rit
 }
 
 // 广告收益报表:按日期汇总的一天(按天趋势图用;全量,不受分页影响)
@@ -568,6 +583,7 @@ export interface AdRevenueHourly {
 export interface AdRevenueTypeStat {
   impressions: number; // 该类型展示条数合计
   revenue_yuan: number; // 该类型预估收益合计(元)
+  ecpm_yuan?: number; // 按真实展示次数加权的 SDK eCPM(元/千次)
 }
 
 // 广告收益报表:一次广告事件(逐条一行)。激励视频展示+发奖按 ad_session_id 合并;信息流展示/发奖各自成行。
@@ -607,6 +623,7 @@ export interface AdRevenueReport {
   daily: AdRevenueDaily[]; // 按日期汇总序列(全量,供按天趋势图)
   hourly: AdRevenueHourly[]; // 按小时汇总序列(全量,供按小时趋势图;按天查询时为空)
   type_stats: Record<string, AdRevenueTypeStat>; // 按广告类型小计;前端取 draw / reward_video
+  category_stats?: Record<string, AdRevenueTypeStat>; // draw=draw+历史feed；video=福利视频+提现视频
   // 按信息流场景小计(comparison/coupon/welfare;全量,不受分页截断)。数据大盘「领券广告/比价广告」卡
   // 优先读它:2026-07-02 后端起 items 不再含信息流逐条展示行(唯一带收益+场景的行),按 items 现算恒 0。
   // 可选(`?.` 探测)以兼容未升级后端,缺失时回退 items 现算。