Product_Trailer

Produktverkehr

Diese Software bietet Einblicke in die Reise von Produkten in Knoten Ihres Versorgungskettennetzes.

Wenn Sie sich jemals gefragt haben: "Woher wurde dieses Produkt bezogen?" oder "Wurden Produkte von diesem Kunden zurückgegeben?", Dann ist diese Software das, was Sie benötigen. Um es zum Laufen zu bringen, müssen Sie lediglich ein Extraktprotokoll aller in Ihrem System registrierten Bewegungen bereitstellen, und PT kümmert sich um den Rest.

Netzwerkdiagramm generiert:

Framework & Nutzung

So führen Sie die Software aus: python main.py *your_profile_name*

Holen Sie sich Hilfe:

... 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

Profile

Ihr Profil definiert:

• Was ist das Format der Eingabedaten ("Bewegungsdaten")
• Wie man es vorbearbeitet, um sich mit dem Algorithmus auszurichten
• Welches Signal einnehmen, um die Verfolgung von Produkten zu beginnen
• Der Ausgabebericht, den Sie davon erhalten möchten: Die Standard -Excel -Ausgabe? Mit weiteren Details? Grafiken? Sie entscheiden!
• Viele andere Parameter, wie das Verzeichnis, in dem Berichte, Dateinamen usw. gespeichert werden sollen, usw.

Profile werden unter ./profiles/ your_profile_name / gespeichert/

Führen Sie für einen Schnellstart einfach den Befehl python main.py *your_profile_name* aus. Das Programm erstellt automatisch Ihr Profil und verarbeitet die erkannten Bewegungsdateien.

Damit das Programm mit Ihren Daten arbeiten kann, müssen Sie wahrscheinlich die Vorverarbeitungsschritte anpassen. Kopieren Sie dazu die Default_profile und bearbeiten Sie die .py -Dateien. Sie wurden dokumentiert, um Ihre Arbeit zu erleichtern.

(Zusätzliche Dokumentation zu typischen Nutzungsmethoden, Programmarchitektur und Screenshots, die bald hinzugefügt werden sollen)

Ausgabe

Standardmäßig werden Ausgabedateien im Root Ihres Profils aufgezeichnet: ./profiles/your_profile_name/

Beispielausgabe:
Eine Beispielausgabedatei ist in /assets /verfügbar /assets /

Installation und Setup

Schritt für Schritt

1. Klonen des Repository git clone https://github.com/emmanuel-ch/Product_Trailer.git

2. Richten Sie Ihre Umgebung ein

   • Durch Kopieren der Umwelt: conda env create -n protrail -f env.yml
   • Oder einen anderen Mittelwert - siehe Anforderungen unten

3. Optional: Stimmen Sie Ihr Profil ein
   Mit einem Profil können Sie die Eingabedateien, die Verarbeitung und die Ausgabe konfigurieren. Wenn kein Profil vorhanden ist, wird der Standardkopie kopiert und verwendet.
   Profile werden unter ./Profiles/ gespeichert

4. Du bist bereit zu gehen!

Anforderungen

Entwickelt auf Python 3.11.
Die Konda -Umgebung kann von env.yml importiert werden. Nicht standardmäßige Pakete verwendet:

• openpyxl
• Numpy
• Pandas
• tqdm
• Pytest
• NetworkX
• Matplotlib
• XLSX2CSV

Beitragen

Sie haben dieses Repo interessant gefunden und gefällt es? Fühlen Sie sich frei, sich in Verbindung zu setzen oder ein Problem anzusprechen!
Anfragen willkommen geheißen. Für wichtige Änderungen öffnen Sie zuerst ein Problem, um zu besprechen, was Sie ändern möchten.
Vielleicht möchten Sie in ...

• Verwenden Sie verschiedene Eingangsformate (XML, JSON, SQL -Verbindung usw.)
• Testsuite verbessern
• Erhöhen Sie die Gesamtleistung (Geschwindigkeit, Speicherverbrauch)
• Schlagen Sie verschiedene Ausgangsformate vor, einschließlich grafischer Darstellungen
• Schlagen Sie eine Retrotracker -Klasse vor: Verfolgen Sie Produkte rückwärts
• ...