优化：明确提现审核状态与超时订单处理 (#71)

## 改动说明

- 将支付配置阻断问题改为明确、可操作的提示，技术详情默认折叠。
- 为支付配置检测和现金账本校验增加加载状态、精确时间与完成反馈。
- 账本正常时使用紧凑状态展示，异常时才显示醒目提示。
- 将“批量对账”改为“处理超时订单”，在确认弹窗中说明查单、更新状态、撤销和退款行为。
- 移除自动查单关闭提示，避免把非阻断运维状态展示成业务问题。
- 审计记录中的操作名称同步调整为“处理超时订单”。

## 验证

- `npx tsc --noEmit`
- Next.js 本地页面编译通过。
- 实际验证重新检测、重新校验和超时订单确认弹窗，浏览器控制台无错误。

## 后端配套

- WonderableAI/shaguabijia-app-server#170

---------

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

deploy/nginx/admin.shaguabijia.com.conf

@@ -32,6 +32,20 @@ server {
         proxy_read_timeout 60s;
     }
 
+    # 新手引导视频上传:视频比图片大一个量级,单独放宽到 100MB(对齐后端
+    # settings.GUIDE_VIDEO_MAX_BYTES)。不放宽全站上限,避免其它接口被大 body 打。
+    # 上传大文件耗时长,读超时同步放宽到 300s。
+    location = /admin/api/guide-video/video {
+        client_max_body_size 100m;
+        proxy_pass http://127.0.0.1:8771;
+        proxy_set_header Host $host;
+        proxy_set_header X-Forwarded-For $remote_addr;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_read_timeout 300s;
+        proxy_send_timeout 300s;
+        proxy_request_buffering off;
+    }
+
     # 用户上传媒体(上报截图 / 反馈截图 / 反馈二维码)由 App 后端(:8770)的 /media 托管。
     # admin 页面要展示这些图,经此同域反代过去(免跨域 + 免 https 页面引 http 图被拦)。
     # 前提:App 后端与本 admin 同机;若分机,把 127.0.0.1:8770 换成 App 后端可达地址。

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

@@ -66,21 +66,101 @@ const APP_TAG: Record<string, { color: string; label: string }> = {
   test: { color: 'default', label: '测试应用' },
 };
 
-// 发奖状态 → 颜色 + 中文(含「不发金币的原因」:提前关闭/未满10秒/缺eCPM/次数超限)
+const REWARD_STATUS_HINT: Record<string, string> = {
-const STATUS_TAG: Record<string, { color: string; label: string }> = {
+  granted: '已完成金币发放',
-  granted: { color: 'green', label: '已发' },
+  capped: '次数超限，未发金币',
-  capped: { color: 'orange', label: '次数超限' },
+  ecpm_missing: '缺少有效 eCPM，未发金币',
-  ecpm_missing: { color: 'red', label: '缺 eCPM' },
+  too_short: '播放时长未达到发奖条件，未发金币',
-  too_short: { color: 'gold', label: '未满10秒' },
+  closed_early: '用户提前关闭广告，未发金币',
+};
+
+const PLAYBACK_STATUS_TAG: Record<string, { color: string; label: string }> = {
+  completed: { color: 'green', label: '已完成' },
+  too_short: { color: 'gold', label: '观看时长不足' },
   closed_early: { color: 'default', label: '提前关闭' },
+  unknown: { color: 'default', label: '未知' },
 };
-const STATUS_HINT: Record<string, string> = {
+
-  granted: '已满足当前客户端发奖条件并完成金币发放。',
+const ZERO_REVENUE_REWARD_VIDEO_STATUSES = new Set(['closed_early', 'too_short']);
-  too_short: '旧版 Draw 信息流观看不足 10 秒，不发金币；新版按观看比例发放时会记为已发。',
+
-  closed_early: '用户在达到发奖条件前主动关闭，不发金币。',
+function rewardStatuses(row: AdRevenueRow): string[] {
-  capped: '已达到次数上限，不再发金币。',
+  if (row.sub_rewards?.length) return row.sub_rewards.map((reward) => reward.status);
-  ecpm_missing: '缺少有效 eCPM，无法计算金币。',
+  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;
+}
+
+function rewardStatusTag(row: AdRevenueRow) {
+  const statuses = rewardStatuses(row);
+  if (!row.has_reward || statuses.length === 0) {
+    return { color: 'default', label: '无记录', hint: '仅记录到广告展示，没有对应发奖记录。' };
+  }
+
+  const grantedCount = statuses.filter((status) => status === 'granted').length;
+  const reasonSummary = Object.entries(
+    statuses
+      .filter((status) => status !== 'granted')
+      .reduce<Record<string, number>>((counts, status) => {
+        counts[status] = (counts[status] ?? 0) + 1;
+        return counts;
+      }, {}),
+  )
+    .map(([status, count]) => `${REWARD_STATUS_HINT[status] ?? status} ${count} 条`)
+    .join('；');
+
+  if (grantedCount === statuses.length) {
+    return { color: 'green', label: '已发', hint: `已完成金币发放${statuses.length > 1 ? ` ${statuses.length} 条` : ''}。` };
+  }
+  if (grantedCount > 0) {
+    return {
+      color: 'blue',
+      label: '部分已发',
+      hint: `已发 ${grantedCount} 条，未发 ${statuses.length - grantedCount} 条${reasonSummary ? `；${reasonSummary}` : ''}。`,
+    };
+  }
+  return { color: 'default', label: '未发', hint: reasonSummary ? `${reasonSummary}。` : '未发放金币。' };
+}
+
+function playbackStatusTag(row: AdRevenueRow) {
+  const statuses = rewardStatuses(row);
+  if (statuses.length === 0) {
+    return row.has_impression
+      ? { color: 'blue', label: '仅展示', hint: '记录到广告展示，但没有对应的播放结果。' }
+      : { color: 'default', label: '无记录', hint: '没有可用的广告播放记录。' };
+  }
+
+  const playbackCounts = statuses.reduce<Record<string, number>>((counts, status) => {
+    const playbackStatus =
+      status === 'too_short' || status === 'closed_early'
+        ? status
+        : status === 'granted' || status === 'capped' || status === 'ecpm_missing'
+          ? 'completed'
+          : 'unknown';
+    counts[playbackStatus] = (counts[playbackStatus] ?? 0) + 1;
+    return counts;
+  }, {});
+  const entries = Object.entries(playbackCounts);
+  if (entries.length === 1) {
+    const [status, count] = entries[0];
+    const tag = PLAYBACK_STATUS_TAG[status];
+    return {
+      ...tag,
+      hint: `${tag.label}${count > 1 ? ` ${count} 条` : ''}。`,
+    };
+  }
+  const hint = entries
+    .map(([status, count]) => `${PLAYBACK_STATUS_TAG[status].label} ${count} 条`)
+    .join('；');
+  return { color: 'purple', label: '部分完成', hint: `${hint}。` };
+}
 
 const fmtFactorRange = (a: number | null, b: number | null) => {
   if (a == null) return '-';
@@ -300,6 +380,8 @@ export default function AdRevenueReportPage() {
   const { message } = App.useApp();
   const [range, setRange] = useState<[Dayjs, Dayjs]>([dayjs().subtract(1, 'day'), dayjs().subtract(1, 'day')]);
   const [userId, setUserId] = useState<number | null>(null);
+  const [appEnv, setAppEnv] = useState<'prod' | 'test' | 'all'>('prod');
+  const [revenueScope, setRevenueScope] = useState<'business' | 'all'>('business');
   const [adType, setAdType] = useState<string | undefined>();
   // 「场景」作为后端全局筛选(feed_scene):同时影响明细 / 合计 / 趋势,与「用户 / 类型」一致,点「查询」生效。
   const [scene, setScene] = useState<string | undefined>();
@@ -333,6 +415,8 @@ export default function AdRevenueReportPage() {
           date_from: from,
           date_to: to,
           user_id: userId ?? undefined,
+          app_env: appEnv === 'all' ? undefined : appEnv,
+          revenue_scope: revenueScope,
           ad_type: adType ?? undefined,
           feed_scene: scene ?? undefined,
           granularity: gran,
@@ -374,7 +458,7 @@ export default function AdRevenueReportPage() {
         setLoading(false);
       }
     },
-    [range, userId, adType, scene, granularity, limit, sortBy],
+    [range, userId, appEnv, revenueScope, adType, scene, granularity, limit, sortBy],
   );
 
   useEffect(() => {
@@ -474,19 +558,25 @@ export default function AdRevenueReportPage() {
       width: 110,
       align: 'right',
       // 一次比价/领券聚合行用 row_revenue_yuan(该次发奖广告 eCPM 折算之和),其它行用展示侧 revenue_yuan
-      render: (v: number, r: AdRevenueRow) => {
+      // 激励视频提前关闭/时长不足时防御性显示 0，与后端有效收益口径一致。
-        const rev = r.row_revenue_yuan ?? v;
+      render: (_v: number, r: AdRevenueRow) => effectiveRevenueYuan(r).toFixed(4),
-        return rev.toFixed(4);
-      },
     },
     {
       title: '发奖状态',
-      dataIndex: 'status',
+      key: 'reward_status',
       width: 100,
-      render: (s: string | null) => {
+      render: (_: unknown, row: AdRevenueRow) => {
-        if (!s) return <Tooltip title="仅记录广告展示，没有对应发奖事件。"><Tag>仅展示</Tag></Tooltip>;
+        const tag = rewardStatusTag(row);
-        const t = STATUS_TAG[s] ?? { color: 'default', label: s };
+        return <Tooltip title={tag.hint}><Tag color={tag.color}>{tag.label}</Tag></Tooltip>;
-        return <Tooltip title={STATUS_HINT[s]}><Tag color={t.color}>{t.label}</Tag></Tooltip>;
+      },
+    },
+    {
+      title: '广告播放状态',
+      key: 'playback_status',
+      width: 120,
+      render: (_: unknown, row: AdRevenueRow) => {
+        const tag = playbackStatusTag(row);
+        return <Tooltip title={tag.hint}><Tag color={tag.color}>{tag.label}</Tag></Tooltip>;
       },
     },
     {
@@ -528,7 +618,8 @@ export default function AdRevenueReportPage() {
     'ecpm_yuan',
     'revenue_yuan',
     'actual_coin',
-    'status',
+    'reward_status',
+    'playback_status',
     'ad_type',
     'app_env',
     'our_code_id',
@@ -614,13 +705,14 @@ export default function AdRevenueReportPage() {
               <br />
               <br />
               「预估收益」为客户端在广告展示(onAdShow)时上报 eCPM 折算的预估值(每千次展示 ÷1000
-              累加),<b>只要广告展示就计入、不论是否看完发奖</b>;穿山甲会过滤无效/过短曝光,故预估值可能偏高,
+              累加);<b>激励视频提前关闭或播放时长不足时按 0 计</b>,其他有效展示按 eCPM 折算。穿山甲仍可能过滤无效曝光,
               <b>实际收益一律以穿山甲后台结算为准</b>。测试应用多为 0。「广告位ID / 来源应用」为本期新增,历史记录留空。
               <br />
               <br />
               核心指标里的<b>「穿山甲后台收益(T+1)」</b>来自穿山甲 GroMore 数据 API(后台结算口径,次日出数):
               <b>穿山甲预估收益</b>=接口 revenue、<b>收益API</b>=各 ADN 回传更接近结算。穿山甲不提供分用户/类型/场景维度,
-              故仅在<b>全量视图</b>(未按用户/类型/场景筛选)展示;逐条事件行仍是客户端预估,不受其影响。
+              故仅在<b>可对账视图</b>(未按用户/类型/场景筛选)展示;环境和数据范围会同时作用于客户端与穿山甲汇总。
+              默认“正式 + 业务代码位”用于同口径对账;切到“全部代码位”会包含广告测试等非业务曝光。
             </div>
           }
         >
@@ -655,6 +747,31 @@ export default function AdRevenueReportPage() {
               style={{ width: 130 }}
             />
           </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">环境</Typography.Text>
+            <Select
+              value={appEnv}
+              onChange={setAppEnv}
+              style={{ width: 130 }}
+              options={[
+                { value: 'prod', label: '正式(prod)' },
+                { value: 'test', label: '测试(dev)' },
+                { value: 'all', label: '全部' },
+              ]}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">数据范围</Typography.Text>
+            <Select
+              value={revenueScope}
+              onChange={setRevenueScope}
+              style={{ width: 150 }}
+              options={[
+                { value: 'business', label: '业务代码位' },
+                { value: 'all', label: '全部代码位' },
+              ]}
+            />
+          </Space>
           <Space size={6}>
             <Typography.Text type="secondary">类型</Typography.Text>
             <Select

src/app/(main)/config/GuideVideoConfig.tsx

@@ -0,0 +1,222 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import { Button, Card, 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';
+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;
+
+/**
+ * 领券等候浮层的「新手引导视频」配置。
+ *
+ * 用户点首页「一键自动领取」→ 出等候浮层,浮层下方那块位置**前 3 次**放这支引导视频
+ * (而不是广告),每次固定发 120 金币;播完若浮层还开着,自动接着放广告(原逻辑)。
+ * 「系统配置 → 领券引导视频」tab 的一个区块。
+ *
+ * 后台只管两件事:**开关** 和 **换片**。次数(3)/ 金币(120)走服务端默认值,产品已拍板不再
+ * 开放配置,所以这里不渲染输入框、PATCH 也不带这两个字段(后端仍保留字段与默认值)。
+ */
+export default function GuideVideoConfig() {
+  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 canEdit = canDo(['operator']);
+
+  const sync = (c: GuideCfg) => {
+    setCfg(c);
+    setEnabled(c.enabled);
+  };
+
+  const load = async () => {
+    setLoading(true);
+    try {
+      const { data } = await api.get<GuideCfg>('/admin/api/guide-video');
+      sync(data);
+    } finally {
+      setLoading(false);
+    }
+  };
+  useEffect(() => {
+    load();
+  }, []);
+
+  const save = async () => {
+    setSaving(true);
+    try {
+      const { data } = await api.patch<GuideCfg>('/admin/api/guide-video', { enabled });
+      sync(data);
+      message.success('已保存，用户下一次进入领券浮层即生效');
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  // antd Upload:beforeUpload 里自行 POST(multipart),返回 false 阻止其默认上传。
+  const beforeUpload = (file: File) => {
+    // 有些系统给 .mp4 的 type 是空串,不能只看 type,再兜一层扩展名。
+    const looksMp4 = file.type === 'video/mp4' || /\.mp4$/i.test(file.name);
+    if (!looksMp4) {
+      message.error('仅支持 MP4 视频（H.264 编码）');
+      return Upload.LIST_IGNORE;
+    }
+    if (file.size > MAX_BYTES) {
+      message.error('视频不能超过 100MB');
+      return Upload.LIST_IGNORE;
+    }
+    void uploadVideo(file);
+    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');
+      sync(data);
+      message.success('已移除引导视频，领券浮层恢复为只放广告');
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setUploading(false);
+    }
+  };
+
+  return (
+    <Card
+      size="small"
+      title="领券引导视频（App 领券等候浮层，前 3 次替代广告）"
+      style={{ marginBottom: 16 }}
+      extra={
+        cfg?.updated_at ? (
+          <Text type="secondary" style={{ fontSize: 12 }}>
+            更新于 {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>
+      {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>
+            )}
+          </div>
+
+          {/* 右:编辑控件 */}
+          <Space direction="vertical" size="middle" style={{ minWidth: 360 }}>
+            <Space>
+              <span>启用引导视频：</span>
+              <Switch checked={enabled} disabled={!canEdit} onChange={setEnabled} />
+              {!enabled && <Tag color="orange">已关闭</Tag>}
+            </Space>
+
+            <Space wrap>
+              <Upload accept="video/mp4,.mp4" showUploadList={false} beforeUpload={beforeUpload} disabled={!canEdit}>
+                <Button icon={<UploadOutlined />} loading={uploading} disabled={!canEdit}>
+                  {cfg.video_url ? '更换视频' : '上传视频'}
+                </Button>
+              </Upload>
+              {cfg.video_url && (
+                <Button
+                  icon={<DeleteOutlined />}
+                  danger
+                  loading={uploading}
+                  disabled={!canEdit}
+                  onClick={removeVideo}
+                >
+                  移除视频
+                </Button>
+              )}
+              <Text type="secondary" style={{ fontSize: 12 }}>
+                MP4（H.264），≤100MB
+              </Text>
+            </Space>
+
+            <Button type="primary" loading={saving} disabled={!canEdit} onClick={save}>
+              保存开关
+            </Button>
+            {!canEdit && <Text type="secondary">仅 operator / super_admin 可修改</Text>}
+          </Space>
+        </Space>
+      )}
+    </Card>
+  );
+}

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

@@ -6,6 +6,7 @@ import { api, errMsg } from '@/lib/api';
 import HomeMarqueeSeeds from './HomeMarqueeSeeds';
 import HomeStatsConfig from './HomeStatsConfig';
 import FeedbackQrConfig from './FeedbackQrConfig';
+import GuideVideoConfig from './GuideVideoConfig';
 
 interface ConfigItem {
   key: string;
@@ -164,6 +165,7 @@ export default function ConfigPage() {
           },
           { key: 'welfare', label: '福利页', children: welfareConfig },
           { key: 'feedback-qr', label: '反馈二维码', children: <FeedbackQrConfig /> },
+          { key: 'guide-video', label: '领券引导视频', children: <GuideVideoConfig /> },
         ]}
       />
     </div>

src/app/(main)/coupon-data/page.tsx

@@ -10,9 +10,11 @@ import {
   DatePicker,
   Divider,
   Input,
+  Popover,
   Row,
   Select,
   Space,
+  Spin,
   Statistic,
   Table,
   Tag,
@@ -72,9 +74,23 @@ interface CouponDataRow {
   app_env: string | null;
   started_at: string;
   claimed_count: number | null;
+  point_success_count: number | null;
+  point_total_count: number | null;
+  // 兼容旧后端的内嵌明细；新后端不再返回，改为点击后按 trace 加载。
+  point_details?: CouponPointDetail[];
   trace_url: string | null;
   ad_revenue_yuan: number | null; // 本次领券看的信息流广告预估收益(元);未填充为 null
 }
+interface CouponPointDetail {
+  coupon_id: string;
+  coupon_name: string | null;
+  status: string;
+  reason: string | null;
+}
+interface CouponPointDetailsOut {
+  trace_id: string;
+  items: CouponPointDetail[];
+}
 interface CouponDataReport {
   date_from: string;
   date_to: string;
@@ -116,6 +132,103 @@ const STATUS_TAG: Record<string, { color: string; label: string }> = {
   abandoned: { color: 'orange', label: '中途退出' },
 };
 
+const POINT_STATUS_TAG: Record<string, { color: string; label: string }> = {
+  success: { color: 'success', label: '成功' },
+  already_claimed: { color: 'processing', label: '已领' },
+  failed: { color: 'error', label: '失败' },
+  skipped: { color: 'default', label: '跳过' },
+};
+
+function PointScorePopover({ row }: { row: CouponDataRow }) {
+  const { message } = App.useApp();
+  const [details, setDetails] = useState<CouponPointDetail[] | null>(row.point_details ?? null);
+  const [loading, setLoading] = useState(false);
+  const [loadError, setLoadError] = useState<string | null>(null);
+
+  if (row.point_success_count == null || row.point_total_count == null || row.point_total_count <= 0) {
+    return <Typography.Text type="secondary">-</Typography.Text>;
+  }
+  const score = `${row.point_success_count}/${row.point_total_count}`;
+  const scoreWithRate = `${score}（${(
+    row.point_success_count / row.point_total_count * 100
+  ).toFixed(1)}%）`;
+  const scoreColor =
+    row.point_success_count === row.point_total_count
+      ? STATUS_TAG.completed.color
+      : STATUS_TAG.abandoned.color;
+  const loadDetails = async () => {
+    if (details !== null || loading) return;
+    setLoading(true);
+    setLoadError(null);
+    try {
+      const response = await api.get<CouponPointDetailsOut>('/admin/api/coupon-data/point-details', {
+        params: { trace_id: row.trace_id },
+      });
+      setDetails(response.data.items);
+    } catch (error) {
+      const errorMessage = errMsg(error);
+      setLoadError(errorMessage);
+      message.error(errorMessage);
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <Popover
+      trigger="click"
+      placement="bottomLeft"
+      title={`点位明细（${score}）`}
+      onOpenChange={(open) => {
+        if (open) void loadDetails();
+      }}
+      content={(
+        <div style={{ width: 380, maxHeight: 360, overflowY: 'auto' }}>
+          {loading || (details === null && loadError === null) ? (
+            <Spin size="small" style={{ display: 'block', margin: '24px auto' }} />
+          ) : loadError ? (
+            <Typography.Text type="danger">明细加载失败，请关闭后重试</Typography.Text>
+          ) : details && details.length > 0 ? details.map((point, index) => {
+            const status = POINT_STATUS_TAG[point.status] ?? {
+              color: 'default', label: point.status,
+            };
+            return (
+              <div
+                key={`${point.coupon_id}-${index}`}
+                style={{
+                  padding: '8px 0',
+                  borderBottom: index < details.length - 1 ? '1px solid #f0f0f0' : undefined,
+                }}
+              >
+                <div style={{ display: 'flex', alignItems: 'flex-start', gap: 12 }}>
+                  <div style={{ flex: 1, minWidth: 0 }}>
+                    <Typography.Text>{point.coupon_name || point.coupon_id}</Typography.Text>
+                    {point.coupon_name ? (
+                      <div><Typography.Text type="secondary">{point.coupon_id}</Typography.Text></div>
+                    ) : null}
+                  </div>
+                  <Tag color={status.color} style={{ marginInlineEnd: 0 }}>{status.label}</Tag>
+                </div>
+                {point.reason ? (
+                  <div style={{ marginTop: 4 }}>
+                    <Typography.Text type="danger">原因：{point.reason}</Typography.Text>
+                  </div>
+                ) : null}
+              </div>
+            );
+          }) : (
+            <Typography.Text type="secondary">暂无点位明细</Typography.Text>
+          )}
+        </div>
+      )}
+    >
+      <Button type="link" size="small" style={{ height: 'auto', padding: 0, color: scoreColor }}>
+        {scoreWithRate}
+      </Button>
+    </Popover>
+  );
+}
+
 // ms → "1.5s"(空值显示 -)
 const fmtSec = (ms: number | null | undefined): string =>
   ms == null ? '-' : `${(ms / 1000).toFixed(1)}s`;
@@ -492,20 +605,10 @@ export default function CouponDataPage() {
       render: (v: number | null) => fmtSec(v),
     },
     {
-      title: '点位成功率',
+      title: '单券成功率',
       key: 'point_success_rate',
-      width: 110,
+      width: 150,
-      render: (_: unknown, r: CouponDataRow) => (
+      render: (_: unknown, r: CouponDataRow) => <PointScorePopover row={r} />,
-        <Tooltip title="当前接口未返回本场应领点位及逐点结果，前端不使用全局均值冒充本场成功率。">
-          {r.trace_url ? (
-            <a href={r.trace_url} target="_blank" rel="noreferrer">
-              查看明细
-            </a>
-          ) : (
-            <Typography.Text type="secondary">待埋点</Typography.Text>
-          )}
-        </Tooltip>
-      ),
     },
     {
       title: '广告收益',

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

@@ -499,12 +499,7 @@ export default function DashboardPage() {
   const tokenCostYuan = periodData?.comparison.token_cost_total_yuan ?? null;
   const couponRewardCoinTotal = periodData?.coins.coupon_reward_coin_total;
   const comparisonRewardCoinTotal = periodData?.coins.comparison_reward_coin_total;
-  const signinCoinTotal = periodData?.coins.signin_coin_total;
+  const regularTaskCoinTotal = periodData?.coins.regular_task_coin_total;
-  const signinBoostCoinTotal = periodData?.coins.signin_boost_coin_total;
-  const taskCoinTotal = periodData?.coins.task_coin_total;
-  const regularTaskCoinTotal =
-    periodData?.coins.regular_task_coin_total ??
-    ((signinCoinTotal ?? 0) + (signinBoostCoinTotal ?? 0) + (taskCoinTotal ?? 0));
   const cpsAvailable = data?.cps.available === true;
   const meituanCpsCommissionCents = data?.cps.meituan_commission_cents;
   const jdCpsCommissionCents = data?.cps.jd_commission_cents;
@@ -1070,13 +1065,14 @@ export default function DashboardPage() {
             value={fmtInt(periodData?.coins.reward_video_coin_total)}
             delta={rewardVideoCoinRatio.value}
             deltaTone={rewardVideoCoinRatio.tone}
-            hint="独立统计看视频发放，不再重复计入领券奖励。"
+            hint="普通看视频与历史签到膨胀的实发金币之和，不再重复计入领券奖励或常规任务。"
           />
           <StatCard
             title="常规任务金币"
             value={fmtInt(regularTaskCoinTotal)}
             delta={regularTaskCoinRatio.value}
             deltaTone={regularTaskCoinRatio.tone}
+            hint="每日签到、通知/其他任务、上报更低价和反馈采纳的实发金币之和。"
           />
           <StatCard
             title="本期提现金额"

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

@@ -4,11 +4,15 @@ import { useEffect, useState } from 'react';
 import type { ColumnsType } from 'antd/es/table';
 import type { SorterResult } from 'antd/es/table/interface';
 import {
+  App,
   Button,
   Card,
   DatePicker,
+  Form,
   Image,
   Input,
+  InputNumber,
+  Modal,
   Select,
   Space,
   Statistic,
@@ -17,9 +21,12 @@ import {
   Typography,
 } from 'antd';
 import type { Dayjs } from 'dayjs';
-import { api } from '@/lib/api';
+import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
 import { formatWallTime } from '@/lib/format';
+import { refreshReviewBadge } from '@/lib/reviewBadge';
+import { BULK_REVIEW_MAX, bulkFailureReasonText, failedReviewIds } from '@/lib/bulkAction';
+import type { BulkReviewResult } from '@/lib/bulkAction';
 import { usePagedList } from '@/lib/usePagedList';
 import type { Feedback, FeedbackSummary } from '@/lib/types';
 import FeedbackHandleDrawer from './FeedbackHandleDrawer';
@@ -27,6 +34,7 @@ import UserRecordsDrawer from '@/components/UserRecordsDrawer';
 
 const { Text, Paragraph } = Typography;
 const { RangePicker } = DatePicker;
+const REWARD_MAX = 10000;
 
 // 截图是 app-server 的 /media 相对路径,本地由 :8770 提供(NEXT_PUBLIC_MEDIA_BASE);生产同域走 nginx 代理。
 const MEDIA_BASE = process.env.NEXT_PUBLIC_MEDIA_BASE || '';
@@ -154,6 +162,8 @@ const RECORD_COLUMNS: ColumnsType<Feedback> = [
 ];
 
 export default function FeedbacksPage() {
+  const { message } = App.useApp();
+  const [bulkForm] = Form.useForm();
   // 筛选草稿:点「查询」才应用(避免输入即刷新)
   const [status, setStatus] = useState<string | undefined>();
   const [source, setSource] = useState<string | undefined>();
@@ -170,6 +180,19 @@ export default function FeedbacksPage() {
     usePagedList<Feedback>('/admin/api/feedbacks', filters);
 
   const canReview = canDo(['operator']);
+  const [selectedRowKeys, setSelectedRowKeys] = useState<number[]>([]);
+  const [bulkAction, setBulkAction] = useState<'approve' | 'reject' | null>(null);
+  const [bulkSubmitting, setBulkSubmitting] = useState(false);
+  const selectedFeedbacks = items.filter(
+    (item) => selectedRowKeys.includes(item.id) && isPending(item.status),
+  );
+
+  useEffect(() => {
+    const visiblePendingIds = new Set(
+      items.filter((item) => isPending(item.status)).map((item) => item.id),
+    );
+    setSelectedRowKeys((keys) => keys.filter((id) => visiblePendingIds.has(id)));
+  }, [items]);
 
   const [summary, setSummary] = useState<FeedbackSummary | null>(null);
   const loadSummary = async () => {
@@ -235,6 +258,61 @@ export default function FeedbacksPage() {
   const sortOrderOf = (field: SortField) =>
     sortBy === field ? (sortOrder === 'asc' ? 'ascend' : 'descend') : null;
 
+  const openBulkModal = (action: 'approve' | 'reject') => {
+    if (!selectedFeedbacks.length) return;
+    if (selectedFeedbacks.length > BULK_REVIEW_MAX) {
+      message.warning(`单次最多审核 ${BULK_REVIEW_MAX} 条反馈`);
+      return;
+    }
+    bulkForm.resetFields();
+    setBulkAction(action);
+  };
+
+  const submitBulkReview = async () => {
+    if (!bulkAction || !selectedFeedbacks.length) return;
+    const values = await bulkForm.validateFields();
+    const targets = selectedFeedbacks;
+    setBulkSubmitting(true);
+    try {
+      const { data } = await api.post<BulkReviewResult>(
+        `/admin/api/feedbacks/bulk/${bulkAction}`,
+        bulkAction === 'approve'
+          ? {
+              ids: targets.map((item) => item.id),
+              reward_coins: values.reward_coins,
+              note: values.note?.trim() || null,
+              reply: values.reply?.trim() || null,
+            }
+          : {
+              ids: targets.map((item) => item.id),
+              reason: values.reason.trim(),
+              note: values.note?.trim() || null,
+              reply: values.reply?.trim() || null,
+            },
+      );
+      const failedIds = failedReviewIds(data);
+      setSelectedRowKeys(failedIds);
+      setBulkAction(null);
+      bulkForm.resetFields();
+      if (failedIds.length) reload();
+      else onPageChange(1, pageSize);
+      loadSummary();
+      refreshReviewBadge('/feedbacks');
+      const label = bulkAction === 'approve' ? '批量采纳' : '批量拒绝';
+      if (failedIds.length) {
+        message.warning(
+          `${label}完成：成功 ${data.success} 条，失败 ${failedIds.length} 条；失败项已保留勾选${bulkFailureReasonText(data)}`,
+        );
+      } else {
+        message.success(`${label}完成：成功 ${data.success} 条`);
+      }
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setBulkSubmitting(false);
+    }
+  };
+
   const columns: ColumnsType<Feedback> = [
     {
       title: '用户ID',
@@ -410,16 +488,58 @@ export default function FeedbacksPage() {
         <Button onClick={resetFilters}>重置</Button>
       </Space>
 
+      {canReview && (
+        <Space wrap style={{ display: 'flex', marginBottom: 12 }}>
+          <Text>已选 <Text strong>{selectedFeedbacks.length}</Text> 条待审核反馈</Text>
+          <Button
+            type="primary"
+            disabled={!selectedFeedbacks.length || selectedFeedbacks.length > BULK_REVIEW_MAX}
+            onClick={() => openBulkModal('approve')}
+          >
+            批量采纳
+          </Button>
+          <Button
+            danger
+            disabled={!selectedFeedbacks.length || selectedFeedbacks.length > BULK_REVIEW_MAX}
+            onClick={() => openBulkModal('reject')}
+          >
+            批量拒绝
+          </Button>
+          {!!selectedFeedbacks.length && (
+            <Button onClick={() => setSelectedRowKeys([])}>取消选择</Button>
+          )}
+        </Space>
+      )}
+
       <Table
         rowKey="id"
         columns={columns}
         dataSource={items}
+        rowSelection={
+          canReview
+            ? {
+                selectedRowKeys,
+                onChange: (keys) => {
+                  const ids = keys as number[];
+                  if (ids.length > BULK_REVIEW_MAX) {
+                    message.warning(`单次最多选择 ${BULK_REVIEW_MAX} 条待审核反馈`);
+                  }
+                  setSelectedRowKeys(ids.slice(0, BULK_REVIEW_MAX));
+                },
+                getCheckboxProps: (record) => ({
+                  disabled: !isPending(record.status),
+                  name: `选择反馈 #${record.id}`,
+                }),
+              }
+            : undefined
+        }
         loading={loading}
         pagination={{
           current: page,
           pageSize,
           total,
           showSizeChanger: true,
+          pageSizeOptions: [10, 20, 50],
           showTotal: (t) => `共 ${t} 条反馈`,
           onChange: onPageChange,
         }}
@@ -427,11 +547,97 @@ export default function FeedbacksPage() {
         scroll={{ x: 1720 }}
       />
 
+      <Modal
+        title={
+          bulkAction === 'approve'
+            ? `批量采纳 ${selectedFeedbacks.length} 条反馈`
+            : `批量拒绝 ${selectedFeedbacks.length} 条反馈`
+        }
+        open={bulkAction != null}
+        okText={bulkAction === 'approve' ? '批量采纳并发金币' : '确认批量拒绝'}
+        okButtonProps={{ danger: bulkAction === 'reject' }}
+        confirmLoading={bulkSubmitting}
+        onOk={submitBulkReview}
+        onCancel={() => {
+          if (bulkSubmitting) return;
+          setBulkAction(null);
+          bulkForm.resetFields();
+        }}
+        destroyOnHidden
+      >
+        <Text type="secondary">
+          下列设置会统一应用到已选的 {selectedFeedbacks.length}
+          条反馈。批量操作前请确认每条内容适用相同处理结果。
+        </Text>
+        <Form form={bulkForm} layout="vertical" preserve={false} style={{ marginTop: 16 }}>
+          {bulkAction === 'approve' ? (
+            <Form.Item
+              name="reward_coins"
+              label={`每条奖励金币（必填，1 ~ ${REWARD_MAX}）`}
+              rules={[
+                { required: true, message: '请输入每条反馈的奖励金币' },
+                { type: 'number', min: 1, max: REWARD_MAX, message: `请输入 1 ~ ${REWARD_MAX}` },
+              ]}
+            >
+              <InputNumber
+                min={1}
+                max={REWARD_MAX}
+                style={{ width: '100%' }}
+                placeholder="每条反馈发放相同金币"
+              />
+            </Form.Item>
+          ) : (
+            <Form.Item
+              name="reason"
+              label="未采纳原因（必填，用户可见）"
+              rules={[
+                { required: true, whitespace: true, message: '请填写未采纳原因' },
+                { max: 256, message: '最多 256 字' },
+              ]}
+            >
+              <Input.TextArea
+                rows={3}
+                maxLength={256}
+                showCount
+                placeholder="同一原因将发送给全部已选用户"
+              />
+            </Form.Item>
+          )}
+          <Form.Item
+            name="note"
+            label={
+              bulkAction === 'approve'
+                ? '采纳要点 / 审核备注（选填，内部）'
+                : '内部备注（选填）'
+            }
+            rules={[{ max: 256, message: '最多 256 字' }]}
+          >
+            <Input.TextArea rows={2} maxLength={256} showCount />
+          </Form.Item>
+          <Form.Item
+            name="reply"
+            label="给用户的回复（选填，用户可见）"
+            rules={[{ max: 256, message: '最多 256 字' }]}
+          >
+            <Input.TextArea
+              rows={2}
+              maxLength={256}
+              showCount
+              placeholder="同一回复将发送给全部已选用户"
+            />
+          </Form.Item>
+        </Form>
+      </Modal>
+
       <FeedbackHandleDrawer
         feedback={drawerFb}
         open={drawerOpen}
         onClose={() => setDrawerOpen(false)}
-        onDone={() => { reload(); loadSummary(); }}
+        onDone={() => {
+          reload();
+          loadSummary();
+          refreshReviewBadge('/feedbacks');
+        }}
       />
 
       <UserRecordsDrawer<Feedback>

src/app/(main)/layout.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useEffect, useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
 import { usePathname, useRouter } from 'next/navigation';
 import {
   BarChartOutlined,
@@ -25,7 +25,16 @@ import {
 import { Avatar, Dropdown, Layout, Tooltip } from 'antd';
 import { api } from '@/lib/api';
 import { clearAuth, getAdmin, getToken, setAuth } from '@/lib/auth';
-import type { AdminInfo } from '@/lib/types';
+import {
+  REVIEW_BADGE_REFRESH_EVENT,
+  type ReviewBadgeKey,
+} from '@/lib/reviewBadge';
+import type {
+  AdminInfo,
+  FeedbackSummary,
+  PriceReportSummary,
+  WithdrawSummary,
+} from '@/lib/types';
 
 const { Sider, Header, Content } = Layout;
 
@@ -58,8 +67,6 @@ const NAV_GROUPS: NavGroup[] = [
       { key: '/comparison-records', icon: <ProfileOutlined />, label: '比价记录' },
       { key: '/coupon-data', icon: <GiftOutlined />, label: '领券记录' },
       { key: '/cps', icon: <ShareAltOutlined />, label: 'CPS收益' },
-      { key: '/device-liveness', icon: <HeartOutlined />, label: '设备存活' },
-      { key: '/analytics-health', icon: <LineChartOutlined />, label: '埋点成功率' },
     ],
   },
   {
@@ -83,9 +90,18 @@ const NAV_GROUPS: NavGroup[] = [
       { key: '/users', icon: <UserOutlined />, label: '用户管理' },
     ],
   },
-  { key: '/admins', icon: <TeamOutlined />, label: '权限管理' },
+  {
+    key: 'monitoring-audit',
+    icon: <FileSearchOutlined />,
+    label: '监控审计',
+    children: [
+      { key: '/device-liveness', icon: <HeartOutlined />, label: '设备存活' },
+      { key: '/analytics-health', icon: <LineChartOutlined />, label: '埋点成功率' },
       { key: '/event-logs', icon: <DatabaseOutlined />, label: '埋点日志' },
       { key: '/audit-logs', icon: <FileSearchOutlined />, label: '审计日志' },
+    ],
+  },
+  { key: '/admins', icon: <TeamOutlined />, label: '权限管理' },
 ];
 
 // 导航项 key(/dashboard)→ 权限页 key(dashboard),与后端 permissions.py 目录对齐
@@ -96,6 +112,8 @@ export default function MainLayout({ children }: { children: React.ReactNode })
   const pathname = usePathname();
   const [admin, setAdmin] = useState<AdminInfo | null>(null);
   const [collapsed, setCollapsed] = useState(false);
+  const [pendingReviewCounts, setPendingReviewCounts] = useState<Partial<Record<ReviewBadgeKey, number>>>({});
+  const reviewRefreshVersion = useRef<Partial<Record<ReviewBadgeKey, number>>>({});
 
   useEffect(() => {
     const token = getToken();
@@ -114,6 +132,44 @@ export default function MainLayout({ children }: { children: React.ReactNode })
       .catch(() => {});
   }, [router]);
 
+  useEffect(() => {
+    if (!admin) return;
+    const canAccess = (page: string) =>
+      admin.role === 'super_admin' || !admin.pages || admin.pages.includes(page);
+
+    const refresh = async (key: ReviewBadgeKey) => {
+      if (!canAccess(key.slice(1))) return;
+      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;
+      } else if (key === '/price-reports') {
+        count = (await api.get<PriceReportSummary>('/admin/api/price-reports/summary')).data.pending;
+      } else {
+        count = (await api.get<FeedbackSummary>('/admin/api/feedbacks/summary')).data.pending;
+      }
+      if (reviewRefreshVersion.current[key] !== version) return;
+      setPendingReviewCounts((current) => ({ ...current, [key]: count }));
+    };
+
+    const refreshSafely = (key: ReviewBadgeKey) => refresh(key).catch(() => {});
+    void Promise.all([
+      refreshSafely('/withdraws'),
+      refreshSafely('/price-reports'),
+      refreshSafely('/feedbacks'),
+    ]);
+
+    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);
+    };
+  }, [admin]);
+
   if (!admin) return null; // 守卫期间不闪烁内容
 
   // 选中态:取路径一级(/users/123 -> /users)
@@ -132,6 +188,20 @@ export default function MainLayout({ children }: { children: React.ReactNode })
     hasChildren(group) ? group.children : [group],
   );
 
+  const reviewBadge = (key: string) => {
+    const count = pendingReviewCounts[key as ReviewBadgeKey] ?? 0;
+    if (count <= 0) return null;
+    return (
+      <span
+        className="nav-review-badge"
+        aria-label={`${count} 条未审核`}
+        title={`${count} 条未审核`}
+      >
+        {count}
+      </span>
+    );
+  };
+
   const logout = () => {
     clearAuth();
     router.replace('/login');
@@ -166,6 +236,7 @@ export default function MainLayout({ children }: { children: React.ReactNode })
                     aria-label={item.label}
                   >
                     {item.icon}
+                    {reviewBadge(item.key)}
                   </button>
                 </Tooltip>
               ))
@@ -183,7 +254,8 @@ export default function MainLayout({ children }: { children: React.ReactNode })
                       onClick={() => router.push(group.key)}
                     >
                       <span className="nav-primary-icon">{group.icon}</span>
-                      <span>{group.label}</span>
+                      <span className="nav-item-label">{group.label}</span>
+                      {reviewBadge(group.key)}
                     </button>
                   );
                 }
@@ -202,7 +274,8 @@ export default function MainLayout({ children }: { children: React.ReactNode })
                           onClick={() => router.push(child.key)}
                         >
                           <span className="nav-child-icon">{child.icon}</span>
-                          <span>{child.label}</span>
+                          <span className="nav-item-label">{child.label}</span>
+                          {reviewBadge(child.key)}
                         </button>
                       ))}
                     </div>
@@ -269,6 +342,29 @@ export default function MainLayout({ children }: { children: React.ReactNode })
           color: rgba(255, 255, 255, 0.72);
           font-size: 16px;
         }
+        .nav-item-label {
+          min-width: 0;
+          flex: 1;
+        }
+        .nav-review-badge {
+          display: inline-flex;
+          align-items: center;
+          justify-content: center;
+          box-sizing: border-box;
+          flex: 0 0 auto;
+          min-width: 18px;
+          height: 18px;
+          padding: 0 5px;
+          border-radius: 9px;
+          background: #ff4d4f;
+          color: #fff;
+          font-size: 11px;
+          font-weight: 600;
+          line-height: 18px;
+          white-space: nowrap;
+          font-variant-numeric: tabular-nums;
+          box-shadow: 0 0 0 1px rgba(0, 0, 0, 0.08);
+        }
         .nav-direct,
         .nav-child,
         .nav-icon-button {
@@ -332,6 +428,7 @@ export default function MainLayout({ children }: { children: React.ReactNode })
           padding: 0 8px 14px;
         }
         .nav-icon-button {
+          position: relative;
           display: inline-flex;
           align-items: center;
           justify-content: center;
@@ -342,6 +439,11 @@ export default function MainLayout({ children }: { children: React.ReactNode })
           color: rgba(255, 255, 255, 0.72);
           font-size: 17px;
         }
+        .nav-icon-button .nav-review-badge {
+          position: absolute;
+          top: 1px;
+          right: -6px;
+        }
         .nav-icon-button:hover,
         .nav-icon-button.is-selected {
           background: #1677ff;

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

@@ -22,6 +22,9 @@ import dayjs from 'dayjs';
 import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
 import { mediaUrl } from '@/lib/media';
+import { refreshReviewBadge } from '@/lib/reviewBadge';
+import { BULK_REVIEW_MAX, bulkFailureReasonText, failedReviewIds } from '@/lib/bulkAction';
+import type { BulkReviewResult } from '@/lib/bulkAction';
 import { usePagedList } from '@/lib/usePagedList';
 import type { PriceReport, PriceReportSummary } from '@/lib/types';
 import UserRecordsDrawer from '@/components/UserRecordsDrawer';
@@ -131,7 +134,10 @@ export default function PriceReportsPage() {
   const [activeStatus, setActiveStatus] = useState('pending');
   const [summary, setSummary] = useState<PriceReportSummary | null>(null);
   const [rejecting, setRejecting] = useState<PriceReport | null>(null);
+  const [bulkRejecting, setBulkRejecting] = useState<PriceReport[]>([]);
   const [rejectReason, setRejectReason] = useState('');
+  const [rejectSubmitting, setRejectSubmitting] = useState(false);
+  const [selectedRowKeys, setSelectedRowKeys] = useState<number[]>([]);
   // 提交时间列服务端排序(默认按提交时间倒序,最新在前)
   const [sortBy, setSortBy] = useState<SortField>('created_at');
   const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc');
@@ -164,6 +170,16 @@ export default function PriceReportsPage() {
   };
 
   const canReview = canDo(['operator']);
+  const selectedReports = items.filter(
+    (item) => selectedRowKeys.includes(item.id) && item.status === 'pending',
+  );
+
+  useEffect(() => {
+    const visiblePendingIds = new Set(
+      items.filter((item) => item.status === 'pending').map((item) => item.id),
+    );
+    setSelectedRowKeys((keys) => keys.filter((id) => visiblePendingIds.has(id)));
+  }, [items]);
 
   const loadSummary = async () => {
     try {
@@ -182,6 +198,49 @@ export default function PriceReportsPage() {
     loadSummary();
   };
 
+  const reportBulkResult = (label: string, result: BulkReviewResult) => {
+    const failedIds = failedReviewIds(result);
+    setSelectedRowKeys(failedIds);
+    refreshReviewBadge('/price-reports');
+    loadSummary();
+    if (failedIds.length) reload();
+    else onPageChange(1, pageSize);
+    if (failedIds.length) {
+      message.warning(
+        `${label}完成：成功 ${result.success} 条，失败 ${failedIds.length} 条；失败项已保留勾选${bulkFailureReasonText(result)}`,
+      );
+    } else {
+      message.success(`${label}完成：成功 ${result.success} 条`);
+    }
+  };
+
+  const bulkApprove = () => {
+    const targets = selectedReports;
+    if (!targets.length) return;
+    if (targets.length > BULK_REVIEW_MAX) {
+      message.warning(`单次最多审核 ${BULK_REVIEW_MAX} 条记录`);
+      return;
+    }
+    modal.confirm({
+      title: `确认批量通过 ${targets.length} 条低价上报？`,
+      icon: <CheckCircleOutlined style={{ color: '#52c41a' }} />,
+      content: `通过后将向每位用户发放 1000 金币，共发放 ${targets.length * 1000} 金币。请确认已逐条核实截图。`,
+      okText: '批量通过并发金币',
+      onOk: async () => {
+        try {
+          const { data } = await api.post<BulkReviewResult>(
+            '/admin/api/price-reports/bulk/approve',
+            { ids: targets.map((item) => item.id) },
+          );
+          reportBulkResult('批量通过', data);
+        } catch (e) {
+          message.error(errMsg(e));
+          throw e;
+        }
+      },
+    });
+  };
+
   const approve = (r: PriceReport) => {
     modal.confirm({
       title: '确认通过该上报?',
@@ -202,6 +261,7 @@ export default function PriceReportsPage() {
       onOk: async () => {
         try {
           await api.post(`/admin/api/price-reports/${r.id}/approve`);
+          refreshReviewBadge('/price-reports');
           message.success('已通过，已发放 1000 金币');
           refreshAfterChange();
         } catch (e) {
@@ -212,20 +272,38 @@ export default function PriceReportsPage() {
   };
 
   const confirmReject = async () => {
-    if (!rejecting) return;
+    const targets = bulkRejecting.length ? bulkRejecting : rejecting ? [rejecting] : [];
+    if (!targets.length) return;
+    if (targets.length > BULK_REVIEW_MAX) {
+      message.warning(`单次最多审核 ${BULK_REVIEW_MAX} 条记录`);
+      return;
+    }
     const reason = rejectReason.trim();
     if (!reason) {
       message.warning('请填写拒绝理由');
       return;
     }
+    setRejectSubmitting(true);
     try {
-      await api.post(`/admin/api/price-reports/${rejecting.id}/reject`, { reason });
+      if (bulkRejecting.length) {
+        const { data } = await api.post<BulkReviewResult>(
+          '/admin/api/price-reports/bulk/reject',
+          { ids: targets.map((item) => item.id), reason },
+        );
+        reportBulkResult('批量拒绝', data);
+      } else {
+        await api.post(`/admin/api/price-reports/${targets[0].id}/reject`, { reason });
+        refreshReviewBadge('/price-reports');
         message.success('已拒绝');
-      setRejecting(null);
-      setRejectReason('');
         refreshAfterChange();
+      }
+      setRejecting(null);
+      setBulkRejecting([]);
+      setRejectReason('');
     } catch (e) {
       message.error(errMsg(e));
+    } finally {
+      setRejectSubmitting(false);
     }
   };
 
@@ -390,10 +468,56 @@ export default function PriceReportsPage() {
           onChange={setActiveStatus}
           items={STATUS_TABS.map((t) => ({ key: t.key, label: t.label }))}
         />
+        {canReview && (
+          <Space wrap style={{ marginBottom: 16 }}>
+            <Text>已选 <Text strong>{selectedReports.length}</Text> 条待审核记录</Text>
+            <Button
+              type="primary"
+              icon={<CheckCircleOutlined />}
+              disabled={!selectedReports.length || selectedReports.length > BULK_REVIEW_MAX}
+              onClick={bulkApprove}
+            >
+              批量通过
+            </Button>
+            <Button
+              danger
+              icon={<CloseCircleOutlined />}
+              disabled={!selectedReports.length || selectedReports.length > BULK_REVIEW_MAX}
+              onClick={() => {
+                setRejecting(null);
+                setBulkRejecting(selectedReports);
+                setRejectReason('');
+              }}
+            >
+              批量拒绝
+            </Button>
+            {!!selectedReports.length && (
+              <Button onClick={() => setSelectedRowKeys([])}>取消选择</Button>
+            )}
+          </Space>
+        )}
         <Table
           rowKey="id"
           columns={columns}
           dataSource={items}
+          rowSelection={
+            canReview
+              ? {
+                  selectedRowKeys,
+                  onChange: (keys) => {
+                    const ids = keys as number[];
+                    if (ids.length > BULK_REVIEW_MAX) {
+                      message.warning(`单次最多选择 ${BULK_REVIEW_MAX} 条待审核记录`);
+                    }
+                    setSelectedRowKeys(ids.slice(0, BULK_REVIEW_MAX));
+                  },
+                  getCheckboxProps: (record) => ({
+                    disabled: record.status !== 'pending',
+                    name: `选择低价上报 #${record.id}`,
+                  }),
+                }
+              : undefined
+          }
           loading={loading}
           onChange={onTableChange}
           pagination={{
@@ -401,6 +525,7 @@ export default function PriceReportsPage() {
             pageSize,
             total,
             showSizeChanger: true,
+            pageSizeOptions: [10, 20, 50],
             showTotal: (t) => `共 ${t} 条`,
             onChange: onPageChange,
           }}
@@ -409,21 +534,25 @@ export default function PriceReportsPage() {
       </Card>
 
       <Modal
-        title="拒绝上报"
+        title={bulkRejecting.length ? `批量拒绝 ${bulkRejecting.length} 条低价上报` : '拒绝上报'}
-        open={!!rejecting}
+        open={!!(rejecting || bulkRejecting.length)}
         okText="确认拒绝"
+        confirmLoading={rejectSubmitting}
         okButtonProps={{ danger: true, icon: <CloseCircleOutlined /> }}
         onOk={confirmReject}
         onCancel={() => {
           setRejecting(null);
+          setBulkRejecting([]);
           setRejectReason('');
         }}
       >
-        {rejecting && (
+        {(rejecting || bulkRejecting.length > 0) && (
           <Space direction="vertical" style={{ width: '100%' }}>
-            <Text>
+            {bulkRejecting.length ? (
-              用户 #{rejecting.user_id} · {rejecting.store_name || '-'}
+              <Text type="secondary">以下原因会统一应用到已选的 {bulkRejecting.length} 条记录。</Text>
-            </Text>
+            ) : rejecting ? (
+              <Text>用户 #{rejecting.user_id} · {rejecting.store_name || '-'}</Text>
+            ) : null}
             <Space wrap>
               {REJECT_TEMPLATES.map((tpl) => (
                 <Button size="small" key={tpl} onClick={() => setRejectReason(tpl)}>

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

@@ -39,6 +39,7 @@ import dayjs, { type Dayjs } from 'dayjs';
 import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
 import { formatUtcTime, utcDayjs, utcFromNow, yuan } from '@/lib/format';
+import { refreshReviewBadge } from '@/lib/reviewBadge';
 import { usePagedList } from '@/lib/usePagedList';
 import type {
   AuditLog,
@@ -141,7 +142,7 @@ function actionLabel(action: string) {
     'withdraw.approve': '审核通过',
     'withdraw.reject': '审核拒绝',
     'withdraw.refresh': '查单刷新',
-    'withdraw.reconcile': '批量对账',
+    'withdraw.reconcile': '处理超时订单',
   };
   return labels[action] || action;
 }
@@ -181,8 +182,11 @@ export default function WithdrawsPage() {
   const [activeStatus, setActiveStatus] = useState('reviewing');
   const [summary, setSummary] = useState<WithdrawSummary | null>(null);
   const [health, setHealth] = useState<WxpayHealthCheck | null>(null);
+  const [healthLoading, setHealthLoading] = useState(false);
+  const [healthCheckedAt, setHealthCheckedAt] = useState<number | null>(null);
   const [ledger, setLedger] = useState<WithdrawLedgerCheck | null>(null);
   const [ledgerLoading, setLedgerLoading] = useState(false);
+  const [ledgerCheckedAt, setLedgerCheckedAt] = useState<number | null>(null);
   const [drawerOpen, setDrawerOpen] = useState(false);
   const [detail, setDetail] = useState<WithdrawDetail | null>(null);
   const [detailLoading, setDetailLoading] = useState(false);
@@ -254,21 +258,36 @@ export default function WithdrawsPage() {
     }
   }, []);
 
-  const loadHealth = useCallback(async () => {
+  const loadHealth = useCallback(async (showFeedback = false) => {
+    setHealthLoading(true);
     try {
       const { data } = await api.get<WxpayHealthCheck>('/admin/api/withdraws/health-check');
       setHealth(data);
+      setHealthCheckedAt(Date.now());
+      if (showFeedback) {
+        message.success(data.ok ? '检测完成，微信提现配置正常' : '检测完成，仍有配置项需要处理');
+      }
     } catch (e) {
       message.error(errMsg(e));
+    } finally {
+      setHealthLoading(false);
     }
   }, []);
 
   // 账本校验是全表对账、相对重,故只在进页时拉一次 + 提供手动按钮,不随每次写操作重算。
-  const loadLedger = useCallback(async () => {
+  const loadLedger = useCallback(async (showFeedback = false) => {
     setLedgerLoading(true);
     try {
       const { data } = await api.get<WithdrawLedgerCheck>('/admin/api/withdraws/ledger-check');
       setLedger(data);
+      setLedgerCheckedAt(Date.now());
+      if (showFeedback) {
+        if (data.ok) {
+          message.success('校验完成，现金账本正常');
+        } else {
+          message.warning('校验完成，发现现金账本异常');
+        }
+      }
     } catch (e) {
       message.error(errMsg(e));
     } finally {
@@ -332,6 +351,7 @@ export default function WithdrawsPage() {
       onOk: async () => {
         try {
           await api.post(`/admin/api/withdraws/${o.out_bill_no}/approve`);
+          refreshReviewBadge('/withdraws');
           message.success('已通过审核并发起打款');
           await refreshAfterChange(o.out_bill_no);
         } catch (e) {
@@ -362,6 +382,7 @@ export default function WithdrawsPage() {
         await api.post(`/admin/api/withdraws/${targets[0].out_bill_no}/reject`, { reason: trimmed });
         message.success('已拒绝并退回余额');
       }
+      refreshReviewBadge('/withdraws');
       setRejecting(null);
       setBulkRejecting([]);
       setRejectReason('');
@@ -400,6 +421,7 @@ export default function WithdrawsPage() {
           const { data } = await api.post<WithdrawBulkResult>('/admin/api/withdraws/bulk/approve', {
             out_bill_nos: selectedReviewing.map((item) => item.out_bill_no),
           });
+          refreshReviewBadge('/withdraws');
           const text = bulkResultText('批量通过完成', data);
           if (data.failed) message.warning(text);
           else message.success(text);
@@ -461,15 +483,16 @@ export default function WithdrawsPage() {
 
   const reconcile = () => {
     modal.confirm({
-      title: '批量对账?',
+      title: '处理超时打款订单？',
-      content: '扫描超过 15 分钟仍处于打款中的提现单，逐单向微信查实并归一化。',
+      content:
-      okText: '开始对账',
+        '将检查超过 15 分钟仍处于“打款中”的订单：微信已成功则更新为“已到账”；失败则退款；仍待用户确认的老单将撤销并退款；仍在处理中则保持不变。',
+      okText: '开始处理',
       onOk: async () => {
         try {
           const { data } = await api.post<{ checked: number; resolved: number }>(
             '/admin/api/withdraws/reconcile',
           );
-          message.success(`对账完成: 检查 ${data.checked} 单，解决 ${data.resolved} 单`);
+          message.success(`处理完成：检查 ${data.checked} 单，更新 ${data.resolved} 单`);
           await refreshAfterChange();
         } catch (e) {
           message.error(errMsg(e));
@@ -648,6 +671,10 @@ export default function WithdrawsPage() {
           : '',
       ].filter(Boolean)
     : [];
+  const payoutReady = Boolean(
+    health?.wxpay_configured && health.private_key_loadable && health.public_key_loadable,
+  );
+  const hasBlockingPayoutIssue = Boolean(health && !payoutReady);
 
   return (
     <div>
@@ -658,41 +685,62 @@ export default function WithdrawsPage() {
         </div>
         {canManage && (
           <Button danger icon={<ReloadOutlined />} onClick={reconcile}>
-            批量对账
+            处理超时订单
           </Button>
         )}
       </Space>
 
-      {(health || ledger) && (
+      {(hasBlockingPayoutIssue || (ledger && !ledger.ok)) && (
         <Space direction="vertical" style={{ width: '100%', marginBottom: 16 }}>
-          {health && (
+          {health && hasBlockingPayoutIssue && (
             <Alert
               showIcon
-              type={health.ok ? 'success' : 'warning'}
+              type="warning"
-              message={health.ok ? '微信提现配置正常' : '微信提现配置需检查'}
+              message="当前环境无法执行微信打款"
               description={
-                health.ok
+                <Space direction="vertical" size={6}>
-                  ? `自动对账已${health.auto_reconcile_enabled ? '开启' : '关闭'}，每 ${health.auto_reconcile_interval_sec}s 扫描 ${health.auto_reconcile_older_than_minutes} 分钟前的打款中订单`
+                  <Text>微信支付配置不完整，点击“通过并打款”将失败。请联系部署管理员处理。</Text>
-                  : health.issues.join('；')
+                  {healthCheckedAt && (
-              }
+                    <Text type="secondary">
-            />
+                      最近检测：{dayjs(healthCheckedAt).format('HH:mm:ss')}
+                    </Text>
                   )}
-          {ledger && (
+                  <details>
-            <Alert
+                    <summary style={{ color: '#1677ff', cursor: 'pointer' }}>查看技术详情</summary>
-              showIcon
+                    <ul style={{ margin: '8px 0 0', paddingInlineStart: 20 }}>
-              type={ledger.ok ? 'success' : 'error'}
+                      {health.issues.map((issue) => (
-              message={ledger.ok ? '现金账本校验正常' : '现金账本存在异常'}
+                        <li key={issue} style={{ marginBottom: 4, overflowWrap: 'anywhere' }}>
-              description={
+                          {issue}
-                ledger.ok
+                        </li>
-                  ? `现金 余额 ${yuan(ledger.cash_balance_total_cents)} / 流水 ${yuan(ledger.cash_transaction_total_cents)}；邀请金 余额 ${yuan(ledger.invite_cash_balance_total_cents)} / 流水 ${yuan(ledger.invite_cash_transaction_total_cents)}`
+                      ))}
-                  : ledgerIssues.join('；')
+                    </ul>
+                  </details>
+                </Space>
               }
+              action={
+                <Button
+                  size="small"
+                  icon={<ReloadOutlined />}
+                  loading={healthLoading}
+                  onClick={() => void loadHealth(true)}
+                >
+                  重新检测
+                </Button>
+              }
+            />
+          )}
+          {ledger && !ledger.ok && (
+            <Alert
+              showIcon
+              type="error"
+              message="现金账本存在异常"
+              description={ledgerIssues.join('；')}
               action={
                 <Button
                   size="small"
                   icon={<ReloadOutlined />}
                   loading={ledgerLoading}
-                  onClick={() => void loadLedger()}
+                  onClick={() => void loadLedger(true)}
                 >
                   重新校验
                 </Button>
@@ -702,6 +750,36 @@ export default function WithdrawsPage() {
         </Space>
       )}
 
+      {(health || ledger) && (
+        <Space
+          size={12}
+          wrap
+          style={{ width: '100%', justifyContent: 'flex-end', marginBottom: 12 }}
+        >
+          {health && payoutReady && <Tag color="success">微信打款可用</Tag>}
+          {ledger?.ok && (
+            <Space size={6}>
+              <CheckCircleOutlined style={{ color: '#52c41a' }} />
+              <Text strong>账本正常</Text>
+              {ledgerCheckedAt && (
+                <Text type="secondary">
+                  · {dayjs(ledgerCheckedAt).format('HH:mm:ss')} 校验
+                </Text>
+              )}
+              <Button
+                type="link"
+                size="small"
+                icon={<ReloadOutlined />}
+                loading={ledgerLoading}
+                onClick={() => void loadLedger(true)}
+              >
+                重新校验
+              </Button>
+            </Space>
+          )}
+        </Space>
+      )}
+
       <Row gutter={12} style={{ marginBottom: 16 }}>
         <Col xs={24} sm={12}>
           <Card size="small">

src/lib/bulkAction.ts

@@ -0,0 +1,33 @@
+export interface BulkReviewItemResult {
+  id: number;
+  ok: boolean;
+  status: string | null;
+  error: string | null;
+}
+
+export interface BulkReviewResult {
+  total: number;
+  success: number;
+  failed: number;
+  items: BulkReviewItemResult[];
+}
+
+export const BULK_REVIEW_MAX = 50;
+
+export function failedReviewIds(result: BulkReviewResult): number[] {
+  return result.items.filter((item) => !item.ok).map((item) => item.id);
+}
+
+export function bulkFailureReasonText(result: BulkReviewResult): string {
+  const reasons = Array.from(
+    new Set(
+      result.items
+        .filter((item) => !item.ok)
+        .map((item) => item.error?.trim())
+        .filter((reason): reason is string => Boolean(reason)),
+    ),
+  );
+  if (!reasons.length) return '';
+  const visible = reasons.slice(0, 3);
+  return `；原因：${visible.join('；')}${reasons.length > visible.length ? '；…' : ''}`;
+}

src/lib/reviewBadge.ts

@@ -0,0 +1,10 @@
+export type ReviewBadgeKey = '/withdraws' | '/price-reports' | '/feedbacks';
+
+export const REVIEW_BADGE_REFRESH_EVENT = 'review-badge-refresh';
+
+export function refreshReviewBadge(key: ReviewBadgeKey) {
+  if (typeof window === 'undefined') return;
+  window.dispatchEvent(
+    new CustomEvent<ReviewBadgeKey>(REVIEW_BADGE_REFRESH_EVENT, { detail: key }),
+  );
+}

src/lib/types.ts

@@ -317,6 +317,18 @@ export interface FeedbackQrConfig {
   updated_at: string | null;
 }
 
+/** 领券等候浮层的「新手引导视频」配置(前 3 次用它替代广告,每次固定 120 金币)。
+ *  后台只开放 enabled + 换片;下面几个字段接口仍返回,但页面不展示、也不回传。 */
+export interface GuideVideoConfig {
+  enabled: boolean;
+  video_url: string | null; // /media/guide_video/xxx.mp4;null = 未配片(浮层照旧只放广告)
+  max_plays: number; // 每个账号前 N 次浮层放引导视频(服务端默认 3,后台不开放调整)
+  reward_coin: number; // 每次固定金币(服务端默认 120,播完 / 中途关闭都发)
+  updated_at: string | null;
+  total_plays: number; // 只读统计:全站已播次数(后台不再展示)
+  granted_plays: number; // 只读统计:其中已发币次数(后台不再展示)
+}
+
 export interface AuditLog {
   id: number;
   admin_id: number;
@@ -488,7 +500,7 @@ export interface AdRevenueRow {
   has_impression: boolean; // 是否有广告展示(信息流逐条展示=true,纯发奖行=false)
   impressions: number; // 本行展示条数 1/0(供日汇总、趋势图复用)
   ecpm: string | null; // 分/千次;展示行取展示值,纯发奖行取发奖采用值
-  revenue_yuan: number; // 本次展示预估收益(元);纯发奖行=0
+  revenue_yuan: number; // 本次有效展示预估收益(元);纯发奖、激励视频提前关闭/时长不足=0
   row_revenue_yuan?: number | null; // 主表逐行显示用:一次比价/领券聚合行=该次发奖广告 eCPM 折算之和;其它行空(回退 revenue_yuan)
   adn: string | null; // 实际填充 ADN;纯发奖行为空
   slot_id: string | null; // 底层 mediation rit;纯发奖行为空