How laoluafolami/netiks_store_wk4 works
Netiks Store is a multi-service marketplace: shoppers browse products and submit demo-card orders, while sellers authenticate, create stores and categories, publish products and images, and review orders. The web app routes user actions through its server-side handlers or API proxy to the gateway, which dispatches to identity, vendor, catalog, and media services. Catalog, identity, and vendor services have database-backed persistence; media handles uploaded files. The README excerpt describes deployment staging, not product behavior, so it does not establish runtime product links. Service internals beyond sampled routes are represented only where the tree supports them.
Main entry points: main.py Gateway router · app Storefront pages · route.ts Checkout action · page.tsx Seller studio
Components 24
Web experience
- Storefront pages
apps/web/src/app - Seller studio
apps/web/src/app/studio/page.tsx - Vendor dashboard
apps/web/src/app/dashboard/page.tsx - Auth actions
apps/web/src/app/auth/actions/[action]/route.ts - Studio actions
apps/web/src/app/studio/actions/[action]/route.ts - Dashboard actions
apps/web/src/app/dashboard/actions/[action]/route.ts - Checkout action
apps/web/src/app/checkout/actions/route.ts - API proxy
apps/web/src/app/api/[...path]/route.ts
API gateway
- Gateway router
apps/gateway/app/main.py - Auth routes
apps/gateway/app/routes/auth.py - Store routes
apps/gateway/app/routes/stores.py - Catalog routes
apps/gateway/app/routes/catalog.py - Upload routes
apps/gateway/app/routes/uploads.py
Marketplace services
- Identity service
services/identity-service/app/routes.py - Vendor service
services/vendor-service/app/routes.py - Catalog service
services/catalog-service/app/routes.py - Media service
services/media-service/app/main.py - Admin service
services/admin-service/app/main.py
Persistence and media
- Identity database
services/identity-service/app/database.py - Vendor database
services/vendor-service/app/database.py - Catalog database
services/catalog-service/app/database.py - Uploaded media
services/media-service/app/service.py
Other components
- Shopper
- Seller
Connections 25
- Shopper → Storefront pages: browses
- Storefront pages → Checkout action: submits order
- Checkout action → API proxy: posts checkout
- Seller → Storefront pages: uses account
- Seller → Seller studio: manages shop
- Seller → Vendor dashboard: manages listings
- Seller studio → Studio actions: submits actions
- Vendor dashboard → Dashboard actions: submits actions
- Storefront pages → Auth actions: authenticates
- Studio actions → Gateway router: calls API
- Dashboard actions → Gateway router: calls API
- Checkout action → Gateway router: posts order
- API proxy → Gateway router: forwards requests
- Gateway router → Auth routes: dispatches auth
- Gateway router → Store routes: dispatches stores
- Gateway router → Catalog routes: dispatches catalog
- Gateway router → Upload routes: dispatches uploads
- Auth routes → Identity service: forwards auth
- Store routes → Vendor service: forwards stores
- Catalog routes → Catalog service: forwards catalog
- Upload routes → Media service: forwards uploads
- Identity service → Identity database: reads/writes
- Vendor service → Vendor database: reads/writes
- Catalog service → Catalog database: reads/writes
- Media service → Uploaded media: saves/resolves