feat: subs and views

src/dto/views.py

@@ -0,0 +1,56 @@
+import datetime
+import uuid
+
+import pydantic
+
+from src import domain
+
+
+class ViewsSnapshotOutput(pydantic.BaseModel):
+    """Снимок просмотров."""
+
+    id: uuid.UUID
+    purchase_id: uuid.UUID
+    views_count: int
+    fetched_at: datetime.datetime
+    created_at: datetime.datetime
+
+
+class GetViewsHistoryInput(pydantic.BaseModel):
+    """Получить историю просмотров для закупа."""
+
+    purchase_id: uuid.UUID
+    user_id: uuid.UUID
+    from_date: datetime.datetime | None = None  # Фильтр: с какой даты
+    to_date: datetime.datetime | None = None  # Фильтр: по какую дату
+
+
+class GetViewsHistoryOutput(pydantic.BaseModel):
+    """История просмотров."""
+
+    snapshots: list[ViewsSnapshotOutput]
+
+
+class FetchViewsInput(pydantic.BaseModel):
+    """Запросить обновление просмотров для закупа."""
+
+    purchase_id: uuid.UUID
+    user_id: uuid.UUID
+
+
+class FetchViewsOutput(pydantic.BaseModel):
+    """Результат получения просмотров."""
+
+    purchase_id: uuid.UUID
+    views_count: int | None  # None если не удалось получить
+    views_availability: domain.PostViewsAvailability
+    fetched_at: datetime.datetime
+    error_message: str | None = None  # Сообщение об ошибке если не удалось
+
+
+class UpdateViewsManuallyInput(pydantic.BaseModel):
+    """Ручное обновление просмотров."""
+
+    purchase_id: uuid.UUID
+    user_id: uuid.UUID
+    views_count: int