Almau Messenger

Анонимный Telegram-бот для студентов и сайт о нём. Бот случайно соединяет двух студентов для разговора. Имя, @username и телефон собеседник не видит.

Новое в этапе 2:

• Подбор по интересам. Бот сначала ищет собеседника с общими темами и показывает их обоим.
• Компания на ивент. Можно отметить «Иду» на ивенте и анонимно поговорить с тем, кто тоже идёт. Кнопка на сайте открывает бота сразу на карточке ивента.
• Модерация. Жалобы приходят админам. После N жалоб от разных людей нарушитель блокируется автоматически. Для админов есть команды /stats, /ban, /unban.

Новое в RK1 — бэкенд и хостинг:

• Веб-API (bot/api.py + отдельная точка входа bot/api_server.py): сайт больше не просто статика — он получает данные клубов/ивентов и живую статистику с сервера, кнопка «Иду» на сайте и форма заявки реально сохраняют данные в БД. См. раздел API.
• Хостинг. Бот и бэкенд — два независимых сервиса, деплоятся и хостятся отдельно друг от друга (бот — отдельно, API — отдельно, каждый на своём Railway-проекте). Живые ссылки — в разделе Живой продукт.

Кто за что отвечает и как устроен код: docs/TEAM.md.

Живой продукт

Что	Ссылка
Сайт	https://almau-messenger.vercel.app
Бот	https://t.me/Almau_mes_bot
API (бэкенд)	https://almaumessanger-production.up.railway.app

После деплоя сайта на Vercel обновите ссылку на сайт в этой таблице.

Партнёр: Summit Seekers

Горный клуб AlmaU — наш партнёр. Для него сделаны запись на походы с листом ожидания, напоминания, рассылки, панель организатора /club, «Я спустился» и SOS, школа туризма, отчёт и страница на сайте. Подробности и инструкция для организатора: docs/SUMMIT.md. Организаторов добавляют в переменную CLUB_ADMIN_IDS.

Структура

bot/
  main.py            точка входа бота (polling); опционально поднимает и API в том же процессе — Дияр
  config.py          настройки из .env                                       — Дияр, + RK1 (PORT, CORS_ORIGIN, ADMIN_TOKEN)
  matchmaking.py     очередь поиска, подбор по интересам и ивентам          — Дияр
  keyboards.py       кнопки меню и диалога                                   — Дияр
  handlers/chat.py   поиск, пересылка сообщений, Следующий/Стоп, /give       — Дияр
  db.py              SQLite: профили, жалобы, баны, статистика, «Иду»        — Абулхаир, + RK1 (заявки с сайта)
  handlers/profile.py   регистрация и профиль (вуз, курс, интересы, соцсети) — Абулхаир
  handlers/moderation.py  жалобы, автобан, /stats /ban /unban                — Абулхаир, + RK1 (/leads)
  api.py             веб-API: /api/clubs, /api/events, /api/leads, /api/stats — RK1
  api_server.py      отдельная точка входа: только веб-API, без бота          — RK1
  content.py         загрузка клубов и ивентов из site/data                  — Хамид
  handlers/events.py афиша, «Иду», «Найти компанию», /clubs                  — Хамид
site/
  index.html         сайт (О проекте, Клубы, Ивенты)                         — Хамид, + RK1 (форма заявки, статистика, кнопка «Иду»)
  data/clubs.json    клубы — общие для сайта и бота                          — Хамид
  data/events.json   ивенты — общие для сайта и бота                         — Хамид
tests/               тесты всех частей, включая API (pytest)

Запуск бота

python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements-dev.txt
cp .env.example .env        # вставить BOT_TOKEN от @BotFather и свой ADMIN_IDS
python -m bot.main

Хостинг

Бот и бэкенд (API) — два независимых сервиса с разными точками входа. Их можно деплоить разными людьми, в разное время и даже на разные платформы — они не знают друг о друге и общаются только через общий файл site/data/*.json с клубами/ивентами.

Бот — python -m bot.main

1. railway.com → New Project → Deploy from GitHub repo → Almau_messanger.
2. Variables: BOT_TOKEN, ADMIN_IDS, BOT_USERNAME.
3. Команда запуска уже задана в railway.json. Публичный домен боту не нужен — он сам стучится в Telegram через long polling, а не наоборот.

API — python -m bot.api_server

Отдельный сервис, без Telegram-токена, со своей базой (заявки с сайта + отметки «Иду» через сайт).

1. railway.com → New Project → Deploy from GitHub repo → тот же репозиторий Almau_messanger (можно в своём, отдельном Railway-проекте).
2. Settings → Deploy → Custom Start Command: python -m bot.api_server (переопределяет команду из railway.json, которая рассчитана на бота).
3. Variables:
   • CORS_ORIGIN — домен сайта на Vercel (например https://almau.vercel.app); для защиты можно временно оставить *.
   • ADMIN_TOKEN — свой произвольный секрет, чтобы читать заявки через GET /api/leads без бота (см. раздел API).
   • BREVO_API_KEY, BREVO_SENDER_EMAIL — вход в «Анонимный чат» на сайте идёт по коду на почту через Brevo (300 писем/день бесплатно). Регистрация, подтверждённый отправитель (Senders → Add a sender) и API-ключ (SMTP & API → API Keys) — за пару минут. Без них код виден только в логах сервиса, письма не уходят.
   • BOT_TOKEN и ADMIN_IDS этому сервису не нужны вообще.
4. Settings → Networking → Generate Domain — обязательно, без публичного домена сайт не достучится до API. Railway сам передаёт порт через $PORT.
5. Проверьте <домен>/health → должно вернуть {"status":"ok"}.
6. Скопируйте домен в константу API в site/index.html и в таблицу Живой продукт выше.

База SQLite в обоих сервисах лежит в контейнере и сбрасывается при каждом новом деплое. Для демо это не страшно, для постоянной работы подключите Volume и задайте DB_PATH=/data/almau.db.

API

Эндпоинты bot/api.py (сервис bot/api_server.py), доступны по адресу из константы API в site/index.html:

Метод	Путь	Что делает
GET	/health	проверка живости сервиса (используется Railway healthcheck)
GET	/api/clubs	список клубов из content.py
GET	/api/events	список ивентов + живое число «Иду» из БД
GET	/api/events/{id}	один ивент, 404 если не найден
POST	/api/events/{id}/going	отметка «Иду» прямо с сайта — требует вход в аккаунт (Authorization: Bearer <token>)
GET	/api/stats	публичная статистика: пользователи, диалоги, заявки, аккаунты и диалоги чата
POST	/api/leads	сохраняет заявку с формы сайта (name, contact, message, опц. event_id) в БД
GET	/api/leads?token=<ADMIN_TOKEN>	просмотр последних заявок без бота (401 без правильного токена)
POST	/api/admin/reset-web-chat?token=<ADMIN_TOKEN>&confirm=yes	необратимо стирает все аккаунты/диалоги/сообщения/фото «Анонимного чата» — для очистки тестовых данных перед демо
POST	/api/chat/register	аккаунт: first_name, last_name, phone, email, password, опц. account_type (student по умолчанию, teacher, registrar). Для student ещё нужны gender, course, specialty, опц. nickname. Для teacher/registrar вместо них — invite_key (см. /api/admin/rotate-invite-key), иначе 403. Всегда шлёт код подтверждения на почту
POST	/api/chat/login	{"email", "password"} — вход по паролю (нужна подтверждённая почта), выдаёт токен сессии
POST	/api/chat/otp/request

Проверить локально после python -m bot.api_server:

curl http://localhost:8080/api/stats
curl -X POST http://localhost:8080/api/leads \
  -H "Content-Type: application/json" \
  -d '{"name":"Аян","contact":"@ayan","message":"Хочу демо"}'
curl "http://localhost:8080/api/leads?token=$ADMIN_TOKEN"

Если API запущен вместе с ботом через python -m bot.main (а не отдельно), POST /api/leads дополнительно уведомляет админов в Telegram, и заявки видны ещё и командой /leads в боте.

Тесты

pytest -q

tests/test_bot_flow.py прогоняет полные сценарии бота без интернета: регистрацию, диалог, жалобы, автобан и поиск компании на ивент.

Сайт

Сайт читает data/*.json через fetch, поэтому при двойном клике по файлу данные не загрузятся. Его нужно открывать через веб-сервер:

cd site && python -m http.server 8000   # открыть http://localhost:8000

На Vercel в настройках проекта укажите Root Directory = site. В site/index.html константа BOT должна совпадать с username бота, а константа API — с доменом задеплоенного бэкенда (см. раздел «Хостинг» выше, подраздел «API»). Если API недоступен, сайт не падает: статистика, кнопка «Иду» и живой счётчик просто не работают, а клубы/ивенты как и раньше читаются из data/*.json.