first commit

This commit is contained in:
dahyeon committed 2026-08-12 17:28:30 +09:00
1 parent 18d31d5dcf
commit 77a5f5248c
31 files changed
+6637 -30

No files matched your search

+225
View File
@@ -0,0 +1,225 @@
export interface Branch {
num: number
name: string
phone: string
}
export interface Theme {
infoNum: number
themeNum: number
name: string
doing: number
memo: string
}
export interface ThemeDetail {
name: string
imageUrl: string
genre: string
level: string
playTime: string
memo: string
serverToday: string
}
export interface TimeSlot {
num: number
time: string
available: boolean
saleText: string
}
export interface PriceOption {
person: number
totalPrice: number
}
export interface ReservationSelection {
branchNum: number
themeNum: number
themeInfoNum: number
date: string
timeNum: number
timeLabel: string
themeName: string
}
export interface ReservationRequest extends ReservationSelection {
totalPrice: number
person: number
name: string
phone: string
captchaToken: string
}
export interface ReservationResult {
success: boolean
message: string
reservationNum?: string
confirmationUrl?: string
transport?: ReservationTransport
}
export interface ReservationTransport {
sentAtMs: number
receivedAtMs: number
rttMs: number
httpStatus: number
remoteIp: string
reusedSocket: boolean
observedServerDateMs?: number
}
export interface ClockSample {
id: number
sentAtMs: number
receivedAtMs: number
midpointMs: number
serverDateMs: number
rttMs: number
offsetEstimateMs: number
offsetMinMs: number
offsetMaxMs: number
remoteIp: string
reusedSocket: boolean
accepted: boolean
rejectionReason?: string
}
export interface ClockCalibrationSettings {
enabled: boolean
autoApply: boolean
scanWindowMs: number
probeIntervalMs: number
initialBoundarySpacingSec: number
requiredBoundaryCount: number
historySize: number
maxBoundarySpreadMs: number
maxProbeRttMs: number
maintenanceIntervalSec: number
sampleWindowSize: number
}
export const CLOCK_CALIBRATION_DEFAULTS: ClockCalibrationSettings = {
enabled: true,
autoApply: true,
scanWindowMs: 250,
probeIntervalMs: 50,
initialBoundarySpacingSec: 2,
requiredBoundaryCount: 5,
historySize: 12,
maxBoundarySpreadMs: 120,
maxProbeRttMs: 350,
maintenanceIntervalSec: 15,
sampleWindowSize: 240,
}
export interface ClockEstimate {
monitoring: boolean
observedAtMs: number
estimatedServerTimeMs: number
offsetMs: number
driftPpm: number
minRttMs: number
p50RttMs: number
p95RttMs: number
oneWayMs: number
uncertaintyMs: number
sampleAgeMs: number
acceptedSamples: number
rawOffsetMs: number
boundaryCount: number
boundaryOffsetMs?: number
boundaryUncertaintyMs?: number
boundarySpreadMs?: number
recommendedCorrectionMs: number
calibrationReady: boolean
calibrationApplied: boolean
calibrationSettings: ClockCalibrationSettings
remoteIp: string
quality: 'good' | 'fair' | 'poor' | 'unavailable'
warning?: string
samples: ClockSample[]
}
export interface TimingTestRequest {
targetServerTimeMs: number
userOffsetMs: number
}
export interface TimingTestResult {
targetServerTimeMs: number
plannedSendAtMs: number
actualSendAtMs: number
estimatedArrivalServerMs: number
arrivalErrorMs: number
schedulerJitterMs: number
rttMs: number
uncertaintyMs: number
remoteIp: string
reusedSocket: boolean
}
export interface AutoReservationConfig {
request: ReservationRequest
targetServerTimeMs: number
userOffsetMs: number
captchaPastedAtMs: number
}
export interface AutoReservationSnapshot {
branchNum: number
themeNum: number
themeInfoNum: number
date: string
timeNum: number
timeLabel: string
themeName: string
totalPrice: number
person: number
}
export interface AutoReservationTimeline {
plannedSendAtMs?: number
actualSendAtMs?: number
estimatedArrivalServerMs?: number
arrivalErrorMs?: number
rttMs?: number
httpStatus?: number
remoteIp?: string
reusedSocket?: boolean
}
export interface AutoReservationState {
status: 'idle' | 'armed' | 'firing' | 'succeeded' | 'failed' | 'cancelled'
targetServerTimeMs?: number
userOffsetMs?: number
armedAtMs?: number
captchaPastedAtMs?: number
tokenStatus: 'empty' | 'ready' | 'consumed' | 'expired'
snapshot?: AutoReservationSnapshot
warning?: string
message?: string
result?: ReservationResult
timeline?: AutoReservationTimeline
}
export interface ReservationApi {
getBranches(): Promise<Branch[]>
getThemes(branchNum: number): Promise<Theme[]>
getThemeDetail(themeInfoNum: number): Promise<ThemeDetail>
getTimes(selection: Pick<ReservationSelection, 'date' | 'branchNum' | 'themeNum'>): Promise<TimeSlot[]>
prepare(selection: ReservationSelection): Promise<PriceOption[]>
openCaptcha(selection: Pick<ReservationSelection, 'branchNum' | 'themeNum' | 'themeInfoNum'>): Promise<void>
submit(request: ReservationRequest): Promise<ReservationResult>
startClockMonitor(): Promise<ClockEstimate>
stopClockMonitor(): Promise<ClockEstimate>
getClockState(): Promise<ClockEstimate>
configureClock(settings: ClockCalibrationSettings): Promise<ClockEstimate>
subscribeClock(listener: (estimate: ClockEstimate) => void): () => void
runTimingTest(request: TimingTestRequest): Promise<TimingTestResult>
armAutoReservation(config: AutoReservationConfig): Promise<AutoReservationState>
disarmAutoReservation(): Promise<AutoReservationState>
getAutoReservationState(): Promise<AutoReservationState>
subscribeAutoState(listener: (state: AutoReservationState) => void): () => void
}