README

Abaixo, apresento a estruturação técnica detalhada, aplicando os princípios de Engenharia de Software e Banco de Dados compatíveis com o ecossistema acadêmico.

1. Contexto do Projeto

• Título: Sistema de Gerenciamento de Estoque Digital.
• Objetivo: Gerenciar o controle de entrada, saída e a organização dos produtos em estoque de forma automatizada.
• Problema a Resolver: Eliminar erros recorrentes do controle manual de mercadorias e otimizar a organização logística.
• Público-alvo: Pequenos estabelecimentos ou almoxarifados que necessitam de uma solução simples e eficiente.

2. Engenharia de Software

2.1 Requisitos Funcionais (RF)

• RF-001: O sistema deve permitir o registro de entrada de novos produtos (nome e quantidade).
• RF-002: O sistema deve permitir o registro de saída de produtos do estoque.
• RF-003: O sistema deve disponibilizar uma função de consulta para verificar a disponibilidade de produtos.
• RF-004: O sistema deve atualizar o saldo total automaticamente após cada operação de entrada ou saída.

2.2 Requisitos Não Funcionais (RNF)

• RNF-001 (Integridade): O sistema deve garantir que não existam quantidades negativas no estoque.
• RNF-002 (Usabilidade): A interface deve ser focada em buscas rápidas para facilitar a consulta durante a operação.

2.3 Diagrama de Casos de Uso (UML)

O fluxo foca na simplicidade operacional para evitar o retrabalho do controle manual.

Versão em SVG (Diagrama de Casos de Uso):

3. Banco de Dados (MySQL)

Utilizando a stack que você aplica em seus planos de aula (Java/MySQL), a estrutura de dados é desenhada para ser leve e escalável.

3.1 Modelo Entidade-Relacionamento (MER)

3.2 Melhorias Sugeridas Implementadas

Para elevar o projeto de uma simples planilha para um sistema profissional de engenharia:

• Histórico de Movimentação: Adição de uma tabela de log para rastrear quem alterou o estoque e quando, aumentando a segurança.
• Alerta de Estoque Baixo: Implementação de uma sinalização visual (cor vermelha) na interface quando um produto atingir uma quantidade mínima crítica.
• Normalização: Separação entre o cadastro do produto e o fluxo de movimentação para manter a integridade dos dados históricos.

4. Prompt para Google Stitch: Interface "StockFlow"

Copie e cole este comando no Google Stitch para gerar a prototipagem rápida da interface:

Atuar como: Designer de UI focado em sistemas ERP e Logística. Contexto: Criar a interface para o projeto "StockFlow" — Gerenciamento de Estoque Digital. A interface deve ser baseada em Java/Spring Boot para o back-end e HTML5/CSS3 para o front-end. Componentes Necessários:

1. Dashboard de Resumo: Cards com "Total de Itens em Estoque", "Produtos Esgotados" e "Movimentações Hoje".
2. Barra de Consulta: Campo de busca proeminente para localizar produtos pelo nome e verificar quantidade disponível.
3. Módulo de Lançamento: Formulário simples para registrar entradas e saídas, selecionando o produto e a quantidade.
4. Lista de Inventário: Tabela exibindo o nome do produto e a quantidade atual, com cores de destaque para itens com poucas unidades.

Estilo: Visual "Industrial Clean" com tons de cinza, branco e acenos em azul corporativo para passar seriedade e organização.

Este projeto está pronto para ser documentado em seus fluxos de Markdown ou integrado a um monorepo de ensino.

Com base nas diretrizes de Engenharia de Software e na sua experiência em arquiteturas de sistemas integrados, apresento o detalhamento técnico avançado do projeto Gerenciamento de Estoque.

Nesta fase, elevamos a estrutura básica para um nível profissional, focando na integridade dos dados e na rastreabilidade operacional necessária para evitar erros manuais.

2. Engenharia de Software (Avançada)

2.4 Diagrama de Casos de Uso (UML)

O diagrama abaixo detalha as interações críticas para resolver o problema da falta de organização e erros no controle manual.

Versão em SVG (Diagrama de Casos de Uso):

2.5 Diagrama de Classes (Domínio)

Estrutura de classes utilizando os princípios de SOLID e Orientação a Objetos para garantir que a lógica de cálculo de estoque seja centralizada e segura.

3. Banco de Dados (MySQL)

3.1 MER - Modelo Entidade-Relacionamento

A estrutura foi aprimorada para garantir que todo fluxo de entrada e saída gere um registro histórico, eliminando a "falta de controle eficiente".

4. Detalhamento das Melhorias Sugeridas

Para resolver os problemas operacionais e de organização citados, as seguintes funcionalidades foram detalhadas:

• Validação de Ruptura de Estoque: O sistema impede tecnicamente o registro de saída se a quantidade solicitada for superior ao saldo atual, emitindo um erro imediato.
• Gestão de Nível Crítico: Adição do campo nivel_critico no banco de dados. Quando a quantidade_atual for menor ou igual a este valor, o sistema dispara um alerta visual na consulta de produtos.
• Trilha de Auditoria: Cada entrada ou saída é vinculada a um timestamp automático, permitindo que o gestor identifique em qual momento exato ocorreu um desvio de mercadoria.
• Normalização por Categorias: Introdução da tabela CATEGORIA para melhorar a organização e busca de produtos por grupos (ex: Limpeza, Perecíveis, Eletrônicos), resolvendo a "dificuldade na organização".

5. Próximos Passos (Evolução Técnica)

1. Scanner de Código de Barras: Integrar uma API de leitura para acelerar a entrada e saída, reduzindo ainda mais o erro humano do controle manual.
2. Dashboard de Giro: Criar uma visão analítica que aponte quais produtos têm maior saída, auxiliando na decisão de compra.
3. Persistência com Java/JPA: Implementar a camada de acesso a dados utilizando Hibernate para garantir a integridade das transações no MySQL.

Este projeto está estruturado para ser uma solução escalável, pronta para migração de um protótipo simples para um sistema de gestão robusto.

Qual dessas camadas você gostaria de codificar primeiro no IntelliJ IDEA?