Genarrative/apps/admin-web/src/config/trackingEventDefinitions.ts

import type {TrackingScopeKind} from '../api/adminApiTypes';

export interface AdminTrackingEventDefinition {
  key: string;
  title: string;
  scopeKind: TrackingScopeKind;
  remark: string;
  taskConfigEligible?: boolean;
}

export const adminTrackingEventDefinitions: AdminTrackingEventDefinition[] = [
  {
    key: 'auth_login_options_view',
    title: '登录方式查看',
    scopeKind: 'site',
    remark: '读取当前可用登录方式时记录，用于观察登录入口曝光。',
  },
  {
    key: 'auth_phone_code_send',
    title: '发送手机验证码',
    scopeKind: 'site',
    remark: '提交手机验证码发送请求成功后记录。',
  },
  {
    key: 'daily_login',
    title: '每日登录',
    scopeKind: 'user',
    remark: '认证成功或 refresh 续期后由后端幂等记录，用于每日登录任务进度校验。',
    taskConfigEligible: true,
  },
  {
    key: 'auth_phone_login_success',
    title: '手机号登录成功',
    scopeKind: 'user',
    remark: '手机号验证码登录成功后记录。',
  },
  {
    key: 'auth_me_view',
    title: '当前账号查看',
    scopeKind: 'user',
    remark: '读取当前登录账号信息成功后记录。',
  },
  {
    key: 'auth_sessions_view',
    title: '登录会话查看',
    scopeKind: 'user',
    remark: '读取当前账号登录会话列表成功后记录。',
  },
  {
    key: 'auth_refresh_success',
    title: '登录续期成功',
    scopeKind: 'site',
    remark: 'refresh cookie 续期成功后记录。',
  },
  {
    key: 'auth_logout',
    title: '退出登录',
    scopeKind: 'user',
    remark: '退出当前登录会话成功后记录。',
  },
  {
    key: 'auth_logout_all',
    title: '退出全部会话',
    scopeKind: 'user',
    remark: '退出全部登录会话成功后记录。',
  },
  {
    key: 'auth_wechat_bind_phone_success',
    title: '微信绑定手机成功',
    scopeKind: 'user',
    remark: '微信账号绑定手机号成功后记录。',
  },
  {
    key: 'profile_identity_update',
    title: '资料更新',
    scopeKind: 'user',
    remark: '用户资料更新成功后记录。',
  },
  {
    key: 'profile_dashboard_view',
    title: '个人看板查看',
    scopeKind: 'user',
    remark: '读取个人看板成功后记录。',
  },
  {
    key: 'wallet_ledger_view',
    title: '钱包流水查看',
    scopeKind: 'user',
    remark: '读取光点钱包流水成功后记录。',
  },
  {
    key: 'recharge_center_view',
    title: '充值中心查看',
    scopeKind: 'user',
    remark: '读取充值中心信息成功后记录。',
  },
  {
    key: 'recharge_order_create',
    title: '充值订单创建',
    scopeKind: 'user',
    remark: '创建充值订单成功后记录。',
  },
  {
    key: 'feedback_submit',
    title: '反馈提交',
    scopeKind: 'user',
    remark: '资料页反馈提交成功后记录。',
  },
  {
    key: 'invite_center_view',
    title: '邀请中心查看',
    scopeKind: 'user',
    remark: '读取邀请中心成功后记录。',
  },
  {
    key: 'referral_invite_code_redeem',
    title: '邀请码绑定',
    scopeKind: 'user',
    remark: '绑定推荐邀请码成功后记录。',
  },
  {
    key: 'redeem_code_submit',
    title: '兑换码提交',
    scopeKind: 'user',
    remark: '提交运营兑换码成功后记录。',
  },
  {
    key: 'task_center_view',
    title: '任务中心查看',
    scopeKind: 'user',
    remark: '读取个人任务中心成功后记录。',
  },
  {
    key: 'task_reward_claim',
    title: '任务奖励领取',
    scopeKind: 'user',
    remark: '领取个人任务奖励成功后记录。',
  },
  {
    key: 'save_archive_list_view',
    title: '存档列表查看',
    scopeKind: 'user',
    remark: '读取个人存档列表成功后记录。',
  },
  {
    key: 'save_archive_detail_view',
    title: '存档详情查看',
    scopeKind: 'user',
    remark: '读取个人存档详情成功后记录。',
  },
  {
    key: 'browse_history_view',
    title: '浏览历史查看',
    scopeKind: 'user',
    remark: '读取浏览历史成功后记录。',
  },
  {
    key: 'browse_history_record',
    title: '浏览历史写入',
    scopeKind: 'user',
    remark: '记录浏览历史成功后记录。',
  },
  {
    key: 'browse_history_clear',
    title: '浏览历史清空',
    scopeKind: 'user',
    remark: '清空浏览历史成功后记录。',
  },
  {
    key: 'play_stats_view',
    title: '游玩统计查看',
    scopeKind: 'user',
    remark: '读取个人游玩统计成功后记录。',
  },
  {
    key: 'profile_analytics_metric_view',
    title: '个人指标查看',
    scopeKind: 'user',
    remark: '读取个人埋点指标成功后记录。',
  },
  {
    key: 'ai_task_create',
    title: 'AI 任务创建',
    scopeKind: 'user',
    remark: '创建 AI 任务成功后记录。',
  },
  {
    key: 'ai_task_start',
    title: 'AI 任务启动',
    scopeKind: 'user',
    remark: '启动 AI 任务成功后记录。',
  },
  {
    key: 'ai_task_stage_start',
    title: 'AI 阶段启动',
    scopeKind: 'user',
    remark: '启动 AI 任务阶段成功后记录。',
  },
  {
    key: 'ai_task_chunk_append',
    title: 'AI 分片追加',
    scopeKind: 'user',
    remark: '追加 AI 文本分片成功后记录。',
  },
  {
    key: 'ai_task_stage_complete',
    title: 'AI 阶段完成',
    scopeKind: 'user',
    remark: '完成 AI 任务阶段成功后记录。',
  },
  {
    key: 'ai_task_reference_attach',
    title: 'AI 结果引用绑定',
    scopeKind: 'user',
    remark: '绑定 AI 结果引用成功后记录。',
  },
  {
    key: 'ai_task_complete',
    title: 'AI 任务完成',
    scopeKind: 'user',
    remark: '完成 AI 任务成功后记录。',
  },
  {
    key: 'ai_task_fail',
    title: 'AI 任务失败标记',
    scopeKind: 'user',
    remark: '标记 AI 任务失败成功后记录。',
  },
  {
    key: 'ai_task_cancel',
    title: 'AI 任务取消',
    scopeKind: 'user',
    remark: '取消 AI 任务成功后记录。',
  },
  {
    key: 'asset_upload_ticket_create',
    title: '资产上传票据创建',
    scopeKind: 'user',
    remark: '创建直传票据成功后记录，metadata 包含低敏资产定位字段。',
  },
  {
    key: 'asset_sts_credentials_create',
    title: '资产 STS 凭证创建',
    scopeKind: 'user',
    remark: '创建临时上传凭证成功后记录。',
  },
  {
    key: 'asset_upload_confirm',
    title: '资产上传确认',
    scopeKind: 'user',
    remark: '确认 OSS 对象为平台资产成功后记录。',
  },
  {
    key: 'asset_bind',
    title: '资产绑定',
    scopeKind: 'user',
    remark: '把平台资产绑定到业务实体成功后记录。',
  },
  {
    key: 'asset_character_visual_generate',
    title: '角色形象生成',
    scopeKind: 'user',
    remark: '角色主图生成请求成功后记录。',
  },
  {
    key: 'asset_character_visual_publish',
    title: '角色形象发布',
    scopeKind: 'user',
    remark: '角色主图发布成功后记录。',
  },
  {
    key: 'asset_character_animation_generate',
    title: '角色动画生成',
    scopeKind: 'user',
    remark: '角色动画生成请求成功后记录。',
  },
  {
    key: 'asset_character_animation_publish',
    title: '角色动画发布',
    scopeKind: 'user',
    remark: '角色动画发布成功后记录。',
  },
  {
    key: 'asset_character_animation_import',
    title: '角色动画视频导入',
    scopeKind: 'user',
    remark: '角色动画导入视频成功后记录。',
  },
  {
    key: 'asset_character_workflow_cache_save',
    title: '角色工作流缓存保存',
    scopeKind: 'user',
    remark: '保存角色工作流缓存成功后记录。',
  },
  {
    key: 'asset_history_view',
    title: '资产历史查看',
    scopeKind: 'user',
    remark: '读取资产历史成功后记录。',
  },
  {
    key: 'llm_request',
    title: 'LLM 请求',
    scopeKind: 'user',
    remark: '调用后端 LLM 门面成功后记录。',
  },
  {
    key: 'speech_config_view',
    title: '语音配置查看',
    scopeKind: 'user',
    remark: '读取语音配置成功后记录。',
  },
  {
    key: 'asr_stream_start',
    title: 'ASR 流启动',
    scopeKind: 'user',
    remark: '启动语音识别流成功后记录。',
  },
  {
    key: 'tts_bidirection_start',
    title: 'TTS 双向流启动',
    scopeKind: 'user',
    remark: '启动双向语音合成流成功后记录。',
  },
  {
    key: 'tts_sse_start',
    title: 'TTS SSE 启动',
    scopeKind: 'user',
    remark: '启动 SSE 语音合成成功后记录。',
  },
  {
    key: 'runtime_settings_view',
    title: '运行设置查看',
    scopeKind: 'user',
    remark: '读取运行设置成功后记录。',
  },
  {
    key: 'runtime_settings_update',
    title: '运行设置更新',
    scopeKind: 'user',
    remark: '更新运行设置成功后记录。',
  },
  {
    key: 'runtime_snapshot_view',
    title: '运行快照查看',
    scopeKind: 'user',
    remark: '读取运行快照成功后记录。',
  },
  {
    key: 'runtime_snapshot_save',
    title: '运行快照保存',
    scopeKind: 'user',
    remark: '保存运行快照成功后记录。',
  },
  {
    key: 'runtime_snapshot_delete',
    title: '运行快照删除',
    scopeKind: 'user',
    remark: '删除运行快照成功后记录。',
  },
  {
    key: 'puzzle_route_success',
    title: '拼图路由成功',
    scopeKind: 'user',
    remark: '拼图运行或创作接口成功响应后兜底记录；GET 入口可能按 site 统计。',
  },
  {
    key: 'match3d_route_success',
    title: '抓大鹅路由成功',
    scopeKind: 'user',
    remark: '抓大鹅创作或运行接口成功响应后兜底记录；GET 入口可能按 site 统计。',
  },
  {
    key: 'square_hole_route_success',
    title: '方洞路由成功',
    scopeKind: 'user',
    remark: '方洞创作或运行接口成功响应后兜底记录；GET 入口可能按 site 统计。',
  },
  {
    key: 'custom_world_route_success',
    title: '自定义世界路由成功',
    scopeKind: 'user',
    remark: '自定义世界运行接口成功响应后兜底记录；GET 入口可能按 site 统计。',
  },
  {
    key: 'creative_agent_route_success',
    title: '创意 Agent 路由成功',
    scopeKind: 'user',
    remark: '创意 Agent 接口成功响应后兜底记录；GET 入口可能按 site 统计。',
  },
  {
    key: 'work_play_start',
    title: '作品开始游玩',
    scopeKind: 'work',
    remark: '拼图、抓大鹅、方洞、自定义世界、大鱼吃小鱼、Visual Novel 正式开始游玩时记录。',
  },
];

export const adminProfileTaskTrackingEventDefinitions =
  adminTrackingEventDefinitions.filter((definition) => definition.taskConfigEligible);

export function findAdminTrackingEventDefinition(eventKey: string) {
  const normalizedEventKey = eventKey.trim();
  return (
    adminTrackingEventDefinitions.find(
      (definition) => definition.key === normalizedEventKey,
    ) ?? null
  );
}

export function filterAdminTrackingEventDefinitions(query: string) {
  return filterTrackingEventDefinitions(adminTrackingEventDefinitions, query);
}

export function filterAdminProfileTaskTrackingEventDefinitions(query: string) {
  return filterTrackingEventDefinitions(
    adminProfileTaskTrackingEventDefinitions,
    query,
  );
}

function filterTrackingEventDefinitions(
  definitions: AdminTrackingEventDefinition[],
  query: string,
) {
  const normalizedQuery = query.trim().toLowerCase();
  if (!normalizedQuery) {
    return definitions;
  }

  return definitions.filter((definition) => {
    const haystack = [
      definition.key,
      definition.title,
      definition.scopeKind,
      definition.remark,
    ]
      .join(' ')
      .toLowerCase();
    return haystack.includes(normalizedQuery);
  });
}