Сервис управления бронированием мест в кафе, просмотр меню и действующих акций.

• Управление пользователями (создание/ редактирование/ блокировка-разблокировка)
• Авторизация пользователей
• Бронирование столов в кафе с выбором даты, времени
• Предост��вление информации о действующих акциях
• Предоставление информации о доступных блюдах
• Управление бронированием
• Напоминание о бронировании
• Уведомление администратора о бронировании/ изменении бронирования

### Основные технологии
**Язык и платформа**
- Python `3.12`

**API (веб-сервис)**
- FastAPI `0.124.2`
- Starlette `0.50.0`
- Uvicorn `0.38.0`

**Данные и хранение**
- PostgreSQL `17`
- SQLAlchemy `2.0.45`
- Alembic `1.17.2`
- asyncpg `0.31.0`

**Валидация и конфигурация**
- Pydantic `2.12.5`
- pydantic-settings `2.12.0`
- pydantic-extra-types `2.10.6`
- email-validator `2.3.0`
- phonenumbers `9.0.20`

**Фоновые задачи**
- Celery `5.6.0`
- Redis (клиент) `7.1.0`
- Flower `2.0.1`
- kombu `5.6.1`, amqp `5.3.1`

**HTTP и аутентификация**
- HTTPX `0.28.1`
- PyJWT `2.8.0`

### Безопасность и криптография

**Тестирование**
- pytest `9.0.2`
- pytest-asyncio `1.3.0`

**Качество кода**
- ruff `0.14.8`
- pre-commit `4.5.0`

***Безопасность и криптография***
- cryptography `46.0.3`

Требования: установлен Docker и Docker Compose.

# 1) Склонировать репозиторий
git clone git@github.com:ohhaus/cafe-booking.git
cd cafe-booking

# 2) Создать .env
cp .env.example .env

# 3) Собрать и запустить контейнеры
docker compose -f infra/docker-compose.yml up -d --build

• API: http://localhost:8000
• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

• Основной способ запуска — через Docker Compose (инфраструктура и приложение).
• Локальная установка (venv) может быть полезна для разработки/линтинга/тестов.

git clone git@github.com:ohhaus/cafe-booking.git

# Создание и активация виртуального окружения

# Windows:
python -m venv venv
. venv/Scripts/activate

# Linux и MacOS:
python3 -m venv venv
source venv/bin/activate

# Обновить пакетный менеджер:

# Для Windows:
python -m pip install --upgrade pip

# Для Linux и macOS:
python3 -m pip install --upgrade pip

# Установить зависимости
pip install -r src/requirements.txt

# Создайте файл .env на основе примера:

cp .env.example .env

# Настройки подключения к БД
POSTGRES_USER=username
POSTGRES_PASSWORD=password
POSTGRES_DB=db_name
POSTGRES_SERVER=server_address
POSTGRES_PORT=server_port

# Опциональные настройки пула/логирования SQL
DATABASE_POOL_TIMEOUT=30
DATABASE_POOL_RECYCLE=1800
DATABASE_POOL_SIZE=20
DATABASE_MAX_OVERFLOW=30
DATABASE_POOL_PING=true
DATABASE_ECHO_SQL=false

# Redis
REDIS_URL=redis://localhost:6379/0 # DB для кешей/вспомогательных данных
REDIS_PASSWORD=password

# Celery
CELERY_BROKER_DB=1 # Redis DB для брокера (очереди задач)
CELERY_RESULT_DB=2 # Redis DB для result-backend (результаты задач)
CELERY_TIMEZONE=Europe/Moscow
CELERY_ENABLE_UTC=true
CELERY_TASK_TRACK_STARTED=true
CELERY_BROKER_CONNECTION_RETRY_ON_STARTUP=true

# Параметры для отправки уведомлений по почте
MAIL_SERVER=smtp.yandex.ru
MAIL_PORT=465 # Порт SMTP (465 для SSL)
MAIL_SSL=true # Использовать SSL (для 465 должно быть true)
MAIL_TLS=false # STARTTLS (для 587 true, для 465 обычно false)
MAIL_USERNAME=your_login@yandex.ru
MAIL_PASSWORD=app_password # Пароль приложения (не обычный пароль от аккаунта)
MAIL_FROM=your_login@yandex.ru
MAIL_FROM_NAME=Cafe Booking System # Отображаемое имя отправителя
MAIL_USE_CREDENTIALS=true
MAIL_VALIDATE_CREDS=true

Сервис запускается в контейнерах, миграции выполняются отдельной командой

# Запуск контейнера из корневой папки проекта:
# Тихий режим (без логов в терминале):
docker compose -f infra/docker-compose.yml up -d --build
# Режим с выводом логов в терминале:
docker compose -f infra/docker-compose.yml up --build

# список контейнеров и их статус
docker compose -f infra/docker-compose.yml ps

# Вывод логов в терминал (для тихого режима)
docker compose -f infra/docker-compose.yml logs -f
# Остановить просмотр логов: Ctrl + C

После запуска сервиса:

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Если порт отличается — проверь infra/docker-compose.yml.

В проекте используется ролевая модель доступа. Роль пользователя хранится в поле role:

Точные ограничения по эндпоинтам см. в таблице “Основные запросы API” и в Swagger/ReDoc.

Полный перечень моделей, входных и выходных параметров можно изучить в Swagger UI или ReDoc.

При создании/обновлении кафе поле managers_id работает как синхронизация списка менеджеров, а не как “добавить одного”.

• Семантика replace (полная замена): переданный массив managers_id полностью заменяет текущий список менеджеров кафе.
  • Если передать только одного менеджера — все остальные будут удалены из связки с кафе.
  • Если передать пустой массив — у кафе станет 0 менеджеров (если это разрешено бизнес-логикой).
• Атомарность: обновление связей выполняется целиком (в транзакции): либо применяются все изменения, либо не применяется ничего.
• Валидации (ожидаемое поведение):
  • все managers_id должны быть валидными UUID;
  • пользователи должны существовать;
  • недопустимы дубли в списке;
  • (если предусмотрено) назначаемые пользователи должны иметь роль manager/admin.
• Права доступа: после синхронизации меняется набор пользователей, которые могут управлять конкретным кафе (и связанными ресурсами) — учитывайте это при интеграции.

Коллекция и сценарии лежат в postman_collection/:

• Cafe_booking.postman_collection.json — коллекция Postman
• README.md — инструкция по использованию
• 10 Создание бронирования.md — сценарий ручной проверки
• 20 Изменение бронирования.md — сценарий ручной проверки

├── .github
│   └── workflows
│       ├── style_check.yml
│       └── telegram-pr-notify.yml
├── infra
│   └── docker-compose.yml
├── logs
│   └── system
├── postman_collection
│   ├── 10 Создание бронирования.md
│   ├── 20 Изменение бронирования.md
│   ├── Cafe_booking.postman_collection.json
│   └── README.md
├── src
│   ├── actions
│   │   └── __init__.py
│   ├── auth
│   │   ├── __init__.py
│   │   ├── responses.py
│   │   └── views.py
│   ├── booking
│   │   ├── __init__.py
│   │   ├── constants.py
│   │   ├── crud.py
│   │   ├── dependencies.py
│   │   ├── enums.py
│   │   ├── lookup.py
│   │   ├── models.py
│   │   ├── schemas.py
│   │   ├── services.py
│   │   ├── validators.py
│   │   └── views.py
│   ├── cafes
│   │   ├── __init__.py
│   │   ├── cafe_scoped.py
│   │   ├── cafes_help_caches.py
│   │   ├── crud.py
│   │   ├── models.py
│   │   ├── responses.py
│   │   ├── schemas.py
│   │   ├── service.py
│   │   └── views.py
│   ├── celery
│   │   ├── tasks
│   │   │   ├── __init__.py
│   │   │   ├── admin_events.py
│   │   │   └── daily_reminders.py
│   │   ├── __init__.py
│   │   ├── asyncio_runner.py
│   │   ├── celery_app.py
│   │   ├── service.py
│   │   └── utils.py
│   ├── common
│   │   ├── logging
│   │   │   ├── logs
│   │   │   ├── __init__.py
│   │   │   ├── config.py
│   │   │   ├── decorators.py
│   │   │   ├── filters.py
│   │   │   ├── formatters.py
│   │   │   └── system_logger.py
│   │   ├── __init__.py
│   │   ├── exception_handlers.py
│   │   ├── exceptions.py
│   │   ├── responses.py
│   │   ├── schemas.py
│   │   └── super_user.py
│   ├── database
│   │   ├── revisions
│   │   │   ├── versions
│   │   │   │   └── 9a94f601510a_initial.py
│   │   │   ├── README
│   │   │   ├── env.py
│   │   │   └── script.py.mako
│   │   ├── __init__.py
│   │   ├── associations.py
│   │   ├── base.py
│   │   ├── models_imports.py
│   │   ├── service.py
│   │   └── sessions.py
│   ├── dishes
│   │   ├── __init__.py
│   │   ├── crud.py
│   │   ├── models.py
│   │   ├── router.py
│   │   ├── schemas.py
│   │   ├── services.py
│   │   ├── validators.py
│   │   └── views.py
│   ├── slots
│   │   ├── __init__.py
│   │   ├── crud.py
│   │   ├── models.py
│   │   ├── responses.py
│   │   ├── schemas.py
│   │   └── views.py
│   ├── tables
│   │   ├── __init__.py
│   │   ├── crud.py
│   │   ├── models.py
│   │   ├── responses.py
│   │   ├── schemas.py
│   │   └── views.py
│   ├── users
│   │   ├── __init__.py
│   │   ├── dependencies.py
│   │   ├── models.py
│   │   ├── responses.py
│   │   ├── schemas.py
│   │   ├── security.py
│   │   ├── services.py
│   │   ├── validators.py
│   │   └── views.py
│   ├── Dockerfile
│   ├── __init__.py
│   ├── api.py
│   ├── config.py
│   ├── main.py
│   ├── models.py
│   └── requirements.txt
├── tests
│   ├── conftest.py
│   └── test_db_session.py
├── .env.example
├── .gitignore
├── .pre-commit-config.yaml
├── README.md
├── alembic.ini
├── pyproject.toml
└── requirements_style.txt

Проект выполнен командой Team 4 (Яндекс Практикум).

• Михаил Ковалев — Team Lead, Backend-разработчик (Настройка проекта, Разработка базовых классов для моделей БД, базо��ый CRUD, Кэширование (Redis), Деплой на сервер, CI/CD) — GitHub: ohhaus — Telegram: @ohhaus
• Константин Клейников — Backend-разработчик (Модуль Bookings, Настройка связей с модулями Slots и Tables, Формирование Postman collection) — GitHub: kkleinikov — Telegram: @kkleinikov
• Никита Ефремчев — Backend-разработчик (Модули Cafes, Slots, Tables, Алгоритм синхронизации связей менеджер-кафе, Настройка Celery и разработка логики отправки уведомлений) — GitHub: StigTax — Telegram: @Nik_efr
• Владимир Игнатьев — Backend-разработчик (Модуль Dishes, Кастомизация исключений) — GitHub: Ignatev-V — Telegram: @V_Ignatev
• Евгений Бирюков — Backend-разработчик (Модуль Users) — GitHub: JinBir007 — Telegram: @Yfg007
• Максим Быстрых — Backend-разработчик (Логирование, модуль Actions) — GitHub: pro100max1996 — Telegram: @pro100maksim1996
• Сергей Гусев — Backend-разработчик (Модуль Media) — GitHub: SergeyGusev1 — Telegram: @magnatuch