# seshasai7d7-source/mediflow-pharmacy-platform architecture

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

- Interactive diagram: https://gitdiagram.com/seshasai7d7-source/mediflow-pharmacy-platform
- Repository: https://github.com/seshasai7d7-source/mediflow-pharmacy-platform

## Overview

MediFlow is a pharmacy platform where customers authenticate, browse medicines and submit prescriptions; pharmacists review prescription details (with AI extraction as an unapproved draft), then manage resulting orders and refills. The frontend routes users to role-specific screens and calls a FastAPI API; backend services apply workflow and inventory rules and persist state in PostgreSQL. Edges reflect sampled imports/calls or README-documented capabilities; unsampled router and page internals are not asserted beyond those documented relationships.

Main entry points: [`frontend/src/lib/api.ts`](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/lib/api.ts) (HTTP API Client), [`frontend/src/App.tsx`](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/App.tsx) (Route Application), [`backend/app/db/database.py`](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/db/database.py) (PostgreSQL Session Layer), [`backend/app/services/order_service.py`](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/order_service.py) (Order Workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer and Staff UI"]
  node_app["Route Application<br/>[App.tsx]"]
  node_authcontext["Session Context<br/>[AuthContext.tsx]"]
  node_catalogue["Medicine Catalogue"]
  node_prescription_ui["Prescription Submission"]
  node_review_ui["Pharmacist Review"]
  node_orders_ui["Order Screens"]
  node_refills_ui["Refill Screens"]
  node_admin_ui["Admin Screens"]
end

subgraph group_api["API and Identity"]
  node_api_client["HTTP API Client<br/>[api.ts]"]
  node_auth_api["Authentication API<br/>[auth.py]"]
  node_security["Token and Password Security<br/>[security.py]"]
end

subgraph group_clinical["Prescription Workflow"]
  node_prescriptions_api["Prescription API<br/>[prescriptions.py]"]
  node_pharmacist_api["Pharmacist API<br/>[pharmacist.py]"]
  node_extraction["Gemini Extraction"]
  node_prescription_storage["Prescription Document Storage"]
end

subgraph group_commerce["Inventory and Orders"]
  node_inventory_api["Inventory API<br/>[inventory.py]"]
  node_inventory_service["Inventory Rules"]
  node_orders_api["Orders API<br/>[orders.py]"]
  node_order_service["Order Workflow<br/>[order_service.py]"]
  node_refills_api["Refills API<br/>[refills.py]"]
  node_refill_service["Refill Workflow<br/>[refill_service.py]"]
end

subgraph group_platform["Persistence and Admin"]
  node_admin_api["Administration API<br/>[admin.py]"]
  node_database[("PostgreSQL Session Layer<br/>[database.py]")]
  node_models["Domain Models<br/>[__init__.py]"]
  node_config["Application Configuration<br/>[config.py]"]
end

node_user(("Customer / Staff"))

node_user -->|"uses"| node_app
node_app -->|"provides session"| node_authcontext
node_app -->|"routes to"| node_prescription_ui
node_app -->|"routes to"| node_review_ui
node_app -->|"routes to"| node_orders_ui
node_app -->|"routes to"| node_refills_ui
node_app -->|"routes to"| node_admin_ui
node_authcontext -->|"calls"| node_api_client
node_authcontext -->|"authenticates via"| node_auth_api
node_catalogue -->|"requests catalogue"| node_api_client
node_prescription_ui -->|"submits documents"| node_api_client
node_review_ui -->|"sends decision"| node_api_client
node_orders_ui -->|"manages orders"| node_api_client
node_refills_ui -->|"manages refills"| node_api_client
node_admin_ui -->|"requests admin data"| node_api_client
node_api_client -->|"calls endpoints"| node_prescriptions_api
node_api_client -->|"calls endpoints"| node_pharmacist_api
node_api_client -->|"calls endpoints"| node_inventory_api
node_api_client -->|"calls endpoints"| node_orders_api
node_api_client -->|"calls endpoints"| node_refills_api
node_api_client -->|"calls endpoints"| node_admin_api
node_auth_api -->|"uses hashing and tokens"| node_security
node_auth_api -->|"queries users"| node_database
node_prescriptions_api -.->|"stores documents"| node_prescription_storage
node_prescriptions_api -.->|"requests draft extraction"| node_extraction
node_pharmacist_api -.->|"uses draft data"| node_extraction
node_inventory_api -.->|"applies inventory rules"| node_inventory_service
node_orders_api -.->|"runs order workflow"| node_order_service
node_order_service -->|"calculates distance"| node_inventory_service
node_refills_api -.->|"runs refill workflow"| node_refill_service
node_order_service -->|"reads and writes"| node_database
node_inventory_service -->|"reads and updates"| node_database
node_refill_service -->|"creates related orders"| node_order_service
node_database -->|"gets database settings"| node_config
node_admin_api -.->|"manages persisted records"| node_database
node_database -.->|"maps domain records"| node_models

click node_app "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/App.tsx"
click node_authcontext "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/auth/AuthContext.tsx"
click node_catalogue "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/MedicineCataloguePage.tsx"
click node_prescription_ui "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/MyPrescriptionsPage.tsx"
click node_review_ui "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/PharmacistReviewPage.tsx"
click node_orders_ui "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/OrderManagementPage.tsx"
click node_refills_ui "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/CustomerRefillsPage.tsx"
click node_admin_ui "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/admin/AdminStoresPage.tsx"
click node_api_client "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/lib/api.ts"
click node_auth_api "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/auth.py"
click node_security "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/core/security.py"
click node_prescriptions_api "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/prescriptions.py"
click node_pharmacist_api "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/pharmacist.py"
click node_extraction "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/gemini_extraction.py"
click node_prescription_storage "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/prescription_storage.py"
click node_inventory_api "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/inventory.py"
click node_inventory_service "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/inventory_service.py"
click node_orders_api "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/orders.py"
click node_order_service "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/order_service.py"
click node_refills_api "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/refills.py"
click node_refill_service "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/refill_service.py"
click node_admin_api "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/admin.py"
click node_database "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/db/database.py"
click node_models "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/models/__init__.py"
click node_config "https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/core/config.py"

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_app,node_authcontext,node_catalogue,node_prescription_ui,node_review_ui,node_orders_ui,node_refills_ui,node_admin_ui toneBlue
class node_api_client,node_auth_api,node_security toneAmber
class node_prescriptions_api,node_pharmacist_api,node_extraction,node_prescription_storage toneMint
class node_inventory_api,node_inventory_service,node_orders_api,node_order_service,node_refills_api,node_refill_service toneRose
class node_admin_api,node_database,node_models,node_config,node_user toneIndigo
```

## Components

### Customer and Staff UI

- [Route Application](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Session Context](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/auth/AuthContext.tsx): `frontend/src/auth/AuthContext.tsx`
- [Medicine Catalogue](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/MedicineCataloguePage.tsx): `frontend/src/pages/MedicineCataloguePage.tsx`
- [Prescription Submission](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/MyPrescriptionsPage.tsx): `frontend/src/pages/MyPrescriptionsPage.tsx`
- [Pharmacist Review](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/PharmacistReviewPage.tsx): `frontend/src/pages/PharmacistReviewPage.tsx`
- [Order Screens](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/OrderManagementPage.tsx): `frontend/src/pages/OrderManagementPage.tsx`
- [Refill Screens](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/CustomerRefillsPage.tsx): `frontend/src/pages/CustomerRefillsPage.tsx`
- [Admin Screens](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/pages/admin/AdminStoresPage.tsx): `frontend/src/pages/admin/AdminStoresPage.tsx`

### API and Identity

- [HTTP API Client](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Authentication API](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/auth.py): `backend/app/api/v1/auth.py`
- [Token and Password Security](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/core/security.py): `backend/app/core/security.py`

### Prescription Workflow

- [Prescription API](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/prescriptions.py): `backend/app/api/v1/prescriptions.py`
- [Pharmacist API](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/pharmacist.py): `backend/app/api/v1/pharmacist.py`
- [Gemini Extraction](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/gemini_extraction.py): `backend/app/services/gemini_extraction.py`
- [Prescription Document Storage](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/prescription_storage.py): `backend/app/services/prescription_storage.py`

### Inventory and Orders

- [Inventory API](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/inventory.py): `backend/app/api/v1/inventory.py`
- [Inventory Rules](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/inventory_service.py): `backend/app/services/inventory_service.py`
- [Orders API](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/orders.py): `backend/app/api/v1/orders.py`
- [Order Workflow](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/order_service.py): `backend/app/services/order_service.py`
- [Refills API](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/refills.py): `backend/app/api/v1/refills.py`
- [Refill Workflow](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/services/refill_service.py): `backend/app/services/refill_service.py`

### Persistence and Admin

- [Administration API](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/api/v1/admin.py): `backend/app/api/v1/admin.py`
- [PostgreSQL Session Layer](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/db/database.py): `backend/app/db/database.py`
- [Domain Models](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/models/__init__.py): `backend/app/models/__init__.py`
- [Application Configuration](https://github.com/seshasai7d7-source/mediflow-pharmacy-platform/blob/master/backend/app/core/config.py): `backend/app/core/config.py`

### Other components

- **Customer / Staff**

## Connections

- Customer / Staff → Route Application: uses (evidence: `README.md`)
- Route Application → Session Context: provides session (evidence: `frontend/src/App.tsx`)
- Route Application → Prescription Submission: routes to (evidence: `frontend/src/App.tsx`)
- Route Application → Pharmacist Review: routes to (evidence: `frontend/src/App.tsx`)
- Route Application → Order Screens: routes to (evidence: `frontend/src/App.tsx`)
- Route Application → Refill Screens: routes to (evidence: `frontend/src/App.tsx`)
- Route Application → Admin Screens: routes to (evidence: `frontend/src/App.tsx`)
- Session Context → HTTP API Client: calls (evidence: `frontend/src/auth/AuthContext.tsx`)
- Session Context → Authentication API: authenticates via (evidence: `README.md`)
- Medicine Catalogue → HTTP API Client: requests catalogue (evidence: `README.md`)
- Prescription Submission → HTTP API Client: submits documents (evidence: `README.md`)
- Pharmacist Review → HTTP API Client: sends decision (evidence: `frontend/src/pages/PharmacistReviewPage.tsx`)
- Order Screens → HTTP API Client: manages orders (evidence: `frontend/src/lib/api.ts`)
- Refill Screens → HTTP API Client: manages refills (evidence: `frontend/src/lib/api.ts`)
- Admin Screens → HTTP API Client: requests admin data (evidence: `frontend/src/pages/admin/AdminStoresPage.tsx`)
- HTTP API Client → Prescription API: calls endpoints (evidence: `README.md`)
- HTTP API Client → Pharmacist API: calls endpoints (evidence: `README.md`)
- HTTP API Client → Inventory API: calls endpoints (evidence: `README.md`)
- HTTP API Client → Orders API: calls endpoints (evidence: `frontend/src/lib/api.ts`)
- HTTP API Client → Refills API: calls endpoints (evidence: `frontend/src/lib/api.ts`)
- HTTP API Client → Administration API: calls endpoints (evidence: `frontend/src/lib/api.ts`)
- Authentication API → Token and Password Security: uses hashing and tokens (evidence: `backend/app/api/v1/auth.py`)
- Authentication API → PostgreSQL Session Layer: queries users (evidence: `backend/app/api/v1/auth.py`)
- Prescription API → Prescription Document Storage: stores documents
- Prescription API → Gemini Extraction: requests draft extraction
- Pharmacist API → Gemini Extraction: uses draft data (evidence: `README.md`)
- Inventory API → Inventory Rules: applies inventory rules
- Orders API → Order Workflow: runs order workflow
- Order Workflow → Inventory Rules: calculates distance (evidence: `backend/app/services/order_service.py`)
- Refills API → Refill Workflow: runs refill workflow
- Order Workflow → PostgreSQL Session Layer: reads and writes (evidence: `backend/app/services/order_service.py`)
- Inventory Rules → PostgreSQL Session Layer: reads and updates (evidence: `backend/app/services/inventory_service.py`)
- Refill Workflow → Order Workflow: creates related orders (evidence: `backend/app/services/refill_service.py`)
- PostgreSQL Session Layer → Application Configuration: gets database settings (evidence: `backend/app/db/database.py`)
- Administration API → PostgreSQL Session Layer: manages persisted records
- PostgreSQL Session Layer → Domain Models: maps domain records
