📚 Pré-requisitos Teóricos: este projeto aplica conceitos ensinados na Matriz de 20 Capítulos de Aplicações Full Stack. Recomendado revisar antes de iniciar a execução.

📦 PI 05 — StockFlow: Gestão de Estoque Digital & Logística

v1.0 — Projeto Integrador Full Stack para acurácia de inventário, classificação por Curva ABC, cálculo de ponto de ressuprimento e conferência cega de mercadorias.

Trilha de Especialização Pedagógica — Série Projetos Integradores (PI 5 de 6)

• PI 01: ParkManager (Gestão de Vagas, Tarifação e Caixa)
• PI 02: SafePass Corporate (Cofre de Senhas, Criptografia e LGPD)
• PI 03: ChefPoint (Comanda Digital e KDS Restaurante)
• PI 04: TechBorrow (Empréstimo de Dispositivos de TI)
• PI 05 (este): StockFlow (Almoxarifado Inteligente, Curva ABC e Ponto de Pedido)
• PI 06: QuickDrop (Roteamento Expresso de Delivery)

🎓 Nível Profissional Simulado: Arquiteto de Software Logístico / Desenvolvedor Full Stack. A gestão física e financeira de estoques depende de acurácia acima de 98%. Dominar algoritmos de reabastecimento (Ponto de Pedido, Lote Econômico de Compras e Estoque de Segurança) integrados a interfaces visuais ágeis assegura operações industriais e atacadistas sem rupturas.

🏛️ Galeria Arquitetural & Diagramas de Engenharia

Arquitetura de Logística e Camadas de Almoxarifado

Diagrama de Casos de Uso Formal (UML)

📁 Estrutura Canônica de Pastas Anti-Colisão

O projeto adota a convenção padronizada de subpastas por camada e tecnologia <camada>-<tecnologia>:

catalogo_projetos/fullstack_pi_05_stockflow/
├── web-react/                  # Aplicação SPA moderna em React 18, Vite e TailwindCSS
│   ├── src/
│   │   ├── components/         # InventoryGrid, BlindAuditModal, ABCChart, ReorderAlert
│   │   ├── types/              # Definições TypeScript de Produto, Movimento, Curva ABC
│   │   ├── utils/              # Cálculos estatísticos de giro e ponto de ressuprimento
│   │   ├── App.tsx             # Gerenciamento de estado de inventário
│   │   └── main.tsx            # Inicializador da SPA
│   ├── package.json            # Scripts de build, ícones Lucide e Tailwind
│   └── vite.config.ts          # Configuração do Vite
├── assets/                     # Galeria de diagramas vetoriais SVG autorais
├── README.md                   # Resumo executivo do projeto
└── Gestao_Estoque_Documentacao_Final.md # Especificação acadêmica e modelagem física

🧑‍💼 Especificação Formal de Engenharia de Software

1. Histórias de Usuário (User Stories)

• US-SF01: Como estoquista de recebimento, quero bipar caixas em processo de “conferência cega” sem visualizar previamente a quantidade da NF para evitar vícios de contagem.
• US-SF02: Como analista de compras, quero visualizar o gráfico da Curva ABC categorizando produtos em Classe A (alto valor), B (médio) e C (baixo).
• US-SF03: Como gestor de almoxarifado, quero receber alerta automático assim que o saldo de um item atingir o Ponto de Pedido (PP).
• US-SF04: Como conferente, quero registrar avarias e devoluções com baixa imediata do estoque comercializável.
• US-SF05: Como auditor financeiro, quero exportar o relatório de valor total imobilizado em estoque por categoria de produto.

2. Requisitos Funcionais (RF)

• RF-SF01: O sistema deve registrar produtos com código de barras (EAN-13), descrição, localização física (rua/prateleira), custo e saldo atual.
• RF-SF02: A interface de conferência de entrada deve comparar a contagem física com o manifesto XML da nota fiscal, emitindo relatório de divergências.
• RF-SF03: O módulo estatístico deve calcular automaticamente a Curva ABC com base no valor acumulado de movimentação nos últimos 90 dias.
• RF-SF04: O sistema deve calcular o Ponto de Pedido utilizando a fórmula: $PP = (Consumo\ Diário \times Lead\ Time) + Estoque\ de\ Segurança$.
• RF-SF05: O painel deve fornecer exportação consolidada em formatos CSV e JSON para conciliação com sistemas ERP.

3. Requisitos Não-Funcionais (RNF)

• RNF-SF01 (Acurácia de Dados): O sistema deve garantir zero inconsistência em atualizações de saldo através de operações atômicas.
• RNF-SF02 (Escalabilidade de Catálogo): O catálogo deve suportar renderização fluida com paginação virtualizada para mais de 5.000 SKUs ativos.
• RNF-SF03 (Compatibilidade com Leitores de Código): A interface deve capturar eventos de entrada de leitores de código de barras USB/Bluetooth em qualquer campo focalizado.
• RNF-SF04 (Resiliência Local): As contagens de inventário em andamento devem ser mantidas em cache local protegendo contra travamentos de navegador.
• RNF-SF05 (Padrões de Interface): O design system deve utilizar paleta semântica estrita para níveis de estoque (verde: normal, amarelo: atenção, vermelho: ruptura).

📐 Diagrama de Casos de Uso (Mermaid)

flowchart LR
    subgraph Atores
        Conferente["📦 Conferente / Estoquista"]
        Comprador["💼 Analista de Compras"]
        Auditor["📊 Auditor de Estoque"]
    end

    subgraph "Sistema StockFlow"
        UC01["UC01: Realizar Conferência Cega"]
        UC02["UC02: Consultar Curva ABC"]
        UC03["UC03: Monitorar Ponto de Pedido"]
        UC04["UC04: Registrar Baixa de Avarias"]
        UC05["UC05: Exportar Balanço Patrimonial"]
    end

    Conferente --> UC01
    Conferente --> UC04
    Comprador --> UC02
    Comprador --> UC03
    Auditor --> UC05

📊 Matriz de Rastreabilidade de Requisitos (RTM)

🚀 Roteiro de Execução & Homologação no Laboratório

1. Inicialização do Frontend StockFlow (web-react)

cd catalogo_projetos/fullstack_pi_05_stockflow/web-react

# Instalação dos pacotes
npm install

# Inicialização do servidor Vite
npm run dev

• A interface estará acessível em: http://localhost:5173.

2. Leitura da Documentação Técnica

• Consulte o documento completo em: Gestao_Estoque_Documentacao_Final.html para formulação matemática do Lote Econômico e scripts DDL.

🧪 Matriz de Checkpoints de Homologação (CP-01 a CP-05)