Skip to content

Untuk developer ​

Catatan ringkas untuk build dari source dan memahami konfigurasi cadangan. Repo aplikasi: personal-dompet/mobile. Repo docs ini: personal-dompet/doc.

Syarat ​

  • Flutter stable (repo memakai 3.47.x, Dart 3.13) + Android SDK, minSdk 26.
  • Node.js 22+ hanya untuk site dokumentasi ini.

Menjalankan aplikasi ​

sh
cd dompet_app
flutter pub get
# Client ID ada di Google Cloud Console → Credentials → OAuth Web client
flutter run --dart-define=GOOGLE_SERVER_CLIENT_ID=<web-client-id>.apps.googleusercontent.com
# atau pakai file (lihat env.example.json):
flutter run --dart-define-from-file=env.json

Tanpa GOOGLE_SERVER_CLIENT_ID, aplikasi jalan normal kecuali fitur cadangan (muncul pesan konfigurasi).

Konfigurasi Google (agar cadangan jalan) ​

  1. Aktifkan Google Drive API di project Google Cloud.
  2. OAuth consent screen: tipe External, isi beranda + kebijakan privasi dari site ini, publikasikan (jangan bertahan di Testing untuk rilis).
  3. Buat 2 client:
    • Web application → Client ID-nya dipakai sebagai GOOGLE_SERVER_CLIENT_ID.
    • Android → packageName com.lutfi.dompet.app + SHA-1 keystore yang dipakai build (debug dan release didaftarkan terpisah).
  4. Scope yang dipakai kode: https://www.googleapis.com/auth/drive.appdata (BackupScopes.appData di lib/features/backup/services/backup_auth_service.dart).
  5. Selama status Testing, daftarkan akun penguji di Test users — selain itu dapat error 403.

Error khas: ApiException: 10 = SHA-1 / package name / client ID tidak cocok. 403 akses ditolak = akun belum jadi Test user / Drive API belum aktif.

Arsitektur singkat ​

  • lib/features/backup/: backup_auth_service.dart (login + AuthClient) → drive_backup_service.dart (upload/unduh dompet_backup.db + backup_meta.json di appDataFolder) → backup_repository.dart (staging, verifikasi header SQLite + integrity_check, rollback aman) → backup_cubit.dart (state UI).
  • Database lokal: dompet.db via sqflite_common_ffi, offline-first. Cadangan butuh internet (connectivity_plus).
  • Istilah UI baku (jangan bocorkan nama kode ke UI): Target (bukan Pocket), Alokasi / Ditarik kembali, Belanja dari target, Anggaran / Rencana Anggaran, Cadangan (bukan Backup). Lihat docs/DOCUMENT.md di repo aplikasi.

Build rilis ​

sh
flutter build apk --release --split-per-abi --dart-define-from-file=env.json
# output: build/app/outputs/flutter-apk/

Rilis memakai keystore sendiri (saat ini repo masih signingConfig debug — ganti sebelum publikasi) dan tiap tag menaikkan versionCode di pubspec.yaml (1.0.0+N).

Site dokumentasi ini ​

sh
npm install
npm run docs:dev     # http://localhost:5173
npm run docs:build   # output docs/.vitepress/dist
npm run docs:preview # pratinjau hasil build

Deploy: GitHub Pages otomatis via .github/workflows/deploy.yml (pilih Source GitHub Actions di Settings → Pages). Untuk Vercel: Build Command npm run docs:build, Output Directory docs/.vitepress/dist. Jika deploy sebagai Project Pages (*.github.io/doc/), ubah base di docs/.vitepress/config.mts menjadi '/doc/'.

Gratis dan open untuk dipelajari. Data keuanganmu tetap milikmu.