O problema

Todo mês, síndicos e administradores recebem um PDF ou Excel denso com o resumo financeiro do condomínio. O material cobre desde contratos de manutenção até contas de consumo, mas é estruturado para contabilidade, não para entendimento.

O painel do sistema de administração condominial exibindo o demonstrativo de receitas e despesas como uma tabela HTML crua
É isso que os administradores têm à disposição: uma tabela HTML sem filtros e sem exportação com o demonstrativo de receitas e despesas.

Como morador, eu tinha dificuldade real para responder perguntas básicas: Para onde foi o dinheiro neste mês? Quais despesas estão crescendo ao longo do tempo? Esse fornecedor está cobrando de forma consistente? Os dados estavam lá, mas enterrados entre códigos contábeis e jargão técnico.

Depois de conversar com moradores e gestores de dois prédios no Rio de Janeiro, ficou claro que não era frustração só minha — era uma lacuna estrutural na forma como condomínios comunicam saúde financeira aos moradores.

Trabalhando com parceiros de design

Conversei com dois condomínios de perfis bem diferentes — um residencial de médio porte em Botafogo e um complexo maior na Barra da Tijuca — para validar o conceito e cocriar o produto.

Nas entrevistas e sessões de trabalho com gestores e conselhos fiscais, dois problemas raiz se destacaram:

1. Os dados estavam presos em sistemas proprietários. A operação financeira era feita em um sistema legado de administração condominial que apenas exportava CSV. Não havia ferramenta que importasse esses arquivos e gerasse visualizações úteis.

2. As descrições das transações eram códigos crípticos. Um lançamento como “SERV MANUT PRED 04/12” fazia sentido para o contador, mas não para moradores ou conselheiros. Faltava clareza para entender onde o dinheiro estava indo.

Isso definiu a principal aposta do produto: importar dados brutos dos sistemas existentes, enriquecer com categorias em linguagem clara via IA e apresentar insights por visualização.

Jobs to be done

Bater o olho e entender o mês

receitas, despesas e variação em relação ao mês anterior

Identificar tendências ao longo do tempo

quais categorias crescem e quais fornecedores se repetem

Aprofundar em qualquer área

do grupo contábil até uma transação específica

Visualizar anomalias

encontrar cobranças pontuais e fornecedores novos

Esses objetivos definiram as quatro visões principais. O aprofundamento através do gráfico sunburst, por exemplo, começou como visão secundária e virou uma peça central depois que os pilotos mostraram que era o ponto de maior exploração dos usuários.

Desenhando a plataforma

Visão mensal

A primeira visão após selecionar o período é o Resumo. Ela responde imediatamente as perguntas centrais: quanto entrou, quanto saiu e como isso compara com o mês anterior.

Os dois gráficos de pizza quebram receitas e despesas por categoria. Além da leitura rápida, funcionam como porta de entrada para explorar categorias e seus detalhes naquele mês.

Resumo — visão financeira mensal

Tendências ao longo do tempo

A visão do Histórico permite acompanhar padrões financeiros mês a mês. Quatro séries temporais cobrem receita vs. despesa, receitas por categoria, despesas por categoria e saldo final por grupo contábil.

Ao passar o cursor em uma linha, o gráfico reduz ruído visual e facilita o foco em uma categoria específica.

Histórico — tendências ao longo do tempo

Exploração visual dos dados

A área “Explorar” foi a funcionalidade que mais engajou os usuários piloto. Um grande gráfico sunburst interativo permite navegar do nível mais alto (grupos contábeis) até transações individuais. Clicar em um arco aproxima; clicar no centro afasta.

Explorar — drill-down em sunburst

Visão detalhada do extrato

Para quem precisa inspecionar lançamentos individualmente, a área “Extrato” renderiza a lista completa com ordenação por colunas, filtros de categoria e busca textual.

Cada linha é enriquecida com categoria padronizada e nome normalizado de fornecedor.

Extrato — visualização detalhada

Ao selecionar qualquer texto da tabela, um atalho é exibido para fazer uma busca pelo valor selecionado, filtrando a lista instantaneamente. É uma microinteração pequena, mas torna o cruzamento de lançamentos muito mais rápido do que digitar.

Selecionar o valor de uma célula filtra o extrato instantaneamente

Enriquecimento de dados com IA

As exportações CSV dos sistemas condominiais trazem descrições curtas em linguagem contábil. Para transformar isso em informação útil, construí um pipeline de enriquecimento usando a API da Groq.

Diagrama do pipeline de enriquecimento

Cada import dispara um job em lote que classifica as transações em 29 categorias MECE, desenhadas para a contabilidade condominial brasileira, e extrai um nome padronizado para cada fornecedor.

Na prática, esse enriquecimento é invisível para o usuário final: ele já vê categorias claras desde o primeiro acesso ao extrato.

Construído para times

O CondoVis é multiusuário por design. Gestores e administradores têm acesso de admin: podem importar extratos, disparar enriquecimento e adicionar observações em transações, visíveis para todo o time.

Conselheiros e moradores recebem acesso de visualização (somente leitura), com acesso aos gráficos e dados, mas sem controles de importação e sem operações sensíveis. As permissões são aplicadas tanto no roteamento quanto em cada endpoint da API.

Teste você mesmo

O CondoVis está no ar em condovis.com.br. Você pode explorar a plataforma completa com este acesso de demonstração:

  • Login: viewer@condovis.dev
  • Senha: viewer123456