Duit

"Duitmu, di tanganmu."

Ekosistem pencatatan keuangan personal yang cepat, terpusat, dan bisa di-self-host. Input dari Android, analisis di dashboard web.

Deskripsi Singkat

Duit adalah aplikasi keuangan personal tiga komponen (backend API + dashboard web + app Android) yang dirancang untuk berjalan di shared hosting biasa. Catat transaksi dalam hitungan detik dari HP, lalu lihat ringkasan, grafik, dan riwayat di dashboard web. Tanpa LLM, tanpa Redis, tanpa queue worker — semua sinkron dan sederhana.

Tech Stack

Backend — Laravel REST API

REST API sebagai single source of truth. Berjalan di shared hosting tanpa queue worker atau Redis — semua request diproses synchronously.

Teknologi	Versi	Peran
Laravel	12	Framework utama, routing, Eloquent ORM, middleware
PHP	8.2	Runtime
MySQL	8	Database relasional (MariaDB 10.4+ kompatibel)
Laravel Sanctum	—	Autentikasi token-based (bearer token per device)
PHPUnit	—	Feature testing (64 test cases)

Pattern: Resource API (JSON:Resource transform), route-model-binding, policy-based authorization, form request validation.

Dashboard Web — Astro SSR

Dashboard read-only dengan server-side rendering. Setiap page fetch data dari Laravel API di server-side, render HTML, kirim ke client. Tidak ada client-side JS framework — hanya vanilla interactivity.

Teknologi	Versi	Peran
Astro	7	SSR framework, .astro components, API routes
Tailwind CSS	4	Styling utility-first
TypeScript	5	Type safety di API routes & components
Node.js	22.12+	Runtime SSR

Pattern: Middleware auth (cookie-based session), server-side fetch ke Laravel API, Chart.js untuk grafik (lazy-loaded), export CSV via API proxy.

App Android — Kotlin + Jetpack Compose

Native Android app sebagai input utama. Arsitektur clean (data → domain → ui) dengan unidirectional data flow.

Teknologi	Versi	Peran
Kotlin	2.0	Bahasa utama
Jetpack Compose	BOM 2024.12	Declarative UI toolkit
Material 3	1.3.x	Design system (dynamic color, typography, shapes)
Hilt	—	Dependency injection
Retrofit	2	HTTP client ke Laravel API
OkHttp	4	HTTP interceptor (AuthInterceptor, logging)
Kotlin Coroutines	—	Async operations
Navigation Compose	—	Bottom nav + nested NavHost
EncryptedSharedPreferences	—	Token storage (AES256-GCM, via Jetpack Security)
Room	2.6.1	Local cache (offline-first, 4 entities)
WorkManager	—	Background job: cek budget & savings harian
JUnit4 + Mockito	—	Unit testing

Pattern: MVVM + Repository, Result<T> error handling, StateFlow untuk UI state, sealed class untuk state modeling.

Min SDK 31 (Android 12), Target SDK 35.

Alur dan Perencanaan

Arsitektur

┌─────────────┐      ┌──────────────┐      ┌─────────────┐
│   Android   │      │   Laravel    │      │    MySQL    │
│  (Kotlin)   │ ───→ │     API      │ ───→ │  Database   │
│  Input data │      │  Single SoT  │      │             │
└─────────────┘      └──────┬───────┘      └─────────────┘
                            │
                            ▼
                     ┌──────────────┐
                     │     Astro    │
                     │  Dashboard   │
                     │  (read-only) │
                     └──────────────┘

Prinsip arsitektur:

• Android = input utama
• Web = analisis (read-only v1–v4)
• Backend = single source of truth
• Tidak ada LLM — semua parsing on-device di versi mendatang
• Shared hosting friendly — tanpa queue, tanpa Redis

Roadmap

Versi	Fokus	Status
v1	Input manual, Laravel API, Astro dashboard	✅ Live
v2	Budget & savings, notifikasi, password reset, email verification, 2FA	✅ Done
v3	OCR scan struk (on-device ML Kit)	✅ Done
v4	Voice input (on-device SpeechRecognizer)	✅ Done
v5	Multi-user lanjutan (shared wallet)	🚧 Backend done, Android next

Detail roadmap: docs/07-roadmap.md

Business Rules Penting

• Wallet cash: maksimal 1 per user, dibuat otomatis saat register, tidak bisa dihapus
• Wallet bank/ewallet: tidak terbatas per user
• Transaksi: wajib ada wallet_id dan category_id
• Data isolation: semua query HARUS filter by user_id — user A tidak bisa akses data user B
• Shared wallet (v5): owner bisa mengundang user lain via email; member bisa lihat wallet + lihat/buat transaksi, tapi tidak bisa edit/hapus wallet atau kelola member

Cara Instalasi

Prasyarat

• PHP 8.2+ dengan ekstensi: pdo_mysql, mbstring, openssl, json
• MySQL 8+ (atau MariaDB 10.4+)
• Composer 2+
• Node.js 20+ dan npm 10+
• Android Studio (Koala+ / 2024.1+) dengan Android SDK 35
• XAMPP (disarankan untuk lokal) — Apache port 80, MySQL port 3306

1. Clone Repository

git clone https://github.com/USERNAME/personal-finance.git
cd personal-finance

2. Setup Backend (Laravel)

cd backend
composer install
cp .env.example .env
php artisan key:generate

Edit .env:

APP_URL=http://localhost:8000
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=duit
DB_USERNAME=root
DB_PASSWORD=

SANCTUM_STATEFUL_DOMAINS=localhost:4321
SESSION_DOMAIN=localhost

Jalankan migrasi dan seed:

php artisan migrate --seed
php artisan serve   # jalan di http://localhost:8000

Verifikasi: php artisan test — harus 19/19 passed.

3. Setup Dashboard Web (Astro)

cd ../web
npm install
cp .env.example .env

Edit .env:

API_BASE_URL=http://localhost:8000/api

Jalankan:

npm run dev     # jalan di http://localhost:4321

Build production: npm run build

4. Setup App Android

1. Buka folder android/ di Android Studio
2. Tunggu Gradle sync selesai
3. Update NetworkModule.kt dengan URL backend:

   // android/app/src/main/kotlin/com/duit/app/data/di/NetworkModule.kt
   private const val BASE_URL = "http://10.0.2.2:8000/api/"   // emulator
   // atau IP host untuk device fisik

4. Jalankan di emulator atau device fisik (min SDK 31, target SDK 35)

Catatan: Emulator mengakses host via 10.0.2.2. Device fisik butuh IP LAN host + port forwarding.

5. Konfigurasi CORS (untuk Astro Dashboard)

Pastikan config/cors.php di backend mengizinkan domain Astro:

'allowed_origins' => [
    'http://localhost:4321',
    // tambahkan domain production di sini
],

6. Verifikasi End-to-End

1. Register user baru di Android app
2. Tambah transaksi (misal: "Kopi", 18000, expense)
3. Buka dashboard web di browser, login dengan user yang sama
4. Cek transaksi muncul di dashboard

Jika semua berfungsi, instalasi sukses.

Struktur Repo

personal-finance/
├── backend/        # Laravel REST API (PHP)
├── web/            # Astro SSR dashboard (Node.js)
├── android/        # Kotlin + Jetpack Compose
├── docs/           # Semua dokumentasi
├── DESIGN.md       # Design system
├── AGENTS.md       # Panduan AI agent
└── README.md       # File ini

Dokumentasi

• Project Overview
• Arsitektur
• Mobile App
• Backend API
• Dashboard Web
• Database
• Roadmap
• UI/UX
• Tasks
• Design System

License

Proyek ini dilisensikan di bawah lisensi MIT — lihat file LICENSE.