fix: recover auction client from rejected transitions
거부(특히 낙관적 동시성 CONFLICT)를 받은 클라가 낡은 상태에 멈춰 후속 액션을 반복 거부받던 문제를 해결한다. - 서버: 거부 ack에 설명적 거부코드(auctionRejectionReason)와 resync 권장 여부, 그리고 resync 권장 거부에 한해 최신 권위 state를 동봉한다. 구조 전환 거부는 내부 code(CONFLICT 등)를 구조화해 던져 매핑 가능하게 한다. - 클라: 거부 시 동봉된 state로 즉시 rebaseline(없으면 join으로 재요청)하고, "낡은 화면" 거부면 구조 액션을 1회 자동 재시도한다. 거부 문구를 거부코드 기반 한국어로 매핑한다(error 이벤트 채널 포함). 신규 auction-rejection 모듈로 짧은 내부 코드를 맥락이 담긴 설명적 코드로 변환한다. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
1 parent
09d304d782
commit
55b80e62cd
6 files changed
+477
-15
No files matched your search
@@ -0,0 +1,101 @@
|
||||
/**
|
||||
* 경매 거부코드 → 사용자 문구 매핑(프론트 전용).
|
||||
*
|
||||
* 서버(`apps/api/.../auction-rejection.ts`)가 ack에 실어주는 설명적 거부코드
|
||||
* `auctionRejectionReason`를 사람이 읽는 한국어 문구로 바꾼다. reason 문자열은
|
||||
* 서버와의 계약이므로 양쪽을 함께 바꿔야 한다(서버는 영문 message도 함께 보내므로,
|
||||
* 매핑이 빠진 reason은 message로 폴백된다).
|
||||
*
|
||||
* 또한 ack가 없는 `error` 이벤트 채널(영문 message만 옴)도 같은 톤의 한국어로
|
||||
* 바꿀 수 있도록 영문 message → 한국어 매핑을 함께 둔다.
|
||||
*/
|
||||
|
||||
/** 서버 `AUCTION_REJECTION_REASON`와 1:1로 맞춘 사용자 문구. */
|
||||
const REASON_TO_USER_MESSAGE: Record<string, string> = {
|
||||
// 구조 전환
|
||||
AUCTION_TRANSITION_REJECTED_BECAUSE_LIVE_STATE_CHANGED_BEFORE_APPLY:
|
||||
'경매 상태가 바뀌어 최신 상태로 맞췄어요. 다시 시도해 주세요.',
|
||||
AUCTION_TRANSITION_REJECTED_BECAUSE_AUCTION_NOT_IN_BIDDING_PHASE:
|
||||
'이미 입찰 단계가 아니에요. 최신 상태로 맞췄어요.',
|
||||
AUCTION_TRANSITION_REJECTED_BECAUSE_PHASE_DOES_NOT_ALLOW_ADVANCE:
|
||||
'이미 다음 단계로 넘어간 상태예요. 최신 상태로 맞췄어요.',
|
||||
AUCTION_TRANSITION_REJECTED_BECAUSE_NO_WINNING_BID_TO_MARK_SOLD:
|
||||
'낙찰할 입찰이 없어요. 최신 상태로 맞췄어요.',
|
||||
AUCTION_TRANSITION_REJECTED_BECAUSE_ACTIVE_BID_PRESENT:
|
||||
'진행 중인 입찰이 있어 유찰할 수 없어요.',
|
||||
AUCTION_TRANSITION_REJECTED_BECAUSE_REQUEST_COORDINATION_RETRYABLE:
|
||||
'잠시 처리 중이라 반영되지 않았어요. 다시 시도해 주세요.',
|
||||
// 입찰
|
||||
BID_REJECTED_BECAUSE_BID_ROUND_ALREADY_ADVANCED: '이미 다음 선수로 넘어갔어요.',
|
||||
BID_REJECTED_BECAUSE_BID_ROUND_DEADLINE_PASSED: '마감되어 반영되지 않았어요.',
|
||||
BID_REJECTED_BECAUSE_AUCTION_NOT_IN_BIDDING_PHASE:
|
||||
'지금은 입찰할 수 없는 단계예요.',
|
||||
BID_REJECTED_BECAUSE_AMOUNT_NOT_HIGHER_THAN_CURRENT_HIGHEST:
|
||||
'더 높은 입찰이 있었어요.',
|
||||
BID_REJECTED_BECAUSE_TEAM_ROSTER_FULL: '팀 정원이 가득 찼어요.',
|
||||
BID_REJECTED_BECAUSE_INSUFFICIENT_REMAINING_POINTS_FOR_SLOTS:
|
||||
'남은 슬롯을 고려하면 포인트가 부족해요.',
|
||||
BID_REJECTED_BECAUSE_UNKNOWN_TEAM: '알 수 없는 팀이에요.',
|
||||
BID_REJECTED_BECAUSE_DUPLICATE_REQUEST_PAYLOAD_CONFLICT: '중복된 요청이에요.',
|
||||
BID_REJECTED_BECAUSE_RATE_LIMITED:
|
||||
'요청이 너무 많아요. 잠시 후 다시 시도해 주세요.',
|
||||
// 공통
|
||||
AUCTION_REQUEST_REJECTED_BECAUSE_REALTIME_STATE_UNAVAILABLE:
|
||||
'실시간 상태를 불러오는 중이에요. 잠시 후 다시 시도해 주세요.',
|
||||
};
|
||||
|
||||
/** ack 없이 `error` 이벤트로만 오는 영문 message → 한국어. */
|
||||
const ENGLISH_MESSAGE_TO_USER_MESSAGE: Record<string, string> = {
|
||||
'Bid deadline has already expired.': '마감되어 반영되지 않았어요.',
|
||||
'Bid must exceed current bid.': '더 높은 입찰이 있었어요.',
|
||||
'Bid round has already changed.': '이미 다음 선수로 넘어갔어요.',
|
||||
'Auction is not in bidding phase.': '지금은 입찰할 수 없는 단계예요.',
|
||||
'Team already has maximum members.': '팀 정원이 가득 찼어요.',
|
||||
'Bid must reserve minimum points for remaining slots.':
|
||||
'남은 슬롯을 고려하면 포인트가 부족해요.',
|
||||
'Unknown team.': '알 수 없는 팀이에요.',
|
||||
'Bid request conflicts with an earlier request.': '중복된 요청이에요.',
|
||||
'Cannot advance from current phase.':
|
||||
'이미 다음 단계로 넘어간 상태예요. 최신 상태로 맞췄어요.',
|
||||
'No bid to mark sold.': '낙찰할 입찰이 없어요. 최신 상태로 맞췄어요.',
|
||||
'Cannot pass a player with an active bid.':
|
||||
'진행 중인 입찰이 있어 유찰할 수 없어요.',
|
||||
};
|
||||
|
||||
const DEFAULT_REJECTION_MESSAGE = '요청이 반영되지 않았어요.';
|
||||
const DEFAULT_ERROR_MESSAGE = '실시간 경매 연결 중 오류가 발생했습니다.';
|
||||
|
||||
export interface AuctionRejectionAckLike {
|
||||
auctionRejectionReason?: string;
|
||||
code?: string;
|
||||
message?: string;
|
||||
resyncRecommended?: boolean;
|
||||
}
|
||||
|
||||
/** 거부 ack → 사용자 문구. reason 매핑 우선, 없으면 영문 message 매핑, 그래도 없으면 원문/기본값. */
|
||||
export function resolveAuctionRejectionMessage(
|
||||
ack: AuctionRejectionAckLike,
|
||||
): string {
|
||||
if (ack.auctionRejectionReason) {
|
||||
const mapped = REASON_TO_USER_MESSAGE[ack.auctionRejectionReason];
|
||||
if (mapped) return mapped;
|
||||
}
|
||||
if (ack.message) {
|
||||
const mapped = ENGLISH_MESSAGE_TO_USER_MESSAGE[ack.message];
|
||||
if (mapped) return mapped;
|
||||
}
|
||||
return ack.message ?? ack.code ?? DEFAULT_REJECTION_MESSAGE;
|
||||
}
|
||||
|
||||
/** `error` 이벤트(영문 message) → 사용자 문구. */
|
||||
export function resolveAuctionErrorMessage(message?: string): string {
|
||||
if (message && ENGLISH_MESSAGE_TO_USER_MESSAGE[message]) {
|
||||
return ENGLISH_MESSAGE_TO_USER_MESSAGE[message];
|
||||
}
|
||||
return message ?? DEFAULT_ERROR_MESSAGE;
|
||||
}
|
||||
|
||||
/** 최신 상태로 rebaseline 후 재시도가 권장되는 거부인지. */
|
||||
export function isAuctionResyncRecommended(ack: AuctionRejectionAckLike): boolean {
|
||||
return ack.resyncRecommended === true;
|
||||
}
|
||||
@@ -3,6 +3,11 @@ import { io, type Socket } from 'socket.io-client';
|
||||
import { API_BASE_URL, useAuthUserId } from '../config';
|
||||
import { acquireAccessToken } from '../lib/auth/token-provider';
|
||||
import type { ApiAuction, ApiAuctionChatMessage, Position } from './types';
|
||||
import {
|
||||
isAuctionResyncRecommended,
|
||||
resolveAuctionErrorMessage,
|
||||
resolveAuctionRejectionMessage,
|
||||
} from './auctionRejectionMessages';
|
||||
|
||||
type ConnectionStatus =
|
||||
| 'idle'
|
||||
@@ -84,12 +89,14 @@ interface BidDiagnosticsPayload {
|
||||
}
|
||||
|
||||
interface BidAckPayload {
|
||||
auctionRejectionReason?: string;
|
||||
bidDelta?: BidDeltaPayload | null;
|
||||
bidDiagnostics?: BidDiagnosticsPayload;
|
||||
bidServerTiming?: BidServerTimingPayload;
|
||||
code?: string;
|
||||
message?: string;
|
||||
rejected?: boolean;
|
||||
resyncRecommended?: boolean;
|
||||
state?: ApiAuction;
|
||||
}
|
||||
|
||||
@@ -435,7 +442,8 @@ export function useAuctionSocket(matchId: string | undefined) {
|
||||
});
|
||||
|
||||
socket.on('error', (payload: { message?: string }) => {
|
||||
setError(payload.message ?? '실시간 경매 연결 중 오류가 발생했습니다.');
|
||||
// ack 없는 error 채널(영문 message만)도 같은 톤의 한국어로 매핑한다.
|
||||
setError(resolveAuctionErrorMessage(payload.message));
|
||||
});
|
||||
})();
|
||||
|
||||
@@ -527,7 +535,21 @@ export function useAuctionSocket(matchId: string | undefined) {
|
||||
};
|
||||
}
|
||||
|
||||
function emitAuctionAction(eventName: string, payload: AuctionActionPayload) {
|
||||
// 거부 등으로 클라 상태가 낡았을 때 서버 최신 state를 다시 받아 rebaseline한다.
|
||||
// join 핸들러가 getStateByMatchId → broadcastState로 fresh state를 내려주고,
|
||||
// revision 가드상 더 높은 revision이라 정상 적용된다(force-resync 아님).
|
||||
function resyncAuctionState() {
|
||||
const socket = socketRef.current;
|
||||
if (!socket || !socket.connected || !matchId) return;
|
||||
socket.emit('join', { matchId });
|
||||
}
|
||||
|
||||
// retryAttempt: 거부 후 자동 재시도 횟수(루프 방지를 위해 1회로 제한).
|
||||
function emitAuctionAction(
|
||||
eventName: string,
|
||||
payload: AuctionActionPayload,
|
||||
retryAttempt = 0,
|
||||
) {
|
||||
const socket = socketRef.current;
|
||||
if (!socket || !socket.connected) {
|
||||
setError('소켓이 아직 연결되지 않았습니다.');
|
||||
@@ -557,15 +579,41 @@ export function useAuctionSocket(matchId: string | undefined) {
|
||||
actionPayload,
|
||||
(ack?: {
|
||||
auctionActionRequestId?: string;
|
||||
auctionRejectionReason?: string;
|
||||
code?: string;
|
||||
message?: string;
|
||||
rejected?: boolean;
|
||||
resyncRecommended?: boolean;
|
||||
state?: ApiAuction;
|
||||
}) => {
|
||||
if (ack?.rejected) {
|
||||
clearPendingActionRequest(
|
||||
ack?.auctionActionRequestId ?? auctionActionRequestId,
|
||||
);
|
||||
setError(ack.code ?? '경매 진행 상태가 반영되지 않았습니다.');
|
||||
// 1) rebaseline: 서버가 동봉한 최신 state를 즉시 반영(없으면 join으로 재요청).
|
||||
// commitAuctionState는 latestAuctionRef를 동기로 갱신하므로, 이후
|
||||
// buildAuctionActionPayload는 최신 관측값(revision/phase/선수)을 읽는다.
|
||||
if (ack.state) {
|
||||
commitAuctionState(ack.state);
|
||||
} else if (isAuctionResyncRecommended(ack)) {
|
||||
resyncAuctionState();
|
||||
}
|
||||
// 2) 자동 재시도: "낡은 화면 때문에 거부"였고 동기 rebaseline 소스(state)가
|
||||
// 있을 때만 1회. assignedPosition 등 원래 payload는 유지하고 관측값/요청
|
||||
// id만 새로 만든다. 재시도 시에는 중간 에러 문구를 띄우지 않는다(무음 복구).
|
||||
const canAutoRetry =
|
||||
Boolean(ack.state) &&
|
||||
isAuctionResyncRecommended(ack) &&
|
||||
retryAttempt < 1;
|
||||
if (canAutoRetry) {
|
||||
emitAuctionAction(
|
||||
eventName,
|
||||
{ ...payload, ...buildAuctionActionPayload() },
|
||||
retryAttempt + 1,
|
||||
);
|
||||
} else {
|
||||
setError(resolveAuctionRejectionMessage(ack));
|
||||
}
|
||||
return;
|
||||
}
|
||||
const ackState = ack?.state;
|
||||
@@ -644,7 +692,15 @@ export function useAuctionSocket(matchId: string | undefined) {
|
||||
captureBidLatencyDiagnostics(ack);
|
||||
if (ack?.rejected) {
|
||||
clearPendingBidRequest(bidRequestId);
|
||||
setError(ack.message ?? ack.code ?? '입찰이 반영되지 않았습니다.');
|
||||
// 입찰 거부도 최신 state로 rebaseline(예: 0초 입찰 EXPIRED → 만료된
|
||||
// 라운드 화면에서 벗어나게). 단 입찰은 자동 재시도하지 않는다(의도치
|
||||
// 않은 금액 재입찰 방지).
|
||||
if (ack.state) {
|
||||
commitAuctionState(ack.state);
|
||||
} else if (isAuctionResyncRecommended(ack)) {
|
||||
resyncAuctionState();
|
||||
}
|
||||
setError(resolveAuctionRejectionMessage(ack));
|
||||
return;
|
||||
}
|
||||
if (ack?.bidDelta) {
|
||||
|
||||
Reference in new issue
Block a user