How sap2024-4y/apibp002 works
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: app.js Express App · router.js REST Router · resolvers.js GraphQL Resolvers · middleware.js JWT and Guards
Components 23
Storefront
- React Storefront
frontend/src/App.jsx - Frontend API Client
frontend/src/api.js
API Interfaces
- Express App
src/app.js - REST Router
src/rest/router.js - Product Routes
src/rest/products.routes.js - Booking Routes
src/rest/bookings.routes.js - Auth Routes
src/rest/auth.routes.js - Admin Routes
src/rest/admin.routes.js - GraphQL Resolvers
src/graphql/resolvers.js
Marketplace Domain
- Product Catalog
src/services/products.js - Slot Booking
src/services/bookings.js - Marketplace Stats
src/services/stats.js - Cursor Pagination
src/util/cursor.js - Geospatial Utilities
src/util/geo.js
Identity and Runtime
- JWT and Guards
src/auth/middleware.js - Rate Limiting
src/middleware/rateLimit.js - Error Handling
src/errors.js
Persistence and Docs
- SQLite Database
src/db/client.js - Demo Catalogue Seed
src/db/seed.js - GraphQL DataLoaders
src/graphql/loaders.js - REST API Docs
src/docs/swagger.js
Other components
- Shopper
- Admin
Connections 34
- Shopper → React Storefront: uses
README.md - Admin → Product Routes: manages products
README.md - React Storefront → Frontend API Client: uses
frontend/src/App.jsx - Frontend API Client → Express App: calls API
- Express App → REST Router: mounts REST
src/app.js - Express App → GraphQL Resolvers: configures GraphQL
src/app.js - Express App → JWT and Guards: attaches user
src/app.js - Express App → Rate Limiting: limits requests
src/app.js - Express App → Demo Catalogue Seed: seeds database
src/app.js - Express App → REST API Docs: serves docs
src/app.js - REST Router → Product Routes: mounts routes
src/rest/router.js - REST Router → Booking Routes: mounts routes
src/rest/router.js - REST Router → Auth Routes: mounts routes
src/rest/router.js - REST Router → Admin Routes: mounts routes
src/rest/router.js - Product Routes → Product Catalog: calls catalog
src/rest/products.routes.js - Product Routes → Slot Booking: lists slots
src/rest/products.routes.js - Booking Routes → Slot Booking: calls booking
src/rest/bookings.routes.js - Auth Routes → JWT and Guards: issues tokens
src/rest/auth.routes.js - Admin Routes → Marketplace Stats: reads statistics
src/rest/admin.routes.js - Admin Routes → JWT and Guards: checks roles
src/rest/admin.routes.js - Product Routes → JWT and Guards: checks roles
src/rest/products.routes.js - Booking Routes → JWT and Guards: checks identity
src/rest/bookings.routes.js - GraphQL Resolvers → Product Catalog: calls catalog
src/graphql/resolvers.js - GraphQL Resolvers → Slot Booking: calls booking
src/graphql/resolvers.js - GraphQL Resolvers → JWT and Guards: issues tokens
src/graphql/resolvers.js - GraphQL Resolvers → GraphQL DataLoaders: loads relations
src/graphql/resolvers.js - Product Catalog → SQLite Database: reads and writes
src/services/products.js - Slot Booking → SQLite Database: reads and writes
src/services/bookings.js - Marketplace Stats → SQLite Database: queries stats
src/services/stats.js - GraphQL DataLoaders → SQLite Database: batches reads
src/graphql/loaders.js - Product Catalog → Cursor Pagination: encodes cursors
src/services/products.js - Product Catalog → Geospatial Utilities: computes proximity
src/services/products.js - GraphQL Resolvers → Geospatial Utilities: formats locations
src/graphql/resolvers.js - REST Router → Error Handling: handles failures