feat: Swagger API 문서 추가 + 보스레이드/플레이어 레벨 시스템

- swaggo/swag 기반 전체 API 엔드포인트 Swagger 어노테이션 (59개)
- /swagger/ 경로에 Swagger UI 제공
- 보스레이드 데디서버 관리 (등록, 하트비트, 슬롯 리셋)
- 플레이어 레벨/경험치 시스템 및 스탯 성장

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

internal/download/handler.go

@@ -19,6 +19,14 @@ func NewHandler(svc *Service, baseURL string) *Handler {
 	return &Handler{svc: svc, baseURL: baseURL}
 }
 
+// GetInfo godoc
+// @Summary      다운로드 정보 조회
+// @Description  게임 및 런처 다운로드 정보를 조회합니다
+// @Tags         Download
+// @Produce      json
+// @Success      200  {object}  docs.DownloadInfoResponse
+// @Failure      404  {object}  docs.ErrorResponse
+// @Router       /api/download/info [get]
 func (h *Handler) GetInfo(c *fiber.Ctx) error {
 	info, err := h.svc.GetInfo()
 	if err != nil {
@@ -27,8 +35,20 @@ func (h *Handler) GetInfo(c *fiber.Ctx) error {
 	return c.JSON(info)
 }
 
-// Upload accepts a raw binary body (application/octet-stream).
-// The filename is passed as a query parameter: ?filename=A301_v1.0.zip
+// Upload godoc
+// @Summary      게임 파일 업로드 (관리자)
+// @Description  게임 zip 파일을 스트리밍 업로드합니다. Body는 raw binary입니다.
+// @Tags         Download
+// @Accept       application/octet-stream
+// @Produce      json
+// @Security     BearerAuth
+// @Param        filename  query     string  false  "파일명"  default(game.zip)
+// @Success      200       {object}  docs.DownloadInfoResponse
+// @Failure      400       {object}  docs.ErrorResponse
+// @Failure      401       {object}  docs.ErrorResponse
+// @Failure      403       {object}  docs.ErrorResponse
+// @Failure      500       {object}  docs.ErrorResponse
+// @Router       /api/download/upload/game [post]
 func (h *Handler) Upload(c *fiber.Ctx) error {
 	filename := strings.TrimSpace(c.Query("filename", "game.zip"))
 	// 경로 순회 방지: 디렉토리 구분자 제거, 기본 파일명만 사용
@@ -49,6 +69,14 @@ func (h *Handler) Upload(c *fiber.Ctx) error {
 	return c.JSON(info)
 }
 
+// ServeFile godoc
+// @Summary      게임 파일 다운로드
+// @Description  게임 zip 파일을 다운로드합니다
+// @Tags         Download
+// @Produce      application/octet-stream
+// @Success      200  {file}    binary
+// @Failure      404  {object}  docs.ErrorResponse
+// @Router       /api/download/file [get]
 func (h *Handler) ServeFile(c *fiber.Ctx) error {
 	path := h.svc.GameFilePath()
 	if _, err := os.Stat(path); err != nil {
@@ -63,6 +91,18 @@ func (h *Handler) ServeFile(c *fiber.Ctx) error {
 	return c.SendFile(path)
 }
 
+// UploadLauncher godoc
+// @Summary      런처 업로드 (관리자)
+// @Description  런처 실행 파일을 스트리밍 업로드합니다. Body는 raw binary입니다.
+// @Tags         Download
+// @Accept       application/octet-stream
+// @Produce      json
+// @Security     BearerAuth
+// @Success      200  {object}  docs.DownloadInfoResponse
+// @Failure      401  {object}  docs.ErrorResponse
+// @Failure      403  {object}  docs.ErrorResponse
+// @Failure      500  {object}  docs.ErrorResponse
+// @Router       /api/download/upload/launcher [post]
 func (h *Handler) UploadLauncher(c *fiber.Ctx) error {
 	body := c.Request().BodyStream()
 	info, err := h.svc.UploadLauncher(body, h.baseURL)
@@ -73,6 +113,14 @@ func (h *Handler) UploadLauncher(c *fiber.Ctx) error {
 	return c.JSON(info)
 }
 
+// ServeLauncher godoc
+// @Summary      런처 다운로드
+// @Description  런처 실행 파일을 다운로드합니다
+// @Tags         Download
+// @Produce      application/octet-stream
+// @Success      200  {file}    binary
+// @Failure      404  {object}  docs.ErrorResponse
+// @Router       /api/download/launcher [get]
 func (h *Handler) ServeLauncher(c *fiber.Ctx) error {
 	path := h.svc.LauncherFilePath()
 	if _, err := os.Stat(path); err != nil {