How fgdiaz-jr/marckedplace-usc works
Marketplace USC is a role-based university marketplace: buyers browse products, manage a cart, check out and follow orders; sellers manage inventory and deliveries, while admins review accounting. The frontend integrates with Supabase and configured REST services, with a documented Supabase fallback. Runtime services cover notifications, delivery tracking, and accounting/escrow; the README also documents orders, payments, inventory, and catalog as external team services, not implementations in this tree. Source excerpts show tracking dispatching notification and escrow calls; other frontend and backend links rely on README statements, so unsampled runtime details are not assumed.
Main entry points: api.js REST and fallback · services.py Delivery lifecycle · auth.js JWT auth · main.py Tracking API
Components 27
Marketplace frontend
- Login and roles
frontend/login.html - JWT auth
frontend/js/auth.js - Product catalog
frontend/catalog.html - Catalog rendering
frontend/js/modules/catalog.js - Cart and tax
frontend/cart.html - Cart state
frontend/js/cart-store.js - Checkout
frontend/checkout.html - Order history
frontend/orders.html - Shipment view
frontend/tracking.html - Seller dashboard
frontend/seller-dashboard.html - Admin accounting
frontend/admin-accounting.html - Notification inbox
frontend/notifications.html - REST and fallback
frontend/js/api.js - Service URLs
frontend/js/config.js
Commerce integrations
- Team services
- Supabase platform
- Marketplace schema
supabase_schema.sql
Delivery tracking
- Tracking API
backend/seguimiento/main.py - Delivery lifecycle
backend/seguimiento/services.py - Tracking database access
backend/seguimiento/database.py
Accounting and escrow
- Accounting API
backend/contabilidad/main.py - Escrow and ledger
backend/contabilidad/services.py - Accounting database access
backend/contabilidad/database.py
Notifications
- Notifications API
backend/notificaciones/main.py - Notification service
backend/notificaciones/services.py - Notification database access
backend/notificaciones/database.py
Other components
- Marketplace user
Connections 31
- Marketplace user → Login and roles: signs in
README.md - Login and roles → JWT auth: uses auth
README.md - JWT auth → Supabase platform: authenticates with
README.md - JWT auth → Product catalog: routes by role
README.md - Product catalog → Catalog rendering: renders products
README.md - Catalog rendering → REST and fallback: loads catalog
- Cart and tax → Cart state: uses cart state
README.md - Cart and tax → Checkout: continues to
README.md - Checkout → REST and fallback: submits requests
README.md - Order history → REST and fallback: loads orders
- Shipment view → REST and fallback: loads tracking
- Seller dashboard → REST and fallback: uses services
- Admin accounting → REST and fallback: loads accounting
- Notification inbox → REST and fallback: loads notices
- REST and fallback → Service URLs: reads endpoints
README.md - REST and fallback → Supabase platform: fallback queries
README.md - Service URLs → Team services: configures endpoints
README.md - Supabase platform → Marketplace schema: hosts schema
README.md - Team services → Tracking API: creates shipment
backend/seguimiento/main.py - Tracking API → Delivery lifecycle: dispatches operations
backend/seguimiento/main.py - Tracking API → Tracking database access: checks health
backend/seguimiento/main.py - Delivery lifecycle → Tracking database access: reads and writes
backend/seguimiento/services.py - Tracking database access → Supabase platform: queries shipments
backend/seguimiento/database.py - Delivery lifecycle → Notifications API: sends notices
backend/seguimiento/services.py - Delivery lifecycle → Accounting API: updates escrow
backend/seguimiento/services.py - Accounting API → Escrow and ledger: dispatches operations
backend/contabilidad/main.py - Escrow and ledger → Accounting database access: reads and writes
backend/contabilidad/services.py - Accounting database access → Supabase platform: queries ledger
- Notifications API → Notification service: dispatches operations
backend/notificaciones/main.py - Notification service → Notification database access: reads and writes
backend/notificaciones/services.py - Notification database access → Supabase platform: queries messages