Merge pull request #217 from Pseudo-Lab/fix/api-prefix

feat: API 경로 /api/v1 통일, Traefik 라우팅 규칙 정비

Author: soohyunme

getcloser/.gitignore

@@ -0,0 +1 @@
+.env

getcloser/backend/app/api/v1/auth/auth.py

@@ -8,7 +8,10 @@
 
 router = APIRouter()
 
-@router.post('/', response_model=UserResponse)
+# Accept both /auth and /auth/ to avoid redirects (307) when the trailing slash is
+# omitted by clients such as the frontend.
+@router.post("", response_model=UserResponse)
+@router.post("/", response_model=UserResponse, include_in_schema=False)
 def auth(user_auth: UserAuth, db: Session = Depends(get_db)):
   token = auth_user(db, user_auth.email)
   return token

getcloser/backend/app/main.py

@@ -1,6 +1,5 @@
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
-from fastapi.openapi.utils import get_openapi
 from dotenv import load_dotenv
 import os
 
@@ -27,21 +26,6 @@
     redoc_url="/redoc",
 )
 
-# Swagger 기본 경로를 /api 로 지정
-def custom_openapi():
-    if app.openapi_schema:
-        return app.openapi_schema
-    openapi_schema = get_openapi(   
-        title=app.title,
-        version=app.version,
-        description=app.description,
-        routes=app.routes,
-    )
-    openapi_schema["servers"] = [{"url": "/api"}]
-    app.openapi_schema = openapi_schema
-    return app.openapi_schema
-
-app.openapi = custom_openapi
 
 # CORS 미들웨어 설정
 origins = os.getenv("CORS_ORIGINS", "").split(",")
@@ -53,7 +37,8 @@ def custom_openapi():
     allow_headers=["*"],
 )
 
-app.include_router(api_router, prefix="/v1")
+# 모든 환경에서 /api 프리픽스 사용 (개발/프로덕션 통일)
+app.include_router(api_router, prefix="/api/v1")
 app.include_router(test_db.test_router)
 
 

getcloser/docker-compose.dev.yml

@@ -1,14 +1,22 @@
 version: '3.8'
 
 services:
-  # frontend:
-  #   build:
-  #     context: ./frontend
-  #     labels:
-  #       - "org.pseudolab.project=getcloser"
-  #   ports:
-  #     - "${FRONTEND_PORT}:80"
-  #   restart: always
+  frontend:
+    build:
+      context: ./frontend
+      dockerfile: Dockerfile.dev
+      labels:
+        - "org.pseudolab.project=getcloser"
+    ports:
+      - "3000:3000"
+    environment:
+      NODE_ENV: development
+      NEXT_PUBLIC_API_BASE: http://backend:8000/api
+    volumes:
+      - ./frontend:/app
+      - /app/node_modules
+      - /app/.next
+    restart: always
 
   backend:
     build:
@@ -17,10 +25,11 @@ services:
       labels:
         - "org.pseudolab.project=getcloser"
     ports:
-      - "${BACKEND_PORT}:8000"
+      - "8000:8000"
     environment:
       ENV: development
       DATABASE_URL: postgresql+psycopg2://${DB_USER}:${DB_PASSWORD}@db:5432/${DB_DATABASE}
+      CORS_ORIGINS: ${CORS_ORIGINS:-http://localhost:3000}
       SECRET_KEY: ${SECRET_KEY:-change-me-in-prod}
       ACCESS_TOKEN_EXPIRE_MINUTES: ${ACCESS_TOKEN_EXPIRE_MINUTES:-60}
     volumes:

getcloser/docker-compose.yaml

@@ -54,16 +54,18 @@ services:
       - traefik.docker.network=traefik
 
       # --- Traefik Router (backend) ---
-      - traefik.http.routers.getcloser-api.rule=Host(`${APP_HOST}`) && PathPrefix(`/api`) || Host(`${APP_HOST}`) && PathPrefix(`/docs`) || Host(`${APP_HOST}`) && PathPrefix(`/redoc`) || Host(`${APP_HOST}`) && PathPrefix(`/health`) || Host(`${APP_HOST}`) && Path(`/openapi.json`)
+      # 백엔드로 라우팅되는 경로:
+      # - /api/* : API 엔드포인트 (백엔드에서 /api/v1/* 로 라우팅)
+      # - /docs, /redoc : Swagger UI 문서 (백엔드에서 /docs, /redoc로 라우팅)
+      # - /health : 헬스체크 (백엔드에서 /health로 라우팅)
+      # - /openapi.json : OpenAPI 스키마 (백엔드에서 /openapi.json로 라우팅)
+      # 백엔드에 /api 프리픽스가 포함되어 있으므로 stripPrefix 미들웨어 없이 그대로 전달
+      - traefik.http.routers.getcloser-api.rule=Host(`${APP_HOST}`) && (PathPrefix(`/api`) || PathPrefix(`/docs`) || PathPrefix(`/redoc`) || PathPrefix(`/health`) || Path(`/openapi.json`))
       - traefik.http.routers.getcloser-api.entrypoints=websecure
       - traefik.http.routers.getcloser-api.tls=true
       - traefik.http.routers.getcloser-api.tls.certresolver=le
       - traefik.http.services.getcloser-api.loadbalancer.server.port=8000
 
-      # /api 프리픽스 제거 (백엔드 내부는 / 기준으로 동작)
-      - traefik.http.middlewares.getcloser-stripapi.stripPrefix.prefixes=/api
-      - traefik.http.routers.getcloser-api.middlewares=getcloser-stripapi
-
       # HTTP → HTTPS 리다이렉트 (backend)
       - traefik.http.routers.getcloser-api-http.rule=Host(`${APP_HOST}`) && PathPrefix(`/api`)
       - traefik.http.routers.getcloser-api-http.entrypoints=web

getcloser/frontend/.env.example

@@ -0,0 +1,19 @@
+FROM node:24-alpine
+
+WORKDIR /app
+
+# 시스템 의존성 설치
+RUN apk add --no-cache libc6-compat
+
+# package.json과 lock 파일 복사
+COPY package*.json ./
+
+# 의존성 설치
+RUN npm ci
+
+# 소스 코드 복사
+COPY . .
+
+# 개발 모드로 실행
+CMD ["npm", "run", "dev"]
+