One of the plans — Backend Server

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

기술 스택

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

실행

# 로컬 (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 마운트 필요.