Como Funciona: No campo de entrada, ao digitar sua Senha Mestre, o aplicativo descriptografa e carrega sua carteira real. Se você digitar sua Senha Fantasma (Ghost Mode), o aplicativo carrega um cofre secundário com dados fictícios para proteção contra extorsão.

Teclado Virtual

[Teclado Virtual] Alternância Alfanumérica:

Como Funciona: Ao clicar no ícone de teclado na caixa de entrada, o teclado virtual é exibido na tela. Utilize os botões 123 / ABC / Shift para alternar entre números, símbolos e caracteres maiúsculos/minúsculos sem usar o teclado físico.

Ação Entrar

[Botão] Entrar / Desbloquear Cofre:

Como Funciona: Após preencher a senha, clique no botão Entrar / Desbloquear Cofre. O sistema derivará a chave via PBKDF2 (100.000 iterações) e liberará o acesso imediato.

⚡

2. Como Configurar a Chave da API Google Gemini

Conexão com a Inteligência Artificial de leitura

AI Studio

Obtenção no AI Studio & Cadastro no App:

1. Acesse aistudio.google.com, faça login e clique em Get API Key -> Create API Key.

2. No Ai Wallet, vá no menu Chave da API, cole o código alfanumérico e clique em Salvar Chave da API.

🔝

3. Como Usar a Barra Superior do Aplicativo (Header Global)

Recursos globais acessíveis no topo de todas as telas da aplicação

Upload

[Barra Superior] Upload de Faturas (PDF/XML/OFX/CSV/Imagem):

Como Funciona: Clique ou arraste seus arquivos para a área de upload no topo da carteira. A IA Gemini 3 processará o documento e extrairá estabelecimentos, datas, parcelas e valores para salvamento no histórico.

Privacidade

[Barra Superior] Botão Revelar/Ocultar Saldos (👁️):

Como Funciona: Clique no ícone de olho no cabeçalho ou sobre qualquer valor numérico dos cards para ocultar ou exibir os saldos por privacidade.

💼

4. Como Usar a Tela "Minha Carteira" & Todos os Seus Cards

Instruções de uso de cada card, sub-card e botão do painel principal

Explicação de Uso dos Cards e Sub-cards do Organograma:

⚡ Card 1

Card 1: Despesas e Receitas (Ação Rápida)

Exibe o Saldo em Dinheiro/Caixa do fluxo de caixa diário.

💎 Card 2

Card 2: Economias (Investimentos & Patrimônio)

Exibe o Patrimônio Total Investido.

🏛️ Card 3

Card 3: Contas Bancárias (Extratos & Contas)

Exibe a quantidade de extratos e o Saldo Acumulado em Contas Bancárias.

↳ Sub-tela: Gerenciamento de Contas por Banco & Sub-cards:

[Sub-card 3.1] Banco Itaú: Extratos bancários processados do Banco Itaú.

[Sub-card 3.2] Banco Bradesco: Extratos bancários processados do Banco Bradesco.

[Sub-card 3.3] Santander / Inter / Nubank: Extratos bancários de outras instituições.

[Ação] Reabrir Extrato: Clique em qualquer extrato listado no card do banco para reabrir a visão de lançamentos.

💳 Card 4

Card 4: Cartões de Crédito (Faturas & Gastos Futuros)

Exibe faturas ativas, total acumulado e projeção de Gastos Futuros.

[Botão E] Evolução Passada: Clique no botão E no topo do card para abrir o gráfico comparativo de faturas passadas.

[Botão F] Evolução Futura: Clique no botão F no topo do card para abrir a projeção gráfica de parcelas dos próximos meses.

↳ Sub-tela: Faturas por Cartão de Crédito & Sub-cards:

[Sub-card 4.1] Itaú Black: Faturas do cartão Itaú Mastercard Black.

[Sub-card 4.2] Nubank / C6: Faturas dos cartões Nubank e C6 Carbon.

[Ação] Abrir / Excluir Fatura: Clique na fatura para abrir a lista de compras ou no ícone da lixeira para excluí-la.

📌 Card 6

Card 6: Notas (Lembretes & Anotações Financeiras)

Exibe o painel de anotações e avisos organizados por etiquetas.

↳ Sub-cards por Etiquetas Coloridas (Tags) & Janela Modal:

[Sub-card 6.1] Tag LEMBRETE (Azul): Lembretes de pagamentos e prazos.

[Sub-card 6.2] Tag IDEIA (Verde): Anotações de ideias de economia ou compras.

[Sub-card 6.3] Tag ATENÇÃO (Vermelho): Alertas urgentes de vencimento.

[Sub-card 6.4] Tag META (Roxo): Objetivos financeiros e metas de economia.

[Ações] Nova Nota / Fixar (📌): Clique no Card 6 para abrir a janela modal de Lembretes & Anotações Financeiras. Clique em + Nova Nota para criar anotações ou no alfinete (📌) para fixar a nota no topo.

📈

4. Como Usar a Tela "Notas de Corretagens" (Mercado B3)

Guia completo da sub-tela exclusiva de investimentos em bolsa

Upload B3

[Ação] Botão "Carregar Nota" (Upload PDF/XML/Imagem B3):

Como Usar: Clique no botão no canto superior direito para carregar arquivos de nota de corretagem (XP, Clear, NuInvest, BTG, Inter, Avenue, etc).

Gestão Fiscal

[Ação] Botão "Painel Informativo" (Gestão Fiscal de Ações B3):

Como Usar: Clique no botão "Painel Informativo" ao lado de Ações / FIIs para abrir o painel de apuração automática. O sistema agrupa por mês de competência, calcula o Resultado Líquido, separa Swing Trade (15%) de Day Trade (20%), valida a isenção de R$ 20.000/mês, compensa prejuízos acumulados e calcula o DARF final descontando o IRRF ("Dedo-Duro").

Sub-cards / Abas

Abas / Sub-cards de Categorias B3:

[Sub-card Tab 5.1] Ações / FIIs: Operações no mercado à vista Bovespa de ações e fundos imobiliários.

[Sub-card Tab 5.2] Futuros / Derivativos: Contratos futuros de Mini-Índice (WIN) e Mini-Dólar (WDO).

[Sub-card Tab 5.3] Renda Fixa: Títulos públicos do Tesouro Direto, CDBs e Debêntures.

[Sub-card Tab 5.4] Criptoativos: Criptomoedas (Bitcoin, Ethereum) e ETFs.

Tabela

[Tabela Operações] Edição Inline (Lápis) & Exclusão (Lixeira):

Como Usar: Clique no ícone de lápis para editar o ativo, quantidade e valor ou no ícone da lixeira para excluir uma operação da nota.

🏛️

5. Como Apurar e Emitir DARF (Código 6015 / Receita Federal)

Guia do assistente tributário oficial com Multa e Juros SELIC

Passo 1

[Passo 1] Seleção Mês/Notas, Prejuízos Anteriores, IRRF na Fonte, Isenção R$ 20k:

Como Usar: Clique no botão 📄 Emissão de DARF. Selecione o mês de apuração, marque/desmarque as notas, preencha o Nome e CPF, informe Prejuízos Acumulados de Meses Anteriores e o IRRF Retido na Fonte (*dedo de moça*) para abater do valor final.

Juros & Multa

[Simulação Atraso] Data Prevista Pagamento, Multa (0,33%/dia a 20%), Juros SELIC:

Como Usar: Caso esteja pagando após o vencimento, ajuste o campo Data Prevista de Pagamento e a Taxa SELIC Mensal Estimada (%). O sistema calcula a **Multa de Mora (0,33%/dia até 20%)** e os **Juros SELIC** automaticamente.

Passo 2

[Passo 2] Tabela Apuração + Formulário Oficial RFB (Quadros 01-10) + PDF / Copiar:

Como Usar: Examine a tabela comparativa de apuração e a guia oficial da Receita Federal. Clique no botão Baixar / Imprimir DARF para exportar em PDF ou em Copiar Resumo para pagamento no banco.

📊

6. Como Usar a Tela "Dashboard" (Análise Global)

Instruções para gráficos e busca global

Pizza

[Gráfico 1] Gráfico de Pizza por Categorias:

Como Usar: Passe o mouse ou toque nas fatias do gráfico para detalhar o valor gasto em cada categoria. Utilize o filtro para selecionar faturas específicas.

Barras

[Gráfico 2] Gráfico de Barras por Período:

Como Usar: Acompanhe a comparação mensal de despesas acumuladas em faturas e extratos.

Busca

[Barra de Busca] Pesquisa Global de Lançamentos:

Como Usar: Digite o nome de uma loja, valor ou categoria para buscar instantaneamente em todo o seu histórico.

📚

7. Como Usar a Tela "Histórico" (Biblioteca de Documentos)

Manutenção de faturas salvas

Lista

[Lista] Faturas e Extratos Salvos Cronologicamente:

Como Usar: Exibe a biblioteca de documentos salvos no cofre ordenados por data de vencimento.

Filtros & Exclusão

[Filtros & Exclusão] Reabrir Documento & Excluir Permanentemente:

Como Usar: Clique em uma fatura para reabri-la na tela principal ou clique no ícone da lixeira para excluí-la do histórico.

🤖

8. Como Usar as "Regras IA" & Retroatividade em Massa

Automação de categorias

Nova Regra

[Formulário] + Nova Regra (Palavra-chave, Categoria, Tipo Gasto):

Como Usar: Clique em + Nova Regra, digite a palavra-chave (ex: "Uber"), escolha a categoria ("Transporte") e se o gasto é Fixo ou Variável.

Retroatividade

[Modal Prompt] Atualização Retroativa em Massa no Histórico Antigo:

Como Usar: Ao salvar a regra, confirme o prompt do app para aplicar a nova categorização automaticamente a todas as faturas antigas já salvas.

Cartões

[Tabela] Mapeamento de Cartões (Final 4 dígitos, Emissor, Bandeira):

Como Usar: Cadastre o final do cartão (ex: 4321), emissor (Itaú) e bandeira (Mastercard Black) para vincular faturas lidas ao cartão correto.

🔐

9. Como Usar o Gerenciamento de Senhas & Modo Fantasma

Instruções para alterar credenciais de acesso

Senha Mestra

[Aba 1] Alterar Senha Mestra (+ Medidor de Força e Tempo de Quebra GPU):

Como Usar: No modal Gerenciar Senha, digite a senha atual e defina a nova senha mestre. O medidor exibirá a resistência estimada em anos contra ataques por força bruta.

Ghost Mode

[Aba 2] Configurar Senha Fantasma (Ghost Mode):

Como Usar: Cadastre uma senha secundária de pânico. Ao digitar essa senha na tela inicial, o aplicativo abre uma base fictícia sem revelar sua carteira real.

☁️

10. Como Conectar e Sincronizar com o Google Drive

Nuvem privada pessoal

Google Drive

[Opções] LocalStorage Criptografado vs. Google Drive Privado:

Como Usar: No menu Armazenamento, altere de *Local* para *Google Drive*. Conecte sua conta pessoal para sincronizar automaticamente seus dados criptografados entre seus dispositivos.

📦

11. Como Gerar Backup, Exportar Excel (.xlsx) e Zerar o App

Ferramentas de exportação e reset

Backup / Excel

[Ações] Exportar Backup (.aiv), Relatório Excel (.xlsx) e Reset Cofre:

Backup Nativo (.aiv): Clique em Exportar Backup (.aiv) para salvar uma cópia criptografada completa dos seus dados.

Relatório Excel (.xlsx): Clique em Exportar Relatório Excel (.xlsx) para baixar a planilha formatada pronta com abas de Resumo, Lançamentos, Investimentos e Faturas.

Excluir Tudo (Reset): No menu lateral, clique em Excluir Tudo e confirme com sua senha mestre para apagar permanentemente os dados do cofre.