use sun-valley theme from sv_ttk and imrpove whole project

Author: AbdullahBakir97

README.md

@@ -0,0 +1,210 @@
+# Expense Tracker
+
+![Python](https://img.shields.io/badge/Python-3.x-blue.svg)
+![Tkinter](https://img.shields.io/badge/Tkinter-GUI-yellow.svg)
+![SQLite](https://img.shields.io/badge/SQLite-3-lightgrey.svg)
+![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)
+
+## Overview
+
+The **Expense Tracker** is a graphical application built with Python and Tkinter, designed to help users manage their expenses efficiently. It utilizes SQLite for data storage and offers an intuitive interface for adding, categorizing, and analyzing expenses. Whether for personal use or small business needs, this tool aims to simplify expense tracking and financial management.
+
+## Features
+
+- 📊 **Expense Management:**
+  - Add, edit, and delete expenses with details such as amount, date, category, and notes.
+  - Categorize expenses for better organization and analysis.
+
+- 🗃️ **Data Storage:**
+  - Uses SQLite database to store expense records securely locally.
+  - Provides robust data management capabilities through SQL queries.
+
+- 📅 **Date Filtering:**
+  - Filter expenses by specific dates to view transactions within a specified timeframe.
+
+- 📈 **Expense Analytics:**
+  - Generate summaries and visual representations (charts/graphs) of expenses over time or by category.
+  - Gain insights into spending patterns for informed financial decisions.
+
+- 🎨 **Customizable Interface:**
+  - User-friendly GUI built with Tkinter, offering a responsive and customizable experience.
+
+## Future Development
+
+🚀 **Under Development**
+
+The Expense Tracker is continuously evolving with planned features to enhance functionality and user experience:
+
+- **Expense Report Generation:** Export detailed expense reports in PDF or CSV formats.
+- **Budget Planning:** Set budgets and receive alerts when nearing or exceeding limits.
+- **Cloud Integration:** Synchronize data across devices and cloud storage for accessibility.
+- **Data Insights:** Incorporate machine learning for predictive analytics and spending behavior analysis.
+- **Multi-user Support:** Enable multiple user profiles with secure login and personalized settings.
+- **Expense Reminders:** Schedule reminders for upcoming bills or recurring expenses.
+- **Localization:** Support for multiple languages and currency formats for global usability.
+
+Stay updated with our roadmap and contribute to shaping the future of Expense Tracker by opening issues or submitting pull requests. Your feedback and ideas are crucial for improving the tool!
+
+## Getting Started
+
+### Prerequisites
+
+- 🐍 Python 3.x installed
+- 🖼️ Tkinter library (usually included with Python installations)
+- 🗄️ SQLite3
+
+### Installation
+
+1. **Clone the repository:**
+   
+```
+   git clone https://github.com/yourusername/expense-tracker.git
+   cd python-env-tool
+```
+
+2. **Install dependencies:**
+   
+```
+   pip install -r requirements.txt
+```
+
+3. **Setup the SQLite database:**
+   
+```
+   python setup_db.py
+```
+
+### Usage
+
+1. **Run the application:**
+
+```
+    python gui.py
+```
+
+
+
+. **Explore functionalities:**
+
+- 📅 **Filter by Date:** Use date selectors to view expenses within a specific period.
+- 📊 **View Reports:** Analyze expenses with graphical representations.
+- 📝 **Add/Edit Expenses:** Input new expenses or modify existing ones easily.
+
+## Sequence Diagram
+
+::: mermaid
+sequenceDiagram
+    participant User
+    participant ExpenseTrackerView
+    participant ExpenseTrackerController
+    participant ExpenseModel
+    participant Preferences
+
+    User->>ExpenseTrackerView: Opens Expense Tracker
+    activate ExpenseTrackerView
+
+    ExpenseTrackerView->>ExpenseTrackerController: Request categories
+    activate ExpenseTrackerController
+    ExpenseTrackerController-->>ExpenseTrackerView: Categories
+    deactivate ExpenseTrackerController
+
+    User->>ExpenseTrackerView: Adds new expense
+    ExpenseTrackerView->>ExpenseTrackerController: Validate and save expense details
+    activate ExpenseTrackerController
+    ExpenseTrackerController->>ExpenseModel: add_expense(amount, category, date, description)
+    activate ExpenseModel
+    ExpenseModel-->>ExpenseTrackerController: Expense saved confirmation
+    deactivate ExpenseModel
+    deactivate ExpenseTrackerController
+
+    User->>ExpenseTrackerView: Filters expenses by category and date
+    ExpenseTrackerView->>ExpenseTrackerController: Request filtered expenses
+    activate ExpenseTrackerController
+    ExpenseTrackerController->>ExpenseModel: get_expenses()
+    activate ExpenseModel
+    ExpenseModel-->>ExpenseTrackerController: Filtered expenses
+    deactivate ExpenseModel
+    deactivate ExpenseTrackerController
+
+    User->>ExpenseTrackerView: Requests expense reports
+    ExpenseTrackerView->>ExpenseTrackerController: Generate report
+    activate ExpenseTrackerController
+    ExpenseTrackerController->>ExpenseModel: get_expenses()
+    activate ExpenseModel
+    ExpenseModel-->>ExpenseTrackerController: Report data
+    deactivate ExpenseModel
+    deactivate ExpenseTrackerController
+
+    User->>ExpenseTrackerView: Manages categories (add/remove)
+    ExpenseTrackerView->>Preferences: Opens Preferences
+    activate Preferences
+    Preferences->>ExpenseModel: load_categories_from_db()
+    activate ExpenseModel
+    ExpenseModel-->>Preferences: Categories
+    deactivate ExpenseModel
+
+    Preferences->>ExpenseModel: add_category(category)
+    activate ExpenseModel
+    ExpenseModel-->>Preferences: Category added confirmation
+    deactivate ExpenseModel
+
+    Preferences->>ExpenseModel: remove_category(category)
+    activate ExpenseModel
+    ExpenseModel-->>Preferences: Category removed confirmation
+    deactivate ExpenseModel
+
+    Preferences-->>ExpenseTrackerView: Update categories UI
+    deactivate Preferences
+
+    User->>ExpenseTrackerView: Closes Expense Tracker
+    ExpenseTrackerView->>ExpenseTrackerController: Close connection
+    activate ExpenseTrackerController
+    ExpenseTrackerController->>ExpenseModel: close_connection()
+    activate ExpenseModel
+    ExpenseModel-->>ExpenseTrackerController: Connection closed
+    deactivate ExpenseModel
+    deactivate ExpenseTrackerController
+
+    ExpenseTrackerView-->>User: Expense Tracker closed
+    deactivate ExpenseTrackerView
+:::
+
+## Entity-Relationship Diagram
+
+::: mermaid
+erDiagram
+    EXPENSE {
+        id INT PK
+        amount FLOAT
+        category VARCHAR
+        date DATE
+        description TEXT
+    }
+:::
+
+
+## Visualizations
+
+### Expense Distribution by Category
+
+![Expense Distribution](data/Figure_1.png)
+
+### Monthly Expenses
+
+![Monthly Expenses](data/Figure_2.png)
+
+## Full Expense Report
+
+For a detailed expense report, view the [PDF report](data/pdf.pdf).
+
+
+![Expense Tracker List](https://github.com/AbdullahBakir97/Py-Desktop-Expense_Tracker/assets/127149804/aa142657-cdbd-4060-8439-74a032fa2ad5)
+
+
+## Contributing
+
+Contributions are welcome! Please feel free to open issues or submit pull requests for any improvements or additional features you'd like to see in the Expense Tracker.
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

data/Figure_1.png

@@ -1,4 +1,31 @@
 id,amount,category,date,description
-1,500.0,Food,2024-06-21,Limits
-2,200.0,as,2024-06-21,fasfsdga
-3,600.0,ghjf,2024-06-21,fhdfgs
+1,50.0,Groceries,2024-01-05,Grocery shopping
+2,75.0,Utilities,2024-01-10,Electricity bill
+3,40.0,Entertainment,2024-01-12,Movie tickets
+4,20.0,Transport,2024-01-14,Bus fare
+5,60.0,Dining,2024-01-15,Dinner at a restaurant
+6,30.0,Health,2024-01-18,Doctor visit
+7,100.0,Education,2024-01-20,Online course
+8,45.0,Shopping,2024-01-22,Clothes
+9,150.0,Insurance,2024-01-25,Health insurance
+10,10.0,Miscellaneous,2024-01-27,Stationery
+11,55.0,Groceries,2024-02-03,Grocery shopping
+12,80.0,Utilities,2024-02-10,Water bill
+13,35.0,Entertainment,2024-02-14,Concert tickets
+14,25.0,Transport,2024-02-18,Taxi fare
+15,70.0,Dining,2024-02-20,Lunch at a cafe
+16,40.0,Health,2024-02-22,Pharmacy purchase
+17,120.0,Education,2024-02-25,Course materials
+18,55.0,Shopping,2024-02-28,Shoes
+19,200.0,Insurance,2024-03-01,Car insurance
+20,15.0,Miscellaneous,2024-03-05,Gift
+21,60.0,Groceries,2024-03-07,Grocery shopping
+22,90.0,Utilities,2024-03-10,Gas bill
+23,50.0,Entertainment,2024-03-14,Amusement park
+24,30.0,Transport,2024-03-18,Train fare
+25,80.0,Dining,2024-03-20,Dinner at a restaurant
+26,50.0,Health,2024-03-22,Dentist visit
+27,150.0,Education,2024-03-25,Textbooks
+28,65.0,Shopping,2024-03-28,Accessories
+29,250.0,Insurance,2024-03-30,Home insurance
+30,20.0,Miscellaneous,2024-03-31,Cleaning supplies

data/Figure_2.png

@@ -74,6 +74,13 @@ def get_expenses(self):
         except Exception as e:
             print(f"Error getting expenses: {e}")
             return []
+        
+    def get_expenses_charts(self):
+        try:
+            return self.model.get_expenses_charts()
+        except Exception as e:
+            print(f"Error getting expenses: {e}")
+            return []
 
     def get_categories(self):
         try: