💰 Tharwa – Personal Investment Application

Tharwa is a console-based personal investment management system built using Java. It allows users to create accounts, securely log in, manage various asset types, and perform zakah calculations — all while tracking their financial growth in a structured and goal-oriented way.

---

📌 Features

• 🔐 User Sign Up & Login
  Simple authentication with username and password validation.

• 🏦 Bank Account Management
  Users can securely register their bank account details.

• 📊 Asset Management
  Users can add and track the value of different types of assets:

  • Stock
  • Gold
  • Cryptocurrency
  • Real Estate

• 🕌 Zakah Calculator
  A dedicated tool to help users calculate their zakah based on their holdings.

---

🧠 How It Works

• Users launch the program via Main.java using any Java IDE.
• The application provides a menu-based interface for navigating between functionalities.
• All data is stored locally (no external database).

---

🛠️ Technologies and tools that are used

• Java (Core Language)
• Object-Oriented Design
• Console-Based I/O
• File Handling (for local data storage)
• Github : For version control and sharing work
• draw.io: For making system diagrams
• Miro: For system navigation map
• Intellij Idea: IDE for writing code
• Javadoc: For generating documentation

---

🗂️ Project Structure

├── Main.java # Entry point of the application
├── controllers/ # Handles core application logic
├── models/ # Contains Asset, BankAccount, User classes
├── services/ # Business logic like zakah calculation
├── utils/ # Helper classes for validation and input
├── data/ # Stores user data locally (files)

---

📄 Documentation

The project includes full SDLC documentation:

• 📙 System Navigation
• 🧪 Class Diagram, State Diagram and component Diagram
• 🧪 Sequence Diagrams
• 🧪 Use Case Diagram
• 📊 Presentation Slides

---

👨‍💻 Contributors

• Fatema El-Zhraa Ahmed "Project Leader"
• Nagham Wael
• Aly El-Deen Yasser Ali

---

🚀 Getting Started

1. Clone or download the project.
2. Open in your favorite Java IDE (e.g., IntelliJ, Eclipse).
3. Run Main.java.
4. Use the menu options to explore all features.

---

🛠️ Future Improvements (Optional)

• Add multi-user roles (e.g., Admin)
• Connect with real-time financial APIs
• Add data persistence using a database
• GUI interface (e.g., using JavaFX or Swing)

---

📬 Contact

For inquiries or contributions, feel free to reach out to any of the contributors.

---