Neseia, as contas do condomínio que sobrevivem a quem as guarda

O bichinho

Em Portugal, um prédio muda de mãos mal. Quando um administrador eleito sai ou uma empresa de gestão perde um prédio na assembleia anual, quem entra recebe uma caixa de papel, um Excel com dez anos de fórmulas e saldos por reconciliar. A lei faz da passagem um dever; o software que as pessoas usam foi feito para a contabilidade da gestora, não para a continuidade do prédio. Sei-o porque me aconteceu: fui eleito administrador do prédio onde vivo e passei uma semana a reconstruir quem tinha pago o quê.

A decisão

Uma decisão estrutural moldou tudo o resto: a subscrição é do condomínio, e não da pessoa ou da empresa que o administra este ano. Daí saem três regras que o código impõe em vez de documentar. Os lançamentos nunca se editam nem se apagam; um erro corrige-se com um estorno, que fica à vista com o motivo. Um histórico importado não publica nada aos condóminos até cada saldo de abertura reconciliar ou a diferença ser aceite e assinada. E cada prédio gera a sua pasta de entrega a qualquer momento: os ficheiros originais, um manifesto com a impressão digital de cada um, e um guia em português para quem vier a seguir.

A segunda decisão foi sobre o dinheiro. A Neseia nunca recebe nem retém um cêntimo. Referências Multibanco, MB WAY, débito direto SEPA e ligação ao banco correm todos na conta do próprio condomínio, com o fornecedor que o prédio escolher. Reconciliamos; não intermediamos.

Como funciona

Um backend em Django sobre PostgreSQL, com a separação entre condomínios imposta pela própria base de dados: uma consulta sem prédio definido falha em vez de devolver tudo, e um registo de um condomínio não consegue apontar para outro. Um frontend em Nuxt serve três pessoas muito diferentes a partir do mesmo código: o escritório da gestora, o condómino no telemóvel e quem faz rondas no prédio. A aplicação do condómino instala-se a partir do browser, entra com passkey e recebe notificações; o papel continua a ser um canal de primeira classe, com avisos A4, cartas para envelope de janela e um centro de impressão para os condóminos sem email.

O livro razão cobre quotas, imputação com sugestões determinísticas, régua de cobrança com juros, artefactos legais como a declaração de dívida, assembleias com quórum, votação e ata aprovada em sessão, um plano do fundo de reserva a trinta anos, e a faturação das avenças da própria gestora. Nada financeiro é decidido por um modelo; as faturas leem-se pelo código QR da AT e uma pessoa confirma.

Foi construído em cerca de seis semanas, com os documentos de especificação escritos primeiro e agentes implementadores a trabalhar a partir deles, um marco de cada vez, cada um verificado por testes que provam que a guarda aguenta peso ao desligá-la dentro da suite. O resultado é um produto com mais de 150 especificações numeradas e mais de 4.700 testes automáticos antes do primeiro cliente pagante.

Um livro razão é uma promessa a quem o ler a seguir. A maior parte do software cumpre-a durante um ano. Um prédio precisa que ela se cumpra durante trinta.

O que aprendi

• Decidir de quem são os dados, antes de escrever uma linha de código, resolve a maior parte das discussões de produto mais tarde.
• A imutabilidade é mais barata do que a confiança: um estorno com motivo vale mais do que uma edição com permissão.
• O papel não é legado num país onde um terço de um prédio pode não ter email; é um canal com geometria própria.
• Escrever a especificação como entregável, e deixar os agentes construir a partir dela, tornou seis semanas de trabalho revisáveis.