refactor: uv migration, clean architecture (#26)

* refactor: uv migration, apply ruff
* refactor: 클린아키텍처 도입

Author: 9keyyyy

.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+  "python.defaultInterpreterPath": "${workspaceFolder}/.venv/bin/python3",
+  "python.analysis.extraPaths": [
+    "${workspaceFolder}/.venv/lib/python3.13/site-packages"
+  ],
+  "python.analysis.typeCheckingMode": "basic"
+}

Dockerfile

@@ -2,15 +2,12 @@ FROM python:3.10
 
 RUN apt-get update && apt-get install -y vim && apt-get install -y less
 
-RUN pip install poetry
-
-# 가상환경 생성하지 않음
-RUN poetry config virtualenvs.create false
+RUN pip install uv
 
 WORKDIR /satto
 
-COPY pyproject.toml poetry.lock ./
+COPY pyproject.toml uv.lock ./
 
-RUN poetry lock && poetry install --no-root
+RUN uv sync --no-install-project --no-dev
 
 COPY ./src /satto/src

docker-compose.dev.yml

@@ -27,7 +27,7 @@ services:
       - ${WRITABLE_DIR}/logs/app:/data/logs/app
     command: >
       sh -c "
-        gunicorn src.main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000
+        uv run gunicorn src.main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:8000
       "
     ports:
       - "8000:8000"

docker-compose.local.yml

@@ -36,7 +36,7 @@ services:
       - ${WRITABLE_DIR}/logs/app:/data/logs/app
     command: >
       sh -c "
-        uvicorn src.main:app --host 0.0.0.0 --port 8000 --reload
+        uv run uvicorn src.main:app --host 0.0.0.0 --port 8000 --reload
       "
     ports:
       - "8000:8000"

poetry.lock

@@ -5,8 +5,7 @@ description = ""
 authors = [
     {name = "Gukhee Jo", email = "[email protected]"}
 ]
-readme = "README.md"
-requires-python = "^3.13"
+requires-python = ">=3.13"
 dependencies = [
     "fastapi (>=0.116.1,<0.117.0)",
     "sqlalchemy (>=2.0.41,<3.0.0)",
@@ -24,9 +23,45 @@ dependencies = [
     "apscheduler (>=3.11.0,<4.0.0)"
 ]
 
-[tool.poetry]
-package-mode = false
-
 [build-system]
-requires = ["poetry-core>=2.0.0,<3.0.0"]
-build-backend = "poetry.core.masonry.api"
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src"]
+
+[dependency-groups]
+dev = [
+    "mypy>=1.19.1",
+    "ruff>=0.14.9",
+]
+
+[tool.ruff]
+target-version = "py313"
+line-length = 80
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "F",   # pyflakes
+    "I",   # isort
+]
+ignore = [
+    "E501",  # line too long (handled by formatter)
+]
+exclude = [
+    ".git",
+    "__pycache__",
+    ".venv",
+    "venv",
+    "migrations",
+    "mysql_data",
+]
+
+[tool.mypy]
+python_version = "3.13"
+strict = false
+warn_unused_configs = true
+disallow_untyped_defs = true
+disallow_any_unimported = false
+warn_return_any = true

pyproject.toml

@@ -1,6 +1,49 @@
-from fastapi import Request
+from fastapi import Depends, Request
 from sqlalchemy.ext.asyncio import AsyncSession
 
+from src.fortune.application.service import FortuneService
+from src.fortune.domain.interfaces import IFortuneRepository
+from src.fortune.infrastructure.repository import FortuneRepository
+from src.lotto.application.service import LottoService
+from src.lotto.domain.interfaces import ILottoRepository
+from src.lotto.infrastructure.repository import LottoRepository
+from src.users.application.service import UserService
+from src.users.domain.interfaces import IUserRepository
+from src.users.infrastructure.repository import UserRepository
+
 
 def get_db_session(request: Request) -> AsyncSession:
+    """DB 세션 의존성 주입 함수"""
     return request.state.db_session
+
+
+def get_lotto_service(
+    session: AsyncSession = Depends(get_db_session),
+) -> LottoService:
+    """로또 서비스 의존성 주입 함수"""
+    lotto_repository: ILottoRepository = LottoRepository(session=session)
+    user_repository: IUserRepository = UserRepository(session=session)
+    return LottoService(
+        lotto_repository=lotto_repository,
+        user_repository=user_repository,
+    )
+
+
+def get_fortune_service(
+    session: AsyncSession = Depends(get_db_session),
+) -> FortuneService:
+    """운세 서비스 의존성 주입 함수"""
+    fortune_repository: IFortuneRepository = FortuneRepository(session=session)
+    user_repository: IUserRepository = UserRepository(session=session)
+    return FortuneService(
+        fortune_repository=fortune_repository,
+        user_repository=user_repository,
+    )
+
+
+def get_user_service(
+    session: AsyncSession = Depends(get_db_session),
+) -> UserService:
+    """사용자 서비스 의존성 주입 함수"""
+    user_repository: IUserRepository = UserRepository(session=session)
+    return UserService(user_repository=user_repository)

src/common/dependencies.py

@@ -1,25 +1,30 @@
 from src.common.logger import logger
 from src.config.config import db_config
 from src.config.database import Mysql
-from src.lotto.repository import LottoRepository
-from src.lotto.service import LottoService
+from src.lotto.application.service import LottoService
+from src.lotto.infrastructure.repository import LottoRepository
+from src.users.infrastructure.repository import UserRepository
 
 
 async def update_next_lotto_draw():
     """다음 회차 로또 데이터를 동행복권 API에서 가져와서 데이터베이스에 저장합니다."""
     db = Mysql(db_config)
-    
+
     try:
         async with db.session() as session:
-            repository = LottoRepository(session)
-            lotto_service = LottoService(repository)
+            lotto_repository = LottoRepository(session)
+            user_repository = UserRepository(session)
+            lotto_service = LottoService(
+                lotto_repository=lotto_repository,
+                user_repository=user_repository,
+            )
             success = await lotto_service.update_next_lotto_draw()
             await session.commit()
             if success:
                 logger.info("로또 데이터 업데이트가 성공적으로 완료되었습니다.")
             else:
                 logger.warning("로또 데이터 업데이트가 실패했습니다.")
-                
+
     except Exception as e:
         logger.error(f"로또 데이터 업데이트 중 오류 발생: {e}")
     finally:

src/common/scheduler/tasks.py

@@ -1,15 +1,16 @@
-# src/fortune/router.py
+# src/fortune/api/router.py
 from datetime import date
 from typing import Optional
 from fastapi import APIRouter, Depends, Query, Path, HTTPException, status
-from src.fortune.entities.schemas import (
+from src.common.dependencies import get_fortune_service
+from src.fortune.api.schemas import (
     DailyFortuneResource,
     DailyFortuneResourceCreate,
     DailyFortuneResourceUpdate,
     DailyFortuneResourceList,
 )
-from src.fortune.service import FortuneService
-from src.fortune.entities.enums import FortuneType
+from src.fortune.application.service import FortuneService
+from src.fortune.domain.entities.enums import FortuneType
 
 fortune_router = APIRouter(prefix="/admin/fortune", tags=["fortune-admin"])
 
@@ -23,7 +24,7 @@ async def list_fortune_resources(
     limit: int = Query(10, ge=1, le=100, description="한 페이지 크기"),
     publish_date: Optional[date] = Query(None, description="발행일 필터"),
     fortune_type: Optional[FortuneType] = Query(None, description="유형 필터"),
-    service: FortuneService = Depends(),
+    service: FortuneService = Depends(get_fortune_service),
 ):
     return await service.list_fortunes(cursor, limit, publish_date, fortune_type)
 
@@ -36,7 +37,7 @@ async def list_fortune_resources(
 )
 async def create_fortune_resource(
     body: DailyFortuneResourceCreate,
-    service: FortuneService = Depends(),
+    service: FortuneService = Depends(get_fortune_service),
 ):
     return await service.create_fortune(body)
 
@@ -49,7 +50,7 @@ async def create_fortune_resource(
 async def update_fortune_resource(
     body: DailyFortuneResourceUpdate,
     resource_id: int = Path(..., description="운세 리소스 ID"),
-    service: FortuneService = Depends(),
+    service: FortuneService = Depends(get_fortune_service),
 ):
     return await service.update_fortune(resource_id, body)
 
@@ -61,7 +62,7 @@ async def update_fortune_resource(
 )
 async def delete_fortune_resource(
     resource_id: int = Path(..., description="운세 리소스 ID"),
-    service: FortuneService = Depends(),
+    service: FortuneService = Depends(get_fortune_service),
 ):
     await service.delete_fortune(resource_id)
     # 204 No Content