feat: Implement payment notification system and API structure

- Added notifications for successful payments in `api/core/notifications.py`.
- Created main API entry point in `api/main.py` with FastAPI integration.
- Established routing structure in `api/routes/__init__.py` and `api/routes/pally.py` for handling payment callbacks.
- Developed billing handlers in `bot/handlers/billing.py` and `bot/handlers/buy.py` for subscription management.
- Introduced state management for user interactions in `bot/states/`.
- Created user interface elements in `bot/keyboards/` for navigation and payment processing.
- Set up middleware for dependency injection in `bot/middlewares/di.py`.
- Added support for user commands and interactions in `bot/handlers/common.py` and `bot/handlers/support.py`.
- Implemented logging and error handling throughout the bot's functionality.
- Created entry point script for API server in `entrypoints/api.sh`.

bot/handlers/menus.py

@@ -0,0 +1,107 @@
+from aiogram import F, Router
+from aiogram.filters import Command, CommandObject, CommandStart
+from aiogram.fsm.context import FSMContext
+from aiogram.types import CallbackQuery, Message
+from sqlalchemy.ext.asyncio import AsyncSession
+
+from bot.keyboards.client import close_kb, main_menu, return_to_menu
+from bot.texts import FAQ_TEXT, GENERAL_PROCESSING
+from misc.utils import build_main_menu_text, format_subscription_link
+from schemas.di import DependenciesDTO
+from services.rw import get_user_by_telegram_id
+
+router = Router()
+
+
+@router.message(CommandStart(deep_link=True, deep_link_encoded=True))
+async def fetch_referal(
+    msg: Message,
+    command: CommandObject,
+    state: FSMContext,
+    session: AsyncSession,
+    deps: DependenciesDTO,
+):
+    await state.clear()
+
+    data = command.args.split("_")
+    if not data:
+        await standard_start(msg, command, state)
+        return
+
+    referal = int(data[1])
+    user = await deps.user_service.add_user(
+        session, user_id=msg.from_user.id, referal=referal, rw_sdk=deps.rw_sdk
+    )
+
+    await msg.answer(
+        build_main_menu_text(format_subscription_link(user.subscription_link)),
+        reply_markup=main_menu,
+    )
+
+
+@router.message(Command(commands=["start", "cancel"]))
+async def standard_start(
+    msg: Message,
+    state: FSMContext,
+    session: AsyncSession,
+    deps: DependenciesDTO,
+):
+    await state.clear()
+
+    user = await deps.user_service.add_user(session, user_id=msg.from_user.id, rw_sdk=deps.rw_sdk)
+
+    await msg.answer(
+        build_main_menu_text(format_subscription_link(user.subscription_link)),
+        reply_markup=main_menu,
+    )
+
+
+@router.callback_query(F.data == "menu:main")
+async def main_menu_cb(
+    cb: CallbackQuery, state: FSMContext, session: AsyncSession, deps: DependenciesDTO
+):
+    await state.clear()
+
+    user = await deps.user_repository.get_user_by_id(session, cb.from_user.id)
+    await cb.message.edit_text(
+        build_main_menu_text(format_subscription_link(user.subscription_link)),
+        reply_markup=main_menu,
+    )
+
+
+@router.callback_query(F.data == "update_link")
+async def update_link(
+    cb: CallbackQuery, state: FSMContext, session: AsyncSession, deps: DependenciesDTO
+):
+    await state.clear()
+    await cb.message.edit_text(GENERAL_PROCESSING)
+
+    user = await deps.user_service.update_user_link(session, cb.from_user.id, deps.rw_sdk)
+    await cb.answer("✅")
+    await cb.message.edit_text(
+        build_main_menu_text(format_subscription_link(user.subscription_link)),
+        reply_markup=main_menu,
+    )
+
+
+@router.callback_query(F.data == "faq")
+async def faq(cb: CallbackQuery, state: FSMContext):
+    await state.clear()
+
+    await cb.message.edit_text(FAQ_TEXT, reply_markup=return_to_menu)
+
+
+@router.callback_query(F.data == "sub_info")
+async def sub_info(
+    cb: CallbackQuery, state: FSMContext, deps: DependenciesDTO, session: AsyncSession
+):
+    await state.clear()
+
+    await cb.message.edit_text(GENERAL_PROCESSING, reply_markup=close_kb)
+    rw_user = await get_user_by_telegram_id(deps.rw_sdk, cb.from_user.id)
+    user = await deps.user_service.update_user_link(session, cb.from_user.id, deps.rw_sdk)
+
+    await cb.message.edit_text(
+        deps.user_service.format_subscription_message(rw_user, link=user.subscription_link),
+        reply_markup=return_to_menu,
+    )