How ashab-al/vacantist-bot_ashab works
Вакантист — Telegram-бот для выбора категорий вакансий, получения публикаций и покупки поинтов; рядом работает административный HTTP API для управления данными и приёма вакансий и платежных вебхуков. Основной путь: Telegram присылает обновления приложению, бот обрабатывает выбор категорий и доставляет подходящие вакансии; отдельный путь — создание вакансии через API с последующей отправкой. Граф также показывает оплату, модерацию спама и внутренние данные. Связи ограничены README и показанными либо индексированными ссылками; детали некоторых обработчиков и сервисов не проверялись.
Main entry points: api API routes · main.py FastAPI entry · payment.py Telegram payments · handlers Bot handlers
Components 21
Запуск и API
- FastAPI entry
app/main.py - API routes
app/api - Bot runtime
app/bot/create_bot.py
Telegram-продукт
- Bot handlers
app/bot/handlers - Category subscriptions
app/services/tg/user/update_subscription_with_category.py - Vacancy browsing
app/services/tg/vacancy/send_vacancies.py - Vacancy delivery
app/services/tg/vacancy/sender_vacancy.py - Spam moderation
app/services/tg/vacancy/send_spam_vacancy_in_admin_group.py
Администрирование и оплата
- Category management
app/services/api/category - User administration
app/services/api/user - Vacancy intake
app/services/api/vacancy - Telegram payments
app/bot/handlers/payment.py - YooKassa webhook
app/services/api/yookassa/payment_processing.py
Данные и хранилище
- Domain models
app/models - Database sessions
app/database.py - Vacancy queries
app/query_objects/vacancies
Other components
- Пользователь Telegram
- API-клиент
- Telegram
- YooKassa
- PostgreSQL
Connections 26
- Пользователь Telegram → Telegram: sends updates
- Telegram → FastAPI entry: posts webhook
app/main.py - FastAPI entry → Bot runtime: starts bot
app/main.py - FastAPI entry → API routes: mounts routes
app/main.py - FastAPI entry → Bot handlers: registers handlers
app/main.py - Bot handlers → Telegram: sends replies
- Пользователь Telegram → Category subscriptions: chooses categories
- Category subscriptions → Vacancy browsing: gets earlier vacancies
- Category subscriptions → Vacancy delivery: receives new vacancies
- API-клиент → API routes: calls endpoints
- API routes → Vacancy intake: creates vacancy
app/api/vacancies/create.py - Vacancy intake → Vacancy delivery: requests sending
app/api/vacancies/create.py - API routes → Category management: manages categories
- API routes → User administration: manages users
app/api/users/set_status.py - Пользователь Telegram → Telegram payments: selects tariff
app/bot/handlers/payment.py - Telegram payments → Telegram: sends invoice
app/bot/handlers/payment.py - Telegram → Telegram payments: confirms checkout
app/bot/handlers/payment.py - YooKassa → API routes: posts payment event
app/api/yookassa/success.py - API routes → YooKassa webhook: processes event
app/api/yookassa/success.py - YooKassa webhook → Bot runtime: uses bot
app/services/api/yookassa/payment_processing.py - Bot handlers → Spam moderation: routes complaint
- Spam moderation → Vacancy queries: looks up vacancy
app/services/tg/vacancy/send_spam_vacancy_in_admin_group.py - API routes → Database sessions: opens sessions
app/api/vacancies/create.py - Database sessions → PostgreSQL: creates engine
app/database.py - Vacancy queries → Domain models: queries models
app/query_objects/vacancies/vacancies_for_the_week.py - Telegram payments → Database sessions: uses session
app/bot/handlers/payment.py