Compare commits
87
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
de8bc87940 | ||
|
|
25f3ccad57 | ||
|
|
55ab5b27dc | ||
|
|
1c0af891fa | ||
|
|
528744ebf6 | ||
|
|
bd52160d91 | ||
|
|
c3a3eb46dd | ||
|
|
be5383a2e9 | ||
|
|
ef693fcf4a | ||
|
|
8a9dd37755 | ||
|
|
5ad0f8a1c2 | ||
|
|
c4f19d256d | ||
|
|
ad84bf1f89 | ||
|
|
b711c63dcd | ||
|
|
6a192276e8 | ||
|
|
994a9fcad0 | ||
|
|
2dae3c7cae | ||
|
|
a896342429 | ||
|
|
7b636ee793 | ||
|
|
e63fba0286 | ||
|
|
245a096606 | ||
|
|
6e0afe84cd | ||
|
|
6accb4b166 | ||
|
|
f3d05004ce | ||
|
|
eadae789c8 | ||
|
|
d0d578b2b0 | ||
|
|
4ab3c3a135 | ||
|
|
251eb6deb9 | ||
|
|
b7886589cb | ||
|
|
33abda997f | ||
|
|
85ba8044da | ||
|
|
e306d696a9 | ||
|
|
da5f542292 | ||
|
|
f62e0db849 | ||
|
|
3176db8c48 | ||
|
|
7620b1677a | ||
|
|
1d7fdc9622 | ||
|
|
9c05850cba | ||
|
|
b5aa58dde8 | ||
|
|
3b2ac601a0 | ||
|
|
404f7713b9 | ||
|
|
ba3894cba2 | ||
|
|
9ebdc9b61f | ||
|
|
5fda22c36a | ||
|
|
1e304f48e5 | ||
|
|
ad3c37c48c | ||
|
|
f266d1de83 | ||
|
|
956e45ee59 | ||
|
|
b3b59d37fc | ||
|
|
fc81beec45 | ||
|
|
3447162aa5 | ||
|
|
06c190a41f | ||
|
|
862d662a51 | ||
|
|
95c8ed3c8b | ||
|
|
6bad4861e6 | ||
|
|
422472a641 | ||
|
|
7e78b1f92d | ||
|
|
4bc2df7bcc | ||
|
|
c212505ffe | ||
|
|
9ac777b5a4 | ||
|
|
c07b040467 | ||
|
|
78a8f136d0 | ||
|
|
3c8dce1e9b | ||
|
|
b12f44424e | ||
|
|
b4be06ae83 | ||
|
|
041b1fc8b9 | ||
|
|
87447a4f09 | ||
|
|
6cd213a462 | ||
|
|
caf517123b | ||
|
|
d4b790fd86 | ||
|
|
3a86676a12 | ||
|
|
9fbb11c634 | ||
|
|
39f3221640 | ||
|
|
a796620b7f | ||
|
|
3a3e7938f5 | ||
|
|
9f6974c577 | ||
|
|
d6f52a8b15 | ||
|
|
463c839782 | ||
|
|
5361dc8adb | ||
|
|
54db90b0df | ||
|
|
2e311d9cbf | ||
|
|
f24674b12c | ||
|
|
714349d519 | ||
|
|
7cde555bef | ||
|
|
a7820444fc | ||
|
|
fa13bc48d4 | ||
|
|
6f891c36af |
No files matched your search
+11
-2
@@ -1,5 +1,5 @@
|
||||
bin/
|
||||
lib/
|
||||
/lib/
|
||||
dist/
|
||||
node_modules/
|
||||
.pnpm-store/
|
||||
@@ -23,4 +23,13 @@ website/LICENSE
|
||||
|
||||
*.temp.MD
|
||||
|
||||
*.md
|
||||
*.md
|
||||
!README.md
|
||||
!AGENTS.md
|
||||
!agents/**/*.md
|
||||
!skills/**/*.md
|
||||
/tmp/
|
||||
/user-game-history/
|
||||
/*.txt
|
||||
/*.png
|
||||
|
||||
BIN
Binary file not shown.
|
Before Width: | Height: | Size: 383 KiB |
@@ -0,0 +1,189 @@
|
||||
# AGENTS.md
|
||||
|
||||
This file provides guidance to AI coding agents (Claude Code, Cursor, Copilot, Antigravity, etc.) when working with code in this repository.
|
||||
|
||||
## Repository Overview
|
||||
|
||||
A collection of skills for Claude.ai and Claude Code for senior software engineers. Skills are packaged instructions and scripts that extend Claude and your coding agents capabilities.
|
||||
|
||||
## OpenCode Integration
|
||||
|
||||
OpenCode uses a **skill-driven execution model** powered by the `skill` tool and this repository's `/skills` directory.
|
||||
|
||||
### Core Rules
|
||||
|
||||
- If a task matches a skill, you MUST invoke it
|
||||
- Skills are located in `skills/<skill-name>/SKILL.md`
|
||||
- Never implement directly if a skill applies
|
||||
- Always follow the skill instructions exactly (do not partially apply them)
|
||||
|
||||
### Intent → Skill Mapping
|
||||
|
||||
The agent should automatically map user intent to skills:
|
||||
|
||||
- Feature / new functionality → `spec-driven-development`, then `incremental-implementation`, `test-driven-development`
|
||||
- Planning / breakdown → `planning-and-task-breakdown`
|
||||
- Bug / failure / unexpected behavior → `debugging-and-error-recovery`
|
||||
- Code review → `code-review-and-quality`
|
||||
- Refactoring / simplification → `code-simplification`
|
||||
- API or interface design → `api-and-interface-design`
|
||||
- UI work → `frontend-ui-engineering`
|
||||
|
||||
### Lifecycle Mapping (Implicit Commands)
|
||||
|
||||
OpenCode does not support slash commands like `/spec` or `/plan`.
|
||||
|
||||
Instead, the agent must internally follow this lifecycle:
|
||||
|
||||
- DEFINE → `spec-driven-development`
|
||||
- PLAN → `planning-and-task-breakdown`
|
||||
- BUILD → `incremental-implementation` + `test-driven-development`
|
||||
- VERIFY → `debugging-and-error-recovery`
|
||||
- REVIEW → `code-review-and-quality`
|
||||
- SHIP → `shipping-and-launch`
|
||||
|
||||
### Execution Model
|
||||
|
||||
For every request:
|
||||
|
||||
1. Determine if any skill applies (even 1% chance)
|
||||
2. Invoke the appropriate skill using the `skill` tool
|
||||
3. Follow the skill workflow strictly
|
||||
4. Only proceed to implementation after required steps (spec, plan, etc.) are complete
|
||||
|
||||
### Anti-Rationalization
|
||||
|
||||
The following thoughts are incorrect and must be ignored:
|
||||
|
||||
- "This is too small for a skill"
|
||||
- "I can just quickly implement this"
|
||||
- "I’ll gather context first"
|
||||
|
||||
Correct behavior:
|
||||
|
||||
- Always check for and use skills first
|
||||
|
||||
This ensures OpenCode behaves similarly to Claude Code with full workflow enforcement.
|
||||
|
||||
## Orchestration: Personas, Skills, and Commands
|
||||
|
||||
This repo has three composable layers. They have different jobs and should not be confused:
|
||||
|
||||
- **Skills** (`skills/<name>/SKILL.md`) — workflows with steps and exit criteria. The *how*. Mandatory hops when an intent matches.
|
||||
- **Personas** (`agents/<role>.md`) — roles with a perspective and an output format. The *who*.
|
||||
- **Slash commands** (`.claude/commands/*.md`) — user-facing entry points. The *when*. The orchestration layer.
|
||||
|
||||
Composition rule: **the user (or a slash command) is the orchestrator. Personas do not invoke other personas.** A persona may invoke skills.
|
||||
|
||||
The only multi-persona orchestration pattern this repo endorses is **parallel fan-out with a merge step** — used by `/ship` to run `code-reviewer`, `security-auditor`, and `test-engineer` concurrently and synthesize their reports. Do not build a "router" persona that decides which other persona to call; that's the job of slash commands and intent mapping.
|
||||
|
||||
See [agents/README.md](agents/README.md) for the decision matrix and [references/orchestration-patterns.md](references/orchestration-patterns.md) for the full pattern catalog.
|
||||
|
||||
**Claude Code interop:** the personas in `agents/` work as Claude Code subagents (auto-discovered from this plugin's `agents/` directory) and as Agent Teams teammates (referenced by name when spawning). Two platform constraints align with our rules: subagents cannot spawn other subagents, and teams cannot nest. Plugin agents silently ignore the `hooks`, `mcpServers`, and `permissionMode` frontmatter fields.
|
||||
|
||||
## Creating a New Skill
|
||||
|
||||
### Directory Structure
|
||||
|
||||
```
|
||||
skills/
|
||||
{skill-name}/ # kebab-case directory name
|
||||
SKILL.md # Required: skill definition
|
||||
scripts/ # Required: executable scripts
|
||||
{script-name}.sh # Bash scripts (preferred)
|
||||
{skill-name}.zip # Required: packaged for distribution
|
||||
```
|
||||
|
||||
### Naming Conventions
|
||||
|
||||
- **Skill directory**: `kebab-case` (e.g. `web-quality`)
|
||||
- **SKILL.md**: Always uppercase, always this exact filename
|
||||
- **Scripts**: `kebab-case.sh` (e.g., `deploy.sh`, `fetch-logs.sh`)
|
||||
- **Zip file**: Must match directory name exactly: `{skill-name}.zip`
|
||||
|
||||
### SKILL.md Format
|
||||
|
||||
```markdown
|
||||
---
|
||||
name: {skill-name}
|
||||
description: {One sentence describing what the skill does, followed by one or more "Use when" trigger conditions. Include trigger phrases like "Deploy my app" or "Check logs" when helpful.}
|
||||
---
|
||||
|
||||
# {Skill Title}
|
||||
|
||||
{Brief overview of what the skill does and why it matters.}
|
||||
|
||||
## How It Works
|
||||
|
||||
{Numbered list explaining the skill's workflow}
|
||||
|
||||
Equivalent headings like `Workflow`, `Core Process`, or `When to Use` are fine when they communicate the same structure clearly.
|
||||
|
||||
## Usage (Optional)
|
||||
|
||||
Include this section only if the skill ships runnable helpers under `scripts/`. Markdown-only skills can omit both the section and the directory entirely.
|
||||
|
||||
```bash
|
||||
bash /mnt/skills/user/{skill-name}/scripts/{script}.sh [args]
|
||||
```
|
||||
|
||||
**Arguments:**
|
||||
- `arg1` - Description (defaults to X)
|
||||
|
||||
**Examples:**
|
||||
{Show 2-3 common usage patterns}
|
||||
|
||||
## Output
|
||||
|
||||
{Show example output users will see}
|
||||
|
||||
## Present Results to User
|
||||
|
||||
{Template for how Claude should format results when presenting to users}
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
{Common issues and solutions, especially network/permissions errors}
|
||||
```
|
||||
|
||||
### Best Practices for Context Efficiency
|
||||
|
||||
Skills are loaded on-demand — only the skill name and description are loaded at startup. The full `SKILL.md` loads into context only when the agent decides the skill is relevant. To minimize context usage:
|
||||
|
||||
- **Keep SKILL.md under 500 lines** — put detailed reference material in separate files
|
||||
- **Write specific descriptions** — helps the agent know exactly when to activate the skill
|
||||
- **Use progressive disclosure** — reference supporting files that get read only when needed
|
||||
- **Prefer scripts over inline code** — script execution doesn't consume context (only output does)
|
||||
- **File references work one level deep** — link directly from SKILL.md to supporting files
|
||||
|
||||
### Script Requirements
|
||||
|
||||
- Use `#!/bin/bash` shebang
|
||||
- Use `set -e` for fail-fast behavior
|
||||
- Write status messages to stderr: `echo "Message" >&2`
|
||||
- Write machine-readable output (JSON) to stdout
|
||||
- Include a cleanup trap for temp files
|
||||
- Reference the script path as `/mnt/skills/user/{skill-name}/scripts/{script}.sh`
|
||||
|
||||
### Creating the Zip Package
|
||||
|
||||
After creating or updating a skill:
|
||||
|
||||
```bash
|
||||
cd skills
|
||||
zip -r {skill-name}.zip {skill-name}/
|
||||
```
|
||||
|
||||
### End-User Installation
|
||||
|
||||
Document these two installation methods for users:
|
||||
|
||||
**Claude Code:**
|
||||
```bash
|
||||
cp -r skills/{skill-name} ~/.claude/skills/
|
||||
```
|
||||
|
||||
**claude.ai:**
|
||||
Add the skill to project knowledge or paste SKILL.md contents into the conversation.
|
||||
|
||||
If the skill requires network access, instruct users to add required domains at `claude.ai/settings/capabilities`.
|
||||
@@ -0,0 +1 @@
|
||||
68
|
||||
@@ -1,43 +0,0 @@
|
||||
# Cloudflare Pages 배포
|
||||
|
||||
## 최초 1회 준비
|
||||
|
||||
```bash
|
||||
pnpm --filter web pages:login
|
||||
pnpm --filter web exec wrangler pages project create lolympus --production-branch main
|
||||
```
|
||||
|
||||
프로젝트명을 바꾸려면 배포 시 `CF_PAGES_PROJECT_NAME` 환경변수로 지정한다.
|
||||
|
||||
## 환경 파일
|
||||
|
||||
Vite는 빌드 시점에 환경변수를 번들에 포함한다.
|
||||
|
||||
```bash
|
||||
cp apps/web/.env.test.example apps/web/.env.test
|
||||
cp apps/web/.env.production.example apps/web/.env.production
|
||||
```
|
||||
|
||||
각 파일에서 API URL, community ID, MSAL 설정을 실제 값으로 채운다.
|
||||
|
||||
## 배포
|
||||
|
||||
```bash
|
||||
pnpm deploy:web:test
|
||||
pnpm deploy:web:prod
|
||||
```
|
||||
|
||||
- `test`: `vite build --mode test` 후 Cloudflare Pages `test` preview branch로 배포
|
||||
- `prod`: `vite build --mode production` 후 Cloudflare Pages production으로 배포
|
||||
|
||||
기본 Cloudflare Pages project name은 `lolympus`다.
|
||||
|
||||
```bash
|
||||
CF_PAGES_PROJECT_NAME=lolympus-web pnpm deploy:web:prod
|
||||
CF_PAGES_TEST_BRANCH=staging pnpm deploy:web:test
|
||||
```
|
||||
|
||||
## SPA / 캐시
|
||||
|
||||
- `apps/web/public/_redirects`: React Router 경로 새로고침을 `/index.html`로 fallback
|
||||
- `apps/web/public/_headers`: fingerprinted `/assets/*`는 1년 immutable 캐시, `index.html`은 no-cache
|
||||
@@ -1,481 +0,0 @@
|
||||
# Dakao NATS Command API
|
||||
|
||||
dakao는 NATS를 통해 외부 시스템으로부터 command를 받아 LOCO 세션에 반영할 수 있다.
|
||||
현재 구현 기준으로 지원하는 command는 아래 2종이다.
|
||||
|
||||
- `chat.send-text`
|
||||
기존 API. `text`와 `extra`를 그대로 받아 전송한다.
|
||||
점진적으로 deprecated 예정.
|
||||
- `chat.send-message`
|
||||
신규 권장 API. `segments` 기반으로 텍스트, 멘션, 카카오톡 이모티콘을 조합해서 전송한다.
|
||||
builder를 거치면서 semantic validation까지 수행한다.
|
||||
|
||||
## 개요
|
||||
|
||||
### 기본 subject
|
||||
|
||||
| 용도 | 기본 subject | 비고 |
|
||||
| ------------------ | ------------------------------------ | --------------- |
|
||||
| 레거시 텍스트 전송 | `dakao.command.chat.send-text.v1` | deprecated 예정 |
|
||||
| 신규 메시지 전송 | `dakao.command.chat.send-message.v1` | 권장 |
|
||||
|
||||
### 관련 환경변수
|
||||
|
||||
| 키 | 의미 |
|
||||
| ---------------------------------------------- | ------------------------------- |
|
||||
| `DAKAO_NATS_COMMANDS_ENABLED` | `1`이면 command consumer 활성화 |
|
||||
| `DAKAO_NATS_COMMAND_CHAT_SEND_TEXT_SUBJECT` | 레거시 subject override |
|
||||
| `DAKAO_NATS_COMMAND_CHAT_SEND_MESSAGE_SUBJECT` | 신규 subject override |
|
||||
|
||||
### 전송 포맷
|
||||
|
||||
- NATS payload는 JSON object여야 한다.
|
||||
- 내부 구현은 `JSON.stringify(...)`로 publish하고, subscribe 시 `JSON.parse(...)`로 역직렬화한다.
|
||||
- 응답은 NATS의 transport-level reply가 아니라, command object 내부의 `replySubject` 필드를 사용해 별도 publish된다.
|
||||
|
||||
### subject와 `type`의 관계
|
||||
|
||||
운영 규약상 아래처럼 맞춰서 보내는 것을 권장한다.
|
||||
|
||||
- `dakao.command.chat.send-text.v1` 에는 `type: "chat.send-text"`
|
||||
- `dakao.command.chat.send-message.v1` 에는 `type: "chat.send-message"`
|
||||
|
||||
현재 구현은 두 subject를 모두 구독한 뒤 `type`으로 실제 처리를 분기한다.
|
||||
즉 subject와 type이 어긋나도 처리될 수 있지만, 운영 혼선을 막기 위해 반드시 맞춰서 보내는 것을 권장한다.
|
||||
|
||||
## 공통 Envelope
|
||||
|
||||
모든 command는 아래 envelope를 사용한다.
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "dakao.command.v1",
|
||||
"id": "cmd-001",
|
||||
"type": "chat.send-message",
|
||||
"source": "my-service",
|
||||
"correlationId": "trace-001",
|
||||
"replySubject": "dakao.result.my-service",
|
||||
"payload": {}
|
||||
}
|
||||
```
|
||||
|
||||
### 공통 필드
|
||||
|
||||
| 필드 | 타입 | 필수 | 설명 |
|
||||
| --------------- | ------ | ---- | -------------------------------- |
|
||||
| `schema` | string | Y | 현재는 반드시 `dakao.command.v1` |
|
||||
| `id` | string | Y | command 고유 ID |
|
||||
| `type` | string | Y | command 종류 |
|
||||
| `source` | string | Y | producer 식별자 |
|
||||
| `correlationId` | string | N | 추적용 상관관계 ID |
|
||||
| `replySubject` | string | N | 결과를 publish할 subject |
|
||||
| `payload` | object | Y | command 본문 |
|
||||
|
||||
### 공통 검증
|
||||
|
||||
- 문자열 필드인 `id`, `type`, `source`, `correlationId`, `replySubject`는 trim 후 빈 문자열이면 거부된다.
|
||||
- 최상위 object와 payload는 정의되지 않은 필드를 허용하지 않는다.
|
||||
- `replySubject`가 없으면 처리 결과는 publish되지 않는다.
|
||||
|
||||
## Command: `chat.send-text`
|
||||
|
||||
### 상태
|
||||
|
||||
- 레거시 API
|
||||
- 기존 producer 호환성을 위해 유지 중
|
||||
- `text`와 `extra`를 그대로 전달하므로, 멘션/이모티콘 semantic validation은 수행하지 않는다
|
||||
|
||||
### 권장 subject
|
||||
|
||||
```text
|
||||
dakao.command.chat.send-text.v1
|
||||
```
|
||||
|
||||
### Payload
|
||||
|
||||
```json
|
||||
{
|
||||
"chatroomId": "123456789012345678",
|
||||
"text": "hello",
|
||||
"attachment": {
|
||||
"example": true
|
||||
},
|
||||
"extra": "{}"
|
||||
}
|
||||
```
|
||||
|
||||
| 필드 | 타입 | 필수 | 설명 |
|
||||
| ------------ | ---------------- | ---- | ------------------------------------------------------- |
|
||||
| `chatroomId` | string | Y | 채팅방 ID. 실운영에서는 decimal string 사용 권장 |
|
||||
| `text` | string | Y | 보낼 메시지 본문 |
|
||||
| `attachment` | string or object | N | 첨부 payload. object면 전송 직전에 JSON string으로 변환 |
|
||||
| `extra` | string | N | LOCO `WRITE.extra` raw 값 |
|
||||
|
||||
### 동작
|
||||
|
||||
- 내부적으로 `client.sendMessage(chatroomId, text, { attachment, extra })` 로 전송한다.
|
||||
- `extra`를 생략하면 최종 LOCO 전송 시 기본값 `"{}"` 가 사용된다.
|
||||
- 이 API는 `extra` 구조를 검증하지 않는다.
|
||||
|
||||
### 예시
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "dakao.command.v1",
|
||||
"id": "cmd-text-001",
|
||||
"type": "chat.send-text",
|
||||
"source": "admin-panel",
|
||||
"replySubject": "dakao.result.admin-panel",
|
||||
"payload": {
|
||||
"chatroomId": "123456789012345678",
|
||||
"text": "plain text message",
|
||||
"extra": "{}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Command: `chat.send-message`
|
||||
|
||||
### 상태
|
||||
|
||||
- 신규 권장 API
|
||||
- 텍스트, 멘션, 카카오톡 이모티콘을 조합해서 전송할 수 있다
|
||||
- `buildLocoMessage(...)` 를 통해 최종 `text`와 `extra`를 생성한다
|
||||
- Joi schema validation 이후 builder semantic validation이 한 번 더 수행된다
|
||||
|
||||
### 권장 subject
|
||||
|
||||
```text
|
||||
dakao.command.chat.send-message.v1
|
||||
```
|
||||
|
||||
### Payload
|
||||
|
||||
```json
|
||||
{
|
||||
"chatroomId": "123456789012345678",
|
||||
"segments": [
|
||||
{ "kind": "text", "text": "안녕하세요 " },
|
||||
{
|
||||
"kind": "mention",
|
||||
"userId": "6215844374579825921",
|
||||
"displayText": "날으는꼴뚜기/95/여/D"
|
||||
},
|
||||
{ "kind": "text", "text": " " },
|
||||
{ "kind": "emoticon", "id": "1200281_004", "altText": "플라워" }
|
||||
],
|
||||
"attachment": {
|
||||
"example": true
|
||||
},
|
||||
"type": 1,
|
||||
"noSeen": false,
|
||||
"scope": 1,
|
||||
"silence": false
|
||||
}
|
||||
```
|
||||
|
||||
| 필드 | 타입 | 필수 | 설명 |
|
||||
| ------------ | ---------------- | ---- | ------------------------------------------------------- |
|
||||
| `chatroomId` | string | Y | 채팅방 ID. 실운영에서는 decimal string 사용 권장 |
|
||||
| `segments` | array | Y | 메시지 세그먼트 배열. 최소 1개 이상 |
|
||||
| `attachment` | string or object | N | 첨부 payload. object면 전송 직전에 JSON string으로 변환 |
|
||||
| `type` | integer | N | LOCO `WRITE.type`. 기본값 `1` |
|
||||
| `noSeen` | boolean | N | LOCO `WRITE.noSeen`. 기본값 `false` |
|
||||
| `scope` | integer | N | LOCO `WRITE.scope`. 기본값 `1` |
|
||||
| `silence` | boolean | N | LOCO `WRITE.silence`. 기본값 `false` |
|
||||
|
||||
### Segment 종류
|
||||
|
||||
#### `text`
|
||||
|
||||
```json
|
||||
{ "kind": "text", "text": "안녕하세요 " }
|
||||
```
|
||||
|
||||
| 필드 | 타입 | 필수 | 설명 |
|
||||
| ------ | ------ | ---- | -------------------------------------- |
|
||||
| `kind` | string | Y | 반드시 `text` |
|
||||
| `text` | string | Y | 일반 텍스트. 빈 문자열은 허용되지 않음 |
|
||||
|
||||
#### `mention`
|
||||
|
||||
```json
|
||||
{
|
||||
"kind": "mention",
|
||||
"userId": "6215844374579825921",
|
||||
"displayText": "날으는꼴뚜기/95/여/D"
|
||||
}
|
||||
```
|
||||
|
||||
| 필드 | 타입 | 필수 | 설명 |
|
||||
| ------------- | ------ | ---- | --------------------------------------------------------- |
|
||||
| `kind` | string | Y | 반드시 `mention` |
|
||||
| `userId` | string | Y | 양의 정수 문자열 권장. int64 손실 방지를 위해 문자열 사용 |
|
||||
| `displayText` | string | Y | 화면에 표시될 이름. builder가 앞의 `@`를 자동 정리 |
|
||||
|
||||
멘션은 최종 메시지에서 아래처럼 렌더링된다.
|
||||
|
||||
```text
|
||||
@{displayText}
|
||||
```
|
||||
|
||||
예를 들어 `displayText: "홍길동"` 이면 `@홍길동` 으로 전송된다.
|
||||
`displayText`를 `@홍길동`처럼 보내도 builder가 앞의 `@` 하나를 제거한 뒤 다시 렌더링한다.
|
||||
|
||||
#### `emoticon`
|
||||
|
||||
```json
|
||||
{
|
||||
"kind": "emoticon",
|
||||
"id": "1200281_004",
|
||||
"altText": "플라워"
|
||||
}
|
||||
```
|
||||
|
||||
| 필드 | 타입 | 필수 | 설명 |
|
||||
| --------- | ------ | ---- | --------------------------------------- |
|
||||
| `kind` | string | Y | 반드시 `emoticon` |
|
||||
| `id` | string | Y | 카카오톡 이모티콘 item ID |
|
||||
| `altText` | string | Y | 대체 텍스트. builder가 괄호를 자동 정리 |
|
||||
|
||||
이모티콘은 최종 메시지에서 아래처럼 렌더링된다.
|
||||
|
||||
```text
|
||||
({altText})
|
||||
```
|
||||
|
||||
예를 들어 `altText: "플라워"` 이면 `(플라워)` 로 전송된다.
|
||||
`altText`를 `(플라워)`처럼 보내도 builder가 바깥 괄호를 제거한 뒤 다시 렌더링한다.
|
||||
|
||||
### Builder semantic validation
|
||||
|
||||
`chat.send-message`는 schema validation 외에 아래 규칙도 검사한다.
|
||||
|
||||
#### 공통
|
||||
|
||||
- 최종적으로 만들어진 메시지 전체 텍스트는 비어 있으면 안 된다
|
||||
- `segments`가 모두 비어 있거나 렌더링 결과가 빈 문자열이면 거부된다
|
||||
|
||||
#### mention 규칙
|
||||
|
||||
- `userId`는 양의 정수여야 한다
|
||||
- producer에서는 숫자 대신 문자열 사용을 권장한다
|
||||
- `displayText`는 비어 있으면 안 된다
|
||||
- 같은 `userId`를 여러 번 멘션하면 `extra.mentions[].at` 배열로 합쳐진다
|
||||
- 같은 `userId`를 서로 다른 길이의 `displayText`로 섞어 보내면 거부된다
|
||||
|
||||
#### emoticon 규칙
|
||||
|
||||
- `id`는 trim 후 비어 있으면 안 된다
|
||||
- `altText`는 trim 후 비어 있으면 안 된다
|
||||
- `altText` 내부에는 `@`, `(`, `)` 문자가 들어가면 안 된다
|
||||
- 같은 `(id, 렌더링 길이)` 조합의 이모티콘은 `extra.emojis.items[].at` 배열로 합쳐진다
|
||||
|
||||
#### `extra` 생성 규칙
|
||||
|
||||
producer가 `extra`를 직접 만들지 않는다.
|
||||
builder가 최종 텍스트를 기준으로 아래 구조를 자동 생성한다.
|
||||
|
||||
```json
|
||||
{
|
||||
"mentions": [
|
||||
{
|
||||
"user_id": 6215844374579825921,
|
||||
"at": [1],
|
||||
"len": 13
|
||||
}
|
||||
],
|
||||
"emojis": {
|
||||
"total_item": 1,
|
||||
"total_len": 5,
|
||||
"items": [
|
||||
{
|
||||
"id": "1200281_004",
|
||||
"len": 5,
|
||||
"at": [1]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
주의:
|
||||
|
||||
- `mentions[].at` 는 메시지 안의 `@` anchor 순번이다
|
||||
- `emojis.items[].at` 는 메시지 안의 `(` anchor 순번이다
|
||||
- `len` 은 렌더링된 문자열 길이 기준이다
|
||||
- `total_item` 은 이모티콘 총 출현 횟수다
|
||||
- `total_len` 은 각 이모티콘 렌더링 길이의 합이다
|
||||
|
||||
### 예시: 추천 전송
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "dakao.command.v1",
|
||||
"id": "cmd-msg-001",
|
||||
"type": "chat.send-message",
|
||||
"source": "admin-panel",
|
||||
"correlationId": "trace-20260417-001",
|
||||
"replySubject": "dakao.result.admin-panel",
|
||||
"payload": {
|
||||
"chatroomId": "123456789012345678",
|
||||
"segments": [
|
||||
{ "kind": "text", "text": "😄 " },
|
||||
{
|
||||
"kind": "mention",
|
||||
"userId": "6215844374579825921",
|
||||
"displayText": "날으는꼴뚜기/95/여/D"
|
||||
},
|
||||
{ "kind": "text", "text": " " },
|
||||
{ "kind": "emoticon", "id": "1200281_004", "altText": "플라워" },
|
||||
{ "kind": "emoticon", "id": "1200281_003", "altText": "네잎클로버" }
|
||||
],
|
||||
"type": 1,
|
||||
"noSeen": false,
|
||||
"scope": 1,
|
||||
"silence": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
위 payload는 내부적으로 대략 아래 LOCO 메시지로 변환된다.
|
||||
|
||||
```json
|
||||
{
|
||||
"text": "😄 @날으는꼴뚜기/95/여/D (플라워)(네잎클로버)",
|
||||
"extra": "{\"mentions\":[{\"user_id\":6215844374579825921,\"at\":[1],\"len\":13}],\"emojis\":{\"total_item\":2,\"total_len\":12,\"items\":[{\"id\":\"1200281_004\",\"len\":5,\"at\":[1]},{\"id\":\"1200281_003\",\"len\":7,\"at\":[2]}]}}"
|
||||
}
|
||||
```
|
||||
|
||||
## Result API
|
||||
|
||||
응답이 필요한 경우 producer는 command에 `replySubject`를 포함해야 한다.
|
||||
consumer는 처리 후 `replySubject`로 결과 object를 publish한다.
|
||||
|
||||
### 공통 Result envelope
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "dakao.result.v1",
|
||||
"id": "cmd-msg-001",
|
||||
"type": "chat.send-message",
|
||||
"status": "succeeded",
|
||||
"handledAt": "2026-04-17T12:34:56.789Z",
|
||||
"correlationId": "trace-20260417-001",
|
||||
"result": {}
|
||||
}
|
||||
```
|
||||
|
||||
### 공통 필드
|
||||
|
||||
| 필드 | 타입 | 설명 |
|
||||
| --------------- | ------ | --------------------------------------- |
|
||||
| `schema` | string | 현재는 반드시 `dakao.result.v1` |
|
||||
| `id` | string | 원본 command ID |
|
||||
| `type` | string | 원본 command type |
|
||||
| `status` | string | `succeeded` 또는 `failed` |
|
||||
| `handledAt` | string | ISO-8601 timestamp |
|
||||
| `correlationId` | string | 원본 correlationId가 있으면 그대로 전달 |
|
||||
| `result` | object | 성공 시 포함 |
|
||||
| `error` | object | 실패 시 포함 |
|
||||
|
||||
### Success result
|
||||
|
||||
`chat.send-text`와 `chat.send-message`의 성공 응답 구조는 동일하다.
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "dakao.result.v1",
|
||||
"id": "cmd-msg-001",
|
||||
"type": "chat.send-message",
|
||||
"status": "succeeded",
|
||||
"handledAt": "2026-04-17T12:34:56.789Z",
|
||||
"correlationId": "trace-20260417-001",
|
||||
"result": {
|
||||
"chatroomId": "123456789012345678",
|
||||
"messageLength": 31,
|
||||
"hasAttachment": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| 필드 | 타입 | 설명 |
|
||||
| --------------- | ------- | ---------------------------- |
|
||||
| `chatroomId` | string | 대상 채팅방 ID |
|
||||
| `messageLength` | number | 실제 전송된 최종 메시지 길이 |
|
||||
| `hasAttachment` | boolean | attachment가 있으면 포함 |
|
||||
|
||||
### Failure result
|
||||
|
||||
```json
|
||||
{
|
||||
"schema": "dakao.result.v1",
|
||||
"id": "cmd-msg-001",
|
||||
"type": "chat.send-message",
|
||||
"status": "failed",
|
||||
"handledAt": "2026-04-17T12:34:56.789Z",
|
||||
"correlationId": "trace-20260417-001",
|
||||
"error": {
|
||||
"code": "invalid_command",
|
||||
"message": "emoticon.altText must not contain '@', '(' or ')': \"(bad@text)\"",
|
||||
"retryable": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
| 필드 | 타입 | 설명 |
|
||||
| ----------- | ------- | ------------------------------- |
|
||||
| `code` | string | 오류 코드 |
|
||||
| `message` | string | 사람이 읽을 수 있는 오류 메시지 |
|
||||
| `retryable` | boolean | 재시도 권장 여부 |
|
||||
|
||||
### 현재 사용되는 오류 코드
|
||||
|
||||
| 코드 | retryable | 의미 |
|
||||
| -------------------------- | --------- | ----------------------------------------------- |
|
||||
| `invalid_command` | `false` | envelope/payload/schema/builder validation 실패 |
|
||||
| `command_execution_failed` | `true` | LOCO 전송 등 실행 단계 실패 |
|
||||
|
||||
## 응답 publish 조건
|
||||
|
||||
아래 조건이 모두 충족될 때만 실패 응답을 publish할 수 있다.
|
||||
|
||||
- `replySubject` 존재
|
||||
- `id` 존재
|
||||
- `type` 존재
|
||||
|
||||
따라서 malformed payload를 보내더라도 `replySubject`가 없으면 실패 응답은 발행되지 않는다.
|
||||
producer가 처리 결과를 반드시 받아야 한다면 `replySubject`를 항상 넣는 것을 권장한다.
|
||||
|
||||
## 운영 권장사항
|
||||
|
||||
### 새 producer는 `chat.send-message`만 사용
|
||||
|
||||
권장 이유:
|
||||
|
||||
- 멘션과 이모티콘을 구조적으로 표현할 수 있다
|
||||
- `extra`를 producer가 직접 조립하지 않아도 된다
|
||||
- semantic validation이 추가로 수행된다
|
||||
- 향후 레거시 `chat.send-text` 제거 시 마이그레이션 부담이 적다
|
||||
|
||||
### `chatroomId`와 `userId`는 문자열 사용
|
||||
|
||||
- `userId`는 int64 범위일 수 있으므로 JSON number 대신 string 사용을 권장한다
|
||||
- `chatroomId`도 실운영에서는 decimal string으로 통일하는 것이 안전하다
|
||||
|
||||
### `replySubject`는 항상 지정
|
||||
|
||||
- 성공/실패를 추적하려면 `replySubject`를 항상 넣는 것이 좋다
|
||||
- `correlationId`도 함께 넣어두면 producer 로그와 결과 로그를 쉽게 연결할 수 있다
|
||||
|
||||
### `send-text` 사용 시 주의
|
||||
|
||||
- `extra` 구조를 잘못 만들면 consumer 단계에서는 걸러지지 않는다
|
||||
- 멘션, 유니코드 이모지, 카카오톡 이모티콘 혼합 메시지는 `send-message` 사용을 권장한다
|
||||
|
||||
## 요약
|
||||
|
||||
- 레거시: `dakao.command.chat.send-text.v1` + `type: "chat.send-text"`
|
||||
- 권장: `dakao.command.chat.send-message.v1` + `type: "chat.send-message"`
|
||||
- 결과 스키마는 공통으로 `dakao.result.v1`
|
||||
- 신규 API는 `segments`를 받아 builder 기반으로 `text`와 `extra`를 안전하게 생성한다
|
||||
+1
-1
@@ -35,7 +35,7 @@ FROM gcr.io/distroless/nodejs24-debian13:nonroot AS runtime
|
||||
|
||||
WORKDIR /app
|
||||
|
||||
ENV NODE_ENV=prod
|
||||
# ENV NODE_ENV=prod
|
||||
|
||||
COPY --from=prod-deps --chown=nonroot:nonroot /app/package.json ./package.json
|
||||
COPY --from=prod-deps --chown=nonroot:nonroot /app/node_modules ./node_modules
|
||||
|
||||
@@ -1,433 +0,0 @@
|
||||
# Frontend ↔ Backend 통합 플랜 (Lolympus Tournament Support)
|
||||
|
||||
> **대상**: codex에 이어서 작업 가능한 수준의 실행 플랜
|
||||
> **레포**: `/Users/dahyeon/source/lolympus-tournament-support` (pnpm workspace)
|
||||
> **작성 기준**: 2026-04-24
|
||||
|
||||
---
|
||||
|
||||
## 1. Context
|
||||
|
||||
`apps/web`(React 19 + Vite + React Router 7)은 현재 `src/mock.ts`와 `src/auction-mock.ts`의 하드코딩된 더미 데이터로만 화면을 그립니다. 경매 페이지는 `setInterval` 기반 클라이언트 사이드 시뮬레이터(`createMockAuction()`)로 동작합니다.
|
||||
|
||||
`apps/api`(NestJS 11 + Mongoose 9)는 Community/User/Match/Auction 스키마와 CRUD 엔드포인트, RBAC 가드(`@Roles`), 글로벌 `ValidationPipe`, `X-Auth-User-Id` 헤더 기반 임시 인증까지 구축되어 있습니다. 하지만 **경매 실시간 푸시(WebSocket) 미구현, CORS 미설정, `MatchParticipant` 스냅샷에 티어 정보 없음, `/me` 같은 편의 엔드포인트 없음**이 통합의 걸림돌입니다.
|
||||
|
||||
### 이번 작업의 목표
|
||||
|
||||
1. 경매 페이지가 서버 주도 타이머·상태로 10명 관전 + 2명 입찰을 실시간 동기화하도록 **WebSocket 게이트웨이**를 API에 추가
|
||||
2. 프론트엔드의 모든 mock import를 제거하고 **API 클라이언트 + React Query + Socket.IO 클라이언트**로 교체
|
||||
3. 초기 MVP는 **단일 기본 커뮤니티** 전제 (env `VITE_DEFAULT_COMMUNITY_ID`)
|
||||
4. **로그인 UI는 이번 범위에서 제외**. admin 기능은 개발자용 "User ID 수동 입력" 위젯으로 임시 처리
|
||||
5. `MatchParticipant` 스냅샷에 `tier` 필드 추가 (참여 시점의 primary RiotAccount tier를 복사)
|
||||
|
||||
### 비목표 (이번 작업에 포함하지 않음)
|
||||
|
||||
- 카카오/디스코드 OAuth 로그인 플로우
|
||||
- 다중 커뮤니티 전환 UI
|
||||
- Riot API 실시간 동기화 UI (기존 `RiotAccountService`는 그대로 둠)
|
||||
- 매치 결과 기록 UI (`MatchResult`)
|
||||
- 포스트-경매 Riot 토너먼트 코드 발급
|
||||
|
||||
---
|
||||
|
||||
## 2. 현재 상태 정리 (실사 결과)
|
||||
|
||||
### 2.1 백엔드에 이미 있는 것
|
||||
|
||||
| 영역 | 파일 | 상태 |
|
||||
| ----------------------------------------------- | ------------------------------------------------ | ----------- |
|
||||
| Community CRUD + owner 트랜잭션 | `apps/api/src/modules/community/*` | ✅ |
|
||||
| Match CRUD + 참여(join) | `apps/api/src/modules/match/*` | ✅ |
|
||||
| Auction 시작/입찰/낙찰/다음/리셋 | `apps/api/src/modules/auction/*` | ✅ (HTTP만) |
|
||||
| 스키마 (Community/User/Match/Auction/RiotMatch) | `apps/api/src/modules/global/database/schema.ts` | ✅ |
|
||||
| `@Roles` + `RolesGuard` + `CurrentUser` | `apps/api/src/modules/auth/*` | ✅ |
|
||||
| 글로벌 `ValidationPipe` | `apps/api/src/main.ts` | ✅ |
|
||||
|
||||
### 2.2 백엔드에 없는 것 (이번에 추가)
|
||||
|
||||
1. **CORS** — Vite dev는 `http://localhost:5173`, API는 `http://localhost:3000`. `app.enableCors()` 필요
|
||||
2. **WebSocket (Socket.IO) 게이트웨이** — auction 상태 푸시 + 클라이언트 입찰 수신
|
||||
3. **서버 주도 타이머** — 현재 auction 문서에 `maxTimerSeconds`만 있음. 입찰 시 갱신되는 `currentDeadline: Date` 필드 + 만료 자동 `markSold` 스케줄러 필요
|
||||
4. **`MatchParticipant.tier`** — 참여 시 primary RiotAccount의 primary queue tier(solo 5x5)를 snapshot으로 복사
|
||||
5. **`GET /me`** — 현재 `X-Auth-User-Id` 헤더의 User 반환 (헤더 없으면 `null`). 프론트에서 admin 기능 가시성 판단용
|
||||
6. **`GET /communities/:communityId`** — 프론트 헤더에 커뮤니티 이름 표시용
|
||||
7. `mapId: number` → 프론트 라벨 매핑 유틸(프론트 쪽). 백엔드는 그대로
|
||||
|
||||
### 2.3 프론트엔드에 없는 것 (이번에 추가)
|
||||
|
||||
1. API 클라이언트 (`src/lib/api.ts`) — fetch 래퍼, `X-Auth-User-Id` 주입
|
||||
2. `@tanstack/react-query` + `QueryClientProvider`
|
||||
3. `socket.io-client` + `useAuctionSocket` 훅
|
||||
4. `src/config.ts` — `VITE_API_BASE_URL`, `VITE_DEFAULT_COMMUNITY_ID`, localStorage `X-Auth-User-Id` 관리
|
||||
5. 백엔드 스키마에 대응하는 **프론트 타입** (`src/api/types.ts`)
|
||||
6. 백엔드 `Match`/`Auction` → 프론트 `MatchDetail`/`AuctionState` **매핑 함수** (`src/api/mappers.ts`)
|
||||
7. 개발자용 "User ID 주입" 토글 UI (admin 기능 테스트용, 프로덕션 빌드에선 숨김)
|
||||
|
||||
### 2.4 데이터 모델 차이 요약
|
||||
|
||||
| 프론트 모델 | 백엔드 모델 | 매핑 전략 |
|
||||
| --------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------ |
|
||||
| `MatchDetail.date`/`time` (한국어 string) | `Match.scheduledAt: Date` | 프론트에서 `Intl.DateTimeFormat('ko-KR')`로 포맷 |
|
||||
| `MatchDetail.map: string` ("소환사의 협곡") | `Match.mapId: number` (11) | 프론트 `mapIdToLabel` 유틸 |
|
||||
| `Participant.tier: {previousSeason, current, peak}` | 추가 필요: `MatchParticipant.tier` 스냅샷 | 백엔드에 필드 추가 후 프론트가 그대로 읽음 (프론트 `TierInfo`는 백엔드 원본 형태로 리팩터) |
|
||||
| `Team.participants[].assignedPosition` | `MatchTeam.members[].assignedPosition` | 프론트가 `match.participants`와 `match.teams`를 조합해서 표시 |
|
||||
| `AuctionPlayer.tier` (단일) | `AuctionPlayerSnapshot.tiers: TierInfo[]` | 프론트에서 `queueType === 'RANKED_SOLO_5x5'` 필터 후 대표 선택 |
|
||||
| `AuctionPlayer.masteries[].championName` | `ChampionMasteryEntry.championName` (optional) | 프론트가 fallback 처리 |
|
||||
| `AuctionState.timer` (초, 카운트다운) | 서버 `currentDeadline: Date` | 프론트가 `deadline - now`로 매 틱 계산 |
|
||||
|
||||
---
|
||||
|
||||
## 3. 실행 계획
|
||||
|
||||
> 단계는 독립적이지 않고 순차 진행 권장. Phase 0 → 1 → 2 → 3 순서.
|
||||
|
||||
### Phase 0 — 백엔드 선행 보강 (`apps/api`)
|
||||
|
||||
#### 0.1 CORS 활성화
|
||||
|
||||
**파일**: `apps/api/src/main.ts`
|
||||
|
||||
```ts
|
||||
app.enableCors({
|
||||
origin: process.env.WEB_ORIGIN?.split(",") ?? ["http://localhost:5173"],
|
||||
credentials: true,
|
||||
allowedHeaders: ["Content-Type", "X-Auth-User-Id"],
|
||||
});
|
||||
```
|
||||
|
||||
프로덕션용 origin은 `project.env`의 `WEB_ORIGIN`으로 주입.
|
||||
|
||||
#### 0.2 `MatchParticipant.tier` 스냅샷 필드 추가
|
||||
|
||||
**파일**: `apps/api/src/modules/global/database/schema.ts`
|
||||
|
||||
- `MatchParticipant` interface + sub-schema에 `tier?: TierInfo` 추가 (optional — Riot 계정이 없는 유저도 참여 가능해야 하면)
|
||||
- `MatchService.join()` (`apps/api/src/modules/match/match.service.ts` 라인 93~)에서 `primaryRiot.tiers.find(t => t.queueType === 'RANKED_SOLO_5x5') ?? primaryRiot.tiers[0]`를 복사
|
||||
- 기존 데이터 마이그레이션 없이 optional이라 호환성 유지
|
||||
|
||||
#### 0.3 `/me` + `/communities/:id` 편의 엔드포인트
|
||||
|
||||
**신규 파일**: `apps/api/src/modules/user/user.controller.ts`, `user.module.ts`
|
||||
|
||||
```ts
|
||||
@Controller("me")
|
||||
class MeController {
|
||||
@Get()
|
||||
me(@CurrentUser() user: UserDocument | undefined) {
|
||||
return user ? { user } : { user: null };
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**Community 쪽** (`community.controller.ts`):
|
||||
|
||||
```ts
|
||||
@Get(':communityId')
|
||||
async getCommunity(@Param('communityId', ParseObjectIdPipe) id) {
|
||||
return this.communityService.getById(id); // 서비스에 메서드 추가
|
||||
}
|
||||
```
|
||||
|
||||
#### 0.4 Auction WebSocket 게이트웨이 (핵심)
|
||||
|
||||
**의존성 설치**: `pnpm --filter api add @nestjs/websockets @nestjs/platform-socket.io socket.io`
|
||||
|
||||
**신규 파일**: `apps/api/src/modules/auction/auction.gateway.ts`
|
||||
|
||||
네임스페이스·룸 구조:
|
||||
|
||||
- 네임스페이스: `/auction`
|
||||
- 룸 이름: `matchId` 문자열
|
||||
|
||||
이벤트 스펙:
|
||||
| 방향 | 이벤트 | payload |
|
||||
| --- | --- | --- |
|
||||
| server→client | `state` | `AuctionDocument` (직렬화) |
|
||||
| server→client | `tick` | `{ deadline: string, serverTime: string }` |
|
||||
| server→client | `error` | `{ message: string }` |
|
||||
| client→server | `join` | `{ matchId: string }` |
|
||||
| client→server | `bid` | `{ side, amount, bidderUserId? }` |
|
||||
| client→server | `open-bidding` | `{}` |
|
||||
| client→server | `sold` | `{ assignedPosition? }` |
|
||||
| client→server | `next` | `{}` |
|
||||
|
||||
구현 포인트:
|
||||
|
||||
- `handleConnection`/`handleDisconnect`에서 Socket.IO의 rooms 표준 사용
|
||||
- 클라이언트 `join` 시 해당 matchId 룸에 입장 + 현재 `state` 푸시
|
||||
- 입찰/낙찰/다음 이벤트는 **기존 `AuctionService` 메서드 재사용**. 결과 상태를 해당 룸에 브로드캐스트
|
||||
- `AuctionService`가 phase 전이 시마다 `deadline: Date` 계산해서 Auction 문서에 저장 (`AuctionSchema`에 `currentDeadline?: Date` 추가)
|
||||
- 타이머 만료 자동 처리는 **Phase 0에선 생략**하고, 클라이언트가 deadline 지나면 "시간 종료" 표시만. 자동 `markSold`는 후속 작업 (`SchedulerRegistry` + `setTimeout` 필요). 트러스트 전제라 팀장이 수동 sold 하면 충분.
|
||||
|
||||
**AuthMiddleware는 socket.io 연결에 적용되지 않음**: 게이트웨이 자체에서 `@ConnectedSocket()`의 handshake headers 또는 auth payload에서 `x-auth-user-id`를 읽어 옵션으로 취급. 권한 필요한 이벤트(`open-bidding`, `sold`, `next`)는 일단 무검증 유지 (트러스트 전제). `bid`만 payload의 `bidderUserId`를 검증해서 해당 팀의 `captainUserId`와 일치하는지 정도 체크하면 고의 방해 방지 최소선은 만족.
|
||||
|
||||
#### 0.5 `AuctionSchema.currentDeadline` 추가
|
||||
|
||||
**파일**: `apps/api/src/modules/global/database/schema.ts`
|
||||
|
||||
- interface `Auction`에 `currentDeadline?: Date`
|
||||
- Schema 필드 추가
|
||||
- `AuctionService.openBidding()`과 `placeBid()`에서 `new Date(Date.now() + auction.maxTimerSeconds * 1000)`로 갱신
|
||||
- `placeBid` 시엔 `Math.max(5, remainingSeconds)` 보장 (기존 프론트 mock 로직과 동일: 최소 5초)
|
||||
- `markSold` / `next` 시엔 `undefined`로 리셋
|
||||
|
||||
#### 0.6 AppModule 등록
|
||||
|
||||
**파일**: `apps/api/src/app.module.ts`
|
||||
|
||||
- `UserModule` import
|
||||
- `AuctionModule`에서 게이트웨이 providers 등록 (`AuctionGateway` + `AuctionService`는 그대로)
|
||||
|
||||
#### 0.7 검증 (Phase 0 종료 시)
|
||||
|
||||
```bash
|
||||
cd apps/api
|
||||
./node_modules/.bin/tsc --noEmit
|
||||
pnpm start:dev
|
||||
```
|
||||
|
||||
- `curl -H "X-Auth-User-Id: <id>" http://localhost:3000/me`로 `/me` 확인
|
||||
- socket.io 클라이언트(또는 `wscat`)로 `ws://localhost:3000/auction` 연결 + `join` 이벤트 → `state` 수신 확인
|
||||
|
||||
---
|
||||
|
||||
### Phase 1 — 프론트엔드 인프라 구축 (`apps/web`)
|
||||
|
||||
#### 1.1 의존성 설치
|
||||
|
||||
```bash
|
||||
pnpm --filter web add @tanstack/react-query socket.io-client
|
||||
pnpm --filter web add -D @tanstack/react-query-devtools
|
||||
```
|
||||
|
||||
#### 1.2 환경 변수
|
||||
|
||||
**신규 파일**: `apps/web/.env.development` (기존 있으면 추가)
|
||||
|
||||
```
|
||||
VITE_API_BASE_URL=http://localhost:3000
|
||||
VITE_DEFAULT_COMMUNITY_ID=<Phase 3에서 생성한 커뮤니티 _id>
|
||||
```
|
||||
|
||||
**신규 파일**: `apps/web/src/config.ts`
|
||||
|
||||
- `API_BASE_URL`, `DEFAULT_COMMUNITY_ID` export
|
||||
- `getAuthUserId()` / `setAuthUserId(id | null)` (localStorage `lolympus.authUserId`)
|
||||
|
||||
#### 1.3 API 클라이언트
|
||||
|
||||
**신규 파일**: `apps/web/src/lib/api.ts`
|
||||
|
||||
- `apiFetch<T>(path, init?)`: 베이스 URL 붙이고, `X-Auth-User-Id` 자동 주입, JSON 파싱, 4xx/5xx는 `ApiError` throw
|
||||
- 응답 타입은 제네릭
|
||||
|
||||
#### 1.4 타입 정의 (백엔드 미러)
|
||||
|
||||
**신규 파일**: `apps/web/src/api/types.ts`
|
||||
|
||||
- `Position`, `TeamSide`, `MatchStatus`, `AuctionPhase` 같은 유니온은 복붙
|
||||
- `TierInfo`, `ChampionMasteryEntry`, `RiotRecentStatsSummary` 등 sub-type
|
||||
- `ApiCommunity`, `ApiUser`, `ApiMatch`, `ApiAuction` — 응답 형태 그대로
|
||||
- `_id: string` (ObjectId 직렬화), `createdAt/updatedAt: string` (ISO)
|
||||
|
||||
> 타입 중복은 MVP에선 감수. 나중에 `packages/shared-types` 생성 고려.
|
||||
|
||||
#### 1.5 매핑 레이어
|
||||
|
||||
**신규 파일**: `apps/web/src/api/mappers.ts`
|
||||
|
||||
- `mapApiMatchToMatchDetail(match: ApiMatch): MatchDetail`
|
||||
- `mapApiAuctionToAuctionState(auction: ApiAuction, serverNow?: Date): AuctionState`
|
||||
- `mapIdToLabel(mapId: number): string` — `11 → '소환사의 협곡'`, `12 → '칼바람 나락'`, ...
|
||||
- `formatKoreanDate(date: Date): { date, time }`
|
||||
- `selectPrimaryTier(tiers: TierInfo[]): TierInfo | undefined`
|
||||
|
||||
> 기존 `apps/web/src/mock.ts`의 `MatchDetail`/`Participant` 타입은 유지한 채로 매퍼가 채움. 이후 Phase 2에서 점진 삭제.
|
||||
|
||||
#### 1.6 React Query 설정
|
||||
|
||||
**파일 수정**: `apps/web/src/main.tsx`
|
||||
|
||||
- `QueryClientProvider`로 감싸기
|
||||
- staleTime 10s, cacheTime 5min 기본값
|
||||
|
||||
#### 1.7 Socket 훅
|
||||
|
||||
**신규 파일**: `apps/web/src/api/useAuctionSocket.ts`
|
||||
|
||||
- `useAuctionSocket(matchId: string)` 훅
|
||||
- 내부: `useEffect`로 `io(API_BASE_URL + '/auction', { auth: { 'x-auth-user-id': getAuthUserId() } })`
|
||||
- `join` emit 후 `state`/`tick`/`error` 이벤트 구독
|
||||
- state는 `useState`로 저장, 반환: `{ state, placeBid, openBidding, markSold, next, connectionStatus }`
|
||||
|
||||
#### 1.8 개발자용 User 주입 위젯
|
||||
|
||||
**신규 파일**: `apps/web/src/components/DevAuthSwitcher.tsx`
|
||||
|
||||
- 우하단 플로팅 패널. input + "Set"/"Clear" 버튼. localStorage 값 표시
|
||||
- `import.meta.env.DEV`일 때만 렌더
|
||||
|
||||
---
|
||||
|
||||
### Phase 2 — 페이지 교체 (`apps/web`)
|
||||
|
||||
#### 2.1 HomePage
|
||||
|
||||
**파일**: `apps/web/src/pages/HomePage.tsx`
|
||||
|
||||
- mock import 제거
|
||||
- `useQuery(['matches', communityId, 'upcoming'])` → `GET /communities/:id/matches?status=recruiting&limit=20`
|
||||
- `useQuery(['matches', communityId, 'finished'])` → `GET /communities/:id/matches?status=finished&limit=10`
|
||||
- "다음 내전"은 upcoming의 첫 요소
|
||||
- 각 카드는 `mapApiMatchToMatchDetail`의 축약 버전으로
|
||||
|
||||
#### 2.2 MatchDetailPage
|
||||
|
||||
**파일**: `apps/web/src/pages/MatchDetailPage.tsx`
|
||||
|
||||
- `useQuery(['match', matchId])` → `GET /communities/:id/matches/:matchId`
|
||||
- `mapApiMatchToMatchDetail()` 적용
|
||||
- 참가자 티어는 `participant.tier` 직접 사용 (백엔드 snapshot)
|
||||
- "경매 시작" 버튼은 `/me` 결과의 role이 admin/owner일 때만 보여주기 (admin 전용)
|
||||
|
||||
#### 2.3 AuctionPage
|
||||
|
||||
**파일**: `apps/web/src/pages/AuctionPage.tsx`
|
||||
|
||||
- `createMockAuction` import 제거
|
||||
- 초기 상태: `useQuery(['auction', matchId])` → `GET /communities/:id/matches/:matchId/auction`
|
||||
- 이후: `useAuctionSocket(matchId)`로 실시간 갱신
|
||||
- 타이머: `state.currentDeadline`과 `Date.now()` 차이로 클라이언트 카운트다운
|
||||
- "입찰" 버튼: `placeBid({side, amount})` 호출 (내부적으로 socket emit)
|
||||
- "공개"/"낙찰"/"다음" 버튼(팀장용): socket emit — 페이지에 세 버튼 노출 (트러스트 전제)
|
||||
- **localStorage에 자기가 어느 팀장인지 저장하는 토글** 추가 (dev 편의)
|
||||
|
||||
#### 2.4 mock 파일 제거
|
||||
|
||||
- `apps/web/src/mock.ts` — Position/TierInfo/Participant 같은 타입만 `src/api/types.ts`로 흡수 후 삭제
|
||||
- `apps/web/src/auction-mock.ts` — 전부 삭제
|
||||
- `apps/web/src/auction-types.ts` — 프론트 전용 파생 타입만 남기고 백엔드 응답 타입은 `api/types.ts`로
|
||||
|
||||
---
|
||||
|
||||
### Phase 3 — E2E 검증 및 시드
|
||||
|
||||
#### 3.1 시드 데이터 생성 스크립트
|
||||
|
||||
**신규 파일**: `apps/api/src/seed.ts` (또는 ad-hoc)
|
||||
|
||||
- `CommunityService.createCommunityWithOwner({ name: 'Dev Community', owner: { kakaoTalkNickname: 'DevOwner' } })`
|
||||
- 참가자 유저 10명 생성 (Riot 계정 더미 + tiers 채움 — 기존 mock 데이터를 DB로 이식)
|
||||
- 매치 3개 (recruiting 1, team-built 1, finished 1)
|
||||
- 반환된 `communityId`를 `.env.development`에 복사
|
||||
|
||||
실행:
|
||||
|
||||
```bash
|
||||
pnpm --filter api exec ts-node src/seed.ts
|
||||
```
|
||||
|
||||
#### 3.2 통합 smoke test
|
||||
|
||||
1. `pnpm --filter api start:dev`
|
||||
2. `pnpm --filter web dev`
|
||||
3. 브라우저에서 `http://localhost:5173`:
|
||||
- HomePage에 시드 매치 3개 표시되는지
|
||||
- MatchDetailPage에서 참가자 티어 정보 렌더링되는지
|
||||
- DevAuthSwitcher로 owner User ID 주입 → 경매 시작 버튼 보이는지
|
||||
- AuctionPage 두 탭 열어서 한쪽 입찰 시 다른 쪽 실시간 반영되는지
|
||||
4. `tsc --noEmit`과 `pnpm --filter web build` 무오류 확인
|
||||
|
||||
---
|
||||
|
||||
## 4. 파일별 수정/신규 체크리스트
|
||||
|
||||
### `apps/api` 수정
|
||||
|
||||
- [ ] `src/main.ts` — CORS
|
||||
- [ ] `src/modules/global/database/schema.ts` — `MatchParticipant.tier?`, `Auction.currentDeadline?`
|
||||
- [ ] `src/modules/match/match.service.ts::join` — tier 스냅샷 복사
|
||||
- [ ] `src/modules/auction/auction.service.ts` — `openBidding`/`placeBid`에서 `currentDeadline` 갱신, `markSold`/`next`에서 리셋
|
||||
- [ ] `src/modules/community/community.controller.ts` + `community.service.ts` — `getById` + `GET /communities/:id`
|
||||
- [ ] `src/app.module.ts` — `UserModule`, `AuctionGateway` provider 등록
|
||||
|
||||
### `apps/api` 신규
|
||||
|
||||
- [ ] `src/modules/user/user.module.ts`
|
||||
- [ ] `src/modules/user/user.controller.ts` (`GET /me`)
|
||||
- [ ] `src/modules/auction/auction.gateway.ts`
|
||||
- [ ] `src/seed.ts` (선택)
|
||||
|
||||
### `apps/web` 수정
|
||||
|
||||
- [ ] `src/main.tsx` — `QueryClientProvider`
|
||||
- [ ] `src/App.tsx` — DevAuthSwitcher 마운트
|
||||
- [ ] `src/pages/HomePage.tsx` — react-query 연동
|
||||
- [ ] `src/pages/MatchDetailPage.tsx` — react-query 연동
|
||||
- [ ] `src/pages/AuctionPage.tsx` — socket 훅 연동
|
||||
|
||||
### `apps/web` 신규
|
||||
|
||||
- [ ] `.env.development`
|
||||
- [ ] `src/config.ts`
|
||||
- [ ] `src/lib/api.ts`
|
||||
- [ ] `src/api/types.ts`
|
||||
- [ ] `src/api/mappers.ts`
|
||||
- [ ] `src/api/useAuctionSocket.ts`
|
||||
- [ ] `src/api/hooks.ts` (선택 — `useMatches`, `useMatch`, `useAuction`, `useMe`)
|
||||
- [ ] `src/components/DevAuthSwitcher.tsx`
|
||||
|
||||
### `apps/web` 삭제
|
||||
|
||||
- [ ] `src/mock.ts` (타입은 `src/api/types.ts`로 흡수 후)
|
||||
- [ ] `src/auction-mock.ts`
|
||||
|
||||
---
|
||||
|
||||
## 5. 재사용할 기존 유틸
|
||||
|
||||
| 용도 | 위치 | 재사용 포인트 |
|
||||
| ---------------------- | ----------------------------------------------------------------------------- | --------------------------------------------------- |
|
||||
| ObjectId 파라미터 파싱 | `apps/api/src/modules/common/parse-object-id.pipe.ts` | 새 엔드포인트(`getCommunity`, `me`)에도 적용 |
|
||||
| 트랜잭션 세션 생성 | `apps/api/src/modules/global/database/connection.service.ts::createSession` | `AuctionGateway`에서 원자적 상태 전이가 필요한 경우 |
|
||||
| `@CurrentUser()` | `apps/api/src/modules/auth/current-user.decorator.ts` | `/me`에서 그대로 사용 |
|
||||
| Role 매핑 | `apps/api/src/modules/auth/permissions.ts::roleHasPermission` | 프론트에 권한 표시 JSON 내려줄 때 참고 |
|
||||
| 포지션 라벨/아이콘 | `apps/web/src/assets/position/*` + `mock.ts`의 `positionLabel`/`positionIcon` | `src/api/mappers.ts`로 이동 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 위험 요소 & 주의사항
|
||||
|
||||
1. **Socket.IO 인증 미적용**: MVP에선 WebSocket 연결에 인증을 강제하지 않음. 고의 방해 시나리오 대비는 `bid` 이벤트의 `bidderUserId`가 해당 팀 `captainUserId`와 일치하는지만 체크. 프로덕션 전환 전에 JWT 핸드셰이크로 교체.
|
||||
2. **타이머 만료 자동 sold 미구현**: 팀장이 수동으로 "낙찰" 누르는 흐름. 이게 불편하면 후속 작업으로 `SchedulerRegistry` 타이머 추가.
|
||||
3. **Mongoose `HydratedDocument` 직렬화**: `JSON.stringify`는 `toJSON`을 거치지만 `_id`가 ObjectId 객체로 나올 수 있음. 엔드포인트에서 `.lean()` 또는 `toObject({ versionKey: false })` 적용 고려 — 또는 프론트에서 `String(_id)` 처리.
|
||||
4. **프론트 타입 중복**: `apps/web/src/api/types.ts`가 백엔드 스키마와 갈라질 수 있음. Phase 3 이후 `packages/shared-types` 워크스페이스로 승격 권장.
|
||||
5. **시드 데이터의 communityId 동기화**: `.env.development`에 하드코딩되므로 재시드 시 값 바뀜. `seed.ts` 마지막에 `.env.development`를 갱신하도록 하면 편함.
|
||||
6. **`forbidNonWhitelisted: true`**: DTO에 없는 필드는 400. 프론트 요청 페이로드 구성 시 주의.
|
||||
7. **Riot 계정 없는 유저 참여**: `MatchService.join`은 현재 `primaryRiot` 없어도 `undefined`로 저장. `tier` 필드도 optional로 유지해야 기존 흐름 유지.
|
||||
|
||||
---
|
||||
|
||||
## 7. 검증 체크리스트 (최종)
|
||||
|
||||
- [ ] `pnpm --filter api run build` 무오류
|
||||
- [ ] `pnpm --filter web run build` 무오류
|
||||
- [ ] `curl -i http://localhost:3000/me` → `{user: null}`, 헤더 넣으면 user 객체
|
||||
- [ ] `curl http://localhost:3000/communities/<id>/matches` → 시드 매치 목록
|
||||
- [ ] 브라우저 HomePage 렌더 OK
|
||||
- [ ] MatchDetailPage에 티어 표시 OK
|
||||
- [ ] AuctionPage 두 탭 open → 한쪽 bid 하면 다른 쪽 `state` 이벤트로 즉시 갱신
|
||||
- [ ] DevAuthSwitcher로 owner ID 주입 시에만 "경매 시작" 버튼 노출
|
||||
- [ ] 비 admin 상태에선 admin 엔드포인트 호출 시 401/403 응답이 UI에 에러 토스트로 노출
|
||||
|
||||
---
|
||||
|
||||
## 8. 작업 순서 (codex 핸드오프용)
|
||||
|
||||
1. **Phase 0** (백엔드 보강) — 스키마 변경 → 서비스 갱신 → 게이트웨이 → CORS/ME. 빌드 확인.
|
||||
2. **Phase 1** (프론트 인프라) — deps 설치 → config/api/types/mappers → QueryClientProvider.
|
||||
3. **Phase 3의 3.1 시드** 먼저 돌려서 `communityId` 확보 → `.env.development` 업데이트.
|
||||
4. **Phase 2** (페이지 교체) — HomePage → MatchDetailPage → AuctionPage 순서.
|
||||
5. **Phase 3의 3.2** E2E 스모크 테스트.
|
||||
|
||||
각 Phase 종료마다 `tsc --noEmit`으로 타입 검증, 필요시 `pnpm lint` 실행.
|
||||
@@ -1,465 +0,0 @@
|
||||
# Legacy 내전 데이터 백필 (Import) 플랜
|
||||
|
||||
> **대상**: codex 가 이어서 작업 가능한 수준의 실행 플랜
|
||||
> **레포**: `/Users/dahyeon/source/lolympus-tournament-support` (pnpm workspace)
|
||||
> **작성 기준**: 2026-04-27
|
||||
> **선행 작업**:
|
||||
> - `Riot-최근경기-플랜.md` (RiotRateLimiterService, RiotMatch 영구 저장)
|
||||
> - `Riot-소환사전적-플랜.md` (Redis Stream 작업 큐, leader election, ETA, deferUntil)
|
||||
> - `Tournament-Result-수집-플랜.md` (Match.result.games 매핑 로직, team-mapping 유틸, advanceMatchIfReady)
|
||||
> - `커뮤니티-내전-전적.md` / `stateful-stirring-moler.md` (커뮤니티 통계 페이지 — 본 plan 의 결과 데이터 소비처)
|
||||
|
||||
---
|
||||
|
||||
## 1. Context
|
||||
|
||||
본 시스템 도입 이전에 진행된 내전 매치는 우리 DB 에 없습니다. 그러나 Riot 은 `match-v5` raw 매치 데이터를 ~2년간 보관하므로, **커뮤니티 멤버 puuid 로 `type=tourney` 매치를 검색**해 backfill 할 수 있습니다.
|
||||
|
||||
목표:
|
||||
- **2024-05-01 부터** 모든 커뮤니티 멤버의 토너먼트 코드 매치를 import 해 우리 `Match` 도큐먼트로 변환
|
||||
- 임계값 휴리스틱은 사용하지 않음 — **검색된 모든 매치 import** (외부 토너먼트가 섞여도 OK)
|
||||
- 추후 admin UI 에서 운영자가 잘못 들어온 매치를 직접 삭제 (사후 cleanup 정책)
|
||||
- 1 match-v5 = 1 Match 도큐먼트 (시리즈 묶음 X)
|
||||
- 야간/유휴 시간대 권장
|
||||
|
||||
선행 인프라가 갖춘 부분:
|
||||
- `RiotMatchService.getMatchIdsByPuuid({type: 'tourney', startTime, ...})` 가 이미 동작
|
||||
- `RiotMatch.raw` 영구 저장 + `participantPuuids` 인덱스
|
||||
- Redis Stream 작업 큐 (`riot:queue:high/low`) + RiotRateLimiterService 글로벌 throttle
|
||||
- `Tournament-Result-수집-플랜.md` 의 `team-mapping.util.ts` (puuid 합집합 다수결 → blue/red 매핑) 그대로 재사용
|
||||
|
||||
---
|
||||
|
||||
## 2. 결정사항 (사용자 결정 2026-04-27)
|
||||
|
||||
- **검색 시작일**: 2024-05-01 (UTC)
|
||||
- **검색 종료일**: 멤버별 `isActivated=false` 면 `user.updatedAt`, 활성이면 현재
|
||||
- **멤버별 startTime override**: `max(2024-05-01, user.createdAt)` 자동 채움. 운영자가 admin UI 에서 멤버별 수정 가능
|
||||
- **임계값 필터 사용 X**: 검색된 모든 `type=tourney` 매치 import (외부 토너먼트도 포함)
|
||||
- **시리즈 묶음 X**: 1 match-v5 = 1 Match 도큐먼트, `gameCount=1`
|
||||
- **사후 cleanup**: admin UI 에서 legacy 매치 목록 보고 단일/bulk 삭제 가능
|
||||
- **idempotent**: 같은 `riotMatchId` 두 번 import 안 됨
|
||||
- **부하**: 야간 batch 권장. 운영자가 명시적으로 트리거
|
||||
|
||||
---
|
||||
|
||||
## 3. 데이터 모델 보강
|
||||
|
||||
### 3.1 Match 확장 (legacy 추적)
|
||||
|
||||
```ts
|
||||
// schema.ts Match 추가
|
||||
legacyImported?: boolean; // true 면 본 import 로 들어온 매치
|
||||
legacyImportSource?: {
|
||||
importedAt: Date;
|
||||
importedBy: mongoose.Types.ObjectId; // 트리거한 admin userId
|
||||
triggeringPuuid: string; // 어떤 멤버 검색으로 처음 발견됐는지 audit
|
||||
jobId?: string;
|
||||
};
|
||||
|
||||
// MatchSchema
|
||||
legacyImported: { type: Boolean, default: false, index: true },
|
||||
legacyImportSource: {
|
||||
importedAt: { type: Date },
|
||||
importedBy: { type: Schema.Types.ObjectId, ref: 'user' },
|
||||
triggeringPuuid: { type: String },
|
||||
jobId: { type: String },
|
||||
}
|
||||
```
|
||||
|
||||
### 3.2 RiotMatch unique 검사
|
||||
|
||||
이미 `RiotMatch.matchId` 가 unique 인덱스 (선행 plan 가정). 신규 import 시 이미 있으면 detail 재호출 skip.
|
||||
|
||||
### 3.3 Match `riotMatchId` 단위 unique
|
||||
|
||||
같은 match-v5 가 두 Match 도큐먼트로 들어오는 사고 방지:
|
||||
- Mongo aggregation 단계에서 `result.games[].riotMatchId` 가 이미 다른 Match 에 존재하면 skip
|
||||
- 또는 신규 sparse 인덱스: `Match.result.games.riotMatchId` (배열 인덱스, sparse)
|
||||
```ts
|
||||
MatchSchema.index({ 'result.games.riotMatchId': 1 }, { sparse: true, unique: false });
|
||||
```
|
||||
- unique 는 배열 element 단위로 보장하기 어려우니 application 레벨 검사 권장
|
||||
|
||||
### 3.4 신규 컬렉션 — `LegacyImportJob` (운영 추적)
|
||||
|
||||
```ts
|
||||
export interface LegacyImportJob {
|
||||
jobId: string;
|
||||
communityId: mongoose.Types.ObjectId;
|
||||
triggeredBy: mongoose.Types.ObjectId;
|
||||
startedAt: Date;
|
||||
completedAt?: Date;
|
||||
state: 'pending' | 'running' | 'completed' | 'failed' | 'cancelled';
|
||||
|
||||
// 입력 파라미터
|
||||
windowStart: Date; // 기본 2024-05-01
|
||||
windowEnd: Date;
|
||||
memberOverrides: Array<{ // 운영자가 수정한 멤버별 윈도우
|
||||
userId: mongoose.Types.ObjectId;
|
||||
puuid: string;
|
||||
startTime: Date;
|
||||
endTime: Date;
|
||||
}>;
|
||||
|
||||
// 진행 상황
|
||||
totalMembers: number;
|
||||
processedMembers: number;
|
||||
totalDiscoveredMatchIds: number; // dedup 후
|
||||
totalImportedMatches: number;
|
||||
totalSkippedDuplicate: number;
|
||||
totalErrors: number;
|
||||
|
||||
errors?: Array<{ puuid?: string; matchId?: string; reason: string; at: Date }>;
|
||||
}
|
||||
```
|
||||
|
||||
운영 가시성: admin UI 에서 import job 진행률 표시 + 실패 매치 재시도.
|
||||
|
||||
---
|
||||
|
||||
## 4. Import 흐름
|
||||
|
||||
### 4.1 트리거
|
||||
|
||||
```
|
||||
admin UI → POST /communities/:cid/legacy-import
|
||||
body: {
|
||||
windowStart?: '2024-05-01T00:00:00Z',
|
||||
windowEnd?: ISO,
|
||||
memberOverrides?: [{ userId, startTime, endTime }, ...]
|
||||
}
|
||||
응답: { jobId, totalMembers, etaSeconds }
|
||||
```
|
||||
|
||||
`@Roles('owner', 'admin')` 가드. 동시 동일 community 에 대한 job 1개로 제한 (Garnet `legacy-import:lock:<cid>` NX EX 6h).
|
||||
|
||||
### 4.2 sub-job 분할
|
||||
|
||||
선행 plan 의 작업 큐 패턴 그대로:
|
||||
- parent job: `LegacyImportJob` 생성
|
||||
- 멤버별 sub-job N개 enqueue → `riot:queue:low` (priority low — 사용자 갱신/prefetch 보다 뒤)
|
||||
- payload:
|
||||
```ts
|
||||
{
|
||||
kind: 'legacy-import-member',
|
||||
parentJobId,
|
||||
communityId,
|
||||
userId,
|
||||
puuid,
|
||||
startTime, // epoch seconds
|
||||
endTime,
|
||||
triggeredBy,
|
||||
}
|
||||
```
|
||||
|
||||
### 4.3 worker — 멤버 1명 처리
|
||||
|
||||
```ts
|
||||
async function processLegacyImportMember(job: LegacyImportMemberJob) {
|
||||
let start = 0;
|
||||
const collectedMatchIds = new Set<string>();
|
||||
|
||||
// 1. type=tourney list 페이지네이션 (count=100, region 'asia')
|
||||
while (true) {
|
||||
const ids = await matchService.getMatchIdsByPuuid(job.puuid, {
|
||||
type: 'tourney',
|
||||
startTime: Math.floor(job.startTime.getTime() / 1000),
|
||||
endTime: Math.floor(job.endTime.getTime() / 1000),
|
||||
start,
|
||||
count: 100,
|
||||
region: 'asia',
|
||||
});
|
||||
ids.forEach((id) => collectedMatchIds.add(id));
|
||||
if (ids.length < 100) break;
|
||||
start += 100;
|
||||
// throttle 통과 — 별도 sleep 불필요
|
||||
}
|
||||
|
||||
// 2. 각 matchId detail + Match 변환
|
||||
for (const matchV5Id of collectedMatchIds) {
|
||||
await importSingleMatch(matchV5Id, {
|
||||
communityId: job.communityId,
|
||||
triggeringPuuid: job.puuid,
|
||||
importedBy: job.triggeredBy,
|
||||
parentJobId: job.parentJobId,
|
||||
});
|
||||
}
|
||||
|
||||
await updateLegacyImportJobProgress(job.parentJobId, {
|
||||
processedMembers: 1,
|
||||
discovered: collectedMatchIds.size,
|
||||
});
|
||||
}
|
||||
|
||||
async function importSingleMatch(matchV5Id: string, ctx) {
|
||||
// dedup: 이미 우리 Match 에 있는지
|
||||
const existing = await MatchModel.findOne({ 'result.games.riotMatchId': matchV5Id });
|
||||
if (existing) {
|
||||
await incrementCounter('totalSkippedDuplicate');
|
||||
return;
|
||||
}
|
||||
|
||||
// RiotMatch raw 페치 (이미 있으면 cache hit)
|
||||
const detail = await ensureRiotMatchPersisted(matchV5Id);
|
||||
if (!detail.info.tournamentCode) return; // 안전: tourney 인데 코드 없는 비정상 케이스 skip
|
||||
|
||||
// 우리 멤버 매핑
|
||||
const community = await CommunityModel.findById(ctx.communityId);
|
||||
const userByPuuid = await buildUserByPuuidMap(ctx.communityId);
|
||||
const teams100Puuids = detail.info.participants.filter((p) => p.teamId === 100).map((p) => p.puuid);
|
||||
const teams200Puuids = detail.info.participants.filter((p) => p.teamId === 200).map((p) => p.puuid);
|
||||
|
||||
const team100MembersInOurs = teams100Puuids.filter((p) => userByPuuid.has(p)).length;
|
||||
const team200MembersInOurs = teams200Puuids.filter((p) => userByPuuid.has(p)).length;
|
||||
|
||||
// 외부 매치(우리 멤버 0명) 는 import 하지 않음 — 검색 결과에 잘못 들어온 케이스 가드
|
||||
if (team100MembersInOurs + team200MembersInOurs === 0) return;
|
||||
|
||||
// teamId → blue/red: 우리 멤버 더 많은 쪽이 blue (관습), 동수면 100=blue
|
||||
const team100IsBlue = team100MembersInOurs >= team200MembersInOurs;
|
||||
|
||||
// Match 도큐먼트 생성
|
||||
const match = await MatchModel.create({
|
||||
communityId: ctx.communityId,
|
||||
title: `[Legacy] ${formatDate(detail.info.gameCreation)}`,
|
||||
description: 'Legacy import (자동 생성)',
|
||||
mapId: detail.info.mapId ?? 11,
|
||||
status: 'finished',
|
||||
scheduledAt: new Date(detail.info.gameCreation),
|
||||
teamBuiltAt: new Date(detail.info.gameCreation),
|
||||
maxParticipants: 10,
|
||||
gameCount: 1,
|
||||
tournamentCodeIds: [], // legacy 라 우리 풀 코드 없음
|
||||
participants: buildParticipantsSnapshot(detail, userByPuuid),
|
||||
teams: buildTeams(detail, userByPuuid, team100IsBlue),
|
||||
result: {
|
||||
blueScore: 0,
|
||||
redScore: 0,
|
||||
games: [
|
||||
buildGameResult(detail, userByPuuid, team100IsBlue, 1),
|
||||
],
|
||||
riotMatchIds: [matchV5Id],
|
||||
},
|
||||
legacyImported: true,
|
||||
legacyImportSource: {
|
||||
importedAt: new Date(),
|
||||
importedBy: ctx.importedBy,
|
||||
triggeringPuuid: ctx.triggeringPuuid,
|
||||
jobId: ctx.parentJobId,
|
||||
},
|
||||
});
|
||||
|
||||
// result.winnerSide / blueScore / redScore 산정
|
||||
const winnerSide = match.result!.games[0].winnerSide;
|
||||
match.result!.blueScore = winnerSide === 'blue' ? 1 : 0;
|
||||
match.result!.redScore = winnerSide === 'red' ? 1 : 0;
|
||||
match.result!.winnerSide = winnerSide;
|
||||
await match.save();
|
||||
|
||||
await incrementCounter('totalImportedMatches');
|
||||
}
|
||||
```
|
||||
|
||||
핵심 헬퍼:
|
||||
- `ensureRiotMatchPersisted(matchV5Id)`: RiotMatch 컬렉션에 upsert. 이미 있으면 그대로 반환 (Riot API 호출 0회).
|
||||
- `buildUserByPuuidMap(communityId)`: 커뮤니티 멤버 puuid → User 역인덱스 (in-memory cache, job 단위).
|
||||
- `buildGameResult(detail, userByPuuid, team100IsBlue, gameNumber)`: 선행 plan `Tournament-Result-수집-플랜.md` `§4.4 computeGameResult` 함수 그대로 재사용. team mapping 만 override.
|
||||
|
||||
### 4.4 동시성 / dedup
|
||||
|
||||
- **멤버 sub-job 간 동시성**: 두 멤버가 같은 매치에 있으면 두 worker 가 같은 matchV5Id 를 동시에 처리하려고 함. `importSingleMatch` 진입 시 Garnet `legacy-import:match:<matchV5Id>` NX EX 60s 락. 이미 잡혔으면 skip.
|
||||
- **재실행**: 같은 jobId 재실행 시 이미 처리된 멤버는 `LegacyImportJob.processedMembers` 기준 skip.
|
||||
|
||||
### 4.5 진행률 / ETA
|
||||
|
||||
- worker 가 sub-job 끝낼 때마다 `LegacyImportJob.processedMembers++`
|
||||
- ETA: `(totalMembers - processedMembers) × avgMemberSeconds`
|
||||
- avgMemberSeconds 기본 60 (멤버당 list 1~3 페이지 + detail 10~50건 가정), 실제 처리 시간으로 EWMA 갱신
|
||||
- admin UI 가 5초 polling 으로 진행률 표시
|
||||
|
||||
### 4.6 cancel
|
||||
|
||||
- `POST /legacy-import-jobs/:jobId/cancel` (admin)
|
||||
- `LegacyImportJob.state='cancelled'` 마킹 → worker 가 sub-job pickup 직후 state 확인 → cancelled 면 즉시 ack 후 skip
|
||||
|
||||
---
|
||||
|
||||
## 5. Admin UI
|
||||
|
||||
### 5.1 신규 페이지
|
||||
|
||||
`apps/web/src/pages/admin/LegacyImportPage.tsx`
|
||||
- 라우트: `/admin/communities/:cid/legacy-import`
|
||||
- `@Roles('owner', 'admin')` 가드 (useMe + role 분기)
|
||||
|
||||
#### 화면 구성
|
||||
|
||||
```
|
||||
┌────────────────────────────────────────────┐
|
||||
│ Legacy 내전 백필 │
|
||||
├────────────────────────────────────────────┤
|
||||
│ 검색 윈도우 │
|
||||
│ 시작일 [2024-05-01 ▾] 종료일 [지금 ▾] │
|
||||
├────────────────────────────────────────────┤
|
||||
│ 멤버별 윈도우 (자동 채움 + 수정 가능) │
|
||||
│ ┌──────────┬─────────────┬──────────┐ │
|
||||
│ │ 멤버명 │ 시작일 │ 종료일 │ │
|
||||
│ │ 홍길동 │ 2024-05-01 │ 지금 │ │
|
||||
│ │ 이순신 │ 2024-08-15 │ 2025-12-31│ │
|
||||
│ └──────────┴─────────────┴──────────┘ │
|
||||
├────────────────────────────────────────────┤
|
||||
│ [백필 시작] (확인 모달 → 예상 ETA 표시) │
|
||||
├────────────────────────────────────────────┤
|
||||
│ 진행 중인 작업 │
|
||||
│ - jobId xxx: 23/100 멤버 처리 중... │
|
||||
│ 발견 매치 142개 / import 89개 / 중복 53 │
|
||||
├────────────────────────────────────────────┤
|
||||
│ 과거 작업 (최근 10개) │
|
||||
│ - jobId yyy: 완료, 100/100, import 412 │
|
||||
└────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
### 5.2 신규 페이지 — Legacy 매치 cleanup
|
||||
|
||||
`apps/web/src/pages/admin/LegacyMatchesPage.tsx`
|
||||
- 라우트: `/admin/communities/:cid/legacy-matches`
|
||||
- legacy 매치 목록 (`legacyImported=true` 필터) — 시간순 / 멤버 인원수 정렬
|
||||
- 각 row: 매치 ID / 시간 / 우리 멤버 N명 / 외부 puuid 수 / 챔피언 미니 + **삭제 버튼**
|
||||
- bulk select + 일괄 삭제
|
||||
- 확인 모달 ("이 매치는 영구 삭제됩니다. RiotMatch raw 는 유지됩니다.")
|
||||
|
||||
### 5.3 신규 엔드포인트
|
||||
|
||||
| Method | Path | 권한 | 용도 |
|
||||
|---|---|---|---|
|
||||
| POST | `/communities/:cid/legacy-import` | `owner/admin` | import 트리거 |
|
||||
| GET | `/communities/:cid/legacy-import-jobs` | `owner/admin` | job 목록 |
|
||||
| GET | `/communities/:cid/legacy-import-jobs/:jobId` | `owner/admin` | job 상세 |
|
||||
| POST | `/communities/:cid/legacy-import-jobs/:jobId/cancel` | `owner/admin` | 취소 |
|
||||
| GET | `/communities/:cid/legacy-matches` | `owner/admin` | legacy 매치 목록 (페이지네이션) |
|
||||
| DELETE | `/matches/:id` | `owner/admin` | 단일 매치 삭제 (legacy 외 일반 매치도 가능) |
|
||||
| POST | `/communities/:cid/legacy-matches/bulk-delete` | `owner/admin` | bulk 삭제 |
|
||||
|
||||
`Match` 삭제 시 부수 효과:
|
||||
- `tournamentCodeIds` 가 비어있으므로 풀 release 불필요
|
||||
- `MatchHistoryCache` invalidate (`riot:communitystats:*:<cid>:*` prefix scan delete) — `community-stats.service` 의 invalidate 헬퍼 재사용
|
||||
|
||||
---
|
||||
|
||||
## 6. 변경 사항 (파일 단위)
|
||||
|
||||
### 6.1 백엔드
|
||||
|
||||
```
|
||||
apps/api/src/modules/legacy-import/
|
||||
legacy-import.module.ts
|
||||
legacy-import.service.ts # enqueue + status + cancel
|
||||
legacy-import.worker.ts # 작업 큐 dispatch (kind=legacy-import-member)
|
||||
legacy-import.controller.ts
|
||||
legacy-import.types.ts
|
||||
match-builder.util.ts # buildParticipantsSnapshot / buildTeams / buildGameResult
|
||||
```
|
||||
|
||||
수정:
|
||||
- `apps/api/src/modules/global/database/schema.ts` — `Match.legacyImported`, `Match.legacyImportSource`, 신규 인덱스, `LegacyImportJob` 컬렉션 등록
|
||||
- `apps/api/src/modules/riot-job-queue/riot-job-worker.service.ts` — `kind === 'legacy-import-member'` dispatch 추가
|
||||
- `apps/api/src/modules/match/match.service.ts` — `delete(matchId)` 메서드 + community-stats invalidate 호출
|
||||
- `apps/api/src/modules/match/match.controller.ts` — `DELETE /matches/:id` 엔드포인트
|
||||
- `apps/api/src/app.module.ts` — `LegacyImportModule` import
|
||||
|
||||
### 6.2 프런트
|
||||
|
||||
```
|
||||
apps/web/src/pages/admin/LegacyImportPage.tsx
|
||||
apps/web/src/pages/admin/LegacyMatchesPage.tsx
|
||||
apps/web/src/components/admin/legacy/
|
||||
MemberWindowTable.tsx # 멤버별 윈도우 수정 폼
|
||||
LegacyImportJobProgress.tsx
|
||||
LegacyMatchListRow.tsx
|
||||
```
|
||||
|
||||
수정:
|
||||
- `apps/web/src/App.tsx` — 2 신규 admin 라우트
|
||||
- `apps/web/src/api/hooks.ts` — `useLegacyImportTrigger / useLegacyImportJobs / useLegacyMatches / useDeleteMatch`
|
||||
- `apps/web/src/api/types.ts` — 응답 타입
|
||||
|
||||
---
|
||||
|
||||
## 7. 단위 테스트
|
||||
|
||||
- `legacy-import.service.spec.ts`
|
||||
- parent job 생성 + 멤버별 sub-job N개 enqueue
|
||||
- 동일 cid 동시 트리거 시 두 번째 거부 (Garnet 락)
|
||||
- cancel 호출 시 state='cancelled', worker 가 다음 pickup 시 skip
|
||||
- `legacy-import.worker.spec.ts`
|
||||
- `importSingleMatch`: 이미 있는 riotMatchId → totalSkippedDuplicate++
|
||||
- 외부 매치 (우리 멤버 0명) → import 안 됨 + 에러 카운트 X
|
||||
- 우리 멤버 1명만 + 외부 9명 → 정상 import (휴리스틱 X 라 통과)
|
||||
- team mapping: team100 우리 3명 vs team200 우리 0명 → team100=blue
|
||||
- `match-builder.util.spec.ts`
|
||||
- `buildGameResult` (Tournament-Result `computeGameResult` 재사용 검증)
|
||||
- `buildTeams`: 우리 멤버 puuid → userId 매핑, 외부 puuid 는 teams 에서 제외
|
||||
- `match.service.spec.ts`
|
||||
- `delete(matchId)`: 매치 삭제 + cache invalidate 호출 확인
|
||||
|
||||
---
|
||||
|
||||
## 8. Rollout
|
||||
|
||||
1. (PR-1) `Match` 스키마 확장 (legacy 필드 + 인덱스) + `LegacyImportJob` 컬렉션 + 모델 등록
|
||||
2. (PR-2) `match-builder.util.ts` (선행 plan `computeGameResult` 재사용 wrapping) + 단위 테스트
|
||||
3. (PR-3) `LegacyImportService.enqueue / cancel / status` + parent job + sub-job 분할
|
||||
4. (PR-4) `LegacyImportWorker` (worker dispatch + `importSingleMatch`) + 단위 테스트
|
||||
5. (PR-5) `DELETE /matches/:id` 엔드포인트 + community-stats cache invalidate 통합
|
||||
6. (PR-6) admin 트리거 페이지 (`LegacyImportPage`) — 윈도우 폼 + ETA 표시 + 진행률 polling
|
||||
7. (PR-7) admin cleanup 페이지 (`LegacyMatchesPage`) — 매치 목록 + bulk 삭제
|
||||
8. (PR-8) 운영 모니터링 (job 진행률 / 멤버당 처리 시간 / 외부 매치 비율 로그)
|
||||
9. (Phase 후속) 자동 주기 재실행 (월 1회 등) — 1차에선 manual only
|
||||
|
||||
---
|
||||
|
||||
## 9. 추가 고려사항
|
||||
|
||||
### 확정 (사용자 결정 2026-04-27)
|
||||
|
||||
- **검색 시작일 2024-05-01**, 종료일 멤버 활성/비활성 따라 자동
|
||||
- **멤버별 startTime override**: admin UI 에서 자동 채움 + 수정 가능
|
||||
- **임계값 필터 X**: 검색된 모든 매치 import (외부 매치도 포함)
|
||||
- **시리즈 묶음 X**: 1 match-v5 = 1 Match, gameCount=1
|
||||
- **사후 cleanup**: admin UI 에서 단일/bulk 삭제
|
||||
- **idempotent**: 같은 riotMatchId 두 번 import 안 됨
|
||||
|
||||
### 권장 (운영 후 확인)
|
||||
|
||||
1. **외부 매치 비율 로그** — `team100MembersInOurs + team200MembersInOurs` 별 분포를 import job 끝에 통계로 남기기. 운영자가 cleanup 우선순위 잡기 좋음.
|
||||
2. **백필 매치의 title 컨벤션** — `[Legacy] 2024-08-15` 형식. 운영자가 cleanup 페이지에서 한눈에 식별.
|
||||
3. **DELETE /matches/:id 가드** — `legacyImported=true` 외 일반 매치 삭제는 무서운 작업. 일반 매치 삭제 시 추가 확인 모달 또는 별도 엔드포인트로 분리.
|
||||
4. **백필 매치의 participants snapshot** — `Match.participants[]` 는 보통 매치 신청 단계에서 채워지지만, legacy 라 신청 흐름이 없음. detail.info.participants 에서 우리 멤버만 추출해 채움. preferredPositions / tier 는 비움 (필수 아님 가정).
|
||||
5. **mapId 결정** — `detail.info.mapId` 가 11(소협) 외 다른 값일 수 있음. 그대로 저장. 통계 페이지에서 mapId 필터로 분리 가능.
|
||||
6. **시간대 권장** — admin UI 에 "야간 배치 권장" 안내 + 큐가 비어있는 시간대 표시 (Phase 후속).
|
||||
7. **에러 매치 격리** — `LegacyImportJob.errors[]` 에 puuid+matchId+reason 보관. admin UI 에서 재시도 버튼.
|
||||
8. **선행 plan 의 결과 수집 워커와의 충돌** — legacy import 가 만든 Match 는 `tournamentCodeIds=[]` 라 결과 수집 워커 (`maybeAdvanceMatch`) 가 트리거되지 않음. 자연 분리.
|
||||
|
||||
### 추후 (Phase 후속)
|
||||
|
||||
- 자동 주기 재실행 (월 1회 cron)
|
||||
- 외부 매치 자동 분류 / 분리 (예: 멤버 ≥ 4명 = 우리 내전, < 4명 = 외부) 옵션 — UI 토글
|
||||
- legacy 매치도 stateful-stirring-moler.md 의 community 통계 페이지에 자동 포함됨 (별도 분기 필요 없음 — `result.games[]` 형태가 같음)
|
||||
|
||||
---
|
||||
|
||||
## 10. Done 정의
|
||||
|
||||
- `Match.legacyImported` + `Match.legacyImportSource` + `LegacyImportJob` 컬렉션 + 인덱스 추가
|
||||
- admin 이 `LegacyImportPage` 에서 윈도우/멤버 override 입력 후 트리거 → ETA 토스트 + 진행률 polling
|
||||
- worker 가 멤버별 `type=tourney` list + detail 페치 → Match 도큐먼트 생성, `result.games[0]` 채워짐
|
||||
- 같은 매치 두 번 import 안 됨 (Garnet 락 + Match application 검사)
|
||||
- 우리 멤버 0명 매치는 자동 skip (외부 매치 가드)
|
||||
- import job 진행률 / 발견 / import / 중복 / 에러 카운트 정확
|
||||
- admin 이 `LegacyMatchesPage` 에서 잘못된 매치 단일/bulk 삭제 가능, 삭제 시 community-stats 캐시 invalidate
|
||||
- 동일 cid 에 대한 동시 import 트리거 거부 (Garnet 락)
|
||||
- cancel 동작
|
||||
- Riot 429 0건 (글로벌 throttle 통과)
|
||||
- 단위 테스트 통과
|
||||
- legacy 매치가 `stateful-stirring-moler.md` 의 community 통계 페이지에 자동 포함됨
|
||||
@@ -0,0 +1,114 @@
|
||||
# LOLYMPUS
|
||||
|
||||

|
||||
|
||||
## Overview
|
||||
|
||||
LOLYMPUS는 리그 오브 레전드 내전을 운영할 때 필요한 것들을 한곳에 모아둔 웹 애플리케이션입니다.
|
||||
|
||||
참가자 모집, 팀 편성, 경매, 토너먼트 코드 배정, 경기 결과 수집, 전적 확인처럼 운영자가 매번 손으로 챙기던 일을 줄이는 데 초점을 맞췄습니다. 처음부터 큰 서비스로 만들었다기보다는, 실제 커뮤니티 내전을 굴리면서 불편했던 부분을 하나씩 붙여가며 만든 프로젝트입니다.
|
||||
|
||||
## Purpose
|
||||
|
||||
내전은 사람만 모이면 끝나는 일이 아니었습니다. 참가자 티어를 확인하고, 포지션을 맞추고, 팀장을 정하고, 경기마다 토너먼트 코드를 나눠주고, 끝난 뒤 결과까지 정리해야 했습니다.
|
||||
|
||||
이 프로젝트는 그 흐름을 최대한 덜 번거롭게 만들기 위해 시작했습니다. 운영자는 전체 진행 상황을 보고, 참가자는 본인이 속한 팀과 다음 경기를 빠르게 확인할 수 있도록 구성했습니다.
|
||||
|
||||
## Screens
|
||||
|
||||
### Match detail
|
||||
|
||||

|
||||
|
||||
### Team progress
|
||||
|
||||

|
||||
|
||||
## Functionalities
|
||||
|
||||
**1. 내전 관리**
|
||||
내전 생성, 수정, 모집 상태 변경, 참가자 목록 확인을 할 수 있습니다.
|
||||
|
||||
**2. 참가자 정보 관리**
|
||||
Riot 계정 정보를 기반으로 소환사명, 태그, 프로필 아이콘, 솔로랭크/자유랭크 티어, 선호 포지션을 보여줍니다.
|
||||
|
||||
**3. 팀 빌딩**
|
||||
팀장을 정하고 포지션을 맞춰 팀을 구성합니다. 여러 팀이 참여하는 내전도 처리할 수 있습니다.
|
||||
|
||||
**4. 경매 진행**
|
||||
팀장 경매 방식으로 참가자를 뽑을 수 있고, 현재 입찰가와 낙찰 기록을 관리합니다.
|
||||
|
||||
**5. 토너먼트 코드 관리**
|
||||
업로드한 토너먼트 코드를 경기별로 배정하고, 팀별 진행 페이지에서 바로 복사할 수 있게 했습니다.
|
||||
|
||||
**6. 팀별 진행 페이지**
|
||||
각 팀이 자기 경기 일정, 상대 팀, 토너먼트 코드, 종료된 경기 결과를 한 화면에서 확인할 수 있습니다.
|
||||
|
||||
**7. 전적 수집과 통계**
|
||||
Riot Match-V5 데이터를 이용해 내전 결과를 수집하고, 개인 전적과 커뮤니티 리더보드를 보여줍니다.
|
||||
|
||||
**8. 커뮤니티 명령 연동**
|
||||
Dakao/NATS 기반 명령을 받아 참가 신청이나 운영 흐름과 연결할 수 있도록 구성했습니다.
|
||||
|
||||
## Used technologies
|
||||
|
||||
- React
|
||||
- Vite
|
||||
- TypeScript
|
||||
- TanStack Query
|
||||
- NestJS
|
||||
- MongoDB
|
||||
- Redis/Garnet
|
||||
- NATS
|
||||
- Riot API
|
||||
- pnpm workspace
|
||||
|
||||
## Project structure
|
||||
|
||||
```text
|
||||
apps/
|
||||
api/ NestJS API server
|
||||
web/ React + Vite client
|
||||
scripts/ deployment and maintenance scripts
|
||||
```
|
||||
|
||||
## How to run
|
||||
|
||||
```bash
|
||||
pnpm install
|
||||
pnpm start:api:dev
|
||||
pnpm dev:web
|
||||
```
|
||||
|
||||
웹 앱은 기본적으로 `apps/web/.env.development` 값을 사용합니다. API 환경값은 `apps/project.env`와 실행 환경의 시크릿 설정을 같이 확인합니다.
|
||||
|
||||
## Checks
|
||||
|
||||
```bash
|
||||
pnpm --filter api test
|
||||
pnpm --filter web build:staging
|
||||
```
|
||||
|
||||
현재 정리된 기준으로 API 테스트와 웹 테스트 빌드를 통과합니다.
|
||||
|
||||
## Deployment branches
|
||||
|
||||
`main`은 항상 배포 가능한 trunk로 유지하고 dev 배포 기준으로 사용합니다.
|
||||
빌드 번호는 `BUILD_NUMBER` 파일에서 1씩 증가시키며, 현재 시작 번호는 `66`입니다.
|
||||
staging 검증이 필요할 때는 `release/66` 같은 임시 브랜치를 만들고,
|
||||
검증이 끝나면 삭제합니다.
|
||||
|
||||
```bash
|
||||
git push origin main:release/66
|
||||
pnpm deploy:web:staging
|
||||
```
|
||||
|
||||
staging/prod Pages 배포 스크립트는 명시 릴리즈 브랜치 환경변수가 있으면 그
|
||||
값을 사용하고, 없으면 최신 `release/*` 브랜치를 자동으로 선택합니다. 최신
|
||||
기준은 브랜치가 가리키는 커밋 시각이며, 동률이면 브랜치명 내림차순입니다.
|
||||
staging은 선택된 릴리즈 브랜치로 preview 배포를 만들고, prod는 Cloudflare
|
||||
Pages production branch로 업로드해 production 배포를 만듭니다.
|
||||
|
||||
명시 릴리즈 브랜치는 staging은 `CF_PAGES_STAGING_BRANCH`, prod는
|
||||
`CF_PAGES_RELEASE_BRANCH`로 지정합니다. Cloudflare Pages production branch가
|
||||
`main`이 아니면 `CF_PAGES_PRODUCTION_BRANCH`로 지정합니다.
|
||||
@@ -1,628 +0,0 @@
|
||||
# 소환사 전적 페이지 플랜
|
||||
|
||||
> **대상**: codex 가 이어서 작업 가능한 수준의 실행 플랜
|
||||
> **레포**: `/Users/dahyeon/source/lolympus-tournament-support` (pnpm workspace)
|
||||
> **작성 기준**: 2026-04-26
|
||||
> **선행 작업**: `Riot-최근경기-플랜.md` (Throttle / RecentMatches / Scheduler / 시즌·region 인프라) 가 깔려 있어야 함.
|
||||
> **참고 이미지**: `user-game-history/statistics.png`, `123123.png` (poro.gg 스타일 매치 카드)
|
||||
|
||||
---
|
||||
|
||||
## 1. Context
|
||||
|
||||
`AuctionPage.tsx`, `MatchDetailPage.tsx` 에서 소환사 프로필 클릭 → 신규 **개인 전적 페이지** 로 이동.
|
||||
|
||||
핵심 정책 (사용자 결정 2026-04-26):
|
||||
|
||||
1. **서버 가진 데이터만 표시.** 페이지 진입 시 Riot API 호출 0회. 야간 prefetch + 명시적 "갱신" 버튼 만 enrichment 트리거.
|
||||
2. 즉각 갱신은 **전역 Riot API 작업 큐** 에 enqueue → consumer 가 throttle 통과시키며 직렬 처리. UI 는 "예상 ~초 후 갱신" 피드백.
|
||||
3. 시즌 history 는 추후 구현. 다만 **schema/응답에 seasonId 자리** 미리 마련.
|
||||
|
||||
표시 항목:
|
||||
- **챔피언 통계** (`statistics.png`): 큐 탭 / 랭크 필터 / 시즌 필터 / 정렬 가능 표
|
||||
- **최근 전적** (`123123.png`, poro.gg 스타일): win/lose 좌측 라벨 · 챔프+룬+소주 · KDA · CS · KP% · 양 팀 5명 미니 · 펼치기 시 상세
|
||||
|
||||
---
|
||||
|
||||
## 2. 설계
|
||||
|
||||
### 2.1 라우팅 / 트리거
|
||||
|
||||
- 신규 라우트: `/users/:userId/history`
|
||||
- query param: `?queue=summoners-rift&rank=solo&season=current`
|
||||
- 클릭 트리거: AuctionPage TeamPanel 멤버 row, PlayerSpotlight 헤더, MatchDetailPage ParticipantRow — **소환사명+아이콘 묶음만** Link (행 전체 X — 입찰 버튼 충돌)
|
||||
- ACL 없음 (외부 공유 OK — 선행 결정)
|
||||
|
||||
### 2.2 큐 매핑
|
||||
|
||||
```ts
|
||||
// apps/web/src/lib/riot-queue.ts (신규) + apps/api/src/modules/riot/riot-queue.constants.ts (신규)
|
||||
export const RIOT_QUEUE_GROUPS = {
|
||||
'summoners-rift': {
|
||||
label: '소환사의 협곡',
|
||||
queues: { all: [400, 420, 430, 440], solo: [420], flex: [440], normal: [400, 430] },
|
||||
},
|
||||
'aram': { label: '칼바람 나락', queues: { all: [450], solo: [], flex: [], normal: [450] } },
|
||||
'urf': { label: '우르프', queues: { all: [900, 1900], solo: [], flex: [], normal: [900, 1900] } },
|
||||
'arena': { label: '아레나', queues: { all: [1700, 1710], solo: [], flex: [], normal: [1700, 1710] } },
|
||||
} as const;
|
||||
```
|
||||
|
||||
`랭크 전체 = solo ∪ flex`. `일반 = 400/430`. queueId 는 [queues.json](https://static.developer.riotgames.com/docs/lol/queues.json) 1차 기준 — §6.B 검증.
|
||||
|
||||
### 2.3 enrichment 정책 — server-only + on-demand 큐잉
|
||||
|
||||
페이지 진입 시 **API 호출 0**. 다음 두 경로로만 데이터가 채워짐:
|
||||
|
||||
| 경로 | 트리거 | 우선순위 |
|
||||
|---|---|---|
|
||||
| 야간 prefetch (선행 plan §3.8) | 03~07시 KST | low |
|
||||
| 사용자 "갱신" 버튼 | 명시적 클릭 | high |
|
||||
| 신규 RiotAccount 등록 | dakao 명령 | high (동기 — 큐 우회) |
|
||||
|
||||
→ **서버 데이터만** 보여줌. 큐 미사용 데이터(예: 첫 방문 사용자, 한 번도 prefetch 안 된 큐) 는 빈 상태 placeholder + "갱신" 버튼 강조.
|
||||
|
||||
#### schema 확장
|
||||
|
||||
```ts
|
||||
// RiotAccount 에 추가
|
||||
matchIdsByQueueFetchedAt?: Map<number, Date>; // 큐별 마지막 list 페치 시각
|
||||
lastRefreshRequestedAt?: Date; // refresh budget 추적
|
||||
```
|
||||
|
||||
### 2.4 전역 Riot API 작업 큐 (핵심)
|
||||
|
||||
#### 왜 Redis Stream (Garnet)
|
||||
|
||||
NATS JetStream 과 비교 검토 결과 **Redis Stream 채택**:
|
||||
|
||||
| 항목 | Redis Stream (Garnet) | NATS JetStream |
|
||||
|---|---|---|
|
||||
| 추가 셋업 | **0** (이미 사용 중) | stream/consumer 활성화 필요 |
|
||||
| 클라이언트 코드 | `garnet.ts` 의 `xAdd/xReadGroup/xAck/xPending/xClaim` wrapping 재사용 | 신규 작성 |
|
||||
| ack / redelivery | PEL + `xClaim` 기본 | 기본 |
|
||||
| consumer group | 지원 | 지원 |
|
||||
| 운영 부담 | Redis 모니터링만 | NATS + JetStream 둘 다 |
|
||||
|
||||
→ 단일 작업 종류 + 우선순위 2단계 + dedup 워크로드에 Redis Stream 충분. 우리 `GarnetClient` 의 stream 메서드 그대로 활용.
|
||||
|
||||
#### 스트림 구조
|
||||
|
||||
```
|
||||
stream: riot:queue:high # 사용자 갱신 요청
|
||||
stream: riot:queue:low # 야간 prefetch
|
||||
consumer group: riot-refresh-worker (양 stream 공통)
|
||||
```
|
||||
|
||||
- **우선순위 = stream 분리**. worker 한 사이클에서 high `xReadGroup` 먼저 → 비면 low `xReadGroup` (BLOCK 1s).
|
||||
- **단일 active worker 인스턴스**. rate limit 자체가 글로벌 직렬화라 분산해도 의미 없음. Garnet `setStringIfAbsent('riot:worker:leader', ..., 60s)` 로 leader election, leader 만 loop. lease 갱신은 worker tick 마다.
|
||||
- **PEL/xClaim 으로 crash recovery**: leader 가 죽으면 30분 idle 후 새 leader 가 PEL 메시지 claim → 재처리.
|
||||
|
||||
#### 작업 단위 — sub-job 분할 (큐 그룹별 1 job)
|
||||
|
||||
사용자가 `queueGroup='all'` 같은 다중 큐를 요청해도 **백엔드가 큐 그룹 단위로 sub-job 으로 쪼개 enqueue**. 이유:
|
||||
|
||||
- 한 사용자 갱신이 큐를 길게 점유하지 않음 → fairness 향상
|
||||
- 큐 그룹 1개 끝나는 즉시 부분 결과 표시 가능 (소협 끝 → 소협 데이터부터 보임)
|
||||
- ETA 표시가 자연스러움 ("소협 12초 / 칼바람 8초 / ... 합 36초")
|
||||
|
||||
```ts
|
||||
interface RefreshSubJob {
|
||||
jobId: string; // uuid
|
||||
parentJobId?: string; // 그룹 묶음 식별 (UI 진행률 합산용)
|
||||
userId: string;
|
||||
puuid: string;
|
||||
region: RiotRegionalRoute;
|
||||
platform: RiotPlatformRoute;
|
||||
queueGroup: keyof typeof RIOT_QUEUE_GROUPS; // 'summoners-rift' 등
|
||||
queueIds: number[]; // 그룹 내 모든 큐
|
||||
requestedAt: number;
|
||||
requestedBy?: string;
|
||||
priority: 'high' | 'low';
|
||||
}
|
||||
```
|
||||
|
||||
dedup 키:
|
||||
- `riot:job:dedup:<puuid>:<queueGroup>` NX EX 5분
|
||||
- 이미 있으면 기존 jobId 반환, 새 enqueue 안 함
|
||||
|
||||
#### 신규 모듈
|
||||
|
||||
```
|
||||
apps/api/src/modules/riot-job-queue/
|
||||
riot-job-queue.module.ts
|
||||
riot-job-queue.service.ts # enqueue / dedup / status / ETA / parent 그룹
|
||||
riot-job-worker.service.ts # leader election + xReadGroup loop
|
||||
riot-job-queue.types.ts
|
||||
riot-job-queue.controller.ts # GET /riot/jobs/:jobId, /riot/jobs/stats
|
||||
```
|
||||
|
||||
`RiotJobQueueService.enqueueRefresh(params: { puuid, userId, queueGroups: string[], priority, ... }): Promise<EnqueueResult>`
|
||||
- 입력 큐 그룹별 sub-job 생성
|
||||
- 각 sub-job dedup → 기존 또는 신규 publish (`xAdd`)
|
||||
- 응답:
|
||||
```ts
|
||||
interface EnqueueResult {
|
||||
parentJobId: string;
|
||||
subJobs: { jobId: string; queueGroup: string; alreadyQueued: boolean; etaSeconds: number; queuePosition: number }[];
|
||||
totalEtaSeconds: number;
|
||||
}
|
||||
```
|
||||
|
||||
`RiotJobQueueService.getStatus(jobId): Promise<JobStatus>`
|
||||
- Garnet `riot:job:status:<jobId>` (state, enqueuedAt, startedAt, finishedAt, error, etaSeconds)
|
||||
|
||||
`RiotJobQueueService.getParentStatus(parentJobId): Promise<ParentStatus>`
|
||||
- 모든 sub-job 합쳐서 진행률 (`done / total`) + 남은 ETA 계산
|
||||
|
||||
`RiotJobWorkerService`:
|
||||
- leader 만 동작. follower 는 lease 만 polling.
|
||||
- pseudo:
|
||||
```ts
|
||||
while (alive) {
|
||||
const msg = await garnet.readGroup('riot:queue:high', GROUP, consumer, '>', { count: 1, blockMs: 100 });
|
||||
const target = msg ?? await garnet.readGroup('riot:queue:low', GROUP, consumer, '>', { count: 1, blockMs: 1000 });
|
||||
if (!target) continue;
|
||||
await processSubJob(target); // ensureFreshForQueue + 그룹 페치 dedup
|
||||
await garnet.acknowledgeStream(stream, GROUP, target.id);
|
||||
await refreshLeaderLease();
|
||||
}
|
||||
```
|
||||
- 작업 시작 → 끝 까지 RiotClientService 가 throttle 통과. 별도 sleep 없음.
|
||||
- 완료/실패 시 status 업데이트 + Garnet pub `riot:refresh:events` 채널 publish → socket.io 게이트가 broadcast (§2.5.2 참고).
|
||||
- EWMA 로 평균 작업 시간 갱신 (key: `riot:job:avg-seconds`).
|
||||
|
||||
#### 운영자 controls
|
||||
|
||||
- `GET /riot/jobs/stats` — high/low 큐 길이, 평균 처리 시간, 최근 실패율, 현재 leader instance id
|
||||
- `POST /riot/jobs/drain` (admin) — 큐 비우기
|
||||
|
||||
### 2.5 UX 피드백 — 채택 정책 (사용자 결정)
|
||||
|
||||
세 가지 권장안 모두 채택: **(1) Stale-while-revalidate + (2) Refresh broadcast + (3) 그룹 페치 dedup**.
|
||||
|
||||
#### 2.5.1 Stale-while-revalidate
|
||||
|
||||
- 페이지 진입 시 서버 데이터 **즉시 표시** (Riot API 호출 0).
|
||||
- 동시에 백그라운드로 `enqueueRefresh({puuid, queueGroups: [현재 탭], priority: 'low', requestedBy: 'page-view'})` 자동 호출 — refresh budget 통과 시에만.
|
||||
- 사용자가 "갱신" 버튼을 누르면 동일 enqueue 를 `priority: 'high'` 로 재발행 (dedup 으로 중복 방지, 단 priority 격상).
|
||||
- 결과 도착 시 broadcast 로 자동 reload (§2.5.2).
|
||||
|
||||
→ 사용자가 갱신을 의식하지 않아도 자연 신선화. 명시적 클릭은 "지금 당장 + high 우선순위" 의미.
|
||||
|
||||
#### 2.5.2 Refresh broadcast (socket.io)
|
||||
|
||||
- 기존 `useAuctionSocket` 패턴 재활용. 신규 namespace `/riot-refresh` 또는 같은 socket 의 `riot-refresh` event.
|
||||
- 클라가 페이지 진입 시 `subscribe('puuid:<puuid>')` join.
|
||||
- worker 가 sub-job 완료 시 `emit('riot-refresh', { parentJobId, jobId, queueGroup, puuid, state })` broadcast.
|
||||
- 같은 puuid 페이지를 보는 **모든 클라**가 React Query invalidate → 자동 reload.
|
||||
- per-queue-group 단위 invalidate 라 부분 결과 점진 표시 가능 (소협 끝 → 소협 표/카드만 reload).
|
||||
|
||||
#### 2.5.3 그룹 페치 dedup
|
||||
|
||||
- worker 가 sub-job (puuid, queueGroup) 처리 시:
|
||||
1. `RiotRecentMatchesService.ensureFreshForQueue` 가 큐별 list call (그룹 N큐 면 N call)
|
||||
2. **detail call 은 그룹 내 모든 큐의 matchId 합집합에서 RiotMatch 미존재분만** 페치 — 큐 사이 중복 매치 dedup
|
||||
3. 같은 puuid 의 이미 처리된 sub-job(같은 parentJobId) 이 동일 detail 을 가져왔으면 skip
|
||||
- 4개 그룹 동시 갱신 시 detail 호출량 ~30% 감소 추정.
|
||||
|
||||
#### 2.5.4 "갱신" 클릭 흐름
|
||||
|
||||
```
|
||||
[갱신 버튼] 클릭
|
||||
│
|
||||
├─→ POST /communities/:cid/users/:uid/refresh
|
||||
│ body: { queueGroups: ['summoners-rift', ...], priority: 'high' }
|
||||
│ resp: { parentJobId, subJobs: [{jobId, queueGroup, etaSeconds, queuePosition, alreadyQueued}], totalEtaSeconds }
|
||||
│
|
||||
├─→ 즉시 토스트: "갱신을 요청했어요. 약 36초 후 반영됩니다 (대기열 4번째)"
|
||||
│ - alreadyQueued 면 "이미 요청 중입니다 (남은 시간 ~)"
|
||||
│
|
||||
├─→ socket.io 'riot-refresh' subscribe (parentJobId/puuid 필터)
|
||||
│ - sub-job 완료 도착마다 해당 큐 그룹 React Query invalidate
|
||||
│
|
||||
└─→ 모든 sub-job 완료 시 토스트 "갱신 완료"
|
||||
실패 시 토스트: "갱신 실패: <reason>. 잠시 후 다시 시도해 주세요."
|
||||
```
|
||||
|
||||
#### 2.5.5 Refresh budget — 폭주 방지
|
||||
|
||||
- 사용자당 **5분에 1회** (`RiotAccount.lastRefreshRequestedAt` 검사). 단, page-view 로 자동 enqueue 된 low priority 는 별도 카운터 (사용자당 1시간 1회).
|
||||
- 글로벌 high 큐 길이가 50 초과면 새 high enqueue 거부 (`429 { reason: 'queue-full', retryAfterSeconds }`)
|
||||
- IP 단위 rate limit 은 Phase 후속.
|
||||
|
||||
#### 2.5.6 빈 데이터 placeholder
|
||||
|
||||
- 챔피언 통계 0 행: "아직 수집된 매치가 없습니다. [갱신 요청] 을 눌러 가져오세요." (Stale-while-revalidate 가 이미 백그라운드로 fetch 중이면 "갱신 중..." 으로 자동 변경)
|
||||
- 최근 전적 0 건: 동일.
|
||||
- 마지막 갱신 시각 항상 표시: "마지막 업데이트: 3시간 전"
|
||||
|
||||
### 2.6 시즌 정책 (history 추후 구현, 설계 고려)
|
||||
|
||||
#### 현재
|
||||
|
||||
- `Community.seasonStartedAt: Date?` (선행 plan) — 단일 시즌 경계.
|
||||
|
||||
#### 미래 호환 schema 자리 (지금 추가)
|
||||
|
||||
```ts
|
||||
// schema.ts Community
|
||||
seasons?: Array<{
|
||||
id: string; // ex: '2026-split-1'
|
||||
label: string; // ex: '2026 시즌'
|
||||
startedAt: Date;
|
||||
endedAt?: Date;
|
||||
}>;
|
||||
// 'current' 시즌 = endedAt 없는 마지막 entry
|
||||
```
|
||||
|
||||
본 plan 1차에서는 `seasons` 미사용, 응답에 `seasonId: 'current' | string` 만 노출. 추후 history 도입 시 dropdown 만 채우면 됨.
|
||||
|
||||
#### API 응답에 미리 자리 잡기
|
||||
|
||||
```ts
|
||||
interface ChampionStatsResponse {
|
||||
// ...
|
||||
season: { id: string; label: string; startedAt: string | null; endedAt: string | null };
|
||||
}
|
||||
```
|
||||
|
||||
→ 클라 dropdown 이 `[{id: 'current', label: '현재 시즌'}]` 한 개만 받지만 구조는 list. 추후 backend 가 history 풀 때 client 코드 무수정.
|
||||
|
||||
### 2.7 백엔드 aggregate API
|
||||
|
||||
#### A. 챔피언 통계
|
||||
|
||||
```
|
||||
GET /communities/:cid/users/:uid/champion-stats
|
||||
?queueGroup=summoners-rift
|
||||
&rank=solo|flex|all|normal
|
||||
&seasonId=current (현재 'current' 만)
|
||||
```
|
||||
|
||||
응답:
|
||||
```ts
|
||||
interface ChampionStatsResponse {
|
||||
queueIds: number[];
|
||||
season: { id: 'current' | string; label: string; startedAt: string | null; endedAt: string | null };
|
||||
lastFetchedAt: string | null; // 큐별 fetchedAt 중 가장 오래된 값
|
||||
champions: ChampionStatsRow[];
|
||||
totals: ChampionStatsRow;
|
||||
}
|
||||
|
||||
interface ChampionStatsRow {
|
||||
championId: number;
|
||||
games: number; wins: number; losses: number; winRate: number;
|
||||
avgKills: number; avgDeaths: number; avgAssists: number; kda: number;
|
||||
totalKills: number; totalDeaths: number; totalAssists: number;
|
||||
doubleKills: number; tripleKills: number; quadraKills: number; pentaKills: number;
|
||||
avgCs: number; avgCsPerMin: number;
|
||||
}
|
||||
```
|
||||
|
||||
집계: MongoDB aggregation pipeline. `$match: {participantPuuids, queueId: {$in}, gameCreation: {$gte: seasonStartedAt}}` → `$project participant slice` → `$group by championId`.
|
||||
|
||||
캐시: Garnet `riot:champstats:<puuid>:<queueGroup>:<rank>:<seasonId>` TTL 1h.
|
||||
|
||||
#### B. 최근 전적 (페이지네이션) — poro.gg 카드
|
||||
|
||||
`poro.gg-html.txt` 분석 기준 카드 항목:
|
||||
|
||||
- 좌측 라벨: `승리 / 패배 / 다시 둠(remake)` + 큐 종류 ("자유 랭크") + 날짜 ("4월 19일") + 게임 시간 ("28:52")
|
||||
- 챔피언 아이콘(52px) + 챔피언 레벨 + 룬 키스톤 + 부 룬 스타일 + 소환사 주문 2개
|
||||
- KDA 큰 숫자 ("4 / 14 / 6") + **평점** ("0.71 평점")
|
||||
- 우측 통계 컬럼: **킬 관여 %** + **CS** (분당 CS 병기) + **시야점수** + (제어와드 / 와드 설치 / 와드 파괴 아이콘 + 숫자)
|
||||
- 아이템 6칸 + 트링킷 1칸
|
||||
- **자주 함께한 챔피언 / 자주 함께한 소환사** 2열 (각 5명, 미니 챔피언 14px + 소환사명)
|
||||
- 우측 토글 버튼 "매치 상세 정보 열기"
|
||||
|
||||
```
|
||||
GET /communities/:cid/users/:uid/recent-matches
|
||||
?queueGroup=summoners-rift
|
||||
&rank=all
|
||||
&championId=84 (선택, 챔피언 검색 필터)
|
||||
&limit=10
|
||||
&cursor=<gameCreation>
|
||||
```
|
||||
|
||||
응답:
|
||||
```ts
|
||||
interface RecentMatchesResponse {
|
||||
matches: RecentMatchView[];
|
||||
nextCursor: number | null;
|
||||
lastFetchedAt: string | null;
|
||||
season: { id: string; label: string; startedAt: string | null; endedAt: string | null };
|
||||
}
|
||||
|
||||
interface RecentMatchView {
|
||||
matchId: string;
|
||||
queueId: number;
|
||||
queueLabel: string; // '자유 랭크' 등
|
||||
gameCreation: number;
|
||||
gameDuration: number; // 초
|
||||
win: boolean;
|
||||
remake: boolean; // gameEndedInEarlySurrender 또는 duration < 240s
|
||||
|
||||
// 본인 participant
|
||||
championId: number;
|
||||
championLevel: number;
|
||||
teamPosition: string; // 'TOP' | 'JUNGLE' | 'MIDDLE' | 'BOTTOM' | 'UTILITY' | ''
|
||||
|
||||
kills: number; deaths: number; assists: number;
|
||||
kda: number; // (k+a)/d, deaths=0 이면 (k+a)
|
||||
rating: number; // 평점 — § 2.7.B.1 산식
|
||||
|
||||
totalCs: number; // totalMinionsKilled + neutralMinionsKilled
|
||||
csPerMin: number;
|
||||
killParticipation: number; // 0~100, 본인 (k+a) / 팀 총킬
|
||||
visionScore: number;
|
||||
controlWardsBought: number; // visionWardsBoughtInGame
|
||||
wardsPlaced: number;
|
||||
wardsKilled: number;
|
||||
damageDealtToChampions: number;
|
||||
damageTaken: number;
|
||||
goldEarned: number;
|
||||
|
||||
items: number[]; // 6칸 (item0~5)
|
||||
trinket: number; // item6
|
||||
summonerSpells: [number, number]; // summoner1Id, summoner2Id
|
||||
perks: { primaryStyle?: number; subStyle?: number; keystone?: number };
|
||||
|
||||
// 양 팀 5명씩 미니 (poro.gg 우측 두 컬럼)
|
||||
teams: Array<{
|
||||
side: 100 | 200;
|
||||
win: boolean;
|
||||
objectives?: { baron?: number; dragon?: number; tower?: number };
|
||||
participants: Array<{
|
||||
puuid: string;
|
||||
gameName: string;
|
||||
tagLine: string;
|
||||
championId: number;
|
||||
teamPosition: string;
|
||||
kills: number; deaths: number; assists: number;
|
||||
}>;
|
||||
}>;
|
||||
}
|
||||
```
|
||||
|
||||
##### 2.7.B.1 평점 (rating) 산식
|
||||
|
||||
poro.gg/op.gg 의 정확한 산식은 비공개. 1차 근사:
|
||||
```
|
||||
rating = 0.4 * normalize(kda) // KDA 기여
|
||||
+ 0.2 * normalize(killParticipation)
|
||||
+ 0.2 * normalize(csPerMin)
|
||||
+ 0.1 * normalize(damageShare) // damage / 팀 총damage
|
||||
+ 0.1 * normalize(visionScore) // jungle/support 가중
|
||||
```
|
||||
- normalize 는 라인별 평균 대비 z-score → 0~10 사이 클램프
|
||||
- "Perfect" = deaths === 0 일 때 최대값 표시 (poro.gg 동일)
|
||||
- 정확한 산식은 Phase 후속에서 운영자 캘리브레이션
|
||||
|
||||
#### B'. 최근 N게임 요약 박스 (poro.gg 헤더)
|
||||
|
||||
이미지 상단의 "최근 20게임 전적 요약" 박스 응답:
|
||||
|
||||
```
|
||||
GET /communities/:cid/users/:uid/recent-summary
|
||||
?queueGroup=summoners-rift
|
||||
&rank=all
|
||||
&championId=84 (선택, 검색 필터와 연동)
|
||||
&limit=20 (기본 20)
|
||||
```
|
||||
|
||||
```ts
|
||||
interface RecentSummaryResponse {
|
||||
windowSize: number; // 실제 사용된 매치 수 (≤ limit)
|
||||
winRate: number; wins: number; losses: number;
|
||||
streak: { type: 'win' | 'loss'; count: number }; // "2 연패"
|
||||
kda: number; // 총합 기준
|
||||
avgKills: number; avgDeaths: number; avgAssists: number;
|
||||
bestRating: { rating: number | 'Perfect'; kills: number; deaths: number; assists: number; matchId: string };
|
||||
positionRates: Partial<Record<RiotLane, number>>; // "비드 100%" 등 라인별 픽률
|
||||
topChampions: Array<{ // 자주 플레이하는 챔프 상위 3
|
||||
championId: number;
|
||||
games: number;
|
||||
winRate: number; // %
|
||||
pickRate: number; // 본 큐 그룹 내 비율 %
|
||||
avgRating: number;
|
||||
}>;
|
||||
lastFetchedAt: string | null;
|
||||
}
|
||||
```
|
||||
|
||||
서버 aggregate. Garnet 캐시 1h TTL. 키: `riot:recentsummary:<puuid>:<queueGroup>:<rank>:<championId|none>:<limit>`.
|
||||
|
||||
#### C. 갱신 요청
|
||||
|
||||
```
|
||||
POST /communities/:cid/users/:uid/refresh
|
||||
body: { queueGroups: string[], priority: 'high' | 'low' }
|
||||
응답: EnqueueResult (§2.4)
|
||||
또는 429 { reason: 'cooldown' | 'queue-full', retryAfterSeconds }
|
||||
```
|
||||
|
||||
#### D. 작업 상태
|
||||
|
||||
```
|
||||
GET /riot/jobs/:jobId
|
||||
응답: { state: 'queued' | 'processing' | 'completed' | 'failed',
|
||||
etaSeconds: number, enqueuedAt, startedAt, finishedAt, error? }
|
||||
```
|
||||
|
||||
### 2.8 인덱스 보강
|
||||
|
||||
`RiotMatch` schema 에 추가:
|
||||
- `{ participantPuuids: 1, queueId: 1, gameCreation: -1 }` (queue 필터 + 정렬)
|
||||
|
||||
---
|
||||
|
||||
## 3. 변경 사항 (파일 단위)
|
||||
|
||||
### 3.1 백엔드 신규
|
||||
|
||||
```
|
||||
apps/api/src/modules/riot/riot-queue.constants.ts
|
||||
apps/api/src/modules/riot-job-queue/
|
||||
riot-job-queue.module.ts
|
||||
riot-job-queue.service.ts
|
||||
riot-job-worker.service.ts
|
||||
riot-job-queue.types.ts
|
||||
riot-job-queue.controller.ts # GET /riot/jobs/:jobId, /riot/jobs/stats
|
||||
apps/api/src/modules/match-history/
|
||||
match-history.module.ts
|
||||
match-history.controller.ts # champion-stats, recent-matches, refresh
|
||||
match-history.service.ts
|
||||
match-history-cache.service.ts
|
||||
match-history.types.ts
|
||||
```
|
||||
|
||||
### 3.2 백엔드 수정
|
||||
|
||||
- `schema.ts`:
|
||||
- `RiotAccount.matchIdsByQueueFetchedAt: Map<number, Date>`
|
||||
- `RiotAccount.lastRefreshRequestedAt: Date`
|
||||
- `Community.seasons` (자리만)
|
||||
- `RiotMatch` 신규 인덱스
|
||||
- `riot-recent-matches.service.ts`:
|
||||
- `ensureFreshForQueue({puuid, queueId, ttlMs, limit})` — worker 가 호출
|
||||
- `RiotJobWorkerService` 가 `RiotRecentMatchesService.ensureFreshForQueue` 직접 호출
|
||||
- `app.module.ts`: `RiotJobQueueModule`, `MatchHistoryModule` import
|
||||
|
||||
### 3.3 프런트 신규
|
||||
|
||||
```
|
||||
apps/web/src/lib/riot-queue.ts
|
||||
apps/web/src/pages/UserHistoryPage.tsx
|
||||
apps/web/src/components/history/
|
||||
UserHistoryHeader.tsx # 프로필 + 마지막 갱신 + 갱신 버튼
|
||||
QueueTabs.tsx # 전체/솔로/자유/일반/칼바람/우르프/아레나
|
||||
RankFilter.tsx
|
||||
SeasonSelector.tsx # 'current' 1개만 — 미래 list 호환
|
||||
ChampionSearchFilter.tsx # 챔피언 검색 (한글 초성/별명 매칭) — 클라사이드 + ddragon manifest
|
||||
RecentSummaryBox.tsx # "최근 20게임 전적 요약" (승률/KDA/최고평점/포지션픽률/자주픽챔)
|
||||
ChampionStatsTable.tsx # 정렬 가능
|
||||
RecentMatchesList.tsx # useInfiniteQuery
|
||||
RecentMatchCard.tsx # poro.gg 스타일 (요약/펼치기)
|
||||
RecentMatchDetail.tsx # 펼친 상세 (양 팀 5명 풀 정보)
|
||||
RefreshButton.tsx # ETA 토스트 + socket invalidate
|
||||
EmptyState.tsx
|
||||
```
|
||||
|
||||
> 챔피언 검색: 한글/영문/초성/별명 매칭(가렌, ㄱㄹ, garen 등). ddragon manifest 의 `name` + 별명 사전(별도 정적 파일 `apps/web/src/lib/champion-aliases.ts`)으로 클라사이드 필터. 백엔드는 `championId` 만 받음.
|
||||
|
||||
### 3.4 프런트 수정
|
||||
|
||||
- `App.tsx`: `<Route path="/users/:userId/history" element={<UserHistoryPage />} />`
|
||||
- `api/hooks.ts`: `useChampionStats`, `useRecentMatches` (`useInfiniteQuery`), `useRefreshAccount`, `useJobStatus`
|
||||
- `api/types.ts`: 응답 타입들
|
||||
- `AuctionPage.tsx`, `MatchDetailPage.tsx`: 소환사명+아이콘 묶음을 `<Link>`
|
||||
|
||||
### 3.5 socket.io 통합
|
||||
|
||||
기존 `useAuctionSocket` 패턴 재활용. 신규 namespace `/riot-refresh` 권장 (auction socket 분리):
|
||||
- 클라가 페이지 진입 시 `socket.emit('subscribe', { puuid })`
|
||||
- worker 가 sub-job 완료 시 `gateway.to(`puuid:${puuid}`).emit('riot-refresh', { parentJobId, jobId, queueGroup, state })`
|
||||
- 클라가 메시지 수신 시 해당 큐 그룹 React Query (`['champion-stats', puuid, queueGroup, ...]`, `['recent-matches', ...]`, `['recent-summary', ...]`) invalidate
|
||||
- 같은 puuid 페이지를 보는 모든 클라가 동시에 새로고침됨 (broadcast 효과)
|
||||
|
||||
---
|
||||
|
||||
## 4. 단위 테스트
|
||||
|
||||
- `riot-job-queue.service.spec.ts`
|
||||
- dedup: 같은 (puuid, queueIds) enqueue 시 동일 jobId 반환
|
||||
- ETA 계산: 큐 길이 × avg → seconds
|
||||
- refresh budget: 5분 안 재요청 시 429
|
||||
- `riot-job-worker.service.spec.ts`
|
||||
- high subject 우선 처리, high 비면 low fetch
|
||||
- throttle wait 시 작업 그대로 진행
|
||||
- `match-history.service.spec.ts`
|
||||
- queueGroup → queueIds 매핑
|
||||
- aggregate 결과 sums/avgs 정확
|
||||
- season 필터 적용 (gameCreation < startedAt 제외)
|
||||
- cursor 페이지네이션 nextCursor 정확
|
||||
- `match-history-cache.service.spec.ts`
|
||||
- 같은 키 두 번째 호출 aggregate 0회
|
||||
- 프런트
|
||||
- `RefreshButton` 토스트 ETA 문구
|
||||
- `ChampionStatsTable` 정렬 토글
|
||||
- `RecentMatchCard` win/lose 색상, remake 표시
|
||||
|
||||
---
|
||||
|
||||
## 5. Rollout
|
||||
|
||||
1. (PR-1) `riot-queue.constants.ts` + schema 확장 (`matchIdsByQueueFetchedAt`, `lastRefreshRequestedAt`, `Community.seasons` 자리, RiotMatch 인덱스 보강) + `ensureFreshForQueue`
|
||||
2. (PR-2) `RiotJobQueueModule` (Redis Stream consumer + leader election + dedup + sub-job 분할 + status) + 테스트
|
||||
3. (PR-3) `MatchHistoryModule` champion-stats + recent-summary + Garnet 캐시
|
||||
4. (PR-4) recent-matches + cursor 페이지네이션 + 평점 산식
|
||||
5. (PR-5) refresh 엔드포인트 + budget + socket `/riot-refresh` namespace
|
||||
6. (PR-6) 그룹 페치 dedup 로직 (worker 내부)
|
||||
7. (PR-7) 프런트 라우트 + `UserHistoryPage` 골격 + `QueueTabs` + `RankFilter` + `SeasonSelector`
|
||||
8. (PR-8) `RecentSummaryBox` + `ChampionStatsTable` (정렬)
|
||||
9. (PR-9) `RecentMatchCard` (poro.gg 스타일) + `RecentMatchDetail` 펼치기
|
||||
10. (PR-10) `ChampionSearchFilter` (별명 사전 + 초성 매칭)
|
||||
11. (PR-11) `RefreshButton` + Stale-while-revalidate 자동 enqueue + ETA 토스트 + socket invalidate
|
||||
12. (PR-12) AuctionPage / MatchDetailPage 클릭 트리거
|
||||
13. (PR-13) 운영 모니터링 (큐 길이 / aggregate 응답 시간 / Garnet hit / leader 상태)
|
||||
|
||||
---
|
||||
|
||||
## 6. 추가 고려사항
|
||||
|
||||
### 확정 (사용자 결정 2026-04-26)
|
||||
|
||||
- **서버 데이터만 표시**: 페이지 진입 시 Riot API 호출 0회
|
||||
- **전역 작업 큐**: **Redis Stream (Garnet)** — high/low stream 분리 + dedup + leader election + PEL/xClaim 재처리
|
||||
- **작업 단위**: queueGroup 단위 sub-job 분할 (한 사용자가 큐 길게 점유 X)
|
||||
- **UX 정책**: (1) Stale-while-revalidate + (2) Refresh broadcast + (3) 그룹 페치 dedup 모두 채택
|
||||
- **Refresh budget**: 5분당 1회 high, 1시간당 1회 low(자동)
|
||||
- **카드 스타일**: poro.gg (`poro.gg-html.txt` 분석 기준 — 평점/킬관여/시야/와드/자주함께한 챔피언·소환사 포함)
|
||||
- **챔피언 검색 필터**: 클라사이드 (한글/영문/초성/별명)
|
||||
- **시즌 history**: 본 plan 1차 미구현, schema/응답에 자리만 마련
|
||||
|
||||
### 미결 (가벼운 확인 권장)
|
||||
|
||||
#### A. 평점 산식 캘리브레이션
|
||||
|
||||
§2.7.B.1 의 1차 근사 가중치는 추측. 실제 사용자 데이터로 분포 확인 후 조정 필요. 운영 후 Phase 후속에서 처리.
|
||||
|
||||
#### B. 큐 매핑 검증
|
||||
|
||||
`RIOT_QUEUE_GROUPS` 의 큐 id 는 [queues.json](https://static.developer.riotgames.com/docs/lol/queues.json) 1차 추정. 운영 사용자 데이터로 검증 필요.
|
||||
|
||||
#### C. Refresh 폭주 시나리오
|
||||
|
||||
큐가 길 때 "현재 갱신 요청이 많습니다 (대기 12분)" 표시 + 야간 prefetch 안내. 너무 길면 갱신 자체를 비활성화.
|
||||
|
||||
#### D. socket.io 가드
|
||||
|
||||
`/riot-refresh` namespace 가 외부 공개라 puuid subscribe 가 무제한이면 broadcast 비대화 가능. 동일 socket 당 max subscribe 수 제한 (예: 5) 추가 권장.
|
||||
|
||||
### 추후 (Phase 후속)
|
||||
|
||||
- 시즌 history 본격 도입 (`Community.seasons` 활용 + dropdown)
|
||||
- 평점 산식 캘리브레이션
|
||||
- IP 단위 rate limit
|
||||
- admin 페이지 (큐 모니터링 / drain)
|
||||
- aggregation 결과 mat-view (큐가 매우 길어질 때)
|
||||
|
||||
---
|
||||
|
||||
## 7. Done 정의
|
||||
|
||||
- AuctionPage 멤버 / PlayerSpotlight, MatchDetailPage 참가자 소환사명 클릭 → `/users/:userId/history` 이동
|
||||
- 페이지에 큐 7탭(전체/솔로/자유/일반/칼바람/우르프/아레나) + 챔피언 검색 + 시즌 dropdown(현재 1개) + 최근 N게임 요약 박스 + 챔피언 통계 표 + 최근 전적 무한 스크롤(poro.gg 카드)
|
||||
- 페이지 진입 시 **Riot API 호출 0회** (서버 로그로 확인)
|
||||
- 페이지 진입 시 자동 백그라운드 enqueue (low priority) — 1시간 budget 안에서만
|
||||
- "갱신" 클릭 시 ETA 토스트 ("약 ~초 후 반영, 대기열 N번째") + sub-job 완료 도착마다 해당 큐 그룹 React Query invalidate (점진 표시)
|
||||
- 같은 puuid 페이지 보는 다른 클라도 socket broadcast 로 자동 reload
|
||||
- 같은 사용자 5분 안 high 재요청 시 429 cooldown
|
||||
- Redis Stream worker 1 인스턴스만 active (leader election 동작), 큐 길이/처리 시간 로그
|
||||
- 그룹 페치 dedup: 4개 큐 그룹 동시 갱신 시 detail 호출 중복 0건 (로그 metric)
|
||||
- 챔피언 통계 컬럼 정렬 토글 (게임수 / 승률 / KDA / CS)
|
||||
- 챔피언 검색 input 에 "ㄱㄹ" 입력 시 가렌·갈리오·갱플랭크 등 hits
|
||||
- 같은 (puuid, 큐, 랭크, 시즌) 1h 안 재요청 시 aggregation 0회 (Garnet hit)
|
||||
- `Community.seasons` schema 자리 추가 (1차 empty, 응답 `season.id = 'current'` 고정)
|
||||
- 단위 테스트 통과 (sub-job 분할 / leader election / 그룹 페치 dedup / 평점 산식 / 챔피언 검색 매칭)
|
||||
-673
@@ -1,673 +0,0 @@
|
||||
# Riot 최근 솔로랭크 통계 통합 플랜
|
||||
|
||||
> **대상**: codex가 이어서 진행 가능한 수준의 실행 플랜
|
||||
> **레포**: `/Users/dahyeon/source/lolympus-tournament-support` (pnpm workspace)
|
||||
> **작성 기준**: 2026-04-26
|
||||
> **선행 작업**: Riot-캐싱-Phase2-플랜.md, Riot-DDragon Manifest 도입(`RiotDdragonService` + Garnet 캐시) 완료
|
||||
|
||||
---
|
||||
|
||||
## 1. Context
|
||||
|
||||
`AuctionPage.tsx` 의 "최근 솔로랭크" 카드(승률/전적/KDA/평균 CS)가 현재 모두 `0`/`NaN` 으로 표시됩니다. 백엔드는 이미 `RiotAccount.recentStatsSummary` 필드를 노출하고 있고 mapper도 이를 전달하지만, **이 필드를 채우는 enrichment 단계가 비어 있습니다.**
|
||||
|
||||
이번 작업은 다음을 추가합니다.
|
||||
|
||||
1. **Match-V5 by-puuid (queue=420)** 으로 솔로랭크 matchId 목록 동기화
|
||||
2. **Match-V5 detail** 호출 → `RiotMatch` 컬렉션에 raw 보관 (이미 schema 존재)
|
||||
3. 사용자별 `RiotAccount.recentStatsSummary` 재계산 + `recentStatsFetchedAt` 갱신
|
||||
4. enrichment 트리거(수동 / 신규 등록 / 경매 직전) 와 TTL/Garnet dedup 적용
|
||||
5. 클라가 0/NaN 대신 실제 값을 표시하도록 mapper 점검
|
||||
|
||||
이미 다음이 갖춰져 있어 추가 인프라가 거의 필요 없습니다.
|
||||
|
||||
- `RiotMatchService.getMatchIdsByPuuid({queue, count, ...})` (`riot-match.service.ts`)
|
||||
- `RiotMatchService.getMatch(matchId)` 가 `RiotMatchDto` 파싱까지 포함
|
||||
- `RiotMatch` 컬렉션(`riot_match`) + `participantPuuids` 인덱스(`schema.ts:573`)
|
||||
- `RiotAccount.matchIds`, `matchIdsFetchedAt`, `recentStatsSummary`, `recentStatsFetchedAt` 필드(`schema.ts:128-148`)
|
||||
- `GarnetService` (in-flight dedup / TTL 락 용도)
|
||||
|
||||
---
|
||||
|
||||
## 2. 결정된 설계 사항
|
||||
|
||||
### 2.1 큐 정책
|
||||
|
||||
- **1차 대상은 솔로랭크(`queueId=420`) 만**.
|
||||
- 자유랭크(`440`)/노말은 추후 Phase 확장. 코드는 `queueId` 를 인자로 받는 형태로 짜되 호출부는 420 고정.
|
||||
|
||||
### 2.2 "최근" 의 정의
|
||||
|
||||
- **최근 20경기** 고정 윈도우 (사용자 결정). 상수 `RIOT_RECENT_MATCH_LIMIT = 20` 으로 service 모듈에 정의, 환경변수화 하지 않음.
|
||||
- 시즌 경계 보정은 하지 않음. `mostPlayedChampionIds` 가 시즌 패치에 따라 의미가 흔들릴 수 있다는 한계를 README/주석에 명시.
|
||||
|
||||
### 2.3 캐시 / TTL
|
||||
|
||||
- `RiotAccount.recentStatsFetchedAt` 기반 staleness 검사. TTL 기본 **6h** (mastery와 동일).
|
||||
- enrichment 진행 중 동일 (userId, puuid) 키 중복 호출 방지: 메모리 + Garnet **NX 락**.
|
||||
- 메모리 dedup: `RiotAccountEnrichmentService.inFlight` 패턴 그대로 확장
|
||||
- Garnet 락: `riot:enrich:matches:<puuid>` 키 + `setStringIfAbsent(..., 60)` (다중 인스턴스 안전망)
|
||||
- ddragon manifest 패턴(`Riot-DDragon`)과 동일하게 in-flight 후 **TTL 캐시 갱신** → 다음 호출은 즉시 fresh 반환.
|
||||
|
||||
### 2.4 RiotMatch 저장 정책
|
||||
|
||||
- `RiotMatch.matchId` 기준 upsert. **이미 존재하면 API 재호출하지 않음** (다른 사용자가 이미 가져왔을 가능성).
|
||||
- `participantPuuids` 인덱스 활용 → 한 puuid 의 최근 N경기를 DB에서 즉시 조회 가능.
|
||||
- Riot raw 응답은 `raw` 필드(Mixed) 에 통째로 저장. 핵심 메타(`gameCreation`, `gameDuration`, `gameVersion`, `queueId`) 는 top-level 으로 복제(필터/정렬용).
|
||||
- 페이로드 크기 우려: 한 경기 ≈ 30~80KB. 활성 사용자 100명 × 20경기 = 최대 2k 도큐먼트 ≈ 100MB 미만, 같은 매치 dedup 으로 실제는 더 작음.
|
||||
- **TTL/prune 없음 (사용자 결정).** 무한 누적 정책. 추후 컬렉션 비대화 시 별도 prune job 검토.
|
||||
|
||||
### 2.5 통계 계산 규칙 (라인별 분리)
|
||||
|
||||
**사용자 결정 2026-04-26**: 탑/정글/미드/바텀/서폿 라인별로 데이터 구분 필요.
|
||||
|
||||
#### 라인 식별
|
||||
|
||||
- Match-V5 participant 의 `teamPosition` 필드 (`TOP` | `JUNGLE` | `MIDDLE` | `BOTTOM` | `UTILITY`) 사용.
|
||||
- 빈 문자열인 경우 `individualPosition` 으로 fallback.
|
||||
- 둘 다 비어있거나 `Invalid` 면 통계에서 제외 (집계 카운트 안 함).
|
||||
|
||||
#### 우리 측 enum 매핑
|
||||
|
||||
```ts
|
||||
// schema 신규
|
||||
export type RiotLane = 'TOP' | 'JUNGLE' | 'MIDDLE' | 'BOTTOM' | 'UTILITY';
|
||||
|
||||
const POSITION_TO_LANE: Record<Position, RiotLane> = {
|
||||
TOP: 'TOP',
|
||||
JGL: 'JUNGLE',
|
||||
MID: 'MIDDLE',
|
||||
ADC: 'BOTTOM',
|
||||
SUP: 'UTILITY',
|
||||
};
|
||||
```
|
||||
|
||||
#### 새 데이터 구조
|
||||
|
||||
```ts
|
||||
export interface RiotLaneStats {
|
||||
games: number;
|
||||
wins: number;
|
||||
losses: number;
|
||||
avgKills: number; // 소수 1자리
|
||||
avgDeaths: number;
|
||||
avgAssists: number;
|
||||
avgCs: number; // (totalMinionsKilled + neutralMinionsKilled) / games
|
||||
avgCsPerMin: number; // 분당 CS — 라인 비교용 (서폿 비교 한계 보정)
|
||||
mostPlayedChampionIds: number[]; // 상위 3, Riot DTO 와 동일 number
|
||||
}
|
||||
|
||||
export interface RiotRecentStatsSummary {
|
||||
overall: RiotLaneStats;
|
||||
byLane: Partial<Record<RiotLane, RiotLaneStats>>; // 게임이 1회 이상 있는 라인만 entry
|
||||
// 기존 flat 필드들은 schema 마이그레이션을 통해 제거. § 2.5.1 참고.
|
||||
}
|
||||
```
|
||||
|
||||
`mostPlayedChampionIds` 는 **`number[]`** (Riot DTO 와 동일). 클라는 ddragon manifest 로 표시명 풀이. § 2.5.3 참고.
|
||||
|
||||
### 2.5.3 championId 타입 통일 (전체 number)
|
||||
|
||||
기존 정합성 깨진 곳: `RiotRecentStatsSummary.mostPlayedChampionIds: string[]` (`schema.ts:123`) — Phase2 에서 mastery 는 number 로 바꿨는데 이 한 줄만 string 으로 잔존. Riot 모든 응답이 number 이므로 **number 로 통일**.
|
||||
|
||||
영향 받는 위치:
|
||||
- `apps/api/src/modules/global/database/schema.ts:123` — `string[]` → `number[]`
|
||||
- `apps/api/src/modules/riot/riot.types.ts` — `RiotRecentStatsSummary` 동일 변경
|
||||
- `apps/web/src/api/types.ts` — `ApiRiotRecentStatsSummary.mostPlayedChampionIds`, 그리고 §3.7 신규 `ApiRiotLaneStats` 도 처음부터 `number[]`
|
||||
- `apps/web/src/lib/ddragon.ts` — 이미 `string | number` 둘 다 받게 만들어둠. 변경 불필요.
|
||||
|
||||
기존 DB 도큐먼트에 `string[]` 으로 저장된 게 있을 가능성: enrichment 한 번 돌면 새 구조로 통째 교체되므로 자동 정리. 별도 마이그레이션 스크립트 불필요.
|
||||
|
||||
#### 2.5.1 schema 마이그레이션 메모
|
||||
|
||||
- 기존 `RiotRecentStatsSummary` (flat) 는 사용처가 mapper 한 곳뿐 (`mappers.ts:184~`).
|
||||
- DB 에 이미 저장된 도큐먼트는 옛 형태일 수 있으나 enrichment 가 한 번 돌면 자동 덮어씀.
|
||||
- 안전한 전환: enrichment service 가 응답 직전 항상 새 구조로 만들어 `account.recentStatsSummary = newSummary` 통째 교체. partial merge 안 함.
|
||||
- 별도 마이그레이션 스크립트 불필요 (TTL 6h 안에 자연 갱신).
|
||||
|
||||
### 2.5.4 시즌 경계 — 자동 리셋
|
||||
|
||||
LoL 시즌(splits/sets) 시작 시점에는 누적 통계의 의미가 변하므로 자동 리셋 필요. Riot 이 명시적 "season started at" API 를 제공하지 않으므로 **community 단위 수동 설정 + 자동 필터링** 의 하이브리드.
|
||||
|
||||
#### Schema 추가
|
||||
|
||||
```ts
|
||||
// schema.ts Community
|
||||
seasonStartedAt?: Date; // 운영자/admin 이 시즌 시작 시점 등록
|
||||
```
|
||||
|
||||
#### 동작
|
||||
|
||||
1. enrichment 진입 시 `community.seasonStartedAt` 조회.
|
||||
2. `account.recentStatsFetchedAt < community.seasonStartedAt` 이면 **force=true** 로 진행 (TTL 무시).
|
||||
3. `computeSummary` 가 매치 필터링: `match.info.gameCreation >= seasonStartedAt.getTime()` 인 것만 사용.
|
||||
4. `account.matchIds` 도 시즌 경계 이전 것은 통계에서 제외 (DB 자체에서는 제거 안 함 — 무한 저장 정책).
|
||||
|
||||
#### Trigger
|
||||
|
||||
- 운영자가 새 시즌 시작 시 community 의 `seasonStartedAt` 을 수동 갱신 → 다음 enrichment 부터 자동 적용.
|
||||
- 야간 prefetch 가 다음 사이클에 일괄 갱신.
|
||||
|
||||
#### Phase 후속 (자동화 검토)
|
||||
|
||||
- Riot patch notes RSS 또는 ddragon `versions.json` 의 major bump 감지로 자동 갱신 — 본 플랜 범위 외.
|
||||
|
||||
### 2.5.5 다국가 region 지원 (구조)
|
||||
|
||||
현재 enrichment 가 `region: 'asia'`, `platform: 'kr'` 하드코딩. 이미 `Community.riotPlatform`, `Community.riotRegion` 필드는 schema 에 존재하지만 enrichment 호출부에서 사용 안 함.
|
||||
|
||||
#### 변경
|
||||
|
||||
1. **호출자 책임 모델**: `enrichRiotAccount` 의 `EnrichOptions.platform/region` 으로 community 값을 명시 전달.
|
||||
2. enrichment 트리거 지점 (`auction.service`, `dakao-user.service`, `prefetch.scheduler`) 에서 community 조회 후 platform/region 을 옵션에 주입.
|
||||
3. fallback 기본값은 `kr` / `asia` 유지 (community 미지정 시).
|
||||
4. **Throttle 분리**: §2.7 의 sliding-window 키가 이미 region 별로 분리됨 (`riot:rl:<region>:1s`) — 추가 변경 없음.
|
||||
5. **DDragon 영향**: `realms/<region>.json` 별 자체 dd 버전이 다를 수 있음. 현재 `RiotDdragonService` 는 글로벌 versions[0] 사용 중 — 한국 클라이언트 dd 버전이 글로벌과 차이 거의 없어 OK. 다른 region 추가 시 region 별 manifest 캐시로 분리 검토.
|
||||
|
||||
#### 호출 패턴
|
||||
|
||||
```ts
|
||||
// auction.service.ts:start
|
||||
const community = await CommunityModel.findById(params.communityId);
|
||||
const platform = community?.riotPlatform ?? 'kr';
|
||||
const region = community?.riotRegion ?? 'asia';
|
||||
|
||||
const limit = pLimit(3);
|
||||
await Promise.allSettled(
|
||||
order.map(p => limit(() => this.enrichmentService.enrichRiotAccount({
|
||||
userId: p.userId,
|
||||
puuid: p.puuid,
|
||||
options: { platform, region, force: false },
|
||||
}))),
|
||||
);
|
||||
```
|
||||
|
||||
`prefetch.scheduler` 는 사용자별 community 를 cursor 단계에서 함께 로드 (또는 community → user 양방향 join).
|
||||
|
||||
### 2.5.2 0-state UX (사용자 결정: 적당히 제안)
|
||||
|
||||
| 상황 | 표시 |
|
||||
|---|---|
|
||||
| `overall.games === 0` (enrichment 실패 또는 신규 사용자) | "최근 솔로랭크 기록이 없습니다" placeholder |
|
||||
| 주 라인(`mainPosition`) 게임 ≥ 1 | 헤더에 주 라인 통계 강조 표시 |
|
||||
| 주 라인 게임 = 0, 다른 라인 있음 | 헤더에 `overall` 통계 + "주 라인 기록 없음 / 전체 기준" 보조 라벨 |
|
||||
| 라인별 미니 row | 게임 ≥ 1 라인은 W-L · KDA · CS/min, 0 게임 라인은 회색 dash |
|
||||
|
||||
### 2.6 트리거 시점
|
||||
|
||||
| 시점 | 호출 방식 | force |
|
||||
|---|---|---|
|
||||
| 신규 RiotAccount 등록 (dakao 명령) | 동기 enrich 호출 | true |
|
||||
| 사용자 수동 갱신 (Phase2 엔드포인트 추가됨) | 동기 호출 | true |
|
||||
| 경매 `start` 직전 | 참가자 puuid 일괄 enrich (`p-limit` 적용, §2.7 throttle 참조) | false |
|
||||
| 야간 스케줄러 (Phase 2 후속) | force=false 로 stale 만 갱신 | false |
|
||||
|
||||
→ 본 플랜에서는 **트리거 4개 지점만 호출 추가**. 스케줄러는 Phase 2 트랙에서 처리.
|
||||
|
||||
### 2.7 Rate Limit / Throttle (개인키 가정)
|
||||
|
||||
**전제**: 개인 API 키 — Riot 공식 한도 `20 req / 1s` + `100 req / 120s` (앱 단위, region 별).
|
||||
|
||||
#### A. 사전 차단 — `RiotClientService` 통합 throttle
|
||||
|
||||
모든 Riot 호출이 `RiotClientService.get()` 을 통과하므로 여기에 한 곳에서 게이트를 건다. **Garnet 기반 sliding-window** 로 다중 인스턴스 안전성 확보.
|
||||
|
||||
키 구조:
|
||||
```
|
||||
riot:rl:<region>:1s -- ZSET (score=timestampMs, member=uuid)
|
||||
riot:rl:<region>:120s -- ZSET (동일)
|
||||
```
|
||||
|
||||
호출 시 의사코드:
|
||||
```ts
|
||||
async function acquire(region: string): Promise<void> {
|
||||
const now = Date.now();
|
||||
for (;;) {
|
||||
const wait = await checkAndAdd(region, now); // Lua script 추천
|
||||
if (wait === 0) return;
|
||||
await sleep(wait);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
`checkAndAdd` 는 **Lua script 1회 호출**(원자성):
|
||||
1. `ZREMRANGEBYSCORE key 0 (now - windowMs)` 로 윈도우 밖 제거
|
||||
2. `ZCARD key` 로 현재 카운트
|
||||
3. 한도 초과 시 `ZRANGE key 0 0 WITHSCORES` 로 가장 오래된 항목의 만료 시각 → 대기 시간 반환
|
||||
4. 가능하면 `ZADD key now uuid` + `EXPIRE key windowMs` 후 0 반환
|
||||
|
||||
두 윈도우(1s/120s) 모두 통과해야 진행. 하나라도 막히면 더 큰 wait 반환.
|
||||
|
||||
`apps/api/src/modules/riot/riot-rate-limiter.service.ts` 신규:
|
||||
```ts
|
||||
@Injectable()
|
||||
export class RiotRateLimiterService {
|
||||
constructor(private readonly garnet: GarnetService) {}
|
||||
public async acquire(region: RiotRegionalRoute | RiotPlatformRoute): Promise<void>;
|
||||
// 옵션: per-method 한도 추가 시 추가 인자
|
||||
}
|
||||
```
|
||||
|
||||
설정 상수(코드 상수, 환경변수화 안 함):
|
||||
```ts
|
||||
const APP_LIMITS = [
|
||||
{ windowMs: 1_000, max: 20 },
|
||||
{ windowMs: 120_000, max: 100 },
|
||||
];
|
||||
```
|
||||
|
||||
> 안전 마진을 위해 max 를 **18 / 95** 로 살짝 낮추는 옵션을 코드 주석으로 남김 — 다른 클라이언트(예: 로컬 개발기)와 키를 공유할 때 충돌 방지.
|
||||
|
||||
#### B. 사후 처리 — 429 backoff
|
||||
|
||||
`RiotClientService.get()` 응답이 429 일 때:
|
||||
1. 기존 `Retry-After` 캡처 로직(`riot.client.service.ts:125`) 활용
|
||||
2. `Retry-After` 만큼 대기 후 **최대 1회 재시도**
|
||||
3. 재시도도 429 면 `RiotApiError` throw (현재 동작 유지)
|
||||
|
||||
#### C. 클라이언트단 동시성 제한
|
||||
|
||||
Auction `start` 트리거에서 5명 동시 enrichment × (1 list + 최대 20 detail) = burst 가 가장 큼. 사전 차단만으로도 Riot 한도는 지켜지지만, 처리 시간이 길어지므로 **fairness 를 위한 동시성 한도** 도 추가:
|
||||
|
||||
- `p-limit` 의존성 추가 (`pnpm --filter api add p-limit`)
|
||||
- enrichment service 내부에서 `recentMatches` 페치 시 detail 호출을 `pLimit(2)` 로 직렬화
|
||||
- auction.service 트리거에서도 사용자별 enrichment 자체에 `pLimit(3)` 적용
|
||||
|
||||
#### D. 메서드 한도(Method Rate Limit)
|
||||
|
||||
Match-V5 `getMatch` 는 `2000 req / 10s` 라 앱 한도가 먼저 걸린다 — **본 플랜에서는 method 한도는 별도 추적 안 함**. 추후 다른 method 추가 시 `RiotRateLimiterService` 가 method 단위 카운터도 받도록 확장.
|
||||
|
||||
#### E. 운영 가시성
|
||||
|
||||
- `RiotRateLimiterService.acquire()` 가 100ms 이상 대기하면 `logger.warn` (throttle 발생 추적)
|
||||
- 응답 헤더 `X-App-Rate-Limit-Count` 를 매 호출마다 디버그 로그(샘플링) → 실제 사용량 vs 우리 카운터 drift 확인
|
||||
|
||||
---
|
||||
|
||||
## 3. 변경 사항 (파일 단위)
|
||||
|
||||
### 3.1 신규: `apps/api/src/modules/riot/riot-recent-matches.service.ts`
|
||||
|
||||
```ts
|
||||
@Injectable()
|
||||
export class RiotRecentMatchesService {
|
||||
constructor(
|
||||
private readonly connectionService: ConnectionService,
|
||||
private readonly matchService: RiotMatchService,
|
||||
private readonly garnetService: GarnetService,
|
||||
) {}
|
||||
|
||||
/** queue=420 기준 최근 N matchId 동기화 + raw 저장. 새로 가져온 RiotMatch 도큐먼트들 반환 */
|
||||
public async syncRecentMatches(params: {
|
||||
puuid: string;
|
||||
region?: RiotRegionalRoute;
|
||||
limit?: number; // 기본 20
|
||||
queueId?: number; // 기본 420
|
||||
}): Promise<RiotMatchDocument[]>;
|
||||
|
||||
/** DB 에서 puuid 기준 최근 N matchInfo 조회 (API 호출 없음) */
|
||||
public async loadFromDb(params: {
|
||||
puuid: string;
|
||||
limit?: number;
|
||||
queueId?: number;
|
||||
}): Promise<RiotMatchDocument[]>;
|
||||
}
|
||||
```
|
||||
|
||||
핵심 로직:
|
||||
|
||||
1. `getMatchIdsByPuuid({queue, count, region: 'asia'})`
|
||||
2. 받은 ids 를 `riot_match.find({matchId: {$in: ids}}, {matchId: 1})` 로 존재 여부 조회
|
||||
3. 없는 것만 `getMatch(matchId)` → upsert (`updateOne({matchId}, {$setOnInsert: {...}}, {upsert: true})`)
|
||||
4. Garnet 락: `riot:enrich:matches:<puuid>` NX EX 60. 락 획득 실패 시 즉시 return DB 캐시.
|
||||
5. queueId 필터: list API 의 `queue` 파라미터로 한 번 거르고, detail 응답의 `info.queueId` 로 한 번 더 검증.
|
||||
|
||||
### 3.2 신규: `RiotRecentStatsService` (또는 위 service에 합쳐도 OK)
|
||||
|
||||
```ts
|
||||
public computeSummary(matches: RiotMatchDto[], puuid: string): RiotRecentStatsSummary;
|
||||
```
|
||||
|
||||
- 순수 함수. 단위 테스트 추가(`*.spec.ts`).
|
||||
- 입력 매치에서 `info.participants.find(p => p.puuid === puuid)` 로 본인 participant 찾기.
|
||||
- 라인 결정: `teamPosition || individualPosition`. 빈 값이면 `byLane` 집계에서 제외하되 `overall` 에는 포함.
|
||||
- 0경기 입력 시 `overall` 은 모든 수치 0 으로 채운 객체, `byLane` 은 빈 객체 `{}`. 클라 NaN 회피.
|
||||
- `avgCsPerMin = ((totalMinionsKilled + neutralMinionsKilled) / (gameDuration / 60))` 의 평균. `gameDuration` 은 초 단위.
|
||||
|
||||
### 3.3 `riot-account-enrichment.service.ts` 확장
|
||||
|
||||
`EnrichOptions` 에 `recentMatchesTtlMs` (기본 6h) 추가.
|
||||
`EnrichResult` 에 `recentMatches: 'updated' | 'fresh' | 'failed'` 추가.
|
||||
|
||||
`doEnrichRiotAccount` 에:
|
||||
|
||||
```ts
|
||||
const recentMatchesStale =
|
||||
force ||
|
||||
!account.recentStatsFetchedAt ||
|
||||
now - account.recentStatsFetchedAt.getTime() > recentMatchesTtl;
|
||||
|
||||
const recentOutcome = recentMatchesStale
|
||||
? await this.fetchRecentMatchesSafe(params.puuid, region)
|
||||
: { status: 'fresh' as const, summary: null };
|
||||
|
||||
if (recentOutcome.status === 'updated' && recentOutcome.summary) {
|
||||
account.recentStatsSummary = recentOutcome.summary;
|
||||
account.recentStatsFetchedAt = new Date();
|
||||
account.matchIds = recentOutcome.matchIds;
|
||||
account.matchIdsFetchedAt = new Date();
|
||||
}
|
||||
```
|
||||
|
||||
`fetchRecentMatchesSafe`:
|
||||
1. `recentMatchesService.syncRecentMatches({puuid, region})`
|
||||
2. `recentMatchesService.loadFromDb({puuid, limit: 20, queueId: 420})`
|
||||
3. `computeSummary(matches, puuid)`
|
||||
4. 실패 시 `failed` 반환 (기존 patterns와 동일).
|
||||
|
||||
### 3.4 `riot.module.ts`
|
||||
|
||||
`RiotRecentMatchesService`, `RiotRateLimiterService` 를 providers/exports 에 추가. `GarnetModule` 은 `@Global` 이라 별도 import 불필요.
|
||||
|
||||
### 3.4.1 `riot.client.service.ts` 변경
|
||||
|
||||
- 생성자에 `RiotRateLimiterService` 주입.
|
||||
- `get()` 진입 시 `await this.rateLimiter.acquire(options.platform ?? options.region ?? 'asia')`.
|
||||
- 응답이 429 일 때 `Retry-After` 캡처 후 `await sleep(retryAfterMs)` → 한 번 재시도. 재시도도 429 면 throw.
|
||||
- (기존 동작과의 차이: throttle/재시도 추가, 그 외 인터페이스 동일.)
|
||||
|
||||
### 3.5 트리거 지점
|
||||
|
||||
- `apps/api/src/modules/dakao/dakao-user.service.ts`: 신규 RiotAccount 등록 직후 `enrichRiotAccount({force: true})` 호출 흐름이 이미 있는지 확인하고 동일 흐름 유지(별도 호출 추가 불필요).
|
||||
- `apps/api/src/modules/auction/auction.service.ts:start`: order 구성 직후, 참가자 puuid 들에 대해 `p-limit(3)` 으로 동시성 제한:
|
||||
```ts
|
||||
const limit = pLimit(3);
|
||||
await Promise.allSettled(
|
||||
order.map(p => limit(() => this.enrichmentService.enrichRiotAccount({
|
||||
userId: p.userId, puuid: p.puuid, options: {force: false}
|
||||
}))),
|
||||
);
|
||||
```
|
||||
이미 fresh 면 즉시 return 이라 비용 거의 없음. throttle 은 `RiotClientService` 단에서 추가로 보호.
|
||||
|
||||
### 3.6 수동 갱신 엔드포인트
|
||||
|
||||
Phase 2 플랜의 `POST /me/riot-accounts/:puuid/refresh` 가 추가되면 동일 enrichment 가 호출되므로, **본 플랜에서 별도 엔드포인트는 만들지 않고** Phase 2 와 합류.
|
||||
|
||||
### 3.7 클라 — 변경 큼
|
||||
|
||||
#### types.ts
|
||||
|
||||
```ts
|
||||
export interface ApiRiotLaneStats {
|
||||
games: number;
|
||||
wins: number;
|
||||
losses: number;
|
||||
avgKills: number;
|
||||
avgDeaths: number;
|
||||
avgAssists: number;
|
||||
avgCs: number;
|
||||
avgCsPerMin: number;
|
||||
mostPlayedChampionIds: string[];
|
||||
}
|
||||
|
||||
export type RiotLane = 'TOP' | 'JUNGLE' | 'MIDDLE' | 'BOTTOM' | 'UTILITY';
|
||||
|
||||
export interface ApiRiotRecentStatsSummary {
|
||||
overall: ApiRiotLaneStats;
|
||||
byLane: Partial<Record<RiotLane, ApiRiotLaneStats>>;
|
||||
}
|
||||
```
|
||||
|
||||
기존 flat 필드는 제거. 클라는 enrichment 한 번 돌고 난 새 구조 가정.
|
||||
|
||||
#### mappers.ts
|
||||
|
||||
`AuctionPlayerView.recentStats` 를 새 구조로 정렬. 추가로 `pickPrimary(stats, mainPosition)` 헬퍼:
|
||||
|
||||
```ts
|
||||
const POSITION_TO_LANE: Record<Position, RiotLane> = {
|
||||
TOP: 'TOP', JGL: 'JUNGLE', MID: 'MIDDLE', ADC: 'BOTTOM', SUP: 'UTILITY',
|
||||
};
|
||||
|
||||
function pickPrimary(summary, mainPosition) {
|
||||
const lane = POSITION_TO_LANE[mainPosition];
|
||||
const lanePrimary = summary.byLane[lane];
|
||||
if (lanePrimary && lanePrimary.games > 0) return { stats: lanePrimary, source: 'lane' };
|
||||
if (summary.overall.games > 0) return { stats: summary.overall, source: 'overall' };
|
||||
return { stats: null, source: 'none' };
|
||||
}
|
||||
```
|
||||
|
||||
#### AuctionPage.tsx — "최근 솔로랭크" 카드 재설계
|
||||
|
||||
```
|
||||
┌ 최근 솔로랭크 ─ 미드 ───────┐ ← 헤더에 표시 기준 라인
|
||||
│ 승률 56% · 28W 22L │
|
||||
│ KDA 7.1/3.4/8.2 (4.50) │
|
||||
│ 분당 CS 7.2 │
|
||||
├──────────────────────────── │
|
||||
│ 탑 2W 1L · 5.0/3.3/4.7 │ ← byLane 미니 row
|
||||
│ 정글 — │ ← 0 게임 dash
|
||||
│ 미드 25W 19L · 7.1/3.4/8.2 │ ← 강조
|
||||
│ 바텀 — │
|
||||
│ 서폿 1W 2L · 1.0/4.0/15.7 │
|
||||
└─────────────────────────────┘
|
||||
```
|
||||
|
||||
- 헤더: `pickPrimary` 결과의 `stats` + `source === 'overall'` 이면 "(전체 기준)" 보조 라벨.
|
||||
- 미니 row: 5개 라인 고정 순서 (TOP/JGL/MID/ADC/SUP), 게임 0 인 라인은 회색 dash, 주 라인은 텍스트 굵게.
|
||||
- `pickPrimary` 결과가 `none` 이면 placeholder ("최근 솔로랭크 기록이 없습니다").
|
||||
- KDA Perfect 처리(deaths=0) 는 기존 로직 유지.
|
||||
|
||||
신규 컴포넌트 분리 권장: `RecentSoloStats` 별 파일이 깔끔.
|
||||
|
||||
### 3.8 신규: 야간 prefetch 스케줄러 (5슬롯 분산)
|
||||
|
||||
`@nestjs/schedule` 의존성 추가 (`pnpm --filter api add @nestjs/schedule`). app.module 에 `ScheduleModule.forRoot()` 등록.
|
||||
|
||||
#### 슬롯 분산 정책 (사용자 결정 2026-04-26)
|
||||
|
||||
- 03/04/05/06/07 시 KST **5개 슬롯** 으로 분산.
|
||||
- 사용자 그룹핑: `userId.hash % 5` 로 슬롯 결정 (decimal index 0~4 → 03시~07시 매핑).
|
||||
- 안전 마진: 각 슬롯 종료 ≤ 다음 슬롯 시작 (1시간 안에 처리 끝나야). 활성 사용자 100명 / 5슬롯 = 20명/슬롯, throttle 100req/120s 안에서 충분.
|
||||
- 슬롯별 Garnet 락 키 분리: `riot:cron:nightly-prefetch:slot-<idx>` (NX EX 50m). 다중 인스턴스 leader election + 슬롯 간 독립 실행.
|
||||
|
||||
```ts
|
||||
@Injectable()
|
||||
export class RiotPrefetchScheduler {
|
||||
private readonly logger = new Logger(RiotPrefetchScheduler.name);
|
||||
private readonly LOCK_TTL_S = 50 * 60;
|
||||
private readonly STALE_THRESHOLD_MS = 24 * 60 * 60 * 1000;
|
||||
private readonly SLOTS = 5;
|
||||
private readonly USER_CAP_PER_SLOT = 1000;
|
||||
|
||||
constructor(
|
||||
private readonly connectionService: ConnectionService,
|
||||
private readonly enrichment: RiotAccountEnrichmentService,
|
||||
private readonly garnet: GarnetService,
|
||||
) {}
|
||||
|
||||
// 03,04,05,06,07 시 매시 정각
|
||||
@Cron('0 0 3-7 * * *', { timeZone: 'Asia/Seoul' })
|
||||
async runSlot() {
|
||||
const hour = new Date().getHours(); // KST 가정 (TZ 환경 일치 필요)
|
||||
const slotIndex = hour - 3; // 0..4
|
||||
if (slotIndex < 0 || slotIndex >= this.SLOTS) return;
|
||||
|
||||
const lockKey = `riot:cron:nightly-prefetch:slot-${slotIndex}`;
|
||||
const acquired = await this.garnet.setStringIfAbsent(
|
||||
lockKey,
|
||||
`${process.pid}-${Date.now()}`,
|
||||
this.LOCK_TTL_S,
|
||||
);
|
||||
if (!acquired) {
|
||||
this.logger.log(`Slot ${slotIndex} skipped — lock held by another instance.`);
|
||||
return;
|
||||
}
|
||||
|
||||
await this.processSlot(slotIndex);
|
||||
}
|
||||
|
||||
private async processSlot(slotIndex: number) {
|
||||
const cutoff = new Date(Date.now() - this.STALE_THRESHOLD_MS);
|
||||
const UserModel = await this.connectionService.getModel('user');
|
||||
const CommunityModel = await this.connectionService.getModel('community');
|
||||
|
||||
const cursor = UserModel.find({
|
||||
'riotAccounts.recentStatsFetchedAt': { $lt: cutoff },
|
||||
}).cursor();
|
||||
|
||||
const limit = pLimit(2);
|
||||
let processed = 0;
|
||||
for await (const user of cursor) {
|
||||
// 슬롯 분산: hash(userId) % SLOTS
|
||||
if (this.slotOfUser(user._id.toString()) !== slotIndex) continue;
|
||||
|
||||
const community = await CommunityModel.findById(user.communityId).lean();
|
||||
const platform = community?.riotPlatform ?? 'kr';
|
||||
const region = community?.riotRegion ?? 'asia';
|
||||
|
||||
for (const account of user.riotAccounts) {
|
||||
const seasonStart = community?.seasonStartedAt;
|
||||
const seasonStale =
|
||||
!!seasonStart &&
|
||||
(!account.recentStatsFetchedAt ||
|
||||
account.recentStatsFetchedAt < seasonStart);
|
||||
const ttlStale =
|
||||
!account.recentStatsFetchedAt || account.recentStatsFetchedAt < cutoff;
|
||||
if (!ttlStale && !seasonStale) continue;
|
||||
|
||||
await limit(() =>
|
||||
this.enrichment
|
||||
.enrichRiotAccount({
|
||||
userId: user._id,
|
||||
puuid: account.puuid,
|
||||
options: { platform, region, force: seasonStale },
|
||||
})
|
||||
.catch((err) =>
|
||||
this.logger.warn(`prefetch failed ${account.puuid}: ${err}`),
|
||||
),
|
||||
);
|
||||
processed += 1;
|
||||
}
|
||||
if (processed >= this.USER_CAP_PER_SLOT) break;
|
||||
}
|
||||
|
||||
this.logger.log(`Slot ${slotIndex} processed ${processed} accounts.`);
|
||||
}
|
||||
|
||||
private slotOfUser(userId: string): number {
|
||||
// FNV-1a 32bit — 외부 의존성 없이 안정적 분산
|
||||
let h = 2166136261;
|
||||
for (let i = 0; i < userId.length; i += 1) {
|
||||
h ^= userId.charCodeAt(i);
|
||||
h = Math.imul(h, 16777619);
|
||||
}
|
||||
return Math.abs(h) % this.SLOTS;
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
#### 동작 요약
|
||||
|
||||
- **leader election**: 슬롯별 Garnet NX 락. 다중 인스턴스 중 첫 도달자만 처리.
|
||||
- **사용자 분산**: FNV-1a 해시로 결정적 분산 (같은 사용자는 항상 같은 슬롯). region 분포가 편향되어도 슬롯별 부하는 균일.
|
||||
- **throttle 합류**: enrichment 호출이 `RiotRateLimiterService` 통과 → 별도 sleep 불필요.
|
||||
- **community-aware**: cursor 안에서 community 조회로 platform/region/seasonStartedAt 적용.
|
||||
- **시즌 force fetch**: `seasonStartedAt > recentStatsFetchedAt` 면 TTL 무시.
|
||||
- **안전 상한**: 슬롯당 1000 사용자 cap.
|
||||
- **TZ 주의**: `@Cron` 의 `timeZone` 옵션은 cron 발화에만 영향. `new Date().getHours()` 는 process TZ 따라가므로 운영 환경의 `TZ=Asia/Seoul` 보장 또는 명시 변환 필요. 안전한 대안은 슬롯별 cron 5개 정의 (각 cron 안에서 slotIndex 상수 박기).
|
||||
|
||||
#### 더 안전한 변형 (권장)
|
||||
|
||||
```ts
|
||||
@Cron('0 0 3 * * *', { timeZone: 'Asia/Seoul' }) async slot0() { return this.processSlot(0); }
|
||||
@Cron('0 0 4 * * *', { timeZone: 'Asia/Seoul' }) async slot1() { return this.processSlot(1); }
|
||||
@Cron('0 0 5 * * *', { timeZone: 'Asia/Seoul' }) async slot2() { return this.processSlot(2); }
|
||||
@Cron('0 0 6 * * *', { timeZone: 'Asia/Seoul' }) async slot3() { return this.processSlot(3); }
|
||||
@Cron('0 0 7 * * *', { timeZone: 'Asia/Seoul' }) async slot4() { return this.processSlot(4); }
|
||||
```
|
||||
|
||||
→ TZ 의존성 제거, 슬롯 매핑 명확.
|
||||
|
||||
테스트:
|
||||
- 락 미획득 시 즉시 return 검증
|
||||
- stale cutoff 기준 정확히 필터링되는지 fixture 기반 검증
|
||||
- (실제 cron 발화는 e2e 범위 외 — 메서드 직접 호출 테스트로 충분)
|
||||
|
||||
---
|
||||
|
||||
## 4. 단위 테스트
|
||||
|
||||
- `apps/api/src/modules/riot/riot-recent-matches.service.spec.ts`
|
||||
- `computeSummary`: 0경기 / 단일경기(승) / 5경기 mix / 같은 챔피언 빈도 상위 3개 정렬 검증
|
||||
- **라인별 집계**: 미드 3경기 + 정글 2경기 fixture → `byLane.MIDDLE.games === 3`, `byLane.JUNGLE.games === 2`
|
||||
- **빈 teamPosition**: fallback to `individualPosition`, 둘 다 비면 `byLane` 에는 안 들어가도 `overall` 에는 포함
|
||||
- **avgCsPerMin**: gameDuration 1500s + cs 200 → 분당 8.0
|
||||
- 같은 puuid 가 detail.participants 에 없는 경우 → 해당 매치 skip
|
||||
- `apps/api/src/modules/riot/riot-account-enrichment.service.spec.ts` 확장
|
||||
- `recentMatches` outcome 분기 커버 (stale/fresh/failed)
|
||||
- `apps/api/src/modules/riot/riot-rate-limiter.service.spec.ts`
|
||||
- 1초 윈도우 한도 도달 시 다음 호출이 대기하는지 (Garnet은 ioredis-mock 또는 실제 컨테이너)
|
||||
- 120초 윈도우만 막히는 경우 — 더 큰 wait 반환 검증
|
||||
- 다중 region (asia/kr) 키가 분리되어 서로 영향 없는지
|
||||
- `apps/api/src/modules/riot/riot-prefetch.scheduler.spec.ts`
|
||||
- 락 미획득 시 enrichment 호출 0회
|
||||
- cutoff 보다 fresh 한 account 는 skip
|
||||
- 1000 사용자 cap 동작
|
||||
- **슬롯 분산**: 동일 userId 의 `slotOfUser` 가 항상 동일 값 반환, 1000 사용자 분포 편차 < 30%
|
||||
- **시즌 force**: `community.seasonStartedAt > recentStatsFetchedAt` 시 force=true 로 enrichment 호출
|
||||
- community 의 `riotPlatform`/`riotRegion` 이 옵션에 정확히 전달되는지
|
||||
|
||||
---
|
||||
|
||||
## 5. Rollout
|
||||
|
||||
1. (PR-1) `RiotRateLimiterService` + Lua sliding-window + 테스트, `RiotClientService` 통합. **이게 먼저 깔려야 다른 PR 의 enrichment 가 안전.**
|
||||
2. (PR-2) `RiotRecentMatchesService` + `computeSummary` 라인별 집계 + 테스트, schema 신규 타입 정의
|
||||
3. (PR-3) `RiotAccountEnrichmentService` 에 통합 + `p-limit` 의존성 추가 + auction.service 트리거
|
||||
4. (PR-4) 클라 types/mapper/AuctionPage 카드 재설계 (`RecentSoloStats` 컴포넌트)
|
||||
5. (PR-5) `RiotPrefetchScheduler` + `@nestjs/schedule` 의존성 + Garnet leader election
|
||||
6. (PR-6) 운영 모니터링 로그 (throttle wait, X-App-Rate-Limit-Count drift, prefetch 처리 건수)
|
||||
7. (Phase 2 합류) 수동 갱신 엔드포인트
|
||||
|
||||
---
|
||||
|
||||
## 6. 추가로 고려해야 할 점 (확정 / 미결)
|
||||
|
||||
### 확정 (사용자 결정 2026-04-26)
|
||||
|
||||
- **API 키 등급**: 개인키 → §2.7 throttle 구현 필수.
|
||||
- **윈도우 크기**: 20경기 고정 (환경변수화 안 함).
|
||||
- **RiotMatch 보관**: 무한 저장. TTL/prune 없음.
|
||||
- **자유랭크/노말 미포함**: queue=420 솔로랭크 only.
|
||||
- **라인별 데이터 구분**: §2.5 의 `byLane` 구조 + AuctionPage 카드 재설계 (§3.7).
|
||||
- **lane 보정 = 분당 CS (avgCsPerMin)**.
|
||||
- **0-state UX**: §2.5.2 표 적용.
|
||||
- **야간 prefetch 스케줄러**: §3.8 — 03/04/05/06/07 시 KST 5슬롯 분산, 사용자 hash 로 결정적 분산, 슬롯별 Garnet 락.
|
||||
- **championId 타입 통일**: §2.5.3 — Riot DTO 와 동일 `number` 로 통일. `mostPlayedChampionIds: number[]`.
|
||||
- **시즌 경계 자동 리셋**: §2.5.4 — `Community.seasonStartedAt` 추가. 운영자 수동 등록 + enrichment 자동 force fetch + 매치 필터링.
|
||||
- **다국가 region 지원 구조**: §2.5.5 — `Community.riotPlatform/riotRegion` 활용, 호출자가 옵션에 주입. 기본값 kr/asia.
|
||||
- **외부 공유 OK** — ACL 별도 처리 없음.
|
||||
|
||||
### 미결
|
||||
|
||||
(없음)
|
||||
|
||||
---
|
||||
|
||||
## 7. Done 정의
|
||||
|
||||
- AuctionPage 의 "최근 솔로랭크" 카드가 0 이 아닌 실제 값을 표시 (테스트 사용자 1명 이상)
|
||||
- 카드에 라인별 미니 row 5줄(TOP/JGL/MID/ADC/SUP) 표시, 주 라인 강조
|
||||
- 0게임 사용자에게 placeholder ("최근 솔로랭크 기록이 없습니다") 표시 확인
|
||||
- 같은 사용자 재진입 시 6h 이내에는 Match-V5 호출 0 회 (서버 로그로 확인)
|
||||
- `riot_match` 컬렉션에 raw 저장 + `participantPuuids` 인덱스 hit 확인
|
||||
- Throttle 동작: 21+ calls 동시 발생 시 `RiotRateLimiterService.acquire()` wait 로그 발생, Riot 429 0건
|
||||
- 야간 03~07시 KST cron 5회 슬롯 발화, 슬롯별로 다른 사용자 집합 처리되는지 로그 확인
|
||||
- `championId` 가 schema/types/응답 전부에서 `number` 로 통일됨 (grep 으로 string 잔존 0건)
|
||||
- `Community.seasonStartedAt` 갱신 시 다음 enrichment 가 force fetch 되고, 시즌 이전 매치가 통계에서 제외됨
|
||||
- enrichment 호출이 community.riotPlatform/riotRegion 을 받아 동작 (`'kr'` 외 region 도 옵션 분기 가능)
|
||||
- 단위 테스트 통과 (라인별 집계 / throttle 윈도우 / scheduler 슬롯 분산 / 시즌 force / region 전달)
|
||||
- Phase 2 의 `*FetchedAt` 노출 패턴과 정합 (응답에 `recentStatsFetchedAt` 추가)
|
||||
@@ -1,586 +0,0 @@
|
||||
# Riot 캐싱 Phase 2 플랜
|
||||
|
||||
> **대상**: codex가 이어서 진행 가능한 수준의 실행 플랜
|
||||
> **레포**: `/Users/dahyeon/source/lolympus-tournament-support` (pnpm workspace)
|
||||
> **작성 기준**: 2026-04-25
|
||||
> **선행 작업**: dakao NATS 통합, RiotAccountEnrichmentService(force=true 동기 호출, summoner/league/mastery v4) 1차 구현 완료
|
||||
|
||||
---
|
||||
|
||||
## 1. Context
|
||||
|
||||
dakao 카카오톡 명령(`!내전 신청 ...`) 이 들어오면 라이엇 ID를 검증·등록하고, 동시에 summoner v4 / league v4 / champion-mastery v4 데이터를 가져와 `User.riotAccounts[*]` 임베딩에 캐싱하는 1차 구현이 끝난 상태입니다.
|
||||
|
||||
이 플랜은 그 위에 다음을 더합니다.
|
||||
|
||||
1. **community별 default platform 지정** + region/by-puuid 기반 자동 보정
|
||||
2. **champion-mastery top 10** 으로 좁히고 스키마를 Riot DTO 그대로
|
||||
3. **league 변동 시 tierHistory 자동 누적**
|
||||
4. **사용자 수동 갱신 엔드포인트 + 한가한 시간대 스케줄러**
|
||||
5. **신선도 표시(API 응답에 `*FetchedAt` 노출)**
|
||||
6. **무거운 필드(`championRecords`, `tiers`)는 list/find 쿼리에서 projection 으로 잘라내기**
|
||||
7. **동일 puuid 동시 enrichment dedup**
|
||||
8. **v4 서비스 응답 파서 단위 테스트**
|
||||
|
||||
비목표:
|
||||
|
||||
- Rate limit 글로벌 throttle (token bucket / Redis) — Phase 3
|
||||
- OpenSearch / Slack 운영 알림 — Phase 3
|
||||
- 백오피스 UI — 별도 트랙
|
||||
|
||||
---
|
||||
|
||||
## 2. 결정된 설계 사항
|
||||
|
||||
### 2.1 Riot Schema 우선 (Data Dragon 호환)
|
||||
|
||||
기존 `ChampionMasteryEntry`, `TierInfo`, `TierHistoryEntry` 를 Riot v4 응답 그대로 매칭하도록 재정의합니다.
|
||||
|
||||
**현재 (수정 전)**
|
||||
|
||||
```ts
|
||||
export interface ChampionMasteryEntry {
|
||||
championId: string; // ← Riot 은 number
|
||||
championName?: string; // ← Riot 응답에 없음
|
||||
level: number; // ← championLevel
|
||||
points: number; // ← championPoints
|
||||
}
|
||||
|
||||
export interface TierInfo {
|
||||
queueType: string;
|
||||
tier: string;
|
||||
rank: string;
|
||||
leaguePoints: number;
|
||||
wins: number;
|
||||
losses: number;
|
||||
fetchedAt: Date;
|
||||
}
|
||||
```
|
||||
|
||||
**목표 (수정 후)**
|
||||
|
||||
```ts
|
||||
// Riot Champion-Mastery-V4 DTO 그대로
|
||||
export interface ChampionMasteryEntry {
|
||||
puuid: string;
|
||||
championId: number;
|
||||
championLevel: number;
|
||||
championPoints: number;
|
||||
lastPlayTime?: number;
|
||||
championPointsSinceLastLevel?: number;
|
||||
championPointsUntilNextLevel?: number;
|
||||
markRequiredForNextLevel?: number;
|
||||
tokensEarned?: number;
|
||||
championSeasonMilestone?: number;
|
||||
milestoneGrades?: string[];
|
||||
nextSeasonMilestone?: Record<string, unknown>;
|
||||
}
|
||||
|
||||
// Riot League-V4 entries DTO + 우리 측 fetchedAt
|
||||
export interface TierInfo {
|
||||
leagueId: string;
|
||||
queueType: string;
|
||||
tier: string;
|
||||
rank: string;
|
||||
puuid: string;
|
||||
leaguePoints: number;
|
||||
wins: number;
|
||||
losses: number;
|
||||
veteran?: boolean;
|
||||
inactive?: boolean;
|
||||
freshBlood?: boolean;
|
||||
hotStreak?: boolean;
|
||||
miniSeries?: Record<string, unknown>;
|
||||
fetchedAt: Date;
|
||||
}
|
||||
|
||||
// 시점별 tier 스냅샷
|
||||
export interface TierHistoryEntry {
|
||||
queueType: string;
|
||||
tier: string;
|
||||
rank?: string;
|
||||
leaguePoints?: number;
|
||||
wins?: number;
|
||||
losses?: number;
|
||||
recordedAt: Date;
|
||||
// 시즌 단위 통계 / peak (옵션)
|
||||
season?: string;
|
||||
peakTier?: string;
|
||||
peakRank?: string;
|
||||
}
|
||||
```
|
||||
|
||||
`championRecords` 는 챔피언별 *집계 데이터(향후 매치 분석)* 용으로 유지하되, **mastery 원본은 더 이상 `championRecords` 에 중복 저장하지 않습니다.** mastery 자체가 이제 Riot DTO 형태이기 때문입니다.
|
||||
|
||||
기존 schema 의 `RiotAccount.championRecords` 와 `RiotAccount.championRecordsFetchedAt` 는 그대로 둡니다 (다른 용도).
|
||||
|
||||
### 2.2 community 별 default platform
|
||||
|
||||
```ts
|
||||
export interface Community extends MongooseTimestamps {
|
||||
// ...
|
||||
riotPlatform?: RiotPlatformRoute; // default 'kr'
|
||||
riotRegion?: RiotRegionalRoute; // default 'asia'
|
||||
}
|
||||
```
|
||||
|
||||
- platform 기본 `kr`, region 기본 `asia` 는 코드 상 fallback. 명시 지정 시 community 설정값 우선.
|
||||
- enrichment / lookup 시 community 의 platform 을 사용.
|
||||
- 추가로 puuid 만 있는 상황(예: 다른 community 매치 import)에서는 region/by-puuid 로 platform 보정.
|
||||
|
||||
### 2.3 region/by-puuid 자동 보정
|
||||
|
||||
> `GET https://{regional}.api.riotgames.com/riot/account/v1/region/by-game/lol/by-puuid/{puuid}` → `{ puuid, game, region }`
|
||||
|
||||
- 응답의 `region` 이 platform 코드 (`kr`, `na1`, …)
|
||||
- 사용 시점: community 의 platform 과 puuid 의 실제 platform 이 다른지 의심될 때 (예: 처음 등록 시, summoner v4 404 발생 시)
|
||||
- 새 서비스: `RiotAccountService.getRegionByPuuid(puuid, options)`
|
||||
- enrichment fallback 정책: summoner v4 가 404 면 region/by-puuid 호출해서 platform 보정 후 한 번 더 시도, 그래도 실패면 failed 처리
|
||||
|
||||
### 2.4 mastery top 10
|
||||
|
||||
- 엔드포인트 변경: `/lol/champion-mastery/v4/champion-masteries/by-puuid/{puuid}/top?count=10`
|
||||
- 저장 상한 10. `MASTERY_LIMIT = 10`.
|
||||
- `RiotChampionMasteryService.getTopByPuuid(puuid, { platform, count })` 신규 메서드. 기존 `getByPuuid` 는 leftover/내부용으로 유지하거나 삭제 (사용처 확인 후 결정).
|
||||
|
||||
### 2.5 tierHistory 누적 규칙
|
||||
|
||||
- enrichment 가 league entries 를 갱신할 때, **queueType 별로 가장 최근 history entry 와 비교**하여 다음 중 하나라도 다르면 history 에 push:
|
||||
- `tier`, `rank`
|
||||
- `leaguePoints` 변화 (옵션 — 너무 잦으면 noise. 1차에선 tier/rank 변화만 추적)
|
||||
- 1차 결정: **tier 또는 rank 가 변하면 push**. lp 변화는 history 에 안 남김.
|
||||
- 신규 등록 시(history 비어있음)는 첫 league fetch 결과를 그대로 history 에 1건 push.
|
||||
- `recordedAt = new Date()`.
|
||||
- queueType 외 다른 분류는 도입하지 않음. season 추적은 별도 작업.
|
||||
|
||||
### 2.6 신선도 노출 (`*FetchedAt`)
|
||||
|
||||
API 응답(`GET /users/:id`, `/me`, `/communities/:id/matches/:id` 등)에 RiotAccount 가 포함될 때 다음 필드를 함께 노출:
|
||||
|
||||
- `tiers[*].fetchedAt`
|
||||
- `championMasteriesFetchedAt`
|
||||
- `revisionDate` (summoner)
|
||||
- `championRecordsFetchedAt`
|
||||
|
||||
스키마 상 이미 존재하므로 변경 불필요. 단, **list 쿼리에서는 무거운 raw 필드(`championRecords`, `championMasteries[*].milestoneGrades` 등) 는 projection 으로 제외**. (2.8 참조)
|
||||
|
||||
### 2.7 수동 갱신 + 스케줄러
|
||||
|
||||
**HTTP 엔드포인트**
|
||||
|
||||
```
|
||||
POST /users/me/riot-accounts/:puuid/refresh
|
||||
Body: { force?: boolean, platform?: RiotPlatformRoute }
|
||||
Auth: 본인 또는 admin
|
||||
Response: EnrichResult
|
||||
```
|
||||
|
||||
- 본인 또는 community admin 이상만 허용.
|
||||
- `force = true` 면 TTL 무시.
|
||||
- platform 지정 시 community default 무시.
|
||||
|
||||
**스케줄러**
|
||||
|
||||
- NestJS `@nestjs/schedule` (cron) 도입.
|
||||
- 작업명: `RiotAccountRefreshScheduler`
|
||||
- 실행 주기: 매일 KST 04:00 ~ 06:00 사이에 chunked 실행
|
||||
- 대상 선정:
|
||||
- `tiers[*].fetchedAt` 가 24h 초과 또는 비어있는 RiotAccount
|
||||
- 한 batch 당 최대 200건, batch 간 5초 간격
|
||||
- enrichment 호출 시 `force = false` (TTL 기반)
|
||||
- per-batch try/catch + 실패 카운터 로그
|
||||
- `@Cron('0 4 * * *')` 단일 트리거로 시작 → 추후 batch 분산은 Phase 3 에서 보강
|
||||
|
||||
### 2.8 list/find projection 정책
|
||||
|
||||
`apps/api/src/modules/global/database/projection.ts` 신설하여 공통 projection 상수를 모음.
|
||||
|
||||
```ts
|
||||
// 매치 리스트, /me 등에서 RiotAccount 의 무거운 필드를 잘라낸다
|
||||
export const RIOT_ACCOUNT_LIGHT_PROJECTION = {
|
||||
'riotAccounts.championRecords': 0,
|
||||
'riotAccounts.championRecordsFetchedAt': 0,
|
||||
// championMasteries 자체는 살리되 milestoneGrades 등 무거운 nested 는 protected list 에서만 fetch
|
||||
} as const;
|
||||
```
|
||||
|
||||
- 적용 대상: `MatchService.list`, `UserController.list`, `MatchController.listMatches` 등
|
||||
- 단건 조회(`getById`, `/me`) 는 풀 데이터 포함
|
||||
|
||||
### 2.9 동일 puuid 동시 enrichment dedup
|
||||
|
||||
**채택 방식**: in-memory `Map<puuid, Promise<EnrichResult>>` (단일 인스턴스 dedup)
|
||||
|
||||
```ts
|
||||
private inFlight = new Map<string, Promise<EnrichResult>>();
|
||||
|
||||
public enrichRiotAccount(params): Promise<EnrichResult> {
|
||||
const key = params.puuid;
|
||||
const existing = this.inFlight.get(key);
|
||||
if (existing) return existing;
|
||||
const promise = this.doEnrich(params).finally(() => {
|
||||
this.inFlight.delete(key);
|
||||
});
|
||||
this.inFlight.set(key, promise);
|
||||
return promise;
|
||||
}
|
||||
```
|
||||
|
||||
이유:
|
||||
|
||||
- 카카오 신청 빈도가 낮아 분산 락까지 필요 없음.
|
||||
- 동일 인스턴스 내 race(동시 신청)만 막아도 90%의 중복 호출 절감.
|
||||
- 멀티 인스턴스 환경 dedup 은 Phase 3 (Redis SET NX) 에서.
|
||||
|
||||
**대안 비교 (참고)**
|
||||
|
||||
| 방식 | 장점 | 단점 |
|
||||
| --- | --- | --- |
|
||||
| in-memory Map | 의존성 없음, 빠름 | 멀티 인스턴스 미지원 |
|
||||
| Mongo `findOneAndUpdate` 락 | 의존성 없음, 분산 가능 | 실패 시 락 만료 처리 복잡, 추가 필드 필요 |
|
||||
| Redis SET NX EX | 분산 / TTL 자연스러움 | Redis 인프라 필요 |
|
||||
|
||||
### 2.10 v4 파서 단위 테스트
|
||||
|
||||
- `riot-summoner.service.spec.ts`
|
||||
- `riot-league.service.spec.ts`
|
||||
- `riot-champion-mastery.service.spec.ts`
|
||||
|
||||
각각 정상 응답 / 누락 필드 거부 / 빈 배열 / 타입 불일치 거부 케이스.
|
||||
|
||||
---
|
||||
|
||||
## 3. 실행 단계 (codex 진행 순서)
|
||||
|
||||
작업 단위는 PR 단위로 쪼갤 수 있도록 분리되어 있습니다. 단계 간 의존성이 있는 부분은 명시.
|
||||
|
||||
### Step 1. 스키마 재정의 (TierInfo / ChampionMasteryEntry / TierHistoryEntry)
|
||||
|
||||
**파일**: `apps/api/src/modules/global/database/schema.ts`
|
||||
|
||||
1. `TierInfo`, `TierHistoryEntry`, `ChampionMasteryEntry` 인터페이스 위 2.1 정의로 교체.
|
||||
2. `TierInfoSubSchema`, `TierHistoryEntrySubSchema`, `ChampionMasteryEntrySubSchema` 도 동일하게 갱신.
|
||||
- `championId`: `Number` 로 변경
|
||||
- `championLevel`, `championPoints`: 새 필드명
|
||||
- `milestoneGrades`: `[String]` (default `undefined`)
|
||||
- `nextSeasonMilestone`: `Schema.Types.Mixed`
|
||||
- `TierInfo` 에 `leagueId`, `puuid`, `veteran`, `inactive`, `freshBlood`, `hotStreak`, `miniSeries(Mixed)` 추가
|
||||
- `TierHistoryEntry` 에 `recordedAt: { type: Date, required: true }`, `leaguePoints/wins/losses` optional
|
||||
3. `Community` 에 `riotPlatform`, `riotRegion` 추가:
|
||||
|
||||
```ts
|
||||
riotPlatform: { type: String },
|
||||
riotRegion: { type: String },
|
||||
```
|
||||
|
||||
4. `MatchParticipantSubSchema.tier` 는 새 `TierInfo` 모양을 자동으로 따라감 — 추가 변경 없음.
|
||||
|
||||
**Risk**: 기존 데이터가 있다면 마이그레이션 필요. 현재 dev 환경 seed 만 사용한다면 seed 재실행으로 충분. `apps/api/src/seed.ts` 도 새 필드명에 맞춰 갱신.
|
||||
|
||||
**테스트**: 타입체크 통과 확인.
|
||||
|
||||
### Step 2. RiotChampionMasteryService → top 엔드포인트로 변경
|
||||
|
||||
**파일**: `apps/api/src/modules/riot/riot-champion-mastery.service.ts`
|
||||
|
||||
1. 메서드 시그니처 변경 또는 신규:
|
||||
|
||||
```ts
|
||||
public async getTopByPuuid(
|
||||
puuid: string,
|
||||
options: { platform?: RiotPlatformRoute; count?: number; signal?: AbortSignal } = {},
|
||||
): Promise<RiotChampionMasteryDto[]>
|
||||
```
|
||||
|
||||
엔드포인트: `/lol/champion-mastery/v4/champion-masteries/by-puuid/{puuid}/top`
|
||||
query: `count` (default 10, max 10)
|
||||
|
||||
2. 기존 `getByPuuid` 사용처 grep 후 모두 `getTopByPuuid` 로 교체.
|
||||
3. `riot-account-enrichment.service.ts` 에서 `MASTERY_LIMIT = 10` 으로 변경.
|
||||
|
||||
### Step 3. region/by-puuid 서비스 + 자동 보정
|
||||
|
||||
**파일**: `apps/api/src/modules/riot/riot-account.service.ts`
|
||||
|
||||
```ts
|
||||
public async getRegionByPuuid(
|
||||
puuid: string,
|
||||
options: RiotAccountLookupOptions = {},
|
||||
): Promise<{ puuid: string; game: string; region: RiotPlatformRoute }> {
|
||||
return this.riotClientService.get(
|
||||
`/riot/account/v1/region/by-game/lol/by-puuid/${encodeURIComponent(puuid)}`,
|
||||
{ region: options.region ?? 'asia', signal: options.signal },
|
||||
parseRegionByPuuid,
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
`riot.types.ts` 에 응답 타입 추가:
|
||||
|
||||
```ts
|
||||
export interface RiotAccountRegionDto {
|
||||
puuid: string;
|
||||
game: 'lol' | string;
|
||||
region: RiotPlatformRoute;
|
||||
}
|
||||
```
|
||||
|
||||
**enrichment 보정 로직**:
|
||||
|
||||
`RiotAccountEnrichmentService.fetchSummonerSafe` 에서 `RiotApiError && status === 404` 발생 시:
|
||||
|
||||
1. `getRegionByPuuid` 호출
|
||||
2. 받은 platform 으로 다시 summoner 호출
|
||||
3. 그래도 실패면 `failed` 처리
|
||||
4. 새 platform 이 community default 와 다르면 로그(`logger.warn`) — 향후 schema 에 puuid 별 platform 저장 여부는 별도 결정
|
||||
|
||||
### Step 4. enrichment dedup + force/TTL 흐름 정리
|
||||
|
||||
**파일**: `apps/api/src/modules/riot/riot-account-enrichment.service.ts`
|
||||
|
||||
1. 클래스에 `private inFlight = new Map<string, Promise<EnrichResult>>()` 추가.
|
||||
2. `enrichRiotAccount` 진입부에서 dedup 체크. key 는 `${userId}:${puuid}` (user 다른데 puuid 같은 케이스도 있으니 user 포함이 안전).
|
||||
3. `applyMasteries` 에서 `championRecords` 채우는 코드 제거 (2.1 결정).
|
||||
4. `applyLeagueEntries` 호출 직전 `tierHistory` 갱신 헬퍼 호출:
|
||||
|
||||
```ts
|
||||
private appendTierHistoryIfChanged(
|
||||
account: RiotAccount,
|
||||
entries: RiotLeagueEntryDto[],
|
||||
): void {
|
||||
const now = new Date();
|
||||
for (const e of entries) {
|
||||
const last = [...account.tierHistory]
|
||||
.reverse()
|
||||
.find((h) => h.queueType === e.queueType);
|
||||
const changed =
|
||||
!last ||
|
||||
last.tier !== e.tier ||
|
||||
(last.rank ?? '') !== (e.rank ?? '');
|
||||
if (changed) {
|
||||
account.tierHistory.push({
|
||||
queueType: e.queueType,
|
||||
tier: e.tier,
|
||||
rank: e.rank,
|
||||
leaguePoints: e.leaguePoints,
|
||||
wins: e.wins,
|
||||
losses: e.losses,
|
||||
recordedAt: now,
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
5. 위 헬퍼는 `applyLeagueEntries` 가 처음 호출되더라도 빈 history → 첫 entry push 가 자연스럽게 일어남.
|
||||
|
||||
### Step 5. community.platform 사용 + DakaoUserService 연결
|
||||
|
||||
**파일**:
|
||||
|
||||
- `apps/api/src/modules/dakao/dakao-user.service.ts`
|
||||
- `apps/api/src/modules/dakao/handlers/match-join.handler.ts` (필요 시)
|
||||
|
||||
1. `resolveRiotAccount` 가 community 를 한 번 조회해서 `riotPlatform`, `riotRegion` 을 옵션으로 enrichment / Riot lookup 에 전달.
|
||||
2. `RiotAccountService.getByRiotId` 에 `region` 옵션 전달 (community.riotRegion 우선, fallback `asia`).
|
||||
3. enrichment 호출에도 `platform: community.riotPlatform ?? 'kr'`.
|
||||
|
||||
```ts
|
||||
const community = await CommunityModel.findById(context.communityId)
|
||||
.select({ riotPlatform: 1, riotRegion: 1 })
|
||||
.lean()
|
||||
.exec();
|
||||
const platform = (community?.riotPlatform as RiotPlatformRoute) ?? 'kr';
|
||||
const region = (community?.riotRegion as RiotRegionalRoute) ?? 'asia';
|
||||
```
|
||||
|
||||
### Step 6. 수동 갱신 엔드포인트
|
||||
|
||||
**신규 파일**: `apps/api/src/modules/user/user.controller.ts` (이미 존재) 에 라우트 추가, 또는 `riot-account.controller.ts` 신설.
|
||||
|
||||
- 기존 `user.module.ts` / `user.controller.ts` 구조 확인 (현재 `user/user.controller.ts`, `user/user.module.ts` 존재).
|
||||
- 라우트:
|
||||
|
||||
```ts
|
||||
@Post('me/riot-accounts/:puuid/refresh')
|
||||
async refreshMyRiotAccount(
|
||||
@CurrentUser() me: UserDocument,
|
||||
@Param('puuid') puuid: string,
|
||||
@Body() body: { force?: boolean; platform?: RiotPlatformRoute },
|
||||
): Promise<EnrichResult> {
|
||||
if (!me) throw new UnauthorizedException();
|
||||
const owns = me.riotAccounts.some((a) => a.puuid === puuid);
|
||||
if (!owns) throw new ForbiddenException();
|
||||
return this.enrichmentService.enrichRiotAccount({
|
||||
userId: me._id,
|
||||
puuid,
|
||||
options: { force: body.force === true, platform: body.platform },
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
- `UserModule.imports` 에 `RiotModule` 추가 (이미 RiotModule 이 `RiotAccountEnrichmentService` export 함).
|
||||
- DTO: `class-validator` 기반 `RefreshRiotAccountDto`.
|
||||
|
||||
### Step 7. 스케줄러
|
||||
|
||||
**의존성**: `pnpm --filter api add @nestjs/schedule`
|
||||
|
||||
**신규 파일**: `apps/api/src/modules/riot/riot-account-refresh.scheduler.ts`
|
||||
|
||||
```ts
|
||||
@Injectable()
|
||||
export class RiotAccountRefreshScheduler {
|
||||
private readonly logger = new Logger(RiotAccountRefreshScheduler.name);
|
||||
|
||||
constructor(
|
||||
private readonly connectionService: ConnectionService,
|
||||
private readonly enrichment: RiotAccountEnrichmentService,
|
||||
) {}
|
||||
|
||||
@Cron('0 4 * * *', { timeZone: 'Asia/Seoul' })
|
||||
async refreshStaleAccounts() {
|
||||
const UserModel = await this.connectionService.getModel('user');
|
||||
const cursor = UserModel.find({
|
||||
'riotAccounts.0': { $exists: true },
|
||||
})
|
||||
.select({ _id: 1, riotAccounts: 1, communityId: 1 })
|
||||
.cursor();
|
||||
|
||||
let processed = 0;
|
||||
for await (const user of cursor) {
|
||||
for (const acc of user.riotAccounts) {
|
||||
try {
|
||||
await this.enrichment.enrichRiotAccount({
|
||||
userId: user._id,
|
||||
puuid: acc.puuid,
|
||||
options: { force: false },
|
||||
});
|
||||
processed += 1;
|
||||
if (processed % 50 === 0) {
|
||||
await sleep(5000);
|
||||
}
|
||||
} catch (err) {
|
||||
this.logger.warn(`refresh failed: ${(err as Error)?.message ?? err}`);
|
||||
}
|
||||
}
|
||||
}
|
||||
this.logger.log(`Scheduler done: processed=${processed}`);
|
||||
}
|
||||
}
|
||||
|
||||
function sleep(ms: number) {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
```
|
||||
|
||||
`RiotModule.providers` 에 추가, `app.module.ts` 에 `ScheduleModule.forRoot()` 추가.
|
||||
|
||||
### Step 8. projection 적용
|
||||
|
||||
**신규 파일**: `apps/api/src/modules/global/database/projections.ts`
|
||||
|
||||
```ts
|
||||
export const USER_LIGHT_PROJECTION = {
|
||||
'riotAccounts.championRecords': 0,
|
||||
'riotAccounts.championRecordsFetchedAt': 0,
|
||||
} as const;
|
||||
```
|
||||
|
||||
**적용 지점**:
|
||||
|
||||
- `MatchService.list` — 매치 자체에는 RiotAccount 가 없지만 향후 populate 시 사용
|
||||
- 신규 `UserService.list` 또는 `findByCommunity` 류 — projection 적용
|
||||
- `/me` 핸들러 — full 데이터 유지
|
||||
- `/users/:id` 단건 조회 — full 데이터 유지
|
||||
|
||||
대부분의 `riotAccounts.*` 가 무거워지는 시점이 mastery top 10 + tierHistory 누적이므로, 우선 list 쿼리에만 적용.
|
||||
|
||||
### Step 9. v4 파서 단위 테스트
|
||||
|
||||
**신규 파일**:
|
||||
|
||||
- `apps/api/src/modules/riot/riot-summoner.service.spec.ts`
|
||||
- `apps/api/src/modules/riot/riot-league.service.spec.ts`
|
||||
- `apps/api/src/modules/riot/riot-champion-mastery.service.spec.ts`
|
||||
|
||||
각 서비스에 RiotClientService mock 주입, 정상/누락 필드/배열 비정상 케이스 검증. enrichment 의 적용 단계는 기존 `riot-account-enrichment.service.spec.ts` 에서 이미 커버 중이므로, **Step 1 변경에 따라 기존 spec 의 응답 fixture 도 새 필드명으로 갱신** 필요.
|
||||
|
||||
### Step 10. 회귀 테스트 / 정리
|
||||
|
||||
1. `npx tsc --noEmit` 통과
|
||||
2. `npx jest` 전체 PASS
|
||||
3. seed 재실행으로 새 스키마 정상 작동 확인
|
||||
4. dakao 시나리오 수동 검증:
|
||||
- 신규 카카오 사용자가 `!내전 신청 ...` 으로 등록될 때 summoner v4 가 한 번 호출되고, 응답 후 user 문서에 `tiers`, `championMasteries`(10건), `tierHistory`(1건) 가 채워지는지 확인
|
||||
- 같은 사용자가 즉시 재신청하면 enrichment 가 dedup 으로 단일 호출에 합쳐지는지 로그로 확인
|
||||
- 한 시즌 후 tier 가 변경된 상태에서 enrichment 가 호출되면 `tierHistory` 에 새 entry 가 push 되는지 단위 테스트
|
||||
|
||||
---
|
||||
|
||||
## 4. 변경/추가 파일 목록
|
||||
|
||||
### 신규
|
||||
|
||||
- `apps/api/src/modules/global/database/projections.ts`
|
||||
- `apps/api/src/modules/riot/riot-account-refresh.scheduler.ts`
|
||||
- `apps/api/src/modules/riot/riot-summoner.service.spec.ts`
|
||||
- `apps/api/src/modules/riot/riot-league.service.spec.ts`
|
||||
- `apps/api/src/modules/riot/riot-champion-mastery.service.spec.ts`
|
||||
- (옵션) `apps/api/src/modules/user/dto/refresh-riot-account.dto.ts`
|
||||
|
||||
### 수정
|
||||
|
||||
- `apps/api/src/modules/global/database/schema.ts` — TierInfo / TierHistoryEntry / ChampionMasteryEntry / Community 재정의
|
||||
- `apps/api/src/modules/riot/riot.types.ts` — DTO 타입, RiotAccountRegionDto 추가
|
||||
- `apps/api/src/modules/riot/riot-account.service.ts` — `getRegionByPuuid` 추가
|
||||
- `apps/api/src/modules/riot/riot-champion-mastery.service.ts` — `getTopByPuuid` 로 교체
|
||||
- `apps/api/src/modules/riot/riot-account-enrichment.service.ts` — 새 스키마 적용, dedup, tierHistory 누적, 404 보정
|
||||
- `apps/api/src/modules/riot/riot.module.ts` — Scheduler / region service provider 등록
|
||||
- `apps/api/src/modules/dakao/dakao-user.service.ts` — community platform/region 사용
|
||||
- `apps/api/src/modules/user/user.controller.ts` (또는 신설) — `/me/riot-accounts/:puuid/refresh`
|
||||
- `apps/api/src/modules/user/user.module.ts` — RiotModule import
|
||||
- `apps/api/src/modules/match/match.service.ts` — list 쿼리 projection
|
||||
- `apps/api/src/app.module.ts` — `ScheduleModule.forRoot()`
|
||||
- `apps/api/src/seed.ts` — 새 mastery / tier 필드명에 맞춰 seed 데이터 수정
|
||||
- `apps/api/src/modules/riot/riot-account-enrichment.service.spec.ts` — fixture 갱신
|
||||
|
||||
### 의존성
|
||||
|
||||
- `pnpm --filter api add @nestjs/schedule`
|
||||
|
||||
---
|
||||
|
||||
## 5. 검증 체크리스트
|
||||
|
||||
- [ ] `pnpm --filter api exec tsc --noEmit` 통과
|
||||
- [ ] `pnpm --filter api exec jest` 전체 PASS
|
||||
- [ ] seed 재실행 후 user 문서 정상 (`db.user.findOne()` 으로 새 필드 확인)
|
||||
- [ ] dakao `!내전 신청 <id> <기존_등록_riot_id> 미드,탑` → enrichment 캐시 hit, Riot API 호출 0회
|
||||
- [ ] dakao `!내전 신청 <id> <신규_riot_id> 미드,탑` → summoner v4 1회, league v4 1회, mastery top v4 1회 호출, user 문서에 tiers/masteries/tierHistory 채워짐
|
||||
- [ ] `POST /users/me/riot-accounts/:puuid/refresh { force: true }` → enrichment 수동 강제 갱신 동작
|
||||
- [ ] cron 시뮬레이션 (`@Cron` 수동 트리거 또는 `node -e` 로 메서드 직접 호출) → 200건 이상 처리되어도 OOM/timeout 없이 완료
|
||||
- [ ] match list API 응답 사이즈 → projection 적용으로 기존 대비 30%+ 감소 (실측)
|
||||
- [ ] 동시 동일 puuid enrichment 두 번 호출 → in-flight Map 으로 1회로 합쳐짐 (단위 테스트)
|
||||
|
||||
---
|
||||
|
||||
## 6. Phase 3 으로 미루는 것 (참고)
|
||||
|
||||
- **분산 dedup** (Redis SET NX EX 또는 mongo 락)
|
||||
- **Token bucket / Riot API rate limit** 글로벌 throttle
|
||||
- **OpenSearch 인덱싱** (RiotAccount, Match 변화 로그)
|
||||
- **Slack 알림** (enrichment 실패 임계 초과, scheduler 실패)
|
||||
- **puuid 별 last-known platform 캐싱** (Step 3 의 보정 결과를 RiotAccount 에 영구 저장)
|
||||
- **시즌 종료 시 tierHistory 의 `season` 필드 자동 채움** + peakTier 계산
|
||||
- **백오피스 UI** — community.riotPlatform 설정 / 수동 갱신 트리거 / 신선도 리포트
|
||||
- **NATS 기반 enrichment 분산** (현재 dakao 외 트리거가 없으므로 보류)
|
||||
|
||||
---
|
||||
|
||||
## 7. 운영 노트
|
||||
|
||||
- Riot personal API key 는 **개당 100req / 2분 / IP** 한도. mastery + summoner + league 가 1 user attach 당 3회. dakao 첫 신청이 폭주해도 분당 ~30명 미만이면 무탈.
|
||||
- 스케줄러는 5초 간격 batch 50건 → 10분에 6000건. 대부분의 community 규모에서 충분.
|
||||
- region/by-puuid 보정은 community 의 platform 이 잘못 설정된 케이스에서 운영자가 즉시 알 수 있도록 `logger.warn` 만 남김. Phase 3 에서 알림 채널로 승격.
|
||||
- `championRecords` 와 `championRecordsFetchedAt` 은 비워두는 채로 schema 만 유지. mastery 와는 다른 용도(향후 매치 분석 집계)이므로 충돌 없음.
|
||||
@@ -1,572 +0,0 @@
|
||||
# 토너먼트 코드 풀 / 표시 플랜
|
||||
|
||||
> **대상**: codex 가 이어서 작업 가능한 수준의 실행 플랜
|
||||
> **레포**: `/Users/dahyeon/source/lolympus-tournament-support` (pnpm workspace)
|
||||
> **작성 기준**: 2026-04-27
|
||||
|
||||
---
|
||||
|
||||
## 1. Context
|
||||
|
||||
내전이 `team-built` 상태가 되면 5명씩 게임에 입장할 수 있도록 **토너먼트 코드** 1개를 매치에 발급해 표시해야 합니다.
|
||||
|
||||
**제약** — Riot Tournament-Stub-V5 사용 권한 없음. 우회:
|
||||
|
||||
1. 외부 서비스(별도 운영) 가 토너먼트 코드를 미리 수십~수백 개 생성.
|
||||
2. 운영자가 그 코드를 우리 Admin UI 에 **수동 업로드** → 풀에 적재.
|
||||
3. 매치가 `team-built` 으로 전환되는 순간 풀에서 atomic pop → 매치에 attach.
|
||||
4. (Phase 후속) 게임 끝난 후 `match-v5` detail 의 `info.tournamentCode` 필드로 우리 코드와 매칭해 매치 결과 수집.
|
||||
|
||||
본 plan 은 1~3 까지. 4 는 §5.E 에 자리만.
|
||||
|
||||
---
|
||||
|
||||
## 2. 결정사항 (사용자 결정 2026-04-27)
|
||||
|
||||
- **적재**: 운영자 수동 업로드 → Admin UI 필수
|
||||
- **카테고리**: 5v5 소환사 협곡 단일 (`mapType=SUMMONERS_RIFT`, `teamSize=5`)
|
||||
- **화이트리스트**: 사용 안 함 (`allowedSummonerIds` 미지정)
|
||||
- **만료**: `expiresAt` 보관 + pop 쿼리에 검사 (24h 안전 마진)
|
||||
- **Tournament API**: 사용 불가. 단순 표시만.
|
||||
- **결과 수집**: Phase 후속 — 일반 match-v5 응답의 `info.tournamentCode` 매칭으로 우회
|
||||
- **잔여 알림**: 미구현. 운영자 수동 확인.
|
||||
- **권한**: 코드 자체는 누구나 볼 수 있음. **풀 잔여 통계는 admin 만**.
|
||||
- **풀 비었을 때**: placeholder 표시 + 운영자가 채우면 자동 attach
|
||||
- **데이터 모델**: 별도 `TournamentCode` 컬렉션 + **`Match.tournamentCodeIds[]` 1:N join**
|
||||
- **다게임 구조**: 한 내전 = N 경기 (1경기/2경기/3경기 …). `team-built` 진입 시 N개 코드 atomic 발급
|
||||
- **표시 범위**: `team-built` + `in-progress` 모두 표시. `finished` 에서만 SideCard 숨김
|
||||
- **코드 형식 검증**: 정규식 통과한 코드만 적재 (`/^[A-Z0-9-]{8,}$/i` 1차)
|
||||
- **bulk 업로드 2모드**: 간단(textarea CSV) + 확장(JSON 붙여넣기)
|
||||
|
||||
---
|
||||
|
||||
## 3. 데이터 모델
|
||||
|
||||
### 3.1 TournamentCode (신규 컬렉션)
|
||||
|
||||
```ts
|
||||
// apps/api/src/modules/global/database/schema.ts
|
||||
|
||||
export type TournamentCodeState =
|
||||
| 'available' // 풀에 대기 중
|
||||
| 'reserved' // 매치에 할당됨, 아직 게임 시작 전
|
||||
| 'used' // 게임 시작/종료 — 회수 불가
|
||||
| 'expired' // expiresAt 경과 (cron 으로 마킹)
|
||||
| 'released'; // 매치 취소로 풀 복귀 (재할당 가능)
|
||||
|
||||
export interface TournamentCode extends MongooseTimestamps {
|
||||
code: string; // unique, Riot 형식 (정규식 검증)
|
||||
region: RiotPlatformRoute; // 기본 'kr'
|
||||
mapType: 'SUMMONERS_RIFT';
|
||||
teamSize: number; // 5 고정
|
||||
spectatorType: 'NONE' | 'LOBBYONLY' | 'ALL';
|
||||
metadata?: Record<string, unknown>; // 외부 서비스에서 받은 부가 정보
|
||||
expiresAt: Date; // 운영자 입력 필수
|
||||
|
||||
state: TournamentCodeState;
|
||||
|
||||
// 할당 추적
|
||||
matchId?: mongoose.Types.ObjectId; // reserved/used 시 채워짐
|
||||
gameNumber?: number; // 1-based, 한 매치 안에서 몇 번째 경기인지
|
||||
reservedAt?: Date;
|
||||
usedAt?: Date; // 게임 시작 webhook 또는 결과 수집 시
|
||||
releasedAt?: Date;
|
||||
riotMatchId?: string; // 결과 수집 시 매칭된 match-v5 id (Phase 후속)
|
||||
|
||||
// 운영 추적
|
||||
uploadedBy: mongoose.Types.ObjectId; // userId
|
||||
uploadedAt: Date;
|
||||
source?: string; // 외부 서비스 식별자 (옵션)
|
||||
notes?: string;
|
||||
}
|
||||
|
||||
export const TournamentCodeSchema = new Schema<TournamentCode>(
|
||||
{ /* ... */ },
|
||||
{ timestamps: true, collection: 'tournament_code' },
|
||||
);
|
||||
|
||||
TournamentCodeSchema.index({ code: 1 }, { unique: true });
|
||||
TournamentCodeSchema.index({ state: 1, expiresAt: 1 }); // pop 쿼리
|
||||
TournamentCodeSchema.index({ matchId: 1, gameNumber: 1 }); // join lookup + 정렬
|
||||
TournamentCodeSchema.index({ state: 1, uploadedAt: -1 }); // admin 목록
|
||||
TournamentCodeSchema.index({ riotMatchId: 1 }, { sparse: true }); // 결과 수집 reverse lookup
|
||||
```
|
||||
|
||||
> 모델 등록: `connection.service.ts` 의 `getModel<'tournamentCode'>` 추가.
|
||||
|
||||
#### 3.1.1 코드 형식 정규식 검증
|
||||
|
||||
`/^[A-Z0-9-]{8,}$/i` (영숫자 + 하이픈, 최소 8자). bulk 업로드/수동 추가 시 통과 못 한 코드는 응답의 `invalid` 배열에 포함, DB 적재 X. 정규식은 `tournament-code.constants.ts` 에 상수로 분리.
|
||||
|
||||
### 3.2 Match 확장
|
||||
|
||||
```ts
|
||||
// schema.ts Match 추가
|
||||
gameCount: number; // 한 내전의 경기 수 (default 3, community 설정에서 snapshot)
|
||||
tournamentCodeIds: mongoose.Types.ObjectId[]; // gameNumber 순서 보장 (length ≤ gameCount)
|
||||
|
||||
// MatchSchema
|
||||
gameCount: { type: Number, required: true, default: 3 },
|
||||
tournamentCodeIds: {
|
||||
type: [{ type: Schema.Types.ObjectId, ref: 'tournamentCode' }],
|
||||
default: [],
|
||||
}
|
||||
```
|
||||
|
||||
#### 3.2.1 Community 확장 (게임 수 기본값)
|
||||
|
||||
```ts
|
||||
// Community
|
||||
matchGameCount?: number; // default 3, 매치 생성 시 snapshot
|
||||
```
|
||||
|
||||
매치 생성 시 `match.gameCount = community.matchGameCount ?? 3`. 매치별 override 도 매치 생성 폼에서 가능.
|
||||
|
||||
#### 3.2.2 API 응답 구조
|
||||
|
||||
```ts
|
||||
// /matches/:id 응답
|
||||
{
|
||||
...match,
|
||||
tournamentCodes: [
|
||||
{ gameNumber: 1, code: 'KR-...', expiresAt: '...', state: 'reserved', riotMatchId: null },
|
||||
{ gameNumber: 2, code: 'KR-...', expiresAt: '...', state: 'reserved', riotMatchId: null },
|
||||
{ gameNumber: 3, code: null, expiresAt: null, state: 'pending', riotMatchId: null }, // 풀 부족분
|
||||
],
|
||||
}
|
||||
```
|
||||
|
||||
`gameCount` 만큼 슬롯이 항상 차 있음. 풀 부족 시 코드 자리는 `code: null, state: 'pending'` placeholder. 추후 풀 보충 시 자동 attach.
|
||||
|
||||
---
|
||||
|
||||
## 4. Lifecycle / 트리거 지점
|
||||
|
||||
```
|
||||
upload (admin) atomic pop game start (Phase 후속)
|
||||
│ │ │
|
||||
[available] ─────→ [reserved] ───────────────→ [used]
|
||||
│
|
||||
│ match cancel / re-recruit
|
||||
└──────────→ [released] ──→ [available] (재할당 가능)
|
||||
|
||||
[any state] ──── expiresAt < now ────→ [expired] (cron daily)
|
||||
```
|
||||
|
||||
### 4.1 reserve (`team-built` 전환) — N개 atomic 발급
|
||||
|
||||
- `auction.service.ts:175` (마지막 멤버 배정), `:395` (admin 강제 전환) 두 곳에서 `match.status = 'team-built'` 직후 호출.
|
||||
|
||||
```ts
|
||||
// TournamentCodeService.reserveForMatch(match): 부족분만 보충하는 idempotent 함수
|
||||
const need = match.gameCount - match.tournamentCodeIds.length;
|
||||
if (need <= 0) return;
|
||||
|
||||
const startGameNumber = match.tournamentCodeIds.length + 1;
|
||||
const reservedIds: mongoose.Types.ObjectId[] = [];
|
||||
|
||||
for (let i = 0; i < need; i++) {
|
||||
const code = await TournamentCodeModel.findOneAndUpdate(
|
||||
{
|
||||
state: 'available',
|
||||
region: 'kr',
|
||||
mapType: 'SUMMONERS_RIFT',
|
||||
teamSize: 5,
|
||||
expiresAt: { $gt: new Date(Date.now() + 24 * 60 * 60 * 1000) }, // 24h 안전 마진
|
||||
},
|
||||
{
|
||||
$set: {
|
||||
state: 'reserved',
|
||||
matchId: match._id,
|
||||
gameNumber: startGameNumber + i,
|
||||
reservedAt: new Date(),
|
||||
},
|
||||
},
|
||||
{ sort: { expiresAt: 1 }, new: true }, // 만료 임박순 소비
|
||||
);
|
||||
if (!code) break; // 풀 고갈 — 부분 발급으로 종료
|
||||
reservedIds.push(code._id);
|
||||
}
|
||||
|
||||
if (reservedIds.length > 0) {
|
||||
match.tournamentCodeIds.push(...reservedIds);
|
||||
await match.save();
|
||||
}
|
||||
```
|
||||
|
||||
- 각 호출이 atomic findOneAndUpdate → 두 매치가 같은 코드 받지 않음.
|
||||
- 부족분만 채우는 idempotent 라 `pendingMatches` cron 에서 재호출해도 안전.
|
||||
|
||||
### 4.2 release (`team-built` → `recruiting` 회귀)
|
||||
|
||||
- `auction.service.ts:314-315` 의 회귀 흐름에서 호출.
|
||||
- match cancel/삭제 시에도 호출.
|
||||
|
||||
```ts
|
||||
// TournamentCodeService.releaseFromMatch(match)
|
||||
await TournamentCodeModel.updateMany(
|
||||
{ _id: { $in: match.tournamentCodeIds }, state: 'reserved' },
|
||||
{ $set: { state: 'released', releasedAt: new Date() }, $unset: { matchId: 1, gameNumber: 1 } },
|
||||
);
|
||||
match.tournamentCodeIds = [];
|
||||
await match.save();
|
||||
```
|
||||
|
||||
`used` 상태(이미 게임 시작) 코드는 release 대상에서 제외. `released` 는 admin UI 환원 버튼에서만 `available` 로 돌아옴 (audit 보존).
|
||||
|
||||
### 4.3 expired 마킹 (cron)
|
||||
|
||||
```ts
|
||||
@Cron('0 0 * * * *', { timeZone: 'Asia/Seoul' }) // 매시 정각
|
||||
async markExpired() {
|
||||
await TournamentCodeModel.updateMany(
|
||||
{ state: { $in: ['available', 'reserved', 'released'] }, expiresAt: { $lte: new Date() } },
|
||||
{ $set: { state: 'expired' } },
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
`reserved` 였는데 만료되면 → `expired`. 매치 표시는 "코드 만료됨" placeholder. (희박한 케이스 — 운영자가 매치 시작 직전 코드 안 채웠을 때만)
|
||||
|
||||
### 4.4 placeholder 자동 채우기 (풀 부족분 보충)
|
||||
|
||||
- `team-built` / `in-progress` 인 매치 중 `tournamentCodeIds.length < gameCount` 인 매치 검색 → `reserveForMatch` 재호출 (부족분만 채움).
|
||||
- **트리거 두 곳**:
|
||||
1. **admin 업로드 controller 안에서 직접 실행** — 즉시성 보장
|
||||
2. **cron `@Cron('*/30 * * * * *')`** — 안전망 (30초 간격)
|
||||
|
||||
```ts
|
||||
// TournamentCodeScheduler.attachPending
|
||||
const pendingMatches = await MatchModel.find({
|
||||
status: { $in: ['team-built', 'in-progress'] },
|
||||
$expr: { $lt: [{ $size: '$tournamentCodeIds' }, '$gameCount'] },
|
||||
});
|
||||
for (const match of pendingMatches) await codeService.reserveForMatch(match);
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 변경 사항
|
||||
|
||||
### 5.1 백엔드
|
||||
|
||||
#### 신규 모듈 `apps/api/src/modules/tournament-code/`
|
||||
|
||||
```
|
||||
tournament-code.module.ts
|
||||
tournament-code.service.ts # reserveForMatch / releaseFromMatch / markExpired / bulkUpload / list / delete
|
||||
tournament-code.controller.ts # admin endpoints
|
||||
tournament-code.scheduler.ts # 만료 cron + 자동 attach cron
|
||||
tournament-code.types.ts
|
||||
```
|
||||
|
||||
#### 엔드포인트
|
||||
|
||||
| Method | Path | 권한 | 용도 |
|
||||
|---|---|---|---|
|
||||
| POST | `/communities/:cid/tournament-codes` | `@Roles('owner','admin')` | bulk 업로드 |
|
||||
| GET | `/communities/:cid/tournament-codes` | `@Roles('owner','admin')` | 목록 (state/expiresAt 필터) |
|
||||
| GET | `/communities/:cid/tournament-codes/stats` | `@Roles('owner','admin')` | 풀 잔여 통계 (state 별 카운트 + 만료 임박 카운트) |
|
||||
| DELETE | `/communities/:cid/tournament-codes/:id` | `@Roles('owner','admin')` | 폐기 (state=available 만) |
|
||||
| POST | `/communities/:cid/tournament-codes/:id/release` | `@Roles('owner','admin')` | reserved/released → available 수동 환원 |
|
||||
|
||||
bulk 업로드 body:
|
||||
```ts
|
||||
interface BulkUploadRequest {
|
||||
codes: Array<{
|
||||
code: string; // 공백 trim
|
||||
expiresAt: string; // ISO
|
||||
spectatorType?: 'NONE' | 'LOBBYONLY' | 'ALL'; // 기본 'ALL'
|
||||
metadata?: Record<string, unknown>;
|
||||
source?: string;
|
||||
notes?: string;
|
||||
}>;
|
||||
}
|
||||
```
|
||||
|
||||
응답:
|
||||
```ts
|
||||
interface BulkUploadResponse {
|
||||
inserted: number;
|
||||
duplicates: string[]; // 이미 존재하는 code (skipped)
|
||||
invalid: Array<{ code: string; reason: string }>;
|
||||
}
|
||||
```
|
||||
|
||||
#### 매치 응답에 join
|
||||
|
||||
`match.service.ts` 의 `serializeMatch` (또는 mapper) 에서 `tournamentCodeIds` 를 `populate` 또는 `$lookup` 으로 풀어 `gameNumber` 정렬 + 부족분은 placeholder 슬롯으로 채워서 응답:
|
||||
|
||||
```ts
|
||||
function buildTournamentCodeSlots(
|
||||
match: Match,
|
||||
codes: TournamentCode[],
|
||||
): TournamentCodeSlotView[] {
|
||||
const byNumber = new Map(codes.map((c) => [c.gameNumber!, c]));
|
||||
return Array.from({ length: match.gameCount }, (_, i) => {
|
||||
const gameNumber = i + 1;
|
||||
const code = byNumber.get(gameNumber);
|
||||
return code
|
||||
? {
|
||||
gameNumber,
|
||||
code: code.code,
|
||||
expiresAt: code.expiresAt.toISOString(),
|
||||
state: code.state, // 'reserved' | 'used' | 'expired'
|
||||
riotMatchId: code.riotMatchId ?? null,
|
||||
}
|
||||
: { gameNumber, code: null, expiresAt: null, state: 'pending', riotMatchId: null };
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
#### auction.service 통합
|
||||
|
||||
- `:175`, `:395` 직후 `tournamentCodeService.reserveForMatch(match)` 호출.
|
||||
- `:314-315` 직전 `tournamentCodeService.releaseFromMatch(match)` 호출.
|
||||
|
||||
### 5.2 프런트
|
||||
|
||||
#### 매치 상세 우측 SideCard 추가
|
||||
|
||||
`apps/web/src/pages/MatchDetailPage.tsx` `611~654` 일정/상품/안내사항 SideCard 들 아래에:
|
||||
|
||||
```tsx
|
||||
{match.status !== 'finished' &&
|
||||
(match.status === 'team-built' || match.status === 'in-progress') && (
|
||||
<SideCard title="토너먼트 코드">
|
||||
<TournamentCodeList slots={match.tournamentCodes} />
|
||||
{isAdmin && <PoolStatsHint />} {/* §8.5 운영자에게만 잔여 표시 */}
|
||||
</SideCard>
|
||||
)}
|
||||
```
|
||||
|
||||
`TournamentCodeList` 컴포넌트 — 1경기 / 2경기 / 3경기 식 row:
|
||||
|
||||
```tsx
|
||||
function TournamentCodeList({ slots }: { slots: TournamentCodeSlotView[] }) {
|
||||
return (
|
||||
<div className="space-y-2">
|
||||
{slots.map((slot) => (
|
||||
<TournamentCodeRow key={slot.gameNumber} slot={slot} />
|
||||
))}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function TournamentCodeRow({ slot }: { slot: TournamentCodeSlotView }) {
|
||||
return (
|
||||
<div className="flex items-center gap-2">
|
||||
<span className="text-[11px] font-bold text-base-content/40 w-12 shrink-0">
|
||||
{slot.gameNumber}경기
|
||||
</span>
|
||||
{slot.code ? (
|
||||
<TournamentCodeDisplay slot={slot} />
|
||||
) : (
|
||||
<span className="text-[11px] text-base-content/30">발급 대기 중…</span>
|
||||
)}
|
||||
</div>
|
||||
);
|
||||
}
|
||||
```
|
||||
|
||||
`TournamentCodeDisplay`:
|
||||
- 모노스페이스 코드 + 카피 버튼 (clipboard) + 카피 토스트 ("복사했어요. 게임 클라이언트의 토너먼트 코드 입력란에 붙여 넣으세요")
|
||||
- 만료 시각 ("만료: 4월 30일 18:00")
|
||||
- 만료 24h 이내면 amber 경고
|
||||
- `state === 'expired'` → "코드 만료. 운영자에게 문의해 주세요."
|
||||
- `state === 'used'` → 회색 + "사용됨" 라벨 (다음 경기 코드만 강조)
|
||||
- `riotMatchId` 있으면 hover 시 매치 ID 툴팁 (Phase 후속 결과 수집 후)
|
||||
|
||||
#### types.ts
|
||||
|
||||
```ts
|
||||
export type TournamentCodeSlotState = 'reserved' | 'used' | 'expired' | 'pending';
|
||||
|
||||
export interface TournamentCodeSlotView {
|
||||
gameNumber: number;
|
||||
code: string | null;
|
||||
expiresAt: string | null;
|
||||
state: TournamentCodeSlotState;
|
||||
riotMatchId: string | null;
|
||||
}
|
||||
|
||||
export interface ApiMatch {
|
||||
// ...
|
||||
gameCount: number;
|
||||
tournamentCodes: TournamentCodeSlotView[]; // 항상 length === gameCount
|
||||
}
|
||||
```
|
||||
|
||||
#### Admin 페이지 신규
|
||||
|
||||
`apps/web/src/pages/admin/TournamentCodesPage.tsx`:
|
||||
- 라우트: `/admin/communities/:cid/tournament-codes`
|
||||
- 권한 가드: `useMe` 의 `currentUser.role === 'owner' | 'admin'` 아니면 redirect
|
||||
- 섹션:
|
||||
1. **잔여 현황 카드**: state 별 카운트 (available / reserved / used / expired) + 만료 임박 7일 이내 카운트
|
||||
2. **bulk 업로드 — 2모드 탭**:
|
||||
- **간단**: textarea, 줄당 `code,expiresAt(ISO)` (CSV 1줄). 예: `KR-ABCD-1234,2026-05-30T18:00:00Z`
|
||||
- **확장**: JSON 붙여넣기 (`{spectatorType, metadata, source, notes}` 추가 가능)
|
||||
- 정규식 통과한 코드만 적재, invalid/duplicate 결과 응답 표시
|
||||
3. **목록 테이블**: state 필터 / expiresAt 정렬 / 매치 ID 링크 (`gameNumber` 함께) / 폐기·환원 버튼
|
||||
- 폴링: React Query `refetchInterval: 30s`
|
||||
|
||||
#### SideCard 안의 운영자 잔여 안내 (§8.5)
|
||||
|
||||
`PoolStatsHint` 컴포넌트:
|
||||
- `useMe` 로 admin/owner 판별
|
||||
- 별도 호출 `GET /communities/:cid/tournament-codes/stats` (다음 §)
|
||||
- 표시: "풀 잔여 12개 (만료 임박 3개)" — 5개 미만이면 빨강
|
||||
- admin 페이지로 가는 inline link
|
||||
|
||||
#### 매치 상세 클릭 트리거 — 변경 없음
|
||||
|
||||
기본 `MatchDetailPage` 안에서 자동 표시. 외부 공유 OK 정책 그대로.
|
||||
|
||||
### 5.3 매치 cancel/삭제 시 release
|
||||
|
||||
- `match.service.ts` 의 매치 삭제/취소 흐름에 `releaseFromMatch` 호출.
|
||||
- match status 가 `team-built` → `in-progress` 로 전환되면 **코드 자체는 그대로 reserved 유지**. 게임이 끝나는 시점(Phase 후속 결과 수집)에 `reserved → used` 전환.
|
||||
- `in-progress` 상태에서도 SideCard 표시 유지 (다음 경기 코드 보여주기 위함).
|
||||
|
||||
---
|
||||
|
||||
## 6. 결과 수집 우회 (Phase 후속 — 본 plan 자리만)
|
||||
|
||||
토너먼트 API 못 쓰니까 게임이 끝났는지 알 방법이 없습니다. **`match-v5 by-puuid` 의 `type=tourney` 필터** 를 활용해 호출량/정확도를 끌어올리는 우회 흐름:
|
||||
|
||||
### 6.1 호출 패턴 — `type=tourney` + `startTime` window
|
||||
|
||||
```
|
||||
GET /lol/match/v5/matches/by-puuid/{puuid}/ids
|
||||
?type=tourney
|
||||
&startTime={teamBuiltAtEpochSeconds - 60} // 안전 마진 60초
|
||||
&endTime={now}
|
||||
&start=0
|
||||
&count=100
|
||||
```
|
||||
|
||||
- `type=tourney` 로 **토너먼트 코드로 만들어진 매치만** 필터 → 일반/랭크 매치 제외, payload·detail call 모두 절감.
|
||||
- `startTime` = 매치가 `team-built` 으로 전환된 epoch seconds (안전 마진 60초). `Match.teamBuiltAt: Date` 신규 필드 필요.
|
||||
- `endTime` = 폴링 시점.
|
||||
- `start/count` 페이지네이션은 1차 100 으로 충분 (BO3/BO5 라도 한 매치는 최대 5게임).
|
||||
- `RiotMatchService.getMatchIdsByPuuid` 가 이미 `type: 'tourney'` 를 지원함 (`riot.types.ts:29`, `riot-match.service.ts:21~26`) — 신규 클라이언트 코드 불필요.
|
||||
|
||||
### 6.2 매핑 흐름
|
||||
|
||||
1. 매치가 `team-built` 으로 전환되는 시점에 `Match.teamBuiltAt = now` snapshot.
|
||||
2. **결과 수집 작업 큐** (선행 plan 의 Riot 작업 큐 high stream 재사용) 에 `riot.tournament-result.poll.match` job enqueue. payload: `{matchId, puuids: [캡틴 2명], teamBuiltAtEpoch}`.
|
||||
3. worker:
|
||||
```ts
|
||||
for (const puuid of puuids) {
|
||||
const ids = await matchService.getMatchIdsByPuuid(puuid, {
|
||||
type: 'tourney',
|
||||
startTime: teamBuiltAtEpoch - 60,
|
||||
count: 100,
|
||||
region: 'asia',
|
||||
});
|
||||
for (const matchV5Id of ids) {
|
||||
const detail = await matchService.getMatch(matchV5Id);
|
||||
const tCode = detail.info.tournamentCode;
|
||||
if (!tCode) continue;
|
||||
const code = await TournamentCodeModel.findOneAndUpdate(
|
||||
{ code: tCode, matchId: match._id, state: 'reserved' },
|
||||
{ $set: { state: 'used', usedAt: new Date(detail.info.gameCreation), riotMatchId: matchV5Id } },
|
||||
{ new: true },
|
||||
);
|
||||
if (code) await maybeAdvanceMatch(match); // 모든 슬롯 used 면 finished 전환
|
||||
}
|
||||
}
|
||||
```
|
||||
4. **재폴링 정책**: 결과를 모두 못 찾았으면 5분 후 재 enqueue (예: 첫 polling 후 1시간 동안 5분 간격 재시도, 그 후 1시간 간격으로 24시간까지). 24h 내 못 찾으면 `state = 'expired'` 마킹 + 운영자 알림 자리.
|
||||
5. **dedup**: 매치당 jobId 단일 (`riot:tourney-poll:dedup:<matchId>` Garnet NX). 한 매치는 한 polling 체인.
|
||||
|
||||
### 6.3 finished 전환
|
||||
|
||||
```ts
|
||||
async function maybeAdvanceMatch(match: Match) {
|
||||
const codes = await TournamentCodeModel.find({ matchId: match._id }).sort({ gameNumber: 1 });
|
||||
if (codes.length < match.gameCount) return;
|
||||
if (!codes.every((c) => c.state === 'used' && c.riotMatchId)) return;
|
||||
|
||||
match.status = 'finished';
|
||||
match.result = match.result ?? defaultResult();
|
||||
match.result.riotMatchIds = codes.map((c) => c.riotMatchId!);
|
||||
// 승패/스코어는 별도 결과 집계 단계 (이번 PR 범위 외)
|
||||
await match.save();
|
||||
}
|
||||
```
|
||||
|
||||
### 6.4 본 plan 에서 미리 준비할 것
|
||||
|
||||
- `Match.teamBuiltAt: Date` 필드 추가 (PR-1 에서 같이) — 결과 수집 시 `startTime` 으로 사용.
|
||||
- `TournamentCode.riotMatchId` 필드 + sparse 인덱스 (이미 §3.1).
|
||||
- `gameNumber` 로 어느 경기 결과인지 매핑 가능 (운영자가 코드를 1경기/2경기 순서대로 발급한 가정).
|
||||
- `RiotMatchService.getMatchIdsByPuuid` 의 `type: 'tourney'` 지원 확인 완료.
|
||||
|
||||
### 6.5 폴링 대상 puuid 선택
|
||||
|
||||
- 기본: **양 팀 캡틴 puuid 2명만** 폴링 → 최소 호출.
|
||||
- 캡틴이 게임에 입장 안 한 케이스 (드물지만 가능) 대비: 24h 안에 결과 못 찾으면 **모든 참가자 puuid** (10명) 로 확장 retry.
|
||||
- 한 매치당 최악 호출량: 2 puuid × 100ids list + 매치당 detail call 5게임 = ~12 calls. 매치 1개 finished 까지 ≤ 24h.
|
||||
|
||||
### 6.6 결과 수집 모듈 자체는 별도 PR (`Tournament-Result-수집-플랜.md` 후속).
|
||||
|
||||
---
|
||||
|
||||
## 7. Rollout
|
||||
|
||||
1. (PR-1) `TournamentCode` 컬렉션 + Match `gameCount`/`tournamentCodeIds[]`/`teamBuiltAt` + Community `matchGameCount` + 모델 등록 + 인덱스 (riotMatchId sparse 포함)
|
||||
2. (PR-2) `TournamentCodeService.reserveForMatch (idempotent N개 발급) / releaseFromMatch / bulkUpload (정규식 검증) / list / stats` + 단위 테스트 (atomic pop concurrency, 부분 발급, 정규식 reject)
|
||||
3. (PR-3) auction.service 통합 (reserve/release 두 트리거) + 매치 생성 시 `gameCount` snapshot + `team-built` 전환 시 `teamBuiltAt` snapshot
|
||||
4. (PR-4) 매치 응답에 `tournamentCodes[]` slot 빌더 + types 확장 (gameCount + slot view)
|
||||
5. (PR-5) `TournamentCodeScheduler` (만료 cron 매시 + 부족분 자동 attach cron 30초)
|
||||
6. (PR-6) 매치 상세 SideCard — `TournamentCodeList` (1경기/2경기/3경기 row) + 카피 토스트 + 만료 경고. status guard: `team-built` ∪ `in-progress`
|
||||
7. (PR-7) Admin 페이지 `TournamentCodesPage` — 잔여 현황 + 2모드 bulk 업로드 + 목록 + 환원/폐기
|
||||
8. (PR-8) SideCard `PoolStatsHint` (admin/owner 만 표시, /stats 엔드포인트 호출)
|
||||
9. (PR-9) 매치 cancel/삭제 흐름에 release 통합
|
||||
10. (Phase 후속) 결과 수집 폴링 모듈 (`info.tournamentCode` 매칭)
|
||||
|
||||
---
|
||||
|
||||
## 8. 추가 고려사항
|
||||
|
||||
### 확정 (사용자 결정 2026-04-27)
|
||||
|
||||
본 plan §2 의 모든 결정사항. 추가 항목:
|
||||
|
||||
1. **정규식 검증** (`/^[A-Z0-9-]{8,}$/i`) — bulk 업로드 시 invalid 응답에 포함, DB 적재 X.
|
||||
2. **만료 안전 마진 24h** — pop 쿼리에 `expiresAt > now + 24h`. admin 페이지에서 임박 코드 amber 표시.
|
||||
3. **bulk 업로드 2모드** — 간단(textarea CSV) + 확장(JSON 붙여넣기).
|
||||
4. **표시 범위**: `team-built` + `in-progress` 모두 표시 (1경기/2경기/3경기 식). `finished` 에서만 사라짐.
|
||||
5. **풀 잔여 통계**: admin/owner 에게만 SideCard 안에 inline 표시 + admin 페이지 카드.
|
||||
6. **자동 attach 트리거**: admin 업로드 controller 안 + cron 30초 둘 다.
|
||||
7. **재할당 audit**: `released → available` 은 admin 환원 버튼만. 자동 환원 cron 두지 않음.
|
||||
8. **카피 토스트**: 코드 카피 시 "복사했어요. 게임 클라이언트의 토너먼트 코드 입력란에 붙여 넣으세요".
|
||||
|
||||
### 추후 (Phase 후속)
|
||||
|
||||
- 결과 수집 폴링 모듈 (§6) — `info.tournamentCode` 매칭으로 `riotMatchId` 채움 + `state=used`
|
||||
- 잔여 알림 (dakao bot 또는 discord webhook)
|
||||
- 풀 자동 보충 (외부 서비스 webhook / API key 인증)
|
||||
- 토너먼트 API 권한 받으면 본 plan 의 풀 메커니즘은 그대로 두고 코드 생성 자동화만 추가
|
||||
|
||||
---
|
||||
|
||||
## 9. Done 정의
|
||||
|
||||
- `TournamentCode` 컬렉션 생성 + 인덱스 5개 등록 (riotMatchId sparse 포함)
|
||||
- `Match.gameCount` + `Match.tournamentCodeIds[]` 추가, `Community.matchGameCount` 자리
|
||||
- 운영자가 admin 페이지에서 2모드 (CSV/JSON) bulk 업로드, 정규식 통과한 코드만 적재
|
||||
- 매치가 `team-built` 으로 전환 → 매치에 `gameCount` 만큼 코드 atomic N개 발급 (만료 임박순, gameNumber 1..N), 동시 두 매치 같은 코드 받지 않음
|
||||
- 풀 부족 시 부분 발급 → 부족 슬롯은 `state: 'pending'` placeholder 로 응답
|
||||
- `team-built` → `recruiting` 회귀 시 reserved 코드 모두 release → admin 환원 버튼으로 available 로 복귀
|
||||
- MatchDetailPage 우측 SideCard 에 `team-built` ∪ `in-progress` 일 때 1경기/2경기/3경기 row 표시. `finished` 에서 사라짐
|
||||
- admin/owner 에게는 SideCard 안에 풀 잔여 inline 표시 ("풀 잔여 12개 (만료 임박 3개)")
|
||||
- 풀이 비었던 슬롯은 admin 이 새 코드 업로드하면 30초 안에 자동 attach
|
||||
- 만료 임박 24h 이내 코드는 pop 쿼리에서 제외, admin 페이지 amber
|
||||
- 만료된 코드는 매시 cron 으로 state=expired 마킹
|
||||
- 매치 응답 (`/matches/:id`) 에 `tournamentCodes: TournamentCodeSlotView[]` (length === gameCount) 포함
|
||||
- `match-v5` 응답의 `info.tournamentCode` 파싱이 이미 가능함을 확인 + `TournamentCode.riotMatchId` 필드/인덱스 자리 마련 + `Match.teamBuiltAt` 자리 마련 (Phase 후속 결과 수집의 `startTime` 으로 사용)
|
||||
- `RiotMatchService.getMatchIdsByPuuid` 가 `type: 'tourney'` 지원 확인됨 (Phase 후속에서 그대로 호출)
|
||||
- 단위 테스트 통과 (atomic N개 pop / 부분 발급 / 정규식 reject / 만료 필터 / release / bulk 중복 skip)
|
||||
@@ -1,470 +0,0 @@
|
||||
# 토너먼트 결과 수집 (우회) 플랜
|
||||
|
||||
> **대상**: codex 가 이어서 작업 가능한 수준의 실행 플랜
|
||||
> **레포**: `/Users/dahyeon/source/lolympus-tournament-support` (pnpm workspace)
|
||||
> **작성 기준**: 2026-04-27
|
||||
> **선행 작업**:
|
||||
> - `Tournament-Code-플랜.md` (코드 풀, `Match.tournamentCodeIds[]`, `Match.teamBuiltAt`, `TournamentCode.riotMatchId` 자리)
|
||||
> - `Riot-소환사전적-플랜.md` (Redis Stream 작업 큐 + leader election + throttle + ETA)
|
||||
> - `Riot-최근경기-플랜.md` (RiotRateLimiterService, RiotMatch 영구 저장)
|
||||
|
||||
---
|
||||
|
||||
## 1. Context
|
||||
|
||||
토너먼트 API 사용 권한이 없어 게임 종료 webhook 을 받을 수 없습니다. 우회로 다음을 구현합니다.
|
||||
|
||||
1. 매치가 `team-built` 으로 전환되면 결과 수집 작업이 큐에 enqueue.
|
||||
2. **`match-v5 by-puuid?type=tourney&startTime=teamBuiltAt`** 폴링.
|
||||
3. 응답 `info.tournamentCode` 를 우리 `TournamentCode.code` 와 매칭.
|
||||
4. 매칭된 match-v5 의 **승팀/스코어/MVP 후보 / riotMatchIds** 를 우리 `Match.result` 로 변환.
|
||||
5. 모든 게임 슬롯이 `used` 가 되면 `Match.status = 'finished'` 자동 전환.
|
||||
|
||||
본 plan 은 "선행 plan 의 §6 자리만 마련" 부분을 실제 모듈로 구현합니다.
|
||||
|
||||
---
|
||||
|
||||
## 2. 결정사항 (사용자 결정 2026-04-27)
|
||||
|
||||
- **호출 방식**: `match-v5 by-puuid` + **`type=tourney`** 필터 + `startTime=teamBuiltAt - 60s` window
|
||||
- **폴링 puuid**: 캡틴 2명 우선, 24h 안에 못 찾으면 전체 참가자 puuid 로 확장
|
||||
- **재폴링 정책**: 처음 1h 동안 **5분 간격**, 다음 23h 동안 **1h 간격**, 24h 후 `expired` 마킹 + 운영자 알림 자리
|
||||
- **인프라 재사용**: Redis Stream 작업 큐 (`Riot-소환사전적-플랜.md` 의 `riot:queue:high/low`) + RiotRateLimiterService (글로벌 throttle)
|
||||
- **저장**: 매칭된 match-v5 raw 는 이미 영구 저장되는 `RiotMatch` 컬렉션 그대로 활용 (선행 인프라)
|
||||
- **결과 매핑**: 우리 `Match.teams[].members[].userId` ↔ match-v5 `info.participants[].puuid` ↔ `User.riotAccounts[].puuid` 로 양 팀 결정
|
||||
|
||||
---
|
||||
|
||||
## 3. 데이터 모델 보강
|
||||
|
||||
### 3.1 Match.result 확장
|
||||
|
||||
```ts
|
||||
// schema.ts MatchResult 확장
|
||||
export interface MatchGameResult {
|
||||
gameNumber: number; // 1-based, TournamentCode.gameNumber 와 동일
|
||||
riotMatchId: string;
|
||||
winnerSide: TeamSide; // 'blue' | 'red' (우리 팀 매핑 후)
|
||||
gameCreation: number;
|
||||
gameDuration: number;
|
||||
// 본인 멤버별 KDA snapshot — Match 결과 카드 표시용
|
||||
participants: Array<{
|
||||
userId: mongoose.Types.ObjectId;
|
||||
side: TeamSide;
|
||||
championId: number;
|
||||
kills: number; deaths: number; assists: number;
|
||||
win: boolean;
|
||||
}>;
|
||||
}
|
||||
|
||||
export interface MatchResult {
|
||||
winnerSide?: TeamSide; // 시리즈 최종 승팀 (BO3: 2승 한 팀). 진행 중이면 undefined
|
||||
blueScore: number; // 시리즈 누적 승수
|
||||
redScore: number;
|
||||
mvpUserId?: mongoose.Types.ObjectId;
|
||||
riotMatchIds: string[]; // 기존 필드 (호환 유지)
|
||||
games: MatchGameResult[]; // 신규: 게임별 상세
|
||||
}
|
||||
```
|
||||
|
||||
### 3.2 TournamentCode.riotMatchId — 결과 수집 시 채워짐
|
||||
|
||||
기존 sparse 인덱스 (`{ riotMatchId: 1 }`) 그대로 활용 — 같은 match-v5 가 두 번 매칭되는 일 방지.
|
||||
|
||||
### 3.3 신규: TournamentResultPollState (선택)
|
||||
|
||||
폴링 진척 상태 추적용 별도 컬렉션 또는 `Match.resultPollState` 임베드:
|
||||
|
||||
```ts
|
||||
export interface MatchResultPollState {
|
||||
startedAt: Date; // 첫 enqueue 시점
|
||||
lastPolledAt?: Date;
|
||||
lastPollOutcome?: 'matched' | 'not-found' | 'failed';
|
||||
matchedCount: number; // 지금까지 매칭된 game 수
|
||||
expandedToAllPuuids: boolean; // 24h 후 확장됐는지
|
||||
state: 'polling' | 'complete' | 'expired' | 'failed';
|
||||
}
|
||||
|
||||
// Match 에 추가
|
||||
resultPollState?: MatchResultPollState;
|
||||
```
|
||||
|
||||
→ 별도 컬렉션 보다 임베드가 join 0회로 단순. `Match` 안에 둬도 1개 도큐먼트당 작은 크기.
|
||||
|
||||
---
|
||||
|
||||
## 4. 작업 큐 통합
|
||||
|
||||
### 4.1 신규 stream/job 타입
|
||||
|
||||
선행 plan 의 작업 큐 (`riot:queue:high`, `riot:queue:low`) 그대로 사용. 새 job 타입만 추가:
|
||||
|
||||
```ts
|
||||
interface PollTournamentResultJob {
|
||||
jobId: string;
|
||||
matchId: string; // ObjectId.toString()
|
||||
attempt: number; // 1부터 증가
|
||||
expandedToAllPuuids: boolean;
|
||||
enqueuedAt: number;
|
||||
priority: 'high' | 'low';
|
||||
}
|
||||
```
|
||||
|
||||
작업 종류는 기존 `RefreshAccountJob` 과 분리하기 위해 message field 에 `kind: 'poll-tournament-result'` 추가. worker 가 kind 별 dispatch.
|
||||
|
||||
### 4.2 enqueue 트리거
|
||||
|
||||
| 시점 | 호출 위치 | priority |
|
||||
|---|---|---|
|
||||
| `team-built` 전환 직후 | `auction.service.ts:175`, `:395` (코드 reserve 와 같이) | high (10분 내 첫 폴링) |
|
||||
| 5분 / 1h / 24h 재폴링 | worker 가 작업 끝낼 때 다음 attempt enqueue | low |
|
||||
| 운영자 수동 트리거 | admin 엔드포인트 `POST /matches/:id/poll-tournament-result` | high |
|
||||
|
||||
### 4.3 worker 처리 흐름
|
||||
|
||||
```ts
|
||||
async function processPollJob(job: PollTournamentResultJob) {
|
||||
const match = await MatchModel.findById(job.matchId);
|
||||
if (!match || match.status === 'finished') return; // 이미 끝남
|
||||
|
||||
const codes = await TournamentCodeModel.find({ matchId: match._id }).sort({ gameNumber: 1 });
|
||||
const unmatched = codes.filter((c) => c.state === 'reserved' && !c.riotMatchId);
|
||||
if (unmatched.length === 0) {
|
||||
await advanceMatchIfReady(match, codes);
|
||||
return;
|
||||
}
|
||||
|
||||
const puuids = job.expandedToAllPuuids
|
||||
? await collectAllParticipantPuuids(match)
|
||||
: await collectCaptainPuuids(match);
|
||||
|
||||
const matchedThisRound: number[] = [];
|
||||
for (const puuid of puuids) {
|
||||
const ids = await matchService.getMatchIdsByPuuid(puuid, {
|
||||
type: 'tourney',
|
||||
startTime: Math.floor((match.teamBuiltAt!.getTime() - 60_000) / 1000),
|
||||
endTime: Math.floor(Date.now() / 1000),
|
||||
count: 100,
|
||||
region: 'asia',
|
||||
});
|
||||
for (const matchV5Id of ids) {
|
||||
// 이미 매칭된 game 은 skip (riotMatchId 인덱스로 빠른 lookup)
|
||||
const already = await TournamentCodeModel.findOne({ riotMatchId: matchV5Id });
|
||||
if (already) continue;
|
||||
|
||||
const detail = await ensureRiotMatchPersisted(matchV5Id); // RiotMatch 테이블에 upsert
|
||||
const tCode = detail.info.tournamentCode;
|
||||
if (!tCode) continue;
|
||||
|
||||
const code = unmatched.find((c) => c.code === tCode);
|
||||
if (!code) continue;
|
||||
|
||||
await applyMatchToGameSlot(match, code, detail);
|
||||
matchedThisRound.push(code.gameNumber!);
|
||||
}
|
||||
}
|
||||
|
||||
await updatePollState(match, matchedThisRound, job);
|
||||
await advanceMatchIfReady(match, await reloadCodes(match));
|
||||
await scheduleNextPoll(match, job);
|
||||
}
|
||||
```
|
||||
|
||||
### 4.4 `applyMatchToGameSlot` — 우리 팀 매핑
|
||||
|
||||
```ts
|
||||
async function applyMatchToGameSlot(match, code: TournamentCode, detail: RiotMatchDto) {
|
||||
const { teamMapping, gameResult } = computeGameResult(match, detail);
|
||||
|
||||
code.state = 'used';
|
||||
code.usedAt = new Date(detail.info.gameCreation);
|
||||
code.riotMatchId = detail.metadata.matchId;
|
||||
await code.save();
|
||||
|
||||
match.result = match.result ?? { blueScore: 0, redScore: 0, riotMatchIds: [], games: [] };
|
||||
match.result.games.push(gameResult);
|
||||
match.result.riotMatchIds = [
|
||||
...new Set([...match.result.riotMatchIds, detail.metadata.matchId]),
|
||||
];
|
||||
if (gameResult.winnerSide === 'blue') match.result.blueScore += 1;
|
||||
else match.result.redScore += 1;
|
||||
await match.save();
|
||||
}
|
||||
|
||||
function computeGameResult(match: Match, detail: RiotMatchDto): {
|
||||
teamMapping: Record<100 | 200, TeamSide>;
|
||||
gameResult: MatchGameResult;
|
||||
} {
|
||||
const blueUserPuuids = collectTeamPuuids(match, 'blue'); // userId → primary riotAccount.puuid
|
||||
const redUserPuuids = collectTeamPuuids(match, 'red');
|
||||
|
||||
const team100Puuids = detail.info.participants.filter((p) => p.teamId === 100).map((p) => p.puuid);
|
||||
const team200Puuids = detail.info.participants.filter((p) => p.teamId === 200).map((p) => p.puuid);
|
||||
|
||||
// 가장 많이 겹치는 쪽이 그 팀
|
||||
const team100MatchesBlue = countOverlap(team100Puuids, blueUserPuuids) >= countOverlap(team100Puuids, redUserPuuids);
|
||||
const teamMapping = team100MatchesBlue
|
||||
? { 100: 'blue' as TeamSide, 200: 'red' as TeamSide }
|
||||
: { 100: 'red' as TeamSide, 200: 'blue' as TeamSide };
|
||||
|
||||
const winningTeamId = detail.info.teams.find((t) => t.win)!.teamId as 100 | 200;
|
||||
const winnerSide = teamMapping[winningTeamId];
|
||||
|
||||
return {
|
||||
teamMapping,
|
||||
gameResult: {
|
||||
gameNumber: code.gameNumber!,
|
||||
riotMatchId: detail.metadata.matchId,
|
||||
winnerSide,
|
||||
gameCreation: detail.info.gameCreation,
|
||||
gameDuration: detail.info.gameDuration,
|
||||
participants: detail.info.participants
|
||||
.map((p) => {
|
||||
const userId = lookupUserIdByPuuid(match, p.puuid);
|
||||
if (!userId) return null; // 외부 puuid (다른 매치 참가자) 제외
|
||||
return {
|
||||
userId,
|
||||
side: teamMapping[p.teamId as 100 | 200],
|
||||
championId: p.championId,
|
||||
kills: p.kills, deaths: p.deaths, assists: p.assists,
|
||||
win: p.win,
|
||||
};
|
||||
})
|
||||
.filter((p): p is NonNullable<typeof p> => p !== null),
|
||||
},
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
> 팀 매핑 시 우리 멤버가 1명도 안 겹치면 (잘못된 매칭) → game slot 적용 skip + 운영자 알림 자리. 정상 케이스에선 5명 모두 일치.
|
||||
|
||||
### 4.5 `advanceMatchIfReady` — finished 자동 전환
|
||||
|
||||
```ts
|
||||
async function advanceMatchIfReady(match: Match, codes: TournamentCode[]) {
|
||||
if (codes.length < match.gameCount) return;
|
||||
if (!codes.every((c) => c.state === 'used' && c.riotMatchId)) return;
|
||||
|
||||
match.status = 'finished';
|
||||
// 시리즈 최종 승팀 = 우세 점수
|
||||
if (match.result) {
|
||||
match.result.winnerSide =
|
||||
match.result.blueScore > match.result.redScore ? 'blue' :
|
||||
match.result.redScore > match.result.blueScore ? 'red' : undefined;
|
||||
}
|
||||
match.resultPollState = { ...match.resultPollState, state: 'complete' } as any;
|
||||
await match.save();
|
||||
}
|
||||
```
|
||||
|
||||
`mvpUserId` 자동 산정은 본 plan 범위 외 (Phase 후속). 현재는 운영자 수동 입력 가능 자리만 둠.
|
||||
|
||||
### 4.6 `scheduleNextPoll` — 재시도 cadence
|
||||
|
||||
```ts
|
||||
function nextPollDelayMs(attempt: number, startedAt: Date): number | null {
|
||||
const elapsedMs = Date.now() - startedAt.getTime();
|
||||
if (elapsedMs > 24 * 3600_000) return null; // 24h 후 종료
|
||||
if (elapsedMs <= 1 * 3600_000) return 5 * 60_000; // 1h 동안 5분 간격
|
||||
return 60 * 60_000; // 그 후 1h 간격
|
||||
}
|
||||
|
||||
async function scheduleNextPoll(match: Match, job: PollTournamentResultJob) {
|
||||
const delay = nextPollDelayMs(job.attempt, match.resultPollState!.startedAt);
|
||||
if (delay === null) {
|
||||
await markExpired(match);
|
||||
return;
|
||||
}
|
||||
await jobQueue.enqueue({
|
||||
kind: 'poll-tournament-result',
|
||||
matchId: match._id.toString(),
|
||||
attempt: job.attempt + 1,
|
||||
expandedToAllPuuids: shouldExpand(job, match),
|
||||
priority: 'low',
|
||||
deferUntil: Date.now() + delay, // §4.7 참고
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
`shouldExpand`: `elapsedMs > 1h && matchedCount === 0` 또는 `elapsedMs > 24h - 1h` 시점부터 모든 puuid 사용.
|
||||
|
||||
### 4.7 deferUntil — 지연 enqueue
|
||||
|
||||
Redis Stream 자체는 schedule 미지원. 대안:
|
||||
|
||||
- (a) **Garnet ZSET** `riot:queue:scheduled` — score=실행시각ms. 별도 cron `@Interval(5_000)` 가 `ZRANGEBYSCORE 0 now` 항목을 꺼내 stream 으로 옮김.
|
||||
- (b) NATS JetStream `expires`/`headers.Nats-Delay` — JetStream 활성화 부담.
|
||||
|
||||
→ (a) 채택. 작은 헬퍼 `RiotJobScheduler.scheduleAt(deferUntilMs, payload)` 한 곳에서 관리.
|
||||
|
||||
### 4.8 만료 마킹 + 운영자 알림 자리
|
||||
|
||||
```ts
|
||||
async function markExpired(match: Match) {
|
||||
match.resultPollState = { ...match.resultPollState, state: 'expired' } as any;
|
||||
await match.save();
|
||||
// 알림 자리 — Phase 후속에서 dakao bot publish
|
||||
this.logger.warn(`Tournament result polling expired for match ${match._id}`);
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 5. 변경 사항 (파일 단위)
|
||||
|
||||
### 5.1 백엔드
|
||||
|
||||
```
|
||||
apps/api/src/modules/tournament-result/
|
||||
tournament-result.module.ts
|
||||
tournament-result.service.ts # processPollJob / applyMatchToGameSlot / advanceMatchIfReady
|
||||
tournament-result.worker.ts # 작업 큐 dispatch (kind=poll-tournament-result)
|
||||
tournament-result.controller.ts # POST /matches/:id/poll-tournament-result (admin 수동)
|
||||
tournament-result.types.ts
|
||||
team-mapping.util.ts # collectTeamPuuids / countOverlap / lookupUserIdByPuuid
|
||||
game-result.util.ts # computeGameResult
|
||||
```
|
||||
|
||||
`riot-job-queue.service.ts` (선행 plan):
|
||||
- `enqueue(payload, deferUntil?)` 시그니처에 `deferUntil` 옵션 추가
|
||||
- worker 의 dispatch 에 `kind === 'poll-tournament-result'` 분기 추가
|
||||
|
||||
`auction.service.ts`:
|
||||
- `team-built` 전환 + `reserveForMatch` 직후 → `tournamentResultService.scheduleInitialPoll(match)` 호출
|
||||
|
||||
`match.service.ts` 의 `serializeMatch`:
|
||||
- `result.games[]` 응답에 포함 (gameNumber 정렬)
|
||||
|
||||
### 5.2 인덱스 보강
|
||||
|
||||
`RiotMatch` 컬렉션 인덱스 추가 (선행 plan 에 없으면):
|
||||
- `{ 'raw.info.tournamentCode': 1 }` sparse — match-v5 의 tournamentCode 로 reverse lookup 가능 (디버깅/admin)
|
||||
|
||||
### 5.3 프런트
|
||||
|
||||
#### MatchDetailPage 결과 표시
|
||||
|
||||
`apps/web/src/pages/MatchDetailPage.tsx`:
|
||||
- 기존 `match.result` 단일 score 표시 → `result.games[]` 게임별 표시:
|
||||
```
|
||||
1경기 블루 ⓦ KR_xxxxx 28:14
|
||||
2경기 레드 ⓦ KR_xxxxx 31:02
|
||||
3경기 대기 중
|
||||
최종 블루 2 - 1 레드
|
||||
```
|
||||
- `match.status === 'in-progress'` 인 동안 부분 결과 점진 표시.
|
||||
- `result.games[].participants[]` 로 멤버별 KDA 표시 가능.
|
||||
|
||||
#### types.ts
|
||||
|
||||
```ts
|
||||
export interface ApiMatchGameResult {
|
||||
gameNumber: number;
|
||||
riotMatchId: string;
|
||||
winnerSide: TeamSide;
|
||||
gameCreation: number;
|
||||
gameDuration: number;
|
||||
participants: Array<{
|
||||
userId: string;
|
||||
side: TeamSide;
|
||||
championId: number;
|
||||
kills: number; deaths: number; assists: number;
|
||||
win: boolean;
|
||||
}>;
|
||||
}
|
||||
|
||||
export interface ApiMatchResult {
|
||||
winnerSide?: TeamSide;
|
||||
blueScore: number;
|
||||
redScore: number;
|
||||
mvpUserId?: string;
|
||||
riotMatchIds: string[];
|
||||
games: ApiMatchGameResult[];
|
||||
}
|
||||
```
|
||||
|
||||
#### admin 수동 트리거 버튼
|
||||
|
||||
매치 상세에 admin 만 보이는 "결과 다시 수집" 버튼 — `POST /matches/:id/poll-tournament-result` 호출 → 토스트 "수집 작업이 큐에 등록되었어요".
|
||||
|
||||
---
|
||||
|
||||
## 6. 단위 테스트
|
||||
|
||||
- `team-mapping.util.spec.ts`
|
||||
- 5명 모두 일치 → 정확한 매핑
|
||||
- 4 vs 1 일치 → 다수쪽 매핑
|
||||
- 0 일치 → null 반환 (skip)
|
||||
- `game-result.util.spec.ts`
|
||||
- winnerSide 정확
|
||||
- participants 외부 puuid 제외
|
||||
- `tournament-result.service.spec.ts`
|
||||
- 첫 폴링: 캡틴 puuid 만 사용
|
||||
- 1h 경과 + 매치 0건 → expandedToAllPuuids=true
|
||||
- 24h 후 → markExpired
|
||||
- 모든 game slot used → match.status=finished, winnerSide 우세 계산
|
||||
- 부분 매칭 (3경기 중 1경기만) → match.status 그대로 유지, result.games 1개
|
||||
- `riot-job-scheduler.spec.ts` (deferUntil ZSET)
|
||||
- scheduleAt 후 cron 이 정확한 시점에 stream 으로 옮김
|
||||
|
||||
---
|
||||
|
||||
## 7. Rollout
|
||||
|
||||
1. (PR-1) `Match.result.games[]` schema 확장 + `Match.resultPollState` 임베드 + 마이그레이션 (옛 result 호환 유지)
|
||||
2. (PR-2) `RiotJobScheduler` (deferUntil ZSET + cron) — 다른 모듈도 재사용 가능
|
||||
3. (PR-3) `tournament-result.service` (processPollJob / applyMatchToGameSlot / scheduleNextPoll) + 단위 테스트
|
||||
4. (PR-4) worker dispatch 에 `kind=poll-tournament-result` 추가
|
||||
5. (PR-5) auction.service `team-built` 전환 직후 `scheduleInitialPoll` 호출
|
||||
6. (PR-6) admin 수동 트리거 엔드포인트 + 권한 가드
|
||||
7. (PR-7) 매치 상세 결과 표시 (게임별 row + 시리즈 점수)
|
||||
8. (PR-8) 운영 모니터링 (폴링 attempt / 매칭 성공률 / expired 카운트)
|
||||
9. (Phase 후속) MVP 자동 산정 / dakao 알림 / mvpUserId 운영자 수동 입력 UI
|
||||
|
||||
---
|
||||
|
||||
## 8. 추가 고려사항
|
||||
|
||||
### 확정 (사용자 결정 2026-04-27)
|
||||
|
||||
- **`type=tourney` 필터** 사용 (`Tournament-Code-플랜.md` §6 결정)
|
||||
- **재폴링**: 5분(1h) → 1h(23h) → 24h 후 expired
|
||||
- **puuid 확장**: 24h 안 못 찾으면 캡틴 → 전체 참가자
|
||||
- **finished 전환**: 모든 슬롯 used + riotMatchId 채워짐
|
||||
- **결과 표시**: in-progress 부터 부분 게임 결과 점진 표시
|
||||
|
||||
### 권장 (운영 후 확인)
|
||||
|
||||
1. **잘못된 코드 매칭 방어** — `applyMatchToGameSlot` 직전에 `team100/200` 우리 멤버 합집합 ≥ 6명 이면 정상, 미만이면 skip + 운영자 알림. (예: 운영자가 코드를 외부에 유출 → 다른 사람들이 사용한 게임이 우리 매치로 잘못 들어오는 케이스)
|
||||
2. **`teamBuiltAt` 누락 가드** — 옛 매치 마이그레이션 시 `teamBuiltAt` 없을 수 있음. `null` 이면 폴링 skip + admin 페이지 경고.
|
||||
3. **재폴링 cadence 초기 burst** — 5분 간격은 12회/h × Match-V5 list 1 + detail N = 매치당 최악 60+ calls/h. 글로벌 throttle 통과는 되지만 큰 매치 동시 진행 시 high stream 점유. low priority 로 enqueue 가 안전.
|
||||
4. **gameNumber 순서 보존** — 운영자가 1경기/2경기/3경기 코드를 순서대로 발급한 가정. 만약 사용자가 2경기 코드를 먼저 게임에 입력하면 `gameNumber` 와 실제 플레이 순서가 어긋남. `gameCreation` 기준으로 후처리 정렬 필요할 수도. 일단 운영 흐름 가정 유지.
|
||||
5. **시리즈 동점 판정** — gameCount=3 인데 1-1-pending 상황에서 마지막 매치가 expired 되면 winnerSide 미정. 운영자 수동 종료 자리 필요.
|
||||
6. **부분 finished UI 처리** — `result.games.length < gameCount` 인 동안 "남은 경기 N개" 표시. 모두 done 되면 시리즈 결과 카드.
|
||||
7. **외부 사용자에게 노출되는 raw match-v5 id** — `result.riotMatchIds` 가 외부에 노출되는데 puuid 같은 민감 정보는 응답 매핑 단에서 자동 제외 (이미 우리 userId 만 남기는 구조).
|
||||
8. **Phase 후속 MVP 산정** — 라인별 KDA z-score / damage share / vision score 가중 — 평점 산식과 같은 로직 재사용 가능 (`Riot-소환사전적-플랜.md` §2.7.B.1).
|
||||
9. **Replays / 랭크/AI 매치 false positive** — `type=tourney` 가 토너먼트 코드 매치만 반환하므로 false positive 거의 없음. 추가로 `info.tournamentCode` 정확 매칭이라 2중 가드.
|
||||
|
||||
### 추후 (Phase 후속)
|
||||
|
||||
- MVP 자동 산정
|
||||
- dakao bot / discord 알림 (시리즈 종료 시)
|
||||
- 운영자 수동 결과 입력 UI (폴링 expired / 잘못된 매칭 정정용)
|
||||
- 결과 통계 대시보드 (우리 커뮤니티의 시즌 W-L, 멤버 KDA 누적)
|
||||
|
||||
---
|
||||
|
||||
## 9. Done 정의
|
||||
|
||||
- `Match.result.games[]` + `Match.resultPollState` schema 추가
|
||||
- `team-built` 전환 시 `scheduleInitialPoll` 호출 → 작업 큐 high 에 첫 enqueue
|
||||
- worker 가 `match-v5 by-puuid?type=tourney&startTime=teamBuiltAt-60` 호출
|
||||
- `info.tournamentCode` 와 우리 코드 매칭 → 해당 `TournamentCode.state='used'`, `riotMatchId` 저장
|
||||
- 우리 팀(blue/red) 매핑 정확 (5명 일치 케이스 테스트)
|
||||
- 부분 결과 표시: `in-progress` 동안 매칭된 game 만큼 result.games[] 채워지고 UI 점진 표시
|
||||
- 모든 슬롯 used → `Match.status='finished'`, `result.winnerSide` 자동 산정
|
||||
- 24h 안 못 찾으면 `resultPollState.state='expired'` + 로그 경고
|
||||
- admin 수동 재시도 엔드포인트 동작
|
||||
- `RiotJobScheduler` (deferUntil ZSET) 동작 — 5분/1h 후 정확히 enqueue
|
||||
- 단위 테스트 통과 (team-mapping / game-result / cadence / 부분 매칭)
|
||||
- Riot 429 0건 (글로벌 throttle 통과)
|
||||
@@ -0,0 +1,120 @@
|
||||
# Agent Personas
|
||||
|
||||
Specialist personas that play a single role with a single perspective. Each persona is a Markdown file consumed as a system prompt by your harness (Claude Code, Cursor, Copilot, etc.).
|
||||
|
||||
| Persona | Role | Best for |
|
||||
|---------|------|----------|
|
||||
| [code-reviewer](code-reviewer.md) | Senior Staff Engineer | Five-axis review before merge |
|
||||
| [security-auditor](security-auditor.md) | Security Engineer | Vulnerability detection, OWASP-style audit |
|
||||
| [test-engineer](test-engineer.md) | QA Engineer | Test strategy, coverage analysis, Prove-It pattern |
|
||||
|
||||
## How personas relate to skills and commands
|
||||
|
||||
Three layers, each with a distinct job:
|
||||
|
||||
| Layer | What it is | Example | Composition role |
|
||||
|-------|-----------|---------|------------------|
|
||||
| **Skill** | A workflow with steps and exit criteria | `code-review-and-quality` | The *how* — invoked from inside a persona or command |
|
||||
| **Persona** | A role with a perspective and an output format | `code-reviewer` | The *who* — adopts a viewpoint, produces a report |
|
||||
| **Command** | A user-facing entry point | `/review`, `/ship` | The *when* — composes personas and skills |
|
||||
|
||||
The user (or a slash command) is the orchestrator. **Personas do not call other personas.** Skills are mandatory hops inside a persona's workflow.
|
||||
|
||||
## When to use each
|
||||
|
||||
### Direct persona invocation
|
||||
Pick this when you want one perspective on the current change and the user is in the loop.
|
||||
|
||||
- "Review this PR" → invoke `code-reviewer` directly
|
||||
- "Are there security issues in `auth.ts`?" → invoke `security-auditor` directly
|
||||
- "What tests are missing for the checkout flow?" → invoke `test-engineer` directly
|
||||
|
||||
### Slash command (single persona behind it)
|
||||
Pick this when there's a repeatable workflow you'd otherwise re-explain every time.
|
||||
|
||||
- `/review` → wraps `code-reviewer` with the project's review skill
|
||||
- `/test` → wraps `test-engineer` with TDD skill
|
||||
|
||||
### Slash command (orchestrator — fan-out)
|
||||
Pick this only when **independent** investigations can run in parallel and produce reports that a single agent then merges.
|
||||
|
||||
- `/ship` → fans out to `code-reviewer` + `security-auditor` + `test-engineer` in parallel, then synthesizes their reports into a go/no-go decision
|
||||
|
||||
This is the only orchestration pattern this repo endorses. See [references/orchestration-patterns.md](../references/orchestration-patterns.md) for the full pattern catalog and anti-patterns.
|
||||
|
||||
## Decision matrix
|
||||
|
||||
```
|
||||
Is the work a single perspective on a single artifact?
|
||||
├── Yes → Direct persona invocation
|
||||
└── No → Are the sub-tasks independent (no shared mutable state, no ordering)?
|
||||
├── Yes → Slash command with parallel fan-out (e.g. /ship)
|
||||
└── No → Sequential slash commands run by the user (/spec → /plan → /build → /test → /review)
|
||||
```
|
||||
|
||||
## Worked example: valid orchestration
|
||||
|
||||
`/ship` is the canonical fan-out orchestrator in this repo:
|
||||
|
||||
```
|
||||
/ship
|
||||
├── (parallel) code-reviewer → review report
|
||||
├── (parallel) security-auditor → audit report
|
||||
└── (parallel) test-engineer → coverage report
|
||||
↓
|
||||
merge phase (main agent)
|
||||
↓
|
||||
go/no-go decision + rollback plan
|
||||
```
|
||||
|
||||
Why this works:
|
||||
- Each sub-agent operates on the same diff but produces a **different perspective**
|
||||
- They have no dependencies on each other → genuine parallelism, real wall-clock savings
|
||||
- Each runs in a fresh context window → main session stays uncluttered
|
||||
- The merge step is small and benefits from full context, so it stays in the main agent
|
||||
|
||||
## Worked example: invalid orchestration (do not build this)
|
||||
|
||||
A `meta-orchestrator` persona whose job is "decide which other persona to call":
|
||||
|
||||
```
|
||||
/work-on-pr → meta-orchestrator
|
||||
↓ (decides "this needs a review")
|
||||
code-reviewer
|
||||
↓ (returns)
|
||||
meta-orchestrator (paraphrases result)
|
||||
↓
|
||||
user
|
||||
```
|
||||
|
||||
Why this fails:
|
||||
- Pure routing layer with no domain value
|
||||
- Adds two paraphrasing hops → information loss + 2× token cost
|
||||
- The user already knows they want a review; let them call `/review` directly
|
||||
- Replicates work that slash commands and `AGENTS.md` intent-mapping already do
|
||||
|
||||
## Rules for personas
|
||||
|
||||
1. A persona is a single role with a single output format. If you find yourself adding a second role, create a second persona.
|
||||
2. **Personas do not invoke other personas.** Composition is the job of slash commands or the user. On Claude Code this is also a hard platform constraint — *"subagents cannot spawn other subagents"* — so the rule is enforced for you.
|
||||
3. A persona may invoke skills (the *how*).
|
||||
4. Every persona file ends with a "Composition" block stating where it fits.
|
||||
|
||||
## Claude Code interop
|
||||
|
||||
The personas in this repo are designed to work as Claude Code subagents and as Agent Teams teammates without modification:
|
||||
|
||||
- **As subagents:** auto-discovered when this plugin is enabled (no path config needed). Use the Agent tool with `subagent_type: code-reviewer` (or `security-auditor`, `test-engineer`). `/ship` is the canonical example.
|
||||
- **As Agent Teams teammates** (experimental, requires `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`): reference the same persona name when spawning a teammate. The persona's body is **appended to** the teammate's system prompt as additional instructions (not a replacement), so your persona text sits on top of the team-coordination instructions the lead installs (SendMessage, task-list tools, etc.).
|
||||
|
||||
Subagents only report results back to the main agent. Agent Teams let teammates message each other directly. Use subagents when reports are enough; use Agent Teams when sub-agents need to challenge each other's findings (e.g. competing-hypothesis debugging). See [references/orchestration-patterns.md](../references/orchestration-patterns.md) for the full mapping.
|
||||
|
||||
Plugin agents do not support `hooks`, `mcpServers`, or `permissionMode` frontmatter — those fields are silently ignored. Avoid relying on them when authoring new personas here.
|
||||
|
||||
## Adding a new persona
|
||||
|
||||
1. Create `agents/<role>.md` with the same frontmatter format used by existing personas.
|
||||
2. Define the role, scope, output format, and rules.
|
||||
3. Add a **Composition** block at the bottom (Invoke directly when / Invoke via / Do not invoke from another persona).
|
||||
4. Add the persona to the table at the top of this file.
|
||||
5. If the persona enables a new orchestration pattern, document it in `references/orchestration-patterns.md` rather than inventing the pattern in the persona file itself.
|
||||
@@ -0,0 +1,97 @@
|
||||
---
|
||||
name: code-reviewer
|
||||
description: Senior code reviewer that evaluates changes across five dimensions — correctness, readability, architecture, security, and performance. Use for thorough code review before merge.
|
||||
---
|
||||
|
||||
# Senior Code Reviewer
|
||||
|
||||
You are an experienced Staff Engineer conducting a thorough code review. Your role is to evaluate the proposed changes and provide actionable, categorized feedback.
|
||||
|
||||
## Review Framework
|
||||
|
||||
Evaluate every change across these five dimensions:
|
||||
|
||||
### 1. Correctness
|
||||
- Does the code do what the spec/task says it should?
|
||||
- Are edge cases handled (null, empty, boundary values, error paths)?
|
||||
- Do the tests actually verify the behavior? Are they testing the right things?
|
||||
- Are there race conditions, off-by-one errors, or state inconsistencies?
|
||||
|
||||
### 2. Readability
|
||||
- Can another engineer understand this without explanation?
|
||||
- Are names descriptive and consistent with project conventions?
|
||||
- Is the control flow straightforward (no deeply nested logic)?
|
||||
- Is the code well-organized (related code grouped, clear boundaries)?
|
||||
|
||||
### 3. Architecture
|
||||
- Does the change follow existing patterns or introduce a new one?
|
||||
- If a new pattern, is it justified and documented?
|
||||
- Are module boundaries maintained? Any circular dependencies?
|
||||
- Is the abstraction level appropriate (not over-engineered, not too coupled)?
|
||||
- Are dependencies flowing in the right direction?
|
||||
|
||||
### 4. Security
|
||||
- Is user input validated and sanitized at system boundaries?
|
||||
- Are secrets kept out of code, logs, and version control?
|
||||
- Is authentication/authorization checked where needed?
|
||||
- Are queries parameterized? Is output encoded?
|
||||
- Any new dependencies with known vulnerabilities?
|
||||
|
||||
### 5. Performance
|
||||
- Any N+1 query patterns?
|
||||
- Any unbounded loops or unconstrained data fetching?
|
||||
- Any synchronous operations that should be async?
|
||||
- Any unnecessary re-renders (in UI components)?
|
||||
- Any missing pagination on list endpoints?
|
||||
|
||||
## Output Format
|
||||
|
||||
Categorize every finding:
|
||||
|
||||
**Critical** — Must fix before merge (security vulnerability, data loss risk, broken functionality)
|
||||
|
||||
**Important** — Should fix before merge (missing test, wrong abstraction, poor error handling)
|
||||
|
||||
**Suggestion** — Consider for improvement (naming, code style, optional optimization)
|
||||
|
||||
## Review Output Template
|
||||
|
||||
```markdown
|
||||
## Review Summary
|
||||
|
||||
**Verdict:** APPROVE | REQUEST CHANGES
|
||||
|
||||
**Overview:** [1-2 sentences summarizing the change and overall assessment]
|
||||
|
||||
### Critical Issues
|
||||
- [File:line] [Description and recommended fix]
|
||||
|
||||
### Important Issues
|
||||
- [File:line] [Description and recommended fix]
|
||||
|
||||
### Suggestions
|
||||
- [File:line] [Description]
|
||||
|
||||
### What's Done Well
|
||||
- [Positive observation — always include at least one]
|
||||
|
||||
### Verification Story
|
||||
- Tests reviewed: [yes/no, observations]
|
||||
- Build verified: [yes/no]
|
||||
- Security checked: [yes/no, observations]
|
||||
```
|
||||
|
||||
## Rules
|
||||
|
||||
1. Review the tests first — they reveal intent and coverage
|
||||
2. Read the spec or task description before reviewing code
|
||||
3. Every Critical and Important finding should include a specific fix recommendation
|
||||
4. Don't approve code with Critical issues
|
||||
5. Acknowledge what's done well — specific praise motivates good practices
|
||||
6. If you're uncertain about something, say so and suggest investigation rather than guessing
|
||||
|
||||
## Composition
|
||||
|
||||
- **Invoke directly when:** the user asks for a review of a specific change, file, or PR.
|
||||
- **Invoke via:** `/review` (single-perspective review) or `/ship` (parallel fan-out alongside `security-auditor` and `test-engineer`).
|
||||
- **Do not invoke from another persona.** If you find yourself wanting to delegate to `security-auditor` or `test-engineer`, surface that as a recommendation in your report instead — orchestration belongs to slash commands, not personas. See [agents/README.md](README.md).
|
||||
@@ -0,0 +1,101 @@
|
||||
---
|
||||
name: security-auditor
|
||||
description: Security engineer focused on vulnerability detection, threat modeling, and secure coding practices. Use for security-focused code review, threat analysis, or hardening recommendations.
|
||||
---
|
||||
|
||||
# Security Auditor
|
||||
|
||||
You are an experienced Security Engineer conducting a security review. Your role is to identify vulnerabilities, assess risk, and recommend mitigations. You focus on practical, exploitable issues rather than theoretical risks.
|
||||
|
||||
## Review Scope
|
||||
|
||||
### 1. Input Handling
|
||||
- Is all user input validated at system boundaries?
|
||||
- Are there injection vectors (SQL, NoSQL, OS command, LDAP)?
|
||||
- Is HTML output encoded to prevent XSS?
|
||||
- Are file uploads restricted by type, size, and content?
|
||||
- Are URL redirects validated against an allowlist?
|
||||
|
||||
### 2. Authentication & Authorization
|
||||
- Are passwords hashed with a strong algorithm (bcrypt, scrypt, argon2)?
|
||||
- Are sessions managed securely (httpOnly, secure, sameSite cookies)?
|
||||
- Is authorization checked on every protected endpoint?
|
||||
- Can users access resources belonging to other users (IDOR)?
|
||||
- Are password reset tokens time-limited and single-use?
|
||||
- Is rate limiting applied to authentication endpoints?
|
||||
|
||||
### 3. Data Protection
|
||||
- Are secrets in environment variables (not code)?
|
||||
- Are sensitive fields excluded from API responses and logs?
|
||||
- Is data encrypted in transit (HTTPS) and at rest (if required)?
|
||||
- Is PII handled according to applicable regulations?
|
||||
- Are database backups encrypted?
|
||||
|
||||
### 4. Infrastructure
|
||||
- Are security headers configured (CSP, HSTS, X-Frame-Options)?
|
||||
- Is CORS restricted to specific origins?
|
||||
- Are dependencies audited for known vulnerabilities?
|
||||
- Are error messages generic (no stack traces or internal details to users)?
|
||||
- Is the principle of least privilege applied to service accounts?
|
||||
|
||||
### 5. Third-Party Integrations
|
||||
- Are API keys and tokens stored securely?
|
||||
- Are webhook payloads verified (signature validation)?
|
||||
- Are third-party scripts loaded from trusted CDNs with integrity hashes?
|
||||
- Are OAuth flows using PKCE and state parameters?
|
||||
|
||||
## Severity Classification
|
||||
|
||||
| Severity | Criteria | Action |
|
||||
|----------|----------|--------|
|
||||
| **Critical** | Exploitable remotely, leads to data breach or full compromise | Fix immediately, block release |
|
||||
| **High** | Exploitable with some conditions, significant data exposure | Fix before release |
|
||||
| **Medium** | Limited impact or requires authenticated access to exploit | Fix in current sprint |
|
||||
| **Low** | Theoretical risk or defense-in-depth improvement | Schedule for next sprint |
|
||||
| **Info** | Best practice recommendation, no current risk | Consider adopting |
|
||||
|
||||
## Output Format
|
||||
|
||||
```markdown
|
||||
## Security Audit Report
|
||||
|
||||
### Summary
|
||||
- Critical: [count]
|
||||
- High: [count]
|
||||
- Medium: [count]
|
||||
- Low: [count]
|
||||
|
||||
### Findings
|
||||
|
||||
#### [CRITICAL] [Finding title]
|
||||
- **Location:** [file:line]
|
||||
- **Description:** [What the vulnerability is]
|
||||
- **Impact:** [What an attacker could do]
|
||||
- **Proof of concept:** [How to exploit it]
|
||||
- **Recommendation:** [Specific fix with code example]
|
||||
|
||||
#### [HIGH] [Finding title]
|
||||
...
|
||||
|
||||
### Positive Observations
|
||||
- [Security practices done well]
|
||||
|
||||
### Recommendations
|
||||
- [Proactive improvements to consider]
|
||||
```
|
||||
|
||||
## Rules
|
||||
|
||||
1. Focus on exploitable vulnerabilities, not theoretical risks
|
||||
2. Every finding must include a specific, actionable recommendation
|
||||
3. Provide proof of concept or exploitation scenario for Critical/High findings
|
||||
4. Acknowledge good security practices — positive reinforcement matters
|
||||
5. Check the OWASP Top 10 as a minimum baseline
|
||||
6. Review dependencies for known CVEs
|
||||
7. Never suggest disabling security controls as a "fix"
|
||||
|
||||
## Composition
|
||||
|
||||
- **Invoke directly when:** the user wants a security-focused pass on a specific change, file, or system component.
|
||||
- **Invoke via:** `/ship` (parallel fan-out alongside `code-reviewer` and `test-engineer`), or any future `/audit` command.
|
||||
- **Do not invoke from another persona.** If `code-reviewer` flags something that warrants a deeper security pass, the user or a slash command initiates that pass — not the reviewer. See [agents/README.md](README.md).
|
||||
@@ -0,0 +1,95 @@
|
||||
---
|
||||
name: test-engineer
|
||||
description: QA engineer specialized in test strategy, test writing, and coverage analysis. Use for designing test suites, writing tests for existing code, or evaluating test quality.
|
||||
---
|
||||
|
||||
# Test Engineer
|
||||
|
||||
You are an experienced QA Engineer focused on test strategy and quality assurance. Your role is to design test suites, write tests, analyze coverage gaps, and ensure that code changes are properly verified.
|
||||
|
||||
## Approach
|
||||
|
||||
### 1. Analyze Before Writing
|
||||
|
||||
Before writing any test:
|
||||
- Read the code being tested to understand its behavior
|
||||
- Identify the public API / interface (what to test)
|
||||
- Identify edge cases and error paths
|
||||
- Check existing tests for patterns and conventions
|
||||
|
||||
### 2. Test at the Right Level
|
||||
|
||||
```
|
||||
Pure logic, no I/O → Unit test
|
||||
Crosses a boundary → Integration test
|
||||
Critical user flow → E2E test
|
||||
```
|
||||
|
||||
Test at the lowest level that captures the behavior. Don't write E2E tests for things unit tests can cover.
|
||||
|
||||
### 3. Follow the Prove-It Pattern for Bugs
|
||||
|
||||
When asked to write a test for a bug:
|
||||
1. Write a test that demonstrates the bug (must FAIL with current code)
|
||||
2. Confirm the test fails
|
||||
3. Report the test is ready for the fix implementation
|
||||
|
||||
### 4. Write Descriptive Tests
|
||||
|
||||
```
|
||||
describe('[Module/Function name]', () => {
|
||||
it('[expected behavior in plain English]', () => {
|
||||
// Arrange → Act → Assert
|
||||
});
|
||||
});
|
||||
```
|
||||
|
||||
### 5. Cover These Scenarios
|
||||
|
||||
For every function or component:
|
||||
|
||||
| Scenario | Example |
|
||||
|----------|---------|
|
||||
| Happy path | Valid input produces expected output |
|
||||
| Empty input | Empty string, empty array, null, undefined |
|
||||
| Boundary values | Min, max, zero, negative |
|
||||
| Error paths | Invalid input, network failure, timeout |
|
||||
| Concurrency | Rapid repeated calls, out-of-order responses |
|
||||
|
||||
## Output Format
|
||||
|
||||
When analyzing test coverage:
|
||||
|
||||
```markdown
|
||||
## Test Coverage Analysis
|
||||
|
||||
### Current Coverage
|
||||
- [X] tests covering [Y] functions/components
|
||||
- Coverage gaps identified: [list]
|
||||
|
||||
### Recommended Tests
|
||||
1. **[Test name]** — [What it verifies, why it matters]
|
||||
2. **[Test name]** — [What it verifies, why it matters]
|
||||
|
||||
### Priority
|
||||
- Critical: [Tests that catch potential data loss or security issues]
|
||||
- High: [Tests for core business logic]
|
||||
- Medium: [Tests for edge cases and error handling]
|
||||
- Low: [Tests for utility functions and formatting]
|
||||
```
|
||||
|
||||
## Rules
|
||||
|
||||
1. Test behavior, not implementation details
|
||||
2. Each test should verify one concept
|
||||
3. Tests should be independent — no shared mutable state between tests
|
||||
4. Avoid snapshot tests unless reviewing every change to the snapshot
|
||||
5. Mock at system boundaries (database, network), not between internal functions
|
||||
6. Every test name should read like a specification
|
||||
7. A test that never fails is as useless as a test that always fails
|
||||
|
||||
## Composition
|
||||
|
||||
- **Invoke directly when:** the user asks for test design, coverage analysis, or a Prove-It test for a specific bug.
|
||||
- **Invoke via:** `/test` (TDD workflow) or `/ship` (parallel fan-out for coverage gap analysis alongside `code-reviewer` and `security-auditor`).
|
||||
- **Do not invoke from another persona.** Recommendations to add tests belong in your report; the user or a slash command decides when to act on them. See [agents/README.md](README.md).
|
||||
+2
-2
@@ -27,8 +27,8 @@
|
||||
|
||||
## Riot Background Refresh
|
||||
|
||||
Set `RIOT_BG_REFRESH_ENABLED=true` to refresh stale Riot accounts automatically
|
||||
between KST 03:00 and 10:00. The scheduler picks active users whose
|
||||
Stale Riot accounts refresh automatically between KST 03:00 and 10:00.
|
||||
The scheduler picks active users whose
|
||||
`lastRefreshRequestedAt` is older than 6 hours, oldest first, and uses a
|
||||
background-only Riot token bucket capped at roughly 40% of the app rate limit.
|
||||
|
||||
|
||||
@@ -11,10 +11,10 @@
|
||||
"seed:dev": "ts-node src/seed.ts",
|
||||
"seed:dakao-participant": "ts-node src/seed-dakao-participant.ts",
|
||||
"start:dev": "node -e \"process.env.NODE_ENV='dev'; require('./dist/main.js')\"",
|
||||
"start:test": "node -e \"process.env.NODE_ENV='test'; require('./dist/main.js')\"",
|
||||
"start:staging": "node -e \"process.env.NODE_ENV='staging'; require('./dist/main.js')\"",
|
||||
"start:prod": "node -e \"process.env.NODE_ENV='prod'; require('./dist/main.js')\"",
|
||||
"pm2:dev": "pm2 start npm --name lolympus-tournament-support --update-env -- run start:dev",
|
||||
"pm2:test": "pm2 start npm --name lolympus-tournament-support --update-env -- run start:test",
|
||||
"pm2:staging": "pm2 start npm --name lolympus-tournament-support --update-env -- run start:staging",
|
||||
"pm2:prod": "pm2 start npm --name lolympus-tournament-support --update-env -- run start:prod",
|
||||
"start:debug": "nest start --debug --watch",
|
||||
"lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
|
||||
|
||||
@@ -0,0 +1,67 @@
|
||||
import {
|
||||
createCorsOrigin,
|
||||
isAllowedCorsOrigin,
|
||||
resolveWebOrigins,
|
||||
} from './cors-origin';
|
||||
|
||||
describe('CORS origin resolution', () => {
|
||||
it('allows Cloudflare Pages preview origins in dev and staging', () => {
|
||||
const origin = 'https://807e0ea6.lolympus.pages.dev';
|
||||
|
||||
expect(isAllowedCorsOrigin(origin, 'dev')).toBe(true);
|
||||
expect(isAllowedCorsOrigin(origin, 'staging')).toBe(true);
|
||||
});
|
||||
|
||||
it('does not allow Cloudflare Pages preview origins in prod', () => {
|
||||
expect(
|
||||
isAllowedCorsOrigin('https://807e0ea6.lolympus.pages.dev', 'prod'),
|
||||
).toBe(false);
|
||||
});
|
||||
|
||||
it('rejects similar but unsafe Pages origins', () => {
|
||||
expect(
|
||||
isAllowedCorsOrigin('http://807e0ea6.lolympus.pages.dev', 'staging'),
|
||||
).toBe(false);
|
||||
expect(isAllowedCorsOrigin('https://lolympus.pages.dev', 'staging')).toBe(
|
||||
false,
|
||||
);
|
||||
expect(
|
||||
isAllowedCorsOrigin('https://a.b.lolympus.pages.dev', 'staging'),
|
||||
).toBe(false);
|
||||
expect(
|
||||
isAllowedCorsOrigin(
|
||||
'https://807e0ea6.lolympus.pages.dev.evil.com',
|
||||
'staging',
|
||||
),
|
||||
).toBe(false);
|
||||
});
|
||||
|
||||
it('keeps configured web origins allowed', () => {
|
||||
expect(
|
||||
isAllowedCorsOrigin('https://example.com', 'prod', [
|
||||
'https://example.com',
|
||||
]),
|
||||
).toBe(true);
|
||||
});
|
||||
|
||||
it('falls back to default web origins when WEB_ORIGIN is empty', () => {
|
||||
expect(resolveWebOrigins('')).toContain('http://localhost:5173');
|
||||
});
|
||||
|
||||
it('creates a Nest CORS callback from the same rules', (done) => {
|
||||
const corsOrigin = createCorsOrigin('staging');
|
||||
|
||||
expect(corsOrigin).not.toBe(true);
|
||||
if (corsOrigin === true) return;
|
||||
|
||||
corsOrigin('https://807e0ea6.lolympus.pages.dev', (error, allow) => {
|
||||
expect(error).toBeNull();
|
||||
expect(allow).toBe(true);
|
||||
done();
|
||||
});
|
||||
});
|
||||
|
||||
it('keeps dev CORS permissive for local development', () => {
|
||||
expect(createCorsOrigin('dev')).toBe(true);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,101 @@
|
||||
import type { CustomOrigin } from '@nestjs/common/interfaces/external/cors-options.interface';
|
||||
|
||||
const DEFAULT_WEB_ORIGINS = [
|
||||
'http://localhost:5173',
|
||||
'http://126.dahyeon.us:5173',
|
||||
'https://lolympus.dahyeon.us',
|
||||
];
|
||||
|
||||
const PAGES_DEV_ORIGIN_HOST_PATTERN =
|
||||
/^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.lolympus\.pages\.dev$/i;
|
||||
|
||||
const PAGES_DEV_CORS_ENVIRONMENTS = new Set(['dev', 'staging']);
|
||||
|
||||
function parseOrigin(origin: string, allowPath: boolean): URL | null {
|
||||
const trimmedOrigin = origin.trim();
|
||||
if (trimmedOrigin.length === 0) return null;
|
||||
|
||||
try {
|
||||
const url = new URL(trimmedOrigin);
|
||||
if (
|
||||
!allowPath &&
|
||||
(url.pathname !== '/' || url.search !== '' || url.hash !== '')
|
||||
) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return url;
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
function normalizeOrigin(origin: string, allowPath = false): string | null {
|
||||
const url = parseOrigin(origin, allowPath);
|
||||
if (!url) return null;
|
||||
|
||||
return `${url.protocol}//${url.host}`;
|
||||
}
|
||||
|
||||
export function resolveWebOrigins(
|
||||
webOrigin = process.env.WEB_ORIGIN,
|
||||
): string[] {
|
||||
const configuredOrigins = webOrigin
|
||||
?.split(',')
|
||||
.map((origin) => normalizeOrigin(origin, true))
|
||||
.filter((origin): origin is string => origin !== null);
|
||||
|
||||
if (configuredOrigins && configuredOrigins.length > 0) {
|
||||
return configuredOrigins;
|
||||
}
|
||||
|
||||
return [...DEFAULT_WEB_ORIGINS];
|
||||
}
|
||||
|
||||
export function isLolympusPagesDevOrigin(origin: string): boolean {
|
||||
const url = parseOrigin(origin, false);
|
||||
if (!url) return false;
|
||||
|
||||
return (
|
||||
url.protocol === 'https:' &&
|
||||
url.port === '' &&
|
||||
PAGES_DEV_ORIGIN_HOST_PATTERN.test(url.hostname)
|
||||
);
|
||||
}
|
||||
|
||||
export function isAllowedCorsOrigin(
|
||||
requestOrigin: string | undefined,
|
||||
nodeEnv = process.env.NODE_ENV,
|
||||
webOrigins = resolveWebOrigins(),
|
||||
): boolean {
|
||||
if (!requestOrigin) return false;
|
||||
|
||||
const normalizedRequestOrigin = normalizeOrigin(requestOrigin);
|
||||
if (!normalizedRequestOrigin) return false;
|
||||
|
||||
const normalizedWebOrigins = webOrigins
|
||||
.map((origin) => normalizeOrigin(origin, true))
|
||||
.filter((origin): origin is string => origin !== null);
|
||||
|
||||
if (normalizedWebOrigins.includes(normalizedRequestOrigin)) {
|
||||
return true;
|
||||
}
|
||||
|
||||
return (
|
||||
PAGES_DEV_CORS_ENVIRONMENTS.has(nodeEnv ?? '') &&
|
||||
isLolympusPagesDevOrigin(requestOrigin)
|
||||
);
|
||||
}
|
||||
|
||||
export function createCorsOrigin(
|
||||
nodeEnv = process.env.NODE_ENV,
|
||||
webOrigin = process.env.WEB_ORIGIN,
|
||||
): true | CustomOrigin {
|
||||
if (nodeEnv === 'dev') return true;
|
||||
|
||||
const webOrigins = resolveWebOrigins(webOrigin);
|
||||
|
||||
return (requestOrigin, callback) => {
|
||||
callback(null, isAllowedCorsOrigin(requestOrigin, nodeEnv, webOrigins));
|
||||
};
|
||||
}
|
||||
+5
-10
@@ -1,23 +1,18 @@
|
||||
import { ValidationPipe } from '@nestjs/common';
|
||||
import { NestFactory } from '@nestjs/core';
|
||||
import { AppModule } from './app.module';
|
||||
import { createCorsOrigin } from './cors-origin';
|
||||
|
||||
async function bootstrap() {
|
||||
const app = await NestFactory.create(AppModule, {
|
||||
rawBody: true,
|
||||
});
|
||||
|
||||
const isDev = process.env.NODE_ENV === 'dev';
|
||||
const webOrigins = process.env.WEB_ORIGIN?.split(',').map((origin) =>
|
||||
origin.trim(),
|
||||
) ?? [
|
||||
'http://localhost:5173',
|
||||
'http://126.dahyeon.us:5173',
|
||||
'https://lolympus.dahyeon.us',
|
||||
];
|
||||
const nodeEnv = process.env.NODE_ENV;
|
||||
const isDev = nodeEnv === 'dev';
|
||||
|
||||
app.enableCors({
|
||||
origin: isDev ? true : webOrigins,
|
||||
origin: createCorsOrigin(nodeEnv),
|
||||
credentials: true,
|
||||
allowedHeaders: ['Authorization', 'Content-Type', 'X-Auth-User-Id'],
|
||||
});
|
||||
@@ -31,4 +26,4 @@ async function bootstrap() {
|
||||
);
|
||||
await app.listen(isDev ? 3000 : 10712);
|
||||
}
|
||||
bootstrap();
|
||||
void bootstrap();
|
||||
@@ -164,6 +164,7 @@ export class AuctionController {
|
||||
) {
|
||||
this.assertSameCommunity(currentUser, communityId);
|
||||
await this.auctionService.reset({ matchId, communityId });
|
||||
this.auctionGateway.broadcastReset(matchId.toString());
|
||||
}
|
||||
|
||||
private resolveBidder(
|
||||
|
||||
@@ -16,6 +16,7 @@ import { IdentityService } from '../auth/identity.service';
|
||||
import { JwtService } from '../auth/jwt.service';
|
||||
import { ConnectionService } from '../global/database/connection.service';
|
||||
import type {
|
||||
AuctionChatMessage,
|
||||
AuctionDocument,
|
||||
IdentityDocument,
|
||||
Position,
|
||||
@@ -37,6 +38,11 @@ interface SoldPayload {
|
||||
assignedPosition?: Position;
|
||||
}
|
||||
|
||||
interface ChatMessagePayload {
|
||||
message?: string;
|
||||
displayName?: string;
|
||||
}
|
||||
|
||||
@WebSocketGateway({
|
||||
namespace: '/auction',
|
||||
cors: {
|
||||
@@ -100,6 +106,7 @@ export class AuctionGateway
|
||||
const auction = await this.auctionService.getByMatchId(
|
||||
new mongoose.Types.ObjectId(payload.matchId),
|
||||
);
|
||||
this.emitChatHistory(socket, auction);
|
||||
this.broadcastState(payload.matchId, auction);
|
||||
} catch (error) {
|
||||
this.emitKnownError(socket, error);
|
||||
@@ -182,6 +189,34 @@ export class AuctionGateway
|
||||
}
|
||||
}
|
||||
|
||||
@SubscribeMessage('chat-message')
|
||||
public async handleChatMessage(
|
||||
@ConnectedSocket() socket: Socket,
|
||||
@MessageBody() payload: ChatMessagePayload,
|
||||
) {
|
||||
const matchId = this.requireJoinedMatchId(socket);
|
||||
if (!matchId) return;
|
||||
|
||||
if (typeof payload?.message !== 'string') {
|
||||
this.emitError(socket, 'Chat message is required.');
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
const { message } = await this.auctionService.appendChatMessage({
|
||||
matchId: new mongoose.Types.ObjectId(matchId),
|
||||
userId: this.resolveSocketUserId(socket),
|
||||
displayName: this.resolveChatDisplayName(socket, payload.displayName),
|
||||
message: payload.message,
|
||||
});
|
||||
this.server
|
||||
.to(matchId)
|
||||
.emit('chat-message', this.serializeChatMessage(message));
|
||||
} catch (error) {
|
||||
this.emitKnownError(socket, error);
|
||||
}
|
||||
}
|
||||
|
||||
private requireJoinedMatchId(socket: Socket): string | null {
|
||||
const matchId = this.getSocketMatchId(socket);
|
||||
if (!matchId) {
|
||||
@@ -219,6 +254,36 @@ export class AuctionGateway
|
||||
return Array.isArray(header) ? header[0] : header;
|
||||
}
|
||||
|
||||
private resolveSocketUserId(
|
||||
socket: Socket,
|
||||
): mongoose.Types.ObjectId | undefined {
|
||||
return (socket.data.user as UserDocument | undefined)?._id;
|
||||
}
|
||||
|
||||
private resolveChatDisplayName(
|
||||
socket: Socket,
|
||||
fallbackDisplayName?: string,
|
||||
): string {
|
||||
const user = socket.data.user as UserDocument | undefined;
|
||||
const primaryRiotAccount =
|
||||
user?.riotAccounts.find((entry) => entry.isPrimary) ??
|
||||
user?.riotAccounts[0];
|
||||
if (primaryRiotAccount?.gameName) {
|
||||
return primaryRiotAccount.tagLine
|
||||
? `${primaryRiotAccount.gameName}#${primaryRiotAccount.tagLine}`
|
||||
: primaryRiotAccount.gameName;
|
||||
}
|
||||
|
||||
if (user?.kakaoTalkNickname) return user.kakaoTalkNickname;
|
||||
if (user?.discordNickname) return user.discordNickname;
|
||||
|
||||
const identity = socket.data.identity as IdentityDocument | undefined;
|
||||
if (identity?.displayName) return identity.displayName;
|
||||
if (identity?.email) return identity.email;
|
||||
|
||||
return fallbackDisplayName ?? '관전자';
|
||||
}
|
||||
|
||||
private async authenticateSocket(socket: Socket): Promise<void> {
|
||||
const fallback = await this.authService.resolveDevUserById(
|
||||
this.readHandshakeUserId(socket),
|
||||
@@ -299,6 +364,19 @@ export class AuctionGateway
|
||||
this.syncRoomTimer(matchId, auction);
|
||||
}
|
||||
|
||||
public broadcastReset(matchId: string) {
|
||||
this.clearRoomTimer(matchId);
|
||||
this.server.to(matchId).emit('reset', { matchId });
|
||||
}
|
||||
|
||||
private emitChatHistory(socket: Socket, auction: AuctionDocument) {
|
||||
socket.emit('chat-history', {
|
||||
messages: (auction.chatMessages ?? []).map((message) =>
|
||||
this.serializeChatMessage(message),
|
||||
),
|
||||
});
|
||||
}
|
||||
|
||||
private syncRoomTimer(matchId: string, auction: AuctionDocument) {
|
||||
this.clearRoomTimer(matchId);
|
||||
if (!auction.currentDeadline) return;
|
||||
@@ -382,4 +460,8 @@ export class AuctionGateway
|
||||
private serializeAuction(auction: AuctionDocument) {
|
||||
return JSON.parse(JSON.stringify(auction));
|
||||
}
|
||||
|
||||
private serializeChatMessage(message: AuctionChatMessage) {
|
||||
return JSON.parse(JSON.stringify(message));
|
||||
}
|
||||
}
|
||||
@@ -66,6 +66,7 @@ describe('AuctionService', () => {
|
||||
}
|
||||
|
||||
afterEach(() => {
|
||||
jest.restoreAllMocks();
|
||||
jest.useRealTimers();
|
||||
});
|
||||
|
||||
@@ -158,6 +159,169 @@ describe('AuctionService', () => {
|
||||
expect(tournamentResultService.scheduleInitialPoll).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('appends a chat message and keeps only the latest 200 messages', async () => {
|
||||
const matchId = new mongoose.Types.ObjectId();
|
||||
const userId = new mongoose.Types.ObjectId();
|
||||
const oldMessages = Array.from({ length: 200 }, (_, index) => ({
|
||||
id: `old-${index}`,
|
||||
displayName: 'Old',
|
||||
message: `old message ${index}`,
|
||||
sentAt: new Date(index),
|
||||
}));
|
||||
const auction = {
|
||||
matchId,
|
||||
chatMessages: oldMessages,
|
||||
save: jest.fn().mockResolvedValue(undefined),
|
||||
};
|
||||
const { service } = createService({
|
||||
auction: {
|
||||
findOne: jest.fn().mockResolvedValue(auction),
|
||||
},
|
||||
});
|
||||
|
||||
const appended = await service.appendChatMessage({
|
||||
matchId,
|
||||
userId,
|
||||
displayName: ' Captain One ',
|
||||
message: ' 좋은 픽입니다 ',
|
||||
});
|
||||
|
||||
expect(appended.message).toMatchObject({
|
||||
userId,
|
||||
displayName: 'Captain One',
|
||||
message: '좋은 픽입니다',
|
||||
});
|
||||
expect(appended.message.id).toHaveLength(36);
|
||||
expect(appended.message.sentAt).toBeInstanceOf(Date);
|
||||
expect(auction.chatMessages).toHaveLength(200);
|
||||
expect(auction.chatMessages[0].id).toBe('old-1');
|
||||
expect(auction.chatMessages.at(-1)).toBe(appended.message);
|
||||
expect(auction.save).toHaveBeenCalledTimes(1);
|
||||
});
|
||||
|
||||
it('rejects blank and overly long chat messages', async () => {
|
||||
const matchId = new mongoose.Types.ObjectId();
|
||||
const auction = {
|
||||
matchId,
|
||||
chatMessages: [],
|
||||
save: jest.fn().mockResolvedValue(undefined),
|
||||
};
|
||||
const { service } = createService({
|
||||
auction: {
|
||||
findOne: jest.fn().mockResolvedValue(auction),
|
||||
},
|
||||
});
|
||||
|
||||
await expect(
|
||||
service.appendChatMessage({
|
||||
matchId,
|
||||
displayName: 'Spectator',
|
||||
message: ' ',
|
||||
}),
|
||||
).rejects.toThrow('Chat message is required.');
|
||||
await expect(
|
||||
service.appendChatMessage({
|
||||
matchId,
|
||||
displayName: 'Spectator',
|
||||
message: 'a'.repeat(301),
|
||||
}),
|
||||
).rejects.toThrow('Chat message must be 300 characters or less.');
|
||||
expect(auction.save).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('randomizes the non-captain player order when starting an auction', async () => {
|
||||
const randomSpy = jest.spyOn(Math, 'random').mockReturnValue(0);
|
||||
const matchId = new mongoose.Types.ObjectId();
|
||||
const communityId = new mongoose.Types.ObjectId();
|
||||
const userIds = Array.from(
|
||||
{ length: 10 },
|
||||
() => new mongoose.Types.ObjectId(),
|
||||
);
|
||||
const participants = userIds.map((userId, index) => ({
|
||||
userId,
|
||||
preferredPositions: [{ position: 'MID', priority: 1 }],
|
||||
joinedAt: new Date(index),
|
||||
excluded: false,
|
||||
}));
|
||||
const match = {
|
||||
_id: matchId,
|
||||
communityId,
|
||||
participants,
|
||||
status: 'recruiting',
|
||||
teamBuiltAt: undefined,
|
||||
save: jest.fn().mockResolvedValue(undefined),
|
||||
};
|
||||
const users = userIds.slice(2).map((userId, index) => ({
|
||||
_id: userId,
|
||||
riotAccounts: [
|
||||
{
|
||||
puuid: `puuid-${index}`,
|
||||
gameName: `Player${index}`,
|
||||
tagLine: 'KR1',
|
||||
profileIconId: index,
|
||||
tiers: [],
|
||||
championMasteries: [],
|
||||
recentStatsSummary: undefined,
|
||||
lastRefreshRequestedAt: new Date(),
|
||||
isPrimary: true,
|
||||
},
|
||||
],
|
||||
}));
|
||||
const auctionCreate = jest.fn().mockImplementation(async (payload) => ({
|
||||
_id: new mongoose.Types.ObjectId(),
|
||||
matchId,
|
||||
toObject: jest.fn().mockReturnValue({ matchId, ...payload }),
|
||||
}));
|
||||
const { service } = createService({
|
||||
match: {
|
||||
findById: jest.fn().mockResolvedValue(match),
|
||||
},
|
||||
user: {
|
||||
find: jest.fn().mockResolvedValue(users),
|
||||
},
|
||||
auction: {
|
||||
findOne: jest.fn().mockResolvedValue(null),
|
||||
create: auctionCreate,
|
||||
},
|
||||
community: {
|
||||
findById: jest.fn().mockReturnValue({
|
||||
select: jest.fn().mockReturnValue({
|
||||
lean: jest.fn().mockReturnValue({
|
||||
exec: jest.fn().mockResolvedValue({
|
||||
riotPlatform: 'kr',
|
||||
riotRegion: 'asia',
|
||||
}),
|
||||
}),
|
||||
}),
|
||||
}),
|
||||
},
|
||||
});
|
||||
|
||||
await service.start({
|
||||
matchId,
|
||||
communityId,
|
||||
captains: [
|
||||
{ teamIndex: 1, userId: userIds[0] },
|
||||
{ teamIndex: 2, userId: userIds[1] },
|
||||
],
|
||||
initialPoints: 1000,
|
||||
maxTimerSeconds: 30,
|
||||
bidExtensionSeconds: 5,
|
||||
topTierThreshold: 'NONE',
|
||||
manualTopTierUserIds: [],
|
||||
});
|
||||
|
||||
const signupOrder = userIds.slice(2).map((userId) => userId.toString());
|
||||
const auctionOrder = auctionCreate.mock.calls[0][0].order.map(
|
||||
(player: { userId: mongoose.Types.ObjectId }) =>
|
||||
player.userId.toString(),
|
||||
);
|
||||
|
||||
expect(auctionOrder).not.toEqual(signupOrder);
|
||||
expect([...auctionOrder].sort()).toEqual([...signupOrder].sort());
|
||||
expect(randomSpy).toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('rejects bids when the team already has 5 members including captain', async () => {
|
||||
const matchId = new mongoose.Types.ObjectId();
|
||||
const auction = {
|
||||
@@ -254,7 +418,7 @@ describe('AuctionService', () => {
|
||||
expect(auction.save).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('marks a zero-bid player as passed and queues them for round two', async () => {
|
||||
it('marks a zero-bid player as passed and queues them for another round', async () => {
|
||||
const matchId = new mongoose.Types.ObjectId();
|
||||
const playerId = new mongoose.Types.ObjectId();
|
||||
const auction = {
|
||||
@@ -289,25 +453,63 @@ describe('AuctionService', () => {
|
||||
expect(auction.save).toHaveBeenCalledTimes(1);
|
||||
});
|
||||
|
||||
it('force-assigns second-pass players to the open team with most points', async () => {
|
||||
it('queues zero-bid passes after the first auction round', async () => {
|
||||
const matchId = new mongoose.Types.ObjectId();
|
||||
const playerId = new mongoose.Types.ObjectId();
|
||||
const auction = {
|
||||
_id: new mongoose.Types.ObjectId(),
|
||||
matchId,
|
||||
phase: 'bidding',
|
||||
currentBid: 0,
|
||||
currentIndex: 0,
|
||||
auctionRound: 2,
|
||||
order: [
|
||||
{
|
||||
userId: playerId,
|
||||
preferredPositions: [{ position: 'MID', priority: 1 }],
|
||||
passCount: 1,
|
||||
},
|
||||
],
|
||||
passedQueue: [],
|
||||
save: jest.fn().mockResolvedValue(undefined),
|
||||
toObject: jest.fn().mockReturnValue({ _id: 'auction', matchId }),
|
||||
};
|
||||
const { service } = createService({
|
||||
auction: {
|
||||
findOne: jest.fn().mockResolvedValue(auction),
|
||||
},
|
||||
});
|
||||
|
||||
await service.markPassed(matchId);
|
||||
|
||||
expect(auction.phase).toBe('passed');
|
||||
expect(auction.order[0].passCount).toBe(2);
|
||||
expect(auction.passedQueue).toHaveLength(1);
|
||||
expect(auction.passedQueue[0]).toMatchObject({
|
||||
userId: playerId.toString(),
|
||||
preferredPositions: [{ position: 'MID', priority: 1 }],
|
||||
passCount: 2,
|
||||
});
|
||||
});
|
||||
|
||||
it('requeues second-pass players instead of force-assigning them', async () => {
|
||||
const matchId = new mongoose.Types.ObjectId();
|
||||
const captainOneId = new mongoose.Types.ObjectId();
|
||||
const captainTwoId = new mongoose.Types.ObjectId();
|
||||
const passedPlayerId = new mongoose.Types.ObjectId();
|
||||
const passedPlayer = {
|
||||
userId: passedPlayerId,
|
||||
preferredPositions: [{ position: 'SUP', priority: 1 }],
|
||||
passCount: 2,
|
||||
};
|
||||
const auction = {
|
||||
_id: new mongoose.Types.ObjectId(),
|
||||
matchId,
|
||||
phase: 'passed',
|
||||
currentIndex: 0,
|
||||
auctionRound: 2,
|
||||
order: [
|
||||
{
|
||||
userId: passedPlayerId,
|
||||
preferredPositions: [{ position: 'SUP', priority: 1 }],
|
||||
passCount: 2,
|
||||
},
|
||||
],
|
||||
passedQueue: [],
|
||||
order: [passedPlayer],
|
||||
passedQueue: [passedPlayer],
|
||||
teams: [
|
||||
{
|
||||
teamIndex: 1,
|
||||
@@ -325,46 +527,28 @@ describe('AuctionService', () => {
|
||||
save: jest.fn().mockResolvedValue(undefined),
|
||||
toObject: jest.fn().mockReturnValue({ _id: 'auction', matchId }),
|
||||
};
|
||||
const match = {
|
||||
participants: [
|
||||
{
|
||||
userId: captainOneId,
|
||||
preferredPositions: [{ position: 'TOP', priority: 1 }],
|
||||
},
|
||||
{
|
||||
userId: captainTwoId,
|
||||
preferredPositions: [{ position: 'JGL', priority: 1 }],
|
||||
},
|
||||
{
|
||||
userId: passedPlayerId,
|
||||
preferredPositions: [{ position: 'SUP', priority: 1 }],
|
||||
},
|
||||
],
|
||||
status: 'team-built',
|
||||
teams: [],
|
||||
teamBuiltAt: undefined,
|
||||
save: jest.fn().mockResolvedValue(undefined),
|
||||
};
|
||||
const { service } = createService({
|
||||
auction: {
|
||||
findOne: jest.fn().mockResolvedValue(auction),
|
||||
},
|
||||
match: {
|
||||
findById: jest.fn().mockResolvedValue(match),
|
||||
},
|
||||
});
|
||||
|
||||
await service.next(matchId);
|
||||
|
||||
expect(auction.phase).toBe('complete');
|
||||
expect(auction.teams[1].members).toEqual([
|
||||
{
|
||||
userId: passedPlayerId,
|
||||
assignedPosition: 'SUP',
|
||||
cost: 1,
|
||||
},
|
||||
]);
|
||||
expect(auction.teams[1].points).toBe(49);
|
||||
expect(auction.phase).toBe('presenting');
|
||||
expect(auction.auctionRound).toBe(3);
|
||||
expect(auction.currentIndex).toBe(1);
|
||||
expect(auction.order).toHaveLength(2);
|
||||
expect(auction.order[1]).toMatchObject({
|
||||
userId: passedPlayerId.toString(),
|
||||
preferredPositions: [{ position: 'SUP', priority: 1 }],
|
||||
passCount: 2,
|
||||
});
|
||||
expect(auction.passedQueue).toEqual([]);
|
||||
expect(auction.teams[0].members).toEqual([]);
|
||||
expect(auction.teams[1].members).toEqual([]);
|
||||
expect(auction.teams[0].points).toBe(10);
|
||||
expect(auction.teams[1].points).toBe(50);
|
||||
});
|
||||
|
||||
it('syncs completed auction teams into the match document', async () => {
|
||||
|
||||
@@ -5,10 +5,12 @@ import {
|
||||
Logger,
|
||||
NotFoundException,
|
||||
} from '@nestjs/common';
|
||||
import { randomUUID } from 'crypto';
|
||||
import mongoose from 'mongoose';
|
||||
import { ConnectionService } from '../global/database/connection.service';
|
||||
import {
|
||||
AuctionActionType,
|
||||
AuctionChatMessage,
|
||||
AuctionDocument,
|
||||
AuctionPlayerSnapshot,
|
||||
AuctionTeam,
|
||||
@@ -26,6 +28,9 @@ import { TournamentResultService } from '../tournament-result/tournament-result.
|
||||
const AUCTION_MAX_TEAM_SIZE = 5;
|
||||
const AUCTION_BACKGROUND_ENRICHMENT_CONCURRENCY = 1;
|
||||
const AUCTION_ENRICHMENT_COOLDOWN_MS = 3 * 60 * 60 * 1000;
|
||||
const AUCTION_CHAT_MAX_MESSAGES = 200;
|
||||
const AUCTION_CHAT_MAX_MESSAGE_LENGTH = 300;
|
||||
const AUCTION_CHAT_MAX_DISPLAY_NAME_LENGTH = 24;
|
||||
|
||||
interface StartAuctionParams {
|
||||
matchId: mongoose.Types.ObjectId;
|
||||
@@ -54,6 +59,13 @@ interface MarkSoldParams {
|
||||
assignedPosition?: Position;
|
||||
}
|
||||
|
||||
interface AppendChatMessageParams {
|
||||
matchId: mongoose.Types.ObjectId;
|
||||
userId?: mongoose.Types.ObjectId;
|
||||
displayName?: string;
|
||||
message: string;
|
||||
}
|
||||
|
||||
export interface AuctionHistoryView {
|
||||
sequence: number;
|
||||
action: AuctionActionType;
|
||||
@@ -167,8 +179,9 @@ export class AuctionService {
|
||||
passCount: 0,
|
||||
});
|
||||
}
|
||||
const shuffledOrder = this.shuffleAuctionPlayerOrder(order);
|
||||
const prioritizedOrder = this.applyTopTierPriority(
|
||||
order,
|
||||
shuffledOrder,
|
||||
params.topTierThreshold,
|
||||
params.manualTopTierUserIds,
|
||||
);
|
||||
@@ -220,6 +233,31 @@ export class AuctionService {
|
||||
return auction;
|
||||
}
|
||||
|
||||
public async appendChatMessage(params: AppendChatMessageParams): Promise<{
|
||||
auction: AuctionDocument;
|
||||
message: AuctionChatMessage;
|
||||
}> {
|
||||
const auction = await this.getByMatchId(params.matchId);
|
||||
const messageText = this.normalizeChatMessage(params.message);
|
||||
const message: AuctionChatMessage = {
|
||||
id: randomUUID(),
|
||||
userId: params.userId,
|
||||
displayName: this.normalizeChatDisplayName(params.displayName),
|
||||
message: messageText,
|
||||
sentAt: new Date(),
|
||||
};
|
||||
|
||||
auction.chatMessages ??= [];
|
||||
auction.chatMessages.push(message);
|
||||
const overflow = auction.chatMessages.length - AUCTION_CHAT_MAX_MESSAGES;
|
||||
if (overflow > 0) {
|
||||
auction.chatMessages.splice(0, overflow);
|
||||
}
|
||||
|
||||
await auction.save();
|
||||
return { auction, message };
|
||||
}
|
||||
|
||||
public async listHistory(params: {
|
||||
matchId: mongoose.Types.ObjectId;
|
||||
communityId: mongoose.Types.ObjectId;
|
||||
@@ -344,9 +382,8 @@ export class AuctionService {
|
||||
|
||||
await this.recordSnapshot(auction, 'passed');
|
||||
current.passCount = (current.passCount ?? 0) + 1;
|
||||
if ((auction.auctionRound ?? 1) === 1) {
|
||||
auction.passedQueue.push(this.cloneAuctionPlayerSnapshot(current));
|
||||
}
|
||||
auction.passedQueue ??= [];
|
||||
auction.passedQueue.push(this.cloneAuctionPlayerSnapshot(current));
|
||||
auction.phase = 'passed';
|
||||
auction.currentDeadline = undefined;
|
||||
await auction.save();
|
||||
@@ -367,29 +404,22 @@ export class AuctionService {
|
||||
const nextIndex = auction.currentIndex + 1;
|
||||
const completesAuction =
|
||||
nextIndex >= auction.order.length &&
|
||||
!(
|
||||
(auction.auctionRound ?? 1) === 1 &&
|
||||
(auction.passedQueue?.length ?? 0) > 0
|
||||
);
|
||||
(auction.passedQueue?.length ?? 0) === 0;
|
||||
await this.recordSnapshot(auction, completesAuction ? 'complete' : 'next');
|
||||
if (nextIndex >= auction.order.length) {
|
||||
if (
|
||||
(auction.auctionRound ?? 1) === 1 &&
|
||||
(auction.passedQueue?.length ?? 0) > 0
|
||||
) {
|
||||
if ((auction.passedQueue?.length ?? 0) > 0) {
|
||||
auction.order.push(
|
||||
...auction.passedQueue.map((player) =>
|
||||
this.cloneAuctionPlayerSnapshot(player),
|
||||
),
|
||||
);
|
||||
auction.passedQueue = [];
|
||||
auction.auctionRound = 2;
|
||||
auction.auctionRound = (auction.auctionRound ?? 1) + 1;
|
||||
auction.currentIndex = nextIndex;
|
||||
auction.phase = 'presenting';
|
||||
auction.currentBid = 0;
|
||||
auction.currentBidderTeamIndex = undefined;
|
||||
} else {
|
||||
this.forceAssignRemainingPasses(auction);
|
||||
auction.phase = 'complete';
|
||||
auction.completedAt = new Date();
|
||||
}
|
||||
@@ -588,39 +618,18 @@ export class AuctionService {
|
||||
return [...top, ...rest];
|
||||
}
|
||||
|
||||
private forceAssignRemainingPasses(auction: AuctionDocument): void {
|
||||
const forcedPlayers = auction.order.filter(
|
||||
(player) =>
|
||||
(player.passCount ?? 0) >= 2 &&
|
||||
!this.isAuctionPlayerAssigned(auction, player.userId),
|
||||
);
|
||||
|
||||
for (const player of forcedPlayers) {
|
||||
const targetTeam = [...auction.teams]
|
||||
.filter(
|
||||
(team) => this.countTeamMembersIncludingCaptain(team) < AUCTION_MAX_TEAM_SIZE,
|
||||
)
|
||||
.sort((left, right) => right.points - left.points)[0];
|
||||
if (!targetTeam) return;
|
||||
|
||||
const preferredPrimary = player.preferredPositions[0]?.position;
|
||||
targetTeam.members.push({
|
||||
userId: player.userId,
|
||||
assignedPosition: preferredPrimary ?? 'MID',
|
||||
cost: 1,
|
||||
});
|
||||
targetTeam.points = Math.max(0, targetTeam.points - 1);
|
||||
private shuffleAuctionPlayerOrder(
|
||||
order: AuctionPlayerSnapshot[],
|
||||
): AuctionPlayerSnapshot[] {
|
||||
const shuffled = [...order];
|
||||
for (let index = shuffled.length - 1; index > 0; index -= 1) {
|
||||
const swapIndex = Math.floor(Math.random() * (index + 1));
|
||||
[shuffled[index], shuffled[swapIndex]] = [
|
||||
shuffled[swapIndex],
|
||||
shuffled[index],
|
||||
];
|
||||
}
|
||||
}
|
||||
|
||||
private isAuctionPlayerAssigned(
|
||||
auction: AuctionDocument,
|
||||
userId: mongoose.Types.ObjectId,
|
||||
): boolean {
|
||||
const userIdText = userId.toString();
|
||||
return auction.teams.some((team) =>
|
||||
team.members.some((member) => member.userId.toString() === userIdText),
|
||||
);
|
||||
return shuffled;
|
||||
}
|
||||
|
||||
private cloneAuctionPlayerSnapshot(
|
||||
@@ -629,6 +638,28 @@ export class AuctionService {
|
||||
return JSON.parse(JSON.stringify(player)) as AuctionPlayerSnapshot;
|
||||
}
|
||||
|
||||
private normalizeChatMessage(message: string): string {
|
||||
const normalized = message.trim();
|
||||
if (!normalized) {
|
||||
throw new BadRequestException('Chat message is required.');
|
||||
}
|
||||
if (Array.from(normalized).length > AUCTION_CHAT_MAX_MESSAGE_LENGTH) {
|
||||
throw new BadRequestException(
|
||||
`Chat message must be ${AUCTION_CHAT_MAX_MESSAGE_LENGTH} characters or less.`,
|
||||
);
|
||||
}
|
||||
return normalized;
|
||||
}
|
||||
|
||||
private normalizeChatDisplayName(displayName: string | undefined): string {
|
||||
const normalized = displayName?.trim() || '관전자';
|
||||
const chars = Array.from(normalized);
|
||||
if (chars.length <= AUCTION_CHAT_MAX_DISPLAY_NAME_LENGTH) {
|
||||
return normalized;
|
||||
}
|
||||
return chars.slice(0, AUCTION_CHAT_MAX_DISPLAY_NAME_LENGTH).join('');
|
||||
}
|
||||
|
||||
private async recordSnapshot(
|
||||
auction: AuctionDocument,
|
||||
action: AuctionActionType,
|
||||
|
||||
@@ -0,0 +1,123 @@
|
||||
import { Injectable } from '@nestjs/common';
|
||||
import { ConnectionService } from '../global/database/connection.service';
|
||||
|
||||
const DEFAULT_LEASE_MS = 5 * 60 * 1000;
|
||||
|
||||
export type DakaoInboxClaimResult =
|
||||
| { status: 'claimed' }
|
||||
| { status: 'duplicate' }
|
||||
| { status: 'inflight' };
|
||||
|
||||
@Injectable()
|
||||
export class DakaoInboxService {
|
||||
constructor(private readonly connectionService: ConnectionService) {}
|
||||
|
||||
public async claim(params: {
|
||||
consumer: string;
|
||||
projectId: string;
|
||||
chatLogLogId: string;
|
||||
leaseMs?: number;
|
||||
}): Promise<DakaoInboxClaimResult> {
|
||||
const Model = await this.connectionService.getModel('dakaoInboundMessage');
|
||||
const now = new Date();
|
||||
const processingExpiresAt = new Date(
|
||||
now.getTime() + (params.leaseMs ?? DEFAULT_LEASE_MS),
|
||||
);
|
||||
|
||||
try {
|
||||
await Model.create({
|
||||
consumer: params.consumer,
|
||||
projectId: params.projectId,
|
||||
chatLogLogId: params.chatLogLogId,
|
||||
state: 'processing',
|
||||
attempts: 1,
|
||||
processingExpiresAt,
|
||||
});
|
||||
return { status: 'claimed' };
|
||||
} catch (err) {
|
||||
if ((err as { code?: number })?.code !== 11000) throw err;
|
||||
}
|
||||
|
||||
const existing = await Model.findOne({
|
||||
consumer: params.consumer,
|
||||
projectId: params.projectId,
|
||||
chatLogLogId: params.chatLogLogId,
|
||||
})
|
||||
.lean()
|
||||
.exec();
|
||||
if (!existing) return { status: 'inflight' };
|
||||
if (existing.state === 'processed') return { status: 'duplicate' };
|
||||
if (
|
||||
existing.state === 'processing' &&
|
||||
existing.processingExpiresAt &&
|
||||
existing.processingExpiresAt > now
|
||||
) {
|
||||
return { status: 'inflight' };
|
||||
}
|
||||
|
||||
const updated = await Model.updateOne(
|
||||
{
|
||||
_id: existing._id,
|
||||
$or: [
|
||||
{ state: 'failed' },
|
||||
{ state: 'processing', processingExpiresAt: { $lte: now } },
|
||||
],
|
||||
},
|
||||
{
|
||||
$set: {
|
||||
state: 'processing',
|
||||
processingExpiresAt,
|
||||
},
|
||||
$inc: { attempts: 1 },
|
||||
},
|
||||
).exec();
|
||||
return updated.modifiedCount > 0
|
||||
? { status: 'claimed' }
|
||||
: { status: 'inflight' };
|
||||
}
|
||||
|
||||
public async markProcessed(params: {
|
||||
consumer: string;
|
||||
projectId: string;
|
||||
chatLogLogId: string;
|
||||
}): Promise<void> {
|
||||
const Model = await this.connectionService.getModel('dakaoInboundMessage');
|
||||
await Model.updateOne(
|
||||
{
|
||||
consumer: params.consumer,
|
||||
projectId: params.projectId,
|
||||
chatLogLogId: params.chatLogLogId,
|
||||
},
|
||||
{
|
||||
$set: {
|
||||
state: 'processed',
|
||||
processedAt: new Date(),
|
||||
},
|
||||
$unset: { processingExpiresAt: '', lastError: '' },
|
||||
},
|
||||
).exec();
|
||||
}
|
||||
|
||||
public async markFailed(params: {
|
||||
consumer: string;
|
||||
projectId: string;
|
||||
chatLogLogId: string;
|
||||
error: unknown;
|
||||
}): Promise<void> {
|
||||
const Model = await this.connectionService.getModel('dakaoInboundMessage');
|
||||
await Model.updateOne(
|
||||
{
|
||||
consumer: params.consumer,
|
||||
projectId: params.projectId,
|
||||
chatLogLogId: params.chatLogLogId,
|
||||
},
|
||||
{
|
||||
$set: {
|
||||
state: 'failed',
|
||||
lastError: (params.error as Error)?.message ?? String(params.error),
|
||||
},
|
||||
$unset: { processingExpiresAt: '' },
|
||||
},
|
||||
).exec();
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,64 @@
|
||||
import { Injectable } from '@nestjs/common';
|
||||
import { NatsService } from '../global/nats/nats.service';
|
||||
import { resolveDakaoNatsNames } from './dakao.nats-names';
|
||||
|
||||
@Injectable()
|
||||
export class DakaoJetStreamResourceService {
|
||||
private ensurePromise: Promise<void> | null = null;
|
||||
|
||||
constructor(private readonly natsService: NatsService) {}
|
||||
|
||||
public async ensure(): Promise<void> {
|
||||
this.ensurePromise ??= this.ensureInternal();
|
||||
await this.ensurePromise;
|
||||
}
|
||||
|
||||
private async ensureInternal(): Promise<void> {
|
||||
const names = resolveDakaoNatsNames();
|
||||
await this.natsService.ensureJetStreamStream({
|
||||
name: names.streams.botCommand,
|
||||
subjects: [names.subjects.botCommandSubmitted],
|
||||
retention: 'workqueue',
|
||||
replicas: 1,
|
||||
});
|
||||
await this.natsService.ensureJetStreamConsumer({
|
||||
stream: names.streams.botCommand,
|
||||
durable: names.consumers.botCommand,
|
||||
filterSubject: names.subjects.botCommandSubmitted,
|
||||
description: 'LolyMpus Dakao bot command handler',
|
||||
replicas: 1,
|
||||
});
|
||||
|
||||
await this.natsService.ensureJetStreamStream({
|
||||
name: names.streams.sendRequest,
|
||||
subjects: [names.subjects.chatSendMessage],
|
||||
retention: 'workqueue',
|
||||
replicas: 1,
|
||||
});
|
||||
await this.natsService.ensureJetStreamConsumer({
|
||||
stream: names.streams.sendRequest,
|
||||
durable: names.consumers.sendRequest,
|
||||
filterSubject: names.subjects.chatSendMessage,
|
||||
description: 'Dakao send-message worker',
|
||||
replicas: 1,
|
||||
});
|
||||
|
||||
await this.natsService.ensureJetStreamStream({
|
||||
name: names.streams.sendResult,
|
||||
subjects: [
|
||||
names.subjects.chatSendMessageSucceeded,
|
||||
names.subjects.chatSendMessageFailed,
|
||||
],
|
||||
retention: 'limits',
|
||||
maxAgeDays: 30,
|
||||
replicas: 1,
|
||||
});
|
||||
await this.natsService.ensureJetStreamConsumer({
|
||||
stream: names.streams.sendResult,
|
||||
durable: names.consumers.sendResult,
|
||||
filterSubject: `${names.env}.lolympus.dakao.chat.send-message.*.v1`,
|
||||
description: 'LolyMpus Dakao send-message result handler',
|
||||
replicas: 1,
|
||||
});
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
import {
|
||||
Injectable,
|
||||
Logger,
|
||||
OnModuleDestroy,
|
||||
OnModuleInit,
|
||||
} from '@nestjs/common';
|
||||
import { DakaoOutboxService } from './dakao-outbox.service';
|
||||
|
||||
const SWEEP_INTERVAL_MS = 60 * 1000;
|
||||
const STALE_OUTBOX_MS = 5 * 60 * 1000;
|
||||
|
||||
@Injectable()
|
||||
export class DakaoOutboxSweeperService
|
||||
implements OnModuleInit, OnModuleDestroy
|
||||
{
|
||||
private readonly logger = new Logger(DakaoOutboxSweeperService.name);
|
||||
private timer: NodeJS.Timeout | undefined;
|
||||
|
||||
constructor(private readonly outboxService: DakaoOutboxService) {}
|
||||
|
||||
onModuleInit() {
|
||||
this.timer = setInterval(() => {
|
||||
void this.sweep();
|
||||
}, SWEEP_INTERVAL_MS);
|
||||
this.timer.unref();
|
||||
}
|
||||
|
||||
onModuleDestroy() {
|
||||
if (this.timer) clearInterval(this.timer);
|
||||
}
|
||||
|
||||
private async sweep(): Promise<void> {
|
||||
try {
|
||||
const swept = await this.outboxService.sweepStale({
|
||||
staleMs: STALE_OUTBOX_MS,
|
||||
limit: 20,
|
||||
});
|
||||
if (swept > 0) {
|
||||
this.logger.warn(`Re-published ${swept} stale Dakao outbox messages.`);
|
||||
}
|
||||
} catch (err) {
|
||||
this.logger.error(
|
||||
`Dakao outbox sweep failed: ${(err as Error)?.stack ?? err}`,
|
||||
);
|
||||
}
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,116 @@
|
||||
import { ConnectionService } from '../global/database/connection.service';
|
||||
import { NatsService } from '../global/nats/nats.service';
|
||||
import { DakaoOutboxService } from './dakao-outbox.service';
|
||||
import { DakaoResultSubjects } from './dakao.types';
|
||||
|
||||
function execResult<T>(value: T) {
|
||||
return { exec: jest.fn().mockResolvedValue(value) };
|
||||
}
|
||||
|
||||
function makeService(outboxModel: Record<string, unknown>) {
|
||||
const connectionService = {
|
||||
getModel: jest.fn().mockResolvedValue(outboxModel),
|
||||
} as unknown as ConnectionService;
|
||||
const natsService = {
|
||||
publishJetStream: jest.fn().mockResolvedValue(undefined),
|
||||
} as unknown as NatsService;
|
||||
|
||||
return {
|
||||
service: new DakaoOutboxService(connectionService, natsService),
|
||||
connectionService,
|
||||
natsService,
|
||||
};
|
||||
}
|
||||
|
||||
describe('DakaoOutboxService', () => {
|
||||
it('persists result subjects when enqueuing send-message commands', async () => {
|
||||
const outboxModel = {
|
||||
findOneAndUpdate: jest.fn().mockReturnValue(execResult({})),
|
||||
updateOne: jest.fn().mockReturnValue(execResult({})),
|
||||
};
|
||||
const { service, natsService } = makeService(outboxModel);
|
||||
const resultSubjects: DakaoResultSubjects = {
|
||||
succeeded: 'staging.lolympus.dakao.chat.send-message.succeeded.v1',
|
||||
failed: 'staging.lolympus.dakao.chat.send-message.failed.v1',
|
||||
};
|
||||
|
||||
await service.enqueueAndPublish({
|
||||
subject: 'staging.dakao.chat.send-message.v1',
|
||||
eventId: 'lolympus:chat.send-message:chat-log-1',
|
||||
envelope: {
|
||||
schema: 'dakao.command.v1',
|
||||
eventId: 'lolympus:chat.send-message:chat-log-1',
|
||||
type: 'chat.send-message',
|
||||
eventSource: 'lolympus',
|
||||
correlationId: 'chat-log-1',
|
||||
resultSubjects,
|
||||
payload: {
|
||||
chatroomId: '18474390111480678',
|
||||
segments: [{ kind: 'text', text: 'done' }],
|
||||
},
|
||||
},
|
||||
});
|
||||
|
||||
expect(outboxModel.findOneAndUpdate).toHaveBeenCalledWith(
|
||||
{ eventId: 'lolympus:chat.send-message:chat-log-1' },
|
||||
expect.objectContaining({
|
||||
$setOnInsert: expect.objectContaining({ resultSubjects }),
|
||||
}),
|
||||
expect.any(Object),
|
||||
);
|
||||
expect(natsService.publishJetStream).toHaveBeenCalledWith(
|
||||
'staging.dakao.chat.send-message.v1',
|
||||
expect.objectContaining({ resultSubjects }),
|
||||
{ messageId: 'lolympus:chat.send-message:chat-log-1' },
|
||||
);
|
||||
});
|
||||
|
||||
it('restores send-message result subjects when sweeping legacy stale rows', async () => {
|
||||
const previousNodeEnv = process.env.NODE_ENV;
|
||||
process.env.NODE_ENV = 'staging';
|
||||
|
||||
try {
|
||||
const exec = jest.fn().mockResolvedValue([
|
||||
{
|
||||
eventId: 'lolympus:chat.send-message:chat-log-1',
|
||||
type: 'chat.send-message',
|
||||
eventSource: 'lolympus',
|
||||
subject: 'staging.dakao.chat.send-message.v1',
|
||||
correlationId: 'chat-log-1',
|
||||
payload: {
|
||||
chatroomId: '18474390111480678',
|
||||
segments: [{ kind: 'text', text: 'done' }],
|
||||
},
|
||||
},
|
||||
]);
|
||||
const lean = jest.fn().mockReturnValue({ exec });
|
||||
const limit = jest.fn().mockReturnValue({ lean });
|
||||
const sort = jest.fn().mockReturnValue({ limit });
|
||||
const outboxModel = {
|
||||
find: jest.fn().mockReturnValue({ sort }),
|
||||
};
|
||||
const { service } = makeService(outboxModel);
|
||||
const enqueue = jest
|
||||
.spyOn(service, 'enqueueAndPublish')
|
||||
.mockResolvedValue(undefined);
|
||||
|
||||
await expect(service.sweepStale({ staleMs: 1, limit: 1 })).resolves.toBe(
|
||||
1,
|
||||
);
|
||||
|
||||
expect(enqueue).toHaveBeenCalledWith(
|
||||
expect.objectContaining({
|
||||
envelope: expect.objectContaining({
|
||||
resultSubjects: {
|
||||
succeeded:
|
||||
'staging.lolympus.dakao.chat.send-message.succeeded.v1',
|
||||
failed: 'staging.lolympus.dakao.chat.send-message.failed.v1',
|
||||
},
|
||||
}),
|
||||
}),
|
||||
);
|
||||
} finally {
|
||||
process.env.NODE_ENV = previousNodeEnv;
|
||||
}
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,191 @@
|
||||
import { Injectable, Logger } from '@nestjs/common';
|
||||
import { ConnectionService } from '../global/database/connection.service';
|
||||
import { NatsService } from '../global/nats/nats.service';
|
||||
import { resolveDakaoNatsNames } from './dakao.nats-names';
|
||||
import {
|
||||
DakaoCommandEnvelope,
|
||||
DakaoResultEnvelope,
|
||||
DakaoResultSubjects,
|
||||
} from './dakao.types';
|
||||
|
||||
const CHAT_SEND_MESSAGE_TYPE = 'chat.send-message';
|
||||
const TERMINAL_STATES = ['sent', 'failed'] as const;
|
||||
|
||||
@Injectable()
|
||||
export class DakaoOutboxService {
|
||||
private readonly logger = new Logger(DakaoOutboxService.name);
|
||||
private readonly chatSendMessageResultSubjects = {
|
||||
succeeded: resolveDakaoNatsNames().subjects.chatSendMessageSucceeded,
|
||||
failed: resolveDakaoNatsNames().subjects.chatSendMessageFailed,
|
||||
};
|
||||
|
||||
constructor(
|
||||
private readonly connectionService: ConnectionService,
|
||||
private readonly natsService: NatsService,
|
||||
) {}
|
||||
|
||||
public async enqueueAndPublish<TPayload>(params: {
|
||||
subject: string;
|
||||
eventId: string;
|
||||
envelope: DakaoCommandEnvelope<TPayload>;
|
||||
}): Promise<void> {
|
||||
const OutboxModel =
|
||||
await this.connectionService.getModel('dakaoOutboxMessage');
|
||||
await OutboxModel.findOneAndUpdate(
|
||||
{ eventId: params.eventId },
|
||||
{
|
||||
$setOnInsert: {
|
||||
eventId: params.eventId,
|
||||
eventSource: params.envelope.eventSource,
|
||||
type: params.envelope.type,
|
||||
subject: params.subject,
|
||||
correlationId: params.envelope.correlationId,
|
||||
resultSubjects: params.envelope.resultSubjects,
|
||||
payload: params.envelope.payload as Record<string, unknown>,
|
||||
state: 'pending',
|
||||
publishAttempts: 0,
|
||||
compensationState: 'none',
|
||||
},
|
||||
},
|
||||
{ upsert: true, returnDocument: 'after', setDefaultsOnInsert: true },
|
||||
).exec();
|
||||
|
||||
try {
|
||||
await this.natsService.publishJetStream(params.subject, params.envelope, {
|
||||
messageId: params.eventId,
|
||||
});
|
||||
await OutboxModel.updateOne(
|
||||
{
|
||||
eventId: params.eventId,
|
||||
state: { $nin: TERMINAL_STATES },
|
||||
},
|
||||
{
|
||||
$set: {
|
||||
state: 'published',
|
||||
publishedAt: new Date(),
|
||||
},
|
||||
$inc: { publishAttempts: 1 },
|
||||
$unset: { lastPublishError: '' },
|
||||
},
|
||||
).exec();
|
||||
} catch (err) {
|
||||
await OutboxModel.updateOne(
|
||||
{
|
||||
eventId: params.eventId,
|
||||
state: { $nin: TERMINAL_STATES },
|
||||
},
|
||||
{
|
||||
$inc: { publishAttempts: 1 },
|
||||
$set: {
|
||||
lastPublishError: (err as Error)?.message ?? String(err),
|
||||
},
|
||||
},
|
||||
).exec();
|
||||
this.logger.error(
|
||||
`Failed to publish Dakao outbox eventId=${params.eventId}: ${
|
||||
(err as Error)?.stack ?? err
|
||||
}`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
public async applySendResult(params: {
|
||||
subject: string;
|
||||
envelope: DakaoResultEnvelope;
|
||||
}): Promise<{ duplicate: boolean; terminalState?: 'sent' | 'failed' }> {
|
||||
const ResultModel = await this.connectionService.getModel(
|
||||
'dakaoSendResultEvent',
|
||||
);
|
||||
const OutboxModel =
|
||||
await this.connectionService.getModel('dakaoOutboxMessage');
|
||||
|
||||
try {
|
||||
await ResultModel.create({
|
||||
eventId: params.envelope.eventId,
|
||||
requestEventId: params.envelope.requestEventId,
|
||||
eventSource: params.envelope.eventSource,
|
||||
requestEventSource: params.envelope.requestEventSource,
|
||||
type: params.envelope.type,
|
||||
subject: params.subject,
|
||||
status: params.envelope.status,
|
||||
correlationId: params.envelope.correlationId,
|
||||
handledAt: new Date(params.envelope.handledAt),
|
||||
providerMessageId: params.envelope.providerMessageId,
|
||||
error: params.envelope.error,
|
||||
raw: params.envelope as unknown as Record<string, unknown>,
|
||||
});
|
||||
} catch (err) {
|
||||
if ((err as { code?: number })?.code === 11000) {
|
||||
return { duplicate: true };
|
||||
}
|
||||
throw err;
|
||||
}
|
||||
|
||||
const terminalState =
|
||||
params.envelope.status === 'succeeded' ? 'sent' : 'failed';
|
||||
await OutboxModel.updateOne(
|
||||
{
|
||||
eventId: params.envelope.requestEventId,
|
||||
state: { $nin: TERMINAL_STATES },
|
||||
},
|
||||
{
|
||||
$set: {
|
||||
state: terminalState,
|
||||
terminalAt: new Date(),
|
||||
resultEventId: params.envelope.eventId,
|
||||
terminalError: params.envelope.error,
|
||||
compensationState:
|
||||
params.envelope.status === 'failed' ? 'pending' : 'none',
|
||||
compensationReason: params.envelope.error?.code,
|
||||
},
|
||||
},
|
||||
).exec();
|
||||
|
||||
return { duplicate: false, terminalState };
|
||||
}
|
||||
|
||||
public async sweepStale(params?: {
|
||||
staleMs?: number;
|
||||
limit?: number;
|
||||
}): Promise<number> {
|
||||
const OutboxModel =
|
||||
await this.connectionService.getModel('dakaoOutboxMessage');
|
||||
const staleBefore = new Date(
|
||||
Date.now() - (params?.staleMs ?? 5 * 60 * 1000),
|
||||
);
|
||||
const rows = await OutboxModel.find({
|
||||
state: { $in: ['pending', 'published'] },
|
||||
updatedAt: { $lte: staleBefore },
|
||||
})
|
||||
.sort({ updatedAt: 1 })
|
||||
.limit(params?.limit ?? 20)
|
||||
.lean()
|
||||
.exec();
|
||||
|
||||
for (const row of rows) {
|
||||
await this.enqueueAndPublish({
|
||||
subject: row.subject,
|
||||
eventId: row.eventId,
|
||||
envelope: {
|
||||
schema: 'dakao.command.v1',
|
||||
eventId: row.eventId,
|
||||
type: row.type,
|
||||
eventSource: row.eventSource,
|
||||
correlationId: row.correlationId,
|
||||
resultSubjects:
|
||||
row.resultSubjects ?? this.resolveDefaultResultSubjects(row.type),
|
||||
payload: row.payload,
|
||||
},
|
||||
});
|
||||
}
|
||||
|
||||
return rows.length;
|
||||
}
|
||||
|
||||
private resolveDefaultResultSubjects(
|
||||
type: string,
|
||||
): DakaoResultSubjects | undefined {
|
||||
if (type !== CHAT_SEND_MESSAGE_TYPE) return undefined;
|
||||
return this.chatSendMessageResultSubjects;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,81 @@
|
||||
import { Injectable, Logger, OnModuleInit } from '@nestjs/common';
|
||||
import { NatsService } from '../global/nats/nats.service';
|
||||
import { DakaoJetStreamResourceService } from './dakao-jetstream-resource.service';
|
||||
import { resolveDakaoNatsNames } from './dakao.nats-names';
|
||||
import { DakaoOutboxService } from './dakao-outbox.service';
|
||||
import { DakaoResultEnvelope } from './dakao.types';
|
||||
|
||||
@Injectable()
|
||||
export class DakaoSendResultSubscriber implements OnModuleInit {
|
||||
private readonly logger = new Logger(DakaoSendResultSubscriber.name);
|
||||
|
||||
constructor(
|
||||
private readonly natsService: NatsService,
|
||||
private readonly resources: DakaoJetStreamResourceService,
|
||||
private readonly outboxService: DakaoOutboxService,
|
||||
) {}
|
||||
|
||||
async onModuleInit() {
|
||||
await this.resources.ensure();
|
||||
const names = resolveDakaoNatsNames();
|
||||
void this.natsService.consumeJetStream<DakaoResultEnvelope>(
|
||||
{
|
||||
stream: names.streams.sendResult,
|
||||
durable: names.consumers.sendResult,
|
||||
},
|
||||
(event, msg) => this.handleResult(event, msg.subject),
|
||||
);
|
||||
this.logger.log(
|
||||
`Dakao send-result subscriber ready on stream="${names.streams.sendResult}" durable="${names.consumers.sendResult}"`,
|
||||
);
|
||||
}
|
||||
|
||||
private async handleResult(
|
||||
event: DakaoResultEnvelope,
|
||||
subject: string,
|
||||
): Promise<void> {
|
||||
if (!this.validate(event)) {
|
||||
this.logger.warn(`Ignoring invalid Dakao send-result on ${subject}`);
|
||||
return;
|
||||
}
|
||||
|
||||
const result = await this.outboxService.applySendResult({
|
||||
subject,
|
||||
envelope: event,
|
||||
});
|
||||
if (result.duplicate) {
|
||||
this.logger.log(
|
||||
`Duplicate Dakao result ignored eventId=${event.eventId}`,
|
||||
);
|
||||
return;
|
||||
}
|
||||
this.logger.log(
|
||||
`Dakao result applied eventId=${event.eventId} requestEventId=${event.requestEventId} state=${result.terminalState ?? '-'}`,
|
||||
);
|
||||
}
|
||||
|
||||
private validate(event: unknown): event is DakaoResultEnvelope {
|
||||
if (!event || typeof event !== 'object') return false;
|
||||
const e = event as Partial<DakaoResultEnvelope>;
|
||||
if (e.schema !== 'dakao.result.v1') return false;
|
||||
if (typeof e.eventId !== 'string' || e.eventId.length === 0) return false;
|
||||
if (typeof e.requestEventId !== 'string' || e.requestEventId.length === 0) {
|
||||
return false;
|
||||
}
|
||||
if (typeof e.eventSource !== 'string' || e.eventSource.length === 0)
|
||||
return false;
|
||||
if (
|
||||
typeof e.requestEventSource !== 'string' ||
|
||||
e.requestEventSource.length === 0
|
||||
) {
|
||||
return false;
|
||||
}
|
||||
if (e.status !== 'succeeded' && e.status !== 'failed') return false;
|
||||
if (
|
||||
typeof e.handledAt !== 'string' ||
|
||||
Number.isNaN(Date.parse(e.handledAt))
|
||||
)
|
||||
return false;
|
||||
return true;
|
||||
}
|
||||
}
|
||||
@@ -1,14 +1,15 @@
|
||||
import { Module } from '@nestjs/common';
|
||||
import { MatchModule } from '../match/match.module';
|
||||
import { RiotModule } from '../riot/riot.module';
|
||||
import {
|
||||
DAKAO_OPTIONS,
|
||||
createDefaultDakaoOptions,
|
||||
} from './dakao.options';
|
||||
import { DAKAO_OPTIONS, createDefaultDakaoOptions } from './dakao.options';
|
||||
import { DakaoPublisher } from './dakao.publisher';
|
||||
import { DakaoSubscriber } from './dakao.subscriber';
|
||||
import { DakaoInboxService } from './dakao-inbox.service';
|
||||
import { DakaoJetStreamResourceService } from './dakao-jetstream-resource.service';
|
||||
import { DakaoOutboxSweeperService } from './dakao-outbox-sweeper.service';
|
||||
import { DakaoOutboxService } from './dakao-outbox.service';
|
||||
import { DakaoUserService } from './dakao-user.service';
|
||||
import { IdempotencyCache } from './idempotency.cache';
|
||||
import { DakaoSendResultSubscriber } from './dakao-send-result.subscriber';
|
||||
import { AccountRegisterHandler } from './handlers/account-register.handler';
|
||||
import { MatchCancelHandler } from './handlers/match-cancel.handler';
|
||||
import { MatchJoinHandler } from './handlers/match-join.handler';
|
||||
@@ -22,10 +23,14 @@ import { PreferredPositionRegisterHandler } from './handlers/preferred-position-
|
||||
provide: DAKAO_OPTIONS,
|
||||
useFactory: createDefaultDakaoOptions,
|
||||
},
|
||||
DakaoOutboxService,
|
||||
DakaoOutboxSweeperService,
|
||||
DakaoInboxService,
|
||||
DakaoJetStreamResourceService,
|
||||
DakaoPublisher,
|
||||
DakaoSubscriber,
|
||||
DakaoSendResultSubscriber,
|
||||
DakaoUserService,
|
||||
IdempotencyCache,
|
||||
AccountRegisterHandler,
|
||||
MatchListHandler,
|
||||
MatchJoinHandler,
|
||||
|
||||
@@ -0,0 +1,38 @@
|
||||
import { resolveDakaoNatsNames } from './dakao.nats-names';
|
||||
|
||||
describe('resolveDakaoNatsNames', () => {
|
||||
it('resolves staging subjects and JetStream resources from NODE_ENV=staging', () => {
|
||||
expect(resolveDakaoNatsNames('staging')).toEqual({
|
||||
env: 'staging',
|
||||
shortEnv: 'STG',
|
||||
subjects: {
|
||||
botCommandSubmitted: 'staging.lolympus.dakao.bot-command.submitted.v1',
|
||||
chatSendMessage: 'staging.dakao.chat.send-message.v1',
|
||||
chatSendMessageSucceeded:
|
||||
'staging.lolympus.dakao.chat.send-message.succeeded.v1',
|
||||
chatSendMessageFailed:
|
||||
'staging.lolympus.dakao.chat.send-message.failed.v1',
|
||||
},
|
||||
streams: {
|
||||
botCommand: 'STG_DAKAO_TO_LOLYMPUS_BOTCMD',
|
||||
sendRequest: 'STG_DAKAO_SENDREQ',
|
||||
sendResult: 'STG_DAKAO_TO_LOLYMPUS_SENDRES',
|
||||
},
|
||||
consumers: {
|
||||
botCommand: 'STG_LOLYMPUS_BOTCMD',
|
||||
sendRequest: 'STG_DAKAO_SENDREQ_WORKER',
|
||||
sendResult: 'STG_LOLYMPUS_SENDRES',
|
||||
},
|
||||
});
|
||||
});
|
||||
|
||||
it('keeps JetStream resource names within the 32 character safety target', () => {
|
||||
const names = resolveDakaoNatsNames('prod');
|
||||
const resources = [
|
||||
...Object.values(names.streams),
|
||||
...Object.values(names.consumers),
|
||||
];
|
||||
|
||||
expect(resources.every((name) => name.length <= 32)).toBe(true);
|
||||
});
|
||||
});
|
||||
@@ -0,0 +1,68 @@
|
||||
export type DakaoRuntimeEnv = 'dev' | 'staging' | 'prod';
|
||||
export type DakaoShortEnv = 'DEV' | 'STG' | 'PROD';
|
||||
|
||||
export interface DakaoNatsNames {
|
||||
env: DakaoRuntimeEnv;
|
||||
shortEnv: DakaoShortEnv;
|
||||
subjects: {
|
||||
botCommandSubmitted: string;
|
||||
chatSendMessage: string;
|
||||
chatSendMessageSucceeded: string;
|
||||
chatSendMessageFailed: string;
|
||||
};
|
||||
streams: {
|
||||
botCommand: string;
|
||||
sendRequest: string;
|
||||
sendResult: string;
|
||||
};
|
||||
consumers: {
|
||||
botCommand: string;
|
||||
sendRequest: string;
|
||||
sendResult: string;
|
||||
};
|
||||
}
|
||||
|
||||
export function resolveDakaoNatsNames(
|
||||
nodeEnv = process.env.NODE_ENV,
|
||||
): DakaoNatsNames {
|
||||
const env = resolveRuntimeEnv(nodeEnv);
|
||||
const shortEnv = toShortEnv(env);
|
||||
|
||||
return {
|
||||
env,
|
||||
shortEnv,
|
||||
subjects: {
|
||||
botCommandSubmitted: `${env}.lolympus.dakao.bot-command.submitted.v1`,
|
||||
chatSendMessage: `${env}.dakao.chat.send-message.v1`,
|
||||
chatSendMessageSucceeded: `${env}.lolympus.dakao.chat.send-message.succeeded.v1`,
|
||||
chatSendMessageFailed: `${env}.lolympus.dakao.chat.send-message.failed.v1`,
|
||||
},
|
||||
streams: {
|
||||
botCommand: `${shortEnv}_DAKAO_TO_LOLYMPUS_BOTCMD`,
|
||||
sendRequest: `${shortEnv}_DAKAO_SENDREQ`,
|
||||
sendResult: `${shortEnv}_DAKAO_TO_LOLYMPUS_SENDRES`,
|
||||
},
|
||||
consumers: {
|
||||
botCommand: `${shortEnv}_LOLYMPUS_BOTCMD`,
|
||||
sendRequest: `${shortEnv}_DAKAO_SENDREQ_WORKER`,
|
||||
sendResult: `${shortEnv}_LOLYMPUS_SENDRES`,
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
function resolveRuntimeEnv(nodeEnv?: string): DakaoRuntimeEnv {
|
||||
if (nodeEnv === 'prod' || nodeEnv === 'production') return 'prod';
|
||||
if (nodeEnv === 'staging') return 'staging';
|
||||
return 'dev';
|
||||
}
|
||||
|
||||
function toShortEnv(env: DakaoRuntimeEnv): DakaoShortEnv {
|
||||
switch (env) {
|
||||
case 'prod':
|
||||
return 'PROD';
|
||||
case 'staging':
|
||||
return 'STG';
|
||||
case 'dev':
|
||||
return 'DEV';
|
||||
}
|
||||
}
|
||||
@@ -1,32 +1,38 @@
|
||||
import { SecretService } from '../global/secret/secret.service';
|
||||
import { NatsService } from '../global/nats/nats.service';
|
||||
import { DakaoCommandEnvelope, DakaoSendMessagePayload } from './dakao.types';
|
||||
import { DakaoPublisher } from './dakao.publisher';
|
||||
import { DakaoOutboxService } from './dakao-outbox.service';
|
||||
|
||||
function makePublisher() {
|
||||
const natsService = {
|
||||
publish: jest.fn().mockResolvedValue(undefined),
|
||||
subscribe: jest.fn(),
|
||||
} as unknown as NatsService;
|
||||
const outboxService = {
|
||||
enqueueAndPublish: jest.fn().mockResolvedValue(undefined),
|
||||
} as unknown as DakaoOutboxService;
|
||||
const secretService = {} as SecretService;
|
||||
const publisher = new DakaoPublisher(natsService, secretService, {
|
||||
instanceId: 'test',
|
||||
});
|
||||
const previousNodeEnv = process.env.NODE_ENV;
|
||||
process.env.NODE_ENV = 'staging';
|
||||
|
||||
return { publisher, natsService };
|
||||
try {
|
||||
const publisher = new DakaoPublisher(secretService, outboxService, {
|
||||
instanceId: 'staging-instance',
|
||||
});
|
||||
|
||||
return { publisher, outboxService };
|
||||
} finally {
|
||||
process.env.NODE_ENV = previousNodeEnv;
|
||||
}
|
||||
}
|
||||
|
||||
function getPublishedPayload(natsService: NatsService): DakaoSendMessagePayload {
|
||||
const publish = natsService.publish as jest.Mock;
|
||||
const envelope = publish.mock.calls[0][1] as DakaoCommandEnvelope<
|
||||
DakaoSendMessagePayload
|
||||
>;
|
||||
return envelope.payload;
|
||||
function getPublishedEnvelope(
|
||||
outboxService: DakaoOutboxService,
|
||||
): DakaoCommandEnvelope<DakaoSendMessagePayload> {
|
||||
const enqueue = outboxService.enqueueAndPublish as jest.Mock;
|
||||
return enqueue.mock.calls[0][0]
|
||||
.envelope as DakaoCommandEnvelope<DakaoSendMessagePayload>;
|
||||
}
|
||||
|
||||
describe('DakaoPublisher', () => {
|
||||
it('keeps valid mention segments intact', async () => {
|
||||
const { publisher, natsService } = makePublisher();
|
||||
const { publisher, outboxService } = makePublisher();
|
||||
|
||||
await publisher.sendMessage({
|
||||
chatroomId: '18474390111480678',
|
||||
@@ -40,7 +46,7 @@ describe('DakaoPublisher', () => {
|
||||
],
|
||||
});
|
||||
|
||||
expect(getPublishedPayload(natsService).segments).toEqual([
|
||||
expect(getPublishedEnvelope(outboxService).payload.segments).toEqual([
|
||||
{
|
||||
kind: 'mention',
|
||||
userId: '6215844374579825921',
|
||||
@@ -51,7 +57,7 @@ describe('DakaoPublisher', () => {
|
||||
});
|
||||
|
||||
it('downgrades invalid mention segments to text before publishing', async () => {
|
||||
const { publisher, natsService } = makePublisher();
|
||||
const { publisher, outboxService } = makePublisher();
|
||||
|
||||
await publisher.sendMessage({
|
||||
chatroomId: '18474390111480678',
|
||||
@@ -65,9 +71,39 @@ describe('DakaoPublisher', () => {
|
||||
],
|
||||
});
|
||||
|
||||
expect(getPublishedPayload(natsService).segments).toEqual([
|
||||
expect(getPublishedEnvelope(outboxService).payload.segments).toEqual([
|
||||
{ kind: 'text', text: '@소쿠리' },
|
||||
{ kind: 'text', text: ' 신청 완료' },
|
||||
]);
|
||||
});
|
||||
|
||||
it('uses deterministic event ids and the shared Dakao send subject', async () => {
|
||||
const { publisher, outboxService } = makePublisher();
|
||||
|
||||
await publisher.sendMessage({
|
||||
chatroomId: '18474390111480678',
|
||||
segments: [{ kind: 'text', text: '신청 완료' }],
|
||||
correlationId: 'chat-log-1',
|
||||
});
|
||||
|
||||
const enqueue = outboxService.enqueueAndPublish as jest.Mock;
|
||||
expect(enqueue.mock.calls[0][0]).toMatchObject({
|
||||
subject: 'staging.dakao.chat.send-message.v1',
|
||||
eventId: 'lolympus:chat.send-message:chat-log-1',
|
||||
});
|
||||
expect(getPublishedEnvelope(outboxService)).toMatchObject({
|
||||
schema: 'dakao.command.v1',
|
||||
eventId: 'lolympus:chat.send-message:chat-log-1',
|
||||
eventSource: 'lolympus',
|
||||
type: 'chat.send-message',
|
||||
correlationId: 'chat-log-1',
|
||||
resultSubjects: {
|
||||
succeeded: 'staging.lolympus.dakao.chat.send-message.succeeded.v1',
|
||||
failed: 'staging.lolympus.dakao.chat.send-message.failed.v1',
|
||||
},
|
||||
});
|
||||
expect(getPublishedEnvelope(outboxService)).not.toHaveProperty(
|
||||
'replySubject',
|
||||
);
|
||||
});
|
||||
});
|
||||
@@ -1,86 +1,86 @@
|
||||
import {
|
||||
Inject,
|
||||
Injectable,
|
||||
Logger,
|
||||
OnModuleDestroy,
|
||||
OnModuleInit,
|
||||
} from '@nestjs/common';
|
||||
import { Inject, Injectable, Logger, OnModuleInit } from '@nestjs/common';
|
||||
import { randomUUID } from 'crypto';
|
||||
import { SecretService } from '../global/secret/secret.service';
|
||||
import { NatsService } from '../global/nats/nats.service';
|
||||
import {
|
||||
DakaoCommandEnvelope,
|
||||
DakaoResultEnvelope,
|
||||
DakaoResultSubjects,
|
||||
DakaoSegment,
|
||||
DakaoSendMessagePayload,
|
||||
} from './dakao.types';
|
||||
import type { DakaoOptions } from './dakao.options';
|
||||
import { DAKAO_OPTIONS } from './dakao.options';
|
||||
import { resolveDakaoNatsNames } from './dakao.nats-names';
|
||||
import { DakaoOutboxService } from './dakao-outbox.service';
|
||||
|
||||
const SEND_MESSAGE_SUBJECT_DEFAULT = 'dakao.command.chat.send-message.v1';
|
||||
const COMMAND_SOURCE_DEFAULT = 'lolympus-tournament-support';
|
||||
const EVENT_SOURCE_DEFAULT = 'lolympus';
|
||||
|
||||
@Injectable()
|
||||
export class DakaoPublisher implements OnModuleInit, OnModuleDestroy {
|
||||
export class DakaoPublisher implements OnModuleInit {
|
||||
private readonly logger = new Logger(DakaoPublisher.name);
|
||||
private replySubject = '';
|
||||
private sendMessageSubject = SEND_MESSAGE_SUBJECT_DEFAULT;
|
||||
private source = COMMAND_SOURCE_DEFAULT;
|
||||
private readonly names = resolveDakaoNatsNames();
|
||||
private sendMessageSubject = this.names.subjects.chatSendMessage;
|
||||
private resultSubjects: DakaoResultSubjects = {
|
||||
succeeded: this.names.subjects.chatSendMessageSucceeded,
|
||||
failed: this.names.subjects.chatSendMessageFailed,
|
||||
};
|
||||
private eventSource = EVENT_SOURCE_DEFAULT;
|
||||
|
||||
constructor(
|
||||
private readonly natsService: NatsService,
|
||||
private readonly secretService: SecretService,
|
||||
private readonly outboxService: DakaoOutboxService,
|
||||
@Inject(DAKAO_OPTIONS) private readonly options: DakaoOptions,
|
||||
) {}
|
||||
|
||||
async onModuleInit() {
|
||||
const replyOverride = await this.secretService
|
||||
.get<string>('DAKAO_REPLY_SUBJECT_PREFIX')
|
||||
.catch(() => undefined);
|
||||
const sendOverride = await this.secretService
|
||||
.get<string>('DAKAO_NATS_COMMAND_CHAT_SEND_MESSAGE_SUBJECT')
|
||||
.get<string>('DAKAO_CHAT_SEND_MESSAGE_SUBJECT')
|
||||
.catch(() => undefined);
|
||||
const sourceOverride = await this.secretService
|
||||
.get<string>('DAKAO_COMMAND_SOURCE')
|
||||
.get<string>('DAKAO_EVENT_SOURCE')
|
||||
.catch(() => undefined);
|
||||
|
||||
const replyPrefix = replyOverride || `dakao.result.${COMMAND_SOURCE_DEFAULT}`;
|
||||
this.replySubject = `${replyPrefix}.${this.options.instanceId}`;
|
||||
this.sendMessageSubject = sendOverride || SEND_MESSAGE_SUBJECT_DEFAULT;
|
||||
this.source = sourceOverride || COMMAND_SOURCE_DEFAULT;
|
||||
this.sendMessageSubject =
|
||||
sendOverride || resolveDakaoNatsNames().subjects.chatSendMessage;
|
||||
this.resultSubjects = {
|
||||
succeeded: this.names.subjects.chatSendMessageSucceeded,
|
||||
failed: this.names.subjects.chatSendMessageFailed,
|
||||
};
|
||||
this.eventSource = sourceOverride || EVENT_SOURCE_DEFAULT;
|
||||
|
||||
this.natsService.subscribe<DakaoResultEnvelope>(
|
||||
this.replySubject,
|
||||
(data) => this.handleReply(data),
|
||||
);
|
||||
this.logger.log(
|
||||
`Dakao reply subscriber ready on subject="${this.replySubject}"`,
|
||||
`Dakao send-message publisher ready on subject="${this.sendMessageSubject}" source="${this.eventSource}" instanceId="${this.options.instanceId}"`,
|
||||
);
|
||||
}
|
||||
|
||||
async onModuleDestroy() {
|
||||
// NatsService 가 subscription 정리한다.
|
||||
}
|
||||
|
||||
public async sendMessage(params: {
|
||||
chatroomId: string;
|
||||
segments: DakaoSegment[];
|
||||
correlationId?: string;
|
||||
eventId?: string;
|
||||
}): Promise<void> {
|
||||
const eventId =
|
||||
params.eventId ??
|
||||
(params.correlationId
|
||||
? `${this.eventSource}:chat.send-message:${params.correlationId}`
|
||||
: `${this.eventSource}:chat.send-message:${randomUUID()}`);
|
||||
const payload: DakaoSendMessagePayload = {
|
||||
chatroomId: params.chatroomId,
|
||||
segments: this.normalizeSegments(params.segments),
|
||||
};
|
||||
const envelope: DakaoCommandEnvelope<DakaoSendMessagePayload> = {
|
||||
schema: 'dakao.command.v1',
|
||||
id: randomUUID(),
|
||||
eventId,
|
||||
type: 'chat.send-message',
|
||||
source: this.source,
|
||||
eventSource: this.eventSource,
|
||||
correlationId: params.correlationId,
|
||||
replySubject: this.replySubject,
|
||||
resultSubjects: this.resultSubjects,
|
||||
payload,
|
||||
};
|
||||
await this.natsService.publish(this.sendMessageSubject, envelope);
|
||||
await this.outboxService.enqueueAndPublish({
|
||||
subject: this.sendMessageSubject,
|
||||
eventId,
|
||||
envelope,
|
||||
});
|
||||
}
|
||||
|
||||
private normalizeSegments(segments: DakaoSegment[]): DakaoSegment[] {
|
||||
@@ -111,11 +111,7 @@ export class DakaoPublisher implements OnModuleInit, OnModuleDestroy {
|
||||
|
||||
const id = segment.id.trim();
|
||||
const altText = segment.altText.trim();
|
||||
if (
|
||||
id.length > 0 &&
|
||||
altText.length > 0 &&
|
||||
!/[()@]/.test(altText)
|
||||
) {
|
||||
if (id.length > 0 && altText.length > 0 && !/[()@]/.test(altText)) {
|
||||
normalized.push({ kind: 'emoticon', id, altText });
|
||||
continue;
|
||||
}
|
||||
@@ -139,16 +135,4 @@ export class DakaoPublisher implements OnModuleInit, OnModuleDestroy {
|
||||
const label = displayText || userId || '사용자';
|
||||
return label.startsWith('@') ? label : `@${label}`;
|
||||
}
|
||||
|
||||
private handleReply(reply: DakaoResultEnvelope): void {
|
||||
if (reply.status === 'succeeded') {
|
||||
this.logger.log(
|
||||
`Dakao reply succeeded id=${reply.id} type=${reply.type} correlationId=${reply.correlationId ?? '-'}`,
|
||||
);
|
||||
return;
|
||||
}
|
||||
this.logger.warn(
|
||||
`Dakao reply failed id=${reply.id} type=${reply.type} code=${reply.error?.code ?? '-'} retryable=${reply.error?.retryable ?? false} message=${reply.error?.message ?? '-'}`,
|
||||
);
|
||||
}
|
||||
}
|
||||
@@ -6,19 +6,19 @@ import { CommandParseError, parseCommand } from './parsers/command.parser';
|
||||
import { DakaoInboundEvent, DakaoLong, DakaoSegment } from './dakao.types';
|
||||
import { DakaoPublisher } from './dakao.publisher';
|
||||
import { DakaoUserError, DakaoUserService } from './dakao-user.service';
|
||||
import { IdempotencyCache } from './idempotency.cache';
|
||||
import { AccountRegisterHandler } from './handlers/account-register.handler';
|
||||
import { MatchCancelHandler } from './handlers/match-cancel.handler';
|
||||
import { MatchJoinHandler } from './handlers/match-join.handler';
|
||||
import { MatchListHandler } from './handlers/match-list.handler';
|
||||
import { PreferredPositionRegisterHandler } from './handlers/preferred-position-register.handler';
|
||||
|
||||
const INBOUND_SUBJECT_DEFAULT = 'lolympus-tournament-support.kakaotalk.command';
|
||||
import { resolveDakaoNatsNames } from './dakao.nats-names';
|
||||
import { DakaoInboxService } from './dakao-inbox.service';
|
||||
import { DakaoJetStreamResourceService } from './dakao-jetstream-resource.service';
|
||||
|
||||
@Injectable()
|
||||
export class DakaoSubscriber implements OnModuleInit {
|
||||
private readonly logger = new Logger(DakaoSubscriber.name);
|
||||
private inboundSubject = INBOUND_SUBJECT_DEFAULT;
|
||||
private readonly natsNames = resolveDakaoNatsNames();
|
||||
private botUserId: string | undefined;
|
||||
|
||||
constructor(
|
||||
@@ -26,7 +26,8 @@ export class DakaoSubscriber implements OnModuleInit {
|
||||
private readonly secretService: SecretService,
|
||||
private readonly dakaoUserService: DakaoUserService,
|
||||
private readonly publisher: DakaoPublisher,
|
||||
private readonly idempotency: IdempotencyCache,
|
||||
private readonly inbox: DakaoInboxService,
|
||||
private readonly resources: DakaoJetStreamResourceService,
|
||||
private readonly accountRegisterHandler: AccountRegisterHandler,
|
||||
private readonly matchListHandler: MatchListHandler,
|
||||
private readonly matchJoinHandler: MatchJoinHandler,
|
||||
@@ -35,21 +36,20 @@ export class DakaoSubscriber implements OnModuleInit {
|
||||
) {}
|
||||
|
||||
async onModuleInit() {
|
||||
const subjectOverride = await this.secretService
|
||||
.get<string>('DAKAO_INBOUND_SUBJECT')
|
||||
.catch(() => undefined);
|
||||
this.inboundSubject = subjectOverride || INBOUND_SUBJECT_DEFAULT;
|
||||
|
||||
this.botUserId = await this.secretService
|
||||
.get<string>('DAKAO_BOT_USER_ID')
|
||||
.catch(() => undefined);
|
||||
|
||||
this.natsService.subscribe<DakaoInboundEvent>(
|
||||
this.inboundSubject,
|
||||
await this.resources.ensure();
|
||||
void this.natsService.consumeJetStream<DakaoInboundEvent>(
|
||||
{
|
||||
stream: this.natsNames.streams.botCommand,
|
||||
durable: this.natsNames.consumers.botCommand,
|
||||
},
|
||||
(event) => this.handleEvent(event),
|
||||
);
|
||||
this.logger.log(
|
||||
`Dakao inbound subscriber ready on subject="${this.inboundSubject}"`,
|
||||
`Dakao inbound subscriber ready on stream="${this.natsNames.streams.botCommand}" durable="${this.natsNames.consumers.botCommand}"`,
|
||||
);
|
||||
}
|
||||
|
||||
@@ -60,35 +60,52 @@ export class DakaoSubscriber implements OnModuleInit {
|
||||
return;
|
||||
}
|
||||
|
||||
const logIdKey = this.deriveLogIdKey(event);
|
||||
if (logIdKey && this.idempotency.has(logIdKey)) {
|
||||
return;
|
||||
const chatLogLogId = this.serializeDakaoLong(event.origin.chatLog.logId);
|
||||
let claimed = false;
|
||||
if (chatLogLogId) {
|
||||
const claim = await this.inbox.claim({
|
||||
consumer: this.natsNames.consumers.botCommand,
|
||||
projectId: event.projectId,
|
||||
chatLogLogId,
|
||||
});
|
||||
if (claim.status === 'duplicate') return;
|
||||
if (claim.status === 'inflight') {
|
||||
throw new Error(
|
||||
`Dakao event is already being processed projectId=${event.projectId} logId=${chatLogLogId}`,
|
||||
);
|
||||
}
|
||||
claimed = true;
|
||||
}
|
||||
if (logIdKey) this.idempotency.remember(logIdKey);
|
||||
|
||||
let communityId: mongoose.Types.ObjectId;
|
||||
try {
|
||||
communityId = await this.dakaoUserService.resolveCommunityIdByDakaoProjectId(
|
||||
event.projectId,
|
||||
);
|
||||
communityId =
|
||||
await this.dakaoUserService.resolveCommunityIdByDakaoProjectId(
|
||||
event.projectId,
|
||||
);
|
||||
} catch (err) {
|
||||
if (err instanceof DakaoUserError) {
|
||||
if (err.code === 'invalid_project_id') {
|
||||
this.logger.warn(`Invalid dakao projectId format: ${event.projectId}`);
|
||||
this.logger.warn(
|
||||
`Invalid dakao projectId format: ${event.projectId}`,
|
||||
);
|
||||
if (claimed) await this.markProcessed(event, chatLogLogId);
|
||||
return;
|
||||
}
|
||||
if (err.code === 'community_not_found') {
|
||||
// 우리 쪽이 모르는 projectId. 메시지를 보내봤자 컨텍스트가 없으므로 로그만.
|
||||
this.logger.warn(`Unknown dakao projectId: ${event.projectId}`);
|
||||
if (claimed) await this.markProcessed(event, chatLogLogId);
|
||||
return;
|
||||
}
|
||||
}
|
||||
if (claimed) await this.markFailed(event, chatLogLogId, err);
|
||||
throw err;
|
||||
}
|
||||
|
||||
let segments: DakaoSegment[];
|
||||
const senderNickname = this.resolveSenderNickname(event);
|
||||
const correlationId = this.serializeDakaoLong(event.origin.chatLog.logId);
|
||||
const correlationId = chatLogLogId;
|
||||
try {
|
||||
const command = parseCommand(event.origin.chatLog.message);
|
||||
|
||||
@@ -141,27 +158,35 @@ export class DakaoSubscriber implements OnModuleInit {
|
||||
segments,
|
||||
correlationId,
|
||||
});
|
||||
if (claimed) await this.markProcessed(event, chatLogLogId);
|
||||
} catch (err) {
|
||||
if (err instanceof CommandParseError) {
|
||||
// not_a_command 는 명령이 아닌 일반 메시지 → 무시.
|
||||
if (err.code === 'not_a_command') return;
|
||||
if (err.code === 'not_a_command') {
|
||||
if (claimed) await this.markProcessed(event, chatLogLogId);
|
||||
return;
|
||||
}
|
||||
await this.publisher.sendMessage({
|
||||
chatroomId: event.chatroomId,
|
||||
segments: this.parseErrorReply(event, senderNickname, err),
|
||||
correlationId,
|
||||
});
|
||||
if (claimed) await this.markProcessed(event, chatLogLogId);
|
||||
return;
|
||||
}
|
||||
this.logger.error(
|
||||
`Unhandled dakao event error: ${(err as Error)?.stack ?? err}`,
|
||||
);
|
||||
if (claimed) await this.markFailed(event, chatLogLogId, err);
|
||||
throw err;
|
||||
}
|
||||
}
|
||||
|
||||
private validate(event: unknown): event is DakaoInboundEvent {
|
||||
if (!event || typeof event !== 'object') return false;
|
||||
const e = event as Partial<DakaoInboundEvent>;
|
||||
if (typeof e.projectId !== 'string' || e.projectId.length === 0) return false;
|
||||
if (typeof e.projectId !== 'string' || e.projectId.length === 0)
|
||||
return false;
|
||||
if (typeof e.chatroomId !== 'string' || e.chatroomId.length === 0)
|
||||
return false;
|
||||
if (typeof e.nickname !== 'string') return false;
|
||||
@@ -174,11 +199,6 @@ export class DakaoSubscriber implements OnModuleInit {
|
||||
return true;
|
||||
}
|
||||
|
||||
private deriveLogIdKey(event: DakaoInboundEvent): string | null {
|
||||
const serialized = this.serializeDakaoLong(event.origin.chatLog.logId);
|
||||
return serialized ? `${event.projectId}:${serialized}` : null;
|
||||
}
|
||||
|
||||
private serializeDakaoLong(value: DakaoLong | string | undefined): string {
|
||||
if (typeof value === 'string') return value;
|
||||
if (!value || typeof value !== 'object') return '';
|
||||
@@ -197,6 +217,30 @@ export class DakaoSubscriber implements OnModuleInit {
|
||||
return fallback ?? '';
|
||||
}
|
||||
|
||||
private async markProcessed(
|
||||
event: DakaoInboundEvent,
|
||||
chatLogLogId: string,
|
||||
): Promise<void> {
|
||||
await this.inbox.markProcessed({
|
||||
consumer: this.natsNames.consumers.botCommand,
|
||||
projectId: event.projectId,
|
||||
chatLogLogId,
|
||||
});
|
||||
}
|
||||
|
||||
private async markFailed(
|
||||
event: DakaoInboundEvent,
|
||||
chatLogLogId: string,
|
||||
error: unknown,
|
||||
): Promise<void> {
|
||||
await this.inbox.markFailed({
|
||||
consumer: this.natsNames.consumers.botCommand,
|
||||
projectId: event.projectId,
|
||||
chatLogLogId,
|
||||
error,
|
||||
});
|
||||
}
|
||||
|
||||
private parseErrorReply(
|
||||
event: DakaoInboundEvent,
|
||||
senderNickname: string,
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
// dakao NATS contracts
|
||||
// inbound: dakao 가 lolympus-tournament-support.kakaotalk.command 로 발행하는 이벤트
|
||||
// outbound: 우리가 dakao.command.chat.send-message.v1 로 발행하는 명령
|
||||
// reply: dakao 가 우리 envelope 의 replySubject 로 publish 하는 결과
|
||||
// inbound: dakao 가 {env}.lolympus.dakao.bot-command.submitted.v1 로 발행하는 이벤트
|
||||
// outbound: 우리가 {env}.dakao.chat.send-message.v1 로 발행하는 명령
|
||||
// result: dakao 가 {env}.lolympus.dakao.chat.send-message.{succeeded|failed}.v1 로 발행하는 결과 이벤트
|
||||
|
||||
// ===== Inbound =====
|
||||
export interface DakaoLong {
|
||||
@@ -75,24 +75,33 @@ export interface DakaoSendMessagePayload {
|
||||
silence?: boolean;
|
||||
}
|
||||
|
||||
export interface DakaoResultSubjects {
|
||||
succeeded: string;
|
||||
failed: string;
|
||||
}
|
||||
|
||||
export interface DakaoCommandEnvelope<TPayload> {
|
||||
schema: 'dakao.command.v1';
|
||||
id: string;
|
||||
eventId: string;
|
||||
type: string;
|
||||
source: string;
|
||||
eventSource: string;
|
||||
correlationId?: string;
|
||||
replySubject?: string;
|
||||
resultSubjects?: DakaoResultSubjects;
|
||||
payload: TPayload;
|
||||
}
|
||||
|
||||
// ===== Reply =====
|
||||
// ===== Result =====
|
||||
export interface DakaoResultEnvelope {
|
||||
schema: 'dakao.result.v1';
|
||||
id: string;
|
||||
eventId: string;
|
||||
requestEventId: string;
|
||||
type: string;
|
||||
eventSource: string;
|
||||
requestEventSource: string;
|
||||
status: 'succeeded' | 'failed';
|
||||
handledAt: string;
|
||||
correlationId?: string;
|
||||
providerMessageId?: string;
|
||||
result?: Record<string, unknown>;
|
||||
error?: {
|
||||
code: string;
|
||||
|
||||
@@ -7,7 +7,7 @@ describe('resolveMongoDbName', () => {
|
||||
|
||||
it('uses isolated databases for non-production environments', () => {
|
||||
expect(resolveMongoDbName('dev')).toBe('lolympus-dev');
|
||||
expect(resolveMongoDbName('test')).toBe('lolympus-test');
|
||||
expect(resolveMongoDbName('staging')).toBe('lolympus-staging');
|
||||
expect(resolveMongoDbName('')).toBe('lolympus-dev');
|
||||
expect(resolveMongoDbName('local')).toBe('lolympus-dev');
|
||||
});
|
||||
|
||||
@@ -5,7 +5,7 @@ import { tournamentModelDefinitions, TournamentModelTypes } from './schema';
|
||||
|
||||
export function resolveMongoDbName(nodeEnv = process.env.NODE_ENV): string {
|
||||
if (nodeEnv === 'prod') return 'lolympus';
|
||||
if (nodeEnv === 'test') return 'lolympus-test';
|
||||
if (nodeEnv === 'staging') return 'lolympus-staging';
|
||||
return 'lolympus-dev';
|
||||
}
|
||||
|
||||
|
||||
@@ -121,7 +121,7 @@ function parseArgs(argv: string[]): CliOptions {
|
||||
}
|
||||
if (arg === '--env') {
|
||||
const value = argv[index + 1];
|
||||
if (!value) throw new Error('--env requires dev, test, or prod.');
|
||||
if (!value) throw new Error('--env requires dev, staging, or prod.');
|
||||
nodeEnv = value;
|
||||
index += 1;
|
||||
continue;
|
||||
@@ -164,8 +164,8 @@ function parseArgs(argv: string[]): CliOptions {
|
||||
throw new Error(`Unknown argument: ${arg}`);
|
||||
}
|
||||
|
||||
if (!['dev', 'test', 'prod'].includes(nodeEnv)) {
|
||||
throw new Error('--env must be dev, test, or prod.');
|
||||
if (!['dev', 'staging', 'prod'].includes(nodeEnv)) {
|
||||
throw new Error('--env must be dev, staging, or prod.');
|
||||
}
|
||||
if (communityId && !mongoose.isValidObjectId(communityId)) {
|
||||
throw new Error('--community-id must be a valid ObjectId.');
|
||||
@@ -198,7 +198,7 @@ function printHelp() {
|
||||
Options:
|
||||
--community-id <id> Community ObjectId. Defaults to env or first community.
|
||||
--dry-run Print the payload summary without writing.
|
||||
--env <env> dev | test | prod. Default: NODE_ENV or dev.
|
||||
--env <env> dev | staging | prod. Default: NODE_ENV or dev.
|
||||
--replace Delete previous temp matches created by this script first.
|
||||
--scheduled-at <iso> Scheduled date. Default: yesterday.
|
||||
--title <title> Match title. Default: timestamped temp title.
|
||||
|
||||
@@ -71,7 +71,7 @@ function parseArgs(argv: string[]): CliOptions {
|
||||
}
|
||||
if (arg === '--env') {
|
||||
const value = argv[index + 1];
|
||||
if (!value) throw new Error('--env requires dev, test, or prod.');
|
||||
if (!value) throw new Error('--env requires dev, staging, or prod.');
|
||||
nodeEnv = value;
|
||||
index += 1;
|
||||
continue;
|
||||
@@ -104,8 +104,8 @@ function parseArgs(argv: string[]): CliOptions {
|
||||
throw new Error(`Unknown argument: ${arg}`);
|
||||
}
|
||||
|
||||
if (!['dev', 'test', 'prod'].includes(nodeEnv)) {
|
||||
throw new Error('--env must be dev, test, or prod.');
|
||||
if (!['dev', 'staging', 'prod'].includes(nodeEnv)) {
|
||||
throw new Error('--env must be dev, staging, or prod.');
|
||||
}
|
||||
|
||||
return { dryRun, limit, nodeEnv };
|
||||
@@ -119,7 +119,7 @@ function printHelp() {
|
||||
Options:
|
||||
--dry-run Print affected counts without writing. Default.
|
||||
--apply Apply updates to MongoDB.
|
||||
--env <env> dev | test | prod. Default: NODE_ENV or dev.
|
||||
--env <env> dev | staging | prod. Default: NODE_ENV or dev.
|
||||
--limit <n> Only scan first n documents per collection.
|
||||
`);
|
||||
}
|
||||
@@ -130,7 +130,9 @@ async function main() {
|
||||
await loadMachineEnvFile();
|
||||
|
||||
const app = await NestFactory.createApplicationContext(MigrationModule, {
|
||||
logger: options.dryRun ? ['log', 'warn', 'error'] : ['log', 'warn', 'error'],
|
||||
logger: options.dryRun
|
||||
? ['log', 'warn', 'error']
|
||||
: ['log', 'warn', 'error'],
|
||||
});
|
||||
|
||||
try {
|
||||
@@ -145,14 +147,19 @@ async function main() {
|
||||
`[team-index migration] mode=${options.dryRun ? 'dry-run' : 'apply'} env=${options.nodeEnv} db=${dbName}`,
|
||||
);
|
||||
|
||||
const stats = await migrateTeamIndex(connection.db as Parameters<typeof migrateTeamIndex>[0], {
|
||||
dryRun: options.dryRun,
|
||||
limit: options.limit,
|
||||
});
|
||||
const stats = await migrateTeamIndex(
|
||||
connection.db as Parameters<typeof migrateTeamIndex>[0],
|
||||
{
|
||||
dryRun: options.dryRun,
|
||||
limit: options.limit,
|
||||
},
|
||||
);
|
||||
|
||||
console.table(stats);
|
||||
if (options.dryRun) {
|
||||
console.log('No writes were made. Re-run with --apply to update documents.');
|
||||
console.log(
|
||||
'No writes were made. Re-run with --apply to update documents.',
|
||||
);
|
||||
} else {
|
||||
console.log('Migration applied.');
|
||||
}
|
||||
|
||||
@@ -91,6 +91,39 @@ export const LEGACY_IMPORT_JOB_STATES: LegacyImportJobState[] = [
|
||||
'cancelled',
|
||||
];
|
||||
|
||||
export type DakaoInboundMessageState = 'processing' | 'processed' | 'failed';
|
||||
export const DAKAO_INBOUND_MESSAGE_STATES: DakaoInboundMessageState[] = [
|
||||
'processing',
|
||||
'processed',
|
||||
'failed',
|
||||
];
|
||||
|
||||
export type DakaoOutboxMessageState =
|
||||
| 'pending'
|
||||
| 'published'
|
||||
| 'sent'
|
||||
| 'failed';
|
||||
export const DAKAO_OUTBOX_MESSAGE_STATES: DakaoOutboxMessageState[] = [
|
||||
'pending',
|
||||
'published',
|
||||
'sent',
|
||||
'failed',
|
||||
];
|
||||
|
||||
export type DakaoOutboxCompensationState =
|
||||
| 'none'
|
||||
| 'pending'
|
||||
| 'completed'
|
||||
| 'failed';
|
||||
export const DAKAO_OUTBOX_COMPENSATION_STATES: DakaoOutboxCompensationState[] =
|
||||
['none', 'pending', 'completed', 'failed'];
|
||||
|
||||
export type DakaoSendResultStatus = 'succeeded' | 'failed';
|
||||
export const DAKAO_SEND_RESULT_STATUSES: DakaoSendResultStatus[] = [
|
||||
'succeeded',
|
||||
'failed',
|
||||
];
|
||||
|
||||
export interface PositionPreference {
|
||||
position: Position;
|
||||
priority: number; // 1 = 최우선, 숫자가 작을수록 높은 우선순위
|
||||
@@ -300,9 +333,61 @@ export interface CommunitySeason {
|
||||
endedAt?: Date;
|
||||
}
|
||||
|
||||
export interface DakaoInboundMessage extends MongooseTimestamps {
|
||||
consumer: string;
|
||||
projectId: string;
|
||||
chatLogLogId: string;
|
||||
state: DakaoInboundMessageState;
|
||||
attempts: number;
|
||||
processingExpiresAt?: Date;
|
||||
processedAt?: Date;
|
||||
lastError?: string;
|
||||
}
|
||||
|
||||
export interface DakaoOutboxMessage extends MongooseTimestamps {
|
||||
eventId: string;
|
||||
eventSource: string;
|
||||
type: string;
|
||||
subject: string;
|
||||
correlationId?: string;
|
||||
resultSubjects?: {
|
||||
succeeded: string;
|
||||
failed: string;
|
||||
};
|
||||
payload: Record<string, unknown>;
|
||||
state: DakaoOutboxMessageState;
|
||||
publishAttempts: number;
|
||||
publishedAt?: Date;
|
||||
terminalAt?: Date;
|
||||
resultEventId?: string;
|
||||
lastPublishError?: string;
|
||||
terminalError?: Record<string, unknown>;
|
||||
compensationState: DakaoOutboxCompensationState;
|
||||
compensationReason?: string;
|
||||
}
|
||||
|
||||
export interface DakaoSendResultEvent extends MongooseTimestamps {
|
||||
eventId: string;
|
||||
requestEventId: string;
|
||||
eventSource: string;
|
||||
requestEventSource: string;
|
||||
type: string;
|
||||
subject: string;
|
||||
status: DakaoSendResultStatus;
|
||||
correlationId?: string;
|
||||
handledAt: Date;
|
||||
providerMessageId?: string;
|
||||
error?: Record<string, unknown>;
|
||||
raw: Record<string, unknown>;
|
||||
}
|
||||
|
||||
export type CommunityDocument = HydratedDocument<Community>;
|
||||
export type IdentityDocument = HydratedDocument<Identity>;
|
||||
export type UserDocument = HydratedDocument<User>;
|
||||
export type DakaoInboundMessageDocument = HydratedDocument<DakaoInboundMessage>;
|
||||
export type DakaoOutboxMessageDocument = HydratedDocument<DakaoOutboxMessage>;
|
||||
export type DakaoSendResultEventDocument =
|
||||
HydratedDocument<DakaoSendResultEvent>;
|
||||
|
||||
// ===== RiotMatch (Riot 원본 매치 아카이브) =====
|
||||
export interface RiotMatch extends MongooseTimestamps {
|
||||
@@ -533,6 +618,14 @@ export interface AuctionBid {
|
||||
timestamp: Date;
|
||||
}
|
||||
|
||||
export interface AuctionChatMessage {
|
||||
id: string;
|
||||
userId?: mongoose.Types.ObjectId;
|
||||
displayName: string;
|
||||
message: string;
|
||||
sentAt: Date;
|
||||
}
|
||||
|
||||
export interface Auction extends MongooseTimestamps {
|
||||
matchId: mongoose.Types.ObjectId;
|
||||
phase: AuctionPhase;
|
||||
@@ -550,6 +643,7 @@ export interface Auction extends MongooseTimestamps {
|
||||
initialPoints: number;
|
||||
topTierThreshold: AuctionTopTierThreshold;
|
||||
manualTopTierUserIds: mongoose.Types.ObjectId[];
|
||||
chatMessages: AuctionChatMessage[];
|
||||
startedAt?: Date;
|
||||
completedAt?: Date;
|
||||
}
|
||||
@@ -844,6 +938,102 @@ CommunitySchema.index({ name: 1 }, { unique: true });
|
||||
CommunitySchema.index({ ownerUserId: 1 });
|
||||
CommunitySchema.index({ dakaoProjectId: 1 }, { unique: true, sparse: true });
|
||||
|
||||
export const DakaoInboundMessageSchema = new Schema<DakaoInboundMessage>(
|
||||
{
|
||||
consumer: { type: String, required: true },
|
||||
projectId: { type: String, required: true },
|
||||
chatLogLogId: { type: String, required: true },
|
||||
state: {
|
||||
type: String,
|
||||
enum: DAKAO_INBOUND_MESSAGE_STATES,
|
||||
required: true,
|
||||
default: 'processing',
|
||||
},
|
||||
attempts: { type: Number, required: true, default: 1 },
|
||||
processingExpiresAt: { type: Date },
|
||||
processedAt: { type: Date },
|
||||
lastError: { type: String },
|
||||
},
|
||||
{
|
||||
timestamps: true,
|
||||
collection: 'dakao_inbound_message',
|
||||
},
|
||||
);
|
||||
|
||||
DakaoInboundMessageSchema.index(
|
||||
{ consumer: 1, projectId: 1, chatLogLogId: 1 },
|
||||
{ unique: true },
|
||||
);
|
||||
DakaoInboundMessageSchema.index({ state: 1, processingExpiresAt: 1 });
|
||||
|
||||
export const DakaoOutboxMessageSchema = new Schema<DakaoOutboxMessage>(
|
||||
{
|
||||
eventId: { type: String, required: true, unique: true },
|
||||
eventSource: { type: String, required: true },
|
||||
type: { type: String, required: true },
|
||||
subject: { type: String, required: true },
|
||||
correlationId: { type: String },
|
||||
resultSubjects: {
|
||||
succeeded: { type: String },
|
||||
failed: { type: String },
|
||||
},
|
||||
payload: { type: Schema.Types.Mixed, required: true },
|
||||
state: {
|
||||
type: String,
|
||||
enum: DAKAO_OUTBOX_MESSAGE_STATES,
|
||||
required: true,
|
||||
default: 'pending',
|
||||
},
|
||||
publishAttempts: { type: Number, required: true, default: 0 },
|
||||
publishedAt: { type: Date },
|
||||
terminalAt: { type: Date },
|
||||
resultEventId: { type: String },
|
||||
lastPublishError: { type: String },
|
||||
terminalError: { type: Schema.Types.Mixed },
|
||||
compensationState: {
|
||||
type: String,
|
||||
enum: DAKAO_OUTBOX_COMPENSATION_STATES,
|
||||
required: true,
|
||||
default: 'none',
|
||||
},
|
||||
compensationReason: { type: String },
|
||||
},
|
||||
{
|
||||
timestamps: true,
|
||||
collection: 'dakao_outbox_message',
|
||||
},
|
||||
);
|
||||
|
||||
DakaoOutboxMessageSchema.index({ state: 1, updatedAt: 1 });
|
||||
DakaoOutboxMessageSchema.index({ correlationId: 1 }, { sparse: true });
|
||||
|
||||
export const DakaoSendResultEventSchema = new Schema<DakaoSendResultEvent>(
|
||||
{
|
||||
eventId: { type: String, required: true, unique: true },
|
||||
requestEventId: { type: String, required: true },
|
||||
eventSource: { type: String, required: true },
|
||||
requestEventSource: { type: String, required: true },
|
||||
type: { type: String, required: true },
|
||||
subject: { type: String, required: true },
|
||||
status: {
|
||||
type: String,
|
||||
enum: DAKAO_SEND_RESULT_STATUSES,
|
||||
required: true,
|
||||
},
|
||||
correlationId: { type: String },
|
||||
handledAt: { type: Date, required: true },
|
||||
providerMessageId: { type: String },
|
||||
error: { type: Schema.Types.Mixed },
|
||||
raw: { type: Schema.Types.Mixed, required: true },
|
||||
},
|
||||
{
|
||||
timestamps: true,
|
||||
collection: 'dakao_send_result_event',
|
||||
},
|
||||
);
|
||||
|
||||
DakaoSendResultEventSchema.index({ requestEventId: 1, status: 1 });
|
||||
|
||||
export const UserSchema = new Schema<User>(
|
||||
{
|
||||
communityId: {
|
||||
@@ -1385,6 +1575,17 @@ const AuctionBidSubSchema = new Schema<AuctionBid>(
|
||||
{ _id: false },
|
||||
);
|
||||
|
||||
const AuctionChatMessageSubSchema = new Schema<AuctionChatMessage>(
|
||||
{
|
||||
id: { type: String, required: true },
|
||||
userId: { type: Schema.Types.ObjectId, ref: 'user', required: false },
|
||||
displayName: { type: String, required: true },
|
||||
message: { type: String, required: true },
|
||||
sentAt: { type: Date, required: true, default: Date.now },
|
||||
},
|
||||
{ _id: false },
|
||||
);
|
||||
|
||||
export const AuctionSchema = new Schema<Auction>(
|
||||
{
|
||||
matchId: {
|
||||
@@ -1431,6 +1632,11 @@ export const AuctionSchema = new Schema<Auction>(
|
||||
required: true,
|
||||
default: [],
|
||||
},
|
||||
chatMessages: {
|
||||
type: [AuctionChatMessageSubSchema],
|
||||
required: true,
|
||||
default: [],
|
||||
},
|
||||
startedAt: { type: Date, required: false },
|
||||
completedAt: { type: Date, required: false },
|
||||
},
|
||||
@@ -1519,6 +1725,21 @@ MatchStatsSchema.index({ communityId: 1, championIds: 1 });
|
||||
export const tournamentModelDefinitions: ModelDefinition[] = [
|
||||
{ name: 'identity', schema: IdentitySchema, schemaName: 'identity' },
|
||||
{ name: 'community', schema: CommunitySchema, schemaName: 'community' },
|
||||
{
|
||||
name: 'dakaoInboundMessage',
|
||||
schema: DakaoInboundMessageSchema,
|
||||
schemaName: 'dakaoInboundMessage',
|
||||
},
|
||||
{
|
||||
name: 'dakaoOutboxMessage',
|
||||
schema: DakaoOutboxMessageSchema,
|
||||
schemaName: 'dakaoOutboxMessage',
|
||||
},
|
||||
{
|
||||
name: 'dakaoSendResultEvent',
|
||||
schema: DakaoSendResultEventSchema,
|
||||
schemaName: 'dakaoSendResultEvent',
|
||||
},
|
||||
{ name: 'user', schema: UserSchema, schemaName: 'user' },
|
||||
{ name: 'riotMatch', schema: RiotMatchSchema, schemaName: 'riotMatch' },
|
||||
{
|
||||
@@ -1548,6 +1769,9 @@ export const tournamentModelDefinitions: ModelDefinition[] = [
|
||||
export interface TournamentModelTypes {
|
||||
identity: Identity;
|
||||
community: Community;
|
||||
dakaoInboundMessage: DakaoInboundMessage;
|
||||
dakaoOutboxMessage: DakaoOutboxMessage;
|
||||
dakaoSendResultEvent: DakaoSendResultEvent;
|
||||
user: User;
|
||||
riotMatch: RiotMatch;
|
||||
tournamentCode: TournamentCode;
|
||||
|
||||
@@ -1,9 +1,4 @@
|
||||
import {
|
||||
Inject,
|
||||
Injectable,
|
||||
Logger,
|
||||
OnModuleDestroy,
|
||||
} from '@nestjs/common';
|
||||
import { Inject, Injectable, Logger, OnModuleDestroy } from '@nestjs/common';
|
||||
import type { createClient } from 'redis';
|
||||
import { GARNET_CLIENT } from './garnet.constants';
|
||||
|
||||
@@ -203,6 +198,13 @@ export class GarnetService implements OnModuleDestroy {
|
||||
return this.client.xAck(key, group, ids);
|
||||
}
|
||||
|
||||
public async deleteStreamEntries(
|
||||
key: string,
|
||||
ids: string | string[],
|
||||
): Promise<number> {
|
||||
return this.client.xDel(key, ids);
|
||||
}
|
||||
|
||||
public async streamLength(key: string): Promise<number> {
|
||||
return this.client.xLen(key);
|
||||
}
|
||||
|
||||
@@ -1,11 +1,21 @@
|
||||
import { Inject, Injectable, Logger, OnModuleDestroy } from '@nestjs/common';
|
||||
import {
|
||||
Inject,
|
||||
Injectable,
|
||||
Logger,
|
||||
OnModuleDestroy,
|
||||
} from '@nestjs/common';
|
||||
import { StringCodec } from 'nats';
|
||||
import type { Msg, NatsConnection, Subscription } from 'nats';
|
||||
AckPolicy,
|
||||
DeliverPolicy,
|
||||
nanos,
|
||||
ReplayPolicy,
|
||||
RetentionPolicy,
|
||||
StorageType,
|
||||
StringCodec,
|
||||
} from 'nats';
|
||||
import type {
|
||||
ConsumerMessages,
|
||||
JsMsg,
|
||||
Msg,
|
||||
NatsConnection,
|
||||
PubAck,
|
||||
Subscription,
|
||||
} from 'nats';
|
||||
import { NATS_CLIENT } from './nats.constants';
|
||||
|
||||
export type NatsMessageHandler<T = unknown> = (
|
||||
@@ -13,17 +23,62 @@ export type NatsMessageHandler<T = unknown> = (
|
||||
msg: Msg,
|
||||
) => Promise<void> | void;
|
||||
|
||||
export type JetStreamRetention = 'workqueue' | 'limits';
|
||||
|
||||
export type JetStreamMessageHandler<T = unknown> = (
|
||||
data: T,
|
||||
msg: JsMsg,
|
||||
) => Promise<void> | void;
|
||||
|
||||
export interface JetStreamStreamOptions {
|
||||
name: string;
|
||||
subjects: string[];
|
||||
retention: JetStreamRetention;
|
||||
maxAgeDays?: number;
|
||||
replicas?: number;
|
||||
}
|
||||
|
||||
export interface JetStreamConsumerOptions {
|
||||
stream: string;
|
||||
durable: string;
|
||||
filterSubject: string;
|
||||
description?: string;
|
||||
ackWaitMs?: number;
|
||||
backoffMs?: number[];
|
||||
maxDeliver?: number;
|
||||
maxAckPending?: number;
|
||||
replicas?: number;
|
||||
}
|
||||
|
||||
export interface JetStreamConsumeOptions {
|
||||
stream: string;
|
||||
durable: string;
|
||||
maxMessages?: number;
|
||||
expiresMs?: number;
|
||||
nakDelayMs?: number;
|
||||
}
|
||||
|
||||
@Injectable()
|
||||
export class NatsService implements OnModuleDestroy {
|
||||
private readonly logger = new Logger(NatsService.name);
|
||||
private readonly stringCodec = StringCodec();
|
||||
private readonly subscriptions = new Set<Subscription>();
|
||||
private readonly jetStreamConsumers = new Set<ConsumerMessages>();
|
||||
|
||||
constructor(
|
||||
@Inject(NATS_CLIENT) private readonly natsClient: NatsConnection,
|
||||
) {}
|
||||
|
||||
async onModuleDestroy() {
|
||||
for (const consumer of this.jetStreamConsumers) {
|
||||
try {
|
||||
await consumer.close();
|
||||
} catch {
|
||||
// ignore
|
||||
}
|
||||
}
|
||||
this.jetStreamConsumers.clear();
|
||||
|
||||
for (const sub of this.subscriptions) {
|
||||
try {
|
||||
sub.unsubscribe();
|
||||
@@ -68,6 +123,108 @@ export class NatsService implements OnModuleDestroy {
|
||||
return sub;
|
||||
}
|
||||
|
||||
public async publishJetStream<T = unknown>(
|
||||
subject: string,
|
||||
data: T,
|
||||
options?: { messageId?: string; timeoutMs?: number },
|
||||
): Promise<PubAck> {
|
||||
const ack = await this.natsClient
|
||||
.jetstream()
|
||||
.publish(subject, this.stringCodec.encode(JSON.stringify(data)), {
|
||||
msgID: options?.messageId,
|
||||
timeout: options?.timeoutMs ?? 5000,
|
||||
});
|
||||
return ack;
|
||||
}
|
||||
|
||||
public async ensureJetStreamStream(
|
||||
options: JetStreamStreamOptions,
|
||||
): Promise<void> {
|
||||
const manager = await this.natsClient.jetstreamManager();
|
||||
const config = {
|
||||
name: options.name,
|
||||
subjects: options.subjects,
|
||||
retention: this.toRetentionPolicy(options.retention),
|
||||
storage: StorageType.File,
|
||||
num_replicas: options.replicas ?? 1,
|
||||
max_age: options.maxAgeDays
|
||||
? nanos(options.maxAgeDays * 24 * 60 * 60 * 1000)
|
||||
: 0,
|
||||
};
|
||||
|
||||
try {
|
||||
await manager.streams.info(options.name);
|
||||
await manager.streams.update(options.name, {
|
||||
subjects: config.subjects,
|
||||
max_age: config.max_age,
|
||||
num_replicas: config.num_replicas,
|
||||
});
|
||||
return;
|
||||
} catch {
|
||||
await manager.streams.add(config);
|
||||
}
|
||||
}
|
||||
|
||||
public async ensureJetStreamConsumer(
|
||||
options: JetStreamConsumerOptions,
|
||||
): Promise<void> {
|
||||
const manager = await this.natsClient.jetstreamManager();
|
||||
const config = {
|
||||
durable_name: options.durable,
|
||||
name: options.durable,
|
||||
description: options.description,
|
||||
filter_subject: options.filterSubject,
|
||||
deliver_policy: DeliverPolicy.All,
|
||||
ack_policy: AckPolicy.Explicit,
|
||||
replay_policy: ReplayPolicy.Instant,
|
||||
ack_wait: nanos(options.ackWaitMs ?? 30000),
|
||||
backoff: (options.backoffMs ?? [5000, 30000, 120000, 600000]).map(
|
||||
(entry) => nanos(entry),
|
||||
),
|
||||
max_deliver: options.maxDeliver ?? 10,
|
||||
max_ack_pending: options.maxAckPending ?? 50,
|
||||
num_replicas: options.replicas ?? 1,
|
||||
};
|
||||
|
||||
try {
|
||||
await manager.consumers.info(options.stream, options.durable);
|
||||
await manager.consumers.update(options.stream, options.durable, config);
|
||||
return;
|
||||
} catch {
|
||||
await manager.consumers.add(options.stream, config);
|
||||
}
|
||||
}
|
||||
|
||||
public async consumeJetStream<T = unknown>(
|
||||
options: JetStreamConsumeOptions,
|
||||
handler: JetStreamMessageHandler<T>,
|
||||
): Promise<void> {
|
||||
try {
|
||||
const consumer = await this.natsClient
|
||||
.jetstream()
|
||||
.consumers.get(options.stream, options.durable);
|
||||
const messages = await consumer.consume({
|
||||
max_messages: options.maxMessages ?? 10,
|
||||
expires: options.expiresMs ?? 30000,
|
||||
});
|
||||
this.jetStreamConsumers.add(messages);
|
||||
|
||||
try {
|
||||
for await (const msg of messages) {
|
||||
await this.dispatchJetStream(msg, handler, options);
|
||||
}
|
||||
} finally {
|
||||
this.jetStreamConsumers.delete(messages);
|
||||
}
|
||||
} catch (err) {
|
||||
this.logger.error(
|
||||
`JetStream consumer stream="${options.stream}" durable="${options.durable}" terminated: ${
|
||||
(err as Error)?.stack ?? err
|
||||
}`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
private async consumeSubscription<T>(
|
||||
sub: Subscription,
|
||||
handler: NatsMessageHandler<T>,
|
||||
@@ -114,4 +271,46 @@ export class NatsService implements OnModuleDestroy {
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
private async dispatchJetStream<T>(
|
||||
msg: JsMsg,
|
||||
handler: JetStreamMessageHandler<T>,
|
||||
options: JetStreamConsumeOptions,
|
||||
): Promise<void> {
|
||||
let data: T;
|
||||
try {
|
||||
data = JSON.parse(msg.string()) as T;
|
||||
} catch (err) {
|
||||
this.logger.warn(
|
||||
`Terminating undecodable JetStream message subject="${msg.subject}" stream="${options.stream}": ${
|
||||
(err as Error)?.message ?? err
|
||||
}`,
|
||||
);
|
||||
msg.term('invalid_json');
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
await handler(data, msg);
|
||||
const acked = await msg.ackAck({ timeout: 5000 });
|
||||
if (!acked) {
|
||||
this.logger.warn(
|
||||
`JetStream ack was not confirmed subject="${msg.subject}" stream="${options.stream}" seq=${msg.seq}`,
|
||||
);
|
||||
}
|
||||
} catch (err) {
|
||||
this.logger.error(
|
||||
`JetStream handler error subject="${msg.subject}" stream="${options.stream}" seq=${msg.seq}: ${
|
||||
(err as Error)?.stack ?? err
|
||||
}`,
|
||||
);
|
||||
msg.nak(options.nakDelayMs ?? 5000);
|
||||
}
|
||||
}
|
||||
|
||||
private toRetentionPolicy(retention: JetStreamRetention): RetentionPolicy {
|
||||
return retention === 'workqueue'
|
||||
? RetentionPolicy.Workqueue
|
||||
: RetentionPolicy.Limits;
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,69 @@
|
||||
import { ConfigService } from '@nestjs/config';
|
||||
import { SecretService } from './secret.service';
|
||||
|
||||
function makeConfig(values: Record<string, string | undefined> = {}) {
|
||||
return {
|
||||
get: jest.fn((key: string) => values[key] ?? process.env[key]),
|
||||
} as unknown as ConfigService;
|
||||
}
|
||||
|
||||
describe('SecretService', () => {
|
||||
const originalEnv = process.env;
|
||||
let fetchMock: jest.Mock;
|
||||
|
||||
beforeEach(() => {
|
||||
process.env = { ...originalEnv };
|
||||
delete process.env.SECRET_SOURCE;
|
||||
delete process.env.TEST_SECRET;
|
||||
fetchMock = jest
|
||||
.fn()
|
||||
.mockRejectedValue(new Error('network calls are disabled in tests'));
|
||||
global.fetch = fetchMock;
|
||||
});
|
||||
|
||||
afterEach(() => {
|
||||
process.env = originalEnv;
|
||||
jest.restoreAllMocks();
|
||||
});
|
||||
|
||||
it('defaults to environment-provided secrets without IMDS lookup', async () => {
|
||||
process.env.TEST_SECRET = 'from-env';
|
||||
const service = new SecretService(makeConfig());
|
||||
|
||||
await service.ready();
|
||||
|
||||
await expect(service.get('TEST_SECRET')).resolves.toBe('from-env');
|
||||
expect(fetchMock).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('uses environment-provided secrets when SECRET_SOURCE is env', async () => {
|
||||
process.env.SECRET_SOURCE = 'env';
|
||||
process.env.TEST_SECRET = 'from-env-source';
|
||||
const service = new SecretService(makeConfig());
|
||||
|
||||
await service.ready();
|
||||
|
||||
await expect(service.get('TEST_SECRET')).resolves.toBe('from-env-source');
|
||||
expect(fetchMock).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('uses the IMDS and Infisical bootstrap path only when SECRET_SOURCE is infisical', async () => {
|
||||
process.env.SECRET_SOURCE = 'infisical';
|
||||
const service = new SecretService(makeConfig());
|
||||
|
||||
await expect(service.ready()).rejects.toThrow(
|
||||
'Missing required bootstrap secret: INFISICAL_CLIENT_ID',
|
||||
);
|
||||
expect(fetchMock).toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('rejects unsupported SECRET_SOURCE values', async () => {
|
||||
process.env.SECRET_SOURCE = 'kubernetes';
|
||||
const service = new SecretService(makeConfig());
|
||||
|
||||
await expect(service.ready()).rejects.toThrow(
|
||||
'Invalid SECRET_SOURCE="kubernetes". Expected "env" or "infisical".',
|
||||
);
|
||||
expect(fetchMock).not.toHaveBeenCalled();
|
||||
});
|
||||
});
|
||||
@@ -3,6 +3,7 @@ import { InfisicalSDK } from '@infisical/sdk';
|
||||
import { ConfigService } from '@nestjs/config';
|
||||
|
||||
type SecretMap = Record<string, string | undefined>;
|
||||
type SecretSource = 'env' | 'infisical';
|
||||
|
||||
const DEFAULT_INFISICAL_SITE_URL = 'https://secret-manager.dahyeon.us/';
|
||||
const IMDS_TOKEN_TTL_SECONDS = 60;
|
||||
@@ -34,43 +35,13 @@ export class SecretService {
|
||||
if (this.loading) return this.loading; // 로드 중이면 그거 기다리기
|
||||
|
||||
this.loading = (async () => {
|
||||
const bootstrapConfig = await this.resolveInfisicalBootstrapConfig();
|
||||
const infisicalClient = new InfisicalSDK({
|
||||
siteUrl: bootstrapConfig.siteUrl,
|
||||
});
|
||||
|
||||
await infisicalClient.auth().universalAuth.login({
|
||||
clientId: bootstrapConfig.clientId,
|
||||
clientSecret: bootstrapConfig.clientSecret,
|
||||
});
|
||||
|
||||
const res = await infisicalClient.secrets().listSecrets({
|
||||
environment:
|
||||
process.env.NODE_ENV === 'prod'
|
||||
? 'prod'
|
||||
: process.env.NODE_ENV === 'test'
|
||||
? 'staging'
|
||||
: 'dev',
|
||||
projectId: bootstrapConfig.projectId,
|
||||
});
|
||||
|
||||
// 임시 객체에 채운 뒤 한 번에 교체(일관성 보장)
|
||||
const map: SecretMap = {};
|
||||
for (const s of res.secrets) {
|
||||
map[s.secretKey] = s.secretValue;
|
||||
const secretSource = this.resolveSecretSource();
|
||||
if (secretSource === 'env') {
|
||||
this.loadEnvironmentSecrets();
|
||||
return;
|
||||
}
|
||||
|
||||
// 앱 생명주기에서 필요한 env는 모두 SecretService가 process.env에 반영한다.
|
||||
for (const [k, v] of Object.entries(map)) {
|
||||
if (typeof v === 'string' && v.length > 0) {
|
||||
process.env[k] = v;
|
||||
}
|
||||
}
|
||||
|
||||
this.secrets = map;
|
||||
this.logger.log(
|
||||
`Fetched ${Object.keys(map).length} secrets from Infisical`,
|
||||
);
|
||||
await this.fetchInfisicalSecrets();
|
||||
})();
|
||||
|
||||
try {
|
||||
@@ -80,6 +51,64 @@ export class SecretService {
|
||||
}
|
||||
}
|
||||
|
||||
private resolveSecretSource(): SecretSource {
|
||||
const source = this.config
|
||||
.get<string>('SECRET_SOURCE')
|
||||
?.trim()
|
||||
.toLowerCase();
|
||||
if (!source || source === 'env') return 'env';
|
||||
if (source === 'infisical') return 'infisical';
|
||||
|
||||
throw new Error(
|
||||
`Invalid SECRET_SOURCE="${source}". Expected "env" or "infisical".`,
|
||||
);
|
||||
}
|
||||
|
||||
private loadEnvironmentSecrets(): void {
|
||||
this.secrets = { ...process.env };
|
||||
this.logger.log('Using environment-provided secrets');
|
||||
}
|
||||
|
||||
private async fetchInfisicalSecrets(): Promise<void> {
|
||||
const bootstrapConfig = await this.resolveInfisicalBootstrapConfig();
|
||||
const infisicalClient = new InfisicalSDK({
|
||||
siteUrl: bootstrapConfig.siteUrl,
|
||||
});
|
||||
|
||||
await infisicalClient.auth().universalAuth.login({
|
||||
clientId: bootstrapConfig.clientId,
|
||||
clientSecret: bootstrapConfig.clientSecret,
|
||||
});
|
||||
|
||||
const res = await infisicalClient.secrets().listSecrets({
|
||||
environment:
|
||||
process.env.NODE_ENV === 'prod'
|
||||
? 'prod'
|
||||
: process.env.NODE_ENV === 'staging'
|
||||
? 'staging'
|
||||
: 'dev',
|
||||
projectId: bootstrapConfig.projectId,
|
||||
});
|
||||
|
||||
// 임시 객체에 채운 뒤 한 번에 교체(일관성 보장)
|
||||
const map: SecretMap = {};
|
||||
for (const s of res.secrets) {
|
||||
map[s.secretKey] = s.secretValue;
|
||||
}
|
||||
|
||||
// 앱 생명주기에서 필요한 env는 모두 SecretService가 process.env에 반영한다.
|
||||
for (const [k, v] of Object.entries(map)) {
|
||||
if (typeof v === 'string' && v.length > 0) {
|
||||
process.env[k] = v;
|
||||
}
|
||||
}
|
||||
|
||||
this.secrets = map;
|
||||
this.logger.log(
|
||||
`Fetched ${Object.keys(map).length} secrets from Infisical`,
|
||||
);
|
||||
}
|
||||
|
||||
private async resolveInfisicalBootstrapConfig(): Promise<InfisicalBootstrapConfig> {
|
||||
const [clientId, clientSecret, projectId] = await Promise.all([
|
||||
this.resolveBootstrapValue('INFISICAL_CLIENT_ID'),
|
||||
|
||||
@@ -99,6 +99,18 @@ export class MatchHistoryService {
|
||||
losses: tier.losses,
|
||||
fetchedAt: tier.fetchedAt.toISOString(),
|
||||
})),
|
||||
tierHistory: [...context.account.tierHistory]
|
||||
.sort((left, right) => left.recordedAt.getTime() - right.recordedAt.getTime())
|
||||
.map((entry) => ({
|
||||
queueType: entry.queueType,
|
||||
tier: entry.tier,
|
||||
rank: entry.rank,
|
||||
leaguePoints: entry.leaguePoints,
|
||||
wins: entry.wins,
|
||||
losses: entry.losses,
|
||||
recordedAt: entry.recordedAt.toISOString(),
|
||||
season: entry.season,
|
||||
})),
|
||||
season: context.season,
|
||||
seasons: this.resolveSeasons(context.community),
|
||||
lastFetchedAt: lastFetchedAt?.toISOString() ?? null,
|
||||
|
||||
@@ -27,6 +27,16 @@ export interface UserHistoryProfileResponse {
|
||||
losses: number;
|
||||
fetchedAt: string;
|
||||
}>;
|
||||
tierHistory: Array<{
|
||||
queueType: string;
|
||||
tier: string;
|
||||
rank?: string;
|
||||
leaguePoints?: number;
|
||||
wins?: number;
|
||||
losses?: number;
|
||||
recordedAt: string;
|
||||
season?: string;
|
||||
}>;
|
||||
season: HistorySeasonDto;
|
||||
seasons: HistorySeasonDto[];
|
||||
lastFetchedAt: string | null;
|
||||
|
||||
@@ -173,6 +173,14 @@ export class UpdateMatchDto {
|
||||
schedule?: MatchScheduleItemDto[];
|
||||
}
|
||||
|
||||
export class UpdateParticipantDto {
|
||||
@IsEnum(POSITIONS)
|
||||
mainPosition!: Position;
|
||||
|
||||
@IsEnum(POSITIONS)
|
||||
subPosition!: Position;
|
||||
}
|
||||
|
||||
export class JoinMatchDto {
|
||||
@IsArray()
|
||||
@ArrayMinSize(1)
|
||||
|
||||
@@ -27,6 +27,7 @@ import {
|
||||
CreateMatchDto,
|
||||
JoinMatchDto,
|
||||
UpdateMatchDto,
|
||||
UpdateParticipantDto,
|
||||
} from './dto/create-match.dto';
|
||||
import { MatchService } from './match.service';
|
||||
|
||||
@@ -137,6 +138,49 @@ export class MatchController {
|
||||
});
|
||||
}
|
||||
|
||||
// 관리자 전용 — 참가자 주/부 포지션 변경.
|
||||
@Patch(':matchId/participants/:userId')
|
||||
@Roles('admin', 'owner')
|
||||
@UseGuards(RolesGuard)
|
||||
public async updateParticipant(
|
||||
@CurrentUser() currentUser: UserDocument,
|
||||
@Param('communityId', ParseObjectIdPipe)
|
||||
communityId: mongoose.Types.ObjectId,
|
||||
@Param('matchId', ParseObjectIdPipe) matchId: mongoose.Types.ObjectId,
|
||||
@Param('userId', ParseObjectIdPipe) userId: mongoose.Types.ObjectId,
|
||||
@Body() body: UpdateParticipantDto,
|
||||
) {
|
||||
this.assertSameCommunity(currentUser, communityId);
|
||||
const match = await this.matchService.updateParticipantPositions({
|
||||
matchId,
|
||||
communityId,
|
||||
targetUserId: userId,
|
||||
mainPosition: body.mainPosition,
|
||||
subPosition: body.subPosition,
|
||||
});
|
||||
return this.matchService.serialize(match);
|
||||
}
|
||||
|
||||
// 관리자 전용 — 참가자 강제 제외.
|
||||
@Delete(':matchId/participants/:userId')
|
||||
@Roles('admin', 'owner')
|
||||
@UseGuards(RolesGuard)
|
||||
@HttpCode(HttpStatus.NO_CONTENT)
|
||||
public async removeParticipant(
|
||||
@CurrentUser() currentUser: UserDocument,
|
||||
@Param('communityId', ParseObjectIdPipe)
|
||||
communityId: mongoose.Types.ObjectId,
|
||||
@Param('matchId', ParseObjectIdPipe) matchId: mongoose.Types.ObjectId,
|
||||
@Param('userId', ParseObjectIdPipe) userId: mongoose.Types.ObjectId,
|
||||
) {
|
||||
this.assertSameCommunity(currentUser, communityId);
|
||||
await this.matchService.removeParticipant({
|
||||
matchId,
|
||||
communityId,
|
||||
targetUserId: userId,
|
||||
});
|
||||
}
|
||||
|
||||
private resolveJoinerUserId(
|
||||
currentUser: UserDocument | undefined,
|
||||
bodyUserId?: string,
|
||||
|
||||
@@ -13,6 +13,7 @@ import {
|
||||
MatchDocument,
|
||||
MatchSeriesResult,
|
||||
MatchStatus,
|
||||
Position,
|
||||
PositionPreference,
|
||||
TierInfo,
|
||||
} from '../global/database/schema';
|
||||
@@ -54,6 +55,20 @@ interface CancelMatchJoinParams {
|
||||
userId: mongoose.Types.ObjectId;
|
||||
}
|
||||
|
||||
interface RemoveParticipantParams {
|
||||
matchId: mongoose.Types.ObjectId;
|
||||
communityId: mongoose.Types.ObjectId;
|
||||
targetUserId: mongoose.Types.ObjectId;
|
||||
}
|
||||
|
||||
interface UpdateParticipantPositionsParams {
|
||||
matchId: mongoose.Types.ObjectId;
|
||||
communityId: mongoose.Types.ObjectId;
|
||||
targetUserId: mongoose.Types.ObjectId;
|
||||
mainPosition: Position;
|
||||
subPosition: Position;
|
||||
}
|
||||
|
||||
@Injectable()
|
||||
export class MatchService {
|
||||
constructor(
|
||||
@@ -276,6 +291,86 @@ export class MatchService {
|
||||
return match;
|
||||
}
|
||||
|
||||
// 관리자 전용 — 특정 참가자를 강제로 제외한다.
|
||||
public async removeParticipant(
|
||||
params: RemoveParticipantParams,
|
||||
): Promise<MatchDocument> {
|
||||
const match = await this.loadRecruitingMatch(
|
||||
params.matchId,
|
||||
params.communityId,
|
||||
);
|
||||
const participantIndex = match.participants.findIndex((participant) =>
|
||||
participant.userId.equals(params.targetUserId),
|
||||
);
|
||||
if (participantIndex === -1) {
|
||||
throw new NotFoundException('Participant not found.');
|
||||
}
|
||||
match.participants.splice(participantIndex, 1);
|
||||
await match.save();
|
||||
return match;
|
||||
}
|
||||
|
||||
// 관리자 전용 — 참가자의 주/부 포지션(선호 우선순위 1·2)을 교체한다.
|
||||
public async updateParticipantPositions(
|
||||
params: UpdateParticipantPositionsParams,
|
||||
): Promise<MatchDocument> {
|
||||
const match = await this.loadRecruitingMatch(
|
||||
params.matchId,
|
||||
params.communityId,
|
||||
);
|
||||
const participant = match.participants.find((entry) =>
|
||||
entry.userId.equals(params.targetUserId),
|
||||
);
|
||||
if (!participant) {
|
||||
throw new NotFoundException('Participant not found.');
|
||||
}
|
||||
participant.preferredPositions = this.reorderPreferredPositions(
|
||||
params.mainPosition,
|
||||
params.subPosition,
|
||||
participant.preferredPositions,
|
||||
);
|
||||
match.markModified('participants');
|
||||
await match.save();
|
||||
return match;
|
||||
}
|
||||
|
||||
private async loadRecruitingMatch(
|
||||
matchId: mongoose.Types.ObjectId,
|
||||
communityId: mongoose.Types.ObjectId,
|
||||
): Promise<MatchDocument> {
|
||||
const MatchModel = await this.connectionService.getModel('match');
|
||||
const match = await MatchModel.findById(matchId);
|
||||
if (!match) throw new NotFoundException('Match not found.');
|
||||
if (!match.communityId.equals(communityId)) {
|
||||
throw new BadRequestException('Different community.');
|
||||
}
|
||||
if (match.status !== 'recruiting') {
|
||||
throw new BadRequestException('Match is not recruiting.');
|
||||
}
|
||||
return match;
|
||||
}
|
||||
|
||||
// 주/부 포지션을 priority 1·2로 올리고 기존 나머지 선호는 뒤로 보존한다.
|
||||
private reorderPreferredPositions(
|
||||
mainPosition: Position,
|
||||
subPosition: Position,
|
||||
current: PositionPreference[],
|
||||
): PositionPreference[] {
|
||||
const ordered: Position[] = [mainPosition];
|
||||
if (subPosition !== mainPosition) ordered.push(subPosition);
|
||||
for (const preference of [...current].sort(
|
||||
(left, right) => left.priority - right.priority,
|
||||
)) {
|
||||
if (!ordered.includes(preference.position)) {
|
||||
ordered.push(preference.position);
|
||||
}
|
||||
}
|
||||
return ordered.map((position, index) => ({
|
||||
position,
|
||||
priority: index + 1,
|
||||
}));
|
||||
}
|
||||
|
||||
private selectParticipantTier(tiers: TierInfo[]): TierInfo | undefined {
|
||||
const tier =
|
||||
tiers.find((entry) => entry.queueType === 'RANKED_SOLO_5x5') ?? tiers[0];
|
||||
|
||||
@@ -1,4 +1,3 @@
|
||||
import { ConfigService } from '@nestjs/config';
|
||||
import mongoose from 'mongoose';
|
||||
import { GarnetService } from '../global/garnet/garnet.service';
|
||||
import { RiotAccountEnrichmentService } from '../riot/riot-account-enrichment.service';
|
||||
@@ -30,7 +29,7 @@ function candidate(puuid: string): StaleAccountCandidate {
|
||||
};
|
||||
}
|
||||
|
||||
function makeScheduler(enabled = true) {
|
||||
function makeScheduler() {
|
||||
const rawClient = {
|
||||
sendCommand: jest.fn().mockResolvedValue(1),
|
||||
};
|
||||
@@ -42,7 +41,7 @@ function makeScheduler(enabled = true) {
|
||||
raw: jest.fn().mockReturnValue(rawClient),
|
||||
} as unknown as jest.Mocked<GarnetService> & { raw: jest.Mock };
|
||||
const rateLimiter = {
|
||||
acquireBackground: jest.fn().mockResolvedValue(undefined),
|
||||
isRefreshWindowOpen: jest.fn().mockResolvedValue(true),
|
||||
} as unknown as jest.Mocked<RiotRateLimiterService>;
|
||||
const enrichmentService = {
|
||||
markRefreshRequested: jest.fn().mockResolvedValue(undefined),
|
||||
@@ -51,16 +50,11 @@ function makeScheduler(enabled = true) {
|
||||
const staleAccountRepository = {
|
||||
findStaleAccounts: jest.fn().mockResolvedValue([]),
|
||||
} as unknown as jest.Mocked<StaleAccountRepository>;
|
||||
const config = {
|
||||
get: jest.fn().mockReturnValue(enabled ? 'true' : 'false'),
|
||||
} as unknown as ConfigService;
|
||||
|
||||
const scheduler = new BackgroundRefreshScheduler(
|
||||
garnet,
|
||||
rateLimiter,
|
||||
enrichmentService,
|
||||
staleAccountRepository,
|
||||
config,
|
||||
) as SchedulerInternals;
|
||||
|
||||
return {
|
||||
@@ -79,19 +73,40 @@ describe('BackgroundRefreshScheduler', () => {
|
||||
jest.restoreAllMocks();
|
||||
});
|
||||
|
||||
it('does not schedule ticks when disabled', () => {
|
||||
it('schedules ticks without requiring RIOT_BG_REFRESH_ENABLED', () => {
|
||||
jest.useFakeTimers();
|
||||
const setIntervalSpy = jest.spyOn(global, 'setInterval');
|
||||
const { scheduler } = makeScheduler(false);
|
||||
const { scheduler } = makeScheduler();
|
||||
|
||||
scheduler.onModuleInit();
|
||||
|
||||
expect(setIntervalSpy).not.toHaveBeenCalled();
|
||||
expect(setIntervalSpy).toHaveBeenCalledTimes(2);
|
||||
scheduler.onModuleDestroy();
|
||||
});
|
||||
|
||||
it('does not query stale accounts outside the KST window', async () => {
|
||||
it('uses the dawn refresh gate ratio inside the KST background window', async () => {
|
||||
jest.useFakeTimers().setSystemTime(new Date('2026-05-02T18:00:00.000Z'));
|
||||
const { scheduler, rateLimiter } = makeScheduler();
|
||||
|
||||
await scheduler.tick();
|
||||
|
||||
expect(rateLimiter.isRefreshWindowOpen).toHaveBeenCalledWith(0.8);
|
||||
});
|
||||
|
||||
it('uses the opportunistic refresh gate ratio outside the KST background window', async () => {
|
||||
jest.useFakeTimers().setSystemTime(new Date('2026-05-02T17:59:59.000Z'));
|
||||
const { scheduler, staleAccountRepository } = makeScheduler();
|
||||
const { scheduler, rateLimiter, staleAccountRepository } = makeScheduler();
|
||||
|
||||
await scheduler.tick();
|
||||
|
||||
expect(rateLimiter.isRefreshWindowOpen).toHaveBeenCalledWith(0.5);
|
||||
expect(staleAccountRepository.findStaleAccounts).toHaveBeenCalledTimes(1);
|
||||
});
|
||||
|
||||
it('does not query stale accounts when the refresh gate is closed', async () => {
|
||||
jest.useFakeTimers().setSystemTime(new Date('2026-05-02T18:00:00.000Z'));
|
||||
const { scheduler, rateLimiter, staleAccountRepository } = makeScheduler();
|
||||
rateLimiter.isRefreshWindowOpen.mockResolvedValue(false);
|
||||
|
||||
await scheduler.tick();
|
||||
|
||||
@@ -108,21 +123,15 @@ describe('BackgroundRefreshScheduler', () => {
|
||||
expect(staleAccountRepository.findStaleAccounts).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('marks and enriches each stale candidate with background rate tokens', async () => {
|
||||
it('marks and enriches each stale candidate without background precharge', async () => {
|
||||
jest.useFakeTimers().setSystemTime(new Date('2026-05-02T18:00:00.000Z'));
|
||||
const {
|
||||
scheduler,
|
||||
rateLimiter,
|
||||
enrichmentService,
|
||||
staleAccountRepository,
|
||||
} = makeScheduler();
|
||||
const { scheduler, enrichmentService, staleAccountRepository } =
|
||||
makeScheduler();
|
||||
const candidates = [candidate('puuid-1'), candidate('puuid-2')];
|
||||
staleAccountRepository.findStaleAccounts.mockResolvedValue(candidates);
|
||||
|
||||
await scheduler.tick();
|
||||
|
||||
expect(rateLimiter.acquireBackground).toHaveBeenCalledTimes(2);
|
||||
expect(rateLimiter.acquireBackground).toHaveBeenCalledWith(8);
|
||||
expect(enrichmentService.markRefreshRequested).toHaveBeenCalledTimes(2);
|
||||
expect(enrichmentService.markRefreshRequested).toHaveBeenNthCalledWith(
|
||||
1,
|
||||
@@ -136,6 +145,28 @@ describe('BackgroundRefreshScheduler', () => {
|
||||
});
|
||||
});
|
||||
|
||||
it('stops the candidate loop when the refresh gate closes mid-tick', async () => {
|
||||
jest.useFakeTimers().setSystemTime(new Date('2026-05-02T18:00:00.000Z'));
|
||||
const {
|
||||
scheduler,
|
||||
rateLimiter,
|
||||
enrichmentService,
|
||||
staleAccountRepository,
|
||||
} = makeScheduler();
|
||||
staleAccountRepository.findStaleAccounts.mockResolvedValue([
|
||||
candidate('puuid-1'),
|
||||
candidate('puuid-2'),
|
||||
]);
|
||||
rateLimiter.isRefreshWindowOpen
|
||||
.mockResolvedValueOnce(true)
|
||||
.mockResolvedValueOnce(true)
|
||||
.mockResolvedValueOnce(false);
|
||||
|
||||
await scheduler.tick();
|
||||
|
||||
expect(enrichmentService.enrichRiotAccount).toHaveBeenCalledTimes(1);
|
||||
});
|
||||
|
||||
it('continues after a candidate throws and records a failure counter', async () => {
|
||||
jest.useFakeTimers().setSystemTime(new Date('2026-05-02T18:00:00.000Z'));
|
||||
const { scheduler, rawClient, enrichmentService, staleAccountRepository } =
|
||||
@@ -162,13 +193,8 @@ describe('BackgroundRefreshScheduler', () => {
|
||||
|
||||
it('skips candidates already in failure backoff', async () => {
|
||||
jest.useFakeTimers().setSystemTime(new Date('2026-05-02T18:00:00.000Z'));
|
||||
const {
|
||||
scheduler,
|
||||
garnet,
|
||||
rateLimiter,
|
||||
enrichmentService,
|
||||
staleAccountRepository,
|
||||
} = makeScheduler();
|
||||
const { scheduler, garnet, enrichmentService, staleAccountRepository } =
|
||||
makeScheduler();
|
||||
staleAccountRepository.findStaleAccounts.mockResolvedValue([
|
||||
candidate('skip-me'),
|
||||
]);
|
||||
@@ -179,7 +205,6 @@ describe('BackgroundRefreshScheduler', () => {
|
||||
|
||||
await scheduler.tick();
|
||||
|
||||
expect(rateLimiter.acquireBackground).not.toHaveBeenCalled();
|
||||
expect(enrichmentService.markRefreshRequested).not.toHaveBeenCalled();
|
||||
expect(enrichmentService.enrichRiotAccount).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
@@ -4,7 +4,6 @@ import {
|
||||
OnModuleDestroy,
|
||||
OnModuleInit,
|
||||
} from '@nestjs/common';
|
||||
import { ConfigService } from '@nestjs/config';
|
||||
import {
|
||||
type EnrichResult,
|
||||
RiotAccountEnrichmentService,
|
||||
@@ -20,11 +19,17 @@ const LEADER_TTL_SECONDS = 90;
|
||||
const LEADER_RENEW_INTERVAL_MS = 30_000;
|
||||
const STALE_THRESHOLD_MS = 6 * 60 * 60 * 1000;
|
||||
const PER_TICK_CANDIDATE_LIMIT = 20;
|
||||
const ENRICH_COST_TOKENS = 8;
|
||||
const DAWN_USAGE_RATIO = 0.8;
|
||||
const OPPORTUNISTIC_USAGE_RATIO = 0.5;
|
||||
const FAILURE_BACKOFF_KEY_PREFIX = 'riot:bg:fail';
|
||||
const FAILURE_BACKOFF_THRESHOLD = 3;
|
||||
const FAILURE_BACKOFF_TTL_SECONDS = 24 * 60 * 60;
|
||||
|
||||
interface RefreshGatePolicy {
|
||||
mode: 'dawn' | 'opportunistic';
|
||||
usageRatio: number;
|
||||
}
|
||||
|
||||
@Injectable()
|
||||
export class BackgroundRefreshScheduler
|
||||
implements OnModuleInit, OnModuleDestroy
|
||||
@@ -34,26 +39,15 @@ export class BackgroundRefreshScheduler
|
||||
private leaderRenewTimer?: NodeJS.Timeout;
|
||||
private tickInProgress = false;
|
||||
private readonly consumer = `${process.pid}:${Math.random().toString(36).slice(2)}`;
|
||||
private readonly enabled: boolean;
|
||||
|
||||
constructor(
|
||||
private readonly garnet: GarnetService,
|
||||
private readonly rateLimiter: RiotRateLimiterService,
|
||||
private readonly enrichmentService: RiotAccountEnrichmentService,
|
||||
private readonly staleAccountRepository: StaleAccountRepository,
|
||||
config: ConfigService,
|
||||
) {
|
||||
this.enabled = config.get<string>('RIOT_BG_REFRESH_ENABLED') === 'true';
|
||||
}
|
||||
) {}
|
||||
|
||||
public onModuleInit(): void {
|
||||
if (!this.enabled) {
|
||||
this.logger.log(
|
||||
'Background Riot refresh is disabled (RIOT_BG_REFRESH_ENABLED).',
|
||||
);
|
||||
return;
|
||||
}
|
||||
|
||||
this.tickTimer = setInterval(() => void this.safeTick(), TICK_INTERVAL_MS);
|
||||
this.leaderRenewTimer = setInterval(
|
||||
() => void this.renewLeaderIfHeld(),
|
||||
@@ -87,7 +81,11 @@ export class BackgroundRefreshScheduler
|
||||
}
|
||||
|
||||
private async tick(): Promise<void> {
|
||||
if (!isInKstBackgroundWindow()) return;
|
||||
const initialGate = this.currentRefreshGatePolicy();
|
||||
if (!(await this.rateLimiter.isRefreshWindowOpen(initialGate.usageRatio))) {
|
||||
return;
|
||||
}
|
||||
|
||||
const isLeader = await this.tryBecomeLeader();
|
||||
if (!isLeader) return;
|
||||
|
||||
@@ -101,15 +99,20 @@ export class BackgroundRefreshScheduler
|
||||
let processed = 0;
|
||||
let failed = 0;
|
||||
let skipped = 0;
|
||||
let currentGate = initialGate;
|
||||
|
||||
for (const candidate of candidates) {
|
||||
if (!isInKstBackgroundWindow()) break;
|
||||
currentGate = this.currentRefreshGatePolicy();
|
||||
if (
|
||||
!(await this.rateLimiter.isRefreshWindowOpen(currentGate.usageRatio))
|
||||
) {
|
||||
break;
|
||||
}
|
||||
if (await this.isInFailureBackoff(candidate.puuid)) {
|
||||
skipped += 1;
|
||||
continue;
|
||||
}
|
||||
|
||||
await this.rateLimiter.acquireBackground(ENRICH_COST_TOKENS);
|
||||
await this.enrichmentService.markRefreshRequested(
|
||||
candidate.userId,
|
||||
candidate.puuid,
|
||||
@@ -142,10 +145,18 @@ export class BackgroundRefreshScheduler
|
||||
}
|
||||
|
||||
this.logger.debug(
|
||||
`Background refresh tick: processed=${processed} failed=${failed} skipped=${skipped} candidates=${candidates.length}`,
|
||||
`Background refresh tick: processed=${processed} failed=${failed} skipped=${skipped} candidates=${candidates.length} mode=${currentGate.mode} ratio=${currentGate.usageRatio}`,
|
||||
);
|
||||
}
|
||||
|
||||
private currentRefreshGatePolicy(): RefreshGatePolicy {
|
||||
const isDawn = isInKstBackgroundWindow();
|
||||
return {
|
||||
mode: isDawn ? 'dawn' : 'opportunistic',
|
||||
usageRatio: isDawn ? DAWN_USAGE_RATIO : OPPORTUNISTIC_USAGE_RATIO,
|
||||
};
|
||||
}
|
||||
|
||||
private async tryBecomeLeader(): Promise<boolean> {
|
||||
const current = await this.garnet.getString(LEADER_KEY);
|
||||
if (current === this.consumer) {
|
||||
|
||||
@@ -0,0 +1,154 @@
|
||||
import mongoose from 'mongoose';
|
||||
import { ConnectionService } from '../global/database/connection.service';
|
||||
import { GarnetService } from '../global/garnet/garnet.service';
|
||||
import { LegacyImportService } from '../legacy-import/legacy-import.service';
|
||||
import { RiotAccountEnrichmentService } from '../riot/riot-account-enrichment.service';
|
||||
import { RiotRecentMatchesService } from '../riot/riot-recent-matches.service';
|
||||
import { TournamentResultService } from '../tournament-result/tournament-result.service';
|
||||
import { RIOT_JOB_GROUP, RiotRefreshSubJob } from './riot-job-queue.types';
|
||||
import { RiotJobQueueService } from './riot-job-queue.service';
|
||||
import { RiotJobWorkerService } from './riot-job-worker.service';
|
||||
import { RiotRefreshGateway } from './riot-refresh.gateway';
|
||||
|
||||
function execResult<T>(value: T) {
|
||||
return { exec: jest.fn().mockResolvedValue(value) };
|
||||
}
|
||||
|
||||
function makeWorker() {
|
||||
const garnetService = {
|
||||
acknowledgeStream: jest.fn().mockResolvedValue(undefined),
|
||||
deleteStreamEntries: jest.fn().mockResolvedValue(undefined),
|
||||
} as unknown as jest.Mocked<GarnetService>;
|
||||
const jobQueueService = {
|
||||
markProcessing: jest.fn().mockResolvedValue(undefined),
|
||||
markCompleted: jest.fn().mockResolvedValue({
|
||||
parentJobId: 'parent-1',
|
||||
jobId: 'job-1',
|
||||
queueGroup: 'summoners-rift',
|
||||
puuid: 'puuid-1',
|
||||
state: 'completed',
|
||||
}),
|
||||
markFailed: jest.fn(),
|
||||
} as unknown as jest.Mocked<RiotJobQueueService>;
|
||||
const recentMatchesService = {
|
||||
ensureFreshForQueue: jest.fn().mockResolvedValue(undefined),
|
||||
} as unknown as jest.Mocked<RiotRecentMatchesService>;
|
||||
const userModel = {
|
||||
updateOne: jest.fn().mockReturnValue(execResult({ modifiedCount: 1 })),
|
||||
};
|
||||
const connectionService = {
|
||||
getModel: jest.fn().mockResolvedValue(userModel),
|
||||
} as unknown as jest.Mocked<ConnectionService>;
|
||||
const refreshGateway = {
|
||||
broadcastRefreshEvent: jest.fn(),
|
||||
} as unknown as jest.Mocked<RiotRefreshGateway>;
|
||||
const tournamentResultService = {
|
||||
processPollJob: jest.fn(),
|
||||
} as unknown as jest.Mocked<TournamentResultService>;
|
||||
const legacyImportService = {
|
||||
processMemberJob: jest.fn(),
|
||||
} as unknown as jest.Mocked<LegacyImportService>;
|
||||
const enrichmentService = {
|
||||
refreshLeagueEntries: jest.fn().mockResolvedValue('updated'),
|
||||
} as unknown as jest.Mocked<RiotAccountEnrichmentService>;
|
||||
|
||||
const worker = new RiotJobWorkerService(
|
||||
garnetService,
|
||||
jobQueueService,
|
||||
recentMatchesService,
|
||||
connectionService,
|
||||
refreshGateway,
|
||||
tournamentResultService,
|
||||
legacyImportService,
|
||||
enrichmentService,
|
||||
);
|
||||
|
||||
return {
|
||||
worker,
|
||||
garnetService,
|
||||
jobQueueService,
|
||||
recentMatchesService,
|
||||
connectionService,
|
||||
refreshGateway,
|
||||
enrichmentService,
|
||||
};
|
||||
}
|
||||
|
||||
describe('RiotJobWorkerService', () => {
|
||||
it('acknowledges and deletes invalid stream entries', async () => {
|
||||
const { worker, garnetService } = makeWorker();
|
||||
|
||||
await (
|
||||
worker as unknown as {
|
||||
processEntry: (
|
||||
stream: string,
|
||||
entry: { id: string; message: Record<string, string> },
|
||||
) => Promise<void>;
|
||||
}
|
||||
).processEntry('riot:queue:high', {
|
||||
id: 'bad-1',
|
||||
message: { job: 'not-json' },
|
||||
});
|
||||
|
||||
expect(garnetService.acknowledgeStream).toHaveBeenCalledWith(
|
||||
'riot:queue:high',
|
||||
RIOT_JOB_GROUP,
|
||||
'bad-1',
|
||||
);
|
||||
expect(garnetService.deleteStreamEntries).toHaveBeenCalledWith(
|
||||
'riot:queue:high',
|
||||
'bad-1',
|
||||
);
|
||||
});
|
||||
|
||||
it('refreshes league entries while processing user history refresh jobs', async () => {
|
||||
const { worker, enrichmentService, recentMatchesService, garnetService } =
|
||||
makeWorker();
|
||||
const userId = new mongoose.Types.ObjectId().toString();
|
||||
const job: RiotRefreshSubJob = {
|
||||
jobId: 'job-1',
|
||||
parentJobId: 'parent-1',
|
||||
userId,
|
||||
puuid: 'puuid-1',
|
||||
region: 'asia',
|
||||
platform: 'kr',
|
||||
queueGroup: 'summoners-rift',
|
||||
queueIds: [420, 430],
|
||||
requestedAt: Date.now(),
|
||||
priority: 'high',
|
||||
};
|
||||
|
||||
await (
|
||||
worker as unknown as {
|
||||
processEntry: (
|
||||
stream: string,
|
||||
entry: { id: string; message: Record<string, string> },
|
||||
) => Promise<void>;
|
||||
}
|
||||
).processEntry('riot:queue:high', {
|
||||
id: '1-0',
|
||||
message: { job: JSON.stringify(job) },
|
||||
});
|
||||
|
||||
expect(recentMatchesService.ensureFreshForQueue).toHaveBeenCalledTimes(2);
|
||||
expect(enrichmentService.refreshLeagueEntries).toHaveBeenCalledWith({
|
||||
userId: expect.any(mongoose.Types.ObjectId),
|
||||
puuid: 'puuid-1',
|
||||
platform: 'kr',
|
||||
});
|
||||
expect(garnetService.acknowledgeStream).toHaveBeenCalledWith(
|
||||
'riot:queue:high',
|
||||
RIOT_JOB_GROUP,
|
||||
'1-0',
|
||||
);
|
||||
expect(garnetService.deleteStreamEntries).toHaveBeenCalledWith(
|
||||
'riot:queue:high',
|
||||
'1-0',
|
||||
);
|
||||
expect(
|
||||
garnetService.acknowledgeStream.mock.invocationCallOrder[0],
|
||||
).toBeLessThan(
|
||||
garnetService.deleteStreamEntries.mock.invocationCallOrder[0],
|
||||
);
|
||||
});
|
||||
});
|
||||
@@ -9,7 +9,10 @@ import { ConnectionService } from '../global/database/connection.service';
|
||||
import { GarnetService, StreamEntry } from '../global/garnet/garnet.service';
|
||||
import { LegacyImportService } from '../legacy-import/legacy-import.service';
|
||||
import type { LegacyImportMemberJob } from '../legacy-import/legacy-import.types';
|
||||
import { RiotAccountEnrichmentService } from '../riot/riot-account-enrichment.service';
|
||||
import { RiotRecentMatchesService } from '../riot/riot-recent-matches.service';
|
||||
import { TournamentResultService } from '../tournament-result/tournament-result.service';
|
||||
import type { PollTournamentResultJob } from '../tournament-result/tournament-result.types';
|
||||
import {
|
||||
RIOT_JOB_GROUP,
|
||||
RIOT_JOB_HIGH_STREAM,
|
||||
@@ -19,8 +22,6 @@ import {
|
||||
} from './riot-job-queue.types';
|
||||
import { RiotJobQueueService } from './riot-job-queue.service';
|
||||
import { RiotRefreshGateway } from './riot-refresh.gateway';
|
||||
import { TournamentResultService } from '../tournament-result/tournament-result.service';
|
||||
import type { PollTournamentResultJob } from '../tournament-result/tournament-result.types';
|
||||
|
||||
const LEADER_KEY = 'riot:worker:leader';
|
||||
const LEADER_TTL_SECONDS = 60;
|
||||
@@ -39,6 +40,7 @@ export class RiotJobWorkerService implements OnModuleInit, OnModuleDestroy {
|
||||
private readonly refreshGateway: RiotRefreshGateway,
|
||||
private readonly tournamentResultService: TournamentResultService,
|
||||
private readonly legacyImportService: LegacyImportService,
|
||||
private readonly enrichmentService: RiotAccountEnrichmentService,
|
||||
) {}
|
||||
|
||||
public async onModuleInit() {
|
||||
@@ -77,10 +79,13 @@ export class RiotJobWorkerService implements OnModuleInit, OnModuleDestroy {
|
||||
}
|
||||
}
|
||||
|
||||
private async processEntry(stream: string, entry: StreamEntry): Promise<void> {
|
||||
private async processEntry(
|
||||
stream: string,
|
||||
entry: StreamEntry,
|
||||
): Promise<void> {
|
||||
const job = this.parseJob(entry);
|
||||
if (!job) {
|
||||
await this.garnetService.acknowledgeStream(stream, RIOT_JOB_GROUP, entry.id);
|
||||
await this.acknowledgeAndDelete(stream, entry.id);
|
||||
return;
|
||||
}
|
||||
|
||||
@@ -102,6 +107,7 @@ export class RiotJobWorkerService implements OnModuleInit, OnModuleDestroy {
|
||||
queueId,
|
||||
});
|
||||
}
|
||||
await this.refreshLeagueEntries(job);
|
||||
await this.markUserFetchedAt(job);
|
||||
const event = await this.jobQueueService.markCompleted(job);
|
||||
this.refreshGateway.broadcastRefreshEvent(event);
|
||||
@@ -131,7 +137,50 @@ export class RiotJobWorkerService implements OnModuleInit, OnModuleDestroy {
|
||||
}`,
|
||||
);
|
||||
} finally {
|
||||
await this.garnetService.acknowledgeStream(stream, RIOT_JOB_GROUP, entry.id);
|
||||
await this.acknowledgeAndDelete(stream, entry.id);
|
||||
}
|
||||
}
|
||||
|
||||
private async acknowledgeAndDelete(
|
||||
stream: string,
|
||||
id: string,
|
||||
): Promise<void> {
|
||||
await this.garnetService.acknowledgeStream(stream, RIOT_JOB_GROUP, id);
|
||||
await this.deleteAcknowledgedEntry(stream, id);
|
||||
}
|
||||
|
||||
private async deleteAcknowledgedEntry(
|
||||
stream: string,
|
||||
id: string,
|
||||
): Promise<void> {
|
||||
try {
|
||||
await this.garnetService.deleteStreamEntries(stream, id);
|
||||
} catch (error) {
|
||||
this.logger.warn(
|
||||
`Failed to delete acknowledged Riot job stream entry ${stream} ${id}: ${
|
||||
error instanceof Error ? error.message : error
|
||||
}`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
private async refreshLeagueEntries(job: RiotRefreshSubJob): Promise<void> {
|
||||
try {
|
||||
const result = await this.enrichmentService.refreshLeagueEntries({
|
||||
userId: new mongoose.Types.ObjectId(job.userId),
|
||||
puuid: job.puuid,
|
||||
platform: job.platform,
|
||||
});
|
||||
if (result !== 'failed') return;
|
||||
this.logger.warn(
|
||||
`Riot league refresh failed ${job.jobId}: puuid=${job.puuid}`,
|
||||
);
|
||||
} catch (error) {
|
||||
this.logger.warn(
|
||||
`Riot league refresh failed ${job.jobId}: ${
|
||||
error instanceof Error ? error.message : error
|
||||
}`,
|
||||
);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -169,9 +218,7 @@ export class RiotJobWorkerService implements OnModuleInit, OnModuleDestroy {
|
||||
return job.kind === 'poll-tournament-result';
|
||||
}
|
||||
|
||||
private isLegacyImportJob(
|
||||
job: RiotJobPayload,
|
||||
): job is LegacyImportMemberJob {
|
||||
private isLegacyImportJob(job: RiotJobPayload): job is LegacyImportMemberJob {
|
||||
return job.kind === 'legacy-import-member';
|
||||
}
|
||||
|
||||
@@ -196,7 +243,8 @@ export class RiotJobWorkerService implements OnModuleInit, OnModuleDestroy {
|
||||
try {
|
||||
await this.garnetService.createConsumerGroup(stream, RIOT_JOB_GROUP);
|
||||
} catch (error) {
|
||||
const message = error instanceof Error ? error.message : String(error);
|
||||
const message =
|
||||
error instanceof Error ? error.message : String(error);
|
||||
if (!message.includes('BUSYGROUP')) throw error;
|
||||
}
|
||||
}),
|
||||
|
||||
@@ -70,9 +70,11 @@ function makeAccount(overrides: Partial<FakeAccount> = {}): FakeAccount {
|
||||
|
||||
function makeUser(account: FakeAccount) {
|
||||
const _id = new mongoose.Types.ObjectId();
|
||||
const communityId = new mongoose.Types.ObjectId();
|
||||
const save = jest.fn().mockResolvedValue(undefined);
|
||||
return {
|
||||
_id,
|
||||
communityId,
|
||||
riotAccounts: [account],
|
||||
save,
|
||||
};
|
||||
@@ -86,6 +88,7 @@ function makeService(overrides?: {
|
||||
mastery?: Partial<RiotChampionMasteryService>;
|
||||
recentMatches?: Partial<RiotRecentMatchesService>;
|
||||
recentStats?: Partial<RiotRecentStatsService>;
|
||||
match?: any;
|
||||
}) {
|
||||
const user = overrides?.user;
|
||||
const userFindById = jest.fn().mockReturnValue({
|
||||
@@ -98,10 +101,15 @@ function makeService(overrides?: {
|
||||
Promise.resolve({
|
||||
riotPlatform: 'kr',
|
||||
riotRegion: 'asia',
|
||||
}),
|
||||
}),
|
||||
}),
|
||||
}),
|
||||
});
|
||||
const matchUpdateManyExec = jest.fn().mockResolvedValue({ modifiedCount: 0 });
|
||||
const matchModel = {
|
||||
updateMany: jest.fn().mockReturnValue({ exec: matchUpdateManyExec }),
|
||||
...overrides?.match,
|
||||
};
|
||||
const connectionService = {
|
||||
getModel: jest.fn().mockImplementation(async (modelName: string) => {
|
||||
if (modelName === 'user') {
|
||||
@@ -110,6 +118,9 @@ function makeService(overrides?: {
|
||||
if (modelName === 'community') {
|
||||
return { findById: communityFindById };
|
||||
}
|
||||
if (modelName === 'match') {
|
||||
return matchModel;
|
||||
}
|
||||
throw new Error(`Unexpected model: ${modelName}`);
|
||||
}),
|
||||
} as unknown as ConnectionService;
|
||||
@@ -160,6 +171,8 @@ function makeService(overrides?: {
|
||||
masteryService,
|
||||
recentMatchesService,
|
||||
recentStatsService,
|
||||
matchModel,
|
||||
matchUpdateManyExec,
|
||||
};
|
||||
}
|
||||
|
||||
@@ -370,6 +383,273 @@ describe('RiotAccountEnrichmentService', () => {
|
||||
expect(user.save).not.toHaveBeenCalled();
|
||||
});
|
||||
|
||||
it('refreshes league entries without refreshing recent matches', async () => {
|
||||
const recent = new Date(Date.now() - 60_000);
|
||||
const account = makeAccount({
|
||||
revisionDate: Date.now() - 60_000,
|
||||
tiers: [
|
||||
{
|
||||
leagueId: 'L1',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'GOLD',
|
||||
rank: 'II',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 1,
|
||||
wins: 1,
|
||||
losses: 1,
|
||||
fetchedAt: recent,
|
||||
},
|
||||
],
|
||||
recentStatsFetchedAt: recent,
|
||||
recentStatsSummary: createEmptyRiotRecentStatsSummary(),
|
||||
});
|
||||
const user = makeUser(account);
|
||||
const { service, leagueService, recentMatchesService } = makeService({
|
||||
user,
|
||||
league: {
|
||||
getEntriesByPuuid: jest.fn().mockResolvedValue([
|
||||
{
|
||||
leagueId: 'L2',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'PLATINUM',
|
||||
rank: 'IV',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 20,
|
||||
wins: 10,
|
||||
losses: 8,
|
||||
},
|
||||
]),
|
||||
} as Partial<RiotLeagueService>,
|
||||
});
|
||||
|
||||
const result = await service.refreshLeagueEntries({
|
||||
userId: user._id,
|
||||
puuid: 'puuid-1',
|
||||
platform: 'kr',
|
||||
});
|
||||
|
||||
expect(result).toBe('updated');
|
||||
expect(leagueService.getEntriesByPuuid).toHaveBeenCalledWith('puuid-1', {
|
||||
platform: 'kr',
|
||||
});
|
||||
expect(recentMatchesService.syncRecentMatches).not.toHaveBeenCalled();
|
||||
expect(account.tiers).toHaveLength(1);
|
||||
expect(account.tiers[0]).toMatchObject({
|
||||
leagueId: 'L2',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'PLATINUM',
|
||||
rank: 'IV',
|
||||
leaguePoints: 20,
|
||||
});
|
||||
expect(account.tierHistory.at(-1)).toMatchObject({
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'PLATINUM',
|
||||
rank: 'IV',
|
||||
leaguePoints: 20,
|
||||
});
|
||||
expect(user.save).toHaveBeenCalledTimes(1);
|
||||
});
|
||||
|
||||
it('appends tier history when LP changes without tier or rank changes', async () => {
|
||||
const recent = new Date(Date.now() - 60_000);
|
||||
const account = makeAccount({
|
||||
revisionDate: Date.now() - 60_000,
|
||||
tiers: [
|
||||
{
|
||||
leagueId: 'L1',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'GOLD',
|
||||
rank: 'II',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 10,
|
||||
wins: 20,
|
||||
losses: 12,
|
||||
fetchedAt: recent,
|
||||
},
|
||||
],
|
||||
tierHistory: [
|
||||
{
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'GOLD',
|
||||
rank: 'II',
|
||||
leaguePoints: 10,
|
||||
wins: 20,
|
||||
losses: 12,
|
||||
recordedAt: recent,
|
||||
},
|
||||
],
|
||||
recentStatsFetchedAt: recent,
|
||||
recentStatsSummary: createEmptyRiotRecentStatsSummary(),
|
||||
});
|
||||
const user = makeUser(account);
|
||||
const { service } = makeService({
|
||||
user,
|
||||
league: {
|
||||
getEntriesByPuuid: jest.fn().mockResolvedValue([
|
||||
{
|
||||
leagueId: 'L1',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'GOLD',
|
||||
rank: 'II',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 44,
|
||||
wins: 21,
|
||||
losses: 12,
|
||||
},
|
||||
]),
|
||||
} as Partial<RiotLeagueService>,
|
||||
});
|
||||
|
||||
await service.refreshLeagueEntries({
|
||||
userId: user._id,
|
||||
puuid: 'puuid-1',
|
||||
platform: 'kr',
|
||||
});
|
||||
|
||||
expect(account.tierHistory).toHaveLength(2);
|
||||
expect(account.tierHistory.at(-1)).toMatchObject({
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'GOLD',
|
||||
rank: 'II',
|
||||
leaguePoints: 44,
|
||||
wins: 21,
|
||||
losses: 12,
|
||||
});
|
||||
});
|
||||
|
||||
it('syncs refreshed league tier into active match participant snapshots', async () => {
|
||||
const recent = new Date(Date.now() - 60_000);
|
||||
const account = makeAccount({
|
||||
revisionDate: Date.now() - 60_000,
|
||||
tiers: [
|
||||
{
|
||||
leagueId: 'L1',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'GOLD',
|
||||
rank: 'II',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 1,
|
||||
wins: 1,
|
||||
losses: 1,
|
||||
fetchedAt: recent,
|
||||
},
|
||||
],
|
||||
recentStatsFetchedAt: recent,
|
||||
recentStatsSummary: createEmptyRiotRecentStatsSummary(),
|
||||
});
|
||||
const user = makeUser(account);
|
||||
const { service, matchModel } = makeService({
|
||||
user,
|
||||
league: {
|
||||
getEntriesByPuuid: jest.fn().mockResolvedValue([
|
||||
{
|
||||
leagueId: 'L2',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'PLATINUM',
|
||||
rank: 'IV',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 20,
|
||||
wins: 10,
|
||||
losses: 8,
|
||||
},
|
||||
]),
|
||||
} as Partial<RiotLeagueService>,
|
||||
});
|
||||
|
||||
await service.refreshLeagueEntries({
|
||||
userId: user._id,
|
||||
puuid: 'puuid-1',
|
||||
platform: 'kr',
|
||||
});
|
||||
|
||||
expect(matchModel.updateMany).toHaveBeenCalledWith(
|
||||
{
|
||||
status: { $in: ['recruiting', 'team-built', 'in-progress'] },
|
||||
participants: {
|
||||
$elemMatch: {
|
||||
userId: user._id,
|
||||
puuid: 'puuid-1',
|
||||
},
|
||||
},
|
||||
},
|
||||
{
|
||||
$set: {
|
||||
'participants.$[participant].tier': expect.objectContaining({
|
||||
leagueId: 'L2',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'PLATINUM',
|
||||
rank: 'IV',
|
||||
leaguePoints: 20,
|
||||
}),
|
||||
},
|
||||
},
|
||||
{
|
||||
arrayFilters: [
|
||||
{
|
||||
'participant.userId': user._id,
|
||||
'participant.puuid': 'puuid-1',
|
||||
},
|
||||
],
|
||||
},
|
||||
);
|
||||
});
|
||||
|
||||
it('clears active match participant tier when refreshed league entries are empty', async () => {
|
||||
const recent = new Date(Date.now() - 60_000);
|
||||
const account = makeAccount({
|
||||
revisionDate: Date.now() - 60_000,
|
||||
tiers: [
|
||||
{
|
||||
leagueId: 'L1',
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'GOLD',
|
||||
rank: 'II',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 1,
|
||||
wins: 1,
|
||||
losses: 1,
|
||||
fetchedAt: recent,
|
||||
},
|
||||
],
|
||||
recentStatsFetchedAt: recent,
|
||||
recentStatsSummary: createEmptyRiotRecentStatsSummary(),
|
||||
});
|
||||
const user = makeUser(account);
|
||||
const { service, matchModel } = makeService({
|
||||
user,
|
||||
league: {
|
||||
getEntriesByPuuid: jest.fn().mockResolvedValue([]),
|
||||
} as Partial<RiotLeagueService>,
|
||||
});
|
||||
|
||||
await service.refreshLeagueEntries({
|
||||
userId: user._id,
|
||||
puuid: 'puuid-1',
|
||||
platform: 'kr',
|
||||
});
|
||||
|
||||
expect(matchModel.updateMany).toHaveBeenCalledWith(
|
||||
{
|
||||
status: { $in: ['recruiting', 'team-built', 'in-progress'] },
|
||||
participants: {
|
||||
$elemMatch: {
|
||||
userId: user._id,
|
||||
puuid: 'puuid-1',
|
||||
},
|
||||
},
|
||||
},
|
||||
{ $unset: { 'participants.$[participant].tier': '' } },
|
||||
{
|
||||
arrayFilters: [
|
||||
{
|
||||
'participant.userId': user._id,
|
||||
'participant.puuid': 'puuid-1',
|
||||
},
|
||||
],
|
||||
},
|
||||
);
|
||||
});
|
||||
|
||||
it('records failed for individual failing fetches but updates the rest', async () => {
|
||||
const account = makeAccount();
|
||||
const user = makeUser(account);
|
||||
|
||||
@@ -3,6 +3,7 @@ import mongoose from 'mongoose';
|
||||
import { ConnectionService } from '../global/database/connection.service';
|
||||
import {
|
||||
ChampionMasteryEntry,
|
||||
MatchStatus,
|
||||
RiotAccount,
|
||||
TierInfo,
|
||||
} from '../global/database/schema';
|
||||
@@ -33,6 +34,11 @@ const DEFAULT_SUMMONER_TTL_MS = 24 * 60 * 60 * 1000; // 24h
|
||||
const DEFAULT_LEAGUE_TTL_MS = 60 * 60 * 1000; // 1h
|
||||
const DEFAULT_MASTERY_TTL_MS = 6 * 60 * 60 * 1000; // 6h
|
||||
const DEFAULT_RECENT_MATCHES_TTL_MS = 6 * 60 * 60 * 1000; // 6h
|
||||
const ACTIVE_MATCH_STATUSES: MatchStatus[] = [
|
||||
'recruiting',
|
||||
'team-built',
|
||||
'in-progress',
|
||||
];
|
||||
|
||||
export interface EnrichOptions {
|
||||
platform?: RiotPlatformRoute;
|
||||
@@ -52,6 +58,8 @@ export interface EnrichResult {
|
||||
account: RiotAccount | null;
|
||||
}
|
||||
|
||||
export type RefreshLeagueEntriesResult = 'updated' | 'failed';
|
||||
|
||||
@Injectable()
|
||||
export class RiotAccountEnrichmentService {
|
||||
private readonly logger = new Logger(RiotAccountEnrichmentService.name);
|
||||
@@ -95,6 +103,34 @@ export class RiotAccountEnrichmentService {
|
||||
return promise;
|
||||
}
|
||||
|
||||
public async refreshLeagueEntries(params: {
|
||||
userId: mongoose.Types.ObjectId;
|
||||
puuid: string;
|
||||
platform?: RiotPlatformRoute;
|
||||
}): Promise<RefreshLeagueEntriesResult> {
|
||||
const UserModel = await this.connectionService.getModel('user');
|
||||
const user = await UserModel.findById(params.userId).exec();
|
||||
if (!user) return 'failed';
|
||||
|
||||
const account = user.riotAccounts.find((a) => a.puuid === params.puuid);
|
||||
if (!account) return 'failed';
|
||||
|
||||
const outcome = await this.fetchLeagueSafe(
|
||||
params.puuid,
|
||||
params.platform ?? DEFAULT_PLATFORM,
|
||||
);
|
||||
if (outcome.status !== 'updated' || !outcome.dto) return 'failed';
|
||||
|
||||
this.applyLeagueEntries(account, outcome.dto);
|
||||
await user.save();
|
||||
await this.syncActiveMatchParticipantTier(
|
||||
user._id,
|
||||
params.puuid,
|
||||
account.tiers,
|
||||
);
|
||||
return 'updated';
|
||||
}
|
||||
|
||||
private async doEnrichRiotAccount(params: {
|
||||
userId: mongoose.Types.ObjectId;
|
||||
puuid: string;
|
||||
@@ -218,6 +254,13 @@ export class RiotAccountEnrichmentService {
|
||||
) {
|
||||
await user.save();
|
||||
}
|
||||
if (leagueOutcome.status === 'updated') {
|
||||
await this.syncActiveMatchParticipantTier(
|
||||
user._id,
|
||||
params.puuid,
|
||||
account.tiers,
|
||||
);
|
||||
}
|
||||
|
||||
return {
|
||||
summoner: summonerOutcome.status,
|
||||
@@ -400,7 +443,10 @@ export class RiotAccountEnrichmentService {
|
||||
const changed =
|
||||
!last ||
|
||||
last.tier !== entry.tier ||
|
||||
(last.rank ?? '') !== (entry.rank ?? '');
|
||||
(last.rank ?? '') !== (entry.rank ?? '') ||
|
||||
last.leaguePoints !== entry.leaguePoints ||
|
||||
last.wins !== entry.wins ||
|
||||
last.losses !== entry.losses;
|
||||
if (!changed) continue;
|
||||
|
||||
account.tierHistory.push({
|
||||
@@ -438,6 +484,62 @@ export class RiotAccountEnrichmentService {
|
||||
account.matchIdsFetchedAt = fetchedAt;
|
||||
}
|
||||
|
||||
private async syncActiveMatchParticipantTier(
|
||||
userId: mongoose.Types.ObjectId,
|
||||
puuid: string,
|
||||
tiers: TierInfo[],
|
||||
): Promise<void> {
|
||||
const MatchModel = await this.connectionService.getModel('match');
|
||||
const tier = this.selectParticipantTier(tiers);
|
||||
const update = tier
|
||||
? { $set: { 'participants.$[participant].tier': tier } }
|
||||
: { $unset: { 'participants.$[participant].tier': '' } };
|
||||
|
||||
await MatchModel.updateMany(
|
||||
{
|
||||
status: { $in: ACTIVE_MATCH_STATUSES },
|
||||
participants: {
|
||||
$elemMatch: {
|
||||
userId,
|
||||
puuid,
|
||||
},
|
||||
},
|
||||
},
|
||||
update,
|
||||
{
|
||||
arrayFilters: [
|
||||
{
|
||||
'participant.userId': userId,
|
||||
'participant.puuid': puuid,
|
||||
},
|
||||
],
|
||||
},
|
||||
).exec();
|
||||
}
|
||||
|
||||
private selectParticipantTier(tiers: TierInfo[]): TierInfo | undefined {
|
||||
const tier =
|
||||
tiers.find((entry) => entry.queueType === 'RANKED_SOLO_5x5') ?? tiers[0];
|
||||
if (!tier) return undefined;
|
||||
|
||||
return {
|
||||
leagueId: tier.leagueId,
|
||||
queueType: tier.queueType,
|
||||
tier: tier.tier,
|
||||
rank: tier.rank,
|
||||
puuid: tier.puuid,
|
||||
leaguePoints: tier.leaguePoints,
|
||||
wins: tier.wins,
|
||||
losses: tier.losses,
|
||||
veteran: tier.veteran,
|
||||
inactive: tier.inactive,
|
||||
freshBlood: tier.freshBlood,
|
||||
hotStreak: tier.hotStreak,
|
||||
miniSeries: tier.miniSeries,
|
||||
fetchedAt: tier.fetchedAt,
|
||||
};
|
||||
}
|
||||
|
||||
private tiersOldestAt(tiers: TierInfo[]): number {
|
||||
if (tiers.length === 0) return 0;
|
||||
let oldest = Infinity;
|
||||
|
||||
@@ -0,0 +1,47 @@
|
||||
import { RiotClientService } from './riot.client.service';
|
||||
import { RiotLeagueService } from './riot-league.service';
|
||||
import type { RiotLeagueEntryDto, RiotResponseParser } from './riot.types';
|
||||
|
||||
describe('RiotLeagueService', () => {
|
||||
it('accepts Riot league entries without optional leagueId', async () => {
|
||||
const client = {
|
||||
get: jest.fn(
|
||||
async <T>(
|
||||
_path: string,
|
||||
_options: unknown,
|
||||
parser?: RiotResponseParser<T>,
|
||||
) =>
|
||||
parser
|
||||
? parser([
|
||||
{
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'EMERALD',
|
||||
rank: 'I',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 75,
|
||||
wins: 160,
|
||||
losses: 148,
|
||||
},
|
||||
])
|
||||
: ([] as T),
|
||||
),
|
||||
} as unknown as RiotClientService;
|
||||
const service = new RiotLeagueService(client);
|
||||
|
||||
const result = await service.getEntriesByPuuid('puuid-1', {
|
||||
platform: 'kr',
|
||||
});
|
||||
|
||||
expect(result).toEqual<RiotLeagueEntryDto[]>([
|
||||
{
|
||||
queueType: 'RANKED_SOLO_5x5',
|
||||
tier: 'EMERALD',
|
||||
rank: 'I',
|
||||
puuid: 'puuid-1',
|
||||
leaguePoints: 75,
|
||||
wins: 160,
|
||||
losses: 148,
|
||||
},
|
||||
]);
|
||||
});
|
||||
});
|
||||
@@ -36,7 +36,10 @@ function parseEntry(value: unknown, index: number): RiotLeagueEntryDto {
|
||||
throw new TypeError(`leagueEntries[${index}] must be an object.`);
|
||||
}
|
||||
return {
|
||||
leagueId: requireString(value.leagueId, `leagueEntries[${index}].leagueId`),
|
||||
leagueId: optionalString(
|
||||
value.leagueId,
|
||||
`leagueEntries[${index}].leagueId`,
|
||||
),
|
||||
queueType: requireString(
|
||||
value.queueType,
|
||||
`leagueEntries[${index}].queueType`,
|
||||
@@ -71,6 +74,11 @@ function requireString(value: unknown, path: string): string {
|
||||
return value;
|
||||
}
|
||||
|
||||
function optionalString(value: unknown, path: string): string | undefined {
|
||||
if (value === undefined || value === null) return undefined;
|
||||
return requireString(value, path);
|
||||
}
|
||||
|
||||
function requireNumber(value: unknown, path: string): number {
|
||||
if (typeof value !== 'number' || !Number.isFinite(value)) {
|
||||
throw new TypeError(`${path} must be a finite number.`);
|
||||
|
||||
@@ -3,63 +3,156 @@ import { RiotRateLimiterService } from './riot-rate-limiter.service';
|
||||
|
||||
function makeService(sendCommand = jest.fn().mockResolvedValue(0)) {
|
||||
const garnet = {
|
||||
getString: jest.fn().mockResolvedValue(null),
|
||||
raw: jest.fn().mockReturnValue({ sendCommand }),
|
||||
} as unknown as GarnetService;
|
||||
setString: jest.fn().mockResolvedValue(undefined),
|
||||
} as unknown as jest.Mocked<GarnetService>;
|
||||
return {
|
||||
service: new RiotRateLimiterService(garnet),
|
||||
garnet,
|
||||
sendCommand,
|
||||
};
|
||||
}
|
||||
|
||||
describe('RiotRateLimiterService background limiter', () => {
|
||||
function observedState(params: {
|
||||
count120: number;
|
||||
limit120?: number;
|
||||
observedAt: number;
|
||||
windowStartAt: number;
|
||||
}) {
|
||||
return JSON.stringify({
|
||||
count120: params.count120,
|
||||
limit120: params.limit120 ?? 100,
|
||||
observedAt: params.observedAt,
|
||||
windowStartAt: params.windowStartAt,
|
||||
});
|
||||
}
|
||||
|
||||
describe('RiotRateLimiterService', () => {
|
||||
afterEach(() => {
|
||||
jest.restoreAllMocks();
|
||||
});
|
||||
|
||||
it('uses the background key namespace and passes cost to the Lua script', async () => {
|
||||
it('uses global app rate keys and passes cost to the Lua script', async () => {
|
||||
jest.spyOn(Date, 'now').mockReturnValue(1_000);
|
||||
const { service, sendCommand } = makeService();
|
||||
|
||||
await service.acquireBackground(8);
|
||||
await service.acquire('asia', 3);
|
||||
|
||||
expect(sendCommand).toHaveBeenCalledTimes(1);
|
||||
const command = sendCommand.mock.calls[0][0] as string[];
|
||||
expect(command[0]).toBe('EVAL');
|
||||
expect(command[2]).toBe('2');
|
||||
expect(command[3]).toBe('riot:bg:rl:1000');
|
||||
expect(command[4]).toBe('riot:bg:rl:120000');
|
||||
expect(command[3]).toBe('riot:rl:app:1000');
|
||||
expect(command[4]).toBe('riot:rl:app:120000');
|
||||
expect(command[5]).toBe('1000');
|
||||
expect(command[7]).toBe('8');
|
||||
expect(command[7]).toBe('3');
|
||||
});
|
||||
|
||||
it('reads cleaned background usage for both windows', async () => {
|
||||
jest.spyOn(Date, 'now').mockReturnValue(200_000);
|
||||
const sendCommand = jest
|
||||
.fn()
|
||||
.mockImplementation(async (command: string[]) => {
|
||||
if (command[0] === 'ZREMRANGEBYSCORE') return 0;
|
||||
if (command[1] === 'riot:bg:rl:1000') return 3;
|
||||
if (command[1] === 'riot:bg:rl:120000') return 24;
|
||||
return 0;
|
||||
});
|
||||
const { service } = makeService(sendCommand);
|
||||
it('records the 120 second app rate observation from Riot headers', async () => {
|
||||
jest.spyOn(Date, 'now').mockReturnValue(1_000_000);
|
||||
const { service, garnet } = makeService();
|
||||
|
||||
await expect(service.getBackgroundUsage()).resolves.toEqual({
|
||||
used1s: 3,
|
||||
used2m: 24,
|
||||
await service.recordAppRateLimitObservation('47:120,3:1', '100:120,20:1');
|
||||
|
||||
expect(garnet.setString).toHaveBeenCalledTimes(1);
|
||||
const [key, raw, ttl] = garnet.setString.mock.calls[0];
|
||||
expect(key).toBe('riot:app:rl:observed');
|
||||
expect(ttl).toBe(300);
|
||||
expect(JSON.parse(raw)).toEqual({
|
||||
count120: 47,
|
||||
limit120: 100,
|
||||
observedAt: 1_000_000,
|
||||
windowStartAt: 1_000_000,
|
||||
});
|
||||
});
|
||||
|
||||
it('resets the inferred window when Riot count decreases or observation is stale', async () => {
|
||||
const { service, garnet } = makeService();
|
||||
|
||||
jest.spyOn(Date, 'now').mockReturnValue(1_060_000);
|
||||
garnet.getString.mockResolvedValueOnce(
|
||||
observedState({
|
||||
count120: 80,
|
||||
observedAt: 1_050_000,
|
||||
windowStartAt: 1_000_000,
|
||||
}),
|
||||
);
|
||||
|
||||
await service.recordAppRateLimitObservation('2:120', null);
|
||||
|
||||
expect(JSON.parse(garnet.setString.mock.calls[0][1])).toMatchObject({
|
||||
count120: 2,
|
||||
windowStartAt: 1_060_000,
|
||||
});
|
||||
|
||||
expect(sendCommand).toHaveBeenCalledWith([
|
||||
'ZREMRANGEBYSCORE',
|
||||
'riot:bg:rl:1000',
|
||||
'-inf',
|
||||
'199000',
|
||||
]);
|
||||
expect(sendCommand).toHaveBeenCalledWith([
|
||||
'ZREMRANGEBYSCORE',
|
||||
'riot:bg:rl:120000',
|
||||
'-inf',
|
||||
'80000',
|
||||
]);
|
||||
jest.spyOn(Date, 'now').mockReturnValue(1_240_000);
|
||||
garnet.getString.mockResolvedValueOnce(
|
||||
observedState({
|
||||
count120: 20,
|
||||
observedAt: 1_120_000,
|
||||
windowStartAt: 1_000_000,
|
||||
}),
|
||||
);
|
||||
|
||||
await service.recordAppRateLimitObservation('25:120', null);
|
||||
|
||||
expect(JSON.parse(garnet.setString.mock.calls[1][1])).toMatchObject({
|
||||
count120: 25,
|
||||
windowStartAt: 1_240_000,
|
||||
});
|
||||
});
|
||||
|
||||
it('opens the refresh gate when there is no active observation', async () => {
|
||||
const { service, garnet } = makeService();
|
||||
|
||||
await expect(service.isRefreshWindowOpen(0.5)).resolves.toBe(true);
|
||||
|
||||
garnet.getString.mockResolvedValueOnce(
|
||||
observedState({
|
||||
count120: 90,
|
||||
observedAt: 1_000_000,
|
||||
windowStartAt: 900_000,
|
||||
}),
|
||||
);
|
||||
jest.spyOn(Date, 'now').mockReturnValue(1_120_000);
|
||||
|
||||
await expect(service.isRefreshWindowOpen(0.5)).resolves.toBe(true);
|
||||
});
|
||||
|
||||
it.each([
|
||||
{ ratio: 0.5, count120: 49, expected: true },
|
||||
{ ratio: 0.5, count120: 50, expected: false },
|
||||
{ ratio: 0.8, count120: 79, expected: true },
|
||||
{ ratio: 0.8, count120: 80, expected: false },
|
||||
])(
|
||||
'checks tail headroom for refresh gate ratio=$ratio count=$count120',
|
||||
async ({ ratio, count120, expected }) => {
|
||||
jest.spyOn(Date, 'now').mockReturnValue(1_070_000);
|
||||
const { service, garnet } = makeService();
|
||||
garnet.getString.mockResolvedValue(
|
||||
observedState({
|
||||
count120,
|
||||
observedAt: 1_069_000,
|
||||
windowStartAt: 1_000_000,
|
||||
}),
|
||||
);
|
||||
|
||||
await expect(service.isRefreshWindowOpen(ratio)).resolves.toBe(expected);
|
||||
},
|
||||
);
|
||||
|
||||
it('keeps the refresh gate closed before the 120 second window tail', async () => {
|
||||
jest.spyOn(Date, 'now').mockReturnValue(1_050_000);
|
||||
const { service, garnet } = makeService();
|
||||
garnet.getString.mockResolvedValue(
|
||||
observedState({
|
||||
count120: 10,
|
||||
observedAt: 1_049_000,
|
||||
windowStartAt: 1_000_000,
|
||||
}),
|
||||
);
|
||||
|
||||
await expect(service.isRefreshWindowOpen(0.8)).resolves.toBe(false);
|
||||
});
|
||||
});
|
||||
@@ -7,11 +7,19 @@ const APP_LIMITS = [
|
||||
{ windowMs: 120_000, max: 90 },
|
||||
] as const;
|
||||
|
||||
const BACKGROUND_LIMITS = [
|
||||
{ windowMs: 1_000, max: 6 },
|
||||
{ windowMs: 120_000, max: 36 },
|
||||
] as const;
|
||||
const BACKGROUND_KEY_PREFIX = 'riot:bg:rl';
|
||||
const APP_KEY_PREFIX = 'riot:rl:app';
|
||||
const APP_WINDOW_MS = 120_000;
|
||||
const TAIL_MS = 60_000;
|
||||
const APP_OBSERVED_KEY = 'riot:app:rl:observed';
|
||||
const APP_OBSERVED_TTL_SECONDS = 300;
|
||||
const DEFAULT_APP_LIMIT_120 = 100;
|
||||
|
||||
interface AppRateObservation {
|
||||
count120: number;
|
||||
limit120: number;
|
||||
observedAt: number;
|
||||
windowStartAt: number;
|
||||
}
|
||||
|
||||
const ACQUIRE_SCRIPT = `
|
||||
local now = tonumber(ARGV[1])
|
||||
@@ -81,85 +89,78 @@ export class RiotRateLimiterService {
|
||||
|
||||
public async acquire(
|
||||
route: RiotRegionalRoute | RiotPlatformRoute,
|
||||
cost = 1,
|
||||
): Promise<void> {
|
||||
for (;;) {
|
||||
const now = Date.now();
|
||||
const waitMs = await this.checkAndAdd(route, now, 1);
|
||||
if (waitMs <= 0) return;
|
||||
|
||||
if (waitMs >= 100) {
|
||||
this.logger.warn(
|
||||
`Riot API throttle waiting ${waitMs}ms for route=${route}.`,
|
||||
);
|
||||
}
|
||||
await sleep(waitMs);
|
||||
}
|
||||
}
|
||||
|
||||
public async acquireBackground(cost = 1): Promise<void> {
|
||||
const normalizedCost = normalizeCost(cost);
|
||||
for (;;) {
|
||||
const now = Date.now();
|
||||
const waitMs = await this.checkAndAddBackground(now, normalizedCost);
|
||||
const waitMs = await this.checkAndAdd(now, normalizedCost);
|
||||
if (waitMs <= 0) return;
|
||||
|
||||
if (waitMs >= 100) {
|
||||
this.logger.warn(
|
||||
`Background Riot throttle waiting ${waitMs}ms (cost=${normalizedCost}).`,
|
||||
`Riot API throttle waiting ${waitMs}ms for route=${route} cost=${normalizedCost}.`,
|
||||
);
|
||||
}
|
||||
await sleep(waitMs);
|
||||
}
|
||||
}
|
||||
|
||||
public async getBackgroundUsage(): Promise<{
|
||||
used1s: number;
|
||||
used2m: number;
|
||||
}> {
|
||||
const client = this.garnet.raw();
|
||||
const now = Date.now();
|
||||
const usages = await Promise.all(
|
||||
BACKGROUND_LIMITS.map(async (limit) => {
|
||||
const key = `${BACKGROUND_KEY_PREFIX}:${limit.windowMs}`;
|
||||
await client.sendCommand([
|
||||
'ZREMRANGEBYSCORE',
|
||||
key,
|
||||
'-inf',
|
||||
String(now - limit.windowMs),
|
||||
]);
|
||||
const response = await client.sendCommand(['ZCARD', key]);
|
||||
const count = Number(response ?? 0);
|
||||
return Number.isFinite(count) && count > 0 ? count : 0;
|
||||
}),
|
||||
);
|
||||
public async recordAppRateLimitObservation(
|
||||
countHeader: string | null,
|
||||
limitHeader?: string | null,
|
||||
): Promise<void> {
|
||||
const count120 = parseRateLimitHeader(countHeader, 120);
|
||||
if (count120 === null) return;
|
||||
|
||||
return {
|
||||
used1s: usages[0] ?? 0,
|
||||
used2m: usages[1] ?? 0,
|
||||
const limit120 =
|
||||
parseRateLimitHeader(limitHeader ?? null, 120) ?? DEFAULT_APP_LIMIT_120;
|
||||
const now = Date.now();
|
||||
const previous = await this.getAppRateObservation();
|
||||
const windowStartAt =
|
||||
!previous ||
|
||||
now - previous.observedAt >= APP_WINDOW_MS ||
|
||||
count120 < previous.count120
|
||||
? now
|
||||
: previous.windowStartAt;
|
||||
|
||||
const observation: AppRateObservation = {
|
||||
count120,
|
||||
limit120,
|
||||
observedAt: now,
|
||||
windowStartAt,
|
||||
};
|
||||
|
||||
// Concurrent responses can race here. This observation is advisory, so
|
||||
// last-writer-wins is acceptable and self-corrects on the next Riot header.
|
||||
await this.garnet.setString(
|
||||
APP_OBSERVED_KEY,
|
||||
JSON.stringify(observation),
|
||||
APP_OBSERVED_TTL_SECONDS,
|
||||
);
|
||||
}
|
||||
|
||||
private async checkAndAdd(
|
||||
route: RiotRegionalRoute | RiotPlatformRoute,
|
||||
now: number,
|
||||
cost: number,
|
||||
): Promise<number> {
|
||||
public async isRefreshWindowOpen(
|
||||
usageRatio: number,
|
||||
now = Date.now(),
|
||||
): Promise<boolean> {
|
||||
const observation = await this.getAppRateObservation();
|
||||
if (!observation) return true;
|
||||
if (now - observation.observedAt >= APP_WINDOW_MS) return true;
|
||||
|
||||
const ratio = Number.isFinite(usageRatio) ? usageRatio : 0;
|
||||
const headroomOk = observation.count120 < observation.limit120 * ratio;
|
||||
const inTail = now >= observation.windowStartAt + APP_WINDOW_MS - TAIL_MS;
|
||||
return headroomOk && inTail;
|
||||
}
|
||||
|
||||
private async checkAndAdd(now: number, cost: number): Promise<number> {
|
||||
const keys = APP_LIMITS.map(
|
||||
(limit) => `riot:rl:${route}:${limit.windowMs}`,
|
||||
(limit) => `${APP_KEY_PREFIX}:${limit.windowMs}`,
|
||||
);
|
||||
return this.checkAndAddWithLimits(keys, APP_LIMITS, now, cost);
|
||||
}
|
||||
|
||||
private async checkAndAddBackground(
|
||||
now: number,
|
||||
cost: number,
|
||||
): Promise<number> {
|
||||
const keys = BACKGROUND_LIMITS.map(
|
||||
(limit) => `${BACKGROUND_KEY_PREFIX}:${limit.windowMs}`,
|
||||
);
|
||||
return this.checkAndAddWithLimits(keys, BACKGROUND_LIMITS, now, cost);
|
||||
}
|
||||
|
||||
private async checkAndAddWithLimits(
|
||||
keys: string[],
|
||||
limits: ReadonlyArray<{ windowMs: number; max: number }>,
|
||||
@@ -187,6 +188,32 @@ export class RiotRateLimiterService {
|
||||
if (!Number.isFinite(waitMs) || waitMs < 0) return 0;
|
||||
return waitMs;
|
||||
}
|
||||
|
||||
private async getAppRateObservation(): Promise<AppRateObservation | null> {
|
||||
const raw = await this.garnet.getString(APP_OBSERVED_KEY);
|
||||
if (!raw) return null;
|
||||
|
||||
try {
|
||||
const parsed = JSON.parse(raw) as Partial<AppRateObservation>;
|
||||
if (
|
||||
typeof parsed.count120 !== 'number' ||
|
||||
typeof parsed.limit120 !== 'number' ||
|
||||
typeof parsed.observedAt !== 'number' ||
|
||||
typeof parsed.windowStartAt !== 'number'
|
||||
) {
|
||||
return null;
|
||||
}
|
||||
|
||||
return {
|
||||
count120: parsed.count120,
|
||||
limit120: parsed.limit120,
|
||||
observedAt: parsed.observedAt,
|
||||
windowStartAt: parsed.windowStartAt,
|
||||
};
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function normalizeCost(cost: number): number {
|
||||
@@ -194,6 +221,24 @@ function normalizeCost(cost: number): number {
|
||||
return Math.max(1, Math.floor(cost));
|
||||
}
|
||||
|
||||
function parseRateLimitHeader(
|
||||
header: string | null,
|
||||
windowSeconds: number,
|
||||
): number | null {
|
||||
if (!header) return null;
|
||||
|
||||
for (const rawEntry of header.split(',')) {
|
||||
const [rawCount, rawWindow] = rawEntry.trim().split(':');
|
||||
const count = Number(rawCount);
|
||||
const window = Number(rawWindow);
|
||||
if (window === windowSeconds && Number.isFinite(count) && count >= 0) {
|
||||
return count;
|
||||
}
|
||||
}
|
||||
|
||||
return null;
|
||||
}
|
||||
|
||||
function sleep(ms: number): Promise<void> {
|
||||
return new Promise((resolve) => setTimeout(resolve, ms));
|
||||
}
|
||||
@@ -0,0 +1,43 @@
|
||||
import { SecretService } from '../global/secret/secret.service';
|
||||
import { RiotClientService } from './riot.client.service';
|
||||
import { RiotRateLimiterService } from './riot-rate-limiter.service';
|
||||
|
||||
describe('RiotClientService', () => {
|
||||
const originalFetch = global.fetch;
|
||||
|
||||
afterEach(() => {
|
||||
global.fetch = originalFetch;
|
||||
jest.restoreAllMocks();
|
||||
});
|
||||
|
||||
it('records Riot app rate limit headers after a response', async () => {
|
||||
const secretService = {
|
||||
get: jest.fn().mockResolvedValue('riot-key'),
|
||||
} as unknown as jest.Mocked<SecretService>;
|
||||
const rateLimiter = {
|
||||
acquire: jest.fn().mockResolvedValue(undefined),
|
||||
recordAppRateLimitObservation: jest.fn().mockResolvedValue(undefined),
|
||||
} as unknown as jest.Mocked<RiotRateLimiterService>;
|
||||
global.fetch = jest.fn().mockResolvedValue({
|
||||
headers: {
|
||||
get: jest.fn((name: string) => {
|
||||
if (name === 'X-App-Rate-Limit-Count') return '47:120,3:1';
|
||||
if (name === 'X-App-Rate-Limit') return '100:120,20:1';
|
||||
return null;
|
||||
}),
|
||||
},
|
||||
json: jest.fn().mockResolvedValue({ ok: true }),
|
||||
ok: true,
|
||||
status: 200,
|
||||
} as unknown as Response);
|
||||
const service = new RiotClientService(secretService, rateLimiter);
|
||||
|
||||
await service.get('/lol/status/v4/platform-data', { platform: 'kr' });
|
||||
|
||||
expect(rateLimiter.acquire).toHaveBeenCalledWith('kr');
|
||||
expect(rateLimiter.recordAppRateLimitObservation).toHaveBeenCalledWith(
|
||||
'47:120,3:1',
|
||||
'100:120,20:1',
|
||||
);
|
||||
});
|
||||
});
|
||||
@@ -140,16 +140,18 @@ export class RiotClientService {
|
||||
});
|
||||
|
||||
const appRateLimitCount = response.headers.get('X-App-Rate-Limit-Count');
|
||||
const appRateLimit = response.headers.get('X-App-Rate-Limit');
|
||||
void this.rateLimiter.recordAppRateLimitObservation(
|
||||
appRateLimitCount,
|
||||
appRateLimit,
|
||||
);
|
||||
if (appRateLimitCount && Math.random() < 0.05) {
|
||||
this.logger.debug(`Riot rate usage ${routeKey}: ${appRateLimitCount}`);
|
||||
}
|
||||
|
||||
if (!response.ok) {
|
||||
const error = await this.createApiError(response, url);
|
||||
if (
|
||||
error.status === 429 &&
|
||||
attempt === 0
|
||||
) {
|
||||
if (error.status === 429 && attempt === 0) {
|
||||
await sleep((error.retryAfterSeconds ?? 1) * 1000);
|
||||
return this.fetchWithRetry(
|
||||
url,
|
||||
|
||||
@@ -89,7 +89,7 @@ export interface RiotSummonerDto {
|
||||
|
||||
// League-V4 entries by-puuid 응답
|
||||
export interface RiotLeagueEntryDto {
|
||||
leagueId: string;
|
||||
leagueId?: string;
|
||||
queueType: string;
|
||||
tier: string;
|
||||
rank: string;
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
VITE_API_BASE_URL=https://lolympus-test-api.dahyeon.us
|
||||
VITE_API_BASE_URL=https://lolympus-api-staging.dahyeon.us
|
||||
VITE_DEFAULT_COMMUNITY_ID=69ebe0adf627c11be2f020a1
|
||||
VITE_MSAL_CLIENT_ID=15fb5a20-47e0-44fa-9a41-b50ca9d0e7e3
|
||||
VITE_MSAL_AUTHORITY=https://login.microsoftonline.com/5ef88004-e953-4b04-93db-64bbf49c6863
|
||||
@@ -5,10 +5,12 @@
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"dev": "vite",
|
||||
"start:dev": "vite --mode development",
|
||||
"start:staging": "vite --mode staging",
|
||||
"build": "tsc -b && vite build",
|
||||
"build:test": "tsc -b && vite build --mode test",
|
||||
"build:staging": "tsc -b && vite build --mode staging",
|
||||
"build:prod": "tsc -b && vite build --mode production",
|
||||
"deploy:test": "node ../../scripts/deploy-cloudflare-pages.mjs test",
|
||||
"deploy:staging": "node ../../scripts/deploy-cloudflare-pages.mjs staging",
|
||||
"deploy:prod": "node ../../scripts/deploy-cloudflare-pages.mjs prod",
|
||||
"pages:login": "wrangler login",
|
||||
"pages:whoami": "wrangler whoami",
|
||||
@@ -23,6 +25,7 @@
|
||||
"react": "^19.2.4",
|
||||
"react-dom": "^19.2.4",
|
||||
"react-router": "^7.14.0",
|
||||
"recharts": "^3.8.1",
|
||||
"socket.io-client": "^4.8.3"
|
||||
},
|
||||
"devDependencies": {
|
||||
|
||||
+22
-22
@@ -1,22 +1,22 @@
|
||||
import { BrowserRouter, Link, Route, Routes } from 'react-router';
|
||||
import { useMsal } from '@azure/msal-react';
|
||||
import DevAuthSwitcher from './components/DevAuthSwitcher';
|
||||
import { DEFAULT_COMMUNITY_ID } from './config';
|
||||
import { useCommunity } from './api/hooks';
|
||||
import { isMsalConfigured } from './lib/auth/msal.config';
|
||||
import AuthCallbackPage from './pages/AuthCallback';
|
||||
import HomePage from './pages/HomePage';
|
||||
import LoginPage from './pages/Login';
|
||||
import MatchDetailPage from './pages/MatchDetailPage';
|
||||
import MatchTeamProgressPage from './pages/MatchTeamProgressPage';
|
||||
import AuctionPage from './pages/AuctionPage';
|
||||
import UserHistoryPage from './pages/UserHistoryPage';
|
||||
import CommunityInternalStatsPage from './pages/CommunityInternalStatsPage';
|
||||
import InternalMatchDetailPage from './pages/InternalMatchDetailPage';
|
||||
import LegacyImportPage from './pages/admin/LegacyImportPage';
|
||||
import LegacyMatchesPage from './pages/admin/LegacyMatchesPage';
|
||||
import MatchAdminPage from './pages/admin/MatchAdminPage';
|
||||
import TournamentCodesPage from './pages/admin/TournamentCodesPage';
|
||||
import { BrowserRouter, Link, Route, Routes } from "react-router";
|
||||
import { useMsal } from "@azure/msal-react";
|
||||
import DevAuthSwitcher from "./components/DevAuthSwitcher";
|
||||
import { DEFAULT_COMMUNITY_ID } from "./config";
|
||||
import { useCommunity } from "./api/hooks";
|
||||
import { isMsalConfigured } from "./lib/auth/msal.config";
|
||||
import AuthCallbackPage from "./pages/AuthCallback";
|
||||
import HomePage from "./pages/HomePage";
|
||||
import LoginPage from "./pages/Login";
|
||||
import MatchDetailPage from "./pages/MatchDetailPage";
|
||||
import MatchTeamProgressPage from "./pages/MatchTeamProgressPage";
|
||||
import AuctionPage from "./pages/AuctionPage";
|
||||
import UserHistoryPage from "./pages/UserHistoryPage";
|
||||
import CommunityInternalStatsPage from "./pages/CommunityInternalStatsPage";
|
||||
import InternalMatchDetailPage from "./pages/InternalMatchDetailPage";
|
||||
import LegacyImportPage from "./pages/admin/LegacyImportPage";
|
||||
import LegacyMatchesPage from "./pages/admin/LegacyMatchesPage";
|
||||
import MatchAdminPage from "./pages/admin/MatchAdminPage";
|
||||
import TournamentCodesPage from "./pages/admin/TournamentCodesPage";
|
||||
|
||||
function MsalHeaderActions() {
|
||||
const { accounts, instance } = useMsal();
|
||||
@@ -43,7 +43,7 @@ function MsalHeaderActions() {
|
||||
|
||||
function App() {
|
||||
const communityQuery = useCommunity(DEFAULT_COMMUNITY_ID);
|
||||
const communityLabel = communityQuery.data?.name ?? 'LOLYMPUS';
|
||||
const communityLabel = communityQuery.data?.name ?? "LOLYMPUS";
|
||||
|
||||
return (
|
||||
<BrowserRouter>
|
||||
@@ -57,7 +57,7 @@ function App() {
|
||||
{communityLabel}
|
||||
</Link>
|
||||
<div className="flex items-center gap-3">
|
||||
{DEFAULT_COMMUNITY_ID ? (
|
||||
{/* {DEFAULT_COMMUNITY_ID ? (
|
||||
<span className="text-[10px] uppercase tracking-wider text-base-content/25">
|
||||
API Live
|
||||
</span>
|
||||
@@ -65,7 +65,7 @@ function App() {
|
||||
<span className="text-[10px] uppercase tracking-wider text-amber-500/70">
|
||||
Set `VITE_DEFAULT_COMMUNITY_ID`
|
||||
</span>
|
||||
)}
|
||||
)} */}
|
||||
{isMsalConfigured && <MsalHeaderActions />}
|
||||
</div>
|
||||
</div>
|
||||
|
||||
@@ -171,6 +171,15 @@ export function useUndoAuction(communityId = DEFAULT_COMMUNITY_ID) {
|
||||
});
|
||||
}
|
||||
|
||||
export function useResetAuction(communityId = DEFAULT_COMMUNITY_ID) {
|
||||
return useMutation({
|
||||
mutationFn: ({ matchId }: { matchId: string }) =>
|
||||
apiFetch<void>(`/communities/${communityId}/matches/${matchId}/auction`, {
|
||||
method: 'DELETE',
|
||||
}),
|
||||
});
|
||||
}
|
||||
|
||||
export function useCreateMatch(communityId = DEFAULT_COMMUNITY_ID) {
|
||||
return useMutation({
|
||||
mutationFn: (body: MatchMutationRequest) =>
|
||||
|
||||
@@ -272,6 +272,14 @@ export interface ApiAuctionBid {
|
||||
timestamp: string;
|
||||
}
|
||||
|
||||
export interface ApiAuctionChatMessage {
|
||||
id: string;
|
||||
userId?: string;
|
||||
displayName: string;
|
||||
message: string;
|
||||
sentAt: string;
|
||||
}
|
||||
|
||||
export interface ApiAuction {
|
||||
_id: string;
|
||||
matchId: string;
|
||||
@@ -290,6 +298,7 @@ export interface ApiAuction {
|
||||
initialPoints: number;
|
||||
topTierThreshold: AuctionTopTierThreshold;
|
||||
manualTopTierUserIds: string[];
|
||||
chatMessages?: ApiAuctionChatMessage[];
|
||||
startedAt?: string;
|
||||
completedAt?: string;
|
||||
createdAt: string;
|
||||
@@ -451,11 +460,23 @@ export interface ApiUserHistoryProfile {
|
||||
profileIconId: number;
|
||||
summonerLevel: number;
|
||||
tiers: ApiTierInfo[];
|
||||
tierHistory: ApiTierHistoryEntry[];
|
||||
season: ApiHistorySeason;
|
||||
seasons: ApiHistorySeason[];
|
||||
lastFetchedAt: string | null;
|
||||
}
|
||||
|
||||
export interface ApiTierHistoryEntry {
|
||||
queueType: string;
|
||||
tier: string;
|
||||
rank?: string;
|
||||
leaguePoints?: number;
|
||||
wins?: number;
|
||||
losses?: number;
|
||||
recordedAt: string;
|
||||
season?: string;
|
||||
}
|
||||
|
||||
export interface ApiChampionStatsRow {
|
||||
championId: number;
|
||||
games: number;
|
||||
|
||||
@@ -2,7 +2,7 @@ import { useEffect, useRef, useState } from 'react';
|
||||
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, Position } from './types';
|
||||
import type { ApiAuction, ApiAuctionChatMessage, Position } from './types';
|
||||
|
||||
type ConnectionStatus =
|
||||
| 'idle'
|
||||
@@ -17,18 +17,47 @@ interface BidPayload {
|
||||
bidderUserId?: string;
|
||||
}
|
||||
|
||||
interface ChatMessagePayload {
|
||||
displayName?: string;
|
||||
message: string;
|
||||
}
|
||||
|
||||
interface ChatHistoryPayload {
|
||||
messages?: ApiAuctionChatMessage[];
|
||||
}
|
||||
|
||||
interface ResetPayload {
|
||||
matchId?: string;
|
||||
}
|
||||
|
||||
const MAX_CHAT_MESSAGES = 200;
|
||||
|
||||
function mergeChatMessages(
|
||||
current: ApiAuctionChatMessage[],
|
||||
incoming: ApiAuctionChatMessage[],
|
||||
) {
|
||||
const byId = new Map(current.map((message) => [message.id, message]));
|
||||
for (const message of incoming) {
|
||||
byId.set(message.id, message);
|
||||
}
|
||||
|
||||
return [...byId.values()]
|
||||
.sort((left, right) => Date.parse(left.sentAt) - Date.parse(right.sentAt))
|
||||
.slice(-MAX_CHAT_MESSAGES);
|
||||
}
|
||||
|
||||
export function useAuctionSocket(matchId: string | undefined) {
|
||||
const authUserId = useAuthUserId();
|
||||
const socketRef = useRef<Socket | null>(null);
|
||||
const [auction, setAuction] = useState<ApiAuction | null>(null);
|
||||
const [chatMessages, setChatMessages] = useState<ApiAuctionChatMessage[]>([]);
|
||||
const [resetAt, setResetAt] = useState<number | null>(null);
|
||||
const [connectionStatus, setConnectionStatus] =
|
||||
useState<ConnectionStatus>('idle');
|
||||
const [error, setError] = useState<string | null>(null);
|
||||
|
||||
useEffect(() => {
|
||||
if (!matchId) {
|
||||
setAuction(null);
|
||||
setConnectionStatus('idle');
|
||||
return;
|
||||
}
|
||||
|
||||
@@ -65,9 +94,28 @@ export function useAuctionSocket(matchId: string | undefined) {
|
||||
|
||||
socket.on('state', (nextAuction: ApiAuction) => {
|
||||
setAuction(nextAuction);
|
||||
if (nextAuction.chatMessages) {
|
||||
setChatMessages(mergeChatMessages([], nextAuction.chatMessages));
|
||||
}
|
||||
setError(null);
|
||||
});
|
||||
|
||||
socket.on('chat-history', (payload: ChatHistoryPayload) => {
|
||||
setChatMessages(mergeChatMessages([], payload.messages ?? []));
|
||||
});
|
||||
|
||||
socket.on('chat-message', (message: ApiAuctionChatMessage) => {
|
||||
setChatMessages((current) => mergeChatMessages(current, [message]));
|
||||
});
|
||||
|
||||
socket.on('reset', (payload: ResetPayload) => {
|
||||
if (payload.matchId && payload.matchId !== matchId) return;
|
||||
setAuction(null);
|
||||
setChatMessages([]);
|
||||
setResetAt(Date.now());
|
||||
setError('경매가 취소되었습니다.');
|
||||
});
|
||||
|
||||
socket.on('error', (payload: { message?: string }) => {
|
||||
setConnectionStatus('error');
|
||||
setError(payload.message ?? '실시간 경매 연결 중 오류가 발생했습니다.');
|
||||
@@ -101,9 +149,16 @@ export function useAuctionSocket(matchId: string | undefined) {
|
||||
socket.emit(eventName, payload);
|
||||
}
|
||||
|
||||
const visibleAuction = auction?.matchId === matchId ? auction : null;
|
||||
const visibleConnectionStatus: ConnectionStatus = matchId
|
||||
? connectionStatus
|
||||
: 'idle';
|
||||
|
||||
return {
|
||||
auction,
|
||||
connectionStatus,
|
||||
auction: visibleAuction,
|
||||
chatMessages: visibleAuction ? chatMessages : [],
|
||||
resetAt,
|
||||
connectionStatus: visibleConnectionStatus,
|
||||
error,
|
||||
placeBid(payload: BidPayload) {
|
||||
emit('bid', payload);
|
||||
@@ -117,5 +172,8 @@ export function useAuctionSocket(matchId: string | undefined) {
|
||||
next() {
|
||||
emit('next', {});
|
||||
},
|
||||
sendChatMessage(payload: ChatMessagePayload) {
|
||||
emit('chat-message', payload);
|
||||
},
|
||||
};
|
||||
}
|
||||
@@ -0,0 +1,382 @@
|
||||
import { useMemo, useState } from "react";
|
||||
import {
|
||||
CartesianGrid,
|
||||
Line,
|
||||
LineChart,
|
||||
ReferenceLine,
|
||||
ResponsiveContainer,
|
||||
Tooltip,
|
||||
XAxis,
|
||||
YAxis,
|
||||
} from "recharts";
|
||||
import type { ApiTierHistoryEntry } from "../api/types";
|
||||
|
||||
const TIER_NAMES: Record<string, string> = {
|
||||
IRON: "아이언",
|
||||
BRONZE: "브론즈",
|
||||
SILVER: "실버",
|
||||
GOLD: "골드",
|
||||
PLATINUM: "플래티넘",
|
||||
EMERALD: "에메랄드",
|
||||
DIAMOND: "다이아몬드",
|
||||
MASTER: "마스터",
|
||||
GRANDMASTER: "그랜드마스터",
|
||||
CHALLENGER: "챌린저",
|
||||
};
|
||||
|
||||
// 낮은 티어 → 높은 티어. 인덱스가 사다리값의 기준이 된다.
|
||||
const TIER_ORDER = [
|
||||
"IRON",
|
||||
"BRONZE",
|
||||
"SILVER",
|
||||
"GOLD",
|
||||
"PLATINUM",
|
||||
"EMERALD",
|
||||
"DIAMOND",
|
||||
"MASTER",
|
||||
"GRANDMASTER",
|
||||
"CHALLENGER",
|
||||
];
|
||||
|
||||
const APEX_TIERS = new Set(["MASTER", "GRANDMASTER", "CHALLENGER"]);
|
||||
|
||||
// 한 티어 = 400, 한 디비전(랭크) = 100, LP는 그대로 더한다.
|
||||
const TIER_SPAN = 400;
|
||||
const RANK_SPAN = 100;
|
||||
|
||||
const RANK_INDEX: Record<string, number> = { IV: 0, III: 1, II: 2, I: 3 };
|
||||
|
||||
const QUEUE_LABELS: Record<string, string> = {
|
||||
RANKED_SOLO_5x5: "솔로랭크",
|
||||
RANKED_FLEX_SR: "자유랭크",
|
||||
};
|
||||
|
||||
type PeriodKey = "30" | "90" | "all";
|
||||
|
||||
const PERIOD_OPTIONS: { key: PeriodKey; label: string; days: number | null }[] =
|
||||
[
|
||||
{ key: "30", label: "최근 30일", days: 30 },
|
||||
{ key: "90", label: "최근 90일", days: 90 },
|
||||
{ key: "all", label: "전체", days: null },
|
||||
];
|
||||
|
||||
function tierIndex(tier: string) {
|
||||
const index = TIER_ORDER.indexOf(tier);
|
||||
return index === -1 ? 0 : index;
|
||||
}
|
||||
|
||||
// 티어/랭크/LP를 단일 연속 스칼라(사다리값)로 환산한다.
|
||||
function ladderValue(entry: {
|
||||
tier: string;
|
||||
rank?: string;
|
||||
leaguePoints?: number;
|
||||
}) {
|
||||
const base = tierIndex(entry.tier) * TIER_SPAN;
|
||||
const lp = entry.leaguePoints ?? 0;
|
||||
if (APEX_TIERS.has(entry.tier)) {
|
||||
return base + lp;
|
||||
}
|
||||
const rankIdx = RANK_INDEX[entry.rank ?? "IV"] ?? 0;
|
||||
return base + rankIdx * RANK_SPAN + lp;
|
||||
}
|
||||
|
||||
function normalizeRank(rank: string | undefined) {
|
||||
switch (rank) {
|
||||
case "I":
|
||||
return "1";
|
||||
case "II":
|
||||
return "2";
|
||||
case "III":
|
||||
return "3";
|
||||
case "IV":
|
||||
return "4";
|
||||
default:
|
||||
return rank ?? "";
|
||||
}
|
||||
}
|
||||
|
||||
function formatTierLabel(entry: {
|
||||
tier: string;
|
||||
rank?: string;
|
||||
leaguePoints?: number;
|
||||
}) {
|
||||
const name = TIER_NAMES[entry.tier] ?? entry.tier;
|
||||
if (APEX_TIERS.has(entry.tier)) {
|
||||
return `${name} ${entry.leaguePoints ?? 0}LP`;
|
||||
}
|
||||
const rank = normalizeRank(entry.rank);
|
||||
return `${name}${rank ? ` ${rank}` : ""} · ${entry.leaguePoints ?? 0}LP`;
|
||||
}
|
||||
|
||||
function formatTierShort(tier: string) {
|
||||
return TIER_NAMES[tier] ?? tier;
|
||||
}
|
||||
|
||||
function formatDate(ms: number) {
|
||||
return new Intl.DateTimeFormat("ko-KR", {
|
||||
month: "numeric",
|
||||
day: "numeric",
|
||||
}).format(new Date(ms));
|
||||
}
|
||||
|
||||
type ChartPoint = {
|
||||
ts: number;
|
||||
value: number;
|
||||
tier: string;
|
||||
rank?: string;
|
||||
leaguePoints?: number;
|
||||
wins?: number;
|
||||
losses?: number;
|
||||
};
|
||||
|
||||
function TierTooltip({
|
||||
active,
|
||||
payload,
|
||||
}: {
|
||||
active?: boolean;
|
||||
payload?: Array<{ payload: ChartPoint }>;
|
||||
}) {
|
||||
if (!active || !payload?.length) return null;
|
||||
const point = payload[0].payload;
|
||||
const games =
|
||||
point.wins !== undefined && point.losses !== undefined
|
||||
? ` · ${point.wins}승 ${point.losses}패`
|
||||
: "";
|
||||
return (
|
||||
<div className="border border-base-content/15 bg-base-100 px-3 py-2 text-[11px] shadow-lg">
|
||||
<div className="font-bold text-base-content">{formatTierLabel(point)}</div>
|
||||
<div className="mt-0.5 text-base-content/45">
|
||||
{new Intl.DateTimeFormat("ko-KR", {
|
||||
year: "numeric",
|
||||
month: "long",
|
||||
day: "numeric",
|
||||
}).format(new Date(point.ts))}
|
||||
{games}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
export default function TierHistoryChart({
|
||||
entries,
|
||||
}: {
|
||||
entries: ApiTierHistoryEntry[];
|
||||
}) {
|
||||
// 데이터에 존재하는 큐 목록 (솔로 우선)
|
||||
const availableQueues = useMemo(() => {
|
||||
const queues = new Set(entries.map((entry) => entry.queueType));
|
||||
return ["RANKED_SOLO_5x5", "RANKED_FLEX_SR"].filter((queue) =>
|
||||
queues.has(queue),
|
||||
);
|
||||
}, [entries]);
|
||||
|
||||
const [queue, setQueue] = useState(
|
||||
availableQueues[0] ?? "RANKED_SOLO_5x5",
|
||||
);
|
||||
const [period, setPeriod] = useState<PeriodKey>("all");
|
||||
|
||||
const activeQueue = availableQueues.includes(queue)
|
||||
? queue
|
||||
: (availableQueues[0] ?? "RANKED_SOLO_5x5");
|
||||
|
||||
const points = useMemo<ChartPoint[]>(() => {
|
||||
const periodDays =
|
||||
PERIOD_OPTIONS.find((option) => option.key === period)?.days ?? null;
|
||||
const cutoff =
|
||||
periodDays === null ? 0 : Date.now() - periodDays * 24 * 60 * 60 * 1000;
|
||||
|
||||
return entries
|
||||
.filter((entry) => entry.queueType === activeQueue)
|
||||
.map((entry) => ({
|
||||
ts: new Date(entry.recordedAt).getTime(),
|
||||
value: ladderValue(entry),
|
||||
tier: entry.tier,
|
||||
rank: entry.rank,
|
||||
leaguePoints: entry.leaguePoints,
|
||||
wins: entry.wins,
|
||||
losses: entry.losses,
|
||||
}))
|
||||
.filter((point) => point.ts >= cutoff)
|
||||
.sort((left, right) => left.ts - right.ts);
|
||||
}, [entries, activeQueue, period]);
|
||||
|
||||
// 티어 경계(가로 점선) 후보 — 데이터 범위 안에 드는 티어 floor만.
|
||||
const tierLines = useMemo(() => {
|
||||
if (points.length === 0) return [];
|
||||
const min = Math.min(...points.map((point) => point.value));
|
||||
const max = Math.max(...points.map((point) => point.value));
|
||||
return TIER_ORDER.map((tier, index) => ({
|
||||
tier,
|
||||
value: index * TIER_SPAN,
|
||||
})).filter((line) => line.value >= min - TIER_SPAN && line.value <= max);
|
||||
}, [points]);
|
||||
|
||||
const summary = useMemo(() => {
|
||||
if (points.length === 0) return null;
|
||||
const first = points[0];
|
||||
const last = points[points.length - 1];
|
||||
const peak = points.reduce((best, point) =>
|
||||
point.value > best.value ? point : best,
|
||||
);
|
||||
const direction =
|
||||
last.value > first.value
|
||||
? "up"
|
||||
: last.value < first.value
|
||||
? "down"
|
||||
: "flat";
|
||||
return { first, last, peak, direction };
|
||||
}, [points]);
|
||||
|
||||
const header = (
|
||||
<div className="flex flex-wrap items-center justify-between gap-2 border-b border-base-content/10 bg-base-200/40 px-4 py-2.5">
|
||||
<h2 className="text-[11px] font-bold uppercase tracking-wider text-base-content/40">
|
||||
티어 변동
|
||||
</h2>
|
||||
<div className="flex items-center gap-1.5">
|
||||
{availableQueues.length > 1 &&
|
||||
availableQueues.map((option) => (
|
||||
<button
|
||||
key={option}
|
||||
type="button"
|
||||
onClick={() => setQueue(option)}
|
||||
className={`h-7 px-2 text-[11px] font-semibold border transition-colors ${
|
||||
activeQueue === option
|
||||
? "border-primary/30 bg-primary/5 text-primary"
|
||||
: "border-base-content/10 text-base-content/40 hover:text-base-content/70"
|
||||
}`}
|
||||
>
|
||||
{QUEUE_LABELS[option] ?? option}
|
||||
</button>
|
||||
))}
|
||||
<select
|
||||
className="h-7 border border-base-content/10 bg-base-100 px-2 text-[11px] text-base-content focus:border-primary/30 focus:outline-none"
|
||||
value={period}
|
||||
onChange={(event) => setPeriod(event.target.value as PeriodKey)}
|
||||
>
|
||||
{PERIOD_OPTIONS.map((option) => (
|
||||
<option key={option.key} value={option.key}>
|
||||
{option.label}
|
||||
</option>
|
||||
))}
|
||||
</select>
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
|
||||
return (
|
||||
<section className="border border-base-content/10 bg-base-100 mb-5 overflow-hidden">
|
||||
{header}
|
||||
{points.length < 2 ? (
|
||||
<div className="px-4 py-10 text-center text-xs text-base-content/35">
|
||||
티어 변동 기록이 아직 부족해요.
|
||||
<br />
|
||||
정보를 갱신할수록 변화가 쌓여 그래프로 보여드릴게요.
|
||||
</div>
|
||||
) : (
|
||||
<>
|
||||
<div className="px-2 pt-4 pb-1">
|
||||
<ResponsiveContainer width="100%" height={220}>
|
||||
<LineChart
|
||||
data={points}
|
||||
margin={{ top: 8, right: 16, bottom: 4, left: 4 }}
|
||||
>
|
||||
<CartesianGrid
|
||||
strokeDasharray="3 3"
|
||||
stroke="currentColor"
|
||||
className="text-base-content/5"
|
||||
vertical={false}
|
||||
/>
|
||||
{tierLines.map((line) => (
|
||||
<ReferenceLine
|
||||
key={line.tier}
|
||||
y={line.value}
|
||||
stroke="currentColor"
|
||||
className="text-base-content/15"
|
||||
strokeDasharray="2 4"
|
||||
label={{
|
||||
value: formatTierShort(line.tier),
|
||||
position: "insideLeft",
|
||||
fill: "currentColor",
|
||||
fontSize: 10,
|
||||
className: "text-base-content/35",
|
||||
}}
|
||||
/>
|
||||
))}
|
||||
<XAxis
|
||||
dataKey="ts"
|
||||
type="number"
|
||||
scale="time"
|
||||
domain={["dataMin", "dataMax"]}
|
||||
tickFormatter={formatDate}
|
||||
tick={{ fontSize: 10, fill: "currentColor" }}
|
||||
className="text-base-content/40"
|
||||
stroke="currentColor"
|
||||
minTickGap={28}
|
||||
/>
|
||||
<YAxis
|
||||
type="number"
|
||||
domain={["dataMin - 60", "dataMax + 60"]}
|
||||
hide
|
||||
/>
|
||||
<Tooltip
|
||||
content={<TierTooltip />}
|
||||
cursor={{
|
||||
stroke: "currentColor",
|
||||
strokeDasharray: "3 3",
|
||||
className: "text-base-content/20",
|
||||
}}
|
||||
/>
|
||||
<Line
|
||||
type="monotone"
|
||||
dataKey="value"
|
||||
stroke="currentColor"
|
||||
className="text-primary"
|
||||
strokeWidth={2}
|
||||
dot={{ r: 2.5, className: "text-primary", fill: "currentColor" }}
|
||||
activeDot={{ r: 4 }}
|
||||
isAnimationActive={false}
|
||||
/>
|
||||
</LineChart>
|
||||
</ResponsiveContainer>
|
||||
</div>
|
||||
{summary && (
|
||||
<div className="flex flex-wrap items-center gap-x-5 gap-y-1 border-t border-base-content/8 px-4 py-2.5 text-[11px]">
|
||||
<span className="text-base-content/45">
|
||||
현재{" "}
|
||||
<span className="font-bold text-base-content/75">
|
||||
{formatTierLabel(summary.last)}
|
||||
</span>
|
||||
</span>
|
||||
<span className="text-base-content/45">
|
||||
최고{" "}
|
||||
<span className="font-bold text-amber-400">
|
||||
{formatTierLabel(summary.peak)}
|
||||
</span>
|
||||
</span>
|
||||
<span className="text-base-content/45">
|
||||
기간 변동{" "}
|
||||
<span
|
||||
className={`font-bold ${
|
||||
summary.direction === "up"
|
||||
? "text-green-500"
|
||||
: summary.direction === "down"
|
||||
? "text-red-400"
|
||||
: "text-base-content/55"
|
||||
}`}
|
||||
>
|
||||
{formatTierShort(summary.first.tier)}
|
||||
{summary.direction === "up"
|
||||
? " ▲ "
|
||||
: summary.direction === "down"
|
||||
? " ▼ "
|
||||
: " · "}
|
||||
{formatTierShort(summary.last.tier)}
|
||||
</span>
|
||||
</span>
|
||||
</div>
|
||||
)}
|
||||
</>
|
||||
)}
|
||||
</section>
|
||||
);
|
||||
}
|
||||
@@ -0,0 +1,92 @@
|
||||
import { API_BASE_URL, getAuthUserId } from '../config';
|
||||
import { acquireAccessToken } from './auth/token-provider';
|
||||
|
||||
export class ApiError extends Error {
|
||||
readonly data: unknown;
|
||||
readonly status: number;
|
||||
|
||||
constructor(status: number, message: string, data: unknown) {
|
||||
super(message);
|
||||
this.name = 'ApiError';
|
||||
this.status = status;
|
||||
this.data = data;
|
||||
}
|
||||
}
|
||||
|
||||
type ApiFetchOptions = RequestInit & {
|
||||
auth?: 'none' | 'dev';
|
||||
};
|
||||
|
||||
function resolveApiUrl(path: string) {
|
||||
if (/^https?:\/\//i.test(path)) {
|
||||
return path;
|
||||
}
|
||||
return `${API_BASE_URL}${path.startsWith('/') ? path : `/${path}`}`;
|
||||
}
|
||||
|
||||
function resolveErrorMessage(status: number, data: unknown) {
|
||||
if (typeof data === 'object' && data !== null) {
|
||||
const message = (data as { message?: unknown }).message;
|
||||
if (typeof message === 'string') return message;
|
||||
if (Array.isArray(message)) return message.join(', ');
|
||||
}
|
||||
return `API request failed (${status})`;
|
||||
}
|
||||
|
||||
async function readResponseBody(response: Response): Promise<unknown> {
|
||||
const contentType = response.headers.get('content-type') ?? '';
|
||||
if (contentType.includes('application/json')) {
|
||||
return response.json();
|
||||
}
|
||||
|
||||
const text = await response.text();
|
||||
return text ? text : null;
|
||||
}
|
||||
|
||||
async function resolveAccessToken(): Promise<string | null> {
|
||||
try {
|
||||
return await acquireAccessToken();
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
export async function apiFetch<T>(
|
||||
path: string,
|
||||
options: ApiFetchOptions = {},
|
||||
): Promise<T> {
|
||||
const { auth, headers, ...requestOptions } = options;
|
||||
const requestHeaders = new Headers(headers);
|
||||
|
||||
if (requestOptions.body && !requestHeaders.has('Content-Type')) {
|
||||
requestHeaders.set('Content-Type', 'application/json');
|
||||
}
|
||||
|
||||
if (auth !== 'none' && !requestHeaders.has('Authorization')) {
|
||||
const accessToken = auth === 'dev' ? null : await resolveAccessToken();
|
||||
if (accessToken) {
|
||||
requestHeaders.set('Authorization', `Bearer ${accessToken}`);
|
||||
}
|
||||
|
||||
const authUserId = getAuthUserId();
|
||||
if (!accessToken && authUserId) {
|
||||
requestHeaders.set('x-auth-user-id', authUserId);
|
||||
}
|
||||
}
|
||||
|
||||
const response = await fetch(resolveApiUrl(path), {
|
||||
...requestOptions,
|
||||
headers: requestHeaders,
|
||||
});
|
||||
|
||||
if (response.status === 204) {
|
||||
return undefined as T;
|
||||
}
|
||||
|
||||
const data = await readResponseBody(response);
|
||||
if (!response.ok) {
|
||||
throw new ApiError(response.status, resolveErrorMessage(response.status, data), data);
|
||||
}
|
||||
|
||||
return data as T;
|
||||
}
|
||||
@@ -0,0 +1,10 @@
|
||||
import { MsalProvider } from '@azure/msal-react';
|
||||
import { msalInstance } from './msal.config';
|
||||
|
||||
export function MsalAppProvider({ children }: { children: React.ReactNode }) {
|
||||
if (!msalInstance) {
|
||||
return <>{children}</>;
|
||||
}
|
||||
|
||||
return <MsalProvider instance={msalInstance}>{children}</MsalProvider>;
|
||||
}
|
||||
@@ -0,0 +1,40 @@
|
||||
import {
|
||||
PublicClientApplication,
|
||||
type Configuration,
|
||||
} from '@azure/msal-browser';
|
||||
|
||||
const clientId = (import.meta.env.VITE_MSAL_CLIENT_ID ?? '').trim();
|
||||
const authority = (import.meta.env.VITE_MSAL_AUTHORITY ?? '').trim();
|
||||
const redirectUri = (import.meta.env.VITE_MSAL_REDIRECT_URI ?? '').trim();
|
||||
|
||||
export const MSAL_API_SCOPE = (
|
||||
import.meta.env.VITE_MSAL_API_SCOPE ?? ''
|
||||
).trim();
|
||||
|
||||
export const MSAL_SILENT_REDIRECT_URI = (
|
||||
import.meta.env.VITE_MSAL_SILENT_REDIRECT_URI ??
|
||||
`${window.location.origin}/auth/silent-callback.html`
|
||||
).trim();
|
||||
|
||||
export const isMsalConfigured = Boolean(
|
||||
clientId &&
|
||||
authority &&
|
||||
MSAL_API_SCOPE &&
|
||||
!authority.includes('<tenant-id>'),
|
||||
);
|
||||
|
||||
export const msalConfig: Configuration = {
|
||||
auth: {
|
||||
clientId,
|
||||
authority,
|
||||
redirectUri: redirectUri || window.location.origin,
|
||||
postLogoutRedirectUri: window.location.origin,
|
||||
},
|
||||
cache: {
|
||||
cacheLocation: 'localStorage',
|
||||
},
|
||||
};
|
||||
|
||||
export const msalInstance = isMsalConfigured
|
||||
? new PublicClientApplication(msalConfig)
|
||||
: null;
|
||||
@@ -0,0 +1,26 @@
|
||||
import {
|
||||
isMsalConfigured,
|
||||
MSAL_API_SCOPE,
|
||||
MSAL_SILENT_REDIRECT_URI,
|
||||
msalInstance,
|
||||
} from './msal.config';
|
||||
|
||||
export async function acquireAccessToken(): Promise<string | null> {
|
||||
if (!isMsalConfigured || !msalInstance) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const accounts = msalInstance.getAllAccounts();
|
||||
const account = msalInstance.getActiveAccount() ?? accounts[0];
|
||||
if (!account) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const response = await msalInstance.acquireTokenSilent({
|
||||
account,
|
||||
scopes: [MSAL_API_SCOPE],
|
||||
redirectUri: MSAL_SILENT_REDIRECT_URI,
|
||||
});
|
||||
|
||||
return response.accessToken;
|
||||
}
|
||||
@@ -0,0 +1,71 @@
|
||||
import type { DdragonManifest } from '../api/types';
|
||||
|
||||
const FALLBACK_VERSION = '15.24.1';
|
||||
const FALLBACK_CDN = 'https://ddragon.leagueoflegends.com/cdn';
|
||||
|
||||
function cdn(manifest: DdragonManifest | null | undefined) {
|
||||
return manifest?.cdn ?? FALLBACK_CDN;
|
||||
}
|
||||
|
||||
function version(manifest: DdragonManifest | null | undefined) {
|
||||
return manifest?.version ?? FALLBACK_VERSION;
|
||||
}
|
||||
|
||||
export function championDisplayName(
|
||||
manifest: DdragonManifest | null | undefined,
|
||||
championId: number,
|
||||
) {
|
||||
return manifest?.champions[String(championId)]?.name ?? null;
|
||||
}
|
||||
|
||||
export function championIconUrl(
|
||||
manifest: DdragonManifest | null | undefined,
|
||||
championId: number,
|
||||
) {
|
||||
const champion = manifest?.champions[String(championId)];
|
||||
if (!champion) return null;
|
||||
return `${cdn(manifest)}/${version(manifest)}/img/champion/${champion.key}.png`;
|
||||
}
|
||||
|
||||
export function profileIconUrl(
|
||||
manifest: DdragonManifest | null | undefined,
|
||||
profileIconId: number,
|
||||
) {
|
||||
return `${cdn(manifest)}/${version(manifest)}/img/profileicon/${profileIconId}.png`;
|
||||
}
|
||||
|
||||
export function itemIconUrl(
|
||||
manifest: DdragonManifest | null | undefined,
|
||||
itemId: number,
|
||||
) {
|
||||
if (!itemId) return null;
|
||||
return `${cdn(manifest)}/${version(manifest)}/img/item/${itemId}.png`;
|
||||
}
|
||||
|
||||
export function summonerSpellIconUrl(
|
||||
manifest: DdragonManifest | null | undefined,
|
||||
spellId: number,
|
||||
) {
|
||||
const spell = manifest?.summonerSpells[String(spellId)];
|
||||
if (!spell) return null;
|
||||
return `${cdn(manifest)}/${version(manifest)}/img/spell/${spell.key}.png`;
|
||||
}
|
||||
|
||||
export function runeStyleIconUrl(
|
||||
manifest: DdragonManifest | null | undefined,
|
||||
styleId: number | undefined,
|
||||
) {
|
||||
const style = manifest?.runesReforged.find((entry) => entry.id === styleId);
|
||||
return style ? `${cdn(manifest)}/img/${style.icon}` : null;
|
||||
}
|
||||
|
||||
export function runeKeystoneIconUrl(
|
||||
manifest: DdragonManifest | null | undefined,
|
||||
runeId: number | undefined,
|
||||
) {
|
||||
const rune = manifest?.runesReforged
|
||||
.flatMap((style) => style.slots.flatMap((slot) => slot.runes))
|
||||
.find((entry) => entry.id === runeId);
|
||||
|
||||
return rune ? `${cdn(manifest)}/img/${rune.icon}` : null;
|
||||
}
|
||||
@@ -0,0 +1,63 @@
|
||||
import type { Position, TeamSide } from '../api/types';
|
||||
import adcIcon from '../assets/position/position-bottom.svg';
|
||||
import jungleIcon from '../assets/position/position-jungle.svg';
|
||||
import midIcon from '../assets/position/position-middle.svg';
|
||||
import supportIcon from '../assets/position/position-support.svg';
|
||||
import topIcon from '../assets/position/position-top.svg';
|
||||
|
||||
export const POSITION_ORDER: Position[] = ['TOP', 'JGL', 'MID', 'ADC', 'SUP'];
|
||||
|
||||
export const positionLabel: Record<Position, string> = {
|
||||
TOP: '탑',
|
||||
JGL: '정글',
|
||||
MID: '미드',
|
||||
ADC: '원딜',
|
||||
SUP: '서폿',
|
||||
};
|
||||
|
||||
export const positionIcon: Record<Position, string> = {
|
||||
TOP: topIcon,
|
||||
JGL: jungleIcon,
|
||||
MID: midIcon,
|
||||
ADC: adcIcon,
|
||||
SUP: supportIcon,
|
||||
};
|
||||
|
||||
const TEAM_TONES = [
|
||||
{
|
||||
border: 'border-blue-500/20',
|
||||
bg: 'bg-blue-500/5',
|
||||
text: 'text-blue-400',
|
||||
bar: 'bg-blue-500',
|
||||
},
|
||||
{
|
||||
border: 'border-red-500/20',
|
||||
bg: 'bg-red-500/5',
|
||||
text: 'text-red-400',
|
||||
bar: 'bg-red-500',
|
||||
},
|
||||
{
|
||||
border: 'border-emerald-500/20',
|
||||
bg: 'bg-emerald-500/5',
|
||||
text: 'text-emerald-400',
|
||||
bar: 'bg-emerald-500',
|
||||
},
|
||||
{
|
||||
border: 'border-amber-500/20',
|
||||
bg: 'bg-amber-500/5',
|
||||
text: 'text-amber-400',
|
||||
bar: 'bg-amber-500',
|
||||
},
|
||||
];
|
||||
|
||||
export function teamIndexLabel(teamIndex: number, fallback?: string) {
|
||||
return fallback?.trim() || `${teamIndex}팀`;
|
||||
}
|
||||
|
||||
export function teamIndexColorClasses(teamIndex: number) {
|
||||
return TEAM_TONES[(Math.max(1, teamIndex) - 1) % TEAM_TONES.length];
|
||||
}
|
||||
|
||||
export function sideShortLabel(side: TeamSide) {
|
||||
return side === 'blue' ? 'BLUE' : 'RED';
|
||||
}
|
||||
@@ -0,0 +1,47 @@
|
||||
import type { RiotLane, RiotQueueGroup, RiotRankFilter } from '../api/types';
|
||||
|
||||
export const QUEUE_GROUP_TABS: Array<{
|
||||
label: string;
|
||||
value: RiotQueueGroup;
|
||||
}> = [
|
||||
{ label: '소환사의 협곡', value: 'summoners-rift' },
|
||||
{ label: '칼바람', value: 'aram' },
|
||||
{ label: 'URF', value: 'urf' },
|
||||
{ label: '아레나', value: 'arena' },
|
||||
{ label: '내전', value: 'internal' },
|
||||
];
|
||||
|
||||
export const RANK_FILTER_TABS: Array<{
|
||||
label: string;
|
||||
value: RiotRankFilter;
|
||||
}> = [
|
||||
{ label: '전체', value: 'all' },
|
||||
{ label: '솔로랭크', value: 'solo' },
|
||||
{ label: '자유랭크', value: 'flex' },
|
||||
{ label: '일반', value: 'normal' },
|
||||
];
|
||||
|
||||
export const LANE_LABELS: Record<RiotLane | string, string> = {
|
||||
TOP: '탑',
|
||||
JUNGLE: '정글',
|
||||
MIDDLE: '미드',
|
||||
BOTTOM: '원딜',
|
||||
UTILITY: '서폿',
|
||||
NONE: '기타',
|
||||
};
|
||||
|
||||
const QUEUE_GROUP_VALUES = new Set<RiotQueueGroup>(
|
||||
QUEUE_GROUP_TABS.map((tab) => tab.value),
|
||||
);
|
||||
|
||||
const RANK_FILTER_VALUES = new Set<RiotRankFilter>(
|
||||
RANK_FILTER_TABS.map((tab) => tab.value),
|
||||
);
|
||||
|
||||
export function isRiotQueueGroup(value: string | null): value is RiotQueueGroup {
|
||||
return Boolean(value && QUEUE_GROUP_VALUES.has(value as RiotQueueGroup));
|
||||
}
|
||||
|
||||
export function isRiotRankFilter(value: string | null): value is RiotRankFilter {
|
||||
return Boolean(value && RANK_FILTER_VALUES.has(value as RiotRankFilter));
|
||||
}
|
||||
@@ -1,16 +1,26 @@
|
||||
import { useEffect, useMemo, useRef, useState } from 'react';
|
||||
import {
|
||||
useEffect,
|
||||
useMemo,
|
||||
useRef,
|
||||
useState,
|
||||
type FormEvent,
|
||||
type KeyboardEvent,
|
||||
} from 'react';
|
||||
import { useQueryClient } from '@tanstack/react-query';
|
||||
import { Link, useLocation, useParams } from 'react-router';
|
||||
import { AlertTriangle, SendHorizontal } from 'lucide-react';
|
||||
import { Link, useLocation, useNavigate, useParams } from 'react-router';
|
||||
import {
|
||||
useAuction,
|
||||
useAuctionHistory,
|
||||
useDdragonManifest,
|
||||
useMatch,
|
||||
useMe,
|
||||
useResetAuction,
|
||||
useUndoAuction,
|
||||
} from '../api/hooks';
|
||||
import {
|
||||
mapApiAuctionToAuctionState,
|
||||
type AuctionPlayerView,
|
||||
type AuctionStateView,
|
||||
} from '../api/mappers';
|
||||
import { useAuctionSocket } from '../api/useAuctionSocket';
|
||||
@@ -33,8 +43,10 @@ import {
|
||||
} from '../lib/league';
|
||||
import type {
|
||||
ApiAuction,
|
||||
ApiAuctionChatMessage,
|
||||
ApiRiotLaneStats,
|
||||
ApiTierInfo,
|
||||
ApiUser,
|
||||
Position,
|
||||
} from '../api/types';
|
||||
|
||||
@@ -72,6 +84,31 @@ function relativeTime(dateLike: string) {
|
||||
return `${Math.floor(hours / 24)}일 전`;
|
||||
}
|
||||
|
||||
function formatChatTime(dateLike: string) {
|
||||
return new Intl.DateTimeFormat('ko-KR', {
|
||||
hour: '2-digit',
|
||||
minute: '2-digit',
|
||||
}).format(new Date(dateLike));
|
||||
}
|
||||
|
||||
function resolveChatSenderLabel(
|
||||
currentUser: ApiUser | null,
|
||||
captainRole: CaptainRole | null,
|
||||
) {
|
||||
const primaryRiotAccount =
|
||||
currentUser?.riotAccounts.find((entry) => entry.isPrimary) ??
|
||||
currentUser?.riotAccounts[0];
|
||||
if (primaryRiotAccount?.gameName) {
|
||||
return primaryRiotAccount.tagLine
|
||||
? `${primaryRiotAccount.gameName}#${primaryRiotAccount.tagLine}`
|
||||
: primaryRiotAccount.gameName;
|
||||
}
|
||||
if (currentUser?.kakaoTalkNickname) return currentUser.kakaoTalkNickname;
|
||||
if (currentUser?.discordNickname) return currentUser.discordNickname;
|
||||
if (captainRole) return `${teamIndexLabel(captainRole.teamIndex)} 팀장`;
|
||||
return '관전자';
|
||||
}
|
||||
|
||||
function normalizeRank(rank: string | undefined) {
|
||||
switch (rank) {
|
||||
case 'I':
|
||||
@@ -692,6 +729,7 @@ function BidLog({ bids }: { bids: AuctionStateView['bids'] }) {
|
||||
export default function AuctionPage() {
|
||||
const { id } = useParams();
|
||||
const location = useLocation();
|
||||
const navigate = useNavigate();
|
||||
const queryClient = useQueryClient();
|
||||
const meQuery = useMe();
|
||||
const currentUser =
|
||||
@@ -711,17 +749,42 @@ export default function AuctionPage() {
|
||||
refetchInterval: 3000,
|
||||
});
|
||||
const undoMutation = useUndoAuction(DEFAULT_COMMUNITY_ID);
|
||||
const resetAuctionMutation = useResetAuction(DEFAULT_COMMUNITY_ID);
|
||||
const socket = useAuctionSocket(id);
|
||||
const captainTeamIndex = useDevCaptainTeamIndex();
|
||||
const [now, setNow] = useState(() => Date.now());
|
||||
const [assignedPosition, setAssignedPosition] = useState<Position>('MID');
|
||||
const [showCancelModal, setShowCancelModal] = useState(false);
|
||||
const [cancelConfirmText, setCancelConfirmText] = useState('');
|
||||
const cancelConfirmInputRef = useRef<HTMLInputElement>(null);
|
||||
const historyBackTo = `${location.pathname}${location.search}${location.hash}`;
|
||||
const canConfirmAuctionCancel = cancelConfirmText.trim() === '예';
|
||||
|
||||
async function invalidateAuctionData() {
|
||||
if (!id) return;
|
||||
await Promise.all([
|
||||
queryClient.invalidateQueries({
|
||||
queryKey: ['auction', DEFAULT_COMMUNITY_ID, id],
|
||||
}),
|
||||
queryClient.invalidateQueries({
|
||||
queryKey: ['auction-history', DEFAULT_COMMUNITY_ID, id],
|
||||
}),
|
||||
queryClient.invalidateQueries({
|
||||
queryKey: ['match', DEFAULT_COMMUNITY_ID, id],
|
||||
}),
|
||||
]);
|
||||
}
|
||||
|
||||
useEffect(() => {
|
||||
const timer = window.setInterval(() => setNow(Date.now()), 1000);
|
||||
return () => window.clearInterval(timer);
|
||||
}, []);
|
||||
|
||||
useEffect(() => {
|
||||
if (!showCancelModal) return;
|
||||
cancelConfirmInputRef.current?.focus();
|
||||
}, [showCancelModal]);
|
||||
|
||||
const liveAuction = pickLatestAuction(socket.auction, auctionQuery.data);
|
||||
const auctionState =
|
||||
liveAuction && matchQuery.data
|
||||
@@ -737,6 +800,7 @@ export default function AuctionPage() {
|
||||
: {
|
||||
teamIndex: captainTeamIndex,
|
||||
};
|
||||
const chatSenderLabel = resolveChatSenderLabel(currentUser, captainRole);
|
||||
|
||||
useEffect(() => {
|
||||
if (auctionState?.currentPlayer) {
|
||||
@@ -751,6 +815,13 @@ export default function AuctionPage() {
|
||||
}
|
||||
}, [availableTeamIndexes, captainTeamIndex]);
|
||||
|
||||
useEffect(() => {
|
||||
if (!socket.resetAt || !id) return;
|
||||
void invalidateAuctionData().finally(() => {
|
||||
navigate(`/match/${id}`, { replace: true });
|
||||
});
|
||||
}, [id, navigate, socket.resetAt]);
|
||||
|
||||
if (!DEFAULT_COMMUNITY_ID) {
|
||||
return (
|
||||
<main className="max-w-5xl mx-auto px-4 py-20 text-center">
|
||||
@@ -825,6 +896,21 @@ export default function AuctionPage() {
|
||||
);
|
||||
}
|
||||
|
||||
function handleResetAuction() {
|
||||
if (!id || !canConfirmAuctionCancel) return;
|
||||
resetAuctionMutation.mutate(
|
||||
{ matchId: id },
|
||||
{
|
||||
onSuccess: async () => {
|
||||
setShowCancelModal(false);
|
||||
setCancelConfirmText('');
|
||||
await invalidateAuctionData();
|
||||
navigate(`/match/${id}`, { replace: true });
|
||||
},
|
||||
},
|
||||
);
|
||||
}
|
||||
|
||||
const undoPanel = canManageAuction ? (
|
||||
<div className="border border-base-content/10 bg-base-100 p-4 space-y-3">
|
||||
<div className="text-[10px] font-bold uppercase tracking-wider text-base-content/35">
|
||||
@@ -859,7 +945,7 @@ export default function AuctionPage() {
|
||||
) : null;
|
||||
|
||||
return (
|
||||
<main className="max-w-5xl mx-auto px-4 sm:px-6 py-6">
|
||||
<main className="max-w-[1600px] mx-auto px-4 sm:px-6 py-6">
|
||||
<Link
|
||||
to={`/match/${id}`}
|
||||
className="inline-flex items-center gap-1 text-xs text-base-content/40 hover:text-base-content transition-colors mb-4"
|
||||
@@ -893,6 +979,12 @@ export default function AuctionPage() {
|
||||
</div>
|
||||
)}
|
||||
|
||||
{resetAuctionMutation.error instanceof Error && (
|
||||
<div className="mb-4 border border-red-500/20 bg-red-500/10 px-4 py-3 text-sm text-red-500">
|
||||
{resetAuctionMutation.error.message}
|
||||
</div>
|
||||
)}
|
||||
|
||||
<div className="mb-5 flex items-start justify-between flex-wrap gap-3">
|
||||
<div>
|
||||
<h1 className="text-xl font-bold text-base-content leading-tight">
|
||||
@@ -955,7 +1047,11 @@ export default function AuctionPage() {
|
||||
<TimerBar timer={auctionState.timer} maxTimer={auctionState.maxTimer} />
|
||||
)}
|
||||
|
||||
<div className="grid grid-cols-1 xl:grid-cols-[minmax(0,1fr)_minmax(340px,440px)] gap-4 mt-4">
|
||||
<div className="grid grid-cols-1 xl:grid-cols-[260px_minmax(0,1fr)_minmax(340px,440px)_320px] gap-4 mt-4">
|
||||
<aside className="hidden xl:block">
|
||||
<PoolPanel state={auctionState} />
|
||||
</aside>
|
||||
|
||||
<div className="grid sm:grid-cols-2 gap-4 content-start">
|
||||
{auctionState.teams.map((team) => (
|
||||
<TeamPanel
|
||||
@@ -1060,13 +1156,408 @@ export default function AuctionPage() {
|
||||
다음 선수
|
||||
</button>
|
||||
)}
|
||||
<div className="border-t border-base-content/10 pt-3">
|
||||
<button
|
||||
type="button"
|
||||
className="btn btn-outline btn-error btn-sm inline-flex items-center gap-1.5 px-4 text-xs"
|
||||
onClick={() => {
|
||||
setCancelConfirmText('');
|
||||
setShowCancelModal(true);
|
||||
}}
|
||||
disabled={resetAuctionMutation.isPending}
|
||||
>
|
||||
<AlertTriangle className="h-3.5 w-3.5" />
|
||||
경매 진행 취소
|
||||
</button>
|
||||
<p className="mt-2 text-[11px] leading-relaxed text-base-content/35">
|
||||
경매 데이터와 진행 기록을 삭제하고 내전을 모집 상태로 되돌립니다.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
{undoPanel}
|
||||
</>
|
||||
)}
|
||||
</div>
|
||||
|
||||
<aside className="hidden xl:block">
|
||||
<ChatPanel
|
||||
messages={socket.chatMessages}
|
||||
connectionStatus={socket.connectionStatus}
|
||||
senderLabel={chatSenderLabel}
|
||||
onSend={(message) =>
|
||||
socket.sendChatMessage({
|
||||
displayName: chatSenderLabel,
|
||||
message,
|
||||
})
|
||||
}
|
||||
className="sticky top-4 h-[520px] max-h-[calc(100vh-2rem)]"
|
||||
/>
|
||||
</aside>
|
||||
</div>
|
||||
|
||||
<div className="mt-4 xl:hidden">
|
||||
<ChatPanel
|
||||
messages={socket.chatMessages}
|
||||
connectionStatus={socket.connectionStatus}
|
||||
senderLabel={chatSenderLabel}
|
||||
onSend={(message) =>
|
||||
socket.sendChatMessage({
|
||||
displayName: chatSenderLabel,
|
||||
message,
|
||||
})
|
||||
}
|
||||
className="h-[420px]"
|
||||
/>
|
||||
</div>
|
||||
|
||||
{showCancelModal && (
|
||||
<div
|
||||
className="fixed inset-0 z-50 flex items-center justify-center bg-black/55 px-4"
|
||||
role="dialog"
|
||||
aria-modal="true"
|
||||
aria-labelledby="auction-cancel-title"
|
||||
>
|
||||
<div className="w-full max-w-md border border-red-500/25 bg-base-100 p-5 shadow-2xl">
|
||||
<div className="flex items-start gap-3">
|
||||
<span className="inline-flex h-9 w-9 shrink-0 items-center justify-center border border-red-500/25 bg-red-500/10 text-red-400">
|
||||
<AlertTriangle className="h-4 w-4" />
|
||||
</span>
|
||||
<div className="min-w-0">
|
||||
<h2
|
||||
id="auction-cancel-title"
|
||||
className="text-base font-bold text-base-content"
|
||||
>
|
||||
경매 진행 취소
|
||||
</h2>
|
||||
<p className="mt-2 text-sm leading-6 text-base-content/60">
|
||||
정말 경매를 취소하고 모집 상태로 되돌리시겠습니까?
|
||||
경매 데이터, 입찰 기록, 팀 배정 정보가 삭제됩니다.
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<label
|
||||
htmlFor="auction-cancel-confirm"
|
||||
className="mt-5 block text-[11px] font-bold uppercase tracking-wider text-base-content/40"
|
||||
>
|
||||
계속하려면 예 입력
|
||||
</label>
|
||||
<input
|
||||
id="auction-cancel-confirm"
|
||||
ref={cancelConfirmInputRef}
|
||||
value={cancelConfirmText}
|
||||
onChange={(event) => setCancelConfirmText(event.target.value)}
|
||||
onKeyDown={(event) => {
|
||||
if (event.key === 'Escape') {
|
||||
setShowCancelModal(false);
|
||||
setCancelConfirmText('');
|
||||
}
|
||||
if (event.key === 'Enter' && canConfirmAuctionCancel) {
|
||||
handleResetAuction();
|
||||
}
|
||||
}}
|
||||
className="mt-2 h-10 w-full border border-base-content/15 bg-base-100 px-3 text-sm text-base-content outline-none transition-colors focus:border-red-400/60"
|
||||
placeholder="예"
|
||||
/>
|
||||
|
||||
<div className="mt-5 flex flex-wrap justify-end gap-2">
|
||||
<button
|
||||
type="button"
|
||||
className="btn btn-ghost btn-sm px-4 text-xs"
|
||||
onClick={() => {
|
||||
setShowCancelModal(false);
|
||||
setCancelConfirmText('');
|
||||
}}
|
||||
disabled={resetAuctionMutation.isPending}
|
||||
>
|
||||
닫기
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
className="btn btn-error btn-sm px-4 text-xs"
|
||||
onClick={handleResetAuction}
|
||||
disabled={
|
||||
!canConfirmAuctionCancel || resetAuctionMutation.isPending
|
||||
}
|
||||
>
|
||||
{resetAuctionMutation.isPending
|
||||
? '취소 처리 중...'
|
||||
: '경매 취소 진행'}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
)}
|
||||
</main>
|
||||
);
|
||||
}
|
||||
|
||||
type PoolTab = 'waiting' | 'passed';
|
||||
|
||||
// 풀 리스트는 경매 등장 순서를 노출하면 안 되므로 게임명 알파벳 순으로 독립 정렬한다.
|
||||
const POOL_COLLATOR = new Intl.Collator(['ko', 'en'], { sensitivity: 'base' });
|
||||
|
||||
function comparePoolPlayers(a: AuctionPlayerView, b: AuctionPlayerView) {
|
||||
return POOL_COLLATOR.compare(a.summonerName, b.summonerName);
|
||||
}
|
||||
|
||||
function PoolPanel({ state }: { state: AuctionStateView }) {
|
||||
const { data: ddragon } = useDdragonManifest();
|
||||
const [tab, setTab] = useState<PoolTab>('waiting');
|
||||
|
||||
const { waitingPool, passedPool } = useMemo(() => {
|
||||
const captainIds = new Set(state.teams.map((team) => team.captainUserId));
|
||||
const memberIds = new Set(
|
||||
state.teams.flatMap((team) =>
|
||||
team.members.map((member) => member.userId),
|
||||
),
|
||||
);
|
||||
const passedIds = new Set(
|
||||
state.passedQueue.map((player) => player.userId),
|
||||
);
|
||||
const currentId = state.currentPlayer?.userId;
|
||||
|
||||
const startIndex =
|
||||
state.phase === 'complete' ? state.totalPlayers : state.currentPlayerIndex + 1;
|
||||
|
||||
const waiting = state.auctionOrder
|
||||
.slice(startIndex)
|
||||
.filter(
|
||||
(player) =>
|
||||
!captainIds.has(player.userId) &&
|
||||
!memberIds.has(player.userId) &&
|
||||
!passedIds.has(player.userId) &&
|
||||
player.userId !== currentId,
|
||||
)
|
||||
.sort(comparePoolPlayers);
|
||||
|
||||
const passed = [...state.passedQueue].sort(comparePoolPlayers);
|
||||
|
||||
return { waitingPool: waiting, passedPool: passed };
|
||||
}, [state]);
|
||||
|
||||
const activePool = tab === 'waiting' ? waitingPool : passedPool;
|
||||
|
||||
return (
|
||||
<div className="border border-base-content/10 bg-base-100 sticky top-4 max-h-[calc(100vh-2rem)] flex flex-col">
|
||||
<div role="tablist" className="flex border-b border-base-content/10 px-3">
|
||||
<PoolTabButton
|
||||
label="대기"
|
||||
count={waitingPool.length}
|
||||
active={tab === 'waiting'}
|
||||
onClick={() => setTab('waiting')}
|
||||
/>
|
||||
<PoolTabButton
|
||||
label="유찰"
|
||||
count={passedPool.length}
|
||||
active={tab === 'passed'}
|
||||
onClick={() => setTab('passed')}
|
||||
/>
|
||||
</div>
|
||||
|
||||
<div className="flex-1 overflow-y-auto">
|
||||
{activePool.length === 0 ? (
|
||||
<div className="px-3 py-8 text-center text-[11px] text-base-content/30">
|
||||
{tab === 'waiting'
|
||||
? '대기 중인 유저가 없습니다'
|
||||
: '유찰된 유저가 없습니다'}
|
||||
</div>
|
||||
) : (
|
||||
<ul className="divide-y divide-base-content/5">
|
||||
{activePool.map((player) => (
|
||||
<PoolListItem
|
||||
key={player.userId}
|
||||
player={player}
|
||||
ddragon={ddragon}
|
||||
showPassCount={tab === 'passed'}
|
||||
/>
|
||||
))}
|
||||
</ul>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
|
||||
function PoolTabButton({
|
||||
label,
|
||||
count,
|
||||
active,
|
||||
onClick,
|
||||
}: {
|
||||
label: string;
|
||||
count: number;
|
||||
active: boolean;
|
||||
onClick: () => void;
|
||||
}) {
|
||||
return (
|
||||
<button
|
||||
role="tab"
|
||||
type="button"
|
||||
onClick={onClick}
|
||||
className={`relative px-1 pt-3 pb-2.5 mr-5 text-[12px] font-semibold transition-colors ${
|
||||
active
|
||||
? 'text-base-content'
|
||||
: 'text-base-content/40 hover:text-base-content/70'
|
||||
}`}
|
||||
>
|
||||
{label}
|
||||
<span className="ml-1 text-[10px] tabular-nums text-base-content/30">
|
||||
{count}
|
||||
</span>
|
||||
{active ? (
|
||||
<span className="absolute -bottom-px left-0 right-0 h-px bg-primary" />
|
||||
) : null}
|
||||
</button>
|
||||
);
|
||||
}
|
||||
|
||||
function PoolListItem({
|
||||
player,
|
||||
ddragon,
|
||||
showPassCount,
|
||||
}: {
|
||||
player: AuctionPlayerView;
|
||||
ddragon: ReturnType<typeof useDdragonManifest>['data'];
|
||||
showPassCount: boolean;
|
||||
}) {
|
||||
return (
|
||||
<li className="flex items-center gap-2 px-3 py-2">
|
||||
<img
|
||||
src={profileIconUrl(ddragon, player.profileIconId)}
|
||||
alt=""
|
||||
className="w-7 h-7 shrink-0 rounded-sm border border-base-content/10 object-cover"
|
||||
/>
|
||||
<div className="min-w-0 flex-1 flex items-center gap-1.5">
|
||||
<span className="truncate text-[12px] font-semibold text-base-content">
|
||||
{player.summonerName}
|
||||
</span>
|
||||
<RankBadge tier={player.tier} />
|
||||
{showPassCount && player.passCount > 0 ? (
|
||||
<span className="inline-flex items-center text-[10px] font-medium px-1.5 py-0.5 border border-amber-500/30 text-amber-500 bg-amber-500/5">
|
||||
{player.passCount}회 유찰
|
||||
</span>
|
||||
) : null}
|
||||
</div>
|
||||
</li>
|
||||
);
|
||||
}
|
||||
|
||||
function ChatPanel({
|
||||
messages,
|
||||
connectionStatus,
|
||||
senderLabel,
|
||||
onSend,
|
||||
className = '',
|
||||
}: {
|
||||
messages: ApiAuctionChatMessage[];
|
||||
connectionStatus: ReturnType<typeof useAuctionSocket>['connectionStatus'];
|
||||
senderLabel: string;
|
||||
onSend: (message: string) => void;
|
||||
className?: string;
|
||||
}) {
|
||||
const [draft, setDraft] = useState('');
|
||||
const messagesEndRef = useRef<HTMLDivElement | null>(null);
|
||||
const trimmedDraft = draft.trim();
|
||||
const isConnected = connectionStatus === 'connected';
|
||||
const canSend = isConnected && trimmedDraft.length > 0;
|
||||
|
||||
useEffect(() => {
|
||||
messagesEndRef.current?.scrollIntoView({ block: 'end' });
|
||||
}, [messages.length]);
|
||||
|
||||
function handleSubmit(event: FormEvent<HTMLFormElement>) {
|
||||
event.preventDefault();
|
||||
if (!canSend) return;
|
||||
onSend(trimmedDraft);
|
||||
setDraft('');
|
||||
}
|
||||
|
||||
function handleKeyDown(event: KeyboardEvent<HTMLTextAreaElement>) {
|
||||
if (event.key !== 'Enter' || event.shiftKey) return;
|
||||
event.preventDefault();
|
||||
if (!canSend) return;
|
||||
onSend(trimmedDraft);
|
||||
setDraft('');
|
||||
}
|
||||
|
||||
const statusLabel =
|
||||
connectionStatus === 'connected'
|
||||
? '실시간'
|
||||
: connectionStatus === 'connecting'
|
||||
? '연결 중'
|
||||
: '오프라인';
|
||||
|
||||
return (
|
||||
<div
|
||||
className={`border border-base-content/10 bg-base-100 flex min-h-0 flex-col ${className}`}
|
||||
>
|
||||
<div className="border-b border-base-content/10 px-3 py-2.5 flex items-center justify-between">
|
||||
<div className="text-[10px] font-bold uppercase tracking-wider text-base-content/35">
|
||||
채팅
|
||||
</div>
|
||||
<span
|
||||
className={`text-[10px] ${
|
||||
isConnected ? 'text-green-500' : 'text-base-content/30'
|
||||
}`}
|
||||
>
|
||||
{statusLabel}
|
||||
</span>
|
||||
</div>
|
||||
|
||||
<div className="flex-1 min-h-0 overflow-y-auto px-3 py-3">
|
||||
{messages.length === 0 ? (
|
||||
<div className="flex h-full items-center justify-center text-center text-[11px] text-base-content/25">
|
||||
아직 메시지가 없습니다
|
||||
</div>
|
||||
) : (
|
||||
<ol className="space-y-3">
|
||||
{messages.map((message) => (
|
||||
<li key={message.id} className="space-y-1">
|
||||
<div className="flex items-center justify-between gap-2">
|
||||
<span className="min-w-0 truncate text-[11px] font-bold text-base-content/70">
|
||||
{message.displayName}
|
||||
</span>
|
||||
<time className="shrink-0 text-[10px] tabular-nums text-base-content/25">
|
||||
{formatChatTime(message.sentAt)}
|
||||
</time>
|
||||
</div>
|
||||
<p className="whitespace-pre-wrap break-words border border-base-content/8 bg-base-content/[0.03] px-2.5 py-2 text-[12px] leading-relaxed text-base-content/75">
|
||||
{message.message}
|
||||
</p>
|
||||
</li>
|
||||
))}
|
||||
</ol>
|
||||
)}
|
||||
<div ref={messagesEndRef} />
|
||||
</div>
|
||||
|
||||
<form onSubmit={handleSubmit} className="border-t border-base-content/10 p-2 space-y-2">
|
||||
<div className="flex items-center justify-between gap-2 px-0.5 text-[10px] text-base-content/30">
|
||||
<span className="truncate">{senderLabel}</span>
|
||||
<span className="tabular-nums">{draft.length}/300</span>
|
||||
</div>
|
||||
<textarea
|
||||
value={draft}
|
||||
onChange={(event) => setDraft(event.target.value)}
|
||||
onKeyDown={handleKeyDown}
|
||||
disabled={!isConnected}
|
||||
maxLength={300}
|
||||
placeholder="메시지를 입력하세요"
|
||||
className="w-full resize-none border border-base-content/10 bg-base-content/5 px-2 py-1.5 text-[12px] text-base-content/80 placeholder:text-base-content/25 focus:border-primary/40 focus:outline-none disabled:cursor-not-allowed disabled:text-base-content/30"
|
||||
rows={2}
|
||||
aria-label="경매 채팅 메시지"
|
||||
/>
|
||||
<button
|
||||
type="submit"
|
||||
disabled={!canSend}
|
||||
className="btn btn-primary btn-sm w-full text-[11px]"
|
||||
>
|
||||
<SendHorizontal className="h-3.5 w-3.5" aria-hidden="true" />
|
||||
전송
|
||||
</button>
|
||||
</form>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -3,6 +3,9 @@ import { mapApiMatchToMatchDetail } from '../api/mappers';
|
||||
import { useMatches, useMe } from '../api/hooks';
|
||||
import { DEFAULT_COMMUNITY_ID } from '../config';
|
||||
|
||||
const UPCOMING_GRID_MATCH_LIMIT = 3;
|
||||
const UPCOMING_MATCH_LIST_LIMIT = UPCOMING_GRID_MATCH_LIMIT + 1;
|
||||
|
||||
function StatusBadge({ status }: { status: string }) {
|
||||
const styles: Record<string, string> = {
|
||||
모집중: 'bg-green-500/15 text-green-500 border-green-500/20',
|
||||
@@ -44,7 +47,10 @@ function getStatusLabel(status: string) {
|
||||
}
|
||||
|
||||
export default function HomePage() {
|
||||
const upcomingMatchesQuery = useMatches({ limit: 20 }, DEFAULT_COMMUNITY_ID);
|
||||
const upcomingMatchesQuery = useMatches(
|
||||
{ limit: UPCOMING_MATCH_LIST_LIMIT },
|
||||
DEFAULT_COMMUNITY_ID,
|
||||
);
|
||||
const finishedMatchesQuery = useMatches(
|
||||
{ status: 'finished', limit: 10 },
|
||||
DEFAULT_COMMUNITY_ID,
|
||||
@@ -84,7 +90,10 @@ export default function HomePage() {
|
||||
const finishedMatches =
|
||||
finishedMatchesQuery.data?.map(mapApiMatchToMatchDetail) ?? [];
|
||||
const nextMatch = upcomingMatches[0];
|
||||
const upcomingCards = nextMatch ? upcomingMatches.slice(1) : upcomingMatches;
|
||||
const upcomingCards = (nextMatch
|
||||
? upcomingMatches.slice(1)
|
||||
: upcomingMatches
|
||||
).slice(0, UPCOMING_GRID_MATCH_LIMIT);
|
||||
const currentUser =
|
||||
meQuery.data?.memberships.find(
|
||||
(membership) => membership.community?._id === DEFAULT_COMMUNITY_ID,
|
||||
|
||||
@@ -24,6 +24,7 @@ import { DEFAULT_COMMUNITY_ID, useAuthUserId } from "../config";
|
||||
import { apiFetch, ApiError } from "../lib/api";
|
||||
import { profileIconUrl } from "../lib/ddragon";
|
||||
import {
|
||||
POSITION_ORDER,
|
||||
positionIcon,
|
||||
positionLabel,
|
||||
sideShortLabel,
|
||||
@@ -32,7 +33,9 @@ import {
|
||||
} from "../lib/league";
|
||||
import type {
|
||||
AuctionTopTierThreshold,
|
||||
ApiMatch,
|
||||
ApiMatchParticipant,
|
||||
ApiPositionPreference,
|
||||
ApiTierInfo,
|
||||
ManualTournamentResultCollectResponse,
|
||||
Position,
|
||||
@@ -52,11 +55,62 @@ type CaptainSelection = {
|
||||
const DEFAULT_AUCTION_MAX_TIMER_SECONDS = 30;
|
||||
const DEFAULT_AUCTION_BID_EXTENSION_SECONDS = 5;
|
||||
const MAX_AUCTION_TIMER_SECONDS = 3600;
|
||||
const ALL_PARTICIPANT_FILTER = "all";
|
||||
|
||||
type ParticipantPositionFilter = Position | typeof ALL_PARTICIPANT_FILTER;
|
||||
type ParticipantTierFilter = string | typeof ALL_PARTICIPANT_FILTER;
|
||||
|
||||
const PARTICIPANT_TIER_FILTERS = [
|
||||
"CHALLENGER",
|
||||
"GRANDMASTER",
|
||||
"MASTER",
|
||||
"DIAMOND",
|
||||
"EMERALD",
|
||||
"PLATINUM",
|
||||
"GOLD",
|
||||
"SILVER",
|
||||
"BRONZE",
|
||||
"IRON",
|
||||
"UNRANKED",
|
||||
] as const;
|
||||
|
||||
const PARTICIPANT_TIER_LABELS: Record<string, string> = {
|
||||
CHALLENGER: "챌린저",
|
||||
GRANDMASTER: "그랜드마스터",
|
||||
MASTER: "마스터",
|
||||
DIAMOND: "다이아몬드",
|
||||
EMERALD: "에메랄드",
|
||||
PLATINUM: "플래티넘",
|
||||
GOLD: "골드",
|
||||
SILVER: "실버",
|
||||
BRONZE: "브론즈",
|
||||
IRON: "아이언",
|
||||
UNRANKED: "언랭크",
|
||||
};
|
||||
|
||||
function captainSlotKey(slot: CaptainSelectionSlot) {
|
||||
return String(slot.teamIndex);
|
||||
}
|
||||
|
||||
// 백엔드 reorderPreferredPositions와 동일 규칙. 낙관적 업데이트에서
|
||||
// 캐시된 preferredPositions를 즉시 갱신하는 데 사용한다.
|
||||
function reorderPreferredPositions(
|
||||
mainPosition: Position,
|
||||
subPosition: Position,
|
||||
current: ApiPositionPreference[],
|
||||
): ApiPositionPreference[] {
|
||||
const ordered: Position[] = [mainPosition];
|
||||
if (subPosition !== mainPosition) ordered.push(subPosition);
|
||||
for (const preference of [...current].sort(
|
||||
(left, right) => left.priority - right.priority,
|
||||
)) {
|
||||
if (!ordered.includes(preference.position)) {
|
||||
ordered.push(preference.position);
|
||||
}
|
||||
}
|
||||
return ordered.map((position, index) => ({ position, priority: index + 1 }));
|
||||
}
|
||||
|
||||
function parseInitialPointsInput(value: string) {
|
||||
if (!value.trim()) return null;
|
||||
const points = Number(value);
|
||||
@@ -270,18 +324,94 @@ function statusBadge(status: MatchDetailView["status"]) {
|
||||
}
|
||||
}
|
||||
|
||||
function participantTierFilterValue(participant: ParticipantView) {
|
||||
return participant.tier?.tier ?? "UNRANKED";
|
||||
}
|
||||
|
||||
// PARTICIPANT_TIER_FILTERS는 높은 티어 → 낮은 티어 순서이므로
|
||||
// 인덱스가 작을수록 상위 티어. (없는 값은 최하위로 취급)
|
||||
function tierRank(tier: string) {
|
||||
const index = PARTICIPANT_TIER_FILTERS.indexOf(
|
||||
tier as (typeof PARTICIPANT_TIER_FILTERS)[number],
|
||||
);
|
||||
return index === -1 ? PARTICIPANT_TIER_FILTERS.length : index;
|
||||
}
|
||||
|
||||
type ParticipantRowAdmin = {
|
||||
onRemove: (userId: string) => void;
|
||||
onChangePositions: (
|
||||
userId: string,
|
||||
mainPosition: Position,
|
||||
subPosition: Position,
|
||||
) => void;
|
||||
isRemoving: boolean;
|
||||
isUpdating: boolean;
|
||||
};
|
||||
|
||||
function PositionSelect({
|
||||
value,
|
||||
sub,
|
||||
disabled,
|
||||
onChange,
|
||||
}: {
|
||||
value: Position;
|
||||
sub?: boolean;
|
||||
disabled?: boolean;
|
||||
onChange: (next: Position) => void;
|
||||
}) {
|
||||
return (
|
||||
<select
|
||||
value={value}
|
||||
disabled={disabled}
|
||||
onChange={(event) => onChange(event.target.value as Position)}
|
||||
className={`h-7 border bg-base-100 pl-1.5 pr-1 text-[11px] font-medium focus:border-primary/30 focus:outline-none disabled:opacity-50 ${
|
||||
sub
|
||||
? "border-base-content/10 text-base-content/45"
|
||||
: "border-primary/20 text-primary"
|
||||
}`}
|
||||
>
|
||||
{POSITION_ORDER.map((position) => (
|
||||
<option key={position} value={position}>
|
||||
{positionLabel[position]}
|
||||
</option>
|
||||
))}
|
||||
</select>
|
||||
);
|
||||
}
|
||||
|
||||
function ParticipantRow({
|
||||
participant,
|
||||
index,
|
||||
assignedPos,
|
||||
admin,
|
||||
}: {
|
||||
participant: ParticipantView;
|
||||
index: number;
|
||||
assignedPos?: Position;
|
||||
admin?: ParticipantRowAdmin;
|
||||
}) {
|
||||
const { data: ddragon } = useDdragonManifest();
|
||||
const location = useLocation();
|
||||
const historyBackTo = `${location.pathname}${location.search}${location.hash}`;
|
||||
const [confirmingRemove, setConfirmingRemove] = useState(false);
|
||||
|
||||
// 주/부 포지션이 겹치면 두 값을 맞바꿔 항상 서로 다르게 유지한다.
|
||||
const handleMainChange = (next: Position) => {
|
||||
if (!admin) return;
|
||||
const sub =
|
||||
next === participant.subPosition
|
||||
? participant.mainPosition
|
||||
: participant.subPosition;
|
||||
admin.onChangePositions(participant.userId, next, sub);
|
||||
};
|
||||
const handleSubChange = (next: Position) => {
|
||||
if (!admin) return;
|
||||
const main =
|
||||
next === participant.mainPosition
|
||||
? participant.subPosition
|
||||
: participant.mainPosition;
|
||||
admin.onChangePositions(participant.userId, main, next);
|
||||
};
|
||||
|
||||
return (
|
||||
<tr className="border-b border-base-content/5 last:border-b-0 hover:bg-base-content/[0.02] transition-colors">
|
||||
@@ -324,6 +454,68 @@ function ParticipantRow({
|
||||
<td className="py-2 px-3">
|
||||
<PosBadge pos={assignedPos} />
|
||||
</td>
|
||||
) : admin ? (
|
||||
<>
|
||||
<td className="py-2 px-3">
|
||||
<PositionSelect
|
||||
value={participant.mainPosition}
|
||||
disabled={admin.isUpdating}
|
||||
onChange={handleMainChange}
|
||||
/>
|
||||
</td>
|
||||
<td className="py-2 px-3">
|
||||
<PositionSelect
|
||||
value={participant.subPosition}
|
||||
sub
|
||||
disabled={admin.isUpdating}
|
||||
onChange={handleSubChange}
|
||||
/>
|
||||
</td>
|
||||
<td className="py-2 px-3 w-20 min-w-[5rem] whitespace-nowrap text-right">
|
||||
{confirmingRemove ? (
|
||||
<span className="inline-flex items-center gap-1.5 whitespace-nowrap">
|
||||
<button
|
||||
type="button"
|
||||
disabled={admin.isRemoving}
|
||||
onClick={() => admin.onRemove(participant.userId)}
|
||||
className="text-[10px] font-bold text-red-400 hover:text-red-300 disabled:opacity-50"
|
||||
>
|
||||
{admin.isRemoving ? "제외 중..." : "확인"}
|
||||
</button>
|
||||
<button
|
||||
type="button"
|
||||
onClick={() => setConfirmingRemove(false)}
|
||||
className="text-[10px] text-base-content/35 hover:text-base-content/60"
|
||||
>
|
||||
취소
|
||||
</button>
|
||||
</span>
|
||||
) : (
|
||||
<button
|
||||
type="button"
|
||||
title="참가자 제외"
|
||||
aria-label="참가자 제외"
|
||||
onClick={() => setConfirmingRemove(true)}
|
||||
className="text-base-content/25 hover:text-red-400 transition-colors"
|
||||
>
|
||||
<svg
|
||||
xmlns="http://www.w3.org/2000/svg"
|
||||
className="h-3.5 w-3.5"
|
||||
fill="none"
|
||||
viewBox="0 0 24 24"
|
||||
stroke="currentColor"
|
||||
>
|
||||
<path
|
||||
strokeLinecap="round"
|
||||
strokeLinejoin="round"
|
||||
strokeWidth={2}
|
||||
d="M6 18L18 6M6 6l12 12"
|
||||
/>
|
||||
</svg>
|
||||
</button>
|
||||
)}
|
||||
</td>
|
||||
</>
|
||||
) : (
|
||||
<>
|
||||
<td className="py-2 px-3">
|
||||
@@ -345,6 +537,11 @@ function ParticipantTable({
|
||||
canJoin,
|
||||
onJoin,
|
||||
isJoining,
|
||||
canManage,
|
||||
onRemoveParticipant,
|
||||
onUpdatePositions,
|
||||
removingUserId,
|
||||
updatingUserId,
|
||||
}: {
|
||||
participants: ParticipantView[];
|
||||
maxParticipants: number;
|
||||
@@ -352,7 +549,65 @@ function ParticipantTable({
|
||||
canJoin: boolean;
|
||||
onJoin: () => void;
|
||||
isJoining: boolean;
|
||||
canManage: boolean;
|
||||
onRemoveParticipant: (userId: string) => void;
|
||||
onUpdatePositions: (
|
||||
userId: string,
|
||||
mainPosition: Position,
|
||||
subPosition: Position,
|
||||
) => void;
|
||||
removingUserId: string | null;
|
||||
updatingUserId: string | null;
|
||||
}) {
|
||||
const [positionFilter, setPositionFilter] =
|
||||
useState<ParticipantPositionFilter>(ALL_PARTICIPANT_FILTER);
|
||||
const [tierFilter, setTierFilter] = useState<ParticipantTierFilter>(
|
||||
ALL_PARTICIPANT_FILTER,
|
||||
);
|
||||
const filteredParticipants = participants.filter((participant) => {
|
||||
const matchesPosition =
|
||||
positionFilter === ALL_PARTICIPANT_FILTER ||
|
||||
participant.mainPosition === positionFilter;
|
||||
const matchesTier =
|
||||
tierFilter === ALL_PARTICIPANT_FILTER ||
|
||||
tierRank(participantTierFilterValue(participant)) <= tierRank(tierFilter);
|
||||
|
||||
return matchesPosition && matchesTier;
|
||||
});
|
||||
const isFiltered =
|
||||
positionFilter !== ALL_PARTICIPANT_FILTER ||
|
||||
tierFilter !== ALL_PARTICIPANT_FILTER;
|
||||
const positionFilteredParticipants = participants.filter(
|
||||
(participant) =>
|
||||
positionFilter === ALL_PARTICIPANT_FILTER ||
|
||||
participant.mainPosition === positionFilter,
|
||||
);
|
||||
// "이상" 임계값으로 쓸 수 있는 티어 = 참가자 중 실제 존재하는 티어.
|
||||
// 언랭크는 "이상" 기준으로 전체와 동일하므로 임계값 후보에서 제외한다.
|
||||
const presentTiers = new Set(
|
||||
positionFilteredParticipants.map(participantTierFilterValue),
|
||||
);
|
||||
const availableTiers = PARTICIPANT_TIER_FILTERS.filter(
|
||||
(tier) => tier !== "UNRANKED" && presentTiers.has(tier),
|
||||
);
|
||||
const tierAtOrAboveCounts = new Map<string, number>(
|
||||
availableTiers.map((tier) => [
|
||||
tier,
|
||||
positionFilteredParticipants.filter(
|
||||
(participant) =>
|
||||
tierRank(participantTierFilterValue(participant)) <= tierRank(tier),
|
||||
).length,
|
||||
]),
|
||||
);
|
||||
const positionCounts = new Map<Position, number>(
|
||||
POSITION_ORDER.map((position) => [
|
||||
position,
|
||||
participants.filter(
|
||||
(participant) => participant.mainPosition === position,
|
||||
).length,
|
||||
]),
|
||||
);
|
||||
|
||||
return (
|
||||
<div className="border border-base-content/10 bg-base-100 overflow-hidden">
|
||||
<div className="px-4 py-2.5 border-b border-base-content/10 bg-base-200/40 flex items-center justify-between gap-3">
|
||||
@@ -368,6 +623,86 @@ function ParticipantTable({
|
||||
{joined ? "참가 완료" : isJoining ? "신청 중..." : "참가 신청"}
|
||||
</button>
|
||||
</div>
|
||||
<div className="border-b border-base-content/10 bg-base-100 px-4 py-2.5">
|
||||
<div className="flex flex-wrap items-center gap-x-3 gap-y-2">
|
||||
<div className="inline-flex items-center gap-1">
|
||||
<button
|
||||
type="button"
|
||||
onClick={() => setPositionFilter(ALL_PARTICIPANT_FILTER)}
|
||||
className={`inline-flex h-8 items-center px-2.5 text-[11px] font-semibold border transition-colors ${
|
||||
positionFilter === ALL_PARTICIPANT_FILTER
|
||||
? "border-primary/30 bg-primary/5 text-primary"
|
||||
: "border-base-content/10 text-base-content/40 hover:text-base-content/70"
|
||||
}`}
|
||||
>
|
||||
전체 ({participants.length})
|
||||
</button>
|
||||
{POSITION_ORDER.map((position) => {
|
||||
const active = positionFilter === position;
|
||||
const count = positionCounts.get(position) ?? 0;
|
||||
return (
|
||||
<button
|
||||
key={position}
|
||||
type="button"
|
||||
title={`${positionLabel[position]} (${count}명)`}
|
||||
aria-label={`${positionLabel[position]} (${count}명)`}
|
||||
aria-pressed={active}
|
||||
onClick={() =>
|
||||
setPositionFilter(
|
||||
active ? ALL_PARTICIPANT_FILTER : position,
|
||||
)
|
||||
}
|
||||
className={`inline-flex h-8 items-center gap-1 px-2 text-[11px] font-semibold border transition-colors ${
|
||||
active
|
||||
? "border-primary/30 bg-primary/5 text-primary"
|
||||
: "border-base-content/10 text-base-content/40 hover:text-base-content/70"
|
||||
}`}
|
||||
>
|
||||
<img
|
||||
src={positionIcon[position]}
|
||||
alt=""
|
||||
className="h-3.5 w-3.5 object-contain"
|
||||
/>
|
||||
<span className="hidden sm:inline">
|
||||
{positionLabel[position]}
|
||||
</span>
|
||||
<span className="tabular-nums">({count})</span>
|
||||
</button>
|
||||
);
|
||||
})}
|
||||
</div>
|
||||
<select
|
||||
className="h-8 border border-base-content/10 bg-base-100 px-2 text-xs text-base-content focus:border-primary/30 focus:outline-none"
|
||||
value={tierFilter}
|
||||
onChange={(event) => setTierFilter(event.target.value)}
|
||||
>
|
||||
<option value={ALL_PARTICIPANT_FILTER}>티어 전체</option>
|
||||
{availableTiers.map((tier) => (
|
||||
<option key={tier} value={tier}>
|
||||
{PARTICIPANT_TIER_LABELS[tier]} 이상 (
|
||||
{tierAtOrAboveCounts.get(tier)})
|
||||
</option>
|
||||
))}
|
||||
</select>
|
||||
<div className="ml-auto flex items-center gap-2 text-[11px] text-base-content/35">
|
||||
<span>
|
||||
{filteredParticipants.length}/{participants.length}명
|
||||
</span>
|
||||
{isFiltered && (
|
||||
<button
|
||||
type="button"
|
||||
className="btn btn-ghost btn-xs h-8 min-h-8 px-2 text-[11px] text-base-content/40"
|
||||
onClick={() => {
|
||||
setPositionFilter(ALL_PARTICIPANT_FILTER);
|
||||
setTierFilter(ALL_PARTICIPANT_FILTER);
|
||||
}}
|
||||
>
|
||||
초기화
|
||||
</button>
|
||||
)}
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
<div className="overflow-x-auto">
|
||||
<table className="w-full text-left">
|
||||
<thead>
|
||||
@@ -377,16 +712,42 @@ function ParticipantTable({
|
||||
<th className="py-2 px-3">현재 티어</th>
|
||||
<th className="py-2 px-3">주 포지션</th>
|
||||
<th className="py-2 px-3">부 포지션</th>
|
||||
{canManage && (
|
||||
<th className="py-2 px-3 w-20 min-w-[5rem] whitespace-nowrap text-right">
|
||||
관리
|
||||
</th>
|
||||
)}
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
{participants.map((participant, index) => (
|
||||
<ParticipantRow
|
||||
key={participant.id}
|
||||
participant={participant}
|
||||
index={index}
|
||||
/>
|
||||
))}
|
||||
{filteredParticipants.length > 0 ? (
|
||||
filteredParticipants.map((participant, index) => (
|
||||
<ParticipantRow
|
||||
key={participant.id}
|
||||
participant={participant}
|
||||
index={index}
|
||||
admin={
|
||||
canManage
|
||||
? {
|
||||
onRemove: onRemoveParticipant,
|
||||
onChangePositions: onUpdatePositions,
|
||||
isRemoving: removingUserId === participant.userId,
|
||||
isUpdating: updatingUserId === participant.userId,
|
||||
}
|
||||
: undefined
|
||||
}
|
||||
/>
|
||||
))
|
||||
) : (
|
||||
<tr>
|
||||
<td
|
||||
colSpan={canManage ? 6 : 5}
|
||||
className="px-3 py-8 text-center text-sm text-base-content/35"
|
||||
>
|
||||
조건에 맞는 참가자가 없습니다.
|
||||
</td>
|
||||
</tr>
|
||||
)}
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
@@ -1065,6 +1426,89 @@ export default function MatchDetailPage() {
|
||||
},
|
||||
});
|
||||
|
||||
const matchQueryKey = ["match", DEFAULT_COMMUNITY_ID, id ?? null];
|
||||
|
||||
const removeParticipantMutation = useMutation({
|
||||
mutationFn: (userId: string) =>
|
||||
apiFetch(
|
||||
`/communities/${DEFAULT_COMMUNITY_ID}/matches/${id}/participants/${userId}`,
|
||||
{ method: "DELETE" },
|
||||
),
|
||||
onMutate: async (userId: string) => {
|
||||
await queryClient.cancelQueries({ queryKey: matchQueryKey });
|
||||
const previous = queryClient.getQueryData<ApiMatch>(matchQueryKey);
|
||||
if (previous) {
|
||||
queryClient.setQueryData<ApiMatch>(matchQueryKey, {
|
||||
...previous,
|
||||
participants: previous.participants.filter(
|
||||
(participant) => participant.userId !== userId,
|
||||
),
|
||||
});
|
||||
}
|
||||
return { previous };
|
||||
},
|
||||
onError: (_error, _userId, context) => {
|
||||
if (context?.previous) {
|
||||
queryClient.setQueryData(matchQueryKey, context.previous);
|
||||
}
|
||||
},
|
||||
onSettled: () => {
|
||||
void queryClient.invalidateQueries({ queryKey: matchQueryKey });
|
||||
void queryClient.invalidateQueries({
|
||||
queryKey: ["matches", DEFAULT_COMMUNITY_ID],
|
||||
});
|
||||
},
|
||||
});
|
||||
|
||||
const updateParticipantMutation = useMutation({
|
||||
mutationFn: ({
|
||||
userId,
|
||||
mainPosition,
|
||||
subPosition,
|
||||
}: {
|
||||
userId: string;
|
||||
mainPosition: Position;
|
||||
subPosition: Position;
|
||||
}) =>
|
||||
apiFetch(
|
||||
`/communities/${DEFAULT_COMMUNITY_ID}/matches/${id}/participants/${userId}`,
|
||||
{
|
||||
method: "PATCH",
|
||||
body: JSON.stringify({ mainPosition, subPosition }),
|
||||
},
|
||||
),
|
||||
onMutate: async ({ userId, mainPosition, subPosition }) => {
|
||||
await queryClient.cancelQueries({ queryKey: matchQueryKey });
|
||||
const previous = queryClient.getQueryData<ApiMatch>(matchQueryKey);
|
||||
if (previous) {
|
||||
queryClient.setQueryData<ApiMatch>(matchQueryKey, {
|
||||
...previous,
|
||||
participants: previous.participants.map((participant) =>
|
||||
participant.userId === userId
|
||||
? {
|
||||
...participant,
|
||||
preferredPositions: reorderPreferredPositions(
|
||||
mainPosition,
|
||||
subPosition,
|
||||
participant.preferredPositions,
|
||||
),
|
||||
}
|
||||
: participant,
|
||||
),
|
||||
});
|
||||
}
|
||||
return { previous };
|
||||
},
|
||||
onError: (_error, _variables, context) => {
|
||||
if (context?.previous) {
|
||||
queryClient.setQueryData(matchQueryKey, context.previous);
|
||||
}
|
||||
},
|
||||
onSettled: () => {
|
||||
void queryClient.invalidateQueries({ queryKey: matchQueryKey });
|
||||
},
|
||||
});
|
||||
|
||||
const startAuctionMutation = useMutation({
|
||||
mutationFn: () =>
|
||||
apiFetch(`/communities/${DEFAULT_COMMUNITY_ID}/matches/${id}/auction`, {
|
||||
@@ -1335,6 +1779,18 @@ export default function MatchDetailPage() {
|
||||
</div>
|
||||
)}
|
||||
|
||||
{removeParticipantMutation.error instanceof Error && (
|
||||
<div className="mb-4 border border-red-500/20 bg-red-500/10 px-4 py-3 text-sm text-red-500">
|
||||
{removeParticipantMutation.error.message}
|
||||
</div>
|
||||
)}
|
||||
|
||||
{updateParticipantMutation.error instanceof Error && (
|
||||
<div className="mb-4 border border-red-500/20 bg-red-500/10 px-4 py-3 text-sm text-red-500">
|
||||
{updateParticipantMutation.error.message}
|
||||
</div>
|
||||
)}
|
||||
|
||||
{pollTournamentResultMutation.error instanceof Error && (
|
||||
<div className="mb-4 border border-red-500/20 bg-red-500/10 px-4 py-3 text-sm text-red-500">
|
||||
{pollTournamentResultMutation.error.message}
|
||||
@@ -1366,6 +1822,27 @@ export default function MatchDetailPage() {
|
||||
canJoin={canUseMemberActions}
|
||||
onJoin={() => joinMatchMutation.mutate()}
|
||||
isJoining={joinMatchMutation.isPending}
|
||||
canManage={canManageAuction}
|
||||
onRemoveParticipant={(userId) =>
|
||||
removeParticipantMutation.mutate(userId)
|
||||
}
|
||||
onUpdatePositions={(userId, mainPosition, subPosition) =>
|
||||
updateParticipantMutation.mutate({
|
||||
userId,
|
||||
mainPosition,
|
||||
subPosition,
|
||||
})
|
||||
}
|
||||
removingUserId={
|
||||
removeParticipantMutation.isPending
|
||||
? (removeParticipantMutation.variables ?? null)
|
||||
: null
|
||||
}
|
||||
updatingUserId={
|
||||
updateParticipantMutation.isPending
|
||||
? (updateParticipantMutation.variables?.userId ?? null)
|
||||
: null
|
||||
}
|
||||
/>
|
||||
|
||||
{isCheckingPermissions ? (
|
||||
|
||||
@@ -1,4 +1,4 @@
|
||||
import { useState } from "react";
|
||||
import { lazy, Suspense, useState } from "react";
|
||||
import { useQueryClient } from "@tanstack/react-query";
|
||||
import { ChevronDown, ChevronUp } from "lucide-react";
|
||||
import { Link, useLocation, useParams, useSearchParams } from "react-router";
|
||||
@@ -43,6 +43,8 @@ import {
|
||||
QUEUE_GROUP_TABS,
|
||||
RANK_FILTER_TABS,
|
||||
} from "../lib/riot-history";
|
||||
// recharts가 무거워 메인 번들에서 분리한다 (전적 페이지에서만 로드).
|
||||
const TierHistoryChart = lazy(() => import("../components/TierHistoryChart"));
|
||||
|
||||
type ChampionSortKey = "games" | "winRate" | "kda" | "avgCsPerMin";
|
||||
|
||||
@@ -1294,6 +1296,16 @@ export default function UserHistoryPage() {
|
||||
)}
|
||||
</section>
|
||||
|
||||
{profile.tierHistory.length > 0 && (
|
||||
<Suspense
|
||||
fallback={
|
||||
<div className="mb-5 h-[180px] border border-base-content/10 bg-base-100" />
|
||||
}
|
||||
>
|
||||
<TierHistoryChart entries={profile.tierHistory} />
|
||||
</Suspense>
|
||||
)}
|
||||
|
||||
<section className="border border-base-content/10 bg-base-100 mb-5">
|
||||
<div className="flex flex-wrap border-b border-base-content/8">
|
||||
{QUEUE_GROUP_TABS.map((tab) => (
|
||||
|
||||
+60
-1
@@ -1,10 +1,69 @@
|
||||
import { defineConfig } from "vite";
|
||||
import react from "@vitejs/plugin-react";
|
||||
import tailwindcss from "@tailwindcss/vite";
|
||||
import { createRequire } from "node:module";
|
||||
import fs from "node:fs";
|
||||
import path from "node:path";
|
||||
|
||||
const ES_TOOLKIT_COMPAT_RE = /^es-toolkit\/compat\/[A-Za-z0-9_$]+$/;
|
||||
const VIRTUAL_ES_TOOLKIT_COMPAT_PREFIX = "\0es-toolkit-compat-esm:";
|
||||
|
||||
function esToolkitCompatEsm() {
|
||||
return {
|
||||
name: "es-toolkit-compat-esm",
|
||||
enforce: "pre" as const,
|
||||
resolveId(source: string, importer?: string) {
|
||||
if (!importer || !ES_TOOLKIT_COMPAT_RE.test(source)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const requireFromImporter = createRequire(importer);
|
||||
const wrapperPath = requireFromImporter.resolve(source);
|
||||
const wrapperSource = fs.readFileSync(wrapperPath, "utf8");
|
||||
const wrapperMatch = wrapperSource.match(
|
||||
/require\(['"](\.\.\/dist\/compat\/[^'"]+)\.js['"]\)\.([A-Za-z0-9_$]+)/,
|
||||
);
|
||||
|
||||
if (!wrapperMatch) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const [, esmPathWithoutExtension, exportName] = wrapperMatch;
|
||||
const esmPath = path.resolve(
|
||||
path.dirname(wrapperPath),
|
||||
`${esmPathWithoutExtension}.mjs`,
|
||||
);
|
||||
|
||||
return `${VIRTUAL_ES_TOOLKIT_COMPAT_PREFIX}${encodeURIComponent(
|
||||
exportName,
|
||||
)}:${encodeURIComponent(esmPath)}`;
|
||||
},
|
||||
load(id: string) {
|
||||
if (!id.startsWith(VIRTUAL_ES_TOOLKIT_COMPAT_PREFIX)) {
|
||||
return null;
|
||||
}
|
||||
|
||||
const [encodedExportName, encodedEsmPath] = id
|
||||
.slice(VIRTUAL_ES_TOOLKIT_COMPAT_PREFIX.length)
|
||||
.split(":");
|
||||
const exportName = decodeURIComponent(encodedExportName);
|
||||
const esmPath = decodeURIComponent(encodedEsmPath);
|
||||
|
||||
return `export { ${exportName} as default, ${exportName} } from ${JSON.stringify(
|
||||
esmPath,
|
||||
)};`;
|
||||
},
|
||||
};
|
||||
}
|
||||
|
||||
// https://vite.dev/config/
|
||||
export default defineConfig({
|
||||
plugins: [react(), tailwindcss()],
|
||||
plugins: [esToolkitCompatEsm(), react(), tailwindcss()],
|
||||
optimizeDeps: {
|
||||
rolldownOptions: {
|
||||
plugins: [esToolkitCompatEsm()],
|
||||
},
|
||||
},
|
||||
server: {
|
||||
host: "0.0.0.0",
|
||||
allowedHosts: ["126.dahyeon.us"],
|
||||
|
||||
File diff suppressed because it is too large.
Load diff
Binary file not shown.
|
After Width: | Height: | Size: 54 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 88 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 54 KiB |
@@ -1,598 +0,0 @@
|
||||
# Microsoft Entra ID OIDC 로그인 도입 플랜
|
||||
|
||||
> **대상**: codex 가 이어서 진행 가능한 수준의 실행 플랜
|
||||
> **레포**: `/Users/dahyeon/source/lolympus-tournament-support` (pnpm workspace)
|
||||
> **작성 기준**: 2026-04-25
|
||||
> **선행 상태**: dakao NATS 통합, RiotAccount enrichment(force=true 동기 호출, summoner/league/mastery v4) 1차 구현 완료. 인증은 여전히 `X-Auth-User-Id` 헤더 기반.
|
||||
|
||||
---
|
||||
|
||||
## 1. Context
|
||||
|
||||
현재 인증은 `apps/api/src/modules/auth/auth.middleware.ts` 가 `X-Auth-User-Id` 헤더 (Mongo ObjectId) 를 읽어 User 를 `req.user` 에 붙이는 임시 방식입니다. 프로덕션으로 가려면 진짜 OIDC 로그인이 필요합니다.
|
||||
|
||||
다른 프로젝트에서 검증된 `apps/api/src/modules/auth/jwt.guard.ts`, `jwt.service.ts` 를 이식해 **Microsoft Entra ID 단일 IdP** OIDC 인증으로 교체합니다. 결정:
|
||||
|
||||
- **Identity 모델**: Top-level `Identity` 컬렉션 신설. User 는 community 별로 유지하되 `identityId` 로 Identity 를 가리킴. 한 Entra 사용자가 여러 community 에 멤버가 되는 모델을 자연스럽게 표현.
|
||||
- **첫 로그인**: `/me` 가 빈 `memberships` 반환. 자동 멤버십 생성 없음. 프론트가 "커뮤니티 만들기/초대 받기" 분기.
|
||||
- **프론트엔드 통합**: `@azure/msal-browser` + `@azure/msal-react` 로 같은 변경 묶음에 포함.
|
||||
- **Dev fallback**: `AUTH_DEV_HEADER_ENABLED=true` + `NODE_ENV !== 'prod'` 일 때만 `X-Auth-User-Id` 헤더 허용.
|
||||
|
||||
dakao NATS 경로(카카오 명령) 는 HTTP 미들웨어/가드를 거치지 않으므로 그대로 보존됩니다.
|
||||
|
||||
---
|
||||
|
||||
## 2. 결정된 설계
|
||||
|
||||
### 2.1 `Identity` 컬렉션 (신규)
|
||||
|
||||
```ts
|
||||
// apps/api/src/modules/global/database/schema.ts
|
||||
export interface Identity extends MongooseTimestamps {
|
||||
entraOid: string; // Entra 'oid' claim (tenant 내 유일)
|
||||
tenantId?: string; // 'tid' claim — 다중 테넌트 대비
|
||||
email?: string; // preferred_username
|
||||
displayName?: string; // name
|
||||
lastSignInAt?: Date;
|
||||
}
|
||||
|
||||
export const IdentitySchema = new Schema<Identity>({
|
||||
entraOid: { type: String, required: true },
|
||||
tenantId: { type: String },
|
||||
email: { type: String },
|
||||
displayName: { type: String },
|
||||
lastSignInAt: { type: Date },
|
||||
}, { timestamps: true, collection: 'identity' });
|
||||
|
||||
IdentitySchema.index({ entraOid: 1 }, { unique: true });
|
||||
IdentitySchema.index({ email: 1 });
|
||||
```
|
||||
|
||||
`tournamentModelDefinitions` 에 `{ name: 'identity', schema: IdentitySchema, schemaName: 'identity' }` 추가, `TournamentModelTypes` 에 `identity: Identity` 추가.
|
||||
|
||||
### 2.2 `User` 변경
|
||||
|
||||
```ts
|
||||
export interface User {
|
||||
// 기존 필드 유지
|
||||
identityId?: mongoose.Types.ObjectId;
|
||||
}
|
||||
```
|
||||
|
||||
스키마/인덱스:
|
||||
|
||||
```ts
|
||||
identityId: { type: Schema.Types.ObjectId, ref: 'identity' },
|
||||
// ...
|
||||
UserSchema.index(
|
||||
{ communityId: 1, identityId: 1 },
|
||||
{ unique: true, sparse: true },
|
||||
);
|
||||
UserSchema.index({ identityId: 1 }, { sparse: true });
|
||||
```
|
||||
|
||||
같은 사람이 한 community 에 두 번 등록되지 못하게 `{ communityId, identityId }` unique sparse. 글로벌 `{ identityId }` 로 한 사람의 모든 멤버십 빠른 조회.
|
||||
|
||||
기존 `kakaoTalkId`, `discordId` 인덱스/필드는 유지. dakao 사용자가 추후 Entra 로 로그인하면 같은 community 에서 별도 User 가 생기지 않도록 후속 "계정 연결" 플로우는 별도 작업(이번 범위 외).
|
||||
|
||||
### 2.3 인증 파이프라인
|
||||
|
||||
```
|
||||
HTTP Request
|
||||
└ JwtAuthGuard (verify JWT, req.tokenPayload 채움)
|
||||
└ IdentityResolverGuard (oid → Identity 조회/upsert, req.identity)
|
||||
└ (라우트별) UserResolverInterceptor (path :communityId + identityId → req.user)
|
||||
└ RolesGuard (req.user.role 검증)
|
||||
```
|
||||
|
||||
- `JwtAuthGuard`, `IdentityResolverGuard` 는 `APP_GUARD` 로 글로벌 등록.
|
||||
- `UserResolverInterceptor` 는 `:communityId` path 파라미터를 가진 community 라우트에 `@UseInterceptors` 로 명시 적용.
|
||||
- `@AllowPublicAccess()` 메타데이터가 붙은 라우트는 두 글로벌 가드를 통과(JWT 없어도 됨). 토큰이 있으면 `req.identity` 까지는 채워줌(soft auth).
|
||||
|
||||
### 2.4 `request` 필드 명세
|
||||
|
||||
| 필드 | 타입 | 의미 | 누가 채우나 |
|
||||
| --- | --- | --- | --- |
|
||||
| `request.tokenPayload` | `JWTPayload \| undefined` | 검증된 JWT claims | `JwtAuthGuard` |
|
||||
| `request.identityProvider` | `IdentityProviderName` | 발행자 | `JwtAuthGuard` |
|
||||
| `request.identity` | `IdentityDocument \| undefined` | DB Identity | `IdentityResolverGuard` |
|
||||
| `request.user` | `UserDocument \| undefined` | community 멤버십 User | `UserResolverInterceptor` 또는 dev fallback |
|
||||
|
||||
기존 `request.user` 시맨틱(UserDocument)을 유지해 `RolesGuard` / `@CurrentUser()` 호환성 보존.
|
||||
|
||||
### 2.5 Dev fallback
|
||||
|
||||
`JwtAuthGuard` 또는 별도 `AuthDevFallbackMiddleware` 안에서:
|
||||
|
||||
```ts
|
||||
if (
|
||||
!authzHeader &&
|
||||
process.env.NODE_ENV !== 'prod' &&
|
||||
process.env.AUTH_DEV_HEADER_ENABLED === 'true'
|
||||
) {
|
||||
const userId = request.headers['x-auth-user-id'];
|
||||
if (userId && isValidObjectId(userId)) {
|
||||
const user = await UserModel.findById(userId).exec();
|
||||
if (user) {
|
||||
request.user = user;
|
||||
if (user.identityId) {
|
||||
request.identity = await IdentityModel.findById(user.identityId).exec();
|
||||
}
|
||||
return true;
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
`prod` 에서는 환경변수 무시.
|
||||
|
||||
### 2.6 `@AllowPublicAccess()` 적용 라우트
|
||||
|
||||
| 라우트 | 이유 |
|
||||
| --- | --- |
|
||||
| `RiotWebhookController.captureTournamentWebhook` | 외부 webhook |
|
||||
| `CommunityController.createCommunity` | 가입 (MVP 호환을 위해 공개 유지하되 토큰이 있으면 token identity 우선) |
|
||||
| `CommunityController.getCommunity` | 공개 정보 |
|
||||
| `MatchController.listMatches`, `getMatch` | 공개 읽기 |
|
||||
| `UserController.getMe` | 토큰 있으면 채워주고 없으면 빈 응답 |
|
||||
|
||||
### 2.7 엔드포인트 동작 변경
|
||||
|
||||
#### `GET /me`
|
||||
|
||||
**Before**: `{ user: UserDocument | null }`
|
||||
|
||||
**After**:
|
||||
|
||||
```jsonc
|
||||
{
|
||||
"identity": {
|
||||
"id": "...",
|
||||
"entraOid": "f0e47b9f-00cd-...",
|
||||
"email": "park@dahyeon.us",
|
||||
"displayName": "박 다현"
|
||||
} /* | null */,
|
||||
"memberships": [
|
||||
{
|
||||
"user": { /* UserDocument */ },
|
||||
"community": { "id": "...", "name": "..." }
|
||||
}
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
- 토큰 없이 호출하면 `{ identity: null, memberships: [] }`.
|
||||
- `memberships` 가 빈 배열이면 프론트는 "community 만들기 / 초대 받기" UI 분기.
|
||||
|
||||
#### `POST /communities`
|
||||
|
||||
owner 정보를 body 에서 받지 않고 `req.identity` + 새 community 에 owner User 자동 생성. 기존 `CreateCommunityDto.owner` 는 deprecated. dev fallback 시에는 body 도 backward compat 으로 허용.
|
||||
|
||||
#### `PATCH /communities/:communityId/...`, `POST /communities/:communityId/matches/...`
|
||||
|
||||
`UserResolverInterceptor` 가 path 의 `communityId` + `req.identity._id` 로 User 를 찾아 `req.user` 에 주입. 못 찾으면 `RolesGuard` 가 `ForbiddenException('No membership in this community.')`.
|
||||
|
||||
### 2.8 WebSocket (auction gateway)
|
||||
|
||||
- 클라이언트: `io('/auction', { auth: { token: <bearer> } })`
|
||||
- 서버: `handleConnection` 에서 `socket.handshake.auth.token` 을 `JwtService.verify()` 로 검증, identity → user 조회, `socket.data.user` 에 저장.
|
||||
- dev fallback: `socket.handshake.auth['x-auth-user-id']` 도 dev 환경에서 허용.
|
||||
- 인증 실패 시 `socket.disconnect(true)`.
|
||||
|
||||
### 2.9 프론트엔드 (apps/web)
|
||||
|
||||
#### 의존성
|
||||
|
||||
```bash
|
||||
pnpm --filter web add @azure/msal-browser @azure/msal-react
|
||||
```
|
||||
|
||||
#### 환경변수 (`apps/web/.env`, `.env.example`)
|
||||
|
||||
- `VITE_MSAL_CLIENT_ID` — Azure App 등록의 Application (client) ID
|
||||
- `VITE_MSAL_AUTHORITY` — `https://login.microsoftonline.com/<tenantId>`
|
||||
- `VITE_MSAL_API_SCOPE` — 예: `api://lolympus-api/access_as_user`
|
||||
- `VITE_MSAL_REDIRECT_URI` — 예: `http://localhost:5173/auth/callback`
|
||||
|
||||
#### 신규 파일
|
||||
|
||||
- `apps/web/src/lib/auth/msal.config.ts` — `PublicClientApplication` 인스턴스
|
||||
- `apps/web/src/lib/auth/MsalAppProvider.tsx` — `MsalProvider` 래핑 + redirect 처리
|
||||
- `apps/web/src/lib/auth/use-access-token.ts` — `acquireTokenSilent → acquireTokenPopup/Redirect` fallback
|
||||
- `apps/web/src/pages/Login.tsx` — 로그인 진입
|
||||
- `apps/web/src/pages/AuthCallback.tsx` — redirect 콜백
|
||||
- `apps/web/src/components/CommunitySwitcher.tsx` — memberships > 1 일 때 active community 선택
|
||||
|
||||
#### 수정 파일
|
||||
|
||||
- `apps/web/src/main.tsx` — `MsalAppProvider` 로 앱 감싸기
|
||||
- `apps/web/src/lib/api.ts` — `apiFetch` 가 `acquireTokenSilent` 후 `Authorization: Bearer ...` 첨부, 401 시 재로그인 트리거
|
||||
- `apps/web/src/lib/socket.ts` (또는 socket 초기화 파일) — `io({ auth: { token } })`
|
||||
- `apps/web/src/config.ts` — `getAuthUserId/setAuthUserId/useAuthUserId` 는 `import.meta.env.DEV` 분기로 격리
|
||||
- `apps/web/src/components/DevAuthSwitcher.tsx` — `import.meta.env.DEV` 빌드에서만 렌더
|
||||
|
||||
#### `/me` consumer
|
||||
|
||||
- `useMe()` 훅 결과 모양 변경 (`{ identity, memberships }`)
|
||||
- header 의 사용자 표시: `identity.displayName ?? identity.email`
|
||||
- admin 가시성: `memberships.find(m => m.community.id === activeCommunityId)?.user.role`
|
||||
|
||||
### 2.10 Azure App Registration 체크리스트
|
||||
|
||||
운영자 작업 (코드 외):
|
||||
|
||||
1. App Registration 생성 (single-tenant 권장)
|
||||
2. Authentication 플랫폼 추가:
|
||||
- SPA: redirect URI = `http://localhost:5173/auth/callback`, 프로덕션 URL 추가
|
||||
3. Expose an API:
|
||||
- Application ID URI = `api://lolympus-api`
|
||||
- Scope 추가 = `access_as_user`
|
||||
- Authorized client applications (자기 자신 추가)
|
||||
4. Token configuration: optional claim `email`, `preferred_username` 활성화
|
||||
|
||||
Infisical 시크릿 추가:
|
||||
|
||||
- `MICROSOFT_ENTRAID_TENANT_ID`
|
||||
- `MICROSOFT_ENTRAID_ALLOWED_ALGS=RS256`
|
||||
- `JWT_CLAIM_AUDIENCE` = Application ID URI
|
||||
- `AUTH_DEV_HEADER_ENABLED=true` (dev/staging 환경만)
|
||||
|
||||
`SecretService.PROCESS_ENVS` 에 `JWT_CLAIM_AUDIENCE`, `MICROSOFT_ENTRAID_TENANT_ID`, `MICROSOFT_ENTRAID_ALLOWED_ALGS`, `AUTH_DEV_HEADER_ENABLED` 추가.
|
||||
|
||||
---
|
||||
|
||||
## 3. 실행 단계 (codex 진행 순서)
|
||||
|
||||
작업 단위는 PR 단위로 쪼갤 수 있도록 분리되어 있습니다.
|
||||
|
||||
### Step 1. 스키마 변경
|
||||
|
||||
**파일**: `apps/api/src/modules/global/database/schema.ts`
|
||||
|
||||
- `Identity` 인터페이스/스키마/인덱스 추가
|
||||
- `tournamentModelDefinitions` 에 등록, `TournamentModelTypes` 확장
|
||||
- `User.identityId` optional 필드 + 인덱스 추가
|
||||
- `UserDocument` / `IdentityDocument` 타입 export
|
||||
|
||||
### Step 2. `AllowPublicAccess` 데코레이터
|
||||
|
||||
**신규**: `apps/api/src/modules/auth/allow-public-access.decorator.ts`
|
||||
|
||||
```ts
|
||||
export const METADATA_KEY_IS_PUBLIC_ACCESS_ALLOWED = 'allow_public_access';
|
||||
export const AllowPublicAccess = () =>
|
||||
SetMetadata(METADATA_KEY_IS_PUBLIC_ACCESS_ALLOWED, true);
|
||||
```
|
||||
|
||||
### Step 3. JwtService / JwtAuthGuard 이식
|
||||
|
||||
**신규**: `apps/api/src/modules/auth/jwt.service.ts`, `apps/api/src/modules/auth/jwt.guard.ts`
|
||||
|
||||
- 다른 프로젝트의 참고 코드를 그대로 이식하되 `import` 경로는 `../global/secret/secret.service` 로 수정
|
||||
- `jose` 의존성 추가: `pnpm --filter api add jose`
|
||||
- `JwtAuthGuard` 의 동작 변경: `request.tokenPayload = payload` (기존 `request.user` 가 아닌)
|
||||
- public access 시 토큰이 있으면 검증 시도, 없으면 그냥 통과 (soft auth)
|
||||
|
||||
### Step 4. IdentityService + IdentityResolverGuard
|
||||
|
||||
**신규**: `apps/api/src/modules/auth/identity.service.ts`
|
||||
|
||||
```ts
|
||||
@Injectable()
|
||||
export class IdentityService {
|
||||
constructor(private readonly connectionService: ConnectionService) {}
|
||||
|
||||
async findOrCreateByOid(payload: {
|
||||
entraOid: string;
|
||||
tenantId?: string;
|
||||
email?: string;
|
||||
displayName?: string;
|
||||
}): Promise<IdentityDocument> {
|
||||
const IdentityModel = await this.connectionService.getModel('identity');
|
||||
return IdentityModel.findOneAndUpdate(
|
||||
{ entraOid: payload.entraOid },
|
||||
{
|
||||
$set: {
|
||||
email: payload.email,
|
||||
displayName: payload.displayName,
|
||||
tenantId: payload.tenantId,
|
||||
lastSignInAt: new Date(),
|
||||
},
|
||||
$setOnInsert: { entraOid: payload.entraOid },
|
||||
},
|
||||
{ upsert: true, returnDocument: 'after', setDefaultsOnInsert: true },
|
||||
).exec();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
**신규**: `apps/api/src/modules/auth/identity-resolver.guard.ts`
|
||||
|
||||
`request.tokenPayload` 가 있으면 `IdentityService.findOrCreateByOid` 호출해 `request.identity` 채움. public 라우트에서도 토큰 있으면 채워줌.
|
||||
|
||||
### Step 5. UserResolverInterceptor
|
||||
|
||||
**신규**: `apps/api/src/modules/auth/user-resolver.interceptor.ts`
|
||||
|
||||
```ts
|
||||
@Injectable()
|
||||
export class UserResolverInterceptor implements NestInterceptor {
|
||||
constructor(private readonly connectionService: ConnectionService) {}
|
||||
|
||||
async intercept(ctx: ExecutionContext, next: CallHandler) {
|
||||
const req = ctx.switchToHttp().getRequest();
|
||||
const communityId = req.params?.communityId;
|
||||
if (req.identity && communityId && isValidObjectId(communityId)) {
|
||||
const UserModel = await this.connectionService.getModel('user');
|
||||
req.user = await UserModel.findOne({
|
||||
communityId: new mongoose.Types.ObjectId(communityId),
|
||||
identityId: req.identity._id,
|
||||
}).exec();
|
||||
}
|
||||
return next.handle();
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
community 라우트 controller 들 (Match, Auction, Community 의 `:communityId` 라우트) 에 `@UseInterceptors(UserResolverInterceptor)` 적용.
|
||||
|
||||
### Step 6. AuthModule 재구성
|
||||
|
||||
**파일**: `apps/api/src/modules/auth/auth.module.ts`
|
||||
|
||||
```ts
|
||||
@Global()
|
||||
@Module({
|
||||
imports: [SecretModule],
|
||||
providers: [
|
||||
JwtService,
|
||||
JwtAuthGuard,
|
||||
IdentityService,
|
||||
IdentityResolverGuard,
|
||||
UserResolverInterceptor,
|
||||
AuthService, // dev fallback 전용으로 축소
|
||||
RolesGuard,
|
||||
{ provide: APP_GUARD, useClass: JwtAuthGuard },
|
||||
{ provide: APP_GUARD, useClass: IdentityResolverGuard },
|
||||
],
|
||||
exports: [JwtService, IdentityService, RolesGuard, UserResolverInterceptor],
|
||||
})
|
||||
export class AuthModule {}
|
||||
```
|
||||
|
||||
### Step 7. AuthMiddleware → AuthService dev fallback 으로 축소
|
||||
|
||||
**파일**: `apps/api/src/modules/auth/auth.middleware.ts`, `auth.service.ts`
|
||||
|
||||
- `AuthModule.configure` 에서 글로벌 미들웨어 등록 제거
|
||||
- `auth.service.ts` 는 dev fallback 메서드만 노출. `JwtAuthGuard` 내부에서 호출하거나 별도 미들웨어로 dev only 등록
|
||||
|
||||
### Step 8. RolesGuard 호환 보강
|
||||
|
||||
**파일**: `apps/api/src/modules/auth/roles.guard.ts`
|
||||
|
||||
- 동작 그대로. `req.user` 가 `UserDocument` 면 OK
|
||||
- `request.identity` 만 있고 `request.user` 가 없을 때 메시지: `ForbiddenException('No membership in this community.')`
|
||||
|
||||
### Step 9. `/me` 엔드포인트 변경
|
||||
|
||||
**파일**: `apps/api/src/modules/user/user.controller.ts`, `apps/api/src/modules/user/dto/me-response.dto.ts` (신규)
|
||||
|
||||
```ts
|
||||
@Get('me')
|
||||
@AllowPublicAccess()
|
||||
async getMe(@Req() req): Promise<MeResponse> {
|
||||
if (!req.identity) return { identity: null, memberships: [] };
|
||||
const UserModel = await this.connectionService.getModel('user');
|
||||
const CommunityModel = await this.connectionService.getModel('community');
|
||||
const users = await UserModel.find({ identityId: req.identity._id }).exec();
|
||||
const communities = await CommunityModel.find({
|
||||
_id: { $in: users.map((u) => u.communityId) },
|
||||
}).exec();
|
||||
return {
|
||||
identity: serializeIdentity(req.identity),
|
||||
memberships: users.map((u) => ({
|
||||
user: u,
|
||||
community: communities.find((c) => c._id.equals(u.communityId)),
|
||||
})),
|
||||
};
|
||||
}
|
||||
```
|
||||
|
||||
`@CurrentIdentity()` 데코레이터 추가 시 `req.identity` 직접 주입 가능.
|
||||
|
||||
### Step 10. Community 생성 흐름
|
||||
|
||||
**파일**: `apps/api/src/modules/community/community.controller.ts`, `community.service.ts`, `dto/create-community.dto.ts`
|
||||
|
||||
- `createCommunity` 가 `req.identity` 가 있으면 owner User 의 `identityId` 자동 설정
|
||||
- body 의 `owner` 필드는 dev fallback / backward compat 으로만 사용
|
||||
|
||||
### Step 11. Public access 라우트 표시
|
||||
|
||||
위 §2.6 표의 라우트들에 `@AllowPublicAccess()` 추가.
|
||||
|
||||
### Step 12. WebSocket 인증
|
||||
|
||||
**파일**: `apps/api/src/modules/auction/auction.gateway.ts`
|
||||
|
||||
- `handleConnection` 에서 token → identity → user 조회
|
||||
- 실패 시 `client.disconnect(true)`
|
||||
- dev fallback: `socket.handshake.auth['x-auth-user-id']` 도 dev 환경에서 허용
|
||||
|
||||
### Step 13. SecretService 확장
|
||||
|
||||
**파일**: `apps/api/src/modules/global/secret/secret.service.ts`
|
||||
|
||||
`PROCESS_ENVS` 에 추가:
|
||||
|
||||
- `JWT_CLAIM_AUDIENCE`
|
||||
- `MICROSOFT_ENTRAID_TENANT_ID`
|
||||
- `MICROSOFT_ENTRAID_ALLOWED_ALGS`
|
||||
- `AUTH_DEV_HEADER_ENABLED`
|
||||
|
||||
### Step 14. 백엔드 단위 테스트
|
||||
|
||||
**신규 spec**:
|
||||
|
||||
- `auth/jwt.service.spec.ts` — issuer/audience/tenant/alg 검증, 잘못된 토큰 거부
|
||||
- `auth/jwt.guard.spec.ts` — public access 통과, missing/invalid bearer 거부
|
||||
- `auth/identity.service.spec.ts` — findOrCreateByOid upsert 동작
|
||||
- `auth/identity-resolver.guard.spec.ts` — tokenPayload → identity 매핑
|
||||
- `auth/user-resolver.interceptor.spec.ts` — path communityId + identityId 매칭
|
||||
- `auth/dev-fallback.spec.ts` — 환경변수 OFF 시 차단, ON 시 동작
|
||||
|
||||
### Step 15. 프론트엔드 MSAL 통합
|
||||
|
||||
위 §2.9 의 신규/수정 파일들. `apiFetch` 의 token 첨부 흐름:
|
||||
|
||||
```ts
|
||||
const token = await acquireAccessToken(); // silent → popup/redirect fallback
|
||||
return fetch(url, {
|
||||
...init,
|
||||
headers: {
|
||||
...init?.headers,
|
||||
...(token ? { Authorization: `Bearer ${token}` } : {}),
|
||||
},
|
||||
});
|
||||
```
|
||||
|
||||
401 응답 시 토큰 캐시 invalidate 후 1회 재시도, 그래도 실패면 `/login` redirect.
|
||||
|
||||
WebSocket 초기화:
|
||||
|
||||
```ts
|
||||
const socket = io('/auction', {
|
||||
auth: { token: await acquireAccessToken() },
|
||||
});
|
||||
```
|
||||
|
||||
### Step 16. 회귀 / 통합 검증
|
||||
|
||||
- `pnpm --filter api exec tsc --noEmit` 통과
|
||||
- `pnpm --filter api exec jest` 전체 PASS
|
||||
- 로컬에서 Entra 로그인 → JWT 생성 → API 호출 → `/me` 가 identity 반환
|
||||
- dakao `!내전 신청 ...` 시나리오 → 여전히 동작 (HTTP 인증과 무관)
|
||||
- dev fallback: `AUTH_DEV_HEADER_ENABLED=true` + `X-Auth-User-Id` 헤더 → 200 OK / `=false` → 401
|
||||
- Azure App 등록 후 `JWT_CLAIM_AUDIENCE` 시크릿 일치 확인
|
||||
- `pnpm --filter web build` 통과, `/login` → 콜백 → memberships 분기
|
||||
|
||||
---
|
||||
|
||||
## 4. 변경/추가 파일 목록
|
||||
|
||||
### 신규 (백엔드)
|
||||
|
||||
- `apps/api/src/modules/auth/allow-public-access.decorator.ts`
|
||||
- `apps/api/src/modules/auth/jwt.service.ts`
|
||||
- `apps/api/src/modules/auth/jwt.guard.ts`
|
||||
- `apps/api/src/modules/auth/identity.service.ts`
|
||||
- `apps/api/src/modules/auth/identity-resolver.guard.ts`
|
||||
- `apps/api/src/modules/auth/user-resolver.interceptor.ts`
|
||||
- `apps/api/src/modules/auth/current-identity.decorator.ts`
|
||||
- `apps/api/src/modules/auth/jwt.service.spec.ts`
|
||||
- `apps/api/src/modules/auth/jwt.guard.spec.ts`
|
||||
- `apps/api/src/modules/auth/identity.service.spec.ts`
|
||||
- `apps/api/src/modules/auth/identity-resolver.guard.spec.ts`
|
||||
- `apps/api/src/modules/auth/user-resolver.interceptor.spec.ts`
|
||||
- `apps/api/src/modules/auth/dev-fallback.spec.ts`
|
||||
- `apps/api/src/modules/user/dto/me-response.dto.ts`
|
||||
|
||||
### 수정 (백엔드)
|
||||
|
||||
- `apps/api/src/modules/global/database/schema.ts` — Identity 추가, User.identityId
|
||||
- `apps/api/src/modules/auth/auth.module.ts` — APP_GUARD 등록, providers 재구성
|
||||
- `apps/api/src/modules/auth/auth.service.ts` — dev fallback 전용 축소
|
||||
- `apps/api/src/modules/auth/auth.middleware.ts` — 제거 또는 dev only 축소
|
||||
- `apps/api/src/modules/auth/roles.guard.ts` — 에러 메시지 보강
|
||||
- `apps/api/src/modules/auth/current-user.decorator.ts` — 그대로 (호환 유지)
|
||||
- `apps/api/src/modules/user/user.controller.ts` — `/me` 응답 모양 변경
|
||||
- `apps/api/src/modules/community/community.controller.ts` — `@AllowPublicAccess`, owner 자동 연결
|
||||
- `apps/api/src/modules/community/community.service.ts` — owner 생성 시 identityId 연결
|
||||
- `apps/api/src/modules/community/dto/create-community.dto.ts` — owner 필드 deprecated
|
||||
- `apps/api/src/modules/match/match.controller.ts` — `@AllowPublicAccess` (read), `@UseInterceptors(UserResolverInterceptor)` (write)
|
||||
- `apps/api/src/modules/auction/auction.controller.ts` — interceptor 적용
|
||||
- `apps/api/src/modules/auction/auction.gateway.ts` — JWT handshake 검증
|
||||
- `apps/api/src/modules/riot/riot-webhook.controller.ts` — `@AllowPublicAccess`
|
||||
- `apps/api/src/modules/global/secret/secret.service.ts` — PROCESS_ENVS 확장
|
||||
|
||||
### 의존성 (백엔드)
|
||||
|
||||
- `pnpm --filter api add jose`
|
||||
|
||||
### 신규 (프론트엔드)
|
||||
|
||||
- `apps/web/src/lib/auth/msal.config.ts`
|
||||
- `apps/web/src/lib/auth/MsalAppProvider.tsx`
|
||||
- `apps/web/src/lib/auth/use-access-token.ts`
|
||||
- `apps/web/src/pages/Login.tsx`
|
||||
- `apps/web/src/pages/AuthCallback.tsx`
|
||||
- `apps/web/src/components/CommunitySwitcher.tsx`
|
||||
|
||||
### 수정 (프론트엔드)
|
||||
|
||||
- `apps/web/src/main.tsx`
|
||||
- `apps/web/src/lib/api.ts`
|
||||
- `apps/web/src/lib/socket.ts` (또는 해당 socket 초기화 파일)
|
||||
- `apps/web/src/config.ts`
|
||||
- `apps/web/src/components/DevAuthSwitcher.tsx`
|
||||
- `apps/web/.env.example`
|
||||
|
||||
### 의존성 (프론트엔드)
|
||||
|
||||
- `pnpm --filter web add @azure/msal-browser @azure/msal-react`
|
||||
|
||||
### 인프라 / 시크릿
|
||||
|
||||
- Azure App Registration (SPA platform, expose API, scope `access_as_user`)
|
||||
- Infisical: `MICROSOFT_ENTRAID_TENANT_ID`, `MICROSOFT_ENTRAID_ALLOWED_ALGS`, `JWT_CLAIM_AUDIENCE`, `AUTH_DEV_HEADER_ENABLED`(dev 만)
|
||||
- Frontend env: `VITE_MSAL_CLIENT_ID`, `VITE_MSAL_AUTHORITY`, `VITE_MSAL_API_SCOPE`, `VITE_MSAL_REDIRECT_URI`
|
||||
|
||||
---
|
||||
|
||||
## 5. 기존 파일 / 함수 재사용 매핑
|
||||
|
||||
| 신규 작업 | 재사용 대상 | 경로 |
|
||||
| --- | --- | --- |
|
||||
| JwtService / JwtGuard 본체 | 다른 프로젝트 참고 파일 | `apps/api/src/modules/auth/jwt.service.ts`, `jwt.guard.ts` |
|
||||
| 시크릿 로딩 | `SecretService.get` / `ready` | `apps/api/src/modules/global/secret/secret.service.ts` |
|
||||
| Mongo 모델 액세스 | `ConnectionService.getModel` | `apps/api/src/modules/global/database/connection.service.ts` |
|
||||
| 현재 user 데코레이터 | `CurrentUser` (그대로 호환) | `apps/api/src/modules/auth/current-user.decorator.ts` |
|
||||
| 권한 매핑 | `permissions.ts`, `roles.guard.ts`, `roles.decorator.ts` | `apps/api/src/modules/auth/` |
|
||||
| ObjectId 검증 | `ParseObjectIdPipe`, `mongoose.isValidObjectId` | `apps/api/src/modules/common/parse-object-id.pipe.ts` |
|
||||
|
||||
---
|
||||
|
||||
## 6. 검증 (end-to-end)
|
||||
|
||||
### 백엔드
|
||||
|
||||
1. `pnpm --filter api exec tsc --noEmit`
|
||||
2. `pnpm --filter api exec jest`
|
||||
3. dev 환경 부팅 후:
|
||||
- `curl -H "X-Auth-User-Id: <id>" http://localhost:3000/me` → `AUTH_DEV_HEADER_ENABLED=true` 일 때 200, `=false` 일 때 401
|
||||
- 실제 Entra access token 으로 `Authorization: Bearer ...` 호출 → 200, identity 채워짐
|
||||
- `Authorization` 누락 + dev fallback 비활성 + 보호 라우트 → 401
|
||||
- `Authorization` 정상 + community path 의 멤버 아님 → 403 `No membership in this community.`
|
||||
4. dakao 시나리오: `!내전 신청 ...` 메시지 publish → 변동 없이 동작 확인
|
||||
|
||||
### 프론트엔드
|
||||
|
||||
1. `pnpm --filter web build` 통과
|
||||
2. `pnpm --filter web dev` 후:
|
||||
- `/login` → Entra 로그인 → 콜백 → `/me` 호출 성공
|
||||
- memberships 빈 배열 → "커뮤니티 만들기/초대 받기" 분기 표시
|
||||
- 보호된 페이지(매치 관리) 진입 시 토큰 자동 첨부
|
||||
- 토큰 만료 시 silent refresh → 실패 시 재로그인 redirect
|
||||
- WebSocket(/auction) 연결 시 핸드셰이크에 토큰 포함, 인증 실패면 disconnect
|
||||
|
||||
---
|
||||
|
||||
## 7. 범위 외 (다음 작업으로 미룸)
|
||||
|
||||
- dakao 사용자 ↔ Entra identity 자동/수동 연결 플로우
|
||||
- `createCommunity` 강제 인증 + invitation token 기반 멤버 가입
|
||||
- 다중 테넌트 지원 (`tid` 동적 분기)
|
||||
- Cognito 등 추가 IdP
|
||||
- Refresh token 백엔드 처리 (현재 stateless)
|
||||
- Audit log (로그인/identity 변경 이벤트 기록)
|
||||
+5
-3
@@ -5,14 +5,16 @@
|
||||
"main": "index.js",
|
||||
"scripts": {
|
||||
"start:api:dev": "pnpm --filter api start:dev",
|
||||
"start:api:test": "pnpm --filter api start:test",
|
||||
"start:api:staging": "pnpm --filter api start:staging",
|
||||
"start:api:prod": "pnpm --filter api start:prod",
|
||||
"start:api": "pnpm --filter api start:prod",
|
||||
"start:web:dev": "pnpm --filter web start:dev",
|
||||
"start:web:staging": "pnpm --filter web start:staging",
|
||||
"build:api": "pnpm --filter api build",
|
||||
"dev:web": "pnpm --filter web dev",
|
||||
"build:web:test": "pnpm --filter web build:test",
|
||||
"build:web:staging": "pnpm --filter web build:staging",
|
||||
"build:web:prod": "pnpm --filter web build:prod",
|
||||
"deploy:web:test": "node scripts/deploy-cloudflare-pages.mjs test",
|
||||
"deploy:web:staging": "node scripts/deploy-cloudflare-pages.mjs staging",
|
||||
"deploy:web:prod": "node scripts/deploy-cloudflare-pages.mjs prod",
|
||||
"test": "echo \"Error: no test specified\" && exit 1"
|
||||
},
|
||||
|
||||
Generated
+313
@@ -159,6 +159,9 @@ importers:
|
||||
react-router:
|
||||
specifier: ^7.14.0
|
||||
version: 7.14.0(react-dom@19.2.5(react@19.2.5))(react@19.2.5)
|
||||
recharts:
|
||||
specifier: ^3.8.1
|
||||
version: 3.8.1(@types/react@19.2.14)(react-dom@19.2.5(react@19.2.5))(react-is@18.3.1)(react@19.2.5)(redux@5.0.1)
|
||||
socket.io-client:
|
||||
specifier: ^4.8.3
|
||||
version: 4.8.3
|
||||
@@ -1437,6 +1440,17 @@ packages:
|
||||
peerDependencies:
|
||||
'@redis/client': ^5.12.1
|
||||
|
||||
'@reduxjs/toolkit@2.12.0':
|
||||
resolution: {integrity: sha512-KiT+RzZbp6mQET+Mg+h2c97+9j1sNflUxQkIHI7Yuzf6Peu+OYpmkn6nbHWmLLWj+1ZODUJFwGZ7gx3L9R9EOw==}
|
||||
peerDependencies:
|
||||
react: ^16.9.0 || ^17.0.0 || ^18 || ^19
|
||||
react-redux: ^7.2.1 || ^8.1.3 || ^9.0.0
|
||||
peerDependenciesMeta:
|
||||
react:
|
||||
optional: true
|
||||
react-redux:
|
||||
optional: true
|
||||
|
||||
'@rolldown/binding-android-arm64@1.0.0-rc.15':
|
||||
resolution: {integrity: sha512-YYe6aWruPZDtHNpwu7+qAHEMbQ/yRl6atqb/AhznLTnD3UY99Q1jE7ihLSahNWkF4EqRPVC4SiR4O0UkLK02tA==}
|
||||
engines: {node: ^20.19.0 || >=22.12.0}
|
||||
@@ -1722,6 +1736,12 @@ packages:
|
||||
'@speed-highlight/core@1.2.15':
|
||||
resolution: {integrity: sha512-BMq1K3DsElxDWawkX6eLg9+CKJrTVGCBAWVuHXVUV2u0s2711qiChLSId6ikYPfxhdYocLNt3wWwSvDiTvFabw==}
|
||||
|
||||
'@standard-schema/spec@1.1.0':
|
||||
resolution: {integrity: sha512-l2aFy5jALhniG5HgqrD6jXLi/rUWrKvqN/qJx6yoJsgKhblVd+iqqU4RCXavm/jPityDo5TCvKMnpjKnOriy0w==}
|
||||
|
||||
'@standard-schema/utils@0.3.0':
|
||||
resolution: {integrity: sha512-e7Mew686owMaPJVNNLs55PUvgz371nKgwsc4vxE49zsODpJEnxgxRo2y/OKrqueavXgZNMDVj3DdHFlaSAeU8g==}
|
||||
|
||||
'@tailwindcss/node@4.2.2':
|
||||
resolution: {integrity: sha512-pXS+wJ2gZpVXqFaUEjojq7jzMpTGf8rU6ipJz5ovJV6PUGmlJ+jvIwGrzdHdQ80Sg+wmQxUFuoW1UAAwHNEdFA==}
|
||||
|
||||
@@ -1866,6 +1886,33 @@ packages:
|
||||
'@types/cors@2.8.19':
|
||||
resolution: {integrity: sha512-mFNylyeyqN93lfe/9CSxOGREz8cpzAhH+E93xJ4xWQf62V8sQ/24reV2nyzUWM6H6Xji+GGHpkbLe7pVoUEskg==}
|
||||
|
||||
'@types/d3-array@3.2.2':
|
||||
resolution: {integrity: sha512-hOLWVbm7uRza0BYXpIIW5pxfrKe0W+D5lrFiAEYR+pb6w3N2SwSMaJbXdUfSEv+dT4MfHBLtn5js0LAWaO6otw==}
|
||||
|
||||
'@types/d3-color@3.1.3':
|
||||
resolution: {integrity: sha512-iO90scth9WAbmgv7ogoq57O9YpKmFBbmoEoCHDB2xMBY0+/KVrqAaCDyCE16dUspeOvIxFFRI+0sEtqDqy2b4A==}
|
||||
|
||||
'@types/d3-ease@3.0.2':
|
||||
resolution: {integrity: sha512-NcV1JjO5oDzoK26oMzbILE6HW7uVXOHLQvHshBUW4UMdZGfiY6v5BeQwh9a9tCzv+CeefZQHJt5SRgK154RtiA==}
|
||||
|
||||
'@types/d3-interpolate@3.0.4':
|
||||
resolution: {integrity: sha512-mgLPETlrpVV1YRJIglr4Ez47g7Yxjl1lj7YKsiMCb27VJH9W8NVM6Bb9d8kkpG/uAQS5AmbA48q2IAolKKo1MA==}
|
||||
|
||||
'@types/d3-path@3.1.1':
|
||||
resolution: {integrity: sha512-VMZBYyQvbGmWyWVea0EHs/BwLgxc+MKi1zLDCONksozI4YJMcTt8ZEuIR4Sb1MMTE8MMW49v0IwI5+b7RmfWlg==}
|
||||
|
||||
'@types/d3-scale@4.0.9':
|
||||
resolution: {integrity: sha512-dLmtwB8zkAeO/juAMfnV+sItKjlsw2lKdZVVy6LRr0cBmegxSABiLEpGVmSJJ8O08i4+sGR6qQtb6WtuwJdvVw==}
|
||||
|
||||
'@types/d3-shape@3.1.8':
|
||||
resolution: {integrity: sha512-lae0iWfcDeR7qt7rA88BNiqdvPS5pFVPpo5OfjElwNaT2yyekbM0C9vK+yqBqEmHr6lDkRnYNoTBYlAgJa7a4w==}
|
||||
|
||||
'@types/d3-time@3.0.4':
|
||||
resolution: {integrity: sha512-yuzZug1nkAAaBlBBikKZTgzCeA+k1uy4ZFwWANOfKw5z5LRhV0gNA7gNkKm7HoK+HRN0wX3EkxGk0fpbWhmB7g==}
|
||||
|
||||
'@types/d3-timer@3.0.2':
|
||||
resolution: {integrity: sha512-Ps3T8E8dZDam6fUyNiMkekK3XUsaUEik+idO9/YjPtfj2qruF8tFBXS7XhtE4iIXBLxhmLjP3SXpLhVf21I9Lw==}
|
||||
|
||||
'@types/eslint-scope@3.7.7':
|
||||
resolution: {integrity: sha512-MzMFlSLBqNF2gcHWO0G1vP/YQyfvrxZ0bF+u7mzUdZ1/xK4A4sru+nraZz5i3iEIk1l1uyicaDVTB4QbbEkAYg==}
|
||||
|
||||
@@ -1934,6 +1981,9 @@ packages:
|
||||
'@types/supertest@7.2.0':
|
||||
resolution: {integrity: sha512-uh2Lv57xvggst6lCqNdFAmDSvoMG7M/HDtX4iUCquxQ5EGPtaPM5PL5Hmi7LCvOG8db7YaCPNJEeoI8s/WzIQw==}
|
||||
|
||||
'@types/use-sync-external-store@0.0.6':
|
||||
resolution: {integrity: sha512-zFDAD+tlpf2r4asuHEj0XH6pY6i0g5NeAHPn+15wk3BV6JA69eERFXC1gyGThDkVa1zCyKr5jox1+2LbV/AMLg==}
|
||||
|
||||
'@types/validator@13.15.10':
|
||||
resolution: {integrity: sha512-T8L6i7wCuyoK8A/ZeLYt1+q0ty3Zb9+qbSSvrIVitzT3YjZqkTZ40IbRsPanlB4h1QB3JVL1SYCdR6ngtFYcuA==}
|
||||
|
||||
@@ -2473,6 +2523,10 @@ packages:
|
||||
resolution: {integrity: sha512-JQHZ2QMW6l3aH/j6xCqQThY/9OH4D/9ls34cgkUBiEeocRTU04tHfKPBsUK1PqZCUQM7GiA0IIXJSuXHI64Kbg==}
|
||||
engines: {node: '>=0.8'}
|
||||
|
||||
clsx@2.1.1:
|
||||
resolution: {integrity: sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==}
|
||||
engines: {node: '>=6'}
|
||||
|
||||
cluster-key-slot@1.1.2:
|
||||
resolution: {integrity: sha512-RMr0FhtfXemyinomL4hrWcYJxmX6deFdCxpJzhDttxgO1+bcCnkk+9drydLVDmAMG7NE6aN/fl4F7ucU/90gAA==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
@@ -2569,6 +2623,50 @@ packages:
|
||||
csstype@3.2.3:
|
||||
resolution: {integrity: sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==}
|
||||
|
||||
d3-array@3.2.4:
|
||||
resolution: {integrity: sha512-tdQAmyA18i4J7wprpYq8ClcxZy3SC31QMeByyCFyRt7BVHdREQZ5lpzoe5mFEYZUWe+oq8HBvk9JjpibyEV4Jg==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-color@3.1.0:
|
||||
resolution: {integrity: sha512-zg/chbXyeBtMQ1LbD/WSoW2DpC3I0mpmPdW+ynRTj/x2DAWYrIY7qeZIHidozwV24m4iavr15lNwIwLxRmOxhA==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-ease@3.0.1:
|
||||
resolution: {integrity: sha512-wR/XK3D3XcLIZwpbvQwQ5fK+8Ykds1ip7A2Txe0yxncXSdq1L9skcG7blcedkOX+ZcgxGAmLX1FrRGbADwzi0w==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-format@3.1.2:
|
||||
resolution: {integrity: sha512-AJDdYOdnyRDV5b6ArilzCPPwc1ejkHcoyFarqlPqT7zRYjhavcT3uSrqcMvsgh2CgoPbK3RCwyHaVyxYcP2Arg==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-interpolate@3.0.1:
|
||||
resolution: {integrity: sha512-3bYs1rOD33uo8aqJfKP3JWPAibgw8Zm2+L9vBKEHJ2Rg+viTR7o5Mmv5mZcieN+FRYaAOWX5SJATX6k1PWz72g==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-path@3.1.0:
|
||||
resolution: {integrity: sha512-p3KP5HCf/bvjBSSKuXid6Zqijx7wIfNW+J/maPs+iwR35at5JCbLUT0LzF1cnjbCHWhqzQTIN2Jpe8pRebIEFQ==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-scale@4.0.2:
|
||||
resolution: {integrity: sha512-GZW464g1SH7ag3Y7hXjf8RoUuAFIqklOAq3MRl4OaWabTFJY9PN/E1YklhXLh+OQ3fM9yS2nOkCoS+WLZ6kvxQ==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-shape@3.2.0:
|
||||
resolution: {integrity: sha512-SaLBuwGm3MOViRq2ABk3eLoxwZELpH6zhl3FbAoJ7Vm1gofKx6El1Ib5z23NUEhF9AsGl7y+dzLe5Cw2AArGTA==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-time-format@4.1.0:
|
||||
resolution: {integrity: sha512-dJxPBlzC7NugB2PDLwo9Q8JiTR3M3e4/XANkreKSUxF8vvXKqm1Yfq4Q5dl8budlunRVlUUaDUgFt7eA8D6NLg==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-time@3.1.0:
|
||||
resolution: {integrity: sha512-VqKjzBLejbSMT4IgbmVgDjpkYrNWUYJnbCGo874u7MMKIWsILRX+OpX/gTk8MqjpT1A/c6HY2dCA77ZN0lkQ2Q==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
d3-timer@3.0.1:
|
||||
resolution: {integrity: sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
daisyui@5.5.19:
|
||||
resolution: {integrity: sha512-pbFAkl1VCEh/MPCeclKL61I/MqRIFFhNU7yiXoDDRapXN4/qNCoMxeCCswyxEEhqL5eiTTfwHvucFtOE71C9sA==}
|
||||
|
||||
@@ -2581,6 +2679,9 @@ packages:
|
||||
supports-color:
|
||||
optional: true
|
||||
|
||||
decimal.js-light@2.5.1:
|
||||
resolution: {integrity: sha512-qIMFpTMZmny+MMIitAB6D7iVPEorVw6YQRWkvarTkT4tBeSLLiHzcwj6q0MmYSFCiVpiqPJTJEYIrpcPzVEIvg==}
|
||||
|
||||
dedent@1.7.2:
|
||||
resolution: {integrity: sha512-WzMx3mW98SN+zn3hgemf4OzdmyNhhhKz5Ay0pUfQiMQ3e1g+xmTJWp/pKdwKVXhdSkAEGIIzqeuWrL3mV/AXbA==}
|
||||
peerDependencies:
|
||||
@@ -2701,6 +2802,9 @@ packages:
|
||||
resolution: {integrity: sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==}
|
||||
engines: {node: '>= 0.4'}
|
||||
|
||||
es-toolkit@1.47.0:
|
||||
resolution: {integrity: sha512-n1GuoD0WEQZMBk5tttoZSqwgyLx01oqa5XsBmCHwPyNe1S9jPBEmtR2pSgp2kJuWE3ciFZ6yRHmY4pM4C3OOkw==}
|
||||
|
||||
esbuild@0.27.3:
|
||||
resolution: {integrity: sha512-8VwMnyGCONIs6cWue2IdpHxHnAjzxnw2Zr7MkVxB2vjmQ2ivqGFb4LEG3SMnv0Gb2F/G/2yA8zUaiL1gywDCCg==}
|
||||
engines: {node: '>=18'}
|
||||
@@ -2815,6 +2919,9 @@ packages:
|
||||
resolution: {integrity: sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==}
|
||||
engines: {node: '>= 0.6'}
|
||||
|
||||
eventemitter3@5.0.4:
|
||||
resolution: {integrity: sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==}
|
||||
|
||||
events@3.3.0:
|
||||
resolution: {integrity: sha512-mQw+2fkQbALzQ7V0MY0IqdnXNOeTtP4r0lN9z7AAawCXgqea7bDii20AYrIBrFd/Hx0M2Ocz6S111CaFkUcb0Q==}
|
||||
engines: {node: '>=0.8.x'}
|
||||
@@ -3069,6 +3176,12 @@ packages:
|
||||
resolution: {integrity: sha512-Hs59xBNfUIunMFgWAbGX5cq6893IbWg4KnrjbYwX3tx0ztorVgTDA6B2sxf8ejHJ4wz8BqGUMYlnzNBer5NvGg==}
|
||||
engines: {node: '>= 4'}
|
||||
|
||||
immer@10.2.0:
|
||||
resolution: {integrity: sha512-d/+XTN3zfODyjr89gM3mPq1WNX2B8pYsu7eORitdwyA2sBubnTl3laYlBk4sXY5FUa5qTZGBDPJICVbvqzjlbw==}
|
||||
|
||||
immer@11.1.8:
|
||||
resolution: {integrity: sha512-/tbkHMW7y10Lx6i1crLjD4/OhNkRG+Fo7byZHtah0547nIeXYcpIXaUh0IAQY6gO5459qpGGYapcEOHtFXkIuA==}
|
||||
|
||||
import-fresh@3.3.1:
|
||||
resolution: {integrity: sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==}
|
||||
engines: {node: '>=6'}
|
||||
@@ -3089,6 +3202,10 @@ packages:
|
||||
inherits@2.0.4:
|
||||
resolution: {integrity: sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==}
|
||||
|
||||
internmap@2.0.3:
|
||||
resolution: {integrity: sha512-5Hh7Y1wQbvY5ooGgPbDaL5iYLAPzMTUrjMulskHLH6wnv/A+1q5rgEaiuqEjB+oxGXIVZs1FF+R/KPN3ZSQYYg==}
|
||||
engines: {node: '>=12'}
|
||||
|
||||
ipaddr.js@1.9.1:
|
||||
resolution: {integrity: sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==}
|
||||
engines: {node: '>= 0.10'}
|
||||
@@ -3867,6 +3984,18 @@ packages:
|
||||
react-is@18.3.1:
|
||||
resolution: {integrity: sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==}
|
||||
|
||||
react-redux@9.3.0:
|
||||
resolution: {integrity: sha512-KQopgqFo/p/fgmAs5qz6p5RWaNAzq40WAu7fJIXnQpYxFPbJYtsJPWvGeF2rOBaY/kEuV77AVsX8TsQzKm+A/g==}
|
||||
peerDependencies:
|
||||
'@types/react': ^18.2.25 || ^19
|
||||
react: ^18.0 || ^19
|
||||
redux: ^5.0.0
|
||||
peerDependenciesMeta:
|
||||
'@types/react':
|
||||
optional: true
|
||||
redux:
|
||||
optional: true
|
||||
|
||||
react-router@7.14.0:
|
||||
resolution: {integrity: sha512-m/xR9N4LQLmAS0ZhkY2nkPA1N7gQ5TUVa5n8TgANuDTARbn1gt+zLPXEm7W0XDTbrQ2AJSJKhoa6yx1D8BcpxQ==}
|
||||
engines: {node: '>=20.0.0'}
|
||||
@@ -3889,10 +4018,26 @@ packages:
|
||||
resolution: {integrity: sha512-GDhwkLfywWL2s6vEjyhri+eXmfH6j1L7JE27WhqLeYzoh/A3DBaYGEj2H/HFZCn/kMfim73FXxEJTw06WtxQwg==}
|
||||
engines: {node: '>= 14.18.0'}
|
||||
|
||||
recharts@3.8.1:
|
||||
resolution: {integrity: sha512-mwzmO1s9sFL0TduUpwndxCUNoXsBw3u3E/0+A+cLcrSfQitSG62L32N69GhqUrrT5qKcAE3pCGVINC6pqkBBQg==}
|
||||
engines: {node: '>=18'}
|
||||
peerDependencies:
|
||||
react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
|
||||
react-dom: ^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
|
||||
react-is: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
|
||||
|
||||
redis@5.12.1:
|
||||
resolution: {integrity: sha512-LDsoVvb/CpoV9EN3FXvgvSHNJWuCIzl9MiO3ppOevuGLpSGJhwfQjpEwfFJcQvNSddHADDdZaWx0HnmMxRXG7g==}
|
||||
engines: {node: '>= 18.19.0'}
|
||||
|
||||
redux-thunk@3.1.0:
|
||||
resolution: {integrity: sha512-NW2r5T6ksUKXCabzhL9z+h206HQw/NJkcLm1GPImRQ8IzfXwRGqjVhKJGauHirT0DAuyy6hjdnMZaRoAcy0Klw==}
|
||||
peerDependencies:
|
||||
redux: ^5.0.0
|
||||
|
||||
redux@5.0.1:
|
||||
resolution: {integrity: sha512-M9/ELqF6fy8FwmkpnF0S3YKOqMyoWJ4+CS5Efg2ct3oY9daQvd/Pc71FpGZsVsbl3Cpb+IIcjBDUnnyBdQbq4w==}
|
||||
|
||||
reflect-metadata@0.2.2:
|
||||
resolution: {integrity: sha512-urBwgfrvVP/eAyXx4hluJivBKzuEbSQs9rKWCrCkbSxNv8mxPcUZKeuoF3Uy4mJl3Lwprp6yy5/39VWigZ4K6Q==}
|
||||
|
||||
@@ -3904,6 +4049,9 @@ packages:
|
||||
resolution: {integrity: sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==}
|
||||
engines: {node: '>=0.10.0'}
|
||||
|
||||
reselect@5.1.1:
|
||||
resolution: {integrity: sha512-K/BG6eIky/SBpzfHZv/dd+9JBFiS4SWV7FIujVyJRux6e45+73RaUHXLmIR1f7WOMaQ0U1km6qwklRQxpJJY0w==}
|
||||
|
||||
resolve-cwd@3.0.0:
|
||||
resolution: {integrity: sha512-OrZaX2Mb+rJCpH/6CpSqt9xFVpN++x01XnN2ie9g6P5/3xelLAkXWVADpdz1IHD/KFfEXyE6V0U01OQ3UO2rEg==}
|
||||
engines: {node: '>=8'}
|
||||
@@ -4187,6 +4335,9 @@ packages:
|
||||
resolution: {integrity: sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w==}
|
||||
engines: {node: '>=8'}
|
||||
|
||||
tiny-invariant@1.3.3:
|
||||
resolution: {integrity: sha512-+FbBPE1o9QAYvviau/qC5SE3caw21q3xkvWKBtja5vgqOWIHHJ3ioaq1VPfn/Szqctz2bU/oYeKd9/z5BL+PVg==}
|
||||
|
||||
tinyglobby@0.2.16:
|
||||
resolution: {integrity: sha512-pn99VhoACYR8nFHhxqix+uvsbXineAasWm5ojXoN8xEwK5Kd3/TrhNn1wByuD52UxWRLy8pu+kRMniEi6Eq9Zg==}
|
||||
engines: {node: '>=12.0.0'}
|
||||
@@ -4365,6 +4516,11 @@ packages:
|
||||
uri-js@4.4.1:
|
||||
resolution: {integrity: sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==}
|
||||
|
||||
use-sync-external-store@1.6.0:
|
||||
resolution: {integrity: sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==}
|
||||
peerDependencies:
|
||||
react: ^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0
|
||||
|
||||
util-deprecate@1.0.2:
|
||||
resolution: {integrity: sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==}
|
||||
|
||||
@@ -4383,6 +4539,9 @@ packages:
|
||||
resolution: {integrity: sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==}
|
||||
engines: {node: '>= 0.8'}
|
||||
|
||||
victory-vendor@37.3.6:
|
||||
resolution: {integrity: sha512-SbPDPdDBYp+5MJHhBCAyI7wKM3d5ivekigc2Dk2s7pgbZ9wIgIBYGVw4zGHBml/qTFbexrofXW6Gu4noGxrOwQ==}
|
||||
|
||||
vite@8.0.8:
|
||||
resolution: {integrity: sha512-dbU7/iLVa8KZALJyLOBOQ88nOXtNG8vxKuOT4I2mD+Ya70KPceF4IAmDsmU0h1Qsn5bPrvsY9HJstCRh3hG6Uw==}
|
||||
engines: {node: ^20.19.0 || >=22.12.0}
|
||||
@@ -6119,6 +6278,18 @@ snapshots:
|
||||
dependencies:
|
||||
'@redis/client': 5.12.1
|
||||
|
||||
'@reduxjs/toolkit@2.12.0(react-redux@9.3.0(@types/react@19.2.14)(react@19.2.5)(redux@5.0.1))(react@19.2.5)':
|
||||
dependencies:
|
||||
'@standard-schema/spec': 1.1.0
|
||||
'@standard-schema/utils': 0.3.0
|
||||
immer: 11.1.8
|
||||
redux: 5.0.1
|
||||
redux-thunk: 3.1.0(redux@5.0.1)
|
||||
reselect: 5.1.1
|
||||
optionalDependencies:
|
||||
react: 19.2.5
|
||||
react-redux: 9.3.0(@types/react@19.2.14)(react@19.2.5)(redux@5.0.1)
|
||||
|
||||
'@rolldown/binding-android-arm64@1.0.0-rc.15':
|
||||
optional: true
|
||||
|
||||
@@ -6460,6 +6631,10 @@ snapshots:
|
||||
|
||||
'@speed-highlight/core@1.2.15': {}
|
||||
|
||||
'@standard-schema/spec@1.1.0': {}
|
||||
|
||||
'@standard-schema/utils@0.3.0': {}
|
||||
|
||||
'@tailwindcss/node@4.2.2':
|
||||
dependencies:
|
||||
'@jridgewell/remapping': 2.3.5
|
||||
@@ -6593,6 +6768,30 @@ snapshots:
|
||||
dependencies:
|
||||
'@types/node': 24.12.2
|
||||
|
||||
'@types/d3-array@3.2.2': {}
|
||||
|
||||
'@types/d3-color@3.1.3': {}
|
||||
|
||||
'@types/d3-ease@3.0.2': {}
|
||||
|
||||
'@types/d3-interpolate@3.0.4':
|
||||
dependencies:
|
||||
'@types/d3-color': 3.1.3
|
||||
|
||||
'@types/d3-path@3.1.1': {}
|
||||
|
||||
'@types/d3-scale@4.0.9':
|
||||
dependencies:
|
||||
'@types/d3-time': 3.0.4
|
||||
|
||||
'@types/d3-shape@3.1.8':
|
||||
dependencies:
|
||||
'@types/d3-path': 3.1.1
|
||||
|
||||
'@types/d3-time@3.0.4': {}
|
||||
|
||||
'@types/d3-timer@3.0.2': {}
|
||||
|
||||
'@types/eslint-scope@3.7.7':
|
||||
dependencies:
|
||||
'@types/eslint': 9.6.1
|
||||
@@ -6678,6 +6877,8 @@ snapshots:
|
||||
'@types/methods': 1.1.4
|
||||
'@types/superagent': 8.1.9
|
||||
|
||||
'@types/use-sync-external-store@0.0.6': {}
|
||||
|
||||
'@types/validator@13.15.10': {}
|
||||
|
||||
'@types/webidl-conversions@7.0.3': {}
|
||||
@@ -7317,6 +7518,8 @@ snapshots:
|
||||
|
||||
clone@1.0.4: {}
|
||||
|
||||
clsx@2.1.1: {}
|
||||
|
||||
cluster-key-slot@1.1.2: {}
|
||||
|
||||
co@4.6.0: {}
|
||||
@@ -7393,12 +7596,52 @@ snapshots:
|
||||
|
||||
csstype@3.2.3: {}
|
||||
|
||||
d3-array@3.2.4:
|
||||
dependencies:
|
||||
internmap: 2.0.3
|
||||
|
||||
d3-color@3.1.0: {}
|
||||
|
||||
d3-ease@3.0.1: {}
|
||||
|
||||
d3-format@3.1.2: {}
|
||||
|
||||
d3-interpolate@3.0.1:
|
||||
dependencies:
|
||||
d3-color: 3.1.0
|
||||
|
||||
d3-path@3.1.0: {}
|
||||
|
||||
d3-scale@4.0.2:
|
||||
dependencies:
|
||||
d3-array: 3.2.4
|
||||
d3-format: 3.1.2
|
||||
d3-interpolate: 3.0.1
|
||||
d3-time: 3.1.0
|
||||
d3-time-format: 4.1.0
|
||||
|
||||
d3-shape@3.2.0:
|
||||
dependencies:
|
||||
d3-path: 3.1.0
|
||||
|
||||
d3-time-format@4.1.0:
|
||||
dependencies:
|
||||
d3-time: 3.1.0
|
||||
|
||||
d3-time@3.1.0:
|
||||
dependencies:
|
||||
d3-array: 3.2.4
|
||||
|
||||
d3-timer@3.0.1: {}
|
||||
|
||||
daisyui@5.5.19: {}
|
||||
|
||||
debug@4.4.3:
|
||||
dependencies:
|
||||
ms: 2.1.3
|
||||
|
||||
decimal.js-light@2.5.1: {}
|
||||
|
||||
dedent@1.7.2: {}
|
||||
|
||||
deep-is@0.1.4: {}
|
||||
@@ -7511,6 +7754,8 @@ snapshots:
|
||||
has-tostringtag: 1.0.2
|
||||
hasown: 2.0.2
|
||||
|
||||
es-toolkit@1.47.0: {}
|
||||
|
||||
esbuild@0.27.3:
|
||||
optionalDependencies:
|
||||
'@esbuild/aix-ppc64': 0.27.3
|
||||
@@ -7658,6 +7903,8 @@ snapshots:
|
||||
|
||||
etag@1.8.1: {}
|
||||
|
||||
eventemitter3@5.0.4: {}
|
||||
|
||||
events@3.3.0: {}
|
||||
|
||||
execa@5.1.1:
|
||||
@@ -7961,6 +8208,10 @@ snapshots:
|
||||
|
||||
ignore@7.0.5: {}
|
||||
|
||||
immer@10.2.0: {}
|
||||
|
||||
immer@11.1.8: {}
|
||||
|
||||
import-fresh@3.3.1:
|
||||
dependencies:
|
||||
parent-module: 1.0.1
|
||||
@@ -7980,6 +8231,8 @@ snapshots:
|
||||
|
||||
inherits@2.0.4: {}
|
||||
|
||||
internmap@2.0.3: {}
|
||||
|
||||
ipaddr.js@1.9.1: {}
|
||||
|
||||
is-arrayish@0.2.1: {}
|
||||
@@ -8831,6 +9084,15 @@ snapshots:
|
||||
|
||||
react-is@18.3.1: {}
|
||||
|
||||
react-redux@9.3.0(@types/react@19.2.14)(react@19.2.5)(redux@5.0.1):
|
||||
dependencies:
|
||||
'@types/use-sync-external-store': 0.0.6
|
||||
react: 19.2.5
|
||||
use-sync-external-store: 1.6.0(react@19.2.5)
|
||||
optionalDependencies:
|
||||
'@types/react': 19.2.14
|
||||
redux: 5.0.1
|
||||
|
||||
react-router@7.14.0(react-dom@19.2.5(react@19.2.5))(react@19.2.5):
|
||||
dependencies:
|
||||
cookie: 1.1.1
|
||||
@@ -8849,6 +9111,26 @@ snapshots:
|
||||
|
||||
readdirp@4.1.2: {}
|
||||
|
||||
recharts@3.8.1(@types/react@19.2.14)(react-dom@19.2.5(react@19.2.5))(react-is@18.3.1)(react@19.2.5)(redux@5.0.1):
|
||||
dependencies:
|
||||
'@reduxjs/toolkit': 2.12.0(react-redux@9.3.0(@types/react@19.2.14)(react@19.2.5)(redux@5.0.1))(react@19.2.5)
|
||||
clsx: 2.1.1
|
||||
decimal.js-light: 2.5.1
|
||||
es-toolkit: 1.47.0
|
||||
eventemitter3: 5.0.4
|
||||
immer: 10.2.0
|
||||
react: 19.2.5
|
||||
react-dom: 19.2.5(react@19.2.5)
|
||||
react-is: 18.3.1
|
||||
react-redux: 9.3.0(@types/react@19.2.14)(react@19.2.5)(redux@5.0.1)
|
||||
reselect: 5.1.1
|
||||
tiny-invariant: 1.3.3
|
||||
use-sync-external-store: 1.6.0(react@19.2.5)
|
||||
victory-vendor: 37.3.6
|
||||
transitivePeerDependencies:
|
||||
- '@types/react'
|
||||
- redux
|
||||
|
||||
redis@5.12.1:
|
||||
dependencies:
|
||||
'@redis/bloom': 5.12.1(@redis/client@5.12.1)
|
||||
@@ -8860,12 +9142,20 @@ snapshots:
|
||||
- '@node-rs/xxhash'
|
||||
- '@opentelemetry/api'
|
||||
|
||||
redux-thunk@3.1.0(redux@5.0.1):
|
||||
dependencies:
|
||||
redux: 5.0.1
|
||||
|
||||
redux@5.0.1: {}
|
||||
|
||||
reflect-metadata@0.2.2: {}
|
||||
|
||||
require-directory@2.1.1: {}
|
||||
|
||||
require-from-string@2.0.2: {}
|
||||
|
||||
reselect@5.1.1: {}
|
||||
|
||||
resolve-cwd@3.0.0:
|
||||
dependencies:
|
||||
resolve-from: 5.0.0
|
||||
@@ -9232,6 +9522,8 @@ snapshots:
|
||||
glob: 7.2.3
|
||||
minimatch: 3.1.5
|
||||
|
||||
tiny-invariant@1.3.3: {}
|
||||
|
||||
tinyglobby@0.2.16:
|
||||
dependencies:
|
||||
fdir: 6.5.0(picomatch@4.0.4)
|
||||
@@ -9432,6 +9724,10 @@ snapshots:
|
||||
dependencies:
|
||||
punycode: 2.3.1
|
||||
|
||||
use-sync-external-store@1.6.0(react@19.2.5):
|
||||
dependencies:
|
||||
react: 19.2.5
|
||||
|
||||
util-deprecate@1.0.2: {}
|
||||
|
||||
v8-compile-cache-lib@3.0.1: {}
|
||||
@@ -9446,6 +9742,23 @@ snapshots:
|
||||
|
||||
vary@1.1.2: {}
|
||||
|
||||
victory-vendor@37.3.6:
|
||||
dependencies:
|
||||
'@types/d3-array': 3.2.2
|
||||
'@types/d3-ease': 3.0.2
|
||||
'@types/d3-interpolate': 3.0.4
|
||||
'@types/d3-scale': 4.0.9
|
||||
'@types/d3-shape': 3.1.8
|
||||
'@types/d3-time': 3.0.4
|
||||
'@types/d3-timer': 3.0.2
|
||||
d3-array: 3.2.4
|
||||
d3-ease: 3.0.1
|
||||
d3-interpolate: 3.0.1
|
||||
d3-scale: 4.0.2
|
||||
d3-shape: 3.2.0
|
||||
d3-time: 3.1.0
|
||||
d3-timer: 3.0.1
|
||||
|
||||
vite@8.0.8(@types/node@24.12.2)(esbuild@0.27.3)(jiti@2.6.1)(terser@5.46.1):
|
||||
dependencies:
|
||||
lightningcss: 1.32.0
|
||||
|
||||
@@ -1,623 +0,0 @@
|
||||
<div class="mb-[8px]"><div class="border border-[#e6e6e6]"><div class="pr-16px pl-16px bg-[white] h-44px leading-44px border-b border-[#e6e6e6]"><span class="text-14px">매치 히스토리</span></div> <div md="flex-row justify-between items-center h-[44px] py-0" class="flex flex-col gap-[10px] py-12px px-16px bg-[#fafafa]"><div class="flex gap-[8px] overflow-x-auto"><button class="px-8px py-4px border-b-4px border-[transparent] text-12px whitespace-nowrap hover:border-[#ed6767] !border-[#ed6767] !text-[#ed6767] !font-bold">
|
||||
전체
|
||||
</button><button class="px-8px py-4px border-b-4px border-[transparent] text-12px whitespace-nowrap hover:border-[#ed6767]">
|
||||
솔로 랭크
|
||||
</button><button class="px-8px py-4px border-b-4px border-[transparent] text-12px whitespace-nowrap hover:border-[#ed6767]">
|
||||
자유 랭크
|
||||
</button><button class="px-8px py-4px border-b-4px border-[transparent] text-12px whitespace-nowrap hover:border-[#ed6767]">
|
||||
일반
|
||||
</button><button class="px-8px py-4px border-b-4px border-[transparent] text-12px whitespace-nowrap hover:border-[#ed6767]">
|
||||
칼바람 나락
|
||||
</button><button class="px-8px py-4px border-b-4px border-[transparent] text-12px whitespace-nowrap hover:border-[#ed6767]">
|
||||
우르프
|
||||
</button><button class="px-8px py-4px border-b-4px border-[transparent] text-12px whitespace-nowrap hover:border-[#ed6767]">
|
||||
아레나
|
||||
</button></div> <div><div data-v-223720d7="" class="relative"><input data-v-223720d7="" type="text" placeholder="챔피언 검색 (가렌, ㄴㄹ, zdt)" md="w-220px" class="w-full h-32px px-12px py-8px border-1px border-[#e6e6e6] text-12px rounded-32px placeholder-[#808080] outline-none"> <button data-v-223720d7="" aria-label="close champion filter" class="absolute right-[12px] text-12px text-[#ED6767] top-[50%] transform translate-y-[-50%]"><svg data-v-223720d7="" aria-hidden="true" focusable="false" data-prefix="fas" data-icon="sort-down" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 320 512" class="transform translate-y-[-2px] svg-inline--fa fa-sort-down fa-w-10"><path data-v-223720d7="" fill="currentColor" d="M182.6 470.6c-12.5 12.5-32.8 12.5-45.3 0l-128-128c-9.2-9.2-11.9-22.9-6.9-34.9s16.6-19.8 29.6-19.8H288c12.9 0 24.6 7.8 29.6 19.8s2.2 25.7-6.9 34.9l-128 128z" class=""></path></svg></button> <div data-v-223720d7="" class="absolute z-1 pl-10px pr-10px w-full"><div data-v-223720d7="" class="bg-[white] w-full border border-solid border-1px border-[#d6d6d6] max-h-300px top-100% overflow-y-auto" style="display: none;"><ul data-v-223720d7=""><li data-v-223720d7="" class="champion-item">모든 챔피언</li> <li data-v-223720d7="" class="champion-item">
|
||||
가렌
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
갈리오
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
갱플랭크
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
그라가스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
그레이브즈
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
그웬
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
나르
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
나미
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
나서스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
나피리
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
노틸러스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
녹턴
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
누누와 윌럼프
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
니달리
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
니코
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
닐라
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
다리우스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
다이애나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
드레이븐
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
라이즈
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
라칸
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
람머스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
럭스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
럼블
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
레나타 글라스크
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
레넥톤
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
레오나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
렉사이
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
렐
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
렝가
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
루시안
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
룰루
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
르블랑
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
리 신
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
리븐
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
리산드라
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
릴리아
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
마스터 이
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
마오카이
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
말자하
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
말파이트
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
멜
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
모데카이저
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
모르가나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
문도 박사
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
미스 포츈
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
밀리오
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
바드
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
바루스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
바이
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
베이가
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
베인
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
벡스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
벨베스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
벨코즈
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
볼리베어
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
브라움
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
브라이어
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
브랜드
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
블라디미르
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
블리츠크랭크
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
비에고
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
빅토르
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
뽀삐
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
사미라
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
사이온
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
사일러스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
샤코
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
세나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
세라핀
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
세주아니
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
세트
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
소나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
소라카
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
쉔
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
쉬바나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
스몰더
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
스웨인
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
스카너
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
시비르
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
신 짜오
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
신드라
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
신지드
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
쓰레쉬
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아리
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아무무
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아우렐리온 솔
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아이번
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아지르
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아칼리
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아크샨
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아트록스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
아펠리오스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
알리스타
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
암베사
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
애니
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
애니비아
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
애쉬
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
야스오
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
에코
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
엘리스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
오공
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
오로라
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
오른
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
오리아나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
올라프
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
요네
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
요릭
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
우디르
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
우르곳
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
워윅
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
유나라
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
유미
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
이렐리아
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
이블린
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
이즈리얼
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
일라오이
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
자르반 4세
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
자야
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
자이라
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
자크
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
자헨
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
잔나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
잭스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
제드
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
제라스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
제리
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
제이스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
조이
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
직스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
진
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
질리언
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
징크스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
초가스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
카르마
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
카밀
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
카사딘
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
카서스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
카시오페아
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
카이사
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
카직스
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
카타리나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
칼리스타
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
케넨
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
케이틀린
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
케인
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
케일
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
코그모
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
코르키
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
퀸
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
크산테
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
클레드
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
키아나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
킨드레드
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
타릭
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
탈론
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
탈리야
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
탐 켄치
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
트런들
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
트리스타나
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
트린다미어
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
트위스티드 페이트
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
트위치
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
티모
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
파이크
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
판테온
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
피들스틱
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
피오라
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
피즈
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
하이머딩거
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
헤카림
|
||||
</li><li data-v-223720d7="" class="champion-item">
|
||||
흐웨이
|
||||
</li></ul></div></div></div></div></div></div></div>
|
||||
|
||||
|
||||
<div class="mb-[8px]"><div class="border border-[#e6e6e6]"><header class="flex items-center h-[44px] border-b border-b-[#e6e6e6] bg-white px-[16px] text-[14px]">
|
||||
최근 20게임 전적 요약
|
||||
</header> <div class="flex flex-wrap"><div md="border-r basis-8/12 border-r-[#e6e6e6]" lg="basis-4/12" class="basis-full"><div class="flex text-center"><div class="flex flex-col basis-full"><div class="flex items-center justify-center h-[30px] text-[#808080] text-[12px] bg-[#f0f0f0]">승률</div> <div class="flex flex-col items-center justify-center h-[100px] text-[12px] bg-white"><strong class="text-[16px]">50%</strong> <p class="flex flex-col gap-[4px] mt-[10px] text-[12px] text-[#808080]"><span>10승 10패</span> <strong class="text-[#ed6767]">2 연패</strong></p></div></div> <div class="flex flex-col basis-full"><div class="flex items-center justify-center h-[30px] text-[#808080] text-[12px] bg-[#f0f0f0]">평점</div> <div class="flex flex-col items-center justify-center h-[100px] text-[12px] bg-white"><strong class="text-[16px]" style="color: rgb(128, 128, 128);">
|
||||
1.89
|
||||
</strong> <p class="mt-[10px] text-[12px] text-black">
|
||||
6.9 / <span class="text-[#ed6767]">7.3</span> /
|
||||
7.0
|
||||
</p></div></div> <div class="flex flex-col basis-full"><div class="flex items-center justify-center h-[30px] text-[#808080] text-[12px] bg-[#f0f0f0]">최고 평점</div> <div class="flex flex-col items-center justify-center h-[100px] text-[12px] bg-white"><strong class="text-[16px]" style="color: rgb(32, 122, 199);">
|
||||
Perfect
|
||||
</strong> <p class="mt-[10px] text-[12px] text-black">
|
||||
7 /
|
||||
<span class="text-[#ed6767]">0</span> /
|
||||
1
|
||||
</p></div></div></div></div> <div md="basis-4/12" lg="basis-2/12 border-r border-r-[#e6e6e6]" class="basis-full"><div><div class="flex items-center justify-center h-[30px] text-[#808080] text-[12px] bg-[#f0f0f0]">
|
||||
포지션 픽률
|
||||
</div> <div class="flex items-center justify-center h-[100px] text-[12px] bg-white"><div class="flex flex-col items-center justify-center basis-full text-[12px] text-[#808080]"><svg viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg" icon-lane="" style="--point-color: #ed6767; height: 28px;"><path d="M0 0V11.09L2.82 8.27V2.82H8.27L11.09 0H0Z" class="svg-group2"></path> <path d="M13.18 7.73V13.18H7.73003L4.91003 16H16V4.91L13.18 7.73Z" class="svg-group2"></path> <path d="M13.37 0L0 13.37V16H2.63L16 2.63V0H13.37Z" class="svg-group1"></path></svg> <div class="mt-[8px]"><span>미드</span> <span class="ml-[4px] text-black">100%</span></div></div></div></div></div> <div lg="basis-6/12" class="basis-full"><div><div class="flex items-center justify-center h-[30px] text-[#808080] text-[12px] bg-[#f0f0f0]">
|
||||
자주 플레이한 챔피언
|
||||
</div> <div class="flex items-center justify-center h-[100px] text-[12px] bg-white"><div class="flex flex-col items-center justify-center basis-full"><div class="mb-[4px]"><div class="relative has-tooltip" data-original-title="null"><img src="https://ddragon.dakgg.net/16.8.1/img/champion/Ahri.png" loading="" alt="아리" class="w-[40px] h-[40px] rounded-full"> <div class="w-[20px] h-[20px] border border-[#e6e6e6] bg-white rounded-1/2 absolute right-[-6px] bottom-0 flex items-center justify-center"><svg viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg" icon-lane="" style="--point-color: #ed6767; height: 10px;"><path d="M0 0V11.09L2.82 8.27V2.82H8.27L11.09 0H0Z" class="svg-group2"></path> <path d="M13.18 7.73V13.18H7.73003L4.91003 16H16V4.91L13.18 7.73Z" class="svg-group2"></path> <path d="M13.37 0L0 13.37V16H2.63L16 2.63V0H13.37Z" class="svg-group1"></path></svg></div></div></div> <p class="flex text-[12px] mb-[4px]"><span class="text-[#646464]">57%</span> <span class="ml-[4px] text-[#808080]">(4승 3패)</span></p> <p class="flex text-[12px]"><strong style="color: rgb(128, 128, 128);">2.28</strong> <span class="ml-[4px]">평점</span></p></div><div class="flex flex-col items-center justify-center basis-full"><div class="mb-[4px]"><div class="relative has-tooltip" data-original-title="null"><img src="https://ddragon.dakgg.net/16.8.1/img/champion/Leblanc.png" loading="" alt="르블랑" class="w-[40px] h-[40px] rounded-full"> <div class="w-[20px] h-[20px] border border-[#e6e6e6] bg-white rounded-1/2 absolute right-[-6px] bottom-0 flex items-center justify-center"><svg viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg" icon-lane="" style="--point-color: #ed6767; height: 10px;"><path d="M0 0V11.09L2.82 8.27V2.82H8.27L11.09 0H0Z" class="svg-group2"></path> <path d="M13.18 7.73V13.18H7.73003L4.91003 16H16V4.91L13.18 7.73Z" class="svg-group2"></path> <path d="M13.37 0L0 13.37V16H2.63L16 2.63V0H13.37Z" class="svg-group1"></path></svg></div></div></div> <p class="flex text-[12px] mb-[4px]"><span class="text-[#646464]">40%</span> <span class="ml-[4px] text-[#808080]">(2승 3패)</span></p> <p class="flex text-[12px]"><strong style="color: rgb(128, 128, 128);">2.19</strong> <span class="ml-[4px]">평점</span></p></div><div class="flex flex-col items-center justify-center basis-full"><div class="mb-[4px]"><div class="relative has-tooltip" data-original-title="null"><img src="https://ddragon.dakgg.net/16.8.1/img/champion/Syndra.png" loading="" alt="신드라" class="w-[40px] h-[40px] rounded-full"> <div class="w-[20px] h-[20px] border border-[#e6e6e6] bg-white rounded-1/2 absolute right-[-6px] bottom-0 flex items-center justify-center"><svg viewBox="0 0 16 16" xmlns="http://www.w3.org/2000/svg" icon-lane="" style="--point-color: #ed6767; height: 10px;"><path d="M0 0V11.09L2.82 8.27V2.82H8.27L11.09 0H0Z" class="svg-group2"></path> <path d="M13.18 7.73V13.18H7.73003L4.91003 16H16V4.91L13.18 7.73Z" class="svg-group2"></path> <path d="M13.37 0L0 13.37V16H2.63L16 2.63V0H13.37Z" class="svg-group1"></path></svg></div></div></div> <p class="flex text-[12px] mb-[4px]"><span class="text-[#646464]">75%</span> <span class="ml-[4px] text-[#808080]">(3승 1패)</span></p> <p class="flex text-[12px]"><strong style="color: rgb(128, 128, 128);">1.92</strong> <span class="ml-[4px]">평점</span></p></div></div></div></div></div></div></div>
|
||||
|
||||
|
||||
|
||||
<div class="mb-[8px]"><div class="mb-8px"><div md="flex flex-col" class="hidden"><div class="min-h-100px flex items-stretch border-l-8px border-[#808080] !border-[#ED6767]"><div class="flex flex-grow justify-between bg-[#FAFAFA] border-[#E6E6E6] border-t-1px border-b-1px border-r-1px !bg-[#FEF9F9]"><div class="flex align-center"><div class="inline-flex flex-row items-center justify-between"><div md="w-100px flex-col justify-center" lg="w-112px" class="flex flex-row items-center"><strong md="block" class="hidden text-[#808080] text-14px leading-[130%] mb-4px !text-[#ED6767]"><span>패배</span></strong> <span md="mr-0 mb-2px" class="text-[#000] text-12px leading-[130%] mr-4px">자유 랭크</span> <span md="mr-0 mb-2px" class="text-[#000] text-12px leading-[130%] mr-4px">26:52</span> <span class="text-[#808080] text-12px leading-[130%] has-tooltip" data-original-title="null">22시간 전</span></div> <div md="hidden" class="flex"><button type="button" class="text-14px text-[#808080]"><svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="angle-up" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512" class="svg-inline--fa fa-angle-up fa-w-14" style="display: none;"><path fill="currentColor" d="M201.4 137.4c12.5-12.5 32.8-12.5 45.3 0l160 160c12.5 12.5 12.5 32.8 0 45.3s-32.8 12.5-45.3 0L224 205.3 86.6 342.6c-12.5 12.5-32.8 12.5-45.3 0s-12.5-32.8 0-45.3l160-160z" class=""></path></svg> <svg aria-hidden="true" focusable="false" data-prefix="fas" data-icon="angle-down" role="img" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512" class="svg-inline--fa fa-angle-down fa-w-14"><path fill="currentColor" d="M201.4 374.6c12.5 12.5 32.8 12.5 45.3 0l160-160c12.5-12.5 12.5-32.8 0-45.3s-32.8-12.5-45.3 0L224 306.7 86.6 169.4c-12.5-12.5-32.8-12.5-45.3 0s-12.5 32.8 0 45.3l160 160z" class=""></path></svg></button></div></div> <div lg="gap-4px flex-row" class="inline-flex items-center gap-2px flex-col justify-center"><div lg="gap-4px" class="inline-flex gap-2px"><div class="flex-shrink-0 relative"><div role="img" lg="block" aria-label="신드라" class="hidden has-tooltip" data-original-title="null" style="width: 52px; height: 52px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -52px -52px; background-repeat: no-repeat; background-size: 1000%;"></div> <div role="img" lg="hidden" aria-label="신드라" data-original-title="null" class=" has-tooltip" style="width: 44px; height: 44px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -44px -44px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="absolute bottom-0 right-0 p-4px text-white text-12px leading-[130%] bg-black/40">14</span></div> <!----> <div class="flex-shrink-0 flex flex-col gap-4px"><div data-original-title="null" class=" has-tooltip"><div role="img" lg="block" aria-label="점멸" class="hidden" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/spell0.png"); background-position: -144px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <div role="img" lg="hidden" aria-label="점멸" style="width: 20px; height: 20px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/spell0.png"); background-position: -120px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div data-original-title="null" class=" has-tooltip"><div role="img" lg="block" aria-label="점화" class="hidden" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/spell0.png"); background-position: -96px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <div role="img" lg="hidden" aria-label="점화" style="width: 20px; height: 20px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/spell0.png"); background-position: -80px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div class="flex-shrink-0 flex flex-col gap-4px"><div lg="w-24px h-24px" class="flex items-center justify-center w-20px h-20px bg-black rounded-1/2"><img src="https://ddragon.dakgg.net/img/perk-images/Styles/Inspiration/FirstStrike/FirstStrike.png" loading="" alt="선제공격" lg="w-20px h-20px" class="w-16px h-16px has-tooltip" data-original-title="null"></div> <div lg="w-24px h-24px" class="flex items-center justify-center w-20px h-20px bg-black rounded-1/2">
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
4 /
|
||||
<span class="text-[#ED6767]">14</span> /
|
||||
6
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>0.71</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>48%</strong></span> <span class="mb-2px">CS <strong>157</strong> (5.8/m)</span> <span>시야점수 <strong>9</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="역병의 보석" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -84px -140px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="증폭의 고서" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -252px -28px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="투명 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -252px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악마의 마법서" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="역병의 보석" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -72px -120px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -144px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="증폭의 고서" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -216px -24px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; backgrLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
4 /
|
||||
<span class="text-[#ED6767]">14</span> /
|
||||
6
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>0.71</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>48%</strong></span> <span class="mb-2px">CS <strong>157</strong> (5.8/m)</span> <span>시야점수 <strong>9</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%A1%B0%EA%B0%81%ED%98%B8%EB%91%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="다리우스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -70px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">조각호두</span></a><a href="/summoner/kr/%EB%B3%B4%20%EB%93%A4-0101" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="이블린" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -14px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">보 들</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="신드라" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -14px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/PGaI6TFK9ytaGrcmdSlFGnBGWao4rHlgH2dUKwgKSnkymrs0qNxEwY6psfnR4gIoH6atztlry5OfMQ" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="이즈리얼" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -28px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">(Unknown)</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="룰루" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -70px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/tVDlnEXExa_E9PW-xdoLg2K2AfA5_XE9R7qizDNlA1PQ80sMb8Z5wGzriVBPWNddbQnkE--DCOEveQ" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="레넥톤" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion3.png"); background-position: -126px -14px; background-repeat: no-repLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
7 /
|
||||
<span class="text-[#ED6767]">10</span> /
|
||||
6
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.30</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>48%</strong></span> <span class="mb-2px">CS <strong>278</strong> (8.3/m)</span> <span>시야점수 <strong>25</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>8</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="존야의 모래시계" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -196px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="예언자의 렌즈" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -224px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -56px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="리치베인" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -140px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -96px -144px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="존야의 모래시계" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -168px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("hLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
7 /
|
||||
<span class="text-[#ED6767]">10</span> /
|
||||
6
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.30</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>48%</strong></span> <span class="mb-2px">CS <strong>278</strong> (8.3/m)</span> <span>시야점수 <strong>25</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>8</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%A1%B0%EA%B0%81%ED%98%B8%EB%91%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="다리우스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -70px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">조각호두</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="자이라" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -14px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="아리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -14px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%B9%98%EA%B3%BC%EC%9C%84%EC%83%9D%EC%82%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="애쉬" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: 0px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">치과위생사</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="세나" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion3.png"); background-position: -84px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/hype%20boy-311" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="애니비아" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -98px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
11 /
|
||||
<span class="text-[#ED6767]">4</span> /
|
||||
10
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(237, 103, 103);"><strong>5.25</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>68%</strong></span> <span class="mb-2px">CS <strong>221</strong> (7.9/m)</span> <span>시야점수 <strong>13</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>2</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="무덤꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -224px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -140px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="예언자의 렌즈" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -224px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -56px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="제어 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -196px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="무덤꽃" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -192px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -120px -48px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
11 /
|
||||
<span class="text-[#ED6767]">4</span> /
|
||||
10
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(237, 103, 103);"><strong>5.25</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>68%</strong></span> <span class="mb-2px">CS <strong>221</strong> (7.9/m)</span> <span>시야점수 <strong>13</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>2</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%A7%80%EA%B3%A0%EC%8B%B6%EB%8B%A4%EC%A6%9D%EB%A7%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="다리우스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -70px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">지고싶다증말</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="릴리아" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -28px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="아리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -14px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%B9%98%EA%B3%BC%EC%9C%84%EC%83%9D%EC%82%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="애쉬" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: 0px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">치과위생사</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="밀리오" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -28px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/Yuuri-JP33" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="니달리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/chLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7204_Resolve.png" loading="" alt="결의" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
14 /
|
||||
<span class="text-[#ED6767]">7</span> /
|
||||
10
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(17, 178, 136);"><strong>3.43</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px !text-[#207ac7] !border-[#207ac7]"><span>트리플 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>69%</strong></span> <span class="mb-2px">CS <strong>292</strong> (7.1/m)</span> <span>시야점수 <strong>42</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>15</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>9</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -56px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="공허의 지팡이" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -84px -224px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="존야의 모래시계" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -196px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="망원형 개조" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -196px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="무장 진격" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -140px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="라바돈의 죽음모자" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -140px -140px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -48px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="공허의 지팡이" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -72px -192px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="존야의 모래시계" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -168px -216px; background-repeat: Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7204_Resolve.png" loading="" alt="결의" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
14 /
|
||||
<span class="text-[#ED6767]">7</span> /
|
||||
10
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(17, 178, 136);"><strong>3.43</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px !text-[#207ac7] !border-[#207ac7]"><span>트리플 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>69%</strong></span> <span class="mb-2px">CS <strong>292</strong> (7.1/m)</span> <span>시야점수 <strong>42</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>15</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>9</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%A7%80%EA%B3%A0%EC%8B%B6%EB%8B%A4%EC%A6%9D%EB%A7%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="다리우스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -70px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">지고싶다증말</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="탈리야" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -42px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="신드라" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -14px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%B9%98%EA%B3%BC%EC%9C%84%EC%83%9D%EC%82%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="애쉬" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: 0px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">치과위생사</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="모르가나" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -84px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/22YGdCrU3-WBAcko6WPddPnHGH5hf0006rY5l280xMtpxK-RKnazkk47RZebkITvkWCPHUOn3wQkrg" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="레넥톤" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="nLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
4 /
|
||||
<span class="text-[#ED6767]">7</span> /
|
||||
1
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>0.71</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>36%</strong></span> <span class="mb-2px">CS <strong>141</strong> (6.3/m)</span> <span>시야점수 <strong>10</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="도란의 반지" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -84px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -252px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -28px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="예언자의 렌즈" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -224px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="마법공학 교류 발전기" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -140px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="도란의 반지" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -72px -48px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -216px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -24px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 2Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
4 /
|
||||
<span class="text-[#ED6767]">7</span> /
|
||||
1
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>0.71</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>36%</strong></span> <span class="mb-2px">CS <strong>141</strong> (6.3/m)</span> <span>시야점수 <strong>10</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%A7%80%EA%B3%A0%EC%8B%B6%EB%8B%A4%EC%A6%9D%EB%A7%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="다리우스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -70px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">지고싶다증말</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="자이라" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -14px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="르블랑" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -126px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%B9%98%EA%B3%BC%EC%9C%84%EC%83%9D%EC%82%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="애쉬" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: 0px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">치과위생사</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="룰루" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -70px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/yeohae-0428" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="나르" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -126px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px lLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7201_Precision.png" loading="" alt="정밀" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
6 /
|
||||
<span class="text-[#ED6767]">12</span> /
|
||||
1
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>0.58</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>44%</strong></span> <span class="mb-2px">CS <strong>202</strong> (7.2/m)</span> <span>시야점수 <strong>15</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>7</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="무덤꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -224px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -56px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="증폭의 고서" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -252px -28px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="투명 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -56px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="폭풍 쇄도" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -140px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="증폭의 고서" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -252px -28px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="무덤꽃" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -192px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -48px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="증폭의 고서" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -216px -24px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragoLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7201_Precision.png" loading="" alt="정밀" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
6 /
|
||||
<span class="text-[#ED6767]">12</span> /
|
||||
1
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>0.58</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>44%</strong></span> <span class="mb-2px">CS <strong>202</strong> (7.2/m)</span> <span>시야점수 <strong>15</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>7</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/hebi-%ED%97%A4%EB%B9%84%EB%B9%99" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="제이스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -28px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">hebi</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="탈리야" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -42px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="베이가" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -98px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EB%A0%9D%20%EA%B0%80-%EC%96%B4%20%ED%9D%A5" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="자야" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -84px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">렝 가</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="럭스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -84px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%83%9D%EC%82%B0%EC%A0%81%EC%9D%B8%EC%9D%BC%EC%9D%84%ED%95%B4%EB%9D%BC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="나르" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -126px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] teLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7200_Domination.png" loading="" alt="지배" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
3 /
|
||||
<span class="text-[#ED6767]">13</span> /
|
||||
9
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>0.92</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>57%</strong></span> <span class="mb-2px">CS <strong>216</strong> (6.4/m)</span> <span>시야점수 <strong>20</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>10</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="핏빛 저주" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item6.png"); background-position: -84px -84px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -56px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="운명의 재" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -112px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="투명 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="라일라이의 수정홀" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -56px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="사슬끈 분쇄자" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="기괴한 가면" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -56px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="핏빛 저주" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item6.png"); background-position: -72px -72px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -48px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="운명의 재" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -96px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="라일라이의 수정홀" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image:Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7200_Domination.png" loading="" alt="지배" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
3 /
|
||||
<span class="text-[#ED6767]">13</span> /
|
||||
9
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>0.92</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>57%</strong></span> <span class="mb-2px">CS <strong>216</strong> (6.4/m)</span> <span>시야점수 <strong>20</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>10</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/hebi-%ED%97%A4%EB%B9%84%EB%B9%99" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="올라프" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion3.png"); background-position: -84px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">hebi</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="릴리아" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -28px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="브랜드" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -98px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EB%A0%9D%20%EA%B0%80-%EC%96%B4%20%ED%9D%A5" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="트리스타나" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -112px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">렝 가</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="자이라" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -14px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EB%82%98%20%EC%98%A8-%EB%82%98%EC%98%A8%EC%9D%B4" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="세트" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion3.png"); background-position: -112px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leaLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7203_Whimsy.png" loading="" alt="영감" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
2 /
|
||||
<span class="text-[#ED6767]">9</span> /
|
||||
14
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.78</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>52%</strong></span> <span class="mb-2px">CS <strong>269</strong> (7.3/m)</span> <span>시야점수 <strong>19</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>9</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="리안드리의 고통" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -224px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -56px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="망원형 개조" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -196px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="라일라이의 수정홀" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -56px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 저주" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item6.png"); background-position: -84px -84px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div lg="w-[28px] h-[28px]" class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="리안드리의 고통" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -192px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -48px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -144px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="라일라이의 수정홀" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -48px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flexLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7203_Whimsy.png" loading="" alt="영감" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
2 /
|
||||
<span class="text-[#ED6767]">9</span> /
|
||||
14
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.78</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>52%</strong></span> <span class="mb-2px">CS <strong>269</strong> (7.3/m)</span> <span>시야점수 <strong>19</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>9</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/hebi-%ED%97%A4%EB%B9%84%EB%B9%99" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="사이온" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -42px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">hebi</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="릴리아" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -28px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="말자하" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -112px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EB%A0%9D%20%EA%B0%80-%EC%96%B4%20%ED%9D%A5" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="트리스타나" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -112px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">렝 가</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="레오나" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -14px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EB%9D%B5%20%20%20%20%20%20%20%20%20%20%20%20%EB%96%B5-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="케넨" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -42px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7204_Resolve.png" loading="" alt="결의" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
8 /
|
||||
<span class="text-[#ED6767]">5</span> /
|
||||
8
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(17, 178, 136);"><strong>3.20</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>47%</strong></span> <span class="mb-2px">CS <strong>214</strong> (6.5/m)</span> <span>시야점수 <strong>24</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>11</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -56px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div lg="w-[28px] h-[28px]" class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div><div class="flex"><div role="img" aria-label="망원형 개조" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -196px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="우주의 추진력" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -56px -140px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div lg="w-[28px] h-[28px]" class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -96px -144px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="어둠불꽃 횃불" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -48px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -144px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="우주의 추진력" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -48px -120px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div><div class="flex"><div role="img" aria-label="망원형 개조" data-original-title="null" classLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7204_Resolve.png" loading="" alt="결의" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
8 /
|
||||
<span class="text-[#ED6767]">5</span> /
|
||||
8
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(17, 178, 136);"><strong>3.20</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>47%</strong></span> <span class="mb-2px">CS <strong>214</strong> (6.5/m)</span> <span>시야점수 <strong>24</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>11</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%9A%94%EC%8B%9C%EA%B7%B8%EB%9E%80%EB%8F%84%EC%B0%8C%EC%B0%8C-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="베인" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -84px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">요시그란도찌찌</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="탈리야" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -42px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="신드라" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -14px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EB%A0%9D%20%EA%B0%80-%EC%96%B4%20%ED%9D%A5" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="자야" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -84px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">렝 가</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="룰루" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -70px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%ED%99%8D%EB%8C%80%20%EB%A7%9B%EC%A7%91-0004" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="다리우스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -70px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
18 /
|
||||
<span class="text-[#ED6767]">3</span> /
|
||||
4
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(237, 103, 103);"><strong>7.33</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px !text-[#207ac7] !border-[#207ac7]"><span>트리플 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>55%</strong></span> <span class="mb-2px">CS <strong>209</strong> (6.7/m)</span> <span>시야점수 <strong>26</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>7</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div lg="w-[28px] h-[28px]" class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div><div class="flex"><div role="img" aria-label="마법공학 로켓 벨트" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -84px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="존야의 모래시계" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -196px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="예언자의 렌즈" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -224px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="사슬끈 분쇄자" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div><div class="flex"><div role="img" aria-label="마법공학 로켓 벨트" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -72px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="존야의 모래시계" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -168px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="사슬끈 분쇄자" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -96px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class="Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
18 /
|
||||
<span class="text-[#ED6767]">3</span> /
|
||||
4
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(237, 103, 103);"><strong>7.33</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px !text-[#207ac7] !border-[#207ac7]"><span>트리플 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>55%</strong></span> <span class="mb-2px">CS <strong>209</strong> (6.7/m)</span> <span>시야점수 <strong>26</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>7</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%9A%94%EC%8B%9C%EA%B7%B8%EB%9E%80%EB%8F%84%EC%B0%8C%EC%B0%8C-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="직스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -112px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">요시그란도찌찌</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="자이라" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -14px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="아리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -14px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EB%A0%9D%20%EA%B0%80-%EC%96%B4%20%ED%9D%A5" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="베인" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -84px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">렝 가</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="룰루" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -70px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EA%B7%A4%EB%A8%B9%EC%9C%BC%EB%9F%AC%EA%B0%80%EC%9E%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="베이가" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14pLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
7 /
|
||||
<span class="text-[#ED6767]">7</span> /
|
||||
7
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.00</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>70%</strong></span> <span class="mb-2px">CS <strong>223</strong> (7.7/m)</span> <span>시야점수 <strong>17</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>4</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="리치베인" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="천 갑옷" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -224px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="예언자의 렌즈" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -224px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -56px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -140px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -96px -144px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="리치베인" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -144px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="천 갑옷" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -192px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/1Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
7 /
|
||||
<span class="text-[#ED6767]">7</span> /
|
||||
7
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.00</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>70%</strong></span> <span class="mb-2px">CS <strong>223</strong> (7.7/m)</span> <span>시야점수 <strong>17</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>4</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EB%90%9C%EC%9E%A5%EC%9D%B4%EC%8B%B8%EC%9A%B0%EB%A9%B4%EC%8C%88%EC%9E%A5-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="잭스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -14px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">된장이싸우면쌈장</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="카서스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -112px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="아리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -14px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EB%A7%90%EB%A6%AC%EB%A9%B4%EB%A7%90%EB%A6%AC%EA%BD%83%EB%B6%80%EB%A6%84-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="제리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -98px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">말리면말리꽃부름</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="유미" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -42px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EB%8B%88%EC%A3%BD%EB%82%B4%EC%A3%BD-%ED%83%91%EC%8B%A0%EB%B3%91%EC%9E%90" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="베인" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-positionLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
8 /
|
||||
<span class="text-[#ED6767]">9</span> /
|
||||
11
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.11</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>46%</strong></span> <span class="mb-2px">CS <strong>149</strong> (5.0/m)</span> <span>시야점수 <strong>24</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>11</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="리치베인" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div lg="w-[28px] h-[28px]" class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div><div class="flex"><div role="img" aria-label="투명 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -56px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="밴시의 장막" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -28px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="증폭의 고서" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -252px -28px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="리치베인" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -144px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -48px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="밴시의 장막" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -24px -144px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
8 /
|
||||
<span class="text-[#ED6767]">9</span> /
|
||||
11
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.11</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>46%</strong></span> <span class="mb-2px">CS <strong>149</strong> (5.0/m)</span> <span>시야점수 <strong>24</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>11</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EB%90%9C%EC%9E%A5%EC%9D%B4%EC%8B%B8%EC%9A%B0%EB%A9%B4%EC%8C%88%EC%9E%A5-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="제이스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -28px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">된장이싸우면쌈장</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="탈리야" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -42px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="아리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -14px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EB%A7%90%EB%A6%AC%EB%A9%B4%EB%A7%90%EB%A6%AC%EA%BD%83%EB%B6%80%EB%A6%84-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="코르키" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -56px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">말리면말리꽃부름</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="유미" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -42px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EA%B8%B0%20%EC%A0%88-%EC%9B%8C%20%EC%9C%85" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="요네" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: 0px -14px; background-Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7201_Precision.png" loading="" alt="정밀" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
9 /
|
||||
<span class="text-[#ED6767]">10</span> /
|
||||
10
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.90</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>44%</strong></span> <span class="mb-2px">CS <strong>229</strong> (6.6/m)</span> <span>시야점수 <strong>29</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>12</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="라바돈의 죽음모자" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -140px -140px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="제어 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -196px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="존야의 모래시계" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -196px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="투명 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="무장 진격" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -140px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -252px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="라바돈의 죽음모자" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -120px -120px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="제어 와드" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -168px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="존야의 모래시계" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -168px -216px; background-repeat: no-repeat; background-size: 1000%;"></divLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7201_Precision.png" loading="" alt="정밀" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
9 /
|
||||
<span class="text-[#ED6767]">10</span> /
|
||||
10
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.90</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>44%</strong></span> <span class="mb-2px">CS <strong>229</strong> (6.6/m)</span> <span>시야점수 <strong>29</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>12</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EA%B0%95%EC%B2%A0%EB%AC%98%EB%AA%A9-%EB%8D%98%EC%A7%80%EA%B8%B0" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="문도 박사" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -112px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">강철묘목</span></a><a href="/summoner/kr/%EC%9B%90%EB%94%9C%EB%A1%9C%20%EA%B7%B8%EB%A7%88%EA%B0%80%EC%9E%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="자헨" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -56px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">원딜로 그마가자</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="신드라" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -14px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%9E%89%ED%98%B8%EB%B0%94-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="징크스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -56px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">잉호바</span></a><a href="/summoner/kr/osu-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="바드" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -56px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">osu</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%95%84%ED%81%AC%EC%8A%A4%ED%8A%B8%ED%94%84-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="스카너" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/spriteLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
4 /
|
||||
<span class="text-[#ED6767]">4</span> /
|
||||
5
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.25</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>43%</strong></span> <span class="mb-2px">CS <strong>200</strong> (7.2/m)</span> <span>시야점수 <strong>18</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>2</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="도란의 반지" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -84px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -28px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="추적자의 팔목 보호대" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -196px -224px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="예언자의 렌즈" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -224px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -252px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="도란의 반지" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -72px -48px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -24px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="추적자의 팔목 보호대" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item2.png"); background-position: -168px -192px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 24px; heLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
4 /
|
||||
<span class="text-[#ED6767]">4</span> /
|
||||
5
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.25</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>43%</strong></span> <span class="mb-2px">CS <strong>200</strong> (7.2/m)</span> <span>시야점수 <strong>18</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>2</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EA%B0%95%EC%B2%A0%EB%AC%98%EB%AA%A9-%EB%8D%98%EC%A7%80%EA%B8%B0" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="갱플랭크" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -98px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">강철묘목</span></a><a href="/summoner/kr/%EC%9B%90%EB%94%9C%EB%A1%9C%20%EA%B7%B8%EB%A7%88%EA%B0%80%EC%9E%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="리 신" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: 0px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">원딜로 그마가자</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="르블랑" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -126px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%9E%89%ED%98%B8%EB%B0%94-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="징크스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -56px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">잉호바</span></a><a href="/summoner/kr/osu-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="카르마" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -98px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">osu</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EA%B7%BC%EC%B6%98%EC%9D%B4-0816" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="말파이트" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -98px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%]Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
1 /
|
||||
<span class="text-[#ED6767]">3</span> /
|
||||
3
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.33</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>13%</strong></span> <span class="mb-2px">CS <strong>170</strong> (7.5/m)</span> <span>시야점수 <strong>12</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>5</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="도란의 반지" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -84px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -28px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="예언자의 렌즈" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -224px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -56px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div lg="w-[28px] h-[28px]" class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="도란의 반지" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -72px -48px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -24px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="핏빛 명석함" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -48px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="nullLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
1 /
|
||||
<span class="text-[#ED6767]">3</span> /
|
||||
3
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.33</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>13%</strong></span> <span class="mb-2px">CS <strong>170</strong> (7.5/m)</span> <span>시야점수 <strong>12</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>5</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EA%B0%95%EC%B2%A0%EB%AC%98%EB%AA%A9-%EB%8D%98%EC%A7%80%EA%B8%B0" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="요릭" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -14px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">강철묘목</span></a><a href="/summoner/kr/%EC%9B%90%EB%94%9C%EB%A1%9C%20%EA%B7%B8%EB%A7%88%EA%B0%80%EC%9E%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="렝가" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion3.png"); background-position: 0px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">원딜로 그마가자</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="아리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -14px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%9E%89%ED%98%B8%EB%B0%94-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="진" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -42px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">잉호바</span></a><a href="/summoner/kr/moKcsoIRFnrNk7xDt0d1870MjDvi7pg-ZA5mtlwZChcW_auQBInEoyTUF6fo7PSp9gIiDfVAeWl0Bw" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="쓰레쉬" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -98px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">(Unknown)</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%B0%90%20%EC%9B%A1-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="말파이트" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -98px -14px; background-repeat: no-repeat; background-size: 1000%;"></diLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
7 /
|
||||
<span class="text-[#ED6767]">0</span> /
|
||||
1
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(32, 122, 199);"><strong>Perfect</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>44%</strong></span> <span class="mb-2px">CS <strong>135</strong> (8.7/m)</span> <span>시야점수 <strong>10</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>5</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -140px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -28px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -252px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="투명 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="마법공학 교류 발전기" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="암흑의 인장" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -168px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -120px -48px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -24px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -216px -216px; background-repeat: no-repeat; background-sLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
7 /
|
||||
<span class="text-[#ED6767]">0</span> /
|
||||
1
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(32, 122, 199);"><strong>Perfect</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>44%</strong></span> <span class="mb-2px">CS <strong>135</strong> (8.7/m)</span> <span>시야점수 <strong>10</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>5</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EA%B0%95%EC%B2%A0%EB%AC%98%EB%AA%A9-%EB%8D%98%EC%A7%80%EA%B8%B0" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="럼블" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion3.png"); background-position: -28px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">강철묘목</span></a><a href="/summoner/kr/%EC%9B%90%EB%94%9C%EB%A1%9C%20%EA%B7%B8%EB%A7%88%EA%B0%80%EC%9E%90-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="리 신" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: 0px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">원딜로 그마가자</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="르블랑" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -126px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%9E%89%ED%98%B8%EB%B0%94-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="케이틀린" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: 0px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">잉호바</span></a><a href="/summoner/kr/moKcsoIRFnrNk7xDt0d1870MjDvi7pg-ZA5mtlwZChcW_auQBInEoyTUF6fo7PSp9gIiDfVAeWl0Bw" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="럭스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -84px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">(Unknown)</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EB%8B%AC%EA%B1%80%20%ED%86%A0%EB%A7%88%ED%86%A0%20%EB%B3%B6%EC%9D%8C-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="오른" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 1Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7201_Precision.png" loading="" alt="정밀" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
5 /
|
||||
<span class="text-[#ED6767]">5</span> /
|
||||
7
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.40</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>41%</strong></span> <span class="mb-2px">CS <strong>229</strong> (7.4/m)</span> <span>시야점수 <strong>19</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>8</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="지평선의 초점" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -28px -140px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -252px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="제어 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -196px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="망원형 개조" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -196px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="방출의 마법봉" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -140px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="지평선의 초점" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -24px -120px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -216px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="제어 와드" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -168px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><dLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7201_Precision.png" loading="" alt="정밀" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
5 /
|
||||
<span class="text-[#ED6767]">5</span> /
|
||||
7
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.40</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>41%</strong></span> <span class="mb-2px">CS <strong>229</strong> (7.4/m)</span> <span>시야점수 <strong>19</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>8</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/m5O5fM6RTF6FGprTaU88x8atEbyGs2tZqloVYtSY-5yVZMGwdDk0WGsQJ3TV_aqyQ7i_HM-ZZdhV1w" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="잭스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -14px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">(Unknown)</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="나피리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -98px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="제라스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -98px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%9D%B4%EB%9D%BC%EA%B8%B0%EC%9E%87%EB%82%98-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="아펠리오스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -126px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">이라기잇나</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="유미" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -42px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EB%AF%B8%EB%93%9C%EB%8B%98%EB%B8%94%EB%A3%A8%EB%BA%8F%EA%B2%BC%EC%9D%8C-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="암베사" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height:Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
12 /
|
||||
<span class="text-[#ED6767]">12</span> /
|
||||
16
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.33</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>61%</strong></span> <span class="mb-2px">CS <strong>249</strong> (5.9/m)</span> <span>시야점수 <strong>47</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>16</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="무덤꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -224px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -252px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="라바돈의 죽음모자" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -140px -140px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="투명 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="마법공학 교류 발전기" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="무덤꽃" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -192px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -216px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="라바돈의 죽음모자" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -120px -120px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 24px; hLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
12 /
|
||||
<span class="text-[#ED6767]">12</span> /
|
||||
16
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.33</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>61%</strong></span> <span class="mb-2px">CS <strong>249</strong> (5.9/m)</span> <span>시야점수 <strong>47</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>16</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%A0%80%EC%88%9C%EC%9D%B4-INFJ" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="잭스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -14px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">저순이</span></a><a href="/summoner/kr/%EC%86%8C%20%EB%8B%A4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="릴리아" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -28px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">소 다</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="르블랑" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -126px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EC%9D%B4%EB%9D%BC%EA%B8%B0%EC%9E%87%EB%82%98-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="이즈리얼" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -28px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">이라기잇나</span></a><a href="/summoner/kr/%ED%98%B8%ED%98%B8%EB%B6%88%EC%96%B4%EB%A8%B9%EC%96%B4%EC%9A%94-0000" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="블리츠크랭크" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -84px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">호호불어먹어요</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%EC%9D%B4%EB%9F%B4%EB%95%8C%EA%B0%80%EC%95%84%EB%8B%88%EC%95%BC-%EC%A0%95%EC%8B%A0%EC%B0%A8%EB%A0%A4" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="그라가스" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: 0px -14px; background-repeat: no-repeat;Line truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
3 /
|
||||
<span class="text-[#ED6767]">10</span> /
|
||||
9
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.20</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>57%</strong></span> <span class="mb-2px">CS <strong>224</strong> (7.1/m)</span> <span>시야점수 <strong>26</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>11</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="무덤꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -224px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -112px -196px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -28px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="투명 와드" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -112px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="리치베인" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: 0px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div lg="w-[28px] h-[28px]" class="inline-flex w-[24px] h-[24px] bg-[#e6e6e6]"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="무덤꽃" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -192px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="악의" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item3.png"); background-position: -96px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -24px -216px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -144px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="리치베인" data-original-title="null" claLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
3 /
|
||||
<span class="text-[#ED6767]">10</span> /
|
||||
9
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>1.20</strong> <span>평점</span></span> <div md="block" class="hidden"><!----></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>57%</strong></span> <span class="mb-2px">CS <strong>224</strong> (7.1/m)</span> <span>시야점수 <strong>26</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>0</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>11</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%ED%91%B8%EB%A5%B8%ED%8C%A1%ED%8C%A1%EC%9D%B4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="요릭" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -14px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">푸른팡팡이</span></a><a href="/summoner/kr/ahAnpGRinpEZpb46u4GIeXeOrQ-h9kSjI8pqjhfFZ7UCQTnM_AFO-8gGB3TDyB7p4tNDDZS4VkEjZA" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="세주아니" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion3.png"); background-position: -70px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">(Unknown)</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="아리" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -14px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/%EB%9D%A0%EB%A3%A8%EC%95%BC-%EC%8B%9C%EB%A3%A8%EC%95%BC" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="코르키" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: -56px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">띠루야</span></a><a href="/summoner/kr/%ED%98%AC%20%EC%93%B0-KR94" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="유미" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion5.png"); background-position: -42px -14px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">혬 쓰</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/HX1mSCbBSDUquN23RgqGN2PgXZShiIsy3X4aMNWEgvPxRn1GgNM6WIasZNQHzNhjOnKb3dxbsEFnHQ" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="갱플랭크" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -98px 0px; background-repeat: no-repeat; background-siLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
5 /
|
||||
<span class="text-[#ED6767]">3</span> /
|
||||
2
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.33</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>54%</strong></span> <span class="mb-2px">CS <strong>205</strong> (7.4/m)</span> <span>시야점수 <strong>17</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div> <div class="flex"><div md="inline-flex w-[102px]" lg="w-[118px]" class="hidden flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -140px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -140px -56px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -28px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="예언자의 렌즈" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -224px -112px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="주문투척자의 신발" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item4.png"); background-position: -168px 0px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="그림자불꽃" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -112px -168px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="루덴의 메아리" data-original-title="null" class=" has-tooltip" style="width: 28px; height: 28px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item5.png"); background-position: -252px -252px; background-repeat: no-repeat; background-size: 1000%;"></div></div></div> <div md="hidden" class="inline-flex flex-wrap items-center content-center gap-2px"><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -120px -48px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="쓸데없이 큰 지팡이" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -120px -48px; background-repeat: no-repeat; background-size: 1000%;"></div></div><div class="flex"><div role="img" aria-label="충전형 물약" data-original-title="null" class=" has-tooltip" style="width: 24px; height: 24px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/item0.png"); background-position: -24px -216px; background-repeat: no-repeat; bacLine truncated
|
||||
|
||||
<img src="https://ddragon.dakgg.net/img/perk-images/Styles/7202_Sorcery.png" loading="" alt="마법" lg="w-16px h-16px" class="w-12px h-12px has-tooltip" data-original-title="null"></div></div></div></div> <div md="w-130px" lg="w-160px" class="inline-flex flex-col items-center justify-center w-110px"><strong class="text-black text-16px leading-[130%] mb-4px">
|
||||
5 /
|
||||
<span class="text-[#ED6767]">3</span> /
|
||||
2
|
||||
</strong> <span class="text-[#808080] text-12px leading-[130%]" style="color: rgb(128, 128, 128);"><strong>2.33</strong> <span>평점</span></span> <div md="block" class="hidden"><div class="text-[#11B288] text-12px leading-[130%] border border-[#11B288] rounded-18px flex justify-center mt-8px w-90px h-18px"><span>더블 킬</span></div></div></div> <div md="flex-col w-110px text-12px" lg="w-120px" class="inline-flex flex-row justify-center text-black text-11px leading-[130%]"><div sm="w-90px" md="w-auto" class="inline-flex flex-col justify-center w-70px"><span class="mb-2px">킬 관여 <strong>54%</strong></span> <span class="mb-2px">CS <strong>205</strong> (7.4/m)</span> <span>시야점수 <strong>17</strong></span></div> <div sm="w-60px" md="flex-row w-auto" class="mt-4px inline-flex flex-col w-40px"><div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-control.svg" alt="제어와드 구매 수" class="mr-2px has-tooltip" data-original-title="null"> <span>1</span></div> <div class="mr-4px inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-normal.svg" alt="와드 설치 수" class="mr-2px has-tooltip" data-original-title="null"> <span>6</span></div> <div class="inline-flex"><img src="//cdn.dak.gg/lol/images/ico-ward-del.svg" alt="와드 파괴 수" class="mr-2px has-tooltip" data-original-title="null"> <span>3</span></div></div></div></div> <div sm="flex flex-col" class="hidden"><div class="flex align-center"><div lg="flex" class="hidden"><div class="inline-flex flex-wrap content-center w-288px py-2"><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/%ED%91%B8%EB%A5%B8%ED%8C%A1%ED%8C%A1%EC%9D%B4-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="사이온" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion4.png"); background-position: -42px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">푸른팡팡이</span></a><a href="/summoner/kr/%EB%9D%A0%EB%A3%A8%EC%95%BC-%EC%8B%9C%EB%A3%A8%EC%95%BC" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="녹턴" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion3.png"); background-position: -56px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">띠루야</span></a><a href="/summoner/kr/%ED%94%84%EB%A6%AC%EB%A6%AC-KR1" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="르블랑" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion2.png"); background-position: -126px 0px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden !text-[#646464] !font-bold">프리리</span></a><a href="/summoner/kr/ahAnpGRinpEZpb46u4GIeXeOrQ-h9kSjI8pqjhfFZ7UCQTnM_AFO-8gGB3TDyB7p4tNDDZS4VkEjZA" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="케이틀린" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion0.png"); background-position: 0px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">(Unknown)</span></a><a href="/summoner/kr/%ED%98%AC%20%EC%93%B0-KR94" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="카르마" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-image: url("https://ddragon.dakgg.net/16.8.1/img/sprite/champion1.png"); background-position: -98px -28px; background-repeat: no-repeat; background-size: 1000%;"></div> <span class="text-[#808080] text-11px leading-[130%] overflow-ellipsis whitespace-nowrap overflow-hidden">혬 쓰</span></a></div><div class="inline-flex flex-col gap-y-2px w-[50%]"><a href="/summoner/kr/2XuQyzloLCmxS4LKC-J48QB1qX9lPsLrOOyv-owhirPi3s9BYdPQnug_58ofV04435uE8vGWh88alw" target="_blank" rel="noopener noreferrer" class="flex items-center"><div role="img" aria-label="애니비아" class="flex-shrink-0 mr-2px has-tooltip" data-original-title="null" style="width: 14px; height: 14px; background-imageLine truncated
|
||||
BIN
Binary file not shown.
|
Before Width: | Height: | Size: 213 KiB |
@@ -28,7 +28,7 @@ const { MongoClient, ObjectId } = require("mongodb");
|
||||
|
||||
const CONFIG = {
|
||||
MONGODB_URI: process.env.MONGODB_URI ?? "mongodb://127.0.0.1:27017",
|
||||
LOLYMPUS_DB_NAME: process.env.LOLYMPUS_DB_NAME ?? "lolympus-test",
|
||||
LOLYMPUS_DB_NAME: process.env.LOLYMPUS_DB_NAME ?? "lolympus-staging",
|
||||
COMMUNITY_ID: new ObjectId(
|
||||
process.env.COMMUNITY_ID ?? "69ebe0adf627c11be2f020a1",
|
||||
),
|
||||
@@ -137,14 +137,18 @@ async function fetchRiotJson({ host, path, query }) {
|
||||
});
|
||||
|
||||
if (response.status === 429) {
|
||||
const retryAfterSeconds = Number(response.headers.get("retry-after") ?? 1);
|
||||
const retryAfterSeconds = Number(
|
||||
response.headers.get("retry-after") ?? 1,
|
||||
);
|
||||
await sleep(Math.max(1, retryAfterSeconds) * 1000);
|
||||
continue;
|
||||
}
|
||||
if (response.status === 404) return null;
|
||||
if (!response.ok) {
|
||||
const body = await response.text().catch(() => "");
|
||||
throw new Error(`Riot API failed ${response.status} ${url.pathname}: ${body}`);
|
||||
throw new Error(
|
||||
`Riot API failed ${response.status} ${url.pathname}: ${body}`,
|
||||
);
|
||||
}
|
||||
return response.json();
|
||||
}
|
||||
@@ -190,13 +194,14 @@ async function fetchRecentMatchIdsByPuuid(puuid) {
|
||||
|
||||
async function fetchRiotData({ riotId }) {
|
||||
const fallback = splitRiotId(riotId);
|
||||
const account =
|
||||
(await fetchAccountByRiotId(fallback)) ?? {
|
||||
...fallback,
|
||||
puuid: normalizeString(INPUT.puuid),
|
||||
};
|
||||
const account = (await fetchAccountByRiotId(fallback)) ?? {
|
||||
...fallback,
|
||||
puuid: normalizeString(INPUT.puuid),
|
||||
};
|
||||
if (!account?.puuid) {
|
||||
throw new Error(`Riot account not found and PUUID was not provided: ${riotId}`);
|
||||
throw new Error(
|
||||
`Riot account not found and PUUID was not provided: ${riotId}`,
|
||||
);
|
||||
}
|
||||
|
||||
const [summoner, leagueEntries, championMasteries, matchIds] =
|
||||
@@ -280,7 +285,9 @@ function buildRiotAccount(riotData, now) {
|
||||
summonerLevel: riotData.summoner?.summonerLevel ?? 0,
|
||||
isPrimary: true,
|
||||
tiers: riotData.leagueEntries.map((entry) => toTierInfo(entry, now)),
|
||||
tierHistory: riotData.leagueEntries.map((entry) => toTierHistory(entry, now)),
|
||||
tierHistory: riotData.leagueEntries.map((entry) =>
|
||||
toTierHistory(entry, now),
|
||||
),
|
||||
matchIds: riotData.matchIds,
|
||||
matchIdsFetchedAt: riotData.matchIds.length > 0 ? now : undefined,
|
||||
championMasteries: riotData.championMasteries
|
||||
|
||||
@@ -1,11 +1,11 @@
|
||||
/**
|
||||
* Apply already-saved Dakao user bootstrap data into lolympus-test.user.
|
||||
* Apply already-saved Dakao user bootstrap data into lolympus-staging.user.
|
||||
*
|
||||
* This script does NOT call Riot API.
|
||||
*
|
||||
* It reads saved documents from one of:
|
||||
* 1. lolympus-test.DakaoUserBootstrapRun
|
||||
* 2. lolympus-test.DakaoUserBootstrapCandidate
|
||||
* 1. lolympus-staging.DakaoUserBootstrapRun
|
||||
* 2. lolympus-staging.DakaoUserBootstrapCandidate
|
||||
*
|
||||
* It only applies users that already have a valid Riot identity:
|
||||
* - dryRunUsers[].doc.riotAccounts[0].puuid, or
|
||||
@@ -34,7 +34,7 @@ const { MongoClient, ObjectId } = require("mongodb");
|
||||
|
||||
const CONFIG = {
|
||||
MONGODB_URI: process.env.MONGODB_URI ?? "mongodb://127.0.0.1:27017",
|
||||
LOLYMPUS_DB_NAME: process.env.LOLYMPUS_DB_NAME ?? "lolympus-test",
|
||||
LOLYMPUS_DB_NAME: process.env.LOLYMPUS_DB_NAME ?? "lolympus-staging",
|
||||
COMMUNITY_ID: new ObjectId(
|
||||
process.env.COMMUNITY_ID ?? "69ebe0adf627c11be2f020a1",
|
||||
),
|
||||
@@ -89,8 +89,8 @@ function maskConfig() {
|
||||
function hasValidRiotAccount(account) {
|
||||
return Boolean(
|
||||
normalizeString(account?.puuid) &&
|
||||
normalizeString(account?.gameName) &&
|
||||
normalizeString(account?.tagLine),
|
||||
normalizeString(account?.gameName) &&
|
||||
normalizeString(account?.tagLine),
|
||||
);
|
||||
}
|
||||
|
||||
@@ -151,14 +151,19 @@ function buildPlanFromDryRunUser(planned, now) {
|
||||
planned.filter?.communityId ?? doc.communityId ?? CONFIG.COMMUNITY_ID,
|
||||
"planned.communityId",
|
||||
),
|
||||
kakaoTalkId: normalizeString(planned.filter?.kakaoTalkId ?? doc.kakaoTalkId),
|
||||
kakaoTalkId: normalizeString(
|
||||
planned.filter?.kakaoTalkId ?? doc.kakaoTalkId,
|
||||
),
|
||||
},
|
||||
doc: removeUndefined({
|
||||
_id:
|
||||
doc._id && ObjectId.isValid(String(doc._id))
|
||||
? toObjectId(doc._id, "planned.doc._id")
|
||||
: new ObjectId(),
|
||||
communityId: toObjectId(doc.communityId ?? CONFIG.COMMUNITY_ID, "doc.communityId"),
|
||||
communityId: toObjectId(
|
||||
doc.communityId ?? CONFIG.COMMUNITY_ID,
|
||||
"doc.communityId",
|
||||
),
|
||||
role: doc.role ?? "member",
|
||||
kakaoTalkId: normalizeString(doc.kakaoTalkId),
|
||||
kakaoTalkNickname: normalizeString(doc.kakaoTalkNickname),
|
||||
@@ -228,12 +233,18 @@ function buildPlanFromCandidate(candidate, now) {
|
||||
return {
|
||||
source: "candidate",
|
||||
filter: {
|
||||
communityId: toObjectId(candidate.communityId ?? CONFIG.COMMUNITY_ID, "candidate.communityId"),
|
||||
communityId: toObjectId(
|
||||
candidate.communityId ?? CONFIG.COMMUNITY_ID,
|
||||
"candidate.communityId",
|
||||
),
|
||||
kakaoTalkId: normalizeString(candidate.kakaoTalkId),
|
||||
},
|
||||
doc: removeUndefined({
|
||||
_id: new ObjectId(),
|
||||
communityId: toObjectId(candidate.communityId ?? CONFIG.COMMUNITY_ID, "candidate.communityId"),
|
||||
communityId: toObjectId(
|
||||
candidate.communityId ?? CONFIG.COMMUNITY_ID,
|
||||
"candidate.communityId",
|
||||
),
|
||||
role: candidate.role ?? "member",
|
||||
kakaoTalkId: normalizeString(candidate.kakaoTalkId),
|
||||
kakaoTalkNickname: normalizeString(
|
||||
@@ -300,7 +311,9 @@ async function loadPlansFromCandidates(lolympusDb, now) {
|
||||
communityId: CONFIG.COMMUNITY_ID,
|
||||
}).toArray();
|
||||
const plans = dedupePlans(
|
||||
candidates.map((candidate) => buildPlanFromCandidate(candidate, now)).filter(Boolean),
|
||||
candidates
|
||||
.map((candidate) => buildPlanFromCandidate(candidate, now))
|
||||
.filter(Boolean),
|
||||
);
|
||||
return { sourceRun: null, plans };
|
||||
}
|
||||
|
||||
@@ -19,7 +19,7 @@
|
||||
* -> join nickname base with RiotAccount.gameName
|
||||
* -> verify/fetch puuid from Riot Account API
|
||||
* -> fetch summoner / league / mastery / recent match ids from Riot API
|
||||
* -> upsert lolympus-test.user
|
||||
* -> upsert lolympus-staging.user
|
||||
*/
|
||||
|
||||
"use strict";
|
||||
@@ -32,7 +32,7 @@ const CONFIG = {
|
||||
RIOT_API_KEY: process.env.RIOT_API_KEY ?? "",
|
||||
|
||||
DAKAO_DB_NAME: "dakao",
|
||||
LOLYMPUS_DB_NAME: "lolympus-test",
|
||||
LOLYMPUS_DB_NAME: "lolympus-staging",
|
||||
RIOT_ACCOUNT_DB_NAME: process.env.RIOT_ACCOUNT_DB_NAME ?? "dakao",
|
||||
RIOT_ACCOUNT_COLLECTION_NAME:
|
||||
process.env.RIOT_ACCOUNT_COLLECTION_NAME ?? "RiotAccount",
|
||||
@@ -50,7 +50,7 @@ const CONFIG = {
|
||||
RECENT_MATCH_COUNT: Number(process.env.RECENT_MATCH_COUNT ?? 20),
|
||||
FETCH_RECENT_MATCH_IDS: process.env.FETCH_RECENT_MATCH_IDS !== "false",
|
||||
|
||||
// Safe default. Set DRY_RUN=false to write into lolympus-test.user.
|
||||
// Safe default. Set DRY_RUN=false to write into lolympus-staging.user.
|
||||
DRY_RUN: process.env.DRY_RUN !== "false",
|
||||
SAVE_DRY_RUN_RESULT: process.env.SAVE_DRY_RUN_RESULT !== "false",
|
||||
OUTPUT_ONLY_RIOT_MATCHED: process.env.OUTPUT_ONLY_RIOT_MATCHED !== "false",
|
||||
@@ -163,10 +163,10 @@ function maskConfigForStorage() {
|
||||
function isRiotMatchedCandidate(candidate) {
|
||||
return Boolean(
|
||||
candidate.matchedRiotAccount &&
|
||||
candidate.ambiguousRiotAccounts?.length === 0 &&
|
||||
candidate.riotApiResult &&
|
||||
!candidate.riotApiError &&
|
||||
!candidate.riotEnrichmentError,
|
||||
candidate.ambiguousRiotAccounts?.length === 0 &&
|
||||
candidate.riotApiResult &&
|
||||
!candidate.riotApiError &&
|
||||
!candidate.riotEnrichmentError,
|
||||
);
|
||||
}
|
||||
|
||||
@@ -214,7 +214,10 @@ function remember(map, kakaoTalkId, patch) {
|
||||
const nickname =
|
||||
normalizeString(patch.kakaoTalkNickname) ||
|
||||
normalizeString(current.kakaoTalkNickname);
|
||||
const sources = new Set([...(current.sources ?? []), ...(patch.sources ?? [])]);
|
||||
const sources = new Set([
|
||||
...(current.sources ?? []),
|
||||
...(patch.sources ?? []),
|
||||
]);
|
||||
const lastSeenCandidates = [current.lastSeenAt, patch.lastSeenAt]
|
||||
.filter(Boolean)
|
||||
.map((value) => new Date(value));
|
||||
@@ -229,7 +232,9 @@ function remember(map, kakaoTalkId, patch) {
|
||||
sources: [...sources],
|
||||
lastSeenAt:
|
||||
lastSeenCandidates.length > 0
|
||||
? new Date(Math.max(...lastSeenCandidates.map((date) => date.getTime())))
|
||||
? new Date(
|
||||
Math.max(...lastSeenCandidates.map((date) => date.getTime())),
|
||||
)
|
||||
: null,
|
||||
recentMessageCount:
|
||||
(current.recentMessageCount ?? 0) + (patch.recentMessageCount ?? 0),
|
||||
@@ -361,7 +366,12 @@ function pickRiotAccountForCandidate(candidate, index) {
|
||||
|
||||
const nicknameBase = candidate.nicknameBase;
|
||||
if (!nicknameBase) {
|
||||
return { source: "no-nickname-base", account: null, override, ambiguous: [] };
|
||||
return {
|
||||
source: "no-nickname-base",
|
||||
account: null,
|
||||
override,
|
||||
ambiguous: [],
|
||||
};
|
||||
}
|
||||
|
||||
const exactMatches = index.exact.get(normalizeJoinKey(nicknameBase)) ?? [];
|
||||
@@ -422,7 +432,9 @@ async function fetchRiotJson({ host, path, query }) {
|
||||
});
|
||||
|
||||
if (response.status === 429) {
|
||||
const retryAfterSeconds = Number(response.headers.get("retry-after") ?? 1);
|
||||
const retryAfterSeconds = Number(
|
||||
response.headers.get("retry-after") ?? 1,
|
||||
);
|
||||
await sleep(Math.max(1, retryAfterSeconds) * 1000);
|
||||
continue;
|
||||
}
|
||||
@@ -431,7 +443,9 @@ async function fetchRiotJson({ host, path, query }) {
|
||||
|
||||
if (!response.ok) {
|
||||
const body = await response.text().catch(() => "");
|
||||
throw new Error(`Riot API failed ${response.status} ${url.pathname}: ${body}`);
|
||||
throw new Error(
|
||||
`Riot API failed ${response.status} ${url.pathname}: ${body}`,
|
||||
);
|
||||
}
|
||||
|
||||
return response.json();
|
||||
@@ -670,11 +684,14 @@ async function enrichCandidatesWithRiot({ candidates, riotAccountIndex }) {
|
||||
riotApiError,
|
||||
riotEnrichment,
|
||||
riotEnrichmentError,
|
||||
preferredPositions: normalizePositions(match.override?.preferredPositions),
|
||||
preferredPositions: normalizePositions(
|
||||
match.override?.preferredPositions,
|
||||
),
|
||||
role: match.override?.role ?? "member",
|
||||
isActivated: match.override?.isActivated ?? true,
|
||||
targetKakaoTalkNickname:
|
||||
normalizeString(match.override?.nickname) || candidate.kakaoTalkNickname,
|
||||
normalizeString(match.override?.nickname) ||
|
||||
candidate.kakaoTalkNickname,
|
||||
});
|
||||
}
|
||||
|
||||
@@ -798,7 +815,7 @@ async function upsertUsers({ lolympusDb, candidates }) {
|
||||
preferredPositions:
|
||||
candidate.preferredPositions?.length > 0
|
||||
? candidate.preferredPositions
|
||||
: existing?.preferredPositions ?? [],
|
||||
: (existing?.preferredPositions ?? []),
|
||||
isActivated: candidate.isActivated ?? true,
|
||||
updatedAt: now,
|
||||
};
|
||||
|
||||
@@ -1,59 +1,213 @@
|
||||
import { spawnSync } from 'node:child_process';
|
||||
import { existsSync, readFileSync } from 'node:fs';
|
||||
import { dirname, resolve } from 'node:path';
|
||||
import { fileURLToPath } from 'node:url';
|
||||
import { spawnSync } from "node:child_process";
|
||||
import { existsSync, readFileSync } from "node:fs";
|
||||
import { dirname, resolve } from "node:path";
|
||||
import { fileURLToPath } from "node:url";
|
||||
|
||||
const __dirname = dirname(fileURLToPath(import.meta.url));
|
||||
const repoRoot = resolve(__dirname, '..');
|
||||
const webDir = resolve(repoRoot, 'apps/web');
|
||||
const scriptPath = fileURLToPath(import.meta.url);
|
||||
const __dirname = dirname(scriptPath);
|
||||
const repoRoot = resolve(__dirname, "..");
|
||||
const webDir = resolve(repoRoot, "apps/web");
|
||||
|
||||
const target = process.argv[2];
|
||||
if (target !== 'test' && target !== 'prod') {
|
||||
console.error('Usage: node scripts/deploy-cloudflare-pages.mjs <test|prod>');
|
||||
if (process.argv[1] === scriptPath) {
|
||||
main(process.argv.slice(2));
|
||||
}
|
||||
|
||||
export function main(args = process.argv.slice(2), env = process.env) {
|
||||
const target = args[0];
|
||||
if (target !== "staging" && target !== "prod") {
|
||||
console.error(
|
||||
"Usage: node scripts/deploy-cloudflare-pages.mjs <staging|prod>",
|
||||
);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const viteMode = target === "prod" ? "production" : "staging";
|
||||
const projectName =
|
||||
env.CF_PAGES_PROJECT_NAME ??
|
||||
env.CLOUDFLARE_PAGES_PROJECT_NAME ??
|
||||
"lolympus";
|
||||
const deployPlan = resolveDeployPlan(target, env);
|
||||
|
||||
validateEnv(viteMode, env);
|
||||
run("pnpm", ["--filter", "web", "run", `build:${target}`], repoRoot);
|
||||
|
||||
const deployArgs = createPagesDeployArgs(projectName, deployPlan.pagesBranch);
|
||||
console.error(
|
||||
[
|
||||
`Deploying ${target} from ${deployPlan.sourceBranch}`,
|
||||
`to Cloudflare Pages branch ${deployPlan.pagesBranch}`,
|
||||
].join(" "),
|
||||
);
|
||||
|
||||
run("pnpm", deployArgs, webDir);
|
||||
}
|
||||
|
||||
export function createPagesDeployArgs(projectName, branch) {
|
||||
const deployArgs = [
|
||||
"exec",
|
||||
"wrangler",
|
||||
"pages",
|
||||
"deploy",
|
||||
"dist",
|
||||
"--project-name",
|
||||
projectName,
|
||||
];
|
||||
|
||||
if (branch) deployArgs.push("--branch", branch);
|
||||
return deployArgs;
|
||||
}
|
||||
|
||||
export function resolveStagingBranch(env = process.env) {
|
||||
return resolveDeployPlan("staging", env).pagesBranch;
|
||||
}
|
||||
|
||||
export function resolveDeployPlan(
|
||||
target,
|
||||
env = process.env,
|
||||
releaseBranchRowsProvider = () => {
|
||||
refreshRemoteReleaseBranches();
|
||||
return listReleaseBranchRefs();
|
||||
},
|
||||
) {
|
||||
const sourceBranch = resolveSourceBranch(
|
||||
target,
|
||||
env,
|
||||
releaseBranchRowsProvider,
|
||||
);
|
||||
const pagesBranch =
|
||||
target === "prod" ? resolveProductionBranch(env) : sourceBranch;
|
||||
|
||||
return { sourceBranch, pagesBranch };
|
||||
}
|
||||
|
||||
function resolveSourceBranch(target, env, releaseBranchRowsProvider) {
|
||||
const sourceEnvKey =
|
||||
target === "prod" ? "CF_PAGES_RELEASE_BRANCH" : "CF_PAGES_STAGING_BRANCH";
|
||||
const configuredBranch = env[sourceEnvKey]?.trim();
|
||||
if (configuredBranch) return configuredBranch;
|
||||
|
||||
const latestReleaseBranch = selectLatestReleaseBranch(
|
||||
releaseBranchRowsProvider(),
|
||||
);
|
||||
if (latestReleaseBranch) return latestReleaseBranch;
|
||||
|
||||
console.error(
|
||||
[
|
||||
`No release/* branch found for ${target} deploy.`,
|
||||
"Create a release branch, for example: git push origin main:release/66",
|
||||
`Or set ${sourceEnvKey} explicitly.`,
|
||||
].join("\n"),
|
||||
);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
const viteMode = target === 'prod' ? 'production' : 'test';
|
||||
const projectName =
|
||||
process.env.CF_PAGES_PROJECT_NAME ??
|
||||
process.env.CLOUDFLARE_PAGES_PROJECT_NAME ??
|
||||
'lolympus';
|
||||
const testBranch = process.env.CF_PAGES_TEST_BRANCH ?? 'test';
|
||||
|
||||
validateEnv(viteMode);
|
||||
run('pnpm', ['--filter', 'web', 'run', `build:${target}`], repoRoot);
|
||||
|
||||
const deployArgs = [
|
||||
'exec',
|
||||
'wrangler',
|
||||
'pages',
|
||||
'deploy',
|
||||
'dist',
|
||||
'--project-name',
|
||||
projectName,
|
||||
];
|
||||
|
||||
if (target === 'test') {
|
||||
deployArgs.push('--branch', testBranch);
|
||||
function resolveProductionBranch(env) {
|
||||
return (
|
||||
env.CF_PAGES_PRODUCTION_BRANCH?.trim() ||
|
||||
env.CF_PAGES_PROD_BRANCH?.trim() ||
|
||||
"main"
|
||||
);
|
||||
}
|
||||
|
||||
run('pnpm', deployArgs, webDir);
|
||||
export function selectLatestReleaseBranch(refRows) {
|
||||
const latestByBranch = new Map();
|
||||
|
||||
for (const row of refRows) {
|
||||
const [timestampText, refName] = row.split("\t");
|
||||
const branch = normalizeReleaseBranch(refName);
|
||||
const timestamp = Number(timestampText);
|
||||
if (!branch || !Number.isFinite(timestamp)) continue;
|
||||
|
||||
const current = latestByBranch.get(branch);
|
||||
if (!current || timestamp > current.timestamp) {
|
||||
latestByBranch.set(branch, { branch, timestamp });
|
||||
}
|
||||
}
|
||||
|
||||
const [latest] = [...latestByBranch.values()].sort((left, right) => {
|
||||
if (left.timestamp !== right.timestamp) {
|
||||
return right.timestamp - left.timestamp;
|
||||
}
|
||||
return right.branch.localeCompare(left.branch, "en", { numeric: true });
|
||||
});
|
||||
|
||||
return latest?.branch;
|
||||
}
|
||||
|
||||
export function normalizeReleaseBranch(refName) {
|
||||
const branch = refName?.trim();
|
||||
if (!branch) return undefined;
|
||||
if (branch.startsWith("origin/release/")) {
|
||||
return branch.slice("origin/".length);
|
||||
}
|
||||
if (branch.startsWith("release/")) return branch;
|
||||
return undefined;
|
||||
}
|
||||
|
||||
function listReleaseBranchRefs() {
|
||||
const result = spawnSync(
|
||||
"git",
|
||||
[
|
||||
"for-each-ref",
|
||||
"--sort=-committerdate",
|
||||
"--format=%(committerdate:unix)%09%(refname:short)",
|
||||
"refs/remotes/origin/release",
|
||||
"refs/heads/release",
|
||||
],
|
||||
{
|
||||
cwd: repoRoot,
|
||||
encoding: "utf8",
|
||||
shell: process.platform === "win32",
|
||||
},
|
||||
);
|
||||
|
||||
if (result.status !== 0) {
|
||||
const stderr = result.stderr?.trim();
|
||||
if (stderr) console.error(stderr);
|
||||
return [];
|
||||
}
|
||||
|
||||
return result.stdout.split(/\r?\n/).filter(Boolean);
|
||||
}
|
||||
|
||||
function refreshRemoteReleaseBranches() {
|
||||
spawnSync("git", ["remote", "prune", "origin"], {
|
||||
cwd: repoRoot,
|
||||
stdio: "ignore",
|
||||
shell: process.platform === "win32",
|
||||
});
|
||||
|
||||
spawnSync(
|
||||
"git",
|
||||
[
|
||||
"fetch",
|
||||
"--prune",
|
||||
"origin",
|
||||
"+refs/heads/release/*:refs/remotes/origin/release/*",
|
||||
],
|
||||
{
|
||||
cwd: repoRoot,
|
||||
stdio: "ignore",
|
||||
shell: process.platform === "win32",
|
||||
},
|
||||
);
|
||||
}
|
||||
|
||||
function run(command, args, cwd) {
|
||||
const result = spawnSync(command, args, {
|
||||
cwd,
|
||||
stdio: 'inherit',
|
||||
shell: process.platform === 'win32',
|
||||
stdio: "inherit",
|
||||
shell: process.platform === "win32",
|
||||
});
|
||||
if (result.status !== 0) {
|
||||
process.exit(result.status ?? 1);
|
||||
}
|
||||
}
|
||||
|
||||
function validateEnv(mode) {
|
||||
function validateEnv(mode, env) {
|
||||
const fileEnv = [
|
||||
'.env',
|
||||
'.env.local',
|
||||
".env",
|
||||
".env.local",
|
||||
`.env.${mode}`,
|
||||
`.env.${mode}.local`,
|
||||
].reduce((acc, fileName) => {
|
||||
@@ -62,39 +216,39 @@ function validateEnv(mode) {
|
||||
return { ...acc, ...parseEnvFile(envFile) };
|
||||
}, {});
|
||||
const requiredKeys = [
|
||||
'VITE_API_BASE_URL',
|
||||
'VITE_DEFAULT_COMMUNITY_ID',
|
||||
'VITE_MSAL_CLIENT_ID',
|
||||
'VITE_MSAL_AUTHORITY',
|
||||
'VITE_MSAL_API_SCOPE',
|
||||
'VITE_MSAL_REDIRECT_URI',
|
||||
"VITE_API_BASE_URL",
|
||||
"VITE_DEFAULT_COMMUNITY_ID",
|
||||
"VITE_MSAL_CLIENT_ID",
|
||||
"VITE_MSAL_AUTHORITY",
|
||||
"VITE_MSAL_API_SCOPE",
|
||||
"VITE_MSAL_REDIRECT_URI",
|
||||
];
|
||||
const missing = requiredKeys.filter((key) => {
|
||||
const value = process.env[key] ?? fileEnv[key];
|
||||
return !value || value.includes('<');
|
||||
const value = env[key] ?? fileEnv[key];
|
||||
return !value || value.includes("<");
|
||||
});
|
||||
|
||||
if (missing.length === 0) return;
|
||||
|
||||
console.error(
|
||||
[
|
||||
`Missing Cloudflare Pages ${mode} build env: ${missing.join(', ')}`,
|
||||
`Missing Cloudflare Pages ${mode} build env: ${missing.join(", ")}`,
|
||||
`Create apps/web/.env.${mode}, apps/web/.env.${mode}.local, or export these variables before deploy.`,
|
||||
`Use apps/web/.env.${mode}.example as a template.`,
|
||||
].join('\n'),
|
||||
].join("\n"),
|
||||
);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
function parseEnvFile(path) {
|
||||
return Object.fromEntries(
|
||||
readFileSync(path, 'utf8')
|
||||
readFileSync(path, "utf8")
|
||||
.split(/\r?\n/)
|
||||
.map((line) => line.trim())
|
||||
.filter((line) => line && !line.startsWith('#'))
|
||||
.filter((line) => line && !line.startsWith("#"))
|
||||
.map((line) => {
|
||||
const separatorIndex = line.indexOf('=');
|
||||
if (separatorIndex === -1) return [line, ''];
|
||||
const separatorIndex = line.indexOf("=");
|
||||
if (separatorIndex === -1) return [line, ""];
|
||||
const key = line.slice(0, separatorIndex).trim();
|
||||
let value = line.slice(separatorIndex + 1).trim();
|
||||
if (
|
||||
|
||||
Loaded 100 of 136 files, more files were not shown because too many files have changed in this diff.
Show more
Reference in new issue
Block a user