Market API

Market API, написанный на Fast API, который позволяет регистрироваться покупателям, продавцам. Создание компании для продажи товаров, карточки продукта, добавление менеджеров для ведения компании с ограниченными правами.

Реализована отправка писем для подтверждения почты через микросервис задач Celery.

Безопасность конечных точек обеспечена при помощи аутентификации с JWT-токенами (access и refresh), а так же ролевому доступу к операциям. Создана конечная точка для обновления пары JWT-токенов.

Используемые технологии

Содержание

• Особенности
• Установка
• Документация

Особенности

• Регистрация и аутентификация пользователей (JWT)
• PostgreSQL в качестве базы данных проекта
• SQLAlchemy Admin для администрирования базы данных
• Миграции базы данных с использованием Alembic
• Celery и Flower для отправки писем на почту
• Использование Docker-контейнеров для удобного развертывания

Установка

Системные требования:

Протестировать на своем локальном сервере:

1. Клонируйте репозиторий;
2. Перейдите (cd) в клонированный каталог и создайте виртуальное окружение Python (Virtual environment, venv);
3. Активируйте venv и установите pip и все зависимости из requirements.txt;

sudo apt install python3-pip
pip install -r requirements.txt

4. Совершите миграцию с помощью Alembic:

alembic upgrade head

5. Скопируйте .env-example под именем .env, откройте его и заполните переменные;
6. Запустите через командную строку redis:

redis-server

7. Внутри активированного venv:

python3 -m app

Запуск проекта на сервере с Docker

1. Переименуйте файл .env-example в .env, откройте и заполните переменные;
2. Запустите бота:

docker compose up -d

3. Проверьте, что контейнер поднялся:

docker compose ps

Документация

• API (Swagger UI) - http://localhost:8000/docs

Админ панель

• Админка (SQLAlchemy Admin) - http://localhost:8000/admin

Flower интерфейс

• Celery (Flower) - http://localhost:9999