Health-Connect

A modern healthcare connectivity platform built with Laravel, designed to streamline medical service accessibility.

📝 Project Background

This project was initiated during my 2024 internship, where I (back-end dev) gained first-hand experience with (PHP) Laravel development. The platform was developed through full-team collaboration with my fellow interns/roles: Moses (front-end), Jennifer (UI/UX), Zainab (PM), Sumaiyah (PM), and Chibuike (data analyst).

🙏 Acknowledgments

I extend my sincere gratitude to Natview Technology for this invaluable internship opportunity and the guidance that made this project possible.

"If I have seen further it is by standing on the shoulders of Giants."
— Sir Isaac Newton

🚀 Quick Start Guide

Prerequisites

• PHP >= 8.1
• Composer
• Node.js & npm
• SQLite

1. Initial Setup

First, clone the repository and install dependencies:

# Clone the repository
git clone https://github.com/k0ns0l/Health-Connect.git
cd health-connect

# Install PHP dependencies
composer install

# Install JavaScript dependencies
npm install

2. Environment Configuration

# Create env file from example - add your NEWS_API_KEY <https://newsapi.org/>
cp .env.example .env

# Generate application key
php artisan key:generate

# Create storage symlink
php artisan storage:link

3. Database Setup

# Run migrations and seeders
# note: This will drop all existing tables, and seed the database with `health_facilities_data.csv`
php artisan migrate:fresh --seed

4. Asset Compilation

# Build assets for development
npm run dev

# Or build for production
npm run build

# For development with hot reload
npm run dev -- --host

5. Start the Application

# Start the Laravel development server
php artisan serve

# The application will be available at http://localhost:8000

6. Additional Setup (Optional!)

# Clear all caches
php artisan optimize:clear

# Cache configuration for production
php artisan config:cache
php artisan route:cache
php artisan view:cache