CUANIFY 🚀

AI-Powered Financial Tracker

CUANIFY adalah aplikasi financial tracker kelas premium yang memadukan UI/UX Glassmorphism modern dengan kehebatan Artificial Intelligence. Aplikasi ini tidak sekadar mencatat transaksi, melainkan memberikan wawasan (insights) keuangan proaktif dengan dukungan Random Forest Machine Learning dan Google Gemini AI.

---

✨ Fitur Unggulan

• 🎨 Tier-1 UI/UX: Desain Dark Mode Glassmorphism, animasi Reanimated 3 (Spring/Rolling Counters), dan sistem Haptic Feedback yang taktil.
• ⚡ Performa Tinggi: Skeleton loaders, Toast notifications, dan state management cepat menggunakan Zustand.
• 🧠 AI Financial Advisor: Memprediksi status keuangan Anda ("Sehat", "Stabil", "Kritis") dan menyusun narasi saran finansial secara otomatis layaknya konsultan pribadi.
• 🔒 Aman & Nyaman: Autentikasi berbasis Sanctum API Token dengan dukungan Google Sign-In.

---

🚀 Quick Start Guide (Setup Lokal)

Bagi anggota tim yang baru pertama kali clone repositori ini, ikuti langkah-langkah berikut untuk menjalankan semua komponen secara lokal:

1. Setup Backend (Laravel)

   cd Backend
   cp .env.example .env
   php artisan key:generate

   (Pastikan ekstensi PHP SQLite3 aktif, lalu jalankan php artisan migrate --seed)

2. Setup AI Service (FastAPI)

   cd AI-environment
   cp .env.example .env

   (Isi GEMINI_API_KEY dan INTERNAL_API_KEY di dalam file .env yang baru dibuat)

3. Setup Frontend (React Native/Expo)

   cd Frontend
   cp .env.example .env

   (Isi EXPO_PUBLIC_GOOGLE_CLIENT_ID)

4. Jalankan Semua Server dengan Host 0.0.0.0 (Buka 3 Terminal Terpisah)

   Note: Menggunakan host 0.0.0.0 sangat penting agar aplikasi React Native/Expo di HP fisik yang terhubung ke Wi-Fi yang sama dapat mengakses API backend dan AI.

   • Terminal 1 (Backend): cd Backend && php artisan serve --host 0.0.0.0
   • Terminal 2 (AI Service): cd AI-environment && uvicorn main:app --host 0.0.0.0 --port 8001 --reload
   • Terminal 3 (Frontend): cd Frontend && npx expo start

---

🏗️ Arsitektur Monorepo

Proyek ini menggunakan pendekatan Monorepo yang terbagi menjadi 3 komponen utama. Setiap komponen berdiri sendiri dan dirancang untuk di-deploy secara terpisah.

graph TD
    A[📱 Mobile App<br/>React Native + Expo] <-->|HTTP JSON| B(🛠️ API Gateway<br/>Laravel 11)
    B <-->|HTTP JSON| C{🧠 AI Engine<br/>FastAPI}
    C -->|Predict| D[Random Forest ML]
    C -->|Generate| E[Gemini LLM]

Loading

1. 📱 Frontend (Mobile App)

• Tech Stack: React Native, Expo, Zustand, React Native Reanimated.
• Direktori: /Frontend
• Cara Menjalankan:

  cd Frontend
  npm install
  npx expo start

2. 🛠️ Backend (API & Core Logic)

• Tech Stack: Laravel 12, MySQL/SQLite, Sanctum Auth.
• Direktori: /Backend
• Cara Menjalankan:

  cd Backend
  composer install
  cp .env.example .env
  php artisan key:generate
  php artisan migrate --seed
  php artisan serve --host 0.0.0.0

3. 🧠 AI-Environment (Machine Learning & LLM)

• Tech Stack: FastAPI, Python 3.9+, Scikit-Learn, Google Generative AI.
• Direktori: /AI-environment
• Cara Menjalankan:

  cd AI-environment
  python -m venv venv
  # Aktifkan venv (contoh windows): venv\Scripts\activate
  pip install -r requirements.txt
  uvicorn main:app --host 0.0.0.0 --port 8001 --reload

---

🤝 Branch Deployment Workflow

Saat Anda melakukan deploy ke hosting (seperti Vercel, Railway, atau VPS), arahkan Root Directory dan Branch ke cabang masing-masing:

• main : Source code gabungan (Development)
• frontend : Branch khusus Source UI
• backend : Branch khusus Source API
• ai-environment : Branch khusus Engine AI

Catatan: Repositori ini telah dikonfigurasi gitignore-nya sedemikian rupa agar aman dari cache, kunci API, dan artefak kompilasi OS.

Dibuat dengan ❤️ untuk stabilitas finansial Anda.