feat(SCRUM-219): 채팅 세션 및 메시지 생성 시 시간 동기화 개선

- `created_at` 및 `updated_at` 필드를 UTC 시간으로 동기화하여 일관성 유지
- 채팅 세션 생성 시 동일한 시간으로 설정되도록 수정
- 메시지 저장 시 해당 세션의 `updated_at` 필드도 함께 업데이트하도록 로직 추가
- 관련 문서에 시간 동기화 내용 추가

Author: wonjun0120

app/models/chat.py

@@ -9,7 +9,7 @@
 - 사용자 피드백 모델
 - 벡터 저장소 모델 (PostgreSQL pgvector)
 """
-from datetime import datetime
+from datetime import datetime, timezone
 from typing import Any, Dict, List, Optional
 from uuid import UUID, uuid4
 from sqlmodel import Field as SQLField, Relationship, SQLModel
@@ -45,7 +45,7 @@ class ChatSessionBase(SQLModel):
     # 통계 필드
     total_messages: int = SQLField(default=0)
     avg_response_time_ms: Optional[int] = SQLField(default=None)
-    last_activity_at: datetime = SQLField(default_factory=datetime.utcnow)
+    last_activity_at: datetime = SQLField(default_factory=lambda: datetime.now(timezone.utc))
 
 class ChatSession(ChatSessionBase, table=True):
     """채팅 세션 테이블"""
@@ -57,14 +57,14 @@ class ChatSession(ChatSessionBase, table=True):
         sa_column=Column(PG_UUID(as_uuid=True), primary_key=True)
     )
     created_at: datetime = SQLField(
-        default_factory=datetime.utcnow,
+        default_factory=lambda: datetime.now(timezone.utc),
         # pylint: disable=not-callable
         sa_column=Column(DateTime(timezone=True), server_default=func.now())
     )
-    updated_at: Optional[datetime] = SQLField(
-        default=None,
+    updated_at: datetime = SQLField(
+        default_factory=lambda: datetime.now(timezone.utc),
         # pylint: disable=not-callable
-        sa_column=Column(DateTime(timezone=True), onupdate=func.now())
+        sa_column=Column(DateTime(timezone=True), server_default=func.now(), onupdate=func.now())
     )
 
     # 관계 정의
@@ -83,7 +83,7 @@ class ChatSessionRead(ChatSessionBase):
     """채팅 세션 조회 스키마"""
     id: UUID
     created_at: datetime
-    updated_at: Optional[datetime]
+    updated_at: datetime
 
 class ChatSessionUpdate(SQLModel):
     """채팅 세션 업데이트 스키마"""
@@ -119,7 +119,7 @@ class ChatMessage(ChatMessageBase, table=True):
         sa_column=Column(PG_UUID(as_uuid=True), primary_key=True)
     )
     created_at: datetime = SQLField(
-        default_factory=datetime.utcnow,
+        default_factory=lambda: datetime.now(timezone.utc),
         # pylint: disable=not-callable
         sa_column=Column(DateTime(timezone=True), server_default=func.now())
     )
@@ -169,7 +169,7 @@ class UserFeedback(UserFeedbackBase, table=True):
         sa_column=Column(PG_UUID(as_uuid=True), primary_key=True)
     )
     created_at: datetime = SQLField(
-        default_factory=datetime.utcnow,
+        default_factory=lambda: datetime.now(timezone.utc),
         # pylint: disable=not-callable
         sa_column=Column(DateTime(timezone=True), server_default=func.now())
     )
@@ -220,7 +220,7 @@ class RAGReference(RAGReferenceBase, table=True):
         sa_column=Column(PG_UUID(as_uuid=True), primary_key=True)
     )
     created_at: datetime = SQLField(
-        default_factory=datetime.utcnow,
+        default_factory=lambda: datetime.now(timezone.utc),
         # pylint: disable=not-callable
         sa_column=Column(DateTime(timezone=True), server_default=func.now())
     )
@@ -261,7 +261,7 @@ class UserProfile(UserProfileBase, table=True):
 
     # 기본 필드들 (직접 정의)
     created_at: datetime = SQLField(
-        default_factory=datetime.utcnow,
+        default_factory=lambda: datetime.now(timezone.utc),
         # pylint: disable=not-callable
         sa_column=Column(DateTime(timezone=True), server_default=func.now())
     )
@@ -333,7 +333,7 @@ class DocumentVector(DocumentVectorBase, table=True):
             sa_column=Column(PG_UUID(as_uuid=True), primary_key=True)
         )
         created_at: datetime = SQLField(
-            default_factory=datetime.utcnow,
+            default_factory=lambda: datetime.now(timezone.utc),
             # pylint: disable=not-callable
             sa_column=Column(DateTime(timezone=True), server_default=func.now())
         )

app/repositories/chat_repository.py

@@ -36,11 +36,16 @@ async def create_session(
 
         async with AsyncSessionLocal() as new_session:
             try:
+                # 동일한 시간을 created_at과 updated_at에 사용
+                current_time = datetime.now(timezone.utc)
+                
                 chat_session = ChatSession(
                     user_id=user_id,
                     title=title or "새로운 대화",
                     session_type=session_type,
-                    is_active=True
+                    is_active=True,
+                    created_at=current_time,
+                    updated_at=current_time
                 )
                 new_session.add(chat_session)
                 await new_session.commit()
@@ -239,10 +244,28 @@ async def save_message(
                     rag_metadata=metadata or {}
                 )
                 new_session.add(message)
+
+                # 메시지 저장 시 해당 세션의 updated_at도 함께 업데이트
+                try:
+                    session_stmt = select(ChatSession).where(
+                        and_(
+                            ChatSession.id == session_id,
+                            ChatSession.user_id == user_id
+                        )
+                    )
+                    session_result = await new_session.execute(session_stmt)
+                    chat_session = session_result.scalar_one_or_none()
+                    
+                    if chat_session:
+                        chat_session.updated_at = datetime.now(timezone.utc)
+                        new_session.add(chat_session)
+                except Exception as session_update_error:
+                    logger.warning(f"⚠️ 세션 updated_at 업데이트 실패 (메시지 저장은 계속): {session_update_error}")
+
                 await new_session.commit()
                 await new_session.refresh(message)
 
-                logger.debug(f"💾 메시지 저장 - session_id: {session_id}, role: {role}")
+                logger.debug(f"💾 메시지 저장 및 세션 업데이트 완료 - session_id: {session_id}, role: {role}")
                 return message
 
             except Exception as e:  # pylint: disable=broad-exception-caught

app/routers/chat_stream.py

@@ -234,6 +234,7 @@ async def chat_stream_direct(
        - AI가 사용자의 첫 번째 메시지를 분석하여 의미있는 세션 제목 자동 생성
        - 제목 생성 실패 시 기본 제목("대화 YYYY-MM-DD HH:MM") 사용
     3. **잘못된 세션 ID시**: 새로운 세션을 생성하여 대화 시작 (제목 자동 생성)
+    4. **시간 동기화**: 새로운 세션 생성 시 `created_at`과 `updated_at`이 동일한 시간으로 설정
     
     ## 요청 예시
     ### 새로운 대화 시작 (세션 ID 없음)