PsyBot - Психологический помощник 24/7

Современное веб-приложение для психологической поддержки, использующее методы Гештальт-терапии и когнитивно-поведенческой терапии (КПТ). Доступно как веб-сайт, PWA приложение и Telegram Mini App.

Возможности

• 💬 Чат с ИИ-психологом — 24/7 поддержка на основе GPT-4o-mini с методами Gestalt therapy и CBT
• 📋 Beck Depression Inventory — тест из 21 вопроса с автоматической интерпретацией результатов
• 🧘 Библиотека упражнений — дыхательные техники, релаксация, осознанность, когнитивные упражнения
• ⏱️ Таймер для упражнений — с визуальным прогрессом и звуковым уведомлением
• ⚠️ Режим кризиса — автоматическое обнаружение суицидальных мыслей с экстренными контактами
• 💾 История разговоров — сохранение и управление сессиями в БД
• 📱 PWA — установка на телефон как нативное приложение
• 🤖 Telegram Mini App — запуск прямо в Telegram мессенджере
• 🌙 Космический дизайн — успокаивающая визуальная тема с градиентами и звездами

Технологический стек

Frontend:

• React 19 + TypeScript
• Tailwind CSS 4
• tRPC для типобезопасного API
• Wouter для маршрутизации
• Streamdown для markdown-рендеринга

Backend:

• Express.js
• tRPC Server
• MySQL/TiDB Database
• Drizzle ORM

Интеграции:

• OpenRouter API (GPT-4o-mini)
• Telegram Bot API
• Vercel Edge Functions

Быстрый старт

Локальная разработка

# Установка зависимостей
pnpm install

# Запуск dev сервера
pnpm dev

# Открыть в браузере
# http://localhost:3000

Переменные окружения

Создайте .env файл с необходимыми переменными:

DATABASE_URL=mysql://user:password@host/database
JWT_SECRET=your-secret-key
VITE_APP_ID=your-app-id
OAUTH_SERVER_URL=https://api.manus.im
OWNER_OPEN_ID=your-owner-id
BUILT_IN_FORGE_API_URL=https://forge.manus.im
BUILT_IN_FORGE_API_KEY=your-forge-key
OPENROUTER_API_KEY=your-openrouter-key
TELEGRAM_BOT_TOKEN=your-telegram-bot-token

Структура проекта

psybot-web/
├── client/                 # React приложение
│   ├── src/
│   │   ├── pages/         # Страницы (Home, Conversations, etc)
│   │   ├── components/    # React компоненты
│   │   ├── hooks/         # Custom hooks
│   │   ├── lib/           # Утилиты и конфигурация
│   │   ├── contexts/      # React contexts
│   │   ├── App.tsx        # Главный компонент
│   │   └── main.tsx       # Entry point
│   ├── public/            # Статические файлы
│   │   ├── manifest.json  # PWA манифест
│   │   └── service-worker.js
│   └── index.html
├── server/                # Express сервер
│   ├── routers.ts         # tRPC маршруты
│   ├── db.ts              # Функции БД
│   ├── db-conversations.ts # История разговоров
│   ├── _core/             # Ядро приложения
│   │   ├── index.ts       # Точка входа сервера
│   │   ├── telegram.ts    # Telegram Bot Handler
│   │   ├── openrouter.ts  # OpenRouter API
│   │   ├── env.ts         # Переменные окружения
│   │   ├── context.ts     # tRPC контекст
│   │   └── trpc.ts        # tRPC конфигурация
│   └── tests/             # Unit тесты
├── drizzle/               # ORM схема и миграции
│   └── schema.ts
├── shared/                # Общий код
│   ├── psychology.ts      # Психологические данные
│   ├── exercises.json     # База упражнений
│   └── appRouterType.ts   # Типы маршрутов
└── package.json

Основные компоненты

ChatInterface

Полнофункциональный чат-интерфейс с поддержкой markdown, автоматическим обнаружением кризиса и сохранением истории.

BeckTest

Компонент Beck Depression Inventory с 21 вопросом, автоматическим подсчетом баллов и интерпретацией результатов.

ExerciseLibrary

Библиотека упражнений с фильтрацией по категориям и пошаговыми инструкциями.

ExerciseTimer

Таймер с визуальным прогрессом, паузой/возобновлением и звуковым уведомлением.

Развертывание

На Vercel (рекомендуется)

# Подключить GitHub репозиторий
# Vercel автоматически обнаружит Next.js конфигурацию
# Добавить переменные окружения в Vercel Dashboard
# Нажать Deploy

На собственном сервере

# Сборка
pnpm build

# Запуск production версии
pnpm start

Telegram Mini App

Приложение доступно как Telegram Mini App через бота @nnotrain_bot.

Команды:

• /start — Запустить приложение
• /help — Справка по использованию

Ссылка: https://t.me/nnotrain_bot?startapp=psybot

API Маршруты

tRPC Процедуры

Chat:

• chat.sendMessage — Отправить сообщение психологу

Conversations:

• conversations.create — Создать новый разговор
• conversations.list — Получить список разговоров
• conversations.getMessages — Получить сообщения разговора
• conversations.updateTitle — Обновить название разговора
• conversations.delete — Удалить разговор
• conversations.clearMessages — Очистить сообщения

Auth:

• auth.me — Получить текущего пользователя
• auth.logout — Выход

REST Endpoints

Telegram:

• POST /api/telegram/webhook — Webhook для Telegram Bot

Тестирование

# Запустить все тесты
pnpm test

# Запустить конкретный тест
pnpm test server/telegram.test.ts

# Watch режим
pnpm test --watch

Безопасность

• Все API ключи хранятся на сервере, не передаются клиенту
• OpenRouter API ключ защищен через Vercel Edge Functions
• Telegram Bot Token безопасно обрабатывается на сервере
• Все данные пользователя шифруются в БД

Производительность

• Lazy loading компонентов
• Code splitting для оптимизации бандла
• Service Worker для кэширования и офлайн-работы
• CDN для статических файлов
• Compression ответов сервера

Лицензия

MIT License - свободное использование в личных и коммерческих целях.

Автор

AnykeyevRoman - Разработка и поддержка

Поддержка

Если у вас есть вопросы или вы нашли баг, пожалуйста создайте Issue в GitHub репозитории.

Благодарности

• OpenRouter за API доступ к GPT-4o-mini
• Telegram за Bot API
• React, Express и другим open-source проектам

---

Приложение работает 24/7 без перерывов. Ваше психическое здоровье важно. 💚