Product_Trailer

Продукт-прицел

Это программное обеспечение дает представление о путешествии, совершенном продуктами по всем узлам вашей сети цепочек поставок.

Если вы когда -нибудь задумывались: «Откуда был получен этот продукт?» Или «Были ли возвращены продукты от этого клиента?», Тогда это программное обеспечение является тем, что вам нужно. Чтобы заставить его работать, все, что вам нужно, - это предоставить журнал извлечения всех движений, зарегистрированных в вашей системе, а PT позаботится об остальном.

Сгенерирована сетевая диаграмма:

Структура и использование

Чтобы запустить программное обеспечение: python main.py *your_profile_name*

Получите помощь:

... P roduct_Trailer > python main.py -h
usage: Product-Trailer [-h] [-r RAW_DIR] [-p RAW_PREFIX] [-ne] profile_name

Tracking products through supply-chain network by using product movement logs.

positional arguments:
  profile_name

options:
  -h, --help            show this help message and exit
  -r RAW_DIR, --raw-dir RAW_DIR
  -p RAW_PREFIX, --raw-prefix RAW_PREFIX
  -ne, --no-excel-report

Профили

Ваш профиль - это то, что определяет:

• Каков формат входных данных («Данные движения»)
• Как предварительно обработать его, чтобы соответствовать алгоритму
• Какой сигнал взять, чтобы начать отслеживать продукты
• Выводный отчет, который вы хотите получить от него: вывод Excel по умолчанию? С более подробной информацией? Графики? Вы решите!
• Многие другие параметры, такие как каталог, где хранить отчеты, имена файлов и т. Д.

Профили хранятся под ./profiles/ your_profile_name /

Для быстрого начала просто запустите команду python main.py *your_profile_name* . Программа автоматически создаст ваш профиль и обрабатывает обнаруженные файлы движений.

Чтобы позволить программе работать с вашими данными, вам, вероятно, потребуется настроить шаги предварительной обработки. Для этого скопируйте default_profile и отредактируйте файлы .py. Они были документированы, чтобы облегчить вашу работу.

(Дополнительная документация о типичной методологии использования, архитектуре программы, скриншотах, которые будут добавлены в ближайшее время)

Выход

По умолчанию выходные файлы записываются в корне вашего профиля: ./profiles/your_profile_name/

Пример вывода:
Пример выходного файла доступен в /Assets /

Установка и настройка

Шаг за шагом

1. Клонировать репозиторий git clone https://github.com/emmanuel-ch/Product_Trailer.git

2. Установите окружающую среду

   • Копия окружающую среду: conda env create -n protrail -f env.yml
   • Или любое другое среднее значение - см. Требования ниже

3. Необязательно: настроить свой профиль
   Профиль позволяет настроить входные файлы, обработку, выход. Если профиль не существует, по умолчанию один будет скопирован и используется.
   Профили хранятся под ./profiles/

4. Вы готовы к работе!

Требования

Разработано на Python 3.11.
Среда Conda может быть импортирована из Env.yml. Нестандартные пакеты используются:

• OpenPyxl
• Numpy
• Панды
• TQDM
• питест
• NetworkX
• matplotlib
• XLSX2CSV

Внося

Вы нашли это репо интересным, и вам это нравится? Не стесняйтесь связаться или поднять проблему!
Приглашать запросы. Для серьезных изменений, пожалуйста, сначала откройте проблему, чтобы обсудить, что вы хотели бы изменить.
Вы можете погрузиться в ...

• Используйте различные входные форматы (XML, JSON, SQL Connection и т. Д.)
• Улучшить тестовый набор
• Увеличить общую производительность (скорость, использование памяти)
• Предложить различные выходные форматы, включая графические представления
• Предложить класс ретротракера: трек -продукты в обратном направлении
• ...