-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
7edcb98
commit d82fa78
Showing
3 changed files
with
138 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1 +1,138 @@ | ||
# marketplace-API-template | ||
# marketplace-API-template | ||
|
||
Данное проект предназначен для реализации HTTP запросов и направлен на использование в маркетплейсах. | ||
|
||
## Стек технологий: | ||
- python | ||
- django | ||
- djangorestframework | ||
- python-dotenv | ||
- psycopg2-binary | ||
- djangorestframework-simplejwt | ||
- drf-yasg | ||
- coverage | ||
- flake8 | ||
- django-extensions | ||
- ipython | ||
- django-filter | ||
- pillow | ||
- pyparsing | ||
- pydot | ||
- django-cors-headers | ||
|
||
|
||
## Установка | ||
Прежде чем начать использовать Marketplace API, убедитесь, что у вас установлен | ||
интерпретатор Python c версией не ниже 3.9: | ||
|
||
Клонируйте репозиторий с помощью следующей команды: | ||
```bash | ||
git clone git@github.com:Abramov0Alexandr/marketplace-API-template.git | ||
``` | ||
|
||
Перейдите в директорию проекта: | ||
```bash | ||
cd marketplace-API-template | ||
``` | ||
|
||
Активируйте виртуальное окружение Poetry и установите зависимости: | ||
|
||
```bash | ||
poetry init | ||
``` | ||
|
||
```bash | ||
poetry shell | ||
``` | ||
|
||
```bash | ||
poetry install | ||
``` | ||
|
||
Создайте и примените миграции для базы данных: | ||
|
||
```bash | ||
python manage.py migrate | ||
``` | ||
|
||
|
||
Запустите сервер: | ||
```bash | ||
python manage.py runserver | ||
``` | ||
|
||
Теперь приложение доступно по адресу http://localhost:8000/. | ||
|
||
|
||
## Регистрация | ||
Для регистрации в сервисе необходимо отправить POST-запрос на эндпоинт users/create/. | ||
В зависимости от выбора регистрации пользователя необходимо передать следующие данные: | ||
|
||
1. Регистрация как обычный пользователь: | ||
- first_name: Ваше имя. | ||
- last_name: Ваша фамилия. | ||
- patronymic (необязательно): Ваше отчество (если есть). | ||
- email: Ваша почта. | ||
- password: Пароль для входа. | ||
- password_confirmation: Подтверждение пароля. | ||
- is_seller: Оставьте поле пустым или укажите false, чтобы зарегистрироваться как обычный пользователь. | ||
|
||
|
||
2. Регистрация в качестве продавца: | ||
- email: Ваша почта. | ||
- shop_name: Название магазина. | ||
- password: Пароль для входа. | ||
- password_confirmation: Подтверждение пароля. | ||
- is_seller: Укажите true, чтобы зарегистрироваться как продавец. | ||
|
||
|
||
## Возможности API | ||
Наш проект предоставляет следующие возможности через API: | ||
|
||
1. Идентификация и авторизация: | ||
- Регистрация новых пользователей (как обычных, так и продавцов). | ||
- Авторизация пользователей. | ||
- Получение JWT-токенов для аутентификации. | ||
|
||
|
||
2. Создание и управление товарами: | ||
- Создание нового товара. | ||
- Просмотр списка товаров. | ||
- Просмотр детальной информации о товаре. | ||
- Редактирование и удаление товаров (доступно только продавцам). | ||
- Снятие или вывод товара в продажу (доступно только продавцам). | ||
|
||
|
||
## Схемы моделей и их взаимосвязей | ||
Полная схема моделей | ||
|
||
![Полная схема моделей](models_schemes/full_scheme.png) | ||
|
||
Схема кастомных моделей | ||
|
||
![Схема кастомных моделей](models_schemes/my_project_subsystem.png) | ||
|
||
## Документация | ||
Документацию к API вы можете найти перейдя по следующим ссылкам:<br> | ||
http://127.0.0.1:8000/swagger/ <br> | ||
http://127.0.0.1:8000/redoc/ | ||
|
||
## Тестирование | ||
Для запуска тестов используйте следующую команду: | ||
|
||
```bash | ||
python manage.py test | ||
``` | ||
|
||
## Лицензия | ||
Marketplace API распространяется по [MIT License](https://opensource.org/licenses/MIT). | ||
|
||
## Контакты | ||
|
||
Спасибо за использование Marketplace API! Если у вас есть какие-либо вопросы или предложения, не стесняйтесь обращаться к нам. | ||
|
||
Автор: [Alexandr Abramov <https://github.com/Abramov0Alexandr>] | ||
|
||
Связь: [alexandr.abramovv@gmail.com]https://github.com/Abramov0Alexandr) | ||
|
||
GitHub: [https://github.com/Abramov0Alexandr] |
File renamed without changes
File renamed without changes