Doctors Wallet

About the Project

Doctors Wallet is a Java-based application, structured as a modular Java project template. It provides a robust, organized starting point for building applications in healthcare, workflow management, or similar domains—while following best practices for portability and maintainability.

The older repo is still in github just as a reference for the folder structures and database fileds identification.

Why Was It Built?

• Offers a reusable scaffold for students, professionals, or teams to kickstart new cross-platform Java projects.
• Ensures project organization, modular code (with module-info.java), and smooth IDE integration.
• Simplifies setup for those who want to quickly get hands-on with Java development in any operating system environment.

How to Clone

You have two easy ways to get a copy of this project: using GitHub Desktop (recommended for beginners) or using the command line.

✅ Clone Using GitHub Desktop (No Commands Needed)

1. Download and install GitHub Desktop for your operating system.
2. Open GitHub Desktop.
3. Click File > Clone Repository...
4. In the URL tab, paste:
   https://github.com/MabelMoncy/Doctors_Wallet.git
5. Choose a local path where you want to save the project.
6. Click Clone.

This method works on Windows, macOS, and Linux.

🖥️ Clone Using the Command Line

Open a terminal (Command Prompt, Powershell, macOS Terminal, or Linux Shell) and run:

git clone https://github.com/MabelMoncy/Doctors_Wallet.git

---

How to Use This as Your Project

Using Eclipse IDE (Recommended):

1. Open Eclipse.
2. Go to File > Import > General > Existing Projects into Workspace.
3. Browse to the cloned folder (Doctors_Wallet) and finish the import.
   • .project, .classpath, and .settings guarantee a smooth import as a Java project.

Using Other IDEs (IntelliJ IDEA, NetBeans, VS Code):

• Open or import as a Java project.
• You may need to manually mark the src/ folder as a Source Root.
• In IntelliJ: File > Open, choose the project folder, then right-click src > "Mark Directory as > Sources Root".

Project Structure

• src/: Java source code and modules (place your business logic under src/com/).
• .classpath, .project, .settings/: Eclipse project configuration.
• .gitignore, .gitattributes: Git version control settings.

---

Basic Installations and Requirements (Universal OS Support)

1. Java Development Kit (JDK):

• Install JDK 11 or newer (choose your platform: Windows, macOS, Linux).
  • Oracle JDK
  • Adoptium OpenJDK
• Set your JAVA_HOME environment variable and ensure java is available in your terminal.

2. IDE:

• Eclipse IDE for Java Developers (best for .project support, runs on all OS).
• Alternatives: IntelliJ IDEA Community, Apache NetBeans, VS Code with Java Extension Pack.
• All listed IDEs are cross-platform.

3. Git:

• Download Git for your OS.
• Alternatively: Use GitHub Desktop (see steps above) if you're not comfortable with command line.

4. (Optional) Build Tools:

• Add Maven/Gradle if you want dependency and build automation, though the current setup is plain Java.

5. No External Java Libraries Required (by default)

• The initial setup uses no third-party libraries.
• Add libraries via your IDE/project tool as needed (see each IDE’s documentation).

---

Getting Started

1. Clone the repository using GitHub Desktop or Git as described above.
2. Open in your favorite cross-platform IDE.
3. Build or run Java files from the src/com/ package.
4. Extend the project by adding packages or classes as needed.

Contribution

Fork the repository and submit pull requests for enhancements or bug fixes.

---

Note:
All instructions, tools, and technologies used in this project are supported on Windows, macOS, and Linux. For any OS-specific issues consult your IDE or terminal documentation.
If you're new to Git commands, GitHub Desktop provides a beginner-friendly way to get started with cloning and managing your repository.