feat(admin): 广告收益增加环境与数据范围筛选

## 变更内容
- 将汇总卡“领券成功率”明确为“领券完成率”
- 提示中动态展示完成数、发起数、中途退出数及本期代入计算结果
- 点位成功率提示逐券展示成功数、尝试数、单券成功率和最终等权平均结果
- 展示累计成功/尝试数作为辅助核对，并明确不作为当前加权公式

## 验证
- npx tsc --noEmit
- npm run build

---------

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

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

@@ -300,6 +300,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 +335,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 +378,7 @@ export default function AdRevenueReportPage() {
         setLoading(false);
       }
     },
-    [range, userId, adType, scene, granularity, limit, sortBy],
+    [range, userId, appEnv, revenueScope, adType, scene, granularity, limit, sortBy],
   );
 
   useEffect(() => {
@@ -620,7 +624,8 @@ export default function AdRevenueReportPage() {
               <br />
               核心指标里的<b>「穿山甲后台收益(T+1)」</b>来自穿山甲 GroMore 数据 API(后台结算口径,次日出数):
               <b>穿山甲预估收益</b>=接口 revenue、<b>收益API</b>=各 ADN 回传更接近结算。穿山甲不提供分用户/类型/场景维度,
-              故仅在<b>全量视图</b>(未按用户/类型/场景筛选)展示;逐条事件行仍是客户端预估,不受其影响。
+              故仅在<b>可对账视图</b>(未按用户/类型/场景筛选)展示;环境和数据范围会同时作用于客户端与穿山甲汇总。
+              默认“正式 + 业务代码位”用于同口径对账;切到“全部代码位”会包含广告测试等非业务曝光。
             </div>
           }
         >
@@ -655,6 +660,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)/coupon-data/page.tsx

@@ -137,11 +137,6 @@ const slotRateMean = (rows: CouponSlotRow[]): number | null => {
   return rates.length ? rates.reduce((a, b) => a + b, 0) / rates.length : null;
 };
 
-// 汇总卡成功率口径 tooltip 文案
-const POINT_RATE_HINT =
-  '点位成功率(合计):当前区间内全部券成功率的算术平均(每张券等权);' +
-  '单券成功率=成功(含已领)÷尝试(不含跳过),源自领券每券记录。';
-
 // 按券表:coupon_id 平台 → 中文
 const SLOT_PLATFORM: Record<string, string> = {
   'meituan-waimai': '美团',
@@ -597,6 +592,10 @@ export default function CouponDataPage() {
   const successDenominator = summary ? Math.max(0, summary.started_count - abandonedCount) : 0;
   const couponSuccessRate =
     summary && successDenominator > 0 ? summary.completed_count / successDenominator : null;
+  const validCouponSlots = couponSlots.filter((r) => r.success_rate != null);
+  const pointSuccessRate = slotRateMean(validCouponSlots);
+  const pointSucceededTotal = validCouponSlots.reduce((total, r) => total + r.succeeded, 0);
+  const pointTriedTotal = validCouponSlots.reduce((total, r) => total + r.tried, 0);
   const items = data?.items ?? [];
 
   return (
@@ -714,8 +713,19 @@ export default function CouponDataPage() {
               <Statistic
                 title={
                   <span>
-                    领券成功率{' '}
-                    <Tooltip title="领券完成数 ÷（领券发起数－中途退出数）">
+                    领券完成率{' '}
+                    <Tooltip
+                      overlayStyle={{ maxWidth: 520 }}
+                      title={
+                        <div>
+                          <div>计算逻辑：领券完成数 ÷（领券发起数－中途退出数）</div>
+                          <div style={{ marginTop: 6 }}>
+                            本期：{summary.completed_count} ÷（{summary.started_count}－{abandonedCount}）
+                            ＝ {fmtPct(couponSuccessRate)}
+                          </div>
+                        </div>
+                      }
+                    >
                       <InfoCircleOutlined style={{ color: '#999' }} />
                     </Tooltip>
                   </span>
@@ -728,12 +738,33 @@ export default function CouponDataPage() {
                 title={
                   <span>
                     点位成功率{' '}
-                    <Tooltip title={POINT_RATE_HINT}>
+                    <Tooltip
+                      overlayStyle={{ maxWidth: 560 }}
+                      title={
+                        <div>
+                          <div>计算逻辑：全部单券成功率的算术平均，每张券等权。</div>
+                          <div>单券成功率＝成功数（含已领）÷ 尝试数（不含跳过）。</div>
+                          <div style={{ marginTop: 6 }}>
+                            本期共 {validCouponSlots.length} 张有效券：
+                          </div>
+                          {validCouponSlots.map((slot) => (
+                            <div key={slot.coupon_id}>
+                              {slot.coupon_name || slot.coupon_id}：{slot.succeeded} ÷ {slot.tried}＝
+                              {fmtPct(slot.success_rate)}
+                            </div>
+                          ))}
+                          <div style={{ marginTop: 6 }}>
+                            等权平均＝{fmtPct(pointSuccessRate)}；累计成功/尝试＝
+                            {pointSucceededTotal}/{pointTriedTotal}（累计数仅辅助核对，不作为当前加权公式）。
+                          </div>
+                        </div>
+                      }
+                    >
                       <InfoCircleOutlined style={{ color: '#999' }} />
                     </Tooltip>
                   </span>
                 }
-                value={fmtPct(slotRateMean(couponSlots))}
+                value={fmtPct(pointSuccessRate)}
               />
             </Col>
             <Col flex="1 1 0">

src/app/(main)/huawei-review/page.tsx

@@ -0,0 +1,103 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
+import { Alert, App, Button, Card, Descriptions, Radio, Skeleton, Tag } from 'antd';
+import { api, errMsg } from '@/lib/api';
+import { formatUtcTime } from '@/lib/format';
+
+// 华为审核开关:控制新手引导「快速设置」权限步能否被用户退出。
+// 华为应用市场审核要求该页必须可关闭(引导视频页不在要求内),平时保持「不能关闭」以保住权限开启率,
+// 送审期间切「可关闭」。落在 app_config 的 huawei_review 行,客户端经 /api/v1/platform/huawei-review 拉。
+type Mode = 'default' | 'review';
+
+interface HuaweiReview {
+  mode: Mode;
+  updated_at: string | null;
+}
+
+const MODE_LABEL: Record<Mode, string> = {
+  default: '不能关闭',
+  review: '可关闭',
+};
+
+export default function HuaweiReviewPage() {
+  const { message } = App.useApp();
+  const [loading, setLoading] = useState(true);
+  const [saving, setSaving] = useState(false);
+  // saved = 服务端当前值(用于「有没有改动」判断);mode = 编辑中的值
+  const [saved, setSaved] = useState<HuaweiReview | null>(null);
+  const [mode, setMode] = useState<Mode>('default');
+
+  const load = useCallback(async () => {
+    try {
+      const r = await api.get<HuaweiReview>('/admin/api/huawei-review');
+      setSaved(r.data);
+      setMode(r.data.mode);
+    } catch (e) {
+      message.error(errMsg(e, '华为审核开关加载失败'));
+    } finally {
+      setLoading(false);
+    }
+  }, [message]);
+
+  useEffect(() => {
+    load();
+  }, [load]);
+
+  const save = async () => {
+    setSaving(true);
+    try {
+      const r = await api.patch<HuaweiReview>('/admin/api/huawei-review', { mode });
+      setSaved(r.data);
+      setMode(r.data.mode);
+      message.success('已保存。客户端下次进新手引导时拉取生效');
+    } catch (e) {
+      message.error(errMsg(e, '保存失败'));
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  const dirty = saved !== null && saved.mode !== mode;
+
+  return (
+    <Card
+      title="华为审核开关"
+      extra={
+        <Button type="primary" loading={saving} disabled={loading || !dirty} onClick={save}>
+          保存
+        </Button>
+      }
+    >
+      <Alert
+        type="info"
+        style={{ marginBottom: 16 }}
+        message="华为应用市场审核要求「快速设置」页必须可以关闭。切到「可关闭」后,该页左上角出现退出按钮(返回键同样可退出),用户点了直接进 App 首页、本次引导视为已完成。"
+        description="① 只对华为机型(HarmonyOS / EMUI)生效,荣耀 MagicOS 及其它机型不受影响;② 只影响快速设置权限步,引导视频页照旧必须看完;③ 客户端在进引导前拉一次并缓存,已经停在引导页的用户要重进 App 才会变;④ 审核通过后记得切回「不能关闭」,不然会一直损失权限开启率。"
+      />
+      {loading ? (
+        <Skeleton active paragraph={{ rows: 3 }} />
+      ) : (
+        <>
+          <Descriptions column={1} style={{ marginBottom: 16 }}>
+            <Descriptions.Item label="当前生效">
+              {saved ? (
+                <Tag color={saved.mode === 'review' ? 'orange' : 'green'}>{MODE_LABEL[saved.mode]}</Tag>
+              ) : (
+                '-'
+              )}
+            </Descriptions.Item>
+            <Descriptions.Item label="最后修改">
+              {saved?.updated_at ? formatUtcTime(saved.updated_at) : '从未修改过(默认不能关闭)'}
+            </Descriptions.Item>
+          </Descriptions>
+          <div style={{ marginBottom: 8 }}>华为快速设置页是否可关闭</div>
+          <Radio.Group value={mode} onChange={(e) => setMode(e.target.value as Mode)}>
+            <Radio.Button value="default">不能关闭</Radio.Button>
+            <Radio.Button value="review">可关闭</Radio.Button>
+          </Radio.Group>
+        </>
+      )}
+    </Card>
+  );
+}

src/app/(main)/layout.tsx

@@ -16,6 +16,7 @@ import {
   MoneyCollectOutlined,
   NotificationOutlined,
   ProfileOutlined,
+  SafetyCertificateOutlined,
   SettingOutlined,
   ShareAltOutlined,
   TeamOutlined,
@@ -78,6 +79,7 @@ const NAV_GROUPS: NavGroup[] = [
     children: [
       { key: '/config', icon: <SettingOutlined />, label: '系统配置' },
       { key: '/ad-revenue', icon: <NotificationOutlined />, label: '广告配置' },
+      { key: '/huawei-review', icon: <SafetyCertificateOutlined />, label: '华为审核开关' },
       { key: '/users', icon: <UserOutlined />, label: '用户管理' },
     ],
   },