feat: 3.3-5 Описать модели

app/models/__init__.py

@@ -0,0 +1,5 @@
+from app.models.audit_event import AuditEvent
+from app.models.oauth_client import OAuthClient
+from app.models.user import User
+
+__all__ = ["AuditEvent", "OAuthClient", "User"]

app/models/audit_event.py

@@ -0,0 +1,35 @@
+from datetime import datetime
+from typing import Any
+
+from sqlalchemy import JSON, DateTime, ForeignKey, String
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.db.base import Base
+from app.models.user import utcnow
+
+
+class AuditEvent(Base):
+    __tablename__ = "audit_events"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+
+    # строковый тип события (индексируется);
+    event_type: Mapped[str] = mapped_column(String(100), index=True)
+
+    # внешний ключ на `users.id`, может быть NULL для анонимных событий;
+    actor_id: Mapped[int | None] = mapped_column(ForeignKey("users.id"), nullable=True)
+
+    # строковый идентификатор клиента (если применимо);
+    client_id: Mapped[str | None] = mapped_column(String(64), nullable=True)
+
+    # откуда пришло событие;
+    ip: Mapped[str | None] = mapped_column(String(45), nullable=True)
+    user_agent: Mapped[str | None] = mapped_column(String(512), nullable=True)
+
+    # JSON-поле для произвольных данных;
+    metadata_json: Mapped[dict[str, Any] | None] = mapped_column(JSON, nullable=True)
+
+    # created_at
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), default=utcnow
+    )

app/models/oauth_client.py

@@ -0,0 +1,31 @@
+from datetime import datetime
+
+from sqlalchemy import Boolean, DateTime, JSON, String
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.db.base import Base
+from app.models.user import utcnow
+
+
+class OAuthClient(Base):
+    __tablename__ = "oauth_clients"
+
+    # id
+    id: Mapped[int] = mapped_column(primary_key=True)
+
+    # уникальный строковый идентификатор;
+    client_id: Mapped[str] = mapped_column(String(64), unique=True, index=True)
+
+    # читаемое имя приложения;
+    name: Mapped[str] = mapped_column(String(255))
+
+    # флаг «конфиденциальный / публичный клиент»;
+    is_confidential: Mapped[bool] = mapped_column(Boolean, default=True)
+
+    # список разрешённых URL (JSON-поле);
+    redirect_uris: Mapped[list[str]] = mapped_column(JSON, default=list)
+
+    # created_at
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), default=utcnow
+    )

app/models/user.py

@@ -0,0 +1,32 @@
+from datetime import datetime, timezone
+
+from sqlalchemy import Boolean, DateTime, String
+from sqlalchemy.orm import Mapped, mapped_column
+
+from app.db.base import Base
+
+
+def utcnow() -> datetime:
+    return datetime.now(timezone.utc)
+
+
+class User(Base):
+    __tablename__ = "users"
+
+    # первичный ключ, автоинкремент;
+    id: Mapped[int] = mapped_column(primary_key=True)
+
+    # уникальное, индексируемое поле;
+    email: Mapped[str] = mapped_column(String(255), unique=True, index=True)
+
+    # строка;
+    hashed_password: Mapped[str] = mapped_column(String(255))
+
+    #  булевы флаги;
+    is_active: Mapped[bool] = mapped_column(Boolean, default=True)
+    is_admin: Mapped[bool] = mapped_column(Boolean, default=False)
+
+    # дата-время создания записи.
+    created_at: Mapped[datetime] = mapped_column(
+        DateTime(timezone=True), default=utcnow
+    )