​

📋 Сводка по локальной настройке 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:

.\start-local-dev.ps1

​

Для Linux/macOS:

./start-local-dev.sh

​

Остановка:

# 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
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/docs
• Health Check: http://localhost:8000/health

​

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

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

​

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

​

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

docker-compose up -d

​

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

# База данных в 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):

​

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

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

NEXT_PUBLIC_API_URL=http://localhost:8000
NEXT_PUBLIC_WS_URL=ws://localhost:8000

​

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

​

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

# Windows
netstat -ano | findstr :3000
netstat -ano | findstr :8000

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

​

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

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

​

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

# Очистка кеша
npm cache clean --force
pip cache purge

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

​

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

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

​

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

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