GAZFOOL PRODUCTION
BLUEPRINT
Rancangan teknis tingkat sistem untuk membangun ulang Web Mining GAZFOOL secara terstruktur. Dokumen ini menjabarkan bagaimana keputusan dan kebutuhan dalam GMSS diterjemahkan menjadi arsitektur, domain database, API, alur proses, keamanan, dan operasional.
1. Status dokumen dan aturan dasar
Fondasi proyek
GMSS v1.1 adalah spesifikasi induk yang telah disepakati. Blueprint ini tidak menggantikan GMSS; fungsinya menerjemahkan spesifikasi induk menjadi rancangan teknis.
Greenfield / fresh build
Implementasi baru dirancang dari awal. Tidak menggunakan website lama, kode lama, Pages, Worker, database D1, atau konfigurasi deployment lama sebagai fondasi.
Arsitektur, database, API
System Architecture v1.0, Database Schema v1.0, dan API Contract v1.0 merupakan rancangan awal yang perlu ditinjau dan dirinci sebelum implementasi.
Implementasi dan deployment
Belum ada kode aplikasi baru, database produksi, integrasi aktif, atau deployment yang dibuat melalui blueprint ini.
2. Identitas dan ruang lingkup
GAZFOOL ECOSYSTEM
Token: GAZFOOL ($GAZ)
Blockchain: Sidra Chain
Standard: ERC-20 • Decimals: 18
Total supply: 1,000,000 $GAZ
Contract:0x41aa098e2Dd12954b969481C45df0cF7EfEC31e8
Empat pilar ekosistem
- COMMUNITY
- DIGITAL
- UMKM
- GAME
Website mining adalah salah satu bagian ekosistem, bukan keseluruhan identitas GAZFOOL.
Kontrak token yang sudah ada dipertahankan. Integrasi harus memeriksa alamat, chain ID, decimals, ABI, fungsi kontrak, event, hak akses, dan perilaku transaksi aktual. Status verifikasi kontrak tidak otomatis membuktikan integrasi website sudah berjalan.
3. System Architecture v1.0
RANCANGAN AWALArsitektur cloud-first dengan satu aplikasi backend modular. Modul dipisahkan secara logis agar pengembangan dan pengawasan mudah, tanpa memecah layanan menjadi banyak Worker sebelum memang dibutuhkan.
Workers Static Assets
Menyajikan frontend web dan aset statis. Tampilan responsif untuk Android, tablet, dan desktop.
Workers Backend
Menjalankan API, autentikasi, otorisasi, validasi mining, reward, referral, game, wallet, admin, dan integrasi blockchain.
D1 Database
Menyimpan data operasional terstruktur: akun, sesi, status KYC, catatan reward, ledger internal, konfigurasi, dan audit log.
R2 / KV / Queues
R2 untuk file privat dan aset; KV untuk cache atau data sementara non-finansial; Queues untuk pekerjaan latar belakang yang aman diproses ulang.
Pemisahan environment
| Environment | Tujuan | Aturan |
|---|---|---|
| Development | Pengembangan internal | Data uji, kredensial terpisah, tidak memakai dana/token produksi. |
| Staging | Uji integrasi dan penerimaan | Konfigurasi menyerupai produksi; transaksi dibatasi dan diawasi. |
| Production | Layanan pengguna | Secret, database, domain, monitoring, backup, dan akses terpisah. |
4. Database Schema v1.0
RANCANGAN DOMAIN / TABELSkema berikut adalah pengelompokan awal berdasarkan domain GMSS. Nama kolom, tipe data, constraint, indeks, relasi, migrasi, dan strategi retensi harus difinalisasi sebelum SQL produksi dibuat.
| Domain | Tabel inti (rancangan) | Catatan penting |
|---|---|---|
| Account & Identity | users, user_profiles, user_devices, user_sessions | Identitas unik, satu akun per identitas KYC, kebijakan satu perangkat aktif, riwayat perangkat. |
| Authentication & Security | otp_verifications, security_events, password reset / OAuth records | OTP tidak disimpan plaintext; expiry, attempt limit, rate limit, sesi dan pemulihan. |
| KYC | kyc_submissions, private file references | Hanya Level 1 dan Level 2; dokumen disimpan privat dengan akses terbatas. |
| Mining & Pools | reward_pools, pool_ledger, mining_sessions, mining_rewards | Anggaran emisi, saldo pool, sesi 24 jam, klaim, expiry reward, dan rekonsiliasi. |
| Referral | referral_relationships, referral_rewards | Relasi sampai tiga tingkat; cegah self-referral, siklus, dan atribusi ganda. |
| Wallet & Chain | wallets, wallet_ledger, blockchain_transactions, deposit_records, withdrawal_records | Ledger internal konsisten; status transaksi on-chain diverifikasi sebelum dianggap berhasil. |
| Game & GP | game_sessions, game_attempts, gp_ledger, gp_conversions | Training dan Real Game dipisah; validasi waktu dan hasil di server. |
| Notifications & Admin | notifications, admin_users, admin_audit_logs | Notifikasi berbasis event nyata; akses admin berdasarkan role dan seluruh tindakan sensitif diaudit. |
| Platform operations | ads/revenue, system configs, emergency mode, backup records, announcements, monitoring | Domain pendukung GMSS yang perlu dimasukkan ke skema final. |
Aturan integritas data yang wajib
- Operasi finansial memakai transaksi database atomik dan idempotency key; cegah double claim, double credit, dan pemrosesan ganda.
- Ledger menjadi jejak perubahan; saldo tidak boleh diubah tanpa entri ledger yang dapat diaudit.
- Referral menyimpan rantai ancestor yang tervalidasi dan tidak boleh membentuk siklus.
- Satu user hanya memiliki satu perangkat berstatus aktif sesuai kebijakan perangkat.
- Nominal token menggunakan presisi integer/bigint berbasis unit terkecil; jangan memakai floating point. Representasi dan operasi aritmetika harus diuji.
- Data blockchain yang telah dikonfirmasi harus dapat direkonsiliasi; D1 bukan sumber kebenaran saldo on-chain.
- Data KYC dipisahkan dari data publik, dienkripsi, dibatasi aksesnya, dan memiliki kebijakan retensi.
5. API Contract Specification v1.0
RANCANGAN ENDPOINTPrefix API yang diusulkan: /api/v1/. Format JSON melalui HTTPS. Waktu server UTC. Identitas resource menggunakan UUID. Operasi yang dapat memengaruhi saldo atau reward harus memakai idempotency key.
Kelompok endpoint
| Kelompok | Contoh endpoint / fungsi |
|---|---|
| Auth | POST /auth/register, /auth/login, /auth/logout, /auth/refresh, /auth/google, GET /auth/me |
| Security | /security/otp/request, /security/otp/verify, device management, session revoke |
| Account & KYC | /account/profile, /account/devices, /kyc/status, /kyc/level-1, /kyc/level-2 |
| Mining | /mining/status, /mining/start, /mining/current, /mining/rewards, /mining/rewards/{id}/claim |
| Referral | /referral/summary, /referral/team, /referral/rewards, /referral/code |
| Wallet & Chain | /wallet/balance, /wallet/transactions, connect challenge/verify, /deposit, /withdrawal/quote, /withdrawal/submit |
| Game & GP | /game/config, /game/session, /game/attempt, /gp/balance, /gp/history, /gp/conversion |
| Tasks & Notifications | /tasks, /notifications, read/unread state |
| Public | /public/pools, /public/distributions, /public/tokenomics, /public/system-status |
| Admin | User/KYC/finance/mining/referral/game/ads/monitoring/emergency/configuration endpoints sesuai permission. |
Format respons yang diusulkan
Berhasil
{ success: true, data: {...}, meta: { request_id, server_time } }Gagal
{ success: false, error: { code, message }, meta: { request_id } }Kontrak yang masih harus dirinci
- Request/response schema lengkap, field wajib/opsional, batas ukuran, validasi, dan format error.
- Pagination, sorting, filtering, retry policy, timeout, dan idempotency behavior.
- Permission matrix untuk setiap endpoint admin dan pengguna.
- OAuth/Google Sign-In, strategi access/refresh token, session rotation, dan revocation.
- Verifikasi signature webhook/event blockchain, konfirmasi transaksi, reorg handling, dan rekonsiliasi.
- Aturan rate limit, anti-abuse, logging, serta redaksi data sensitif.
6. Alur proses inti
6.1 Registrasi dan keamanan akun
Pengguna mendaftar menggunakan email/WhatsApp, kata sandi, dan referral code opsional; Google Sign-In dapat disediakan setelah alur OAuth diverifikasi. OTP dipakai untuk verifikasi dan peristiwa keamanan yang ditetapkan GMSS. Login dari perangkat baru memicu verifikasi tambahan dan pencatatan perangkat.
Satu orang satu akun. KYC Level 1 memverifikasi email dan WhatsApp; KYC Level 2 menggunakan identitas pemerintah dan selfie. Kebijakan satu perangkat aktif diterapkan dengan prosedur transfer perangkat yang tercatat.
6.2 Mining dan claim
Waktu dihitung server, bukan jam browser. Mining tidak auto-restart. Pengguna harus memulai siklus berikutnya secara manual. Reward hanya dapat diklaim setelah syarat KYC Level 2 terpenuhi. Reward yang tersedia dapat diklaim selama 30 hari; setelah itu kedaluwarsa dan kembali ke Mining Pool sesuai aturan GMSS.
Dynamic Emission membatasi reward berdasarkan anggaran dan saldo pool. Jumlah penambang aktif memengaruhi pembagian; tidak ada janji tanggal pasti pool habis dan tidak boleh ada reward tanpa dukungan saldo.
6.3 Referral L1 / L2 / L3
Persentase nominal yang ditetapkan dalam GMSS: L1 5%, L2 3%, L3 2%. Reward hanya berasal dari aktivitas mining yang memenuhi syarat dan mengikuti status aktif setiap pihak sesuai aturan. Referral Pool terpisah dari Mining Pool dan Game Reward Pool.
Snapshot aktivitas, dasar pengenaan persentase, pembulatan, batas reward, dan perlakuan ketika salah satu tingkat tidak aktif harus ditetapkan sebelum implementasi.
6.4 GAZ PUZZLE dan GP
Satu permainan sliding-block dengan dua mode. Training Game gratis, tanpa GP dan tanpa batas latihan. Real Game memiliki tiga level/attempt per sesi harian, masing-masing berdurasi 30 detik; setelah ketiga attempt digunakan, cooldown 24 jam. Hasil diverifikasi server-side. Kesalahan menghabiskan attempt tetapi tidak menghasilkan GP.
GP adalah poin internal, bukan token on-chain. GP dapat dikonversi menjadi $GAZ berdasarkan rasio dan batas yang belum difinalisasi serta harus didukung Game Reward Pool. Puzzle harus memiliki solusi sah, validasi solver, dan tingkat kesulitan yang benar-benar meningkat.
6.5 Deposit, withdrawal, dan wallet
Saldo wallet internal menggabungkan sumber reward yang sudah dikreditkan dan deposit eksternal, tetapi riwayat harus membedakan setiap jenis transaksi. Deposit/withdrawal harus diverifikasi terhadap Sidra Chain. Status pending atau processing tidak boleh ditampilkan sebagai sukses.
Biaya withdrawal 1% pernah disetujui secara provisional; angka final dan minimum withdrawal menunggu validasi biaya aktual. Rencana biaya hybrid: pengguna membayar service fee dan GAZFOOL menanggung gas Sidra, dengan detail operasional yang harus diverifikasi.
6.6 Iklan dan pendapatan
Iklan sebelum mining hanya boleh diterapkan jika kebijakan tertulis penyedia mengizinkan konteks mining/reward/crypto. Tidak boleh mewajibkan klik iklan. Jika penyedia tidak mengizinkan atau gagal dimuat, mining tidak boleh dirugikan; gunakan placement non-blocking atau sponsor yang sesuai. Pendapatan dicatat sebagai estimasi, terverifikasi, belum dibayar, diterima, biaya, dan surplus.
7. Keamanan dan kontrol akses
Pengguna
- Password di-hash dengan algoritma kuat.
- OTP expiry, batas percobaan, rate limit, anti-abuse.
- Verifikasi perangkat baru dan pencabutan sesi perangkat lama.
- Isolasi data antar pengguna.
Super Admin
- Authenticator-app 2FA dan email OTP.
- Akses sensitif dibatasi dan dicatat.
- Secret hanya di environment secret manager.
- Recovery dan rotasi kredensial aman.
Role-Based Access
Super Admin, Finance Admin, KYC Admin, dan Support Admin. Hak akses ditegakkan di backend, bukan sekadar menyembunyikan tombol di frontend. Setiap perubahan role/permission diaudit.
Financial integrity
Idempotency, transaksi atomik, ledger, rekonsiliasi chain, kontrol saldo pool, pemisahan treasury, dan pemeriksaan anomali wajib ada.
Prinsip data sensitif
- OTP, password, private key, dan secret tidak pernah disimpan atau ditampilkan dalam bentuk plaintext yang tidak semestinya.
- Dokumen KYC disimpan privat dengan akses minimum, enkripsi, audit akses, dan retensi yang ditetapkan.
- Alamat wallet pribadi, email, nomor WhatsApp, dan identitas KYC tidak boleh muncul di halaman transparansi publik.
- Webhook dan event blockchain harus diverifikasi sumber dan integritasnya.
8. Operasional, transparansi, dan pemulihan
Public transparency
Publikasikan alokasi/remaining Mining Pool dan Referral Pool, total distribusi, tanggal, jumlah, kategori, jumlah penerima, serta TXID/explorer jika sudah terkonfirmasi. Jangan tampilkan identitas pribadi.
Admin Dashboard
Monitoring user, KYC, mining, referral, game/GP, pools, wallet, deposit/withdrawal, blockchain, ads/revenue, keamanan, laporan, dan konfigurasi sesuai role.
Backup & monitoring
Backup terenkripsi, terpisah dari sistem utama, akses terbatas, retensi jelas, dan restore test. Monitor backend, D1, blockchain, reward, transaksi, keamanan, iklan, dan backup.
Emergency Mode
Super Admin dapat menjeda mining, reward, atau withdrawal. Pengguna tetap dapat melihat data yang diizinkan. Alasan, waktu, pelaksana, cakupan, dan pemulihan dicatat. Sistem tidak otomatis aktif kembali.
Prinsip status transaksi
Transaksi hanya boleh disebut berhasil setelah verifikasi dan konfirmasi yang disyaratkan. Ketika koneksi chain terganggu, sistem melakukan rekonsiliasi sebelum mengubah status akhir.
9. Keputusan dan verifikasi yang masih terbuka
Daftar berikut bukan kekurangan yang boleh diisi dengan asumsi. Ini adalah pekerjaan verifikasi atau keputusan yang harus diselesaikan sebelum fitur terkait dibangun.
Pool dan emisi
Verifikasi alokasi kontrak dan saldo aktual; anggaran emisi harian; aturan pembulatan; batas dan pengaman setiap pool.
Reward permainan
GP per level, bobot kesulitan, rasio GP:$GAZ, batas kewajiban, pendanaan Game Reward Pool, dan aturan konversi.
Transaksi chain
Strategi alamat deposit, jumlah konfirmasi, gas sponsorship, treasury custody, minimum withdrawal, dan biaya aktual.
Perhitungan referral
Snapshot status aktif, dasar persentase, pembulatan, batas, dan perlakuan tingkat yang tidak aktif.
Privasi dan verifikasi
Penyedia KYC, pemeriksaan manual, enkripsi, lokasi penyimpanan, retensi, penghapusan, dan prosedur banding.
Keandalan layanan
Backup cadence, retensi, RPO/RTO, ambang monitoring, kanal alert, dan prosedur incident response.
Integrasi kontrak
Validasi ABI, chain ID, event, metode read/write, signer/custody, dan uji transaksi nyata pada lingkungan yang tepat.
Kepatuhan penyedia
Persetujuan tertulis penyedia untuk konteks reward/mining/crypto dan fallback ketika iklan tidak tersedia.
10. Tahapan kerja setelah blueprint
- Review blueprint: periksa apakah terjemahan teknis tetap sesuai GMSS dan keputusan yang telah disepakati.
- UI/UX specification: susun spesifikasi halaman, navigasi, komponen, responsivitas, dan state pengguna/admin.
- Technical design finalization: lengkapi arsitektur, database, API, permission matrix, data flows, dan integrasi chain.
- Security & financial design review: telaah ledger, pool accounting, idempotency, KYC, custody, threat model, dan audit trail.
- Implementation plan: urutan modul, acceptance criteria, test plan, migrasi, observability, dan rollback.
- Build only after explicit instruction: implementasi bertahap pada infrastruktur baru, lalu pengujian staging dan produksi.
Dokumen induk: GAZFOOL MASTER SYSTEM SPECIFICATION (GMSS) v1.1. Jika ada konflik, GMSS dan keputusan resmi yang telah disepakati menjadi acuan; perubahan harus dicatat melalui kontrol versi.
