feat(fulfillment): 增加事务 Outbox 同步履约状态

- 用事务 Outbox 和签名 Webhook 替换直接状态回调
- 增加 Outbox 投递 worker、重试与低频对账兜底
- 缓存客户领取页绑定状态并补充签名与迁移测试
This commit is contained in:
yml
2026-11-18 11:00:28 +08:00
parent 54b9f3251d
commit 9b2fcf1d1f
23 changed files with 1324 additions and 130 deletions
@@ -188,6 +188,7 @@ export default function AdminLayout() {
void queryClient.invalidateQueries({ queryKey: ['admin-notifications'] })
void queryClient.invalidateQueries({ queryKey: ['admin-tasks'] })
void queryClient.invalidateQueries({ queryKey: ['admin-orders'] })
void queryClient.invalidateQueries({ queryKey: ['admin-douyu-fulfillment'] })
void queryClient.invalidateQueries({ queryKey: ['admin-dashboard-summary'] })
},
// 会话过期时清登录态回登录页,避免 SSE 带着失效 token 无限重连刷 401。
@@ -522,6 +523,10 @@ function applyAdminRealtimeEvent(
event: RealtimeEvent,
queryClient: ReturnType<typeof useQueryClient>,
) {
if (event.type === 'order.changed' && event.scopes.includes('admin_douyu_fulfillment')) {
void queryClient.invalidateQueries({ queryKey: ['admin-douyu-fulfillment'] })
}
if (event.type === 'admin_notification.changed' && isRecord(event.data)) {
queryClient.setQueryData(['admin-notifications'], (current: unknown) => {
if (!isRecord(current) || !isRecord(current.data)) return current
@@ -93,13 +93,11 @@ export default function AdminDouyuFulfillmentPage() {
page,
pageSize,
}),
refetchInterval: 5000,
})
const detailQuery = useQuery({
queryKey: ['admin-douyu-fulfillment-detail', detailOrderNo],
queryFn: () => fetchAdminDouyuFulfillmentDetail(detailOrderNo),
enabled: Boolean(detailOrderNo),
refetchInterval: detailOrderNo ? 3000 : false,
})
const list = listQuery.data?.data.items || []
@@ -52,6 +52,13 @@ function systemLabel(value: string) {
return '未填写'
}
function formatRemainingTime(totalSeconds: number) {
const seconds = Math.max(0, Math.ceil(totalSeconds))
const minutes = Math.floor(seconds / 60)
const rest = seconds % 60
return `${String(minutes).padStart(2, '0')}:${String(rest).padStart(2, '0')}`
}
export default function DouyuFulfillmentPage() {
const { message } = App.useApp()
const { orderNo = '' } = useParams<{ orderNo: string }>()
@@ -65,7 +72,7 @@ export default function DouyuFulfillmentPage() {
const [system, setSystem] = useState<DouyuCustomerSystem>('android')
const [qrImage, setQrImage] = useState('')
const [bindingQrExpanded, setBindingQrExpanded] = useState(false)
const [nowMs, setNowMs] = useState(0)
const [nowMs, setNowMs] = useState(() => Date.now())
const autoStartRef = useRef('')
const applyData = useCallback((next: DouyuCustomerFulfillment) => {
@@ -177,6 +184,16 @@ export default function DouyuFulfillmentPage() {
if (!expiresAt || Number.isNaN(expiresAt)) return 0
return Math.max(0, Math.floor((expiresAt - nowMs) / 1000))
}, [live?.qrExpiresAt, nowMs])
const qrExpired = Boolean(live?.qrUrl && live.qrExpiresAt && expiresInSeconds <= 0)
const qrTotalSeconds = useMemo(() => {
const generatedAt = live?.qrGeneratedAt ? Date.parse(live.qrGeneratedAt) : 0
const expiresAt = live?.qrExpiresAt ? Date.parse(live.qrExpiresAt) : 0
if (!generatedAt || !expiresAt || Number.isNaN(generatedAt) || Number.isNaN(expiresAt)) {
return 600
}
return Math.max(1, Math.floor((expiresAt - generatedAt) / 1000))
}, [live?.qrExpiresAt, live?.qrGeneratedAt])
const qrProgressPercent = Math.max(0, Math.min(100, (expiresInSeconds / qrTotalSeconds) * 100))
const canRevealBindingQr = Boolean(
live?.qrUrl && (live.bindReadyForConfirm || live.bindConfirmed),
)
@@ -188,7 +205,19 @@ export default function DouyuFulfillmentPage() {
? '角色绑定已完成,待客服处理。'
: live?.bindReadyForConfirm
? '已识别游戏角色,请核对并确认绑定。'
: live?.message || '请使用微信扫描下方二维码,按提示选择和平精英角色。二维码仅用于本次订单。'
: qrExpired
? '当前二维码已过期,请刷新二维码后重新扫码。'
: live?.issueCode === 'binding_failed'
? '暂未识别到绑定角色,请继续使用当前二维码完成扫码。'
: !live?.accountReady
? '系统正在自动准备账号和二维码,请稍候,无需重复操作。'
: live?.qrUrl
? '必须使用微信扫码。请选择与资料一致的和平精英角色,QQ 扫码或其他方式无效。'
: live?.message || '正在准备绑定二维码,请稍候。'
const bindingStageTitle =
task?.status === 'qr_pending' && live?.qrUrl
? '必须使用微信扫码绑定'
: STATUS_LABELS[task?.status || ''] || '等待处理'
async function submitProfile() {
if (!roleName.trim()) {
@@ -212,6 +241,10 @@ export default function DouyuFulfillmentPage() {
}
async function startBinding(forceRefresh = false) {
if (forceRefresh && !qrExpired) {
message.info('二维码有效期内无需刷新')
return
}
setBindingLoading(true)
try {
const response = await startDouyuBinding(orderNo, forceRefresh)
@@ -295,7 +328,10 @@ export default function DouyuFulfillmentPage() {
}
return (
<CustomerFrame title="斗鱼精英宝典领取">
<CustomerFrame
title="斗鱼精英宝典领取"
compact={Boolean(live?.qrUrl && !live.bindReadyForConfirm && !live.bindConfirmed)}
>
<OrderCard data={data} />
{needsProfile ? (
@@ -353,9 +389,10 @@ export default function DouyuFulfillmentPage() {
) : (
<section className="customer-binding-stage">
<Alert
type={live?.bindConfirmed ? 'success' : 'info'}
className={live?.qrUrl ? 'customer-douyu-binding-alert is-wechat' : undefined}
type={qrExpired ? 'warning' : live?.bindConfirmed ? 'success' : 'info'}
showIcon
message={STATUS_LABELS[task.status] || '等待处理'}
message={bindingStageTitle}
description={bindingDescription}
/>
@@ -370,17 +407,33 @@ export default function DouyuFulfillmentPage() {
) : null}
{!live?.qrUrl && task.status !== 'completed' ? (
<div className="customer-binding-qr-card">
<div className="customer-binding-qr-card customer-douyu-preparing-card">
<h3>游戏角色绑定二维码</h3>
<div className="customer-binding-qr-code">
<div className="customer-auth-qr-placeholder">
<Spin />
<span>正在准备绑定二维码...</span>
<div className="customer-douyu-qr-main">
<span className="customer-douyu-qr-rail" aria-hidden="true">
必须使用微信扫码
</span>
<div className="customer-binding-qr-code">
<div className="customer-douyu-qr-preparing">
<div className="customer-douyu-qr-skeleton" aria-hidden="true" />
<div className="customer-douyu-qr-preparing-copy">
<Spin />
<strong>正在生成二维码</strong>
<span>系统会自动刷新,请稍候</span>
</div>
</div>
</div>
<span className="customer-douyu-qr-rail" aria-hidden="true">
必须使用微信扫码
</span>
</div>
<p className="customer-binding-qr-hint">
二维码准备完成后,必须使用微信扫码并选择游戏角色。
</p>
<Button
block
size="large"
className="customer-douyu-preparing-button"
loading={bindingLoading}
onClick={() => void startBinding(false)}
>
@@ -392,43 +445,55 @@ export default function DouyuFulfillmentPage() {
{live?.qrUrl && showBindingQr ? (
<div className="customer-binding-qr-card">
<h3>游戏角色绑定二维码</h3>
<div className="customer-binding-qr-code">
{qrImage ? (
<Image src={qrImage} alt="和平精英角色绑定二维码" width="100%" preview={false} />
) : (
<div className="customer-auth-qr-placeholder">
<Spin />
<span>正在生成二维码图片...</span>
</div>
)}
<div className="customer-douyu-qr-main">
<span className="customer-douyu-qr-rail" aria-hidden="true">
必须使用微信扫码
</span>
<div className="customer-binding-qr-code">
{qrImage ? (
<Image
src={qrImage}
alt="和平精英角色绑定二维码"
width="100%"
preview={false}
/>
) : (
<div className="customer-auth-qr-placeholder">
<Spin />
<span>正在生成二维码图片...</span>
</div>
)}
</div>
<span className="customer-douyu-qr-rail" aria-hidden="true">
必须使用微信扫码
</span>
</div>
<p className="customer-binding-qr-hint">
请使用微信扫码,并选择与资料一致的和平精英角色。
必须使用微信扫码,并选择与资料一致的和平精英角色。
</p>
{expiresInSeconds > 0 ? (
{qrExpired ? (
<div className="customer-binding-qr-countdown is-expired">二维码已过期</div>
) : (
<div className="customer-binding-qr-countdown">
二维码剩余 {Math.ceil(expiresInSeconds / 60)} 分钟
二维码有效期剩余 {formatRemainingTime(expiresInSeconds)}
</div>
) : null}
<Progress percent={Math.min(100, (expiresInSeconds / 600) * 100)} showInfo={false} />
<div className="customer-binding-qr-actions">
)}
<Progress percent={qrProgressPercent} showInfo={false} />
<div className="customer-binding-qr-actions is-single">
<Button
icon={<ReloadOutlined />}
loading={bindingLoading}
disabled={!qrExpired}
onClick={() => void startBinding(true)}
>
刷新二维码
</Button>
<Button
icon={<QrcodeOutlined />}
loading={bindingLoading}
onClick={() =>
void pollDouyuBinding(orderNo).then((response) => applyData(response.data))
}
>
刷新状态
</Button>
</div>
<p className="customer-douyu-qr-refresh-note">
{qrExpired
? '二维码已过期,请刷新后重新扫码'
: '二维码有效期内无需刷新,过期后可重新生成'}
</p>
</div>
) : null}
@@ -506,9 +571,17 @@ function ChoiceSwitch<T extends string>(input: {
)
}
function CustomerFrame({ title, children }: { title: string; children: ReactNode }) {
function CustomerFrame({
title,
compact = false,
children,
}: {
title: string
compact?: boolean
children: ReactNode
}) {
return (
<div className="customer-auth-page is-huya is-douyu">
<div className={`customer-auth-page is-huya is-douyu${compact ? ' is-compact' : ''}`}>
<div className="customer-auth-shell">
<header className="customer-auth-hero">
<div className="customer-auth-brand">
+282
View File
@@ -3117,6 +3117,288 @@
background: rgba(127, 29, 29, 0.24);
}
.customer-douyu-qr-main {
width: 100%;
display: grid;
grid-template-columns: 30px minmax(0, 220px) 30px;
align-items: stretch;
justify-content: center;
gap: 7px;
}
.customer-douyu-qr-rail {
display: flex;
align-items: center;
justify-content: center;
min-height: 0;
padding: 0;
color: #ff5a67;
font-size: 12px;
font-weight: 800;
line-height: 1.05;
letter-spacing: 1px;
text-align: center;
writing-mode: vertical-rl;
text-orientation: upright;
background: none;
}
.customer-auth-page.is-douyu .customer-douyu-qr-main .customer-binding-qr-code {
width: 100%;
max-width: none;
padding: 10px;
}
.customer-auth-page.is-douyu .customer-douyu-qr-preparing {
position: relative;
width: 100%;
height: 100%;
min-height: 100%;
display: grid;
place-items: center;
overflow: hidden;
border-radius: 7px;
background: #171c24;
}
.customer-auth-page.is-douyu .customer-douyu-qr-skeleton {
position: absolute;
inset: 18px;
opacity: 0.16;
background-image:
linear-gradient(90deg, #9fb1ca 50%, transparent 50%),
linear-gradient(#9fb1ca 50%, transparent 50%);
background-position:
0 0,
0 0;
background-size:
18px 18px,
18px 18px;
-webkit-mask-image: linear-gradient(135deg, #000 12%, transparent 82%);
mask-image: linear-gradient(135deg, #000 12%, transparent 82%);
}
.customer-auth-page.is-douyu .customer-douyu-qr-preparing-copy {
position: relative;
z-index: 1;
display: flex;
flex-direction: column;
align-items: center;
gap: 8px;
color: #b8c1cf;
text-align: center;
}
.customer-auth-page.is-douyu .customer-douyu-qr-preparing-copy strong {
color: #e2e8f0;
font-size: 14px;
font-weight: 600;
}
.customer-auth-page.is-douyu .customer-douyu-qr-preparing-copy span {
color: #8f9aaa;
font-size: 12px;
}
.customer-auth-page.is-douyu .customer-douyu-preparing-button.ant-btn {
color: #e2e8f0;
border-color: #465063;
background: #2a313d;
box-shadow: none;
}
.customer-auth-page.is-douyu .customer-douyu-preparing-button.ant-btn:hover,
.customer-auth-page.is-douyu .customer-douyu-preparing-button.ant-btn:focus-visible {
color: #fff;
border-color: #657186;
background: #343c4a;
}
.customer-auth-page.is-douyu .customer-binding-qr-actions.is-single {
grid-template-columns: minmax(0, 1fr);
}
.customer-auth-page.is-douyu .customer-binding-qr-actions .ant-btn:disabled {
color: #7d8797;
border-color: #394353;
background: #252c37;
opacity: 1;
}
.customer-auth-page.is-douyu .customer-binding-qr-countdown.is-expired {
color: #ff7a84;
font-weight: 700;
}
.customer-auth-page.is-douyu .customer-douyu-qr-refresh-note {
margin: -2px 0 0;
color: #8f9aaa;
font-size: 11px;
line-height: 1.4;
text-align: center;
}
.customer-auth-page.is-douyu .customer-douyu-binding-alert.is-wechat {
border-color: rgba(248, 113, 113, 0.34);
background: linear-gradient(135deg, rgba(127, 29, 29, 0.26), rgba(32, 38, 49, 0.9));
}
.customer-auth-page.is-douyu .customer-douyu-binding-alert.is-wechat .ant-alert-icon,
.customer-auth-page.is-douyu .customer-douyu-binding-alert.is-wechat .ant-alert-message,
.customer-auth-page.is-douyu .customer-douyu-binding-alert.is-wechat .ant-alert-title {
color: #ff8a92;
}
.customer-auth-page.is-douyu.is-compact {
height: 100vh;
height: 100dvh;
min-height: 0;
overflow: hidden;
}
.customer-auth-page.is-douyu.is-compact .customer-auth-shell {
height: 100%;
display: flex;
flex-direction: column;
}
.customer-auth-page.is-douyu.is-compact .customer-auth-hero {
min-height: 148px;
padding: 0 16px 18px;
background-position: center 34%;
}
.customer-auth-page.is-douyu.is-compact .customer-auth-warning {
padding: 8px 16px 12px;
font-size: 14px;
}
.customer-auth-page.is-douyu.is-compact .customer-auth-main {
display: flex;
flex-direction: column;
flex: 1 1 auto;
min-height: 0;
padding-bottom: 0;
overflow: hidden;
}
.customer-auth-page.is-douyu.is-compact .customer-douyu-order-card {
flex: none;
margin: 10px 16px 0;
}
.customer-auth-page.is-douyu.is-compact .customer-douyu-order-head {
padding: 13px 16px;
}
.customer-auth-page.is-douyu.is-compact .customer-douyu-order-field {
grid-template-columns: 72px minmax(0, 1fr);
gap: 12px;
padding: 11px 16px;
}
.customer-auth-page.is-douyu.is-compact .customer-douyu-order-field > span,
.customer-auth-page.is-douyu.is-compact .customer-douyu-order-field > strong {
font-size: 14px;
line-height: 1.5;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-stage {
flex: 1 1 auto;
min-height: 0;
justify-content: center;
gap: 14px;
padding: 16px;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-stage .ant-alert {
flex: none;
padding: 12px 14px;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-stage .ant-alert-description {
margin-top: 4px;
font-size: 13px;
line-height: 1.6;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-qr-card {
flex: 0 1 auto;
justify-content: center;
gap: 10px;
padding: 18px;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-qr-card h3 {
font-size: 15px;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-qr-hint {
font-size: 13px;
line-height: 1.6;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-qr-countdown {
font-size: 13px;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-qr-card .ant-progress {
line-height: 1.5;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-qr-actions {
margin-top: 4px;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-qr-actions .ant-btn {
height: 40px;
font-size: 14px;
}
@media (max-height: 720px) {
.customer-auth-page.is-douyu.is-compact .customer-auth-hero {
min-height: 60px;
padding-bottom: 6px;
}
.customer-auth-page.is-douyu.is-compact .customer-auth-warning {
padding-block: 1px 4px;
font-size: 11px;
}
.customer-auth-page.is-douyu.is-compact .customer-douyu-order-head {
padding-block: 6px;
}
.customer-auth-page.is-douyu.is-compact .customer-douyu-order-field {
padding-block: 5px;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-stage {
justify-content: flex-start;
gap: 6px;
padding-block: 6px;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-stage .ant-alert-description {
display: none;
}
.customer-auth-page.is-douyu.is-compact .customer-binding-qr-card {
gap: 4px;
padding-block: 7px;
}
.customer-auth-page.is-douyu.is-compact .customer-douyu-qr-main {
grid-template-columns: 26px minmax(0, clamp(154px, 30dvh, 190px)) 26px;
gap: 5px;
}
.customer-auth-page.is-douyu.is-compact .customer-douyu-qr-rail {
font-size: 10px;
}
}
.customer-choice-switch {
display: grid;
grid-template-columns: repeat(2, minmax(0, 1fr));