# anupdudhe/edublitz-b2b-medical-erp architecture

> Architecture diagram of the GitHub repository anupdudhe/edublitz-b2b-medical-erp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anupdudhe/edublitz-b2b-medical-erp
- Repository: https://github.com/anupdudhe/edublitz-b2b-medical-erp

## Overview

EduBlitz is a medical B2B ERP for hospitals, distributors, and administrators. Users authenticate and enter role-based dashboards to browse products, manage inventory, and place or track orders. The backend separates identity and organizations, catalog and stock, and order lifecycle/billing across three services backed by MongoDB. The README establishes the service topology and major capabilities; sampled source confirms selected controller-to-service and service-to-storage/client calls. Other unsampled UI and service links are omitted rather than inferred.

Main entry points: [`frontend/src/App.tsx`](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/frontend/src/App.tsx) (Web Routes), [`product-service/src/main/java/com/edublitz/productservice/service/ProductService.java`](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/service/ProductService.java) (Catalog and Stock Logic), [`order-service/src/main/java/com/edublitz/orderservice/service/OrderService.java`](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/service/OrderService.java) (Order and Billing Logic), [`product-service/src/main/java/com/edublitz/productservice/controller/ProductController.java`](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/controller/ProductController.java) (Catalog and Stock API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Role-Based Web App"]
  node_web_app["Web Routes<br/>[App.tsx]"]
  node_auth_pages["Sign-in and Registration"]
  node_role_dashboards["Role Dashboards"]
  node_product_ui["Product and Inventory UI<br/>[ProductsPage.tsx]"]
  node_order_ui["Orders and Detail UI"]
end

subgraph group_identity["Identity and Organizations"]
  node_user_api["Auth and User APIs"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_org_api["Organization Management"]
  node_user_admin["User Administration"]
  node_audit["Audit Trail<br/>[AuditService.java]"]
end

subgraph group_catalog["Catalog and Inventory"]
  node_product_api["Catalog and Stock API"]
  node_product_logic["Catalog and Stock Logic"]
  node_product_store["Product Records"]
  node_inventory_store["Inventory Records"]
end

subgraph group_orders["Orders and Billing"]
  node_order_api["Order Lifecycle API"]
  node_order_logic["Order and Billing Logic<br/>[OrderService.java]"]
  node_product_client["Product Service Client"]
  node_order_store["Order Records"]
end

subgraph group_platform["Shared Data Platform"]
  node_mongodb[("MongoDB Atlas")]
  node_alb{{"AWS ALB Ingress"}}
end

node_business_users(("Hospital, Distributor, Admin"))

node_business_users -->|"use"| node_web_app
node_web_app -->|"routes to"| node_auth_pages
node_web_app -->|"routes to"| node_role_dashboards
node_web_app -->|"routes to"| node_product_ui
node_web_app -->|"routes to"| node_order_ui
node_web_app -->|"served via"| node_alb
node_alb -->|"routes to"| node_user_api
node_alb -->|"routes to"| node_product_api
node_alb -->|"routes to"| node_order_api
node_user_api -->|"delegates to"| node_auth_service
node_auth_service -->|"reads and writes"| node_mongodb
node_user_admin -->|"logs actions"| node_audit
node_audit -->|"writes audit records"| node_mongodb
node_org_api -->|"manages organizations"| node_mongodb
node_product_api -->|"delegates to"| node_product_logic
node_product_logic -->|"reads and writes"| node_product_store
node_product_logic -->|"reads and writes"| node_inventory_store
node_product_store -->|"persists catalog"| node_mongodb
node_inventory_store -->|"persists stock"| node_mongodb
node_order_api -->|"delegates to"| node_order_logic
node_order_logic -->|"checks and reserves"| node_product_client
node_product_client -->|"calls internally"| node_product_api
node_order_logic -->|"reads and writes"| node_order_store
node_order_store -->|"persists orders"| node_mongodb

click node_web_app "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/frontend/src/App.tsx"
click node_auth_pages "https://github.com/anupdudhe/edublitz-b2b-medical-erp/tree/main/frontend/src/pages/auth"
click node_role_dashboards "https://github.com/anupdudhe/edublitz-b2b-medical-erp/tree/main/frontend/src/pages"
click node_product_ui "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/frontend/src/pages/ProductsPage.tsx"
click node_order_ui "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/frontend/src/pages/OrderDetailPage.tsx"
click node_user_api "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/controller/AuthController.java"
click node_auth_service "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/service/AuthService.java"
click node_org_api "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/controller/OrganizationController.java"
click node_user_admin "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/controller/UserController.java"
click node_audit "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/service/AuditService.java"
click node_product_api "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/controller/ProductController.java"
click node_product_logic "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/service/ProductService.java"
click node_product_store "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/repository/ProductRepository.java"
click node_inventory_store "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/repository/InventoryRepository.java"
click node_order_api "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/controller/OrderController.java"
click node_order_logic "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/service/OrderService.java"
click node_product_client "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/client/ProductServiceClient.java"
click node_order_store "https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/repository/OrderRepository.java"

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_auth_pages,node_role_dashboards,node_product_ui,node_order_ui toneBlue
class node_user_api,node_auth_service,node_org_api,node_user_admin,node_audit toneAmber
class node_product_api,node_product_logic,node_product_store,node_inventory_store toneMint
class node_order_api,node_order_logic,node_product_client,node_order_store toneRose
class node_mongodb,node_alb,node_business_users toneIndigo
```

## Components

### Role-Based Web App

- [Web Routes](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Sign-in and Registration](https://github.com/anupdudhe/edublitz-b2b-medical-erp/tree/main/frontend/src/pages/auth): `frontend/src/pages/auth`
- [Role Dashboards](https://github.com/anupdudhe/edublitz-b2b-medical-erp/tree/main/frontend/src/pages): `frontend/src/pages`
- [Product and Inventory UI](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/frontend/src/pages/ProductsPage.tsx): `frontend/src/pages/ProductsPage.tsx`
- [Orders and Detail UI](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/frontend/src/pages/OrderDetailPage.tsx): `frontend/src/pages/OrderDetailPage.tsx`

### Identity and Organizations

- [Auth and User APIs](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/controller/AuthController.java): `user-service/src/main/java/com/edublitz/userservice/controller/AuthController.java`
- [Authentication](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/service/AuthService.java): `user-service/src/main/java/com/edublitz/userservice/service/AuthService.java`
- [Organization Management](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/controller/OrganizationController.java): `user-service/src/main/java/com/edublitz/userservice/controller/OrganizationController.java`
- [User Administration](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/controller/UserController.java): `user-service/src/main/java/com/edublitz/userservice/controller/UserController.java`
- [Audit Trail](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/user-service/src/main/java/com/edublitz/userservice/service/AuditService.java): `user-service/src/main/java/com/edublitz/userservice/service/AuditService.java`

### Catalog and Inventory

- [Catalog and Stock API](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/controller/ProductController.java): `product-service/src/main/java/com/edublitz/productservice/controller/ProductController.java`
- [Catalog and Stock Logic](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/service/ProductService.java): `product-service/src/main/java/com/edublitz/productservice/service/ProductService.java`
- [Product Records](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/repository/ProductRepository.java): `product-service/src/main/java/com/edublitz/productservice/repository/ProductRepository.java`
- [Inventory Records](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/product-service/src/main/java/com/edublitz/productservice/repository/InventoryRepository.java): `product-service/src/main/java/com/edublitz/productservice/repository/InventoryRepository.java`

### Orders and Billing

- [Order Lifecycle API](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/controller/OrderController.java): `order-service/src/main/java/com/edublitz/orderservice/controller/OrderController.java`
- [Order and Billing Logic](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/service/OrderService.java): `order-service/src/main/java/com/edublitz/orderservice/service/OrderService.java`
- [Product Service Client](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/client/ProductServiceClient.java): `order-service/src/main/java/com/edublitz/orderservice/client/ProductServiceClient.java`
- [Order Records](https://github.com/anupdudhe/edublitz-b2b-medical-erp/blob/main/order-service/src/main/java/com/edublitz/orderservice/repository/OrderRepository.java): `order-service/src/main/java/com/edublitz/orderservice/repository/OrderRepository.java`

### Shared Data Platform

- **MongoDB Atlas**
- **AWS ALB Ingress**

### Other components

- **Hospital, Distributor, Admin**

## Connections

- Hospital, Distributor, Admin → Web Routes: use
- Web Routes → Sign-in and Registration: routes to (evidence: `frontend/src/App.tsx`)
- Web Routes → Role Dashboards: routes to (evidence: `frontend/src/App.tsx`)
- Web Routes → Product and Inventory UI: routes to (evidence: `frontend/src/App.tsx`)
- Web Routes → Orders and Detail UI: routes to (evidence: `frontend/src/App.tsx`)
- Web Routes → AWS ALB Ingress: served via
- AWS ALB Ingress → Auth and User APIs: routes to
- AWS ALB Ingress → Catalog and Stock API: routes to
- AWS ALB Ingress → Order Lifecycle API: routes to
- Auth and User APIs → Authentication: delegates to (evidence: `user-service/src/main/java/com/edublitz/userservice/service/AuthService.java`)
- Authentication → MongoDB Atlas: reads and writes
- User Administration → Audit Trail: logs actions (evidence: `user-service/src/main/java/com/edublitz/userservice/controller/UserController.java`)
- Audit Trail → MongoDB Atlas: writes audit records
- Organization Management → MongoDB Atlas: manages organizations
- Catalog and Stock API → Catalog and Stock Logic: delegates to (evidence: `product-service/src/main/java/com/edublitz/productservice/controller/ProductController.java`)
- Catalog and Stock Logic → Product Records: reads and writes (evidence: `product-service/src/main/java/com/edublitz/productservice/service/ProductService.java`)
- Catalog and Stock Logic → Inventory Records: reads and writes (evidence: `product-service/src/main/java/com/edublitz/productservice/service/ProductService.java`)
- Product Records → MongoDB Atlas: persists catalog
- Inventory Records → MongoDB Atlas: persists stock
- Order Lifecycle API → Order and Billing Logic: delegates to (evidence: `order-service/src/main/java/com/edublitz/orderservice/controller/OrderController.java`)
- Order and Billing Logic → Product Service Client: checks and reserves (evidence: `order-service/src/main/java/com/edublitz/orderservice/service/OrderService.java`)
- Product Service Client → Catalog and Stock API: calls internally (evidence: `product-service/src/main/java/com/edublitz/productservice/controller/ProductController.java`)
- Order and Billing Logic → Order Records: reads and writes (evidence: `order-service/src/main/java/com/edublitz/orderservice/service/OrderService.java`)
- Order Records → MongoDB Atlas: persists orders
