Skip to content

DocDim/SyndromeX

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SyndromeX — AI-Assisted Syndromic Detection Tool 🏥

SyndromeX is a clinical decision support web application designed to strengthen epidemiological surveillance. It enables health workers and clinicians to identify potential syndromes in real-time based on structured clinical observations.

Disclaimer: This tool is for clinical decision support only. It does not provide a definitive medical diagnosis and does not replace the final clinical judgment of a healthcare professional.


🌍 Context & Impact

  • Designed for Cameroon: Specifically tailored to the healthcare landscape of Cameroon, incorporating local Health Districts and Facility (FOSA) hierarchies.
  • Optimized for Developing Countries: Engineered to function in resource-limited settings, providing high-level clinical guidance where specialist access may be limited.
  • WHO AWaRe Integration: The system's therapeutic recommendations follow the WHO AWaRe (Access, Watch, Reserve) classification to promote antimicrobial stewardship and combat antibiotic resistance.

🌟 Key Features

  • AI Inference Engine: Real-time analysis of symptoms and physical signs to calculate confidence scores for various syndromes.
  • Ethical Compliance: A mandatory medical disclaimer must be accepted before every session to ensure legal and ethical protection.
  • Healthcare Hierarchy: Strict data structure respecting the Health District > Health Facility (FOSA) parent-child relationship.
  • Surveillance Dashboard: Dynamic visualization (Donut & Bar Charts) of pathology distribution by sex, age group, and geographical area.
  • Data Portability: Exportation of consultation reports in CSV format for advanced epidemiological analysis.

🏗️ Technical Architecture

The project is built on a modern, lightweight stack:

  • Backend: Python with Flask for API management and the inference engine.
  • Frontend: HTML5/JavaScript with Tailwind CSS for a responsive and professional interface.
  • Visualization: Chart.js for dynamic dashboard analytics.
  • Rules Engine: Logic-based JSON files (rules.json) allowing for easy updates of medical protocols.

🚀 Installation & Setup

Prerequisites

  • Python 3.10+
  • Flask

Installation

  1. Clone the repository:
    git clone https://github.com/your-account/SyndromeX.git
    cd SyndromeX
  2. Install dependencies:
    pip install -r requirements.txt
  3. Run the application:
    python app.py
    The interface will be available at http://127.0.0.1:5000.

📊 Operational Workflow

  1. Disclaimer Acceptance: The user must acknowledge the ethical guidelines and clinical responsibility.
  2. Patient Information: Entry of district, health facility (FOSA), and demographic data.
  3. Clinical Observation: Selection of specific symptoms and physical signs.
  4. Inference: The system displays suspected syndromes with a confidence score (default threshold at 30%).
  5. Analytics: Access the Dashboard for a global overview of the regional health status.

📜 License

Distributed under the MIT License. See LICENSE for more information.

About

SyndromeX is a clinical decision support web application designed to strengthen epidemiological surveillance. It enables health workers and clinicians to identify potential syndromes in real-time based on structured clinical observations.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors