pyisu/QUICKSTART.md

Быстрый старт Auth Learning App

Требования

• Docker 20.10+ (запущенный)
• Docker Compose 2.0+

Установка и запуск

1. Клонируйте проект (если нужно):

   git clone <repository-url>
   cd auth-learning-app
   

2. Настройте переменные окружения:

   cp .env.example .env
   # Отредактируйте .env при необходимости
   

3. Запустите приложение:

   docker-compose up --build
   

   Или в фоновом режиме:

   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 (если нужно)

Использование скрипта:

# Мягкая очистка (контейнеры и сети)
./docker-cleanup.sh --soft

# Средняя очистка (рекомендуется) + образы без тегов
./docker-cleanup.sh --medium

# Полная очистка (ВНИМАНИЕ: удалит базу данных!)
./docker-cleanup.sh --all

Ручная очистка:

# Остановить и удалить контейнеры проекта
docker-compose down

# Удалить все неиспользуемые образы
docker image prune -a

# Удалить все неиспользуемые volumes (удалит БД!)
docker volume prune

# Очистить build cache
docker builder prune

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

1. Docker не запущен

# Запустите Docker Desktop или Docker daemon
# Проверьте статус:
docker info

2. Порт уже используется

# Найдите процесс, использующий порт
sudo lsof -i :80    # Frontend
sudo lsof -i :8000  # Backend API
sudo lsof -i :5432  # PostgreSQL

# Остановите процесс или измените порты в docker-compose.yml

3. Проблемы с базой данных

# Просмотрите логи PostgreSQL
docker-compose logs postgres

# Пересоздайте volume (удалит данные!)
docker-compose down -v
docker-compose up -d

4. Проблемы с зависимостями

# Пересоберите образы с очисткой кэша
docker-compose build --no-cache
docker-compose up -d

Логи приложения

# Все сервисы
docker-compose logs -f

# Конкретный сервис
docker-compose logs -f backend
docker-compose logs -f frontend
docker-compose logs -f postgres

Остановка приложения

# Остановить все сервисы
docker-compose down

# Остановить с удалением volumes (удалит БД!)
docker-compose down -v

Дополнительная информация

Полная документация: README.md