Depends 제외 (SummaryUC)

Author: kocory1

ai_server/DEPLOYMENT_CHECKLIST.md

@@ -120,17 +120,31 @@ sudo netstat -tlnp | grep 8000
 ```
 
 ### 문제 2: 502 Bad Gateway (nginx)
-**원인**: 백엔드 서버 응답 없음
+**원인**: 백엔드 서버 응답 없음 (앱 기동 실패 또는 연결 불가)
 
 **해결**:
 ```bash
-# nginx 상태 확인
-sudo systemctl status nginx
+# 1) Docker 사용 시: 컨테이너 로그에서 기동 실패 원인 확인 (lifespan 예외 등)
+docker logs onsikgu-ai-server --tail 200
+# 또는
+docker compose -f ... logs ai-server --tail 200
+
+# 2) 컨테이너가 재시작 루프인지 확인
+docker ps -a   # STATUS가 Restarting이면 lifespan/기동 실패 가능성 높음
+
+# 3) 호스트에서 앱 포트 직접 호출 (프록시 제외)
+curl -s http://localhost:8000/health   # 실패 시 앱 자체 문제
 
-# nginx 로그 확인
+# 4) nginx 상태 및 로그
+sudo systemctl status nginx
 sudo tail -f /var/log/nginx/error.log
 ```
 
+**자주 나오는 기동 실패 원인**
+- `Chroma persist directory is not writable` → 볼륨 경로 `chown 1000:1000` (또는 appuser uid)
+- `OPENAI_API_KEY` 누락/오류 → env_file 또는 환경변수 확인
+- `get_chroma_collection()` / LLM 초기화 예외 → 위 로그에 traceback 출력됨
+
 ### 문제 3: OpenAI API 에러
 **원인**: API 키 미설정 또는 잘못된 키
 

ai_server/app/main.py

@@ -39,35 +39,42 @@ async def lifespan(app: FastAPI):
     # 시작 훅: 첫 요청 전에 의존성(Chroma/체인) 초기화
     # - 첫 요청에서 터지지 않게 fail-fast
     # - 권한/경로 문제를 부팅 단계에서 바로 발견
+    # - 실패 시 로그에 전체 traceback 남김 (502 원인 확인: docker logs <container>)
     logger.info("[lifespan] startup: initializing dependencies (chroma + generators)")
-
-    # Chroma persist directory 쓰기 가능 여부 확인 (권한 이슈 조기 감지)
-    persist_dir = Path(settings.chroma_persist_directory)
-    persist_dir.mkdir(parents=True, exist_ok=True)
-    write_test_path = persist_dir / ".write_test"
     try:
-        write_test_path.write_text("ok", encoding="utf-8")
-        write_test_path.unlink(missing_ok=True)
-    except Exception as e:
-        logger.error(f"[lifespan] chroma persist dir not writable: {persist_dir}", exc_info=True)
-        raise RuntimeError(f"Chroma persist directory is not writable: {persist_dir}") from e
-
-    # DI 싱글톤 생성(초기화) 트리거
-    from app.presentation.dependencies import (
-        get_chroma_collection,
-        get_family_generator,
-        get_personal_generator,
-        get_summary_generator,
-        get_vector_store,
-    )
-
-    get_chroma_collection()
-    get_vector_store()
-    get_personal_generator()
-    get_family_generator()
-    get_summary_generator()
+        # Chroma persist directory 쓰기 가능 여부 확인 (권한 이슈 조기 감지)
+        persist_dir = Path(settings.chroma_persist_directory)
+        persist_dir.mkdir(parents=True, exist_ok=True)
+        write_test_path = persist_dir / ".write_test"
+        try:
+            write_test_path.write_text("ok", encoding="utf-8")
+            write_test_path.unlink(missing_ok=True)
+        except Exception as e:
+            logger.error(
+                f"[lifespan] chroma persist dir not writable: {persist_dir}", exc_info=True
+            )
+            raise RuntimeError(f"Chroma persist directory is not writable: {persist_dir}") from e
+
+        # DI 싱글톤 생성(초기화) 트리거
+        from app.presentation.dependencies import (
+            get_chroma_collection,
+            get_family_generator,
+            get_personal_generator,
+            get_summary_generator,
+            get_vector_store,
+        )
+
+        get_chroma_collection()
+        get_vector_store()
+        get_personal_generator()
+        get_family_generator()
+        get_summary_generator()
+
+        logger.info("[lifespan] startup: initialization complete")
+    except Exception:
+        logger.exception("[lifespan] startup failed (502 원인 확인: docker logs <container>)")
+        raise
 
-    logger.info("[lifespan] startup: initialization complete")
     yield
     logger.info("[lifespan] shutdown")
 

ai_server/app/presentation/routers/summary_router.py

@@ -11,7 +11,8 @@
 from fastapi import APIRouter, Depends, HTTPException, Query
 
 from app.application.dto.summary_dto import SummaryInput, SummaryOutput
-from app.presentation.dependencies import SummaryUC, get_family_summary_use_case
+from app.application.use_cases.family_summary import FamilySummaryUseCase
+from app.presentation.dependencies import get_family_summary_use_case
 from app.presentation.schemas.question_schemas import SummaryResponseSchema
 
 logger = logging.getLogger(__name__)
@@ -32,7 +33,7 @@ async def get_family_summary(
         description="weekly(최근 7일) 또는 monthly(최근 30일)",
         pattern="^(weekly|monthly)$",
     ),
-    use_case: SummaryUC = Depends(get_family_summary_use_case),
+    use_case: FamilySummaryUseCase = Depends(get_family_summary_use_case),
 ) -> SummaryResponseSchema:
     try:
         input_dto = SummaryInput(family_id=familyId, period=period)