Files
order_site/apps/frontend/src/utils/semi-auto-trace-action.ts
T

158 lines
5.8 KiB
TypeScript
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
/**
* 半自动履约报文动作说明。
*
* trace 的 action 是原始格式:入站为「METHOD 路径」,虎牙出站为 WUP 方法名,
* 外部 Connector 为「METHOD 内部路径」。这里只做展示层映射,不写库、不改变报文内容。
*/
export type SemiAutoTraceActionInput = {
channel: string
action: string
}
/** 虎牙 WUP / livelink 出站动作。 */
const HUYA_RPC_ACTIONS: Record<string, string> = {
'webActUI.checkUserBindGameAccount': '查询虎牙账号已绑定角色',
'webActUI.confirmBindActAccount': '向虎牙提交绑定/换绑',
'webActUI.getLiveLinkParam': '获取绑定二维码参数',
'huyauserui.getUserProfile': '获取虎牙账号资料',
'livelink.getMiniAppQrcode': '生成登录二维码',
'livelink.poolingQrcodeStatus': '轮询扫码状态',
}
/** 旧版 Mock Connector 写入的历史动作,保留中文说明避免露出英文。 */
const LEGACY_ACTIONS: Record<string, string> = {
'mock.sms.send': '发送登录验证码(Mock Connector)',
'mock.sms.login': '验证码登录(Mock Connector)',
}
/** 客户接口尾路径 → 用途。 */
const CUSTOMER_ACTIONS: Record<string, string> = {
open: '客户打开履约页',
profile: '提交客户游戏资料',
'login/start': '发起平台登录',
'login/status': '查询登录状态',
'huya/sms/send': '发送虎牙登录验证码',
'huya/sms/login': '虎牙验证码登录',
'huya/sms/verify': '完成虎牙安全验证',
'binding/start': '开始绑定(查询已绑角色)',
'binding/status': '查询绑定状态',
'binding/rebind': '发起扫码换绑',
'binding/confirm': '确认绑定角色(含换绑)',
'weibo/config': '读取微博登录配置',
'weibo/sms/send': '发送微博登录验证码',
'weibo/sms/login': '微博验证码登录',
'weibo/qrcode': '获取微博登录二维码',
'weibo/qrcode/status': '查询微博扫码状态',
}
/** 运营接口尾路径 → 用途。 */
const ADMIN_ACTIONS: Record<string, string> = {
claim: '客服领取任务',
sync: '手动同步平台状态',
reauthorize: '重新发起客户授权',
'browser-session': '生成浏览器登录票据',
complete: '客服完成履约',
cancel: '取消履约任务',
'credential/export': '导出账号 CK',
history: '读取履约历史',
}
const CUSTOMER_PREFIX = '/api/v1/customer-fulfillment'
const ADMIN_PREFIX = '/api/v1/admin/semi-auto'
const CONNECTOR_PREFIX = '/api/internal/huya-semi-auto'
export function describeSemiAutoTraceAction(input: SemiAutoTraceActionInput): string {
const action = String(input?.action || '').trim()
if (!action) return ''
const channel = String(input?.channel || '').trim()
const named = HUYA_RPC_ACTIONS[action] || LEGACY_ACTIONS[action]
if (named) return named
const { method, path } = splitHttpAction(action)
if (!path) return ''
if (path.startsWith(CUSTOMER_PREFIX) || channel === 'customer_api') {
return describeCustomerAction(path)
}
if (path.startsWith(ADMIN_PREFIX) || channel === 'admin_api') {
return describeAdminAction(method, path)
}
if (path.startsWith(CONNECTOR_PREFIX) || channel === 'external_connector') {
return describeConnectorAction(method, path)
}
return ''
}
function splitHttpAction(action: string): { method: string; path: string } {
const match = /^(GET|POST|PUT|PATCH|DELETE)\s+(\S+)/i.exec(action)
if (!match) return { method: '', path: '' }
return {
method: match[1].toUpperCase(),
path: match[2].split('?')[0].split('#')[0],
}
}
function describeCustomerAction(path: string): string {
const match = /^\/api\/v1\/customer-fulfillment\/[^/]+(?:\/tasks\/[^/]+)?(?:\/(.*))?$/.exec(path)
if (!match) return ''
const tail = (match[1] || '').replace(/\/+$/, '')
if (!tail) return '读取履约任务'
return CUSTOMER_ACTIONS[tail] || ''
}
function describeAdminAction(method: string, path: string): string {
if (path === ADMIN_PREFIX + '/tasks') return '读取履约任务列表'
const taskMatch = /^\/api\/v1\/admin\/semi-auto\/tasks\/[^/]+(?:\/(.*))?$/.exec(path)
if (taskMatch) {
const tail = (taskMatch[1] || '').replace(/\/+$/, '')
if (!tail) {
return method === 'POST' || method === 'PUT' || method === 'PATCH'
? '更新履约任务'
: '读取履约任务详情'
}
return ADMIN_ACTIONS[tail] || ''
}
if (/^\/api\/v1\/admin\/semi-auto\/injections\/[^/]+$/.test(path)) {
return '校验浏览器注入票据'
}
return ''
}
function describeConnectorAction(method: string, path: string): string {
if (!path.startsWith(CONNECTOR_PREFIX)) return ''
const rest = path.slice(CONNECTOR_PREFIX.length).split('/').filter(Boolean)
if (rest.length === 0) return ''
if (rest[0] === 'sessions') {
if (rest.length === 1) return method === 'POST' ? '创建平台登录会话' : ''
if (rest.length === 2) {
if (method === 'DELETE') return '释放平台登录会话'
if (method === 'GET') return '查询登录会话'
return ''
}
if (rest.length === 3) {
if (rest[2] === 'binding') {
return method === 'POST' ? '开始绑定(含换绑)' : '查询绑定状态/快照'
}
if (rest[2] === 'browser-ticket') {
return method === 'DELETE' ? '释放浏览器票据' : '生成浏览器票据'
}
if (rest[2] === 'credential') return '读取平台账号 CK'
return ''
}
if (rest.length === 4 && rest[2] === 'binding' && rest[3] === 'confirm') {
return '确认绑定/换绑'
}
return ''
}
if (rest[0] === 'browser-tickets' && rest.length === 2) return '校验浏览器票据'
if (rest[0] === 'sms') {
if (rest[1] === 'send') return '发送平台登录验证码'
if (rest[1] === 'verify') return '完成平台安全验证'
if (rest[1] === 'login') return '平台验证码登录'
}
return ''
}