Restaurant API

Микросервис для автоматизации бронирования столиков в ресторанах с асинхронным управлением данными, кэшированием и автоматизированным развертыванием.

Функционал

• Управление бронированием: Создание, отмена и просмотр резервов в реальном времени.
• Контроль доступности: Автоматическая проверка вместимости и статуса столиков при попытке бронирования.
• Аутентификация: Регистрация и вход пользователей для управления личными бронированиями, используя JWT - токены.
• Кэширование: Оптимизация часто запрашиваемых данных (список доступных столов) через Redis.
• Авто-миграции: Автоматическое обновление схемы базы данных через Alembic при старте контейнера.
• REST API: Документированный интерфейс на FastAPI с валидацией входных данных через Pydantic.

Технологии

Инструкция запуска через Docker Compose

1. Клонировать git-репозиторий

2. Открыть проект

3. Сконфигурировать .env по шаблону

4. Выполнить команду docker compose up -d --build

5. Подождать 20 секунд и перейти на: http://127.0.0.1:8000/docs

Инструкция локального запуска

1. Клонировать git-репозиторий

2. Открыть проект

3. Сконфигурировать .env по шаблону

4. Скачать poetry и установить зависимости

Версия Poetry: 2.2.1

5. Выполнить команду docker-compose up -d database redis-cache

6. Применить миграции

7. Выполнить команду python -m app.main и перейти на http://127.0.0.1:8000/docs

Авторизация

1. Зарегистрироваться

2. Авторизоваться и получить JWT access token

3. Скопировать его и вставить в поле у кнопки Authorize

4. После появится возможность использовать эндпоинты

Конфигурация

Все настройки можно регулировать в .env