---

# 📊 Expense Tracker with Gemini

### Ứng dụng ghi chép và phân tích chi tiêu cá nhân thông minh tích hợp **Gemini AI** và **Google Sheets**.

---

## 🌟 Tính Năng

✅ **Ghi chép chi tiêu nhanh chóng** bằng văn bản hoặc hình ảnh.  
✅ **Phân loại tự động** các khoản chi tiêu (ăn uống, xăng xe, mua sắm, v.v.).  
✅ **Lưu trữ dữ liệu an toàn** trên **Google Sheets**.  
✅ **Phân tích dữ liệu chi tiêu chuyên sâu** với **Gemini AI**.  
✅ **Giao diện trực quan** với **Tkinter**, hỗ trợ **nhấn Enter để gửi** và **hiển thị loading** khi xử lý.  

---

## 🛠 Công Nghệ Sử Dụng

- **Python 3.x** 🐍  
- **Tkinter** – Tạo giao diện người dùng.  
- **Google Generative AI (Gemini API)** – Xử lý và phân tích dữ liệu.  
- **Google Sheets API** – Lưu trữ và truy xuất dữ liệu.  
- **Requests** – Giao tiếp với API.  
- **Python-dotenv** – Quản lý biến môi trường.  

---

## 🚀 Hướng Dẫn Cài Đặt

### 1️⃣ Clone Project

```bash
git clone https://github.com/newnol/gemini-to-sheet.git
cd gemini-to-sheet

2️⃣ Tạo Môi Trường Ảo

python -m venv venv
source venv/bin/activate  # Mac/Linux
venv\Scripts\activate     # Windows

3️⃣ Cài Đặt Thư Viện

pip install -r requirements.txt

4️⃣ Thiết Lập Biến Môi Trường

Tạo file .env:

GEMINI_API_KEY=your_gemini_api_key
SHEET_ID=your_google_sheet_id

5️⃣ Chạy Ứng Dụng

python app/main.py

---

🎮 Cách Sử Dụng

1. Nhập nội dung chi tiêu vào ô văn bản.
   Ví dụ: Nay ăn sáng 25k
2. Nhấn "📨 Gửi" hoặc nhấn Enter để gửi.
3. Nhấn "📷 Tải Ảnh" để tải ảnh hóa đơn hoặc ảnh liên quan.
4. Nhấn "📊 Phân Tích Dữ Liệu" để Gemini phân tích toàn bộ chi tiêu.
5. Dữ liệu sẽ phân loại và lưu vào Google Sheets.

---

📂 Cấu Trúc Dự Án

expense_tracker/
├── app/
│   ├── config.py            # Quản lý biến môi trường
│   ├── gemini.py            # Tích hợp API Gemini (phân tích & ghi chép)
│   ├── google_sheets.py     # Gửi & lấy dữ liệu từ Google Sheets
│   ├── gui.py               # Giao diện Tkinter
│   └── main.py              # Điểm khởi động ứng dụng
│
├── tests/                   # Thư mục kiểm thử
│   ├── test_gemini.py
│   └── test_google_sheets.py
│
├── .env                     # Biến môi trường (KHÔNG commit)
├── .gitignore               # File/thư mục không đẩy lên Git
├── README.md                # File mô tả dự án
└── requirements.txt         # Danh sách thư viện cần cài

---

📊 Ví Dụ Phân Tích Dữ Liệu

Nhập:

Nay ăn sáng 25k

Bot trả lời:

{
  "note": "ăn sáng",
  "category": "breakfast",
  "amount": 25000
}

Phân tích dữ liệu:

📊 Tổng chi tiêu tháng này tập trung vào ăn uống (60%), di chuyển (25%), và mua sắm (15%).
👉 Đề xuất: Giảm chi tiêu ăn uống để tiết kiệm hơn.

---

❓ Câu Hỏi Thường Gặp

1. Làm sao để lấy API Key của Gemini?

• Đăng ký tại Google Cloud Console.
• Tạo API Key và dán vào file .env.

2. Dữ liệu lưu ở đâu?

• Dữ liệu được lưu trực tiếp lên Google Sheets theo SHEET_ID.

3. Phân tích dữ liệu như thế nào?

• Nhấn 📊 Phân Tích Dữ Liệu để lấy dữ liệu từ Google Sheets và gửi cho Gemini AI phân tích.

4. Ứng dụng có hỗ trợ đa ngôn ngữ không?

• Hiện tại ứng dụng hỗ trợ Tiếng Việt. Sẽ mở rộng thêm các ngôn ngữ khác trong tương lai.

---

📈 Kế Hoạch Phát Triển

• Phân loại chi tiêu tự động.
• Phân tích dữ liệu chi tiêu với Gemini AI.
• Báo cáo thống kê chi tiêu theo tuần/tháng.
• Phiên bản di động (Android/iOS).

---

🤝 Đóng Góp

1. Fork repository.
2. Tạo nhánh mới: git checkout -b feature-name.
3. Commit thay đổi: git commit -m "Add feature".
4. Push nhánh: git push origin feature-name.
5. Tạo Pull Request.

---

💼 Tác Giả

• 👤 Tên: [Your Name]
• 🌐 Website: newnol.io.com
• 📧 Email: tantai@newnol.io.vn

---

📜 Giấy Phép

Dự án được cấp phép theo MIT License.

---

⭐️ Nếu Thấy Hay, Hãy Ủng Hộ Dự Án!

⭐️ Star • 🍴 Fork • 🐞 Report Issue

---