A descrição original
« Gerei cerca de trinta habitações em nome de vários proprietários. Cada imóvel tem uma morada, uma área útil, uma renda mensal e despesas associadas, e pertence a um proprietário. Um imóvel é arrendado mediante um contrato de arrendamento, com um inquilino, uma data de início, uma duração e uma caução. Todos os meses preciso de saber quais as rendas já recebidas e quais estão em atraso, e quero ser avisado dos contratos de arrendamento que estão prestes a terminar. Preciso também de um demonstrativo por proprietário que possa enviar-lhes. »
O plano validado antes da geração
Antes de escrever uma única linha, o Blueprint Maker traduz esta descrição num plano que deve validar. Para a Trousseau, o plano cabe num único ecrã: cinco entidades, Proprietário, Imóvel, Inquilino, Contrato de Arrendamento e Renda, e as ligações entre elas. uma renda pertence a um contrato de arrendamento e tem associado o seu mês
Os estados deduzidos do texto aparecem no mesmo plano: o contrato de arrendamento passa por ativo, expirado e resolvido; a renda, por lançada, recebida e em atraso. Os indicadores solicitados são explicitamente identificados. Se faltar uma entidade, se houver um estado a mais ou se um rótulo não corresponder ao seu uso habitual, corrige-se aqui, o que é gerado é exatamente o que foi anunciado.
- Entidades: Proprietário, Imóvel, Inquilino, Contrato de Arrendamento, Renda
- Relações: imóvel → proprietário; contrato de arrendamento → imóvel; contrato de arrendamento → inquilino; renda → contrato de arrendamento
- Estados: ativo / expirado / resolvido; lançada / recebida / em atraso
- Indicadores: rendas recebidas este mês, atrasos em curso, contratos de arrendamento prestes a terminar, taxa de ocupação
A navegação: uma secção por entidade
A aplicação gerada abre com uma barra lateral discreta: Painel de Controlo, Imóveis, Proprietários, Inquilinos, Contratos de Arrendamento, Rendas. Cada secção leva a uma lista, não a uma folha de cálculo, mas a uma verdadeira lista de aplicação: pesquisa no topo, colunas ordenáveis com um clique, paginação e um contador que indica quantos resultados correspondem ao filtro atual.
A lista de rendas mostra o mês, o imóvel, o inquilino, o montante e o estado do pagamento. Um filtro facetado por estado e um filtro por período complementam a pesquisa. Estes filtros estão integrados no endereço da página: a vista «rendas em atraso no trimestre» pode ser guardada como favorito ou enviada por mensagem ao seu sócio, ele abre exatamente o que você estava a ver, não a vista predefinida.
Cada lista exporta para CSV, e a exportação inclui exatamente as linhas apresentadas no ecrã, filtro incluído, o número de resultados aparece na etiqueta do botão, para que saiba o que está a exportar antes de clicar.
A faixa de prazos: o que precisa de tratar esta semana
É a peça mais útil de qualquer ferramenta locativa, e é adicionada automaticamente assim que uma entidade tiver uma data de vencimento. Acima da lista, a aplicação exibe uma faixa que resume a situação numa única linha: quantos prazos já foram ultrapassados, quantos vencem hoje e quantos vencem nos próximos 6 dias
Em seguida, listam-se nominalmente os cinco prazos mais próximos, ordenados por data, cada um com um botão «Tratar» que abre diretamente o registo correspondente. Se houver mais, a faixa informa-o, em vez de se alongar. Uma linha cujo estado indique que já foi resolvida desaparece da faixa automaticamente: só vê o que ainda resta por fazer.
Na prática: abre a aplicação na segunda-feira de manhã e vê, sem ter de ordenar nem filtrar nada, as rendas em atraso e os contratos de arrendamento prestes a expirar.
A ficha do imóvel: o contrato de arrendamento em vigor e o histórico de rendas
Clicar numa linha abre uma FICHA DE LEITURA, não o formulário de edição. A distinção pode parecer menor; não é: consulta um imóvel vinte vezes por cada vez que o corrige, e abrir um formulário apenas para ler é a forma mais certa de alterar algo por acidente. O botão «Editar» está ali mesmo, ao lado, quando é realmente isso que pretende.
A ficha de um imóvel contém a sua morada, área útil, renda e despesas, bem como o seu proprietário. Em seguida vem a parte que muda tudo em comparação com uma folha de cálculo: o contrato de arrendamento em vigor, com o respetivo inquilino e data de término, seguido do histórico de rendas DESSE imóvel, num quadro cronológico, os meses já recebidos, o que está em atraso e o próximo a lançar
Esta ligação não é meramente visual: resulta da base de dados relacional gerada. Corrigir os dados de contacto de um inquilino corrige-os em todos os locais onde aparecem; o demonstrativo de um proprietário deriva dos seus imóveis, nada é copiado manualmente.
Indicadores que levam a algum lado
O painel de controlo inclui os indicadores solicitados na descrição: rendas recebidas este mês, atrasos em curso, contratos de arrendamento prestes a terminar e taxa de ocupação do parque. Trata-se de consultas à base de dados, não de entradas manuais: cada renda registada atualiza-os automaticamente.
Dois pormenores alteram significativamente a forma como os utiliza. O primeiro: cada cartão indica claramente o SEU período, logo abaixo do valor, «Este mês», «Últimos 30 dias», «Desde o início». Um número sem o seu contexto temporal é sempre lido como «recente», o que raramente corresponde ao seu significado real.
O segundo: cada cartão é clicável. Clicar em «atrasos em curso» abre a lista de rendas com o filtro do indicador já aplicado, assinalado por um marcador que pode remover com um clique. Passa do valor às linhas que o constituem sem ter de reconstruir o filtro mentalmente, e, se alguma condição do indicador não for reproduzível tal como está, o clique leva-o mesmo assim à lista, simplesmente sem o filtro: uma lista parcialmente filtrada que pareça completa seria pior do que nenhuma filtragem.
O demonstrativo por proprietário, concebido para sair do ecrã
É o pedido explícito do pitch, e tem o seu próprio ecrã: um demonstrativo sintético por proprietário, que agrega os seus imóveis, as rendas recebidas no período e as despesas, com um cabeçalho que indica a unidade monetária dos montantes.
Este ecrã inclui um botão «Imprimir» determinístico, não é uma chamada a um serviço externo, nem um modelo preenchido por IA: trata-se da própria funcionalidade de impressão do navegador, com layout A4 e quebras de página definidas pela folha de estilos da aplicação. O botão é ocultado na saída de impressão, não aparecendo na página impressa. A partir daqui, imprime ou guarda em PDF através do navegador, e envia.
O que a aplicação NÃO faz, e é melhor saber antes
A Trousseau mantém o registo: que imóvel, que contrato de arrendamento, que inquilino, que renda, liquidada ou não. Não recebe pagamentos: nenhum pagamento online, nenhum débito direto SEPA e nenhuma conciliação bancária são gerados. Uma renda é marcada como recebida assim que o dinheiro é efetivamente recebido noutro local.
Não emite recibos de renda no sentido jurídico: o demonstrativo sintético pode ser impresso, mas não é um modelo regulamentar com numeração e menções obrigatórias. Não produz declarações fiscais nem permite a assinatura eletrónica de contratos de arrendamento.
Por fim, APRESENTA os prazos, mas não os envia: a faixa alerta, no momento em que abre o ecrã, para os prazos em atraso e os que se aproximam, sem envio automático de correio eletrónico ou SMS ao inquilino. São funcionalidades que um programador pode adicionar, o código é exportável, mas que não fazem parte da geração inicial.
Os dados de demonstração: avaliar com ecrãs completos
A Trousseau chega já preenchida: vários meses de vida simulada, imóveis em moradas plausíveis distribuídos por diversos proprietários, contratos de arrendamento em diferentes fases, rendas recebidas e, intencionalmente, algumas em atraso e um contrato de arrendamento prestes a terminar, para que possa observar a faixa de prazos e os indicadores em funcionamento com dados reais, não apenas com zeros.
É 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 própria URL, e o seu código-fonte completo é exportável (ZIP ou push para GitHub), usando a stack padrão Next.js + Prisma.