Arsitektur sistem
Strategi di balik Ageviro: komponen, alur pesan, dan keputusan desain.
Halaman ini menjelaskan kenapa sistemnya disusun seperti ini, bukan hanya apa saja isinya.
#Komponen
| Lapisan | Dipakai untuk |
|---|---|
| Next.js (App Router) | Halaman, route API, dan middleware |
GitHub /storage/database/ | Pengguna, percakapan, anggota, pesan, perangkat, API key, OTP, log moderasi |
| Pusher | Memberi tahu perangkat lain bahwa ada pesan baru |
GitHub /storage/realtime/ | Berita, komentar, like, dan Kritik & Saran (hanya diakses dari server) |
| Email (OTP) dan Google | Cara membuktikan kepemilikan email saat daftar atau reset |
#Alur sebuah pesan
- Klien mengirim pesan ke server. Identitas pengirim selalu diambil dari cookie sesi yang ditandatangani, tidak pernah dari isi permintaan.
- Server memeriksa: sesi valid, akun tidak diblokir, perangkat belum dikeluarkan, pengirim memang anggota percakapan, dan pesan tidak lebih dari 4000 karakter.
- Pesan disimpan di tabel
messages. Inilah sumber kebenaran: perangkat mana pun yang membuka percakapan membaca dari sini. - Server memberi sinyal lewat Pusher. Perangkat lain memuat pesan baru.
- Penanda terbaca disimpan per anggota (
last_read_at), sehingga status baca ikut ke perangkat mana pun.
#Keputusan desain
Satu sumber kebenaran di server. Pesan tidak hidup di satu ponsel. Itu sebabnya login dari perangkat baru langsung melihat riwayat, dan kenapa pesan sementara bisa hilang di semua perangkat sekaligus.
Sesi per perangkat. Setiap login membuat satu baris di tabel devices, dan id-nya ikut di dalam token. Mengeluarkan satu perangkat berarti menandai barisnya dicabut. Token lain tidak terganggu. "Keluar dari semua perangkat" memakai cara berbeda: menaikkan token_version akun.
Tautan perangkat dengan kode, bukan password. Perangkat baru meminta kode, perangkat lama menyetujuinya. Password tidak pernah diketik di perangkat yang tidak kamu percaya. Lihat Perangkat tertaut.
Batas permintaan. Pembatasan permintaan dihitung di memori tiap instance server (tidak menulis ke GitHub supaya kuota commit tidak habis). Perlindungan brute-force login dan OTP tetap global karena hitungannya tersimpan di data akun/OTP.
API terpisah dari sesi. API publik memakai key, bukan cookie. Key hanya bisa dibuat oleh akun yang bergabung ke developer mode, dan hanya hash-nya yang disimpan.
#Perbandingan dengan aplikasi chat besar
| Hal | Ageviro | Aplikasi seperti WhatsApp |
|---|---|---|
| Identitas | Username dan email | Nomor telepon |
| Perangkat tambahan | Kode tautan, maksimal 4 | Kode atau QR, beberapa perangkat |
| Penyimpanan pesan | Di server | Di perangkat, cadangan terpisah |
| Enkripsi end-to-end | Belum ada | Ada |
| Pesan sementara | Ada, per percakapan | Ada |
| Undangan grup | Link berkode acak, bisa direset | Link undangan |