Product_Trailer

Reboque de produtos

Este software fornece informações sobre a jornada realizada pelos produtos ao longo dos nós da sua rede de cadeia de suprimentos.

Se você já se perguntou "de onde este produto foi proveniente?" ou "Os produtos retornaram desse cliente?", Então este software é o que você precisa. Para fazer funcionar, tudo o que você precisa é fornecer um registro de extração de todos os movimentos registrados no seu sistema e o PT cuidará do restante.

Diagrama de rede gerado:

Estrutura e uso

Para executar o software: python main.py *your_profile_name*

Obtenha ajuda:

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

Perfis

Seu perfil é o que define:

• Qual é o formato dos dados de entrada ("dados de movimentos")
• Como pré-processá-lo para alinhar com o algoritmo
• Qual sinal de tomar, para começar a rastrear produtos
• O relatório de saída que você deseja obter dele: a saída padrão do Excel? Com mais detalhes? Gráficos? Você decide!
• Muitos outros parâmetros, como o diretório onde armazenar relatórios, nomes de arquivos, etc.

Os perfis são armazenados em ./profiles/ your_profile_name /

Para uma partida rápida, basta executar o comando python main.py *your_profile_name* . O programa criará automaticamente seu perfil e processará os arquivos de movimentos detectados.

Para permitir que o programa trabalhe com seus dados, você provavelmente precisará personalizar as etapas de pré -processamento. Para fazer isso, copie o default_profile e edite os arquivos .py. Eles foram documentados para facilitar seu trabalho.

(Documentação adicional sobre metodologia de uso típica, arquitetura do programa, capturas de tela a serem adicionadas em breve)

Saída

Por padrão, os arquivos de saída são gravados na raiz do seu perfil: ./profiles/your_profile_name/

Exemplo de saída:
Um exemplo de arquivo de saída está disponível em /ativos /

Instalação e configuração

Passo a passo

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

2. Configure seu ambiente

   • Copiando o ambiente: conda env create -n protrail -f env.yml
   • Ou qualquer outra média - veja os requisitos abaixo

3. Opcional: ajuste seu perfil
   Um perfil permite configurar os arquivos de entrada, o processamento, a saída. Se não houver perfil, o padrão será copiado e usado.
   Os perfis são armazenados em ./profiles/

4. Você está pronto para ir!

Requisitos

Desenvolvido no Python 3.11.
O ambiente do CONDA pode ser importado do Env.yml. Pacotes não padrão usados:

• OpenPyxl
• Numpy
• Pandas
• TQDM
• Pytest
• Networkx
• matplotlib
• XLSX2CSV

Contribuindo

Você achou esse repo interessante e gosta? Sinta -se à vontade para entrar em contato ou para levantar um problema!
Pull Pedidos bem -vindos. Para grandes mudanças, abra um problema primeiro para discutir o que você gostaria de mudar.
Você pode querer mergulhar em ...

• Use diferentes formatos de entrada (XML, JSON, conexão SQL, etc.)
• Melhorar o conjunto de testes
• Aumentar o desempenho geral (velocidade, uso da memória)
• Propor diferentes formatos de saída, incluindo representações gráficas
• Propor uma classe retrotracker: rastrear produtos para trás
• ...