fix: 로깅 메시지에서 포맷을 f-string 스타일로 변경

app/routers/downloads.py

@@ -92,7 +92,12 @@ def download_document(
     except ValueError as value_error:
         raise HTTPException(status_code=status.HTTP_404_NOT_FOUND, detail=str(value_error)) from value_error
     except Exception as error:  # pylint: disable=broad-except
-        logger.error("Word 문서 생성 실패: project_id=%s / error=%s", project_id, error, exc_info=True)
+        logger.error(
+            "Word 문서 생성 실패: project_id={} / error={}",
+            project_id,
+            error,
+            exc_info=True,
+        )
         raise HTTPException(
             status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
             detail="Word 문서 생성 중 오류가 발생했습니다.",

app/routers/pages.py

@@ -52,7 +52,7 @@ def _create_project_for_upload(db: Session) -> Project:
         ),
         user_id=DEFAULT_USER_ID,
     )
-    logger.info("업로드용 프로젝트 생성 - ProjectID: %s", project.project_id)
+    logger.info("업로드용 프로젝트 생성 - ProjectID: {}", project.project_id)
     return project
 
 
@@ -285,7 +285,12 @@ def save_page_text(
             detail=str(value_error),
         ) from value_error
     except Exception as error:  # pylint: disable=broad-except
-        logger.error("페이지 텍스트 저장 실패: page_id=%s / error=%s", page_id, error, exc_info=True)
+        logger.error(
+            "페이지 텍스트 저장 실패: page_id={} / error={}",
+            page_id,
+            error,
+            exc_info=True,
+        )
         raise HTTPException(
             status_code=status.HTTP_500_INTERNAL_SERVER_ERROR,
             detail="페이지 텍스트 저장 중 오류가 발생했습니다.",

app/services/batch_analysis.py

@@ -285,7 +285,7 @@ def _sync_layout_runtime_fields(
         target = element_map.get(mock.element_id)
         if not target:
             logger.warning(
-                "정렬 결과에 존재하지만 DB에 없는 element_id=%s", mock.element_id
+                "정렬 결과에 존재하지만 DB에 없는 element_id={}", mock.element_id
             )
             continue
 
@@ -341,7 +341,9 @@ async def _process_single_page_async(
     개별 페이지에 대한 전체 파이프라인을 실행하고 결과 요약을 반환합니다.
     """
     logger.info(
-        "페이지 분석 시작: project_id=%s / page_id=%s", project.project_id, page.page_id
+        "페이지 분석 시작: project_id={} / page_id={}",
+        project.project_id,
+        page.page_id,
     )
     page_start = time.time()
 
@@ -401,7 +403,7 @@ async def _process_single_page_async(
                     )
                 except Exception as ai_error:
                     logger.error(
-                        "AI 설명 생성 비동기 처리 실패: page_id=%s / error=%s",
+                        "AI 설명 생성 비동기 처리 실패: page_id={} / error={}",
                         page.page_id,
                         ai_error,
                     )
@@ -517,7 +519,7 @@ async def analyze_project_batch_async(
     """
     프로젝트 내 'pending' 상태 페이지를 순차적으로 분석하고 결과 요약을 반환합니다.
     """
-    logger.info("프로젝트 배치 분석 시작: project_id=%s", project_id)
+    logger.info("프로젝트 배치 분석 시작: project_id={}", project_id)
     started_at = time.time()
 
     project = (
@@ -547,7 +549,7 @@ async def analyze_project_batch_async(
     }
 
     if not pending_pages:
-        logger.warning("분석할 페이지가 없습니다. project_id=%s", project.project_id)
+        logger.warning("분석할 페이지가 없습니다. project_id={}", project.project_id)
         return result_summary
 
     _update_project_status(project, "in_progress")
@@ -593,7 +595,7 @@ async def analyze_project_batch_async(
     result_summary["project_status_after"] = project.status
     result_summary["total_time"] = time.time() - started_at
     logger.info(
-        "프로젝트 배치 분석 종료: project_id=%s / status=%s / success=%s / fail=%s / %.2fs",
+        "프로젝트 배치 분석 종료: project_id={} / status={} / success={} / fail={} / {:.2f}s",
         project.project_id,
         final_status,
         result_summary["successful_pages"],
@@ -654,7 +656,7 @@ async def analyze_project_batch_async_parallel(
         max_concurrent_pages 값을 조정하여 시스템 리소스에 맞게 최적화할 수 있습니다.
     """
     logger.info(
-        "프로젝트 병렬 배치 분석 시작: project_id=%s, max_concurrent=%s",
+        "프로젝트 병렬 배치 분석 시작: project_id={}, max_concurrent={}",
         project_id,
         max_concurrent_pages,
     )
@@ -688,7 +690,7 @@ async def analyze_project_batch_async_parallel(
     }
 
     if not pending_pages:
-        logger.warning("분석할 페이지가 없습니다. project_id=%s", project.project_id)
+        logger.warning("분석할 페이지가 없습니다. project_id={}", project.project_id)
         return result_summary
 
     _update_project_status(project, "in_progress")
@@ -778,7 +780,7 @@ async def analyze_project_batch_async_parallel(
     result_summary["total_time"] = time.time() - started_at
     
     logger.info(
-        "프로젝트 병렬 배치 분석 종료: project_id=%s / status=%s / success=%s / fail=%s / %.2fs",
+        "프로젝트 병렬 배치 분석 종료: project_id={} / status={} / success={} / fail={} / {:.2f}s",
         project.project_id,
         final_status,
         result_summary["successful_pages"],

app/services/sorter_strategies.py

@@ -78,7 +78,7 @@ def _env_float(name: str, default: float) -> float:
         return float(value)
     except ValueError:
         logger.warning(
-            "환경 변수 %s 값 '%s'을(를) float로 변환하지 못했습니다. 기본값 %.2f을 사용합니다.",
+            "환경 변수 {} 값 '{}'을(를) float로 변환하지 못했습니다. 기본값 {:.2f}을 사용합니다.",
             name,
             value,
             default,

app/services/text_version_service.py

@@ -29,7 +29,11 @@ def _deactivate_existing_versions(db: Session, page_id: int) -> None:
         .update({"is_current": False}, synchronize_session=False)
     )
     if updated:
-        logger.debug("페이지 %s의 기존 텍스트 버전 %s건을 비활성화했습니다.", page_id, updated)
+        logger.debug(
+            "페이지 {}의 기존 텍스트 버전 {}건을 비활성화했습니다.",
+            page_id,
+            updated,
+        )
 
 
 def _get_next_version_number(db: Session, page_id: int) -> int:
@@ -77,7 +81,7 @@ def create_text_version(
         db.commit()
 
     logger.info(
-        "텍스트 버전 생성 완료: page_id=%s, version_id=%s, number=%s, type=%s",
+        "텍스트 버전 생성 완료: page_id={}, version_id={}, number={}, type={}",
         page.page_id,
         version.version_id,
         next_number,
@@ -120,7 +124,7 @@ def get_current_page_text(db: Session, page_id: int) -> Optional[Dict[str, Any]]
     )
     if not version:
         logger.warning(
-            "페이지 %s의 현재 텍스트 버전을 찾을 수 없습니다. status=%s",
+            "페이지 {}의 현재 텍스트 버전을 찾을 수 없습니다. status={}",
             page_id,
             page.analysis_status,
         )
@@ -162,7 +166,7 @@ def save_user_edited_version(
     )
     if deleted:
         logger.info(
-            "CombinedResult 캐시 무효화: project_id=%s, 삭제된 레코드=%s",
+            "CombinedResult 캐시 무효화: project_id={}, 삭제된 레코드={}",
             page.project_id,
             deleted,
         )