# prasannarkv/e-cart-micro-frontend architecture

> Architecture diagram of the GitHub repository prasannarkv/e-cart-micro-frontend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/prasannarkv/e-cart-micro-frontend
- Repository: https://github.com/prasannarkv/e-cart-micro-frontend

## Overview

E-Cart is a mocked e-commerce micro-frontend demo: the home app is the shell, with separate cart, products, orders, and profile apps, plus a NestJS backend. The main user journey runs through the shell into product browsing and cart/order/profile experiences; products also supports iframe embedding. The backend exposes product, cart, user, and config endpoints over mocked data. Frontend-to-backend call paths are not established by the sampled evidence, so those links are omitted.

Main entry points: [`apps/backend/src/app.module.ts`](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/app.module.ts) (Backend App), [`apps/home/next.config.ts`](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/home/next.config.ts) (Federation Host), [`apps/home/src/pages/index.tsx`](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/home/src/pages/index.tsx) (Home Shell), [`apps/backend/src/MockData/user.ts`](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/MockData/user.ts) (Mock User Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Shell and Integration"]
  node_home["Home Shell<br/>[index.tsx]"]
  node_home_routes["Shop Routes"]
  node_federation["Federation Host<br/>[next.config.ts]"]
  node_iframe_listing["Iframe Listing<br/>[IframeListing.tsx]"]
end

subgraph group_commerce["Commerce Microfrontends"]
  node_cart_ui["Cart UI<br/>[Cart.tsx]"]
  node_cart_widgets["Cart Widgets"]
  node_products_ui["Product Browse<br/>[Listing.tsx]"]
  node_product_details["Product Details<br/>[Details.tsx]"]
  node_message_channel["Message Channel"]
  node_orders_ui["Order Views<br/>[ListOrders.tsx]"]
  node_order_actions["Order Actions<br/>[CreateOrder.tsx]"]
end

subgraph group_account["Account Microfrontends"]
  node_profile_ui["Profile Views<br/>[Profile.tsx]"]
  node_profile_cards["Card Selection<br/>[SelectCard.tsx]"]
end

subgraph group_backend["Mock Backend"]
  node_backend_app["Backend App<br/>[app.module.ts]"]
  node_middleware["User Middleware"]
  node_app_controller["Root Endpoint<br/>[app.controller.ts]"]
  node_app_service["Root Service<br/>[app.service.ts]"]
  node_cart_controller["Cart Endpoint<br/>[cart.controller.ts]"]
  node_cart_service["Cart Service<br/>[cart.service.ts]"]
  node_products_controller["Product Endpoint"]
  node_products_service["Product Service"]
  node_user_controller["User Endpoint<br/>[user.controller.ts]"]
  node_user_service["User Service<br/>[user.service.ts]"]
  node_config_controller["Config Endpoint"]
  node_config_service["Config Service<br/>[config.service.ts]"]
  node_mock_user[("Mock User Data<br/>[user.ts]")]
  node_mock_products[("Mock Product Data<br/>[products.ts]")]
end

subgraph group_shared["Shared UI and Network"]
  node_network["Network Package<br/>[index.tsx]"]
  node_ui_library["UI Components"]
  node_product_card["Product Card<br/>[ProductCard.tsx]"]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_home
node_home -->|"loads remotes"| node_federation
node_federation -->|"federates"| node_cart_ui
node_federation -->|"federates"| node_products_ui
node_federation -->|"federates"| node_orders_ui
node_federation -->|"federates"| node_profile_ui
node_home -.->|"embeds optionally"| node_iframe_listing
node_backend_app -->|"registers"| node_app_controller
node_backend_app -->|"applies routes"| node_middleware
node_backend_app -->|"registers module"| node_cart_controller
node_backend_app -->|"registers module"| node_products_controller
node_backend_app -->|"registers module"| node_user_controller
node_backend_app -->|"registers module"| node_config_controller
node_app_controller -->|"calls"| node_app_service
node_cart_controller -->|"calls"| node_cart_service
node_cart_service -->|"reads and updates"| node_mock_user
node_products_controller -->|"calls"| node_products_service
node_products_service -->|"reads"| node_mock_products
node_user_controller -->|"calls"| node_user_service
node_user_service -->|"reads and updates"| node_mock_user
node_config_controller -->|"calls"| node_config_service
node_config_service -->|"reads"| node_mock_user
node_product_details -->|"uses"| node_product_card

click node_home "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/home/src/pages/index.tsx"
click node_home_routes "https://github.com/prasannarkv/e-cart-micro-frontend/tree/main/apps/home/src/pages"
click node_federation "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/home/next.config.ts"
click node_iframe_listing "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/products/src/components/IframeListing.tsx"
click node_cart_ui "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/cart/src/components/Cart.tsx"
click node_cart_widgets "https://github.com/prasannarkv/e-cart-micro-frontend/tree/main/apps/cart/src/components"
click node_products_ui "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/products/src/components/Listing.tsx"
click node_product_details "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/products/src/components/Details.tsx"
click node_message_channel "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/products/src/hooks/useMessageChannel.ts"
click node_orders_ui "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/orders/src/components/ListOrders.tsx"
click node_order_actions "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/orders/src/components/CreateOrder.tsx"
click node_profile_ui "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/profile/src/components/Profile.tsx"
click node_profile_cards "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/profile/src/components/SelectCard.tsx"
click node_backend_app "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/app.module.ts"
click node_middleware "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/user-decorator/user-decorator.middleware.ts"
click node_app_controller "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/app.controller.ts"
click node_app_service "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/app.service.ts"
click node_cart_controller "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/cart/cart.controller.ts"
click node_cart_service "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/cart/cart.service.ts"
click node_products_controller "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/products/products.controller.ts"
click node_products_service "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/products/products.service.ts"
click node_user_controller "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/user/user.controller.ts"
click node_user_service "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/user/user.service.ts"
click node_config_controller "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/config/config.controller.ts"
click node_config_service "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/config/config.service.ts"
click node_mock_user "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/MockData/user.ts"
click node_mock_products "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/MockData/products.ts"
click node_network "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/packages/network/src/index.tsx"
click node_ui_library "https://github.com/prasannarkv/e-cart-micro-frontend/tree/main/packages/ui/components/ui"
click node_product_card "https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/packages/ui/components/ui/ProductCard.tsx"

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_home,node_home_routes,node_federation,node_iframe_listing toneBlue
class node_cart_ui,node_cart_widgets,node_products_ui,node_product_details,node_message_channel,node_orders_ui,node_order_actions toneAmber
class node_profile_ui,node_profile_cards toneMint
class node_backend_app,node_middleware,node_app_controller,node_app_service,node_cart_controller,node_cart_service,node_products_controller,node_products_service,node_user_controller,node_user_service,node_config_controller,node_config_service,node_mock_user,node_mock_products toneRose
class node_network,node_ui_library,node_product_card,node_shopper toneIndigo
```

## Components

### Shell and Integration

- [Home Shell](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/home/src/pages/index.tsx): `apps/home/src/pages/index.tsx`
- [Shop Routes](https://github.com/prasannarkv/e-cart-micro-frontend/tree/main/apps/home/src/pages): `apps/home/src/pages`
- [Federation Host](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/home/next.config.ts): `apps/home/next.config.ts`
- [Iframe Listing](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/products/src/components/IframeListing.tsx): `apps/products/src/components/IframeListing.tsx`

### Commerce Microfrontends

- [Cart UI](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/cart/src/components/Cart.tsx): `apps/cart/src/components/Cart.tsx`
- [Cart Widgets](https://github.com/prasannarkv/e-cart-micro-frontend/tree/main/apps/cart/src/components): `apps/cart/src/components`
- [Product Browse](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/products/src/components/Listing.tsx): `apps/products/src/components/Listing.tsx`
- [Product Details](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/products/src/components/Details.tsx): `apps/products/src/components/Details.tsx`
- [Message Channel](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/products/src/hooks/useMessageChannel.ts): `apps/products/src/hooks/useMessageChannel.ts`
- [Order Views](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/orders/src/components/ListOrders.tsx): `apps/orders/src/components/ListOrders.tsx`
- [Order Actions](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/orders/src/components/CreateOrder.tsx): `apps/orders/src/components/CreateOrder.tsx`

### Account Microfrontends

- [Profile Views](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/profile/src/components/Profile.tsx): `apps/profile/src/components/Profile.tsx`
- [Card Selection](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/profile/src/components/SelectCard.tsx): `apps/profile/src/components/SelectCard.tsx`

### Mock Backend

- [Backend App](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/app.module.ts): `apps/backend/src/app.module.ts`
- [User Middleware](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/user-decorator/user-decorator.middleware.ts): `apps/backend/src/user-decorator/user-decorator.middleware.ts`
- [Root Endpoint](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/app.controller.ts): `apps/backend/src/app.controller.ts`
- [Root Service](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/app.service.ts): `apps/backend/src/app.service.ts`
- [Cart Endpoint](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/cart/cart.controller.ts): `apps/backend/src/cart/cart.controller.ts`
- [Cart Service](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/cart/cart.service.ts): `apps/backend/src/cart/cart.service.ts`
- [Product Endpoint](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/products/products.controller.ts): `apps/backend/src/products/products.controller.ts`
- [Product Service](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/products/products.service.ts): `apps/backend/src/products/products.service.ts`
- [User Endpoint](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/user/user.controller.ts): `apps/backend/src/user/user.controller.ts`
- [User Service](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/user/user.service.ts): `apps/backend/src/user/user.service.ts`
- [Config Endpoint](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/config/config.controller.ts): `apps/backend/src/config/config.controller.ts`
- [Config Service](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/config/config.service.ts): `apps/backend/src/config/config.service.ts`
- [Mock User Data](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/MockData/user.ts): `apps/backend/src/MockData/user.ts`
- [Mock Product Data](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/apps/backend/src/MockData/products.ts): `apps/backend/src/MockData/products.ts`

### Shared UI and Network

- [Network Package](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/packages/network/src/index.tsx): `packages/network/src/index.tsx`
- [UI Components](https://github.com/prasannarkv/e-cart-micro-frontend/tree/main/packages/ui/components/ui): `packages/ui/components/ui`
- [Product Card](https://github.com/prasannarkv/e-cart-micro-frontend/blob/main/packages/ui/components/ui/ProductCard.tsx): `packages/ui/components/ui/ProductCard.tsx`

### Other components

- **Shopper**

## Connections

- Shopper → Home Shell: uses
- Home Shell → Federation Host: loads remotes
- Federation Host → Cart UI: federates
- Federation Host → Product Browse: federates
- Federation Host → Order Views: federates
- Federation Host → Profile Views: federates
- Home Shell → Iframe Listing: embeds optionally
- Backend App → Root Endpoint: registers (evidence: `apps/backend/src/app.module.ts`)
- Backend App → User Middleware: applies routes (evidence: `apps/backend/src/app.module.ts`)
- Backend App → Cart Endpoint: registers module (evidence: `apps/backend/src/app.module.ts`)
- Backend App → Product Endpoint: registers module (evidence: `apps/backend/src/app.module.ts`)
- Backend App → User Endpoint: registers module (evidence: `apps/backend/src/app.module.ts`)
- Backend App → Config Endpoint: registers module (evidence: `apps/backend/src/app.module.ts`)
- Root Endpoint → Root Service: calls (evidence: `apps/backend/src/app.controller.ts`)
- Cart Endpoint → Cart Service: calls (evidence: `apps/backend/src/cart/cart.controller.ts`)
- Cart Service → Mock User Data: reads and updates (evidence: `apps/backend/src/cart/cart.service.ts`)
- Product Endpoint → Product Service: calls (evidence: `apps/backend/src/products/products.controller.ts`)
- Product Service → Mock Product Data: reads (evidence: `apps/backend/src/products/products.service.ts`)
- User Endpoint → User Service: calls (evidence: `apps/backend/src/user/user.controller.ts`)
- User Service → Mock User Data: reads and updates (evidence: `apps/backend/src/user/user.service.ts`)
- Config Endpoint → Config Service: calls (evidence: `apps/backend/src/config/config.controller.ts`)
- Config Service → Mock User Data: reads (evidence: `apps/backend/src/config/config.service.ts`)
- Product Details → Product Card: uses
