Tutorial de Uso ( Guia completo do sistema. )
Este guia mostra como usar o MicroBank no dia a dia da sua micronação: do primeiro acesso à gestão de vários bancos e moedas pelo Banco Central. Cada seção indica o item de menu e o endereço da página correspondente.
Visão Geral e Papéis
O sistema funciona como uma federação bancária: existe um Banco Central e quantos bancos as micronações precisarem, cada um com sua própria moeda, câmbio, cofre e correntistas. Quatro papéis definem o que cada pessoa pode fazer:
| papel | quem é | o que pode fazer |
|---|---|---|
| Master | Autoridade do Banco Central | Tudo: cria bancos, aprova emissões de moeda e empréstimos interbancários |
| Admin | Dono do banco da micronação | Gere seu banco: correntistas, gerentes, empréstimos, conta do governo |
| Gerente | Funcionário do banco | Aprova contas e empréstimos do seu banco |
| Cliente | Correntista PF ou PJ | Transfere, consulta extrato, solicita e paga empréstimos |
Primeiro Acesso
| 1 | Acesse o endereço do sistema. Você verá a tela de login em /Login.lig. |
| 2 | Entre com o e-mail e a senha da sua conta e clique em Entrar. Ainda não tem conta? Use o link "Solicitar abertura de conta". |
| 3 | Esqueceu a senha? Clique em "Esqueci minha senha", informe seu e-mail e siga o link de redefinição enviado (válido por 1 hora). |
| 4 | Depois de entrar, mantenha seus dados atualizados em — é lá também que você troca sua senha. |
Abrir Conta — Pessoa Física e Jurídica
Qualquer cidadão pode pedir uma conta sem estar logado, pelo link "Solicitar abertura de conta" na tela de login (/Abrir-Conta.lig).
| 1 | Escolha o banco da sua micronação na lista. |
| 2 | Selecione o tipo: Pessoa Física ou Pessoa Jurídica (PJ ganha o campo extra Empresa). |
| 3 | Preencha nome, número de registro (documento da micronação), e-mail e senha, e clique em Solicitar Abertura. |
| 4 | Sua conta fica pendente: você ainda não consegue entrar. Aguarde o banco aprovar — só então o número da conta é gerado. |
Transferências
Menu (/Transferir.lig).
| 1 | Informe o número da conta de destino — pode ser de qualquer banco da federação. |
| 2 | Digite o valor no formato 50,00 ou 1.500,00 e uma descrição opcional. |
| 3 | Clique em Confirmar. O débito e o crédito acontecem na hora. |
Pedir e Pagar Empréstimo (Cliente)
Menu e .
| 1 | Em /Solicitar-Emprestimo.lig, informe o valor desejado e clique em Confirmar. O pedido entra Em Análise. |
| 2 | Quando o banco aprovar, o valor é creditado na sua conta e o status muda para Aprovado. |
| 3 | Para pagar, abra /Meus-Emprestimos.lig, digite um valor no campo ao lado do empréstimo e clique em Pagar. Pagamentos parciais são aceitos. |
| 4 | Ao quitar tudo (principal + juros), o status vira Finalizado. |
Extrato e Meus Dados
Em (/Extrato.lig) você acompanha os últimos 100 lançamentos: transferências enviadas e recebidas, créditos de empréstimo e pagamentos — entradas em verde, saídas em vermelho.
Em (/Meus-Dados.lig) você atualiza nome, e-mail e senha. Deixe o campo senha em branco para mantê-la.
Poupança
Menu (/Poupanca.lig).
| 1 | Use Aplicar para mover dinheiro da conta corrente para a poupança, e Resgatar para o caminho inverso — tudo imediato e sem tarifa. |
| 2 | O rendimento (definido pelo banco, % ao mês) é creditado diariamente, pró-rata, direto na poupança, saindo do cofre do banco. |
Cobranças
Menu (/Cobrancas.lig) — o "boleto" das micronações.
| 1 | Em Nova cobrança, informe a conta do pagador, o valor (na sua moeda) e uma descrição. |
| 2 | O pagador vê a cobrança pendente e escolhe Pagar ou Recusar; o emissor pode cancelar enquanto estiver pendente. |
| 3 | O pagamento usa o motor normal de transferências: conversão de moeda, tarifas e IOF se aplicam. |
Transferências Agendadas
Menu (/Agendamentos.lig).
| 1 | Em Novo agendamento, defina destino, valor, a data da primeira execução e a recorrência: única, diária, semanal ou mensal. |
| 2 | O sistema executa automaticamente na data. Sem saldo, ele tenta de novo e marca "aguardando saldo"; após muitas falhas, cancela. |
| 3 | Ideal para salários do governo, mensalidades e mesadas reais. |
Títulos Públicos
Menu (/Titulos.lig) — o "Tesouro Direto" da micronação.
| 1 | Banco: em Emitir título, defina nome, valor total da oferta, juros no vencimento e prazo. As compras creditam a Conta do Governo. |
| 2 | Cidadão: compre qualquer fração disponível do título. A tela já mostra o valor de resgate previsto (principal + juros). |
| 3 | No vencimento, clique em Resgatar: o valor sai da Conta do Governo e entra na sua conta. |
Autenticação em Duas Etapas (2FA)
Menu (/Seguranca-2FA.lig) — proteção extra com códigos TOTP, compatível com Google Authenticator, Authy, Aegis e Microsoft Authenticator.
| 1 | Clique em Ativar autenticação em duas etapas. O sistema mostra um QR code e a chave para cadastro manual. |
| 2 | Escaneie o QR no seu app autenticador e confirme digitando o primeiro código de 6 dígitos. Pronto: a partir do próximo login, além da senha, será pedido o código do app (que muda a cada 30 segundos). |
| 3 | Para desativar, informe o código atual do app na mesma tela. |
Instalar como Aplicativo (PWA)
O MicroBank é um Progressive Web App: pode ser instalado na tela inicial do celular ou do computador e abre em janela própria, como um app de banco de verdade.
| 1 | Android / Chrome: toque no botão flutuante 📲 Instalar app que aparece no canto da tela, ou use o menu do navegador › "Instalar aplicativo". |
| 2 | iPhone / Safari: toque em Compartilhar › "Adicionar à Tela de Início". |
| 3 | Desktop: clique no ícone de instalação na barra de endereço do Chrome/Edge. |
Aprovar Solicitações de Conta (Banco)
Menu (/Solicitacoes.lig) — visível para admin e gerentes.
| 1 | A lista mostra todos os pedidos pendentes (PF e PJ) do seu banco, com nome e número de registro. |
| 2 | Clique em Aprovar para gerar o número da conta automaticamente e liberar o acesso, ou Recusar para negar. |
Gerir Correntistas
Menus e listam os correntistas com conta, saldo e status (✔ aprovada / ✖ recusada). O campo no topo da lista filtra por qualquer texto.
| 1 | Clique no nome de um correntista para abrir a tela Gerenciar usuário (/Alterar-483693-UID.lig). |
| 2 | Altere nome, empresa (PJ), e-mail, senha, número de registro ou status e clique em Alterar. |
| 3 | O botão Excluir remove o usuário definitivamente (pede confirmação). |
Aprovar Empréstimos (Banco)
Menu (/Emprestimos.lig). Os links do topo filtram por status: Em Análise · Aprovados · Finalizadas · Recusados.
| 1 | Nos pedidos Em Análise, use Aprovar ou Recusar. |
| 2 | Ao aprovar, o valor sai do cofre do banco e é creditado na conta do cliente. Se o cofre não tiver saldo, o sistema bloqueia a aprovação. |
| 3 | Cada pagamento do cliente retorna ao cofre automaticamente. |
Meu Banco e Conta do Governo
Menu (/Meu-Banco.lig) mostra o cofre, a moeda e o câmbio, e permite alterar a URL e definir o número da Conta do Governo — uma conta comum (geralmente PJ) que representa o tesouro da micronação.
| 1 | Crie/aprove a conta do governo como uma PJ normal (ex.: "Governo de Pathros"). |
| 2 | Em Meu Banco, informe o número dela no campo Conta do Governo e clique em Alterar. |
| 3 | Use o quadro "Adicionar dinheiro à conta do governo" para transferir do cofre ao tesouro. O histórico aparece em . |
Gerentes
Menu (/Gerentes.lig). Clique em "Novo gerente", informe nome, e-mail e senha e clique em Cadastrar. O gerente já nasce aprovado, com número de conta próprio, e pode aprovar solicitações e empréstimos do banco.
Dashboard do Banco
Menu (/Dashboard.lig) — a visão executiva do seu banco:
| painel | o que mostra |
|---|---|
| Cartões de resumo | Correntistas (PF/PJ), cofre, depósitos à vista, poupança total, tarifas e IOF arrecadados em 30 dias e empréstimos em aberto (com atrasados) |
| Fluxo diário (14 dias) | Barras com o volume interno, o recebido de outros bancos e o enviado a outros bancos, dia a dia |
| Maiores correntistas | Top 10 por patrimônio (conta corrente + poupança) |
| Movimentação por tipo | Lançamentos e volume de 30 dias por categoria (transferência, tarifa, empréstimo...) |
Tarifas, Juros e Limites
No fim da tela , o quadro "Tarifas e taxas do banco" controla a política do seu banco:
| configuração | efeito |
|---|---|
| Tarifa interna / externa (fixa + %) | Cobrada do remetente em cada transferência; vai para o cofre |
| Juros de empréstimo (%) | Somados ao total devido na aprovação |
| Multa por atraso (%) | Aplicada uma vez ao pagar após o vencimento |
| Rendimento da poupança (% a.m.) | Creditado diariamente aos poupadores, saindo do cofre |
Log de Auditoria
Menu (/Auditoria.lig): registra quem aprovou contas e empréstimos, alterou usuários e tarifas, criou títulos e mais — com data, autor e detalhes. Admins veem o próprio banco; o master vê a federação inteira.
Criar Novos Bancos (Master)
Menu (/Novo-Banco.lig) — cada micronação ganha seu banco e sua moeda.
| 1 | Preencha o nome do banco, o nome e o símbolo da moeda (ex.: Dracma / D$). |
| 2 | Defina o câmbio: quanto vale 1 unidade da moeda nova na moeda do Banco Central. Ex.: câmbio 2 = cada D$ 1,00 vale M$ 2,00. |
| 3 | Informe o cofre inicial e os dados do administrador do banco (nome, e-mail, senha) e clique em Criar Banco. |
| 4 | Em você lista todos, edita moeda/câmbio/status e pode suspender um banco. |
Emissão de Moeda (Geração de Fundos)
É o único jeito de criar dinheiro novo — e sempre passa pelo master.
| 1 | Admin do banco: em (/Solicitar-Emissao.lig), informe o valor e a justificativa. |
| 2 | Master: em (/Emissoes.lig), avalie e clique em Aprovar ou Recusar. |
| 3 | Aprovada, a quantia é creditada no cofre do banco solicitante e registrada no histórico como emissão. |
Empréstimo Interbancário
Quando o cofre de um banco aperta, o admin pode pedir socorro ao Banco Central: basta abrir — para admins de bancos comuns, o credor é automaticamente o Banco Central.
| 1 | Admin: informe o valor (na moeda do Banco Central) e confirme. |
| 2 | Master: aprove em . Só o master decide interbancários. |
| 3 | O valor sai do cofre do Central e entra no cofre do banco tomador, já convertido pelo câmbio. |
IOF e Câmbio Dinâmico (Master)
Menu (/Configuracoes.lig).
| 1 | IOF (%): imposto sobre toda transferência da federação, creditado na Conta do Governo do banco de origem (ou no cofre, se não houver). |
| 2 | Elasticidade do câmbio (%): ativa o mercado de câmbio. Em cada transferência entre bancos, a moeda vendida deprecia e a comprada aprecia, proporcionalmente ao volume (limite de 2% por operação). |
| 3 | O modo dinâmico é ligado por banco na tela de edição (). |
Painel e Estatísticas
O (/Painel.lig) mostra os números da federação: total de bancos e correntistas, "PIB" (volume de 30 dias em moeda central), gráfico de cofres por banco, volume diário dos últimos 14 dias e ranking de bancos.
Já /Estatisticas.lig é uma página pública (sem login) com os números gerais de cada banco — perfeita para linkar no site da micronação.
API REST
Integre o site da sua micronação ao banco. Gere seu token pessoal em e envie-o no cabeçalho Authorization: Bearer SEU_TOKEN.
| método | endpoint | função |
|---|---|---|
| GET | /api/saldo | Conta, saldo, poupança e moeda |
| GET | /api/extrato?limite=20 | Últimos lançamentos em JSON |
| POST | /api/transferir | Envia {"conta":"483691","valor":"50,00","descricao":"..."} |