GraphQL API Integration for Dr. Fadil's Healthcare Profile

August 28, 2025 · View on GitHub

Overview

This project now includes a GraphQL API powered by GraphQL Yoga, providing programmatic access to Dr. Fadil's healthcare services, professional information, and innovation portfolio.

🚀 Quick Start

Install Dependencies

npm install

Start the GraphQL Server

npm run dev
# or
npm start

The GraphQL API will be available at: http://localhost:4000/graphql

GraphiQL Interface

Access the interactive GraphQL playground at: http://localhost:4000/graphql

📋 API Schema

Queries Available

Professional Information

profile - Complete doctor profile information
services - Available medical services
specializations - Areas of medical expertise
innovations - Healthcare technology innovations
publications - Medical research publications

Contact & Scheduling

contactInfo - Contact details and clinic hours
availableSlots(date: String!) - Available appointment slots

Health Information

healthTip - Random health tip

Mutations Available

Contact & Appointments

submitContactForm(input: ContactFormInput!) - Submit contact form
requestAppointment(input: AppointmentInput!) - Request medical appointment
subscribeNewsletter(email: String!) - Subscribe to healthcare newsletter

🔍 Example Queries

Get Doctor Profile

query GetDoctorProfile {
  profile {
    name
    title
    specializations
    bio
    experience
    education {
      degree
      institution
      year
    }
    certifications
    languages
  }
}

Get Available Services

query GetServices {
  services {
    id
    name
    description
    duration
    category
    isAvailable
  }
}

Submit Contact Form

mutation SubmitContact {
  submitContactForm(input: {
    name: "John Doe"
    email: "john@example.com"
    subject: "General Inquiry"
    message: "I would like to learn more about your AI diagnostic services."
    isUrgent: false
  }) {
    success
    message
    referenceId
  }
}

Request Appointment

mutation RequestAppointment {
  requestAppointment(input: {
    name: "Jane Smith"
    email: "jane@example.com"
    phone: "+1-555-0123"
    preferredDate: "2024-02-15"
    preferredTime: "10:00"
    serviceType: "General Consultation"
    reason: "Regular checkup"
  }) {
    success
    message
    appointmentId
    confirmationSent
  }
}

Check Available Slots

query GetAvailableSlots {
  availableSlots(date: "2024-02-15") {
    time
    available
    duration
  }
}

🏥 Healthcare-Specific Features

Medical Services Categories

CONSULTATION - General and specialized consultations
DIAGNOSTIC - AI-powered diagnostic services
TREATMENT - Treatment planning and monitoring
INNOVATION - Healthcare technology consulting
RESEARCH - Medical research collaboration

Professional Information

Complete medical education history
Board certifications and specializations
Experience in healthcare innovation
Published research and publications
Healthcare technology innovations

Contact & Scheduling

Clinic hours and availability
Emergency contact information
Appointment scheduling system
Contact form processing

🔧 Integration with Frontend

The GraphQL API is designed to integrate seamlessly with the existing static site. You can:

Fetch dynamic content using GraphQL queries from the frontend JavaScript
Submit forms using GraphQL mutations instead of traditional form submissions
Display real-time information like available appointment slots
Show personalized content based on user interactions

Example Frontend Integration

// Example: Fetch doctor profile in frontend
async function loadDoctorProfile() {
  const response = await fetch('/graphql', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      query: `
        query GetProfile {
          profile {
            name
            title
            bio
            specializations
          }
        }
      `
    })
  });
  
  const data = await response.json();
  return data.data.profile;
}