th-kim0823 3453217e62 refactor: 부서별 ceil-aware 균등 분배 알고리즘
기존 round-robin은 운에 따라 부서 분포 max-min=2 발생 (예: HPC 2,1,0,1,1,2,1).
ceil 슬롯을 ceil_count 적은 팀에 우선 배정하여 모든 부서 max-min ≤ 1 보장.

결과:
- EffTech [1,2,2,2,2,2,1]
- System  [2,1,1,1,1,1,1]
- HPC     [1,1,1,1,1,1,2]
- Data    [1,1,1,1,0,1,1]
- Platform [0,0,0,0,1,0,0] (1명)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-25 19:08:56 +09:00

해커톤 투표

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

흐름

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

실행

# 1. 의존성 설치
pip install -r requirements.txt

# 2. 팀 배정 (시드 고정 = 재현 가능)
python3 assign_teams.py
# → participants.json 저장됨

# 3. 환경변수 (선택)
export ADMIN_TOKEN="강한-토큰-아무거나"
export VOTE_DB="votes.db"
export PARTICIPANTS="participants.json"

# 4. 홈서버 실행 (외부 접속 허용)
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위 차이만 표시, 하위 팀 표수 비공개)

데이터

  • participants.json — 이름→팀 매핑 (assign_teams.py 산출물)
  • votes.db (sqlite) — 테이블: votes(id, voter_name UNIQUE, voter_team, fun_team, polish_team, utility_team, created_at)

운영 팁

  • 행사 끝나면 votes.db 백업 후 보관 또는 삭제
  • 부정 투표 의심 시 어드민 → 위험 작업 → 전체 삭제 후 재투표 진행 가능
  • ADMIN_TOKEN은 change-me 기본값 — 반드시 변경
Description
No description provided
Readme 134 KiB
Languages
Python 94.2%
Shell 5.2%
Dockerfile 0.6%