Product_Trailer

Tronco de productos

Este software proporciona información sobre el viaje realizado por productos en todos los nodos de su red de cadena de suministro.

Si alguna vez se preguntó "¿de dónde se obtuvo este producto?" o "¿Han devuelto los productos de este cliente?", Entonces este software es lo que necesita. Para que funcione, todo lo que necesita es proporcionar un registro de extracto de todos los movimientos registrados en su sistema, y ​​PT se encargará del resto.

Diagrama de red generado:

Marco y uso

Para ejecutar el software: python main.py *your_profile_name*

Obtenga ayuda:

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

Perfiles

Tu perfil es lo que define:

• ¿Cuál es el formato de los datos de entrada ("datos de movimientos")
• Cómo preprocesarlo para alinearse con el algoritmo
• Qué señal tomar, para comenzar a rastrear productos
• El informe de salida que desea obtener: ¿la salida de Excel predeterminada? Con más detalles? Gráficos? ¡Decides!
• Muchos otros parámetros, como el directorio donde almacenar informes, nombres de archivo, etc.

Los perfiles se almacenan en ./profiles/ your_profile_name /

Para una salida rápida, simplemente ejecute el comando python main.py *your_profile_name* . El programa creará automáticamente su perfil y procesará los archivos de movimientos detectados.

Para permitir que el programa funcione con sus datos, es probable que necesite personalizar los pasos de preprocesamiento. Para hacerlo, copie el default_profile y edite los archivos .py. Han sido documentados para facilitar su trabajo.

(Documentación adicional sobre la metodología de uso típica, la arquitectura del programa, las capturas de pantalla que se agregarán pronto)

Producción

Por defecto, los archivos de salida se registran en la raíz de su perfil: ./profiles/your_profile_name/

Salida de ejemplo:
Un archivo de salida de ejemplo está disponible en /activos /

Instalación y configuración

Paso a paso

1. Clon el repositorio git clone https://github.com/emmanuel-ch/Product_Trailer.git

2. Configurar su entorno

   • Copiando el entorno: conda env create -n protrail -f env.yml
   • O cualquier otra media: consulte los requisitos a continuación

3. Opcional: sintonice su perfil
   Un perfil le permite configurar los archivos de entrada, el procesamiento, la salida. Si no existe un perfil, el predeterminado se copiará y usará.
   Los perfiles se almacenan bajo ./profiles/

4. ¡Estás listo para ir!

Requisitos

Desarrollado en Python 3.11.
El entorno de conda se puede importar de env.yml. Paquetes no estándar utilizados:

• OpenPyxl
• numpy
• pandas
• TQDM
• pytest
• redx
• mate
• xlsx2csv

Que contribuye

¿Encontraste este repositorio interesante y te gusta? ¡No dude en ponerse en contacto o plantear un problema!
Solicitudes de bienvenida. Para cambios importantes, abra primero un problema para discutir lo que le gustaría cambiar.
Es posible que desee sumergirse en ...

• Use diferentes formatos de entrada (XML, JSON, conexión SQL, etc.)
• Mejorar la suite de prueba
• Aumentar el rendimiento general (velocidad, uso de la memoria)
• Proponer diferentes formatos de salida, incluidas representaciones gráficas
• Proponer una clase RetroTracker: Track Products al revés
• ...