docs: README, CLAUDE.md 작성

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -0,0 +1,62 @@
+# CLAUDE.md
+
+## Commands
+
+```bash
+go run .                          # 로컬 실행
+go build -o server .              # 빌드
+docker build -t a301-server .     # Docker 빌드
+```
+
+## Tech Stack
+
+- **Go** + **Fiber v2** (StreamRequestBody: true — 대용량 업로드용)
+- **GORM** + **MySQL** (AutoMigrate 사용)
+- **Redis** — JWT 블랙리스트
+- **JWT** — `golang-jwt/jwt v5`
+
+## Project Purpose
+
+"One of the plans" 게임 플랫폼 백엔드.
+인증 / 공지사항 / 게임 파일(game.zip + launcher.exe) 업로드·서빙 담당.
+
+## Project Structure
+
+```
+internal/
+├── auth/         # User 모델, JWT 발급·검증, 블랙리스트(Redis)
+├── announcement/ # Announcement CRUD
+└── download/     # Info 조회, 파일 업로드(스트리밍), 파일 서빙
+pkg/
+├── config/       # 환경변수 → Config 구조체
+├── database/     # ConnectMySQL(), ConnectRedis()
+└── middleware/   # Auth (JWT 검증), AdminOnly
+routes/routes.go  # 모든 라우트 등록
+```
+
+## Key Patterns
+
+- **계층 구조**: `Handler → Service → Repository`. 각 도메인 폴더에 4파일(handler, service, repository, model).
+- **파일 업로드**: `Fiber StreamRequestBody: true` + `io.Copy`로 raw body를 직접 디스크에 스트리밍. 메모리에 파일 올리지 않음.
+- **SHA256 자동 추출**: 게임 zip 업로드 시 zip 내 `A301.exe`를 스트리밍으로 읽어 해시 계산.
+- **CORS**: `AllowMethods`에 `PATCH` 포함 필수 (유저 권한 변경 엔드포인트).
+- **초기 admin 계정**: 서버 시작 시 `EnsureAdmin()`으로 존재 확인 후 없으면 생성.
+
+## Environment Variables
+
+필수 운영 설정:
+```
+BASE_URL=https://a301.api.tolelom.xyz
+GAME_DIR=/data/game
+JWT_SECRET=<강력한 랜덤값>
+ADMIN_USERNAME=admin
+ADMIN_PASSWORD=<강력한 비밀번호>
+```
+
+## File Storage
+
+게임 파일은 `GAME_DIR`(`/data/game`)에 저장:
+- `/data/game/game.zip` — 게임 본체
+- `/data/game/launcher.exe` — 런처
+
+Docker 볼륨 `game_data:/data/game` 마운트로 컨테이너 재시작 후에도 유지.