Добро пожаловать в Geni AI Docs

Контекст проекта

Проект Geni AI — это цепочка Telegram → n8n → Supabase → WebApps (Cloudflare Pages) → обратно в Telegram.

• вход всего трафика — через Telegram-бота;
• центральная бизнес-логика и маршрутизация — в n8n;
• учёт пользователей, баланса и задач — в Supabase;
• вспомогательные UI-страницы (мини-приложения) на Cloudflare просто отдают параметры назад в n8n;
• новые фичи должны опираться на уже существующие паттерны (форматы входа, вызовы функций в БД, кошелёк).

Что это за сайт

Это рабочая документация проекта Geni AI. Она нужна, чтобы перед тем как писать/генерировать код, сначала:

1. посмотреть, как уже сделано;
2. взять реальные структуры (таблицы, функции, воркфлоу);
3. не выдумывать новые сущности, если похожая уже есть.

Ключевые компоненты

1. Telegram-бот — входящий слой, все апдейты идут отсюда.
2. n8n (оркестратор) — нормализует вход, выбирает tool, дёргает Supabase, запускает генерации и отвечает в Telegram.
3. Supabase (данные и биллинг) — таблицы пользователей, кредиты/кошелёк, задачи, SQL-функции типа wallet_debit, ensure_user.
4. WebApps / мини-приложения — небольшие страницы на Cloudflare Pages, которые пользователь открывает из бота; они выдают настройки/параметры в n8n.

Алгоритм чтения доки (для ИИ)

1. Сначала понять архитектуру.

   • Открыть раздел с общей схемой и зафиксировать поток:
   • Telegram → n8n → Supabase → WebApps → Telegram
   • Кто инициирует запрос.
   • Где хранятся пользователи и баланс.
   • Где происходит фактическая генерация/вызов модели.

2. Потом n8n (самое важное).

   • Открыть каталог воркфлоу.
   • Найти главный/входной воркфлоу, который начинается с Geni_AI... — это хаб.
   • Разобрать, как он получает chatId, tool, цену и где именно дергает Supabase.
   • Потом пройти остальные воркфлоу — это, как правило, сценарии под конкретные модели/режимы.

3. Дальше Supabase.

   • Пройти список таблиц и понять назначение: пользователи, кошелёк, операции, задачи.
   • Открыть сгенерированные страницы по SQL-функциям и посмотреть сигнатуры.
   • Сопоставить: какие функции реально вызываются из n8n (по именам).

4. Потом WebApps.

   • Открыть каталог страниц.
   • Для каждой страницы понять, какие поля/настройки она отдаёт.
   • Сверить, что эти поля реально используются в соответствующих воркфлоу n8n.

5. Только после этого — писать/генерировать код.

   • Использовать существующие имена таблиц/функций.
   • Не придумывать новые поля, если можно положить в уже имеющиеся.
   • Следить за форматом, который ожидает n8n.