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
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.jsonTanpa GOOGLE_SERVER_CLIENT_ID, aplikasi jalan normal kecuali fitur cadangan (muncul pesan konfigurasi).
Konfigurasi Google (agar cadangan jalan)
- Aktifkan Google Drive API di project Google Cloud.
- OAuth consent screen: tipe External, isi beranda + kebijakan privasi dari site ini, publikasikan (jangan bertahan di Testing untuk rilis).
- 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).
- Web application → Client ID-nya dipakai sebagai
- Scope yang dipakai kode:
https://www.googleapis.com/auth/drive.appdata(BackupScopes.appDatadilib/features/backup/services/backup_auth_service.dart). - 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/unduhdompet_backup.db+backup_meta.jsondiappDataFolder) →backup_repository.dart(staging, verifikasi header SQLite +integrity_check, rollback aman) →backup_cubit.dart(state UI).- Database lokal:
dompet.dbviasqflite_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.mddi repo aplikasi.
Build rilis
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
npm install
npm run docs:dev # http://localhost:5173
npm run docs:build # output docs/.vitepress/dist
npm run docs:preview # pratinjau hasil buildDeploy: 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/'.
