Skip to content

Latest commit

Β 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 

Repository files navigation

🍷 Core Finance

A Dark, Premium, and Intelligent Personal Finance Tracker

Flutter Version Dart Version Version AI Powered Storage Powered By


🌟 Tentang Proyek (About The Project)

Core Finance adalah aplikasi manajemen keuangan pribadi (personal finance tracker) bergaya gelap merah darah (dark crimson glassmorphism) yang menggabungkan kecepatan penyimpanan lokal Hive NoSQL, keandalan Firebase Cloud Backup, dan kecerdasan analitis dari Core AI Advisor berbasis Gemini 2.5 Flash.

Didesain untuk memberikan rasa kontrol penuh atas keuangan Anda dengan estetika kelas atas, animasi mulus, dan fitur esensial dari manajemen anggaran hingga ekspor kalender lokal HP.


✨ Fitur Unggulan β€” Mega Update v1.5.0

πŸ’° 1. Smart Budgeting & Alert Pengeluaran

  • Atur batas pengeluaran bulanan per kategori (Makanan, Hiburan, Belanja, Transportasi, Tagihan, dll).
  • Visualisasi progress bar dinamis yang menunjukkan persentase pemakaian anggaran.
  • Peringatan Otomatis (Alert): Memberikan peringatan kuning ketika pengeluaran melampaui 80% dan peringatan merah ketat ketika melampaui 100%, terintegrasi langsung dengan saran Core AI dan halaman Statistik.

πŸ“‘ 2. Debt & Receivable Tracker (Pencatat Hutang & Piutang)

  • Catat siapa yang berhutang kepada Anda (Piutang) dan kepada siapa Anda berhutang (Hutang).
  • Indikator persentase pelunasan dan filter status (Semua, Aktif, Lunas).
  • Ekspor Jatuh Tempo ke Kalender HP: Simpan tanggal jatuh tempo hutang dan piutang langsung ke kalender lokal ponsel dengan alarm pengingat otomatis (VALARM) 1 hari sebelumnya.

🧾 3. Split Bill & Kalkulator Patungan (Fair Split Calculator)

  • Bagi tagihan nongkrong atau makan bersama dengan metode Equal Split (rata) atau Custom Split (disesuaikan per item/orang).
  • Kalkulasi otomatis untuk penambahan Pajak (Tax) dan Service Charge.
  • Simpan hasil perhitungan patungan langsung ke catatan pengeluaran harian hanya dalam satu ketukan.

πŸ€– 4. Core AI Advisor & OCR Vision Scanner

  • Core AI Financial Advisor: Asisten chat pintar berkarakter Core AI yang analitis, tenang, dan tegas. Memahami riwayat keuangan Anda secara presisi dengan konteks kronologi Hari, Bulan, dan Tahun yang akurat.
  • Vision Receipt Scanner: Unggah foto atau jepret gambar struk belanja Anda, dan AI akan otomatis mengenali total transaksi, nama merchant, dan kategori untuk dicatat secara instan!

πŸ“… 5. Integrasi Kalender Lokal HP (.ics / iCalendar Support)

  • Ekspor riwayat transaksi menjadi format standar internasional .ics (RFC 5545) yang mendukung penuh Google Calendar, Apple Calendar, Outlook, dan aplikasi kalender bawaan HP.
  • Dukungan aturan perulangan (RRULE:FREQ=DAILY/WEEKLY/MONTHLY/YEARLY) untuk transaksi rutin serta alarm jatuh tempo.
  • Akses ekspor cepat di 3 titik: Halaman Export Data, AppBar Semua Transaksi, dan AppBar Hutang / Piutang.

πŸ“€ 6. Export Laporan Profesional (PDF & CSV)

  • Generate laporan keuangan bergaya eksekutif dalam format PDF dan spreadsheet CSV.
  • Dilengkapi ringkasan total pemasukan, pengeluaran, saldo bersih, serta tabel rincian transaksi lengkap.

πŸ“Š 7. Pengelompokan Harian & Filter Kalender Lengkap

  • Tampilan riwayat transaksi kini dikelompokkan secara kronologis harian (Hari Ini, Kemarin, dan tanggal lengkap seperti 4 Agustus 2026).
  • Filter Rentang Waktu Dasbor: Chip filter cepat untuk Semua, Hari Ini, Kemarin, 7 Hari, 30 Hari, Bulan Ini, serta tombol Kalender.
  • Filter Lihat Semua Transaksi: Saring riwayat berdasarkan Tahun, Bulan, dan Tanggal khusus dengan tombol Reset cepat.

☁️ 8. Cloud Backup & Restore (Firebase)

  • Backup dan restore data secara aman ke Firebase Cloud Firestore yang dikaitkan dengan akun pengguna (Google Sign-In).
  • Mendukung Mode Guest: Pengguna dapat masuk dan menggunakan aplikasi secara offline, dan akan menerima pemberitahuan ramah jika ingin mengaktifkan backup awan.

🌐 9. Multi-Bahasa & Multi-Mata Uang Internasional

  • 6 Bahasa Resmi: Indonesia (ID), English (EN), Bahasa Melayu (MS), Ψ§Ω„ΨΉΨ±Ψ¨ΩŠΨ© (AR), δΈ­ζ–‡ (ZH), ζ—₯本θͺž (JA).
  • 6 Mata Uang: IDR (Rp), USD ($), MYR (RM), SAR (ο·Ό), CNY (Β₯), JPY (Β₯).
  • Format angka, simbol, dan tanggal otomatis menyesuaikan dengan preferensi lokal Anda.

πŸ“± Arsitektur & Teknologi

Komponen Teknologi yang Digunakan
Framework Flutter 3.x & Dart 3.x
State Management provider (MultiProvider Reactive State)
Local Storage hive & hive_flutter (Zero-latency NoSQL Key-Value Store)
Cloud Service firebase_core, firebase_auth, cloud_firestore, google_sign_in
AI & NLP Engine Gemini 2.5 Flash via Google Gemini API
OCR Vision Engine Gemini 2.5 Flash via Google Gemini API
Export Engine pdf, csv, path_provider, share_plus
Calendar Standard RFC 5545 .ics Generator (VALARM, RRULE)
Typography & UI google_fonts (Inter), Custom Dark Crimson Glassmorphism

πŸ“ Struktur Direktori (Folder Structure)

lib/
 β”œβ”€β”€ l10n/
 β”‚    └── app_strings.dart          # Kamus multi-bahasa (ID, EN, MS, AR, ZH, JA)
 β”œβ”€β”€ models/
 β”‚    β”œβ”€β”€ budget.dart               # Model anggaran tahunan/bulanan per kategori
 β”‚    β”œβ”€β”€ debt.dart                 # Model pencatat hutang dan piutang
 β”‚    β”œβ”€β”€ profile.dart              # Model profil pengguna dan preferensi
 β”‚    └── transaction.dart          # Model transaksi harian (Favorit, Berulang, dll)
 β”œβ”€β”€ providers/
 β”‚    β”œβ”€β”€ budget_provider.dart      # CRUD anggaran dan kalkulasi progress pemakaian
 β”‚    β”œβ”€β”€ currency_provider.dart    # Pengelola preferensi mata uang (IDR, USD, dll)
 β”‚    β”œβ”€β”€ debt_provider.dart        # CRUD hutang/piutang dan perhitungan pelunasan
 β”‚    β”œβ”€β”€ locale_provider.dart      # Pengelola perubahan bahasa secara instan
 β”‚    β”œβ”€β”€ profile_provider.dart     # Pengelola akun dan gambar profil pengguna
 β”‚    └── transaction_provider.dart # Pengelola transaksi utama & auto-generate recurring
 β”œβ”€β”€ screens/
 β”‚    β”œβ”€β”€ dashboard/                # Komponen kartu dasbor (Header, Saldo, Recent)
 β”‚    β”œβ”€β”€ profile/                  # Komponen modal pemilih bahasa & mata uang
 β”‚    β”œβ”€β”€ add_transaction_screen.dart # Layar tambah transaksi + filter Favorit/Berulang
 β”‚    β”œβ”€β”€ all_transactions_screen.dart # Layar semua transaksi + filter Kalender/Hari/Bulan
 β”‚    β”œβ”€β”€ budget_screen.dart        # Layar kelola anggaran dan indikator alert merah/kuning
 β”‚    β”œβ”€β”€ debt_screen.dart          # Layar kelola hutang/piutang + ekspor ke kalender HP
 β”‚    β”œβ”€β”€ edit_transaction_screen.dart # Layar sunting transaksi
 β”‚    β”œβ”€β”€ export_screen.dart        # Layar ekspor laporan PDF, CSV, dan Kalender .ics
 β”‚    β”œβ”€β”€ login_screen.dart         # Layar masuk akun Google / Mode Guest
 β”‚    β”œβ”€β”€ main_screen.dart          # Navigasi utama (Bottom Navigation Bar)
 β”‚    β”œβ”€β”€ profile_screen.dart       # Layar profil, menu versi APK, & pengaturan backup
 β”‚    β”œβ”€β”€ recurring_screen.dart     # Layar daftar transaksi berulang otomatis
 β”‚    β”œβ”€β”€ split_bill_screen.dart    # Layar kalkulator patungan & pembagian tagihan
 β”‚    └── statistics_screen.dart    # Layar grafik statistik pengeluaran/pemasukan
 β”œβ”€β”€ services/
 β”‚    β”œβ”€β”€ ai_service.dart           # Layanan Core AI Chat & Scanner Struk Vision
 β”‚    β”œβ”€β”€ app_version_service.dart  # Layanan informasi versi APK & modal dialog tentang
 β”‚    β”œβ”€β”€ backup_service.dart       # Layanan sinkronisasi Firebase Cloud Firestore
 β”‚    β”œβ”€β”€ calendar_service.dart     # Generator file kalender iCalendar (.ics / RFC 5545)
 β”‚    └── export_service.dart       # Generator laporan dokumen PDF dan CSV
 β”œβ”€β”€ theme/
 β”‚    └── app_theme.dart            # Sistem warna Dark Crimson, glassmorphism, & Google Fonts
 └── main.dart                      # Titik masuk utama aplikasi & inisialisasi Hive/Firebase

πŸ’‘ Tips Penggunaan (Pro Tips)

  1. Gunakan Mode Guest Secara Bebas: Anda dapat langsung mencatat transaksi saat pertama kali membuka aplikasi tanpa perlu login. Jika Anda menekan tombol Backup Cloud dalam mode guest, aplikasi akan memberi tahu secara ramah bahwa Anda perlu login terlebih dahulu.
  2. Pindai Struk dengan Core AI: Pada layar Dasbor atau ruang obrolan AI, ketuk ikon kamera/gambar untuk memindai struk restoran atau belanjaan. AI akan langsung menyimpulkan nominal dan kategori untuk Anda.
  3. Impor ke Kalender Ponsel: Pada menu Export Data, pilih "Export ke Kalender HP (.ics)". File kalender standar akan dibuat dan langsung dapat dibuka dengan Google Calendar atau Apple Calendar Anda!
  4. Pantau Versi Aplikasi: Ketuk baris menu Versi di halaman Profil atau badge di footer untuk melihat status build dan menyalin informasi spesifikasi aplikasi dengan mudah.

πŸ‘₯ Kredit & Kontributor (Credits & Attribution)

  • Developed & Powered by: Core Dev Group
  • App Edition: v1.5.0 (Build 10)
  • AI Backend: Powered by Google Gemini API.
  • License: MIT License β€” bebas digunakan dan dimodifikasi untuk tujuan pengembangan non-komersial dan komersial sesuai ketentuan lisensi.

β€œPegang kendali atas keuanganmu, sebelum keuanganmu yang mengendalikanmu.” β€” Core Finance 🍷

About

🍷 Makima Finance: A dark, premium & intelligent Flutter personal finance tracker with Llama 3.3 AI Advisor, Receipt OCR Scanner, Hive NoSQL, Firebase Cloud Backup, Budget Alert, Split Bill & .ics Calendar Export.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Contributors