AgeviroDocs

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

LapisanDipakai untuk
Next.js (App Router)Halaman, route API, dan middleware
GitHub /storage/database/Pengguna, percakapan, anggota, pesan, perangkat, API key, OTP, log moderasi
PusherMemberi tahu perangkat lain bahwa ada pesan baru
GitHub /storage/realtime/Berita, komentar, like, dan Kritik & Saran (hanya diakses dari server)
Email (OTP) dan GoogleCara membuktikan kepemilikan email saat daftar atau reset

#Alur sebuah pesan

  1. Klien mengirim pesan ke server. Identitas pengirim selalu diambil dari cookie sesi yang ditandatangani, tidak pernah dari isi permintaan.
  2. Server memeriksa: sesi valid, akun tidak diblokir, perangkat belum dikeluarkan, pengirim memang anggota percakapan, dan pesan tidak lebih dari 4000 karakter.
  3. Pesan disimpan di tabel messages. Inilah sumber kebenaran: perangkat mana pun yang membuka percakapan membaca dari sini.
  4. Server memberi sinyal lewat Pusher. Perangkat lain memuat pesan baru.
  5. 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

HalAgeviroAplikasi seperti WhatsApp
IdentitasUsername dan emailNomor telepon
Perangkat tambahanKode tautan, maksimal 4Kode atau QR, beberapa perangkat
Penyimpanan pesanDi serverDi perangkat, cadangan terpisah
Enkripsi end-to-endBelum adaAda
Pesan sementaraAda, per percakapanAda
Undangan grupLink berkode acak, bisa diresetLink undangan