# bit-coder91/mediflow-ai architecture

> Architecture diagram of the GitHub repository bit-coder91/mediflow-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bit-coder91/mediflow-ai
- Repository: https://github.com/bit-coder91/mediflow-ai

## Overview

MediFlow AI is a hospital-resource intelligence and decision-support web application. Patients and staff use a browser interface for hospital discovery, emergency triage, pharmacy comparison, and hospital operations; health officers can view district analytics and blood-supply risks. The Flask server provides the API and prediction behavior, with a separate data-preparation and model-training pipeline. Sampled code confirms some UI-to-API calls and database initialization; several README-described capabilities and server internals are not fully shown, so uncertain connections are omitted.

Main entry points: [`server.py`](https://github.com/bit-coder91/mediflow-ai/blob/main/server.py) (Flask API), [`frontend/app.js`](https://github.com/bit-coder91/mediflow-ai/blob/main/frontend/app.js) (Web interface), [`database/init_db.py`](https://github.com/bit-coder91/mediflow-ai/blob/main/database/init_db.py) (Database initializer), [`ml/src/train_models.py`](https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/train_models.py) (Model training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_web_app["Web interface<br/>[app.js]"]
  node_browser_store["Browser data manager<br/>[firebase-config.js]"]
end

subgraph group_operations["Hospital intelligence"]
  node_flask_api["Flask API<br/>[server.py]"]
  node_hospital_directory["Hospital directory<br/>[server.py]"]
  node_emergency_triage["Emergency triage<br/>[server.py]"]
  node_pharmacy_comparator["Pharmacy comparison<br/>[server.py]"]
  node_blood_alerts["Blood shortage alerts<br/>[server.py]"]
  node_district_analytics["District analytics<br/>[server.py]"]
  node_prediction_service["Resource predictions<br/>[server.py]"]
end

subgraph group_ml["ML pipeline"]
  node_hmis_transform["HMIS data transform"]
  node_synthetic_data["Synthetic data generator"]
  node_kaggle_transform["Kaggle data transform"]
  node_model_training["Model training<br/>[train_models.py]"]
  node_trained_models["Trained models"]
end

subgraph group_persistence["Data persistence"]
  node_db_initializer["Database initializer<br/>[init_db.py]"]
  node_sql_schema["Relational schema<br/>[schema.sql]"]
  node_sql_database[("SQL database")]
end

node_patients_staff(("Patients &amp; staff"))
node_pharmacy_services["Pharmacy platforms"]
node_map_services["Map services"]

node_patients_staff -->|"use"| node_web_app
node_web_app -->|"requests API"| node_flask_api
node_web_app -.->|"map navigation"| node_map_services
node_web_app -.->|"compare prices"| node_pharmacy_services
node_browser_store -.->|"stores hospital data"| node_hospital_directory
node_flask_api -.->|"serves records"| node_hospital_directory
node_flask_api -.->|"routes triage"| node_emergency_triage
node_flask_api -.->|"routes comparison"| node_pharmacy_comparator
node_flask_api -.->|"routes alerts"| node_blood_alerts
node_flask_api -->|"routes analytics"| node_district_analytics
node_flask_api -.->|"routes predictions"| node_prediction_service
node_hmis_transform -->|"writes training input"| node_model_training
node_model_training -->|"exports models"| node_trained_models
node_trained_models -.->|"loads models"| node_prediction_service
node_db_initializer -->|"reads schema"| node_sql_schema
node_db_initializer -->|"initializes"| node_sql_database

click node_web_app "https://github.com/bit-coder91/mediflow-ai/blob/main/frontend/app.js"
click node_browser_store "https://github.com/bit-coder91/mediflow-ai/blob/main/frontend/firebase-config.js"
click node_flask_api "https://github.com/bit-coder91/mediflow-ai/blob/main/server.py"
click node_hospital_directory "https://github.com/bit-coder91/mediflow-ai/blob/main/server.py"
click node_emergency_triage "https://github.com/bit-coder91/mediflow-ai/blob/main/server.py"
click node_pharmacy_comparator "https://github.com/bit-coder91/mediflow-ai/blob/main/server.py"
click node_blood_alerts "https://github.com/bit-coder91/mediflow-ai/blob/main/server.py"
click node_district_analytics "https://github.com/bit-coder91/mediflow-ai/blob/main/server.py"
click node_prediction_service "https://github.com/bit-coder91/mediflow-ai/blob/main/server.py"
click node_hmis_transform "https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/hmis_to_mediflow.py"
click node_synthetic_data "https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/dataset_generator.py"
click node_kaggle_transform "https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/kaggle_dataset_extractor.py"
click node_model_training "https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/train_models.py"
click node_trained_models "https://github.com/bit-coder91/mediflow-ai/tree/main/ml/models"
click node_db_initializer "https://github.com/bit-coder91/mediflow-ai/blob/main/database/init_db.py"
click node_sql_schema "https://github.com/bit-coder91/mediflow-ai/blob/main/database/schema.sql"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_web_app,node_browser_store toneBlue
class node_flask_api,node_hospital_directory,node_emergency_triage,node_pharmacy_comparator,node_blood_alerts,node_district_analytics,node_prediction_service toneAmber
class node_hmis_transform,node_synthetic_data,node_kaggle_transform,node_model_training,node_trained_models toneMint
class node_db_initializer,node_sql_schema,node_sql_database toneRose
class node_patients_staff,node_pharmacy_services,node_map_services toneIndigo
```

## Components

### Web experience

- [Web interface](https://github.com/bit-coder91/mediflow-ai/blob/main/frontend/app.js): `frontend/app.js`
- [Browser data manager](https://github.com/bit-coder91/mediflow-ai/blob/main/frontend/firebase-config.js): `frontend/firebase-config.js`

### Hospital intelligence

- [Flask API](https://github.com/bit-coder91/mediflow-ai/blob/main/server.py): `server.py`
- [Hospital directory](https://github.com/bit-coder91/mediflow-ai/blob/main/server.py): `server.py`
- [Emergency triage](https://github.com/bit-coder91/mediflow-ai/blob/main/server.py): `server.py`
- [Pharmacy comparison](https://github.com/bit-coder91/mediflow-ai/blob/main/server.py): `server.py`
- [Blood shortage alerts](https://github.com/bit-coder91/mediflow-ai/blob/main/server.py): `server.py`
- [District analytics](https://github.com/bit-coder91/mediflow-ai/blob/main/server.py): `server.py`
- [Resource predictions](https://github.com/bit-coder91/mediflow-ai/blob/main/server.py): `server.py`

### ML pipeline

- [HMIS data transform](https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/hmis_to_mediflow.py): `ml/src/hmis_to_mediflow.py`
- [Synthetic data generator](https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/dataset_generator.py): `ml/src/dataset_generator.py`
- [Kaggle data transform](https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/kaggle_dataset_extractor.py): `ml/src/kaggle_dataset_extractor.py`
- [Model training](https://github.com/bit-coder91/mediflow-ai/blob/main/ml/src/train_models.py): `ml/src/train_models.py`
- [Trained models](https://github.com/bit-coder91/mediflow-ai/tree/main/ml/models): `ml/models`

### Data persistence

- [Database initializer](https://github.com/bit-coder91/mediflow-ai/blob/main/database/init_db.py): `database/init_db.py`
- [Relational schema](https://github.com/bit-coder91/mediflow-ai/blob/main/database/schema.sql): `database/schema.sql`
- **SQL database**

### Other components

- **Patients & staff**
- **Pharmacy platforms**
- **Map services**

## Connections

- Patients & staff → Web interface: use (evidence: `README.md`)
- Web interface → Flask API: requests API (evidence: `frontend/app.js`)
- Web interface → Map services: map navigation (evidence: `README.md`)
- Web interface → Pharmacy platforms: compare prices (evidence: `README.md`)
- Browser data manager → Hospital directory: stores hospital data
- Flask API → Hospital directory: serves records (evidence: `server.py`)
- Flask API → Emergency triage: routes triage (evidence: `server.py`)
- Flask API → Pharmacy comparison: routes comparison (evidence: `server.py`)
- Flask API → Blood shortage alerts: routes alerts (evidence: `server.py`)
- Flask API → District analytics: routes analytics (evidence: `server.py`)
- Flask API → Resource predictions: routes predictions (evidence: `server.py`)
- HMIS data transform → Model training: writes training input (evidence: `ml/src/train_models.py`)
- Model training → Trained models: exports models (evidence: `ml/src/train_models.py`)
- Trained models → Resource predictions: loads models
- Database initializer → Relational schema: reads schema (evidence: `database/init_db.py`)
- Database initializer → SQL database: initializes (evidence: `database/init_db.py`)
