feat: Docker 패키징 (로컬 테스트 + 홈서버 배포)

- Dockerfile: python:3.12-slim 베이스, headless streamlit
- docker-compose.yml: ADMIN_TOKEN 환경변수, votes.db 영속 볼륨, participants.json read-only mount
- .dockerignore: 빌드 컨텍스트 최소화

테스트:
- docker compose build OK
- 컨테이너 실행 후 http://localhost:8501 200 OK 확인

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

.dockerignore

@@ -0,0 +1,14 @@
+.git
+.gitignore
+*.db
+*.sqlite
+*.pyc
+__pycache__/
+.venv/
+venv/
+.env
+README.md
+docker-compose.yml
+Dockerfile
+.dockerignore
+teams.md

Dockerfile

@@ -0,0 +1,20 @@
+FROM python:3.12-slim
+
+WORKDIR /app
+
+COPY requirements.txt ./
+RUN pip install --no-cache-dir -r requirements.txt
+
+COPY app.py assign_teams.py ./
+COPY participants.json ./
+
+EXPOSE 8501
+
+ENV VOTE_DB=/data/votes.db \
+    PARTICIPANTS=/app/participants.json
+
+CMD ["streamlit", "run", "app.py", \
+     "--server.address=0.0.0.0", \
+     "--server.port=8501", \
+     "--server.headless=true", \
+     "--browser.gatherUsageStats=false"]

README.md

@@ -8,22 +8,35 @@
 2. `app.py` 실행 → 참가자가 본인 이름 선택 → 자동 본인 팀 매핑 → 다른 6팀에 3분야 투표
 3. 어드민 페이지에서 분야별 1위와 2위 차이만 공개 (하위 표수는 expander 내부)
 
-## 실행
+## 실행 — Docker (권장)
 
 ```bash
-# 1. 의존성 설치
+# 1. 팀 배정 (호스트에서 1회, participants.json 생성)
-pip install -r requirements.txt
-
-# 2. 팀 배정 (시드 고정 = 재현 가능)
 python3 assign_teams.py
-# → participants.json 저장됨
 
-# 3. 환경변수 (선택)
+# 2. 컨테이너 실행
 export ADMIN_TOKEN="강한-토큰-아무거나"
-export VOTE_DB="votes.db"
+docker compose up -d --build
-export PARTICIPANTS="participants.json"
 
-# 4. 홈서버 실행 (외부 접속 허용)
+# 로그
+docker compose logs -f
+
+# 종료
+docker compose down
+
+# DB 영속 데이터까지 삭제
+docker compose down -v
+```
+
+- 투표 DB는 docker volume `vote-data`에 영속 → 컨테이너 재시작해도 유지
+- `participants.json`은 호스트→컨테이너 read-only mount → 재배정 시 호스트에서 변경하고 컨테이너만 재시작
+
+## 실행 — 로컬 (Docker 없이)
+
+```bash
+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
 ```
 

docker-compose.yml

@@ -0,0 +1,20 @@
+services:
+  vote:
+    build: .
+    image: hackathon-vote:latest
+    container_name: hackathon-vote
+    ports:
+      - "${PORT:-8501}:8501"
+    environment:
+      ADMIN_TOKEN: ${ADMIN_TOKEN:-change-me}
+      VOTE_DB: /data/votes.db
+      PARTICIPANTS: /app/participants.json
+    volumes:
+      # 호스트의 participants.json 변경 즉시 반영 (재배정 시)
+      - ./participants.json:/app/participants.json:ro
+      # 투표 DB는 호스트에 영속 (컨테이너 재시작해도 유지)
+      - vote-data:/data
+    restart: unless-stopped
+
+volumes:
+  vote-data: