### 🌟 GIỚI THIỆU DỰ ÁN
Ứng dụng Quản lý Chi tiêu Thông minh được xây dựng bằng React Native, tích hợp Trợ lý AI Nimo (sử dụng Google Gemini AI). Dự án thích hợp làm Đồ án Tốt nghiệp, Báo cáo môn học hoặc phát triển thành sản phẩm thương mại.
---
### 🚀 CÁC TÍNH NĂNG NỔI BẬT
1. 🤖 TRỢ LÝ AI NIMO THÔNG MINH (Google Gemini API):
- Nhập giao dịch tự động qua hội thoại: Chỉ cần nhắn "Sáng nay ăn phở 45k, cà phê 30k", AI sẽ tự phân tích số tiền, danh mục và tạo giao dịch.
- Phân tích & Cố vấn tài chính: Trả lời câu hỏi phân tích dữ liệu như "Tháng này tôi tiêu bao nhiêu?", "Danh mục nào tốn tiền nhất?".
- Cơ chế Retry & Báo lỗi thông minh khi AI gặp sự cố (503 / Limit Quota).
2. 📊 QUẢN LÝ THU CHI CÁ NHÂN & GIA ĐÌNH:
- Theo dõi thu chi riêng tư hoặc quản lý chi chung theo Nhóm Gia Đình realtime qua Firebase Firestore.
- Phân loại danh mục tự động và tùy chỉnh linh hoạt.
- Biểu đồ thống kê và báo cáo chi tiết theo tháng/năm.
3. 🎨 GIAO DIỆN & TRẢI NGHIỆM (UI/UX):
- Hỗ trợ chế độ Sáng/Tối (Light/Dark Mode).
- Tối ưu mượt mà cho cả Android & iOS.
---
### 🛠️ CÔNG NGHỆ SỬ DỤNG
- Framework: React Native (CLI / Expo compatible)
- Ngôn ngữ: TypeScript / JavaScript
- Backend & Database: Firebase Auth, Cloud Firestore
- AI Integration: @google/generative-ai (Gemini 2.5 Flash)
- Icons & UI Components: React Native Vector Icons, Context API (Theme)
XEM THÊM ==> Hướng dẫn cài đặt chi tiết
Nguồn: Sharecode.vn
### 📋 HƯỚNG DẪN CÀI ĐẶT DỰ ÁN
#### Yêu cầu môi trường:
- Node.js >= 18.x
- React Native CLI hoặc Expo
- Android Studio / Xcode
#### Các bước khởi chạy:
1. Giải nén file code vừa tải về.
2. Mở terminal tại thư mục gốc dự án và cài đặt thư viện:
npm install
# hoặc: yarn install
3. Cấu hình file Môi trường (.env):
- Điền API Key Gemini của bạn:
GEMINI_API_KEY=YOUR_GEMINI_API_KEY_HERE
4. Cấu hình Firebase:
- Thay thế file google-services.json (Android) và GoogleService-Info.plist (iOS) bằng cấu hình Firebase của bạn.
- Bật Firebase Authentication (Email/Password) và Cloud Firestore Database trên Firebase Console.
5. Chạy ứng dụng:
# Chạy trên Android:
npx react-native run-android
# Chạy trên iOS:
cd ios && pod install && cd ..
npx react-native run-ios
---
📩 Mọi thắc mắc cần hỗ trợ cài đặt vui lòng liên hệ qua tin nhắn hệ thống Sharecode!