461 lines
18 KiB
Python
461 lines
18 KiB
Python
import datetime
|
|
import typing
|
|
from dataclasses import dataclass
|
|
from uuid import UUID
|
|
|
|
if typing.TYPE_CHECKING:
|
|
from aiogram.types import InlineKeyboardButton
|
|
|
|
from src import domain
|
|
|
|
from .analytics.get_channel_analytics import get_channel_analytics
|
|
from .analytics.get_creatives_analytics import get_creatives_analytics
|
|
from .analytics.get_overview_analytics import get_overview_analytics
|
|
from .analytics.get_placements_analytics import get_placements_analytics
|
|
from .analytics.get_spending_analytics import get_spending_analytics
|
|
from .auth.create_telegram_login_token import create_telegram_login_token
|
|
from .auth.get_jwt_by_telegram_id import get_jwt_by_telegram_id
|
|
from .auth.get_me import get_me
|
|
from .auth.validate_login_token import validate_login_token
|
|
from .channel.attach_channel_to_workspace import attach_channel_to_workspace
|
|
from .channel.get_channel import get_channel
|
|
from .channel.get_channels import get_channels
|
|
from .creative.create_creative import create_creative
|
|
from .creative.delete_creative import delete_creative
|
|
from .creative.get_creative import get_creative
|
|
from .creative.get_creatives import get_creatives
|
|
from .creative.update_creative import update_creative
|
|
from .placement.fetch_placement_post_cycle import fetch_placement_post_cycle
|
|
from .placement.get_placement import get_placement
|
|
from .placement.get_placements import get_placements
|
|
from .project.archive_project import archive_project
|
|
from .project.delete_project import delete_project
|
|
from .project.disconnect_project_by_tg_id import disconnect_project_by_tg_id
|
|
from .project.get_project import get_project
|
|
from .project.get_workspace_projects import get_workspace_projects
|
|
from .project.tg_add_project import tg_add_project
|
|
from .project.update_project_invite_link_type import update_project_invite_link_type
|
|
from .project.update_project_permissions import update_project_permissions
|
|
from .purchase.create_purchase import create_purchase
|
|
from .purchase.get_purchase import get_purchase
|
|
from .purchase.get_purchases import get_purchases
|
|
from .subscription.handle_subscription import handle_subscription
|
|
from .subscription.handle_unsubscription import handle_unsubscription
|
|
from .views.get_views_history import get_views_history
|
|
from .workspace.accept_workspace_invite import accept_workspace_invite
|
|
from .workspace.create_workspace import create_workspace
|
|
from .workspace.create_workspace_invite import create_workspace_invite
|
|
from .workspace.delete_workspace import delete_workspace
|
|
from .workspace.get_workspace_invites import get_workspace_invites
|
|
from .workspace.get_workspace_members import get_workspace_members
|
|
from .workspace.get_workspaces import get_workspaces
|
|
from .workspace.tg_accept_workspace_invite import tg_accept_workspace_invite
|
|
from .workspace.update_workspace import update_workspace
|
|
from .workspace.update_workspace_member_permissions import update_workspace_member_permissions
|
|
|
|
|
|
class Database(typing.Protocol):
|
|
def transaction(self) -> typing.AsyncContextManager[None]: ...
|
|
|
|
async def get_user(
|
|
self,
|
|
user_id: UUID | None = None,
|
|
telegram_id: int | None = None,
|
|
) -> domain.User | None: ...
|
|
|
|
async def get_user_by_username(self, username: str) -> domain.User | None: ...
|
|
|
|
async def create_user(self, user: domain.User) -> None: ...
|
|
|
|
async def get_telegram_user(
|
|
self,
|
|
telegram_user_id: UUID | None = None,
|
|
telegram_id: int | None = None,
|
|
) -> domain.TelegramUser | None: ...
|
|
|
|
async def create_telegram_user(self, telegram_user: domain.TelegramUser) -> None: ...
|
|
|
|
async def update_telegram_user(self, telegram_user: domain.TelegramUser) -> None: ...
|
|
|
|
async def create_workspace(self, workspace: domain.Workspace) -> None: ...
|
|
|
|
async def update_workspace(self, workspace: domain.Workspace) -> None: ...
|
|
|
|
async def delete_workspace(self, workspace_id: UUID) -> None: ...
|
|
|
|
async def add_user_to_workspace(self, workspace_id: UUID, user_id: UUID) -> domain.WorkspaceUser: ...
|
|
|
|
async def set_workspace_user_permissions(
|
|
self,
|
|
workspace_user_id: UUID,
|
|
global_permissions: set[domain.PermissionKey],
|
|
scoped_permissions: list[tuple[domain.PermissionKey, domain.PermissionScopeType, UUID]],
|
|
) -> None: ...
|
|
|
|
async def update_workspace_user(self, workspace_user: domain.WorkspaceUser) -> None: ...
|
|
|
|
async def get_user_workspaces(self, user_id: UUID) -> list[domain.WorkspaceUser]: ...
|
|
|
|
async def get_workspace(self, workspace_id: UUID) -> domain.Workspace | None: ...
|
|
|
|
async def get_workspace_for_user(self, workspace_id: UUID, user_id: UUID) -> domain.Workspace | None: ...
|
|
|
|
async def get_default_workspace_for_user(self, user_id: UUID) -> domain.Workspace | None: ...
|
|
|
|
async def get_workspace_membership(self, workspace_id: UUID, user_id: UUID) -> domain.WorkspaceUser | None: ...
|
|
|
|
async def get_workspace_members(self, workspace_id: UUID) -> list[domain.WorkspaceUser]: ...
|
|
|
|
async def get_workspace_member(self, workspace_user_id: UUID) -> domain.WorkspaceUser | None: ...
|
|
|
|
async def create_workspace_invite(self, invite: domain.WorkspaceInvite) -> None: ...
|
|
|
|
async def update_workspace_invite(self, invite: domain.WorkspaceInvite) -> None: ...
|
|
|
|
async def get_workspace_invite(self, invite_id: UUID) -> domain.WorkspaceInvite | None: ...
|
|
|
|
async def get_workspace_invite_by_user(
|
|
self, workspace_id: UUID, user_id: UUID
|
|
) -> domain.WorkspaceInvite | None: ...
|
|
|
|
async def get_workspace_invites(self, workspace_id: UUID) -> list[domain.WorkspaceInvite]: ...
|
|
|
|
async def create_login_token(self, login_token: domain.LoginToken) -> None: ...
|
|
|
|
async def create_creative(self, creative: domain.Creative) -> None: ...
|
|
|
|
async def get_login_token(self, token: str) -> domain.LoginToken | None: ...
|
|
|
|
async def mark_token_as_used(self, token: str) -> None: ...
|
|
|
|
async def update_user(self, user: domain.User) -> None: ...
|
|
|
|
async def get_channel(
|
|
self,
|
|
channel_id: UUID | None = None,
|
|
telegram_id: int | None = None,
|
|
username: str | None = None,
|
|
) -> domain.Channel | None: ...
|
|
|
|
async def create_channel(self, channel: domain.Channel) -> None: ...
|
|
|
|
async def update_channel(self, channel: domain.Channel) -> None: ...
|
|
|
|
async def delete_channel(self, channel_id: UUID) -> None: ...
|
|
|
|
async def search_channels(self, username_query: str | None = None) -> list[domain.Channel]: ...
|
|
|
|
async def get_project(
|
|
self, workspace_id: UUID, project_id: UUID | None = None, channel_id: UUID | None = None
|
|
) -> domain.Project | None: ...
|
|
|
|
async def get_project_for_user_by_telegram(
|
|
self, user_id: UUID, channel_telegram_id: int
|
|
) -> domain.Project | None: ...
|
|
|
|
async def get_project_by_channel_telegram(self, channel_telegram_id: int) -> domain.Project | None: ...
|
|
|
|
async def create_project(self, project: domain.Project) -> None: ...
|
|
|
|
async def update_project(self, project: domain.Project) -> None: ...
|
|
|
|
async def get_workspace_projects(
|
|
self, workspace_id: UUID, allowed_project_ids: set[UUID] | None = None, include_archived: bool = False
|
|
) -> list[domain.Project]: ...
|
|
|
|
async def archive_project(self, workspace_id: UUID, project_id: UUID) -> None: ...
|
|
|
|
async def delete_project(self, workspace_id: UUID, project_id: UUID) -> None: ...
|
|
|
|
async def get_active_purchase(self, project_id: UUID, creative_id: UUID) -> domain.Purchase | None: ...
|
|
|
|
async def get_purchase(self, workspace_id: UUID, purchase_id: UUID) -> domain.Purchase | None: ...
|
|
|
|
async def get_project_purchases(self, workspace_id: UUID, project_id: UUID) -> list[domain.Purchase]: ...
|
|
|
|
async def create_purchase(self, purchase: domain.Purchase) -> None: ...
|
|
|
|
async def get_purchase_channels(self, purchase_id: UUID) -> list[domain.PurchaseChannel]: ...
|
|
|
|
async def get_purchase_channel(
|
|
self, purchase_channel_id: UUID, purchase_id: UUID
|
|
) -> domain.PurchaseChannel | None: ...
|
|
|
|
async def get_purchase_channel_by_id(self, purchase_channel_id: UUID) -> domain.PurchaseChannel | None: ...
|
|
|
|
async def get_purchase_channels_by_project(self, project_id: UUID) -> list[domain.PurchaseChannel]: ...
|
|
|
|
async def add_channel_to_purchase(
|
|
self,
|
|
purchase_id: UUID,
|
|
channel_id: UUID,
|
|
invite_link: str,
|
|
invite_link_type: domain.purchase.InviteLinkType,
|
|
*,
|
|
status: domain.PurchaseChannelStatus | None = None,
|
|
comment: str | None = None,
|
|
placement_at: datetime.datetime | None = None,
|
|
cost_type: domain.purchase.CostType | None = None,
|
|
cost_value: float | None = None,
|
|
cost_before_bargain: float | None = None,
|
|
format: str | None = None,
|
|
) -> domain.PurchaseChannel: ...
|
|
|
|
async def update_purchase_channel(self, purchase_channel: domain.PurchaseChannel) -> None: ...
|
|
|
|
async def remove_channel_from_purchase(self, purchase_id: UUID, channel_id: UUID) -> None: ...
|
|
|
|
async def get_creative(self, workspace_id: UUID, creative_id: UUID) -> domain.Creative | None: ...
|
|
|
|
async def update_creative(self, creative: domain.Creative) -> None: ...
|
|
|
|
async def get_workspace_creatives(
|
|
self,
|
|
workspace_id: UUID,
|
|
project_id: UUID | None = None,
|
|
include_archived: bool = False,
|
|
allowed_project_ids: set[UUID] | None = None,
|
|
) -> list[domain.Creative]: ...
|
|
|
|
async def delete_creative(self, creative_id: UUID) -> None: ...
|
|
|
|
async def get_placement(self, workspace_id: UUID, placement_id: UUID) -> domain.Placement | None: ...
|
|
|
|
async def get_workspace_placements(
|
|
self,
|
|
workspace_id: UUID,
|
|
project_id: UUID | None = None,
|
|
placement_channel_id: UUID | None = None,
|
|
creative_id: UUID | None = None,
|
|
include_archived: bool = False,
|
|
allowed_project_ids: set[UUID] | None = None,
|
|
date_from: datetime.datetime | None = None,
|
|
date_to: datetime.datetime | None = None,
|
|
) -> list[domain.Placement]: ...
|
|
|
|
async def create_placement(self, placement: domain.Placement) -> None: ...
|
|
|
|
async def update_placement(self, placement: domain.Placement) -> None: ...
|
|
|
|
async def delete_placement(self, placement_id: UUID) -> None: ...
|
|
|
|
async def get_placement_by_invite_link(self, invite_link: str) -> domain.Placement | None: ...
|
|
|
|
async def create_subscription(self, subscription: domain.Subscription) -> None: ...
|
|
|
|
async def get_subscription_by_subscriber_and_placement(
|
|
self, telegram_user_id: UUID, placement_id: UUID
|
|
) -> domain.Subscription | None: ...
|
|
|
|
async def update_subscription(self, subscription: domain.Subscription) -> None: ...
|
|
|
|
async def get_subscriptions_for_placements(
|
|
self,
|
|
placement_ids: list[UUID],
|
|
*,
|
|
date_from: datetime.datetime | None = None,
|
|
date_to: datetime.datetime | None = None,
|
|
) -> list[domain.Subscription]: ...
|
|
|
|
async def get_active_subscriptions_by_subscriber_and_project(
|
|
self, telegram_user_id: UUID, project_id: UUID
|
|
) -> list[domain.Subscription]: ...
|
|
|
|
async def get_active_subscription_by_subscriber_and_project(
|
|
self, telegram_user_id: UUID, project_id: UUID
|
|
) -> domain.Subscription | None: ...
|
|
|
|
# Count methods
|
|
async def count_placements_by_creative(self, creative_id: UUID) -> int: ...
|
|
|
|
async def count_subscriptions_by_placement(self, placement_id: UUID) -> int: ...
|
|
|
|
async def count_placements_by_creative_batch(self, creative_ids: list[UUID]) -> dict[UUID, int]: ...
|
|
|
|
async def count_subscriptions_by_placement_batch(self, placement_ids: list[UUID]) -> dict[UUID, int]: ...
|
|
|
|
async def has_placements_for_creative(self, creative_id: UUID) -> bool: ...
|
|
|
|
# Post methods
|
|
async def create_post(self, post: domain.Post) -> None: ...
|
|
|
|
async def get_post(self, post_id: UUID) -> domain.Post | None: ...
|
|
|
|
async def get_post_by_channel_and_message(self, channel_id: UUID, message_id: int) -> domain.Post | None: ...
|
|
|
|
# Post views history
|
|
async def create_post_views_history(self, history: domain.PostViewsHistory) -> None: ...
|
|
|
|
async def get_views_history(
|
|
self,
|
|
post_id: UUID,
|
|
*,
|
|
from_date: datetime.datetime | None = None,
|
|
to_date: datetime.datetime | None = None,
|
|
) -> list[domain.PostViewsHistory]: ...
|
|
|
|
async def get_latest_views_data(self, post_id: UUID) -> tuple[int, datetime.datetime] | None: ...
|
|
|
|
async def get_latest_views_data_batch(self, post_ids: list[UUID]) -> dict[UUID, tuple[int, datetime.datetime]]: ...
|
|
|
|
|
|
class TelegramBotWriter(typing.Protocol):
|
|
async def send_message(self, text: str, chat_id: int) -> None: ...
|
|
|
|
async def send_message_with_button(self, text: str, chat_id: int, button_text: str, button_url: str) -> None: ...
|
|
|
|
async def send_message_with_inline_keyboard(
|
|
self, text: str, chat_id: int, buttons: list[list['InlineKeyboardButton']]
|
|
) -> None: ...
|
|
|
|
async def edit_message_reply_markup(self, chat_id: int, message_id: int) -> None: ...
|
|
|
|
async def create_chat_invite_link(self, chat_id: int, requires_approval: bool = False) -> str: ...
|
|
|
|
|
|
class JWTEncoder(typing.Protocol):
|
|
def encode_access_token(self, user_id: UUID, telegram_id: int, username: str | None = None) -> str: ...
|
|
|
|
|
|
class FetchChannelResponse(typing.Protocol):
|
|
telegram_id: int
|
|
username: str
|
|
title: str
|
|
|
|
|
|
class Parser(typing.Protocol):
|
|
async def fetch_telegram_channel(self, username: str) -> FetchChannelResponse | None: ...
|
|
|
|
|
|
class S3Storage(typing.Protocol):
|
|
async def connect(self) -> None: ...
|
|
|
|
async def close(self) -> None: ...
|
|
|
|
async def upload(self, key: str, data: bytes, content_type: str) -> None: ...
|
|
|
|
async def get(self, key: str) -> bytes: ...
|
|
|
|
async def delete(self, key: str) -> None: ...
|
|
|
|
|
|
@dataclass
|
|
class Usecase:
|
|
database: Database
|
|
telegram_bot: TelegramBotWriter
|
|
jwt_encoder: JWTEncoder
|
|
parser: Parser
|
|
s3: S3Storage
|
|
|
|
async def ensure_workspace_access(self, workspace_id: UUID, user_id: UUID) -> domain.Workspace:
|
|
workspace = await self.database.get_workspace_for_user(workspace_id, user_id)
|
|
if not workspace:
|
|
raise domain.WorkspaceNotFound(workspace_id)
|
|
|
|
return workspace
|
|
|
|
async def ensure_workspace_permission(
|
|
self,
|
|
workspace_id: UUID,
|
|
user_id: UUID,
|
|
permission: domain.PermissionKey,
|
|
*,
|
|
for_project_id: UUID | None = None,
|
|
) -> domain.WorkspacePermissionContext:
|
|
membership = await self.database.get_workspace_membership(workspace_id, user_id)
|
|
if not membership or not membership.workspace:
|
|
raise domain.WorkspaceNotFound(workspace_id)
|
|
|
|
permissions = domain.WorkspacePermissions.from_membership(membership)
|
|
|
|
if for_project_id is not None:
|
|
has_permission = permissions.has_permission(
|
|
permission,
|
|
scope_type=domain.PermissionScopeType.PROJECT,
|
|
scope_id=for_project_id,
|
|
)
|
|
else:
|
|
has_permission = permissions.has_any(permission)
|
|
|
|
if not has_permission:
|
|
raise domain.WorkspaceAccessDenied(workspace_id)
|
|
|
|
return domain.build_workspace_permission_context(membership)
|
|
|
|
async def get_or_create_personal_workspace(self, user: domain.User) -> domain.Workspace:
|
|
workspace = await self.database.get_default_workspace_for_user(user.id)
|
|
if workspace:
|
|
return workspace
|
|
|
|
if not user.telegram_user:
|
|
raise domain.UserNotFound(user.id)
|
|
|
|
telegram_user = user.telegram_user
|
|
workspace_name = telegram_user.username or f'Workspace {telegram_user.telegram_id}'
|
|
workspace = domain.Workspace(name=workspace_name)
|
|
|
|
async with self.database.transaction():
|
|
await self.database.create_workspace(workspace)
|
|
membership = await self.database.add_user_to_workspace(workspace.id, user.id)
|
|
await self.database.set_workspace_user_permissions(
|
|
membership.id,
|
|
global_permissions={domain.PermissionKey.ADMIN_FULL},
|
|
scoped_permissions=[],
|
|
)
|
|
|
|
return workspace
|
|
|
|
async def ensure_active_purchase(self, project: domain.Project, creative: domain.Creative) -> domain.Purchase:
|
|
purchase = await self.database.get_active_purchase(project.id, creative.id)
|
|
if purchase:
|
|
return purchase
|
|
|
|
purchase = domain.Purchase(project_id=project.id, creative_id=creative.id)
|
|
await self.database.create_purchase(purchase)
|
|
return purchase
|
|
|
|
validate_login_token = validate_login_token
|
|
create_telegram_login_token = create_telegram_login_token
|
|
get_jwt_by_telegram_id = get_jwt_by_telegram_id
|
|
get_me = get_me
|
|
tg_add_project = tg_add_project
|
|
get_workspace_projects = get_workspace_projects
|
|
get_project = get_project
|
|
archive_project = archive_project
|
|
delete_project = delete_project
|
|
disconnect_project_by_tg_id = disconnect_project_by_tg_id
|
|
update_project_permissions = update_project_permissions
|
|
update_project_invite_link_type = update_project_invite_link_type
|
|
get_channels = get_channels
|
|
get_channel = get_channel
|
|
attach_channel_to_workspace = attach_channel_to_workspace
|
|
create_purchase = create_purchase
|
|
get_purchases = get_purchases
|
|
get_purchase = get_purchase
|
|
get_creatives = get_creatives
|
|
get_creative = get_creative
|
|
create_creative = create_creative
|
|
update_creative = update_creative
|
|
delete_creative = delete_creative
|
|
get_placements = get_placements
|
|
get_placement = get_placement
|
|
fetch_placement_post_cycle = fetch_placement_post_cycle
|
|
handle_subscription = handle_subscription
|
|
handle_unsubscription = handle_unsubscription
|
|
get_views_history = get_views_history
|
|
get_placements_analytics = get_placements_analytics
|
|
get_creatives_analytics = get_creatives_analytics
|
|
get_channel_analytics = get_channel_analytics
|
|
get_spending_analytics = get_spending_analytics
|
|
get_overview_analytics = get_overview_analytics
|
|
get_workspaces = get_workspaces
|
|
create_workspace = create_workspace
|
|
update_workspace = update_workspace
|
|
delete_workspace = delete_workspace
|
|
get_workspace_members = get_workspace_members
|
|
update_workspace_member_permissions = update_workspace_member_permissions
|
|
create_workspace_invite = create_workspace_invite
|
|
get_workspace_invites = get_workspace_invites
|
|
accept_workspace_invite = accept_workspace_invite
|
|
tg_accept_workspace_invite = tg_accept_workspace_invite
|