# One of the plans — Backend Server

Go 기반 REST API 서버. 유저 인증, 공지사항, 게임 파일 배포를 담당합니다.

## 기술 스택

- **Go** + **Fiber v2** — HTTP 프레임워크
- **GORM** + **MySQL** — ORM / 주 데이터베이스
- **Redis** — JWT 블랙리스트 (로그아웃 처리)
- **JWT** (`golang-jwt/jwt v5`) — 인증

## 실행

```bash
# 로컬 (MySQL, Redis 필요)
go run .

# Docker
docker build -t a301-server .
docker run -p 8080:8080 --env-file .env a301-server
```

## 환경 변수

| 변수 | 설명 | 기본값 |
|------|------|--------|
| `APP_PORT` | 서버 포트 | `8080` |
| `DB_HOST` | MySQL 호스트 | `localhost` |
| `DB_PORT` | MySQL 포트 | `3306` |
| `DB_USER` | MySQL 사용자 | `root` |
| `DB_PASSWORD` | MySQL 비밀번호 | `""` |
| `DB_NAME` | 데이터베이스 이름 | `a301` |
| `REDIS_ADDR` | Redis 주소 | `localhost:6379` |
| `REDIS_PASSWORD` | Redis 비밀번호 | `""` |
| `JWT_SECRET` | JWT 서명 키 | `secret` |
| `JWT_EXPIRY_HOURS` | JWT 만료 시간(시) | `24` |
| `ADMIN_USERNAME` | 초기 관리자 계정 | `admin` |
| `ADMIN_PASSWORD` | 초기 관리자 비밀번호 | `admin1234` |
| `BASE_URL` | 외부 접근 URL (파일 URL 생성용) | `http://localhost:8080` |
| `GAME_DIR` | 게임 파일 저장 경로 | `/data/game` |

## API 엔드포인트

### Auth
| 메서드 | 경로 | 설명 |
|--------|------|------|
| POST | `/api/auth/register` | 회원가입 |
| POST | `/api/auth/login` | 로그인 → JWT 반환 |
| POST | `/api/auth/logout` | 로그아웃 (토큰 블랙리스트) |

### Users (관리자 전용)
| 메서드 | 경로 | 설명 |
|--------|------|------|
| GET | `/api/users/` | 전체 유저 목록 |
| PATCH | `/api/users/:id/role` | 유저 권한 변경 |
| DELETE | `/api/users/:id` | 유저 삭제 |

### Announcements
| 메서드 | 경로 | 설명 |
|--------|------|------|
| GET | `/api/announcements/` | 공지사항 목록 |
| POST | `/api/announcements/` | 공지 생성 (관리자) |
| PUT | `/api/announcements/:id` | 공지 수정 (관리자) |
| DELETE | `/api/announcements/:id` | 공지 삭제 (관리자) |

### Download
| 메서드 | 경로 | 설명 |
|--------|------|------|
| GET | `/api/download/info` | 게임/런처 메타데이터 (버전, 크기, SHA256) |
| GET | `/api/download/file` | `game.zip` 다운로드 |
| GET | `/api/download/launcher` | `launcher.exe` 다운로드 |
| POST | `/api/download/upload/game` | 게임 zip 업로드 (관리자) |
| POST | `/api/download/upload/launcher` | launcher.exe 업로드 (관리자) |

업로드 엔드포인트는 raw body 스트리밍으로 대용량 파일을 메모리 없이 디스크에 직접 저장합니다.
게임 zip 업로드 시 내부 `A301.exe`의 SHA256 해시를 자동 추출합니다.

## 프로젝트 구조

```
.
├── main.go
├── routes/routes.go
├── internal/
│   ├── auth/        # handler, service, repository, model
│   ├── announcement/
│   └── download/
└── pkg/
    ├── config/      # 환경 변수 로드
    ├── database/    # MySQL, Redis 연결
    └── middleware/  # JWT 인증, AdminOnly
```

## Docker / 배포

`/data/game` 볼륨에 `game.zip`과 `launcher.exe`가 저장됩니다.
`docker-compose.yml`에 named volume `game_data:/data/game` 마운트 필요.