# samyakraka/medecro-ai-smart-healthcare-disease-prediction architecture

> Architecture diagram of the GitHub repository samyakraka/medecro-ai-smart-healthcare-disease-prediction, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction
- Repository: https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction

## Overview

##### Project Type and Purpose
- This is a full-stack, monolithic Flask web application with an embedded machine-learning component.
- Purpose: an AI-driven medical chatbot and recommendation system that lets users assess symptoms, get medical info, book appointments, and receive personalized medicine/diet/workout recommendations.

##### File Structure
- Top‐level application code:
- app.py, index.py, wsgi.py – Flask application entry points and routing
- main.py & Medicine Recommendation System.ipynb – scripts/notebooks for training the recommendation model
- Static/UI Layers:
- /templates – Jinja2 HTML templates (home, chat, login, register, patient/doctor dashboards, appointment pages)
- /static – CSS, JS, images, assets for front-end interaction
- Models & Data:
- /models/svc.pkl – serialized Support Vector Classifier used at runtime
- /datasets/*.csv – raw symptom, medication, diet, workout, precaution datasets used for model training
- Data stores:
- JSON files (users.json, user_credentials.json, doctors.json, responses.json, users_data.json) acting as flat-file databases
- Deployment config:
- requirements.txt (implied), vercel.json, credentials.json for external API keys

##### README Insights
- Backend: Python + Flask
- Data: JSON stores for user, doctor, and chat history
- ML: personalized recommendations via scikit-learn
- Features: symptom assessment, chat, appointment scheduling, chat history retention

a. Main Components
- Client Browser (User/Doctor UI)
- Flask Web Server
- Machine-Learning Service (Model Loader + Predictor)
- Data Layer (JSON “databases” + Optional CSV warehouse for retraining)
- Appointment Scheduler Module
- Static Asset Server
b. Relationships & Interactions
- Browser → Flask Server: HTTP(S) requests (GET/POST) for pages, API calls (symptom submission, chat messages, appointment booking)
- Flask Server → Static Asset Server: serves CSS/JS/images
- Flask Server → Data Layer: read/write JSON files for authentication, user/doctor profiles, chat history
- Flask Server → ML Service: load svc.pkl once on startup, invoke predict() on user symptom input to return medicine/diet/workout recommendations
- Flask Server → Appointment Scheduler: reads/writes doctor schedules and user appointments in JSON or in-memory structures
c. Architectural Patterns & Principles
- Monolithic MVC:
– Model = JSON files + ML model
– Views = Jinja2 templates + static assets
– Controllers = Flask route handlers in app.py/index.py
- Separation of Concerns: UI layer decoupled from backend logic, ML inference isolated as a service module, data persistence via JSON
- Single-file flat-file DB: lightweight storage avoiding external database for prototyping
d. Key Technologies
- Flask (routing, templating, request handling)
- scikit-learn (SVC model)
- Jinja2 (HTML templates)
- JavaScript/CSS (front-end interactivity)
- JSON flat files (data persistence)

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Frontend
    subgraph "Client Browser"
        direction TB
        Browser["Client Browser"]:::browser
    end

    %% Backend - Flask
    subgraph "Flask Web App"
        direction TB
        API["Flask Server"]:::backend
        app_py["app.py"]:::backend
        index_py["index.py"]:::backend
        wsgi_py["wsgi.py"]:::backend
        sched["Appointment Scheduler Module"]:::backend
    end

    %% ML Service
    subgraph "Machine-Learning Service"
        direction TB
        MLService["Model Loader & Predictor"]:::ml
        svc_pkl["svc.pkl"]:::data
        main_py["main.py"]:::offline
        notebook["Medicine Recommendation System.ipynb"]:::offline
    end

    %% Data Stores
    subgraph "JSON Data Store"
        direction TB
        users_json[(users.json)]:::data
        creds_json[(user_credentials.json)]:::data
        doctors_json[(doctors.json)]:::data
        responses_json[(responses.json)]:::data
        users_data_json[(users_data.json)]:::data
    end

    subgraph "CSV Datasets (Retraining)"
        direction TB
        csv1[(Symptom-severity.csv)]:::data
        csv2[(Training.csv)]:::data
        csv3[(description.csv)]:::data
        csv4[(diets.csv)]:::data
        csv5[(medications.csv)]:::data
        csv6[(precautions_df.csv)]:::data
        csv7[(symtoms_df.csv)]:::data
        csv8[(workout_df.csv)]:::data
    end

    %% Static Assets
    subgraph "Static Assets"
        direction TB
        css1["styles.css"]:::frontend
        js1["main.js"]:::frontend
        images["images/"]:::frontend
    end

    %% Deployment Config
    subgraph "Deployment Configuration"
        direction TB
        vercel["vercel.json"]:::data
        creds_cfg["credentials.json"]:::data
        readme["README.md"]:::data
    end

    %% Offline Training Pipeline
    subgraph "Offline Training Pipeline" 
        direction TB
        style Offline fill:#f9f,stroke:#333,stroke-dasharray: 5 5
        notebook -->|retrain| svc_pkl
        csv1 --> notebook
        csv2 --> notebook
        csv3 --> notebook
        csv4 --> notebook
        csv5 --> notebook
        csv6 --> notebook
        csv7 --> notebook
        csv8 --> notebook
    end

    %% Connections
    Browser -->|"HTTP GET/POST"| API
    API -->|"serves static assets"| css1
    API -->|"serves static assets"| js1
    API -->|"reads/writes"| users_json
    API -->|"reads/writes"| creds_json
    API -->|"reads/writes"| doctors_json
    API -->|"reads/writes"| responses_json
    API -->|"reads/writes"| users_data_json
    API -->|"calls predict()"| MLService
    API -->|"routes booking"| sched
    sched -->|"uses"| doctors_json
    sched -->|"uses"| users_data_json
    MLService -->|"loads model"| svc_pkl

    %% Click Events
    click app_py "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/app.py"
    click index_py "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/index.py"
    click wsgi_py "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/wsgi.py"
    click MLService "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/main.py"
    click svc_pkl "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/models/svc.pkl"
    click main_py "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/main.py"
    click notebook "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/Medicine Recommendation System.ipynb"
    click users_json "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/users.json"
    click creds_json "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/user_credentials.json"
    click doctors_json "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/doctors.json"
    click responses_json "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/responses.json"
    click users_data_json "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/users_data.json"
    click csv1 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/datasets/Symptom-severity.csv"
    click csv2 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/datasets/Training.csv"
    click csv3 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/datasets/description.csv"
    click csv4 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/datasets/diets.csv"
    click csv5 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/datasets/medications.csv"
    click csv6 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/datasets/precautions_df.csv"
    click csv7 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/datasets/symtoms_df.csv"
    click csv8 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/datasets/workout_df.csv"
    click css1 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/static/assets/css/styles.css"
    click js1 "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/static/assets/js/main.js"
    click images "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/tree/main/static/images/"
    click vercel "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/vercel.json"
    click creds_cfg "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/credentials.json"
    click readme "https://github.com/samyakraka/medecro-ai-smart-healthcare-disease-prediction/blob/main/README.md"

    %% Styles
    classDef browser fill:#fdfd96,stroke:#333,stroke-width:1px
    classDef frontend fill:#a8d0e6,stroke:#333,stroke-width:1px
    classDef backend fill:#74c69d,stroke:#333,stroke-width:1px
    classDef ml fill:#bde0fe,stroke:#333,stroke-width:1px
    classDef data fill:#caffbf,stroke:#333,stroke-width:1px
    classDef offline fill:#ffc6ff,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5
```
