Documentação em português

Guia do Ecossistema 02QUEST

Guia completo da plataforma Bank & Vote Consensus criada por Joaquim Pedro (Joaquim Pedro de Morais Filho).

1. O que é o 02QUEST?

O 02QUEST é uma aplicação web mobile (SPA) que combina uma economia interna de tokens (QST), depósitos Web3 na BNB Smart Chain (USDT BEP-20), transferências, saques, vouchers e um módulo de votação pública. O plano de dados é o OpenQuestDB — armazenamento em JSONBlob com cache local e APIs no estilo Firebase.

2. Pilares do ecossistema

• Identidade — registro e-mail/senha, sessão e modo convidado para voto público.
• Banco — saldo QST, transferência, compra, saque e logs de atividade.
• Web3 — conexão de carteira, QR de pagamento USDT e validação de TX.
• Consenso — interface de votação pública e voting_stats compartilhados.
• Admin Core — métricas operacionais e processamento de saques.
• OpenQuestDB — JSON remoto compartilhado + loop de sincronização com localStorage.

3. Como o OpenQuestDB funciona

Os clientes carregam um ID de blob (padrão ou de localStorage), fazem pull periódico do JSON remoto e push nas mutações. Caminhos como users/, logs/, withdrawals/, vouchers/ e voting_stats/ imitam um banco em tempo real sem hospedar Firebase.

4. Ciclo de vida do banco

1. Usuário se registra → identidade + saldo zero.
2. Compra → paga USDT à carteira admin → verifica TX → credita QST.
3. Transferência → atualização atômica de saldos entre usuários.
4. Saque → pedido pendente → admin paga ou rejeita (reembolso).
5. Voucher → hash do segredo → resgate único → crédito ao destinatário.

5. Votação e consenso

Convidados podem ver a superfície pública de votação. Usuários autenticados interagem com os mesmos totais compartilhados. O objetivo é capturar preferência coletiva de forma transparente junto aos trilhos bancários, sem pretender privacidade de cédula on-chain.

6. Política somente mobile

Viewports ≥ 768px exibem um bloqueio. É uma decisão de UX para foco e qualidade de apresentação, não uma fronteira criptográfica de segurança.

7. Como executar o app

cd app
python -m http.server 8080
# abra no celular ou emulação (< 768px)

8. Autor

Este software é educacional e de demonstração. Não é instituição financeira licenciada.

← Início bilíngue