修复(半自动履约): 收口虎牙绑定为单一状态机

This commit is contained in:
yml
2026-11-19 15:32:03 +08:00
parent b9dadf2e02
commit 4c64967145
21 changed files with 2691 additions and 613 deletions
@@ -60,6 +60,11 @@ const STATUS_COLORS: Record<string, string> = {
login_scanned: 'cyan',
waiting_binding: 'gold',
binding_confirm: 'orange',
rebind_required: 'gold',
rebind_blocked_account: 'red',
rebind_blocked_target_role: 'red',
rebind_effect_pending: 'processing',
binding_support: 'magenta',
binding_expired: 'red',
binding_failed: 'red',
waiting_operator: 'volcano',
@@ -85,6 +90,27 @@ const BINDING_STATUS_LABELS: Record<string, string> = {
expired: '已过期',
}
const BINDING_FLOW_LABELS: Record<string, string> = {
binding_query_required: '待查询绑定',
initial_bind_required: '待首次绑定',
first_bind_qr_pending: '首次绑定待扫码',
first_bind_role_ready: '首次绑定待确认',
first_bind_role_mismatch: '首次绑定角色不一致',
first_bind_failed: '首次绑定失败',
current_role_confirmable: '当前角色待确认',
rebind_required: '需要换绑',
rebind_qr_pending: '换绑待扫码',
rebind_role_ready: '换绑待确认',
rebind_effect_pending: '换绑生效中',
rebind_blocked_account: '账号换绑冷却',
rebind_blocked_target_role: '目标角色冷却',
rebind_rejected: '虎牙拒绝换绑',
rebind_effect_failed: '换绑未生效',
confirmed: '绑定已确认',
manual_review: '绑定需人工核实',
expired: '绑定已过期',
}
type CompleteFormValues = {
note?: string
externalOrderNo?: string
@@ -481,7 +507,11 @@ export default function AdminSemiAutoTasksPage() {
<Text type="secondary">{task.displayStatus.nextAction}</Text>
<Text type="secondary">{task.huyaUid ? `UID ${task.huyaUid}` : '未获取 UID'}</Text>
<Text type="secondary">
{`绑定:${BINDING_STATUS_LABELS[task.bindingStatus] || task.bindingStatus}`}
{`绑定:${
BINDING_FLOW_LABELS[task.bindingFlowState] ||
BINDING_STATUS_LABELS[task.bindingStatus] ||
task.bindingStatus
}`}
</Text>
{task.bindGameRole || task.bindGameRoleToken ? (
<Text type="secondary">
@@ -773,7 +803,9 @@ export default function AdminSemiAutoTasksPage() {
{detail.task.loginStatus === 'authenticated' ? 'CK 已获取' : '等待客户登录'}
</Descriptions.Item>
<Descriptions.Item label="绑定状态">
{BINDING_STATUS_LABELS[detail.task.bindingStatus] || detail.task.bindingStatus}
{BINDING_FLOW_LABELS[detail.task.bindingFlowState] ||
BINDING_STATUS_LABELS[detail.task.bindingStatus] ||
detail.task.bindingStatus}
</Descriptions.Item>
<Descriptions.Item label="平台当前角色">
{detail.task.bindGameRole || '-'}
@@ -825,6 +857,22 @@ export default function AdminSemiAutoTasksPage() {
<Text type="secondary">{detail.comparison?.message || '-'}</Text>
</Space>
</Descriptions.Item>
<Descriptions.Item label="绑定判定" span={2}>
<Space direction="vertical" size={2}>
<Text strong>{BINDING_FLOW_LABELS[detail.task.bindingFlowState] || '-'}</Text>
<Text type="secondary">{detail.task.bindingDecision?.message || '-'}</Text>
{detail.task.bindingDecision?.rebindBlockScope ? (
<Text type="warning">
阻塞作用域:
{detail.task.bindingDecision.rebindBlockScope === 'account'
? '虎牙账号'
: detail.task.bindingDecision.rebindBlockScope === 'target_role'
? '目标游戏角色'
: '平台其他原因'}
</Text>
) : null}
</Space>
</Descriptions.Item>
<Descriptions.Item label="客服">
{detail.task.assignedAdminName || '未领取'}
</Descriptions.Item>
@@ -104,6 +104,16 @@ export default function CustomerFulfillmentPage({
() => tasks.find((task) => task.id === selectedTaskId) || tasks[0] || null,
[selectedTaskId, tasks],
)
const bindingDecision = bindingInfo?.bindingDecision || selectedTask?.bindingDecision || null
const bindingActions = new Set(bindingDecision?.allowedActions || [])
const canConfirmDecision = bindingDecision?.canConfirmBinding === true
const huyaBindingConfirmed = bindingDecision?.flowState === 'confirmed'
const huyaBindingPolling = Boolean(
selectedTask?.platform === 'huya' &&
(bindingActions.has('refresh_binding_status') ||
bindingActions.has('refresh_first_binding_qr') ||
bindingActions.has('refresh_rebind_qr')),
)
const isWeibo = selectedTask?.platform === 'weibo'
// 虎牙流程:登录 → 填写资料(区服/游戏角色 UID/角色名)→ 绑定角色。
// 资料齐全前不生成绑定二维码,避免客户在资料缺失时先绑错角色。
@@ -202,9 +212,7 @@ export default function CustomerFulfillmentPage({
}
const dedicatedLoginPoll =
selectedTask.loginStatus === 'qr_pending' || selectedTask.loginStatus === 'scanned'
const dedicatedBindingPoll =
selectedTask.platform === 'huya' &&
(selectedTask.bindingStatus === 'qr_pending' || selectedTask.bindingStatus === 'scanned')
const dedicatedBindingPoll = huyaBindingPolling
if (dedicatedLoginPoll || dedicatedBindingPoll) return
const timer = window.setInterval(() => {
void load(true)
@@ -213,7 +221,8 @@ export default function CustomerFulfillmentPage({
}, [
load,
orderNo,
selectedTask?.bindingStatus,
bindingDecision?.flowState,
huyaBindingPolling,
selectedTask?.executionStatus,
selectedTask?.id,
selectedTask?.loginStatus,
@@ -296,8 +305,13 @@ export default function CustomerFulfillmentPage({
if (!selectedTask || !orderNo || selectedTask.platform !== 'huya') return
if (selectedTask.loginStatus !== 'authenticated') return
if (!profileComplete || profileEditing) return
if (selectedTask.bindingStatus === 'confirmed') return
if (selectedTask.bindingStatus !== 'not_started' || startingBindingRef.current) return
if (bindingDecision?.flowState === 'confirmed' || startingBindingRef.current) return
if (
!bindingDecision ||
!['query_binding', 'start_first_binding'].includes(bindingDecision.primaryAction)
) {
return
}
startingBindingRef.current = true
void startCustomerBinding(orderNo, selectedTask.id)
.then((response) => {
@@ -324,7 +338,8 @@ export default function CustomerFulfillmentPage({
orderNo,
profileComplete,
profileEditing,
selectedTask?.bindingStatus,
bindingDecision?.flowState,
bindingDecision?.primaryAction,
selectedTask?.id,
selectedTask?.loginStatus,
selectedTask?.platform,
@@ -332,9 +347,7 @@ export default function CustomerFulfillmentPage({
useEffect(() => {
if (!selectedTask || !orderNo) return
const huyaBinding =
selectedTask.platform === 'huya' &&
['qr_pending', 'scanned'].includes(selectedTask.bindingStatus)
const huyaBinding = selectedTask.platform === 'huya' && huyaBindingPolling
const weiboBinding =
selectedTask.platform === 'weibo' &&
['qr_pending', 'scanned'].includes(selectedTask.bindingStatus)
@@ -364,13 +377,7 @@ export default function CustomerFulfillmentPage({
void tick()
}, POLL_INTERVAL_MS)
return () => window.clearInterval(timer)
}, [
bindingSessionExpired,
orderNo,
selectedTask?.bindingStatus,
selectedTask?.id,
selectedTask?.platform,
])
}, [bindingSessionExpired, orderNo, huyaBindingPolling, selectedTask?.id, selectedTask?.platform])
useEffect(() => {
if (!selectedTask || !orderNo || selectedTask.platform !== 'weibo') return
@@ -404,8 +411,7 @@ export default function CustomerFulfillmentPage({
useEffect(() => {
if (!selectedTask || !orderNo || selectedTask.platform !== 'huya') return
if (bindingSessionExpired) return
if (selectedTask.bindingStatus !== 'role_ready' || bindingInfo || hydratingBindingRef.current)
return
if (!bindingDecision?.canConfirmBinding || bindingInfo || hydratingBindingRef.current) return
hydratingBindingRef.current = true
void pollCustomerBinding(orderNo, selectedTask.id)
.then((response) => {
@@ -429,26 +435,24 @@ export default function CustomerFulfillmentPage({
bindingInfo,
bindingSessionExpired,
orderNo,
selectedTask?.bindingStatus,
bindingDecision?.canConfirmBinding,
selectedTask?.id,
selectedTask?.platform,
])
useEffect(() => {
if (!selectedTask || selectedTask.bindingStatus !== 'role_ready') return
if (!bindingInfo?.comparison) return
// 换绑后仍是原角色时只展示失败原因,不能自动弹出确认框。
if (bindingInfo.rebindUnchanged) return
// 只有角色名与区服一致才自动弹出核对框,让客户直接确认平台绑定;
// 不一致时不弹框,由下方「重新扫码换绑 / 上一步修改资料」两个按钮处理。
if (bindingInfo.comparison.verdict !== 'match') return
if (!bindingDecision?.canConfirmBinding) return
const key = `${selectedTask.id}:${
bindingInfo.pendingBindGameRoleToken || bindingInfo.bindGameRoleToken || ''
bindingInfo?.pendingBindGameRoleToken ||
bindingInfo?.bindGameRoleToken ||
selectedTask.pendingBindGameRoleToken ||
selectedTask.bindGameRoleToken ||
''
}`
if (autoOpenedRoleRef.current === key) return
autoOpenedRoleRef.current = key
setBindingConfirmOpen(true)
}, [bindingInfo, selectedTask?.bindingStatus, selectedTask?.id])
}, [bindingDecision, bindingInfo, selectedTask?.id])
useEffect(() => {
const url = bindingInfo?.qrUrl
@@ -622,13 +626,28 @@ export default function CustomerFulfillmentPage({
lastBindingRefreshAtRef.current = now
setBindingLoading(true)
try {
const response = await startCustomerBinding(orderNo, selectedTask.id, { forceRebind })
const response = await startCustomerBinding(orderNo, selectedTask.id, {
forceRebind,
intent: forceRebind ? 'rebind' : 'auto',
})
setTasks((current) =>
current.map((task) => (task.id === response.data.task.id ? response.data.task : task)),
)
setBindingInfo(response.data.binding)
setBindingLoadError('')
setBindingConfirmOpen(false)
const nextDecision =
response.data.binding?.bindingDecision || response.data.task.bindingDecision
if (
nextDecision?.flowState === 'rebind_blocked_account' ||
nextDecision?.flowState === 'rebind_blocked_target_role' ||
nextDecision?.flowState === 'rebind_rejected' ||
nextDecision?.flowState === 'manual_review'
) {
message.warning(nextDecision.message)
} else if (nextDecision?.canConfirmBinding) {
setBindingConfirmOpen(true)
}
} catch (error) {
if (isConnectorSessionExpired(error)) {
setBindingSessionExpired(true)
@@ -679,7 +698,11 @@ export default function CustomerFulfillmentPage({
* 否则后端发现账号已有绑定角色会直接返回已有角色(role_ready),页面看起来像「返回上一步」。
*/
function handleRefreshBindingQr() {
void handleRefreshBinding(bindingInfo?.rebindRequested === true)
void handleRefreshBinding(
bindingInfo?.rebindRequested === true ||
bindingDecision?.primaryAction === 'start_rebind' ||
bindingDecision?.primaryAction === 'refresh_rebind_qr',
)
}
async function handlePollBindingNow(openConfirm = false) {
@@ -689,65 +712,61 @@ export default function CustomerFulfillmentPage({
const response = await pollCustomerBinding(orderNo, selectedTask.id)
const nextTask = response.data.task
const nextBinding = response.data.binding
const nextDecision = nextBinding?.bindingDecision || nextTask.bindingDecision
setTasks((current) => current.map((task) => (task.id === nextTask.id ? nextTask : task)))
if (nextBinding) setBindingInfo(nextBinding)
setBindingLoadError('')
if (nextTask.bindingStatus === 'role_ready') {
if (nextBinding?.rebindUnchanged) {
setBindingConfirmOpen(false)
if (nextBinding.rebindConfirmState === 'rejected') {
message.error(nextBinding.message || '虎牙未接受本次换绑')
} else {
message.warning(nextBinding.message || '换绑未生效,请查看下方原因')
}
if (selectedTask.platform === 'huya' && nextDecision) {
if (nextDecision.canConfirmBinding) {
setBindingConfirmOpen(true)
return
}
// 只有角色名与区服一致才打开核对框;不一致由页面按钮引导换绑或修改资料。
if (nextBinding?.comparison?.verdict === 'match') {
setBindingConfirmOpen(true)
} else {
setBindingConfirmOpen(false)
message.warning(
nextBinding?.comparison?.message ||
'平台角色与已填资料不一致,请重新扫码换绑或修改资料',
)
}
return
}
if (nextTask.bindingStatus === 'confirmed') {
setBindingConfirmOpen(false)
message.success(
selectedTask.platform === 'weibo'
? '微博角色已绑定,等待客服处理'
: '已提交平台绑定,等待客服处理',
)
if (nextDecision.flowState === 'confirmed') {
message.success('平台绑定已确认,等待客服处理')
return
}
if (nextDecision.flowState === 'manual_review') {
message.warning(nextDecision.message)
return
}
if (
nextDecision.flowState === 'rebind_blocked_account' ||
nextDecision.flowState === 'rebind_blocked_target_role' ||
nextDecision.flowState === 'rebind_rejected' ||
nextDecision.flowState === 'rebind_effect_failed' ||
nextDecision.flowState === 'first_bind_failed'
) {
message.warning(nextDecision.message)
return
}
if (
nextDecision.flowState === 'first_bind_qr_pending' ||
nextDecision.flowState === 'rebind_qr_pending'
) {
message.warning(
`还没有检测到完成扫码,请使用${
nextBinding?.bindGameChannel === 'QQ' ? 'QQ' : '微信'
}扫码后再点击`,
)
return
}
if (nextDecision.flowState === 'expired') {
message.warning(nextDecision.message)
return
}
message.info(nextDecision.message || '绑定状态还没有更新,请稍后再试')
return
}
// 弹窗内点「刷新」:角色不再是待确认状态时收起弹窗,避免展示过期比对。
// 微博仍以平台事实状态展示。
if (openConfirm) setBindingConfirmOpen(false)
const detail = nextBinding?.message || ''
if (nextTask.bindingStatus === 'scanned') {
if (nextBinding?.rebindConfirmState === 'accepted') {
message.info('虎牙已受理换绑,正在等待角色生效')
return
}
message.info(detail || '已扫码,请选好角色后点「核对平台角色」')
if (nextTask.bindingStatus === 'confirmed') {
message.success('微博角色已绑定,等待客服处理')
return
}
if (nextTask.bindingStatus === 'qr_pending') {
message.warning(
`还没有检测到扫码记录,请使用${
nextBinding?.bindGameChannel === 'QQ' ? 'QQ' : '微信'
}扫码完成绑定后再点击`,
)
return
}
if (nextTask.bindingStatus === 'expired') {
message.warning('绑定二维码已过期,请点击「刷新二维码」重新获取')
return
}
if (nextTask.bindingStatus === 'failed') {
message.error(detail || '识别绑定角色失败,请点击「刷新二维码」重试')
if (nextTask.bindingStatus === 'scanned' || nextTask.bindingStatus === 'qr_pending') {
message.info(detail || '请完成扫码后再刷新绑定状态')
return
}
message.info(detail || '绑定状态还没有更新,请稍后再试')
@@ -777,15 +796,20 @@ export default function CustomerFulfillmentPage({
const response = await submitCustomerRebind(orderNo, selectedTask.id)
const nextTask = response.data.task
const nextBinding = response.data.binding
const nextDecision = nextBinding?.bindingDecision || nextTask.bindingDecision
setTasks((current) => current.map((task) => (task.id === nextTask.id ? nextTask : task)))
if (nextBinding) setBindingInfo(nextBinding)
setBindingLoadError('')
setBindingConfirmOpen(false)
if (nextBinding?.rebindUnchanged || nextBinding?.rebindConfirmState === 'rejected') {
message.error(nextBinding.message || '虎牙未接受本次换绑')
if (
nextDecision?.flowState === 'rebind_blocked_account' ||
nextDecision?.flowState === 'rebind_blocked_target_role' ||
nextDecision?.flowState === 'rebind_rejected'
) {
message.error(nextDecision.message || '虎牙未接受本次换绑')
return
}
if (nextTask.bindingStatus === 'role_ready') {
if (nextDecision?.canConfirmBinding) {
message.success('已识别本次待确认角色,请核对后再确认绑定')
return
}
@@ -807,20 +831,44 @@ export default function CustomerFulfillmentPage({
async function handleConfirmBinding() {
if (!selectedTask) return
const expectedRoleName =
bindingInfo?.pendingBindGameRole ||
bindingInfo?.bindGameRole ||
selectedTask.pendingBindGameRole ||
selectedTask.bindGameRole
const expectedRoleToken =
bindingInfo?.pendingBindGameRoleToken ||
bindingInfo?.bindGameRoleToken ||
selectedTask.pendingBindGameRoleToken ||
selectedTask.bindGameRoleToken
const expectedRoleChannel =
bindingInfo?.pendingBindGameChannel ||
bindingInfo?.bindGameChannel ||
selectedTask.pendingBindGameChannel ||
selectedTask.bindGameChannel
setBindingLoading(true)
try {
const response = await confirmCustomerBinding(orderNo, selectedTask.id)
const response = await confirmCustomerBinding(orderNo, selectedTask.id, {
expectedRoleName,
expectedRoleToken,
expectedRoleChannel,
})
setTasks((current) =>
current.map((task) => (task.id === response.data.task.id ? response.data.task : task)),
)
setBindingInfo(response.data.binding)
setBindingConfirmOpen(false)
if (response.data.task.bindingStatus === 'confirmed') {
const nextDecision =
response.data.binding?.bindingDecision || response.data.task.bindingDecision
if (nextDecision?.flowState === 'confirmed') {
message.success('平台绑定已确认,等待客服处理')
} else if (response.data.task.bindingStatus === 'failed') {
message.error(response.data.binding?.message || '虎牙未接受本次绑定')
} else if (
nextDecision?.flowState === 'first_bind_failed' ||
nextDecision?.flowState === 'rebind_rejected'
) {
message.error(nextDecision.message || '虎牙未接受本次绑定')
} else {
message.info('虎牙已受理绑定,正在等待角色生效,请稍后刷新')
message.info(nextDecision?.message || '虎牙已受理绑定,正在等待角色生效,请稍后刷新')
}
} catch (error) {
if (isConnectorSessionExpired(error)) {
@@ -851,7 +899,13 @@ export default function CustomerFulfillmentPage({
.getElementById('customer-binding-stage')
?.scrollIntoView({ behavior: 'smooth', block: 'start' })
}, 60)
if (selectedTask.platform !== 'huya' || selectedTask.bindingStatus === 'not_started') return
if (
selectedTask.platform !== 'huya' ||
bindingDecision?.flowState === 'binding_query_required' ||
bindingDecision?.flowState === 'initial_bind_required'
) {
return
}
resettingBindingRef.current = true
try {
const response = await resetCustomerBinding(orderNo, selectedTask.id)
@@ -954,10 +1008,37 @@ export default function CustomerFulfillmentPage({
selectedTask.executionStatus !== 'completed' &&
selectedTask.executionStatus !== 'cancelled',
)
const bindingQrVisible =
profileComplete &&
['not_started', 'qr_pending', 'scanned'].includes(selectedTask?.bindingStatus || '')
const bindingComparison = bindingInfo?.comparison || null
const bindingQrVisible = bindingDecision
? bindingDecision.flowState === 'first_bind_qr_pending' ||
bindingDecision.flowState === 'rebind_qr_pending'
: profileComplete &&
['not_started', 'qr_pending', 'scanned'].includes(selectedTask?.bindingStatus || '')
const decisionRequiresRebind = bindingActions.has('start_rebind')
const decisionCanRefreshBinding = bindingActions.has('refresh_binding_status')
const decisionCanEditProfile = bindingActions.has('edit_profile')
const decisionCanRefreshQr =
bindingActions.has('refresh_first_binding_qr') ||
bindingActions.has('refresh_rebind_qr') ||
bindingActions.has('start_rebind') ||
bindingActions.has('start_first_binding')
const showBindingDecisionStage = Boolean(
bindingDecision &&
[
'current_role_confirmable',
'first_bind_role_ready',
'first_bind_role_mismatch',
'first_bind_failed',
'rebind_required',
'rebind_role_ready',
'rebind_effect_pending',
'rebind_blocked_account',
'rebind_blocked_target_role',
'rebind_rejected',
'rebind_effect_failed',
'manual_review',
].includes(bindingDecision.flowState),
)
const bindingComparison = bindingDecision?.comparison || bindingInfo?.comparison || null
const currentRoleName = bindingInfo?.bindGameRole || selectedTask?.bindGameRole || ''
const pendingRoleName =
bindingInfo?.pendingBindGameRole || selectedTask?.pendingBindGameRole || ''
@@ -983,17 +1064,39 @@ export default function CustomerFulfillmentPage({
const bindConfirmRejected = bindConfirmState === 'rejected'
const bindConfirmPending = bindConfirmState === 'submitting' || bindConfirmState === 'accepted'
// 只有角色名缺失时才需要人工核实;加密 role token 不再冒充客户游戏角色 UID。
const bindingRequiresSupport = Boolean(bindingInfo?.requiresSupport)
const bindingRequiresSupport = Boolean(
bindingDecision?.requiresSupport || bindingInfo?.requiresSupport,
)
// 绑定阶段顶部状态条:按 bindingStatus 显式映射,已确认/已过期/失败不再显示(各自有卡片)。
const comparisonMismatch =
selectedTask?.bindingStatus === 'role_ready' && bindingComparison?.verdict === 'mismatch'
bindingDecision?.targetRoleMatch === 'mismatch' || bindingComparison?.verdict === 'mismatch'
const comparisonUnknown =
selectedTask?.bindingStatus === 'role_ready' && bindingComparison?.verdict === 'unknown'
bindingDecision?.targetRoleMatch === 'unknown' || bindingComparison?.verdict === 'unknown'
// 平台没给出可核对角色或比对缺项时,都只能转客服人工核实。
const bindingNeedsSupport = bindingRequiresSupport || comparisonUnknown
const bindingBanner = (() => {
if (bindingSessionExpired) return null
if (bindingNeedsSupport && selectedTask?.bindingStatus !== 'confirmed') {
if (bindingDecision) {
if (bindingDecision.flowState === 'rebind_blocked_account') {
return { tone: 'is-warning', text: bindingDecision.message }
}
if (bindingDecision.flowState === 'rebind_blocked_target_role') {
return { tone: 'is-warning', text: bindingDecision.message }
}
if (bindingDecision.flowState === 'rebind_effect_pending') {
return { tone: 'is-info', text: bindingDecision.message }
}
if (bindingDecision.flowState === 'manual_review') {
return { tone: 'is-warning', text: bindingDecision.message }
}
if (bindingDecision.flowState === 'rebind_required') {
return { tone: 'is-info', text: bindingDecision.message }
}
if (bindingDecision.canConfirmBinding) {
return { tone: 'is-info', text: bindingDecision.message }
}
}
if (bindingNeedsSupport && !huyaBindingConfirmed) {
return {
tone: 'is-warning',
text: '已登录,但两侧角色信息不完整,无法自动核对,请联系客服人工核实',
@@ -1008,14 +1111,15 @@ export default function CustomerFulfillmentPage({
if (comparisonMismatch) {
return { tone: 'is-warning', text: '平台角色与已填资料不一致,请重新扫码换绑或修改资料' }
}
if (selectedTask?.bindingStatus === 'role_ready') {
if (!bindingDecision && selectedTask?.bindingStatus === 'role_ready') {
if (!bindingComparison) return { tone: 'is-info', text: '正在核对平台角色,请稍候' }
return { tone: 'is-info', text: '平台角色与已填资料一致,请提交平台绑定' }
}
if (
selectedTask?.bindingStatus === 'confirmed' ||
selectedTask?.bindingStatus === 'expired' ||
selectedTask?.bindingStatus === 'failed'
!bindingDecision &&
(selectedTask?.bindingStatus === 'confirmed' ||
selectedTask?.bindingStatus === 'expired' ||
selectedTask?.bindingStatus === 'failed')
) {
return null
}
@@ -1182,7 +1286,7 @@ export default function CustomerFulfillmentPage({
? 1
: profileEditing || !profileComplete
? 2
: selectedTask.bindingStatus === 'confirmed'
: huyaBindingConfirmed
? 4
: 3
}
@@ -1602,7 +1706,7 @@ export default function CustomerFulfillmentPage({
</div>
) : null}
{selectedTask?.bindingStatus === 'expired' && !profileEditing ? (
{bindingDecision?.flowState === 'expired' && !profileEditing ? (
<Alert
type="warning"
showIcon
@@ -1616,13 +1720,22 @@ export default function CustomerFulfillmentPage({
/>
) : null}
{selectedTask?.bindingStatus === 'failed' && !profileEditing ? (
{(bindingDecision?.flowState === 'rebind_rejected' ||
bindingDecision?.flowState === 'rebind_effect_failed' ||
bindingDecision?.flowState === 'first_bind_failed') &&
!profileEditing ? (
<Alert
type="error"
showIcon
message={bindConfirmRejected ? '虎牙未接受本次绑定' : '绑定失败'}
message={
bindingDecision?.flowState === 'rebind_rejected'
? '虎牙未接受本次换绑'
: '绑定失败'
}
description={
bindingInfo?.message || '请刷新二维码后重新扫码,如持续失败请联系客服。'
bindingDecision?.message ||
bindingInfo?.message ||
'请刷新二维码后重新扫码,如持续失败请联系客服。'
}
action={
<Button size="small" onClick={handleRefreshBindingQr}>
@@ -1632,9 +1745,7 @@ export default function CustomerFulfillmentPage({
/>
) : null}
{selectedTask?.bindingStatus === 'role_ready' &&
!bindingSessionExpired &&
!profileEditing ? (
{showBindingDecisionStage && !bindingSessionExpired && !profileEditing ? (
<Space direction="vertical" size={12} style={{ width: '100%' }}>
{bindingNeedsSupport ? (
<Alert
@@ -1712,8 +1823,44 @@ export default function CustomerFulfillmentPage({
.join(' · ')}
/>
)}
{bindingNeedsSupport ? (
<div className="customer-binding-role-actions">
<div className="customer-binding-role-actions">
{canConfirmDecision ? (
<Button
block
size="large"
className="customer-binding-confirm"
loading={bindingLoading}
onClick={() => setBindingConfirmOpen(true)}
>
提交平台绑定
</Button>
) : null}
{decisionRequiresRebind || decisionCanRefreshQr ? (
<Button
block
size="large"
className="customer-binding-rebind"
icon={<ReloadOutlined />}
loading={bindingLoading}
onClick={() => void handleRefreshBinding(true)}
>
{bindingDecision?.flowState === 'rebind_required'
? '重新扫码换绑'
: '刷新绑定二维码'}
</Button>
) : null}
{decisionCanEditProfile ? (
<Button
block
size="large"
className="customer-binding-rebind"
icon={<ExclamationCircleOutlined />}
onClick={() => void openProfileEditor()}
>
上一步修改资料
</Button>
) : null}
{bindingNeedsSupport ? (
<Button
block
size="large"
@@ -1722,88 +1869,26 @@ export default function CustomerFulfillmentPage({
>
复制订单号联系客服
</Button>
) : null}
{decisionCanRefreshBinding ? (
<Button
block
size="large"
className="customer-binding-rebind"
icon={<ReloadOutlined />}
loading={bindingLoading}
onClick={() => {
setBindingLoading(true)
void load(true).finally(() => setBindingLoading(false))
}}
onClick={() => void handlePollBindingNow()}
>
刷新状态
刷新绑定状态
</Button>
</div>
) : showRebindFailure || comparisonMismatch ? (
<div className="customer-binding-role-actions">
{comparisonMismatch && rebindAccepted ? (
<>
<Button
block
size="large"
className="customer-binding-confirm"
icon={<ExclamationCircleOutlined />}
onClick={() => void openProfileEditor()}
>
上一步修改资料
</Button>
<Button
block
size="large"
className="customer-binding-rebind"
icon={<ReloadOutlined />}
loading={bindingLoading}
onClick={() => void handleRefreshBinding(true)}
>
重新扫码换绑
</Button>
</>
) : (
<>
<Button
block
size="large"
className="customer-binding-confirm"
icon={showRebindFailure ? <ReloadOutlined /> : undefined}
loading={bindingLoading}
onClick={() => void handleRefreshBinding(true)}
>
重新扫码换绑
</Button>
<Button
block
size="large"
className="customer-binding-rebind"
icon={<ExclamationCircleOutlined />}
onClick={() => void openProfileEditor()}
>
上一步修改资料
</Button>
</>
)}
</div>
) : (
<div className="customer-binding-role-actions">
<Button
block
size="large"
className="customer-binding-confirm"
loading={bindingLoading}
disabled={!bindingComparison}
onClick={() => setBindingConfirmOpen(true)}
>
{bindingComparison ? '提交平台绑定' : '正在核对平台角色...'}
</Button>
</div>
)}
) : null}
</div>
</Space>
) : null}
{selectedTask?.bindingStatus === 'confirmed' && !profileEditing ? (
{bindingDecision?.flowState === 'confirmed' && !profileEditing ? (
<div className="customer-binding-verify">
<p>绑定状态需要平台人工核实,请联系客服处理</p>
<p>平台角色绑定已确认,客服正在处理订单</p>
<Button
block
size="large"
@@ -1814,7 +1899,7 @@ export default function CustomerFulfillmentPage({
void load(true).finally(() => setBindingLoading(false))
}}
>
刷新绑定状态
刷新订单状态
</Button>
</div>
) : null}
@@ -1844,9 +1929,8 @@ export default function CustomerFulfillmentPage({
<Modal
open={
bindingConfirmOpen &&
selectedTask?.bindingStatus === 'role_ready' &&
!rebindUnchanged &&
!bindingNeedsSupport &&
canConfirmDecision &&
!bindingDecision?.requiresSupport &&
!profileEditing
}
className="customer-binding-modal"
@@ -1856,7 +1940,7 @@ export default function CustomerFulfillmentPage({
}}
footer={
<div className="customer-binding-modal-footer">
{bindingComparison?.verdict === 'match' ? (
{canConfirmDecision ? (
<div className="customer-binding-modal-actions">
<Button
onClick={() => {
@@ -45,13 +45,14 @@ export function pollCustomerLogin(orderNo: string, taskId: number) {
export function startCustomerBinding(
orderNo: string,
taskId: number,
options: { forceRebind?: boolean; channel?: 'wx' | 'qq' } = {},
options: { forceRebind?: boolean; channel?: 'wx' | 'qq'; intent?: 'auto' | 'rebind' } = {},
) {
return apiPost<{ task: CustomerSemiAutoTask; binding: CustomerBindingInfo }>(
`/api/v1/customer-fulfillment/${encodeURIComponent(orderNo)}/tasks/${taskId}/binding/start`,
{
...(options.forceRebind ? { forceRebind: true } : {}),
...(options.channel ? { channel: options.channel } : {}),
...(options.intent ? { intent: options.intent } : {}),
},
)
}
@@ -73,11 +74,19 @@ export function resetCustomerBinding(orderNo: string, taskId: number) {
export function confirmCustomerBinding(
orderNo: string,
taskId: number,
options: { acceptExistingRole?: boolean } = {},
options: {
expectedRoleName?: string
expectedRoleToken?: string
expectedRoleChannel?: string
} = {},
) {
return apiPost<{ task: CustomerSemiAutoTask; binding: CustomerBindingInfo }>(
`/api/v1/customer-fulfillment/${encodeURIComponent(orderNo)}/tasks/${taskId}/binding/confirm`,
options.acceptExistingRole ? { acceptExistingRole: true } : {},
{
...(options.expectedRoleName ? { expectedRoleName: options.expectedRoleName } : {}),
...(options.expectedRoleToken ? { expectedRoleToken: options.expectedRoleToken } : {}),
...(options.expectedRoleChannel ? { expectedRoleChannel: options.expectedRoleChannel } : {}),
},
)
}
+20 -11
View File
@@ -1,3 +1,11 @@
import type {
HuyaAccountRoleState,
HuyaBindingDecision,
HuyaBindingFlowState,
HuyaRebindBlockScope,
HuyaTargetRoleMatch,
} from '../semi-auto-binding'
export type SemiAutoPlatform = 'huya' | 'weibo'
export type SemiAutoBindingPolicy = {
@@ -42,6 +50,10 @@ export type SemiAutoTask = {
bindGameRole: string
bindGameRoleId: string
bindGameRoleToken: string
isBindAccount: boolean
isBindRole: boolean
accountChangeBindTime: number
accountChangeBindDay: number
platformGameRoleUid: string
bindGameChannel: string
pendingBindGameAccount: string
@@ -50,6 +62,12 @@ export type SemiAutoTask = {
pendingBindGameChannel: string
roleIdentitySource: string
verificationBasis: string
bindingDecision: HuyaBindingDecision | null
bindingFlowState: HuyaBindingFlowState
accountRoleState: HuyaAccountRoleState
targetRoleMatch: HuyaTargetRoleMatch
rebindBlockScope: HuyaRebindBlockScope
rebindPlatformMessage: string
customerGameRoleId: string
customerGameRoleName: string
customerServerZone: string
@@ -98,21 +116,12 @@ export type SemiAutoTaskListResult = {
pagination: { page: number; pageSize: number; total: number }
}
export type SemiAutoBindingComparison = {
verdict: 'match' | 'mismatch' | 'unknown'
customerRoleName: string
customerRoleId: string
customerZone: string
boundRoleName: string
boundRoleId: string
boundZone: string
message: string
}
export type SemiAutoBindingComparison = HuyaBindingDecision['comparison']
export type SemiAutoTaskDetail = {
task: SemiAutoTask
/** 与客户页同源的区服 / 角色名 / 角色 ID 三项比对结果。 */
comparison: SemiAutoBindingComparison
comparison: SemiAutoBindingComparison | null
events: SemiAutoTaskEvent[]
}
+15 -12
View File
@@ -1,15 +1,10 @@
export type CustomerBindingComparison = {
verdict: 'match' | 'mismatch' | 'unknown'
customerRoleName: string
customerRoleId: string
customerZone: string
boundRoleName: string
boundRoleId: string
boundRoleIdKind: 'game_role_uid' | 'huya_role_token' | 'missing'
boundZone: string
verificationBasis: 'role_name_zone' | 'platform_numeric_uid' | 'manual'
message: string
}
import type {
HuyaBindingComparison,
HuyaBindingDecision,
HuyaBindingFlowState,
} from './semi-auto-binding'
export type CustomerBindingComparison = HuyaBindingComparison
export type CustomerSemiAutoTask = {
id: number
@@ -45,6 +40,10 @@ export type CustomerSemiAutoTask = {
bindGameRole: string
bindGameRoleId: string
bindGameRoleToken: string
isBindAccount: boolean
isBindRole: boolean
accountChangeBindTime: number
accountChangeBindDay: number
platformGameRoleUid: string
bindGameChannel: string
pendingBindGameAccount: string
@@ -53,6 +52,8 @@ export type CustomerSemiAutoTask = {
pendingBindGameChannel: string
roleIdentitySource: string
verificationBasis: string
bindingDecision: HuyaBindingDecision | null
bindingFlowState: HuyaBindingFlowState
customerGameRoleId: string
customerGameRoleName: string
customerServerZone: string
@@ -108,4 +109,6 @@ export type CustomerBindingInfo = {
platformChangeBindTime?: number
message: string
comparison: CustomerBindingComparison
bindingDecision?: HuyaBindingDecision | null
bindingFlowState?: HuyaBindingFlowState
}
@@ -0,0 +1,75 @@
export type HuyaAccountRoleState = 'unknown' | 'none' | 'bound' | 'inconsistent'
export type HuyaTargetRoleMatch = 'unknown' | 'match' | 'mismatch'
export type HuyaRebindBlockScope = '' | 'account' | 'target_role' | 'platform'
export type HuyaBindingFlowState =
| 'binding_query_required'
| 'initial_bind_required'
| 'first_bind_qr_pending'
| 'first_bind_role_ready'
| 'first_bind_role_mismatch'
| 'first_bind_failed'
| 'current_role_confirmable'
| 'rebind_required'
| 'rebind_qr_pending'
| 'rebind_role_ready'
| 'rebind_effect_pending'
| 'rebind_blocked_account'
| 'rebind_blocked_target_role'
| 'rebind_rejected'
| 'rebind_effect_failed'
| 'confirmed'
| 'manual_review'
| 'expired'
export type HuyaBindingAction =
| 'query_binding'
| 'start_first_binding'
| 'refresh_first_binding_qr'
| 'confirm_first_binding'
| 'confirm_current_role'
| 'start_rebind'
| 'refresh_rebind_qr'
| 'confirm_rebind'
| 'refresh_binding_status'
| 'wait_account_rebind'
| 'wait_target_role_rebind'
| 'relogin'
| 'edit_profile'
| 'contact_support'
| 'none'
export type HuyaBindingComparison = {
verdict: 'match' | 'mismatch' | 'unknown'
customerRoleName: string
customerRoleId: string
customerZone: string
boundRoleName: string
boundRoleId: string
boundRoleIdKind: 'game_role_uid' | 'huya_role_token' | 'missing'
boundZone: string
verificationBasis: 'role_name_zone' | 'platform_numeric_uid' | 'manual'
message: string
missing?: string[]
mismatched?: string[]
}
export type HuyaBindingDecision = {
accountRoleState: HuyaAccountRoleState
targetRoleMatch: HuyaTargetRoleMatch
flowState: HuyaBindingFlowState
primaryAction: HuyaBindingAction
allowedActions: HuyaBindingAction[]
rebindBlockScope: HuyaRebindBlockScope
accountRebindAvailableAt: string
targetRoleRebindAvailableAt: string
canGenerateBindingQr: boolean
canConfirmBinding: boolean
canCompleteTask: boolean
requiresCustomerConfirmation: boolean
requiresSupport: boolean
comparison: HuyaBindingComparison
currentRoleComparison: HuyaBindingComparison | null
pendingRoleComparison: HuyaBindingComparison | null
message: string
}
@@ -8,6 +8,7 @@ type SemiAutoReadinessTask = Pick<
| 'bindingStatus'
| 'credentialReady'
| 'credentialStatus'
| 'bindingDecision'
>
function hasUsableCredential(task: SemiAutoReadinessTask) {
@@ -26,6 +27,9 @@ export function canInjectSemiAutoBrowser(task: SemiAutoReadinessTask) {
/** 完成履约仍必须满足平台角色绑定策略。 */
export function canCompleteSemiAutoTask(task: SemiAutoReadinessTask) {
if (task.platform === 'huya' && task.bindingDecision) {
return task.bindingDecision.canCompleteTask
}
return (
hasUsableCredential(task) &&
(!task.bindingPolicy.bindingRequired || task.bindingStatus === 'confirmed')