English documentation

02QUEST Ecosystem Guide

Complete guide to the Bank & Vote Consensus platform created by Joaquim Pedro (Joaquim Pedro de Morais Filho).

1. What is 02QUEST?

02QUEST is a mobile-first single-page application that combines an internal token economy (QST), Web3 deposit flows on BNB Smart Chain (USDT BEP-20), peer transfers, withdrawals, vouchers, and a public voting module. The data plane is OpenQuestDB — a JSONBlob-backed store with local cache and Firebase-style APIs.

2. Ecosystem pillars

• Identity — email/password registration, session, guest mode for public vote.
• Bank — QST balance, transfer, buy, withdraw, activity logs.
• Web3 — wallet connect, QR USDT payment, TX validation patterns.
• Consensus — public voting UI and shared voting_stats.
• Admin Core — operator metrics and withdrawal processing.
• OpenQuestDB — shared remote JSON + localStorage sync loop.

3. How OpenQuestDB works

Clients load a blob ID (default or from localStorage), pull remote JSON on an interval, and push on mutations. Paths such as users/, logs/, withdrawals/, vouchers/, and voting_stats/ mirror a realtime database shape without hosting Firebase.

4. Bank lifecycle

1. User registers → identity + zero balance record.
2. Buy flow → pay USDT to admin wallet → verify TX → credit QST.
3. Transfer → atomic balance updates between users.
4. Withdraw → pending request → admin pays or rejects (refund).
5. Voucher → hash secret → redeem once → credit recipient.

5. Voting consensus

Guests can view the public vote surface. Authenticated users interact with the same shared tallies. The design goal is transparent collective preference capture alongside the banking rails, not on-chain ballot privacy.

6. Mobile-only policy

Viewports ≥ 768px display a blocker. This is an intentional UX decision for focus and presentation quality, not a cryptographic security boundary.

7. Running the app

cd app
python -m http.server 8080
# open on mobile or device emulation (< 768px)

8. Author

This software is for education and demonstration. It is not a licensed financial institution.

← Bilingual home