Shakhsni (Diagnose Me)

AI-Powered Hospital Management & Diagnostic System

This repository contains the backend API source code for Shakhsni, a Hospital Management System powered by an NLP Microservice.

Architecture

The system follows a Service-Oriented Architecture (SOA) approach, decoupling the core Laravel backend from the Python AI service.

graph LR
    Client[Client App] --> API[Laravel API]
    API --> Service[Service Layer]
    Service --> AI[Python Flask AI]
    AI --> Prediction

Loading

System Requirements

• PHP: 8.1+
• Laravel: 10.x
• Python: 3.9+ (requests, specialized libs)
• Database: MySQL 8.0+

Setup & Installation

1. Backend Setup

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan serve

2. AI Microservice Setup

Navigate to the AI service directory (if applicable) or ensure the Python environment is active.

pip install -r requirements.txt
python model.py

Core Modules

• Authentication: Sanctum implementation for stateless JWT.
• Appointments: AppointmentService managing slots and status.
• Diagnostics: MedicineService interacting with the ML Model.

Documentation

• Architecture: See .showcase/README.md for in-depth analysis.
• API Spec: See Postman collection in .notes/.

---

Maintained by Ziad Gamal