feat(force-onboarding): 用户列表加「开启新手引导」一次性操作 (#13)

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

src/lib/media.ts

@@ -0,0 +1,11 @@
+// 媒体(上报截图 / 反馈截图 / 反馈二维码等)由 App 后端的 /media 静态服务托管,admin 域不一定同源:
+//   - dev:NEXT_PUBLIC_MEDIA_BASE 指向 App 后端(http://localhost:8770)。
+//   - 生产:留空 = 走同域相对路径,由 admin nginx 的 /media 反代到后端(见 deploy/nginx/*.conf),
+//     避免跨域 / 混合内容(https 页面引 http 图会被浏览器拦)。
+const MEDIA_BASE = process.env.NEXT_PUBLIC_MEDIA_BASE || '';
+
+/** 把后端返回的相对媒体路径(/media/...)拼成可加载的 URL;已是 http(s) 绝对地址的原样返回。 */
+export function mediaUrl(p: string): string {
+  if (!p) return p;
+  return p.startsWith('http') ? p : MEDIA_BASE + p;
+}

src/lib/types.ts

@@ -30,6 +30,8 @@ export interface UserListItem {
   status: string;
   // 调试链接权限:开了的用户在 App 比价结果页/记录页可复制 price.shaguabijia.com 的 trace 调试链接
   debug_trace_enabled: boolean;
+  // 运营「一键开启新手引导」:true = 该用户下次打开 App 会被强制重走新手引导,走完自动取消
+  force_onboarding: boolean;
   wechat_openid: string | null;
   created_at: string;
   last_login_at: string;
@@ -90,6 +92,14 @@ export interface WithdrawOrder {
   updated_at: string;
 }
 
+// 提现列表项:WithdrawOrder + 列表接口联表带出的用户字段。
+// 详情抽屉的 recent_withdraws 仍是裸 WithdrawOrder(无这些字段)。
+export interface WithdrawListItem extends WithdrawOrder {
+  phone: string | null;
+  nickname: string | null;
+  cumulative_success_cents: number; // 累计成功提现(分)
+}
+
 export interface WithdrawSummary {
   reviewing_count: number;
   reviewing_amount_cents: number;
@@ -124,6 +134,30 @@ export interface WithdrawDetail {
   audit_logs: AuditLog[];
 }
 
+// 提现详情抽屉「用户统计区」:按时间窗口算的提现 + 看广告行为统计。
+// *_cash_cents = 该来源累计金币折算成可提现现金(分);现金余额是当前快照不随窗口。
+export interface UserRewardStats {
+  withdraw_success_cents: number; // 累计提现
+  cash_balance_cents: number; // 现金余额(快照)
+  withdraw_total: number; // 提现总次数(全部状态)
+  traditional_task_cash_cents: number; // 传统任务提现
+  reward_video_count: number; // 累计激励视频数
+  reward_video_avg_ecpm: number; // 平均激励视频 eCPM(分/千次)
+  reward_video_cash_cents: number; // 激励视频提现
+  feed_count: number; // 累计信息流广告数(份)
+  feed_avg_ecpm: number; // 平均信息流广告 eCPM(分/千次)
+  feed_cash_cents: number; // 信息流广告提现
+}
+
+// 金币发放记录(提现详情底部表)。ecpm 为原始分/千次,非广告来源为 null。
+export interface UserCoinRecord {
+  source: string; // reward_video / signin_boost / feed / signin
+  source_label: string; // 激励视频 / 签到膨胀 / 信息流广告 / 签到
+  created_at: string;
+  ecpm: string | null;
+  coin: number;
+}
+
 export interface WithdrawBulkItemResult {
   out_bill_no: string;
   ok: boolean;
@@ -176,6 +210,17 @@ export interface Feedback {
   created_at: string;
 }
 
+// 反馈页「加群二维码」卡配置(运营后台改 → App 意见反馈页同步)。
+// image_url 为后端 /media 相对路径(留空=App 走本地兜底图);其余为卡片三行文案与显隐开关。
+export interface FeedbackQrConfig {
+  enabled: boolean;
+  image_url: string | null;
+  title: string; // 第一行(操作提示),如「长按图片保存二维码」
+  group_name: string; // 第二行加粗群名,App 渲染为 直通「{group_name}」
+  subtitle: string; // 第三行(标语)
+  updated_at: string | null;
+}
+
 export interface AuditLog {
   id: number;
   admin_id: number;