safori-team · H4nnhoi · Nov 3, 2025 · Nov 3, 2025 · Nov 3, 2025 · Nov 3, 2025
diff --git a/GLANCES_USAGE.md b/GLANCES_USAGE.md
@@ -0,0 +1,94 @@
+# Glances 사용 가이드
+
+## 설치 완료
+glances 3.4.0.3 버전이 설치되었습니다.
+
+## 기본 사용법
+
+### 터미널에서 실시간 모니터링
+```bash
+glances
+```
+
+### 웹 서버 모드로 실행 (원격 접속 가능)
+```bash
+# 기본 포트(61208)로 실행
+glances -w
+
+# 특정 포트 지정
+glances -w -p 61208
+
+# 특정 IP에서만 접속 허용 (보안 강화)
+glances -w -B 0.0.0.0 -p 61208
+```
+
+웹 브라우저에서 접속: `http://서버IP:61208`
+
+### RESTful API 모드
+```bash
+glances -s
+```
+
+### CPU, 메모리, 디스크, 네트워크만 간단히 보기
+```bash
+glances --percpu
+```
+
+## 주요 단축키
+
+- `q` 또는 `ESC`: 종료
+- `h`: 도움말
+- `c`: CPU 정보 표시/숨김
+- `m`: 메모리 정보 표시/숨김
+- `d`: 디스크 정보 표시/숨김
+- `n`: 네트워크 정보 표시/숨김
+- `p`: 프로세스 정렬 변경
+- `w`: 경고 삭제
+- `x`: 경고/중요 임계값 삭제
+
+## 서비스로 실행
+
+glances가 systemd 서비스로 자동 등록되어 있습니다.
+
+```bash
+# 서비스 시작
+sudo systemctl start glances
+
+# 서비스 중지
+sudo systemctl stop glances
+
+# 서비스 상태 확인
+sudo systemctl status glances
+
+# 부팅 시 자동 시작 활성화
+sudo systemctl enable glances
+```
+
+## 백그라운드 실행
+
+```bash
+# nohup으로 백그라운드 실행
+nohup glances -w > /dev/null 2>&1 &
+
+# tmux/screen 사용
+tmux new-session -d -s monitoring 'glances'
+```
+
+## 유용한 옵션
+
+- `--refresh 2`: 2초마다 갱신 (기본값: 3초)
+- `--disable-plugin docker`: Docker 플러그인 비활성화
+- `--enable-plugin docker`: Docker 플러그인 활성화
+- `--percpu`: CPU 코어별 사용량 표시
+- `--process-short-name`: 짧은 프로세스 이름 표시
+- `--time`: 시간 표시
+
+## 예시: 웹 모드로 백그라운드 실행
+
+```bash
+# 웹 서버 모드로 백그라운드 실행
+glances -w -B 0.0.0.0 -p 61208 &
+```
+
+브라우저에서 `http://서버IP:61208` 접속하여 모니터링 가능합니다.
+
diff --git a/app/dto.py b/app/dto.py
@@ -239,3 +239,28 @@ class ErrorResponse(BaseModel):
 class SuccessResponse(BaseModel):
     message: str
     status: str = "success"
+
+
+# OpenAI 분석 결과 DTO
+class AnalysisResultResponse(BaseModel):
+    """OpenAI 종합분석 결과 응답"""
+    source: str  # weekly | frequency
+    message: str
+
+
+class WeeklyDayItem(BaseModel):
+    date: str
+    weekday: str
+    top_emotion: Optional[str] = None
+
+
+class WeeklyAnalysisCombinedResponse(BaseModel):
+    """주간 종합분석: OpenAI 메시지 + 기존 주간 요약"""
+    message: str
+    weekly: List[WeeklyDayItem]
+
+
+class FrequencyAnalysisCombinedResponse(BaseModel):
+    """월간 빈도 종합분석: OpenAI 메시지 + 기존 빈도 결과"""
+    message: str
+    frequency: dict
diff --git a/app/main.py b/app/main.py
@@ -27,7 +27,8 @@
     UserInfoResponse, CareInfoResponse,
     FcmTokenRegisterRequest, FcmTokenRegisterResponse, FcmTokenDeactivateResponse,
     NotificationListResponse,
-    TopEmotionResponse, CareTopEmotionResponse
+    TopEmotionResponse, CareTopEmotionResponse,
+    AnalysisResultResponse, WeeklyAnalysisCombinedResponse, FrequencyAnalysisCombinedResponse
 )
 from .care_service import CareService
 import random
@@ -361,24 +362,35 @@ async def upload_voice_with_question(
     else:
         raise HTTPException(status_code=400, detail=result["message"])
 
-@users_router.get("/voices/analyzing/frequency")
+@users_router.get("/voices/analyzing/frequency", response_model=FrequencyAnalysisCombinedResponse)
 async def get_user_emotion_frequency(username: str, month: str, db: Session = Depends(get_db)):
-    """사용자 본인의 한달간 감정 빈도수 집계"""
-    voice_service = get_voice_service(db)
-    result = voice_service.get_user_emotion_monthly_frequency(username, month)
-    if not result.get("success"):
-        raise HTTPException(status_code=400, detail=result.get("message", "조회 실패"))
-    return result
+    """사용자 본인의 월간 빈도 종합분석(OpenAI 캐시 + 기존 빈도 결과)"""
+    from .services.analysis_service import get_frequency_result
+    try:
+        message = get_frequency_result(db, username=username, is_care=False)
+        voice_service = get_voice_service(db)
+        base = voice_service.get_user_emotion_monthly_frequency(username, month)
+        frequency = base.get("frequency", {}) if base.get("success") else {}
+        return FrequencyAnalysisCombinedResponse(message=message, frequency=frequency)
+    except Exception as e:
+        raise HTTPException(status_code=400, detail=f"분석 실패: {str(e)}")
 
-@users_router.get("/voices/analyzing/weekly")
+@users_router.get("/voices/analyzing/weekly", response_model=WeeklyAnalysisCombinedResponse)
 async def get_user_emotion_weekly(username: str, month: str, week: int, db: Session = Depends(get_db)):
-    """사용자 본인의 월/주차별 요일별 top 감정 요약"""
-    voice_service = get_voice_service(db)
-    result = voice_service.get_user_emotion_weekly_summary(username, month, week)
+    """사용자 본인의 주간 종합분석(OpenAI 캐시 사용)"""
+    from .services.analysis_service import get_weekly_result
+    try:
+        message = get_weekly_result(db, username=username, is_care=False)
+        # 기존 주간 요약도 함께 제공
+        voice_service = get_voice_service(db)
+        weekly_result = voice_service.get_user_emotion_weekly_summary(username, month, week)
+        weekly = weekly_result.get("weekly", []) if weekly_result.get("success") else []
+        return WeeklyAnalysisCombinedResponse(message=message, weekly=weekly)
+    except Exception as e:
+        raise HTTPException(status_code=400, detail=f"분석 실패: {str(e)}")
 
-    if not result.get("success"):
-        raise HTTPException(status_code=400, detail=result.get("message", "조회 실패"))
-    return result
+
+
 
 
 @users_router.get("/top_emotion", response_model=TopEmotionResponse)
@@ -529,26 +541,49 @@ async def get_care_user_voice_list(
     result = voice_service.get_care_voice_list(care_username, date=date)
     return CareUserVoiceListResponse(success=result["success"], voices=result.get("voices", []))
 
-@care_router.get("/users/voices/analyzing/frequency")
+@care_router.get("/users/voices/analyzing/frequency", response_model=FrequencyAnalysisCombinedResponse)
 async def get_emotion_monthly_frequency(
     care_username: str, month: str, db: Session = Depends(get_db)
 ):
-    """
-    보호자 페이지: 연결된 유저의 한달간 감정 빈도수 집계 (CareService 내부 로직 사용)
-    """
-    care_service = CareService(db)
-    return care_service.get_emotion_monthly_frequency(care_username, month)
+    """보호자: 연결 유저의 월간 빈도 종합분석(OpenAI 캐시 + 기존 빈도 결과)"""
+    from .services.analysis_service import get_frequency_result
+    try:
+        message = get_frequency_result(db, username=care_username, is_care=True)
+        from .care_service import CareService
+        care_service = CareService(db)
+        base = care_service.get_emotion_monthly_frequency(care_username, month)
+        frequency = base.get("frequency", {}) if base.get("success") else {}
+        return FrequencyAnalysisCombinedResponse(message=message, frequency=frequency)
+    except Exception as e:
+        raise HTTPException(status_code=400, detail=f"분석 실패: {str(e)}")
 
-@care_router.get("/users/voices/analyzing/weekly")
+
+
+
+
+
+
+@care_router.get("/users/voices/analyzing/weekly", response_model=WeeklyAnalysisCombinedResponse)
 async def get_emotion_weekly_summary(
     care_username: str,
     month: str,
     week: int,
     db: Session = Depends(get_db)
 ):
-    """보호자페이지 - 연결유저 월/주차별 요일 top 감정 통계"""
-    care_service = CareService(db)
-    return care_service.get_emotion_weekly_summary(care_username, month, week)
+    """보호자: 연결 유저의 주간 종합분석(OpenAI 캐시 사용)"""
+    from .services.analysis_service import get_weekly_result
+    try:
+        message = get_weekly_result(db, username=care_username, is_care=True)
+        # 기존 주간 요약도 함께 제공
+        care_service = CareService(db)
+        weekly_result = care_service.get_emotion_weekly_summary(care_username, month, week)
+        weekly = weekly_result.get("weekly", []) if weekly_result.get("success") else []
+        return WeeklyAnalysisCombinedResponse(message=message, weekly=weekly)
+    except Exception as e:
+        raise HTTPException(status_code=400, detail=f"분석 실패: {str(e)}")
+
+
+
 
 @care_router.get("/notifications", response_model=NotificationListResponse)
 async def get_care_notifications(care_username: str, db: Session = Depends(get_db)):
@@ -800,6 +835,22 @@ async def test_error(statusCode: int):
             detail=f"Invalid statusCode: {statusCode}. Only 400 or 500 are allowed."
         )
 
+
+@test_router.post("/fcm/send")
+async def test_fcm_send(
+    token: Optional[str] = None,
+    title: str = "Test Title",
+    body: str = "Test Body",
+    db: Session = Depends(get_db)
+):
+    """단일 토큰으로 FCM 테스트 전송 (SDK에서 발급받은 토큰 사용)"""
+    if not token:
+        raise HTTPException(status_code=400, detail="token is required")
+    from .services.fcm_service import FcmService
+    svc = FcmService(db)
+    result = svc.send_notification_to_tokens([token], title, body)
+    return {"success": True, "result": result}
+
 # ---------------- router 등록 ----------------
 app.include_router(users_router)
 app.include_router(care_router)

diff --git a/app/models.py b/app/models.py
@@ -237,3 +237,39 @@ class Notification(Base):
         Index('idx_notification_voice', 'voice_id'),
         Index('idx_notification_created', 'created_at'),
     )
+
+
+class WeeklyResult(Base):
+    """주간 OpenAI 종합분석 캐시"""
+    __tablename__ = "weekly_result"
+
+    weekly_result_id = Column(BigInteger, primary_key=True, autoincrement=True)
+    user_id = Column(BigInteger, ForeignKey("user.user_id", ondelete="CASCADE"), nullable=False)
+    latest_voice_composite_id = Column(BigInteger, ForeignKey("voice_composite.voice_composite_id", ondelete="CASCADE"), nullable=True)
+    message = Column(Text, nullable=False)
+    created_at = Column(DateTime, nullable=False, server_default=func.current_timestamp())
+    updated_at = Column(DateTime, nullable=False, server_default=func.current_timestamp(), onupdate=func.current_timestamp())
+
+    __table_args__ = (
+        Index('idx_weekly_user', 'user_id'),
+        Index('idx_weekly_latest_vc', 'latest_voice_composite_id'),
+        UniqueConstraint('user_id', name='uq_weekly_user'),
+    )
+
+
+class FrequencyResult(Base):
+    """월간 빈도 OpenAI 종합분석 캐시"""
+    __tablename__ = "frequency_result"
+
+    frequency_result_id = Column(BigInteger, primary_key=True, autoincrement=True)
+    user_id = Column(BigInteger, ForeignKey("user.user_id", ondelete="CASCADE"), nullable=False)
+    latest_voice_composite_id = Column(BigInteger, ForeignKey("voice_composite.voice_composite_id", ondelete="CASCADE"), nullable=True)
+    message = Column(Text, nullable=False)
+    created_at = Column(DateTime, nullable=False, server_default=func.current_timestamp())
+    updated_at = Column(DateTime, nullable=False, server_default=func.current_timestamp(), onupdate=func.current_timestamp())
+
+    __table_args__ = (
+        Index('idx_freq_user', 'user_id'),
+        Index('idx_freq_latest_vc', 'latest_voice_composite_id'),
+        UniqueConstraint('user_id', name='uq_freq_user'),
+    )