Fase 0
01 / 06Descoberta
Entrevistas informais com profissionais liberais e famílias de classe média. Mapeamento da jornada real — não a jornada idealizada — de quem lida com mais de uma conta e mais de um cartão.
Memorial — Volume único · ~14 min de leitura
Esta é a história do Bolso — por que existe, como foi pensado, quais decisões o moldaram, e quem assumiu a responsabilidade por cada uma delas. Um memorial é, antes de tudo, um compromisso público com a obra: o que está escrito aqui é o que o produto promete cumprir todos os dias.
00— Manifesto
Acreditamos que dinheiro pessoal merece a mesma seriedade que se aplica a um balanço corporativo, sem perder a intimidade de um caderno de capa dura. Que privacidade não é benefício adicional — é ponto de partida. Que clareza vale mais que entusiasmo. Que números bem alinhados explicam mais que gráficos coloridos. E que um aplicativo só está pronto quando deixa de pedir desculpas pela ausência de cada recurso que ele recusou conscientemente.
Bolso — declaração de intenção
01— Carta do idealizador
O Bolso começou como uma inquietação prática. Como engenheiro de produção, passei anos modelando processos em fábricas, hospitais e escritórios — e percebi que faltava em casa o mesmo cuidado que aplicávamos ao chão de fábrica: instrumentar, medir, decidir.
Tentei planilhas. Tentei aplicativos. Tentei agregadores que pediam acesso ao meu banco. Em todos eles, a mesma fadiga: ferramentas pensadas para impressionar, não para acompanhar. Gráficos coloridos onde eu queria uma tabela. Painéis que celebravam o gasto onde eu queria entender a tendência.
Decidi, então, escrever o aplicativo que eu mesmo gostaria de usar — discreto, tipograficamente sério, honesto com a complexidade da vida financeira no Brasil. O Bolso é o resultado dessa decisão.
— Carlos Eduardo
02— Origem
No Brasil, lidar com dinheiro pessoal exige conciliar várias contas, alguns cartões, boletos com vencimentos esparsos, gastos parcelados que se prolongam, e uma cultura financeira que ainda trata orçamento como sinônimo de restrição.
Os agregadores resolvem parte do problema às custas da privacidade. As planilhas cobram disciplina toda semana. Os apps gratuitos vendem atenção. Faltava uma ferramenta que coubesse no meio: manual o suficiente para ser sua, automatizada o suficiente para não cansar.
O Bolso é desenhado para esse intervalo. Você lança. Ele organiza, agrupa, projeta, avisa. Sem leitura de extrato, sem permissão bancária, sem promessa de enriquecimento.
03— Princípios
Um número bem alinhado vale mais que uma animação. Cada pixel responde por uma decisão informativa — ou não merece estar ali.
Nenhum opt-in escondido, nenhum botão pré-marcado, nenhum padrão escuro. O Bolso prefere uma confirmação a mais a uma surpresa a menos.
Carteiras, cartões, contas a pagar, metas: um vocabulário, uma tipografia, uma forma de mostrar valores. A consistência é o primeiro recurso de acessibilidade.
Sem leitura de extrato, sem credenciais bancárias, sem corretagem de dados. Cada conta é isolada por RLS no banco; o que é seu, é só seu.
Listas numeradas, hairlines, marginalia. O Bolso herda da imprensa o que a interface contemporânea esqueceu: ritmo, hierarquia, silêncio.
04— Arquitetura
Hero com saldo consolidado, contas dos próximos sete dias, divisão por categoria, orçamento e metas — tudo na primeira dobra.
DiárioLivro-razão editorial agrupado por dia, com filtros tipográficos, busca por descrição, importação CSV e exclusão com desfazer.
DiárioBoletos agrupados por maturidade (atrasados, semana, próximas, pagas) com recorrência, baixa em massa e lembrete três dias antes.
DiárioMovimento entre carteiras sem distorcer receitas e despesas — uma operação de fluxo, não de resultado.
DiárioCadastro institucional com cor e ícone, base para as carteiras e os cartões. A identidade do banco aparece como filete, não como brasão.
ContasConta corrente, poupança, dinheiro, investimento. Saldo derivado em tempo real do extrato — sem cache cego, sem reconciliação manual.
ContasLimite, melhor data de compra, fatura aberta, parcelamentos abertos. O cartão é exibido como linha, não como ilustração.
ContasTetos por categoria com alertas em 80% e 100%. O alerta é um aviso, não um julgamento.
DecisãoReserva de emergência, viagens, troca de carro. Sub-metas, simulador de aporte mensal, marcos de progresso.
DecisãoFluxo de caixa, evolução patrimonial, heatmap de gastos, exportação em PDF.
DecisãoTaxonomia editada pelo usuário. Cores discretas, ícones em emoji, divisão clara entre saídas e entradas.
SistemaAutomação de classificação: condições simples encadeadas, com retrocompatibilidade — a regra pode reclassificar transações já lançadas.
SistemaPerfil, preferências de moeda, notificações por canal, importação e exportação dos dados.
Sistema05— Linha do tempo
Fase 0
01 / 06Entrevistas informais com profissionais liberais e famílias de classe média. Mapeamento da jornada real — não a jornada idealizada — de quem lida com mais de uma conta e mais de um cartão.
Fase 1
02 / 06Engenharia de processos aplicada a finanças pessoais: identificação de eventos (lançamento, transferência, pagamento), agregadores (saldo, fatura, orçamento) e gatilhos (alerta, vencimento, milestone).
Fase 2
03 / 06Modelagem relacional com isolamento por usuário (RLS). Funções derivadas em vez de campos materializados. Triggers para notificações de orçamento e metas. Índices para os filtros mais usados.
Fase 3
04 / 06Implementação em TanStack Start sobre React 19. Server functions tipadas, queries em cache otimista, RPCs específicos para saldo agregado e projeção de gastos.
Fase 4
05 / 06Migração da identidade visual para Ink & Brass: tipografia Fraunces + Manrope, paleta neutra com latão pontual, redesenho de cada módulo como livro-razão.
Fase 5
06 / 06Ondas semanais de refinamento: ergonomia das ações, microcopies, performance percebida, acessibilidade, automação de classificação, exportação.
06— Decisões
07— Processo
Entrevistas, mapeamento de fricções, leitura do problema antes de prescrever a solução.
Lista priorizada de capacidades — não de telas. Cada capacidade carregava uma justificativa.
Eventos, entidades e agregadores. Diagrama relacional desenhado antes da primeira migração.
Decisões de stack (TanStack Start, React 19, Supabase, RLS, RPCs) com critérios explícitos: tipagem, latência, custo.
Tokens semânticos em oklch, tipografia, espaçamento, componentes shadcn customizados. Documentado em código, não em Figma.
Componentes diretamente no produto. O protótipo é o primeiro build.
Migrações idempotentes, server functions tipadas, queries com cache otimista, undo, e exportação em CSV/PDF.
Uso diário pelo próprio idealizador como instrumento crítico. Refatoração assim que a fricção aparece.
Ondas semanais de polimento — copy, microinterações, acessibilidade, performance percebida.
08— Anatomia
Cada decisão de arquitetura do Bolso pode ser observada no destino de um único lançamento. Os seis passos abaixo descrevem o trajeto entre o toque no botão “Novo” e o número que aparece no topo da Visão geral.
Você lança valor, data, descrição e carteira. Um campo obrigatório, três opcionais. A categoria pode vir em branco — uma regra resolve depois.
Regras encadeadas leem a descrição e atribuem categoria, etiquetas e observações. A mesma regra pode reclassificar lançamentos antigos sem efeitos colaterais.
Inserção em PostgreSQL sob RLS pelo seu user_id. Triggers atualizam orçamento, metas e a fila de notificações; nenhum saldo é gravado.
Saldo de cada carteira, fatura aberta do cartão, consumo do orçamento e progresso da meta são funções puras do extrato — recalculadas a cada leitura.
TanStack Query devolve o conjunto consultado e o livro-razão re-renderiza o dia tocado. Sem refresh global, sem flash de skeleton onde já havia número.
Excluir é instantâneo, com seis segundos para desfazer. Editar é uma única mutação rastreada — auditoria implícita, sem versionamento ostensivo.
09— Materiais técnicos
10— Bastidores
A primeira versão do Bolso tinha cartões coloridos, gradientes em arco-íris e um modo escuro obrigatório. Em três semanas, ele foi sendo desmontado — peça a peça — até virar o livro-razão que você vê hoje. A lição: o produto certo costuma estar escondido sob o produto vistoso.
A mudança mais incômoda foi remover o verde dos botões primários. Verde transmite confiança, mas também sinaliza dinheiro entrando. Como nem todo botão executa uma receita, manter verde como cor de ação confundia o leitor. A primária virou ink puro.
A decisão mais barata foi adotar Fraunces. Uma serifa contemporânea, com peso editorial, mudou o tom da aplicação inteira sem alterar uma única regra de negócio.
11 — Autoria
Sobre o autor
Carlos Eduardo é engenheiro de produção, brasileiro. Sua prática profissional combina engenharia de processos, modelagem operacional e desenvolvimento de produtos digitais — uma trajetória que o levou a tratar finanças pessoais com o mesmo rigor que se aplica a uma linha produtiva.
No Bolso, assumiu integralmente a concepção e a construção do produto. Cada decisão visível na aplicação — do nome de uma categoria à curva de uma sombra — passou por sua direção. O memorial abaixo registra essa responsabilidade sem exagero, mas sem omissão.
“Não construí o Bolso para impressionar quem olha de fora. Construí para que eu pudesse confiar no número que aparece no meu próprio mês.”
— Carlos Eduardo
12— Em números
13
Módulos funcionais
Da visão geral às regras de automação — todos os capítulos do produto cabem em uma única tabela de conteúdos.
100%
Saldo derivado em tempo real
Nenhum valor de saldo é armazenado. Cada número que aparece é recalculado a partir do extrato — não há cache cego para desconfiar.
0
Credenciais bancárias solicitadas
Sem leitura automática de extrato, sem open finance, sem corretagem de dados. Lançamento manual e importação por CSV.
3 dias
Antecedência mínima dos avisos
Boletos sinalizam três dias antes do vencimento; orçamentos avisam em 80% e 100%; metas marcam progresso a cada quartil.
1
Acento de cor no produto inteiro
Latão fosco como único destaque. Verde e vermelho aparecem somente como sinalização funcional — nunca como decoração.
6s
Janela de desfazer
Excluir é instantâneo, com seis segundos para reverter. Reduz fricção sem abrir mão de reversibilidade.
13— Roadmap & Agradecimentos
Próximos capítulos
Conciliação de fatura com importação OFX e leitura assistida de PDF.
Relatório anual editorial — uma edição impressa do próprio aplicativo.
Compartilhamento de orçamento entre membros da mesma família, com permissões granulares.
API pública para exportação programada, sob token rotativo por escopo.
Open finance e leitura automática de extrato — preservar privacidade pesa mais.
Anúncios, recomendações pagas e qualquer monetização por atenção.
A lista é deliberadamente curta. Cada item descartado libera tempo para refinar o que já existe — princípio que orienta o produto desde a primeira versão.
14— Versões
Estreia do Bolso com os treze módulos do produto e a identidade Ink & Brass. Memorial inaugurado como capítulo do próprio aplicativo.
Migração de saldo materializado para função pura sobre o extrato. RPCs dedicados para agregação e projeção de fluxo de caixa.
Motor de regras passa a reclassificar transações pretéritas sob demanda. Importação CSV ganha mapeamento por coluna.
Janela de desfazer adicionada a exclusões e pagamentos. Confirmações destrutivas pedem digitação literal para operações irreversíveis.
Tipografia migrada para Fraunces + Manrope. Cartões e gradientes substituídos por hairlines e tabular numerals em todos os módulos.
Capítulos de Anatomia e Versões publicados. Sumário expandido, standfirst editorial, marginalia revisada por idealização.
Numeração editorial, não semântica. Cada edição corresponde a uma onda completa de refinamento — não a um patch isolado. O Bolso é publicado, não apenas atualizado.
15— Léxico do produto
Todo produto sério tem vocabulário próprio. O Bolso nomeia o que outros aplicativos deixam em branco — e recusa palavras que carregam julgamento. O verbete abaixo registra os termos centrais como aparecem na interface, na documentação e nesta página.
O glossário é deliberadamente curto. Cada termo descartado da lista representa uma palavra que o produto se recusou a inventar.
Continuação
Toda funcionalidade descrita aqui está disponível agora. O cadastro leva trinta segundos e não pede cartão.