Feature/video2

.github/FUNDING.yml

@@ -0,0 +1,2 @@
+github: seoyunje
+buy_me_a_coffee: seoyunje

.github/labeler.yml

@@ -0,0 +1,31 @@
+model:
+  - changed-files:
+    - any-glob-to-any-file: ["src/model/**", "models/**", "*.pt", "*.pth"]
+
+data:
+  - changed-files:
+    - any-glob-to-any-file: ["data/**", "datasets/**", "src/data/**"]
+
+training:
+  - changed-files:
+    - any-glob-to-any-file: ["train*.py", "src/train/**", "configs/**"]
+
+api:
+  - changed-files:
+    - any-glob-to-any-file: ["api/**", "routers/**", "app.py"]
+
+test:
+  - changed-files:
+    - any-glob-to-any-file: ["tests/**", "test_*.py"]
+
+docs:
+  - changed-files:
+    - any-glob-to-any-file: ["docs/**", "*.md", "*.rst"]
+
+ci:
+  - changed-files:
+    - any-glob-to-any-file: [".github/**"]
+
+dependencies:
+  - changed-files:
+    - any-glob-to-any-file: ["requirements*.txt", "pyproject.toml", "setup.py"]

.github/workflows/pr-ci.yml

@@ -0,0 +1,29 @@
+name: PR CI
+
+on:
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  lint-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+          cache: "pip"
+
+      - name: Install dependencies
+        run: pip install -r requirements.txt
+
+      - name: Lint (ruff)
+        run: ruff check . --output-format=github
+
+      - name: Format check (ruff)
+        run: ruff format --check .
+
+      - name: Test (pytest)
+        run: pytest --tb=short -q

.github/workflows/pr-label.yml

@@ -0,0 +1,18 @@
+name: PR Auto Label
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+
+jobs:
+  label:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+
+    steps:
+      - uses: actions/labeler@v5
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          sync-labels: true  # PR 파일 변경 시 라벨 재동기화

.gitignore

@@ -6,6 +6,7 @@
 npm-debug.log*
 yarn-debug.log*
 yarn-error.log*
+*.egg-info
 
 # [FastAPI / Python - App 폴더 관련]
 **/__pycache__/

App/celery_app.py

@@ -1,18 +1,10 @@
 import os
-import sys
-from pathlib import Path
 from celery import Celery
 from dotenv import load_dotenv
 
-current_file = Path(__file__).resolve()
-project_root = current_file.parent.parent
-
-if str(project_root) not in sys.path:
-    sys.path.insert(0, str(project_root))
-
+# ------ .env 파일 가져오기 ------
 load_dotenv()
 
-# 기본값 설정
 REDIS_HOST = os.getenv("REDIS_HOST", "localhost")
 REDIS_PORT = os.getenv("REDIS_PORT", 6379)
 
@@ -23,7 +15,11 @@
     "deepguard",
     broker=REDIS_URL, # 메세지를 전달할 브로커
     backend=REDIS_URL, # 작업 결과를 저장할 백엔드
-    include=["services.inference_svc"] # 비동기 추론 작업 파일
+    # 비동기 추론 작업 파일
+    include=["services.inference_svc", # process_image_task, process_video_task 
+             "services.explain_svc", # process_explain_image_task
+             "services.image_svc", # cleanup_anonymous_image, cleanup_image_cam
+             "services.video_svc"] # cleanup_anonymous_video
 )
 
 # Celery Instance 상세 설정

App/main.py

@@ -1,44 +1,35 @@
 import os
-import sys
-from pathlib import Path
-import warnings
-import logging
 from dotenv import load_dotenv
 
-# ------ 상위 폴더 경로 설정 --------
-current_file = Path(__file__).resolve()
-project_root = current_file.parent.parent  # App의 상위 폴더
-
-if str(project_root) not in sys.path:
-    sys.path.insert(0, str(project_root))
-
+# ------ .env 파일 가져오기 ------
 load_dotenv()
 
 # -------- Huggingface_Hub 인증 ----------
 if os.getenv("HF_TOKEN"):
     os.environ["HF_TOKEN"] = os.getenv("HF_TOKEN")
+else:
+    print("[Warning] HF_TOKEN is not set")
 
 from fastapi import FastAPI
 from fastapi.staticfiles import StaticFiles
 from fastapi.exceptions import RequestValidationError
 from starlette.exceptions import HTTPException as StarletteHTTPException
 from fastapi.middleware.cors import CORSMiddleware
-from starlette.middleware.sessions import SessionMiddleware
-from routes import auth, home, inference, image, video
-from utils.common import lifespan
-from utils import exc_handler, middleware
+# from starlette.middleware.sessions import SessionMiddleware
+from routes import api_router
+from utils import exc_handler, middleware, common
 
 
-# 가상 인스턴스 생성
-app = FastAPI(lifespan=lifespan)
+# 가상 FastAPI 인스턴스 생성
+app = FastAPI(lifespan=common.lifespan)
 
-# StaticFile 등록하기
+# StaticFile 등록 (이미지, 비디오 파일)
 app.mount("/static", StaticFiles(directory="static"), name="static")
 
-# Cross Origin Resource Sharing
+# CORS Setup for cross-origin requests
+# FrontEnd: React, BackEnd: FastAPI
 origins_str = os.getenv("CORS_ALLOWED_ORIGINS")
 allowed_origins = [origin.strip() for origin in origins_str.split(",")]
-
 app.add_middleware(CORSMiddleware,
                    allow_origins=allowed_origins,
                    allow_methods=["*"],
@@ -52,16 +43,12 @@
 # app.add_middleware(SessionMiddleware, secret_key=SECRET_KEY, max_age=3600)
 
 # 세션 미들웨어 등록 - Redis 이용
-app.add_middleware(middleware.RedisSessionMiddleware, max_age=7200)
+app.add_middleware(middleware.RedisSessionMiddleware, max_age=3600)
 
-# 라우터 등록
-app.include_router(auth.router)
-app.include_router(home.router)
-app.include_router(inference.router)
-app.include_router(image.router)
-app.include_router(video.router)
+# 라우터 등록 (View: Router, Controller: Service)
+app.include_router(api_router)
 
-# Custom HTTPException Handler
+# 커스텀 예외 처리: HTTPException
 app.add_exception_handler(StarletteHTTPException, exc_handler.custom_http_exception_handler)
-# Custom RequestValidationError Handler
+# 커스텀 예외 처리: RequestValidationError
 app.add_exception_handler(RequestValidationError, exc_handler.validation_exception_handler)

App/routes/__init__.py

@@ -0,0 +1,15 @@
+from fastapi import APIRouter
+from routes.auth import router as auth_router    
+from routes.explain import router as explain_router    
+from routes.home import router as home_router  
+from routes.image import router as image_router  
+from routes.inference import router as inference_router  
+from routes.video import router as video_router  
+
+api_router = APIRouter(prefix="/api", tags=["api"])
+api_router.include_router(auth_router)   
+api_router.include_router(explain_router) 
+api_router.include_router(home_router)  
+api_router.include_router(image_router)
+api_router.include_router(inference_router) 
+api_router.include_router(video_router)        

App/routes/auth.py

@@ -1,20 +1,21 @@
+from pydantic import BaseModel
 from fastapi import APIRouter, Depends, status, Request
 from services import auth_svc, session_svc
 from sqlalchemy import Connection
 from db.database import context_get_conn
 from fastapi.exceptions import HTTPException
+from fastapi.responses import JSONResponse
 from schemas.auth_schema import RegisterRequest, LoginRequest
 
 router = APIRouter(prefix="/auth", tags=["auth"])
 
-# --- 로그인 상태 확인 API ---
 # 프론트엔드 새로고침 시 세션 유지 여부를 확인하고 유저 정보를 반환합니다
-@router.get("/check", status_code=status.HTTP_200_OK)
+@router.get("/check", status_code=status.HTTP_200_OK, response_class=JSONResponse, summary= "로그인 상태 확인 API")
 async def check_session(session_user = Depends(session_svc.get_session_user_opt)):
     return {"user": session_user}
 
-# --- 회원가입 API ---
-@router.post("/register", status_code=status.HTTP_201_CREATED)
+
+@router.post("/register", status_code=status.HTTP_201_CREATED,response_class=JSONResponse, summary="회원가입 API")
 async def register_user(request: Request,
                         user_info: RegisterRequest,
                         conn: Connection = Depends(context_get_conn)):
@@ -40,8 +41,7 @@
 
     return {"message": "회원가입이 성공적으로 완료되었습니다.", "status": "success"}
 
-# --- 로그인 API ---
-@router.post("/login", status_code=status.HTTP_200_OK)
+@router.post("/login", status_code=status.HTTP_200_OK,response_class=JSONResponse ,summary="로그인 API")
 async def login_user(request: Request,
                      login_info: LoginRequest,
                      conn: Connection = Depends(context_get_conn)):
@@ -73,7 +73,7 @@
         "status": "success"
     }
 
-@router.get("/logout", status_code=status.HTTP_200_OK)
+@router.get("/logout", status_code=status.HTTP_200_OK, response_class=JSONResponse, summary="로그아웃")
 async def logout_user(request: Request):
     request.state.session.clear()
     return {