权限管理新增人员支持「自定义」角色：选中后可见页逐页勾选，保存到本人

角色下拉末尾加「自定义」,选中时「可见页面」从只读矩阵切成可勾选(复用 PermEditor),
提交带 pages_override;编辑自定义用户回填已勾选页;列表里 custom 显示「自定义」,
列表内切到自定义会转去编辑页勾选(避免空可见页)。AdminInfo 加 pages_override 字段。

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

README.md

@@ -4,10 +4,31 @@ 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` 门,登录即可查看。
 
 ## 本地开发
 
@@ -52,5 +73,6 @@ 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)
+- `.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 已建、能登录
 

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）。

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

@@ -0,0 +1,84 @@
+'use client';
+
+// 点收益报表里的用户手机号 → 半屏抽屉展示该用户的广告收益详情(统计卡 + 金币记录)。
+// 复用「提现详情」里的 UserRewardPanel(数据走 /users/{id}/reward-stats + /coin-records);
+// 用户基本信息(昵称/注册时间/钱包)取自 /users/{id} 概览。抽屉样式(width 50% 半屏)与提现详情一致。
+import { useEffect, useState } from 'react';
+import { Drawer } from 'antd';
+import { api } from '@/lib/api';
+import type { WithdrawUserSnapshot } from '@/lib/types';
+import UserRewardPanel from '../withdraws/UserRewardPanel';
+
+// GET /admin/api/users/{id} 概览里我们要用到的子集(前端未单独定义 AdminUserOverview 类型)。
+interface UserOverviewResp {
+  user: {
+    id: number;
+    phone: string;
+    nickname: string | null;
+    status: string;
+    wechat_nickname: string | null;
+    created_at: string;
+    last_login_at: string;
+  };
+  cash_balance_cents: number;
+  withdraw_total: number;
+  withdraw_success_cents: number;
+}
+
+interface Props {
+  open: boolean;
+  onClose: () => void;
+  userId: number | null;
+  phone: string | null; // 报表行已有的手机号:概览拉取失败时兜底展示
+}
+
+export default function UserAdRevenueDrawer({ open, onClose, userId, phone }: Props) {
+  // UserRewardPanel 的 user 快照:它只读 phone/nickname/wechat_nickname/created_at,其余按 snapshot 形状补齐。
+  const [user, setUser] = useState<WithdrawUserSnapshot | null>(null);
+
+  useEffect(() => {
+    if (!open || userId == null) return;
+    let alive = true;
+    setUser(null);
+    api
+      .get<UserOverviewResp>(`/admin/api/users/${userId}`)
+      .then((r) => {
+        if (!alive) return;
+        const o = r.data;
+        setUser({
+          id: o.user.id,
+          phone: o.user.phone,
+          nickname: o.user.nickname,
+          status: o.user.status,
+          wechat_nickname: o.user.wechat_nickname, // 概览接口已返回微信昵称
+          wechat_avatar_url: null,
+          created_at: o.user.created_at,
+          last_login_at: o.user.last_login_at,
+          cash_balance_cents: o.cash_balance_cents,
+          withdraw_total: o.withdraw_total,
+          withdraw_success_cents: o.withdraw_success_cents,
+        });
+      })
+      .catch(() => {
+        // 概览失败:退回只带手机号,昵称/注册天数显示「-」,不阻塞统计/金币记录(它们由 userId 独立拉)
+        if (alive) setUser(phone ? ({ phone } as WithdrawUserSnapshot) : null);
+      });
+    return () => {
+      alive = false;
+    };
+  }, [open, userId, phone]);
+
+  return (
+    <Drawer
+      title={`用户广告收益详情${phone ? ` · ${phone}` : ''}`}
+      width="50%"
+      open={open}
+      onClose={onClose}
+      destroyOnHidden
+    >
+      {/* userId 就绪即渲染;UserRewardPanel 内部按 userId 自行拉统计与金币记录,user 基本信息随后补上。
+          statsVariant="ad":统计区只显示 6 项看广告统计(累计提现/现金余额/激励视频观看数+eCPM/draw观看数+eCPM) */}
+      {userId != null && <UserRewardPanel userId={userId} user={user} statsVariant="ad" />}
+    </Drawer>
+  );
+}

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

@@ -1,290 +1,25 @@
 'use client';
 
 import { useCallback, useEffect, useState } from 'react';
-import type { ColumnsType } from 'antd/es/table';
-import {
-  App,
-  Alert,
-  Button,
-  Card,
-  Col,
-  DatePicker,
-  Divider,
-  Form,
-  Input,
-  InputNumber,
-  Modal,
-  Popover,
-  Row,
-  Select,
-  Space,
-  Statistic,
-  Switch,
-  Table,
-  Tag,
-  Typography,
-} from 'antd';
-import {
-  FallOutlined,
-  InfoCircleOutlined,
-  QuestionCircleOutlined,
-  RiseOutlined,
-} from '@ant-design/icons';
-import dayjs, { type Dayjs } from 'dayjs';
+import { Alert, App, Button, Card, Form, Input, Switch } from 'antd';
 import { api, errMsg } from '@/lib/api';
-import { formatUtcTime } from '@/lib/format';
-import type {
-  AdRevenueDaily,
-  AdRevenueImpression,
-  AdRevenueRecord,
-  AdRevenueReport,
-  AdRevenueRow,
-} 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 信息流' },
-};
-
-// 我们的应用环境标签
-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/收益/adn/底层位)
-const IMPRESSION_COLUMNS: ColumnsType<AdRevenueImpression> = [
-  { title: '时间', dataIndex: 'created_at', render: (v: string) => formatUtcTime(v), width: 165 },
-  { title: 'eCPM（分）', dataIndex: 'ecpm', width: 100 },
-  { title: '预估收益(元)', dataIndex: 'revenue_yuan', width: 120, render: (v: number) => v.toFixed(4) },
-  {
-    title: 'adn',
-    dataIndex: 'adn',
-    width: 90,
-    render: (v: string | null) => v ?? '-',
-  },
-  {
-    title: '底层代码位ID',
-    dataIndex: 'slot_id',
-    render: (v: string | null) => v ?? '-',
-  },
-];
-
-// 展开行 - 发奖明细:该组的逐条发奖复算明细(还原原金币审计的 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),数据源是 items(被 limit 截断时会偏少,调用处给警告)
-function aggregateHourly(rows: AdRevenueRow[]): 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 / 各场景广告位ID / 验签密钥 / 各场景开关。
 // 客户端(发版后)从 /api/v1/platform/ad-config 拉取;此处经 admin /ad-config 读写。
+// 收益报表在独立的「广告收益」页(/ad-revenue-report)。
 interface AdCfg {
   app_id: string;
   reward_code_id: string;
-  compare_feed_code_id: string;
-  coupon_feed_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;
 }
 
-function AdConfigPanel() {
+export default function AdConfigPage() {
   const { message } = App.useApp();
   const [form] = Form.useForm();
   const [saving, setSaving] = useState(false);
@@ -315,7 +50,6 @@ function AdConfigPanel() {
   return (
     <Card
       title="广告配置(穿山甲)"
-      style={{ marginBottom: 16 }}
       extra={
         <Button type="primary" loading={saving} onClick={save}>
           保存
@@ -340,11 +74,11 @@ function AdConfigPanel() {
         >
           <Input.Password placeholder="GroMore S2S 回调验签密钥" autoComplete="off" />
         </Form.Item>
-        <Form.Item name="compare_feed_code_id" label="比价 · 信息流 广告位ID" rules={[{ required: true }]}>
-          <Input placeholder="如 104090333" />
+        <Form.Item name="compare_draw_code_id" label="比价Draw信息流代码位" rules={[{ required: true }]}>
+          <Input placeholder="比价Draw信息流代码位,如 104098712" />
         </Form.Item>
-        <Form.Item name="coupon_feed_code_id" label="领券 · 信息流 广告位ID" rules={[{ required: true }]}>
-          <Input placeholder="如 104090333" />
+        <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 />
@@ -355,486 +89,14 @@ function AdConfigPanel() {
         <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>
   );
 }
-
-export default function AdRevenuePage() {
-  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>();
-  const [granularity, setGranularity] = useState<'day' | 'hour'>('day');
-  const [limit, setLimit] = useState<number>(500);
-  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');
-
-  const load = useCallback(async () => {
-    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,
-          granularity: gran,
-          limit,
-        },
-      });
-      setData(res.data);
-      setQueriedLimit(limit);
-      setQueriedGranularity(gran);
-      setQueriedMultiDay(multiDay);
-    } catch (e) {
-      message.error(errMsg(e));
-    } finally {
-      setLoading(false);
-    }
-  }, [range, userId, adType, granularity, limit]);
-
-  useEffect(() => {
-    load();
-    // 仅首次自动拉今天;之后由「查询」按钮触发
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, []);
-
-  const columns: ColumnsType<AdRevenueRow> = [
-    ...(queriedMultiDay
-      ? [{ title: '日期', dataIndex: 'report_date', width: 110, fixed: 'left' } as ColumnsType<AdRevenueRow>[number]]
-      : []),
-    { title: '用户', dataIndex: 'user_id', width: 80 },
-    ...(queriedGranularity === 'hour'
-      ? [
-          {
-            title: '小时',
-            dataIndex: 'hour',
-            width: 90,
-            render: (h: number | null) =>
-              h == null ? '-' : `${String(h).padStart(2, '0')}:00`,
-          } as ColumnsType<AdRevenueRow>[number],
-        ]
-      : []),
-    {
-      title: '广告类型',
-      dataIndex: 'ad_type',
-      width: 120,
-      render: (s: string) => {
-        const t = TYPE_TAG[s] ?? { color: 'default', label: s };
-        return <Tag color={t.color}>{t.label}</Tag>;
-      },
-    },
-    {
-      title: '来源应用',
-      dataIndex: 'app_env',
-      width: 150,
-      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: '广告位ID',
-      dataIndex: 'our_code_id',
-      width: 120,
-      render: (v: string | null) =>
-        v ? <Typography.Text code>{v}</Typography.Text> : <Typography.Text type="secondary">-</Typography.Text>,
-    },
-    { title: '展示条数', dataIndex: 'impressions', width: 90, align: 'right' },
-    {
-      title: '预估收益(元)',
-      dataIndex: 'revenue_yuan',
-      width: 120,
-      align: 'right',
-      render: (v: number) => v.toFixed(4),
-    },
-    {
-      title: '应发金币',
-      dataIndex: 'expected_coin',
-      width: 100,
-      align: 'right',
-      render: (v: number) => <b>{v}</b>,
-    },
-    { title: '实发金币', dataIndex: 'actual_coin', width: 100, align: 'right' },
-    {
-      title: '一致',
-      dataIndex: 'matched',
-      width: 80,
-      align: 'center',
-      render: (m: boolean) => (m ? <Tag color="green">✓</Tag> : <Tag color="red">✗ 不符</Tag>),
-    },
-    {
-      title: '底层 ADN',
-      dataIndex: 'adns',
-      render: (v: string[]) =>
-        v.length ? v.map((a) => <Tag key={a}>{a}</Tag>) : <Typography.Text type="secondary">-</Typography.Text>,
-    },
-  ];
-
-  // 派生指标(全部基于全量 total_* 字段,不受 limit 截断影响,准):
-  // 平均 eCPM = 收益÷展示×1000;发奖成本(元)= 实发金币÷汇率;预估毛利 = 收益−发奖成本;
-  // 发奖占收益比 = 发奖成本÷收益;应发实发差额(金币)= 应发−实发(正=少发/负=多发)。
-  const derived = data
-    ? {
-        avgEcpm: data.total_impressions
-          ? (data.total_revenue_yuan / data.total_impressions) * 1000
-          : 0,
-        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,
-      }
-    : null;
-
-  return (
-    <div>
-      <AdConfigPanel />
-      <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 信息流' },
-              ]}
-            />
-          </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={limit}
-              onChange={setLimit}
-              style={{ width: 110 }}
-              options={[100, 200, 500, 1000].map((n) => ({ value: n, label: `${n} 组` }))}
-            />
-          </Space>
-          <Button type="primary" onClick={load} 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 span={6}>
-              <Statistic title="展示条数合计" value={data.total_impressions} />
-            </Col>
-            <Col span={6}>
-              <Statistic title="平均 eCPM(元/千次)" value={derived.avgEcpm} precision={2} />
-            </Col>
-            <Col span={6}>
-              <Statistic title="预估收益合计(元)" value={data.total_revenue_yuan} precision={4} />
-            </Col>
-            <Col span={6}>
-              <Statistic title="聚合组数" value={data.total} />
-            </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={6}>
-              <Statistic title="应发金币合计" value={data.total_expected_coin} />
-            </Col>
-            <Col span={6}>
-              <Statistic title="实发金币合计" value={data.total_actual_coin} />
-            </Col>
-            <Col span={6}>
-              <Statistic title="发奖成本(元)" value={derived.payoutYuan} precision={4} />
-            </Col>
-            <Col span={6}>
-              <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>
-        </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} 组,应发与实发全部一致。`} />
-          )}
-          {data.truncated && (
-            <Alert
-              type="warning"
-              showIcon
-              message={`聚合明细已截断到 ${queriedLimit} 组,还有更多未显示——请按用户/类型/日期缩小范围,或调大「组数」。合计数字不受影响。`}
-            />
-          )}
-        </Space>
-      )}
-
-      {data &&
-        (queriedMultiDay
-          ? (data.daily?.length ?? 0) > 0
-          : queriedGranularity === 'hour' && (data.items?.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>
-          }
-        >
-          {/* 按小时图由 items 聚合,会被 limit 截断;按天图用 daily(全量)不受影响,故只在按小时时警告 */}
-          {!queriedMultiDay && data.truncated && (
-            <Alert
-              type="warning"
-              showIcon
-              style={{ marginBottom: 12 }}
-              message={`图表按小时聚合的是已截断到 ${queriedLimit} 组的明细,可能少算——调大「条数」或缩小筛选可还原真实趋势。`}
-            />
-          )}
-          {queriedMultiDay ? (
-            <TrendChart points={aggregateDaily(data.date_from, data.date_to, data.daily)} />
-          ) : (
-            <TrendChart points={aggregateHourly(data.items)} />
-          )}
-        </Card>
-      )}
-
-      <Table
-        rowKey={(r) => `${r.report_date}-${r.user_id}-${r.ad_type}-${r.app_env ?? ''}-${r.our_code_id ?? ''}-${r.hour ?? ''}`}
-        columns={columns}
-        dataSource={data?.items ?? []}
-        loading={loading}
-        pagination={false}
-        size="small"
-        scroll={{ x: 1100 }}
-        rowClassName={(r) => (r.matched ? '' : 'row-mismatch')}
-        expandable={{
-          rowExpandable: (r) =>
-            (r.impression_records?.length ?? 0) > 0 || (r.records?.length ?? 0) > 0,
-          expandedRowRender: (r) => {
-            const imps = r.impression_records ?? [];
-            const recs = r.records ?? [];
-            return (
-              <Space direction="vertical" size="middle" style={{ width: '100%' }}>
-                <div>
-                  <Typography.Text strong>展示明细</Typography.Text>{' '}
-                  <Typography.Text type="secondary">({imps.length} 条)</Typography.Text>
-                  <Table<AdRevenueImpression>
-                    style={{ marginTop: 8 }}
-                    rowKey="id"
-                    columns={IMPRESSION_COLUMNS}
-                    dataSource={imps}
-                    pagination={false}
-                    size="small"
-                    scroll={{ x: 700 }}
-                  />
-                </div>
-                <div>
-                  <Typography.Text strong>发奖明细</Typography.Text>{' '}
-                  <Typography.Text type="secondary">({recs.length} 条)</Typography.Text>
-                  <Table<AdRevenueRecord>
-                    style={{ marginTop: 8 }}
-                    rowKey="record_id"
-                    columns={DETAIL_COLUMNS}
-                    dataSource={recs}
-                    pagination={false}
-                    size="small"
-                    scroll={{ x: 900 }}
-                    rowClassName={(d) => (d.matched ? '' : 'row-mismatch')}
-                    locale={{ emptyText: '该组无发奖记录(只有展示,未发奖)' }}
-                  />
-                </div>
-              </Space>
-            );
-          },
-        }}
-      />
-      <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 累计条数」按该账号累计第几条计(不按天重置);激励视频每次 1 条,信息流每满 10 秒折 1 条。
-          <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)/admins/page.tsx

@@ -1,81 +1,290 @@
 'use client';
 
-import { useEffect, useState } from 'react';
+import { useEffect, useMemo, useState } from 'react';
 import type { ColumnsType } from 'antd/es/table';
-import { App, Button, Form, Input, Modal, Select, Table, Tag } from 'antd';
+import {
+  App, Button, Card, Checkbox, Input, Select, Space, Table, Tag,
+} from 'antd';
 import { api, errMsg } from '@/lib/api';
 import { formatUtcTime } from '@/lib/format';
-import type { AdminInfo } from '@/lib/types';
+import { getAdmin } from '@/lib/auth';
+import type { AdminInfo, AdminRole, PermissionGroup } from '@/lib/types';
 
-const ROLES = [
-  { value: 'super_admin', label: 'super_admin' },
-  { value: 'finance', label: 'finance' },
-  { value: 'operator', label: 'operator' },
-];
-// last_login_at 为 UTC 口径(datetime.now(utc)),按北京显示(勿用 new Date().toLocaleString)
 const dt = (v: string | null) => (v ? formatUtcTime(v, 'YYYY-MM-DD HH:mm:ss') : '从未');
 
+// 随机初始密码(排除易混字符 0O1lI),客户端生成、转交本人,后端只存 hash
+function genPassword(len = 10): string {
+  const chars = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnpqrstuvwxyz23456789';
+  let s = '';
+  for (let i = 0; i < len; i += 1) s += chars[Math.floor(Math.random() * chars.length)];
+  return s;
+}
+
+type View = 'list' | 'person' | 'roles' | 'roleForm';
+
+// 「自定义」哨兵角色:不是共享角色,选它时可见页由本人逐页勾选(存 pages_override),与后端一致。
+const CUSTOM_ROLE = 'custom';
+const CUSTOM_LABEL = '自定义';
+
+// ===== 只读权限矩阵:角色详情 / 人员「可见页面」预览共用(深色=有,灰色=无)=====
+function PermMatrix({ catalog, pages }: { catalog: PermissionGroup[]; pages: string[] }) {
+  const has = useMemo(() => new Set(pages), [pages]);
+  return (
+    <div style={{ border: '1px solid #f0f0f0', borderRadius: 8, overflow: 'hidden' }}>
+      {catalog.map((g) => (
+        <div key={g.group} style={{ display: 'flex', borderBottom: '1px solid #f0f2f5' }}>
+          <div style={{ width: 150, flexShrink: 0, padding: '14px', fontWeight: 500, color: 'rgba(0,0,0,.85)' }}>
+            {g.group}
+          </div>
+          <div style={{ flex: 1, padding: '12px 16px', display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '14px 28px' }}>
+            {g.pages.map((p) => (
+              // 深色=可见,灰色(--ink-3)=不可见
+              <span key={p.key} style={{ fontSize: 13.5, color: has.has(p.key) ? 'rgba(0,0,0,.85)' : '#94a0b1' }}>
+                {p.label}
+              </span>
+            ))}
+          </div>
+        </div>
+      ))}
+    </div>
+  );
+}
+
+// ===== 可编辑权限矩阵:角色表单用(勾选框 + 分类全选/半选)=====
+function PermEditor({
+  catalog, value, onChange,
+}: { catalog: PermissionGroup[]; value: string[]; onChange: (next: string[]) => void }) {
+  const has = useMemo(() => new Set(value), [value]);
+  const setPages = (s: Set<string>) => onChange(Array.from(s));
+  const togglePage = (key: string) => {
+    const n = new Set(has);
+    if (n.has(key)) n.delete(key); else n.add(key);
+    setPages(n);
+  };
+  const toggleGroup = (g: PermissionGroup, on: boolean) => {
+    const n = new Set(has);
+    g.pages.forEach((p) => (on ? n.add(p.key) : n.delete(p.key)));
+    setPages(n);
+  };
+  return (
+    <div style={{ border: '1px solid #f0f0f0', borderRadius: 8, overflow: 'hidden' }}>
+      {catalog.map((g) => {
+        const cnt = g.pages.filter((p) => has.has(p.key)).length;
+        const all = cnt === g.pages.length && cnt > 0;
+        return (
+          <div key={g.group} style={{ display: 'flex', borderBottom: '1px solid #fafafa' }}>
+            <div style={{ width: 140, flexShrink: 0, padding: '14px', background: '#fafbfd' }}>
+              <Checkbox
+                checked={all}
+                indeterminate={cnt > 0 && !all}
+                onChange={(e) => toggleGroup(g, e.target.checked)}
+              >
+                {g.group}
+              </Checkbox>
+            </div>
+            <div style={{ flex: 1, padding: '12px 16px', display: 'grid', gridTemplateColumns: '1fr 1fr', gap: '10px 24px' }}>
+              {g.pages.map((p) => (
+                <Checkbox key={p.key} checked={has.has(p.key)} onChange={() => togglePage(p.key)}>
+                  {p.label}
+                </Checkbox>
+              ))}
+            </div>
+          </div>
+        );
+      })}
+    </div>
+  );
+}
+
 export default function AdminsPage() {
   const { message, modal } = App.useApp();
-  const [admins, setAdmins] = useState<AdminInfo[]>([]);
-  const [loading, setLoading] = useState(false);
-  const [createOpen, setCreateOpen] = useState(false);
-  const [form] = Form.useForm();
+  const me = getAdmin();
+  const isSuper = me?.role === 'super_admin';
 
-  const load = async () => {
+  const [view, setView] = useState<View>('list');
+  const [admins, setAdmins] = useState<AdminInfo[]>([]);
+  const [roles, setRoles] = useState<AdminRole[]>([]);
+  const [catalog, setCatalog] = useState<PermissionGroup[]>([]);
+  const [loading, setLoading] = useState(false);
+
+  const roleByName = useMemo(() => {
+    const m: Record<string, AdminRole> = {};
+    roles.forEach((r) => { m[r.name] = r; });
+    return m;
+  }, [roles]);
+  const roleOptions = roles.map((r) => ({ value: r.name, label: r.label }));
+  // 人员表单角色下拉:真实角色 + 末尾「自定义」。选「自定义」→ 下方可见页改为逐页勾选。
+  const personRoleOptions = [...roleOptions, { value: CUSTOM_ROLE, label: CUSTOM_LABEL }];
+  // 角色 key → 展示名(custom 显示「自定义」;查不到回退 key 原文)
+  const roleLabelOf = (name: string) =>
+    (name === CUSTOM_ROLE ? CUSTOM_LABEL : roleByName[name]?.label ?? name);
+
+  const loadAll = async () => {
     setLoading(true);
     try {
-      const { data } = await api.get<AdminInfo[]>('/admin/api/admins');
-      setAdmins(data);
+      const [a, r, c] = await Promise.all([
+        api.get<AdminInfo[]>('/admin/api/admins'),
+        api.get<AdminRole[]>('/admin/api/roles'),
+        api.get<PermissionGroup[]>('/admin/api/roles/catalog'),
+      ]);
+      setAdmins(a.data);
+      setRoles(r.data);
+      setCatalog(c.data);
+    } catch (e) {
+      message.error(errMsg(e));
     } finally {
       setLoading(false);
     }
   };
-  useEffect(() => {
-    load();
-  }, []);
+  useEffect(() => { loadAll(); }, []); // eslint-disable-line react-hooks/exhaustive-deps
 
-  const create = async () => {
-    const v = await form.validateFields();
+  // ===== 人员表单(新增 / 编辑)状态 =====
+  const [personEditing, setPersonEditing] = useState<AdminInfo | null>(null);
+  const [personName, setPersonName] = useState('');
+  const [personRole, setPersonRole] = useState('');
+  const [initPw, setInitPw] = useState('');
+  // 「自定义」角色时逐页勾选的可见页集(role==custom 才用到)
+  const [personPages, setPersonPages] = useState<string[]>([]);
+
+  const openCreatePerson = () => {
+    setPersonEditing(null);
+    setPersonName('');
+    setPersonRole(roles.find((r) => !r.is_builtin)?.name ?? roles[0]?.name ?? 'operator');
+    setPersonPages([]);
+    setInitPw(genPassword());
+    setView('person');
+  };
+  const openEditPerson = (a: AdminInfo) => {
+    setPersonEditing(a);
+    setPersonName(a.username);
+    setPersonRole(a.role);
+    // 编辑「自定义」用户时,回填其已勾选的可见页(供继续增删)
+    setPersonPages(a.role === CUSTOM_ROLE ? (a.pages_override ?? []) : []);
+    setInitPw(''); // 编辑态密码只读展示 a.password(已确定的登录密码),不用 initPw
+    setView('person');
+  };
+  const copyText = (v: string) => {
+    navigator.clipboard?.writeText(v);
+    message.success('已复制到剪贴板');
+  };
+  // 密码展示框(对齐原型 .pw-show:虚线灰框 + 大号等宽 + 复制)
+  const pwBox = (value: string) => (
+    <div style={{ display: 'flex', alignItems: 'center', gap: 12, background: '#f4f6fa', border: '1px dashed #cbd5e1', borderRadius: 8, padding: '12px 14px' }}>
+      <code style={{ flex: 1, fontFamily: '"DIN Alternate", "SF Mono", Consolas, monospace', fontSize: 22, fontWeight: 700, letterSpacing: 1, color: 'rgba(0,0,0,.85)' }}>{value}</code>
+      <Button onClick={() => copyText(value)}>复制</Button>
+    </div>
+  );
+  const isCustom = personRole === CUSTOM_ROLE;
+  const submitPerson = async () => {
+    if (isCustom && personPages.length === 0) { message.error('自定义角色请至少勾选一个可见页面'); return; }
     try {
-      await api.post('/admin/api/admins', v);
-      message.success('已创建');
-      setCreateOpen(false);
-      form.resetFields();
-      load();
+      if (personEditing) {
+        // 密码只读、不改;提交变更的角色 +(自定义时)勾选的可见页
+        const roleChanged = personRole !== personEditing.role;
+        const pagesChanged = isCustom
+          && JSON.stringify(personPages) !== JSON.stringify(personEditing.pages_override ?? []);
+        if (roleChanged || pagesChanged) {
+          const payload: Record<string, unknown> = {};
+          if (roleChanged) payload.role = personRole;
+          // 自定义:带上勾选集(切到 custom 或改现有 custom 勾选都要);切回普通角色不带,后端会清空 override
+          if (isCustom) payload.pages_override = personPages;
+          await api.patch(`/admin/api/admins/${personEditing.id}`, payload);
+        }
+        message.success('已保存');
+      } else {
+        if (personName.trim().length < 3) { message.error('用户名至少 3 位'); return; }
+        await api.post('/admin/api/admins', {
+          username: personName.trim(),
+          password: initPw,
+          role: personRole,
+          ...(isCustom ? { pages_override: personPages } : {}),
+        });
+        message.success('已创建,请把初始密码转交本人');
+      }
+      setView('list');
+      loadAll();
     } catch (e) {
       message.error(errMsg(e));
     }
   };
-
+  // ===== 列表操作 =====
   const changeRole = (a: AdminInfo, role: string) => {
     if (role === a.role) return;
+    // 改成「自定义」需要逐页勾选 → 转去编辑页(列表里没有页选择器,直接切会得到空可见页)
+    if (role === CUSTOM_ROLE) { openEditPerson({ ...a, role: CUSTOM_ROLE }); return; }
     modal.confirm({
-      title: `把 ${a.username} 的角色改为 ${role}?`,
+      title: `把 ${a.username} 的角色改为 ${roleLabelOf(role)}?`,
       onOk: async () => {
-        try {
-          await api.patch(`/admin/api/admins/${a.id}`, { role });
-          message.success('已更新');
-          load();
-        } catch (e) {
-          message.error(errMsg(e));
-        }
+        try { await api.patch(`/admin/api/admins/${a.id}`, { role }); message.success('已更新'); loadAll(); }
+        catch (e) { message.error(errMsg(e)); }
       },
     });
   };
-
-  const toggle = (a: AdminInfo) => {
+  const toggleStatus = (a: AdminInfo) => {
     const next = a.status === 'active' ? 'disabled' : 'active';
     modal.confirm({
       title: `${next === 'disabled' ? '禁用' : '启用'}管理员 ${a.username}?`,
       onOk: async () => {
-        try {
-          await api.patch(`/admin/api/admins/${a.id}`, { status: next });
-          message.success('已更新');
-          load();
-        } catch (e) {
-          message.error(errMsg(e));
-        }
+        try { await api.patch(`/admin/api/admins/${a.id}`, { status: next }); message.success('已更新'); loadAll(); }
+        catch (e) { message.error(errMsg(e)); }
+      },
+    });
+  };
+  const deletePerson = (a: AdminInfo) => {
+    modal.confirm({
+      title: '确认删除',
+      content: `确定删除管理员「${a.username}」吗?删除后该账号将无法登录,不可恢复。`,
+      okText: '确认删除', okButtonProps: { danger: true },
+      onOk: async () => {
+        try { await api.delete(`/admin/api/admins/${a.id}`); message.success('已删除'); loadAll(); }
+        catch (e) { message.error(errMsg(e)); }
+      },
+    });
+  };
+
+  // ===== 角色设置状态 =====
+  const [selRoleId, setSelRoleId] = useState<number | null>(null);
+  const selRole = roles.find((r) => r.id === selRoleId) ?? roles[0] ?? null;
+  const openRoles = () => {
+    setSelRoleId((prev) => prev ?? roles[0]?.id ?? null);
+    setView('roles');
+  };
+
+  // 角色表单(新增 / 编辑)
+  const [roleEditing, setRoleEditing] = useState<AdminRole | null>(null);
+  const [roleName, setRoleName] = useState('');
+  const [rolePages, setRolePages] = useState<string[]>([]);
+  const openCreateRole = () => {
+    setRoleEditing(null); setRoleName(''); setRolePages([]); setView('roleForm');
+  };
+  const openEditRole = (r: AdminRole) => {
+    setRoleEditing(r); setRoleName(r.label); setRolePages(r.pages); setView('roleForm');
+  };
+  const submitRole = async () => {
+    if (!roleName.trim()) { message.error('请输入角色名称'); return; }
+    try {
+      if (roleEditing) {
+        // 只改展示名 + 可见页(key 不可变)
+        await api.patch(`/admin/api/roles/${roleEditing.id}`, { label: roleName.trim(), pages: rolePages });
+        message.success('角色已保存');
+      } else {
+        await api.post('/admin/api/roles', { name: roleName.trim(), pages: rolePages });
+        message.success('角色已创建');
+      }
+      await loadAll();
+      setView('roles');
+    } catch (e) {
+      message.error(errMsg(e));
+    }
+  };
+  const deleteRole = (r: AdminRole) => {
+    modal.confirm({
+      title: '确认删除角色',
+      content: `确定删除角色「${r.label}」吗?${r.in_use > 0 ? `当前有 ${r.in_use} 名成员在用,需先改派。` : '此操作不可恢复。'}`,
+      okText: '确认删除', okButtonProps: { danger: true },
+      onOk: async () => {
+        try { await api.delete(`/admin/api/roles/${r.id}`); message.success('已删除角色'); await loadAll(); setSelRoleId(null); }
+        catch (e) { message.error(errMsg(e)); }
       },
     });
   };
@@ -84,60 +293,174 @@ export default function AdminsPage() {
     { title: 'ID', dataIndex: 'id', width: 70 },
     { title: '用户名', dataIndex: 'username' },
     {
-      title: '角色',
-      dataIndex: 'role',
+      title: '角色', dataIndex: 'role', width: 170,
+      // options 含「自定义」→ custom 用户在列表里显示为「自定义」;选它会转去编辑页勾选(见 changeRole)
       render: (r: string, a: AdminInfo) => (
-        <Select
-          size="small"
-          value={r}
-          style={{ width: 140 }}
-          options={ROLES}
-          onChange={(v) => changeRole(a, v)}
-        />
+        <Select size="small" value={r} style={{ width: 150 }} options={personRoleOptions} onChange={(v) => changeRole(a, v)} />
       ),
     },
+    { title: '状态', dataIndex: 'status', width: 90, render: (s: string) => <Tag color={s === 'active' ? 'green' : 'default'}>{s === 'active' ? 'active' : '已禁用'}</Tag> },
+    { title: '最后登录', dataIndex: 'last_login_at', width: 180, render: dt },
     {
-      title: '状态',
-      dataIndex: 'status',
-      render: (s: string) => <Tag color={s === 'active' ? 'green' : 'red'}>{s}</Tag>,
-    },
-    { title: '最后登录', dataIndex: 'last_login_at', render: dt },
-    {
-      title: '操作',
-      key: 'op',
+      title: '操作', key: 'op', width: 200,
       render: (_: unknown, a: AdminInfo) => (
-        <a onClick={() => toggle(a)}>{a.status === 'active' ? '禁用' : '启用'}</a>
+        <Space size="middle">
+          <a onClick={() => openEditPerson(a)}>编辑</a>
+          <a onClick={() => toggleStatus(a)}>{a.status === 'active' ? '禁用' : '启用'}</a>
+          <a style={{ color: '#cf1322' }} onClick={() => deletePerson(a)}>删除</a>
+        </Space>
       ),
     },
   ];
 
+  // ============ 视图 1:管理员账号列表 ============
+  if (view === 'list') {
+    return (
+      <div>
+        <h2>权限管理</h2>
+        <Space style={{ marginBottom: 16 }}>
+          <Button type="primary" onClick={openCreatePerson}>+ 新增人员</Button>
+          <Button onClick={openRoles}>角色设置</Button>
+        </Space>
+        <Table rowKey="id" columns={columns} dataSource={admins} loading={loading} pagination={false} />
+      </div>
+    );
+  }
+
+  // ============ 视图 2:新增 / 编辑人员 ============
+  if (view === 'person') {
+    const rolePagesPreview = roleByName[personRole]?.pages ?? [];
+    return (
+      <div>
+        <Space style={{ marginBottom: 16 }}><a onClick={() => setView('list')}>‹ 返回</a></Space>
+        <Card style={{ maxWidth: 720, margin: '0 auto' }}>
+          <h2 style={{ fontSize: 19, fontWeight: 600, marginBottom: 22 }}>{personEditing ? '编辑人员' : '新增人员'}</h2>
+          <div style={{ marginBottom: 20 }}>
+            <div style={{ marginBottom: 8 }}>用户名<span style={{ color: '#cf1322' }}> *</span></div>
+            <Input value={personName} disabled={!!personEditing} onChange={(e) => setPersonName(e.target.value)} placeholder="至少 3 位" />
+            {personEditing && <div style={{ color: '#999', fontSize: 12, marginTop: 6 }}>用户名不可修改</div>}
+          </div>
+
+          {!personEditing ? (
+            // 新增:系统生成初始密码(可换)
+            <div style={{ marginBottom: 20 }}>
+              <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: 8 }}>
+                <span>初始密码</span>
+                <a onClick={() => setInitPw(genPassword())}>换一个 ↻</a>
+              </div>
+              {pwBox(initPw)}
+            </div>
+          ) : personEditing.password ? (
+            // 编辑:显示该成员已确定的登录密码(只读、不可换)
+            <div style={{ marginBottom: 20 }}>
+              <div style={{ marginBottom: 8 }}>登录密码</div>
+              {pwBox(personEditing.password)}
+              <div style={{ color: '#999', fontSize: 12, marginTop: 6 }}>该成员已确定的登录密码,可复制转交本人</div>
+            </div>
+          ) : (
+            // 编辑:无留存明文(脚本/起后台建的超管)→ 不显示密码
+            <div style={{ marginBottom: 20 }}>
+              <div style={{ marginBottom: 8 }}>登录密码</div>
+              <div style={{ color: '#999', fontSize: 13, padding: '6px 0' }}>该账号密码仅在后台创建时设定、系统未留存,不可查看。</div>
+            </div>
+          )}
+
+          <div style={{ marginBottom: 20 }}>
+            <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: 8 }}>
+              <span>选择角色<span style={{ color: '#cf1322' }}> *</span></span>
+              {isSuper && <a onClick={openRoles}>设置角色权限 ›</a>}
+            </div>
+            <Select value={personRole} options={personRoleOptions} onChange={setPersonRole} style={{ width: '100%' }} />
+            <div style={{ color: '#999', fontSize: 12, marginTop: 6 }}>
+              {isCustom
+                ? '「自定义」:下方逐页勾选该成员可见的页面,仅对本人生效(不影响任何角色)'
+                : '可见页面完全由所选角色决定;如需调整请到「角色设置」修改该角色'}
+            </div>
+          </div>
+
+          <div>
+            <div style={{ display: 'flex', justifyContent: 'space-between', marginBottom: 8 }}>
+              <span>可见页面</span>
+              <span style={{ color: '#999', fontSize: 12 }}>
+                {isCustom ? '勾选本成员可见的页面' : '跟随所选角色,此处只读(深色=可见)'}
+              </span>
+            </div>
+            {isCustom ? (
+              <PermEditor catalog={catalog} value={personPages} onChange={setPersonPages} />
+            ) : (
+              <PermMatrix catalog={catalog} pages={personRole === 'super_admin' ? catalog.flatMap((g) => g.pages.map((p) => p.key)) : rolePagesPreview} />
+            )}
+          </div>
+
+          <div style={{ marginTop: 24, textAlign: 'right' }}>
+            <Space><Button onClick={() => setView('list')}>取消</Button><Button type="primary" onClick={submitPerson}>确定</Button></Space>
+          </div>
+        </Card>
+      </div>
+    );
+  }
+
+  // ============ 视图 3:角色设置(角色列表 + 只读权限详情)============
+  if (view === 'roles') {
+    return (
+      <div>
+        <Space style={{ marginBottom: 16 }}><a onClick={() => setView('list')}>‹ 返回</a><b>角色设置</b></Space>
+        <div>
+          <Button type="primary" style={{ marginBottom: 16 }} onClick={openCreateRole}>+ 新增角色权限</Button>
+          <div style={{ display: 'flex', background: '#fff', border: '1px solid #e8ebf1', borderRadius: 10, boxShadow: '0 1px 3px rgba(16,24,40,.06)', overflow: 'hidden' }}>
+            <div style={{ width: 176, flexShrink: 0, borderRight: '1px solid #eff1f6', padding: 8 }}>
+              {roles.map((r) => (
+                <div
+                  key={r.id}
+                  onClick={() => setSelRoleId(r.id)}
+                  style={{
+                    padding: '10px 14px', borderRadius: 8, cursor: 'pointer', marginBottom: 2,
+                    background: selRole?.id === r.id ? '#e6f0ff' : undefined,
+                    color: selRole?.id === r.id ? '#1677ff' : undefined,
+                    fontWeight: selRole?.id === r.id ? 600 : undefined,
+                  }}
+                >
+                  {r.label}{r.is_builtin && <Tag style={{ marginLeft: 6 }}>内建</Tag>}
+                </div>
+              ))}
+            </div>
+            <div style={{ flex: 1, minWidth: 0, padding: '18px 22px' }}>
+              {selRole && (
+                <>
+                  <Space style={{ marginBottom: 16 }} size="middle">
+                    <b style={{ fontSize: 16 }}>{selRole.label}</b>
+                    {!selRole.is_builtin && <a onClick={() => openEditRole(selRole)}>编辑角色权限</a>}
+                    {!selRole.is_builtin && <a style={{ color: '#cf1322' }} onClick={() => deleteRole(selRole)}>删除角色权限</a>}
+                    {selRole.in_use > 0 && <span style={{ color: '#999', fontSize: 12 }}>{selRole.in_use} 名成员在用</span>}
+                  </Space>
+                  <PermMatrix catalog={catalog} pages={selRole.pages} />
+                </>
+              )}
+            </div>
+          </div>
+        </div>
+      </div>
+    );
+  }
+
+  // ============ 视图 4:新增 / 编辑角色权限 ============
   return (
     <div>
-      <h2>管理员账号</h2>
-      <Button type="primary" style={{ marginBottom: 16 }} onClick={() => setCreateOpen(true)}>
-        新建管理员
-      </Button>
-      <Table rowKey="id" columns={columns} dataSource={admins} loading={loading} pagination={false} />
-
-      <Modal
-        title="新建管理员"
-        open={createOpen}
-        onOk={create}
-        onCancel={() => setCreateOpen(false)}
-        destroyOnClose
-      >
-        <Form form={form} layout="vertical" initialValues={{ role: 'operator' }}>
-          <Form.Item name="username" label="用户名" rules={[{ required: true, min: 3 }]}>
-            <Input />
-          </Form.Item>
-          <Form.Item name="password" label="密码(≥8 位)" rules={[{ required: true, min: 8 }]}>
-            <Input.Password />
-          </Form.Item>
-          <Form.Item name="role" label="角色" rules={[{ required: true }]}>
-            <Select options={ROLES} />
-          </Form.Item>
-        </Form>
-      </Modal>
+      <Space style={{ marginBottom: 16 }}><a onClick={() => setView('roles')}>‹ 返回</a></Space>
+      <Card style={{ maxWidth: 920, margin: '0 auto' }}>
+        <h2 style={{ fontSize: 19, fontWeight: 600, marginBottom: 22 }}>{roleEditing ? '编辑角色权限' : '新增角色权限'}</h2>
+        <div style={{ marginBottom: 20 }}>
+          <div style={{ marginBottom: 8 }}>角色名称<span style={{ color: '#cf1322' }}> *</span></div>
+          <Input value={roleName} onChange={(e) => setRoleName(e.target.value)} placeholder="如:运营专员 / 财务 / 审核" maxLength={32} />
+        </div>
+        <div>
+          <div style={{ marginBottom: 8 }}>角色权限(可见页面)<span style={{ color: '#cf1322' }}> *</span></div>
+          <PermEditor catalog={catalog} value={rolePages} onChange={setRolePages} />
+        </div>
+        <div style={{ marginTop: 24, textAlign: 'right' }}>
+          <Space><Button onClick={() => setView('roles')}>取消</Button><Button type="primary" onClick={submitRole}>确定</Button></Space>
+        </div>
+      </Card>
     </div>
   );
 }

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

@@ -1,7 +1,7 @@
 'use client';
 
 import { useState } from 'react';
-import type { CSSProperties } from 'react';
+import type { CSSProperties, ReactNode } from 'react';
 import {
   App, Button, Card, Collapse, Descriptions, Drawer, Input, InputNumber,
   Select, Space, Spin, Table, Tag, Typography,
@@ -28,6 +28,16 @@ const STUCK_LABEL: Record<string, string> = {
 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 '';
@@ -38,6 +48,33 @@ function pretty(s: string | null): string {
   }
 }
 
+// 搜索命中高亮:把 text 里匹配 keyword 的子串套黄底荧光,方便审计快速定位。
+// 大小写不敏感;用 indexOf 逐段切(非正则,keyword 含特殊字符也安全)。keyword 取「已应用」
+// 的搜索词(applied.store / applied.product),不是输入框实时值——只高亮真正搜过的词。
+function highlightMatch(text: string | null, keyword: unknown): ReactNode {
+  if (!text) return '-';
+  const kw = (typeof keyword === 'string' ? keyword : '').trim();
+  if (!kw) return text;
+  const parts: ReactNode[] = [];
+  const hay = text.toLowerCase();
+  const needle = kw.toLowerCase();
+  let from = 0;
+  let hit = hay.indexOf(needle);
+  let k = 0;
+  while (hit !== -1) {
+    if (hit > from) parts.push(text.slice(from, hit));
+    parts.push(
+      <mark key={k++} style={{ background: '#fff566', padding: 0 }}>
+        {text.slice(hit, hit + kw.length)}
+      </mark>,
+    );
+    from = hit + kw.length;
+    hit = hay.indexOf(needle, from);
+  }
+  if (from < text.length) parts.push(text.slice(from));
+  return parts;
+}
+
 const preStyle: CSSProperties = {
   background: '#f6f8fa', padding: 8, borderRadius: 6, fontSize: 12,
   maxHeight: 340, overflow: 'auto', whiteSpace: 'pre-wrap', wordBreak: 'break-word', margin: 0,
@@ -49,7 +86,21 @@ export default function ComparisonRecordsPage() {
   const [userId, setUserId] = useState<number | null>(null);
   const [phone, setPhone] = useState('');
   const [status, setStatus] = useState<string | undefined>();
+  const [store, setStore] = useState('');
+  const [product, setProduct] = useState('');
   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);
@@ -58,12 +109,20 @@ export default function ComparisonRecordsPage() {
   const [detailLoading, setDetailLoading] = useState(false);
 
   const search = () =>
-    setApplied({ user_id: userId ?? undefined, phone: phone || undefined, status });
+    setApplied({
+      user_id: userId ?? undefined,
+      phone: phone || undefined,
+      status,
+      store: store.trim() || undefined,
+      product: product.trim() || undefined,
+    });
 
   const reset = () => {
     setUserId(null);
     setPhone('');
     setStatus(undefined);
+    setStore('');
+    setProduct('');
     setApplied({});
   };
 
@@ -100,7 +159,21 @@ export default function ComparisonRecordsPage() {
     },
     { 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: 'store_name',
+      width: 170,
+      // 审计要一眼看全:不截断、整格自动换行(去 ellipsis),而非靠 hover tooltip
+      onCell: () => ({ style: { whiteSpace: 'normal', wordBreak: 'break-word', verticalAlign: 'top' } }),
+      render: (v: string | null) => highlightMatch(v, applied.store),
+    },
+    {
+      title: '商品',
+      dataIndex: 'product_names',
+      width: 280,
+      onCell: () => ({ style: { whiteSpace: 'normal', wordBreak: 'break-word', verticalAlign: 'top' } }),
+      render: (v: string | null) => highlightMatch(v, applied.product),
+    },
     { title: '最优', dataIndex: 'best_platform_name', width: 80, render: (v) => v || '-' },
     {
       title: '省',
@@ -120,6 +193,18 @@ export default function ComparisonRecordsPage() {
       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',
@@ -158,6 +243,22 @@ export default function ComparisonRecordsPage() {
           allowClear
           style={{ width: 150 }}
         />
+        <Input
+          placeholder="搜索店名"
+          value={store}
+          onChange={(e) => setStore(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 150 }}
+        />
+        <Input
+          placeholder="搜索商品"
+          value={product}
+          onChange={(e) => setProduct(e.target.value)}
+          onPressEnter={search}
+          allowClear
+          style={{ width: 150 }}
+        />
         <Select
           placeholder="状态"
           value={status}
@@ -172,6 +273,15 @@ export default function ComparisonRecordsPage() {
         />
         <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
@@ -187,7 +297,7 @@ export default function ComparisonRecordsPage() {
           showTotal: (t) => `共 ${t} 条`,
           onChange,
         }}
-        scroll={{ x: 1320 }}
+        scroll={{ x: 1820 }}
         onRow={(r) => ({ onClick: () => openDetail(r.id), style: { cursor: 'pointer' } })}
       />
 
@@ -204,10 +314,21 @@ export default function ComparisonRecordsPage() {
               <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.store_name || '-'}</Descriptions.Item>
               <Descriptions.Item label="结论文案" span={2}>{detail.information || '-'}</Descriptions.Item>
               <Descriptions.Item label="trace" span={2}>
                 {detail.trace_url

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

@@ -12,7 +12,7 @@ const { Text } = Typography;
 
 const ACCEPT = ['image/jpeg', 'image/png', 'image/webp'];
 
-/** 反馈页「加群二维码」卡配置。改完 App 意见反馈页下次进入即同步。「反馈工单」页的一个区块。 */
+/** 反馈页「加群二维码」卡配置。改完 App 意见反馈页下次进入即同步。「系统配置 → 反馈二维码」tab 的一个区块。 */
 export default function FeedbackQrConfig() {
   const [cfg, setCfg] = useState<QrConfig | null>(null);
   const [loading, setLoading] = useState(true);

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

@@ -9,6 +9,7 @@ import {
   InputNumber,
   Modal,
   Popconfirm,
+  Segmented,
   Space,
   Spin,
   Switch,
@@ -41,20 +42,24 @@ interface BulkVals {
   enabled: boolean;
 }
 
-interface PreviewItem {
+interface RealRecord {
   masked_user: string;
   saved_amount_cents: number;
-  time: string;
+  created_at: string;
+  user_id: number;
 }
 
 const yuan = (cents: number) => (cents / 100).toFixed(2);
+const MODE_LABEL: Record<string, string> = { mixed: '混播', real: '只真实', seed: '只种子' };
 
-/** 首页轮播「种子」管理(真实记录不足时的兜底假数据,现为「生成规则」)。「数据大盘」页的一个区块。 */
+/** 首页轮播「种子」管理(真实记录不足时的兜底假数据,现为「生成规则」)。「系统配置 / 首页」里的一个区块。 */
 export default function HomeMarqueeSeeds() {
   const { message } = App.useApp();
   const [seeds, setSeeds] = useState<Seed[]>([]);
   const [loading, setLoading] = useState(true);
   const [selectedRowKeys, setSelectedRowKeys] = useState<number[]>([]); // 批量操作选中行
+  const [mode, setMode] = useState<string>('mixed'); // 轮播数据源 mixed/real/seed
+  const [modeSaving, setModeSaving] = useState(false);
 
   const [modalOpen, setModalOpen] = useState(false);
   const [editing, setEditing] = useState<Seed | null>(null);
@@ -63,9 +68,12 @@ export default function HomeMarqueeSeeds() {
   const [bulkOpen, setBulkOpen] = useState(false);
   const [bulkForm] = Form.useForm<BulkVals>();
 
-  const [previewOpen, setPreviewOpen] = useState(false);
-  const [previewItems, setPreviewItems] = useState<PreviewItem[]>([]);
-  const [previewLoading, setPreviewLoading] = useState(false);
+  // 「可展示的真实记录」分页浏览(替代原随机预览):翻遍所有 success+省>0 的真实记录
+  const REC_PAGE_SIZE = 8;
+  const [recItems, setRecItems] = useState<RealRecord[]>([]);
+  const [recTotal, setRecTotal] = useState(0);
+  const [recPage, setRecPage] = useState(0); // 0-based
+  const [recLoading, setRecLoading] = useState(false);
 
   const load = async () => {
     setLoading(true);
@@ -80,8 +88,30 @@ export default function HomeMarqueeSeeds() {
   };
   useEffect(() => {
     load();
+    // 轮播数据源模式(mixed/real/seed):单独拉,与种子列表解耦
+    api
+      .get<{ mode: string }>('/admin/api/marquee-seeds/mode')
+      .then(({ data }) => setMode(data.mode))
+      .catch(() => {});
   }, []);
 
+  // 切换数据源:乐观更新 + 失败回滚
+  const changeMode = async (m: string) => {
+    const prev = mode;
+    setMode(m);
+    setRecPage(0); // 切模式回第 1 页(不同模式条数不同,避免停在越界页)
+    setModeSaving(true);
+    try {
+      await api.patch('/admin/api/marquee-seeds/mode', { mode: m });
+      message.success('已切换,客户端下次进首页生效');
+    } catch (e) {
+      setMode(prev);
+      message.error(errMsg(e));
+    } finally {
+      setModeSaving(false);
+    }
+  };
+
   // ===== 单条 新增 / 编辑 =====
   const openAdd = () => {
     setEditing(null);
@@ -144,22 +174,29 @@ export default function HomeMarqueeSeeds() {
     }
   };
 
-  // ===== 预览实际 feed =====
-  const fetchPreview = async () => {
-    setPreviewLoading(true);
+  // ===== 可展示的记录:按「当前模式」分页浏览全部(不去重)=====
+  // 只真实=真实记录;只种子=各启用种子按生成逻辑各出一行;混播=真实+种子。与 app 同口径洗牌+去连簇,
+  // 后端固定种子 → 翻页稳定、能翻遍全部。
+  const fetchRecords = async (page: number, m: string) => {
+    setRecLoading(true);
     try {
-      const { data } = await api.get<{ items: PreviewItem[] }>('/admin/api/marquee-seeds/preview?limit=8');
-      setPreviewItems(data.items);
+      const { data } = await api.get<{ items: RealRecord[]; total: number }>(
+        '/admin/api/marquee-seeds/real-records',
+        { params: { offset: page * REC_PAGE_SIZE, limit: REC_PAGE_SIZE, mode: m } },
+      );
+      setRecItems(data.items);
+      setRecTotal(data.total);
     } catch (e) {
       message.error(errMsg(e));
     } finally {
-      setPreviewLoading(false);
+      setRecLoading(false);
     }
   };
-  const openPreview = () => {
-    setPreviewOpen(true);
-    fetchPreview();
-  };
+  // 页码或模式变化都重拉(切模式时 changeMode 会把页码重置到 0)。
+  useEffect(() => {
+    fetchRecords(recPage, mode);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [recPage, mode]);
 
   const toggle = async (s: Seed, enabled: boolean) => {
     try {
@@ -260,6 +297,100 @@ export default function HomeMarqueeSeeds() {
         首页「用户xxx 比价后节省xx元」轮播的兜底假数据。真实比价记录不足时随机抽取这些补齐;停用的不参与混播。
         用户名留空则每次展示随机合成;金额为区间则每次随机取值。
       </p>
+      <Space style={{ marginBottom: 12 }} align="center" wrap>
+        <span style={{ fontSize: 13 }}>数据源</span>
+        <Segmented
+          value={mode}
+          disabled={modeSaving}
+          onChange={(v) => changeMode(v as string)}
+          options={[
+            { label: '混播(默认)', value: 'mixed' },
+            { label: '只真实', value: 'real' },
+            { label: '只种子', value: 'seed' },
+          ]}
+        />
+        <span style={{ color: '#999', fontSize: 12 }}>
+          混播=真实优先+种子补位;只真实=不掺假数据(真实不足则少显示);只种子=只用下方种子/合成(演示用)
+        </span>
+      </Space>
+
+      {/* 可展示的真实记录:分页浏览全部(success+省>0,不去重、稳定倒序);app 轮播即从这些记录
+          随机打乱、同一用户去连簇后展示。翻页可看全所有真实用户的展示信息。 */}
+      <div
+        style={{
+          marginBottom: 16,
+          border: '1px solid #f0f0f0',
+          borderRadius: 8,
+          padding: '10px 12px',
+          background: '#fafafa',
+        }}
+      >
+        <div
+          style={{
+            display: 'flex',
+            justifyContent: 'space-between',
+            alignItems: 'center',
+            marginBottom: 6,
+            flexWrap: 'wrap',
+            gap: 8,
+          }}
+        >
+          <span style={{ fontSize: 13, fontWeight: 500 }}>
+            可展示的记录 · {MODE_LABEL[mode] ?? mode} · 共 {recTotal} 条
+            <span style={{ color: '#999', fontWeight: 400, fontSize: 12, marginLeft: 8 }}>
+              当前模式下 app 轮播能露出的全部记录(不去重):只真实=真实、只种子=各种子生成、混播=真实+种子;
+              已按 app 口径洗牌+去连簇,顺序固定便于翻页看全
+            </span>
+          </span>
+          <Space size="small">
+            <Button size="small" disabled={recPage <= 0} onClick={() => setRecPage((p) => Math.max(0, p - 1))}>
+              上一页
+            </Button>
+            <span style={{ fontSize: 12, color: '#666' }}>
+              第 {recTotal === 0 ? 0 : recPage + 1}/{Math.max(1, Math.ceil(recTotal / REC_PAGE_SIZE))} 页
+            </span>
+            <Button
+              size="small"
+              disabled={(recPage + 1) * REC_PAGE_SIZE >= recTotal}
+              onClick={() => setRecPage((p) => p + 1)}
+            >
+              下一页
+            </Button>
+          </Space>
+        </div>
+        <Spin spinning={recLoading}>
+          <div style={{ minHeight: 120 }}>
+            {recItems.length === 0 && !recLoading ? (
+              <div style={{ color: '#bbb', textAlign: 'center', padding: '36px 0', fontSize: 13 }}>
+                当前模式暂无可展示的记录
+              </div>
+            ) : (
+              recItems.map((it, i) => (
+                <div
+                  key={i}
+                  style={{
+                    display: 'flex',
+                    justifyContent: 'space-between',
+                    alignItems: 'center',
+                    padding: '6px 4px',
+                    borderBottom: '1px solid #f0f0f0',
+                  }}
+                >
+                  <span>
+                    {it.masked_user} 比价后节省{' '}
+                    <b style={{ color: '#fa541c' }}>{yuan(it.saved_amount_cents)} 元</b>
+                    <span style={{ color: '#ccc', fontSize: 12, marginLeft: 8 }}>
+                      {it.user_id > 0 ? `u${it.user_id}` : '种子'}
+                    </span>
+                  </span>
+                  <span style={{ color: '#999', fontSize: 12 }}>{it.created_at}</span>
+                </div>
+              ))
+            )}
+          </div>
+        </Spin>
+      </div>
+
       <Space style={{ marginBottom: 12 }} wrap>
         <Button type="primary" size="small" onClick={openAdd}>
           新增种子
@@ -267,9 +398,6 @@ export default function HomeMarqueeSeeds() {
         <Button size="small" onClick={openBulk}>
           批量生成
         </Button>
-        <Button size="small" onClick={openPreview}>
-          预览效果
-        </Button>
         <span style={{ borderLeft: '1px solid #eee', height: 18 }} />
         <Button size="small" disabled={!selectedRowKeys.length} onClick={() => batchSetEnabled(true)}>
           批量启用
@@ -373,48 +501,6 @@ export default function HomeMarqueeSeeds() {
           </Form.Item>
         </Form>
       </Modal>
-
-      {/* 预览实际 feed */}
-      <Modal
-        title="预览轮播效果"
-        open={previewOpen}
-        onCancel={() => setPreviewOpen(false)}
-        footer={
-          <Space>
-            <Button size="small" onClick={fetchPreview}>
-              换一批
-            </Button>
-            <Button size="small" type="primary" onClick={() => setPreviewOpen(false)}>
-              关闭
-            </Button>
-          </Space>
-        }
-      >
-        <p style={{ color: '#999', marginTop: 0 }}>
-          客户端实际会看到的混播结果:真实记录会插队,种子随机抽取、金额/用户名每次都不同。点「换一批」可重新随机。
-        </p>
-        <Spin spinning={previewLoading}>
-          <div style={{ minHeight: 120 }}>
-            {previewItems.map((it, i) => (
-              <div
-                key={i}
-                style={{
-                  display: 'flex',
-                  justifyContent: 'space-between',
-                  padding: '7px 4px',
-                  borderBottom: '1px solid #f0f0f0',
-                }}
-              >
-                <span>
-                  {it.masked_user} 比价后节省{' '}
-                  <b style={{ color: '#fa541c' }}>{yuan(it.saved_amount_cents)} 元</b>
-                </span>
-                <span style={{ color: '#999' }}>{it.time}</span>
-              </div>
-            ))}
-          </div>
-        </Spin>
-      </Modal>
     </div>
   );
 }

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

@@ -8,7 +8,6 @@ import {
   Checkbox,
   Col,
   InputNumber,
-  Popconfirm,
   Radio,
   Row,
   Select,
@@ -246,7 +245,7 @@ function buildBody(metric: string, e: Edit, immediate: boolean): Record<string,
   return body;
 }
 
-/** 首页三门面数字(帮助用户/完成比价/累计节省)的展示模式配置。作为「数据大盘」页的一个区块。 */
+/** 首页三门面数字(帮助用户/完成比价/累计节省)的展示模式配置。「系统配置 / 首页」里的一个区块。 */
 export default function HomeStatsConfig() {
   const { message, modal } = App.useApp();
   const [items, setItems] = useState<StatItem[]>([]);
@@ -630,16 +629,14 @@ export default function HomeStatsConfig() {
       {!loading && (
         <div style={{ marginTop: 16 }}>
           <Space>
-            <Button type="primary" loading={saving != null} onClick={() => saveAll(false)}>
-              保存
+            {/* 保存即生效:PATCH 带 apply_now,不再等各自「更新时间」的 tick(原「改了 app 不变」的主因)。
+                自增长模式下保存会顺带推进一档。改小数字若没生效,记得勾对应卡片的「允许数字下降」。 */}
+            <Button type="primary" loading={saving != null} onClick={() => saveAll(true)}>
+              保存(立即生效)
             </Button>
-            <Popconfirm
-              title="立即更新会马上把三项都推进一次(自增长各走一档),不等更新时间。确定?"
-              onConfirm={() => saveAll(true)}
-            >
-              <Button loading={saving != null}>立即更新</Button>
-            </Popconfirm>
-            <span style={{ color: '#999', fontSize: 12 }}>三项配置共用,一次保存全部生效</span>
+            <span style={{ color: '#999', fontSize: 12 }}>
+              三项共用,一次保存全部立即生效,客户端下次进首页即可见
+            </span>
           </Space>
         </div>
       )}

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

@@ -1,8 +1,11 @@
 'use client';
 
 import { useEffect, useState } from 'react';
-import { App, Button, Card, Input, InputNumber, Space, Spin, Switch, Tag, Tooltip } from 'antd';
+import { App, Button, Card, Input, InputNumber, Space, Spin, Switch, Tabs, Tag, Tooltip } from 'antd';
 import { api, errMsg } from '@/lib/api';
+import HomeMarqueeSeeds from './HomeMarqueeSeeds';
+import HomeStatsConfig from './HomeStatsConfig';
+import FeedbackQrConfig from './FeedbackQrConfig';
 
 interface ConfigItem {
   key: string;
@@ -80,9 +83,66 @@ export default function ConfigPage() {
     }
   };
 
-  if (loading) return <Spin style={{ display: 'block', marginTop: 80 }} />;
-
   const groups = [...new Set(items.map((i) => i.group))];
+  const welfareConfig = loading ? (
+    <Spin style={{ display: 'block', marginTop: 24 }} />
+  ) : (
+    groups.map((g) => (
+      <Card key={g} title={g} size="small" style={{ marginBottom: 16 }}>
+        {items
+          .filter((i) => i.group === g)
+          .map((item) => (
+            <div
+              key={item.key}
+              style={{ marginBottom: 12, paddingBottom: 12, borderBottom: '1px solid #f0f0f0' }}
+            >
+              <div style={{ marginBottom: 4 }}>
+                <b>{item.label}</b> {item.overridden ? <Tag color="blue">已改</Tag> : <Tag>默认</Tag>}
+                {item.help && (
+                  <Tooltip title={item.help}>
+                    <span style={{ color: '#999', marginLeft: 6, fontSize: 12, cursor: 'help' }}>
+                      ⓘ
+                    </span>
+                  </Tooltip>
+                )}
+              </div>
+              <Space wrap>
+                {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 })}
+                    style={{ width: 180 }}
+                  />
+                ) : (
+                  <Input
+                    value={edits[item.key]}
+                    onChange={(e) => setEdits({ ...edits, [item.key]: e.target.value })}
+                    style={{ width: 380 }}
+                    placeholder={
+                      item.type === 'int_list' ? '逗号分隔,如 10, 20, 30' : 'JSON,如 {"key": 100}'
+                    }
+                  />
+                )}
+                <Button
+                  type="primary"
+                  size="small"
+                  loading={saving === item.key}
+                  onClick={() => save(item)}
+                >
+                  保存
+                </Button>
+                <span style={{ color: '#bbb', fontSize: 12 }}>默认 {JSON.stringify(item.default)}</span>
+              </Space>
+            </div>
+          ))}
+      </Card>
+    ))
+  );
 
   return (
     <div>
@@ -90,64 +150,22 @@ export default function ConfigPage() {
       <p style={{ color: '#999' }}>
         改完即生效(业务下次读取用新值)。涉及金额 / 上限,改前请确认。每次改动都进审计日志。
       </p>
-      {groups.map((g) => (
-        <Card key={g} title={g} size="small" style={{ marginBottom: 16 }}>
-          {items
-            .filter((i) => i.group === g)
-            .map((item) => (
-              <div
-                key={item.key}
-                style={{ marginBottom: 12, paddingBottom: 12, borderBottom: '1px solid #f0f0f0' }}
-              >
-                <div style={{ marginBottom: 4 }}>
-                  <b>{item.label}</b>{' '}
-                  {item.overridden ? <Tag color="blue">已改</Tag> : <Tag>默认</Tag>}
-                  {item.help && (
-                    <Tooltip title={item.help}>
-                      <span style={{ color: '#999', marginLeft: 6, fontSize: 12, cursor: 'help' }}>
-                        ⓘ
-                      </span>
-                    </Tooltip>
-                  )}
-                </div>
-                <Space wrap>
-                  {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 })}
-                      style={{ width: 180 }}
-                    />
-                  ) : (
-                    <Input
-                      value={edits[item.key]}
-                      onChange={(e) => setEdits({ ...edits, [item.key]: e.target.value })}
-                      style={{ width: 380 }}
-                      placeholder={
-                        item.type === 'int_list' ? '逗号分隔,如 10, 20, 30' : 'JSON,如 {"key": 100}'
-                      }
-                    />
-                  )}
-                  <Button
-                    type="primary"
-                    size="small"
-                    loading={saving === item.key}
-                    onClick={() => save(item)}
-                  >
-                    保存
-                  </Button>
-                  <span style={{ color: '#bbb', fontSize: 12 }}>
-                    默认 {JSON.stringify(item.default)}
-                  </span>
-                </Space>
-              </div>
-            ))}
-        </Card>
-      ))}
+      <Tabs
+        items={[
+          {
+            key: 'home',
+            label: '首页',
+            children: (
+              <>
+                <HomeStatsConfig />
+                <HomeMarqueeSeeds />
+              </>
+            ),
+          },
+          { key: 'welfare', label: '福利页', children: welfareConfig },
+          { key: 'feedback-qr', label: '反馈二维码', children: <FeedbackQrConfig /> },
+        ]}
+      />
     </div>
   );
 }

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

@@ -0,0 +1,677 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
+import type { ColumnsType } from 'antd/es/table';
+import {
+  App,
+  Button,
+  Card,
+  Col,
+  DatePicker,
+  Divider,
+  Input,
+  Row,
+  Select,
+  Space,
+  Statistic,
+  Table,
+  Tag,
+  Typography,
+} from 'antd';
+import dayjs, { type Dayjs } from 'dayjs';
+import { api, errMsg } from '@/lib/api';
+import { formatUtcTime } from '@/lib/format';
+import UserRecordsDrawer from '@/components/UserRecordsDrawer';
+
+const { RangePicker } = DatePicker;
+
+// ── 领券数据看板类型(仅本页用,内联定义)──
+interface CouponDataSummary {
+  started_count: number;
+  completed_count: number;
+  avg_elapsed_ms: number | null;
+  p5_ms: number | null;
+  p50_ms: number | null;
+  p95_ms: number | null;
+  p99_ms: number | null;
+}
+interface CouponDataDaily {
+  date: string;
+  started_count: number;
+  completed_count: number;
+  avg_elapsed_ms: number | null;
+}
+interface CouponDataHourly {
+  hour: number;
+  started_count: number;
+  completed_count: number;
+  avg_elapsed_ms: number | null;
+}
+interface CouponDataRow {
+  id: number;
+  trace_id: string;
+  user_id: number | null;
+  user_phone: string | null;
+  user_nickname: string | null;
+  status: string;
+  platforms: string[] | null;
+  origin_package: string | null;
+  elapsed_ms: number | null;
+  platform_elapsed: Record<string, number> | null;
+  device_model: string | null;
+  rom: string | null;
+  app_env: string | null;
+  started_at: string;
+  claimed_count: number | null;
+  trace_url: string | null;
+}
+interface CouponDataReport {
+  date_from: string;
+  date_to: string;
+  summary: CouponDataSummary;
+  daily: CouponDataDaily[];
+  hourly: CouponDataHourly[];
+  total: number;
+  items: CouponDataRow[];
+}
+
+// 发起来源 App 包名 → 中文(「发起平台」列):空=傻瓜比价首页发起,外卖 App 包名→对应平台。
+function originLabel(pkg: string | null): string {
+  if (!pkg) return '傻瓜比价';
+  if (pkg.includes('meituan') || pkg.includes('sankuai')) return '美团';
+  if (pkg.includes('taobao') || pkg.includes('ele')) return '淘宝';
+  if (pkg.includes('jingdong') || pkg.includes('jd')) return '京东';
+  return pkg;
+}
+
+// 领券状态 → 颜色 + 中文(started 无终态 = 中途流失)
+const STATUS_TAG: Record<string, { color: string; label: string }> = {
+  started: { color: 'default', label: '未完成' },
+  completed: { color: 'green', label: '完成' },
+  failed: { color: 'red', label: '失败' },
+  abandoned: { color: 'orange', label: '中途退出' },
+};
+
+// ms → "1.5s"(空值显示 -)
+const fmtSec = (ms: number | null | undefined): string =>
+  ms == null ? '-' : `${(ms / 1000).toFixed(1)}s`;
+
+// 点手机号弹出的「该用户全部领券」抽屉列(精简版:单用户,不含用户/手机号列)。
+const RECORD_COLUMNS: ColumnsType<CouponDataRow> = [
+  { title: '时间', dataIndex: 'started_at', width: 160, render: (v: string) => formatUtcTime(v) },
+  {
+    title: '状态',
+    dataIndex: 'status',
+    width: 80,
+    render: (s: string) => {
+      const t = STATUS_TAG[s] ?? { color: 'default', label: s };
+      return <Tag color={t.color}>{t.label}</Tag>;
+    },
+  },
+  { title: '发起平台', dataIndex: 'origin_package', width: 90, render: (pkg: string | null) => originLabel(pkg) },
+  { title: '耗时', dataIndex: 'elapsed_ms', width: 80, align: 'right', render: (v: number | null) => fmtSec(v) },
+  { title: '美团', key: 'mt', width: 70, align: 'right', render: (_: unknown, r: CouponDataRow) => fmtSec(r.platform_elapsed?.['meituan-waimai']) },
+  { title: '淘宝', key: 'tb', width: 70, align: 'right', render: (_: unknown, r: CouponDataRow) => fmtSec(r.platform_elapsed?.['taobao-shanguang']) },
+  { title: '京东', key: 'jd', width: 70, align: 'right', render: (_: unknown, r: CouponDataRow) => fmtSec(r.platform_elapsed?.['jd-waimai']) },
+  {
+    title: 'trace',
+    dataIndex: 'trace_id',
+    width: 90,
+    render: (v: string, r: CouponDataRow) =>
+      r.trace_url ? (
+        <a href={r.trace_url} target="_blank" rel="noreferrer" title={v}>trace</a>
+      ) : (
+        <Typography.Text type="secondary" style={{ fontSize: 12 }}>{v.slice(0, 6)}…</Typography.Text>
+      ),
+  },
+];
+
+// ── 趋势图(纯 SVG,零依赖,复用广告报表同款):浅蓝柱=发起数、深蓝柱=完成数(左轴 次数),橙线=平均耗时(右轴 秒)──
+const CHART_BAR_STARTED = '#bae0ff';
+const CHART_BAR_COMPLETED = '#1677ff';
+const CHART_LINE = '#fa8c16';
+
+interface TrendPoint {
+  label: string; // x 轴刻度(小时数 / MM-DD)
+  tip: string; // hover 原生 tooltip
+  started: number;
+  completed: number;
+  avgSec: number | null; // 平均耗时(秒);该桶无完成为 null(不画线点)
+}
+
+// 按天聚合:用 from..to 补齐空缺日为 0,轴连续。
+function aggregateDaily(dateFrom: string, dateTo: string, daily: CouponDataDaily[]): 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 started = d?.started_count ?? 0;
+    const completed = d?.completed_count ?? 0;
+    const avgSec = d?.avg_elapsed_ms != null ? d.avg_elapsed_ms / 1000 : null;
+    out.push({
+      label: ds.slice(5),
+      tip: `${ds}　发起 ${started} · 完成 ${completed} · 平均耗时 ${avgSec == null ? '-' : avgSec.toFixed(1) + 's'}`,
+      started,
+      completed,
+      avgSec,
+    });
+    cur = cur.add(1, 'day');
+    guard += 1;
+  }
+  return out;
+}
+
+// 按小时聚合(0–23)。
+function aggregateHourly(rows: CouponDataHourly[]): TrendPoint[] {
+  const byHour = new Map(rows.map((r) => [r.hour, r]));
+  return Array.from({ length: 24 }, (_, h) => {
+    const r = byHour.get(h);
+    const started = r?.started_count ?? 0;
+    const completed = r?.completed_count ?? 0;
+    const avgSec = r?.avg_elapsed_ms != null ? r.avg_elapsed_ms / 1000 : null;
+    return {
+      label: String(h),
+      tip: `${String(h).padStart(2, '0')}:00　发起 ${started} · 完成 ${completed} · 平均耗时 ${avgSec == null ? '-' : avgSec.toFixed(1) + 's'}`,
+      started,
+      completed,
+      avgSec,
+    };
+  });
+}
+
+function TrendChart({ points }: { points: TrendPoint[] }) {
+  const n = points.length;
+  const maxBar = Math.max(1, ...points.map((p) => p.started));
+  const maxSec = Math.max(1e-9, ...points.map((p) => p.avgSec ?? 0));
+
+  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(24, step * 0.5);
+  const yBase = padT + plotH;
+
+  const barX = (i: number) => padL + i * step + (step - barW) / 2;
+  const cx = (i: number) => padL + i * step + step / 2;
+  const barH = (v: number) => (v / maxBar) * plotH;
+  const secY = (v: number) => yBase - (v / maxSec) * plotH;
+  // X 轴刻度按天/按小时尽量每格都标(≤31 个点每个都标,超出才抽稀),避免跨度稍大就隔天显示。
+  const labelEvery = Math.max(1, Math.ceil(n / 31));
+
+  // 平均耗时线:仅 avgSec 非 null 的点连线(无完成的桶断开)。
+  const linePts = points
+    .map((p, i) => (p.avgSec == null ? null : `${cx(i)},${secY(p.avgSec)}`))
+    .filter((x): x is string => x !== null)
+    .join(' ');
+
+  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_COMPLETED}>
+              {Math.round(maxBar * t)}
+            </text>
+            <text x={W - padR + 8} y={y + 4} textAnchor="start" fontSize={11} fill={CHART_LINE}>
+              {(maxSec * t).toFixed(1)}
+            </text>
+          </g>
+        );
+      })}
+      {/* 发起数柱(浅) */}
+      {points.map((p, i) => (
+        <rect
+          key={`s-${i}`}
+          x={barX(i)}
+          y={yBase - barH(p.started)}
+          width={barW}
+          height={barH(p.started)}
+          fill={CHART_BAR_STARTED}
+          rx={2}
+        >
+          <title>{p.tip}</title>
+        </rect>
+      ))}
+      {/* 完成数柱(深,窄,叠中间) */}
+      {points.map((p, i) => {
+        const cw = barW * 0.55;
+        return (
+          <rect
+            key={`c-${i}`}
+            x={cx(i) - cw / 2}
+            y={yBase - barH(p.completed)}
+            width={cw}
+            height={barH(p.completed)}
+            fill={CHART_BAR_COMPLETED}
+            rx={1}
+          >
+            <title>{p.tip}</title>
+          </rect>
+        );
+      })}
+      {/* 平均耗时线(橙,右轴) */}
+      <polyline points={linePts} fill="none" stroke={CHART_LINE} strokeWidth={2} />
+      {points.map((p, i) =>
+        p.avgSec == null ? null : (
+          <circle key={`p-${i}`} cx={cx(i)} cy={secY(p.avgSec)} r={2.5} fill={CHART_LINE}>
+            <title>{p.tip}</title>
+          </circle>
+        ),
+      )}
+      {points.map((p, i) =>
+        i % labelEvery === 0 || i === n - 1 ? (
+          <text key={`x-${i}`} x={cx(i)} y={H - 14} textAnchor="middle" fontSize={11} fill="#999">
+            {p.label}
+          </text>
+        ) : null,
+      )}
+    </svg>
+  );
+}
+
+// 领券数据看板:上半汇总卡 + 按天/小时趋势(参考广告收益大盘),下半逐条领券明细。
+// 数据源 coupon_session(客户端 /api/v1/coupon/session 两段上报);耗时统计只算 completed。
+export default function CouponDataPage() {
+  const { message } = App.useApp();
+  const [range, setRange] = useState<[Dayjs, Dayjs]>([dayjs().subtract(6, 'day'), dayjs()]);
+  const [user, setUser] = useState<string>('');
+  const [appEnv, setAppEnv] = useState<string>('prod');
+  const [granularity, setGranularity] = useState<'day' | 'hour'>('day');
+  const [sortBy, setSortBy] = useState<'time' | 'elapsed'>('time');
+  const [limit, setLimit] = useState<number>(100);
+  const [page, setPage] = useState<number>(1);
+  const [queriedGranularity, setQueriedGranularity] = useState<'day' | 'hour'>('day');
+  const [queriedMultiDay, setQueriedMultiDay] = useState(false);
+  const [queriedLimit, setQueriedLimit] = useState<number>(100);
+  const [data, setData] = useState<CouponDataReport | null>(null);
+  const [loading, setLoading] = useState(false);
+  // 点手机号:抽屉看该用户全部领券(总次数 + 记录)
+  const [recordsUser, setRecordsUser] = useState<{ userId: number; phone: string | null } | null>(null);
+  const openUserRecords = (r: CouponDataRow) => {
+    if (r.user_id != null) setRecordsUser({ userId: r.user_id, phone: r.user_phone });
+  };
+
+  // 跨多天时「按小时」无意义,粒度强制按天(同广告报表)。
+  const rangeMultiDay = range[0].format('YYYY-MM-DD') !== range[1].format('YYYY-MM-DD');
+
+  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<CouponDataReport>('/admin/api/coupon-data', {
+          params: {
+            date_from: from,
+            date_to: to,
+            user: user.trim() || undefined,
+            app_env: appEnv,
+            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, user, appEnv, granularity, limit, sortBy, message],
+  );
+
+  useEffect(() => {
+    load();
+    // 仅首次自动拉近 7 天;之后由「查询」按钮触发
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  const columns: ColumnsType<CouponDataRow> = [
+    {
+      title: '用户',
+      dataIndex: 'user_nickname',
+      width: 140,
+      render: (_: unknown, r: CouponDataRow) => {
+        if (r.user_nickname) {
+          return (
+            <span>
+              {r.user_nickname}
+              {r.user_id != null && (
+                <Typography.Text type="secondary" style={{ fontSize: 11, marginLeft: 6 }}>
+                  #{r.user_id}
+                </Typography.Text>
+              )}
+            </span>
+          );
+        }
+        if (r.user_id != null) return <Typography.Text type="secondary">#{r.user_id}</Typography.Text>;
+        return <Typography.Text type="secondary">游客</Typography.Text>;
+      },
+    },
+    {
+      title: '手机号',
+      dataIndex: 'user_phone',
+      width: 130,
+      // 点手机号 → 抽屉看该用户全部领券(参考低价审核/反馈页)。游客(无 user_id)不可点。
+      render: (phone: string | null, r: CouponDataRow) =>
+        r.user_id != null ? (
+          <a onClick={() => openUserRecords(r)}>{phone || `#${r.user_id}`}</a>
+        ) : (
+          <Typography.Text type="secondary">游客</Typography.Text>
+        ),
+    },
+    {
+      title: '状态',
+      dataIndex: 'status',
+      width: 90,
+      render: (s: string) => {
+        const t = STATUS_TAG[s] ?? { color: 'default', label: s };
+        return <Tag color={t.color}>{t.label}</Tag>;
+      },
+    },
+    {
+      title: '发起平台',
+      dataIndex: 'origin_package',
+      width: 110,
+      render: (pkg: string | null) => originLabel(pkg),
+    },
+    {
+      title: '耗时',
+      dataIndex: 'elapsed_ms',
+      width: 90,
+      align: 'right',
+      render: (v: number | null) => fmtSec(v),
+    },
+    {
+      title: '美团耗时',
+      key: 'mt_elapsed',
+      width: 90,
+      align: 'right',
+      render: (_: unknown, r: CouponDataRow) => fmtSec(r.platform_elapsed?.['meituan-waimai']),
+    },
+    {
+      title: '淘宝耗时',
+      key: 'tb_elapsed',
+      width: 90,
+      align: 'right',
+      render: (_: unknown, r: CouponDataRow) => fmtSec(r.platform_elapsed?.['taobao-shanguang']),
+    },
+    {
+      title: '京东耗时',
+      key: 'jd_elapsed',
+      width: 90,
+      align: 'right',
+      render: (_: unknown, r: CouponDataRow) => fmtSec(r.platform_elapsed?.['jd-waimai']),
+    },
+    {
+      title: '机型/ROM',
+      key: 'device',
+      width: 200,
+      render: (_: unknown, r: CouponDataRow) => {
+        const parts = [r.device_model, r.rom].filter(Boolean);
+        return parts.length ? parts.join(' / ') : <Typography.Text type="secondary">-</Typography.Text>;
+      },
+    },
+    {
+      title: '时间',
+      dataIndex: 'started_at',
+      width: 165,
+      render: (v: string) => formatUtcTime(v),
+    },
+    {
+      title: '领券 trace',
+      dataIndex: 'trace_id',
+      width: 150,
+      // 有 trace_url(pricebot 上云,仅 completed)→ 可点链接打开完整现场;否则降级为可复制 trace_id。
+      render: (v: string, r: CouponDataRow) =>
+        r.trace_url ? (
+          <a href={r.trace_url} target="_blank" rel="noreferrer" title={v}>
+            trace（{v.slice(0, 8)}…）
+          </a>
+        ) : (
+          <Typography.Text copyable={{ text: v }} style={{ fontSize: 12 }}>
+            {v.slice(0, 8)}…
+          </Typography.Text>
+        ),
+    },
+  ];
+
+  const summary = data?.summary;
+  const items = data?.items ?? [];
+
+  return (
+    <div>
+      <Space align="center" style={{ display: 'flex', marginBottom: 16 }}>
+        <h2 style={{ margin: 0 }}>领券数据</h2>
+        <Typography.Text type="secondary" style={{ fontSize: 12 }}>
+          发起→完成耗时口径为客户端全程计时;均值/分位仅统计「完成」的领券
+        </Typography.Text>
+      </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>
+            <Input
+              placeholder="手机号/昵称"
+              value={user}
+              onChange={(e) => setUser(e.target.value)}
+              onPressEnter={() => load(1)}
+              allowClear
+              style={{ width: 150 }}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">环境</Typography.Text>
+            <Select
+              value={appEnv}
+              onChange={setAppEnv}
+              style={{ width: 120 }}
+              options={[
+                { value: 'prod', label: '正式(prod)' },
+                { value: 'dev', label: '测试(dev)' },
+                { value: 'all', 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);
+              }}
+              style={{ width: 130 }}
+              options={[
+                { value: 'time', label: '时间倒序' },
+                { value: 'elapsed', label: '耗时倒序' },
+              ]}
+            />
+          </Space>
+          <Space size={6}>
+            <Typography.Text type="secondary">每页</Typography.Text>
+            <Select
+              value={limit}
+              onChange={(v) => {
+                setLimit(v);
+                load(1, v);
+              }}
+              style={{ width: 120 }}
+              options={[20, 50, 100, 200, 500].map((nn) => ({ value: nn, label: `${nn} 条/页` }))}
+            />
+          </Space>
+          <Button type="primary" onClick={() => load(1)} loading={loading}>
+            查询
+          </Button>
+        </Space>
+      </Card>
+
+      {summary && (
+        <Card size="small" style={{ marginBottom: 16 }}>
+          <Row gutter={[16, 12]}>
+            <Col flex="1 1 0">
+              <Statistic title="领券发起数" value={summary.started_count} />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic title="领券完成数" value={summary.completed_count} />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic title="平均耗时" value={fmtSec(summary.avg_elapsed_ms)} />
+            </Col>
+          </Row>
+          <Divider style={{ marginTop: 16, marginBottom: 16 }} />
+          <Row gutter={[16, 12]}>
+            <Col flex="1 1 0">
+              <Statistic title="耗时 5 分位" value={fmtSec(summary.p5_ms)} />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic title="耗时 50 分位" value={fmtSec(summary.p50_ms)} />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic title="耗时 95 分位" value={fmtSec(summary.p95_ms)} />
+            </Col>
+            <Col flex="1 1 0">
+              <Statistic title="耗时 99 分位" value={fmtSec(summary.p99_ms)} />
+            </Col>
+          </Row>
+        </Card>
+      )}
+
+      {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_STARTED,
+                    borderRadius: 2,
+                    marginRight: 4,
+                  }}
+                />
+                发起数
+              </span>
+              <span style={{ fontSize: 12, color: '#666' }}>
+                <span
+                  style={{
+                    display: 'inline-block',
+                    width: 10,
+                    height: 10,
+                    background: CHART_BAR_COMPLETED,
+                    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>
+          }
+        >
+          {queriedMultiDay ? (
+            <TrendChart points={aggregateDaily(data.date_from, data.date_to, data.daily)} />
+          ) : (
+            <TrendChart points={aggregateHourly(data.hourly)} />
+          )}
+        </Card>
+      )}
+
+      <Table
+        rowKey="trace_id"
+        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: 1450 }}
+      />
+
+      <UserRecordsDrawer<CouponDataRow>
+        open={recordsUser != null}
+        onClose={() => setRecordsUser(null)}
+        userId={recordsUser?.userId ?? null}
+        phone={recordsUser?.phone ?? null}
+        endpoint="/admin/api/coupon-data/user-records"
+        columns={RECORD_COLUMNS}
+        recordLabel="领券"
+        countLabel="领券次数"
+        rewardLabel="领到券张数"
+        rewardSuffix="张"
+        rewardOf={(r) => r.claimed_count ?? 0}
+      />
+    </div>
+  );
+}

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

@@ -6,7 +6,7 @@ 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, Row, Segmented, Space, Spin, Statistic, Table, message } from 'antd';
+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';
 
@@ -57,6 +57,20 @@ interface WxUser {
   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' },
@@ -139,6 +153,30 @@ export default function GroupDetailPage() {
     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(
@@ -171,7 +209,7 @@ export default function GroupDetailPage() {
   };
 
   const dailyColumns: ColumnsType<DailyRow> = [
-    { title: '日期', dataIndex: 'date', width: 64, fixed: 'left' },
+    { 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 || '-' },
@@ -224,6 +262,17 @@ export default function GroupDetailPage() {
       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> = [
@@ -258,6 +307,59 @@ export default function GroupDetailPage() {
     { 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>
@@ -307,7 +409,7 @@ export default function GroupDetailPage() {
             columns={dailyColumns}
             dataSource={daily?.rows ?? []}
             pagination={false}
-            scroll={{ x: 900 }}
+            scroll={{ x: 1000 }}
           />
         </Card>
       )}
@@ -326,6 +428,28 @@ export default function GroupDetailPage() {
           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)/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)/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,380 @@
+'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 { formatWallTime } 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>;
+};
+
+// 反馈类型:comparison=比价反馈 / profile(及旧数据)=普通反馈
+const SOURCE_META: Record<string, { label: string; color: string }> = {
+  comparison: { label: '比价反馈', color: 'geekblue' },
+  profile: { label: '普通反馈', color: 'default' },
+};
+
+const sourceTag = (s: string) => {
+  const m = SOURCE_META[s] ?? { label: '普通反馈', 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,
+          reply: v.reply?.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,
+          reply: v.reply?.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} · {formatWallTime(feedback.created_at)}
+            </Text>
+            <div style={{ marginTop: 6 }}>
+              {sourceTag(feedback.source)}
+              {feedback.scene ? (
+                <Text type="secondary" style={{ marginLeft: 6 }}>
+                  场景:{feedback.scene}
+                </Text>
+              ) : null}
+            </div>
+            <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"> · {formatWallTime(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>
+              <div style={{ marginTop: 6 }}>
+                给用户的回复(用户可见):
+                {feedback.admin_reply || <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="reply"
+                      label="给用户的回复(选填,用户端可见)"
+                      rules={[{ max: 256, message: '最多 256 字' }]}
+                    >
+                      <Input.TextArea
+                        rows={2}
+                        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.Item
+                      name="reply"
+                      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} · {formatWallTime(h.created_at)}
+                      </Text>
+                      <Space size={4}>
+                        {sourceTag(h.source)}
+                        {statusTag(h.status)}
+                      </Space>
+                    </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>
+                    )}
+                    {h.admin_reply ? (
+                      <div style={{ fontSize: 12, marginTop: 2 }}>回复:{h.admin_reply}</div>
+                    ) : null}
+                  </div>
+                ))}
+              </Space>
+            )}
+          </div>
+        </Space>
+      )}
+    </Drawer>
+  );
+}

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

@@ -1,28 +1,29 @@
 'use client';
 
 import { useEffect, useState } from 'react';
-import type { Key } from 'react';
 import type { ColumnsType } from 'antd/es/table';
 import type { SorterResult } from 'antd/es/table/interface';
 import {
-  App,
   Button,
+  Card,
   DatePicker,
   Image,
   Input,
   Select,
   Space,
+  Statistic,
   Table,
   Tag,
   Typography,
 } from 'antd';
 import type { Dayjs } from 'dayjs';
-import { api, errMsg } from '@/lib/api';
+import { api } from '@/lib/api';
 import { canDo } from '@/lib/auth';
-import { formatUtcTime } from '@/lib/format';
+import { formatWallTime } from '@/lib/format';
 import { usePagedList } from '@/lib/usePagedList';
-import type { Feedback } from '@/lib/types';
-import FeedbackQrConfig from './FeedbackQrConfig';
+import type { Feedback, FeedbackSummary } from '@/lib/types';
+import FeedbackHandleDrawer from './FeedbackHandleDrawer';
+import UserRecordsDrawer from '@/components/UserRecordsDrawer';
 
 const { Text, Paragraph } = Typography;
 const { RangePicker } = DatePicker;
@@ -33,10 +34,129 @@ 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' },
+};
+
+const statusTag = (s: string) => {
+  const m = STATUS_META[s] ?? { label: s, color: 'default' };
+  return <Tag color={m.color}>{m.label}</Tag>;
+};
+
+// 反馈类型:comparison=比价反馈(比价结果页入口) / profile=普通反馈(「我的」页入口)。
+// 旧数据与未识别来源按普通反馈展示。
+const SOURCE_META: Record<string, { label: string; color: string }> = {
+  comparison: { label: '比价反馈', color: 'geekblue' },
+  profile: { label: '普通反馈', color: 'default' },
+};
+
+const SOURCE_OPTIONS = [
+  { value: 'comparison', label: '比价反馈' },
+  { value: 'profile', label: '普通反馈' },
+];
+
+// 反馈类型标签 +(比价反馈时)问题场景副标题
+const renderSource = (f: Feedback) => {
+  const m = SOURCE_META[f.source] ?? { label: '普通反馈', color: 'default' };
+  return (
+    <Space direction="vertical" size={0}>
+      <Tag color={m.color}>{m.label}</Tag>
+      {f.scene ? (
+        <Text type="secondary" style={{ fontSize: 12 }}>
+          {f.scene}
+        </Text>
+      ) : null}
+    </Space>
+  );
+};
+
+// 用户可见的运营回复留言(采纳/未采纳都可能有)
+const replyLine = (f: Feedback) =>
+  f.admin_reply ? (
+    <Text style={{ fontSize: 12 }} ellipsis>
+      回复:{f.admin_reply}
+    </Text>
+  ) : null;
+
+// 审核结果展示(采纳=金币+批注 / 未采纳=原因 / 回复留言 / 待审核=-),主表与「该用户全部反馈」抽屉共用
+const renderReview = (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}
+        {replyLine(f)}
+      </Space>
+    );
+  }
+  if (f.status === 'rejected') {
+    return (
+      <Space direction="vertical" size={0}>
+        <Text type="secondary" style={{ fontSize: 12 }} ellipsis>
+          未采纳:{f.reject_reason || '-'}
+        </Text>
+        {replyLine(f)}
+      </Space>
+    );
+  }
+  return <Text type="secondary">-</Text>;
+};
+
+// 机型 / OS版本(提交反馈时的端环境;改版前历史反馈无 → -)
+const renderDeviceOs = (f: Feedback) => {
+  const os = [f.android_version ? `Android ${f.android_version}` : null, f.rom_name]
+    .filter(Boolean)
+    .join(' · ');
+  if (!f.device_model && !os) return <Text type="secondary">-</Text>;
+  return (
+    <Space direction="vertical" size={0}>
+      <Text>{f.device_model || '-'}</Text>
+      {os ? (
+        <Text type="secondary" style={{ fontSize: 12 }}>
+          {os}
+        </Text>
+      ) : null}
+    </Space>
+  );
+};
+
+// 点手机号弹出的「该用户全部反馈」抽屉列(精简版:不含操作/手机号,避免抽屉里再套抽屉)
+const RECORD_COLUMNS: ColumnsType<Feedback> = [
+  { title: '提交时间', dataIndex: 'created_at', width: 150, render: (v: string) => formatWallTime(v) },
+  { title: '状态', dataIndex: 'status', width: 80, render: statusTag },
+  { title: '反馈类型', key: 'source', width: 100, render: (_: unknown, f: Feedback) => renderSource(f) },
+  {
+    title: '内容',
+    dataIndex: 'content',
+    render: (v: string) =>
+      v ? (
+        <Paragraph
+          style={{ marginBottom: 0, whiteSpace: 'pre-wrap', wordBreak: 'break-word' }}
+          ellipsis={{ rows: 2, expandable: true, symbol: '展开' }}
+        >
+          {v}
+        </Paragraph>
+      ) : (
+        <Text type="secondary">-</Text>
+      ),
+  },
+  { title: '审核结果', key: 'review', width: 160, render: (_: unknown, f: Feedback) => renderReview(f) },
+];
+
 export default function FeedbacksPage() {
-  const { message, modal } = App.useApp();
   // 筛选草稿:点「查询」才应用(避免输入即刷新)
   const [status, setStatus] = useState<string | undefined>();
+  const [source, setSource] = useState<string | undefined>();
   const [userId, setUserId] = useState('');
   const [content, setContent] = useState('');
   const [createdRange, setCreatedRange] = useState<[Dayjs, Dayjs] | null>(null);
@@ -46,21 +166,40 @@ export default function FeedbacksPage() {
   const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc');
 
   const filters: Record<string, unknown> = { ...applied, sort_by: sortBy, sort_order: sortOrder };
-  const filterKey = JSON.stringify(filters);
   const { items, total, page, pageSize, loading, onChange: onPageChange, reload } =
     usePagedList<Feedback>('/admin/api/feedbacks', filters);
 
-  const canHandle = canDo(['operator']);
-  const [selectedRowKeys, setSelectedRowKeys] = useState<Key[]>([]);
+  const canReview = canDo(['operator']);
 
-  // 筛选/排序变化后清空已选(避免选中项跨筛选错位)
+  const [summary, setSummary] = useState<FeedbackSummary | null>(null);
+  const loadSummary = async () => {
+    try {
+      const { data } = await api.get<FeedbackSummary>('/admin/api/feedbacks/summary');
+      setSummary(data);
+    } catch {
+      /* 统计失败不阻塞列表 */
+    }
+  };
   useEffect(() => {
-    setSelectedRowKeys([]);
-  }, [filterKey]);
+    loadSummary();
+  }, []);
+
+  // 审核/查看抽屉(采纳发金币 / 拒绝填原因 + 看该用户历史反馈)
+  const [drawerFb, setDrawerFb] = useState<Feedback | null>(null);
+  const [drawerOpen, setDrawerOpen] = useState(false);
+  const openDrawer = (f: Feedback) => {
+    setDrawerFb(f);
+    setDrawerOpen(true);
+  };
+
+  // 点手机号:看该用户全部反馈
+  const [recordsUser, setRecordsUser] = useState<{ userId: number; phone: string | null } | null>(null);
+  const openUserRecords = (f: Feedback) => setRecordsUser({ userId: f.user_id, phone: f.phone });
 
   const search = () =>
     setApplied({
       status,
+      source,
       user_id: userId.trim() ? Number(userId.trim()) : undefined,
       content: content.trim() || undefined,
       created_from: createdRange?.[0] ? createdRange[0].startOf('day').toISOString() : undefined,
@@ -69,6 +208,7 @@ export default function FeedbacksPage() {
 
   const resetFilters = () => {
     setStatus(undefined);
+    setSource(undefined);
     setUserId('');
     setContent('');
     setCreatedRange(null);
@@ -95,50 +235,52 @@ export default function FeedbacksPage() {
   const sortOrderOf = (field: SortField) =>
     sortBy === field ? (sortOrder === 'asc' ? 'ascend' : 'descend') : null;
 
-  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 selectedNew = items.filter(
-    (f) => selectedRowKeys.includes(f.id) && f.status === 'new',
-  );
-
-  // 批量:循环调现有逐条 /handle 接口(各自已带审计),Promise.allSettled 汇总成败,不新增 bulk 端点
-  const bulkHandle = () => {
-    if (!selectedNew.length) {
-      message.warning('没有可处理的选中项(仅待处理 new 态生效)');
-      return;
-    }
-    modal.confirm({
-      title: `确认批量标记处理 ${selectedNew.length} 条反馈?`,
-      content: '仅对选中的待处理(new)反馈生效',
-      onOk: async () => {
-        const results = await Promise.allSettled(
-          selectedNew.map((f) => api.post(`/admin/api/feedbacks/${f.id}/handle`)),
-        );
-        const ok = results.filter((r) => r.status === 'fulfilled').length;
-        const fail = results.length - ok;
-        if (fail) message.warning(`批量标记处理完成:成功 ${ok}/${results.length},失败 ${fail}`);
-        else message.success(`批量标记处理完成:${ok} 条`);
-        setSelectedRowKeys([]);
-        reload();
-      },
-    });
-  };
-
   const columns: ColumnsType<Feedback> = [
-    { title: 'ID', dataIndex: 'id', width: 70, sorter: true, sortOrder: sortOrderOf('id') },
-    { title: '用户', dataIndex: 'user_id', width: 80 },
+    {
+      title: '用户ID',
+      dataIndex: 'user_id',
+      width: 80,
+      render: (v: number) => <Text strong>#{v}</Text>,
+    },
+    {
+      title: '手机号',
+      dataIndex: 'phone',
+      width: 130,
+      render: (_: unknown, f: Feedback) =>
+        f.phone ? (
+          <a onClick={() => openUserRecords(f)}>{f.phone}</a>
+        ) : (
+          <Text type="secondary">无手机号</Text>
+        ),
+    },
+    {
+      title: '用户昵称',
+      dataIndex: 'nickname',
+      width: 120,
+      render: (v: string | null) => v || <Text type="secondary">无昵称</Text>,
+    },
+    {
+      title: '反馈类型',
+      key: 'source',
+      width: 110,
+      render: (_: unknown, f: Feedback) => renderSource(f),
+    },
+    {
+      title: '提交版本号',
+      dataIndex: 'app_version',
+      width: 100,
+      render: (v: string | null) => v || <Text type="secondary">-</Text>,
+    },
+    {
+      title: '机型 / OS版本',
+      key: 'device',
+      width: 150,
+      render: (_: unknown, f: Feedback) => renderDeviceOs(f),
+    },
     {
       title: '内容',
       dataIndex: 'content',
-      width: 360,
+      width: 340,
       render: (v: string) =>
         v ? (
           <Paragraph
@@ -154,7 +296,7 @@ export default function FeedbacksPage() {
     {
       title: '截图',
       dataIndex: 'images',
-      width: 180,
+      width: 160,
       render: (imgs: string[] | null) =>
         imgs && imgs.length ? (
           <Image.PreviewGroup>
@@ -174,38 +316,51 @@ export default function FeedbacksPage() {
           <Text type="secondary">无</Text>
         ),
     },
-    { title: '联系方式', dataIndex: 'contact', width: 140, render: (v: string) => v || '-' },
+    { title: '状态', dataIndex: 'status', width: 90, render: statusTag },
     {
-      title: '状态',
-      dataIndex: 'status',
-      width: 90,
-      render: (s: string) => <Tag color={s === 'new' ? 'orange' : 'green'}>{s}</Tag>,
+      title: '审核结果',
+      key: 'review',
+      width: 170,
+      render: (_: unknown, f: Feedback) => renderReview(f),
     },
     {
-      title: '时间',
+      title: '提交时间',
       dataIndex: 'created_at',
-      width: 180,
+      width: 170,
       sorter: true,
       sortOrder: sortOrderOf('created_at'),
-      render: (v: string) => formatUtcTime(v),
+      render: (v: string) => formatWallTime(v),
     },
     {
       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>
         ),
     },
   ];
 
   return (
     <div>
-      <h2>反馈工单</h2>
-      <FeedbackQrConfig />
+      <h2>用户反馈</h2>
+      <div style={{ display: 'flex', gap: 16, marginBottom: 16, flexWrap: 'wrap' }}>
+        <Card size="small" style={{ minWidth: 120 }}>
+          <Statistic title="待审核" value={summary?.pending ?? 0} valueStyle={{ color: '#fa8c16' }} />
+        </Card>
+        <Card size="small" style={{ minWidth: 120 }}>
+          <Statistic title="已采纳" value={summary?.adopted ?? 0} valueStyle={{ color: '#52c41a' }} />
+        </Card>
+        <Card size="small" style={{ minWidth: 120 }}>
+          <Statistic title="未采纳" value={summary?.rejected ?? 0} valueStyle={{ color: '#8c8c8c' }} />
+        </Card>
+        <Card size="small" style={{ minWidth: 120 }}>
+          <Statistic title="合计" value={summary?.total ?? 0} />
+        </Card>
+      </div>
       <Space style={{ marginBottom: 16 }} wrap>
         <Select
           placeholder="状态"
@@ -214,10 +369,19 @@ export default function FeedbacksPage() {
           allowClear
           style={{ width: 120 }}
           options={[
-            { value: 'new', label: '待处理' },
-            { value: 'handled', label: '已处理' },
+            { value: 'pending', label: '审核中' },
+            { value: 'adopted', label: '已采纳' },
+            { value: 'rejected', label: '未采纳' },
           ]}
         />
+        <Select
+          placeholder="反馈类型"
+          value={source}
+          onChange={setSource}
+          allowClear
+          style={{ width: 130 }}
+          options={SOURCE_OPTIONS}
+        />
         <Input
           placeholder="用户ID"
           value={userId}
@@ -246,29 +410,8 @@ export default function FeedbacksPage() {
         <Button onClick={resetFilters}>重置</Button>
       </Space>
 
-      {canHandle && selectedNew.length > 0 && (
-        <Space style={{ marginBottom: 12, width: '100%' }} wrap>
-          <span style={{ color: '#888' }}>已选 {selectedNew.length} 条待处理</span>
-          <Button type="primary" onClick={bulkHandle}>
-            批量标记处理
-          </Button>
-          <Button type="link" onClick={() => setSelectedRowKeys([])}>
-            清空选择
-          </Button>
-        </Space>
-      )}
-
       <Table
         rowKey="id"
-        rowSelection={
-          canHandle
-            ? {
-                selectedRowKeys,
-                onChange: setSelectedRowKeys,
-                getCheckboxProps: (f) => ({ disabled: f.status !== 'new' }),
-              }
-            : undefined
-        }
         columns={columns}
         dataSource={items}
         loading={loading}
@@ -281,6 +424,27 @@ export default function FeedbacksPage() {
           onChange: onPageChange,
         }}
         onChange={onTableChange}
+        scroll={{ x: 1720 }}
+      />
+
+      <FeedbackHandleDrawer
+        feedback={drawerFb}
+        open={drawerOpen}
+        onClose={() => setDrawerOpen(false)}
+        onDone={() => { reload(); loadSummary(); }}
+      />
+
+      <UserRecordsDrawer<Feedback>
+        open={recordsUser != null}
+        onClose={() => setRecordsUser(null)}
+        userId={recordsUser?.userId ?? null}
+        phone={recordsUser?.phone ?? null}
+        endpoint="/admin/api/feedbacks"
+        columns={RECORD_COLUMNS}
+        recordLabel="反馈"
+        countLabel="提交总计"
+        rewardLabel="提交奖励总计"
+        rewardOf={(f) => (f.status === 'adopted' ? (f.reward_coins ?? 0) : 0)}
       />
     </div>
   );

src/app/(main)/layout.tsx

@@ -5,62 +5,128 @@ import { usePathname, useRouter } from 'next/navigation';
 import {
   BarChartOutlined,
   DashboardOutlined,
+  DatabaseOutlined,
   FileSearchOutlined,
   FlagOutlined,
+  GiftOutlined,
+  HeartOutlined,
   LogoutOutlined,
   MessageOutlined,
-  MobileOutlined,
   MoneyCollectOutlined,
+  NotificationOutlined,
   ProfileOutlined,
   SettingOutlined,
   ShareAltOutlined,
   TeamOutlined,
   UserOutlined,
 } from '@ant-design/icons';
-import { Avatar, Dropdown, Layout, Menu } from 'antd';
-import { clearAuth, getAdmin, getToken } from '@/lib/auth';
+import { Avatar, Dropdown, Layout, Tooltip } from 'antd';
+import { api } from '@/lib/api';
+import { clearAuth, getAdmin, getToken, setAuth } from '@/lib/auth';
 import type { AdminInfo } from '@/lib/types';
 
 const { Sider, Header, Content } = Layout;
 
-const MENU = [
-  { key: '/dashboard', icon: <DashboardOutlined />, label: '数据大盘' },
-  { key: '/users', icon: <UserOutlined />, label: '用户管理' },
-  { key: '/devices', icon: <MobileOutlined />, 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-revenue', icon: <BarChartOutlined />, label: '广告管理' },
-  { key: '/cps', icon: <ShareAltOutlined />, label: 'CPS 分发' },
-  { key: '/config', icon: <SettingOutlined />, label: '系统配置' },
-  { key: '/admins', icon: <TeamOutlined />, label: '管理员', superOnly: true },
+type NavItem = {
+  key: string;
+  icon: React.ReactNode;
+  label: string;
+};
+
+type NavGroup =
+  | (NavItem & { children?: never })
+  | {
+      key: string;
+      icon: React.ReactNode;
+      label: string;
+      children: NavItem[];
+    };
+
+const hasChildren = (group: NavGroup): group is NavGroup & { children: NavItem[] } =>
+  Array.isArray(group.children);
+
+const NAV_GROUPS: NavGroup[] = [
+  {
+    key: 'dashboard',
+    icon: <DashboardOutlined />,
+    label: '看板',
+    children: [
+      { key: '/dashboard', icon: <DashboardOutlined />, label: '数据大盘' },
+      { key: '/coupon-data', icon: <GiftOutlined />, label: '领券数据' },
+      { key: '/ad-revenue-report', icon: <BarChartOutlined />, label: '广告收益' },
+      { key: '/comparison-records', icon: <ProfileOutlined />, label: '比价记录' },
+      { key: '/cps', icon: <ShareAltOutlined />, label: 'CPS收益' },
+      { key: '/device-liveness', icon: <HeartOutlined />, label: '设备存活' },
+    ],
+  },
+  {
+    key: 'reward-review',
+    icon: <MoneyCollectOutlined />,
+    label: '奖励审核',
+    children: [
+      { key: '/withdraws', icon: <MoneyCollectOutlined />, label: '提现审核' },
+      { key: '/price-reports', icon: <FlagOutlined />, label: '低价审核' },
+      { key: '/feedbacks', icon: <MessageOutlined />, label: '用户反馈' },
+    ],
+  },
+  {
+    key: 'data-config',
+    icon: <SettingOutlined />,
+    label: '数据配置',
+    children: [
+      { key: '/config', icon: <SettingOutlined />, label: '系统配置' },
+      { key: '/ad-revenue', icon: <NotificationOutlined />, label: '广告配置' },
+      { key: '/users', icon: <UserOutlined />, label: '用户管理' },
+    ],
+  },
+  { key: '/admins', icon: <TeamOutlined />, label: '权限管理' },
+  { key: '/event-logs', icon: <DatabaseOutlined />, label: '埋点日志' },
   { key: '/audit-logs', icon: <FileSearchOutlined />, label: '审计日志' },
 ];
 
+// 导航项 key(/dashboard)→ 权限页 key(dashboard),与后端 permissions.py 目录对齐
+const permOf = (key: string) => key.replace(/^\//, '');
+
 export default function MainLayout({ children }: { children: React.ReactNode }) {
   const router = useRouter();
   const pathname = usePathname();
   const [admin, setAdmin] = useState<AdminInfo | null>(null);
+  const [collapsed, setCollapsed] = useState(false);
 
   useEffect(() => {
-    if (!getToken()) {
+    const token = getToken();
+    if (!token) {
       router.replace('/login');
       return;
     }
-    setAdmin(getAdmin());
+    setAdmin(getAdmin()); // 先用本地存的(快、不闪)
+    // 再拉 /me 刷新有效可见页:超管改过该角色权限也能及时反映到左侧导航
+    api
+      .get<AdminInfo>('/admin/api/auth/me')
+      .then(({ data }) => {
+        setAdmin(data);
+        setAuth(token, data);
+      })
+      .catch(() => {});
   }, [router]);
 
   if (!admin) return null; // 守卫期间不闪烁内容
 
-  const items = MENU.filter((m) => !m.superOnly || admin.role === 'super_admin').map((m) => ({
-    key: m.key,
-    icon: m.icon,
-    label: m.label,
-  }));
-
-  // 选中态:取路径一级(/users/123 → /users)
+  // 选中态:取路径一级(/users/123 -> /users)
   const selectedKey = '/' + (pathname.split('/')[1] || 'dashboard');
+  // 叶子导航项按当前角色的有效可见页过滤:super_admin 恒可见;缺 pages 信息(旧登录)兜底全显示不锁死。
+  const isSuper = admin.role === 'super_admin';
+  const canShowLeaf = (item: { key: string }) =>
+    isSuper || !admin.pages || admin.pages.includes(permOf(item.key));
+  const visibleGroups = NAV_GROUPS
+    .map((group) => {
+      if (!hasChildren(group)) return group;
+      return { ...group, children: group.children.filter(canShowLeaf) };
+    })
+    .filter((group) => (hasChildren(group) ? group.children.length > 0 : canShowLeaf(group)));
+  const flatNavItems = visibleGroups.flatMap((group) =>
+    hasChildren(group) ? group.children : [group],
+  );
 
   const logout = () => {
     clearAuth();
@@ -69,7 +135,15 @@ export default function MainLayout({ children }: { children: React.ReactNode })
 
   return (
     <Layout style={{ minHeight: '100vh' }}>
-      <Sider theme="dark" breakpoint="lg" collapsible>
+      <Sider
+        theme="dark"
+        breakpoint="lg"
+        collapsible
+        collapsed={collapsed}
+        collapsedWidth={72}
+        width={220}
+        onCollapse={setCollapsed}
+      >
         <div
           style={{
             height: 48,
@@ -82,13 +156,61 @@ export default function MainLayout({ children }: { children: React.ReactNode })
         >
           运营后台
         </div>
-        <Menu
-          theme="dark"
-          mode="inline"
-          selectedKeys={[selectedKey]}
-          items={items}
-          onClick={({ key }) => router.push(key)}
-        />
+        <nav className={`side-nav${collapsed ? ' side-nav-collapsed' : ''}`} aria-label="后台导航">
+          {collapsed
+            ? flatNavItems.map((item) => (
+                <Tooltip key={item.key} title={item.label} placement="right">
+                  <button
+                    type="button"
+                    className={`nav-icon-button${selectedKey === item.key ? ' is-selected' : ''}`}
+                    onClick={() => router.push(item.key)}
+                    aria-label={item.label}
+                  >
+                    {item.icon}
+                  </button>
+                </Tooltip>
+              ))
+            : visibleGroups.map((group) => {
+                const isGroup = hasChildren(group);
+                const groupSelected = isGroup
+                  ? group.children.some((child) => child.key === selectedKey)
+                  : selectedKey === group.key;
+                if (!isGroup) {
+                  return (
+                    <button
+                      key={group.key}
+                      type="button"
+                      className={`nav-primary nav-direct${groupSelected ? ' is-selected' : ''}`}
+                      onClick={() => router.push(group.key)}
+                    >
+                      <span className="nav-primary-icon">{group.icon}</span>
+                      <span>{group.label}</span>
+                    </button>
+                  );
+                }
+                return (
+                  <section key={group.key} className={`nav-group${groupSelected ? ' is-active' : ''}`}>
+                    <div className="nav-primary">
+                      <span className="nav-primary-icon">{group.icon}</span>
+                      <span>{group.label}</span>
+                    </div>
+                    <div className="nav-children">
+                      {group.children.map((child) => (
+                        <button
+                          key={child.key}
+                          type="button"
+                          className={`nav-child${selectedKey === child.key ? ' is-selected' : ''}`}
+                          onClick={() => router.push(child.key)}
+                        >
+                          <span className="nav-child-icon">{child.icon}</span>
+                          <span>{child.label}</span>
+                        </button>
+                      ))}
+                    </div>
+                  </section>
+                );
+              })}
+        </nav>
       </Sider>
       <Layout>
         <Header
@@ -114,6 +236,119 @@ export default function MainLayout({ children }: { children: React.ReactNode })
         </Header>
         <Content style={{ margin: 24 }}>{children}</Content>
       </Layout>
+      <style jsx global>{`
+        .side-nav {
+          display: flex;
+          flex-direction: column;
+          gap: 4px;
+          padding: 0 10px 14px;
+        }
+        .nav-group {
+          padding: 6px 0 8px;
+        }
+        .nav-group + .nav-group,
+        .nav-group + .nav-direct,
+        .nav-direct + .nav-direct {
+          margin-top: 4px;
+        }
+        .nav-primary {
+          display: flex;
+          align-items: center;
+          gap: 10px;
+          min-height: 36px;
+          padding: 0 12px;
+          color: rgba(255, 255, 255, 0.88);
+          font-size: 14px;
+          font-weight: 600;
+          letter-spacing: 0;
+        }
+        .nav-primary-icon,
+        .nav-child-icon {
+          display: inline-flex;
+          align-items: center;
+          justify-content: center;
+          color: rgba(255, 255, 255, 0.72);
+          font-size: 16px;
+        }
+        .nav-direct,
+        .nav-child,
+        .nav-icon-button {
+          border: 0;
+          cursor: pointer;
+          font: inherit;
+          text-align: left;
+        }
+        .nav-direct {
+          width: 100%;
+          border-radius: 8px;
+          background: transparent;
+        }
+        .nav-direct:hover,
+        .nav-direct.is-selected {
+          background: #1677ff;
+          color: #fff;
+        }
+        .nav-direct:hover .nav-primary-icon,
+        .nav-direct.is-selected .nav-primary-icon {
+          color: #fff;
+        }
+        .nav-children {
+          display: flex;
+          flex-direction: column;
+          gap: 2px;
+          margin-left: 34px;
+          margin-top: -2px;
+          padding-right: 2px;
+        }
+        .nav-child {
+          display: flex;
+          align-items: center;
+          gap: 8px;
+          width: 100%;
+          min-height: 34px;
+          border-radius: 8px;
+          background: transparent;
+          color: rgba(255, 255, 255, 0.72);
+          font-size: 13px;
+          padding: 0 10px;
+        }
+        .nav-child:hover {
+          background: rgba(255, 255, 255, 0.08);
+          color: #fff;
+        }
+        .nav-child.is-selected {
+          background: #1677ff;
+          color: #fff;
+          font-weight: 600;
+        }
+        .nav-child.is-selected .nav-child-icon {
+          color: #fff;
+        }
+        .nav-group.is-active .nav-primary {
+          color: #fff;
+        }
+        .side-nav-collapsed {
+          align-items: center;
+          gap: 6px;
+          padding: 0 8px 14px;
+        }
+        .nav-icon-button {
+          display: inline-flex;
+          align-items: center;
+          justify-content: center;
+          width: 40px;
+          height: 40px;
+          border-radius: 8px;
+          background: transparent;
+          color: rgba(255, 255, 255, 0.72);
+          font-size: 17px;
+        }
+        .nav-icon-button:hover,
+        .nav-icon-button.is-selected {
+          background: #1677ff;
+          color: #fff;
+        }
+      `}</style>
     </Layout>
   );
 }

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

@@ -16,6 +16,7 @@ import {
   Typography,
 } from 'antd';
 import type { ColumnsType } from 'antd/es/table';
+import type { SorterResult } from 'antd/es/table/interface';
 import { CheckCircleOutlined, CloseCircleOutlined } from '@ant-design/icons';
 import dayjs from 'dayjs';
 import { api, errMsg } from '@/lib/api';
@@ -23,6 +24,7 @@ import { canDo } from '@/lib/auth';
 import { mediaUrl } from '@/lib/media';
 import { usePagedList } from '@/lib/usePagedList';
 import type { PriceReport, PriceReportSummary } from '@/lib/types';
+import UserRecordsDrawer from '@/components/UserRecordsDrawer';
 
 const { Text } = Typography;
 
@@ -55,19 +57,112 @@ function statusTag(status: string) {
   return <Tag color={STATUS_COLOR[status]}>{STATUS_LABEL[status] || status}</Tag>;
 }
 
+type SortField = 'id' | 'created_at';
+
+// 门店/菜品、原价→上报价、审核结果:主表与「该用户全部上报」抽屉共用
+const renderStore = (r: PriceReport) => (
+  <Space direction="vertical" size={0}>
+    <Text>{r.store_name || '-'}</Text>
+    <Text type="secondary" style={{ fontSize: 12 }}>
+      {r.dish_summary || '-'}
+    </Text>
+  </Space>
+);
+
+const renderPrice = (r: PriceReport) => (
+  <Space direction="vertical" size={0}>
+    <Text type="secondary" style={{ fontSize: 12 }}>
+      {r.original_platform_name || '原'}: {yuan(r.original_price_cents)}
+    </Text>
+    <Text strong style={{ color: '#fa541c' }}>
+      {r.reported_platform_name}: {yuan(r.reported_price_cents)}
+    </Text>
+  </Space>
+);
+
+// 只读审核结果(「审核结果」列 + 抽屉共用,不带操作按钮;待审核在「状态」列已显示,这里给 -)
+const renderResult = (r: PriceReport) => {
+  if (r.status === 'approved') return <Text type="success">已发 {r.reward_coins ?? 0} 金币</Text>;
+  if (r.status === 'rejected') return <Text type="secondary">拒绝: {r.reject_reason || '-'}</Text>;
+  return <Text type="secondary">-</Text>;
+};
+
+// Trace:与「比价记录」页一致 —— 有 trace_url(本地比价=localhost debug viewer,线上=公网)
+// 就给可点的「trace」链接,否则 -。
+const traceLink = (r: PriceReport) =>
+  r.trace_url ? (
+    <a href={r.trace_url} target="_blank" rel="noreferrer">
+      trace
+    </a>
+  ) : (
+    <Text type="secondary">-</Text>
+  );
+
+// 机型 / OS版本(取自关联比价记录;无关联记录时为 -)
+const renderDeviceOs = (r: PriceReport) => {
+  const os = [r.android_version ? `Android ${r.android_version}` : null, r.rom_name]
+    .filter(Boolean)
+    .join(' · ');
+  if (!r.device_model && !os) return <Text type="secondary">-</Text>;
+  return (
+    <Space direction="vertical" size={0}>
+      <Text>{r.device_model || '-'}</Text>
+      {os ? (
+        <Text type="secondary" style={{ fontSize: 12 }}>
+          {os}
+        </Text>
+      ) : null}
+    </Space>
+  );
+};
+
+// 点手机号弹出的「该用户全部低价上报」抽屉列(精简版:不含操作/手机号)
+const RECORD_COLUMNS: ColumnsType<PriceReport> = [
+  { title: '提交时间', dataIndex: 'created_at', width: 150, render: (v: string) => dt(v) },
+  { title: '门店 / 菜品', key: 'store', width: 180, render: (_: unknown, r: PriceReport) => renderStore(r) },
+  { title: '原价 → 上报价', key: 'price', width: 200, render: (_: unknown, r: PriceReport) => renderPrice(r) },
+  { title: '状态', dataIndex: 'status', width: 90, render: statusTag },
+  { title: 'Trace', key: 'trace', width: 80, render: (_: unknown, r: PriceReport) => traceLink(r) },
+  { title: '结果', key: 'result', width: 150, render: (_: unknown, r: PriceReport) => renderResult(r) },
+];
+
 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);
   const [rejectReason, setRejectReason] = useState('');
+  // 提交时间列服务端排序(默认按提交时间倒序,最新在前)
+  const [sortBy, setSortBy] = useState<SortField>('created_at');
+  const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc');
+  // 点手机号:看该用户全部低价上报
+  const [recordsUser, setRecordsUser] = useState<{ userId: number; phone: string | null } | null>(null);
+  const openUserRecords = (r: PriceReport) => setRecordsUser({ userId: r.user_id, phone: r.phone });
 
-  const filters: Record<string, unknown> = {};
+  const filters: Record<string, unknown> = { sort_by: sortBy, sort_order: sortOrder };
   if (activeStatus !== 'all') filters.status = activeStatus;
 
   const { items, total, page, pageSize, loading, onChange: onPageChange, reload } =
     usePagedList<PriceReport>('/admin/api/price-reports', filters);
 
+  const sortOrderOf = (field: SortField) =>
+    sortBy === field ? (sortOrder === 'asc' ? 'ascend' : 'descend') : null;
+
+  const onTableChange = (
+    _pagination: unknown,
+    _filters: unknown,
+    sorter: SorterResult<PriceReport> | SorterResult<PriceReport>[],
+  ) => {
+    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('created_at');
+      setSortOrder('desc');
+    }
+  };
+
   const canReview = canDo(['operator']);
 
   const loadSummary = async () => {
@@ -136,38 +231,51 @@ export default function PriceReportsPage() {
 
   const columns: ColumnsType<PriceReport> = [
     {
-      title: '用户',
+      title: '用户ID',
       dataIndex: 'user_id',
-      width: 90,
+      width: 80,
       render: (v: number) => <Text strong>#{v}</Text>,
     },
+    {
+      title: '手机号',
+      dataIndex: 'phone',
+      width: 130,
+      render: (_: unknown, r: PriceReport) =>
+        r.phone ? (
+          <a onClick={() => openUserRecords(r)}>{r.phone}</a>
+        ) : (
+          <Text type="secondary">无手机号</Text>
+        ),
+    },
+    {
+      title: '用户昵称',
+      dataIndex: 'nickname',
+      width: 120,
+      render: (v: string | null) => v || <Text type="secondary">无昵称</Text>,
+    },
+    {
+      title: '提交版本号',
+      dataIndex: 'app_version',
+      width: 100,
+      render: (v: string | null) => v || <Text type="secondary">-</Text>,
+    },
+    {
+      title: '机型 / OS版本',
+      key: 'device',
+      width: 150,
+      render: (_: unknown, r: PriceReport) => renderDeviceOs(r),
+    },
     {
       title: '门店 / 菜品',
       key: 'store',
       width: 200,
-      render: (_: unknown, r: PriceReport) => (
-        <Space direction="vertical" size={0}>
-          <Text>{r.store_name || '-'}</Text>
-          <Text type="secondary" style={{ fontSize: 12 }}>
-            {r.dish_summary || '-'}
-          </Text>
-        </Space>
-      ),
+      render: (_: unknown, r: PriceReport) => renderStore(r),
     },
     {
       title: '原最低价 → 上报价',
       key: 'price',
       width: 220,
-      render: (_: unknown, r: PriceReport) => (
-        <Space direction="vertical" size={0}>
-          <Text type="secondary" style={{ fontSize: 12 }}>
-            {r.original_platform_name || '原'}: {yuan(r.original_price_cents)}
-          </Text>
-          <Text strong style={{ color: '#fa541c' }}>
-            {r.reported_platform_name}: {yuan(r.reported_price_cents)}
-          </Text>
-        </Space>
-      ),
+      render: (_: unknown, r: PriceReport) => renderPrice(r),
     },
     {
       title: '截图证明',
@@ -193,52 +301,58 @@ export default function PriceReportsPage() {
         ),
     },
     { title: '状态', dataIndex: 'status', width: 90, render: statusTag },
+    {
+      title: '审核结果',
+      key: 'review',
+      width: 160,
+      render: (_: unknown, r: PriceReport) => renderResult(r),
+    },
     {
       title: '提交时间',
       dataIndex: 'created_at',
       width: 150,
+      sorter: true,
+      sortOrder: sortOrderOf('created_at'),
       render: (v: string) => dt(v),
     },
     {
-      title: '操作 / 结果',
+      title: 'Trace',
+      key: 'trace',
+      width: 80,
+      render: (_: unknown, r: PriceReport) => traceLink(r),
+    },
+    {
+      title: '操作',
       key: 'op',
       fixed: 'right',
-      width: 200,
+      width: 150,
       render: (_: unknown, r: PriceReport) => {
-        if (r.status === 'pending') {
-          if (!canReview) return <Text type="secondary">无审核权限</Text>;
-          return (
-            <Space>
-              <Button
-                size="small"
-                type="link"
-                icon={<CheckCircleOutlined />}
-                onClick={() => approve(r)}
-              >
-                通过
-              </Button>
-              <Button
-                size="small"
-                type="link"
-                danger
-                icon={<CloseCircleOutlined />}
-                onClick={() => {
-                  setRejecting(r);
-                  setRejectReason('');
-                }}
-              >
-                拒绝
-              </Button>
-            </Space>
-          );
-        }
-        if (r.status === 'approved') {
-          return <Text type="success">已发 {r.reward_coins ?? 0} 金币</Text>;
-        }
-        if (r.status === 'rejected') {
-          return <Text type="secondary">拒绝: {r.reject_reason || '-'}</Text>;
-        }
-        return <Text type="secondary">-</Text>;
+        if (r.status !== 'pending') return <Text type="secondary">-</Text>;
+        if (!canReview) return <Text type="secondary">无审核权限</Text>;
+        return (
+          <Space>
+            <Button
+              size="small"
+              type="link"
+              icon={<CheckCircleOutlined />}
+              onClick={() => approve(r)}
+            >
+              通过
+            </Button>
+            <Button
+              size="small"
+              type="link"
+              danger
+              icon={<CloseCircleOutlined />}
+              onClick={() => {
+                setRejecting(r);
+                setRejectReason('');
+              }}
+            >
+              拒绝
+            </Button>
+          </Space>
+        );
       },
     },
   ];
@@ -247,7 +361,7 @@ export default function PriceReportsPage() {
     <div>
       <Space direction="vertical" style={{ marginBottom: 16 }}>
         <Typography.Title level={4} style={{ margin: 0 }}>
-          上报审核
+          低价审核
         </Typography.Title>
         <Text type="secondary">
           用户上报「某平台更低价」+ 截图，人工核实后通过发放 1000 金币奖励、拒绝需填理由。用户在 app
@@ -255,14 +369,20 @@ export default function PriceReportsPage() {
         </Text>
       </Space>
 
-      {summary && (
-        <Space size="large" style={{ marginBottom: 16 }}>
-          <Statistic title="待审核" value={summary.pending} valueStyle={{ color: '#faad14' }} />
-          <Statistic title="已通过" value={summary.approved} valueStyle={{ color: '#52c41a' }} />
-          <Statistic title="已拒绝" value={summary.rejected} />
-          <Statistic title="合计" value={summary.total} />
-        </Space>
-      )}
+      <div style={{ display: 'flex', gap: 16, marginBottom: 16, flexWrap: 'wrap' }}>
+        <Card size="small" style={{ minWidth: 120 }}>
+          <Statistic title="待审核" value={summary?.pending ?? 0} valueStyle={{ color: '#fa8c16' }} />
+        </Card>
+        <Card size="small" style={{ minWidth: 120 }}>
+          <Statistic title="已通过" value={summary?.approved ?? 0} valueStyle={{ color: '#52c41a' }} />
+        </Card>
+        <Card size="small" style={{ minWidth: 120 }}>
+          <Statistic title="已拒绝" value={summary?.rejected ?? 0} valueStyle={{ color: '#8c8c8c' }} />
+        </Card>
+        <Card size="small" style={{ minWidth: 120 }}>
+          <Statistic title="合计" value={summary?.total ?? 0} />
+        </Card>
+      </div>
 
       <Card>
         <Tabs
@@ -275,6 +395,7 @@ export default function PriceReportsPage() {
           columns={columns}
           dataSource={items}
           loading={loading}
+          onChange={onTableChange}
           pagination={{
             current: page,
             pageSize,
@@ -283,7 +404,7 @@ export default function PriceReportsPage() {
             showTotal: (t) => `共 ${t} 条`,
             onChange: onPageChange,
           }}
-          scroll={{ x: 1100 }}
+          scroll={{ x: 1790 }}
         />
       </Card>
 
@@ -320,6 +441,19 @@ export default function PriceReportsPage() {
           </Space>
         )}
       </Modal>
+
+      <UserRecordsDrawer<PriceReport>
+        open={recordsUser != null}
+        onClose={() => setRecordsUser(null)}
+        userId={recordsUser?.userId ?? null}
+        phone={recordsUser?.phone ?? null}
+        endpoint="/admin/api/price-reports"
+        columns={RECORD_COLUMNS}
+        recordLabel="低价上报"
+        countLabel="上报总计"
+        rewardLabel="上报奖励总计"
+        rewardOf={(r) => (r.status === 'approved' ? (r.reward_coins ?? 0) : 0)}
+      />
     </div>
   );
 }

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

@@ -23,6 +23,7 @@ import { canDo } from '@/lib/auth';
 import { formatUtcTime, formatWallTime, yuan } from '@/lib/format';
 import { useCursorList } from '@/lib/useCursorList';
 import { AdjustCashModal, AdjustCoinModal } from '@/components/AdjustBalanceModals';
+import { DeleteUserModal } from '@/components/DeleteUserModal';
 import type { CashTxn, CoinTxn, UserOverview, WithdrawOrder } from '@/lib/types';
 
 export default function UserDetailPage() {
@@ -33,6 +34,7 @@ export default function UserDetailPage() {
   const [err, setErr] = useState<string | null>(null);
   const [coinOpen, setCoinOpen] = useState(false);
   const [cashOpen, setCashOpen] = useState(false);
+  const [delOpen, setDelOpen] = useState(false);
 
   const loadData = useCallback(() => {
     setErr(null);
@@ -52,6 +54,7 @@ export default function UserDetailPage() {
 
   const canCoins = canDo(['finance']);
   const canStatus = canDo(['operator']);
+  const canDelete = canDo(['super_admin']); // 注销账号最高危,仅 super_admin(与后端 require_role 对齐)
 
   const toggleStatus = () => {
     if (!data) return;
@@ -154,6 +157,11 @@ export default function UserDetailPage() {
               {data.user.status === 'active' ? '封禁' : '解封'}
             </Button>
           )}
+          {canDelete && data.user.status !== 'deleted' && (
+            <Button danger onClick={() => setDelOpen(true)}>
+              注销账号
+            </Button>
+          )}
         </Space>
       </Space>
       <Card style={{ marginBottom: 16 }}>
@@ -272,6 +280,12 @@ export default function UserDetailPage() {
           cash.reload();
         }}
       />
+      <DeleteUserModal
+        user={data.user}
+        open={delOpen}
+        onClose={() => setDelOpen(false)}
+        onDone={loadData}
+      />
     </div>
   );
 }

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

@@ -5,20 +5,21 @@ 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 { App, Button, DatePicker, Input, Select, Space, Table, Tag } from 'antd';
+import { App, Button, DatePicker, Input, Select, Space, Table, Tag, Tooltip } 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 { usePagedList } from '@/lib/usePagedList';
 import { AdjustCashModal, AdjustCoinModal } from '@/components/AdjustBalanceModals';
+import { DeleteUserModal } from '@/components/DeleteUserModal';
 import type { UserListItem } from '@/lib/types';
 
 const { RangePicker } = DatePicker;
 
 const STATUS_COLOR: Record<string, string> = { active: 'green', disabled: 'red', deleted: 'default' };
 
-type SortField = 'id' | 'created_at' | 'last_login_at';
+type SortField = 'id' | 'created_at' | 'last_active_at';
 
 export default function UsersPage() {
   const router = useRouter();
@@ -43,9 +44,11 @@ export default function UsersPage() {
 
   const canCoins = canDo(['finance']);
   const canStatus = canDo(['operator']);
+  const canDelete = canDo(['super_admin']); // 注销账号最高危,仅 super_admin(与后端 require_role 对齐)
 
   const [coinUser, setCoinUser] = useState<UserListItem | null>(null);
   const [cashUser, setCashUser] = useState<UserListItem | null>(null);
+  const [delUser, setDelUser] = useState<UserListItem | null>(null);
   const [selectedRowKeys, setSelectedRowKeys] = useState<Key[]>([]);
 
   // 筛选/排序变化后清空已选(避免选中项跨筛选错位)
@@ -61,8 +64,8 @@ export default function UsersPage() {
       register_channel: channel || undefined,
       created_from: regRange?.[0] ? regRange[0].startOf('day').toISOString() : undefined,
       created_to: regRange?.[1] ? regRange[1].endOf('day').toISOString() : undefined,
-      last_login_from: loginRange?.[0] ? loginRange[0].startOf('day').toISOString() : undefined,
-      last_login_to: loginRange?.[1] ? loginRange[1].endOf('day').toISOString() : undefined,
+      last_active_from: loginRange?.[0] ? loginRange[0].startOf('day').toISOString() : undefined,
+      last_active_to: loginRange?.[1] ? loginRange[1].endOf('day').toISOString() : undefined,
     });
 
   const resetFilters = () => {
@@ -235,18 +238,25 @@ export default function UsersPage() {
       render: (v: string) => formatUtcTime(v),
     },
     {
-      title: '最近登录',
-      dataIndex: 'last_login_at',
+      // 最近活跃 = max(最近登录, 最近发起比价, 最近发起领券),与大盘 DAU/留存活跃口径一致(2026-07-05)
+      title: (
+        <Tooltip title="进入 App(登录)/ 发起比价 / 发起领券,取最近一次">
+          最近活跃
+        </Tooltip>
+      ),
+      dataIndex: 'last_active_at',
       width: 160,
       sorter: true,
-      sortOrder: sortOrderOf('last_login_at'),
-      render: (v: string) => formatUtcTime(v),
+      // 关掉 antd 默认的「点击升序/降序」表头提示,否则与上面自定义口径 Tooltip 同时弹出互相遮挡
+      showSorterTooltip: false,
+      sortOrder: sortOrderOf('last_active_at'),
+      render: (v: string | null, u: UserListItem) => formatUtcTime(v ?? u.last_login_at),
     },
     {
       title: '操作',
       key: 'op',
       fixed: 'right',
-      width: 300,
+      width: 340,
       render: (_: unknown, u: UserListItem) => (
         <Space wrap={false} onClick={(e) => e.stopPropagation()}>
           <a onClick={() => router.push(`/users/${u.id}`)}>详情</a>
@@ -269,6 +279,11 @@ export default function UsersPage() {
             ) : (
               <a onClick={() => setForceOnboarding(u, true)}>开启新手引导</a>
             ))}
+          {canDelete && u.status !== 'deleted' && (
+            <a style={{ color: '#cf1322' }} onClick={() => setDelUser(u)}>
+              注销
+            </a>
+          )}
         </Space>
       ),
     },
@@ -324,7 +339,7 @@ export default function UsersPage() {
           allowClear
         />
         <RangePicker
-          placeholder={['最近登录起', '最近登录止']}
+          placeholder={['最近活跃起', '最近活跃止']}
           value={loginRange}
           onChange={(v) => setLoginRange(v as [Dayjs, Dayjs] | null)}
           allowClear
@@ -377,12 +392,18 @@ export default function UsersPage() {
           showTotal: (t) => `共 ${t} 个用户`,
           onChange: onPageChange,
         }}
-        scroll={{ x: 1160 }}
+        scroll={{ x: 1200 }}
         onChange={onTableChange}
       />
 
       <AdjustCoinModal user={coinUser} open={!!coinUser} onClose={() => setCoinUser(null)} />
       <AdjustCashModal user={cashUser} open={!!cashUser} onClose={() => setCashUser(null)} />
+      <DeleteUserModal
+        user={delUser}
+        open={!!delUser}
+        onClose={() => setDelUser(null)}
+        onDone={reload}
+      />
     </div>
   );
 }

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

@@ -2,7 +2,6 @@
 
 import { useCallback, useEffect, useState } from 'react';
 import {
-  Button,
   DatePicker,
   Descriptions,
   Radio,
@@ -35,20 +34,25 @@ const SOURCE_COLOR: Record<string, string> = {
   signin: 'green',
 };
 
+const PAGE_SIZE = 10; // 金币记录每页条数
+
 interface Props {
   userId: number;
   user: WithdrawUserSnapshot | null;
+  // 统计区字段集:withdraw(默认,提现详情:含提现细分) / ad(广告收益详情:只看看广告观看统计,对齐参考图 6 项)
+  statsVariant?: 'withdraw' | 'ad';
 }
 
-/** 提现详情抽屉:用户基本信息 + 互斥时间筛选 + 看广告/提现统计区 + 金币发放记录表。 */
-export default function UserRewardPanel({ userId, user }: Props) {
+/** 用户看广告/提现详情:基本信息 + 互斥时间筛选 + 统计区(按 statsVariant 取字段集)+ 金币发放记录表。 */
+export default function UserRewardPanel({ userId, user, statsVariant = 'withdraw' }: Props) {
   const [mode, setMode] = useState<'all' | 'range'>('all'); // all=注册至今 / range=自定义区间
   const [range, setRange] = useState<[Dayjs, Dayjs] | null>(null);
   const [stats, setStats] = useState<UserRewardStats | null>(null);
   const [statsLoading, setStatsLoading] = useState(false);
 
   const [records, setRecords] = useState<UserCoinRecord[]>([]);
-  const [nextCursor, setNextCursor] = useState<number | null>(null);
+  const [page, setPage] = useState(1);
+  const [total, setTotal] = useState(0);
   const [recordsLoading, setRecordsLoading] = useState(false);
 
   // 时间窗口参数:注册至今=不传;自定义区间(选齐两端)=date_from/date_to。
@@ -76,17 +80,15 @@ export default function UserRewardPanel({ userId, user }: Props) {
   }, [userId, paramsKey]);
 
   const loadRecords = useCallback(
-    async (cursor: number | null) => {
+    async (p: number) => {
       setRecordsLoading(true);
       try {
-        const reqParams: Record<string, unknown> = { ...JSON.parse(paramsKey), limit: 20 };
-        if (cursor != null) reqParams.cursor = cursor;
         const { data } = await api.get<CursorPage<UserCoinRecord>>(
           `/admin/api/users/${userId}/coin-records`,
-          { params: reqParams },
+          { params: { ...JSON.parse(paramsKey), limit: PAGE_SIZE, cursor: (p - 1) * PAGE_SIZE } },
         );
-        setRecords((prev) => (cursor == null ? data.items : [...prev, ...data.items]));
-        setNextCursor(data.next_cursor);
+        setRecords(data.items);
+        setTotal(data.total ?? 0);
       } catch (e) {
         message.error(errMsg(e));
       } finally {
@@ -96,9 +98,11 @@ export default function UserRewardPanel({ userId, user }: Props) {
     [userId, paramsKey],
   );
 
+  // 用户或时间筛选变化:回到第 1 页重新拉取
   useEffect(() => {
     loadStats();
-    loadRecords(null);
+    setPage(1);
+    loadRecords(1);
   }, [loadStats, loadRecords]);
 
   const regDays = user?.created_at ? dayjs().diff(apiTime(user.created_at), 'day') : null;
@@ -162,7 +166,7 @@ export default function UserRewardPanel({ userId, user }: Props) {
         </Space>
       </Space>
 
-      {/* 统计区(受时间筛选;现金余额为当前快照) */}
+      {/* 统计区(受时间筛选;现金余额为当前快照)。ad 视图只保留看广告观看统计(对齐参考图 6 项) */}
       <Descriptions bordered size="small" column={2} style={{ marginBottom: 8 }}>
         <Descriptions.Item label="累计提现">
           {stats ? yuan(stats.withdraw_success_cents) : '-'}
@@ -170,29 +174,51 @@ export default function UserRewardPanel({ userId, user }: Props) {
         <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>
+        {statsVariant === 'ad' ? (
+          <>
+            <Descriptions.Item label="激励视频观看数">
+              {stats?.reward_video_count ?? '-'}
+            </Descriptions.Item>
+            {/* eCPM 均按元展示(reward_video / feed avg_ecpm 原始为分/千次,÷100 转元) */}
+            <Descriptions.Item label="平均激励视频ECPM">
+              {stats ? `${(stats.reward_video_avg_ecpm / 100).toFixed(2)} 元/千` : '-'}
+            </Descriptions.Item>
+            <Descriptions.Item label="draw信息流视频观看数">
+              {stats?.feed_count ?? '-'}
+            </Descriptions.Item>
+            <Descriptions.Item label="平均draw信息流ECPM">
+              {stats ? `${(stats.feed_avg_ecpm / 100).toFixed(2)} 元/千` : '-'}
+            </Descriptions.Item>
+          </>
+        ) : (
+          <>
+            <Descriptions.Item label="提现总次数">{stats?.withdraw_total ?? '-'}</Descriptions.Item>
+            <Descriptions.Item label="传统任务提现">
+              {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 单位分/千次,同金币审计。
+        {statsVariant === 'ad'
+          ? '统计随上方时间筛选(现金余额除外,为当前快照);eCPM 均按元展示(原始分/千次 ÷100)。'
+          : '统计随上方时间筛选(现金余额除外,为当前快照);eCPM 单位分/千次,同金币审计。'}
       </Text>
 
       {/* 金币记录 */}
@@ -203,18 +229,18 @@ export default function UserRewardPanel({ userId, user }: Props) {
         columns={columns}
         dataSource={records}
         loading={recordsLoading || statsLoading}
-        pagination={false}
+        pagination={{
+          current: page,
+          pageSize: PAGE_SIZE,
+          total,
+          showSizeChanger: false,
+          onChange: (p) => {
+            setPage(p);
+            loadRecords(p);
+          },
+          showTotal: (t) => `共 ${t} 条`,
+        }}
       />
-      <div style={{ marginTop: 12, textAlign: 'center' }}>
-        <Button
-          size="small"
-          onClick={() => loadRecords(nextCursor)}
-          disabled={!nextCursor}
-          loading={recordsLoading}
-        >
-          {nextCursor ? '加载更多' : '没有更多了'}
-        </Button>
-      </div>
     </div>
   );
 }

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

@@ -104,6 +104,19 @@ const SORT_OPTIONS = [
   { value: 'created_at', label: '申请时间' },
   { value: 'amount_cents', label: '提现金额' },
 ];
+// 提现类型:coin_cash=福利页提现(金币兑换现金) / invite_cash=邀请提现(邀请奖励金)
+const SOURCE_LABEL: Record<string, string> = {
+  coin_cash: '福利页提现',
+  invite_cash: '邀请提现',
+};
+const SOURCE_COLOR: Record<string, string> = {
+  coin_cash: 'blue',
+  invite_cash: 'purple',
+};
+const SOURCE_OPTIONS = [
+  { value: 'coin_cash', label: '福利页提现' },
+  { value: 'invite_cash', label: '邀请提现' },
+];
 const DATE_FIELD_OPTIONS = [
   { value: 'created_at', label: '申请时间' },
   { value: 'updated_at', label: '更新时间' },
@@ -149,9 +162,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;
 }
 
@@ -183,9 +197,11 @@ export default function WithdrawsPage() {
   const [sortBy, setSortBy] = useState<'created_at' | 'amount_cents'>('created_at');
   const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc');
   const [quickFilter, setQuickFilter] = useState<string | undefined>(undefined);
+  const [source, setSource] = useState<string | undefined>(undefined);
 
   const filters: Record<string, unknown> = {};
   if (activeStatus !== 'all') filters.status = activeStatus;
+  if (source) filters.source = source;
   if (keyword.trim()) filters.keyword = keyword.trim();
   if (dateRange?.[0]) filters.date_from = dateRange[0].startOf('day').toISOString();
   if (dateRange?.[1]) filters.date_to = dateRange[1].endOf('day').toISOString();
@@ -210,6 +226,7 @@ export default function WithdrawsPage() {
     setSortBy('created_at');
     setSortOrder('desc');
     setQuickFilter(undefined);
+    setSource(undefined);
   };
 
   const applyQuickFilter = (value?: string) => {
@@ -480,6 +497,12 @@ export default function WithdrawsPage() {
       width: 120,
       render: (v: number) => <Text strong>{yuan(v)}</Text>,
     },
+    {
+      title: '提现类型',
+      dataIndex: 'source',
+      width: 110,
+      render: (v: string) => <Tag color={SOURCE_COLOR[v] || 'default'}>{SOURCE_LABEL[v] || v}</Tag>,
+    },
     {
       title: '累计提现',
       dataIndex: 'cumulative_success_cents',
@@ -601,12 +624,27 @@ export default function WithdrawsPage() {
   const rejectAmount = rejectTargets.reduce((sum, item) => sum + item.amount_cents, 0);
   const ledgerIssues = ledger
     ? [
-        ledger.balance_diff_cents ? `余额差额 ${yuan(ledger.balance_diff_cents)}` : '',
-        ledger.missing_withdraw_txn_count ? `缺扣款流水 ${ledger.missing_withdraw_txn_count} 笔` : '',
-        ledger.missing_refund_txn_count ? `缺退款流水 ${ledger.missing_refund_txn_count} 笔` : '',
-        ledger.duplicate_refund_txn_count ? `重复退款流水 ${ledger.duplicate_refund_txn_count} 类` : '',
+        // 普通现金账(coin_cash)
+        ledger.balance_diff_cents ? `现金余额差额 ${yuan(ledger.balance_diff_cents)}` : '',
+        ledger.missing_withdraw_txn_count ? `现金缺扣款流水 ${ledger.missing_withdraw_txn_count} 笔` : '',
+        ledger.missing_refund_txn_count ? `现金缺退款流水 ${ledger.missing_refund_txn_count} 笔` : '',
+        ledger.duplicate_refund_txn_count ? `现金重复退款流水 ${ledger.duplicate_refund_txn_count} 类` : '',
         ledger.refund_txn_on_non_terminal_count
-          ? `非退款终态存在退款流水 ${ledger.refund_txn_on_non_terminal_count} 笔`
+          ? `现金非退款终态存在退款流水 ${ledger.refund_txn_on_non_terminal_count} 笔`
+          : '',
+        // 邀请奖励金账(invite_cash)
+        ledger.invite_balance_diff_cents ? `邀请金余额差额 ${yuan(ledger.invite_balance_diff_cents)}` : '',
+        ledger.invite_missing_withdraw_txn_count
+          ? `邀请金缺扣款流水 ${ledger.invite_missing_withdraw_txn_count} 笔`
+          : '',
+        ledger.invite_missing_refund_txn_count
+          ? `邀请金缺退款流水 ${ledger.invite_missing_refund_txn_count} 笔`
+          : '',
+        ledger.invite_duplicate_refund_txn_count
+          ? `邀请金重复退款流水 ${ledger.invite_duplicate_refund_txn_count} 类`
+          : '',
+        ledger.invite_refund_txn_on_non_terminal_count
+          ? `邀请金非退款终态存在退款流水 ${ledger.invite_refund_txn_on_non_terminal_count} 笔`
           : '',
       ].filter(Boolean)
     : [];
@@ -646,7 +684,7 @@ export default function WithdrawsPage() {
               message={ledger.ok ? '现金账本校验正常' : '现金账本存在异常'}
               description={
                 ledger.ok
-                  ? `账户余额合计 ${yuan(ledger.cash_balance_total_cents)}，现金流水净额 ${yuan(ledger.cash_transaction_total_cents)}`
+                  ? `现金 余额 ${yuan(ledger.cash_balance_total_cents)} / 流水 ${yuan(ledger.cash_transaction_total_cents)}；邀请金 余额 ${yuan(ledger.invite_cash_balance_total_cents)} / 流水 ${yuan(ledger.invite_cash_transaction_total_cents)}`
                   : ledgerIssues.join('；')
               }
               action={
@@ -723,6 +761,14 @@ export default function WithdrawsPage() {
               }}
               onSearch={(value) => setKeyword(value.trim())}
             />
+            <Select
+              value={source}
+              allowClear
+              placeholder="提现类型"
+              style={{ width: 140 }}
+              options={SOURCE_OPTIONS}
+              onChange={(value?: string) => setSource(value)}
+            />
             <Select
               value={quickFilter}
               allowClear
@@ -848,7 +894,7 @@ export default function WithdrawsPage() {
             showTotal: (t) => `共 ${t} 条`,
             onChange: onPageChange,
           }}
-          scroll={{ x: 1350 }}
+          scroll={{ x: 1460 }}
           onRow={(record) => ({
             onClick: () => openDetail(record),
             style: { cursor: 'pointer' },
@@ -858,7 +904,7 @@ export default function WithdrawsPage() {
 
       <Drawer
         title="提现详情"
-        width={720}
+        width="50%"
         open={drawerOpen}
         onClose={() => setDrawerOpen(false)}
         extra={
@@ -880,6 +926,11 @@ export default function WithdrawsPage() {
                 <Descriptions.Item label="金额">
                   <Text strong>{yuan(detail.order.amount_cents)}</Text>
                 </Descriptions.Item>
+                <Descriptions.Item label="提现类型">
+                  <Tag color={SOURCE_COLOR[detail.order.source] || 'default'}>
+                    {SOURCE_LABEL[detail.order.source] || detail.order.source}
+                  </Tag>
+                </Descriptions.Item>
                 <Descriptions.Item label="提现实名">
                   {detail.order.user_name || '-'}
                 </Descriptions.Item>
@@ -900,7 +951,7 @@ export default function WithdrawsPage() {
               <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) => (

src/components/AdjustBalanceModals.tsx

@@ -3,7 +3,7 @@
 // 调金币 / 调现金弹窗(受控)。列表页与用户详情页共用,避免两处各写一套。
 // 每个弹窗自带「增减 / 设为指定值」两种模式;打开时拉一次 360 概览展示当前余额。
 import { useEffect, useState } from 'react';
-import { App, Form, Input, InputNumber, Modal, Segmented } from 'antd';
+import { App, Form, Input, InputNumber, Modal, Radio, Segmented } from 'antd';
 import { api, errMsg } from '@/lib/api';
 import { yuan } from '@/lib/format';
 import type { UserOverview } from '@/lib/types';
@@ -17,15 +17,19 @@ interface ModalProps {
   onDone?: () => void; // 调整成功后回调(刷新余额/列表)
 }
 
-const balanceLine = (balances: { coin: number; cashCents: number } | null) => (
+type Balances = { coin: number; cashCents: number; inviteCashCents: number };
+
+const balanceLine = (balances: Balances | null) => (
   <p style={{ color: '#888', marginBottom: 12 }}>
-    当前余额:金币 {balances ? balances.coin : '…'} ｜ 现金 {balances ? yuan(balances.cashCents) : '…'}
+    当前余额:金币 {balances ? balances.coin : '…'} ｜ 现金(金币兑现金){' '}
+    {balances ? yuan(balances.cashCents) : '…'} ｜ 邀请奖励金{' '}
+    {balances ? yuan(balances.inviteCashCents) : '…'}
   </p>
 );
 
 // 弹窗打开时拉一次该用户余额;用户切换/关闭时丢弃过期响应(alive 标记防竞态)。
 function useBalances(userId: number | undefined, open: boolean) {
-  const [balances, setBalances] = useState<{ coin: number; cashCents: number } | null>(null);
+  const [balances, setBalances] = useState<Balances | null>(null);
   useEffect(() => {
     if (!open || userId == null) {
       setBalances(null);
@@ -36,7 +40,12 @@ function useBalances(userId: number | undefined, open: boolean) {
     api
       .get<UserOverview>(`/admin/api/users/${userId}`)
       .then((r) => {
-        if (alive) setBalances({ coin: r.data.coin_balance, cashCents: r.data.cash_balance_cents });
+        if (alive)
+          setBalances({
+            coin: r.data.coin_balance,
+            cashCents: r.data.cash_balance_cents,
+            inviteCashCents: r.data.invite_cash_balance_cents,
+          });
       })
       .catch(() => {});
     return () => {
@@ -113,39 +122,39 @@ 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');
+  // 操作方式改为表单必选项(无默认、手动选);用 watch 驱动金额栏文案/最小值
+  const mode = Form.useWatch('mode', form) as 'delta' | 'set' | undefined;
   const balances = useBalances(user?.id, open);
 
   useEffect(() => {
-    if (open) {
-      setMode('delta');
-      form.resetFields();
-    }
+    if (open) form.resetFields(); // 目标账户 / 操作方式 都重置为「未选」
   }, [open, form]);
 
   // 输入元,×100 转分后调后端(主要给无现金用户发钱直接测试提现)
   const submit = async () => {
     if (!user) return;
-    const v = await form.validateFields();
+    const v = await form.validateFields(); // 任一必填/必选缺失 → 该项下方红字 + 阻断提交
     const amountCents = Math.round(Number(v.amount_yuan) * 100);
-    if (mode === 'delta' && amountCents === 0) {
+    if (v.mode === 'delta' && amountCents === 0) {
       message.warning('金额不能为 0(且不小于 1 分)');
       return;
     }
-    if (mode === 'set' && amountCents < 0) {
+    if (v.mode === 'set' && amountCents < 0) {
       message.warning('目标金额不能为负');
       return;
     }
+    const acctName = v.account === 'invite_cash' ? '邀请奖励金' : '现金';
     try {
       await api.post(`/admin/api/users/${user.id}/cash`, {
-        mode,
+        account: v.account,
+        mode: v.mode,
         amount_cents: amountCents,
         reason: v.reason,
       });
       message.success(
-        mode === 'set'
-          ? `已设为 ¥${(amountCents / 100).toFixed(2)} 现金`
-          : `已${amountCents > 0 ? '发放' : '扣减'} ¥${(Math.abs(amountCents) / 100).toFixed(2)} 现金`,
+        v.mode === 'set'
+          ? `已设为 ¥${(amountCents / 100).toFixed(2)} ${acctName}`
+          : `已${amountCents > 0 ? '发放' : '扣减'} ¥${(Math.abs(amountCents) / 100).toFixed(2)} ${acctName}`,
       );
       onClose();
       onDone?.();
@@ -164,10 +173,20 @@ export function AdjustCashModal({ user, open, onClose, onDone }: ModalProps) {
     >
       {balanceLine(balances)}
       <Form form={form} layout="vertical">
-        <Form.Item label="操作方式">
-          <Segmented
-            value={mode}
-            onChange={(v) => setMode(v as 'delta' | 'set')}
+        <Form.Item name="account" label="目标账户" rules={[{ required: true, message: '请选择目标账户' }]}>
+          <Radio.Group
+            optionType="button"
+            buttonStyle="solid"
+            options={[
+              { label: '金币兑现金账户', value: 'coin_cash' },
+              { label: '邀请账户', value: 'invite_cash' },
+            ]}
+          />
+        </Form.Item>
+        <Form.Item name="mode" label="操作方式" rules={[{ required: true, message: '请选择操作方式' }]}>
+          <Radio.Group
+            optionType="button"
+            buttonStyle="solid"
             options={[
               { label: '增减', value: 'delta' },
               { label: '设为指定值', value: 'set' },
@@ -182,7 +201,7 @@ export function AdjustCashModal({ user, open, onClose, onDone }: ModalProps) {
               : '现金变动(元,正=发放,负=扣减;不可扣成负)'
           }
           rules={[
-            { required: true },
+            { required: true, message: '请输入现金变动金额' },
             ...(mode === 'set' ? [{ type: 'number' as const, min: 0, message: '目标值不能为负' }] : []),
           ]}
         >
@@ -194,7 +213,7 @@ export function AdjustCashModal({ user, open, onClose, onDone }: ModalProps) {
             min={mode === 'set' ? 0 : undefined}
           />
         </Form.Item>
-        <Form.Item name="reason" label="原因(入审计)" rules={[{ required: true }]}>
+        <Form.Item name="reason" label="原因(入审计)" rules={[{ required: true, message: '请填写原因' }]}>
           <Input.TextArea rows={2} />
         </Form.Item>
       </Form>

src/components/DeleteUserModal.tsx

@@ -0,0 +1,61 @@
+'use client';
+
+// 注销/删除账号弹窗(受控)。列表页与用户详情页共用,避免两处各写一套(同 AdjustBalanceModals)。
+// 复用 C 端自助注销同一套后端清理:物理删除个人内容/行为/PII 表 + 清零余额 + 匿名化 user 行,
+// 保留资金流水/邀请关系/广告幂等+对账表。仅 super_admin 可见入口;后端亦 require_role("super_admin") 兜底。
+// 后端资金前置闸(有未提现现金/邀请金 / 在审提现单 → 409)带明确 detail,errMsg 原样透出。
+import { App, Form, Input, Modal } from 'antd';
+import { api, errMsg } from '@/lib/api';
+
+export type DeleteTargetUser = { id: number; phone: string };
+
+interface Props {
+  user: DeleteTargetUser | null;
+  open: boolean;
+  onClose: () => void;
+  onDone?: () => void; // 删除成功后回调(刷新详情/列表)
+}
+
+export function DeleteUserModal({ user, open, onClose, onDone }: Props) {
+  const { message } = App.useApp();
+  const [form] = Form.useForm();
+
+  const submit = async () => {
+    if (!user) return;
+    const v = await form.validateFields(); // 原因必填,缺失即红字阻断
+    try {
+      // axios 的 DELETE 带 body 要放在 config.data 里
+      await api.delete(`/admin/api/users/${user.id}`, { data: { reason: v.reason } });
+      message.success('账号已注销');
+      onClose();
+      onDone?.();
+    } catch (e) {
+      message.error(errMsg(e));
+    }
+  };
+
+  return (
+    <Modal
+      title={`注销账号 - ${user?.phone ?? ''}`}
+      open={open}
+      onOk={submit}
+      onCancel={onClose}
+      okText="确认注销"
+      okButtonProps={{ danger: true }}
+      afterOpenChange={(o) => {
+        if (o) form.resetFields();
+      }}
+      destroyOnHidden
+    >
+      <p style={{ color: '#cf1322', marginBottom: 12 }}>
+        将永久删除该账号的个人数据(比价/省钱/签到/领券/埋点/设备/邀请指纹等)并清零余额、匿名化手机号,
+        <strong>不可恢复</strong>。资金流水/邀请关系/广告对账记录按合规保留。
+      </p>
+      <Form form={form} layout="vertical">
+        <Form.Item name="reason" label="注销原因(入审计)" rules={[{ required: true, message: '请填写注销原因' }]}>
+          <Input.TextArea rows={2} />
+        </Form.Item>
+      </Form>
+    </Modal>
+  );
+}

src/components/UserRecordsDrawer.tsx

@@ -0,0 +1,113 @@
+'use client';
+
+// 点列表里的手机号 → 抽屉列出该用户「同类型」的全部记录(反馈页=全部反馈;低价审核页=全部上报)。
+// 顶部汇总该用户的「提交/上报总计」+「奖励总计」;复用各自的 list 接口按 user_id 过滤(无需新后端接口)。
+import { useEffect, useState } from 'react';
+import { Drawer, Empty, Space, Spin, Statistic, Table, Typography } from 'antd';
+import type { ColumnsType } from 'antd/es/table';
+import { api } from '@/lib/api';
+import type { CursorPage } from '@/lib/types';
+
+const { Text } = Typography;
+
+interface Props<T> {
+  open: boolean;
+  onClose: () => void;
+  userId: number | null;
+  phone: string | null;
+  endpoint: string; // 列表接口,按 user_id 过滤,如 /admin/api/feedbacks
+  columns: ColumnsType<T>;
+  recordLabel: string; // 「反馈」/「低价上报」,用于标题与空态文案
+  countLabel: string; // 顶部计数卡标题,如「提交总计」/「上报总计」
+  rewardLabel: string; // 顶部奖励卡标题,如「提交奖励总计」/「上报奖励总计」
+  rewardOf: (item: T) => number; // 单条已发奖励金币(未采纳/未通过返回 0)
+  rewardSuffix?: string; // 第二个汇总卡单位,默认「金币」;领券场景可传「张」(领到券张数)等
+}
+
+export default function UserRecordsDrawer<T extends { id: number }>({
+  open,
+  onClose,
+  userId,
+  phone,
+  endpoint,
+  columns,
+  recordLabel,
+  countLabel,
+  rewardLabel,
+  rewardOf,
+  rewardSuffix = '金币',
+}: Props<T>) {
+  const [items, setItems] = useState<T[]>([]);
+  const [total, setTotal] = useState(0);
+  const [loading, setLoading] = useState(false);
+
+  useEffect(() => {
+    if (!open || userId == null) return;
+    let alive = true;
+    setLoading(true);
+    api
+      .get<CursorPage<T>>(endpoint, {
+        params: { user_id: userId, limit: 100, sort_by: 'created_at', sort_order: 'desc' },
+      })
+      .then((r) => {
+        if (!alive) return;
+        setItems(r.data.items);
+        setTotal(r.data.total ?? r.data.items.length);
+      })
+      .catch(() => {
+        if (!alive) return;
+        setItems([]);
+        setTotal(0);
+      })
+      .finally(() => {
+        if (alive) setLoading(false);
+      });
+    return () => {
+      alive = false;
+    };
+  }, [open, userId, endpoint]);
+
+  // 奖励总计在已加载记录上累加(单用户记录数远小于 100 上限,够用)
+  const rewardTotal = items.reduce((sum, it) => sum + rewardOf(it), 0);
+
+  return (
+    <Drawer
+      title={
+        <span>
+          用户 #{userId ?? '-'} 的全部{recordLabel}
+          {phone ? (
+            <Text type="secondary" style={{ fontSize: 13, marginLeft: 8 }}>
+              {phone}
+            </Text>
+          ) : null}
+        </span>
+      }
+      width={760}
+      open={open}
+      onClose={onClose}
+      destroyOnHidden
+    >
+      {loading ? (
+        <Spin style={{ display: 'block', margin: '40px auto' }} />
+      ) : (
+        <>
+          <Space size={48} style={{ marginBottom: 20 }}>
+            <Statistic title={countLabel} value={total} />
+            <Statistic title={rewardLabel} value={rewardTotal} suffix={rewardSuffix} />
+          </Space>
+          {items.length === 0 ? (
+            <Empty description={`该用户暂无${recordLabel}`} style={{ marginTop: 24 }} />
+          ) : (
+            <Table<T>
+              rowKey="id"
+              size="small"
+              columns={columns}
+              dataSource={items}
+              pagination={false}
+            />
+          )}
+        </>
+      )}
+    </Drawer>
+  );
+}

src/lib/types.ts

@@ -3,10 +3,32 @@
 export interface AdminInfo {
   id: number;
   username: string;
-  role: string; // super_admin / finance / operator
+  role: string; // super_admin / finance / operator / custom(自定义) / 自定义角色名
   status: string;
   created_at: string;
   last_login_at: string | null;
+  pages?: string[]; // 当前有效可见页 key(登录 / /me 下发);super_admin = 全部页;role==custom = pages_override。左侧导航按此过滤
+  pages_override?: string[] | null; // 「自定义」勾选的可见页原始集(role==custom 时非空);列表接口下发,供编辑回填勾选
+  password?: string | null; // 明文登录密码(仅账号列表下发);无留存(脚本建的超管)为 null → 不显示
+}
+
+// RBAC:页面权限目录(= 左侧导航项,后端 /admin/api/roles/catalog 下发)
+export interface PermissionPage {
+  key: string;
+  label: string;
+}
+export interface PermissionGroup {
+  group: string;
+  pages: PermissionPage[];
+}
+// RBAC:角色(可见页集合)
+export interface AdminRole {
+  id: number;
+  name: string; // 角色 key(承重,admin_user.role 引用)
+  label: string; // 展示名(UI 显示,如 管理员/运营/财务/技术)
+  pages: string[]; // 该角色有效可见页 key(super_admin = 全部)
+  is_builtin: boolean; // 内建(super_admin):不可编辑/删除
+  in_use: number; // 使用该角色的管理员数
 }
 
 export interface LoginResponse {
@@ -35,6 +57,8 @@ export interface UserListItem {
   wechat_openid: string | null;
   created_at: string;
   last_login_at: string;
+  // 最近活跃 = max(最近登录, 最近发起比价, 最近发起领券);与大盘 DAU/留存活跃口径一致
+  last_active_at: string | null;
 }
 
 // 设备维度新手引导:一台设备(ANDROID_ID)聚合,走过引导的账号数 + 最近完成时间。
@@ -44,10 +68,44 @@ 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;
   cash_balance_cents: number;
+  invite_cash_balance_cents: number; // 邀请奖励金余额(与 cash_balance_cents 物理隔离)
   total_coin_earned: number;
   comparison_total: number;
   comparison_success: number;
@@ -83,6 +141,8 @@ export interface WithdrawOrder {
   user_id: number;
   out_bill_no: string;
   amount_cents: number;
+  // 提现类型:coin_cash(福利页提现,金币兑换现金) / invite_cash(邀请提现,邀请奖励金)
+  source: string;
   user_name: string | null;
   status: string; // reviewing / pending / success / failed / rejected
   wechat_state: string | null;
@@ -174,6 +234,7 @@ export interface WithdrawBulkResult {
 
 export interface WithdrawLedgerCheck {
   ok: boolean;
+  // 普通现金账(coin_cash)
   cash_balance_total_cents: number;
   cash_transaction_total_cents: number;
   balance_diff_cents: number;
@@ -181,6 +242,14 @@ export interface WithdrawLedgerCheck {
   missing_refund_txn_count: number;
   duplicate_refund_txn_count: number;
   refund_txn_on_non_terminal_count: number;
+  // 邀请奖励金账(invite_cash:与普通现金物理隔离,各自对账)
+  invite_cash_balance_total_cents: number;
+  invite_cash_transaction_total_cents: number;
+  invite_balance_diff_cents: number;
+  invite_missing_withdraw_txn_count: number;
+  invite_missing_refund_txn_count: number;
+  invite_duplicate_refund_txn_count: number;
+  invite_refund_txn_on_non_terminal_count: number;
 }
 
 export interface WxpayHealthCheck {
@@ -205,9 +274,36 @@ export interface Feedback {
   user_id: number;
   content: string;
   contact: string;
+  // 反馈来源入口:profile(「我的」页=普通反馈) / comparison(比价结果页=比价反馈)
+  source: string;
+  // 比价反馈的问题场景(找错商品/优惠不对…);普通反馈为 null
+  scene: string | null;
   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; // 审核批注(采纳要点 / 内部备注,用户不可见)
+  admin_reply: string | null; // 运营给用户的回复留言(用户端可见)
+  reviewed_by_admin_id: number | null;
+  reviewed_at: string | null;
   created_at: string;
+  // 提交端环境快照:提交版本号 / 机型OS版本;改版前的历史反馈为 null
+  app_version: string | null;
+  device_model: string | null;
+  rom_name: string | null;
+  android_version: string | null;
+  // 联表瞬态:展示完整手机号(点手机号查该用户全部反馈)
+  phone: string | null;
+  nickname: string | null;
+}
+
+// 反馈审核台顶部各状态计数(pending 含历史 new 态)。后端 GET /admin/api/feedbacks/summary。
+export interface FeedbackSummary {
+  pending: number;
+  adopted: number;
+  rejected: number;
+  total: number;
 }
 
 // 反馈页「加群二维码」卡配置(运营后台改 → App 意见反馈页同步)。
@@ -246,6 +342,7 @@ export interface ComparisonRecordListItem {
   status: string;
   information: string | null;
   store_name: string | null;
+  product_names: string | null; // 下单商品名派生串(顿号分隔),「商品」列展示
   source_platform_name: string | null;
   best_platform_name: string | null;
   source_price_cents: number | null;
@@ -255,6 +352,8 @@ export interface ComparisonRecordListItem {
   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;
@@ -324,44 +423,90 @@ export interface AdRevenueRecord {
   matched: boolean;
 }
 
-// 广告收益报表:按日期汇总的一天(按天趋势图用;全量,不受 limit 影响)
+// 广告收益报表:按日期汇总的一天(按天趋势图用;全量,不受分页影响)
 export interface AdRevenueDaily {
   date: string; // 北京时间 YYYY-MM-DD
   impressions: number;
+  revenue_yuan: number; // 客户端预估收益(eCPM 折算)
+  pangle_revenue_yuan: number | null; // 穿山甲后台预估收益(GroMore revenue);非全量视图/无数据为 null
+  pangle_api_revenue_yuan: number | null; // 穿山甲收益API(更接近结算);未配/当天/无数据为 null
+  expected_coin: number;
+  actual_coin: number;
+}
+
+// 广告收益报表:按北京小时(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 {
-  report_date: string; // 该组所属日期 北京时间 YYYY-MM-DD
+  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)
-  impressions: number; // 展示条数(轮播每条各计一次)
-  revenue_yuan: number; // 收益(元),预估口径
-  expected_coin: number; // 应发金币(公式复算,与金币审计同源)
-  actual_coin: number; // 实发金币(实际入账)
-  matched: boolean; // 该组应发==实发
-  adns: string[]; // 底层填充 ADN 子渠道集合
-  impression_records: AdRevenueImpression[]; // 该组逐条展示明细(展开下钻)
-  records: AdRevenueRecord[]; // 该组逐条发奖复算明细(展开下钻)
+  created_at: string; // 事件时间(有展示=展示时间,纯发奖=发奖时间)
+  // ── 展示侧 ──
+  has_impression: boolean; // 是否有广告展示(信息流逐条展示=true,纯发奖行=false)
+  impressions: number; // 本行展示条数 1/0(供日汇总、趋势图复用)
+  ecpm: string | null; // 分/千次;展示行取展示值,纯发奖行取发奖采用值
+  revenue_yuan: number; // 本次展示预估收益(元);纯发奖行=0
+  row_revenue_yuan?: number | null; // 主表逐行显示用:一次比价/领券聚合行=该次发奖广告 eCPM 折算之和;其它行空(回退 revenue_yuan)
+  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; // 发奖复算明细(点行展开下钻);纯展示为空
+  sub_rewards?: AdRevenueRecord[]; // 一次比价/领券聚合行的组内逐条明细(同整场 ad_session_id 的多条广告);展开渲染多行
+  sub_count?: number; // 本行聚合的发奖条数:一次比价/领券=该次广告条数(≥1);激励视频/纯展示=1
 }
 
 export interface AdRevenueReport {
   date_from: string; // 起始日 北京时间 YYYY-MM-DD
   date_to: string; // 结束日 北京时间 YYYY-MM-DD(闭区间;单日时与 date_from 相同)
   daily: AdRevenueDaily[]; // 按日期汇总序列(全量,供按天趋势图)
-  total: number; // 聚合组总数(全量,不受 limit 影响)
-  truncated: boolean;
+  hourly: AdRevenueHourly[]; // 按小时汇总序列(全量,供按小时趋势图;按天查询时为空)
+  type_stats: Record<string, AdRevenueTypeStat>; // 按广告类型小计;前端取 draw / reward_video
+  // 按信息流场景小计(comparison/coupon/welfare;全量,不受分页截断)。数据大盘「领券广告/比价广告」卡
+  // 优先读它:2026-07-02 后端起 items 不再含信息流逐条展示行(唯一带收益+场景的行),按 items 现算恒 0。
+  // 可选(`?.` 探测)以兼容未升级后端,缺失时回退 items 现算。
+  scene_stats?: Record<string, AdRevenueTypeStat>;
+  // 可选:后端预聚合的「按广告类型」富小计(含发放金币明细)。当前后端未下发 → 数据大盘页
+  // (dashboard adTypeSummary)用 `?.` 探测、缺失时按 items 现算兜底;后端补上即自动启用。
+  by_ad_type?: Record<
+    string,
+    { ad_type: string; impressions: number; revenue_yuan: number; expected_coin: number; actual_coin: number }
+  >;
+  dau: number | null; // 区间去重活跃用户(口径同数据大盘 period.users.active:登录+开始比价+开始领券);按查询区间统计、含今日,全局口径不随筛选变化
+  total: number; // 当前筛选下的分页总条数(全量,不受分页影响)
+  truncated: boolean; // 当前页之后是否还有更多事件(分页后前端不再据此报警)
   total_impressions: number;
-  total_revenue_yuan: number;
+  total_revenue_yuan: number; // 客户端预估收益合计(eCPM 折算)
+  total_pangle_revenue_yuan: number | null; // 穿山甲后台预估收益合计(GroMore revenue);非全量视图/无数据为 null
+  total_pangle_api_revenue_yuan: number | null; // 穿山甲收益API合计(更接近结算);未配/当天/非全量视图为 null
+  pangle_revenue_available: boolean; // 本次结果是否带穿山甲后台收益(全量视图且已同步到数据)
   total_expected_coin: number;
   total_actual_coin: number;
-  mismatch_count: number; // 应发≠实发的组数
+  mismatch_count: number; // 应发≠实发的发奖条数
   items: AdRevenueRow[];
 }
 
@@ -374,7 +519,17 @@ export interface DashboardOverview {
     new_today: number;
     dau: number;
   };
-  coins: { granted_total: number };
+  coins: {
+    reward_video_coin_total: number;
+    reward_video_watch_count: number;
+    feed_ad_coin_total: number;
+    feed_ad_watch_count: number;
+    signin_coin_total: number;
+    signin_count: number;
+    signin_boost_coin_total: number;
+    signin_boost_watch_count: number;
+    granted_total: number;
+  };
   cash: {
     withdraw_success_cents: number;
     withdraw_pending_count: number;
@@ -382,8 +537,73 @@ export interface DashboardOverview {
     withdraw_failed_count: number;
   };
   comparison: { total: number; success: number; success_rate: number };
+  // 时段大盘(对应后端 app/admin/schemas/dashboard.py DashboardPeriod);新版数据大盘页用
+  period: {
+    date_from: string;
+    date_to: string;
+    users: {
+      new: number;
+      active: number;
+      retained_new_users: number;
+      // 次日留存基数:窗口内逐日「前一日新增用户数」之和(retention_rate 的分母;旧后端无此字段)
+      retention_cohort?: number;
+      retention_rate: number | null;
+      retention_note: string;
+    };
+    comparison: {
+      total: number;
+      success: number;
+      success_rate: number;
+      ordered: number;
+      average_duration_ms: number | null;
+      average_saved_cents: number | null;
+    };
+    // 领券核心数据(2026-07-05 新增;旧后端无此字段,前端 `?.` 探测)。
+    // 点位=一张券;成功口径 success+already_claimed;点位成功率分母=发起数×应领点位数(未跑到视为失败)。
+    coupon?: {
+      started: number;
+      all_success: number; // 全部点位领成功的完成场次数
+      success_rate: number | null;
+      point_success: number;
+      points_per_session: number | null; // 应领点位数(本期完成场点位数众数)
+      point_success_rate: number | null;
+      median_elapsed_ms: number | null; // 仅 completed,同「领券数据」页口径
+    };
+    coins: {
+      granted_total: number;
+      reward_video_coin_total: number;
+      feed_ad_coin_total: number;
+      signin_coin_total: number;
+      signin_boost_coin_total: number;
+      task_coin_total: number;
+      coupon_reward_coin_total: number;
+      comparison_reward_coin_total: number;
+      regular_task_coin_total: number;
+    };
+    cash: { withdraw_success_cents: number };
+    trend: {
+      date: string;
+      active_users: number;
+      new_users: number;
+      comparisons: number;
+    }[];
+  };
   feedback: { new: number };
-  cps: { available: boolean; note: string };
+  cps: {
+    available: boolean;
+    note: string;
+    meituan_order_count: number;
+    meituan_commission_cents: number;
+    meituan_hit_count: number;
+    meituan_miss_count: number;
+    meituan_unknown_rate_count: number;
+    meituan_hit_rate: number | null;
+    jd_order_count?: number;
+    jd_commission_cents?: number;
+    jd_actual_commission_cents?: number;
+    jd_estimated_commission_cents?: number;
+    jd_invalid_count?: number;
+  };
 }
 
 export interface PriceReport {
@@ -404,6 +624,16 @@ export interface PriceReport {
   reward_coins: number | null;
   reviewed_at: string | null;
   created_at: string;
+  // 联表瞬态:phone/nickname 展示完整手机号(点手机号查该用户全部上报);
+  // 其余取自关联比价记录(无关联记录时为 null):trace 调试链接、机型OS版本、提交版本号
+  phone: string | null;
+  nickname: string | null;
+  trace_id: string | null;
+  trace_url: string | null;
+  device_model: string | null; // 机型,如 PEEM00
+  rom_name: string | null; // ROM/OS 名,如 ColorOS / MIUI / HarmonyOS
+  android_version: string | null; // Android 版本号,如 13
+  app_version: string | null; // 提交时我们 app 的 versionName,如 1.2.3
 }
 
 export interface PriceReportSummary {