feat(ad-revenue): 收益报表分页、eCPM 元列、场景筛选与逐行展开+ 大盘改版 (#23)

- 列:eCPM 新增「元」列;广告位ID 移到「一致」列后。
- 分页:「每页条数」接后端 offset 真分页,可翻页看当前筛选下全部数据(原仅展示截断的前 N 条)。
- 场景:「场景」下推后端作为全局筛选(随查询生效,同时影响明细/合计/趋势),移除前端仅过滤当前数据的旧逻辑与过时提示。
- 趋势:按小时趋势改用后端全量 hourly,不受分页影响。
- 展开:明细表每行左侧都有展开号——发奖行看金币复算因子,纯展示行看展示明细(eCPM/收益/ADN/底层rit/代码位/来源)。
- 文案:修正金币规则弹窗「信息流每满10秒折1条」→「一条广告=1条」。
- types 新增 AdRevenueHourly + hourly 字段。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: zzhyyyyy <2685922758@qq.com>
Reviewed-on: #23
Co-authored-by: zhuzihao <zhuzihao@wonderable.ai>
Co-committed-by: zhuzihao <zhuzihao@wonderable.ai>

.env.production

@@ -1,3 +1,9 @@
-# 生产:前端与 admin API 同域(admin.shaguabijia.com),nginx 把 /admin/api 反代到后端 8771。
-# 留空 = axios 用相对路径,请求落到当前域名,由 nginx 转发。
+# 生产:前端与 admin API 同域(admin-web.shaguabijia.com),nginx 把 /admin/api 反代到后端 8771。
+# 留空 = axios 用相对路径,请求落到当前域名,由 nginx 转发。(已验证线上 /admin/api 走通、操作 200)
 NEXT_PUBLIC_API_BASE=
+
+# 媒体(反馈二维码 / 上报截图 / 头像)由 App 后端托管在 app-api.shaguabijia.com/media,【不在 admin 域】。
+# 必须指到 App 后端的公开域名,否则 admin 里所有 /media 图片都会 404(被拼到 admin 域而非 App 域)。
+# 都是 https → 无混合内容;<img> 跨域加载不受 CORS 限制,无需后端配 CORS。
+# ⚠️ NEXT_PUBLIC_* 是编译期常量:改这里后必须重新 `npm run build` 再部署,前端才会带上新值。
+NEXT_PUBLIC_MEDIA_BASE=https://app-api.shaguabijia.com

README.md

@@ -4,11 +4,34 @@ Next.js 15 + Ant Design 5,对接 `shaguabijia-app-server` 的 admin API(`app/adm
 后端是独立 FastAPI app(端口 8771,复用 app-server 的 models/repositories + 同一 PostgreSQL,
 鉴权用独立 JWT)。本仓只是前端。
 
-## 功能(P0)
-数据大盘 / 用户管理(列表+360详情+封禁+调金币) / 提现管理(列表+重试+对账) /
-反馈工单 / 管理员账号(super) / 审计日志。按角色显示操作:finance=钱、operator=用户+反馈、super=全部。
+## 功能模块
+
+侧边栏 `MENU`(`src/app/(main)/layout.tsx`)共 12 个模块,均已上线:
+
+- **数据大盘**(`/dashboard`)— 核心经营指标概览。
+- **用户管理**(`/users`)— 列表(多条件筛选+服务端排序)+ 360 详情;封禁/解封、调金币、调现金;运营开关:开启新手引导(标记用户重看一次,看完自动恢复)、开/关调试链接(trace 排障)、以及上述操作的批量勾选执行。
+- **设备管理**(`/devices`)— 按硬件 ANDROID_ID 聚合走过新手引导的设备;可单设备或全量「重设新手引导」。
+- **提现管理**(`/withdraws`)— 提现单审核(通过即发起微信打款 / 拒绝退回余额)、查单刷新、批量通过/拒绝/刷新、批量对账,含微信配置健康检查 + 现金账本校验。
+- **上报审核**(`/price-reports`)— 用户上报「某平台更低价」+ 截图,人工核实;通过发放 1000 金币、拒绝需填理由(用户端轮询看到结果)。
+- **比价记录**(`/comparison-records`)— 比价过程明细(逐平台结局/卡在哪一步、LLM 调用明细、trace);支持按页面输入的 LLM 单价做 token / 成本估算(纯前端,见 `calcCost` / `pricePerMTok`)。
+- **反馈工单**(`/feedbacks`)— 用户反馈审核闭环:采纳发金币 / 拒绝填用户可见原因(`FeedbackHandleDrawer`),并含反馈二维码配置。
+- **广告管理**(`/ad-revenue`)— 穿山甲广告配置(应用ID/各场景广告位ID/验签密钥/开关)+ 收益报表(展示/预估收益 与 应发/实发金币逐组对账)。
+- **CPS 分发**(`/cps`)— 优惠券分发与对账(美团/淘宝/京东);单页 Tabs:对账统计 / 群管理 / 活动管理 / 订单明细。含群对账详情子页(`/cps/groups/[id]`):点击/复制趋势折线 + 按天明细 + 群内微信用户画像。
+- **系统配置**(`/config`)— 业务运行参数(金额/上限等)在线读写,改完即时生效、每次进审计。
+- **管理员**(`/admins`)— 管理员账号管理(仅 `super_admin` 可见)。
+- **审计日志**(`/audit-logs`)— 所有写操作的审计流水。
+
+### 按角色显示操作
+
+权限以 `src/lib/auth.ts` 的 `canDo()` 为准(`super_admin` 恒可全部),各 `page.tsx` 用 `canDo([...])` 控制按钮:
+
+- **finance**(钱):提现审核、用户调金币/调现金、CPS 对账(刷新拉美团订单)。
+- **operator**(用户+内容):用户封禁/调试链接/新手引导、反馈审核、上报审核、设备重设引导、CPS 群/活动管理。
+- **super**(super_admin):以上全部 + 管理员账号管理。
+- 数据大盘 / 比价记录 / 广告管理 / 系统配置 / 审计日志:无 `canDo` 门,登录即可查看。
 
 ## 本地开发
+
 ```bash
 # 1. 起 admin 后端(在 shaguabijia-app-server 目录)
 conda activate price && uvicorn app.admin.main:admin_app --port 8771
@@ -17,11 +40,13 @@ python scripts/create_admin.py --username admin --role super_admin
 # 3. 起前端
 npm install && npm run dev        # → http://localhost:3001
 ```
+
 `.env.local` 已指向 `http://localhost:8771`。
 
 ## 生产部署(阿里云,域名 admin.shaguabijia.com)
 
 ### ① 后端 admin(在 app-server 机器,复用同一 codebase)
+
 ```bash
 scp deploy/shaguabijia-admin.service server:/etc/systemd/system/   # 文件在 app-server/deploy/
 ssh server "systemctl daemon-reload && systemctl enable --now shaguabijia-admin"
@@ -29,6 +54,7 @@ ssh server "cd /opt/shaguabijia-app-server && .venv/bin/python scripts/create_ad
 ```
 
 ### ② 前端
+
 ```bash
 npm run build
 rsync -avz --exclude node_modules --exclude .next/cache ./ server:/opt/shaguabijia-admin-web/
@@ -36,13 +62,17 @@ ssh server "cd /opt/shaguabijia-admin-web && npm install --omit=dev && npm run b
 ```
 
 ### ③ nginx
+
 ```bash
 scp deploy/nginx/admin.shaguabijia.com.conf server:/etc/nginx/conf.d/
 ssh server "nginx -t && systemctl reload nginx"
 ```
 
 ## ⚠️ 上线必查
-- [ ] app-server 的 `.env` 里 `ADMIN_JWT_SECRET` 改成 ≥32 字节强随机串(默认 `change-me-admin` 可伪造 token)
-- [ ] nginx 打开 IP 白名单(运营出口 IP)+ HTTPS 证书就位
-- [ ] `.env.production` 的 `NEXT_PUBLIC_API_BASE` 留空(同域,nginx 反代 /admin/api)
-- [ ] 首个 super_admin 已建、能登录
+
+- app-server 的 `.env` 里 `ADMIN_JWT_SECRET` 改成 ≥32 字节强随机串(默认 `change-me-admin` 可伪造 token)
+- nginx 打开 IP 白名单(运营出口 IP)+ HTTPS 证书就位
+- `.env.production` 的 `NEXT_PUBLIC_API_BASE` 留空(同域,nginx 反代 /admin/api)
+- `.env.production` 的 `NEXT_PUBLIC_MEDIA_BASE` 必须指向 **App 后端** `https://app-api.shaguabijia.com`(/media 的真正的家),否则后台所有 /media 图片(上报/反馈截图、二维码、头像)被拼到 admin 域而 404。`NEXT_PUBLIC_*` 是编译期常量,改完必须重新 `npm run build` 才生效(详见 `src/lib/media.ts`)
+- 首个 super_admin 已建、能登录
+

deploy/nginx/admin.shaguabijia.com.conf

@@ -32,6 +32,18 @@ server {
         proxy_read_timeout 60s;
     }
 
+    # 用户上传媒体(上报截图 / 反馈截图 / 反馈二维码)由 App 后端(:8770)的 /media 托管。
+    # admin 页面要展示这些图,经此同域反代过去(免跨域 + 免 https 页面引 http 图被拦)。
+    # 前提:App 后端与本 admin 同机;若分机,把 127.0.0.1:8770 换成 App 后端可达地址。
+    # 配好此段后,前端 .env.production 的 NEXT_PUBLIC_MEDIA_BASE 留空即走同域。
+    location /media/ {
+        proxy_pass http://127.0.0.1:8770;
+        proxy_set_header Host $host;
+        proxy_set_header X-Forwarded-For $remote_addr;
+        proxy_set_header X-Forwarded-Proto $scheme;
+        proxy_read_timeout 60s;
+    }
+
     # 其余 → Next.js 前端
     location / {
         proxy_pass http://127.0.0.1:3001;

docs/superpowers/plans/2026-06-26-cps-day-user-drilldown.md

@@ -0,0 +1,746 @@
+# CPS 群详情 · 每日明细「按天 · 按用户」领券下钻 — 实现计划
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 在 CPS 群详情页每日明细表每行加「明细」按钮，点开弹窗展示该群该天以用户为单位的领券/点击，并在「点击次数」上悬停展示该用户当天点过的优惠券（券名 ×次数）。
+
+**Architecture:** 后端 `shaguabijia-app-server` 新增只读聚合接口 `/admin/api/cps/groups/{id}/day-users?date=YYYY-MM-DD`（券明细内联返回），并把既有 `/daily` 的 `date` 由 `MM-DD` 改全为 `YYYY-MM-DD` 供下钻定位整天。前端 `shaguabijia-admin-web` 加明细列 + Modal + Tooltip，一次请求渲染。纯读侧聚合，**不动数据库**。
+
+**Tech Stack:** 后端 FastAPI + SQLAlchemy + pytest（`.venv`）；前端 Next.js 15 + Ant Design 5 + TypeScript（无测试框架，门槛为 `npm run build`）。
+
+**配套 spec：** `docs/superpowers/specs/2026-06-26-cps-day-user-drilldown-design.md`
+
+---
+
+## 仓库与分支
+
+- **前端** `e:\project\shaguabijia-admin-web`：已在分支 `feat/cps-day-user-drilldown`。
+- **后端** `e:\project\shaguabijia-app-server`：独立 git 仓，需自建同名分支（Task 1 Step 0）。
+
+后端命令统一**从后端仓根目录运行**；git 用 `git -C e:\project\shaguabijia-app-server ...` 避免切目录。
+
+## File Structure
+
+| 文件 | 改动 | 职责 |
+|---|---|---|
+| `app/admin/routers/cps.py`（后端） | 改 1 行 + 加 1 个 endpoint | `/daily` 的 `date` 改全日期；新增 `/day-users` 路由（鉴权、日期解析、窗口计算） |
+| `app/admin/repositories/cps.py`（后端） | 加 1 个函数 + 补 1 处 import | `group_day_users(...)`：按 openid 聚合领券/点击 + 券明细（Python 侧） |
+| `tests/test_cps_admin.py`（后端） | 新建 | admin CPS 端点测试：`/daily` 日期格式 + `/day-users` 聚合与边界 |
+| `src/app/(main)/cps/groups/[id]/page.tsx`（前端） | 改 | 日期列加宽、明细列、Modal、Tooltip、按用户表 |
+
+---
+
+## Task 1: 后端 `/daily` 的 `date` 改为 `YYYY-MM-DD`
+
+**Files:**
+- Modify: `app/admin/routers/cps.py:472`（`group_daily` 内构行处）
+- Test: `tests/test_cps_admin.py`（新建）
+
+- [ ] **Step 0: 在后端仓建分支**
+
+先看工作区状态，避免把无关改动带入：
+
+Run:
+```
+git -C e:\project\shaguabijia-app-server status --short
+git -C e:\project\shaguabijia-app-server checkout -b feat/cps-day-user-drilldown
+```
+Expected: 切到新分支 `feat/cps-day-user-drilldown`。
+
+- [ ] **Step 1: 写失败测试（新建测试文件，含共用 fixtures + 种子）**
+
+新建 `tests/test_cps_admin.py`，内容如下（fixtures 仿 `tests/test_admin_read.py` 自包含；种子函数后续 Task 复用）：
+
+```python
+"""admin CPS 端点测试:每日明细 date 格式 + 按天按用户领券下钻(/day-users)。"""
+from __future__ import annotations
+
+from datetime import date, datetime, timedelta, timezone
+
+import pytest
+from fastapi.testclient import TestClient
+
+from app.admin.main import admin_app
+from app.admin.repositories import admin_user as admin_repo
+from app.admin.repositories import cps as cps_repo
+from app.db.session import SessionLocal
+from app.models.cps_link import CpsClick
+from app.models.cps_wx_user import CpsWxUser
+from app.repositories import cps_link as cps_link_repo
+
+_BJ = timezone(timedelta(hours=8))
+
+
+@pytest.fixture()
+def admin_client() -> TestClient:
+    return TestClient(admin_app)
+
+
+@pytest.fixture()
+def admin_token() -> str:
+    db = SessionLocal()
+    try:
+        if admin_repo.get_by_username(db, "cps_test_admin") is None:
+            admin_repo.create_admin(
+                db, username="cps_test_admin", password="cps-pass", role="super_admin"
+            )
+    finally:
+        db.close()
+    c = TestClient(admin_app)
+    r = c.post("/admin/api/auth/login", json={"username": "cps_test_admin", "password": "cps-pass"})
+    return r.json()["access_token"]
+
+
+def _auth(token: str) -> dict:
+    return {"Authorization": f"Bearer {token}"}
+
+
+def _seed_cps_day(day_bj: date) -> tuple[int, str]:
+    """造淘宝群 + 2 个活动(券) + 2 条 link + day_bj 当天点击(含匿名 + 次日各 1) + 授权画像。
+
+    o_user(本群唯一):券A visit×3、券B visit×2、copy×2 → visit_count=5、copy_count=2。
+    另造 1 条匿名 visit(openid=None)与 1 条次日 visit,均不应计入当天该用户聚合。
+    clicked_at 统一存 tz-aware UTC(SQLite DateTime 按字段渲染、忽略 tzinfo;
+    转 UTC 后字段即 UTC 墙钟,与 repo 侧 _as_utc 比较口径一致)。返回 (group_id, openid)。
+    """
+    db = SessionLocal()
+    try:
+        gid = cps_repo.create_group(db, name="下钻测试群", platforms=["taobao"]).id
+        openid = f"od_user_{gid}"  # 按群唯一,规避 CpsWxUser.openid 唯一约束跨用例冲突
+        a1 = cps_repo.create_activity(db, name="618神券", platform="taobao", payload="tkl-1")
+        a2 = cps_repo.create_activity(db, name="买一送一", platform="taobao", payload="tkl-2")
+        link1 = cps_link_repo.create_link(
+            db, group_id=gid, activity_id=a1.id, sid=None, target_url="t1", platform="taobao"
+        )
+        link2 = cps_link_repo.create_link(
+            db, group_id=gid, activity_id=a2.id, sid=None, target_url="t2", platform="taobao"
+        )
+        db.add(CpsWxUser(openid=openid, nickname="张三", headimgurl="https://h/1"))
+        db.commit()
+
+        def at(hour: int) -> datetime:
+            return datetime(day_bj.year, day_bj.month, day_bj.day, hour, tzinfo=_BJ).astimezone(
+                timezone.utc
+            )
+
+        for _ in range(3):
+            db.add(CpsClick(link_id=link1.id, group_id=gid, sid=None,
+                            event_type="visit", openid=openid, clicked_at=at(10)))
+        for _ in range(2):
+            db.add(CpsClick(link_id=link2.id, group_id=gid, sid=None,
+                            event_type="visit", openid=openid, clicked_at=at(11)))
+        for _ in range(2):
+            db.add(CpsClick(link_id=link1.id, group_id=gid, sid=None,
+                            event_type="copy", openid=openid, clicked_at=at(12)))
+        # 匿名点击 — 不计入
+        db.add(CpsClick(link_id=link1.id, group_id=gid, sid=None,
+                        event_type="visit", openid=None, clicked_at=at(13)))
+        # 次日点击 — 验证时间窗,不计入当天
+        nxt = (datetime(day_bj.year, day_bj.month, day_bj.day, 10, tzinfo=_BJ)
+               + timedelta(days=1)).astimezone(timezone.utc)
+        db.add(CpsClick(link_id=link1.id, group_id=gid, sid=None,
+                        event_type="visit", openid=openid, clicked_at=nxt))
+        db.commit()
+        return gid, openid
+    finally:
+        db.close()
+
+
+def test_daily_date_is_full_iso(admin_client: TestClient, admin_token: str) -> None:
+    """/daily 每行 date 改为 YYYY-MM-DD(10 字符、两个连字符),不再是 MM-DD。"""
+    gid, _ = _seed_cps_day(date(2026, 6, 25))
+    r = admin_client.get(
+        f"/admin/api/cps/groups/{gid}/daily", params={"days": 3}, headers=_auth(admin_token)
+    )
+    assert r.status_code == 200, r.text
+    rows = r.json()["rows"]
+    assert rows, "应有按天补零行"
+    for row in rows:
+        assert len(row["date"]) == 10 and row["date"].count("-") == 2, row["date"]
+```
+
+- [ ] **Step 2: 跑测试确认失败**
+
+Run（从后端仓根目录 `e:\project\shaguabijia-app-server`）:
+```
+.\.venv\Scripts\pytest.exe tests\test_cps_admin.py::test_daily_date_is_full_iso -v
+```
+Expected: FAIL —— `date` 当前为 `"%m-%d"`（长度 5），断言 `len==10` 不通过。
+
+- [ ] **Step 3: 改 router 的日期格式**
+
+`app/admin/routers/cps.py` 的 `group_daily` 内（约 472 行），把构行的日期字段改为全日期：
+
+```python
+        row = {
+            "date": cur.strftime("%Y-%m-%d"),
+            "click_pv": cp["click_pv"] if cp else 0,
+            "click_uv": cp["click_uv"] if cp else 0,
+            "copy_pv": cp["copy_pv"] if cp else 0,
+        }
+```
+
+（仅把原 `cur.strftime("%m-%d")` 改成 `cur.strftime("%Y-%m-%d")`，其余不动。）
+
+- [ ] **Step 4: 跑测试确认通过**
+
+Run:
+```
+.\.venv\Scripts\pytest.exe tests\test_cps_admin.py::test_daily_date_is_full_iso -v
+```
+Expected: PASS。
+
+- [ ] **Step 5: 提交（后端仓）**
+
+```
+git -C e:\project\shaguabijia-app-server add app/admin/routers/cps.py tests/test_cps_admin.py
+git -C e:\project\shaguabijia-app-server commit -m "feat(cps): /daily 的 date 改为 YYYY-MM-DD(下钻定位整天用)"
+```
+
+---
+
+## Task 2: 后端新增 `group_day_users` 聚合 + `/day-users` 接口
+
+**Files:**
+- Modify: `app/admin/repositories/cps.py:20`（import 补 `CpsLink`）、文件末尾加函数
+- Modify: `app/admin/routers/cps.py`（`group_wx_users` 路由后追加新路由）
+- Test: `tests/test_cps_admin.py`（追加）
+
+- [ ] **Step 1: 写失败测试（聚合 happy path，含匿名/跨天排除、券倒序、合计自洽）**
+
+在 `tests/test_cps_admin.py` 末尾追加：
+
+```python
+def test_day_users_aggregates(admin_client: TestClient, admin_token: str) -> None:
+    """当天该群:仅授权用户;领券=copy、点击=visit;coupons=visit 券×次数倒序、合计=点击次数。"""
+    gid, openid = _seed_cps_day(date(2026, 6, 25))
+    r = admin_client.get(
+        f"/admin/api/cps/groups/{gid}/day-users",
+        params={"date": "2026-06-25"},
+        headers=_auth(admin_token),
+    )
+    assert r.status_code == 200, r.text
+    body = r.json()
+    assert body["group_id"] == gid
+    assert body["date"] == "2026-06-25"
+    users = body["users"]
+    assert len(users) == 1  # 匿名不计、次日不计
+    u = users[0]
+    assert u["openid"] == openid
+    assert u["nickname"] == "张三"
+    assert u["headimgurl"] == "https://h/1"
+    assert u["copy_count"] == 2
+    assert u["visit_count"] == 5
+    assert [c["name"] for c in u["coupons"]] == ["618神券", "买一送一"]
+    assert [c["count"] for c in u["coupons"]] == [3, 2]
+    assert sum(c["count"] for c in u["coupons"]) == u["visit_count"]
+```
+
+- [ ] **Step 2: 跑测试确认失败**
+
+Run:
+```
+.\.venv\Scripts\pytest.exe tests\test_cps_admin.py::test_day_users_aggregates -v
+```
+Expected: FAIL —— 404/路由不存在（`/day-users` 尚未实现）。
+
+- [ ] **Step 3: 补 repo import**
+
+`app/admin/repositories/cps.py` 第 20 行，给 `cps_link` 的 import 补上 `CpsLink`：
+
+```python
+from app.models.cps_link import CpsClick, CpsLink
+```
+
+- [ ] **Step 4: 加 repo 聚合函数**
+
+在 `app/admin/repositories/cps.py` 末尾（`group_wx_users` 之后）追加：
+
+```python
+def group_day_users(
+    db: Session, *, group_id: int, start: datetime, end: datetime, limit: int = 200,
+) -> list[dict]:
+    """该群某天(北京)以用户为单位的领券/点击 + 每人 visit 过的券。
+
+    时间窗为半开区间 [start, end)(end=次日 00:00),避免午夜双计。只统计 openid 非空
+    (可归属到人)的点击 —— 匿名点击(美团/京东 302 多为匿名)不计入。券名 = 该点击 link
+    对应活动名;活动被硬删则兜底 活动#{id}。copy=领券次数、visit=点击次数;coupons 仅
+    取 visit 事件按活动分组、按次数倒序(合计 = visit_count)。排序:领券 desc、再点击 desc。
+    与 group_wx_users 同风格(Python 侧聚合,跨 PG/SQLite 无方言坑)。
+
+    注:每日明细行的 click_pv/copy_pv 计全部点击(含匿名、UV 按 ip,ua);本函数只计 openid
+    用户,故各用户求和 <= 当天行总数,二者口径不同、不必相等。
+    """
+    rows = db.execute(
+        select(CpsClick.openid, CpsClick.event_type, CpsClick.link_id)
+        .where(CpsClick.group_id == group_id)
+        .where(CpsClick.clicked_at >= _as_utc(start))
+        .where(CpsClick.clicked_at < _as_utc(end))
+        .where(CpsClick.openid.is_not(None))
+    ).all()
+    if not rows:
+        return []
+
+    # link_id -> activity_id -> 券名(活动名)
+    link_ids = {r.link_id for r in rows}
+    link_to_act = dict(
+        db.execute(
+            select(CpsLink.id, CpsLink.activity_id).where(CpsLink.id.in_(link_ids))
+        ).all()
+    )
+    act_ids = {aid for aid in link_to_act.values() if aid is not None}
+    act_name = (
+        dict(
+            db.execute(
+                select(CpsActivity.id, CpsActivity.name).where(CpsActivity.id.in_(act_ids))
+            ).all()
+        )
+        if act_ids
+        else {}
+    )
+
+    def _coupon_name(link_id: int) -> str:
+        aid = link_to_act.get(link_id)
+        if aid is None:
+            return f"链接#{link_id}"
+        return act_name.get(aid) or f"活动#{aid}"
+
+    stat: dict[str, dict] = {}
+    for openid, event_type, link_id in rows:
+        s = stat.setdefault(openid, {"copy": 0, "visit": 0, "coupons": {}})
+        if event_type == "copy":
+            s["copy"] += 1
+        else:
+            s["visit"] += 1
+            name = _coupon_name(link_id)
+            s["coupons"][name] = s["coupons"].get(name, 0) + 1
+
+    openids = list(stat.keys())
+    users = {
+        u.openid: u
+        for u in db.execute(
+            select(CpsWxUser).where(CpsWxUser.openid.in_(openids))
+        ).scalars().all()
+    }
+
+    result = [
+        {
+            "openid": openid,
+            "nickname": users[openid].nickname if openid in users else None,
+            "headimgurl": users[openid].headimgurl if openid in users else None,
+            "copy_count": s["copy"],
+            "visit_count": s["visit"],
+            "coupons": [
+                {"name": name, "count": cnt}
+                for name, cnt in sorted(
+                    s["coupons"].items(), key=lambda kv: kv[1], reverse=True
+                )
+            ],
+        }
+        for openid, s in stat.items()
+    ]
+    result.sort(key=lambda x: (x["copy_count"], x["visit_count"]), reverse=True)
+    return result[:limit]
+```
+
+- [ ] **Step 5: 加 router 端点**
+
+`app/admin/routers/cps.py`，在 `group_wx_users` 路由（文件末尾那个）之后追加：
+
+```python
+@router.get("/groups/{group_id}/day-users", summary="某天该群按用户的领券/点击 + 每人点过的券")
+def group_day_users(
+    group_id: int,
+    db: AdminDb,
+    date: Annotated[str, Query(description="北京日期 YYYY-MM-DD")],
+) -> dict:
+    group = cps_repo.get_group(db, group_id)
+    if group is None:
+        raise HTTPException(status_code=404, detail="群不存在")
+    bj = timezone(timedelta(hours=8))
+    try:
+        day0 = datetime.strptime(date, "%Y-%m-%d").replace(tzinfo=bj)
+    except ValueError as e:
+        raise HTTPException(status_code=400, detail="date 格式应为 YYYY-MM-DD") from e
+    start = day0.replace(hour=0, minute=0, second=0, microsecond=0)
+    end = start + timedelta(days=1)
+    users = cps_repo.group_day_users(db, group_id=group_id, start=start, end=end)
+    return {
+        "group_id": group.id,
+        "group_name": group.name,
+        "date": date,
+        "users": users,
+    }
+```
+
+（`datetime`/`timedelta`/`timezone`、`Annotated`、`Query`、`HTTPException` 该文件均已 import；无需新增。）
+
+- [ ] **Step 6: 跑测试确认通过**
+
+Run:
+```
+.\.venv\Scripts\pytest.exe tests\test_cps_admin.py::test_day_users_aggregates -v
+```
+Expected: PASS。
+
+- [ ] **Step 7: 提交（后端仓）**
+
+```
+git -C e:\project\shaguabijia-app-server add app/admin/repositories/cps.py app/admin/routers/cps.py tests/test_cps_admin.py
+git -C e:\project\shaguabijia-app-server commit -m "feat(cps): 新增 /day-users 按天按用户领券下钻接口"
+```
+
+---
+
+## Task 3: 后端 `/day-users` 边界用例（404 / 400 / 401 / 空天 / 跨年）
+
+**Files:**
+- Test: `tests/test_cps_admin.py`（追加）
+
+> 这些断言验证 Task 2 实现已覆盖的边界。多数应直接通过；若某条失败，回到 Task 2 对应分支修实现。
+
+- [ ] **Step 1: 追加边界测试**
+
+在 `tests/test_cps_admin.py` 末尾追加：
+
+```python
+def test_day_users_group_not_found(admin_client: TestClient, admin_token: str) -> None:
+    r = admin_client.get(
+        "/admin/api/cps/groups/999999/day-users",
+        params={"date": "2026-06-25"},
+        headers=_auth(admin_token),
+    )
+    assert r.status_code == 404
+
+
+def test_day_users_bad_date(admin_client: TestClient, admin_token: str) -> None:
+    gid, _ = _seed_cps_day(date(2026, 6, 25))
+    r = admin_client.get(
+        f"/admin/api/cps/groups/{gid}/day-users",
+        params={"date": "2026/06/25"},  # 非 YYYY-MM-DD
+        headers=_auth(admin_token),
+    )
+    assert r.status_code == 400
+
+
+def test_day_users_requires_auth(admin_client: TestClient) -> None:
+    r = admin_client.get(
+        "/admin/api/cps/groups/1/day-users", params={"date": "2026-06-25"}
+    )
+    assert r.status_code == 401
+
+
+def test_day_users_empty_when_no_clicks(admin_client: TestClient, admin_token: str) -> None:
+    gid, _ = _seed_cps_day(date(2026, 6, 25))
+    r = admin_client.get(
+        f"/admin/api/cps/groups/{gid}/day-users",
+        params={"date": "2026-06-20"},  # 该群当天无任何点击
+        headers=_auth(admin_token),
+    )
+    assert r.status_code == 200
+    assert r.json()["users"] == []
+
+
+def test_day_users_cross_year(admin_client: TestClient, admin_token: str) -> None:
+    """跨年:YYYY-MM-DD 才能精确定位 12-31(MM-DD 会丢年份);次日(次年 01-01)不计入。"""
+    gid, openid = _seed_cps_day(date(2025, 12, 31))
+    r = admin_client.get(
+        f"/admin/api/cps/groups/{gid}/day-users",
+        params={"date": "2025-12-31"},
+        headers=_auth(admin_token),
+    )
+    assert r.status_code == 200, r.text
+    users = r.json()["users"]
+    assert len(users) == 1
+    assert users[0]["openid"] == openid
+    assert users[0]["visit_count"] == 5  # 次年 01-01 那条被时间窗排除
+```
+
+- [ ] **Step 2: 跑整个测试文件确认全绿**
+
+Run:
+```
+.\.venv\Scripts\pytest.exe tests\test_cps_admin.py -v
+```
+Expected: 全部 PASS（共 7 个用例：daily 日期、aggregates、404、bad_date、auth、empty、cross_year）。
+
+- [ ] **Step 3: 跑后端全量回归（确认没碰坏既有）**
+
+Run:
+```
+.\.venv\Scripts\pytest.exe -q
+```
+Expected: 全绿（与改动前同样的通过数 + 新增 7 条）。
+
+- [ ] **Step 4: 提交（后端仓）**
+
+```
+git -C e:\project\shaguabijia-app-server add tests/test_cps_admin.py
+git -C e:\project\shaguabijia-app-server commit -m "test(cps): /day-users 边界用例(404/400/401/空天/跨年)"
+```
+
+---
+
+## Task 4: 前端日期列显示全日期并加宽
+
+**Files:**
+- Modify: `src/app/(main)/cps/groups/[id]/page.tsx`
+
+前端无测试框架，门槛为类型/构建通过（`npm run build`）。
+
+- [ ] **Step 1: 加宽日期列**
+
+`dailyColumns` 第一列（约 174 行）`width: 64` → `width: 96`：
+
+```tsx
+    { title: '日期', dataIndex: 'date', width: 96, fixed: 'left' },
+```
+
+（`date` 现由后端给全 `YYYY-MM-DD`，直接显示即可；`DailyRow.date` 类型仍是 `string`，无需改接口。）
+
+- [ ] **Step 2: 构建确认通过**
+
+Run（前端仓根目录）:
+```
+npm run build
+```
+Expected: 构建成功，无类型错误。
+
+- [ ] **Step 3: 提交（前端仓）**
+
+```
+git add src/app/(main)/cps/groups/[id]/page.tsx
+git commit -m "feat(cps): 每日明细日期列改显示全日期并加宽"
+```
+
+---
+
+## Task 5: 前端下钻 — 明细列 + Modal + Tooltip
+
+**Files:**
+- Modify: `src/app/(main)/cps/groups/[id]/page.tsx`
+
+- [ ] **Step 1: antd 引入 Modal、Tooltip**
+
+第 9 行 import 增加 `Modal, Tooltip`（保持字母序即可）：
+
+```tsx
+import { Button, Card, Col, Empty, Modal, Row, Segmented, Space, Spin, Statistic, Table, Tooltip, message } from 'antd';
+```
+
+- [ ] **Step 2: 加按天用户类型**
+
+在 `WxUser` 接口定义之后（约 58 行后）追加：
+
+```tsx
+// 某天该群按用户领券下钻(/day-users)
+interface DayCoupon {
+  name: string;
+  count: number;
+}
+interface DayUser {
+  openid: string;
+  nickname: string | null;
+  headimgurl: string | null;
+  copy_count: number;
+  visit_count: number;
+  coupons: DayCoupon[];
+}
+```
+
+- [ ] **Step 3: 加弹窗状态 + 拉取 handler**
+
+在组件内 `wxUsers` 相关 `useEffect` 之后（约 140 行后）追加。注意须在 `dailyColumns` 定义之前，供其按钮引用：
+
+```tsx
+  // 某天领券下钻弹窗
+  const [dayDetail, setDayDetail] = useState<{
+    open: boolean;
+    date: string;
+    loading: boolean;
+    users: DayUser[];
+  }>({ open: false, date: '', loading: false, users: [] });
+
+  const openDayDetail = useCallback(
+    async (date: string) => {
+      setDayDetail({ open: true, date, loading: true, users: [] });
+      try {
+        const r = await api.get<{ users: DayUser[] }>(
+          `/admin/api/cps/groups/${id}/day-users?date=${date}`,
+        );
+        setDayDetail((s) => ({ ...s, loading: false, users: r.data.users || [] }));
+      } catch (e) {
+        message.error(errMsg(e, '明细加载失败'));
+        setDayDetail((s) => ({ ...s, loading: false }));
+      }
+    },
+    [id],
+  );
+```
+
+- [ ] **Step 4: 每日明细表加「明细」列 + 调大 scroll.x**
+
+在 `dailyColumns` 数组末尾（`结算佣金` 列之后，约 226 行）追加一列：
+
+```tsx
+    {
+      title: '明细',
+      key: 'drill',
+      width: 64,
+      fixed: 'right',
+      render: (_, r) => (
+        <Button type="link" size="small" style={{ padding: 0 }} onClick={() => openDayDetail(r.date)}>
+          明细
+        </Button>
+      ),
+    },
+```
+
+同时，每日明细 `<Table>`（约 304–311 行）列宽合计已升至约 976（日期 96 + 新明细列 64），把其 `scroll={{ x: 900 }}` 改为 `scroll={{ x: 1000 }}`，保证右侧固定列与横向滚动正常：
+
+```tsx
+          scroll={{ x: 1000 }}
+```
+
+- [ ] **Step 5: 加按用户表列定义**
+
+在 `wxColumns` 定义之后（约 259 行后）追加 `dayUserColumns`：
+
+```tsx
+  const dayUserColumns: ColumnsType<DayUser> = [
+    {
+      title: '用户',
+      key: 'user',
+      render: (_, u) => (
+        <Space>
+          {u.headimgurl ? (
+            <img
+              src={u.headimgurl}
+              alt=""
+              style={{ width: 28, height: 28, borderRadius: '50%', objectFit: 'cover' }}
+            />
+          ) : (
+            <span
+              style={{ width: 28, height: 28, borderRadius: '50%', background: '#f0f0f0', display: 'inline-block' }}
+            />
+          )}
+          <span>{u.nickname || '(未授权昵称)'}</span>
+        </Space>
+      ),
+    },
+    {
+      title: '领券次数',
+      dataIndex: 'copy_count',
+      width: 100,
+      sorter: (a, b) => a.copy_count - b.copy_count,
+      render: (v: number) => (v ? <b style={{ color: '#ff4d4f' }}>{v}</b> : 0),
+    },
+    {
+      title: '点击次数',
+      dataIndex: 'visit_count',
+      width: 100,
+      render: (v: number, u) =>
+        u.coupons.length ? (
+          <Tooltip
+            title={
+              <div>
+                {u.coupons.map((c) => (
+                  <div key={c.name}>
+                    {c.name} ×{c.count}
+                  </div>
+                ))}
+              </div>
+            }
+          >
+            <span style={{ cursor: 'help', textDecoration: 'underline dotted' }}>{v}</span>
+          </Tooltip>
+        ) : (
+          v
+        ),
+    },
+  ];
+```
+
+- [ ] **Step 6: 渲染 Modal**
+
+在最外层 `</div>`（return 末尾，约 329 行）之前、群内微信用户 `Card` 之后，追加：
+
+```tsx
+      <Modal
+        open={dayDetail.open}
+        title={`群「${data?.group_name ?? ''}」${dayDetail.date} · 用户领券明细`}
+        footer={null}
+        width={640}
+        onCancel={() => setDayDetail((s) => ({ ...s, open: false }))}
+      >
+        <div style={{ fontSize: 12, color: '#999', marginBottom: 8 }}>
+          仅统计微信授权(openid)用户;美团/京东多为匿名跳转,可能为空。悬停「点击次数」看该用户当天点过的券。
+        </div>
+        <Table<DayUser>
+          rowKey="openid"
+          size="small"
+          loading={dayDetail.loading}
+          columns={dayUserColumns}
+          dataSource={dayDetail.users}
+          pagination={false}
+          locale={{ emptyText: '当天无授权用户领券/点击' }}
+        />
+      </Modal>
+```
+
+- [ ] **Step 7: 构建确认通过**
+
+Run:
+```
+npm run build
+```
+Expected: 构建成功，无类型错误。
+
+- [ ] **Step 8: 提交（前端仓）**
+
+```
+git add src/app/(main)/cps/groups/[id]/page.tsx
+git commit -m "feat(cps): 每日明细下钻弹窗(按用户领券/点击 + 券明细 tooltip)"
+```
+
+---
+
+## Task 6: 全栈联调（手动验证）
+
+**前置：** 两仓本地起服务。后端 admin API（8771）+ 前端（3001）。可用前端仓 `bash start.sh`（拉起 8770/8771/3001），默认登录 `admin` / `admin12345`。
+
+- [ ] **Step 1: 选一个有授权点击的淘宝群**
+
+后端起来后，直接验证接口（用上面手动登录拿的 admin token，或浏览器已登录的会话）：
+
+Run（确认接口连通，期望 200 + JSON 结构）:
+```
+.\.venv\Scripts\pytest.exe tests\test_cps_admin.py -v
+```
+（接口逻辑已由自动化测试覆盖；本步主要确认前端联调环境。）
+
+- [ ] **Step 2: 前端页面手动核对**
+
+打开 `http://localhost:3001` → CPS 分发 → 进任一群详情 → 每日明细表：
+- [ ] 日期列完整显示 `YYYY-MM-DD`，列宽不挤。
+- [ ] 每行末尾有「明细」按钮（右侧固定列）。
+- [ ] 点「明细」→ 弹窗打开、标题含群名与日期、加载态正常。
+- [ ] 有数据的淘宝群：用户行显示头像/昵称、领券次数、点击次数；悬停「点击次数」浮出 `券名 ×次数`，各次数之和 = 点击次数。
+- [ ] 昵称为空的用户显示 `(未授权昵称)`。
+- [ ] 美团/京东群或无授权用户的天：弹窗走空态文案 `当天无授权用户领券/点击`。
+
+- [ ] **Step 3: 收尾**
+
+确认前后端各自分支提交完整：
+```
+git -C e:\project\shaguabijia-app-server log --oneline -3
+git log --oneline -5
+```
+
+---
+
+## Self-Review（计划自检结论）
+
+- **Spec 覆盖：** `/day-users` 接口（Task 2）、券明细 visit×次数倒序（Task 2 test + 前端 Step 5）、`/daily` date 改全日期（Task 1）、匿名排除（Task 2 实现 + Task 2/3 test）、404/400/401（Task 3）、跨年（Task 3）、前端明细列/Modal/Tooltip/日期列加宽（Task 4–5）、不动数据库（无 migration 任务）—— 均有对应任务。
+- **类型一致：** 后端 `group_day_users(db, *, group_id, start, end, limit)` 在 repo 定义、router 按此调用；响应键 `group_id/group_name/date/users[*].{openid,nickname,headimgurl,copy_count,visit_count,coupons[*].{name,count}}` 与前端 `DayUser/DayCoupon` 接口逐字对应。
+- **无占位：** 所有步骤含可直接落地的完整代码与确切命令。

docs/superpowers/specs/2026-06-26-cps-day-user-drilldown-design.md

@@ -0,0 +1,132 @@
+# CPS 群详情 · 每日明细「按天 · 按用户」领券下钻
+
+日期：2026-06-26
+状态：已与用户确认设计，待写实现计划
+
+## 背景
+
+`shaguabijia-admin-web`（纯前端）+ 后端 `shaguabijia-app-server`（Admin API，`/admin/api/*`，端口 8771）。
+
+CPS 群对账详情页 `src/app/(main)/cps/groups/[id]/page.tsx` 现有两张表：
+
+- **每日明细**（`GET /admin/api/cps/groups/{id}/daily`）：按天一行，含点击/复制/订单佣金。行 `date` 原为 `"MM-DD"`（北京），下钻要完整日期 → **本次改为 `"YYYY-MM-DD"`**（见后端改动）。
+- **群内微信用户**（`GET /admin/api/cps/groups/{id}/wx-users`）：**累计**（非按天）每用户画像，列含 用户 / 领券次数(`copy_count`) / 点击次数(`visit_count`)。
+
+底层数据 `cps_click`（一事件一行）：`event_type` = `visit`(进落地页/被跳转) | `copy`(淘宝"复制口令")、`openid`(微信授权才有)、`clicked_at`、`link_id`。一条点击对应的「优惠券」= `link_id → cps_link.activity_id → cps_activity.name`（活动即优惠券）。`cps_wx_user` 按 `openid` 存 `nickname/headimgurl`。
+
+**既有口径（沿用，不改）**：领券次数 = `copy` 事件数；点击次数 = `visit` 事件数。
+
+## 目标
+
+每日明细表每行末尾加「明细」按钮 → 弹窗展示**该群、该天、以用户为单位**的领券情况：
+
+- 列：用户名、领券次数、点击次数。
+- 鼠标悬停「点击次数」→ tooltip 展示该用户当天 **visit 过的全部优惠券**，每行 `券名 ×次数`，按次数倒序，**合计 = 点击次数**。
+
+## 方案：A（一个新接口，券明细内联返回）
+
+下钻数据量小（单群 / 单天 / 有 openid 的用户）。新接口一次返回每个用户的领券数、点击数及其 visit 过的券列表，前端一次请求渲染表格 + tooltip，无悬停二次加载、无闪烁。
+
+（已否决方案 B：用户列表与券明细拆两接口、悬停再拉 —— 多一接口、多一往返、有闪烁，对这数据量不值得。）
+
+## 数据库：无需改动
+
+纯读侧聚合，所需数据已全部在库，**不加表 / 不加字段 / 无 migration / 无需回填**：
+
+- `cps_click`：`group_id`(idx) / `clicked_at`(idx) / `openid`(idx) / `event_type` / `link_id` —— 筛群、筛天、分用户、分领券/点击、定位券所需字段齐全。
+- 券归属 `link_id → cps_link.activity_id → cps_activity.name` 在**写入时**就落了（`record_click` 一直写 `link_id`），历史点击可反查，**无需回填**。
+- 查询条件 `group_id + clicked_at 区间 + openid IS NOT NULL` 均命中现有单列索引；数据量小、Python 侧聚合，**无需新增复合索引**。
+
+## 后端改动（`app/admin/routers/cps.py` + `app/admin/repositories/cps.py`）
+
+### 新增接口 `GET /admin/api/cps/groups/{group_id}/day-users`
+
+- 入参：`date`（必填，`YYYY-MM-DD`）。
+- 鉴权：`Depends(get_current_admin)`（只读，登录即可；与 `/daily`、`/wx-users` 同口径，**不加** `require_role`）。
+- 群不存在 → 404；`date` 非法 → 400（`detail` 说明格式）。
+- **时间窗**：`date` 按北京时区(UTC+8)解释成 `[当天 00:00, 次日 00:00)` **半开区间**，转 UTC 后查 `clicked_at >= start AND clicked_at < next_day_start`（半开避免午夜双计）。北京日界 → UTC 用既有 `_as_utc` 约定，与 `group_click_timeseries` 分桶口径一致。
+- **取数**：`cps_click` where `group_id == {group_id}` AND 时间窗内 AND `openid IS NOT NULL`。
+- **解析券名**：取该群相关 `cps_link`（或按出现的 `link_id` 批量取）建 `link_id → activity_id` 映射，再 `activity_id → cps_activity.name` 映射；Python 侧聚合（与本仓既有风格一致）。活动被硬删 → 券名兜底 `活动#{activity_id}`。
+- **按 openid 聚合**：
+  - `copy_count` = 该用户 `copy` 事件数（= 领券次数）
+  - `visit_count` = 该用户 `visit` 事件数（= 点击次数）
+  - `coupons` = 该用户 **visit 事件**按活动分组的 `{name, count}` 列表，按 `count` 倒序；`copy` 事件不计入券列表（与用户选择"只算 visit"一致）
+- 关联 `cps_wx_user`（`openid IN (...)`）取 `nickname/headimgurl`（未授权为 null）。
+- **排序**：`copy_count` desc，再 `visit_count` desc（沿用 `group_wx_users` 习惯）。
+- 可选 `limit`（默认 200，与 `group_wx_users` 一致）。
+
+**响应**：
+
+```json
+{
+  "group_id": 1,
+  "group_name": "宝妈薅羊毛1群",
+  "date": "2026-06-25",
+  "users": [
+    {
+      "openid": "oABC...",
+      "nickname": "张三",
+      "headimgurl": "https://thirdwx.qlogo.cn/...",
+      "copy_count": 2,
+      "visit_count": 5,
+      "coupons": [
+        { "name": "618神券", "count": 3 },
+        { "name": "买一送一", "count": 2 }
+      ]
+    }
+  ]
+}
+```
+
+实现建议：在 `cps_repo` 加 `group_day_users(db, *, group_id, date_start, date_end, limit=200) -> list[dict]`，router 负责日期解析与窗口计算后调用之（与 `group_daily`/`group_wx_users` 的分工一致）。
+
+### 微调既有 `/daily`：`date` 改全日期（不新增字段）
+
+把每行 `date` 从 `"MM-DD"` 改成 **`"YYYY-MM-DD"`**（北京），**不再新增 `date_iso`**。下钻必须知道完整日期（`MM-DD` 丢年份，跨年会错）；`date` 直接给全日期，契约更简单、无冗余字段。`group_daily` 已在循环里持有北京日期 `cur`，把 `cur.strftime("%m-%d")` 改成 `cur.strftime("%Y-%m-%d")` 即可。
+
+- 该 endpoint 唯一消费方是本前端（随本次一起改），故**非破坏性**。
+- 折线图/时序用的是 `/timeseries` 的 `label` 字段（另一套，仍 `MM-DD`），**不受影响**，本次不动。
+
+## 前端改动（`src/app/(main)/cps/groups/[id]/page.tsx`）
+
+1. `DailyRow.date` 现为 `"YYYY-MM-DD"`（类型仍 `string`，无需加字段）。日期列 `{ title:'日期', dataIndex:'date' }` 宽度 64 → **调宽到约 96，完整显示 `YYYY-MM-DD`**（跨月/跨年看范围更直观）。表格 `scroll.x` 随新列 + 加宽日期列相应上调（约 980）。
+2. 新增类型：
+   ```ts
+   interface DayCoupon { name: string; count: number; }
+   interface DayUser {
+     openid: string; nickname: string | null; headimgurl: string | null;
+     copy_count: number; visit_count: number; coupons: DayCoupon[];
+   }
+   ```
+3. `dailyColumns` 末尾加**「明细」列**（`key:'drill'`, `fixed:'right'`, `width≈64`），render 一个 `type="link"` 小按钮，`onClick` → `openDayDetail(row.date)`（全日期既用于查询也用于弹窗标题）。
+4. 弹窗状态：`{ open, date, loading, users }`。`openDayDetail(date)` 置 open+loading，`api.get('/admin/api/cps/groups/${id}/day-users?date=' + date)` → 填 `users`；失败 `message.error(errMsg(e, ...))`。
+5. 新增 `<Modal>`（声明式组件，不受 antd5 静态方法 context 限制，无需 `App.useApp()`）含 `<Table>`，三列：
+   - **用户**：头像 + 昵称（空 → `(未授权昵称)`），与既有「群内微信用户」表的用户单元一致（头像直接 `<img src={headimgurl}>`，微信 URL 为绝对地址，非 `/media`）。
+   - **领券次数**：`copy_count`，沿用既有红色加粗样式（0 显示 0）。
+   - **点击次数**：`visit_count`，整格用 `<Tooltip>` 包裹，`title` 渲染 `coupons` 每行 `券名 ×次数`；`coupons` 为空时不挂 tooltip（直接显示数字）。
+6. Modal 标题：`群「{group_name}」{date} · 用户领券明细`。空态文案：`仅统计微信授权(openid)用户；美团/京东多为匿名跳转，可能为空`。
+7. antd 引入新增 `Modal, Tooltip`。
+
+## 默认与边界（已确认）
+
+- **匿名点击（openid 为空）不计入**（无法归属到人），镜像既有 `/wx-users`。后果：美团/京东群弹窗常为空 —— 空态文案已提示。
+- **数据口径差异（需在代码注释点明，避免误读为 bug）**：每日明细行的 `click_pv/copy_pv` 计**全部**点击（含匿名、UV 按 `(ip,ua)`）；本弹窗只计 `openid` 用户。故弹窗各用户求和 **≤** 当天行的点击/复制总数，二者不必相等。
+- **谁出现在弹窗**：当天有任意事件（visit 或 copy）的授权用户都列（含领券数为 0 的纯点击用户）。
+- **领券次数不做 tooltip**：需求只要点击次数的 tooltip，保持最小。
+- **权限**：不加角色门槛（与本页其它只读统计一致）。
+
+## 不做（YAGNI）
+
+- 领券次数的「领了哪些券」tooltip。
+- 匿名点击的聚合行 / 占位行。
+- 用户级下单归因（需 user-level sid，另一期）。
+
+## 验证（本仓无测试框架，手动验证）
+
+- 后端：选一个有 `cps_click` 数据的淘宝群，`curl .../day-users?date=<某天>`，核对：①只含 openid 非空用户；②某用户 `coupons` 的 `count` 之和 = 其 `visit_count`；③`date` 非法返回 400、群不存在返回 404；④跨年日期（如去年 12-31）能取到正确那天。
+- 前端：`npm run build` 通过；日期列完整显示 `YYYY-MM-DD`、列宽不挤；明细按钮 → 弹窗加载；悬停点击次数显示券×次数且合计对得上；美团/京东群弹窗走空态文案；昵称为空显示占位。
+
+## 落点文件
+
+- 后端：`app/admin/routers/cps.py`（新 endpoint + `/daily` 的 `date` 改 `YYYY-MM-DD`）、`app/admin/repositories/cps.py`（新 `group_day_users` + `group_daily` 的 `date` 改全日期）。
+- 前端：`src/app/(main)/cps/groups/[id]/page.tsx`（类型、日期列加宽、明细列、Modal、Tooltip）。

package.json

@@ -12,6 +12,7 @@
     "@ant-design/cssinjs": "^1.24.0",
     "@ant-design/icons": "^5.5.2",
     "@ant-design/nextjs-registry": "^1.0.2",
+    "@ant-design/plots": "^2.6.8",
     "@ant-design/v5-patch-for-react-19": "^1.0.3",
     "antd": "^5.22.0",
     "axios": "^1.7.7",

src/app/(main)/ad-audit/page.tsx

@@ -1,247 +0,0 @@
-'use client';
-
-import { useCallback, useEffect, useState } from 'react';
-import type { ColumnsType } from 'antd/es/table';
-import {
-  Alert,
-  Button,
-  Card,
-  Checkbox,
-  DatePicker,
-  InputNumber,
-  Select,
-  Space,
-  Table,
-  Tag,
-  Typography,
-  message,
-} from 'antd';
-import dayjs, { type Dayjs } from 'dayjs';
-import { api, errMsg } from '@/lib/api';
-import { formatUtcTime } from '@/lib/format';
-import type { AdCoinAudit, AdCoinAuditRow } from '@/lib/types';
-
-const SCENE_TAG: Record<string, { color: string; label: string }> = {
-  reward_video: { color: 'blue', label: '看视频' },
-  feed: { color: 'purple', label: '信息流' },
-};
-
-const STATUS_TAG: Record<string, string> = {
-  granted: 'green',
-  capped: 'orange',
-  ecpm_missing: 'red',
-};
-
-const fmtFactorRange = (a: number | null, b: number | null) => {
-  if (a == null) return '-';
-  return a === b || b == null ? String(a) : `${a}→${b}`;
-};
-
-const fmtIndexRange = (a: number | null, b: number | null) => {
-  if (a == null) return '-';
-  return a === b ? String(a) : `${a}–${b}`;
-};
-
-export default function AdAuditPage() {
-  const [date, setDate] = useState<Dayjs>(dayjs());
-  const [userId, setUserId] = useState<number | null>(null);
-  const [scene, setScene] = useState<string | undefined>();
-  const [limit, setLimit] = useState<number>(100);
-  const [data, setData] = useState<AdCoinAudit | null>(null);
-  const [queriedLimit, setQueriedLimit] = useState<number>(100); // 本次结果对应的 limit,截断提示里展示
-  const [onlyMismatch, setOnlyMismatch] = useState(false); // 只看不一致(✗)行
-  const [loading, setLoading] = useState(false);
-
-  const load = useCallback(async () => {
-    setLoading(true);
-    try {
-      const res = await api.get<AdCoinAudit>('/admin/api/ad-coin-audit', {
-        params: {
-          date: date.format('YYYY-MM-DD'),
-          user_id: userId ?? undefined,
-          scene: scene ?? undefined,
-          limit,
-          only_mismatch: onlyMismatch || undefined,
-        },
-      });
-      setData(res.data);
-      setQueriedLimit(limit);
-    } catch (e) {
-      message.error(errMsg(e));
-    } finally {
-      setLoading(false);
-    }
-  }, [date, userId, scene, limit, onlyMismatch]);
-
-  useEffect(() => {
-    load();
-    // 仅首次自动拉今天;之后由「查询」按钮触发
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-
-  const columns: ColumnsType<AdCoinAuditRow> = [
-    {
-      title: '场景',
-      dataIndex: 'scene',
-      width: 90,
-      render: (s: string) => {
-        const t = SCENE_TAG[s] ?? { color: 'default', label: s };
-        return <Tag color={t.color}>{t.label}</Tag>;
-      },
-    },
-    { title: '时间', dataIndex: 'created_at', render: (v: string) => formatUtcTime(v), width: 175 },
-    { title: '用户', dataIndex: 'user_id', width: 70 },
-    {
-      title: '状态',
-      dataIndex: 'status',
-      width: 110,
-      render: (s: string) => <Tag color={STATUS_TAG[s] ?? 'default'}>{s}</Tag>,
-    },
-    { title: 'eCPM', dataIndex: 'ecpm', width: 90, render: (v: string | null) => v ?? '-' },
-    {
-      title: '因子1',
-      dataIndex: 'ecpm_factor',
-      width: 70,
-      render: (v: number | null) => v ?? '-',
-    },
-    { title: '份数', dataIndex: 'units', width: 60 },
-    {
-      title: 'LT累计条数',
-      key: 'lt_index',
-      width: 100,
-      render: (_: unknown, r: AdCoinAuditRow) => fmtIndexRange(r.lt_index_start, r.lt_index_end),
-    },
-    {
-      title: '因子2',
-      key: 'lt_factor',
-      width: 90,
-      render: (_: unknown, r: AdCoinAuditRow) => fmtFactorRange(r.lt_factor_start, r.lt_factor_end),
-    },
-    {
-      title: '应发金币',
-      dataIndex: 'expected_coin',
-      width: 100,
-      render: (v: number) => <b>{v}</b>,
-    },
-    { title: '实发金币', dataIndex: 'actual_coin', width: 100 },
-    {
-      title: '一致',
-      dataIndex: 'matched',
-      width: 70,
-      render: (m: boolean) =>
-        m ? <Tag color="green">✓</Tag> : <Tag color="red">✗ 不符</Tag>,
-    },
-  ];
-
-  return (
-    <div>
-      <h2>看广告金币审计</h2>
-      <Typography.Paragraph type="secondary" style={{ marginBottom: 16 }}>
-        把「看视频赚金币」和「比价信息流广告」的发奖记录,用与正式发奖相同的公式复算一遍,核对实发金币是否按公式计算。纯只读对账。
-      </Typography.Paragraph>
-
-      {data && (
-        <Card size="small" style={{ marginBottom: 16 }}>
-          <Typography.Text strong>金币公式:</Typography.Text>{' '}
-          <Typography.Text code>{data.formula.description}</Typography.Text>
-          <div style={{ marginTop: 8, color: '#666', fontSize: 13 }}>
-            <div>
-              eCPM 口径:{data.formula.ecpm_unit},计算时 ÷100 转元;金币:元 ={' '}
-              {data.formula.coin_per_yuan}:1;信息流每 {data.formula.feed_unit_seconds} 秒折 1 条。两个点位「LT累计条数」各自独立计数。
-            </div>
-            <div style={{ marginTop: 4 }}>
-              因子1(按 eCPM 元判档,阈值单位:元):
-              {data.formula.ecpm_factor_tiers
-                .map(([f, lo, hi]) => `${lo}~${hi ?? '∞'}元→${f}`)
-                .join('  |  ')}
-            </div>
-            <div style={{ marginTop: 4 }}>
-              因子2(LT 累计条数):
-              {data.formula.lt_factor_tiers
-                .map(([f, lo, hi]) => `${lo}${hi != null && hi !== lo ? `~${hi}` : ''}→${f}`)
-                .join('  |  ')}
-            </div>
-          </div>
-        </Card>
-      )}
-
-      <Space style={{ marginBottom: 16 }} wrap>
-        <DatePicker value={date} onChange={(d) => d && setDate(d)} allowClear={false} />
-        <InputNumber
-          placeholder="用户 ID(可空)"
-          value={userId ?? undefined}
-          onChange={(v) => setUserId(v ?? null)}
-          style={{ width: 140 }}
-        />
-        <Select
-          placeholder="场景(全部)"
-          value={scene}
-          onChange={setScene}
-          allowClear
-          style={{ width: 140 }}
-          options={[
-            { value: 'reward_video', label: '看视频' },
-            { value: 'feed', label: '信息流' },
-          ]}
-        />
-        <Select
-          value={limit}
-          onChange={setLimit}
-          style={{ width: 120 }}
-          options={[50, 100, 200, 500].map((n) => ({ value: n, label: `${n} 条` }))}
-        />
-        <Checkbox checked={onlyMismatch} onChange={(e) => setOnlyMismatch(e.target.checked)}>
-          只看不一致(✗)
-        </Checkbox>
-        <Button type="primary" onClick={load} loading={loading}>
-          查询
-        </Button>
-      </Space>
-
-      {data && (
-        <div style={{ marginBottom: 12 }}>
-          <Space direction="vertical" style={{ width: '100%' }}>
-            {data.mismatch_count > 0 ? (
-              <Alert
-                type="error"
-                message={`共 ${data.total} 条,其中 ${data.mismatch_count} 条复算与实发不一致(✗)——公式可能未生效或发奖有问题`}
-              />
-            ) : (
-              <Alert type="success" message={`共 ${data.total} 条,全部按公式发放(无不一致)`} />
-            )}
-            {onlyMismatch && (
-              <Alert
-                type="info"
-                showIcon
-                message={`当前只展示不一致(✗)行;上方统计仍为全量(共 ${data.total} 条)。`}
-              />
-            )}
-            {data.truncated && (
-              <Alert
-                type="warning"
-                showIcon
-                message={`展示明细已截断到 ${queriedLimit} 条,还有更多未显示——请按用户/场景/日期缩小范围,或调大「条数」。统计数字不受影响。`}
-              />
-            )}
-          </Space>
-        </div>
-      )}
-
-      <Table
-        rowKey={(r) => `${r.scene}-${r.record_id}`}
-        columns={columns}
-        dataSource={data?.items ?? []}
-        loading={loading}
-        pagination={false}
-        size="small"
-        scroll={{ x: 1100 }}
-        rowClassName={(r) => (r.matched ? '' : 'row-mismatch')}
-      />
-      <style jsx global>{`
-        .row-mismatch > td {
-          background: #fff1f0 !important;
-        }
-      `}</style>
-    </div>
-  );
-}

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

@@ -0,0 +1,877 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
+import type { ColumnsType } from 'antd/es/table';
+import {
+  App,
+  Alert,
+  Button,
+  Card,
+  Col,
+  DatePicker,
+  Descriptions,
+  Divider,
+  InputNumber,
+  Modal,
+  Popover,
+  Row,
+  Select,
+  Space,
+  Statistic,
+  Table,
+  Tag,
+  Tooltip,
+  Typography,
+} from 'antd';
+import {
+  FallOutlined,
+  InfoCircleOutlined,
+  QuestionCircleOutlined,
+  RiseOutlined,
+} from '@ant-design/icons';
+import dayjs, { type Dayjs } from 'dayjs';
+import { api, errMsg } from '@/lib/api';
+import { formatUtcTime } from '@/lib/format';
+import type {
+  AdRevenueDaily,
+  AdRevenueHourly,
+  AdRevenueRecord,
+  AdRevenueReport,
+  AdRevenueRow,
+  AdRevenueTypeStat,
+} from '@/lib/types';
+
+const { RangePicker } = DatePicker;
+
+// 广告类型标签
+const TYPE_TAG: Record<string, { color: string; label: string }> = {
+  reward_video: { color: 'blue', label: '激励视频' },
+  feed: { color: 'purple', label: '信息流' },
+  draw: { color: 'geekblue', label: 'Draw 信息流' },
+  withdrawal_video: { color: 'gold', label: '提现激励视频' },
+};
+
+// Draw 信息流投放场景标签(后端 AdRevenueRow.feed_scene:comparison/coupon/welfare)
+const SCENE_TAG: Record<string, { text: string; color: string }> = {
+  comparison: { text: '比价', color: 'blue' },
+  coupon: { text: '领券', color: 'gold' },
+  welfare: { text: '福利', color: 'green' },
+};
+
+// 我们的应用环境标签
+const APP_TAG: Record<string, { color: string; label: string }> = {
+  prod: { color: 'green', label: '傻瓜比价(正式)' },
+  test: { color: 'default', label: '测试应用' },
+};
+
+// 发奖状态 → 颜色 + 中文(含「不发金币的原因」:提前关闭/未满10秒/缺eCPM/次数超限)
+const STATUS_TAG: Record<string, { color: string; label: string }> = {
+  granted: { color: 'green', label: '已发' },
+  capped: { color: 'orange', label: '次数超限' },
+  ecpm_missing: { color: 'red', label: '缺 eCPM' },
+  too_short: { color: 'gold', label: '未满10秒' },
+  closed_early: { color: 'default', label: '提前关闭' },
+};
+
+const fmtFactorRange = (a: number | null, b: number | null) => {
+  if (a == null) return '-';
+  return a === b || b == null ? String(a) : `${a}→${b}`;
+};
+
+const fmtIndexRange = (a: number | null, b: number | null) => {
+  if (a == null) return '-';
+  return a === b ? String(a) : `${a}–${b}`;
+};
+
+// 金币计算公式(写死,展示用)——与后端 app/core/rewards.py 同源,改动以后端常量为准。
+// 单次奖励(元) = (eCPM元 ÷ 1000) × 因子1(eCPM 元档) × 因子2(LT 累计条数);1 元 = 10000 金币,四舍五入取整。
+const COIN_PER_YUAN = 10000;
+// 因子1:按 eCPM(元/千次)判档,对应 AD_ECPM_FACTOR_TABLE
+const ECPM_FACTOR_ROWS = [
+  { key: '4', range: '> 400', factor: 0.6 },
+  { key: '3', range: '201 – 400', factor: 0.4 },
+  { key: '2', range: '101 – 200', factor: 0.3 },
+  { key: '1', range: '0 – 100', factor: 0.1 },
+];
+// 因子2:按该账号累计第几条/份(不按天重置),对应 AD_LT_FACTOR_TABLE
+const LT_FACTOR_ROWS = [
+  { key: '1', lt: '第 1 条', factor: 2.0 },
+  { key: '2', lt: '第 2 条', factor: 1.5 },
+  { key: '3', lt: '第 3 条', factor: 1.3 },
+  { key: '4', lt: '4 – 10 条', factor: 1.1 },
+  { key: '5', lt: '第 11 条及以后', factor: 1.0 },
+];
+
+// 展开行(逐条事件展开)- 该条的发奖复算明细(还原金币审计的 eCPM/因子1/份数/LT/因子2 等列)
+const DETAIL_COLUMNS: ColumnsType<AdRevenueRecord> = [
+  { title: '时间', dataIndex: 'created_at', render: (v: string) => formatUtcTime(v), width: 165 },
+  {
+    title: '状态',
+    dataIndex: 'status',
+    width: 110,
+    render: (s: string) => {
+      const t = STATUS_TAG[s] ?? { color: 'default', label: s };
+      return <Tag color={t.color}>{t.label}</Tag>;
+    },
+  },
+  { title: 'eCPM（分）', dataIndex: 'ecpm', width: 90, render: (v: string | null) => v ?? '-' },
+  { title: '因子1', dataIndex: 'ecpm_factor', width: 70, render: (v: number | null) => v ?? '-' },
+  { title: '份数', dataIndex: 'units', width: 60 },
+  {
+    title: 'LT累计条数',
+    key: 'lt_index',
+    width: 100,
+    render: (_: unknown, r: AdRevenueRecord) => fmtIndexRange(r.lt_index_start, r.lt_index_end),
+  },
+  {
+    title: '因子2',
+    key: 'lt_factor',
+    width: 90,
+    render: (_: unknown, r: AdRevenueRecord) => fmtFactorRange(r.lt_factor_start, r.lt_factor_end),
+  },
+  { title: '应发金币', dataIndex: 'expected_coin', width: 100, render: (v: number) => <b>{v}</b> },
+  { title: '实发金币', dataIndex: 'actual_coin', width: 100 },
+  {
+    title: '一致',
+    dataIndex: 'matched',
+    width: 80,
+    render: (m: boolean) => (m ? <Tag color="green">✓</Tag> : <Tag color="red">✗ 不符</Tag>),
+  },
+];
+
+// 趋势图(纯 SVG,零依赖):柱=展示条数(左轴),线=预估收益元(右轴)。x 轴按传入点序。
+const CHART_BAR = '#69b1ff';
+const CHART_LINE = '#fa8c16';
+
+interface TrendPoint {
+  label: string; // x 轴刻度文案(小时数 / MM-DD)
+  tip: string; // hover 原生 tooltip 全文
+  impressions: number;
+  revenue: number;
+}
+
+// 按小时聚合(0–23),数据源是 hourly(后端全量聚合,不受分页影响)
+function aggregateHourly(rows: AdRevenueHourly[]): TrendPoint[] {
+  const byHour = Array.from({ length: 24 }, (_, h) => ({ hour: h, impressions: 0, revenue: 0 }));
+  for (const r of rows) {
+    if (r.hour == null || r.hour < 0 || r.hour > 23) continue;
+    byHour[r.hour].impressions += r.impressions;
+    byHour[r.hour].revenue += r.revenue_yuan;
+  }
+  return byHour.map((b) => ({
+    label: String(b.hour),
+    tip: `${String(b.hour).padStart(2, '0')}:00　展示 ${b.impressions} 条 · 预估收益 ${b.revenue.toFixed(4)} 元`,
+    impressions: b.impressions,
+    revenue: b.revenue,
+  }));
+}
+
+// 按天聚合,数据源是 daily(全量,不受 limit 影响);用 from..to 补齐空缺日为 0,轴连续
+function aggregateDaily(dateFrom: string, dateTo: string, daily: AdRevenueDaily[]): TrendPoint[] {
+  const map = new Map(daily.map((d) => [d.date, d]));
+  const out: TrendPoint[] = [];
+  let cur = dayjs(dateFrom);
+  let guard = 0;
+  while (cur.format('YYYY-MM-DD') <= dateTo && guard < 400) {
+    const ds = cur.format('YYYY-MM-DD');
+    const d = map.get(ds);
+    const impressions = d?.impressions ?? 0;
+    const revenue = d?.revenue_yuan ?? 0;
+    out.push({
+      label: ds.slice(5),
+      tip: `${ds}　展示 ${impressions} 条 · 预估收益 ${revenue.toFixed(4)} 元`,
+      impressions,
+      revenue,
+    });
+    cur = cur.add(1, 'day');
+    guard += 1;
+  }
+  return out;
+}
+
+function TrendChart({ points }: { points: TrendPoint[] }) {
+  const n = points.length;
+  const maxImp = Math.max(1, ...points.map((p) => p.impressions));
+  const maxRev = Math.max(1e-9, ...points.map((p) => p.revenue));
+
+  const W = 960;
+  const H = 280;
+  const padL = 48;
+  const padR = 56;
+  const padT = 16;
+  const padB = 32;
+  const plotW = W - padL - padR;
+  const plotH = H - padT - padB;
+  const step = plotW / Math.max(1, n);
+  const barW = Math.min(28, step * 0.55);
+  const yBase = padT + plotH;
+
+  const barX = (i: number) => padL + i * step + (step - barW) / 2;
+  const cx = (i: number) => padL + i * step + step / 2;
+  const impH = (v: number) => (v / maxImp) * plotH;
+  const revY = (v: number) => yBase - (v / maxRev) * plotH;
+  const linePts = points.map((p, i) => `${cx(i)},${revY(p.revenue)}`).join(' ');
+  const labelEvery = Math.max(1, Math.ceil(n / 12)); // 至多 ~12 个 x 标签,避免拥挤
+
+  return (
+    <svg viewBox={`0 0 ${W} ${H}`} width="100%" style={{ display: 'block' }} role="img" aria-label="趋势图">
+      {[0, 0.25, 0.5, 0.75, 1].map((t) => {
+        const y = yBase - t * plotH;
+        return (
+          <g key={t}>
+            <line x1={padL} y1={y} x2={W - padR} y2={y} stroke="#f0f0f0" />
+            <text x={padL - 8} y={y + 4} textAnchor="end" fontSize={11} fill={CHART_BAR}>
+              {Math.round(maxImp * t)}
+            </text>
+            <text x={W - padR + 8} y={y + 4} textAnchor="start" fontSize={11} fill={CHART_LINE}>
+              {(maxRev * t).toFixed(2)}
+            </text>
+          </g>
+        );
+      })}
+      {points.map((p, i) => (
+        <rect
+          key={i}
+          x={barX(i)}
+          y={yBase - impH(p.impressions)}
+          width={barW}
+          height={impH(p.impressions)}
+          fill={CHART_BAR}
+          rx={2}
+        >
+          <title>{p.tip}</title>
+        </rect>
+      ))}
+      <polyline points={linePts} fill="none" stroke={CHART_LINE} strokeWidth={2} />
+      {points.map((p, i) => (
+        <circle key={i} cx={cx(i)} cy={revY(p.revenue)} r={2.5} fill={CHART_LINE}>
+          <title>{p.tip}</title>
+        </circle>
+      ))}
+      {points.map((p, i) =>
+        i % labelEvery === 0 || i === n - 1 ? (
+          <text key={i} x={cx(i)} y={H - 14} textAnchor="middle" fontSize={11} fill="#999">
+            {p.label}
+          </text>
+        ) : null,
+      )}
+    </svg>
+  );
+}
+
+// 广告收益报表页:单表 —— 按 用户×类型×应用×代码位 聚合,一行同时给出
+// 展示条数 / 收益 / 应发金币 / 实发金币 / 是否一致(发奖对账下沉到聚合级)。
+// 穿山甲 app_id / 广告位 / 开关等配置在「广告配置」页(/ad-revenue)维护。
+export default function AdRevenueReportPage() {
+  const { message } = App.useApp();
+  const [range, setRange] = useState<[Dayjs, Dayjs]>([dayjs(), dayjs()]);
+  const [userId, setUserId] = useState<number | null>(null);
+  const [adType, setAdType] = useState<string | undefined>();
+  // 「场景」作为后端全局筛选(feed_scene):同时影响明细 / 合计 / 趋势,与「用户 / 类型」一致,点「查询」生效。
+  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>(500); // 每页条数(分页大小)
+  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 [queriedLimit, setQueriedLimit] = useState<number>(500);
+  const [loading, setLoading] = useState(false);
+  const [formulaOpen, setFormulaOpen] = useState(false);
+
+  // 当前选择是否跨多天:跨多天时「按小时」无意义,粒度强制按天
+  const rangeMultiDay = range[0].format('YYYY-MM-DD') !== range[1].format('YYYY-MM-DD');
+
+  // load(目标页, 每页条数):分页与筛选都经它。offset 由 页码×每页 算;场景(feed_scene)随筛选下推后端。
+  const load = useCallback(
+    async (targetPage = 1, targetLimit = limit, targetSort = sortBy) => {
+      const from = range[0].format('YYYY-MM-DD');
+      const to = range[1].format('YYYY-MM-DD');
+      const multiDay = from !== to;
+      const gran = multiDay ? 'day' : granularity; // 跨多天强制按天
+      setLoading(true);
+      try {
+        const res = await api.get<AdRevenueReport>('/admin/api/ad-revenue-report', {
+          params: {
+            date_from: from,
+            date_to: to,
+            user_id: userId ?? undefined,
+            ad_type: adType ?? undefined,
+            feed_scene: scene ?? undefined,
+            granularity: gran,
+            limit: targetLimit,
+            offset: (targetPage - 1) * targetLimit,
+            sort: targetSort,
+          },
+        });
+        setData(res.data);
+        setPage(targetPage);
+        setQueriedLimit(targetLimit);
+        setQueriedGranularity(gran);
+        setQueriedMultiDay(multiDay);
+      } catch (e) {
+        message.error(errMsg(e));
+      } finally {
+        setLoading(false);
+      }
+    },
+    [range, userId, adType, scene, granularity, limit, sortBy],
+  );
+
+  useEffect(() => {
+    load();
+    // 仅首次自动拉今天;之后由「查询」按钮触发
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  const columns: ColumnsType<AdRevenueRow> = [
+    ...(queriedMultiDay
+      ? [{ title: '日期', dataIndex: 'report_date', width: 105, fixed: 'left' } as ColumnsType<AdRevenueRow>[number]]
+      : []),
+    { title: '时间', dataIndex: 'created_at', width: 165, render: (v: string) => formatUtcTime(v) },
+    {
+      title: '用户',
+      dataIndex: 'user_phone',
+      width: 150,
+      render: (phone: string | null, r: AdRevenueRow) =>
+        phone ? (
+          <span>
+            {phone}
+            <Typography.Text type="secondary" style={{ fontSize: 11, marginLeft: 6 }}>
+              #{r.user_id}
+            </Typography.Text>
+          </span>
+        ) : (
+          <Typography.Text type="secondary">#{r.user_id}（无手机号）</Typography.Text>
+        ),
+    },
+    {
+      title: '广告类型',
+      dataIndex: 'ad_type',
+      width: 110,
+      render: (s: string) => {
+        const t = TYPE_TAG[s] ?? { color: 'default', label: s };
+        return <Tag color={t.color}>{t.label}</Tag>;
+      },
+    },
+    {
+      title: '场景',
+      dataIndex: 'feed_scene',
+      width: 80,
+      render: (v: string | null | undefined) => {
+        if (!v) return <Typography.Text type="secondary">-</Typography.Text>;
+        const t = SCENE_TAG[v];
+        return t ? <Tag color={t.color}>{t.text}</Tag> : <Tag>{v}</Tag>;
+      },
+    },
+    {
+      title: '来源应用',
+      dataIndex: 'app_env',
+      width: 140,
+      render: (v: string | null) => {
+        if (!v) return <Typography.Text type="secondary">未知</Typography.Text>;
+        const t = APP_TAG[v] ?? { color: 'default', label: v };
+        return <Tag color={t.color}>{t.label}</Tag>;
+      },
+    },
+    {
+      title: 'eCPM（分）',
+      dataIndex: 'ecpm',
+      width: 100,
+      align: 'right',
+      render: (v: string | null) => v ?? '-',
+    },
+    {
+      title: 'eCPM（元）',
+      key: 'ecpm_yuan',
+      width: 100,
+      align: 'right',
+      render: (_: unknown, r: AdRevenueRow) => {
+        // eCPM 原始值单位「分/千次」,÷100 转「元/千次」(块);非数字 / 空显示 -。
+        const cents = r.ecpm == null ? null : Number(r.ecpm);
+        return cents == null || Number.isNaN(cents) ? '-' : (cents / 100).toFixed(2);
+      },
+    },
+    {
+      title: '预估收益(元)',
+      dataIndex: 'revenue_yuan',
+      width: 110,
+      align: 'right',
+      render: (v: number, r: AdRevenueRow) => (r.has_impression ? v.toFixed(4) : '-'),
+    },
+    {
+      title: '发奖状态',
+      dataIndex: 'status',
+      width: 100,
+      render: (s: string | null) => {
+        if (!s) return <Tag>仅展示</Tag>;
+        const t = STATUS_TAG[s] ?? { color: 'default', label: s };
+        return <Tag color={t.color}>{t.label}</Tag>;
+      },
+    },
+    {
+      title: '应发金币',
+      dataIndex: 'expected_coin',
+      width: 90,
+      align: 'right',
+      render: (v: number, r: AdRevenueRow) =>
+        r.has_reward ? <b>{v}</b> : <Typography.Text type="secondary">-</Typography.Text>,
+    },
+    {
+      title: '实发金币',
+      dataIndex: 'actual_coin',
+      width: 90,
+      align: 'right',
+      render: (v: number, r: AdRevenueRow) =>
+        r.has_reward ? v : <Typography.Text type="secondary">-</Typography.Text>,
+    },
+    {
+      title: '一致',
+      dataIndex: 'matched',
+      width: 70,
+      align: 'center',
+      render: (m: boolean, r: AdRevenueRow) =>
+        r.has_reward ? (
+          m ? <Tag color="green">✓</Tag> : <Tag color="red">✗ 不符</Tag>
+        ) : (
+          <Typography.Text type="secondary">-</Typography.Text>
+        ),
+    },
+    {
+      title: '广告位ID',
+      dataIndex: 'our_code_id',
+      width: 110,
+      render: (v: string | null) =>
+        v ? <Typography.Text code>{v}</Typography.Text> : <Typography.Text type="secondary">-</Typography.Text>,
+    },
+    {
+      title: '底层 ADN',
+      dataIndex: 'adn',
+      width: 100,
+      render: (v: string | null) =>
+        v ? <Tag>{v}</Tag> : <Typography.Text type="secondary">-</Typography.Text>,
+    },
+  ];
+
+  // 派生指标(全部基于全量 total_* 字段,不受分页影响,准):
+  // 发奖成本(元)= 实发金币÷汇率;预估毛利 = 收益−发奖成本;发奖占收益比 = 发奖成本÷收益;
+  // 应发实发差额(金币)= 应发−实发(正=少发/负=多发);ARPU = 预估收益÷今日DAU(仅今日)。
+  const derived = data
+    ? {
+        payoutYuan: data.total_actual_coin / COIN_PER_YUAN,
+        grossProfit: data.total_revenue_yuan - data.total_actual_coin / COIN_PER_YUAN,
+        payoutRatioPct:
+          data.total_revenue_yuan > 0
+            ? (data.total_actual_coin / COIN_PER_YUAN / data.total_revenue_yuan) * 100
+            : null,
+        coinGap: data.total_expected_coin - data.total_actual_coin,
+        // ARPU(今日)= 预估广告收益 ÷ 今日 DAU;dau 为 null(历史/多天)或 0 时不可算 → null,前端显示「-」。
+        arpu: data.dau && data.dau > 0 ? data.total_revenue_yuan / data.dau : null,
+      }
+    : null;
+
+  // 第二行大盘「分广告类型」:draw / 激励视频 各自 收益 / eCPM / 展示条数;eCPM = 收益÷展示×1000。
+  const drawStat = data?.type_stats?.draw;
+  const rvStat = data?.type_stats?.reward_video;
+  const ecpmOf = (s?: AdRevenueTypeStat) =>
+    s && s.impressions > 0 ? (s.revenue_yuan / s.impressions) * 1000 : 0;
+
+  // 明细直接用后端返回的当前页 items(「场景」已由后端 feed_scene 全局过滤,前端不再二次筛)。
+  const items = data?.items ?? [];
+
+  return (
+    <div>
+      <Space align="center" style={{ display: 'flex', marginBottom: 16 }}>
+        <h2 style={{ margin: 0 }}>收益报表</h2>
+        <Button
+          type="link"
+          size="small"
+          icon={<QuestionCircleOutlined />}
+          onClick={() => setFormulaOpen(true)}
+        >
+          金币计算规则
+        </Button>
+        <Popover
+          placement="bottomLeft"
+          title="收益口径说明"
+          content={
+            <div style={{ maxWidth: 360, fontSize: 13, lineHeight: 1.7 }}>
+              「预估收益」为客户端在广告展示(onAdShow)时上报 eCPM 折算的预估值(每千次展示 ÷1000
+              累加),<b>只要广告展示就计入、不论是否看完发奖</b>;穿山甲会过滤无效/过短曝光,故预估值可能偏高,
+              <b>实际收益一律以穿山甲后台结算为准</b>。测试应用多为 0。「广告位ID / 来源应用」为本期新增,历史记录留空。
+            </div>
+          }
+        >
+          <Button type="link" size="small" icon={<InfoCircleOutlined />}>
+            收益口径
+          </Button>
+        </Popover>
+      </Space>
+
+      <Card size="small" style={{ marginBottom: 16 }}>
+        <Space wrap size="middle" align="center">
+          <Space size={6}>
+            <Typography.Text type="secondary">日期</Typography.Text>
+            <RangePicker
+              value={range}
+              onChange={(v) => v && v[0] && v[1] && setRange([v[0], v[1]])}
+              allowClear={false}
+              presets={[
+                { label: '今天', value: [dayjs(), dayjs()] },
+                { label: '近 7 天', value: [dayjs().subtract(6, 'day'), dayjs()] },
+                { label: '近 30 天', value: [dayjs().subtract(29, 'day'), dayjs()] },
+              ]}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">用户</Typography.Text>
+            <InputNumber
+              placeholder="可空"
+              value={userId ?? undefined}
+              onChange={(v) => setUserId(v ?? null)}
+              style={{ width: 130 }}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">类型</Typography.Text>
+            <Select
+              placeholder="全部"
+              value={adType}
+              onChange={setAdType}
+              allowClear
+              style={{ width: 150 }}
+              options={[
+                { value: 'reward_video', label: '激励视频' },
+                { value: 'feed', label: '信息流' },
+                { value: 'draw', label: 'Draw 信息流' },
+                { value: 'withdrawal_video', label: '提现激励视频' },
+              ]}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">场景</Typography.Text>
+            <Select
+              placeholder="全部"
+              value={scene}
+              onChange={setScene}
+              allowClear
+              style={{ width: 130 }}
+              options={[
+                { value: 'comparison', label: '比价' },
+                { value: 'coupon', label: '领券' },
+                { value: 'welfare', label: '福利' },
+              ]}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">粒度</Typography.Text>
+            <Select
+              value={rangeMultiDay ? 'day' : granularity}
+              onChange={setGranularity}
+              disabled={rangeMultiDay}
+              style={{ width: 110 }}
+              title={rangeMultiDay ? '跨多天仅支持按天' : undefined}
+              options={[
+                { value: 'day', label: '按天' },
+                { value: 'hour', label: '按小时' },
+              ]}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">排序</Typography.Text>
+            <Select
+              value={sortBy}
+              onChange={(v) => {
+                setSortBy(v);
+                load(1, limit, v); // 改排序:回第 1 页并重查
+              }}
+              style={{ width: 130 }}
+              options={[
+                { value: 'time', label: '时间倒序' },
+                { value: 'ecpm', label: 'eCPM 倒序' },
+              ]}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">每页</Typography.Text>
+            <Select
+              value={limit}
+              onChange={(v) => {
+                setLimit(v);
+                load(1, v); // 改每页大小:回到第 1 页并重查
+              }}
+              style={{ width: 120 }}
+              options={[20, 50, 100, 200, 500, 1000].map((n) => ({ value: n, label: `${n} 条/页` }))}
+            />
+          </Space>
+          <Button type="primary" onClick={() => load(1)} loading={loading}>
+            查询
+          </Button>
+        </Space>
+      </Card>
+
+      {data && derived && (
+        <Card size="small" style={{ marginBottom: 16 }}>
+          <Divider orientation="left" plain style={{ marginTop: 0, marginBottom: 16 }}>
+            <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+              核心指标
+            </Typography.Text>
+          </Divider>
+          <Row gutter={[16, 12]}>
+            <Col flex="1 1 0">
+              <Statistic title="预估收益合计(元)" value={data.total_revenue_yuan} precision={4} />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic
+                title={
+                  <Tooltip title="每活跃用户广告预估收入 = 预估收益 ÷ 今日 DAU;DAU 仅今日口径,历史/多天显示 -">
+                    <span>
+                      ARPU(今日)
+                      <InfoCircleOutlined style={{ marginLeft: 4 }} />
+                    </span>
+                  </Tooltip>
+                }
+                value={derived.arpu ?? '-'}
+                precision={4}
+              />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic
+                title={
+                  <Tooltip title="今日活跃用户(复用大盘口径 last_login_at = 今日登录过);仅查询=今日时有值,历史/多天显示 -">
+                    <span>
+                      今日活跃 DAU
+                      <InfoCircleOutlined style={{ marginLeft: 4 }} />
+                    </span>
+                  </Tooltip>
+                }
+                value={data.dau ?? '-'}
+              />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic title="发放金币合计(元)" value={derived.payoutYuan} precision={4} />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic
+                title="预估广告毛利(元)"
+                value={derived.grossProfit}
+                precision={4}
+                prefix={derived.grossProfit >= 0 ? <RiseOutlined /> : <FallOutlined />}
+                valueStyle={{ color: derived.grossProfit >= 0 ? '#3f8600' : '#cf1322' }}
+              />
+              <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+                发奖占收益{' '}
+                {derived.payoutRatioPct == null ? '—' : `${derived.payoutRatioPct.toFixed(0)}%`}
+              </Typography.Text>
+            </Col>
+          </Row>
+          <Divider orientation="left" plain style={{ marginTop: 20, marginBottom: 16 }}>
+            <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+              分广告类型
+            </Typography.Text>
+          </Divider>
+          <Row gutter={[16, 12]}>
+            <Col span={4}>
+              <Statistic title="Draw 信息流收益(元)" value={drawStat?.revenue_yuan ?? 0} precision={4} />
+            </Col>
+            <Col span={4}>
+              <Statistic title="Draw 信息流 eCPM(元/千次)" value={ecpmOf(drawStat)} precision={2} />
+            </Col>
+            <Col span={4}>
+              <Statistic title="Draw 信息流条数" value={drawStat?.impressions ?? 0} />
+            </Col>
+            <Col span={4}>
+              <Statistic title="激励视频收益(元)" value={rvStat?.revenue_yuan ?? 0} precision={4} />
+            </Col>
+            <Col span={4}>
+              <Statistic title="激励视频 eCPM(元/千次)" value={ecpmOf(rvStat)} precision={2} />
+            </Col>
+            <Col span={4}>
+              <Statistic title="激励视频条数" value={rvStat?.impressions ?? 0} />
+            </Col>
+          </Row>
+        </Card>
+      )}
+
+      {data && (
+        <Space direction="vertical" style={{ width: '100%', marginBottom: 12 }}>
+          {data.mismatch_count > 0 ? (
+            <Alert
+              type="error"
+              showIcon
+              message={`共 ${data.total} 条广告事件,其中 ${data.mismatch_count} 条应发≠实发(✗);应发−实发 合计 ${
+                derived && derived.coinGap >= 0 ? '+' : ''
+              }${derived?.coinGap ?? 0} 金币(正=少发/负=多发)——公式可能未生效或发奖有问题。定位到具体记录可用后端逐条审计接口。`}
+            />
+          ) : (
+            <Alert type="success" showIcon message={`共 ${data.total} 条广告事件,应发与实发全部一致。`} />
+          )}
+        </Space>
+      )}
+
+      {data &&
+        (queriedMultiDay
+          ? (data.daily?.length ?? 0) > 0
+          : queriedGranularity === 'hour' && (data.hourly?.length ?? 0) > 0) && (
+        <Card
+          size="small"
+          title={queriedMultiDay ? '按天趋势' : '按小时趋势'}
+          style={{ marginBottom: 16 }}
+          extra={
+            <Space size={16}>
+              <span style={{ fontSize: 12, color: '#666' }}>
+                <span
+                  style={{
+                    display: 'inline-block',
+                    width: 10,
+                    height: 10,
+                    background: CHART_BAR,
+                    borderRadius: 2,
+                    marginRight: 4,
+                  }}
+                />
+                展示条数
+              </span>
+              <span style={{ fontSize: 12, color: '#666' }}>
+                <span
+                  style={{
+                    display: 'inline-block',
+                    width: 14,
+                    borderTop: `2px solid ${CHART_LINE}`,
+                    marginRight: 4,
+                    verticalAlign: 'middle',
+                  }}
+                />
+                预估收益(元)
+              </span>
+            </Space>
+          }
+        >
+          {/* 趋势图恒为全量(不受分页影响):按天图用 daily,按小时图用 hourly;「场景」已下推后端,趋势随场景筛选一并变化。 */}
+          {queriedMultiDay ? (
+            <TrendChart points={aggregateDaily(data.date_from, data.date_to, data.daily)} />
+          ) : (
+            <TrendChart points={aggregateHourly(data.hourly)} />
+          )}
+        </Card>
+      )}
+
+      <Table
+        rowKey="event_key"
+        columns={columns}
+        dataSource={items}
+        loading={loading}
+        pagination={{
+          current: page,
+          pageSize: queriedLimit,
+          total: data?.total ?? 0,
+          showSizeChanger: false,
+          showTotal: (t) => `共 ${t} 条`,
+          onChange: (p) => load(p, queriedLimit),
+        }}
+        size="small"
+        scroll={{ x: 1380 }}
+        rowClassName={(r) => (r.has_reward && !r.matched ? 'row-mismatch' : '')}
+        expandable={{
+          // 每行都可展开(左侧恒有 + 号):有发奖看「金币复算因子」;纯展示看「展示明细」。
+          rowExpandable: () => true,
+          expandedRowRender: (r) =>
+            r.reward_detail ? (
+              <div>
+                <Typography.Text strong>金币复算明细</Typography.Text>{' '}
+                <Typography.Text type="secondary">
+                  (本条广告 应发 {r.reward_detail.expected_coin} / 实发 {r.reward_detail.actual_coin})
+                </Typography.Text>
+                <Table<AdRevenueRecord>
+                  style={{ marginTop: 8 }}
+                  rowKey="record_id"
+                  columns={DETAIL_COLUMNS}
+                  dataSource={[r.reward_detail]}
+                  pagination={false}
+                  size="small"
+                  scroll={{ x: 900 }}
+                  rowClassName={(d) => (d.matched ? '' : 'row-mismatch')}
+                />
+              </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>
+              </div>
+            ),
+        }}
+      />
+      <Modal
+        title="金币计算规则"
+        open={formulaOpen}
+        onCancel={() => setFormulaOpen(false)}
+        footer={null}
+        width={680}
+      >
+        <Typography.Paragraph>
+          <b>单次奖励(元)</b> ＝（单次 eCPM<sub>元</sub> ÷ 1000)× <b>因子1</b>(eCPM 档)× <b>因子2</b>(LT 累计条数)
+        </Typography.Paragraph>
+        <Typography.Paragraph type="secondary" style={{ fontSize: 13 }}>
+          · eCPM 取自穿山甲 SDK <Typography.Text code>getEcpm()</Typography.Text> 原值,单位「分/千次展示」,计算时 ÷100 转元;单次收益按「每千次 ÷1000」折到每次。
+          <br />· 金币汇率:<b>1 元 ＝ {COIN_PER_YUAN.toLocaleString()} 金币</b>,最终四舍五入取整。
+          <br />· 因子2「LT 累计条数」按该账号累计第几条计(不按天重置);<b>一条广告 = 1 条</b>(激励视频每次 1 条;信息流看满 10 秒即发该条满额,不按时长折多份)。
+          <br />· 本表与发奖后端同源,本页「应发金币」即按此复算并与「实发金币」对账。
+        </Typography.Paragraph>
+        <Row gutter={16}>
+          <Col span={12}>
+            <Typography.Text strong>因子1 ·按 eCPM(元/千次)判档</Typography.Text>
+            <Table
+              style={{ marginTop: 8 }}
+              size="small"
+              pagination={false}
+              dataSource={ECPM_FACTOR_ROWS}
+              columns={[
+                { title: 'eCPM 范围(元)', dataIndex: 'range' },
+                { title: '因子1', dataIndex: 'factor', width: 80 },
+              ]}
+            />
+          </Col>
+          <Col span={12}>
+            <Typography.Text strong>因子2 ·按账号 LT 累计条数</Typography.Text>
+            <Table
+              style={{ marginTop: 8 }}
+              size="small"
+              pagination={false}
+              dataSource={LT_FACTOR_ROWS}
+              columns={[
+                { title: 'LT 累计条数', dataIndex: 'lt' },
+                { title: '因子2', dataIndex: 'factor', width: 80 },
+              ]}
+            />
+          </Col>
+        </Row>
+        <Typography.Paragraph type="secondary" style={{ fontSize: 13, marginTop: 12, marginBottom: 0 }}>
+          示例:eCPM ＝ 300 元/千次、账号第 1 条 → 0.3 × 0.4 × 2.0 ＝ 0.24 元 ＝ 2,400 金币。
+        </Typography.Paragraph>
+      </Modal>
+
+      <style jsx global>{`
+        .row-mismatch > td {
+          background: #fff1f0 !important;
+        }
+      `}</style>
+    </div>
+  );
+}

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

@@ -0,0 +1,102 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
+import { Alert, App, Button, Card, Form, Input, Switch } from 'antd';
+import { api, errMsg } from '@/lib/api';
+
+// 广告配置面板:穿山甲 app_id / 各场景广告位ID / 验签密钥 / 各场景开关。
+// 客户端(发版后)从 /api/v1/platform/ad-config 拉取;此处经 admin /ad-config 读写。
+// 收益报表在独立的「广告收益」页(/ad-revenue-report)。
+interface AdCfg {
+  app_id: string;
+  reward_code_id: string;
+  compare_draw_code_id: string;
+  coupon_draw_code_id: string;
+  reward_mkey: string;
+  reward_enabled: boolean;
+  compare_ad_enabled: boolean;
+  coupon_ad_enabled: boolean;
+  withdrawal_ad_enabled: boolean;
+}
+
+export default function AdConfigPage() {
+  const { message } = App.useApp();
+  const [form] = Form.useForm();
+  const [saving, setSaving] = useState(false);
+  const load = useCallback(async () => {
+    try {
+      const r = await api.get<AdCfg>('/admin/api/ad-config');
+      form.setFieldsValue(r.data);
+    } catch (e) {
+      message.error(errMsg(e, '广告配置加载失败'));
+    }
+  }, [form, message]);
+  useEffect(() => {
+    load();
+  }, [load]);
+  const save = async () => {
+    const v = await form.validateFields();
+    setSaving(true);
+    try {
+      await api.patch('/admin/api/ad-config', v);
+      message.success('已保存。客户端下次拉取生效(应用ID需冷启,广告位ID即时)');
+      load();
+    } catch (e) {
+      message.error(errMsg(e, '保存失败'));
+    } finally {
+      setSaving(false);
+    }
+  };
+  return (
+    <Card
+      title="广告配置(穿山甲)"
+      extra={
+        <Button type="primary" loading={saving} onClick={save}>
+          保存
+        </Button>
+      }
+    >
+      <Alert
+        type="info"
+        style={{ marginBottom: 16 }}
+        message="应用ID改了客户端需冷启生效,广告位ID即时;换激励位必须同步换验签密钥(m-key),否则发不出金币。这些配置需客户端发版接入后才会读取。"
+      />
+      <Form form={form} layout="vertical">
+        <Form.Item name="app_id" label="穿山甲应用ID (APP_ID)" rules={[{ required: true }]}>
+          <Input placeholder="如 5830519" />
+        </Form.Item>
+        <Form.Item name="reward_code_id" label="福利页 · 激励视频 广告位ID" rules={[{ required: true }]}>
+          <Input placeholder="如 104099389" />
+        </Form.Item>
+        <Form.Item
+          name="reward_mkey"
+          label="福利激励 · 验签密钥 m-key(机密,不下发客户端;换激励位必须同步换;留空回退 .env)"
+        >
+          <Input.Password placeholder="GroMore S2S 回调验签密钥" autoComplete="off" />
+        </Form.Item>
+        <Form.Item name="compare_draw_code_id" label="比价Draw信息流代码位" rules={[{ required: true }]}>
+          <Input placeholder="比价Draw信息流代码位,如 104098712" />
+        </Form.Item>
+        <Form.Item name="coupon_draw_code_id" label="领券Draw信息流代码位" rules={[{ required: true }]}>
+          <Input placeholder="领券Draw信息流代码位,如 104098712" />
+        </Form.Item>
+        <Form.Item name="reward_enabled" label="福利激励视频开关" valuePropName="checked">
+          <Switch />
+        </Form.Item>
+        <Form.Item name="compare_ad_enabled" label="比价广告开关" valuePropName="checked">
+          <Switch />
+        </Form.Item>
+        <Form.Item name="coupon_ad_enabled" label="领券广告开关" valuePropName="checked">
+          <Switch />
+        </Form.Item>
+        <Form.Item
+          name="withdrawal_ad_enabled"
+          label="提现激励视频开关(关 = 客户端直接放行提现,不看视频)"
+          valuePropName="checked"
+        >
+          <Switch />
+        </Form.Item>
+      </Form>
+    </Card>
+  );
+}

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

@@ -2,8 +2,9 @@
 
 import { useEffect, useState } from 'react';
 import type { ColumnsType } from 'antd/es/table';
-import { Button, Form, Input, Modal, Select, Table, Tag, message } from 'antd';
+import { App, Button, Form, Input, Modal, Select, Table, Tag } from 'antd';
 import { api, errMsg } from '@/lib/api';
+import { formatUtcTime } from '@/lib/format';
 import type { AdminInfo } from '@/lib/types';
 
 const ROLES = [
@@ -11,9 +12,11 @@ const ROLES = [
   { value: 'finance', label: 'finance' },
   { value: 'operator', label: 'operator' },
 ];
-const dt = (v: string | null) => (v ? new Date(v).toLocaleString('zh-CN') : '从未');
+// last_login_at 为 UTC 口径(datetime.now(utc)),按北京显示(勿用 new Date().toLocaleString)
+const dt = (v: string | null) => (v ? formatUtcTime(v, 'YYYY-MM-DD HH:mm:ss') : '从未');
 
 export default function AdminsPage() {
+  const { message, modal } = App.useApp();
   const [admins, setAdmins] = useState<AdminInfo[]>([]);
   const [loading, setLoading] = useState(false);
   const [createOpen, setCreateOpen] = useState(false);
@@ -47,7 +50,7 @@ export default function AdminsPage() {
 
   const changeRole = (a: AdminInfo, role: string) => {
     if (role === a.role) return;
-    Modal.confirm({
+    modal.confirm({
       title: `把 ${a.username} 的角色改为 ${role}?`,
       onOk: async () => {
         try {
@@ -63,7 +66,7 @@ export default function AdminsPage() {
 
   const toggle = (a: AdminInfo) => {
     const next = a.status === 'active' ? 'disabled' : 'active';
-    Modal.confirm({
+    modal.confirm({
       title: `${next === 'disabled' ? '禁用' : '启用'}管理员 ${a.username}?`,
       onOk: async () => {
         try {

src/app/(main)/audit-logs/page.tsx

@@ -3,19 +3,18 @@
 import { useState } from 'react';
 import type { ColumnsType } from 'antd/es/table';
 import { Button, Input, Space, Table, Tag } from 'antd';
-import { useCursorList } from '@/lib/useCursorList';
+import { formatUtcTime } from '@/lib/format';
+import { usePagedList } from '@/lib/usePagedList';
 import type { AuditLog } from '@/lib/types';
 
-const dt = (v: string) => new Date(v).toLocaleString('zh-CN');
+// 审计 created_at 为 UTC 口径(server_default now()),按北京显示(勿用 new Date().toLocaleString)
+const dt = (v: string) => formatUtcTime(v, 'YYYY-MM-DD HH:mm:ss');
 
 export default function AuditLogsPage() {
   const [action, setAction] = useState('');
   const [filters, setFilters] = useState<Record<string, unknown>>({});
-  const { items, nextCursor, loading, loadMore } = useCursorList<AuditLog>(
-    '/admin/api/audit-logs',
-    filters,
-    50,
-  );
+  const { items, total, page, pageSize, loading, onChange: onPageChange } =
+    usePagedList<AuditLog>('/admin/api/audit-logs', filters, 50);
 
   const search = () => setFilters({ action: action || undefined });
 
@@ -59,14 +58,16 @@ export default function AuditLogsPage() {
         columns={columns}
         dataSource={items}
         loading={loading}
-        pagination={false}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 条`,
+          onChange: onPageChange,
+        }}
         scroll={{ x: 1000 }}
       />
-      <div style={{ marginTop: 16, textAlign: 'center' }}>
-        <Button onClick={loadMore} disabled={!nextCursor} loading={loading}>
-          {nextCursor ? '加载更多' : '没有更多了'}
-        </Button>
-      </div>
     </div>
   );
 }

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

@@ -0,0 +1,388 @@
+'use client';
+
+import { useState } from 'react';
+import type { CSSProperties } from 'react';
+import {
+  App, Button, Card, Collapse, Descriptions, Drawer, Input, InputNumber,
+  Select, Space, Spin, Table, Tag, Typography,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import { api, errMsg } from '@/lib/api';
+import { formatWallTime, yuan } from '@/lib/format';
+import { usePagedList } from '@/lib/usePagedList';
+import type { ComparisonRecordDetail, ComparisonRecordListItem } from '@/lib/types';
+
+const STATUS_COLOR: Record<string, string> = { success: 'green', failed: 'red', cancelled: 'default' };
+const STATUS_LABEL: Record<string, string> = { success: '成功', failed: '失败', cancelled: '已终止' };
+
+// 「卡在哪一步」: platform_results[*].status 翻成人话(找店/加菜/起送/读价)
+const STUCK_LABEL: Record<string, string> = {
+  success: '成功',
+  store_not_found: '没找到店',
+  items_not_found: '菜没匹配上',
+  below_minimum: '未达起送',
+  unsupported: '平台不支持',
+  failed: '失败',
+};
+
+const fmtMs = (ms: number | null) => (ms == null ? '-' : `${(ms / 1000).toFixed(1)}s`);
+const cents = (c: number | null) => (c == null ? '-' : yuan(c));
+
+// LLM 成本估算:(input + output) token / 1e6 × 每百万 token 单价(元)。单价由页面输入框配置(localStorage)。
+const calcCost = (inTok: number | null, outTok: number | null, price: number | null): number | null => {
+  if (price == null || Number.isNaN(price)) return null;
+  if (inTok == null && outTok == null) return null;
+  return (((inTok ?? 0) + (outTok ?? 0)) / 1_000_000) * price;
+};
+const fmtCost = (c: number | null) => (c == null ? '-' : `¥${c.toFixed(4)}`);
+const fmtTok = (inTok: number | null, outTok: number | null) =>
+  inTok == null && outTok == null ? '-' : `${inTok ?? 0}/${outTok ?? 0}`;
+
+// LLM message content 常是 json.dumps 的卡片列表;能 parse 成 JSON 就缩进展开,否则原样。
+function pretty(s: string | null): string {
+  if (!s) return '';
+  try {
+    return JSON.stringify(JSON.parse(s), null, 2);
+  } catch {
+    return s;
+  }
+}
+
+const preStyle: CSSProperties = {
+  background: '#f6f8fa', padding: 8, borderRadius: 6, fontSize: 12,
+  maxHeight: 340, overflow: 'auto', whiteSpace: 'pre-wrap', wordBreak: 'break-word', margin: 0,
+};
+
+export default function ComparisonRecordsPage() {
+  const { message } = App.useApp();
+
+  const [userId, setUserId] = useState<number | null>(null);
+  const [phone, setPhone] = useState('');
+  const [status, setStatus] = useState<string | undefined>();
+  const [applied, setApplied] = useState<Record<string, unknown>>({});
+  // LLM 单价(元/百万 token),本地持久化;仅用于前端估算成本,不入库、不影响其它页面
+  const [pricePerMTok, setPricePerMTok] = useState<number | null>(() => {
+    if (typeof window === 'undefined') return null;
+    const v = localStorage.getItem('llm_price_per_mtok');
+    return v != null && v !== '' ? Number(v) : null;
+  });
+  const onPriceChange = (v: number | null) => {
+    setPricePerMTok(v);
+    if (typeof window === 'undefined') return;
+    if (v == null) localStorage.removeItem('llm_price_per_mtok');
+    else localStorage.setItem('llm_price_per_mtok', String(v));
+  };
+
+  const { items, total, page, pageSize, loading, onChange } =
+    usePagedList<ComparisonRecordListItem>('/admin/api/comparison-records', applied);
+
+  const [detail, setDetail] = useState<ComparisonRecordDetail | null>(null);
+  const [detailLoading, setDetailLoading] = useState(false);
+
+  const search = () =>
+    setApplied({ user_id: userId ?? undefined, phone: phone || undefined, status });
+
+  const reset = () => {
+    setUserId(null);
+    setPhone('');
+    setStatus(undefined);
+    setApplied({});
+  };
+
+  const openDetail = async (id: number) => {
+    setDetailLoading(true);
+    setDetail(null);
+    try {
+      const { data } = await api.get<ComparisonRecordDetail>(`/admin/api/comparison-records/${id}`);
+      setDetail(data);
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setDetailLoading(false);
+    }
+  };
+
+  const closeDetail = () => {
+    setDetail(null);
+    setDetailLoading(false);
+  };
+
+  const columns: ColumnsType<ComparisonRecordListItem> = [
+    { title: 'ID', dataIndex: 'id', width: 64 },
+    {
+      title: '用户',
+      key: 'user',
+      width: 140,
+      render: (_, r) => (
+        <div>
+          <div>{r.phone || `#${r.user_id}`}</div>
+          {r.nickname && <div style={{ color: '#999', fontSize: 12 }}>{r.nickname}</div>}
+        </div>
+      ),
+    },
+    { title: '状态', dataIndex: 'status', width: 72, render: (s: string) => <Tag color={STATUS_COLOR[s]}>{STATUS_LABEL[s] || s}</Tag> },
+    { title: '源平台', dataIndex: 'source_platform_name', width: 90, render: (v) => v || '-' },
+    { title: '店/商品', dataIndex: 'store_name', width: 150, ellipsis: true, render: (v) => v || '-' },
+    { title: '最优', dataIndex: 'best_platform_name', width: 80, render: (v) => v || '-' },
+    {
+      title: '省',
+      key: 'saved',
+      width: 84,
+      render: (_, r) =>
+        r.saved_amount_cents == null ? '-' : (
+          <b style={{ color: r.saved_amount_cents > 0 ? '#3f8600' : '#999' }}>{yuan(r.saved_amount_cents)}</b>
+        ),
+    },
+    { title: '耗时', dataIndex: 'total_ms', width: 64, render: fmtMs },
+    { title: '步', dataIndex: 'step_count', width: 48, render: (v) => v ?? '-' },
+    { title: 'LLM', dataIndex: 'llm_call_count', width: 56, render: (v) => v ?? '-' },
+    {
+      title: '重试',
+      dataIndex: 'retry_count',
+      width: 50,
+      render: (v: number | null) => (v ? <span style={{ color: '#cf1322' }}>{v}</span> : v ?? '-'),
+    },
+    {
+      title: 'Token(入/出)',
+      key: 'tokens',
+      width: 110,
+      render: (_, r) => fmtTok(r.input_tokens, r.output_tokens),
+    },
+    {
+      title: '成本',
+      key: 'cost',
+      width: 90,
+      render: (_, r) => fmtCost(calcCost(r.input_tokens, r.output_tokens, pricePerMTok)),
+    },
+    {
+      title: '机型/ROM',
+      key: 'device',
+      width: 150,
+      ellipsis: true,
+      render: (_, r) => [r.device_model, r.rom_name].filter(Boolean).join(' / ') || '-',
+    },
+    { title: '时间', dataIndex: 'created_at', width: 150, render: (v: string) => formatWallTime(v) },
+    {
+      title: '操作',
+      key: 'op',
+      fixed: 'right',
+      width: 80,
+      render: (_, r) =>
+        r.trace_url ? (
+          <a href={r.trace_url} target="_blank" rel="noreferrer" onClick={(e) => e.stopPropagation()}>trace</a>
+        ) : (
+          <span style={{ color: '#ccc' }}>-</span>
+        ),
+    },
+  ];
+
+  const platformResults =
+    (detail?.raw_payload?.platform_results as Record<string, unknown>[] | undefined) || [];
+
+  return (
+    <div>
+      <h2>比价记录(debug)</h2>
+      <Space style={{ marginBottom: 16 }} wrap>
+        <InputNumber placeholder="user_id" value={userId} onChange={setUserId} style={{ width: 110 }} />
+        <Input
+          placeholder="手机号前缀"
+          value={phone}
+          onChange={(e) => setPhone(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 150 }}
+        />
+        <Select
+          placeholder="状态"
+          value={status}
+          onChange={setStatus}
+          allowClear
+          style={{ width: 110 }}
+          options={[
+            { value: 'success', label: '成功' },
+            { value: 'failed', label: '失败' },
+            { value: 'cancelled', label: '已终止' },
+          ]}
+        />
+        <Button type="primary" onClick={search}>查询</Button>
+        <Button onClick={reset}>重置</Button>
+        <InputNumber
+          placeholder="LLM 单价"
+          value={pricePerMTok}
+          onChange={onPriceChange}
+          min={0}
+          step={0.1}
+          style={{ width: 210 }}
+          addonAfter="元/百万token"
+        />
+      </Space>
+
+      <Table
+        rowKey="id"
+        columns={columns}
+        dataSource={items}
+        loading={loading}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 条`,
+          onChange,
+        }}
+        scroll={{ x: 1520 }}
+        onRow={(r) => ({ onClick: () => openDetail(r.id), style: { cursor: 'pointer' } })}
+      />
+
+      <Drawer title={detail ? `比价记录 #${detail.id}` : '详情'} width={780} open={detailLoading || !!detail} onClose={closeDetail}>
+        {detailLoading && <Spin />}
+        {detail && (
+          <Space direction="vertical" size="middle" style={{ width: '100%' }}>
+            <Descriptions size="small" column={2} bordered>
+              <Descriptions.Item label="用户">
+                {detail.phone || `#${detail.user_id}`}{detail.nickname ? `(${detail.nickname})` : ''}
+              </Descriptions.Item>
+              <Descriptions.Item label="状态"><Tag color={STATUS_COLOR[detail.status]}>{STATUS_LABEL[detail.status] || detail.status}</Tag></Descriptions.Item>
+              <Descriptions.Item label="业务">{detail.business_type}</Descriptions.Item>
+              <Descriptions.Item label="耗时">{fmtMs(detail.total_ms)}</Descriptions.Item>
+              <Descriptions.Item label="步数">{detail.step_count ?? '-'}</Descriptions.Item>
+              <Descriptions.Item label="LLM 次数/重试">{detail.llm_call_count ?? '-'} / {detail.retry_count ?? '-'}</Descriptions.Item>
+              <Descriptions.Item label="Token(入/出/合计)">
+                {detail.input_tokens == null && detail.output_tokens == null
+                  ? '-'
+                  : `${detail.input_tokens ?? 0} / ${detail.output_tokens ?? 0} / ${(detail.input_tokens ?? 0) + (detail.output_tokens ?? 0)}`}
+              </Descriptions.Item>
+              <Descriptions.Item label="估算成本">
+                {fmtCost(calcCost(detail.input_tokens, detail.output_tokens, pricePerMTok))}
+                {pricePerMTok == null && (detail.input_tokens != null || detail.output_tokens != null)
+                  ? <span style={{ color: '#999', fontSize: 12 }}>（顶部填 LLM 单价后显示）</span>
+                  : null}
+              </Descriptions.Item>
+              <Descriptions.Item label="源平台">{detail.source_platform_name || '-'}（{cents(detail.source_price_cents)}）</Descriptions.Item>
+              <Descriptions.Item label="最优">{detail.best_platform_name || '-'}（{cents(detail.best_price_cents)}）</Descriptions.Item>
+              <Descriptions.Item label="省" span={2}>{cents(detail.saved_amount_cents)}{detail.is_source_best ? '（源平台最便宜）' : ''}</Descriptions.Item>
+              <Descriptions.Item label="店/商品" span={2}>{detail.store_name || '-'}</Descriptions.Item>
+              <Descriptions.Item label="结论文案" span={2}>{detail.information || '-'}</Descriptions.Item>
+              <Descriptions.Item label="trace" span={2}>
+                {detail.trace_url
+                  ? <a href={detail.trace_url} target="_blank" rel="noreferrer">{detail.trace_url}</a>
+                  : <span style={{ color: '#999' }}>{detail.trace_id}（无 trace_url）</span>}
+              </Descriptions.Item>
+              <Descriptions.Item label="定位" span={2}>
+                {detail.longitude != null ? `${detail.longitude}, ${detail.latitude}` : '-'}
+              </Descriptions.Item>
+              <Descriptions.Item label="最优深链" span={2}>
+                {detail.best_deeplink
+                  ? <Typography.Text copyable={{ text: detail.best_deeplink }} style={{ fontSize: 12, wordBreak: 'break-all' }}>{detail.best_deeplink}</Typography.Text>
+                  : '-'}
+              </Descriptions.Item>
+            </Descriptions>
+
+            <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="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>
+                <Descriptions.Item label="device_id" span={2}>{detail.device_id || '-'}</Descriptions.Item>
+              </Descriptions>
+            </Card>
+
+            {((detail.items?.length ?? 0) > 0 || (detail.skipped_dish_names?.length ?? 0) > 0) && (
+              <Card size="small" title={`下单商品${detail.total_dish_count != null ? `（共 ${detail.total_dish_count}）` : ''}`}>
+                {(detail.items?.length ?? 0) > 0 ? (
+                  <ul style={{ margin: 0, paddingLeft: 18 }}>
+                    {detail.items.map((it, i) => (
+                      <li key={i}>
+                        {it.name}{it.qty != null ? ` ×${it.qty}` : ''}
+                        {it.specs?.length ? <span style={{ color: '#999' }}>（{it.specs.join('/')}）</span> : null}
+                      </li>
+                    ))}
+                  </ul>
+                ) : <Typography.Text type="secondary">无商品明细</Typography.Text>}
+                {(detail.skipped_dish_names?.length ?? 0) > 0 && (
+                  <div style={{ marginTop: 8, color: '#cf1322' }}>
+                    跳过{detail.skipped_dish_count != null ? ` ${detail.skipped_dish_count} ` : ''}个：{detail.skipped_dish_names.join('、')}
+                  </div>
+                )}
+              </Card>
+            )}
+
+            {platformResults.length > 0 && (
+              <Card size="small" title="逐平台结局（卡在哪一步）">
+                <Table
+                  size="small"
+                  rowKey={(_, i) => String(i)}
+                  pagination={false}
+                  dataSource={platformResults}
+                  columns={[
+                    { title: '平台', dataIndex: 'platform_name', render: (v, r: Record<string, unknown>) => (v as string) || (r.platform_id as string) || '-' },
+                    { title: '结局', dataIndex: 'status', render: (s: string) => <Tag color={s === 'success' ? 'green' : 'orange'}>{STUCK_LABEL[s] || s || '-'}</Tag> },
+                    { title: '说明', dataIndex: 'reason', render: (v) => (v as string) || '-' },
+                  ]}
+                />
+              </Card>
+            )}
+
+            {(detail.comparison_results?.length ?? 0) > 0 && (
+              <Collapse
+                size="small"
+                items={[{
+                  key: 'cmp',
+                  label: `逐平台对比（${detail.comparison_results.length}）`,
+                  children: <pre style={preStyle}>{JSON.stringify(detail.comparison_results, null, 2)}</pre>,
+                }]}
+              />
+            )}
+
+            <Card size="small" title={`LLM 调用明细（${detail.llm_calls?.length ?? 0} 次）`}>
+              {detail.llm_calls && detail.llm_calls.length > 0 ? (
+                <Collapse
+                  size="small"
+                  items={detail.llm_calls.map((c, i) => ({
+                    key: String(i),
+                    label: (
+                      <Space size={6} wrap>
+                        <Tag color="blue">{c.scene || 'llm'}</Tag>
+                        <span style={{ color: '#999', fontSize: 12 }}>{c.model}</span>
+                        <span style={{ color: '#999', fontSize: 12 }}>{c.latency_ms ?? '-'}ms</span>
+                        {c.usage?.total_tokens ? <span style={{ color: '#999', fontSize: 12 }}>{c.usage.total_tokens} tok</span> : null}
+                        {c.error ? <Tag color="red">error</Tag> : null}
+                      </Space>
+                    ),
+                    children: (
+                      <div>
+                        {c.input_messages.map((m, j) => (
+                          <div key={j} style={{ marginBottom: 8 }}>
+                            <Tag>{m.role}</Tag>
+                            <pre style={preStyle}>{pretty(m.content)}</pre>
+                          </div>
+                        ))}
+                        <div style={{ marginTop: 8 }}>
+                          <Tag color="green">output</Tag>
+                          <pre style={preStyle}>{c.error ? `【error】${c.error}` : pretty(c.output)}</pre>
+                        </div>
+                      </div>
+                    ),
+                  }))}
+                />
+              ) : (
+                <Typography.Text type="secondary">无 LLM 调用明细（旧记录 / pricebot 未采集到 / 本次未调 LLM）</Typography.Text>
+              )}
+            </Card>
+
+            <Collapse
+              size="small"
+              items={[{
+                key: 'raw',
+                label: '原始上报 raw_payload',
+                children: <pre style={preStyle}>{JSON.stringify(detail.raw_payload, null, 2)}</pre>,
+              }]}
+            />
+          </Space>
+        )}
+      </Drawer>
+    </div>
+  );
+}

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

@@ -1,14 +1,14 @@
 'use client';
 
 import { useEffect, useState } from 'react';
-import { Button, Card, Input, InputNumber, Space, Spin, Tag, Tooltip, message } from 'antd';
+import { App, Button, Card, Input, InputNumber, Space, Spin, Switch, Tag, Tooltip } from 'antd';
 import { api, errMsg } from '@/lib/api';
 
 interface ConfigItem {
   key: string;
   label: string;
   group: string;
-  type: string; // int / int_list / dict_str_int
+  type: string; // int / int_list / dict_str_int / bool
   help: string | null;
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
   default: any;
@@ -28,6 +28,7 @@ function toEdit(item: ConfigItem): any {
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 function fromEdit(type: string, raw: any): any {
   if (type === 'int') return Number(raw);
+  if (type === 'bool') return Boolean(raw);
   if (type === 'int_list') {
     return String(raw)
       .split(',')
@@ -38,6 +39,7 @@ function fromEdit(type: string, raw: any): any {
 }
 
 export default function ConfigPage() {
+  const { message } = App.useApp();
   const [items, setItems] = useState<ConfigItem[]>([]);
   const [loading, setLoading] = useState(true);
   // eslint-disable-next-line @typescript-eslint/no-explicit-any
@@ -109,7 +111,12 @@ export default function ConfigPage() {
                   )}
                 </div>
                 <Space wrap>
-                  {item.type === 'int' ? (
+                  {item.type === 'bool' ? (
+                    <Switch
+                      checked={!!edits[item.key]}
+                      onChange={(v) => setEdits({ ...edits, [item.key]: v })}
+                    />
+                  ) : item.type === 'int' ? (
                     <InputNumber
                       value={edits[item.key]}
                       onChange={(v) => setEdits({ ...edits, [item.key]: v })}

src/app/(main)/cps/groups/[id]/page.tsx

@@ -0,0 +1,455 @@
+'use client';
+
+// CPS 群对账详情:该群点击量/独立点击/复制/独立复制的天级 or 小时级变化折线图。
+// 时间范围: 近 3/7/14/30 天(天级) 或 今日(小时级)。数据由后端补零成连续桶,折线不断裂。
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useParams, useRouter } from 'next/navigation';
+import dynamic from 'next/dynamic';
+import type { ColumnsType } from 'antd/es/table';
+import { Button, Card, Col, Empty, Modal, Row, Segmented, Space, Spin, Statistic, Table, Tooltip, message } from 'antd';
+import { api, errMsg } from '@/lib/api';
+import { formatUtcTime, yuan } from '@/lib/format';
+
+// @ant-design/plots 依赖 DOM,关掉 SSR 仅在客户端渲染(否则 Next 预渲染报 document undefined)。
+const Line = dynamic(() => import('@ant-design/plots').then((m) => m.Line), { ssr: false });
+
+interface TsPoint {
+  label: string;
+  click_pv: number;
+  click_uv: number;
+  copy_pv: number;
+  copy_uv: number;
+}
+interface TsResp {
+  group_id: number;
+  group_name: string;
+  granularity: string;
+  points: TsPoint[];
+}
+
+// 按天大表格一行(订单侧字段对淘宝/京东群为 null → 显示 "-")
+interface DailyRow {
+  date: string;
+  click_pv: number;
+  click_uv: number;
+  copy_pv: number;
+  order_count: number | null;
+  canceled_count: number | null;
+  gmv_cents: number | null;
+  est_commission_cents: number | null;
+  refund_profit_cents: number | null;
+  settled_commission_cents: number | null;
+}
+interface DailyResp {
+  group_name: string;
+  is_meituan: boolean;
+  days: number;
+  rows: DailyRow[];
+}
+
+// 群内微信用户(落地页授权拿到;nickname/headimgurl 仅 userinfo 授权后有)
+interface WxUser {
+  openid: string;
+  nickname: string | null;
+  headimgurl: string | null;
+  first_seen: string;
+  visit_count: number;
+  copy_count: number;
+}
+
+// 某天该群按用户领券下钻(/day-users)
+interface DayCoupon {
+  name: string;
+  count: number;
+}
+interface DayUser {
+  openid: string;
+  nickname: string | null;
+  headimgurl: string | null;
+  copy_count: number;
+  visit_count: number;
+  coupons: DayCoupon[];
+}
+
+const RANGES = [
+  { label: '近 3 天', value: 'd3' },
+  { label: '近 7 天', value: 'd7' },
+  { label: '近 14 天', value: 'd14' },
+  { label: '近 30 天', value: 'd30' },
+  { label: '今日(按小时)', value: 'h' },
+];
+
+const METRICS: { key: keyof Omit<TsPoint, 'label'>; name: string }[] = [
+  { key: 'click_pv', name: '点击量' },
+  { key: 'click_uv', name: '独立点击' },
+  { key: 'copy_pv', name: '复制次数' },
+  { key: 'copy_uv', name: '独立复制' },
+];
+
+function rangeToQuery(r: string): string {
+  if (r === 'h') return 'granularity=hour';
+  const days: Record<string, number> = { d3: 3, d7: 7, d14: 14, d30: 30 };
+  return `granularity=day&days=${days[r] ?? 7}`;
+}
+
+// 大表格只按天:天级范围 → 天数;今日小时(h) → null(此时隐藏表格,小时维度看上面折线)
+function rangeToDays(r: string): number | null {
+  return ({ d3: 3, d7: 7, d14: 14, d30: 30 } as Record<string, number>)[r] ?? null;
+}
+
+export default function GroupDetailPage() {
+  const params = useParams();
+  const router = useRouter();
+  const id = params.id as string;
+  const [range, setRange] = useState('d7');
+  const [data, setData] = useState<TsResp | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  const load = useCallback(async () => {
+    setLoading(true);
+    try {
+      const r = await api.get<TsResp>(
+        `/admin/api/cps/groups/${id}/timeseries?${rangeToQuery(range)}`,
+      );
+      setData(r.data);
+    } catch (e) {
+      message.error(errMsg(e, '加载失败'));
+    } finally {
+      setLoading(false);
+    }
+  }, [id, range]);
+
+  useEffect(() => {
+    load();
+  }, [load]);
+
+  // 按天大表格(独立于折线;今日小时模式 tableDays=null 时不取、不显示)
+  const [daily, setDaily] = useState<DailyResp | null>(null);
+  const tableDays = rangeToDays(range);
+  const loadDaily = useCallback(async () => {
+    if (tableDays == null) return;
+    try {
+      const r = await api.get<DailyResp>(`/admin/api/cps/groups/${id}/daily?days=${tableDays}`);
+      setDaily(r.data);
+    } catch (e) {
+      message.error(errMsg(e, '明细加载失败'));
+    }
+  }, [id, tableDays]);
+  useEffect(() => {
+    loadDaily();
+  }, [loadDaily]);
+
+  // 群内微信用户(独立于时间范围,累计画像)
+  const [wxUsers, setWxUsers] = useState<WxUser[]>([]);
+  const loadWxUsers = useCallback(async () => {
+    try {
+      const r = await api.get<{ users: WxUser[] }>(`/admin/api/cps/groups/${id}/wx-users`);
+      setWxUsers(r.data.users || []);
+    } catch (e) {
+      message.error(errMsg(e, '用户列表加载失败'));
+    }
+  }, [id]);
+  useEffect(() => {
+    loadWxUsers();
+  }, [loadWxUsers]);
+
+  // 某天领券下钻弹窗
+  const [dayDetail, setDayDetail] = useState<{
+    open: boolean;
+    date: string;
+    loading: boolean;
+    users: DayUser[];
+  }>({ open: false, date: '', loading: false, users: [] });
+
+  const openDayDetail = useCallback(
+    async (date: string) => {
+      setDayDetail({ open: true, date, loading: true, users: [] });
+      try {
+        const r = await api.get<{ users: DayUser[] }>(
+          `/admin/api/cps/groups/${id}/day-users?date=${date}`,
+        );
+        setDayDetail((s) => ({ ...s, loading: false, users: r.data.users || [] }));
+      } catch (e) {
+        message.error(errMsg(e, '明细加载失败'));
+        setDayDetail((s) => ({ ...s, loading: false }));
+      }
+    },
+    [id],
+  );
+
+  const points = useMemo(() => data?.points ?? [], [data]);
+  // 展平成「长表」给折线图:每个 (时间桶 × 指标) 一行,colorField 按指标分 4 条线。
+  const chartData = useMemo(
+    () =>
+      points.flatMap((p) =>
+        METRICS.map((m) => ({ label: p.label, 指标: m.name, value: Number(p[m.key]) })),
+      ),
+    [points],
+  );
+  const totals = useMemo(
+    () => METRICS.map((m) => ({ name: m.name, sum: points.reduce((s, p) => s + Number(p[m.key]), 0) })),
+    [points],
+  );
+  const hasData = points.some((p) => p.click_pv || p.click_uv || p.copy_pv || p.copy_uv);
+
+  const config = {
+    data: chartData,
+    xField: 'label',
+    yField: 'value',
+    colorField: '指标',
+    height: 420,
+    legend: { color: { position: 'top' as const } },
+    // 折线带数据点(每桶一个);大小用 style.r 固定 —— sizeField/shapeField 是数据字段映射,
+    // 给常量会被 G2 当字段名找而失效。
+    point: { style: { r: 3 } },
+    // y 轴恒从 0 起、上限自适应取整;CPS 数据量小,固定 0 基线对比更直观。
+    scale: { y: { domainMin: 0, nice: true } },
+    axis: { x: { title: range === 'h' ? '小时' : '日期' }, y: { title: '次数' } },
+    interaction: { tooltip: { shared: true } },
+  };
+
+  const dailyColumns: ColumnsType<DailyRow> = [
+    { title: '日期', dataIndex: 'date', width: 96, fixed: 'left' },
+    { title: '点击', dataIndex: 'click_pv', width: 56 },
+    { title: '独立', dataIndex: 'click_uv', width: 56 },
+    { title: '复制', dataIndex: 'copy_pv', width: 56, render: (v: number) => v || '-' },
+    {
+      title: '点击→下单',
+      key: 'rate',
+      width: 86,
+      render: (_, r) =>
+        r.order_count == null
+          ? '-'
+          : r.click_uv
+            ? `${((r.order_count / r.click_uv) * 100).toFixed(0)}%`
+            : '-',
+    },
+    { title: '有效单', dataIndex: 'order_count', width: 64, render: (v: number | null) => (v == null ? '-' : v) },
+    {
+      title: '取消/风控',
+      dataIndex: 'canceled_count',
+      width: 78,
+      render: (v: number | null) => (v == null ? '-' : v ? <span style={{ color: '#cf1322' }}>{v}</span> : 0),
+    },
+    { title: '成交额', dataIndex: 'gmv_cents', width: 84, render: (v: number | null) => (v == null ? '-' : yuan(v)) },
+    {
+      title: '预估佣金',
+      dataIndex: 'est_commission_cents',
+      width: 84,
+      render: (v: number | null) => (v == null ? '-' : yuan(v)),
+    },
+    {
+      title: '退款佣金',
+      dataIndex: 'refund_profit_cents',
+      width: 84,
+      render: (v: number | null) =>
+        v == null ? '-' : v ? <span style={{ color: '#cf1322' }}>{yuan(v)}</span> : yuan(0),
+    },
+    {
+      title: '净佣金',
+      key: 'net',
+      width: 84,
+      render: (_, r) =>
+        r.est_commission_cents == null ? (
+          '-'
+        ) : (
+          <b>{yuan(r.est_commission_cents - (r.refund_profit_cents || 0))}</b>
+        ),
+    },
+    {
+      title: '结算佣金',
+      dataIndex: 'settled_commission_cents',
+      width: 84,
+      render: (v: number | null) => (v == null ? '-' : <span style={{ color: '#3f8600' }}>{yuan(v)}</span>),
+    },
+    {
+      title: '明细',
+      key: 'drill',
+      width: 64,
+      fixed: 'right',
+      render: (_, r) => (
+        <Button type="link" size="small" style={{ padding: 0 }} onClick={() => openDayDetail(r.date)}>
+          明细
+        </Button>
+      ),
+    },
+  ];
+
+  const wxColumns: ColumnsType<WxUser> = [
+    {
+      title: '用户',
+      key: 'user',
+      render: (_, u) => (
+        <Space>
+          {u.headimgurl ? (
+            <img
+              src={u.headimgurl}
+              alt=""
+              style={{ width: 32, height: 32, borderRadius: '50%', objectFit: 'cover' }}
+            />
+          ) : (
+            <span
+              style={{ width: 32, height: 32, borderRadius: '50%', background: '#f0f0f0', display: 'inline-block' }}
+            />
+          )}
+          <span>{u.nickname || '(未授权昵称)'}</span>
+        </Space>
+      ),
+    },
+    {
+      title: '领券次数',
+      dataIndex: 'copy_count',
+      width: 90,
+      sorter: (a, b) => a.copy_count - b.copy_count,
+      render: (v: number) => (v ? <b style={{ color: '#ff4d4f' }}>{v}</b> : 0),
+    },
+    { title: '点击次数', dataIndex: 'visit_count', width: 90 },
+    { title: '首次进入', dataIndex: 'first_seen', width: 160, render: (v: string) => formatUtcTime(v) },
+  ];
+
+  const dayUserColumns: ColumnsType<DayUser> = [
+    {
+      title: '用户',
+      key: 'user',
+      render: (_, u) => (
+        <Space>
+          {u.headimgurl ? (
+            <img
+              src={u.headimgurl}
+              alt=""
+              style={{ width: 28, height: 28, borderRadius: '50%', objectFit: 'cover' }}
+            />
+          ) : (
+            <span
+              style={{ width: 28, height: 28, borderRadius: '50%', background: '#f0f0f0', display: 'inline-block' }}
+            />
+          )}
+          <span>{u.nickname || '(未授权昵称)'}</span>
+        </Space>
+      ),
+    },
+    {
+      title: '领券次数',
+      dataIndex: 'copy_count',
+      width: 100,
+      sorter: (a, b) => a.copy_count - b.copy_count,
+      render: (v: number) => (v ? <b style={{ color: '#ff4d4f' }}>{v}</b> : 0),
+    },
+    {
+      title: '点击次数',
+      dataIndex: 'visit_count',
+      width: 100,
+      render: (v: number, u) =>
+        u.coupons.length ? (
+          <Tooltip
+            title={
+              <div>
+                {u.coupons.map((c) => (
+                  <div key={c.name}>
+                    {c.name} ×{c.count}
+                  </div>
+                ))}
+              </div>
+            }
+          >
+            <span style={{ cursor: 'help', textDecoration: 'underline dotted' }}>{v}</span>
+          </Tooltip>
+        ) : (
+          v
+        ),
+    },
+  ];
+
+  return (
+    <div>
+      <Space style={{ marginBottom: 16 }} align="center" wrap>
+        <Button onClick={() => router.push('/cps')}>← 返回</Button>
+        <span style={{ fontSize: 18, fontWeight: 600 }}>
+          群「{data?.group_name ?? ''}」点击趋势
+        </span>
+      </Space>
+
+      <Card style={{ marginBottom: 16 }}>
+        <Segmented options={RANGES} value={range} onChange={(v) => setRange(v as string)} />
+      </Card>
+
+      <Row gutter={16} style={{ marginBottom: 16 }}>
+        {totals.map((t) => (
+          <Col key={t.name} xs={12} sm={6}>
+            <Card size="small">
+              <Statistic title={`${t.name}(合计)`} value={t.sum} />
+            </Card>
+          </Col>
+        ))}
+      </Row>
+
+      <Card>
+        <Spin spinning={loading}>
+          {hasData ? (
+            <Line {...config} />
+          ) : (
+            <Empty
+              style={{ padding: '80px 0' }}
+              description={loading ? '加载中…' : '该时间范围内暂无点击数据'}
+            />
+          )}
+        </Spin>
+      </Card>
+
+      {tableDays != null && (
+        <Card title={`每日明细(近 ${tableDays} 天)`} style={{ marginTop: 16 }}>
+          {daily && !daily.is_meituan && (
+            <div style={{ fontSize: 12, color: '#999', marginBottom: 8 }}>
+              该群非美团渠道,订单/佣金类无对账数据,显示「-」
+            </div>
+          )}
+          <Table<DailyRow>
+            rowKey="date"
+            size="small"
+            columns={dailyColumns}
+            dataSource={daily?.rows ?? []}
+            pagination={false}
+            scroll={{ x: 1000 }}
+          />
+        </Card>
+      )}
+
+      <Card title={`群内微信用户(${wxUsers.length})`} style={{ marginTop: 16 }}>
+        <div style={{ fontSize: 12, color: '#999', marginBottom: 8 }}>
+          在微信里打开本群落地页并授权的用户。「领券次数」= 点了几次「复制口令」;昵称/头像需用户点领券时授权补充。
+        </div>
+        <Table<WxUser>
+          rowKey="openid"
+          size="small"
+          columns={wxColumns}
+          dataSource={wxUsers}
+          pagination={false}
+          scroll={{ x: 560 }}
+          locale={{ emptyText: '暂无授权用户' }}
+        />
+      </Card>
+
+      <Modal
+        open={dayDetail.open}
+        title={`群「${data?.group_name ?? ''}」${dayDetail.date} · 用户领券明细`}
+        footer={null}
+        width={640}
+        height={600}
+        onCancel={() => setDayDetail((s) => ({ ...s, open: false }))}
+      >
+        <div style={{ fontSize: 12, color: '#999', marginBottom: 8 }}>
+          仅统计微信授权(openid)用户;美团/京东多为匿名跳转,可能为空。悬停「点击次数」看该用户当天点过的券。
+        </div>
+        <Table<DayUser>
+          rowKey="openid"
+          size="small"
+          loading={dayDetail.loading}
+          columns={dayUserColumns}
+          dataSource={dayDetail.users}
+          pagination={false}
+          locale={{ emptyText: '当天无授权用户领券/点击' }}
+        />
+      </Modal>
+    </div>
+  );
+}

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

@@ -0,0 +1,963 @@
+'use client';
+
+// CPS 优惠券分发与对账。平台:美团(actId+sid,完整对账) / 淘宝(淘口令) / 京东(链接)。
+// 淘宝/京东无 API → 只统计点击,对账字段显示 "-"。单页 Tabs:对账统计/群管理/活动管理/订单明细。
+import { useCallback, useEffect, useState } from 'react';
+import Link from 'next/link';
+import type { ColumnsType } from 'antd/es/table';
+import {
+  Button,
+  Card,
+  Checkbox,
+  Form,
+  Input,
+  InputNumber,
+  Modal,
+  Popconfirm,
+  Select,
+  Space,
+  Statistic,
+  Table,
+  Tabs,
+  Tag,
+  Typography,
+  Upload,
+  message,
+} from 'antd';
+import { api, errMsg } from '@/lib/api';
+import { canDo } from '@/lib/auth';
+import { formatUtcTime, yuan } from '@/lib/format';
+import { usePagedList } from '@/lib/usePagedList';
+import type {
+  CpsActivity,
+  CpsGroup,
+  CpsGroupStat,
+  CpsOrder,
+  CpsReconcileResult,
+  CpsReferralLinks,
+  CpsStats,
+} from '@/lib/types';
+
+const MT_STATUS: Record<string, { text: string; color: string }> = {
+  '2': { text: '已付款', color: 'blue' },
+  '3': { text: '已完成', color: 'cyan' },
+  '4': { text: '已取消', color: 'red' },
+  '5': { text: '风控', color: 'orange' },
+  '6': { text: '已结算', color: 'green' },
+};
+
+const PLATFORM_LABEL: Record<string, string> = { meituan: '美团', taobao: '淘宝', jd: '京东' };
+const PLATFORM_COLOR: Record<string, string> = { meituan: 'gold', taobao: 'volcano', jd: 'red' };
+const PLATFORM_OPTIONS = [
+  { label: '美团', value: 'meituan' },
+  { label: '淘宝', value: 'taobao' },
+  { label: '京东', value: 'jd' },
+];
+
+const fmtRate = (r: string | null) => (r ? `${Number(r) / 100}%` : '-');
+const DASH = <span style={{ color: '#bbb' }}>-</span>;
+const platformTags = (ps: string[] | undefined) =>
+  (ps || []).map((p) => (
+    <Tag key={p} color={PLATFORM_COLOR[p]} style={{ marginInlineEnd: 4 }}>
+      {PLATFORM_LABEL[p] || p}
+    </Tag>
+  ));
+
+export default function CpsPage() {
+  return (
+    <div>
+      <h2>CPS 优惠券分发与对账</h2>
+      <Typography.Paragraph type="secondary" style={{ marginTop: -8 }}>
+        美团(actId + sid,可完整对账下单/佣金) / 淘宝(淘口令) / 京东(链接)。淘宝、京东无开放 API,
+        <b>只统计点击</b>,对账字段显示「-」。发群链接都是咱的落地页 /c/xxx。
+      </Typography.Paragraph>
+      <Tabs
+        defaultActiveKey="stats"
+        destroyInactiveTabPane
+        items={[
+          { key: 'stats', label: '对账统计', children: <StatsTab /> },
+          { key: 'groups', label: '群管理', children: <GroupsTab /> },
+          { key: 'activities', label: '活动管理', children: <ActivitiesTab /> },
+          { key: 'orders', label: '订单明细', children: <OrdersTab /> },
+        ]}
+      />
+    </div>
+  );
+}
+
+// ───────────── 对账统计 ─────────────
+function StatsTab() {
+  const [days, setDays] = useState(30);
+  const [data, setData] = useState<CpsStats | null>(null);
+  const [loading, setLoading] = useState(false);
+  const [reconciling, setReconciling] = useState(false);
+  const canReconcile = canDo(['finance']);
+
+  const load = useCallback(async (d: number) => {
+    setLoading(true);
+    try {
+      const resp = await api.get<CpsStats>('/admin/api/cps/stats', { params: { days: d } });
+      setData(resp.data);
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setLoading(false);
+    }
+  }, []);
+
+  useEffect(() => {
+    load(days);
+  }, [days, load]);
+
+  const reconcile = async () => {
+    setReconciling(true);
+    try {
+      const resp = await api.post<CpsReconcileResult>('/admin/api/cps/orders/reconcile', null, {
+        params: { days },
+      });
+      const r = resp.data;
+      message.success(`对账完成:拉取 ${r.fetched} 单(新增 ${r.inserted}、更新 ${r.updated})`);
+      load(days);
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setReconciling(false);
+    }
+  };
+
+  const columns: ColumnsType<CpsGroupStat> = [
+    {
+      title: '群',
+      dataIndex: 'name',
+      width: 140,
+      ellipsis: true,
+      fixed: 'left',
+      render: (v: string, r) =>
+        r.group_id ? <Link href={`/cps/groups/${r.group_id}`}>{v}</Link> : v,
+    },
+    { title: '平台', key: 'platforms', width: 130, render: (_, r) => platformTags(r.platforms) },
+    { title: '人数', dataIndex: 'member_count', width: 64, render: (v) => v ?? '-' },
+    { title: '点击', dataIndex: 'click_pv', width: 64 },
+    { title: '独立', dataIndex: 'click_uv', width: 64 },
+    {
+      title: '复制',
+      dataIndex: 'copy_pv',
+      width: 64,
+      render: (v: number) => (v ? v : DASH),
+    },
+    {
+      title: '有效单',
+      dataIndex: 'order_count',
+      width: 70,
+      render: (v: number | null) => (v == null ? DASH : v),
+    },
+    {
+      title: '取消/风控',
+      dataIndex: 'canceled_count',
+      width: 80,
+      render: (v: number | null) => (v == null ? DASH : v ? <span style={{ color: '#cf1322' }}>{v}</span> : 0),
+    },
+    {
+      title: '点击→下单',
+      key: 'rate',
+      width: 88,
+      render: (_, r) =>
+        r.order_count == null ? DASH : r.click_uv ? `${((r.order_count / r.click_uv) * 100).toFixed(0)}%` : '-',
+    },
+    {
+      title: '成交额',
+      dataIndex: 'gmv_cents',
+      width: 96,
+      render: (v: number | null) => (v == null ? DASH : yuan(v)),
+    },
+    {
+      title: '预估佣金',
+      dataIndex: 'est_commission_cents',
+      width: 100,
+      sorter: (a, b) => (a.est_commission_cents || 0) - (b.est_commission_cents || 0),
+      render: (v: number | null) => (v == null ? DASH : <b>{yuan(v)}</b>),
+    },
+    {
+      title: '已结算佣金',
+      dataIndex: 'settled_commission_cents',
+      width: 100,
+      render: (v: number | null) => (v == null ? DASH : <span style={{ color: '#3f8600' }}>{yuan(v)}</span>),
+    },
+  ];
+
+  return (
+    <div>
+      <Space style={{ marginBottom: 16 }} wrap>
+        <span>统计区间</span>
+        <Select
+          value={days}
+          onChange={setDays}
+          style={{ width: 120 }}
+          options={[
+            { value: 7, label: '近 7 天' },
+            { value: 30, label: '近 30 天' },
+            { value: 90, label: '近 90 天' },
+          ]}
+        />
+        {canReconcile && (
+          <Button type="primary" loading={reconciling} onClick={reconcile}>
+            刷新对账(拉美团订单)
+          </Button>
+        )}
+        <Typography.Text type="secondary">淘宝/京东无对账,「-」即无法对账;佣金以「已结算」为准</Typography.Text>
+      </Space>
+
+      <Space size="large" style={{ marginBottom: 16 }} wrap>
+        <Card size="small">
+          <Statistic title="有效订单数(美团)" value={data?.total_order_count ?? 0} />
+        </Card>
+        <Card size="small">
+          <Statistic
+            title="预估佣金"
+            value={(data?.total_est_commission_cents ?? 0) / 100}
+            precision={2}
+            prefix="¥"
+          />
+        </Card>
+        <Card size="small">
+          <Statistic
+            title="已结算佣金"
+            value={(data?.total_settled_commission_cents ?? 0) / 100}
+            precision={2}
+            prefix="¥"
+            valueStyle={{ color: '#3f8600' }}
+          />
+        </Card>
+      </Space>
+
+      <Table
+        rowKey={(r) => r.sid ?? `gid-${r.group_id ?? 'none'}`}
+        columns={columns}
+        dataSource={data?.groups ?? []}
+        loading={loading}
+        pagination={false}
+        scroll={{ x: 1200 }}
+      />
+    </div>
+  );
+}
+
+// ───────────── 群管理 ─────────────
+function GroupsTab() {
+  const [keyword, setKeyword] = useState('');
+  const [applied, setApplied] = useState<Record<string, unknown>>({});
+  const { items, total, page, pageSize, loading, onChange, reload } = usePagedList<CpsGroup>(
+    '/admin/api/cps/groups',
+    applied,
+  );
+  const canManage = canDo(['operator']);
+
+  const [editing, setEditing] = useState<CpsGroup | null>(null);
+  const [createOpen, setCreateOpen] = useState(false);
+  const [linkGroup, setLinkGroup] = useState<CpsGroup | null>(null);
+
+  const delGroup = async (g: CpsGroup) => {
+    try {
+      await api.delete(`/admin/api/cps/groups/${g.id}`);
+      message.success('已删除群');
+      reload();
+    } catch (e) {
+      message.error(errMsg(e));
+    }
+  };
+
+  const columns: ColumnsType<CpsGroup> = [
+    { title: 'ID', dataIndex: 'id', width: 60 },
+    { title: '群名', dataIndex: 'name', width: 160, ellipsis: true },
+    { title: '平台', key: 'platforms', width: 140, render: (_, g) => platformTags(g.platforms) },
+    {
+      title: 'sid',
+      dataIndex: 'sid',
+      width: 130,
+      render: (v: string | null) => (v ? <Typography.Text copyable>{v}</Typography.Text> : DASH),
+    },
+    { title: '人数', dataIndex: 'member_count', width: 70, render: (v) => v ?? '-' },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 80,
+      render: (s: string) => <Tag color={s === 'active' ? 'green' : 'default'}>{s}</Tag>,
+    },
+    { title: '创建时间', dataIndex: 'created_at', width: 150, render: (v: string) => formatUtcTime(v) },
+    {
+      title: '操作',
+      key: 'op',
+      fixed: 'right',
+      width: 200,
+      render: (_, g) => (
+        <Space onClick={(e) => e.stopPropagation()}>
+          {canManage && <a onClick={() => setLinkGroup(g)}>生成链接</a>}
+          {canManage && <a onClick={() => setEditing(g)}>编辑</a>}
+          {canManage && (
+            <Popconfirm
+              title="删除这个群?"
+              description="已发出的链接仍可用,但该群不再计入统计。"
+              okText="删除"
+              okButtonProps={{ danger: true }}
+              onConfirm={() => delGroup(g)}
+            >
+              <a style={{ color: '#cf1322' }}>删除</a>
+            </Popconfirm>
+          )}
+        </Space>
+      ),
+    },
+  ];
+
+  return (
+    <div>
+      <Space style={{ marginBottom: 16 }} wrap>
+        <Input
+          placeholder="群名/sid"
+          value={keyword}
+          onChange={(e) => setKeyword(e.target.value)}
+          onPressEnter={() => setApplied({ keyword: keyword || undefined })}
+          allowClear
+          style={{ width: 180 }}
+        />
+        <Button type="primary" onClick={() => setApplied({ keyword: keyword || undefined })}>
+          查询
+        </Button>
+        {canManage && <Button onClick={() => setCreateOpen(true)}>新建群</Button>}
+      </Space>
+
+      <Table
+        rowKey="id"
+        columns={columns}
+        dataSource={items}
+        loading={loading}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 个群`,
+          onChange,
+        }}
+        scroll={{ x: 1090 }}
+      />
+
+      <GroupFormModal open={createOpen} group={null} onClose={() => setCreateOpen(false)} onDone={reload} />
+      <GroupFormModal open={!!editing} group={editing} onClose={() => setEditing(null)} onDone={reload} />
+      <ReferralLinkModal group={linkGroup} onClose={() => setLinkGroup(null)} />
+    </div>
+  );
+}
+
+function GroupFormModal({
+  open,
+  group,
+  onClose,
+  onDone,
+}: {
+  open: boolean;
+  group: CpsGroup | null;
+  onClose: () => void;
+  onDone: () => void;
+}) {
+  const [form] = Form.useForm();
+  const isEdit = !!group;
+  const watchPlatforms = (Form.useWatch('platforms', form) as string[] | undefined) || [];
+  const hasMeituan = watchPlatforms.includes('meituan');
+
+  useEffect(() => {
+    if (open) {
+      if (group) {
+        form.setFieldsValue({
+          name: group.name,
+          platforms: group.platforms,
+          member_count: group.member_count,
+          remark: group.remark,
+          status: group.status,
+        });
+      } else {
+        form.resetFields();
+        form.setFieldsValue({ platforms: ['meituan'] });
+      }
+    }
+  }, [open, group, form]);
+
+  const submit = async () => {
+    const v = await form.validateFields();
+    try {
+      if (isEdit && group) {
+        await api.patch(`/admin/api/cps/groups/${group.id}`, v);
+        message.success('已更新群');
+      } else {
+        await api.post('/admin/api/cps/groups', v);
+        message.success('已新建群');
+      }
+      onClose();
+      onDone();
+    } catch (e) {
+      message.error(errMsg(e));
+    }
+  };
+
+  return (
+    <Modal title={isEdit ? '编辑群' : '新建群'} open={open} onOk={submit} onCancel={onClose} destroyOnHidden>
+      <Form form={form} layout="vertical">
+        <Form.Item name="name" label="群名" rules={[{ required: true, message: '请输入群名' }]}>
+          <Input placeholder="如:宝妈优惠群1" />
+        </Form.Item>
+        <Form.Item
+          name="platforms"
+          label="这个群发哪些平台的券(可多选)"
+          rules={[{ required: true, message: '至少选一个平台' }]}
+        >
+          <Checkbox.Group options={PLATFORM_OPTIONS} />
+        </Form.Item>
+        {hasMeituan && !isEdit && (
+          <Form.Item
+            name="sid"
+            label="美团 sid(渠道标识,留空自动生成 g+ID)"
+            rules={[{ pattern: /^[A-Za-z0-9]+$/, message: '仅字母和数字' }]}
+          >
+            <Input placeholder="留空自动生成;或自定义如 baoma1" maxLength={64} />
+          </Form.Item>
+        )}
+        {hasMeituan && isEdit && (
+          <Typography.Text type="secondary" style={{ fontSize: 12, display: 'block', marginBottom: 12 }}>
+            当前 sid:{group?.sid || '(无,保存后如缺会在生成美团链接时报错)'}
+          </Typography.Text>
+        )}
+        <Form.Item name="member_count" label="群人数(用于估算转化率)">
+          <InputNumber style={{ width: '100%' }} min={0} placeholder="如 200" />
+        </Form.Item>
+        {isEdit && (
+          <Form.Item name="status" label="状态">
+            <Select
+              options={[
+                { value: 'active', label: 'active(启用)' },
+                { value: 'archived', label: 'archived(归档)' },
+              ]}
+            />
+          </Form.Item>
+        )}
+        <Form.Item name="remark" label="备注">
+          <Input.TextArea rows={2} maxLength={256} />
+        </Form.Item>
+      </Form>
+    </Modal>
+  );
+}
+
+function ReferralLinkModal({ group, onClose }: { group: CpsGroup | null; onClose: () => void }) {
+  const [activities, setActivities] = useState<CpsActivity[]>([]);
+  const [activityIds, setActivityIds] = useState<number[]>([]);
+  const [result, setResult] = useState<CpsReferralLinks | null>(null);
+  const [loading, setLoading] = useState(false);
+
+  useEffect(() => {
+    if (!group) {
+      setActivityIds([]);
+      setResult(null);
+      return;
+    }
+    api
+      .get('/admin/api/cps/activities', { params: { status: 'active', limit: 100 } })
+      .then((r) => setActivities(r.data.items as CpsActivity[]))
+      .catch((e) => message.error(errMsg(e)));
+  }, [group]);
+
+  // 只列群平台范围内的活动
+  const groupActivities = activities.filter((a) => (group?.platforms || []).includes(a.platform));
+
+  const generate = async () => {
+    if (!group || !activityIds.length) {
+      message.warning('请勾选要生成的活动');
+      return;
+    }
+    setLoading(true);
+    try {
+      const resp = await api.post<CpsReferralLinks>('/admin/api/cps/referral-links', {
+        group_id: group.id,
+        activity_ids: activityIds,
+      });
+      setResult(resp.data);
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setLoading(false);
+    }
+  };
+
+  return (
+    <Modal
+      title={`生成发群链接 - ${group?.name ?? ''}`}
+      open={!!group}
+      onCancel={onClose}
+      onOk={generate}
+      okText="生成"
+      confirmLoading={loading}
+      destroyOnHidden
+      width={660}
+    >
+      <Typography.Paragraph type="secondary" style={{ fontSize: 12 }}>
+        勾选要发的活动,每个生成一条咱的落地页链接;复制后发到群里。
+      </Typography.Paragraph>
+      {groupActivities.length === 0 ? (
+        <Typography.Text type="warning">
+          该群平台({(group?.platforms || []).map((p) => PLATFORM_LABEL[p]).join('/')})下没有活动,请先到「活动管理」新建。
+        </Typography.Text>
+      ) : (
+        <Checkbox.Group
+          value={activityIds}
+          onChange={(v) => setActivityIds(v as number[])}
+          style={{ width: '100%' }}
+        >
+          <Space direction="vertical" style={{ width: '100%' }}>
+            {groupActivities.map((a) => (
+              <Checkbox key={a.id} value={a.id}>
+                <Tag color={PLATFORM_COLOR[a.platform]}>{PLATFORM_LABEL[a.platform]}</Tag>
+                {a.name}
+                {a.act_id ? <span style={{ color: '#999' }}> (actId={a.act_id})</span> : null}
+              </Checkbox>
+            ))}
+          </Space>
+        </Checkbox.Group>
+      )}
+
+      {result && (
+        <div style={{ marginTop: 16 }}>
+          <Typography.Text strong>👇 生成结果(逐条复制发群):</Typography.Text>
+          {result.results.map((item) => (
+            <div
+              key={item.code}
+              style={{
+                marginTop: 8,
+                padding: 10,
+                background: '#f6ffed',
+                border: '1px solid #b7eb8f',
+                borderRadius: 6,
+              }}
+            >
+              <div style={{ marginBottom: 4 }}>
+                <Tag color={PLATFORM_COLOR[item.platform]}>{PLATFORM_LABEL[item.platform]}</Tag>
+                <span style={{ fontSize: 13 }}>{item.activity_name}</span>
+              </div>
+              <Typography.Text copyable={{ text: item.redirect_url }} style={{ fontSize: 14, wordBreak: 'break-all' }}>
+                {item.redirect_url}
+              </Typography.Text>
+            </div>
+          ))}
+          {result.results.some((i) => !i.redirect_url.startsWith('http')) && (
+            <Typography.Text type="warning" style={{ fontSize: 12 }}>
+              ⚠️ 部分为相对路径:后端未配 CPS_REDIRECT_BASE,请配跳转域名后重启。
+            </Typography.Text>
+          )}
+        </div>
+      )}
+    </Modal>
+  );
+}
+
+// ───────────── 活动管理 ─────────────
+function ActivitiesTab() {
+  const { items, total, page, pageSize, loading, onChange, reload } = usePagedList<CpsActivity>(
+    '/admin/api/cps/activities',
+    {},
+  );
+  const canManage = canDo(['operator']);
+  const [createOpen, setCreateOpen] = useState(false);
+  const [editing, setEditing] = useState<CpsActivity | null>(null);
+
+  const delActivity = async (a: CpsActivity) => {
+    try {
+      await api.delete(`/admin/api/cps/activities/${a.id}`);
+      message.success('已删除活动');
+      reload();
+    } catch (e) {
+      message.error(errMsg(e));
+    }
+  };
+
+  const columns: ColumnsType<CpsActivity> = [
+    { title: 'ID', dataIndex: 'id', width: 60 },
+    {
+      title: '平台',
+      dataIndex: 'platform',
+      width: 80,
+      render: (v: string) => <Tag color={PLATFORM_COLOR[v]}>{PLATFORM_LABEL[v] || v}</Tag>,
+    },
+    { title: '活动名', dataIndex: 'name', width: 180, ellipsis: true },
+    {
+      title: 'actId(美团)',
+      dataIndex: 'act_id',
+      width: 110,
+      render: (v: string | null) => v || '-',
+    },
+    {
+      title: '淘口令/链接',
+      dataIndex: 'payload',
+      width: 240,
+      ellipsis: true,
+      render: (v: string | null) => v || '-',
+    },
+    {
+      title: '落地页图',
+      dataIndex: 'image_url',
+      width: 80,
+      render: (v: string | null) =>
+        v ? (
+          <img src={v} alt="" style={{ width: 36, height: 46, objectFit: 'cover', borderRadius: 4 }} />
+        ) : (
+          '-'
+        ),
+    },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 80,
+      render: (s: string) => <Tag color={s === 'active' ? 'green' : 'default'}>{s}</Tag>,
+    },
+    { title: '创建时间', dataIndex: 'created_at', width: 150, render: (v: string) => formatUtcTime(v) },
+    ...(canManage
+      ? ([
+          {
+            title: '操作',
+            key: 'op',
+            fixed: 'right' as const,
+            width: 120,
+            render: (_: unknown, a: CpsActivity) => (
+              <Space>
+                <a onClick={() => setEditing(a)}>编辑</a>
+                <Popconfirm
+                  title="删除这个活动?"
+                  description="已生成的链接仍可用;淘宝活动删除后其落地页改用默认图。"
+                  okText="删除"
+                  okButtonProps={{ danger: true }}
+                  onConfirm={() => delActivity(a)}
+                >
+                  <a style={{ color: '#cf1322' }}>删除</a>
+                </Popconfirm>
+              </Space>
+            ),
+          },
+        ] as ColumnsType<CpsActivity>)
+      : []),
+  ];
+
+  return (
+    <div>
+      {canManage && (
+        <Space style={{ marginBottom: 16 }}>
+          <Button type="primary" onClick={() => setCreateOpen(true)}>
+            新建活动
+          </Button>
+        </Space>
+      )}
+      <Table
+        rowKey="id"
+        columns={columns}
+        dataSource={items}
+        loading={loading}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 个活动`,
+          onChange,
+        }}
+        scroll={{ x: 1200 }}
+      />
+      <ActivityFormModal open={createOpen} activity={null} onClose={() => setCreateOpen(false)} onDone={reload} />
+      <ActivityFormModal open={!!editing} activity={editing} onClose={() => setEditing(null)} onDone={reload} />
+    </div>
+  );
+}
+
+// 淘宝活动落地页图选择器:上传新图 或 点选已有图。受控组件(value = image_url 绝对 URL)。
+function ImagePicker({ value, onChange }: { value?: string | null; onChange?: (v: string) => void }) {
+  const [existing, setExisting] = useState<string[]>([]);
+  const [uploading, setUploading] = useState(false);
+
+  useEffect(() => {
+    api
+      .get<{ images: string[] }>('/admin/api/cps/activity-images')
+      .then((r) => setExisting(r.data.images || []))
+      .catch(() => {});
+  }, []);
+
+  const upload = async (file: File) => {
+    setUploading(true);
+    try {
+      const fd = new FormData();
+      fd.append('file', file);
+      const r = await api.post<{ url: string }>('/admin/api/cps/upload-image', fd);
+      onChange?.(r.data.url);
+      setExisting((prev) => (prev.includes(r.data.url) ? prev : [r.data.url, ...prev]));
+      message.success('图片已上传');
+    } catch (e) {
+      message.error(errMsg(e, '上传失败'));
+    } finally {
+      setUploading(false);
+    }
+  };
+
+  const thumb = (u: string, w: number, selected: boolean) => (
+    <img
+      key={u}
+      src={u}
+      alt="落地页图"
+      onClick={() => onChange?.(u)}
+      style={{
+        width: w,
+        height: Math.round(w * 1.27),
+        objectFit: 'cover',
+        borderRadius: 6,
+        cursor: 'pointer',
+        border: selected ? '2px solid #ff4d4f' : '2px solid #f0f0f0',
+      }}
+    />
+  );
+
+  return (
+    <div>
+      <Upload
+        accept="image/*"
+        showUploadList={false}
+        beforeUpload={(file) => {
+          upload(file);
+          return false; // 阻止 antd 默认上传,走我们自己的端点
+        }}
+      >
+        <Button loading={uploading}>上传新图</Button>
+      </Upload>
+      {value && (
+        <div style={{ marginTop: 8, display: 'flex', alignItems: 'center', gap: 8 }}>
+          <span style={{ fontSize: 12, color: '#999' }}>当前:</span>
+          {thumb(value, 90, true)}
+        </div>
+      )}
+      {existing.length > 0 && (
+        <div style={{ marginTop: 10 }}>
+          <div style={{ fontSize: 12, color: '#999', marginBottom: 6 }}>或选择已有图:</div>
+          <Space wrap>{existing.map((u) => thumb(u, 56, u === value))}</Space>
+        </div>
+      )}
+    </div>
+  );
+}
+
+function ActivityFormModal({
+  open,
+  activity,
+  onClose,
+  onDone,
+}: {
+  open: boolean;
+  activity: CpsActivity | null;
+  onClose: () => void;
+  onDone: () => void;
+}) {
+  const [form] = Form.useForm();
+  const isEdit = !!activity;
+  const platform = (Form.useWatch('platform', form) as string | undefined) || 'meituan';
+
+  useEffect(() => {
+    if (open) {
+      if (activity) {
+        form.setFieldsValue({
+          name: activity.name,
+          platform: activity.platform,
+          act_id: activity.act_id,
+          product_view_sign: activity.product_view_sign,
+          payload: activity.payload,
+          image_url: activity.image_url,
+          remark: activity.remark,
+          status: activity.status,
+        });
+      } else {
+        form.resetFields();
+        form.setFieldsValue({ platform: 'meituan' });
+      }
+    }
+  }, [open, activity, form]);
+
+  const submit = async () => {
+    const v = await form.validateFields();
+    if (v.platform === 'meituan') {
+      if (!v.act_id && !v.product_view_sign) {
+        message.warning('美团活动:actId 与 productViewSign 至少填一个');
+        return;
+      }
+    } else if (!v.payload) {
+      message.warning(v.platform === 'taobao' ? '请填淘口令' : '请填京东链接');
+      return;
+    }
+    try {
+      if (isEdit && activity) {
+        await api.patch(`/admin/api/cps/activities/${activity.id}`, v);
+        message.success('已更新活动');
+      } else {
+        await api.post('/admin/api/cps/activities', v);
+        message.success('已新建活动');
+      }
+      onClose();
+      onDone();
+    } catch (e) {
+      message.error(errMsg(e));
+    }
+  };
+
+  return (
+    <Modal title={isEdit ? '编辑活动' : '新建活动'} open={open} onOk={submit} onCancel={onClose} destroyOnHidden>
+      <Form form={form} layout="vertical" initialValues={{ platform: 'meituan' }}>
+        <Form.Item name="name" label="活动名" rules={[{ required: true }]}>
+          <Input placeholder="如:点我领取大额红包" />
+        </Form.Item>
+        <Form.Item name="platform" label="平台" rules={[{ required: true }]}>
+          <Select options={PLATFORM_OPTIONS} />
+        </Form.Item>
+
+        {platform === 'meituan' && (
+          <>
+            <Form.Item name="act_id" label="actId(美团活动物料 ID,推荐)">
+              <Input placeholder="美团联盟「我要推广-活动推广」第一列 ID,如 792" maxLength={64} />
+            </Form.Item>
+            <Form.Item name="product_view_sign" label="productViewSign(商品券,与 actId 二选一)">
+              <Input maxLength={128} />
+            </Form.Item>
+          </>
+        )}
+        {platform === 'taobao' && (
+          <>
+            <Form.Item
+              name="payload"
+              label="淘口令(整段,运营从淘宝联盟复制,落地页原样复制给用户)"
+              rules={[{ required: true, message: '请填淘口令' }]}
+            >
+              <Input.TextArea rows={4} placeholder="如:8￥abcXYZ￥ https://m.tb.cn/h.xxx 长按复制本条..." maxLength={4096} />
+            </Form.Item>
+            <Form.Item
+              name="image_url"
+              label="落地页图(用户点链接后看到的页面主图,上传新图或选已有)"
+              rules={[{ required: true, message: '请上传或选择落地页图' }]}
+            >
+              <ImagePicker />
+            </Form.Item>
+          </>
+        )}
+        {platform === 'jd' && (
+          <Form.Item
+            name="payload"
+            label="京东推广链接(落地页 302 跳到它)"
+            rules={[{ required: true, message: '请填京东链接' }]}
+          >
+            <Input placeholder="如:https://u.jd.com/xxxxxx" maxLength={1024} />
+          </Form.Item>
+        )}
+
+        <Form.Item name="remark" label="备注">
+          <Input.TextArea rows={2} maxLength={256} />
+        </Form.Item>
+        {isEdit && (
+          <Form.Item name="status" label="状态">
+            <Select
+              options={[
+                { value: 'active', label: '启用(active)' },
+                { value: 'archived', label: '归档(archived)' },
+              ]}
+            />
+          </Form.Item>
+        )}
+      </Form>
+    </Modal>
+  );
+}
+
+// ───────────── 订单明细 ─────────────
+function OrdersTab() {
+  const [sid, setSid] = useState('');
+  const [status, setStatus] = useState<string | undefined>();
+  const [applied, setApplied] = useState<Record<string, unknown>>({});
+  const { items, total, page, pageSize, loading, onChange } = usePagedList<CpsOrder>(
+    '/admin/api/cps/orders',
+    applied,
+  );
+
+  const columns: ColumnsType<CpsOrder> = [
+    {
+      title: '订单号',
+      dataIndex: 'order_id',
+      width: 200,
+      ellipsis: true,
+      render: (v: string) => <Typography.Text copyable>{v}</Typography.Text>,
+    },
+    { title: 'sid', dataIndex: 'sid', width: 120, render: (v) => v || '-' },
+    { title: '商品', dataIndex: 'product_name', width: 200, ellipsis: true, render: (v) => v || '-' },
+    {
+      title: '成交额',
+      dataIndex: 'pay_price_cents',
+      width: 100,
+      render: (v: number | null) => (v != null ? yuan(v) : '-'),
+    },
+    {
+      title: '佣金',
+      dataIndex: 'commission_cents',
+      width: 90,
+      render: (v: number | null) => (v != null ? yuan(v) : '-'),
+    },
+    { title: '佣金率', dataIndex: 'commission_rate', width: 80, render: fmtRate },
+    {
+      title: '状态',
+      dataIndex: 'mt_status',
+      width: 90,
+      render: (s: string | null) => {
+        const m = s ? MT_STATUS[s] : null;
+        return m ? <Tag color={m.color}>{m.text}</Tag> : s || '-';
+      },
+    },
+    { title: '支付时间', dataIndex: 'pay_time', width: 150, render: (v) => formatUtcTime(v) },
+  ];
+
+  const search = () => setApplied({ sid: sid || undefined, mt_status: status });
+
+  return (
+    <div>
+      <Space style={{ marginBottom: 16 }} wrap>
+        <Input
+          placeholder="sid"
+          value={sid}
+          onChange={(e) => setSid(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 150 }}
+        />
+        <Select
+          placeholder="状态"
+          value={status}
+          onChange={setStatus}
+          allowClear
+          style={{ width: 120 }}
+          options={Object.entries(MT_STATUS).map(([v, m]) => ({ value: v, label: m.text }))}
+        />
+        <Button type="primary" onClick={search}>
+          查询
+        </Button>
+      </Space>
+      <Table
+        rowKey="id"
+        columns={columns}
+        dataSource={items}
+        loading={loading}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 单`,
+          onChange,
+        }}
+        scroll={{ x: 1030 }}
+      />
+    </div>
+  );
+}

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

@@ -2,6 +2,7 @@
 
 import { useEffect, useState } from 'react';
 import {
+  App,
   Button,
   Form,
   Input,
@@ -12,7 +13,6 @@ import {
   Spin,
   Switch,
   Table,
-  message,
 } from 'antd';
 import { api, errMsg } from '@/lib/api';
 
@@ -51,6 +51,7 @@ const yuan = (cents: number) => (cents / 100).toFixed(2);
 
 /** 首页轮播「种子」管理(真实记录不足时的兜底假数据,现为「生成规则」)。「数据大盘」页的一个区块。 */
 export default function HomeMarqueeSeeds() {
+  const { message } = App.useApp();
   const [seeds, setSeeds] = useState<Seed[]>([]);
   const [loading, setLoading] = useState(true);
   const [selectedRowKeys, setSelectedRowKeys] = useState<number[]>([]); // 批量操作选中行

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

@@ -2,12 +2,12 @@
 
 import { useEffect, useState } from 'react';
 import {
+  App,
   Button,
   Card,
   Checkbox,
   Col,
   InputNumber,
-  Modal,
   Popconfirm,
   Radio,
   Row,
@@ -16,9 +16,9 @@ import {
   Spin,
   Tag,
   Tooltip,
-  message,
 } from 'antd';
 import { api, errMsg } from '@/lib/api';
+import { formatUtcTime } from '@/lib/format';
 
 interface StatItem {
   metric: string; // help_users / total_compares / total_saved
@@ -248,6 +248,7 @@ function buildBody(metric: string, e: Edit, immediate: boolean): Record<string,
 
 /** 首页三门面数字(帮助用户/完成比价/累计节省)的展示模式配置。作为「数据大盘」页的一个区块。 */
 export default function HomeStatsConfig() {
+  const { message, modal } = App.useApp();
   const [items, setItems] = useState<StatItem[]>([]);
   const [loading, setLoading] = useState(true);
   const [edits, setEdits] = useState<Record<string, Edit>>({});
@@ -320,7 +321,7 @@ export default function HomeStatsConfig() {
     // 智能校验:按下后三者大概会呈现的关系是否合理,不合理则弹窗劝阻、确认才提交。
     const rel = checkRelations(items, edits);
     if (rel && rel.warnings.length > 0) {
-      Modal.confirm({
+      modal.confirm({
         title: '数据关系校验',
         width: 480,
         okText: '仍要这样设置',
@@ -601,7 +602,7 @@ export default function HomeStatsConfig() {
                         </span>
                         {it.updated_at && (
                           <span style={{ color: '#bbb' }}>
-                            更新于 {new Date(it.updated_at).toLocaleString('zh-CN')}
+                            更新于 {formatUtcTime(it.updated_at, 'YYYY-MM-DD HH:mm:ss')}
                           </span>
                         )}
                       </Space>

src/app/(main)/device-liveness/page.tsx

@@ -0,0 +1,253 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
+import type { ColumnsType } from 'antd/es/table';
+import type { SorterResult } from 'antd/es/table/interface';
+import { ReloadOutlined } from '@ant-design/icons';
+import { Button, Card, Col, Input, Row, Select, Space, Statistic, Table, Tag, Tooltip } from 'antd';
+import { api } from '@/lib/api';
+import { formatUtcTime, utcFromNow } from '@/lib/format';
+import { usePagedList } from '@/lib/usePagedList';
+import type { DeviceLivenessItem, DeviceLivenessStats } from '@/lib/types';
+
+type SortField = 'status' | 'last_heartbeat_at' | 'created_at';
+
+// 存活状态(后端按心跳阈值派生 display_state)→ 标签。operator 口径,不暴露内部 alive/notified/silent。
+const STATUS_TAG: Record<string, { color: string; label: string }> = {
+  online: { color: 'green', label: '在线' },
+  offline: { color: 'red', label: '已掉线' },
+  never: { color: 'default', label: '未启用' },
+};
+
+/** 秒 → 人话时长(掉线时长用)。 */
+function fmtDuration(sec: number | null): string {
+  if (sec == null) return '';
+  if (sec < 60) return `${sec} 秒`;
+  const m = Math.floor(sec / 60);
+  if (m < 60) return `${m} 分钟`;
+  const h = Math.floor(m / 60);
+  if (h < 24) return `${h} 小时 ${m % 60} 分`;
+  const d = Math.floor(h / 24);
+  return `${d} 天 ${h % 24} 小时`;
+}
+
+// 暂无数据的字段统一占位(待客户端上报 / 待加字段)。
+const pending = (hint: string) => (
+  <Tooltip title={hint}>
+    <Tag color="default">待接入</Tag>
+  </Tooltip>
+);
+
+export default function DeviceLivenessPage() {
+  // 筛选草稿:点「查询」才应用
+  const [deviceId, setDeviceId] = useState('');
+  const [phone, setPhone] = useState('');
+  const [status, setStatus] = useState<string | undefined>();
+  const [applied, setApplied] = useState<Record<string, unknown>>({});
+  // 排序:默认 status = 掉线置顶;点「最近心跳」列头切换
+  const [sortBy, setSortBy] = useState<SortField>('status');
+  const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc');
+
+  const filters = { ...applied, sort_by: sortBy, sort_order: sortOrder };
+  const { items, total, page, pageSize, loading, onChange, reload } = usePagedList<DeviceLivenessItem>(
+    '/admin/api/device-liveness',
+    filters,
+  );
+
+  // 顶部卡片统计(全局,不随筛选)
+  const [stats, setStats] = useState<DeviceLivenessStats | null>(null);
+  const loadStats = useCallback(() => {
+    api.get<DeviceLivenessStats>('/admin/api/device-liveness/stats').then((r) => setStats(r.data));
+  }, []);
+  useEffect(() => {
+    loadStats();
+  }, [loadStats]);
+
+  const search = () =>
+    setApplied({
+      status,
+      device_id: deviceId || undefined,
+      phone: phone || undefined,
+    });
+
+  const resetFilters = () => {
+    setDeviceId('');
+    setPhone('');
+    setStatus(undefined);
+    setSortBy('status');
+    setSortOrder('desc');
+    setApplied({});
+  };
+
+  const refreshAll = () => {
+    reload();
+    loadStats();
+  };
+
+  const onTableChange = (
+    _pagination: unknown,
+    _filters: unknown,
+    sorter: SorterResult<DeviceLivenessItem> | SorterResult<DeviceLivenessItem>[],
+  ) => {
+    const s = Array.isArray(sorter) ? sorter[0] : sorter;
+    if (s && s.order && s.field) {
+      setSortBy(s.field as SortField);
+      setSortOrder(s.order === 'ascend' ? 'asc' : 'desc');
+    } else {
+      // 取消列排序 → 回默认「掉线置顶」
+      setSortBy('status');
+      setSortOrder('desc');
+    }
+  };
+
+  const sortOrderOf = (field: SortField) =>
+    sortBy === field ? (sortOrder === 'asc' ? 'ascend' : 'descend') : null;
+
+  const cards = stats
+    ? [
+        { title: '总设备数', value: stats.total, color: undefined as string | undefined },
+        { title: '在线', value: stats.online, color: '#3f8600' },
+        { title: '已掉线', value: stats.offline, color: stats.offline > 0 ? '#cf1322' : undefined },
+        { title: '未启用', value: stats.never, color: undefined },
+      ]
+    : [];
+
+  // 列顺序对齐产品给的字段清单
+  const columns: ColumnsType<DeviceLivenessItem> = [
+    { title: '设备 ID', dataIndex: 'device_id', fixed: 'left', width: 210, ellipsis: true },
+    {
+      title: '归属用户',
+      key: 'user',
+      width: 150,
+      render: (_: unknown, d: DeviceLivenessItem) => (
+        <div>
+          <div>{d.phone || `user#${d.user_id}`}</div>
+          {d.nickname && <div style={{ color: '#888', fontSize: 12 }}>{d.nickname}</div>}
+        </div>
+      ),
+    },
+    { title: '机型', dataIndex: 'device_model', width: 130, render: (v: string | null) => v || '-' },
+    {
+      title: '系统&系统版本',
+      key: 'os',
+      width: 130,
+      render: () => pending('设备未上报系统版本,需客户端在注册/心跳里带上 + 后端加列'),
+    },
+    { title: 'APP 版本', dataIndex: 'app_version', width: 100, render: (v: string | null) => v || '-' },
+    {
+      title: '最近一次心跳',
+      dataIndex: 'last_heartbeat_at',
+      width: 150,
+      sorter: true,
+      sortOrder: sortOrderOf('last_heartbeat_at'),
+      render: (v: string | null) =>
+        v ? <Tooltip title={formatUtcTime(v, 'YYYY-MM-DD HH:mm:ss')}>{utcFromNow(v)}</Tooltip> : '-',
+    },
+    {
+      title: '存活状态',
+      dataIndex: 'display_state',
+      width: 130,
+      render: (s: string, d: DeviceLivenessItem) => {
+        const t = STATUS_TAG[s] ?? { color: 'default', label: s };
+        return (
+          <div>
+            <Tag color={t.color}>{t.label}</Tag>
+            {s === 'offline' && d.offline_seconds != null && (
+              <div style={{ color: '#cf1322', fontSize: 12 }}>已 {fmtDuration(d.offline_seconds)}</div>
+            )}
+          </div>
+        );
+      },
+    },
+    {
+      title: '首次无障碍开启时间',
+      dataIndex: 'first_protected_at',
+      width: 150,
+      render: (v: string | null) =>
+        v ? (
+          formatUtcTime(v)
+        ) : (
+          <Tooltip title="迁移前已开过无障碍的老设备无此记录;之后首次开无障碍的设备会记录">
+            <span style={{ color: '#bbb' }}>-</span>
+          </Tooltip>
+        ),
+    },
+  ];
+
+  return (
+    <div>
+      <h2>设备存活监控</h2>
+
+      {stats && (
+        <Row gutter={[16, 16]} style={{ marginBottom: 16 }}>
+          {cards.map((c) => (
+            <Col key={c.title} xs={12} sm={6} md={6} xl={4}>
+              <Card>
+                <Statistic
+                  title={c.title}
+                  value={c.value}
+                  valueStyle={c.color ? { color: c.color } : undefined}
+                />
+              </Card>
+            </Col>
+          ))}
+        </Row>
+      )}
+
+      <Space style={{ marginBottom: 16 }} wrap>
+        <Select
+          placeholder="存活状态"
+          value={status}
+          onChange={setStatus}
+          allowClear
+          style={{ width: 140 }}
+          options={[
+            { value: 'offline', label: '已掉线' },
+            { value: 'online', label: '在线' },
+            { value: 'never', label: '未启用' },
+          ]}
+        />
+        <Input
+          placeholder="设备ID(包含)"
+          value={deviceId}
+          onChange={(e) => setDeviceId(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 200 }}
+        />
+        <Input
+          placeholder="归属用户手机号(前缀)"
+          value={phone}
+          onChange={(e) => setPhone(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 180 }}
+        />
+        <Button type="primary" onClick={search}>
+          查询
+        </Button>
+        <Button onClick={resetFilters}>重置</Button>
+        <Button icon={<ReloadOutlined />} onClick={refreshAll}>
+          刷新
+        </Button>
+      </Space>
+
+      <Table
+        rowKey="id"
+        columns={columns}
+        dataSource={items}
+        loading={loading}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 台设备`,
+          onChange,
+        }}
+        scroll={{ x: 1300 }}
+        onChange={onTableChange}
+      />
+    </div>
+  );
+}

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

@@ -1,16 +1,19 @@
 'use client';
 
 import type { ColumnsType } from 'antd/es/table';
-import { Button, Modal, Popconfirm, Space, Table, message } from 'antd';
+import { App, Button, Popconfirm, Space, Table } from 'antd';
 import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
+import { formatUtcTime } from '@/lib/format';
 import { useCursorList } from '@/lib/useCursorList';
 import type { DeviceOnboardingItem } from '@/lib/types';
 
-const dt = (v: string) => new Date(v).toLocaleString('zh-CN');
+// completed_at 为 UTC 口径(server_default now()),按北京显示(勿用 new Date().toLocaleString)
+const dt = (v: string) => formatUtcTime(v);
 const EMPTY: Record<string, unknown> = {};
 
 export default function DevicesPage() {
+  const { message, modal } = App.useApp();
   // 后端按设备聚合、全量返回(next_cursor 恒 null),故无筛选/加载更多。
   const { items, loading, reload } = useCursorList<DeviceOnboardingItem>(
     '/admin/api/onboarding/devices',
@@ -29,7 +32,7 @@ export default function DevicesPage() {
   };
 
   const resetAll = () => {
-    Modal.confirm({
+    modal.confirm({
       title: '确认全部重设新手引导?',
       content:
         '清空所有设备的引导完成记录,库里所有用户下次打开 App 都会重走一遍新手引导。此操作不可逆。',

src/app/(main)/event-logs/page.tsx

@@ -0,0 +1,245 @@
+'use client';
+
+import { useEffect, useRef, useState } from 'react';
+import type { ColumnsType } from 'antd/es/table';
+import type { SorterResult } from 'antd/es/table/interface';
+import { Button, DatePicker, Input, Space, Switch, Table, Tag, Typography } from 'antd';
+import type { Dayjs } from 'dayjs';
+import dayjs from 'dayjs';
+import { formatUtcTime } from '@/lib/format';
+import { usePagedList } from '@/lib/usePagedList';
+
+const { Text } = Typography;
+const { RangePicker } = DatePicker;
+
+/** 一条埋点日志(对应后端 analytics_event,五维)。 */
+type EventLog = {
+  id: number;
+  event: string;
+  device_id: string;
+  user_id: number | null;
+  session_id: string | null;
+  client_ts: number;
+  sent_at: number | null;
+  created_at: string;
+  page: string | null;
+  client_ip: string | null;
+  oem: string | null;
+  os: string | null;
+  model: string | null;
+  app_ver: string | null;
+  network: string | null;
+  channel: string | null;
+  props: Record<string, string> | null;
+};
+
+type SortField = 'id' | 'created_at';
+
+// 端时间是 epoch ms;格式化成「月-日 时:分:秒.毫秒」便于核对节流/顺序
+const fmtMs = (ms: number | null) => (ms ? dayjs(ms).format('MM-DD HH:mm:ss.SSS') : '-');
+
+export default function EventLogsPage() {
+  // 筛选草稿:点「查询」才应用
+  const [event, setEvent] = useState('');
+  const [deviceId, setDeviceId] = useState('');
+  const [userId, setUserId] = useState('');
+  const [sessionId, setSessionId] = useState('');
+  const [createdRange, setCreatedRange] = useState<[Dayjs, Dayjs] | null>(null);
+  const [applied, setApplied] = useState<Record<string, unknown>>({});
+  // 排序(服务端)
+  const [sortBy, setSortBy] = useState<SortField>('id');
+  const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc');
+  // 近实时:自动刷新开关
+  const [autoRefresh, setAutoRefresh] = useState(false);
+
+  const filters: Record<string, unknown> = { ...applied, sort_by: sortBy, sort_order: sortOrder };
+  const { items, total, page, pageSize, loading, onChange: onPageChange, reload } =
+    usePagedList<EventLog>('/admin/api/event-logs', filters);
+
+  // 开自动刷新后每 5s 拉当前页;reload 闭包随渲染更新,用 ref 取最新,避免 interval captured 过期闭包。
+  const reloadRef = useRef(reload);
+  reloadRef.current = reload;
+  useEffect(() => {
+    if (!autoRefresh) return;
+    const t = setInterval(() => reloadRef.current(), 5000);
+    return () => clearInterval(t);
+  }, [autoRefresh]);
+
+  const search = () =>
+    setApplied({
+      event: event.trim() || undefined,
+      device_id: deviceId.trim() || undefined,
+      user_id: userId.trim() ? Number(userId.trim()) : undefined,
+      session_id: sessionId.trim() || undefined,
+      created_from: createdRange?.[0] ? createdRange[0].startOf('day').toISOString() : undefined,
+      created_to: createdRange?.[1] ? createdRange[1].endOf('day').toISOString() : undefined,
+    });
+
+  const resetFilters = () => {
+    setEvent('');
+    setDeviceId('');
+    setUserId('');
+    setSessionId('');
+    setCreatedRange(null);
+    setSortBy('id');
+    setSortOrder('desc');
+    setApplied({});
+  };
+
+  const onTableChange = (
+    _p: unknown,
+    _f: unknown,
+    sorter: SorterResult<EventLog> | SorterResult<EventLog>[],
+  ) => {
+    const s = Array.isArray(sorter) ? sorter[0] : sorter;
+    if (s && s.order && s.field) {
+      setSortBy(s.field as SortField);
+      setSortOrder(s.order === 'ascend' ? 'asc' : 'desc');
+    } else {
+      setSortBy('id');
+      setSortOrder('desc');
+    }
+  };
+
+  const sortOrderOf = (field: SortField) =>
+    sortBy === field ? (sortOrder === 'asc' ? 'ascend' : 'descend') : null;
+
+  const columns: ColumnsType<EventLog> = [
+    {
+      title: '接收时间',
+      dataIndex: 'created_at',
+      width: 170,
+      sorter: true,
+      sortOrder: sortOrderOf('created_at'),
+      render: (v: string) => formatUtcTime(v),
+    },
+    { title: 'ID', dataIndex: 'id', width: 70, sorter: true, sortOrder: sortOrderOf('id') },
+    {
+      title: '事件',
+      dataIndex: 'event',
+      width: 170,
+      render: (v: string) => <Tag color="blue">{v}</Tag>,
+    },
+    {
+      title: '页面',
+      dataIndex: 'page',
+      width: 100,
+      render: (v: string | null) => v || <Text type="secondary">-</Text>,
+    },
+    {
+      title: '用户',
+      dataIndex: 'user_id',
+      width: 80,
+      render: (v: number | null) => v ?? <Text type="secondary">未登录</Text>,
+    },
+    {
+      title: '设备',
+      dataIndex: 'device_id',
+      width: 150,
+      ellipsis: true,
+      render: (v: string) => (
+        <Text style={{ fontSize: 12 }} copyable={{ text: v }}>
+          {v}
+        </Text>
+      ),
+    },
+    { title: '网络', dataIndex: 'network', width: 70, render: (v: string | null) => v || '-' },
+    {
+      title: '机型',
+      key: 'oem',
+      width: 130,
+      render: (_: unknown, r: EventLog) => (
+        <Text style={{ fontSize: 12 }}>{[r.oem, r.os].filter(Boolean).join(' / ') || '-'}</Text>
+      ),
+    },
+    { title: '版本', dataIndex: 'app_ver', width: 100, render: (v: string | null) => v || '-' },
+  ];
+
+  return (
+    <div>
+      <h2>埋点日志</h2>
+      <Space style={{ marginBottom: 16 }} wrap>
+        <Input
+          placeholder="事件名 (如 video_play)"
+          value={event}
+          onChange={(e) => setEvent(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 180 }}
+        />
+        <Input
+          placeholder="设备ID(前缀)"
+          value={deviceId}
+          onChange={(e) => setDeviceId(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 160 }}
+        />
+        <Input
+          placeholder="用户ID"
+          value={userId}
+          onChange={(e) => setUserId(e.target.value.replace(/\D/g, ''))}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 100 }}
+        />
+        <Input
+          placeholder="会话ID"
+          value={sessionId}
+          onChange={(e) => setSessionId(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 160 }}
+        />
+        <RangePicker
+          placeholder={['接收起', '接收止']}
+          value={createdRange}
+          onChange={(v) => setCreatedRange(v as [Dayjs, Dayjs] | null)}
+          allowClear
+        />
+        <Button type="primary" onClick={search}>
+          查询
+        </Button>
+        <Button onClick={resetFilters}>重置</Button>
+        <Button onClick={reload}>刷新</Button>
+        <Space size={4}>
+          <Switch checked={autoRefresh} onChange={setAutoRefresh} />
+          <Text type="secondary">自动刷新(5s)</Text>
+        </Space>
+      </Space>
+
+      <Table
+        rowKey="id"
+        size="small"
+        columns={columns}
+        dataSource={items}
+        loading={loading}
+        expandable={{
+          expandedRowRender: (r) => (
+            <Space direction="vertical" size={2} style={{ fontSize: 12 }}>
+              <Text type="secondary">
+                会话: {r.session_id || '-'} ｜ 设备型号: {r.model || '-'} ｜ 渠道: {r.channel || '-'} ｜ IP:{' '}
+                {r.client_ip || '-'}
+              </Text>
+              <Text type="secondary">
+                端事件时间: {fmtMs(r.client_ts)} ｜ 端上报时间: {fmtMs(r.sent_at)}
+              </Text>
+              <Text type="secondary">
+                属性: {r.props && Object.keys(r.props).length ? JSON.stringify(r.props) : '无'}
+              </Text>
+            </Space>
+          ),
+        }}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 条`,
+          onChange: onPageChange,
+        }}
+        onChange={onTableChange}
+      />
+    </div>
+  );
+}

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

@@ -0,0 +1,325 @@
+'use client';
+
+// 反馈审核抽屉:展示本条反馈 + 该用户历史反馈(就近参考),待审核态可采纳(发金币)或拒绝(填用户可见原因)。
+// 已审核态只读回显。对接同事 PR#66 接口:POST .../approve、POST .../reject(.../handle 已废弃)。
+import { useEffect, useState } from 'react';
+import {
+  App,
+  Button,
+  Drawer,
+  Form,
+  Image,
+  Input,
+  InputNumber,
+  Segmented,
+  Space,
+  Spin,
+  Tag,
+  Typography,
+} from 'antd';
+import { api, errMsg } from '@/lib/api';
+import { canDo } from '@/lib/auth';
+import { formatUtcTime } from '@/lib/format';
+import { mediaUrl } from '@/lib/media';
+import type { CursorPage, Feedback } from '@/lib/types';
+
+const { Text, Paragraph } = Typography;
+
+const REWARD_MAX = 10000; // 对齐后端 FEEDBACK_REWARD_MAX_COINS
+
+interface Props {
+  feedback: Feedback | null;
+  open: boolean;
+  onClose: () => void;
+  onDone: () => void; // 审核成功后刷新列表
+}
+
+// 待审核(同事后端初始态 pending;兼容历史 new 数据)
+const isPending = (s: string) => s === 'pending' || s === 'new';
+
+const STATUS_META: Record<string, { label: string; color: string }> = {
+  pending: { label: '审核中', color: 'orange' },
+  new: { label: '待审核', color: 'orange' },
+  adopted: { label: '已采纳', color: 'green' },
+  rejected: { label: '未采纳', color: 'red' },
+};
+
+const statusTag = (s: string) => {
+  const m = STATUS_META[s] ?? { label: s, color: 'default' };
+  return <Tag color={m.color}>{m.label}</Tag>;
+};
+
+function FeedbackImages({ images }: { images: string[] | null }) {
+  if (!images || !images.length) return <Text type="secondary">无截图</Text>;
+  return (
+    <Image.PreviewGroup>
+      <Space size={4} wrap>
+        {images.map((src, i) => (
+          <Image
+            key={i}
+            src={mediaUrl(src)}
+            width={48}
+            height={48}
+            style={{ objectFit: 'cover', borderRadius: 4 }}
+          />
+        ))}
+      </Space>
+    </Image.PreviewGroup>
+  );
+}
+
+export default function FeedbackHandleDrawer({ feedback, open, onClose, onDone }: Props) {
+  const { message } = App.useApp();
+  const [form] = Form.useForm();
+  const [action, setAction] = useState<'approve' | 'reject'>('approve');
+  const [submitting, setSubmitting] = useState(false);
+  const [history, setHistory] = useState<Feedback[]>([]);
+  const [loadingHistory, setLoadingHistory] = useState(false);
+
+  const editable = feedback != null && isPending(feedback.status) && canDo(['operator']);
+
+  // 打开时:重置表单 + 拉该用户全部历史反馈(含本条,渲染时滤掉本条)
+  useEffect(() => {
+    if (!open || !feedback) return;
+    setAction('approve');
+    form.resetFields();
+    let alive = true;
+    setLoadingHistory(true);
+    api
+      .get<CursorPage<Feedback>>('/admin/api/feedbacks', {
+        params: { user_id: feedback.user_id, limit: 50, sort_by: 'id', sort_order: 'desc' },
+      })
+      .then((r) => {
+        if (alive) setHistory(r.data.items);
+      })
+      .catch(() => {
+        if (alive) setHistory([]);
+      })
+      .finally(() => {
+        if (alive) setLoadingHistory(false);
+      });
+    return () => {
+      alive = false;
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [open, feedback?.id]);
+
+  const submit = async () => {
+    if (!feedback) return;
+    const v = await form.validateFields();
+    setSubmitting(true);
+    try {
+      if (action === 'approve') {
+        await api.post(`/admin/api/feedbacks/${feedback.id}/approve`, {
+          reward_coins: v.reward_coins,
+          note: v.note?.trim() || null,
+        });
+        message.success(`已采纳,发放 ${v.reward_coins} 金币`);
+      } else {
+        await api.post(`/admin/api/feedbacks/${feedback.id}/reject`, {
+          reason: v.reason.trim(),
+          note: v.note?.trim() || null,
+        });
+        message.success('已拒绝');
+      }
+      onClose();
+      onDone();
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setSubmitting(false);
+    }
+  };
+
+  const others = feedback ? history.filter((h) => h.id !== feedback.id) : [];
+
+  return (
+    <Drawer
+      title={feedback ? (editable ? `审核反馈 #${feedback.id}` : `反馈详情 #${feedback.id}`) : ''}
+      width={560}
+      open={open}
+      onClose={onClose}
+      destroyOnHidden
+      extra={
+        editable ? (
+          <Button type="primary" danger={action === 'reject'} loading={submitting} onClick={submit}>
+            {action === 'approve' ? '采纳并发金币' : '确认拒绝'}
+          </Button>
+        ) : null
+      }
+    >
+      {feedback && (
+        <Space direction="vertical" size="large" style={{ width: '100%' }}>
+          {/* 本条反馈 */}
+          <div>
+            <Text type="secondary">
+              用户 {feedback.user_id} · {formatUtcTime(feedback.created_at)}
+            </Text>
+            <Paragraph style={{ whiteSpace: 'pre-wrap', marginTop: 8, marginBottom: 8 }}>
+              {feedback.content || '-'}
+            </Paragraph>
+            <FeedbackImages images={feedback.images} />
+          </div>
+
+          {/* 已审核(或无权限):只读回显 */}
+          {!editable && (
+            <div
+              style={{
+                background:
+                  feedback.status === 'adopted'
+                    ? '#f6ffed'
+                    : feedback.status === 'rejected'
+                      ? '#fff1f0'
+                      : '#fafafa',
+                border: `1px solid ${
+                  feedback.status === 'adopted'
+                    ? '#b7eb8f'
+                    : feedback.status === 'rejected'
+                      ? '#ffccc7'
+                      : '#f0f0f0'
+                }`,
+                borderRadius: 8,
+                padding: 12,
+              }}
+            >
+              <div>
+                状态:{statusTag(feedback.status)}
+                {feedback.reviewed_at ? (
+                  <Text type="secondary"> · {formatUtcTime(feedback.reviewed_at)}</Text>
+                ) : null}
+              </div>
+              {feedback.status === 'adopted' && (
+                <div style={{ marginTop: 6 }}>
+                  奖励金币:<b>{feedback.reward_coins ?? 0}</b>
+                </div>
+              )}
+              {feedback.status === 'rejected' && (
+                <div style={{ marginTop: 6 }}>
+                  未采纳原因(用户可见):
+                  {feedback.reject_reason || <Text type="secondary">（无）</Text>}
+                </div>
+              )}
+              <div style={{ marginTop: 6 }}>
+                审核备注:{feedback.review_note || <Text type="secondary">（无）</Text>}
+              </div>
+              {isPending(feedback.status) && (
+                <div style={{ marginTop: 6 }}>
+                  <Text type="secondary">仅 operator / super_admin 可审核</Text>
+                </div>
+              )}
+            </div>
+          )}
+
+          {/* 待审核:采纳 / 拒绝表单 */}
+          {editable && (
+            <div>
+              <Segmented
+                value={action}
+                onChange={(v) => setAction(v as 'approve' | 'reject')}
+                options={[
+                  { label: '采纳(发金币)', value: 'approve' },
+                  { label: '拒绝', value: 'reject' },
+                ]}
+                style={{ marginBottom: 16 }}
+              />
+              {/* preserve=false:切换采纳/拒绝时卸载的字段从 store 移除,validateFields 不误校验另一侧 */}
+              <Form form={form} layout="vertical" preserve={false}>
+                {action === '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
+                        style={{ width: '100%' }}
+                        min={1}
+                        max={REWARD_MAX}
+                        placeholder="采纳后发放给用户的金币"
+                      />
+                    </Form.Item>
+                    <Form.Item
+                      name="note"
+                      label="采纳要点 / 审核备注(选填)"
+                      rules={[{ max: 256, message: '最多 256 字' }]}
+                    >
+                      <Input.TextArea rows={3} maxLength={256} showCount placeholder="如:建议已采纳,将在下个版本上线" />
+                    </Form.Item>
+                  </>
+                ) : (
+                  <>
+                    <Form.Item
+                      name="reason"
+                      label="未采纳原因(必填,用户端可见)"
+                      rules={[
+                        { required: true, message: '请填写未采纳原因' },
+                        { max: 256, message: '最多 256 字' },
+                      ]}
+                    >
+                      <Input.TextArea rows={3} maxLength={256} showCount placeholder="向用户说明为何未采纳" />
+                    </Form.Item>
+                    <Form.Item
+                      name="note"
+                      label="内部备注(选填,用户不可见)"
+                      rules={[{ max: 256, message: '最多 256 字' }]}
+                    >
+                      <Input.TextArea rows={2} maxLength={256} showCount placeholder="运营内部备注" />
+                    </Form.Item>
+                  </>
+                )}
+              </Form>
+            </div>
+          )}
+
+          {/* 该用户历史反馈 */}
+          <div>
+            <Text strong>该用户历史反馈{others.length ? `（${others.length}）` : ''}</Text>
+            {loadingHistory ? (
+              <Spin style={{ display: 'block', margin: '16px 0' }} />
+            ) : others.length === 0 ? (
+              <div style={{ marginTop: 8 }}>
+                <Text type="secondary">该用户暂无其它反馈</Text>
+              </div>
+            ) : (
+              <Space direction="vertical" size={8} style={{ width: '100%', marginTop: 8 }}>
+                {others.map((h) => (
+                  <div
+                    key={h.id}
+                    style={{ border: '1px solid #f0f0f0', borderRadius: 8, padding: 10 }}
+                  >
+                    <div style={{ display: 'flex', justifyContent: 'space-between' }}>
+                      <Text type="secondary">
+                        #{h.id} · {formatUtcTime(h.created_at)}
+                      </Text>
+                      {statusTag(h.status)}
+                    </div>
+                    <Paragraph
+                      style={{ whiteSpace: 'pre-wrap', margin: '6px 0 0' }}
+                      ellipsis={{ rows: 2, expandable: true, symbol: '展开' }}
+                    >
+                      {h.content || '-'}
+                    </Paragraph>
+                    {h.status === 'adopted' && (
+                      <Text type="secondary" style={{ fontSize: 12 }}>
+                        采纳 · 奖励 {h.reward_coins ?? 0} 金币
+                        {h.review_note ? ` · ${h.review_note}` : ''}
+                      </Text>
+                    )}
+                    {h.status === 'rejected' && (
+                      <Text type="secondary" style={{ fontSize: 12 }}>
+                        未采纳:{h.reject_reason || '-'}
+                      </Text>
+                    )}
+                  </div>
+                ))}
+              </Space>
+            )}
+          </div>
+        </Space>
+      )}
+    </Drawer>
+  );
+}

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

@@ -0,0 +1,273 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import { Button, Card, Image, Input, 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 { FeedbackQrConfig as QrConfig } from '@/lib/types';
+
+const { Text } = Typography;
+
+const ACCEPT = ['image/jpeg', 'image/png', 'image/webp'];
+
+/** 反馈页「加群二维码」卡配置。改完 App 意见反馈页下次进入即同步。「反馈工单」页的一个区块。 */
+export default function FeedbackQrConfig() {
+  const [cfg, setCfg] = useState<QrConfig | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [saving, setSaving] = useState(false);
+  const [uploading, setUploading] = useState(false);
+
+  // 本地编辑态(文案 + 开关),保存时一次性 PATCH
+  const [enabled, setEnabled] = useState(true);
+  const [title, setTitle] = useState('');
+  const [groupName, setGroupName] = useState('');
+  const [subtitle, setSubtitle] = useState('');
+
+  const canEdit = canDo(['operator']);
+
+  const sync = (c: QrConfig) => {
+    setCfg(c);
+    setEnabled(c.enabled);
+    setTitle(c.title);
+    setGroupName(c.group_name);
+    setSubtitle(c.subtitle);
+  };
+
+  const load = async () => {
+    setLoading(true);
+    try {
+      const { data } = await api.get<QrConfig>('/admin/api/feedback-config');
+      sync(data);
+    } finally {
+      setLoading(false);
+    }
+  };
+  useEffect(() => {
+    load();
+  }, []);
+
+  const save = async () => {
+    if (!title.trim() || !groupName.trim() || !subtitle.trim()) {
+      message.warning('三行文案都需填写');
+      return;
+    }
+    setSaving(true);
+    try {
+      const { data } = await api.patch<QrConfig>('/admin/api/feedback-config', {
+        enabled,
+        title: title.trim(),
+        group_name: groupName.trim(),
+        subtitle: subtitle.trim(),
+      });
+      sync(data);
+      message.success('已保存，App 反馈页下次进入即可见');
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setSaving(false);
+    }
+  };
+
+  // antd Upload:beforeUpload 里自行 POST(multipart),返回 false 阻止其默认上传。
+  const beforeUpload = (file: File) => {
+    if (!ACCEPT.includes(file.type)) {
+      message.error('仅支持 JPEG / PNG / WebP 图片');
+      return Upload.LIST_IGNORE;
+    }
+    if (file.size > 5 * 1024 * 1024) {
+      message.error('图片不能超过 5MB');
+      return Upload.LIST_IGNORE;
+    }
+    void uploadImage(file);
+    return false;
+  };
+
+  const uploadImage = async (file: File) => {
+    const form = new FormData();
+    form.append('file', file);
+    setUploading(true);
+    try {
+      const { data } = await api.post<QrConfig>('/admin/api/feedback-config/image', form);
+      sync(data);
+      message.success('二维码已更新，App 反馈页下次进入即可见');
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setUploading(false);
+    }
+  };
+
+  const removeImage = async () => {
+    setUploading(true);
+    try {
+      const { data } = await api.delete<QrConfig>('/admin/api/feedback-config/image');
+      sync(data);
+      message.success('已移除二维码，App 将显示本地兜底图');
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setUploading(false);
+    }
+  };
+
+  return (
+    <Card
+      size="small"
+      title="反馈页二维码卡（App 意见反馈页底部）"
+      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 }}>
+        改这里的二维码、文案、显隐，App 意见反馈页底部那张「加群二维码」卡会同步（用户下次进入反馈页生效）。
+        每次改动进审计日志。
+      </p>
+      {loading || !cfg ? (
+        <Spin style={{ display: 'block', margin: '24px 0' }} />
+      ) : (
+        <Space align="start" size={32} wrap>
+          {/* 左：所见即所得预览(对齐 App 卡片布局) */}
+          <div>
+            <Text type="secondary" style={{ fontSize: 12 }}>
+              App 实际效果预览
+            </Text>
+            <div
+              style={{
+                marginTop: 8,
+                width: 320,
+                display: 'flex',
+                gap: 14,
+                alignItems: 'center',
+                padding: 14,
+                border: '1px solid #f0f0f0',
+                borderRadius: 14,
+                boxShadow: '0 1px 4px rgba(0,0,0,0.06)',
+                opacity: enabled ? 1 : 0.4,
+              }}
+            >
+              {cfg.image_url ? (
+                <Image
+                  src={mediaUrl(cfg.image_url)}
+                  width={88}
+                  height={88}
+                  style={{ objectFit: 'cover', borderRadius: 8, border: '1px solid #f0f0f0' }}
+                />
+              ) : (
+                <div
+                  style={{
+                    width: 88,
+                    height: 88,
+                    borderRadius: 8,
+                    border: '1px dashed #d9d9d9',
+                    display: 'flex',
+                    alignItems: 'center',
+                    justifyContent: 'center',
+                    color: '#bbb',
+                    fontSize: 12,
+                    textAlign: 'center',
+                    flexShrink: 0,
+                  }}
+                >
+                  本地兜底图
+                </div>
+              )}
+              <div style={{ fontSize: 13, color: '#1a1a1a', lineHeight: '21px' }}>
+                <div>{title || '（标题）'}</div>
+                <div>
+                  直通
+                  <b>「{groupName || '群名'}」</b>
+                </div>
+                <div>{subtitle || '（标语）'}</div>
+              </div>
+            </div>
+            {!enabled && (
+              <div style={{ color: '#fa8c16', fontSize: 12, marginTop: 6 }}>
+                当前为「隐藏」：App 反馈页不显示这张卡
+              </div>
+            )}
+          </div>
+
+          {/* 右：编辑控件 */}
+          <Space direction="vertical" size="middle" style={{ minWidth: 320 }}>
+            <Space>
+              <span>显示该卡片：</span>
+              <Switch checked={enabled} disabled={!canEdit} onChange={setEnabled} />
+              {!enabled && <Tag color="orange">已隐藏</Tag>}
+            </Space>
+
+            <Space wrap>
+              <Upload accept="image/*" showUploadList={false} beforeUpload={beforeUpload} disabled={!canEdit}>
+                <Button icon={<UploadOutlined />} loading={uploading} disabled={!canEdit}>
+                  {cfg.image_url ? '更换二维码' : '上传二维码'}
+                </Button>
+              </Upload>
+              {cfg.image_url && (
+                <Button
+                  icon={<DeleteOutlined />}
+                  danger
+                  loading={uploading}
+                  disabled={!canEdit}
+                  onClick={removeImage}
+                >
+                  移除二维码
+                </Button>
+              )}
+              <Text type="secondary" style={{ fontSize: 12 }}>
+                JPEG/PNG/WebP，≤5MB
+              </Text>
+            </Space>
+
+            <div>
+              <Text type="secondary" style={{ fontSize: 12 }}>
+                第一行（操作提示）
+              </Text>
+              <Input
+                value={title}
+                maxLength={40}
+                disabled={!canEdit}
+                onChange={(e) => setTitle(e.target.value)}
+                placeholder="如：长按图片保存二维码"
+              />
+            </div>
+            <div>
+              <Text type="secondary" style={{ fontSize: 12 }}>
+                第二行加粗群名（App 显示为：直通「群名」）
+              </Text>
+              <Input
+                value={groupName}
+                maxLength={40}
+                disabled={!canEdit}
+                onChange={(e) => setGroupName(e.target.value)}
+                placeholder="如：傻瓜比价官方群"
+              />
+            </div>
+            <div>
+              <Text type="secondary" style={{ fontSize: 12 }}>
+                第三行（标语）
+              </Text>
+              <Input
+                value={subtitle}
+                maxLength={60}
+                disabled={!canEdit}
+                onChange={(e) => setSubtitle(e.target.value)}
+                placeholder="如：一起唠嗑共创、解锁新玩法"
+              />
+            </div>
+
+            <Button type="primary" loading={saving} disabled={!canEdit} onClick={save}>
+              保存文案 / 开关
+            </Button>
+            {!canEdit && <Text type="secondary">仅 operator / super_admin 可修改</Text>}
+          </Space>
+        </Space>
+      )}
+    </Card>
+  );
+}

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

@@ -2,54 +2,202 @@
 
 import { useState } from 'react';
 import type { ColumnsType } from 'antd/es/table';
-import { Button, Select, Space, Table, Tag, message } from 'antd';
-import { api, errMsg } from '@/lib/api';
+import type { SorterResult } from 'antd/es/table/interface';
+import {
+  Button,
+  DatePicker,
+  Image,
+  Input,
+  Select,
+  Space,
+  Table,
+  Tag,
+  Typography,
+} from 'antd';
+import type { Dayjs } from 'dayjs';
 import { canDo } from '@/lib/auth';
-import { useCursorList } from '@/lib/useCursorList';
+import { formatUtcTime } from '@/lib/format';
+import { usePagedList } from '@/lib/usePagedList';
 import type { Feedback } from '@/lib/types';
+import FeedbackQrConfig from './FeedbackQrConfig';
+import FeedbackHandleDrawer from './FeedbackHandleDrawer';
 
-const dt = (v: string) => new Date(v).toLocaleString('zh-CN');
+const { Text, Paragraph } = Typography;
+const { RangePicker } = DatePicker;
+
+// 截图是 app-server 的 /media 相对路径,本地由 :8770 提供(NEXT_PUBLIC_MEDIA_BASE);生产同域走 nginx 代理。
+const MEDIA_BASE = process.env.NEXT_PUBLIC_MEDIA_BASE || '';
+const mediaUrl = (p: string) => (p.startsWith('http') ? p : MEDIA_BASE + p);
+
+type SortField = 'id' | 'created_at';
+
+// 待审核(同事后端初始态 pending;兼容历史 new 数据)
+const isPending = (s: string) => s === 'pending' || s === 'new';
+
+const STATUS_META: Record<string, { label: string; color: string }> = {
+  pending: { label: '审核中', color: 'orange' },
+  new: { label: '待审核', color: 'orange' },
+  adopted: { label: '已采纳', color: 'green' },
+  rejected: { label: '未采纳', color: 'red' },
+};
 
 export default function FeedbacksPage() {
+  // 筛选草稿:点「查询」才应用(避免输入即刷新)
   const [status, setStatus] = useState<string | undefined>();
-  const [filters, setFilters] = useState<Record<string, unknown>>({});
-  const { items, nextCursor, loading, loadMore, reload } = useCursorList<Feedback>(
-    '/admin/api/feedbacks',
-    filters,
-  );
-  const canHandle = canDo(['operator']);
+  const [userId, setUserId] = useState('');
+  const [content, setContent] = useState('');
+  const [createdRange, setCreatedRange] = useState<[Dayjs, Dayjs] | null>(null);
+  const [applied, setApplied] = useState<Record<string, unknown>>({});
+  // 排序(服务端):点列头即时生效,与「查询」按钮分开
+  const [sortBy, setSortBy] = useState<SortField>('id');
+  const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc');
 
-  const handle = async (f: Feedback) => {
-    try {
-      await api.post(`/admin/api/feedbacks/${f.id}/handle`);
-      message.success('已标记处理');
-      reload();
-    } catch (e) {
-      message.error(errMsg(e));
+  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 canReview = canDo(['operator']);
+
+  // 审核/查看抽屉(采纳发金币 / 拒绝填原因 + 看该用户历史反馈)
+  const [drawerFb, setDrawerFb] = useState<Feedback | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+  const openDrawer = (f: Feedback) => {
+    setDrawerFb(f);
+    setDrawerOpen(true);
+  };
+
+  const search = () =>
+    setApplied({
+      status,
+      user_id: userId.trim() ? Number(userId.trim()) : undefined,
+      content: content.trim() || undefined,
+      created_from: createdRange?.[0] ? createdRange[0].startOf('day').toISOString() : undefined,
+      created_to: createdRange?.[1] ? createdRange[1].endOf('day').toISOString() : undefined,
+    });
+
+  const resetFilters = () => {
+    setStatus(undefined);
+    setUserId('');
+    setContent('');
+    setCreatedRange(null);
+    setSortBy('id');
+    setSortOrder('desc');
+    setApplied({});
+  };
+
+  const onTableChange = (
+    _pagination: unknown,
+    _filters: unknown,
+    sorter: SorterResult<Feedback> | SorterResult<Feedback>[],
+  ) => {
+    const s = Array.isArray(sorter) ? sorter[0] : sorter;
+    if (s && s.order && s.field) {
+      setSortBy(s.field as SortField);
+      setSortOrder(s.order === 'ascend' ? 'asc' : 'desc');
+    } else {
+      setSortBy('id');
+      setSortOrder('desc');
     }
   };
 
+  const sortOrderOf = (field: SortField) =>
+    sortBy === field ? (sortOrder === 'asc' ? 'ascend' : 'descend') : null;
+
   const columns: ColumnsType<Feedback> = [
-    { title: 'ID', dataIndex: 'id', width: 70 },
+    { title: 'ID', dataIndex: 'id', width: 70, sorter: true, sortOrder: sortOrderOf('id') },
     { title: '用户', dataIndex: 'user_id', width: 80 },
-    { title: '内容', dataIndex: 'content' },
-    { title: '联系方式', dataIndex: 'contact', width: 140 },
+    {
+      title: '内容',
+      dataIndex: 'content',
+      width: 340,
+      render: (v: string) =>
+        v ? (
+          <Paragraph
+            style={{ marginBottom: 0, whiteSpace: 'pre-wrap', wordBreak: 'break-word' }}
+            ellipsis={{ rows: 3, expandable: true, symbol: '展开', tooltip: true }}
+          >
+            {v}
+          </Paragraph>
+        ) : (
+          <Text type="secondary">-</Text>
+        ),
+    },
+    {
+      title: '截图',
+      dataIndex: 'images',
+      width: 160,
+      render: (imgs: string[] | null) =>
+        imgs && imgs.length ? (
+          <Image.PreviewGroup>
+            <Space size={4} wrap>
+              {imgs.map((src, i) => (
+                <Image
+                  key={i}
+                  src={mediaUrl(src)}
+                  width={44}
+                  height={44}
+                  style={{ objectFit: 'cover', borderRadius: 4 }}
+                />
+              ))}
+            </Space>
+          </Image.PreviewGroup>
+        ) : (
+          <Text type="secondary">无</Text>
+        ),
+    },
     {
       title: '状态',
       dataIndex: 'status',
       width: 90,
-      render: (s: string) => <Tag color={s === 'new' ? 'orange' : 'green'}>{s}</Tag>,
+      render: (s: string) => {
+        const m = STATUS_META[s] ?? { label: s, color: 'default' };
+        return <Tag color={m.color}>{m.label}</Tag>;
+      },
+    },
+    {
+      title: '审核结果',
+      key: 'review',
+      width: 170,
+      render: (_: unknown, f: Feedback) => {
+        if (f.status === 'adopted') {
+          return (
+            <Space direction="vertical" size={0}>
+              <Tag color="gold">+{f.reward_coins ?? 0} 金币</Tag>
+              {f.review_note ? (
+                <Text type="secondary" style={{ fontSize: 12 }} ellipsis>
+                  {f.review_note}
+                </Text>
+              ) : null}
+            </Space>
+          );
+        }
+        if (f.status === 'rejected') {
+          return (
+            <Text type="secondary" style={{ fontSize: 12 }} ellipsis>
+              未采纳:{f.reject_reason || '-'}
+            </Text>
+          );
+        }
+        return <Text type="secondary">-</Text>;
+      },
+    },
+    {
+      title: '时间',
+      dataIndex: 'created_at',
+      width: 170,
+      sorter: true,
+      sortOrder: sortOrderOf('created_at'),
+      render: (v: string) => formatUtcTime(v),
     },
-    { title: '时间', dataIndex: 'created_at', render: dt, width: 180 },
     {
       title: '操作',
       key: 'op',
-      width: 100,
+      width: 90,
       render: (_: unknown, f: Feedback) =>
-        canHandle && f.status === 'new' ? (
-          <a onClick={() => handle(f)}>标记处理</a>
+        canReview && isPending(f.status) ? (
+          <a onClick={() => openDrawer(f)}>审核</a>
         ) : (
-          <span style={{ color: '#ccc' }}>-</span>
+          <a onClick={() => openDrawer(f)}>查看</a>
         ),
     },
   ];
@@ -57,28 +205,70 @@ export default function FeedbacksPage() {
   return (
     <div>
       <h2>反馈工单</h2>
-      <Space style={{ marginBottom: 16 }}>
+      <FeedbackQrConfig />
+      <Space style={{ marginBottom: 16 }} wrap>
         <Select
           placeholder="状态"
           value={status}
-          onChange={(v) => {
-            setStatus(v);
-            setFilters({ status: v });
-          }}
+          onChange={setStatus}
           allowClear
-          style={{ width: 140 }}
+          style={{ width: 120 }}
           options={[
-            { value: 'new', label: '待处理' },
-            { value: 'handled', label: '已处理' },
+            { value: 'pending', label: '审核中' },
+            { value: 'adopted', label: '已采纳' },
+            { value: 'rejected', label: '未采纳' },
           ]}
         />
-      </Space>
-      <Table rowKey="id" columns={columns} dataSource={items} loading={loading} pagination={false} />
-      <div style={{ marginTop: 16, textAlign: 'center' }}>
-        <Button onClick={loadMore} disabled={!nextCursor} loading={loading}>
-          {nextCursor ? '加载更多' : '没有更多了'}
+        <Input
+          placeholder="用户ID"
+          value={userId}
+          onChange={(e) => setUserId(e.target.value.replace(/\D/g, ''))}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 120 }}
+        />
+        <Input
+          placeholder="内容(模糊)"
+          value={content}
+          onChange={(e) => setContent(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 180 }}
+        />
+        <RangePicker
+          placeholder={['提交起', '提交止']}
+          value={createdRange}
+          onChange={(v) => setCreatedRange(v as [Dayjs, Dayjs] | null)}
+          allowClear
+        />
+        <Button type="primary" onClick={search}>
+          查询
         </Button>
-      </div>
+        <Button onClick={resetFilters}>重置</Button>
+      </Space>
+
+      <Table
+        rowKey="id"
+        columns={columns}
+        dataSource={items}
+        loading={loading}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 条反馈`,
+          onChange: onPageChange,
+        }}
+        onChange={onTableChange}
+      />
+
+      <FeedbackHandleDrawer
+        feedback={drawerFb}
+        open={drawerOpen}
+        onClose={() => setDrawerOpen(false)}
+        onDone={reload}
+      />
     </div>
   );
 }

src/app/(main)/layout.tsx

@@ -3,15 +3,20 @@
 import { useEffect, useState } from 'react';
 import { usePathname, useRouter } from 'next/navigation';
 import {
+  BarChartOutlined,
   DashboardOutlined,
+  DatabaseOutlined,
   FileSearchOutlined,
   FlagOutlined,
-  FundProjectionScreenOutlined,
+  HeartOutlined,
   LogoutOutlined,
   MessageOutlined,
   MobileOutlined,
   MoneyCollectOutlined,
+  NotificationOutlined,
+  ProfileOutlined,
   SettingOutlined,
+  ShareAltOutlined,
   TeamOutlined,
   UserOutlined,
 } from '@ant-design/icons';
@@ -25,12 +30,17 @@ const MENU = [
   { key: '/dashboard', icon: <DashboardOutlined />, label: '数据大盘' },
   { key: '/users', icon: <UserOutlined />, label: '用户管理' },
   { key: '/devices', icon: <MobileOutlined />, label: '设备管理' },
+  { key: '/device-liveness', icon: <HeartOutlined />, label: '设备存活' },
   { key: '/withdraws', icon: <MoneyCollectOutlined />, label: '提现管理' },
   { key: '/price-reports', icon: <FlagOutlined />, label: '上报审核' },
+  { key: '/comparison-records', icon: <ProfileOutlined />, label: '比价记录' },
   { key: '/feedbacks', icon: <MessageOutlined />, label: '反馈工单' },
-  { key: '/ad-audit', icon: <FundProjectionScreenOutlined />, label: '金币审计' },
+  { key: '/ad-revenue', icon: <NotificationOutlined />, label: '广告配置' },
+  { key: '/ad-revenue-report', icon: <BarChartOutlined />, label: '广告收益' },
+  { key: '/cps', icon: <ShareAltOutlined />, label: 'CPS 分发' },
   { key: '/config', icon: <SettingOutlined />, label: '系统配置' },
   { key: '/admins', icon: <TeamOutlined />, label: '管理员', superOnly: true },
+  { key: '/event-logs', icon: <DatabaseOutlined />, label: '埋点日志' },
   { key: '/audit-logs', icon: <FileSearchOutlined />, label: '审计日志' },
 ];
 

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

@@ -2,6 +2,7 @@
 
 import { useEffect, useState } from 'react';
 import {
+  App,
   Button,
   Card,
   Image,
@@ -13,14 +14,14 @@ import {
   Tabs,
   Tag,
   Typography,
-  message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import { CheckCircleOutlined, CloseCircleOutlined } from '@ant-design/icons';
 import dayjs from 'dayjs';
 import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
-import { useCursorList } from '@/lib/useCursorList';
+import { mediaUrl } from '@/lib/media';
+import { usePagedList } from '@/lib/usePagedList';
 import type { PriceReport, PriceReportSummary } from '@/lib/types';
 
 const { Text } = Typography;
@@ -30,9 +31,7 @@ const { Text } = Typography;
 const dt = (v: string | null) => (v ? dayjs(v).format('YYYY-MM-DD HH:mm') : '-');
 const yuan = (c: number | null) => (c == null ? '-' : `¥${(c / 100).toFixed(2)}`);
 
-// 截图是 app-server 的 /media 相对路径,本地由 :8770 提供(NEXT_PUBLIC_MEDIA_BASE);生产同域走 nginx 代理。
-const MEDIA_BASE = process.env.NEXT_PUBLIC_MEDIA_BASE || '';
-const mediaUrl = (p: string) => (p.startsWith('http') ? p : MEDIA_BASE + p);
+// 截图 URL 解析见 @/lib/media(dev 指向 :8770,生产走 nginx /media 同域反代)。
 
 const STATUS_COLOR: Record<string, string> = {
   pending: 'gold',
@@ -57,6 +56,7 @@ function statusTag(status: string) {
 }
 
 export default function PriceReportsPage() {
+  const { message, modal } = App.useApp();
   const [activeStatus, setActiveStatus] = useState('pending');
   const [summary, setSummary] = useState<PriceReportSummary | null>(null);
   const [rejecting, setRejecting] = useState<PriceReport | null>(null);
@@ -65,10 +65,8 @@ export default function PriceReportsPage() {
   const filters: Record<string, unknown> = {};
   if (activeStatus !== 'all') filters.status = activeStatus;
 
-  const { items, nextCursor, loading, loadMore, reload } = useCursorList<PriceReport>(
-    '/admin/api/price-reports',
-    filters,
-  );
+  const { items, total, page, pageSize, loading, onChange: onPageChange, reload } =
+    usePagedList<PriceReport>('/admin/api/price-reports', filters);
 
   const canReview = canDo(['operator']);
 
@@ -90,7 +88,7 @@ export default function PriceReportsPage() {
   };
 
   const approve = (r: PriceReport) => {
-    Modal.confirm({
+    modal.confirm({
       title: '确认通过该上报?',
       icon: <CheckCircleOutlined style={{ color: '#52c41a' }} />,
       content: (
@@ -277,14 +275,16 @@ export default function PriceReportsPage() {
           columns={columns}
           dataSource={items}
           loading={loading}
-          pagination={false}
+          pagination={{
+            current: page,
+            pageSize,
+            total,
+            showSizeChanger: true,
+            showTotal: (t) => `共 ${t} 条`,
+            onChange: onPageChange,
+          }}
           scroll={{ x: 1100 }}
         />
-        <div style={{ marginTop: 16, textAlign: 'center' }}>
-          <Button onClick={loadMore} disabled={!nextCursor} loading={loading}>
-            {nextCursor ? '加载更多' : '没有更多了'}
-          </Button>
-        </div>
       </Card>
 
       <Modal

src/app/(main)/users/[id]/page.tsx

@@ -4,11 +4,11 @@ import { useCallback, useEffect, useState } from 'react';
 import { useParams } from 'next/navigation';
 import type { ColumnsType } from 'antd/es/table';
 import {
+  App,
   Button,
   Card,
   Col,
   Descriptions,
-  Modal,
   Result,
   Row,
   Space,
@@ -17,7 +17,6 @@ import {
   Table,
   Tabs,
   Tag,
-  message,
 } from 'antd';
 import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
@@ -27,6 +26,7 @@ import { AdjustCashModal, AdjustCoinModal } from '@/components/AdjustBalanceModa
 import type { CashTxn, CoinTxn, UserOverview, WithdrawOrder } from '@/lib/types';
 
 export default function UserDetailPage() {
+  const { message, modal } = App.useApp();
   const params = useParams<{ id: string }>();
   const uid = Number(params.id);
   const [data, setData] = useState<UserOverview | null>(null);
@@ -56,7 +56,7 @@ export default function UserDetailPage() {
   const toggleStatus = () => {
     if (!data) return;
     const next = data.user.status === 'active' ? 'disabled' : 'active';
-    Modal.confirm({
+    modal.confirm({
       title: `确认${next === 'disabled' ? '封禁' : '解封'}用户 ${data.user.phone}?`,
       onOk: async () => {
         try {

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

@@ -5,12 +5,12 @@ import type { Key } from 'react';
 import { useRouter } from 'next/navigation';
 import type { ColumnsType } from 'antd/es/table';
 import type { SorterResult } from 'antd/es/table/interface';
-import { Button, DatePicker, Input, Modal, Select, Space, Table, Tag, message } from 'antd';
+import { App, Button, DatePicker, Input, Select, Space, Table, Tag } from 'antd';
 import dayjs, { type Dayjs } from 'dayjs';
 import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
 import { formatUtcTime } from '@/lib/format';
-import { useCursorList } from '@/lib/useCursorList';
+import { usePagedList } from '@/lib/usePagedList';
 import { AdjustCashModal, AdjustCoinModal } from '@/components/AdjustBalanceModals';
 import type { UserListItem } from '@/lib/types';
 
@@ -22,6 +22,7 @@ type SortField = 'id' | 'created_at' | 'last_login_at';
 
 export default function UsersPage() {
   const router = useRouter();
+  const { message, modal } = App.useApp();
 
   // 筛选草稿:点「查询」才应用(避免输入即刷新);状态/渠道/日期一并随查询提交
   const [phone, setPhone] = useState('');
@@ -37,10 +38,8 @@ export default function UsersPage() {
 
   const filters: Record<string, unknown> = { ...applied, sort_by: sortBy, sort_order: sortOrder };
   const filterKey = JSON.stringify(filters);
-  const { items, nextCursor, loading, loadMore, reload } = useCursorList<UserListItem>(
-    '/admin/api/users',
-    filters,
-  );
+  const { items, total, page, pageSize, loading, onChange: onPageChange, reload } =
+    usePagedList<UserListItem>('/admin/api/users', filters);
 
   const canCoins = canDo(['finance']);
   const canStatus = canDo(['operator']);
@@ -99,7 +98,7 @@ export default function UsersPage() {
 
   const toggleStatus = (u: UserListItem) => {
     const next = u.status === 'active' ? 'disabled' : 'active';
-    Modal.confirm({
+    modal.confirm({
       title: `确认${next === 'disabled' ? '封禁' : '解封'}用户 ${u.phone}?`,
       onOk: async () => {
         try {
@@ -115,7 +114,7 @@ export default function UsersPage() {
 
   const toggleDebugTrace = (u: UserListItem) => {
     const next = !u.debug_trace_enabled;
-    Modal.confirm({
+    modal.confirm({
       title: `确认${next ? '开启' : '关闭'}用户 ${u.phone} 的调试链接权限?`,
       content: next
         ? '开启后,该用户在 App 比价结果页/记录页可复制 trace 调试链接发给开发排障'
@@ -132,6 +131,28 @@ export default function UsersPage() {
     });
   };
 
+  // 一次性操作:点一下把该用户标记为「未看过引导」,下次打开 App 重看一遍,看完后端自动恢复(只触发这一次)。
+  // 用户尚未重看前可「撤销」(把 force_onboarding 置回 false),纠正误点。
+  const setForceOnboarding = (u: UserListItem, enable: boolean) => {
+    modal.confirm({
+      title: enable
+        ? `确认让用户 ${u.phone} 重看一次新手引导?`
+        : `撤销用户 ${u.phone} 的「重看新手引导」?`,
+      content: enable
+        ? '点一下即把该用户标记为「未看过引导」:Ta 下次打开 App 会重走一遍新手引导,看完自动恢复——只触发这一次。仅对已支持该功能的 App 版本生效。'
+        : '该用户尚未重看,撤销后下次打开 App 不再触发。',
+      onOk: async () => {
+        try {
+          await api.post(`/admin/api/users/${u.id}/force-onboarding`, { enabled: enable });
+          message.success(enable ? '已开启:该用户下次打开 App 会重看一次' : '已撤销');
+          reload();
+        } catch (e) {
+          message.error(errMsg(e));
+        }
+      },
+    });
+  };
+
   const selectedUsers = items.filter((u) => selectedRowKeys.includes(u.id));
   const selectedActive = selectedUsers.filter((u) => u.status === 'active');
   const selectedDisabled = selectedUsers.filter((u) => u.status === 'disabled');
@@ -158,7 +179,7 @@ export default function UsersPage() {
       message.warning(`没有可${target === 'disabled' ? '封禁(active)' : '解封(disabled)'}的选中用户`);
       return;
     }
-    Modal.confirm({
+    modal.confirm({
       title: `确认${label} ${targets.length} 个用户?`,
       content: target === 'disabled' ? '仅对选中的 active 用户生效' : '仅对选中的 disabled 用户生效',
       okButtonProps: { danger: target === 'disabled' },
@@ -179,7 +200,7 @@ export default function UsersPage() {
       message.warning('没有需要变更的选中用户');
       return;
     }
-    Modal.confirm({
+    modal.confirm({
       title: `确认${label} ${targets.length} 个用户?`,
       onOk: () =>
         runBulk(targets, label, (u) =>
@@ -190,8 +211,14 @@ export default function UsersPage() {
 
   const columns: ColumnsType<UserListItem> = [
     { title: 'ID', dataIndex: 'id', width: 80, sorter: true, sortOrder: sortOrderOf('id') },
-    { title: '手机号', dataIndex: 'phone' },
-    { title: '昵称', dataIndex: 'nickname', render: (v: string | null) => v || '-' },
+    { title: '手机号', dataIndex: 'phone', width: 130 },
+    {
+      title: '昵称',
+      dataIndex: 'nickname',
+      width: 150,
+      ellipsis: true,
+      render: (v: string | null) => v || '-',
+    },
     { title: '渠道', dataIndex: 'register_channel', width: 90 },
     {
       title: '状态',
@@ -219,9 +246,9 @@ export default function UsersPage() {
       title: '操作',
       key: 'op',
       fixed: 'right',
-      width: 230,
+      width: 300,
       render: (_: unknown, u: UserListItem) => (
-        <Space onClick={(e) => e.stopPropagation()}>
+        <Space wrap={false} onClick={(e) => e.stopPropagation()}>
           <a onClick={() => router.push(`/users/${u.id}`)}>详情</a>
           {canCoins && <a onClick={() => setCoinUser(u)}>调金币</a>}
           {canCoins && <a onClick={() => setCashUser(u)}>调现金</a>}
@@ -233,6 +260,15 @@ export default function UsersPage() {
               {u.debug_trace_enabled ? '关调试链接' : '开调试链接'}
             </a>
           )}
+          {canStatus &&
+            u.status !== 'deleted' &&
+            (u.force_onboarding ? (
+              <span style={{ color: '#fa8c16' }}>
+                待重看 <a onClick={() => setForceOnboarding(u, false)}>撤销</a>
+              </span>
+            ) : (
+              <a onClick={() => setForceOnboarding(u, true)}>开启新手引导</a>
+            ))}
         </Space>
       ),
     },
@@ -333,15 +369,17 @@ export default function UsersPage() {
         columns={columns}
         dataSource={items}
         loading={loading}
-        pagination={false}
-        scroll={{ x: 1100 }}
+        pagination={{
+          current: page,
+          pageSize,
+          total,
+          showSizeChanger: true,
+          showTotal: (t) => `共 ${t} 个用户`,
+          onChange: onPageChange,
+        }}
+        scroll={{ x: 1160 }}
         onChange={onTableChange}
       />
-      <div style={{ marginTop: 16, textAlign: 'center' }}>
-        <Button onClick={loadMore} disabled={!nextCursor} loading={loading}>
-          {nextCursor ? '加载更多' : '没有更多了'}
-        </Button>
-      </div>
 
       <AdjustCoinModal user={coinUser} open={!!coinUser} onClose={() => setCoinUser(null)} />
       <AdjustCashModal user={cashUser} open={!!cashUser} onClose={() => setCashUser(null)} />

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

@@ -0,0 +1,222 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
+import {
+  DatePicker,
+  Descriptions,
+  Radio,
+  Space,
+  Table,
+  Tag,
+  Typography,
+  message,
+} from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import dayjs, { type Dayjs } from 'dayjs';
+import type { CursorPage, UserCoinRecord, UserRewardStats, WithdrawUserSnapshot } from '@/lib/types';
+import { api, errMsg } from '@/lib/api';
+
+const { Text } = Typography;
+const { RangePicker } = DatePicker;
+
+const yuan = (c: number) => `¥${(c / 100).toFixed(2)}`;
+// 后端时间为 UTC(无时区串补 Z),按北京时区展示(与提现列表口径一致)
+const apiTime = (v: string) => {
+  const hasTz = /(?:Z|[+-]\d{2}:?\d{2})$/i.test(v);
+  return dayjs(hasTz ? v : `${v}Z`);
+};
+const dt = (v: string) => apiTime(v).format('YYYY-MM-DD HH:mm');
+
+const SOURCE_COLOR: Record<string, string> = {
+  reward_video: 'blue',
+  signin_boost: 'cyan',
+  feed: 'purple',
+  signin: 'green',
+};
+
+const PAGE_SIZE = 10; // 金币记录每页条数
+
+interface Props {
+  userId: number;
+  user: WithdrawUserSnapshot | null;
+}
+
+/** 提现详情抽屉:用户基本信息 + 互斥时间筛选 + 看广告/提现统计区 + 金币发放记录表。 */
+export default function UserRewardPanel({ userId, user }: 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);
+  const [statsLoading, setStatsLoading] = useState(false);
+
+  const [records, setRecords] = useState<UserCoinRecord[]>([]);
+  const [page, setPage] = useState(1);
+  const [total, setTotal] = useState(0);
+  const [recordsLoading, setRecordsLoading] = useState(false);
+
+  // 时间窗口参数:注册至今=不传;自定义区间(选齐两端)=date_from/date_to。
+  const params =
+    mode === 'range' && range?.[0] && range?.[1]
+      ? {
+          date_from: range[0].startOf('day').toISOString(),
+          date_to: range[1].endOf('day').toISOString(),
+        }
+      : {};
+  const paramsKey = JSON.stringify(params);
+
+  const loadStats = useCallback(async () => {
+    setStatsLoading(true);
+    try {
+      const { data } = await api.get<UserRewardStats>(`/admin/api/users/${userId}/reward-stats`, {
+        params: JSON.parse(paramsKey),
+      });
+      setStats(data);
+    } catch (e) {
+      message.error(errMsg(e));
+    } finally {
+      setStatsLoading(false);
+    }
+  }, [userId, paramsKey]);
+
+  const loadRecords = useCallback(
+    async (p: number) => {
+      setRecordsLoading(true);
+      try {
+        const { data } = await api.get<CursorPage<UserCoinRecord>>(
+          `/admin/api/users/${userId}/coin-records`,
+          { params: { ...JSON.parse(paramsKey), limit: PAGE_SIZE, cursor: (p - 1) * PAGE_SIZE } },
+        );
+        setRecords(data.items);
+        setTotal(data.total ?? 0);
+      } catch (e) {
+        message.error(errMsg(e));
+      } finally {
+        setRecordsLoading(false);
+      }
+    },
+    [userId, paramsKey],
+  );
+
+  // 用户或时间筛选变化:回到第 1 页重新拉取
+  useEffect(() => {
+    loadStats();
+    setPage(1);
+    loadRecords(1);
+  }, [loadStats, loadRecords]);
+
+  const regDays = user?.created_at ? dayjs().diff(apiTime(user.created_at), 'day') : null;
+
+  const columns: ColumnsType<UserCoinRecord> = [
+    { title: '日期时间', dataIndex: 'created_at', width: 150, render: dt },
+    {
+      title: '赚取途径',
+      dataIndex: 'source_label',
+      width: 120,
+      render: (label: string, r) => <Tag color={SOURCE_COLOR[r.source] ?? 'default'}>{label}</Tag>,
+    },
+    {
+      title: 'ECPM',
+      dataIndex: 'ecpm',
+      width: 100,
+      render: (v: string | null) => v ?? <Text type="secondary">-</Text>,
+    },
+    { title: '发放金币数', dataIndex: 'coin', width: 100, render: (v: number) => <b>{v}</b> },
+  ];
+
+  return (
+    <div>
+      {/* 用户基本信息 + 互斥时间筛选(同一行) */}
+      <Space
+        wrap
+        align="center"
+        style={{ width: '100%', justifyContent: 'space-between', marginBottom: 12 }}
+      >
+        <Space size="large" wrap>
+          <span>
+            手机号 <Text strong>{user?.phone || '-'}</Text>
+          </span>
+          <span>
+            昵称 <Text strong>{user?.nickname || '-'}</Text>
+          </span>
+          <span>
+            微信昵称 <Text strong>{user?.wechat_nickname || '-'}</Text>
+          </span>
+          <span>
+            注册天数 <Text strong>{regDays != null ? `${regDays} 天` : '-'}</Text>
+          </span>
+        </Space>
+        <Space wrap>
+          <Radio.Group
+            size="small"
+            value={mode}
+            onChange={(e) => setMode(e.target.value)}
+            optionType="button"
+            buttonStyle="solid"
+          >
+            <Radio.Button value="all">注册至今</Radio.Button>
+            <Radio.Button value="range">自定义区间</Radio.Button>
+          </Radio.Group>
+          <RangePicker
+            size="small"
+            disabled={mode !== 'range'}
+            value={range}
+            onChange={(v) => setRange(v as [Dayjs, Dayjs] | null)}
+          />
+        </Space>
+      </Space>
+
+      {/* 统计区(受时间筛选;现金余额为当前快照) */}
+      <Descriptions bordered size="small" column={2} style={{ marginBottom: 8 }}>
+        <Descriptions.Item label="累计提现">
+          {stats ? yuan(stats.withdraw_success_cents) : '-'}
+        </Descriptions.Item>
+        <Descriptions.Item label="现金余额">
+          {stats ? yuan(stats.cash_balance_cents) : '-'}
+        </Descriptions.Item>
+        <Descriptions.Item label="提现总次数">{stats?.withdraw_total ?? '-'}</Descriptions.Item>
+        <Descriptions.Item label="传统任务提现">
+          {stats ? yuan(stats.traditional_task_cash_cents) : '-'}
+        </Descriptions.Item>
+        <Descriptions.Item label="累计激励视频数">
+          {stats?.reward_video_count ?? '-'}
+        </Descriptions.Item>
+        <Descriptions.Item label="平均激励视频ECPM">
+          {stats ? `${stats.reward_video_avg_ecpm} 分/千` : '-'}
+        </Descriptions.Item>
+        <Descriptions.Item label="激励视频提现">
+          {stats ? yuan(stats.reward_video_cash_cents) : '-'}
+        </Descriptions.Item>
+        <Descriptions.Item label="累计信息流广告数">{stats?.feed_count ?? '-'}</Descriptions.Item>
+        <Descriptions.Item label="平均信息流广告ECPM">
+          {stats ? `${stats.feed_avg_ecpm} 分/千` : '-'}
+        </Descriptions.Item>
+        <Descriptions.Item label="信息流广告提现">
+          {stats ? yuan(stats.feed_cash_cents) : '-'}
+        </Descriptions.Item>
+      </Descriptions>
+      <Text type="secondary" style={{ fontSize: 12 }}>
+        统计随上方时间筛选(现金余额除外,为当前快照);eCPM 单位分/千次,同金币审计。
+      </Text>
+
+      {/* 金币记录 */}
+      <h4 style={{ margin: '16px 0 8px' }}>金币记录</h4>
+      <Table
+        rowKey={(r) => `${r.source}-${r.created_at}-${r.coin}-${r.ecpm ?? ''}`}
+        size="small"
+        columns={columns}
+        dataSource={records}
+        loading={recordsLoading || statsLoading}
+        pagination={{
+          current: page,
+          pageSize: PAGE_SIZE,
+          total,
+          showSizeChanger: false,
+          onChange: (p) => {
+            setPage(p);
+            loadRecords(p);
+          },
+          showTotal: (t) => `共 ${t} 条`,
+        }}
+      />
+    </div>
+  );
+}

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

@@ -3,6 +3,7 @@
 import { useCallback, useEffect, useState } from 'react';
 import type { Key } from 'react';
 import {
+  App,
   Alert,
   Button,
   Card,
@@ -22,7 +23,6 @@ import {
   Tag,
   Timeline,
   Typography,
-  message,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
 import {
@@ -38,18 +38,19 @@ import {
 import dayjs, { type Dayjs } from 'dayjs';
 import { api, errMsg } from '@/lib/api';
 import { canDo } from '@/lib/auth';
-import { formatUtcTime, formatWallTime, utcDayjs, utcFromNow, yuan } from '@/lib/format';
-import { useCursorList } from '@/lib/useCursorList';
+import { formatUtcTime, utcDayjs, utcFromNow, yuan } from '@/lib/format';
+import { usePagedList } from '@/lib/usePagedList';
 import type {
   AuditLog,
-  CashTxn,
   WithdrawBulkResult,
   WithdrawDetail,
   WithdrawLedgerCheck,
+  WithdrawListItem,
   WithdrawOrder,
   WithdrawSummary,
   WxpayHealthCheck,
 } from '@/lib/types';
+import UserRewardPanel from './UserRewardPanel';
 
 const { Text } = Typography;
 const { RangePicker } = DatePicker;
@@ -101,19 +102,12 @@ const QUICK_FILTER_STATUS: Record<string, string> = {
 };
 const SORT_OPTIONS = [
   { value: 'created_at', label: '申请时间' },
-  { value: 'updated_at', label: '更新时间' },
   { value: 'amount_cents', label: '提现金额' },
-  { value: 'id', label: '记录 ID' },
 ];
 const DATE_FIELD_OPTIONS = [
   { value: 'created_at', label: '申请时间' },
   { value: 'updated_at', label: '更新时间' },
 ];
-const CASH_BIZ_LABEL: Record<string, string> = {
-  exchange_in: '金币兑入',
-  withdraw: '提现扣款',
-  withdraw_refund: '提现退款',
-};
 
 function statusTag(status: string) {
   return <Tag color={STATUS_COLOR[status]}>{STATUS_LABEL[status] || status}</Tag>;
@@ -155,9 +149,10 @@ function riskTags(detail: WithdrawDetail | null) {
   if (detail.user?.status && detail.user.status !== 'active') tags.push(`账号状态:${detail.user.status}`);
   if (detail.user && dayjs().diff(utcDayjs(detail.user.created_at), 'hour') < 24) tags.push('新注册用户');
   if ((detail.user?.withdraw_total || 0) >= 3) tags.push('多次提现用户');
-  if (detail.recent_withdraws.some((o) => o.status === 'rejected' || o.status === 'failed')) {
-    tags.push('历史异常单');
-  }
+  const rejectedN = detail.recent_withdraws.filter((o) => o.status === 'rejected').length;
+  const failedN = detail.recent_withdraws.filter((o) => o.status === 'failed').length;
+  if (rejectedN) tags.push(`提现拒绝${rejectedN}笔`);
+  if (failedN) tags.push(`提现失败${failedN}笔`);
   return tags;
 }
 
@@ -169,6 +164,7 @@ function bulkResultText(action: string, result: WithdrawBulkResult) {
 }
 
 export default function WithdrawsPage() {
+  const { message, modal } = App.useApp();
   const [activeStatus, setActiveStatus] = useState('reviewing');
   const [summary, setSummary] = useState<WithdrawSummary | null>(null);
   const [health, setHealth] = useState<WxpayHealthCheck | null>(null);
@@ -181,14 +177,11 @@ export default function WithdrawsPage() {
   const [bulkRejecting, setBulkRejecting] = useState<WithdrawOrder[]>([]);
   const [rejectReason, setRejectReason] = useState('');
   const [selectedRowKeys, setSelectedRowKeys] = useState<Key[]>([]);
-  const [pageSize, setPageSize] = useState(20);
   const [searchDraft, setSearchDraft] = useState('');
   const [keyword, setKeyword] = useState('');
   const [dateRange, setDateRange] = useState<[Dayjs, Dayjs] | null>(null);
   const [dateField, setDateField] = useState<'created_at' | 'updated_at'>('created_at');
-  const [sortBy, setSortBy] = useState<'created_at' | 'updated_at' | 'amount_cents' | 'id'>(
-    'created_at',
-  );
+  const [sortBy, setSortBy] = useState<'created_at' | 'amount_cents'>('created_at');
   const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc');
   const [quickFilter, setQuickFilter] = useState<string | undefined>(undefined);
 
@@ -202,11 +195,8 @@ export default function WithdrawsPage() {
   filters.sort_by = sortBy;
   filters.sort_order = sortOrder;
   const filterKey = JSON.stringify(filters);
-  const { items, nextCursor, loading, loadMore, reload } = useCursorList<WithdrawOrder>(
-    '/admin/api/withdraws',
-    filters,
-    pageSize,
-  );
+  const { items, total, page, pageSize, loading, onChange: onPageChange, reload } =
+    usePagedList<WithdrawListItem>('/admin/api/withdraws', filters, 20);
   const canManage = canDo(['finance']);
   const selectedOrders = items.filter((item) => selectedRowKeys.includes(item.id));
   const selectedReviewing = selectedOrders.filter((item) => item.status === 'reviewing');
@@ -290,7 +280,7 @@ export default function WithdrawsPage() {
 
   useEffect(() => {
     setSelectedRowKeys([]);
-  }, [filterKey, pageSize]);
+  }, [filterKey, page, pageSize]);
 
   const refreshAfterChange = async (outBillNo?: string) => {
     setSelectedRowKeys([]);
@@ -309,7 +299,7 @@ export default function WithdrawsPage() {
   };
 
   const approve = (o: WithdrawOrder) => {
-    Modal.confirm({
+    modal.confirm({
       title: `确认通过并打款 ${yuan(o.amount_cents)}?`,
       content: (
         <div>
@@ -372,7 +362,7 @@ export default function WithdrawsPage() {
     }
     const amount = selectedReviewing.reduce((sum, item) => sum + item.amount_cents, 0);
     let confirmText = '';
-    Modal.confirm({
+    modal.confirm({
       title: `确认批量通过 ${selectedReviewing.length} 笔提现?`,
       content: (
         <Space direction="vertical" style={{ width: '100%' }}>
@@ -410,7 +400,7 @@ export default function WithdrawsPage() {
       message.warning('请选择打款中的提现单');
       return;
     }
-    Modal.confirm({
+    modal.confirm({
       title: `确认批量刷新 ${selectedPending.length} 笔打款状态?`,
       content: '会逐笔向微信查单，并按最新状态归一化。',
       okText: '批量刷新查单',
@@ -432,7 +422,7 @@ export default function WithdrawsPage() {
   };
 
   const retry = (o: WithdrawOrder) => {
-    Modal.confirm({
+    modal.confirm({
       title: `重新查询 ${o.out_bill_no} 的微信状态?`,
       content: '会按微信最新状态归一化为成功、失败退款或撤销未确认。',
       okText: '刷新查单',
@@ -454,7 +444,7 @@ export default function WithdrawsPage() {
   };
 
   const reconcile = () => {
-    Modal.confirm({
+    modal.confirm({
       title: '批量对账?',
       content: '扫描超过 15 分钟仍处于打款中的提现单，逐单向微信查实并归一化。',
       okText: '开始对账',
@@ -472,37 +462,37 @@ export default function WithdrawsPage() {
     });
   };
 
-  const columns: ColumnsType<WithdrawOrder> = [
+  const columns: ColumnsType<WithdrawListItem> = [
     {
-      title: '用户',
-      dataIndex: 'user_id',
-      width: 110,
-      render: (v: number) => <Text strong>#{v}</Text>,
-    },
-    {
-      title: '提现实名',
-      dataIndex: 'user_name',
+      title: '手机号',
+      dataIndex: 'phone',
       width: 130,
-      render: (v: string | null) => v || <Text type="secondary">未填写</Text>,
+      render: (v: string | null) => v || <Text type="secondary">-</Text>,
     },
     {
-      title: '金额',
+      title: '用户昵称',
+      dataIndex: 'nickname',
+      width: 130,
+      render: (v: string | null) => v || <Text type="secondary">-</Text>,
+    },
+    {
+      title: '提现金额',
       dataIndex: 'amount_cents',
       width: 120,
       render: (v: number) => <Text strong>{yuan(v)}</Text>,
     },
+    {
+      title: '累计提现',
+      dataIndex: 'cumulative_success_cents',
+      width: 120,
+      render: (v: number) => yuan(v ?? 0),
+    },
     {
       title: '状态',
       dataIndex: 'status',
       width: 110,
       render: statusTag,
     },
-    {
-      title: '微信状态',
-      dataIndex: 'wechat_state',
-      width: 150,
-      render: (v: string | null) => v || <Text type="secondary">-</Text>,
-    },
     {
       title: '提交时间',
       dataIndex: 'created_at',
@@ -515,7 +505,7 @@ export default function WithdrawsPage() {
       ),
     },
     {
-      title: '提现单号',
+      title: '提交单号',
       dataIndex: 'out_bill_no',
       ellipsis: true,
     },
@@ -530,7 +520,7 @@ export default function WithdrawsPage() {
       key: 'op',
       fixed: 'right',
       width: 210,
-      render: (_: unknown, o: WithdrawOrder) => {
+      render: (_: unknown, o: WithdrawListItem) => {
         if (!canManage) return <Text type="secondary">-</Text>;
         if (o.status === 'reviewing') {
           return (
@@ -579,37 +569,6 @@ export default function WithdrawsPage() {
     },
   ];
 
-  const cashColumns: ColumnsType<CashTxn> = [
-    {
-      title: '类型',
-      dataIndex: 'biz_type',
-      width: 130,
-      render: (v: string) => CASH_BIZ_LABEL[v] || v,
-    },
-    {
-      title: '金额',
-      dataIndex: 'amount_cents',
-      width: 100,
-      render: (v: number) => (
-        <Text style={{ color: v < 0 ? '#cf1322' : '#389e0d' }}>
-          {v > 0 ? '+' : ''}
-          {yuan(v)}
-        </Text>
-      ),
-    },
-    { title: '余额', dataIndex: 'balance_after_cents', width: 100, render: yuan },
-    { title: '备注', dataIndex: 'remark', render: (v: string | null) => v || '-' },
-    // 现金流水是北京 wall-clock 口径,原样显示,不能当 UTC 再 +8
-    { title: '时间', dataIndex: 'created_at', width: 150, render: (v: string) => formatWallTime(v) },
-  ];
-
-  const recentWithdrawColumns: ColumnsType<WithdrawOrder> = [
-    { title: '单号', dataIndex: 'out_bill_no', ellipsis: true },
-    { title: '金额', dataIndex: 'amount_cents', width: 90, render: yuan },
-    { title: '状态', dataIndex: 'status', width: 90, render: statusTag },
-    { title: '时间', dataIndex: 'created_at', width: 150, render: dt },
-  ];
-
   const auditTimeline = detail
     ? [
         {
@@ -707,34 +666,14 @@ export default function WithdrawsPage() {
       )}
 
       <Row gutter={12} style={{ marginBottom: 16 }}>
-        <Col xs={24} sm={12} xl={5}>
+        <Col xs={24} sm={12}>
           <Card size="small">
             <Statistic title="待审核" value={summary?.reviewing_count || 0} suffix="笔" />
-            <Text type="secondary">金额 {yuan(summary?.reviewing_amount_cents || 0)}</Text>
           </Card>
         </Col>
-        <Col xs={24} sm={12} xl={5}>
+        <Col xs={24} sm={12}>
           <Card size="small">
-            <Statistic title="今日拒绝" value={summary?.today_rejected_count || 0} suffix="笔" />
-            <Text type="secondary">拒绝原因会同步给用户</Text>
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} xl={5}>
-          <Card size="small">
-            <Statistic title="打款中" value={summary?.pending_count || 0} suffix="笔" />
-            <Text type="secondary">可刷新查单</Text>
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} xl={4}>
-          <Card size="small">
-            <Statistic title="失败待处理" value={summary?.failed_count || 0} suffix="笔" />
-            <Text type="secondary">需关注退款结果</Text>
-          </Card>
-        </Col>
-        <Col xs={24} sm={12} xl={5}>
-          <Card size="small">
-            <Statistic title="今日到账" value={summary?.today_success_count || 0} suffix="笔" />
-            <Text type="secondary">金额 {yuan(summary?.today_success_amount_cents || 0)}</Text>
+            <Statistic title="待审核金额" value={yuan(summary?.reviewing_amount_cents || 0)} />
           </Card>
         </Col>
       </Row>
@@ -775,9 +714,9 @@ export default function WithdrawsPage() {
               allowClear
               enterButton="搜索"
               prefix={<SearchOutlined />}
-              placeholder="用户ID / 手机号 / 单号 / 原因"
+              placeholder="用户手机号"
               value={searchDraft}
-              style={{ width: 320 }}
+              style={{ width: 240 }}
               onChange={(e) => {
                 const value = e.target.value;
                 setSearchDraft(value);
@@ -824,9 +763,7 @@ export default function WithdrawsPage() {
               style={{ width: 130 }}
               suffixIcon={<SortAscendingOutlined />}
               options={SORT_OPTIONS}
-              onChange={(value: 'created_at' | 'updated_at' | 'amount_cents' | 'id') =>
-                setSortBy(value)
-              }
+              onChange={(value: 'created_at' | 'amount_cents') => setSortBy(value)}
             />
             <Select
               value={sortOrder}
@@ -887,31 +824,6 @@ export default function WithdrawsPage() {
             </Space>
           </Space>
         )}
-        <Space
-          wrap
-          style={{
-            width: '100%',
-            justifyContent: 'space-between',
-            marginBottom: 12,
-          }}
-        >
-          <Text type="secondary">
-            当前已加载 {items.length} 条{nextCursor ? '，还有更多' : '，已到最后一页'}
-          </Text>
-          <Space>
-            <Text type="secondary">每次加载</Text>
-            <Select
-              value={pageSize}
-              style={{ width: 96 }}
-              onChange={(value: number) => setPageSize(value)}
-              options={[
-                { value: 20, label: '20 条' },
-                { value: 50, label: '50 条' },
-                { value: 100, label: '100 条' },
-              ]}
-            />
-          </Space>
-        </Space>
         <Table
           rowKey="id"
           rowSelection={
@@ -928,23 +840,26 @@ export default function WithdrawsPage() {
           columns={columns}
           dataSource={items}
           loading={loading}
-          pagination={false}
+          pagination={{
+            current: page,
+            pageSize,
+            total,
+            showSizeChanger: true,
+            pageSizeOptions: [20, 50, 100],
+            showTotal: (t) => `共 ${t} 条`,
+            onChange: onPageChange,
+          }}
           scroll={{ x: 1350 }}
           onRow={(record) => ({
             onClick: () => openDetail(record),
             style: { cursor: 'pointer' },
           })}
         />
-        <div style={{ marginTop: 16, textAlign: 'center' }}>
-          <Button onClick={loadMore} disabled={!nextCursor} loading={loading}>
-            {nextCursor ? `继续加载 ${pageSize} 条` : '没有更多了'}
-          </Button>
-        </div>
       </Card>
 
       <Drawer
         title="提现详情"
-        width={720}
+        width="50%"
         open={drawerOpen}
         onClose={() => setDrawerOpen(false)}
         extra={
@@ -983,29 +898,10 @@ export default function WithdrawsPage() {
                 </Descriptions.Item>
               </Descriptions>
 
-              <Descriptions bordered size="small" column={2} title="用户与钱包">
-                <Descriptions.Item label="用户 ID">#{detail.order.user_id}</Descriptions.Item>
-                <Descriptions.Item label="账号状态">
-                  {detail.user ? <Tag>{detail.user.status}</Tag> : '-'}
-                </Descriptions.Item>
-                <Descriptions.Item label="手机号">{detail.user?.phone || '-'}</Descriptions.Item>
-                <Descriptions.Item label="昵称">{detail.user?.nickname || '-'}</Descriptions.Item>
-                <Descriptions.Item label="微信昵称">
-                  {detail.user?.wechat_nickname || '-'}
-                </Descriptions.Item>
-                <Descriptions.Item label="现金余额">
-                  {yuan(detail.user?.cash_balance_cents || 0)}
-                </Descriptions.Item>
-                <Descriptions.Item label="提现总次数">
-                  {detail.user?.withdraw_total ?? '-'}
-                </Descriptions.Item>
-                <Descriptions.Item label="成功提现">
-                  {yuan(detail.user?.withdraw_success_cents || 0)}
-                </Descriptions.Item>
-              </Descriptions>
+              <UserRewardPanel userId={detail.order.user_id} user={detail.user} />
 
               <div>
-                <h3>风险提示 {detail.risk_score ? <Tag color="red">{detail.risk_score}分</Tag> : null}</h3>
+                <h3>风险提示</h3>
                 {risks.length ? (
                   <Space wrap>
                     {risks.map((risk) => (
@@ -1023,28 +919,6 @@ export default function WithdrawsPage() {
                 <h3>处理时间线</h3>
                 <Timeline items={auditTimeline} />
               </div>
-
-              <div>
-                <h3>最近提现</h3>
-                <Table
-                  rowKey="id"
-                  size="small"
-                  columns={recentWithdrawColumns}
-                  dataSource={detail.recent_withdraws}
-                  pagination={false}
-                />
-              </div>
-
-              <div>
-                <h3>最近现金流水</h3>
-                <Table
-                  rowKey="id"
-                  size="small"
-                  columns={cashColumns}
-                  dataSource={detail.recent_cash_transactions}
-                  pagination={false}
-                />
-              </div>
             </Space>
           )}
         </Spin>

src/app/login/page.tsx

@@ -2,13 +2,14 @@
 
 import { useState } from 'react';
 import { useRouter } from 'next/navigation';
-import { Button, Card, Form, Input, message } from 'antd';
+import { App, Button, Card, Form, Input } from 'antd';
 import { api, errMsg } from '@/lib/api';
 import { setAuth } from '@/lib/auth';
 import type { LoginResponse } from '@/lib/types';
 
 export default function LoginPage() {
   const router = useRouter();
+  const { message } = App.useApp();
   const [loading, setLoading] = useState(false);
 
   const onFinish = async (values: { username: string; password: string }) => {

src/app/providers.tsx

@@ -5,15 +5,27 @@
 // 必须在引入 antd 之前 import。
 import '@ant-design/v5-patch-for-react-19';
 import { AntdRegistry } from '@ant-design/nextjs-registry';
-import { ConfigProvider } from 'antd';
+import { App, ConfigProvider } from 'antd';
 import zhCN from 'antd/locale/zh_CN';
 
 export function Providers({ children }: { children: React.ReactNode }) {
   return (
     <AntdRegistry>
       {/* wave 禁用:消除 antd 5 波纹在 Next15 dev 下的 React 版本兼容误报(纯噪音,后台不需要波纹) */}
-      <ConfigProvider locale={zhCN} wave={{ disabled: true }}>
-        {children}
+      {/* 全局主题:统一圆角到 8、页面底色用偏冷的浅灰,让白色卡片更有层次(全站生效) */}
+      <ConfigProvider
+        locale={zhCN}
+        wave={{ disabled: true }}
+        theme={{
+          token: {
+            borderRadius: 8,
+            colorBgLayout: '#f0f2f5',
+          },
+        }}
+      >
+        {/* antd <App> 容器:让 message/notification/Modal 能通过 App.useApp() 读到 ConfigProvider
+            的动态主题/locale,消除 "Static function can not consume context" 告警(全站生效) */}
+        <App>{children}</App>
       </ConfigProvider>
     </AntdRegistry>
   );

src/components/AdjustBalanceModals.tsx

@@ -3,7 +3,7 @@
 // 调金币 / 调现金弹窗(受控)。列表页与用户详情页共用,避免两处各写一套。
 // 每个弹窗自带「增减 / 设为指定值」两种模式;打开时拉一次 360 概览展示当前余额。
 import { useEffect, useState } from 'react';
-import { Form, Input, InputNumber, Modal, Segmented, message } from 'antd';
+import { App, Form, Input, InputNumber, Modal, Segmented } from 'antd';
 import { api, errMsg } from '@/lib/api';
 import { yuan } from '@/lib/format';
 import type { UserOverview } from '@/lib/types';
@@ -47,6 +47,7 @@ function useBalances(userId: number | undefined, open: boolean) {
 }
 
 export function AdjustCoinModal({ user, open, onClose, onDone }: ModalProps) {
+  const { message } = App.useApp();
   const [form] = Form.useForm();
   const [mode, setMode] = useState<'delta' | 'set'>('delta');
   const balances = useBalances(user?.id, open);
@@ -110,6 +111,7 @@ export function AdjustCoinModal({ user, open, onClose, onDone }: ModalProps) {
 }
 
 export function AdjustCashModal({ user, open, onClose, onDone }: ModalProps) {
+  const { message } = App.useApp();
   const [form] = Form.useForm();
   const [mode, setMode] = useState<'delta' | 'set'>('delta');
   const balances = useBalances(user?.id, open);

src/lib/media.ts

@@ -0,0 +1,12 @@
+// 媒体(上报截图 / 反馈截图 / 反馈二维码等)由 App 后端的 /media 静态服务托管,与 admin 不同域:
+//   - dev :NEXT_PUBLIC_MEDIA_BASE = http://localhost:8770(本地 App 后端)。
+//   - 生产:NEXT_PUBLIC_MEDIA_BASE = https://app-api.shaguabijia.com(线上 App 后端,/media 真正的家)。
+// 留空则退化为同域相对路径——而 admin 域(admin-web.shaguabijia.com)并不 serve /media,会 404,
+// 这正是线上后台图片打不开的根因。NEXT_PUBLIC_* 是编译期常量,改完需重新 build 才生效。
+const MEDIA_BASE = (process.env.NEXT_PUBLIC_MEDIA_BASE || '').replace(/\/+$/, ''); // 去末尾斜杠,防拼出 //media
+
+/** 把后端返回的相对媒体路径(/media/...)拼成可加载的 URL;已是 http(s) 绝对地址的原样返回。 */
+export function mediaUrl(p: string): string {
+  if (!p) return p;
+  return p.startsWith('http') ? p : MEDIA_BASE + p;
+}

src/lib/types.ts

@@ -19,6 +19,7 @@ export interface LoginResponse {
 export interface CursorPage<T> {
   items: T[];
   next_cursor: number | null;
+  total?: number | null; // offset 分页时为符合筛选条件的总条数(页码分页用);加载更多接口可能没有
 }
 
 export interface UserListItem {
@@ -29,6 +30,8 @@ export interface UserListItem {
   status: string;
   // 调试链接权限:开了的用户在 App 比价结果页/记录页可复制 price.shaguabijia.com 的 trace 调试链接
   debug_trace_enabled: boolean;
+  // 运营「一键开启新手引导」:true = 该用户下次打开 App 会被强制重走新手引导,走完自动取消
+  force_onboarding: boolean;
   wechat_openid: string | null;
   created_at: string;
   last_login_at: string;
@@ -41,6 +44,39 @@ export interface DeviceOnboardingItem {
   last_completed_at: string;
 }
 
+// 设备存活监控:device_liveness 表一行 + 后端按心跳阈值派生的在线/掉线/掉线时长。
+export interface DeviceLivenessItem {
+  id: number;
+  user_id: number;
+  phone: string | null;
+  nickname: string | null;
+  device_id: string;
+  device_model: string | null; // 由 device_id 解析的机型
+  platform: string;
+  app_version: string | null;
+  registration_id: string | null; // 非空 = 可极光推送
+  ever_protected: boolean;
+  first_protected_at: string | null; // 首次开无障碍时刻(老设备为 null)
+  last_heartbeat_at: string | null;
+  last_report_protection_on: boolean;
+  liveness_state: string; // unknown / alive / silent(当前未用) / notified
+  notified_at: string | null;
+  kill_alert_pending: boolean; // 掉线召回待客户端 ack
+  created_at: string;
+  updated_at: string;
+  // 后端派生
+  online: boolean;
+  display_state: string; // online 在线 / offline 已掉线 / never 未启用
+  offline_seconds: number | null; // 掉线时长(秒);仅 offline 有值
+}
+
+export interface DeviceLivenessStats {
+  total: number;
+  online: number;
+  offline: number;
+  never: number;
+}
+
 export interface UserOverview {
   user: UserListItem;
   coin_balance: number;
@@ -89,6 +125,14 @@ export interface WithdrawOrder {
   updated_at: string;
 }
 
+// 提现列表项:WithdrawOrder + 列表接口联表带出的用户字段。
+// 详情抽屉的 recent_withdraws 仍是裸 WithdrawOrder(无这些字段)。
+export interface WithdrawListItem extends WithdrawOrder {
+  phone: string | null;
+  nickname: string | null;
+  cumulative_success_cents: number; // 累计成功提现(分)
+}
+
 export interface WithdrawSummary {
   reviewing_count: number;
   reviewing_amount_cents: number;
@@ -123,6 +167,30 @@ export interface WithdrawDetail {
   audit_logs: AuditLog[];
 }
 
+// 提现详情抽屉「用户统计区」:按时间窗口算的提现 + 看广告行为统计。
+// *_cash_cents = 该来源累计金币折算成可提现现金(分);现金余额是当前快照不随窗口。
+export interface UserRewardStats {
+  withdraw_success_cents: number; // 累计提现
+  cash_balance_cents: number; // 现金余额(快照)
+  withdraw_total: number; // 提现总次数(全部状态)
+  traditional_task_cash_cents: number; // 传统任务提现
+  reward_video_count: number; // 累计激励视频数
+  reward_video_avg_ecpm: number; // 平均激励视频 eCPM(分/千次)
+  reward_video_cash_cents: number; // 激励视频提现
+  feed_count: number; // 累计信息流广告数(份)
+  feed_avg_ecpm: number; // 平均信息流广告 eCPM(分/千次)
+  feed_cash_cents: number; // 信息流广告提现
+}
+
+// 金币发放记录(提现详情底部表)。ecpm 为原始分/千次,非广告来源为 null。
+export interface UserCoinRecord {
+  source: string; // reward_video / signin_boost / feed / signin
+  source_label: string; // 激励视频 / 签到膨胀 / 信息流广告 / 签到
+  created_at: string;
+  ecpm: string | null;
+  coin: number;
+}
+
 export interface WithdrawBulkItemResult {
   out_bill_no: string;
   ok: boolean;
@@ -171,10 +239,27 @@ export interface Feedback {
   content: string;
   contact: string;
   images: string[] | null;
-  status: string; // new / handled
+  // pending(审核中) / adopted(已采纳) / rejected(未采纳)；历史数据可能为 new
+  status: string;
+  reject_reason: string | null; // 未采纳原因(用户端可见)
+  reward_coins: number | null; // 采纳后发放金币
+  review_note: string | null; // 审核批注(采纳要点 / 内部备注)
+  reviewed_by_admin_id: number | null;
+  reviewed_at: string | null;
   created_at: string;
 }
 
+// 反馈页「加群二维码」卡配置(运营后台改 → App 意见反馈页同步)。
+// image_url 为后端 /media 相对路径(留空=App 走本地兜底图);其余为卡片三行文案与显隐开关。
+export interface FeedbackQrConfig {
+  enabled: boolean;
+  image_url: string | null;
+  title: string; // 第一行(操作提示),如「长按图片保存二维码」
+  group_name: string; // 第二行加粗群名,App 渲染为 直通「{group_name}」
+  subtitle: string; // 第三行(标语)
+  updated_at: string | null;
+}
+
 export interface AuditLog {
   id: number;
   admin_id: number;
@@ -187,40 +272,166 @@ export interface AuditLog {
   created_at: string;
 }
 
-export interface AdCoinAuditRow {
-  scene: string; // reward_video / feed
-  record_id: number;
+// 广告收益报表聚合行下钻的单条展示明细
+// ===== 比价记录(admin debug 页)=====
+export interface ComparisonRecordListItem {
+  id: number;
   user_id: number;
+  phone: string | null;
+  nickname: string | null;
+  business_type: string;
+  trace_id: string;
+  trace_url: string | null;
+  status: string;
+  information: string | null;
+  store_name: string | null;
+  source_platform_name: string | null;
+  best_platform_name: string | null;
+  source_price_cents: number | null;
+  best_price_cents: number | null;
+  saved_amount_cents: number | null;
+  total_ms: number | null;
+  step_count: number | null;
+  llm_call_count: number | null;
+  retry_count: number | null;
+  input_tokens: number | null;
+  output_tokens: number | null;
+  device_model: string | null;
+  rom_vendor: string | null;
+  rom_name: string | null;
+  android_version: string | null;
+  app_version: string | null;
   created_at: string;
-  status: string; // granted / capped / ecpm_missing
+}
+
+// 单次 LLM 调用明细(pricebot chat() 收口落盘,server 按 trace 拉来)
+export interface LlmCall {
+  ts?: number;
+  scene: string;
+  model: string;
+  input_messages: { role: string; content: string }[];
+  output: string | null;
+  usage: { prompt_tokens?: number; completion_tokens?: number; total_tokens?: number } | null;
+  latency_ms: number | null;
+  error: string | null;
+}
+
+export interface ComparisonRecordDetail extends ComparisonRecordListItem {
+  source_platform_id: string | null;
+  source_package: string | null;
+  best_platform_id: string | null;
+  best_deeplink: string | null;
+  is_source_best: boolean | null;
+  total_dish_count: number | null;
+  skipped_dish_count: number | null;
+  device_id: string | null;
+  items: { name: string; qty?: number; specs?: string[] }[];
+  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;
+  longitude: number | null;
+  latitude: number | null;
+  llm_calls: LlmCall[] | null;
+  raw_payload: Record<string, unknown> | null;
+}
+
+export interface AdRevenueImpression {
+  id: number;
+  created_at: string;
+  ecpm: string; // 分/千次展示
+  revenue_yuan: number; // 本次展示预估收益(元)
+  adn: string | null;
+  slot_id: string | null; // 底层 mediation rit
+}
+
+// 广告收益报表聚合行下钻的单条发奖复算明细
+export interface AdRevenueRecord {
+  record_id: number;
+  created_at: string;
+  status: string; // granted / capped / ecpm_missing / too_short / closed_early
   ecpm: string | null;
-  ecpm_factor: number | null;
-  units: number;
+  ecpm_factor: number | null; // 因子1
+  units: number; // 份数
   lt_index_start: number | null;
   lt_index_end: number | null;
-  lt_factor_start: number | null;
+  lt_factor_start: number | null; // 因子2
   lt_factor_end: number | null;
   expected_coin: number;
   actual_coin: number;
   matched: boolean;
 }
 
-export interface AdCoinFormula {
-  description: string;
-  coin_per_yuan: number;
-  ecpm_unit: string;
-  feed_unit_seconds: number;
-  ecpm_factor_tiers: [number, number, number | null][];
-  lt_factor_tiers: [number, number, number | null][];
+// 广告收益报表:按日期汇总的一天(按天趋势图用;全量,不受分页影响)
+export interface AdRevenueDaily {
+  date: string; // 北京时间 YYYY-MM-DD
+  impressions: number;
+  revenue_yuan: number;
+  expected_coin: number;
+  actual_coin: number;
 }
 
-export interface AdCoinAudit {
-  date: string;
-  formula: AdCoinFormula;
-  total: number; // 全量条数(不受 limit/only_mismatch 影响)
-  mismatch_count: number; // 全量不一致条数
-  truncated: boolean; // 展示集是否被 limit 截断
-  items: AdCoinAuditRow[];
+// 广告收益报表:按北京小时(0–23)汇总的一小时(按小时趋势图用;全量,不受分页影响;按天查询时为空)
+export interface AdRevenueHourly {
+  hour: number; // 北京时间小时 0–23
+  impressions: number;
+  revenue_yuan: number;
+  expected_coin: number;
+  actual_coin: number;
+}
+
+// 广告收益报表:按广告类型(ad_type)的小计(展示条数 + 预估收益;eCPM 前端用 收益÷展示×1000 算)
+export interface AdRevenueTypeStat {
+  impressions: number; // 该类型展示条数合计
+  revenue_yuan: number; // 该类型预估收益合计(元)
+}
+
+// 广告收益报表:一次广告事件(逐条一行)。激励视频展示+发奖按 ad_session_id 合并;信息流展示/发奖各自成行。
+export interface AdRevenueRow {
+  event_key: string; // 事件稳定唯一键(前端 rowKey)
+  report_date: string; // 该事件所属日期 北京时间 YYYY-MM-DD
+  user_id: number;
+  user_phone: string | null; // 用户手机号(admin 展示;查不到为空)
+  ad_type: string; // reward_video / feed / draw
+  feed_scene?: string | null; // Draw 信息流投放场景 comparison(比价) / coupon(领券) / welfare(福利);非信息流或旧数据为 null
+  app_env: string | null; // prod(傻瓜比价) / test(测试);旧数据为空
+  our_code_id: string | null; // 我们配置的代码位 104xxx;旧数据为空
+  hour: number | null; // 北京时间小时 0–23(按小时粒度时有值;按天为 null)
+  created_at: string; // 事件时间(有展示=展示时间,纯发奖=发奖时间)
+  // ── 展示侧 ──
+  has_impression: boolean; // 是否有广告展示(信息流逐条展示=true,纯发奖行=false)
+  impressions: number; // 本行展示条数 1/0(供日汇总、趋势图复用)
+  ecpm: string | null; // 分/千次;展示行取展示值,纯发奖行取发奖采用值
+  revenue_yuan: number; // 本次展示预估收益(元);纯发奖行=0
+  adn: string | null; // 实际填充 ADN;纯发奖行为空
+  slot_id: string | null; // 底层 mediation rit;纯发奖行为空
+  // ── 发奖侧 ──
+  has_reward: boolean; // 是否有发奖(激励视频合并行/信息流整场发奖行=true;纯展示=false)
+  status: string | null; // 发奖状态 granted/closed_early/…;纯展示为空
+  expected_coin: number; // 应发金币;纯展示=0
+  actual_coin: number; // 实发金币;纯展示=0
+  matched: boolean; // 本条应发==实发;纯展示恒 true(不计对账)
+  reward_detail: AdRevenueRecord | null; // 发奖复算明细(点行展开下钻);纯展示为空
+}
+
+export interface AdRevenueReport {
+  date_from: string; // 起始日 北京时间 YYYY-MM-DD
+  date_to: string; // 结束日 北京时间 YYYY-MM-DD(闭区间;单日时与 date_from 相同)
+  daily: AdRevenueDaily[]; // 按日期汇总序列(全量,供按天趋势图)
+  hourly: AdRevenueHourly[]; // 按小时汇总序列(全量,供按小时趋势图;按天查询时为空)
+  type_stats: Record<string, AdRevenueTypeStat>; // 按广告类型小计;前端取 draw / reward_video
+  dau: number | null; // 今日活跃(复用大盘 last_login_at);仅查询=今日时有值,否则 null
+  total: number; // 当前筛选下的分页总条数(全量,不受分页影响)
+  truncated: boolean; // 当前页之后是否还有更多事件(分页后前端不再据此报警)
+  total_impressions: number;
+  total_revenue_yuan: number;
+  total_expected_coin: number;
+  total_actual_coin: number;
+  mismatch_count: number; // 应发≠实发的发奖条数
+  items: AdRevenueRow[];
 }
 
 export interface DashboardOverview {
@@ -270,3 +481,88 @@ export interface PriceReportSummary {
   rejected: number;
   total: number;
 }
+
+// ===== CPS 分发与对账 =====
+export interface CpsGroup {
+  id: number;
+  sid: string | null; // 仅美团群有(渠道追踪位)
+  name: string;
+  platforms: string[]; // meituan/taobao/jd 多选
+  member_count: number | null;
+  status: string; // active / archived
+  remark: string | null;
+  created_at: string;
+}
+
+export interface CpsActivity {
+  id: number;
+  platform: string; // meituan / taobao / jd
+  name: string;
+  act_id: string | null; // 美团活动物料 ID
+  product_view_sign: string | null;
+  payload: string | null; // 淘宝整段淘口令 / 京东链接
+  image_url: string | null; // 淘宝落地页主视觉图(绝对 URL)
+  status: string;
+  remark: string | null;
+  created_at: string;
+}
+
+export interface CpsOrder {
+  id: number;
+  order_id: string;
+  sid: string | null;
+  act_id: string | null;
+  pay_price_cents: number | null;
+  commission_cents: number | null;
+  commission_rate: string | null; // "300"=3% "10"=0.1%
+  mt_status: string | null; // 2付款 3完成 4取消 5风控 6结算
+  invalid_reason: string | null;
+  product_name: string | null;
+  pay_time: string | null;
+}
+
+export interface CpsReferralLinkItem {
+  activity_id: number;
+  activity_name: string;
+  platform: string;
+  redirect_url: string; // 我们的落地页 /c/{code}(发群用)
+  code: string;
+}
+
+export interface CpsReferralLinks {
+  group_name: string;
+  results: CpsReferralLinkItem[];
+}
+
+export interface CpsReconcileResult {
+  fetched: number;
+  inserted: number;
+  updated: number;
+  pages: number;
+}
+
+export interface CpsGroupStat {
+  group_id: number | null;
+  sid: string | null;
+  name: string;
+  platforms: string[];
+  member_count: number | null;
+  click_pv: number;
+  click_uv: number;
+  copy_pv: number; // 淘宝"复制口令"次数
+  copy_uv: number;
+  // 对账类:淘宝/京东无法对账 → null(前端显示 "-")
+  order_count: number | null;
+  settled_count: number | null;
+  canceled_count: number | null;
+  gmv_cents: number | null;
+  est_commission_cents: number | null;
+  settled_commission_cents: number | null;
+}
+
+export interface CpsStats {
+  groups: CpsGroupStat[];
+  total_order_count: number;
+  total_est_commission_cents: number;
+  total_settled_commission_cents: number;
+}

src/lib/usePagedList.ts

@@ -0,0 +1,75 @@
+'use client';
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { api } from './api';
+import type { CursorPage } from './types';
+
+/**
+ * 页码分页列表 hook(对接后端 offset 分页 + total)。
+ * 与 useCursorList(「加载更多」)并存:需要页码/跳页/共 N 条的主列表页用本 hook。
+ *
+ * 约定:后端 cursor 即 offset,本 hook 按 (page-1)*pageSize 计算;CursorPage.total 为符合
+ * 筛选条件的总条数(供 antd Table pagination 渲染)。filters 变化自动回第 1 页重载。
+ */
+export function usePagedList<T>(
+  url: string,
+  filters: Record<string, unknown>,
+  initialPageSize = 20,
+) {
+  const [items, setItems] = useState<T[]>([]);
+  const [total, setTotal] = useState(0);
+  const [page, setPage] = useState(1);
+  const [pageSize, setPageSize] = useState(initialPageSize);
+  const [loading, setLoading] = useState(false);
+  const requestSeq = useRef(0);
+
+  const filtersKey = JSON.stringify(filters);
+
+  const load = useCallback(
+    async (p: number, ps: number) => {
+      const seq = requestSeq.current + 1;
+      requestSeq.current = seq;
+      setLoading(true);
+      try {
+        const params = { ...JSON.parse(filtersKey), limit: ps, cursor: (p - 1) * ps };
+        const { data } = await api.get<CursorPage<T>>(url, { params });
+        if (requestSeq.current !== seq) return; // 丢弃过期响应(快速切页/筛选)
+        setItems(data.items);
+        setTotal(data.total ?? 0);
+      } finally {
+        if (requestSeq.current === seq) setLoading(false);
+      }
+    },
+    [url, filtersKey],
+  );
+
+  // 筛选变化:回第 1 页重载
+  useEffect(() => {
+    setPage(1);
+    load(1, pageSize);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [load]);
+
+  // antd Table pagination.onChange(page, pageSize):页变或每页条数变都走这里
+  const onChange = (p: number, ps: number) => {
+    if (ps !== pageSize) {
+      // 每页条数变 → 回第 1 页,避免越界空页
+      setPageSize(ps);
+      setPage(1);
+      load(1, ps);
+    } else {
+      setPage(p);
+      load(p, ps);
+    }
+  };
+
+  return {
+    items,
+    total,
+    page,
+    pageSize,
+    loading,
+    onChange,
+    reload: () => load(page, pageSize), // 写操作后刷新当前页
+  };
+}