---
status: LOCKED (V1.0 baseline; open Qs accepted as preferred default 2026-05-08)
owner: PM + UX + Architect
version: V1.0
updated: 2026-05-08
based_on:
  - prototype/admin-users-V1.0.md
  - prototype/admin-deposits-V1.0.md
  - 与用户的迭代讨论 2026-05-07 ~ 2026-05-08
note: V1.0 是产品唯一版本;之前的 v2/v3 prototype 和 product-admin-spec 已删除
---

# 运营后台 V1.0 — IA 总图 + 后台开发需求功能 / Ops Admin V1.0 — Full IA + Feature Requirements

> **本文档目的 / Purpose**:
> 1. 单一权威源 / Single source of truth — 整个运营后台的顶层 IA 和模块功能
> 2. 产品对齐 / Product alignment — PM / UX / 开发先看这份再展开
> 3. 排期基础 / Schedule base — 后端 / 前端按这份估工作量
>
> **不在本文档 / Not here**:
> - 每个屏的列字段 / 详情 tab / API 契约 — 在 `admin-<module>-V1.0.md` per-module drafts
> - 视觉风格 / 组件库 — cyberpunk-neon(`#0B0A1F + #D0FF1D`)+ vue-vben-admin

---

## 0. 设计原则 / Design Principles

### 0.1 北极星 / North star

按**运营人一天的工作流**组织,不按数据库表。
Organize by ops persona daily workflow, not DB tables.

### 0.2 6 条边界规则 / 6 boundary rules

| # | 规则 | 含义 |
|---|---|---|
| 1 | ✅ **业务运营** | 管钱 / 用户 / 代理 / 风控 / 内容 — 进 |
| 2 | ❌ **SRE / 运维** | 服务健康 / Kafka / Nacos / RPC 延迟 / KMS health — **不进**(Grafana 那边)|
| 3 | ❌ **开发工具** | 代码生成器 / 插件管理(老 systemTools 反例)— **不进** |
| 4 | ✅ **紧急产品级开关** | 暂停下注 / 暂停提现 / 切 draw mode — 进(运营决策,不是 SRE 重启)|
| 5 | 🟡 **财务运营视图** | 钱包余额、LINK 余额 — 进,但**只读**;KMS health 不进 |
| 6 | ❌ **客服工单 / Tickets** | **不做**(2026-05-08 决策)— 用户沟通走 TG 群 + bot 私聊;后台保留**业务异常队列** |

### 0.3 通用交互模式 / Common interaction patterns

- **危险写操作** = `confirmTyped`(输错放弃),触动钱 / 触动权限的升 `step-up`(密码 + TOTP)
- **审计 + traceId** = 所有写操作记 `audit_event`,带 actor / target / action / reason / traceId
- **TG 沟通时的备注字段** = 凡是「之前会要工单 ID」的地方,改 `reference` 自由文本(粘 TG 链接 / 截图说明)
- **金额** = `string`(USDT 单位),不用 `number`(精度 + JS bigint 限制)
- **时间** = ISO 8601 UTC,前端按用户时区渲染;相对时间(「3 分钟前」)hover 显示绝对时间
- **TraceId** = 等宽字体 + 可点跳 audit log 过滤
- **TG ID 默认隐藏** = 列表不显示 `@username`,详情抽屉「基本」tab 可见(SUPER_ADMIN / 客服角色)
- **桌面优先** = 1280px+;不做响应式;运营在电脑前工作

---

## 1. Sidebar 完整 IA / Full Sidebar IA

```
🌅 总览 / Overview                                                            (2)
   ├─ Dashboard                       KPI / 待办 / 流水 / 告警
   └─ 待办中心 To-Do                  全部 pending 自动汇总(超时开奖+待审提现+待联系用户+风控命中+异常充值)

🎮 活动运营 / Activities ★                                                    (4)
   ├─ 活动列表 Games                   商品/活动主表
   ├─ 期号管理 Rounds ★               每个商品的「期」:期号 / 售罄进度 / 票号区间 / 开奖时间
   ├─ 开奖中心 Draws                   超时队列 + LINK 余额 + 处理历史 (BACKEND/VRF/FULL_CHAIN)
   └─ 奖品库 Prize Pool ★             实物奖品库存 SKU(iPhone / 金条等)

💰 订单 & 资金 / Orders & Funds                                               (5)
   ├─ 购票订单 Tickets                 所有购票订单(用户/期号/票号/金额/状态)
   ├─ 提现审核 Withdraws               待审队列 + 处理历史 + 大额二确
   ├─ 充值兜底 Deposits 💸            4-tab 工作流(详细见 deposits draft)
   ├─ 资金流水 Funds Ledger           6 类聚合(充值/购票/派奖/提现/返佣/退款) — 跨用户全局
   └─ 退款 / 异常单 Exceptions        派奖失败 / 链回调失败 / 双扣等异常订单

📦 实物履约 / Fulfillment ★                                                   (4)
   ├─ 待发货 Pending Ship             按下单时间 / 物流要求排序
   ├─ 物流追踪 Tracking               已发货件物流状态
   ├─ 待联系用户 Awaiting Address     TG 客服尚未拿到收件信息的中奖单
   └─ 异常件 / 退款 Returns           丢件 / 破损 / 退款处理队列

👥 用户运营 / Users                                                           (3)
   ├─ 用户列表 Users                   主屏 + 10 tab 详情抽屉(详细见 users draft)
   ├─ 黑名单 Blacklist 🅑              UID / TG / IP / 钱包地址主动拉黑
   └─ VIP / 标签 Tags 🅑              用户分层

🤝 代理体系 / Agents                                                          (4)
   ├─ 代理列表 Agents                 树形 + baseShare + 本月业绩
   ├─ 邀请关系 Invites                refCode管理 + 邀请关系图
   ├─ 分成阶梯 Ratios 🅑              BR20 启动校验 + 阶梯参数
   └─ 结算流水 Settlements            代理佣金月结记录

📢 内容运营 / Content                                                         (4)
   ├─ Banner / 公告 Banners           首页 banner / 活动公告 / 维护通知
   ├─ FAQ / 帮助 Help                 帮助文档自主维护
   ├─ 推送 / 通知 Push                站内信(单/批量/分群)+ TG Bot 广播
   └─ 中奖晒单 Winners ★              1U夺宝信任建设(运营审 + 推荐展示)

⚙️ 平台配置 / Configuration                                                   (5)
   ├─ 风控规则 Risk Rules             阈值参数 + 启停
   ├─ 限额参数 Limits                 提现 / 购票 / 充值 / 链 gas 阈值
   ├─ 邀请奖励 Promotions 🅑          首充 / 邀请 / 节日券
   ├─ VIP 配置 VIP Tiers 🅑           等级阈值 + 权益
   └─ 🚨 紧急暂停 Emergency Stop      停下注 / 停提现 / 切 BACKEND / 全站只读(step-up + TG 通知)

💼 财务 / Finance                                                             (4)
   ├─ 每日对账 Reconcile              4 方平衡 + 差异单
   ├─ Treasury 余额 Treasury          多链钱包 + LINK 余额(只读)
   ├─ 数据报表 Reports 🅑             GMV / DAU / 留存 / cohort / 漏斗 / CSV
   └─ Economics 沙盒 🅑              LTV / CAC / breakeven / 刷单 ROI

🛡️ 风控 / Risk                                                                (4)
   ├─ 命中队列 Hits                   BR23 反刷命中处理
   ├─ 申诉处理 Appeals                用户对风控的申诉跟踪
   ├─ 提款地址簿 Withdraw Addresses   ✏️跨用户聚合,从用户列表/详情可跳
   └─ 反洗钱 AML 🅒                   大额报告 / 制裁名单(v1.2)

📋 审计 / Audit                                                                (1)
   └─ 审计日志 Audit Log              只读 + 多维筛选 + CSV 导出

🔒 权限 / RBAC                                                                (3)
   ├─ 角色 Roles                       角色 + 权限矩阵
   ├─ 操作员 Operators                邀请 / 改角色 / 重置 TOTP / IP 白名单
   └─ 个人 / TOTP Profile             自己改密码 / 绑 TOTP / 自己的操作日志
```

**图例 / Legend**:
- 无标记 = v1.0 必须
- 🅑 = v1.1
- 🅒 = v1.2
- ★ = 1U夺宝**专属**(普通 SaaS 没有)
- ✏️ = v4 新增(v3 spec 没有)

### 1.1 数量统计 / Counts

| 项 | 数量 |
|---|---|
| 一级菜单 | **12** |
| 二级菜单总数 | **44** |
| v1.0 必须 | **36** |
| v1.1 | **7** |
| v1.2 | **1** |
| 1U夺宝专属 ★ | **5**(期号 / 奖品库 / 4 履约 / 中奖晒单)|

### 1.2 跟 v3 LOCKED spec 的差异 / Diff vs v3 spec(LOCKED)

| 维度 | v3 spec | v4 草案 | 增量 |
|---|---|---|---|
| 一级菜单 | (sidebar 平铺 11 屏)| **12 大类**(分组)| 加分组 |
| 二级菜单 | 11 | **44** | +33 |
| 1U夺宝专属 | 0 | **5** | +5(期号 / 奖品库 / 履约拆 4 屏 / 中奖晒单)|
| 内容运营 | 0 | **4** | +4(banner/FAQ/Push/晒单)|
| 财务深度 | 1(对账)| **4**(对账/Treasury/报表/Economics)| +3 |
| 紧急暂停 | 没有 | **有**(step-up + TG 通知)| +1 |
| 客服工单 | 没有 | 没有(明确决策不做)| 0 |

---

## 2. 12 个一级模块 — 开发需求功能 / Per-Module Feature Requirements

### 2.1 总览 / Overview

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **Dashboard** | v1.0 | 7 张卡:今日 GMV / 活跃 / 售出票数 / 平台留存 / 待办计数 / 最近开奖 / 最近资金流水 | 待办项可点跳对应模块;告警条幅可配 | 跨模块聚合 |
| **待办中心** | v1.0 | 全部 pending 一站式列表(超时开奖 / 待审提现 / 待联系用户 / 风控命中 / 异常充值)| 按优先级排序;一键跳处理 | 跨模块聚合 |

**为什么有「待办中心」**:Dashboard 上的待办区是 widget 摘要,「待办中心」是完整列表。运营 9 点上班第一个进的页。

---

### 2.2 活动运营 / Activities ★ 1U夺宝核心

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **活动列表 Games** | v1.0 | 商品/活动 CRUD + 筛选 + 变更记录 | `drawer-create-game` 抽屉新建;暂停/恢复/关闭 = `confirmTyped` | `oneu_lottery` |
| **期号管理 Rounds** ★ | v1.0 | 每商品的 N 期(期号/总票数/已售/票号区间/开奖时间)+ 手动开奖 | 单期暂停 / 取消 = `confirmTyped` + 写审计 | `oneu_lottery` 期号字段 |
| **开奖中心 Draws** | v1.0 | 超时队列 + LINK 余额 + 处理历史 (BACKEND/VRF/FULL_CHAIN) + commit-reveal 视图 | `modal-fallback`(降级到 BACKEND) / `modal-void`(流拍) — 都 `confirmTyped` + 写审计 + 通知 TG 群 | `oneu_draw_result` + `backend_draw_commit` + `vrf_request_record` |
| **奖品库 Prize Pool** ★ | v1.0 | 实物奖品 SKU(估值 / 库存 / 关联活动)+ 批量上传图片 | 改库存 = `confirmTyped`;低库存告警 | `oneu_lottery_prize` 扩展 |

**1U夺宝特色:**
- 「期号」概念 — 每个活动有 N 期独立售票 / 开奖
- 「奖品库」分离 — 奖品 SKU 与活动解耦,一个奖品可跨多期使用

---

### 2.3 订单 & 资金 / Orders & Funds

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **购票订单 Tickets** | v1.0 | 所有购票订单(UID / 期号 / 票号区间 / 金额 / 状态)+ 多维筛选 + 详情 | 详情抽屉看单笔交易细节;无写操作(订单不可改)| `oneu_order` + `oneu_ticket` |
| **提现审核 Withdraws** | v1.0 | 待审队列 + 历史 + 大额二确;**全部提现需人工审**(D9)| `modal-withdraw`(approve)/ reject — `confirmTyped`;大额 step-up | `wallet_withdraw_request` |
| **充值兜底 Deposits** 💸 | v1.0 | **4 tab**(自动入账 / 异常队列 / 处理历史 / 链上未识别) | 6 种异常处理动作(见 deposits draft);资金类走 step-up | `wallet_deposit_request` + `wallet_transaction` |
| **资金流水 Funds Ledger** | v1.0 | 6 类(充值/购票/派奖/提现/返佣/退款)聚合视图 + traceId 串联 | 只读 + 导出 CSV | `wallet_transaction` |
| **退款 / 异常单 Exceptions** | v1.0 | 派奖失败 / 链回调失败 / 双扣等异常订单的人工处理队列 | 重新派奖 / 手动退款 = step-up | 跨服务异常表 |

**关键决策:**
- D9: 全部提现 v1.0 全人工审;大额审 / 风控驱动(后续开放)
- D2: 充值阈值 10 USDT,低于进异常队列

---

### 2.4 实物履约 / Fulfillment ★

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **待发货 Pending Ship** | v1.0 | 按下单时间 / SLA 排序;TG 客服已录入收件信息才能发 | `modal-ship` + `confirmTyped` + 填快递公司/单号 | `oneu_user_prize`(state=PENDING_SHIP) |
| **物流追踪 Tracking** | v1.0 | 已发货件状态聚合(轨迹同步快递接口)| 标记签收 / 异常 = `confirmTyped` | `oneu_user_prize` + 物流接口 |
| **待联系用户 Awaiting Address** | v1.0 | TG 客服尚未拿到收件信息 → 自动通知 + 客服手动跟进 + 录入收件信息 | `modal-recipient-input` = confirmTyped + reference 必填 | `oneu_user_prize`(state=WAITING_AUDIT) |
| **异常件 / 退款 Returns** | v1.0 | 丢件 / 破损 / 用户拒收等异常处理 | `modal-refund`(退款)= step-up + 客户填退款地址 | `oneu_user_prize` 异常态 |

**1U夺宝特色 / 1U specifics:**
- 实物为主导致**履约工作量大** — 拆 4 屏(普通 SaaS 一屏就够)
- 待联系用户队列**单独**做 — v1.0 不在用户端做地址表单,实物中奖收件信息由 TG 客服沟通获取后由后台运营录入

---

### 2.5 用户运营 / Users

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **用户列表 Users** | v1.0 | 10 列字段 + 6 维筛选 + 详情抽屉 10 tab | 封禁 / 解封 = `confirmTyped`;调余额 = step-up;详细见 users draft | `user_info` 全栈 |
| **黑名单 Blacklist** 🅑 | v1.1 | UID / TG / IP / 钱包地址主动拉黑 + 拉黑历史 | 加黑 = step-up + reason | TBD(新表)|
| **VIP / 标签 Tags** 🅑 | v1.1 | 用户分层(VIP / 大客户 / 高风险)+ 标签管理 | 改标签 = `confirmTyped` | TBD(新表)|

**用户列表详情 10 tab(详细见 users draft):**
基本 / 资产 / 提款白名单 / 订单 / 资金流水 / 中奖记录 / 风控历史 / 代理关系 / 登录日志 / 操作日志

---

### 2.6 代理体系 / Agents

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **代理列表 Agents** | v1.0 | 树形显示 + baseShare + 本月业绩 + refCode | `drawer-promote`(任命)+ `modal-promote`(二确)| `user_invite` + `user_agent_flag_log` |
| **邀请关系 Invites** | v1.0 | refCode管理 + 邀请关系图 | 改refCode / 解绑邀请关系 = `confirmTyped` | `user_invite` |
| **分成阶梯 Ratios** 🅑 | v1.1 | F32 + BR20 启动校验 + 阶梯参数配置 | `modal-ratio-save`(启动校验通过才提交)| 配置表 + Nacos |
| **结算流水 Settlements** | v1.0 | 代理佣金月结记录 + 申诉处理 | 重新结算 = step-up | `agent_settlement` 新表 |

---

### 2.7 内容运营 / Content

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **Banner / 公告 Banners** | v1.0 | 首页 banner / 活动公告 / 维护通知 + 发布预览 + 上下线 | 发布前预览 = 弹窗看「在用户端长什么样」;上下线 = `confirmTyped` | `banner` 新表 |
| **FAQ / 帮助 Help** | v1.0 | 帮助文档自主维护(运营改文案不发版)| 改 = 普通 confirm | `help_article` 新表 |
| **推送 / 通知 Push** | v1.0 | 站内信(单 / 批量 / 分群)+ TG Bot 广播 | 批量发 = `confirmTyped` + 显示目标人数;单发普通 confirm | `user_message_inbox` + 推送队列 |
| **中奖晒单 Winners** ★ | v1.0 | 用户中奖后可上传晒单(图 + 描述)+ 运营审核 + 推荐展示 | 审核通过 / 拒绝 = `confirmTyped` | `winner_post` 新表 |

**1U夺宝特色 / 1U specifics:**
- 中奖晒单是**信任感建设**核心 — 「真有人中过」的视觉证据;运营要主动维护展示

---

### 2.8 平台配置 / Configuration

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **风控规则 Risk Rules** | v1.0 | 阈值参数 + 规则启停(单 IP 多账户、连续高额、异常时段等)| 改阈值 = `confirmTyped`;启停 = `confirmTyped` | Nacos `risk_config` |
| **限额参数 Limits** | v1.0 | 充值最小 / 提现单笔上限 / 提现日上限 / 单期最大票数 / 链 gas 阈值 | 改 = `confirmTyped` + 显示生效范围;链 gas SLA **只读**(SRE 调)| Nacos `limit_config` |
| **邀请奖励 Promotions** 🅑 | v1.1 | 首充奖 / 邀请奖 / 节日券配置 | 改 = `confirmTyped` | Nacos `promo_config` |
| **VIP 配置 VIP Tiers** 🅑 | v1.1 | 等级阈值 + 权益 + 升降级规则 | 改 = `confirmTyped` | 配置表 |
| **🚨 紧急暂停 Emergency Stop** | v1.0 | 红色大开关:停下注 / 停提现 / 切 BACKEND draw / 全站只读 | **step-up**(密码 + TOTP)+ reason + **自动 TG 通知运营群和 SRE** | Nacos 实时切 + 写审计 |

**关键设计:**
- 紧急暂停是**业务级开关**,不是 SRE 重启;运营点了之后,所有用户立即进入对应受限状态
- 所有暂停操作都要有**自动恢复时间**或**手动恢复**两种(防忘记)

---

### 2.9 财务 / Finance

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **每日对账 Reconcile** | v1.0 | F34 + 4 方平衡(充值/售票/派奖/分成/返佣/留存/差异)+ 差异单查询 | `重新对账` = `confirmTyped`;差异单上钻看明细 | `wallet_reconcile_daily` |
| **Treasury 余额 Treasury** | v1.0 | 多链钱包余额(只读)+ LINK 余额 + 阈值告警视图 + 历史趋势 | **只读** — 任何操作不许;阈值告警 = 邮件 / TG 自动 | `wallet_treasury` |
| **数据报表 Reports** 🅑 | v1.1 | GMV / DAU / 留存 / cohort / 漏斗 / CSV 导出 | 自定义查询;导出 CSV | 多表聚合 |
| **Economics 沙盒** 🅑 | v1.1 | LTV / CAC / 单用户购票 vs breakeven / 刷单 ROI 模拟 | 沙盒可调参数,**纯计算无写入** | 计算引擎 |

**Treasury 边界:**
- 看的是钱包余额(财务运营关心)
- **不看** KMS health / 钱包 IAM / 私钥状态(那些是 SRE / Security)

---

### 2.10 风控 / Risk

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **命中队列 Hits** | v1.0 | BR23 反刷命中处理(冻结 / 解冻 / 驳回 / 申诉升级)| `modal-risk-reject`(驳回)= `confirmTyped` + 强 reason | `risk_hit` 新表 |
| **申诉处理 Appeals** | v1.0 | 用户对风控决定的申诉跟踪 + 复审 | 复审通过 / 维持 = `confirmTyped` + reason | `risk_appeal` 新表 |
| **提款地址簿 Withdraw Addresses** ✏️ | v1.0 | 跨用户聚合查询(按 UID / 链 / 地址)+ 反洗钱辅助 | 只读视图;**从用户列表 / 用户详情可跳过来 prefilled UID** | `wallet_withdraw_whitelist` 聚合 |
| **反洗钱 AML** 🅒 | v1.2 | 大额交易报告 + OFAC 制裁名单 + 跨用户地址聚合 | 标记可疑 = step-up + reason | TBD |

**白名单 + 提现审核 = 双重防护(D7 + D9):**
- 用户加白名单 → 24h 冷却(冷却期不能撤改)→ 用户提现 → 运营审核 → 通过才广播

---

### 2.11 审计 / Audit

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **审计日志 Audit Log** | v1.0 | 多维筛选(actor / target / action / traceId / 风险等级 / 时间)+ CSV 导出 | **完全只读**(普通运营不能删改);CSV 导出 ≤ 1w 行,>1w 走后端流 | `audit_event`(append-only)|

---

### 2.12 权限 / RBAC

| 子页 | 优先级 | 核心功能 | 关键交互 | 数据来源 |
|---|---|---|---|---|
| **角色 Roles** | v1.0 | 角色 + 权限矩阵(查看 / 编辑)| 改权限 = step-up | RBAC 表 |
| **操作员 Operators** | v1.0 | 邀请新管理员 / 改角色 / 重置 TOTP / IP 白名单 / 锁号 | `modal-totp-reset` 等 = step-up + reason | `admin_user` |
| **个人 / TOTP Profile** | v1.0 | 自己改密码 / 绑 TOTP / 看自己的操作日志 | 改密码 = 当前密码二确 | `admin_user` 自己 |

---

## 3. 已锁决策汇总 / All Locked Decisions

### 3.1 用户运营相关(from users draft Q1-Q9)

| # | 决策 |
|---|---|
| Q1 | TG ID 列表全局隐藏,详情可见(SUPER_ADMIN/客服角色) |
| Q2 | 调整余额 = step-up(密码+TOTP),v1.0 单人,合规需求时升审批流 |
| Q3 | 累计下注 / 累计中奖**两列分开**,不合并 |
| Q4 | 详情 10 tab + 懒加载(只默认加载基本+资产)|
| Q5 | 封禁(账户层) ≠ 黑名单(注册拦截层),独立可并存 |
| Q6 | 列表 CSV 导出限 1w 行,>1w 走后端流 |
| **Q7** | **提款白名单 = 强制 + 24h 冷却 + 冷却期内不能撤改** |
| **Q8** | **实物中奖收件信息 = TG 客服沟通获取 + 后台运营录入到该笔中奖单 → snapshot 锁;v1.0 用户端不做地址表单** |
| **Q9** | **提现审核 v1.0 全部人工审,v1.1 升级分级** |

### 3.2 充值兜底相关(from deposits draft D1-D4)

| # | 决策 |
|---|---|
| D1 | USDT 充值与提现多链 = BSC + ETH (ERC20) + TRON (TRC20);BTC 奖品 / BTC 提现 (后续开放,2026-05-15 移出 v1.0) |
| D2 | 最小充值阈值 = 统一 10 USDT,低于进异常队列 |
| D3 | 链回调 SLA 行业惯例(BSC 5min / ETH 15min / TRON 5min 告警);Nacos 配,后台只读 |
| D4 | 托管钱包模式 — 平台为每用户每链分配独立地址 |

### 3.3 全局架构相关 / Global

| # | 决策 |
|---|---|
| G1 | TG ID 默认隐藏 — 列表全局规则 |
| G2 | 邀请人字段统一 `昵称(UID)` 格式 |
| G3 | **不做客服工单系统** — TG 沟通(2026-05-08);所有「工单 ID」字段改 `reference` 自由文本 |
| G4 | 桌面优先 1280px+,不做响应式 |
| G5 | 视觉沿用 cyberpunk-neon 风格(同用户端 prototype-V1.0)|

---

## 4. 模块 draft 清单 / Per-Module Drafts

✅ **2026-05-08 全部 LOCKED**:13/13 module drafts 已就绪,status: LOCKED;每个 draft 内的 open Q 默认按「我的倾向」答案接受,后续运营反馈可针对性 amend。

按优先级 / By priority:

| 优先级 | draft 文件 | 状态 |
|---|---|---|
| 1 | `admin-users-V1.0.md` | ✅ 已写,Q1-Q9 锁定 |
| 2 | `admin-deposits-V1.0.md` | ✅ 已写,D1-D4 锁定 |
| 3 | `admin-withdraws-V1.0.md` | ✅ 已写(可快速,继承 Q7+Q9 决策) |
| 4 | `admin-activities-V1.0.md` | ✅ 已写(games + rounds + draws + 奖品库,工作量大)|
| 5 | `admin-fulfillment-V1.0.md` | ✅ 已写(5 屏)|
| 6 | `admin-content-V1.0.md` | ✅ 已写(4 屏 — banner / FAQ / push / 晒单)|
| 7 | `admin-config-V1.0.md` | ✅ 已写(含紧急暂停设计)|
| 8 | `admin-finance-V1.0.md` | ✅ 已写 |
| 9 | `admin-risk-V1.0.md` | ✅ 已写 |
| 10 | `admin-audit-V1.0.md` | ✅ 已写(简单,主要查询)|
| 11 | `admin-rbac-V1.0.md` | ✅ 已写 |
| 12 | `admin-overview-V1.0.md` | ✅ 已写(dashboard + 待办中心)|
| 13 | `admin-agents-V1.0.md` | ✅ 已写 |

---

## 5. 后端开发量初估 / Backend dev effort estimate

> 这是**粗略**估计,正式排期等所有 module draft 锁定后做。

| 维度 | v3 spec(11 屏) | v4 草案(36 v1.0 屏) | 增量倍数 |
|---|---|---|---|
| 后端 endpoint 数 | ~80 | ~250 | 3.1x |
| Mapper / Domain | ~60 类 | ~150 类 | 2.5x |
| 新增 DB 表 | 0(沿用)| ~12(banner / faq / blacklist / vip / agent_settlement / risk_appeal / risk_hit / winner_post / 等)| — |
| Nacos 配置项 | ~30 | ~50 | 1.7x |
| 估算工作量(人天)| 21(`admin-fe-roadmap.md` 估)| **40-55**(后端)+ **35-45**(前端)+ **5-10**(联调)| 4-5x |

**估算前提:**
- 单后端工程师从 0 到 v4 完整 36 屏:**~50 天**(2 个月)
- 单前端工程师从 0 到 v4 完整 36 屏:**~40 天**
- 并行 1 后端 + 1 前端:**~6-7 周**(含联调)
- 当前 admin-service 已经有 P9 plumbing(auth + RBAC + audit),不是从 0;实际增量 -10 天

---

## 6. 跨模块共享规则 / Cross-Module Shared Rules

继承 v3 spec(全部仍生效):

- 所有敏感写操作 = `confirmTyped`(输错放弃)
- 所有资金 / 代理 / 开奖 / 发货 / 风控 / 权限动作 = 写 `audit_event` + 带 `traceId`
- 列表 + 筛选 = 无后端可跑通(mock data 完整覆盖)
- 中文业务名保留 + code id / traceId 用等宽字体

v4 新增 / Added in v4:

- **TG ID 默认隐藏**(全局)
- **邀请人 / 关系字段统一 `昵称(UID)`**
- **资金类动作升 step-up**(密码 + TOTP),不只是 confirmTyped
- **`reference` 自由文本字段**(替代结构化「工单 ID」)
- **「在地址簿中查看 →」跨屏跳转模式**(详情 tab → 全局聚合屏)
- **紧急暂停操作自动 TG 通知运营群和 SRE**

---

## 7. 风险与依赖 / Risks & Dependencies

| 风险 | 缓解 |
|---|---|
| v4 比 v3 工作量翻 4-5x,排期紧 | 按优先级分批:v1.0 先上 36 屏中的「业务必经」(Activities / Orders / Fulfillment / Users / Withdraws / Deposits / Audit),其它(Banners / FAQ / Push / Reconcile / Treasury / RBAC)v1.0.x 补 |
| Per-module draft 还有 11 个未写,边写边变 | 先完成「订单 / 实物 / 紧急暂停」3 个高密度模块 draft,锁定后续才好估排期 |
| 后端 admin-service 当前只到 P9 plumbing,业务面 0% | 跟「后端 P9.5 admin 业务化」并行做,roadmap 调整由 PM 拍 |
| TG 沟通 + reference 字段不严谨,审计可能漏关键信息 | reference 字段强制 50 字符以上 + audit log 索引;客服培训规范怎么填 |

---

## 8. 下一步 / Next Steps

确认这份 IA + 功能要求(本文件)→ 然后:

1. **优先补 3 个高密度模块 draft**(顺序推荐):
   - `admin-activities-V1.0.md`(1U夺宝业务核心)
   - `admin-fulfillment-V1.0.md`(实物拆 5 屏)
   - `admin-config-V1.0.md`(含紧急暂停设计)
2. **其余 8 个模块 draft 平铺写**(简单模块如 audit / rbac 可以快速)
3. **所有 module draft 锁定后** → 本文件 status: DRAFT → LOCKED
4. **再产出**:
   - `prototype-admin-V1.0.html` 高保真原型(cyberpunk-neon 风格)
   - admin-fe-roadmap 更新到 V1.0(对齐 36 v1.0 屏)
   - admin-service 后端业务化排期

回我「OK」或修改意见,我按上面顺序往下做。
Reply OK or with edits, then I'll proceed in the listed order.