Динамическое создание er-диаграммы по моделям

library_service/models/dto/user.py

@@ -10,9 +10,17 @@ from sqlmodel import Field, SQLModel
 class UserBase(SQLModel):
     """Базовая модель пользователя"""
 
-    username: str = Field(min_length=3, max_length=50, index=True, unique=True)
-    email: EmailStr = Field(index=True, unique=True)
-    full_name: str | None = Field(default=None, max_length=100)
+    username: str = Field(
+        min_length=3,
+        max_length=50,
+        index=True,
+        unique=True,
+        description="Имя пользователя",
+    )
+    email: EmailStr = Field(index=True, unique=True, description="Email")
+    full_name: str | None = Field(
+        default=None, max_length=100, description="Полное имя"
+    )
 
     model_config = ConfigDict(
         json_schema_extra={
@@ -28,7 +36,7 @@ class UserBase(SQLModel):
 class UserCreate(UserBase):
     """Модель пользователя для создания"""
 
-    password: str = Field(min_length=8, max_length=100)
+    password: str = Field(min_length=8, max_length=100, description="Пароль")
 
     @field_validator("password")
     @classmethod
@@ -46,30 +54,30 @@ class UserCreate(UserBase):
 class UserLogin(SQLModel):
     """Модель аутентификации для пользователя"""
 
-    username: str
-    password: str
+    username: str = Field(description="Имя пользователя")
+    password: str = Field(description="Пароль")
 
 
 class UserRead(UserBase):
     """Модель пользователя для чтения"""
 
     id: int
-    is_active: bool
-    is_verified: bool
-    is_2fa_enabled: bool
-    roles: List[str] = []
+    is_active: bool = Field(description="Не является ли заблокированым")
+    is_verified: bool = Field(description="Является ли верифицированым")
+    is_2fa_enabled: bool = Field(description="Включен ли TOTP 2FA")
+    roles: List[str] = Field([], description="Роли")
 
 
 class UserUpdate(SQLModel):
     """Модель пользователя для обновления"""
 
-    email: EmailStr | None = None
-    full_name: str | None = None
-    password: str | None = None
+    email: EmailStr | None = Field(None, description="Email")
+    full_name: str | None = Field(None, description="Полное имя")
+    password: str | None = Field(None, description="Пароль")
 
 
 class UserList(SQLModel):
     """Список пользователей"""
 
-    users: List[UserRead]
-    total: int
+    users: List[UserRead] = Field(description="Список пользователей")
+    total: int = Field(description="Количество пользователей")