Приложение-компаньон для людей, переживающих утрату близкого человека. Пользователь загружает текстовые материалы о реальном человеке (экспорт переписки, заметки), приложение строит на их основе RAG-персону и позволяет вести с ней текстовый диалог.
MVP: только текстовый чат, без фото/видео/голоса. PWA на Next.js с прицелом на упаковку в Android-приложение через TWA.
| Слой | Решение |
|---|---|
| Фреймворк | Next.js (App Router), TypeScript |
| Архитектура | Feature-Sliced Design (FSD) |
| Стилизация | SCSS Modules, дизайн-токены (light/dark) |
| UI-примитивы | react-aria-components |
| Auth + БД | Supabase (Postgres, Auth, Storage) |
| Векторное хранилище | pgvector (расширение Postgres в Supabase) |
| ORM-слой доступа к данным | Supabase JS client + RLS |
| API | tRPC + Zod |
| Кэш на клиенте | TanStack Query (@trpc/react-query) |
| AI-оркестрация / стриминг | Vercel AI SDK (ai) |
| LLM | Groq (openai/gpt-oss-120b — чат и онбординг, openai/gpt-oss-20b — классификатор кризисных состояний) |
| Эмбеддинги | Voyage AI (voyage-4-lite, 1024 измерения) |
| Rate limiting | Upstash Redis (@upstash/ratelimit) |
| Resend | |
| i18n | next-intl (RU — основная локаль, EN — подготовлена) |
| Деплой | Vercel |
Каждый внешний провайдер (LLM, эмбеддинги) спрятан за интерфейсом в src/shared/api/*, чтобы смена провайдера не требовала правок в features/widgets.
/app # Next.js App Router — только роутинг и API-роуты
/src
/app # FSD app-layer: провайдеры, глобальные стили/токены
/views # FSD pages-layer (переименован из-за конфликта имени с Next.js Pages Router)
/widgets # композиции виджетов (chat-window, consent-modal, ...)
/features # пользовательские действия (send-message, upload-training-file, ...)
/entities # доменные модели
/shared # ui-кит, api-клиенты, конфиг, i18n, утилиты
/supabase/migrations # SQL-миграции, применяются вручную через Supabase SQL Editor
Требования: Node.js 22+, pnpm.
-
Установить зависимости:
pnpm install
-
Скопировать
.env.exampleв.env.localи заполнить значения (Supabase, Groq, Voyage, Upstash, Resend — см. секцию ниже):cp .env.example .env.local
-
Применить SQL-миграции из
supabase/migrations/— по порядку номеров, каждую целиком, через Supabase Dashboard → SQL Editor → New query → Run. -
Запустить dev-сервер:
pnpm dev
Приложение откроется на http://localhost:3000.
Прочие команды:
pnpm build # production-сборка
pnpm start # запуск production-сборки
pnpm lint # ESLintПолный список — в .env.example. Кратко, откуда брать:
NEXT_PUBLIC_SUPABASE_URL,NEXT_PUBLIC_SUPABASE_ANON_KEY,SUPABASE_SERVICE_ROLE_KEY— Supabase Dashboard → Project Settings → API.GROQ_API_KEY— console.groq.com → API Keys.EMBEDDINGS_API_KEY— dashboard.voyageai.com → API Keys.UPSTASH_REDIS_REST_URL,UPSTASH_REDIS_REST_TOKEN— console.upstash.com, Redis-база → REST API.RESEND_API_KEY— resend.com → API Keys.SUPPORT_EMAIL— адрес, куда форма обратной связи присылает письма.QSTASH_TOKEN— зарезервировано под фоновую обработку больших файлов, в MVP не используется (обработка идёт синхронно).
Приложение рассчитано на Vercel без дополнительной инфраструктуры — прописать те же переменные окружения в настройках проекта Vercel и задеплоить из этого репозитория.