e661372f84
- assign_teams.py: 부서 다양성 제약(같은 부서 ≤2명) 시드 고정 배정 - participants.json: 이름→팀 매핑 산출물 - app.py: 이름 선택 → 본인 팀 자동 표시 (수동 입력 부정 차단) - 어드민 참여율 메트릭 + 미투표자 목록 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
52 lines
1.8 KiB
Markdown
52 lines
1.8 KiB
Markdown
# 해커톤 투표
|
|
|
|
35명 / 7팀 / 3분야 (재미·완성도·실용성) 투표 앱. 본인 팀 제외 투표.
|
|
|
|
## 흐름
|
|
|
|
1. `assign_teams.py` 실행 → `participants.json` 생성 (이름→팀 매핑)
|
|
2. `app.py` 실행 → 참가자가 본인 이름 선택 → 자동 본인 팀 매핑 → 다른 6팀에 3분야 투표
|
|
3. 어드민 페이지에서 분야별 1위와 2위 차이만 공개 (하위 표수는 expander 내부)
|
|
|
|
## 실행
|
|
|
|
```bash
|
|
# 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` 기본값 — 반드시 변경
|