Старт

QUICKSTART.md

@@ -0,0 +1,126 @@
+# Быстрый старт Auth Learning App
+
+## Требования
+- Docker 20.10+ (запущенный)
+- Docker Compose 2.0+
+
+## Установка и запуск
+
+1. **Клонируйте проект** (если нужно):
+   ```bash
+   git clone <repository-url>
+   cd auth-learning-app
+   ```
+
+2. **Настройте переменные окружения**:
+   ```bash
+   cp .env.example .env
+   # Отредактируйте .env при необходимости
+   ```
+
+3. **Запустите приложение**:
+   ```bash
+   docker-compose up --build
+   ```
+
+   Или в фоновом режиме:
+   ```bash
+   docker-compose up -d --build
+   ```
+
+4. **Приложение будет доступно**:
+   - 🌐 Frontend: http://localhost
+   - 📚 API Documentation: http://localhost:8000/docs
+   - 📖 ReDoc: http://localhost:8000/redoc
+
+## Тестовые учетные данные
+- **Email**: test@example.com
+- **Password**: Test1234
+
+## Очистка Docker (если нужно)
+
+### Использование скрипта:
+```bash
+# Мягкая очистка (контейнеры и сети)
+./docker-cleanup.sh --soft
+
+# Средняя очистка (рекомендуется) + образы без тегов
+./docker-cleanup.sh --medium
+
+# Полная очистка (ВНИМАНИЕ: удалит базу данных!)
+./docker-cleanup.sh --all
+```
+
+### Ручная очистка:
+```bash
+# Остановить и удалить контейнеры проекта
+docker-compose down
+
+# Удалить все неиспользуемые образы
+docker image prune -a
+
+# Удалить все неиспользуемые volumes (удалит БД!)
+docker volume prune
+
+# Очистить build cache
+docker builder prune
+```
+
+## Решение проблем
+
+### 1. Docker не запущен
+```bash
+# Запустите Docker Desktop или Docker daemon
+# Проверьте статус:
+docker info
+```
+
+### 2. Порт уже используется
+```bash
+# Найдите процесс, использующий порт
+sudo lsof -i :80    # Frontend
+sudo lsof -i :8000  # Backend API
+sudo lsof -i :5432  # PostgreSQL
+
+# Остановите процесс или измените порты в docker-compose.yml
+```
+
+### 3. Проблемы с базой данных
+```bash
+# Просмотрите логи PostgreSQL
+docker-compose logs postgres
+
+# Пересоздайте volume (удалит данные!)
+docker-compose down -v
+docker-compose up -d
+```
+
+### 4. Проблемы с зависимостями
+```bash
+# Пересоберите образы с очисткой кэша
+docker-compose build --no-cache
+docker-compose up -d
+```
+
+## Логи приложения
+```bash
+# Все сервисы
+docker-compose logs -f
+
+# Конкретный сервис
+docker-compose logs -f backend
+docker-compose logs -f frontend
+docker-compose logs -f postgres
+```
+
+## Остановка приложения
+```bash
+# Остановить все сервисы
+docker-compose down
+
+# Остановить с удалением volumes (удалит БД!)
+docker-compose down -v
+```
+
+## Дополнительная информация
+Полная документация: [README.md](README.md)