Добавление выдач

library_service/models/__init__.py

@@ -1,3 +1,4 @@
 """Модуль моделей"""
 from .db import *
 from .dto import *
+from .enums import *

library_service/models/db/book.py

@@ -5,6 +5,7 @@ from sqlmodel import Field, Relationship
 
 from library_service.models.dto.book import BookBase
 from library_service.models.db.links import AuthorBookLink, GenreBookLink
+from library_service.models.enums import BookStatus
 
 if TYPE_CHECKING:
     from .author import Author
@@ -14,9 +15,11 @@ if TYPE_CHECKING:
 class Book(BookBase, table=True):
     """Модель книги в базе данных"""
     id: int | None = Field(default=None, primary_key=True, index=True)
+    status: BookStatus = Field(default=BookStatus.ACTIVE)
     authors: List["Author"] = Relationship(
         back_populates="books", link_model=AuthorBookLink
     )
     genres: List["Genre"] = Relationship(
         back_populates="books", link_model=GenreBookLink
     )
+    loans: List["BookUserLink"] = Relationship(sa_relationship_kwargs={"cascade": "all, delete"})

library_service/models/db/links.py

@@ -1,4 +1,5 @@
 """Модуль связей между сущностями в БД"""
+from datetime import datetime
 from sqlmodel import SQLModel, Field
 
 
@@ -22,3 +23,20 @@ class UserRoleLink(SQLModel, table=True):
 
     user_id: int | None = Field(default=None, foreign_key="users.id", primary_key=True)
     role_id: int | None = Field(default=None, foreign_key="roles.id", primary_key=True)
+
+
+class BookUserLink(SQLModel, table=True):
+    """
+    Модель истории выдачи книг (Loan).
+    Связывает книгу и пользователя с фиксацией времени.
+    """
+    __tablename__ = "book_loans"
+
+    id: int | None = Field(default=None, primary_key=True, index=True)
+    
+    book_id: int = Field(foreign_key="book.id")
+    user_id: int = Field(foreign_key="users.id")
+    
+    borrowed_at: datetime = Field(default_factory=datetime.utcnow)
+    due_date: datetime
+    returned_at: datetime | None = Field(default=None)

library_service/models/db/user.py

@@ -26,3 +26,4 @@ class User(UserBase, table=True):
 
     # Связи
     roles: List["Role"] = Relationship(back_populates="users", link_model=UserRoleLink)
+    loans: List["BookUserLink"] = Relationship(sa_relationship_kwargs={"cascade": "all, delete"})

library_service/models/dto/__init__.py

@@ -4,9 +4,10 @@ from .genre import GenreBase, GenreCreate, GenreList, GenreRead, GenreUpdate
 from .book import BookBase, BookCreate, BookList, BookRead, BookUpdate
 from .role import RoleBase, RoleCreate, RoleList, RoleRead, RoleUpdate
 from .user import UserBase, UserCreate, UserList, UserRead, UserUpdate, UserLogin
+from .loan import LoanBase, LoanCreate, LoanList, LoanRead, LoanUpdate
 from .token import Token, TokenData
 from .combined import (AuthorWithBooks, GenreWithBooks, BookWithAuthors, BookWithGenres,
-    BookWithAuthorsAndGenres, BookFilteredList)
+    BookWithAuthorsAndGenres, BookFilteredList, BookStatusUpdate, LoanWithBook)
 
 __all__ = [
     "AuthorBase",
@@ -20,11 +21,24 @@ __all__ = [
     "BookRead",
     "BookList",
     "BookFilteredList",
+    "BookStatusUpdate",
     "GenreBase",
     "GenreCreate",
     "GenreUpdate",
     "GenreRead",
     "GenreList",
+    "LoanBase",
+    "LoanCreate",
+    "LoanUpdate",
+    "LoanRead",
+    "LoanList",
+    "LoanWithBook",
+    "UserBase",
+    "UserCreate",
+    "UserUpdate",
+    "UserRead",
+    "UserList",
+    "UserLogin",
     "RoleBase",
     "RoleCreate",
     "RoleUpdate",
@@ -32,10 +46,4 @@ __all__ = [
     "RoleList",
     "Token",
     "TokenData",
-    "UserBase",
-    "UserCreate",
-    "UserRead",
-    "UserUpdate",
-    "UserList",
-    "UserLogin",
 ]

library_service/models/dto/book.py

@@ -1,11 +1,10 @@
 """Модуль DTO-моделей книг"""
-from typing import List, TYPE_CHECKING
+from typing import List
 
 from pydantic import ConfigDict
 from sqlmodel import SQLModel
 
-if TYPE_CHECKING:
-    from .combined import BookWithAuthorsAndGenres
+from library_service.models.enums import BookStatus
 
 
 class BookBase(SQLModel):
@@ -29,11 +28,13 @@ class BookUpdate(SQLModel):
     """Модель книги для обновления"""
     title: str | None = None
     description: str | None = None
+    status: BookStatus | None = None
 
 
 class BookRead(BookBase):
     """Модель книги для чтения"""
     id: int
+    status: BookStatus
 
 
 class BookList(SQLModel):

library_service/models/dto/combined.py

@@ -5,6 +5,7 @@ from sqlmodel import SQLModel, Field
 from .author import AuthorRead
 from .genre import GenreRead
 from .book import BookRead
+from .loan import LoanRead
 
 
 class AuthorWithBooks(SQLModel):
@@ -50,3 +51,11 @@ class BookFilteredList(SQLModel):
     """Список книг с фильтрацией"""
     books: List[BookWithAuthorsAndGenres]
     total: int
+
+class LoanWithBook(LoanRead):
+    """Модель выдачи, включающая данные о книге"""
+    book: BookRead
+    
+class BookStatusUpdate(SQLModel):
+    """Модель для ручного изменения статуса библиотекарем"""
+    status: str

library_service/models/dto/loan.py

@@ -0,0 +1,35 @@
+"""Модуль DTO-моделей для выдачи книг"""
+from typing import List
+
+from datetime import datetime
+from sqlmodel import SQLModel
+
+
+class LoanBase(SQLModel):
+    """Базовая модель выдачи"""
+    book_id: int
+    user_id: int
+    due_date: datetime
+
+
+class LoanCreate(LoanBase):
+    """Модель для создания записи о выдаче"""
+    pass
+
+
+class LoanUpdate(SQLModel):
+    """Модель для обновления записи о выдаче"""
+    returned_at: datetime | None = None
+
+
+class LoanRead(LoanBase):
+    """Модель чтения записи о выдаче"""
+    id: int
+    borrowed_at: datetime
+    returned_at: datetime | None = None
+
+
+class LoanList(SQLModel):
+    """Список выдач"""
+    loans: List[LoanRead]
+    total: int

library_service/models/enums.py

@@ -0,0 +1,10 @@
+"""Модуль перечислений (Enums)"""
+from enum import Enum
+
+class BookStatus(str, Enum):
+    """Статусы книги"""
+    ACTIVE = "active"           
+    BORROWED = "borrowed"       
+    RESERVED = "reserved"       
+    RESTORATION = "restoration" 
+    WRITTEN_OFF = "written_off" 

library_service/routers/auth.py

@@ -250,4 +250,4 @@ def get_roles(
     return RoleList(
         roles=[RoleRead(**role.model_dump()) for role in roles],
         total=len(roles),
-    )
+    )