A descrição original
« Somos dois mecânicos. Cada ordem de reparação diz respeito ao veículo de um cliente, com diagnóstico, trabalhos a realizar, peças utilizadas, horas gastas e um estado: recebida, diagnosticada, aprovada, em curso, concluída, faturada. Algumas ordens aguardam peças. Quero ver a oficina do dia, as ordens à espera de peças e o faturável da semana. »
O plano validado antes da geração
Antes de escrever uma única linha, o Blueprint Maker converte esta descrição num plano que você valida. Para o GarageClair, o plano proposto cabe num único ecrã: cinco entidades, Ordem de reparação, Veículo, Cliente, Peça e Mecânico, e as suas ligações: uma ordem diz respeito a um veículo; um veículo pertence a um cliente; uma ordem utiliza peças e envolve um mecânico.
Os estados deduzidos do texto também aparecem no plano: a ordem de reparação percorre os estados recebida, diagnosticada, aprovada, em curso, concluída e faturada. Os três indicadores solicitados (oficina do dia, ordens à espera de peças, faturável da semana) estão claramente identificados. Se faltar algo ou houver elementos supérfluos, corrige-se aqui, o que é gerado corresponde exatamente ao que foi anunciado.
- Entidades: Ordem de reparação, Veículo, Cliente, Peça, Mecânico
- Relações: ordem → veículo; veículo → cliente; ordem → peças; ordem → mecânico
- Estados: recebida / diagnosticada / aprovada / em curso / concluída / faturada
- Indicadores: ordens em curso por estado, ordens à espera de peças, horas faturáveis desta semana
A navegação: uma secção por entidade
A aplicação gerada abre com uma barra lateral limpa: Painel de controlo, Ordens de reparação, Veículos, Clientes, Peças. Cada secção leva a uma lista, não a um caderno de oficina, mas a uma verdadeira lista de aplicação: campo de pesquisa no topo, colunas ordenáveis com um clique, paginação.
A lista de ordens de reparação mostra o veículo, o cliente, o estado sob a forma de um selo colorido, a data de receção e o montante faturável alinhado à direita no formato monetário. Uma ordem à espera de peças destaca-se imediatamente. No que diz respeito aos veículos, um filtro por cliente e a ordenação por data da última intervenção permitem recuperar o histórico em dois cliques.
A ficha do veículo, com todo o seu histórico
Clicar em «Peugeot 308, AB-123-CD» abre a respetiva ficha: matrícula, cliente (clicável, conduz à ficha do cliente), quilómetros e, sobretudo, a parte que muda tudo em comparação com o caderno de oficina: o histórico de ordens de reparação deste veículo, apresentado numa tabela cronológica: 14 de março, substituição da embraiagem, faturados 320 €; 2 de junho, revisão, faturados 145 €.
Esta ligação não é meramente cosmética: resulta da base de dados relacional gerada. Um cliente que ligue de novo sobre a sua embraiagem encontra a ficha em apenas um clique, desaparece assim a pergunta que costumava consumir tanto tempo no caderno de oficina.
A introdução de uma ordem de reparação
O formulário «Nova ordem» é curto porque a estrutura faz o trabalho: o veículo é selecionado a partir de uma lista pendente (não há necessidade de reintroduzir a matrícula manualmente, logo sem erros de digitação), o estado é uma escolha entre as seis opções definidas, as peças utilizadas são adicionadas uma a uma com a respetiva quantidade e um campo de diagnóstico acolhe o texto livre do mecânico.
Ao guardar, a lista de ordens, a ficha do veículo e o painel de controlo refletem imediatamente a nova entrada, todos os ecrãs leem da mesma base de dados.
O painel de controlo: os números do pitch, calculados diretamente na base de dados
O painel de controlo reproduz exatamente os indicadores solicitados na descrição: as ordens em curso, divididas por estado; o número de ordens à espera de peças; o faturável desta semana; e os veículos entregues este mês.
Estes valores são obtidos através de consultas à base de dados, não de introduções manuais: cada alteração de estado ou adição de peça atualiza-os automaticamente. Um gráfico simples acompanha as fichas, mostrando a repartição das ordens por estado, sem artifícios, o objetivo é responder todas as manhãs às perguntas formuladas no pitch.
Os dados de demonstração: avaliar com ecrãs preenchidos
O GarageClair chega já preenchido: vários meses de atividade simulada, vários meses de histórico simulado, cerca de trinta veículos com matrículas plausíveis, cerca de vinte clientes, ordens de reparação em todos os estados e uma variedade de peças, incluindo, intencionalmente, algumas ordens à espera de peças, para testar o funcionamento do filtro., ordens de reparação em todos os estados e uma variedade de peças, incluindo, propositadamente, algumas ordens à espera de peças, para testar o funcionamento do filtro.
Trata-se de uma escolha deliberada: não se avalia uma ferramenta de gestão com tabelas vazias. Os dados de demonstração são depois apagados para dar lugar aos dados reais. A aplicação funciona na sua URL dedicada e o código-fonte completo pode ser exportado (ZIP ou push para GitHub), utilizando a stack padrão Next.js + Prisma.