feat: 해커톤 투표 앱 초기 구현

- 35명/7팀/3분야(재미·완성도·실용성) 투표
- 본인 팀 제외 자동 처리
- 이름 UNIQUE 중복 방지
- 진행자 어드민 페이지: 1위와 2위 차이만 공개, 하위 팀 표수는 비공개
- sqlite 단일 파일 저장

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
th-kim0823
2026-04-25 18:55:21 +09:00
commit 5fe8842e88
4 changed files with 218 additions and 0 deletions

40
README.md Normal file
View File

@@ -0,0 +1,40 @@
# 해커톤 투표
35명 / 7팀 / 3분야 (재미·완성도·실용성) 투표 앱. 본인 팀 제외 투표.
## 실행
```bash
# 1. 의존성 설치
pip install -r requirements.txt
# 2. 환경변수 (선택)
export TEAMS="팀1,팀2,팀3,팀4,팀5,팀6,팀7" # 콤마 구분
export ADMIN_TOKEN="강한-토큰-아무거나"
export VOTE_DB="votes.db" # sqlite 파일 경로
# 3. 실행 (홈서버, 외부 접속 허용)
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위 차이만 표시, 하위 팀 표수 비공개)
## 데이터
`votes.db` (sqlite). 테이블: `votes(id, voter_name UNIQUE, voter_team, fun_team, polish_team, utility_team, created_at)`.
## 운영 팁
- 행사 끝나면 `votes.db` 백업 후 보관 또는 삭제
- 부정 투표 의심 시 어드민 → 위험 작업 → 전체 삭제 후 재투표 진행 가능
- ADMIN_TOKEN은 `change-me` 기본값 — 반드시 변경