feat: subs and views

src/domain/purchase.py

@@ -24,6 +24,15 @@ class InviteLinkType(StrEnum):
     APPROVAL = 'approval'  # с одобрением ботом
 
 
+class PostViewsAvailability(StrEnum):
+    """Статус доступности получения просмотров поста."""
+
+    UNKNOWN = 'unknown'  # Ещё не проверялось
+    AVAILABLE = 'available'  # Просмотры доступны
+    UNAVAILABLE = 'unavailable'  # Нет доступа / битая ссылка / приватный канал
+    MANUAL = 'manual'  # Просмотры вводятся вручную
+
+
 class Purchase(domain.Base):
     # Основные поля
     target_channel_id: Mapped[uuid.UUID] = mapped_column(ForeignKey('targetchannels.id'), index=True)
@@ -44,7 +53,11 @@ class Purchase(domain.Base):
 
     # Метрики (будут обновляться из Telegram API)
     subscriptions_count: Mapped[int] = mapped_column(default=0, server_default='0')
-    views_count: Mapped[int | None]  # просмотры рекламного поста (если доступны)
+    views_count: Mapped[int | None]  # последние известные просмотры (кэш из последнего snapshot)
+
+    # Статус доступности просмотров
+    views_availability: Mapped[PostViewsAvailability] = mapped_column(default=PostViewsAvailability.UNKNOWN)
+    last_views_fetch_at: Mapped[datetime.datetime | None]  # когда последний раз получали просмотры
 
     # Relationships
     target_channel: Mapped['TargetChannel'] = relationship()