DocDirect - Healthcare Appointment Management System

A comprehensive desktop healthcare management system designed to streamline doctor appointments, patient management, and healthcare service delivery.

📋 Table of Contents

• Overview
• Key Features
• Technology Stack
• System Architecture
• Installation Guide
• API Integration
• Application Screenshots
• Live Demo
• Contributing
• License
• Contact

🎯 Overview

DocDirect is a full-stack desktop application that modernizes healthcare appointment management. Built with JavaFX and MySQL, it provides an intuitive interface for patients to browse healthcare providers, schedule appointments, and manage subscriptions with integrated payment processing.

🚀 Project Inspiration

This project draws inspiration from Praava Health's patient-centered approach to healthcare delivery, incorporating modern UI/UX principles and efficient service management workflows.

🎯 Problem Statement

Traditional healthcare appointment systems often suffer from:

• Complex booking processes
• Limited payment options
• Poor user experience
• Lack of subscription flexibility

DocDirect addresses these challenges through streamlined workflows and modern technology integration.

✨ Key Features

🏥 Core Functionality

• Doctor Directory Management - Comprehensive provider listings with detailed profiles
• Smart Appointment Scheduling - Real-time availability checking and instant booking confirmation
• Multi-tier Subscription System - Flexible yearly, quarterly, and bi-yearly healthcare packages
• Secure Payment Gateway - Integrated support for bKash, Nagad, Rocket, and online banking via SSL Commerz

🔐 Security & User Management

• Robust Authentication System - Secure user registration and login workflows
• Data Encryption - Protected patient information and transaction data
• Session Management - Secure user session handling

📊 Data Management

• Real-time Data Synchronization - Live updates from external APIs
• Efficient Database Operations - Optimized MySQL queries for performance
• JSON Data Processing - Dynamic doctor schedules and availability management

🛠️ Technology Stack

Frontend

• JavaFX - Modern, responsive desktop UI framework
• FXML - Declarative UI design and layout management
• CSS - Custom styling and responsive design

Backend

• Java SE - Core application logic and business rules
• MySQL - Relational database management
• JDBC - Database connectivity and operations

External Integrations

• REST API - External healthcare provider data integration
• SSL Commerz - Secure payment processing
• JSON Processing - Data parsing and manipulation

Development Tools

• IntelliJ IDEA Ultimate - Primary IDE with advanced debugging
• Git & GitHub - Version control and collaborative development
• Maven/Gradle - Dependency management and build automation

🏗️ System Architecture

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Presentation  │    │   Business      │    │   Data Access   │
│   Layer (FXML)  │◄──►│   Logic (Java)  │◄──►│   Layer (MySQL) │
└─────────────────┘    └─────────────────┘    └─────────────────┘
         │                       │                       │
         ▼                       ▼                       ▼
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   UI Components │    │   Service Layer │    │   Database      │
│   - Login/Auth  │    │   - Appointment │    │   - Users       │
│   - Dashboard   │    │   - Payment     │    │   - Doctors     │
│   - Booking     │    │   - User Mgmt   │    │   - Appointments│
└─────────────────┘    └─────────────────┘    └─────────────────┘

🚀 Installation Guide

Prerequisites

• Java JDK 11+ - Required for JavaFX compatibility
• MySQL Server 8.0+ - Database management system
• IntelliJ IDEA Ultimate - Recommended IDE (Community Edition also supported)

Step-by-Step Setup

1. Clone the Repository

   git clone https://github.com/Shakhoyat/DocDirect.git
   cd DocDirect

2. Database Configuration

   CREATE DATABASE docdirect_db;
   -- Import the provided SQL schema file
   SOURCE database/schema.sql;

3. Application Configuration

   # Update database connection settings
   db.url=jdbc:mysql://localhost:3306/docdirect_db
   db.username=your_username
   db.password=your_password

4. Build and Run

   # Using Maven
   mvn clean compile exec:java
   
   # Or run directly from IntelliJ IDEA
   # Right-click on Main.java → Run

🔗 API Integration

Healthcare Provider Data API

Endpoint: http://nayeemcode.pythonanywhere.com/data?file=sujon&key=jhbfhsdjdjsadbjsd
Method: GET
Response: JSON format with doctor details and schedules

Payment Gateway Integration

• SSL Commerz Sandbox/Live - Secure transaction processing
• Multiple Payment Methods - Mobile banking, cards, net banking
• Real-time Transaction Status - Instant payment confirmation

📱 Application Screenshots

🔐 Authentication System

Login Interface

Secure user authentication with input validation and error handling

User Registration

Comprehensive user onboarding with data validation

🏠 Dashboard & Navigation

Main Dashboard

Intuitive dashboard with quick access to all major features

🏥 Healthcare Services

Standard Healthcare Packages

Comprehensive healthcare service offerings

Premium Healthcare Plans

Advanced healthcare packages with additional benefits

Membership Tiers

Flexible subscription options for different user needs

👨‍⚕️ Doctor Management

Doctor Directory

Browse available healthcare providers with filtering options

Doctor Profile Details

Comprehensive provider information including qualifications and specializations

Appointment Booking Interface

Smart scheduling system with real-time availability

💳 Payment & Checkout

Checkout Process

Streamlined checkout with transparent pricing

Shopping Cart

User-friendly cart management with item modification options

Payment Summary

Dynamic pricing calculation with SSL Commerz integration

Payment Gateway - Card Options

Secure card payment processing through SSL Commerz

Payment Gateway - Mobile Banking

Integrated mobile financial services (bKash, Nagad, Rocket)

OTP Verification

Two-factor authentication for enhanced security

🎥 Live Demo

📹 Watch Full Application Demo

Experience the complete user journey from registration to appointment booking and payment processing

🏆 Technical Achievements

• Responsive UI Design - Adaptive layouts for different screen resolutions
• Real-time Data Processing - Live API integration with error handling
• Secure Payment Integration - PCI-compliant transaction processing
• Scalable Architecture - Modular design supporting future enhancements
• Performance Optimization - Efficient database queries and caching strategies

🤝 Contributing

We welcome contributions to enhance DocDirect! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Development Guidelines

• Follow Java coding conventions
• Write comprehensive unit tests
• Update documentation for new features
• Ensure backward compatibility

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

👨‍💻 Developer

Shakhoyat Rahman

• 📧 Email: skt104.shujon@gmail.com
• 🔗 GitHub: @Shakhoyat
• 💼 LinkedIn: Connect with me

---

🚀 Ready to revolutionize healthcare management?

DocDirect - Where technology meets healthcare excellence

---

⭐ If you found this project helpful, please give it a star! ⭐

Built with ❤️ for better healthcare accessibility