Product_Trailer

Semi-remorque

Ce logiciel fournit des informations sur le parcours effectué par les produits à travers les nœuds de votre réseau de chaîne d'approvisionnement.

Si vous vous êtes déjà demandé "d'où ce produit était provenant?" ou "Les produits ont été renvoyés de ce client ont été mis au rebut?", Alors ce logiciel est ce dont vous avez besoin. Pour le faire fonctionner, tout ce dont vous avez besoin est de fournir un journal d'extrait de tous les mouvements enregistrés sur votre système, et PT s'occupera du reste.

Diagramme de réseau généré:

Cadre et utilisation

Pour exécuter le logiciel: python main.py *your_profile_name*

Obtenez de l'aide:

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

Profils

Votre profil est ce qui définit:

• Quel est le format des données d'entrée ("Données de mouvement")
• Comment le prétraiter pour s'aligner sur l'algorithme
• Quel signal à prendre, afin de commencer à suivre les produits
• Le rapport de sortie que vous souhaitez en tirer: la sortie Excel par défaut? Avec plus de détails? Graphiques? Vous décidez!
• De nombreux autres paramètres, tels que le répertoire où stocker les rapports, les noms de fichiers, etc.

Les profils sont stockés sous ./profiles/ your_profile_name /

Pour un démarrage rapide, exécutez simplement la commande python main.py *your_profile_name* . Le programme créera automatiquement votre profil et traitera les fichiers de mouvements détectés.

Pour permettre au programme de travailler avec vos données, vous devrez probablement personnaliser les étapes de prétraitement. Pour ce faire, copiez le default_profile et modifiez les fichiers .py. Ils ont été documentés pour faciliter votre travail.

(Documentation supplémentaire sur la méthodologie d'utilisation typique, l'architecture du programme, les captures d'écran à ajouter bientôt)

Sortir

Par défaut, les fichiers de sortie sont enregistrés à la racine de votre profil: ./profiles/your_profile_name/

Exemple de sortie:
Un exemple de fichier de sortie est disponible en / actifs /

Installation et configuration

Pas à pas

1. Clone The Repository git clone https://github.com/emmanuel-ch/Product_Trailer.git

2. Configurez votre environnement

   • En copiant l'environnement: conda env create -n protrail -f env.yml
   • Ou toute autre moyenne - voir les exigences ci-dessous

3. Facultatif: réglez votre profil
   Un profil vous permet de configurer les fichiers d'entrée, le traitement, la sortie. Si aucun profil n'existe, le par défaut sera copié et utilisé.
   Les profils sont stockés sous ./profiles/

4. Vous êtes prêt à partir!

Exigences

Développé sur Python 3.11.
L'environnement conda peut être importé de Env.yml. Packages non standard utilisés:

• openpyxl
• nombant
• pandas
• tqdm
• pytest
• NetworkX
• matplotlib
• xlsx2csv

Contributif

Vous avez trouvé ce dépôt intéressant et vous l'aimez? N'hésitez pas à nous contacter ou à soulever un problème!
Tirez les demandes de bienvenue. Pour les changements majeurs, veuillez d'abord ouvrir un problème pour discuter de ce que vous souhaitez changer.
Vous voudrez peut-être plonger dans ...

• Utilisez différents formats d'entrée (XML, JSON, connexion SQL, etc.)
• Améliorer la suite de tests
• Augmenter les performances globales (vitesse, utilisation de la mémoire)
• Proposer différents formats de sortie, y compris les représentations graphiques
• Proposer une classe Retrotracker: suivre les produits à l'envers
• ...