How quantum0059/hyper_local_market works
LocalLinc is a hyperlocal marketplace: owners register shops and publish promotions; customers discover nearby sales, inspect offers, and use QR-based redemption, while the platform tracks visits. The map separates the React user journeys, Express routing and domain handlers, and persistence/integrations. The README documents several product capabilities whose frontend or backend implementation was not sampled; those are represented at the subsystem level, without guessing their internal call paths.
Main entry points: App.jsx Route shell · shop.controller.js Shop workflows · sales.controller.js Sale workflows · couponController.js Coupon redemption
Components 29
Customer and owner app
- Route shell
FrontEnd/src/App.jsx - Sign in and signup
FrontEnd/src/pages/LoginPage.jsx - Nearby offers
FrontEnd/src/pages/HomePage.jsx - Sale details
FrontEnd/src/pages/SalesInfo.jsx - Shop details
FrontEnd/src/pages/ShopInfo.jsx - Shop registration
FrontEnd/src/pages/OwnerRegistrationPage.jsx - Sale management
FrontEnd/src/pages/CreateSale.jsx - Shop profile
FrontEnd/src/pages/ShopProfile.jsx - QR redemption scan
FrontEnd/src/Components/QrScanner.jsx - Cart and profile
FrontEnd/src/pages/CartPage.jsx - Shared UI state
FrontEnd/src/Context/ContextProvider.jsx
API and domain workflows
- Express application
BackEnd/src/app.js - Authentication routes
BackEnd/src/routes/route.auth.js - Authentication
BackEnd/src/Controllers/login.controller.js - JWT authorization
BackEnd/src/middleware/auth.middleware.js - Shop routes
BackEnd/src/routes/shopRouter.auth.js - Shop workflows
BackEnd/src/Controllers/shop.controller.js - Sale routes
BackEnd/src/routes/sales.routes.js - Sale workflows
BackEnd/src/Controllers/sales.controller.js - Coupon routes
BackEnd/src/routes/coupon.routes.js - Coupon redemption
BackEnd/src/Controllers/couponController.js
Marketplace data
- User records
BackEnd/src/models/userschema.js - Shop records
BackEnd/src/models/shopschema.js - Sale records
BackEnd/src/models/saleschema.js - Coupon records
BackEnd/src/models/couponschema.js
External services
- Address geocoding
BackEnd/src/utilities/Geocode.js - Image hosting
BackEnd/src/utilities/cloudinary.js - Google OAuth
Other components
- Marketplace user
Connections 39
- Marketplace user → Route shell: uses
FrontEnd/src/App.jsx - Route shell → Sign in and signup: routes to
FrontEnd/src/App.jsx - Route shell → Nearby offers: routes to
FrontEnd/src/App.jsx - Route shell → Sale details: routes to
FrontEnd/src/App.jsx - Route shell → Shop details: routes to
FrontEnd/src/App.jsx - Route shell → Shop registration: routes to
FrontEnd/src/App.jsx - Route shell → Sale management: routes to
FrontEnd/src/App.jsx - Route shell → Shop profile: routes to
FrontEnd/src/App.jsx - Route shell → Cart and profile: routes to
FrontEnd/src/App.jsx - Shared UI state → Route shell: provides UI state
FrontEnd/src/main.jsx - Express application → Authentication routes: mounts
BackEnd/src/app.js - Express application → Shop routes: mounts
BackEnd/src/app.js - Express application → Sale routes: mounts
BackEnd/src/app.js - Express application → Coupon routes: mounts
BackEnd/src/app.js - Authentication routes → Authentication: dispatches to
BackEnd/src/routes/route.auth.js - Shop routes → JWT authorization: checks identity
BackEnd/src/routes/shopRouter.auth.js - Shop routes → Shop workflows: dispatches to
BackEnd/src/routes/shopRouter.auth.js - Sale routes → JWT authorization: checks identity
BackEnd/src/routes/sales.routes.js - Sale routes → Sale workflows: dispatches to
BackEnd/src/routes/sales.routes.js - Coupon routes → JWT authorization: checks identity
BackEnd/src/routes/coupon.routes.js - Coupon routes → Coupon redemption: dispatches to
BackEnd/src/routes/coupon.routes.js - Authentication → User records: reads and writes
BackEnd/src/Controllers/login.controller.js - JWT authorization → User records: loads user
BackEnd/src/middleware/auth.middleware.js - Shop workflows → Shop records: reads and writes
BackEnd/src/Controllers/shop.controller.js - Shop workflows → User records: updates owner
BackEnd/src/Controllers/shop.controller.js - Shop workflows → Sale records: reads sales
BackEnd/src/Controllers/shop.controller.js - Sale workflows → Sale records: reads and writes
BackEnd/src/Controllers/sales.controller.js - Sale workflows → Shop records: queries shops
BackEnd/src/Controllers/sales.controller.js - Sale workflows → User records: reads location
BackEnd/src/Controllers/sales.controller.js - Coupon redemption → Coupon records: uses coupon data
BackEnd/src/Controllers/couponController.js - Coupon redemption → Sale records: checks sale
BackEnd/src/Controllers/couponController.js - Shop workflows → Address geocoding: geocodes address
BackEnd/src/Controllers/shop.controller.js - Shop workflows → Image hosting: uploads images
BackEnd/src/Controllers/shop.controller.js - Authentication → Google OAuth: verifies OAuth
BackEnd/src/Controllers/login.controller.js - Shop profile → QR redemption scan: renders scanner
FrontEnd/src/pages/ShopProfile.jsx - Nearby offers → Sale workflows: requests nearby offers
- Sale management → Shop workflows: submits sale
- Sale details → Coupon redemption: requests redemption QR
- QR redemption scan → Coupon redemption: validates redemption