# tashiel-singh/worthitsolutions-wil-insy7315- architecture

> Architecture diagram of the GitHub repository tashiel-singh/worthitsolutions-wil-insy7315-, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tashiel-singh/worthitsolutions-wil-insy7315-
- Repository: https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-

## Overview

MedFlow is a healthcare-distribution platform for distributor, pharmacy, and patient roles. The main workflow is role-guarded access to inventory and B2B ordering, followed by invoice review; patients can separately view prescriptions and request refills. The React app’s context holds operational state and attempts backend order synchronization, while the Express API exposes auth, users, products, orders, invoices, analytics, tax, and patient routes. The README describes the broader compliance, dual-stock-pool, tier pricing, and patient-portal capabilities. Backend route internals and several frontend views were not sampled, so those links are shown only where routing or calls are evidenced.

Main entry points: [`backend/src/app.ts`](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/app.ts) (Express API router), [`src/App.tsx`](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/App.tsx) (React app routes), [`src/context/AppContext.tsx`](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/context/AppContext.tsx) (Application state), [`backend/src/middleware/auth.ts`](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/middleware/auth.ts) (JWT and role middleware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["React app routes<br/>[App.tsx]"]
  node_login["Login view<br/>[LoginView.tsx]"]
  node_dashboard["Executive dashboard<br/>[DashboardView.tsx]"]
end

subgraph group_operations["Distribution workflows"]
  node_inventory["Dual-pool inventory<br/>[InventoryView.tsx]"]
  node_bulkorder["Bulk ordering<br/>[BulkOrderView.tsx]"]
  node_invoices["Invoices<br/>[InvoicesView.tsx]"]
  node_taxcalc["Tax calculations<br/>[taxCalculations.ts]"]
end

subgraph group_patient["Patient care"]
  node_patientportal["Patient portal"]
end

subgraph group_backend["Backend API"]
  node_backendapp["Express API router<br/>[app.ts]"]
  node_authroutes["Authentication routes<br/>[auth.ts]"]
  node_userroutes["User routes<br/>[users.ts]"]
  node_productroutes["Product routes<br/>[products.ts]"]
  node_orderroutes["Order routes<br/>[orders.ts]"]
  node_invoiceroutes["Invoice routes<br/>[invoices.ts]"]
  node_analyticsroutes["Analytics routes<br/>[analytics.ts]"]
  node_taxroutes["Tax routes<br/>[tax.ts]"]
  node_patientroutes["Patient routes<br/>[patients.ts]"]
  node_authmw["JWT and role middleware<br/>[auth.ts]"]
  node_errors["Validation and errors<br/>[errors.ts]"]
  node_db[("Prisma database access<br/>[prisma.ts]")]
  node_bulkservice["Bulk order calculation"]
  node_revservice["Revenue segregation"]
  node_taxservice["Formal tax deductions"]
end

subgraph group_platform["Shared runtime"]
  node_state["Application state<br/>[AppContext.tsx]"]
  node_api["API client<br/>[api.ts]"]
  node_types["Domain types<br/>[index.ts]"]
  node_formatters["Currency and expiry<br/>[formatters.ts]"]
end

node_users(("Users"))

node_users -->|"accesses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_inventory
node_app -->|"routes to"| node_bulkorder
node_app -->|"routes to"| node_invoices
node_app -->|"routes to"| node_patientportal
node_app -->|"provides context"| node_state
node_bulkorder -->|"reads and updates"| node_state
node_inventory -->|"reads and updates"| node_state
node_invoices -->|"reads"| node_state
node_patientportal -->|"reads and updates"| node_state
node_state -->|"syncs orders"| node_api
node_state -->|"uses domain types"| node_types
node_bulkorder -->|"calculates totals"| node_taxcalc
node_bulkorder -->|"formats values"| node_formatters
node_inventory -->|"formats expiry"| node_formatters
node_invoices -->|"formats values"| node_formatters
node_backendapp -->|"mounts"| node_authroutes
node_backendapp -->|"mounts"| node_userroutes
node_backendapp -->|"mounts"| node_productroutes
node_backendapp -->|"mounts"| node_orderroutes
node_backendapp -->|"mounts"| node_invoiceroutes
node_backendapp -->|"mounts"| node_analyticsroutes
node_backendapp -->|"mounts"| node_taxroutes
node_backendapp -->|"mounts"| node_patientroutes
node_authmw -->|"passes auth errors"| node_errors
node_orderroutes -->|"uses calculations"| node_bulkservice
node_analyticsroutes -->|"uses analytics"| node_revservice
node_orderroutes -->|"queries database"| node_db
node_analyticsroutes -->|"queries database"| node_db
node_authroutes -->|"queries database"| node_db
node_invoiceroutes -->|"queries database"| node_db
node_authroutes -->|"uses auth middleware"| node_authmw
node_orderroutes -->|"uses auth middleware"| node_authmw
node_invoiceroutes -->|"uses auth middleware"| node_authmw
node_analyticsroutes -->|"uses auth middleware"| node_authmw
node_api -.->|"requests API"| node_backendapp

click node_app "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/App.tsx"
click node_login "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/LoginView.tsx"
click node_dashboard "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/DashboardView.tsx"
click node_inventory "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/InventoryView.tsx"
click node_bulkorder "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/BulkOrderView.tsx"
click node_invoices "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/InvoicesView.tsx"
click node_patientportal "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/PatientPortalView.tsx"
click node_state "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/context/AppContext.tsx"
click node_api "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/services/api.ts"
click node_types "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/types/index.ts"
click node_formatters "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/utils/formatters.ts"
click node_taxcalc "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/utils/taxCalculations.ts"
click node_backendapp "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/app.ts"
click node_authroutes "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/auth.ts"
click node_userroutes "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/users.ts"
click node_productroutes "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/products.ts"
click node_orderroutes "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/orders.ts"
click node_invoiceroutes "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/invoices.ts"
click node_analyticsroutes "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/analytics.ts"
click node_taxroutes "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/tax.ts"
click node_patientroutes "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/patients.ts"
click node_authmw "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/middleware/auth.ts"
click node_errors "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/middleware/errors.ts"
click node_db "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/lib/prisma.ts"
click node_bulkservice "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/services/BulkOrderCalculationService.ts"
click node_revservice "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/services/RevenueSegregationService.ts"
click node_taxservice "https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/services/FormalTaxDeductionService.ts"

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_login,node_dashboard,node_users toneBlue
class node_inventory,node_bulkorder,node_invoices,node_taxcalc toneAmber
class node_patientportal toneMint
class node_backendapp,node_authroutes,node_userroutes,node_productroutes,node_orderroutes,node_invoiceroutes,node_analyticsroutes,node_taxroutes,node_patientroutes,node_authmw,node_errors,node_db,node_bulkservice,node_revservice,node_taxservice toneRose
class node_state,node_api,node_types,node_formatters toneIndigo
```

## Components

### Web application

- [React app routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/App.tsx): `src/App.tsx`
- [Login view](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/LoginView.tsx): `src/views/LoginView.tsx`
- [Executive dashboard](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/DashboardView.tsx): `src/views/DashboardView.tsx`

### Distribution workflows

- [Dual-pool inventory](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/InventoryView.tsx): `src/views/InventoryView.tsx`
- [Bulk ordering](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/BulkOrderView.tsx): `src/views/BulkOrderView.tsx`
- [Invoices](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/InvoicesView.tsx): `src/views/InvoicesView.tsx`
- [Tax calculations](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/utils/taxCalculations.ts): `src/utils/taxCalculations.ts`

### Patient care

- [Patient portal](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/views/PatientPortalView.tsx): `src/views/PatientPortalView.tsx`

### Backend API

- [Express API router](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/app.ts): `backend/src/app.ts`
- [Authentication routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/auth.ts): `backend/src/routes/auth.ts`
- [User routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/users.ts): `backend/src/routes/users.ts`
- [Product routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/products.ts): `backend/src/routes/products.ts`
- [Order routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/orders.ts): `backend/src/routes/orders.ts`
- [Invoice routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/invoices.ts): `backend/src/routes/invoices.ts`
- [Analytics routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/analytics.ts): `backend/src/routes/analytics.ts`
- [Tax routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/tax.ts): `backend/src/routes/tax.ts`
- [Patient routes](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/routes/patients.ts): `backend/src/routes/patients.ts`
- [JWT and role middleware](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/middleware/auth.ts): `backend/src/middleware/auth.ts`
- [Validation and errors](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/middleware/errors.ts): `backend/src/middleware/errors.ts`
- [Prisma database access](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/lib/prisma.ts): `backend/src/lib/prisma.ts`
- [Bulk order calculation](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/services/BulkOrderCalculationService.ts): `backend/src/services/BulkOrderCalculationService.ts`
- [Revenue segregation](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/services/RevenueSegregationService.ts): `backend/src/services/RevenueSegregationService.ts`
- [Formal tax deductions](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/backend/src/services/FormalTaxDeductionService.ts): `backend/src/services/FormalTaxDeductionService.ts`

### Shared runtime

- [Application state](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/context/AppContext.tsx): `src/context/AppContext.tsx`
- [API client](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/services/api.ts): `src/services/api.ts`
- [Domain types](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/types/index.ts): `src/types/index.ts`
- [Currency and expiry](https://github.com/tashiel-singh/worthitsolutions-wil-insy7315-/blob/main/src/utils/formatters.ts): `src/utils/formatters.ts`

### Other components

- **Users**

## Connections

- Users → React app routes: accesses (evidence: `README.md`)
- React app routes → Login view: routes to (evidence: `src/App.tsx`)
- React app routes → Executive dashboard: routes to (evidence: `src/App.tsx`)
- React app routes → Dual-pool inventory: routes to (evidence: `src/App.tsx`)
- React app routes → Bulk ordering: routes to (evidence: `src/App.tsx`)
- React app routes → Invoices: routes to (evidence: `src/App.tsx`)
- React app routes → Patient portal: routes to (evidence: `src/App.tsx`)
- React app routes → Application state: provides context (evidence: `src/App.tsx`)
- Bulk ordering → Application state: reads and updates (evidence: `src/views/BulkOrderView.tsx`)
- Dual-pool inventory → Application state: reads and updates (evidence: `src/views/InventoryView.tsx`)
- Invoices → Application state: reads (evidence: `src/views/InvoicesView.tsx`)
- Patient portal → Application state: reads and updates (evidence: `src/views/PatientPortalView.tsx`)
- Application state → API client: syncs orders (evidence: `src/context/AppContext.tsx`)
- Application state → Domain types: uses domain types (evidence: `src/context/AppContext.tsx`)
- Bulk ordering → Tax calculations: calculates totals (evidence: `src/views/BulkOrderView.tsx`)
- Bulk ordering → Currency and expiry: formats values (evidence: `src/views/BulkOrderView.tsx`)
- Dual-pool inventory → Currency and expiry: formats expiry (evidence: `src/views/InventoryView.tsx`)
- Invoices → Currency and expiry: formats values (evidence: `src/views/InvoicesView.tsx`)
- Express API router → Authentication routes: mounts (evidence: `backend/src/app.ts`)
- Express API router → User routes: mounts (evidence: `backend/src/app.ts`)
- Express API router → Product routes: mounts (evidence: `backend/src/app.ts`)
- Express API router → Order routes: mounts (evidence: `backend/src/app.ts`)
- Express API router → Invoice routes: mounts (evidence: `backend/src/app.ts`)
- Express API router → Analytics routes: mounts (evidence: `backend/src/app.ts`)
- Express API router → Tax routes: mounts (evidence: `backend/src/app.ts`)
- Express API router → Patient routes: mounts (evidence: `backend/src/app.ts`)
- JWT and role middleware → Validation and errors: passes auth errors (evidence: `backend/src/middleware/auth.ts`)
- Order routes → Bulk order calculation: uses calculations (evidence: `backend/src/routes/orders.ts`)
- Analytics routes → Revenue segregation: uses analytics (evidence: `backend/src/routes/analytics.ts`)
- Order routes → Prisma database access: queries database (evidence: `backend/src/routes/orders.ts`)
- Analytics routes → Prisma database access: queries database (evidence: `backend/src/routes/analytics.ts`)
- Authentication routes → Prisma database access: queries database (evidence: `backend/src/routes/auth.ts`)
- Invoice routes → Prisma database access: queries database (evidence: `backend/src/routes/invoices.ts`)
- Authentication routes → JWT and role middleware: uses auth middleware (evidence: `backend/src/routes/auth.ts`)
- Order routes → JWT and role middleware: uses auth middleware (evidence: `backend/src/routes/orders.ts`)
- Invoice routes → JWT and role middleware: uses auth middleware (evidence: `backend/src/routes/invoices.ts`)
- Analytics routes → JWT and role middleware: uses auth middleware (evidence: `backend/src/routes/analytics.ts`)
- API client → Express API router: requests API
