Oraro.App

Бизнес-задача

Создание кроссплатформенной экосистемы Oraro для поиска совместимости и общения. Основная сложность заключалась в разработке гибридного решения: приложение должно было работать как полноценный отзывчивый Web-сайт в браузере и одновременно функционировать как бесшовный Telegram Mini App (TMA) внутри мессенджера с единой базой данных, сквозной авторизацией и реалтайм-коммуникацией.

Интерфейс Платформы Oraro

Выберите интересующий раздел в верхнем меню, чтобы переключить скриншот в окне браузера ниже:

01

Профили и Анкеты

Детальные карточки профилей: фотографии, личные интересы, результаты тестирования и автоматический расчёт совместимости.

02

Интеграция с картами

Интерактивная карта, отображающая анкеты людей поблизости и тематические услуги с фильтрацией по расстоянию на базе гео-запросов PostGIS.

03

WebSocket Веб-чат

Интерфейс реалтайм-чата внутри веб-приложения с мгновенной отправкой сообщений, статусами прочтения и индикацией набора текста.

04

Telegram Mini App

Полная интеграция с экосистемой Telegram: приложение открывается прямо внутри чата с ботом как Mini App, используя Telegram WebApp SDK.

Увеличить

Стек Технологий

Архитектура и Решения

Сценарий сквозной авторизации (initData → JWT): При запуске Mini App на клиенте извлекается сырая строка Telegram.WebApp.initData. Бэкенд на FastAPI валидирует её хэш с помощью секретного ключа бота, извлекает tg_user_id и выдает пользователю JWT-токен. Этот токен используется как для обычных REST API запросов, так и для авторизации в WebSocket-соединении чата.

Гео-поиск и PostGIS: Для реализации функции поиска анкет поблизости мы внедрили расширение PostGIS для PostgreSQL. Координаты пользователей хранятся как геометрические точки (POINT). С помощью SQL-запросов и пространственных индексов система выполняет поиск кандидатов в заданном радиусе (например, «в пределах 5 км») за считанные миллисекунды.

Реалтайм WebSocket-чаты: Все диалоги работают поверх постоянного WebSocket-соединения. События отправки, доставки, прочтения сообщений и набора текста сериализуются в JSON и мгновенно маршрутизируются сервером до активных сессий получателей.

Фоновые воркеры Celery: Для ресурсоемких периодических задач (начисление реферальных очков, обновление турнирных таблиц, сброс лиг звезд совместимости) настроена связка Celery Worker + Celery Beat, которая разгружает основной поток API-сервера.