🍁 단풍칼바람 대회 관리 프로그램

단풍바람 운영진용 대회 기록 / 추첨 CLI 프로그램입니다.

참가자 등록 → 랜덤 팀 배정 → 경기 결과 입력 → 점수 집계 → 우승자 확인 / 추첨까지 터미널 하나에서 처리합니다.

---

요구사항

• Python 3.10 이상
• uv

---

설치 및 실행

# 저장소 클론
git clone https://github.com/ark1st/aram_matchmaker.git
cd aram_matchmaker

# 의존성 설치
uv sync

# 실행
uv run python main.py

---

커맨드

커맨드	설명
uv run python main.py	대화형 메인 루프 실행
uv run python main.py results	현재 순위 바로 출력
uv run python main.py lottery	추첨 화면 바로 열기
uv run python main.py more	한판더 (추가 경기 1판)
uv run python main.py reset	저장 데이터 초기화
uv run python main.py --help	도움말

---

주요 기능

참가자 등록

• 이름 / 닉네임 직접 입력
• participants.yaml 파일에서 한번에 불러오기 지원
• 닉네임 중복 경고

경기 진행

• 최대 5경기 (한판더로 추가 가능)
• 랜덤 팀 자동 배정
• 팀 재배정 / 팀원 수동 교체 가능
• 이전 경기 결과 수정 → 점수 자동 재계산

점수 집계 및 순위

• 승리팀 전원 1점
• 5경기 종료 후 최종 순위 자동 집계
• 공동 1등 표시

한판더

• 대회 완료 후 [H] 한판더 선택으로 경기 추가
• 순위표에 자동 반영

추첨

• 공동 1등 추첨
• 전체 참가자 추첨
• 특정 승수 이상 추첨
• 복수 당첨 지원

저장

• tournament_save.json에 자동 저장
• 재실행 시 이어서 진행 가능

---

participants.yaml

참가자를 미리 등록해두는 파일입니다. 이름/닉네임 형식으로 작성합니다.

participants:
  - name: 가람/가람
  - name: 단팽이/단팽이
  - name: 주황버섯/주황버섯

닉네임을 생략하면 이름과 동일하게 처리됩니다.

---

의존성

패키지	용도
rich	터미널 UI
typer	CLI 프레임워크
pyyaml	YAML 파일 파싱