Add seed collection admin endpoint

This commit is contained in:
dahyeon committed 2026-07-03 03:27:52 -07:00
1 parent ce00bc84b5
commit 56f10f7c29
3 files changed
+198 -1

No files matched your search

+13
View File
@@ -70,6 +70,7 @@ web (Riot ID 입력)
- `RIOT_API_KEY` — Riot 개발자 포털 development key
- `MONGODB_CONNECTION_STRING` — Atlas 클러스터 SRV 연결 문자열
- `REDIS_URL` (또는 기존 `REDIS_ENDPOINT`/`REDIS_PASSWORD / REDIS_USERID` 조합 — `RedisModule`이 둘 다 지원)
- `ADMIN_API_TOKEN` — 운영용 백그라운드 잡 enqueue endpoint 보호용 bearer token
- `MONGODB_AUTO_INDEX=true` (dev만 — 스키마 선언 인덱스 자동 생성. prod는 인덱스 수동 생성)
로컬 인프라: MongoDB는 Atlas를 그대로 사용하므로 로컬 컨테이너 불필요. Redis가 로컬에 없으면 `compose.dev.yaml`(redis 단일 서비스)을 추가해 사용한다.
@@ -771,6 +772,18 @@ DB 스키마가 이 단계를 미리 견디도록 상세화한 스펙이다. 구
- `account`에 `isSeed: true`, `seedSource`(challenger/grandmaster/master), `seedAddedAt`, `lastSeedCollectedAt` 기록
- 별도 저우선순위 BullMQ 큐 `seed-collection`(concurrency 1)로 수집. 유저 분석 잡(`analysis`)이 항상 우선하도록 rate limiter를 공유
- seed 유저도 **동일한 파이프라인**(stage 3~5)으로 `player_match_feature`/`player_profile` 생성 — 별도 코드 경로를 만들지 않는다
- 운영 트리거: `POST /api/admin/seed-collection/request` with `Authorization: Bearer <ADMIN_API_TOKEN>`. body 예시:
```json
{
"platform": "kr",
"sourceLimits": {
"challenger": 0,
"grandmaster": 50,
"master": 0
}
}
```
`sourceLimits`를 생략하면 challenger/grandmaster/master 각각 기본 50명, 특정 source를 끄려면 명시적으로 `0`을 보낸다.
- **스토리지 예산 주의**: timeline 원본은 경기당 약 2MB(실측 2.3MB)라 seed 수집(중복 제거 후 수천 경기)이면 수 GB로 Atlas M0(512MB)를 초과한다. MVP 1~2(개인 계정 수십 경기)는 M0로 충분하지만, **MVP 3 착수 전에 ① 클러스터 상향 또는 ② feature 추출 완료 후 `riot_match.timeline` 원본 삭제(derived만 보존) 정책을 결정**해야 한다. ②를 대비해 재계산 잡은 timeline 부재를 결측으로 처리하도록 이미 설계되어 있다(§11.9)
### 12.2 Percentile 정규화 도입 (§5.3 TODO 해소)