# sap2024-4y/apibp002 architecture

> Architecture diagram of the GitHub repository sap2024-4y/apibp002, 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/sap2024-4y/apibp002
- Repository: https://github.com/sap2024-4y/apibp002

## Overview

ShopMesh is an online-shopping marketplace backend with a React storefront. A shopper can browse and geographically search products, inspect delivery slots, request a JWT, and book or cancel slots; REST and GraphQL expose the same domain services. Admins also manage products and view statistics. SQLite stores products, slots, and bookings. The README documents Swagger/OpenAPI and an embedded GraphQL IDE. Some paths are inferred from the documented architecture because their implementation was not sampled; those links are marked unverified.

Main entry points: [`src/app.js`](https://github.com/sap2024-4y/apibp002/blob/main/src/app.js) (Express App), [`src/rest/router.js`](https://github.com/sap2024-4y/apibp002/blob/main/src/rest/router.js) (REST Router), [`src/graphql/resolvers.js`](https://github.com/sap2024-4y/apibp002/blob/main/src/graphql/resolvers.js) (GraphQL Resolvers), [`src/auth/middleware.js`](https://github.com/sap2024-4y/apibp002/blob/main/src/auth/middleware.js) (JWT and Guards)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Storefront"]
  node_storefront["React Storefront<br/>[App.jsx]"]
  node_frontend_api["Frontend API Client<br/>[api.js]"]
end

subgraph group_entry["API Interfaces"]
  node_app["Express App<br/>[app.js]"]
  node_rest_router["REST Router<br/>[router.js]"]
  node_product_routes["Product Routes<br/>[products.routes.js]"]
  node_booking_routes["Booking Routes<br/>[bookings.routes.js]"]
  node_auth_routes["Auth Routes<br/>[auth.routes.js]"]
  node_admin_routes["Admin Routes<br/>[admin.routes.js]"]
  node_graphql["GraphQL Resolvers<br/>[resolvers.js]"]
end

subgraph group_domain["Marketplace Domain"]
  node_product_service["Product Catalog<br/>[products.js]"]
  node_booking_service["Slot Booking<br/>[bookings.js]"]
  node_stats_service["Marketplace Stats<br/>[stats.js]"]
  node_cursor["Cursor Pagination<br/>[cursor.js]"]
  node_geo["Geospatial Utilities<br/>[geo.js]"]
end

subgraph group_identity["Identity and Runtime"]
  node_auth["JWT and Guards<br/>[middleware.js]"]
  node_rate_limit["Rate Limiting<br/>[rateLimit.js]"]
  node_errors["Error Handling<br/>[errors.js]"]
end

subgraph group_storage["Persistence and Docs"]
  node_database[("SQLite Database<br/>[client.js]")]
  node_seed["Demo Catalogue Seed<br/>[seed.js]"]
  node_loaders["GraphQL DataLoaders<br/>[loaders.js]"]
  node_swagger["REST API Docs<br/>[swagger.js]"]
end

node_shopper(("Shopper"))
node_admin(("Admin"))

node_shopper -->|"uses"| node_storefront
node_admin -->|"manages products"| node_product_routes
node_storefront -->|"uses"| node_frontend_api
node_frontend_api -.->|"calls API"| node_app
node_app -->|"mounts REST"| node_rest_router
node_app -->|"configures GraphQL"| node_graphql
node_app -->|"attaches user"| node_auth
node_app -->|"limits requests"| node_rate_limit
node_app -->|"seeds database"| node_seed
node_app -->|"serves docs"| node_swagger
node_rest_router -->|"mounts routes"| node_product_routes
node_rest_router -->|"mounts routes"| node_booking_routes
node_rest_router -->|"mounts routes"| node_auth_routes
node_rest_router -->|"mounts routes"| node_admin_routes
node_product_routes -->|"calls catalog"| node_product_service
node_product_routes -->|"lists slots"| node_booking_service
node_booking_routes -->|"calls booking"| node_booking_service
node_auth_routes -->|"issues tokens"| node_auth
node_admin_routes -->|"reads statistics"| node_stats_service
node_admin_routes -->|"checks roles"| node_auth
node_product_routes -->|"checks roles"| node_auth
node_booking_routes -->|"checks identity"| node_auth
node_graphql -->|"calls catalog"| node_product_service
node_graphql -->|"calls booking"| node_booking_service
node_graphql -->|"issues tokens"| node_auth
node_graphql -->|"loads relations"| node_loaders
node_product_service -->|"reads and writes"| node_database
node_booking_service -->|"reads and writes"| node_database
node_stats_service -->|"queries stats"| node_database
node_loaders -->|"batches reads"| node_database
node_product_service -->|"encodes cursors"| node_cursor
node_product_service -->|"computes proximity"| node_geo
node_graphql -->|"formats locations"| node_geo
node_rest_router -->|"handles failures"| node_errors

click node_storefront "https://github.com/sap2024-4y/apibp002/blob/main/frontend/src/App.jsx"
click node_frontend_api "https://github.com/sap2024-4y/apibp002/blob/main/frontend/src/api.js"
click node_app "https://github.com/sap2024-4y/apibp002/blob/main/src/app.js"
click node_rest_router "https://github.com/sap2024-4y/apibp002/blob/main/src/rest/router.js"
click node_product_routes "https://github.com/sap2024-4y/apibp002/blob/main/src/rest/products.routes.js"
click node_booking_routes "https://github.com/sap2024-4y/apibp002/blob/main/src/rest/bookings.routes.js"
click node_auth_routes "https://github.com/sap2024-4y/apibp002/blob/main/src/rest/auth.routes.js"
click node_admin_routes "https://github.com/sap2024-4y/apibp002/blob/main/src/rest/admin.routes.js"
click node_graphql "https://github.com/sap2024-4y/apibp002/blob/main/src/graphql/resolvers.js"
click node_product_service "https://github.com/sap2024-4y/apibp002/blob/main/src/services/products.js"
click node_booking_service "https://github.com/sap2024-4y/apibp002/blob/main/src/services/bookings.js"
click node_stats_service "https://github.com/sap2024-4y/apibp002/blob/main/src/services/stats.js"
click node_cursor "https://github.com/sap2024-4y/apibp002/blob/main/src/util/cursor.js"
click node_geo "https://github.com/sap2024-4y/apibp002/blob/main/src/util/geo.js"
click node_auth "https://github.com/sap2024-4y/apibp002/blob/main/src/auth/middleware.js"
click node_rate_limit "https://github.com/sap2024-4y/apibp002/blob/main/src/middleware/rateLimit.js"
click node_errors "https://github.com/sap2024-4y/apibp002/blob/main/src/errors.js"
click node_database "https://github.com/sap2024-4y/apibp002/blob/main/src/db/client.js"
click node_seed "https://github.com/sap2024-4y/apibp002/blob/main/src/db/seed.js"
click node_loaders "https://github.com/sap2024-4y/apibp002/blob/main/src/graphql/loaders.js"
click node_swagger "https://github.com/sap2024-4y/apibp002/blob/main/src/docs/swagger.js"

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_storefront,node_frontend_api toneBlue
class node_app,node_rest_router,node_product_routes,node_booking_routes,node_auth_routes,node_admin_routes,node_graphql toneAmber
class node_product_service,node_booking_service,node_stats_service,node_cursor,node_geo toneMint
class node_auth,node_rate_limit,node_errors toneRose
class node_database,node_seed,node_loaders,node_swagger,node_shopper,node_admin toneIndigo
```

## Components

### Storefront

- [React Storefront](https://github.com/sap2024-4y/apibp002/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Frontend API Client](https://github.com/sap2024-4y/apibp002/blob/main/frontend/src/api.js): `frontend/src/api.js`

### API Interfaces

- [Express App](https://github.com/sap2024-4y/apibp002/blob/main/src/app.js): `src/app.js`
- [REST Router](https://github.com/sap2024-4y/apibp002/blob/main/src/rest/router.js): `src/rest/router.js`
- [Product Routes](https://github.com/sap2024-4y/apibp002/blob/main/src/rest/products.routes.js): `src/rest/products.routes.js`
- [Booking Routes](https://github.com/sap2024-4y/apibp002/blob/main/src/rest/bookings.routes.js): `src/rest/bookings.routes.js`
- [Auth Routes](https://github.com/sap2024-4y/apibp002/blob/main/src/rest/auth.routes.js): `src/rest/auth.routes.js`
- [Admin Routes](https://github.com/sap2024-4y/apibp002/blob/main/src/rest/admin.routes.js): `src/rest/admin.routes.js`
- [GraphQL Resolvers](https://github.com/sap2024-4y/apibp002/blob/main/src/graphql/resolvers.js): `src/graphql/resolvers.js`

### Marketplace Domain

- [Product Catalog](https://github.com/sap2024-4y/apibp002/blob/main/src/services/products.js): `src/services/products.js`
- [Slot Booking](https://github.com/sap2024-4y/apibp002/blob/main/src/services/bookings.js): `src/services/bookings.js`
- [Marketplace Stats](https://github.com/sap2024-4y/apibp002/blob/main/src/services/stats.js): `src/services/stats.js`
- [Cursor Pagination](https://github.com/sap2024-4y/apibp002/blob/main/src/util/cursor.js): `src/util/cursor.js`
- [Geospatial Utilities](https://github.com/sap2024-4y/apibp002/blob/main/src/util/geo.js): `src/util/geo.js`

### Identity and Runtime

- [JWT and Guards](https://github.com/sap2024-4y/apibp002/blob/main/src/auth/middleware.js): `src/auth/middleware.js`
- [Rate Limiting](https://github.com/sap2024-4y/apibp002/blob/main/src/middleware/rateLimit.js): `src/middleware/rateLimit.js`
- [Error Handling](https://github.com/sap2024-4y/apibp002/blob/main/src/errors.js): `src/errors.js`

### Persistence and Docs

- [SQLite Database](https://github.com/sap2024-4y/apibp002/blob/main/src/db/client.js): `src/db/client.js`
- [Demo Catalogue Seed](https://github.com/sap2024-4y/apibp002/blob/main/src/db/seed.js): `src/db/seed.js`
- [GraphQL DataLoaders](https://github.com/sap2024-4y/apibp002/blob/main/src/graphql/loaders.js): `src/graphql/loaders.js`
- [REST API Docs](https://github.com/sap2024-4y/apibp002/blob/main/src/docs/swagger.js): `src/docs/swagger.js`

### Other components

- **Shopper**
- **Admin**

## Connections

- Shopper → React Storefront: uses (evidence: `README.md`)
- Admin → Product Routes: manages products (evidence: `README.md`)
- React Storefront → Frontend API Client: uses (evidence: `frontend/src/App.jsx`)
- Frontend API Client → Express App: calls API
- Express App → REST Router: mounts REST (evidence: `src/app.js`)
- Express App → GraphQL Resolvers: configures GraphQL (evidence: `src/app.js`)
- Express App → JWT and Guards: attaches user (evidence: `src/app.js`)
- Express App → Rate Limiting: limits requests (evidence: `src/app.js`)
- Express App → Demo Catalogue Seed: seeds database (evidence: `src/app.js`)
- Express App → REST API Docs: serves docs (evidence: `src/app.js`)
- REST Router → Product Routes: mounts routes (evidence: `src/rest/router.js`)
- REST Router → Booking Routes: mounts routes (evidence: `src/rest/router.js`)
- REST Router → Auth Routes: mounts routes (evidence: `src/rest/router.js`)
- REST Router → Admin Routes: mounts routes (evidence: `src/rest/router.js`)
- Product Routes → Product Catalog: calls catalog (evidence: `src/rest/products.routes.js`)
- Product Routes → Slot Booking: lists slots (evidence: `src/rest/products.routes.js`)
- Booking Routes → Slot Booking: calls booking (evidence: `src/rest/bookings.routes.js`)
- Auth Routes → JWT and Guards: issues tokens (evidence: `src/rest/auth.routes.js`)
- Admin Routes → Marketplace Stats: reads statistics (evidence: `src/rest/admin.routes.js`)
- Admin Routes → JWT and Guards: checks roles (evidence: `src/rest/admin.routes.js`)
- Product Routes → JWT and Guards: checks roles (evidence: `src/rest/products.routes.js`)
- Booking Routes → JWT and Guards: checks identity (evidence: `src/rest/bookings.routes.js`)
- GraphQL Resolvers → Product Catalog: calls catalog (evidence: `src/graphql/resolvers.js`)
- GraphQL Resolvers → Slot Booking: calls booking (evidence: `src/graphql/resolvers.js`)
- GraphQL Resolvers → JWT and Guards: issues tokens (evidence: `src/graphql/resolvers.js`)
- GraphQL Resolvers → GraphQL DataLoaders: loads relations (evidence: `src/graphql/resolvers.js`)
- Product Catalog → SQLite Database: reads and writes (evidence: `src/services/products.js`)
- Slot Booking → SQLite Database: reads and writes (evidence: `src/services/bookings.js`)
- Marketplace Stats → SQLite Database: queries stats (evidence: `src/services/stats.js`)
- GraphQL DataLoaders → SQLite Database: batches reads (evidence: `src/graphql/loaders.js`)
- Product Catalog → Cursor Pagination: encodes cursors (evidence: `src/services/products.js`)
- Product Catalog → Geospatial Utilities: computes proximity (evidence: `src/services/products.js`)
- GraphQL Resolvers → Geospatial Utilities: formats locations (evidence: `src/graphql/resolvers.js`)
- REST Router → Error Handling: handles failures
