1. Introdução ao Contas3

O que é o Contas3?

O Contas3 é um sistema de controle financeiro pessoal e empresarial, projetado para quem precisa organizar receitas, despesas, contas bancárias e obrigações recorrentes de forma simples e segura.

Disponível para Windows (desktop) e Android, com sincronização em nuvem em tempo real.

Destaque
Tudo que você registra é sincronizado automaticamente entre seus dispositivos.

Para quem foi feito?

O Contas3 foi criado para:

PerfilUso típico
Profissionais autônomosControle de receitas e despesas pessoais e da atividade
Pequenas empresasGestão financeira simplificada sem ERP
FamíliasControle compartilhado de contas domésticas
ContadoresGerenciamento de múltiplos clientes (multi-tenant)

Filosofia do sistema

Três princípios guiam o Contas3:

Princípios
Simplicidade — sem funcionalidades desnecessárias
Segurança — dados criptografados, backup automático
Flexibilidade — multi-tenant, contas compartilhadas, recorrências

Controle multi-tenant

Crie múltiplos perfis (tenants) para separar finanças. Cada perfil é completamente isolado.

Exemplo
João cria dois perfis: "Pessoal" (contas pessoais) e "Empresa ABC" (contas da loja). Os dados de um não aparecem no outro.

2. Criando uma conta no sistema

Login com Google

O Contas3 utiliza autenticação via Google OAuth. Não armazenamos sua senha — apenas um token seguro.

Passo a passo
1. Abra o aplicativo
2. Clique em "Entrar com Google"
3. Selecione sua conta Google no navegador
4. Autorize o acesso
5. Você será redirecionado de volta ao app

Primeiro acesso

No primeiro login, o sistema cria automaticamente seu perfil e um usuário administrador (master).

Exemplo prático
Usuário: João Silva (joao@gmail.com)
O sistema cria: Perfil "João Silva" com João como administrador
Próximo passo: Criar a primeira conta financeira (ex: "Banco Inter")

Criando perfis adicionais

Para separar finanças pessoais e empresariais:

Como fazer
Configurações → Trocar perfil → Criar novo perfil
Dê um nome (ex: "Empresa ABC") e confirme.

3. Estrutura do sistema

Hierarquia de dados

Usuário

Tenant (Perfil)

Contas Financeiras

Transações (Receitas / Despesas)

Cada nível contém o próximo. Um usuário pode ter vários perfis, cada perfil várias contas, cada conta muitas transações.

Conceitos principais

ConceitoO que é
UsuárioPessoa identificada pelo email Google
TenantEspaço de trabalho (perfil) que agrupa contas e transações
MembershipVínculo entre usuário e tenant (master ou membro)
AccountConta financeira (bancária, carteira, cartão, etc.)
TransactionLançamento: receita (crédito) ou despesa (débito)
LedgerLivro contábil que agrupa transações
ObligationFatura gerada para contas vinculadas
SubscriptionAssinatura do plano pago

4. Criando contas financeiras

Tipos de conta

Uma "conta" representa qualquer lugar onde você guarda ou movimenta dinheiro. Não há tipos pré-definidos.

ExemploDescrição
Banco InterConta corrente
Cartão NubankCartão de crédito
CarteiraDinheiro em espécie
Poupança CaixaConta poupança
PicPayConta digital

Como criar uma conta

Passo a passo
Menu → Gerenciar ContasNova Conta → Digite o nome → Confirmar
Exemplo prático
Maria cria três contas:
ContaTipoSaldo inicial
Banco InterCorrenteR$ 1.200,00
Cartão NubankCréditoLimite R$ 4.000
CarteiraEspécieR$ 80,00

Contas vinculadas (pai-filho)

Vincule uma conta filha a uma conta mãe para ver o saldo consolidado.

Exemplo
Vincule "Cartão Nubank" como filha de "Banco Inter".
Ao visualizar Banco Inter, o saldo consolidado inclui os gastos do cartão.
Como vincular
Gerenciar Contas → selecione a conta mãe → Vincular conta filha

Contas compartilhadas

Compartilhe contas com outros membros do perfil:

PermissãoO que pode fazer
Somente LeituraVer transações
Leitura e EscritaCriar, editar e excluir transações

5. Registrando receitas

Como registrar

Passo a passo
1. Selecione a conta no dropdown
2. Clique no botão "+"
3. Preencha: Data, Descrição, Valor
4. Tipo: Crédito
5. Clique em Salvar

Exemplo: Salário

Exemplo prático
CampoValor
Data05/11/2025
DescriçãoSalário novembro
ValorR$ 4.200,00
TipoCrédito
ContaBanco Inter

Exemplo: Venda marketplace

Exemplo prático
Data: 12/11/2025
Descrição: Venda marketplace - Kit ferramentas
Valor: + R$ 800,00
Conta: Carteira digital
Observações: Pedido #4521

6. Registrando despesas

Como registrar

Mesmo fluxo das receitas, mas selecione Tipo: Débito.

Exemplo: Supermercado

Exemplo prático
CampoValor
Data08/11/2025
DescriçãoSupermercado Extra
ValorR$ 350,00
TipoDébito
ContaCartão Nubank

Exemplo: Internet

Exemplo prático
Data: 15/11/2025
Descrição: Internet Vivo Fibra
Valor: - R$ 120,00
Conta: Banco Inter
Dica
Para contas fixas como internet, use a funcionalidade de recorrência (capítulo 8).

7. Transferências entre contas

Como registrar uma transferência

No Contas3, uma transferência é feita com dois lançamentos:

Método
1. Débito na conta de origem
2. Crédito na conta de destino

Exemplo prático

Transferir R$ 500: Banco Inter → Carteira
LançamentoContaTipoValorDescrição
1Banco InterDébitoR$ 500Saque para carteira
2CarteiraCréditoR$ 500Depósito do Banco Inter
O saldo consolidado permanece o mesmo.

8. Obrigações e contas recorrentes

Lançamentos recorrentes

Uma recorrência se repete mensalmente. Marque "Recorrente" ao criar o lançamento.

Exemplo: IPTU
Descrição: IPTU 2025
Valor: R$ 165,00/mês
Modo: Recorrente, Mensal
Período: Jan-Dez/2025
Resultado: 12 lançamentos automáticos

Parcelamentos

Marque "Parcelado" e informe o número de parcelas.

Exemplo: TV nova
Descrição: TV Samsung 55"
Valor da parcela: R$ 200,00
Parcelas: 12x
Conta: Cartão Nubank
Resultado: 12 lançamentos (mar/2025 a fev/2026)

Tela de Contratos

Menu → Contratos mostra todas as recorrências e parcelamentos.

Funções
Filtrar por ativas/encerradas
Buscar por descrição
Encerrar recorrência
Cancelar parcelas futuras
Excluir contrato inteiro

Faturas automáticas

Para contas vinculadas (cartões), o sistema gera faturas automáticas com total a pagar.

Exemplo: Fatura do cartão
Conta: Cartão Nubank (filha de Banco Inter)
Vencimento: dia 15
Fatura de novembro: 5 lançamentos, total R$ 870,00
Vencimento: 15/12/2025

9. Projeção de saldo futuro

Como funciona

O painel de projeção calcula o saldo estimado baseado em recorrências e parcelamentos ativos.

Exemplo prático

Projeção de dezembro
ItemValor
Saldo atualR$ 1.000,00
Salário+ R$ 4.200,00
IPTU- R$ 165,00
Internet- R$ 120,00
Saldo projetadoR$ 4.915,00

Insights e comparação

O sistema compara o ciclo atual com o anterior e gera alertas automáticos quando os gastos aumentam significativamente.

Alerta automático
"Gastos aumentaram 15% vs ciclo anterior"

10. Compartilhamento de contas

Níveis de acesso

PapelO que pode fazer
MASTERTudo: criar contas, convidar membros, importar, configurar
MEMBRO (escrita)Criar, editar e excluir transações nas contas autorizadas
MEMBRO (leitura)Apenas visualizar transações

Exemplo: Família

Exemplo prático
MembroPapelPermissão
Pai (João)MASTERAcesso total
Mãe (Maria)MEMBROLeitura e Escrita
Filho (Pedro)MEMBROSomente Leitura

Como compartilhar

Passo a passo
Gerenciar Contas → selecione a conta → MembrosAdicionar membro
Informe o email e selecione a permissão (leitura ou escrita).

11. Sistema de assinaturas

Planos disponíveis

ItemValor
Período de testeGratuito (todas as funcionalidades)
Plano AdministradorR$ 9,99/mês
Membros convidadosGratuito (não precisam de assinatura)

Como assinar

Passo a passo
Configurações → Plano → Escolha o plano → Confirme
Cobrança automática via PagBank.

12. Cancelamento de assinatura

Como cancelar

Passo a passo
Configurações → Plano → Cancelar assinatura → Confirme
Importante
O acesso é mantido até o final do período já pago. Seus dados não são apagados.

Exemplo prático

Exemplo
João assina em 01/11/2025.
Cancela em 20/11/2025.
Acesso mantido até 01/12/2025 (fim do ciclo pago).
Dados preservados indefinidamente. Pode reativar quando quiser.

13. Segurança do sistema

Autenticação e tokens

RecursoDetalhe
LoginGoogle OAuth 2.0 (sem armazenar senha)
Token de acessoJWT, expira em 15 minutos
Token de refreshExpira em 30 dias
ComunicaçãoHTTPS (TLS) em todas as requisições

Proteção de dados

Camadas de segurança
Backups criptografados com AGE
Rate limiting contra força bruta
Isolamento completo de dados por tenant
Monitoramento de acessos suspeitos
Correlation IDs para rastreamento de operações

14. Backup automático

Backups diários

Backups automáticos às 3h, com dump PostgreSQL criptografado com AGE.

Política de retenção GFS
TipoQuantidade
Diários7 (última semana)
Semanais8 (domingos)
Mensais12 (primeiro dia do mês)

Notificação por email

Após cada backup, um email é enviado ao administrador informando sucesso ou falha com detalhes.

15. Administração do sistema

Painel de administração

O painel admin é acessível apenas pelos proprietários do sistema. Mostra métricas, usuários, receita e status do billing.

Acesso
Navegador → /admin/admin.html → Insira seu token JWT

Funções disponíveis

FunçãoDescrição
SuspenderBloqueia login e revoga tokens
ReativarRestaura acesso de usuário suspenso
BanirIRREVERSÍVEL — apaga todos os dados
Conceder planoAtiva plano gratuito sem cobrança
MétricasUsuários, receita, churn, conversão

16. Perguntas frequentes

Posso ter várias contas financeiras?

Sim. Você pode criar quantas contas quiser dentro de cada perfil: Banco Inter, Nubank, Carteira, Poupança, etc.

Posso compartilhar com minha família?

Sim. O administrador (master) convida membros e define permissões por conta. Cada membro faz login com seu próprio Google.

Meus dados estão seguros?

Sim. HTTPS, backups criptografados com AGE, autenticação Google OAuth, rate limiting, isolamento por tenant.

O app funciona offline?

Parcialmente. Visualização offline disponível. Criação e edição requerem conexão para sincronização.

Existe limite de transações?

Não. Sem limite. O sistema é otimizado para milhares de transações.

Perdi acesso ao meu Google. O que faço?

Recupere sua conta Google diretamente com o Google. Seus dados no Contas3 permanecem intactos e acessíveis após a recuperação.

Se cancelar a assinatura, perco meus dados?

Não. Dados preservados indefinidamente. Reative quando quiser e tudo estará como você deixou.

Posso importar dados de outros sistemas?

Sim. Menu → Importar texto. Formato: Data | Descrição | Valor | Observações. Duplicatas são detectadas automaticamente.