Voice Assistant Monorepo

Этот репозиторий теперь организован как монорепа: все приложения (Electron desktop, standalone backend, будущий лендинг и React Native) живут в одном дереве и делят общие пакеты.

Структура

apps/
  desktop/        # Текущее Electron приложение (main + backend-electron + ui-electron)
  backend-main/   # Node.js + MongoDB API сервер
  landing/        # Заготовка под рекламный лендинг (Vite/Next – TBD)
  mobile/         # Заготовка под React Native / Expo приложение
packages/
  shared/         # Общие типы, DTO и zod-схемы (используются backend + desktop)
docs/             # Документация (cursor.md, CURSOR_*.md)

Скрипты верхнего уровня

Команда	Описание
npm run dev	Запускает desktop workspace (эквивалент apps/desktop → npm run dev)
npm run dev:backend-main	Запускает API сервер (workspace apps/backend-main)
npm run build	Сборка desktop приложения
npm run build:backend-main	Сборка backend-main
npm run test	Playwright визуальные тесты desktop UI
npm run lint / npm run format / npm run typecheck	Соответствующие проверки для desktop workspace
npm run run:all	Полный цикл setup MongoDB → build all → старт Electron + backend
npm run prisma:generate --workspace @assistant/backend-main	Генерация Prisma клиента и zod-схем в packages/shared/src/zod
npm run prisma:push --workspace @assistant/backend-main	Применение Prisma схемы к MongoDB

Плейсхолдеры apps/landing и apps/mobile уже подключены к workspace и готовы к разработке (команды пока выводят заглушку).

Новое в монорепе

• Prisma ORM для apps/backend-main: схема хранится в apps/backend-main/prisma/schema.prisma, клиент создаётся в src/lib/prisma.ts, а applicationsService/authService/settingsService/chatService работают через Prisma.
• Shared DTO package (packages/shared): помимо ручных схем (applications.ts) автоматически содержит zod-схемы из Prisma (src/zod/schemas.ts), благодаря чему backend и desktop используют один и тот же контракт.

Документация

• Навигация по докам: docs/INDEX.md
• Для Cursor / AI: cursor.md
• Архитектура: docs/CURSOR_ARCHITECTURE.md
• Команды и workflow: docs/CURSOR_COMMANDS.md
• Технические детали: docs/CURSOR_TECHNICAL.md
• Конфигурации: docs/CURSOR_CONFIGURATION.md
• План работ: docs/planning/ACTION_PLAN.md
• Epics: docs/planning/EPICS.md
• Project plan: docs/planning/PROJECT_PLAN.md

Как работать

1. Установите зависимости из корня: npm install.
2. Работайте с нужным workspace:
   • Desktop: npm run dev (или npm run dev --workspace @assistant/desktop)
   • Backend: npm run dev:backend-main
3. Добавляйте новые пакеты в apps/ или packages/ и перечисляйте их в package.json.workspaces.

Более подробные инструкции по архитектуре, командам и конфигурациям — в cursor.md и docs/CURSOR_*.md.