https://github.com/mikefromru/cash-register
Приложение кассовый аппарат который формирует PDF файл и генерирует QR-code с сылкой на это файл.
https://github.com/mikefromru/cash-register
art django django-environ django-rest-framework drf flake8 fpdf python-dotenv qrcode
Last synced: 16 days ago
JSON representation
Приложение кассовый аппарат который формирует PDF файл и генерирует QR-code с сылкой на это файл.
- Host: GitHub
- URL: https://github.com/mikefromru/cash-register
- Owner: mikefromru
- Created: 2023-12-08T15:08:41.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-15T12:39:42.000Z (over 2 years ago)
- Last Synced: 2025-01-21T07:43:15.692Z (over 1 year ago)
- Topics: art, django, django-environ, django-rest-framework, drf, flake8, fpdf, python-dotenv, qrcode
- Language: Python
- Homepage:
- Size: 944 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Cash-register (кассовый аппарат)
## _Добро пожаловать_
Cash-register это кассовый аппарат магазина. На серавер отправляется мотод POST с id товарами и затем формируется PDF файл и создается url на этот файл в QR-code, после чего отправляется ссылка в ответ на метод POST в котором содержется ссылка на QR-code. При переходе на ссылку сканируется QR-code, после чего можно скачать PDF файл (кассовый чек).
## Технологии
Cash-register использует технологии с открытым исходным кодом для работы:
- Django - это высокоуровневый Python веб-фреймворк!
- Django rest framework - это мощный набор инструментов для создания веб-сервисов и API на основе фреймворка Django.
- Djanog-environ - позволяет использовать переменные среды.
- Fpdf - библиотека для создания PDF.
- Qrcode - библиотека для генерации QR кодов.
- Art - библиотека для генерации ASCII-графики и текстовых изображений.
- Simple Term Menu - меню для консольных программ
## Переменные окружения
Создать файл .env в корне проекта с необходимыми переменными. Рекомендуется использовать IP адрес комьютера локальной сети чтобы выла возможность протестировать на мобильном телефоне.
ipconfig или ifconfig отобразят ip вашего комьютера в локальной сети.
+ Пример ALLOWED_HOSTS должен выглядеть примерно так `192.168.0.1`.
+ Пример SITE_URL должен выглядеть примерно так `http://192.168.0.1:8000/`
```
SECRET_KEY=
ALLOWED_HOSTS=
SITE_URL=
```
## Установка
Cash-register использует [Python](https://python.org/) вирсия 3+.
Установка зависимостей и запуск приложения.
```sh
cd cash-register
python install -r requirements.txt
python manage.py migrate
python manage.py runserver {your_ip_address}:8000
```
## Использование
- Отправить список ids формат JSON `{'items': [1, 2, 3]}` POST `/cash-machine`
- Запустить консольного клиента из корня проекта **python client.py**
## Для чего создан этот проект
Этот проект создан в качестве тестового задания. Возможно в будущем он будет развиваться и будет поддерживаться разработчиками.