> ## Documentation Index
> Fetch the complete documentation index at: https://docs.miscord.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# LOCAL SETUP SUMMARY

# 📋 Сводка по локальной настройке Miscord

## 🎯 Что было создано

Я изучил ваш проект Miscord и создал полный набор инструментов для локальной разработки:

### 📁 Новые файлы:

1. **LOCAL-DEVELOPMENT.md** - Подробная документация по локальной разработке
2. **QUICK-START.md** - Краткая инструкция для быстрого старта
3. **start-local-dev.sh** - Bash скрипт для автоматического запуска (Linux/macOS)
4. **start-local-dev.ps1** - PowerShell скрипт для автоматического запуска (Windows)
5. **stop-local-dev.sh** - Bash скрипт для остановки (Linux/macOS)
6. **stop-local-dev.ps1** - PowerShell скрипт для остановки (Windows)

## 🚀 Самый простой способ запуска

### Для Windows:

```powershell theme={"dark"}
.\start-local-dev.ps1
```

### Для Linux/macOS:

```bash theme={"dark"}
./start-local-dev.sh
```

### Остановка:

```powershell theme={"dark"}
# Windows
.\stop-local-dev.ps1

# Linux/macOS
./stop-local-dev.sh
```

## 📊 Анализ проекта

### Backend (Python/FastAPI):

* ✅ **FastAPI** с асинхронной поддержкой
* ✅ **PostgreSQL** для хранения данных
* ✅ **Redis** для кеширования и pub/sub
* ✅ **WebSocket** для real-time коммуникации
* ✅ **SQLAlchemy** ORM с async поддержкой
* ✅ **JWT** аутентификация
* ✅ **WebRTC** для голосовой связи (aiortc)

### Frontend (Next.js/React):

* ✅ **Next.js 14** с App Router
* ✅ **TypeScript** для типобезопасности
* ✅ **Tailwind CSS** для стилизации
* ✅ **Zustand** для управления состоянием
* ✅ **Socket.IO** для WebSocket соединений
* ✅ **Radix UI** компоненты

### Инфраструктура:

* ✅ **Docker Compose** для оркестрации
* ✅ **Nginx** для reverse proxy
* ✅ **SSL** поддержка через Let's Encrypt

## 🛠 Что делают автоматические скрипты

### Скрипт запуска:

1. ✅ Проверяет наличие всех зависимостей (Python, Node.js, Docker)
2. ✅ Создает файлы окружения (.env) автоматически
3. ✅ Запускает PostgreSQL и Redis через Docker
4. ✅ Настраивает виртуальное окружение Python
5. ✅ Устанавливает все зависимости
6. ✅ Запускает Backend на порту 8000
7. ✅ Запускает Frontend на порту 3000
8. ✅ Проверяет работоспособность всех сервисов

### Скрипт остановки:

1. ✅ Корректно останавливает все процессы
2. ✅ Останавливает Docker контейнеры
3. ✅ Очищает временные файлы
4. ✅ Освобождает порты

## 🌐 После запуска будет доступно:

* **Frontend**: [http://localhost:3000](http://localhost:3000)
* **Backend API**: [http://localhost:8000](http://localhost:8000)
* **API Documentation**: [http://localhost:8000/docs](http://localhost:8000/docs)
* **Health Check**: [http://localhost:8000/health](http://localhost:8000/health)

## 📋 Предварительные требования

* **Python 3.11+**
* **Node.js 18+**
* **Docker & Docker Compose**
* **Git**

## 🔧 Альтернативные способы запуска

### 1. Только Docker (самый простой):

```bash theme={"dark"}
docker-compose up -d
```

### 2. Гибридный (рекомендуется для разработки):

```bash theme={"dark"}
# База данных в Docker
docker-compose up -d postgres redis

# Backend локально
cd backend
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn main:app --reload --host 0.0.0.0 --port 8000

# Frontend локально
cd frontend
npm install
npm run dev
```

### 3. Полностью локальный (без Docker):

Требует ручной установки PostgreSQL и Redis

## 📝 Файлы окружения

Скрипты автоматически создают:

**backend/.env:**

```env theme={"dark"}
DATABASE_URL=postgresql://miscord_user:miscord_password@localhost:5432/miscord
REDIS_URL=redis://localhost:6379
SECRET_KEY=your-secret-key-for-development-change-in-production
CORS_ORIGINS=["http://localhost:3000"]
ACCESS_TOKEN_EXPIRE_MINUTES=10080
```

**frontend/.env.local:**

```env theme={"dark"}
NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_WS_URL=ws://localhost:8000
```

## 🐛 Решение проблем

### Проблема: Порты заняты

```bash theme={"dark"}
# Windows
netstat -ano | findstr :3000
netstat -ano | findstr :8000

# Linux/macOS
lsof -i :3000
lsof -i :8000
```

### Проблема: Docker не запускается

* Перезапустите Docker Desktop
* Проверьте, что Docker запущен: `docker --version`

### Проблема: Зависимости не устанавливаются

```bash theme={"dark"}
# Очистка кеша
npm cache clean --force
pip cache purge

# Переустановка
rm -rf node_modules package-lock.json
npm install
```

## 🎉 Готово к разработке!

Теперь у вас есть:

* ✅ Полная документация по локальной разработке
* ✅ Автоматические скрипты для запуска/остановки
* ✅ Поддержка Windows и Linux/macOS
* ✅ Все необходимые конфигурационные файлы

**Следующий шаг**: Запустите `.\start-local-dev.ps1` (Windows) или `./start-local-dev.sh` (Linux/macOS) и начинайте разработку!

***

## 📚 Дополнительная документация

* **LOCAL-DEVELOPMENT.md** - Подробная документация
* **QUICK-START.md** - Быстрый старт
* **README.md** - Основная документация проекта
* **DEPLOY.md** - Инструкции по деплою