---
description: "Быстрый запуск локального frontend и backend"
alwaysApply: true
---

# Локальный запуск проекта

## Требования

- **Node.js 22**, npm с workspaces.
- Первый раз (или после смены зависимостей): `npm install` из корня репозитория.
- Backend: скопировать `backend/.env.example` → `backend/.env` (по умолчанию `PORT=8000`, `CORS_ORIGIN=http://localhost:3000`).

## Запуск (два процесса)

Из корня репозитория поднять **два** long-running процесса в **отдельных** терминалах:

```powershell
npm run dev
npm --prefix backend run dev
```

| Сервис | URL | Проверка |
|--------|-----|----------|
| Frontend (Next.js 16, Turbopack) | http://localhost:3000 | открыть в браузере |
| Backend (Fastify) | http://localhost:8000 | `GET /health` |

Проверка backend в PowerShell:

```powershell
Invoke-WebRequest -Uri http://localhost:8000/health -UseBasicParsing | Select-Object -ExpandProperty Content
```

Ожидаемый ответ: `{"status":"ok",...}`.

## Поведение агента

Если пользователь просит «запусти проект», «запусти фронт и бэк» или похожее:

1. Сначала проверить уже запущенные терминалы — не дублировать процессы.
2. Запустить обе команды выше как фоновые long-running процессы.
3. Дождаться готовности: frontend — `Ready`, backend — `Server listening` / успешный `/health`.

Подробности архитектуры и env — `README.md`, раздел «Запуск».