Manutenção de Classes
Este tutorial é para o planejador financeiro que quer organizar as categorias dos seus clientes em agrupamentos estratégicos, reutilizar estruturas prontas e escalar a consultoria sem repetir trabalho.
Aqui você vai aprender:
- o que são classes e qual problema elas resolvem;
- como classes se relacionam com categorias, perfis e templates;
- como criar classes na estrutura do cliente e no catálogo da consultoria;
- como clonar classes do catálogo para clientes;
- como clonar templates completos;
- como tudo isso se reflete nas análises e relatórios;
- exemplos práticos prontos para aplicar.
O problema: categorias soltas não contam a história completa
Quando o cliente tem 30 ou 40 categorias de lançamento, a visão individual por categoria é útil para detalhes, mas não responde perguntas maiores:
- "Quanto o cliente gasta com alimentação como um todo?" (supermercado + restaurantes + padaria + delivery)
- "Qual o peso das despesas fixas no orçamento?" (aluguel + condomínio + luz + internet + plano de saúde)
- "O cliente está controlando as despesas variáveis?" (lazer + restaurantes + compras + assinaturas)
Sem classes, o planejador precisa somar categorias manualmente ou criar filtros ad hoc toda vez que quer uma visão consolidada. Com classes, essas visões já existem e se atualizam automaticamente.
O que é uma classe
Uma classe é um agrupamento de categorias. Ela não substitui as categorias — ela organiza categorias que já existem em grupos que fazem sentido para a análise.
Pense nas classes como lentes que você coloca sobre os mesmos lançamentos para enxergar padrões diferentes.
Exemplo concreto
O cliente tem estas categorias de saída:
- Supermercado
- Restaurantes
- Padaria
- Delivery
- Uber
- Combustível
- Estacionamento
- Cinema
- Streaming
- Academia
Sem classes, são 10 linhas independentes. Com classes, você pode criar:
| Classe | Categorias agrupadas |
|---|---|
| Alimentação | Supermercado, Restaurantes, Padaria, Delivery |
| Transporte | Uber, Combustível, Estacionamento |
| Lazer | Cinema, Streaming |
| Saúde e bem-estar | Academia |
| Despesas variáveis | Todas as 10 categorias acima |
Agora o planejador consegue responder "quanto o cliente gasta com alimentação?" com um clique, e ao mesmo tempo ver o detalhe por categoria quando precisar.
Uma categoria pode estar em várias classes
Esse é um ponto fundamental. A categoria "Restaurantes" pode estar simultaneamente em:
- Classe "Alimentação"
- Classe "Despesas variáveis"
- Classe "Lazer" (se o planejador considerar restaurantes como lazer para aquele cliente)
Não há duplicação de lançamento. A mesma compra de R$ 80 no restaurante aparece uma vez em cada classe, mas é o mesmo lançamento. As classes são apenas perspectivas diferentes sobre os mesmos dados.
A hierarquia completa: categorias, classes, perfis e templates
A Rica tem quatro níveis de organização, do mais específico ao mais amplo:
Template
└── Perfil
└── Classe
└── Categoria
└── Lançamento
Categoria
O nível mais granular. Cada lançamento pertence a exatamente uma categoria. Exemplos: Supermercado, Aluguel, Uber, Netflix.
Classe
Agrupa categorias relacionadas. Uma classe contém uma ou mais categorias. Uma categoria pode pertencer a zero, uma ou várias classes. Exemplos: Alimentação, Transporte, Despesas fixas.
Perfil
Agrupa classes para representar um modelo de organização financeira. Exemplos:
- Perfil "Essenciais": classes Moradia, Alimentação, Saúde, Transporte
- Perfil "Estilo de vida": classes Lazer, Assinaturas, Vestuário, Viagens
- Perfil "Crescimento": classes Investimentos, Educação, Previdência
Perfis são úteis quando o planejador quer segmentar a vida financeira do cliente em grandes blocos conceituais.
Template
Agrupa perfis em uma configuração completa e reutilizável. Um template é um "kit de organização" que o planejador aplica a novos clientes com um clique.
Exemplo: Template "Pessoa física padrão" contendo os perfis Essenciais, Estilo de vida e Crescimento, que por sua vez contêm todas as classes e categorias necessárias.
Onde cada nível é gerenciado
| Nível | Onde criar/editar | Visibilidade |
|---|---|---|
| Categorias | Estúdio > Lançamentos (painel Estrutura) | Estrutura do cliente |
| Classes na estrutura | Estúdio > Análises > Classificação | Estrutura do cliente |
| Classes no catálogo | Configurações > Consultoria | Catálogo da consultoria |
| Perfis | Configurações > Consultoria | Catálogo da consultoria |
| Templates | Configurações > Consultoria | Catálogo da consultoria |
Visibilidade: estrutura vs. consultoria
Esse conceito é central para entender como classes escalam.
Estrutura (cliente)
Classes com visibilidade Estrutura pertencem a um cliente específico. Elas aparecem apenas dentro daquela estrutura. Quando você cria uma classe diretamente no Estúdio do cliente, ela nasce com visibilidade Estrutura.
Use para:
- Ajustes específicos de um cliente que não se aplicam a outros.
- Classes que refletem a realidade particular daquela família ou pessoa.
Consultoria (catálogo)
Classes com visibilidade Consultoria vivem no catálogo do planejador. Elas não aparecem em nenhum cliente diretamente — servem como modelos que podem ser clonados para qualquer estrutura.
Use para:
- Padrões que você quer aplicar a vários clientes.
- Estruturas de análise que representam sua metodologia.
- Templates reutilizáveis que aceleram a configuração de novos clientes.
Criando classes na estrutura do cliente
Passo a passo
- Acesse Consultoria > Estúdio e selecione o cliente.
- Vá em Análises > Classificação.
- Clique em Nova classe.
- Preencha:
- Nome: nome descritivo da classe (ex: "Alimentação").
- Descrição: texto livre explicando o propósito (ex: "Todos os gastos com comida dentro e fora de casa").
- Selecione as categorias que fazem parte dessa classe. A lista mostra todas as categorias da estrutura do cliente.
- Salve.
A classe é criada imediatamente e já aparece nas análises de classificação do cliente.
Quando criar na estrutura
- Quando a classe é específica para aquele cliente (ex: "Custos do consultório" para um cliente médico).
- Quando você está experimentando uma organização nova e quer testar antes de padronizar.
- Quando o cliente tem categorias que não existem no seu catálogo padrão.
Criando classes no catálogo da consultoria
Passo a passo
- Acesse Configurações > Consultoria.
- Na seção de classes, clique em Nova classe.
- Preencha nome e descrição.
- Selecione as categorias do catálogo da consultoria que farão parte da classe.
- Salve.
A classe fica disponível no catálogo para ser clonada a qualquer momento para qualquer cliente.
Quando criar no catálogo
- Quando você quer padronizar uma organização e aplicar a vários clientes.
- Quando está construindo sua metodologia de análise.
- Quando quer que novos clientes já comecem com uma estrutura pronta.
Clonando classes do catálogo para a estrutura
Essa é uma das ações mais práticas da Rica. Em vez de criar classes manualmente para cada cliente, você clona do catálogo.
Passo a passo
- No Estúdio do cliente, vá em Análises > Classificação.
- Clique em Clonar do catálogo.
- O seletor mostra todas as classes do catálogo da consultoria.
- Selecione uma ou mais classes.
- Confirme.
O que acontece por dentro
Quando você clona uma classe do catálogo:
- A Rica cria uma cópia da classe na estrutura do cliente com visibilidade Estrutura.
- Para cada categoria referenciada pela classe:
- Se a categoria já existe na estrutura (por nome): a Rica reutiliza a existente.
- Se não existe: a Rica cria uma nova categoria na estrutura com os mesmos dados do catálogo.
- A nova classe na estrutura mantém uma referência à classe original do catálogo (campo
classeMatrizId). - As cores são atribuídas automaticamente com base no nome da classe, mantendo consistência visual entre clientes.
Por que a referência à classe original importa
O classeMatrizId permite que atualizações futuras no catálogo se propaguem para as estruturas. Se você renomear uma classe no catálogo ou ajustar suas categorias, as cópias nas estruturas podem ser atualizadas.
Deduplicação inteligente
A Rica evita duplicatas durante a clonagem:
- Se uma classe com o mesmo nome já existe na estrutura, ela é atualizada em vez de duplicada.
- Se uma categoria com o mesmo nome já existe, a Rica vincula à existente em vez de criar uma cópia.
- Nomes são comparados sem acentos e sem diferença de maiúsculas/minúsculas ("Alimentação" = "alimentacao").
Clonando templates completos
Templates são o nível mais alto de reutilização. Um template contém perfis, que contêm classes, que referenciam categorias. Clonar um template aplica toda essa estrutura de uma vez.
Passo a passo
- No Estúdio do cliente, vá em Análises > Classificação.
- Clique em Clonar template.
- O seletor mostra os templates configurados na consultoria.
- Selecione um ou mais templates.
- Confirme.
O que acontece por dentro
O processo é mais elaborado que a clonagem de classes individuais:
- A Rica resolve o template, extraindo seus perfis.
- Para cada perfil, extrai as classes associadas.
- Se o template tem customizações (classes ou categorias adicionais que não estão nos perfis originais), a Rica mescla tudo.
- O conjunto final de classes é clonado para a estrutura usando o mesmo processo de clonagem de classes do catálogo.
- Cores são recalculadas para manter consistência visual.
Quando usar templates
- Novo cliente: ao configurar a estrutura inicial, aplique o template padrão e o cliente já começa com todas as classes e categorias organizadas.
- Mudança de metodologia: se você redesenhar sua organização, crie um novo template e aplique aos clientes que devem migrar.
- Onboarding em escala: se você está crescendo a carteira, templates garantem que todos os clientes comecem com a mesma base.
Exemplo completo: montando a estrutura do zero
Vamos acompanhar o processo de um planejador que está configurando sua metodologia pela primeira vez.
1. Definir as categorias no catálogo
O planejador cria as categorias de lançamento com visibilidade Consultoria:
Saídas:
- Aluguel, Condomínio, Luz, Água, Internet (moradia)
- Supermercado, Restaurantes, Padaria, Delivery (alimentação)
- Uber, Combustível, Estacionamento, Seguro do carro (transporte)
- Plano de saúde, Farmácia, Academia (saúde)
- Cinema, Streaming, Viagens (lazer)
- Escola, Cursos, Livros (educação)
Entradas:
- Salário, Freelance, Aluguéis recebidos, Dividendos
2. Criar as classes no catálogo
| Classe | Categorias |
|---|---|
| Moradia | Aluguel, Condomínio, Luz, Água, Internet |
| Alimentação | Supermercado, Restaurantes, Padaria, Delivery |
| Transporte | Uber, Combustível, Estacionamento, Seguro do carro |
| Saúde | Plano de saúde, Farmácia, Academia |
| Lazer | Cinema, Streaming, Viagens |
| Educação | Escola, Cursos, Livros |
| Despesas fixas | Aluguel, Condomínio, Luz, Água, Internet, Plano de saúde |
| Despesas variáveis | Supermercado, Restaurantes, Padaria, Delivery, Uber, Combustível, Cinema, Streaming |
| Renda ativa | Salário, Freelance |
| Renda passiva | Aluguéis recebidos, Dividendos |
Note que "Aluguel" aparece tanto em "Moradia" quanto em "Despesas fixas". Isso é intencional e permite duas lentes de análise diferentes.
3. Criar os perfis
| Perfil | Classes |
|---|---|
| Essenciais | Moradia, Alimentação, Saúde, Transporte |
| Estilo de vida | Lazer, Educação |
| Visão consolidada | Despesas fixas, Despesas variáveis |
| Receitas | Renda ativa, Renda passiva |
4. Criar o template
Template "Pessoa física padrão": contém os perfis Essenciais, Estilo de vida, Visão consolidada e Receitas.
5. Aplicar ao cliente
No Estúdio do novo cliente, o planejador clona o template "Pessoa física padrão". Em um clique:
- 10 classes são criadas na estrutura do cliente.
- Todas as categorias referenciadas são criadas ou vinculadas.
- Cores são atribuídas automaticamente.
- O cliente está pronto para receber lançamentos com categorização automática e análises por classe.
Tempo total: segundos.
Sem templates, esse mesmo processo levaria entre 30 minutos e 1 hora de configuração manual por cliente.
Como as classes aparecem nas análises
Análise de Classificação
Em Estúdio > Análises > Classificação, o planejador vê os lançamentos agrupados por classe. Isso responde perguntas como:
- "O cliente gastou R$ 4.200 em Alimentação este mês"
- "Despesas fixas representam 62% do total de saídas"
- "Lazer caiu 15% em relação ao mês anterior"
Metas por classe
É possível criar metas vinculadas a classes inteiras. Exemplo:
- Meta "Alimentação": limite de R$ 3.500/mês
- Meta "Despesas variáveis": limite de R$ 5.000/mês
A meta acompanha automaticamente todos os lançamentos das categorias que compõem a classe.
Orçamento
No orçamento, classes oferecem a visão consolidada que complementa o detalhe por categoria. O planejador pode planejar por classe (macro) e acompanhar por categoria (micro).
Cores e consistência visual
A Rica atribui cores automaticamente às classes e propaga essas cores para as categorias associadas. Isso garante que:
- Categorias da mesma classe tenham a mesma cor nos gráficos.
- A experiência visual seja consistente entre clientes diferentes que usam o mesmo template.
- O planejador identifique rapidamente a qual classe pertence cada categoria.
As cores são determinísticas: o mesmo nome de classe sempre gera a mesma cor. Se você clonar a classe "Alimentação" para 30 clientes, todos terão a mesma cor nos gráficos.
Para recalcular cores (útil após reorganizar classes), use a ação Remontar cores disponível no painel de classes.
Propagação de atualizações
Quando o planejador atualiza uma classe no catálogo da consultoria, a Rica pode propagar as mudanças para as estruturas dos clientes que clonaram aquela classe.
Isso funciona através do campo classeMatrizId:
- Classe "Alimentação" no catálogo tem ID
abc123. - Quando clonada para o cliente João, a cópia na estrutura tem
classeMatrizId: abc123. - Se o planejador adicionar a categoria "Feira" à classe "Alimentação" no catálogo e executar a atualização, a cópia do João também recebe a categoria.
Isso evita o cenário em que o planejador precisa atualizar 30 clientes individualmente quando ajusta sua metodologia.
Estratégia recomendada de implantação
Para quem está começando
- Comece criando 4 a 6 classes no catálogo que representem as grandes áreas da vida financeira dos seus clientes (Moradia, Alimentação, Transporte, Saúde, Lazer, Educação).
- Monte um template com essas classes.
- Aplique o template aos primeiros clientes.
- Observe durante 2 a 4 semanas se a organização faz sentido.
- Ajuste e depois escale.
Para quem já tem clientes configurados
- Crie as classes no catálogo da consultoria refletindo a organização que você já usa informalmente.
- Clone as classes para cada cliente existente. A deduplicação automática vai vincular as categorias que já existem.
- Revise se as categorias foram associadas corretamente.
- Para novos clientes, use o template.
Evolução gradual
Não tente criar a estrutura perfeita na primeira vez. Comece simples:
- 5-6 classes cobrindo os grandes temas.
- 1 template com 1-2 perfis.
- Refine conforme aprende com os dados dos clientes.
Erros comuns e como evitar
-
Erro: criar classes com apenas uma categoria. Por que é problema: uma classe com uma categoria não agrega valor — é o mesmo que olhar a categoria diretamente. Correção: classes devem agrupar pelo menos 2-3 categorias relacionadas.
-
Erro: criar muitas classes granulares demais. Por que é problema: se toda categoria virar uma classe, você volta ao mesmo problema de ter informação demais sem hierarquia. Correção: mantenha entre 5 e 10 classes por perfil. Se precisar de mais, reavalie se algumas podem ser consolidadas.
-
Erro: criar classes apenas na estrutura do cliente sem usar o catálogo. Por que é problema: cada novo cliente exige configuração manual do zero. Correção: crie no catálogo e clone. Use classes na estrutura apenas para ajustes específicos de um cliente.
-
Erro: não atualizar o catálogo quando a metodologia evolui. Por que é problema: novos clientes recebem estrutura desatualizada. Correção: mantenha o catálogo como fonte de verdade da sua metodologia. Atualize primeiro o catálogo, depois propague.
-
Erro: esquecer de clonar as categorias junto com as classes. Por que é problema: a classe fica vazia. Correção: isso não acontece na Rica — ao clonar uma classe, as categorias são criadas ou vinculadas automaticamente. Mas verifique se as categorias clonadas têm conceitos configurados para que a categorização automática funcione.
Checklist de configuração
Antes de considerar sua estrutura de classes completa:
- As classes cobrem as principais áreas de gasto e receita dos seus clientes?
- Cada classe tem pelo menos 2 categorias?
- As categorias das classes têm conceitos configurados para categorização automática?
- Existe pelo menos uma classe de "visão consolidada" (ex: Despesas fixas vs. variáveis)?
- As classes estão salvas no catálogo da consultoria (não apenas na estrutura)?
- Existe um template montado com perfis e classes para novos clientes?
- As cores estão consistentes (executou "Remontar cores" se necessário)?
Resumo da hierarquia
| Nível | O que é | Quantidade típica | Exemplo |
|---|---|---|---|
| Template | Kit de configuração reutilizável | 1-3 por consultoria | "Pessoa física padrão" |
| Perfil | Bloco conceitual de classes | 2-4 por template | "Essenciais", "Estilo de vida" |
| Classe | Agrupamento de categorias | 5-10 por perfil | "Alimentação", "Transporte" |
| Categoria | Classificação do lançamento | 3-8 por classe | "Supermercado", "Restaurantes" |
| Lançamento | Movimentação financeira | N por categoria | "Supermercado Extra R$ 280" |
Cada nível adiciona uma camada de organização que permite análises mais ricas sem trabalho operacional adicional. O investimento de tempo é na configuração inicial do catálogo e dos templates. Depois disso, cada novo cliente herda toda a estrutura com um clique.