fior-analytics 1.0.0__py3-none-any.whl

fior/__init__.py

@@ -0,0 +1,74 @@
+"""
+Fator de Impacto Operacional no Recebimento (FIOR)
+Módulo Central do Pacote Analítico
+
+Autor: Robespierre Santana Silva
+Ano: 2026
+Licença: MIT
+"""
+
+import pandas as pd
+import os
+from datetime import datetime
+
+# Define o que será exportado publicamente quando alguém usar: from fior import *
+__all__ = ['calcular_fior_unidade', 'mapear_zona_criticidade', 'processar_fior_lote']
+__version__ = "1.0.0"
+
+def calcular_fior_unidade(urgencia, divergencia, qualidade, ambiente):
+    """
+    Executa a computação matemática isolada da fórmula ponderada do FIOR.
+    Notas de entrada devem ser inteiros ou floats entre 1 e 5.
+    """
+    for nota in [urgencia, divergencia, qualidade, ambiente]:
+        if not (1 <= nota <= 5):
+            raise ValueError("As notas de entrada devem obedecer ao intervalo discreto de 1 a 5.")
+            
+    # Pesos Oficiais da Metodologia FIOR
+    w = [0.4, 0.3, 0.2, 0.1]
+    fior_calculado = (urgencia * w[0]) + (divergencia * w[1]) + (qualidade * w[2]) + (ambiente * w[3])
+    return round(fior_calculado, 2)
+
+
+def mapear_zona_criticidade(score_fior):
+    """Mapeia o resultado numérico contínuo nas zonas discretas de impacto."""
+    if 1.0 <= score_fior <= 2.2:
+        return "🟢 Zona Verde (Baixo Impacto)"
+    elif 2.3 <= score_fior <= 3.7:
+        return "🟡 Zona Amarela (Médio Impacto)"
+    else:
+        return "🔴 Zona Vermelha (Gestão de Crise)"
+
+
+def processar_fior_lote(caminho_planilha_entrada):
+    """
+    Carrega banco de dados em lote (.xlsx ou .csv), aplica a equação matemática
+    vetorizada via Pandas e exporta o consolidado analítico.
+    """
+    if not os.path.exists(caminho_planilha_entrada):
+        raise FileNotFoundError(f"Arquivo '{caminho_planilha_entrada}' não localizado.")
+
+    if caminho_planilha_entrada.endswith('.xlsx'):
+        df = pd.read_excel(caminho_planilha_entrada)
+    else:
+        df = pd.read_csv(caminho_planilha_entrada, sep=';', encoding='utf-8')
+
+    colunas_obrigatorias = ['F_urg', 'F_div', 'F_qual', 'F_amb']
+    if not all(col in df.columns for col in colunas_obrigatorias):
+        raise KeyError(f"A planilha deve conter as colunas: {colunas_obrigatorias}")
+
+    w_urg, w_div, w_qual, w_amb = 0.4, 0.3, 0.2, 0.1
+
+    df['Resultado_FIOR'] = (
+        (df['F_urg'] * w_urg) + 
+        (df['F_div'] * w_div) + 
+        (df['F_qual'] * w_qual) + 
+        (df['F_amb'] * w_amb)
+    ).round(2)
+
+    df['Classificacao_FIOR'] = df['Resultado_FIOR'].apply(mapear_zona_criticidade)
+    df['Timestamp_Processamento'] = datetime.now().strftime('%d/%m/%Y %H:%M:%S')
+
+    arquivo_saida = "fior_resultados_consolidados.xlsx"
+    df.to_excel(arquivo_saida, index=False)
+    return arquivo_saida

fior_analytics-1.0.0.dist-info/METADATA

@@ -0,0 +1,56 @@
+Metadata-Version: 2.4
+Name: fior-analytics
+Version: 1.0.0
+Summary: Indicador analítico e modelo matemático para impacto operacional no recebimento de materiais.
+Home-page: https://github.com/pierre1567/fior
+Author: Pierre
+Author-email: seu_email@exemplo.com
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: pandas>=1.0.0
+Requires-Dist: openpyxl>=3.0.0
+Dynamic: license-file
+
+# FIOR - Fator de Impacto Operacional no Recebimento 📊🚚
+
+O **FIOR** é uma metodologia analítica e matemática autoral desenvolvida para quantificar a complexidade operacional instantânea enfrentada por equipes de recebimento e conferência de materiais em almoxarifados industriais e centros de distribuição.
+
+Ao contrário de indicadores tradicionais como o OTIF (que avalia o fornecedor) ou o Tempo de Ciclo (que apenas cobra velocidade da equipe), o FIOR mede o grau de impacto que variáveis externas e imprevistos têm sobre a eficiência do setor.
+
+---
+
+## 📐 A Formulação Matemática
+
+O modelo utiliza a abordagem de Análise Multicritério de Decisão (MCDM) com uma estrutura de ponderação linear restrita:
+
+$$FIOR = (F_{urg} \times 0.4) + (F_{div} \times 0.3) + (F_{qual} \times 0.2) + (F_{amb} \times 0.1)$$
+
+Onde cada fator recebe uma nota discreta de 1 a 5 com base no cenário real do pátio:
+* **F_urg (Urgência):** Severidade da demanda (ex: item de máquina parada ou estoque de rotina).
+* **F_div (Divergência):** Complexidade fiscal, cadastral ou documental da Nota Fiscal.
+* **F_qual (Qualidade):** Nível de exigência na conferência física (itens sem identificação, avarias).
+* **F_amb (Ambiente):** Estado da infraestrutura e estresse físico (chuva, queda de sistema, pátio saturado).
+
+---
+
+## 🟢 Matriz de Criticidade (Zonas de Impacto)
+
+O resultado final do FIOR varia de **1.0 a 5.0**, classificando a operação em três zonas de criticidade:
+
+* **De 1.0 a 2.2 | Zona Verde (Baixo Impacto):** Fluxo padrão, sem gargalos.
+* **De 2.3 a 3.7 | Zona Amarela (Médio Impacto):** Operação impactada, exigindo tratativas burocráticas ou esforço extra de conferência.
+* **De 3.8 a 5.0 | Zona Vermelha (Gestão de Crise):** Caos operacional. Justifica quedas bruscas na produtividade e exige atuação da liderança.
+
+---
+
+## 💻 Implementação Automatizada com Python (`pandas`)
+
+O projeto conta com um script em Python que automatiza o cálculo em lote. Ele lê uma planilha comum do Excel contendo os registros de Notas Fiscais e as respectivas notas dos fatores, injeta a lógica matemática e gera um relatório consolidado com os resultados e classificações.
+
+### Pré-requisitos
+```bash
+pip install pandas openpyxl

fior_analytics-1.0.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+fior/__init__.py,sha256=3KUkMb5zgpYXLO0qDHB3T-Z3rNvHQCRI--6BuAABsQI,2772
+fior_analytics-1.0.0.dist-info/licenses/LICENSE.txt,sha256=_isfZKL9AliWTUSB5DM2XWLSM4d2hBW3ZGHexC7RGuM,1101
+fior_analytics-1.0.0.dist-info/METADATA,sha256=dhxODrndu9oUHWvzekYVDTW3oq98YpaTYncjHnj57JQ,2910
+fior_analytics-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+fior_analytics-1.0.0.dist-info/top_level.txt,sha256=5gXrGRTGkZA3hq6VSZLf8J2n_3e13MCbJPuFzcWA8vM,5
+fior_analytics-1.0.0.dist-info/RECORD,,

fior_analytics-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fior_analytics-1.0.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Robespierre Santana Silva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fior_analytics-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+fior