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.

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

Entender o mês de relance

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

Identificar tendências no tempo

quais categorias crescem e quais fornecedores se repetem

Aprofundar em qualquer área

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

Detectar anomalias

encontrar cobranças pontuais e fornecedores novos

Esses objetivos definiram as quatro telas principais. O drill-down em sunburst, por exemplo, começou como tela secundária e virou 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 tela 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 tela 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 tela 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 tela 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.

Um ponto âmbar marca fornecedores que não apareceram no mês anterior, uma pequena adição que virou uma das funcionalidades mais pedidas.

Extrato — visualização detalhada

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