feat: добавлен сервис управления пользователями

- Создан файл services.py в директории lkeep/apps/auth.
- Определен класс UserService для управления пользователями.
- Реализован метод register_user для регистрации нового пользователя.
- Использованы зависимости UserManager и AuthHandler.
- Добавлены необходимые импорты из модулей schemas, managers и handlers.

lkeep/apps/__init__.py

@@ -5,3 +5,11 @@
 Специально для проекта "Код на салфетке"
 https://pressanybutton.ru/category/servis-na-fastapi/
 """
+
+from fastapi import APIRouter
+
+from lkeep.apps.auth.routes import auth_router
+
+apps_router = APIRouter(prefix="/api/v1")
+
+apps_router.include_router(router=auth_router)

lkeep/apps/auth/managers.py

@@ -20,7 +20,7 @@ class UserManager:
     Класс для управления пользователями.
     """
 
-    def __init__(self, model: type[User] = User, db: DBDependency = Depends(DBDependency)) -> None:
+    def __init__(self, db: DBDependency = Depends(DBDependency)) -> None:
         """
         Инициализирует экземпляр класса.
 
@@ -30,7 +30,7 @@ class UserManager:
         :type db: DBDependency
         """
         self.db = db
-        self.model = model
+        self.model = User
 
     async def create_user(self, user: CreateUser) -> UserReturnData:
         """

lkeep/apps/auth/routes.py

@@ -0,0 +1,31 @@
+"""
+Проект: Lkeep
+Автор: Иван Ашихмин
+Год: 2025
+Специально для проекта "Код на салфетке"
+https://pressanybutton.ru/category/servis-na-fastapi/
+"""
+
+from fastapi import APIRouter, Depends
+from starlette import status
+
+from lkeep.apps.auth.schemas import RegisterUser, UserReturnData
+from lkeep.apps.auth.services import UserService
+
+auth_router = APIRouter(prefix="/auth", tags=["auth"])
+
+
+@auth_router.post(path="/register", status_code=status.HTTP_201_CREATED)
+async def registration(user: RegisterUser, service: UserService = Depends(UserService)) -> UserReturnData:
+    """
+    Регистрация нового пользователя.
+
+    :param user: Данные нового пользователя, который нужно зарегистрировать.
+    :type user: RegisterUser
+    :param service: Сервис для взаимодействия с пользователями.
+    :type service: UserService
+    :returns: Данные зарегистрированного пользователя.
+    :rtype: UserReturnData
+    :raises HTTPException 400: Если данные пользователя некорректны.
+    """
+    return await service.register_user(user=user)

lkeep/apps/auth/services.py

@@ -0,0 +1,48 @@
+"""
+Проект: Lkeep
+Автор: Иван Ашихмин
+Год: 2025
+Специально для проекта "Код на салфетке"
+https://pressanybutton.ru/category/servis-na-fastapi/
+"""
+
+from fastapi import Depends
+
+from lkeep.apps.auth.handlers import AuthHandler
+from lkeep.apps.auth.managers import UserManager
+from lkeep.apps.auth.schemas import CreateUser, RegisterUser, UserReturnData
+
+
+class UserService:
+    """
+    Класс для управления пользователями.
+    """
+
+    def __init__(
+        self, manager: UserManager = Depends(UserManager), handler: AuthHandler = Depends(AuthHandler)
+    ) -> None:
+        """
+        Инициализирует экземпляр класса, используя зависимости для управления пользователями и авторизации.
+
+        :param manager: Управитель пользователей, отвечающий за CRUD-операции над пользователями.
+        :type manager: UserManager
+        :param handler: Обработчик аутентификации и авторизации, который используется для проверки доступа к ресурсам.
+        :type handler: AuthHandler
+        """
+        self.manager = manager
+        self.handler = handler
+
+    async def register_user(self, user: RegisterUser) -> UserReturnData:
+        """
+        Регистрирует нового пользователя в системе.
+
+        :param user: Данные для регистрации пользователя.
+        :type user: RegisterUser
+        :return: Данные зарегистрированного пользователя.
+        :rtype: UserReturnData
+        """
+        hashed_password = await self.handler.get_password_hash(user.password)
+
+        new_user = CreateUser(email=user.email, hashed_password=hashed_password)
+
+        return await self.manager.create_user(user=new_user)

lkeep/main.py

@@ -9,8 +9,12 @@ https://pressanybutton.ru/category/servis-na-fastapi/
 import uvicorn
 from fastapi import FastAPI
 
+from lkeep.apps import apps_router
+
 app = FastAPI()
 
+app.include_router(router=apps_router)
+
 
 def start():
     uvicorn.run(app="lkeep.main:app", reload=True)