- site/server: Discord OAuth2 + 봇 토큰 멤버 확인, 세션, 1회용 등록 코드·기기 키 인증, 게임 PC WebSocket 중계(JSON·음성 바이너리), 15초 무응답 잠금, 게임 이미지 캐시, 관리 CLI - site/web: 타임라인·따라 읽기 재생(단어 강조·이어듣기·현장 모드·재생 게인)·필터·검색·실시간·교정, 발로란트/롤 경기 상세, 잠금 화면(관리자 등록 코드), 모바일, 효과음 - deploy/site: Dockerfile·compose·deploy.sh·make-env.sh (.5, 포트 2972) - 앱 코어: 사이트 필터 묶음(킬·라운드)과 유저 필터 규칙 맞춤, hello 에 서버 ID Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
227 lines
5.8 KiB
TypeScript
227 lines
5.8 KiB
TypeScript
// 앱 코어 · 사이트 서버 · 사이트 프런트엔드가 같이 쓰는 타입. docs/dev/ARCHITECTURE.md 4~6장.
|
|
|
|
export type GameType = 'valorant' | 'lol';
|
|
|
|
export interface TimeLabel {
|
|
/** 발로란트 "R7 · 0:42" / 롤 "21:14" / 경기 밖 "21:08:44" */
|
|
primary: string;
|
|
/** 발로란트 경기 경과 시간 "12:18" */
|
|
secondary?: string;
|
|
/** 현실 시각 (unix ms) */
|
|
real: number;
|
|
}
|
|
|
|
export interface Word {
|
|
w: string;
|
|
/** 발화 시작 기준 초 */
|
|
s: number;
|
|
e: number;
|
|
p?: number;
|
|
}
|
|
|
|
export interface User {
|
|
id: string;
|
|
name: string;
|
|
color: string;
|
|
avatar: string | null;
|
|
excluded: boolean;
|
|
riot: { puuid: string; riotId: string }[];
|
|
}
|
|
|
|
export type UtteranceStatus = 'pending' | 'realtime' | 'precise' | 'failed';
|
|
|
|
export interface UtteranceItem {
|
|
kind: 'utterance';
|
|
id: string;
|
|
ts: number;
|
|
endTs: number;
|
|
userId: string;
|
|
text: string | null;
|
|
words: Word[];
|
|
noise: boolean;
|
|
status: UtteranceStatus;
|
|
corrected: boolean;
|
|
confidence: number | null;
|
|
model: string | null;
|
|
audio: { url: string; durationMs: number; gainDb: number } | null;
|
|
game: { type: GameType; matchId: string; round?: number } | null;
|
|
time: TimeLabel;
|
|
}
|
|
|
|
export type EventType =
|
|
| 'kill'
|
|
| 'chat'
|
|
| 'object'
|
|
| 'spike'
|
|
| 'round_end'
|
|
| 'match_start'
|
|
| 'match_end'
|
|
| 'multikill'
|
|
| 'ace';
|
|
|
|
export interface PlayerRef {
|
|
puuid?: string;
|
|
name: string;
|
|
team?: string;
|
|
/** 발로란트 요원 / 롤 챔피언 */
|
|
character?: { id: string; name: string; icon: string | null };
|
|
userId?: string;
|
|
}
|
|
|
|
export interface KillData {
|
|
killer: PlayerRef | null;
|
|
victim: PlayerRef;
|
|
assists: PlayerRef[];
|
|
weapon: { id: string; name: string; icon: string | null } | null;
|
|
headshot?: boolean;
|
|
location?: { x: number; y: number } | null;
|
|
ally?: boolean;
|
|
}
|
|
export interface ChatData {
|
|
sender: PlayerRef;
|
|
channel: 'team' | 'all' | 'party' | 'system';
|
|
text: string;
|
|
source: 'api' | 'ocr' | 'lcu' | 'log';
|
|
}
|
|
export interface ObjectData {
|
|
object: 'dragon' | 'baron' | 'herald' | 'grub' | 'tower' | 'inhibitor' | 'atakhan';
|
|
subtype?: string;
|
|
team?: string;
|
|
killer?: PlayerRef | null;
|
|
ally?: boolean;
|
|
}
|
|
export interface RoundEndData {
|
|
round: number;
|
|
win: boolean;
|
|
result: string;
|
|
score: { ally: number; enemy: number };
|
|
}
|
|
|
|
export interface EventItem {
|
|
kind: 'event';
|
|
id: string;
|
|
ts: number;
|
|
game: GameType;
|
|
matchId: string;
|
|
type: EventType;
|
|
data: any;
|
|
time: TimeLabel;
|
|
userId?: string;
|
|
}
|
|
|
|
export type TimelineItem = UtteranceItem | EventItem;
|
|
|
|
export interface TimelinePage {
|
|
items: TimelineItem[];
|
|
next: string | null;
|
|
}
|
|
|
|
export interface MatchSummary {
|
|
id: string;
|
|
game: GameType;
|
|
startedAt: number;
|
|
endedAt: number | null;
|
|
map: { id: string; name: string; image: string | null };
|
|
mode: string;
|
|
win: boolean | null;
|
|
score: { ally: number; enemy: number } | null;
|
|
status: 'live' | 'pending_detail' | 'complete';
|
|
participants: string[];
|
|
}
|
|
|
|
export interface MatchPlayer {
|
|
puuid: string;
|
|
name: string;
|
|
tag?: string;
|
|
team: string;
|
|
ally: boolean;
|
|
character: { id: string; name: string; icon: string | null };
|
|
kills: number;
|
|
deaths: number;
|
|
assists: number;
|
|
score?: number;
|
|
cs?: number;
|
|
gold?: number;
|
|
level?: number;
|
|
items?: { id: number; name: string; icon: string | null }[];
|
|
rank?: string | null;
|
|
userId?: string;
|
|
}
|
|
|
|
export interface MatchRound {
|
|
num: number;
|
|
startedAt: number;
|
|
endedAt: number;
|
|
win: boolean;
|
|
result: string;
|
|
score: { ally: number; enemy: number };
|
|
economy?: Record<string, { spent: number; remaining: number; weapon?: string }>;
|
|
}
|
|
|
|
export interface MatchDetail extends MatchSummary {
|
|
players: MatchPlayer[];
|
|
rounds?: MatchRound[];
|
|
goldDiff?: { t: number; diff: number }[];
|
|
events: EventItem[];
|
|
utterances: UtteranceItem[];
|
|
mapTransform:
|
|
| { valorant: { xMultiplier: number; yMultiplier: number; xScalarToAdd: number; yScalarToAdd: number } }
|
|
| { lol: { minX: number; minY: number; maxX: number; maxY: number } }
|
|
| null;
|
|
}
|
|
|
|
export interface Overview {
|
|
guild: { id: string; name: string; icon: string | null } | null;
|
|
recording: { active: boolean; channel: string | null; since: number | null; participants: string[] };
|
|
users: User[];
|
|
games: { valorant: { connected: boolean; inMatch: boolean }; lol: { connected: boolean; inMatch: boolean } };
|
|
counts: { utterances: number; matches: number };
|
|
version: string;
|
|
}
|
|
|
|
export interface UserProfile {
|
|
user: User;
|
|
stats: { talkMs: number; count: number; topWords: { w: string; n: number }[] };
|
|
matches: MatchSummary[];
|
|
}
|
|
|
|
export type LiveEvent =
|
|
| { type: 'utterance.created' | 'utterance.updated'; data: UtteranceItem }
|
|
| { type: 'event.created'; data: EventItem }
|
|
| { type: 'match.updated'; data: MatchSummary }
|
|
| { type: 'recording.state'; data: Overview['recording'] }
|
|
| { type: 'users.updated'; data: User[] };
|
|
|
|
export interface DeviceStatus {
|
|
registered: boolean;
|
|
online: boolean;
|
|
name: string | null;
|
|
lastSeen: number | null;
|
|
version: string | null;
|
|
}
|
|
|
|
export type BrowserMessage = { type: 'status'; data: { device: DeviceStatus } } | LiveEvent;
|
|
|
|
// 사이트 서버 ↔ 앱 WebSocket
|
|
export type RelayToDevice =
|
|
| {
|
|
t: 'req';
|
|
id: string;
|
|
method: string;
|
|
path: string;
|
|
headers: Record<string, string>;
|
|
user: { id: string; name: string; avatar: string | null } | null;
|
|
body: string | null;
|
|
}
|
|
| { t: 'cancel'; id: string }
|
|
| { t: 'pong'; ts: number }
|
|
| { t: 'welcome'; deviceId: string };
|
|
|
|
export type RelayFromDevice =
|
|
| { t: 'hello'; name: string; version: string; guildId?: string | null }
|
|
| { t: 'ping'; ts: number }
|
|
| { t: 'res'; id: string; status: number; headers: Record<string, string>; body: string | null }
|
|
| { t: 'res_head'; id: string; status: number; headers: Record<string, string> }
|
|
| { t: 'res_end'; id: string }
|
|
| { t: 'event'; event: LiveEvent };
|