A descrição original
« Tenho uma oficina de reparação de máquinas de jardinagem. Giro um stock de peças sobresselentes: cada artigo tem uma referência, um preço de compra e um limiar de alerta, e liga-se a um fornecedor. O stock movimenta-se em entrada quando recebo uma encomenda a fornecedor, em saída quando uma peça vai para uma reparação. Quero ver o valor total do stock, os artigos abaixo do limiar de alerta e os movimentos do mês. »
O plano validado antes da geração
Antes de escrever uma única linha, o Blueprint Maker traduz esta descrição num plano que se valida. Para o StockAtelier, o plano proposto cabe num ecrã: quatro entidades — Artigo, Fornecedor, Movimento de stock, Encomenda a fornecedor — e as suas ligações: um artigo pertence a um fornecedor, um movimento diz respeito a um artigo, uma encomenda agrupa linhas de artigos.
Os estados deduzidos do texto também aparecem no plano: o movimento é uma entrada ou uma saída; a encomenda a fornecedor passa por rascunho, enviada, recebida. Os três indicadores pedidos (valor do stock, artigos abaixo do limiar, movimentos do mês) constam preto no branco. Se faltar ou sobrar um elemento, corrige-se aqui — o que é gerado é o que foi anunciado.
- Entidades: Artigo, Fornecedor, Movimento de stock, Encomenda a fornecedor
- Relações: artigo → fornecedor; movimento → artigo; linha de encomenda → artigo
- Estados: entrada / saída; rascunho / enviada / recebida
- Indicadores: valor do stock, artigos abaixo do limiar, movimentos em 30 dias
A navegação: uma secção por entidade
A aplicação gerada abre numa barra lateral sóbria: Painel, Artigos, Fornecedores, Movimentos, Encomendas. Cada secção leva a uma lista — não uma folha de cálculo, uma verdadeira lista de aplicação: campo de pesquisa no topo, colunas ordenáveis com um clique, paginação.
A lista de artigos mostra a referência, o nome, o fornecedor, a quantidade em stock, o preço de compra alinhado à direita em formato monetário e o limiar de alerta. Um artigo que caiu abaixo do seu limiar deteta-se de imediato. Do lado dos movimentos, um filtro por tipo (entrada / saída) e a ordenação por data devolvem o histórico em dois cliques.
A ficha do artigo, com o seu histórico
Clicar em «Correia GX-390» abre a sua ficha: referência, fornecedor (clicável, leva à ficha do fornecedor), preço de compra, quantidade em stock, limiar de alerta. Por baixo chega a parte que muda tudo em relação à folha de cálculo: o histórico dos movimentos DESTE artigo, em tabela datada — 12 de março, entrada de 20 unidades na receção da encomenda CF-2024-018; 27 de março, saída de 2 unidades.
Essa ligação não é cosmética: vem da base de dados relacional gerada. Renomear o artigo renomeia-o em todo o lado, e a quantidade apresentada decorre dos movimentos — nada é copiado à mão.
O registo de um movimento de stock
O formulário «Novo movimento» é curto porque a estrutura faz o trabalho: o artigo escolhe-se numa lista pendente (nenhuma referência reescrita à mão, logo nenhum erro de digitação), o tipo é uma escolha entrada / saída, a quantidade é um campo numérico, a data vem pré-preenchida com hoje, e um campo de comentário acolhe o contexto («reparação corta-relva Sr. Bernard»).
Ao guardar, a lista de movimentos, a ficha do artigo e o painel refletem o registo — é a mesma base de dados para todos os ecrãs.
O painel: os números do pitch, calculados sobre a base de dados
O painel retoma exatamente os indicadores pedidos na descrição: o valor total do stock em euros (soma das quantidades × preços de compra), o número de artigos abaixo do seu limiar de alerta, o volume de movimentos em 30 dias e uma repartição do stock por fornecedor.
Estes números são consultas à base de dados, não registos manuais: cada entrada ou saída registada atualiza-os. Um gráfico simples acompanha os mosaicos — a evolução dos movimentos nas últimas semanas — sem encenação: o objetivo é responder todas as manhãs às perguntas colocadas no pitch.
Os dados de demonstração: julgar sobre ecrãs cheios
O StockAtelier chega preenchido: vários meses de vida simulada, cerca de trinta artigos com nomes plausíveis (correias, velas, lâminas, filtros de ar), quatro fornecedores, encomendas em todos os estados e movimentos distribuídos no tempo — incluindo, de propósito, alguns artigos abaixo do seu limiar para ver o alerta funcionar.
É uma escolha deliberada: não se julga uma ferramenta de gestão sobre tabelas vazias. Os dados de demonstração são depois apagados para dar lugar aos reais. A aplicação vive no seu URL dedicado, e o seu código-fonte completo exporta-se (ZIP ou push GitHub) — Next.js + Prisma padrão.