Preserve tournament result jobs through lock contention and transient failures, atomically schedule retries before acknowledgement, and publish initial polls after releasing the preparation lock. Fix Redis connection blocking, durability Hash cleanup, duplicate auction request ordering, and scheduled-job promotion. Use native Redis 8.10 stream, lock, counter, and field-expiring cache operations with invalidation fencing. Repair 90 test type errors and add a repeatable API typecheck command. Validation: 704 API tests, 129 web tests, 31 real Redis integration tests, 3 dependency checks, workspace type checks and builds, and changed-file lint.
LOLYMPUS
LOLYMPUS는 리그 오브 레전드 커뮤니티의 여러 이벤트 중 내전(사용자 설정 게임)을 운영할 때 필요한 일정 관리, 참여자 모집, 팀 빌딩, 토너먼트 코드 배정, 경기 진행, 실시간 라이브 방송(추후 지원 예정), 결과 수집, 전적 확인을 한곳에서 처리하기 위한 웹 애플리케이션입니다.
배포 주소
| Environment | Version | URL |
|---|---|---|
| Production | v84 | https://lolympus.dahyeon.us/ |
| Staging | v84 | https://release-84.lolympus.pages.dev/ |
개요
내전 운영은 사람을 모으는 것에서 끝나지 않습니다. 참가자의 티어와 포지션을 확인하고, 팀장을 정하고, 팀을 나누고, 경기마다 토너먼트 코드를 전달하고, 끝난 뒤 결과와 전적까지 정리해야 합니다.
LOLYMPUS는 이 반복 작업을 줄이는 데 초점을 맞췄습니다. 운영자는 전체 진행 상황을 한눈에 보고, 참가자는 카카오톡 연동을 통해 쉽게 일정 확인/참가 신청하고 본인이 속한 팀과 다음 경기 정보를 빠르게 확인할 수 있습니다.
워크플로우
-
내전 개설과 모집
내전 일정, 진행 방식, 정원, 공지사항을 등록하고 참가 신청 현황을 확인합니다. -
참가자 정보 확인
Riot 계정 기반으로 소환사명, 태그, 프로필 아이콘, 솔로랭크/자유랭크 티어, 선호 포지션을 보여줍니다. -
팀 빌딩과 경매
팀장을 기준으로 팀을 구성하거나, 경매 방식으로 참가자를 배정합니다. 현재 입찰가, 팀별 포인트, 낙찰 기록을 함께 관리합니다. -
팀별 진행 페이지
각 팀은 예정 경기, 상대 팀, 라인업, 토너먼트 코드를 한 화면에서 확인하고 복사할 수 있습니다. -
더블 엘리미네이션 운영 4팀/8팀 더블 엘리미네이션 대진표를 생성하고, 시드 교체, 부전승, 제한적 결과 취소, 그랜드 파이널 리셋을 관리합니다.
-
결과 수집과 통계 Riot Match-V5 데이터를 이용해 경기 결과를 수집하고, 소환사별 전적과 커뮤니티 리더보드를 제공합니다.
스크린샷
상단의 경매 화면은 LOLYMPUS가 단순 참가자 목록을 넘어서 실제 팀빌딩 운영까지 다루는 대표 화면입니다. 3초 간격 데모 영상은 README 렌더러가 video 태그를 지원하면 자동/반복 재생되고, 세부 화면은 아래 PNG 원본을 기준으로 볼 수 있습니다.
| 경매 팀빌딩 |
|---|
![]() |
| 내전 목록 | 모집 상세 |
|---|---|
![]() |
![]() |
| 단판 경기 결과 | 개인 전적 |
|---|---|
![]() |
![]() |
| 경기 상세 |
|---|
![]() |
기능
- 내전 생성, 수정, 모집 상태 변경, 참가자 목록 확인
- 카카오톡 명령어를 통한 일정 조회, 내전 참가, 취소, 계정 등록 등 기능 제공
- Riot 계정 기반 참가자 프로필, 티어, 포지션 확인
- 팀장 지정, 포지션 기반 팀 구성, 다팀 내전 지원
- 팀장 경매 방식의 참가자 낙찰과 입찰 기록 관리
- 4팀/8팀 더블 엘리미네이션 대진표, 시드 관리, 부전승, 제한적 취소, 그랜드 파이널 리셋 지원
- 경기별 토너먼트 코드 배정과 팀별 복사 UI
- 팀별 경기 일정, 상대 팀, 라인업, 결과 확인
- Riot Match-V5 기반 결과 수집, 개인 전적, 리더보드 제공
- Dakao/NATS 기반 커뮤니티 명령 연동
기술 스택
- React
- Vite
- TypeScript
- TanStack Query
- NestJS
- MongoDB 8.3
- Redis 8.10 (일반 캐시/스트림과 경매 실시간 상태 공유)
- NATS
- Riot API
- pnpm workspace
- Kubernetes
- ArgoCD
디렉터리 구조
apps/
api/ NestJS API server
web/ React + Vite client
docs/
screenshots/ README and project screenshots
scripts/ deployment and maintenance scripts
사전 요구사항
- Node.js 24 이상
- pnpm 10.4.1 (
packageManager기준,corepack enable로 활성화 권장) - MongoDB 8.3, Redis 8.10, NATS 실행 환경
일반 캐시/스트림, 경매 실시간 상태, WebSocket Pub/Sub는 GARNET_ENDPOINT로 지정한 하나의 Redis 인스턴스를 공유합니다. 값은 host:port, redis://..., rediss://... 형식을 지원합니다. 인증이 필요하면 기존 GARNET_USERID(또는 GARNET_USERNAME)와 GARNET_PASSWORD를 설정합니다. REDIS_*, AUCTION_REDIS_*, GARNET_URL 연결 설정은 사용하지 않습니다. 경매 점검 스크립트도 같은 설정을 사용합니다.
실행 방법
pnpm install
pnpm start:api:dev
pnpm start:web:dev
웹 앱은 기본적으로 apps/web/.env.development 값을 사용합니다. API 환경값은 apps/project.env와 실행 환경의 시크릿 설정을 함께 확인합니다.
Redis 변경 검증
Redis 8.10.x의 XREADGROUP CLAIM, XACKDEL ACKED, DELEX, SET IFEQ, INCREX, HSETEX를 사용합니다. 스트림의 대기 읽기는 별도 연결에서 실행하며, 처리되지 않은 작업은 길이 제한을 초과해도 보존합니다.
pnpm --filter api test -- --runInBand
pnpm --filter api typecheck
pnpm --filter api test:redis
pnpm --filter api build
test:redis는 PATH의 redis-server 또는 REDIS_TEST_SERVER에 지정한 실행 파일로 Redis 8.10.x를 직접 실행합니다. 임의의 로컬 포트와 일회용 암호를 사용하고, 저장을 비활성화하며, 종료 후 프로세스와 임시 디렉터리를 정리합니다. 애플리케이션 Redis 연결 설정은 사용하지 않습니다. Windows에서는 PowerShell에서 $env:REDIS_TEST_SERVER = 'C:\tools\redis\redis-server.exe'처럼 지정할 수 있습니다.
커뮤니티 통계 캐시는 riot:communitystats:v2:{communityId}:scope Hash로 전환됩니다. 항목별 TTL은 일반 5분, 완성된 상세 24시간, 미완성 상세 60초를 유지합니다. 이전 String 캐시는 기존 TTL로 만료되며 새 캐시는 첫 조회에 생성됩니다. 구버전과 신버전은 무효화 대상이 다르므로 API 인스턴스를 같은 버전으로 함께 전환해야 합니다. 구현 범위와 검증 기록은 Redis 변경 계획을 참고하세요.
API New Relic APM
API 서버는 newrelic Node.js agent를 앱 코드보다 먼저 preload합니다. Docker 런타임과 pnpm start:api:* 스크립트 모두 NEW_RELIC_HOME을 API 패키지로 지정해 apps/api/newrelic.cjs 설정을 읽습니다.
Kubernetes에서는 Infisical이 NEW_RELIC_LICENSE_KEY를 프로세스 시작 전에 환경변수로 주입해야 합니다. 저장소에는 라이선스 키를 두지 않습니다.
비밀이 아닌 기본값은 Dockerfile과 apps/api/newrelic.cjs에 정의되어 있으며 필요하면 런타임 환경변수로 덮어쓸 수 있습니다.
NEW_RELIC_APP_NAME=lolympus
NEW_RELIC_AI_MONITORING_ENABLED=true
NEW_RELIC_CUSTOM_INSIGHTS_EVENTS_MAX_SAMPLES_STORED=100000
NEW_RELIC_SPAN_EVENTS_MAX_SAMPLES_STORED=10000
New Relic Node agent의 정수 환경변수는 100k 같은 축약형 대신 100000처럼 숫자 문자열을 사용합니다.
API 성능 리포트 운영
API 성능 계측은 기본 비활성화이며 필요할 때 API_PERF_OBSERVABILITY_ENABLED=true로 켭니다. 전체 API route 목록은 pnpm --filter api perf:routes, 성능 리포트는 pnpm --filter api perf:report로 생성합니다. New Relic Transaction 실측 duration, New Relic custom event, local NDJSON 파일을 데이터 소스로 사용할 수 있습니다.
운영 절차와 해석 기준은 docs/operations/api-performance-runbook.md를 참고합니다.
카카오톡 기반 명령어 기능은 Dakao(커스텀 카카오톡 게이트웨이) 연동이 필요합니다. Dakao가 실행 중이 아니거나 NATS를 통해 API 서버와 연결되어 있지 않으면 일정 조회, 내전 참가, 참가 취소, 계정 등록 같은 카카오톡 명령어는 사용할 수 없습니다.
커맨드
| Command | Description |
|---|---|
pnpm start:web:dev |
웹 앱 개발 서버 실행 |
pnpm start:api:dev |
API 서버 dev 환경 실행 |
pnpm --filter api test |
API 테스트 실행 |
pnpm --filter api typecheck |
테스트를 포함한 API 타입 검사 |
pnpm --filter api test:redis |
격리된 Redis 8.10 통합 테스트 실행 |
pnpm --filter api perf:routes |
API 성능 리포트 대상 route 출력 |
pnpm --filter api perf:report |
API 성능 리포트 생성 |
pnpm --filter web build:staging |
웹 staging 빌드 검증 |
pnpm deploy:web:staging |
Cloudflare Pages staging 배포 |
pnpm deploy:web:prod |
Cloudflare Pages production 배포 |
라이선스
This project is licensed under the GNU Library General Public License v2.0. See LICENSE for details.



.png)

