Files
hackerthon-vote/README.md
th-kim0823 bf4d3e73cc feat: roster.json 단일 명단 파일 + 핫리로드
호스트에서 직접 편집 가능한 단일 JSON으로 명단 일원화.
앱이 매 요청마다 디스크에서 reload → 컨테이너 재시작 불필요.

변경:
- roster.json 새 형식: {"people": [{"name", "team", "dept", "senior", "notes"}, ...]}
- assign_teams.py: roster.json + legacy participants.json 둘 다 출력
- app.py: get_participants() / get_teams() 매 호출 reload
  - PARTS = get_participants() / TEAMS = get_teams() 함수 안에서 호출
  - 모듈 레벨 PARTICIPANTS/TEAMS 제거
  - load_roster() roster.json 우선, 없으면 legacy fallback
- docker-compose: roster.json + participants.json 둘 다 mount
- Dockerfile: ROSTER env + roster.json COPY

사용자 워크플로:
- 사람 다른 팀 옮기기: roster.json에서 그 사람 'team' 값만 변경
- 자동 배정 재실행: python3 assign_teams.py

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-26 17:43:16 +09:00

2.8 KiB

해커톤 투표

35명 / 7팀 / 3분야 (재미·완성도·실용성) 투표 앱. 본인 팀 제외 투표.

흐름

  1. assign_teams.py 실행 → participants.json 생성 (이름→팀 매핑)
  2. app.py 실행 → 참가자가 본인 이름 선택 → 자동 본인 팀 매핑 → 다른 6팀에 3분야 투표
  3. 어드민 페이지에서 분야별 1위와 2위 차이만 공개 (하위 표수는 expander 내부)

실행 — Docker (권장)

# 1. 팀 배정 (호스트에서 1회, participants.json 생성)
python3 assign_teams.py

# 2. .env 작성 (1회)
cp .env.example .env
# .env 파일을 열어 ADMIN_TOKEN을 강한 랜덤 토큰으로 변경
# 빠르게: python3 -c "import secrets; print(secrets.token_urlsafe(16))"

# 3. 컨테이너 실행
docker compose up -d --build

# 로그
docker compose logs -f

# 종료
docker compose down

# DB 영속 데이터까지 삭제
docker compose down -v

.env는 git ignore. token 노출 방지.

  • 투표 DB는 docker volume vote-data에 영속 → 컨테이너 재시작해도 유지
  • participants.json은 호스트→컨테이너 read-only mount → 재배정 시 호스트에서 변경하고 컨테이너만 재시작

실행 — 로컬 (Docker 없이)

pip install -r requirements.txt
python3 assign_teams.py
export ADMIN_TOKEN="강한-토큰-아무거나"
streamlit run app.py --server.address 0.0.0.0 --server.port 8501

URL

  • 참가자: http://<홈서버-IP>:8501/
  • 진행자: http://<홈서버-IP>:8501/?mode=admin&token=<ADMIN_TOKEN>

흐름

  1. 참가자 — 이름 입력 → 본인 팀 선택 → 본인 팀 빼고 3분야 라디오 → 제출
  2. 중복 방지 — 같은 이름은 한 번만 투표 가능 (UNIQUE 제약)
  3. 진행자 — 어드민 페이지에서 분야별 집계 확인
  4. 시상식 — 어드민 페이지 하단 "시상식 발표용" 박스 복사 (1위와 2위 차이만 표시, 하위 팀 표수 비공개)

데이터

  • roster.json단일 명단 파일 (assign_teams.py 산출물). 호스트에서 직접 편집 가능, 앱이 매 요청 reload.
    {
      "people": [
        {"name": "홍길동", "team": "팀1", "dept": "MLOps Data", "senior": true, "notes": ""},
        ...
      ]
    }
    
    • 사람을 다른 팀으로 옮기기: team 값만 변경
    • 사람 추가/제거: 객체 추가/삭제
    • 변경 후 컨테이너 재시작 불필요 (핫리로드)
  • participants.json — legacy 형식 (이름→팀 string). roster.json 없으면 fallback.
  • votes.db (sqlite, WAL) — votes, team_titles, tie_breaks, settings 테이블

운영 팁

  • 행사 끝나면 votes.db 백업 후 보관 또는 삭제
  • 부정 투표 의심 시 어드민 → 위험 작업 → 전체 삭제 후 재투표 진행 가능
  • ADMIN_TOKEN은 change-me 기본값 — 반드시 변경