🏥 Overview

Vision & Mission

This is a modern, full-stack hospital management system and digital health platform designed to bridge the gap between patients and healthcare providers. At the heart of this experience is a Local, Privacy-First AI Health Assistant that intelligently guides patients through symptom checking, provides step-by-step website navigation, and surfaces relevant doctors and articles. Beyond AI-driven guidance, This project provides a seamless experience for patients to book appointments (both online and offline), order medicines, request emergency ambulances, and read health articles. Simultaneously, it gives hospital staff, doctors, and administrators powerful, centralized tools to manage daily operations, financials, and inventory.

🚀 Getting Started (Local Setup)

Prerequisites

• PHP 8.2 or higher
• Composer
• Node.js & NPM
• MySQL Server

Installation Steps

1. Clone the repository

   git clone https://github.com/your-username/healthcare-php-test.git
   cd healthcare-php-test
   

2. Install Dependencies

   composer install
   

3. Environment & Keys

   cp .env.example .env
   php artisan key:generate
   

4. Database Setup Create an empty database named hellomed in your MySQL instance. Ensure .env has DB_CONNECTION=mysql.

   # Migrate tables and seed the database with demo data
   php artisan migrate:fresh --seed
   
   # Link storage for image uploads
   php artisan storage:link
   

5. Run the Application Open two terminal windows:

   # Terminal 1: Boot backend server
   php artisan serve
   

Ollama AI Setup

The AI assistant requires Ollama running locally.

# Pull the model
ollama pull mistral

# Start the Ollama server (runs on localhost:11434 by default)
ollama serve          

(If Ollama is not running, the platform gracefully disables the chat widget with a friendly offline message).

---