Go Financial Core System - System Design

Kita mau bikin sistem seperti e-wallet (contoh: Dana, OVO), tapi:

• Aman (tidak bisa saldo dobel / hilang)
• Tidak error saat banyak orang transaksi bersamaan
• Mudah dikembangkan

🧠 1. Gambaran Besar Sistem

Bayangkan sistem seperti restoran 🍔

• Client = pelanggan
• Handler = kasir (terima pesanan)
• Usecase = dapur (proses logika)
• Domain = resep asli (aturan bisnis)
• Infrastructure = alat masak (DB, RabbitMQ)

Strukturnya:

Client → Handler → Usecase → Domain → Infrastructure

Artinya:

👉 User request → diproses → aturan dijalankan → disimpan ke database

🧱 2. Modul Utama (Fitur Awal)

Kita mulai dari fitur penting dulu:

• 👤 User → data pengguna
• 💰 Wallet → dompet (saldo)
• 🔄 Transaction → transaksi antar wallet
• 📒 Ledger → catatan semua uang masuk/keluar (INI PALING PENTING)
• 💸 Transfer → kirim uang

🔑 Kenapa Ledger Penting?

❌ Cara salah:

saldo = saldo - 1000

👉 Bahaya! Bisa error kalau banyak transaksi bersamaan

✅ Cara benar:

catat ke ledger(DEBIT / CREDIT)

👉 Saldo dihitung dari riwayat (ledger)

🧠 Analogi: Ledger itu seperti buku tabungan

⚠️ 3. Cara Biar Aman (Anti Error)

Ini bagian paling penting 🔥

🔐 Rule 1 — Jangan Ubah Saldo Langsung

❌ Salah:

balance = balance - amount

✅ Benar:

• Simpan ke ledger dulu
• Hitung saldo dari ledger

🔐 Rule 2 — Pakai Lock Database

Contoh:

SELECT * FROM wallets WHERE id = 1 FOR UPDATE;

👉 Artinya: "Hei database, kunci data ini dulu, jangan ada yang ganggu"

🧠 Analogi: Kayak pegang kursi → orang lain nggak boleh duduk dulu

🔐 Rule 3 — Idempotency (Anti Double Transaksi)

Setiap transaksi harus punya ID unik:

transfer_id = unik

👉 Kalau request dikirim 2x:

• Tidak akan diproses 2x

🧠 Analogi: Kayak tiket bioskop → 1 tiket cuma bisa dipakai sekali

🔐 Rule 4 — Sync vs Async

👉 Uang harus langsung (biar aman)

🔐 Rule 5 — Hindari Deadlock (PENTING BANGET)

❌ Masalah Deadlock

Bayangkan:

• A transfer 1 → 2
• B transfer 2 → 1

Yang terjadi:

• A pegang wallet 1, nunggu wallet 2
• B pegang wallet 2, nunggu wallet 1

💥 Keduanya stuck!

✅ Solusi: Urutan Lock Konsisten

Selalu:

lock wallet kecil → wallet besar

Contoh:

• Transfer 1 → 2 → lock 1 lalu 2
• Transfer 2 → 1 → tetap lock 1 lalu 2

👉 Jadi tidak akan tabrakan

🧠 Analogi Simpel

Bayangkan jalan sempit:

• Kalau orang masuk dari dua arah → macet
• Kalau semua sepakat: "nomor kecil duluan" → lancar

🗂️ 4. Struktur Project (Go)

fincore/
│
├── cmd/            → main app
├── internal/
│   ├── domain/     → aturan bisnis
│   ├── usecase/    → logika aplikasi
│   ├── repository/ → akses database
│   ├── infrastructure/ → DB, RabbitMQ
│   └── delivery/   → HTTP / gRPC
│
├── pkg/            → helper
├── configs/        → config
└── .env            → environment

🧾 5. Model Data (Sederhana)

💰 Wallet

type Wallet struct {
    ID      string
    UserID  string
    Balance int64
}

📒 Ledger (INI PALING PENTING)

type Ledger struct {
    WalletID string
    Amount   int64
    Type     string // DEBIT / CREDIT
}

🔄 Transaction

type Transaction struct {
    FromID string
    ToID   string
    Amount int64
}

🐇 6. RabbitMQ (Event System)

Dipakai untuk:

• Kirim notifikasi
• Logging
• Event transaksi

Contoh event:

• transaction.created
• transaction.success

❗ Tapi ingat:

👉 JANGAN pakai RabbitMQ untuk update saldo

✅ 7. Hasil Step 1

Kalau kamu sudah sampai sini, kamu sudah punya:

✅ Desain sistem yang rapi

✅ Sistem aman dari race condition

✅ Sistem aman dari deadlock

✅ Struktur project Go yang jelas

✅ Fondasi fintech system 🔥