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와 실행 환경의 시크릿 설정을 함께 확인합니다.
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 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)

