How abdulbosidcoder/sanad works
Sanad is a multilingual, multi-vendor marketplace with buyer, seller, administration, and support capabilities. The visible buyer and seller pages are currently lightweight landing/dashboard shells; the documented backend is a FastAPI modular monolith exposing the domain modules. The admin system map fetches health and module metadata. Module-level business interactions and most domain implementations were not sampled, so domain nodes are preserved from the source tree but their internal call relationships are omitted.
Main entry points: __init__.py Module registry · main.py FastAPI application · page.tsx Admin console · system.py System status API
Components 34
Marketplace experiences
- Buyer storefront
frontend/apps/web/app/page.tsx - Seller dashboard
frontend/apps/seller/app/page.tsx - Admin console
frontend/apps/admin/app/page.tsx - System overview
frontend/apps/admin/app/system-overview.tsx
API and runtime
- FastAPI application
backend/app/main.py - Module registry
backend/app/modules/__init__.py - System status API
backend/app/system.py - Request context
backend/app/core/context.py - Structured logging
backend/app/core/logging.py - Request middleware
backend/app/core/middleware.py - Error handling
backend/app/core/errors.py - SQL database
backend/app/core/db.py - Redis
backend/app/core/redis.py
Commerce domains
- Stores
backend/app/modules/stores - Media
backend/app/modules/media - Catalog
backend/app/modules/catalog - Inventory
backend/app/modules/inventory - Search
backend/app/modules/search - Cart
backend/app/modules/cart - Payments
backend/app/modules/payments - Orders
backend/app/modules/orders - Reviews
backend/app/modules/reviews - Engagement
backend/app/modules/engagement - Recommendations
backend/app/modules/recommendations
Platform capabilities
Shared frontend packages
- API client
frontend/packages/api-client/src/index.ts - Localization
frontend/packages/i18n/src/index.ts - UI and theme
frontend/packages/ui/src/components/Button.tsx - Design tokens
frontend/packages/ui/src/tokens.ts
Other components
- Buyer
- Seller
- Administrator
Connections 38
- Buyer → Buyer storefront: browses
README.md - Seller → Seller dashboard: manages store
README.md - Administrator → Admin console: administers
README.md - Admin console → System overview: renders
frontend/apps/admin/app/page.tsx - Admin console → Localization: translates UI
frontend/apps/admin/app/page.tsx - Buyer storefront → Localization: translates UI
frontend/apps/web/app/page.tsx - Seller dashboard → Localization: translates UI
frontend/apps/seller/app/page.tsx - System overview → API client: fetches health and modules
frontend/apps/admin/app/system-overview.tsx - System overview → FastAPI application: requests system map
README.md - Buyer storefront → UI and theme: renders components
frontend/apps/web/app/page.tsx - Seller dashboard → UI and theme: renders components
frontend/apps/seller/app/page.tsx - Admin console → UI and theme: renders components
frontend/apps/admin/app/page.tsx - UI and theme → Design tokens: uses tokens
- FastAPI application → Module registry: mounts module routers
backend/app/main.py - FastAPI application → System status API: mounts system router
backend/app/main.py - Module registry → Identity: registers
backend/app/modules/__init__.py - Module registry → Stores: registers
backend/app/modules/__init__.py - Module registry → Media: registers
backend/app/modules/__init__.py - Module registry → Catalog: registers
backend/app/modules/__init__.py - Module registry → Inventory: registers
backend/app/modules/__init__.py - Module registry → Search: registers
backend/app/modules/__init__.py - Module registry → Cart: registers
backend/app/modules/__init__.py - Module registry → Payments: registers
backend/app/modules/__init__.py - Module registry → Orders: registers
backend/app/modules/__init__.py - Module registry → Reviews: registers
backend/app/modules/__init__.py - Module registry → Engagement: registers
backend/app/modules/__init__.py - Module registry → Recommendations: registers
backend/app/modules/__init__.py - Module registry → Analytics: registers
backend/app/modules/__init__.py - Module registry → Support: registers
backend/app/modules/__init__.py - System status API → SQL database: checks
backend/app/system.py - System status API → Redis: checks
backend/app/system.py - System status API → Module registry: reports modules
backend/app/system.py - FastAPI application → Request middleware: installs
backend/app/main.py - FastAPI application → Error handling: registers handlers
backend/app/main.py - Request middleware → Request context: sets request context
backend/app/core/middleware.py - Request middleware → Structured logging: logs requests
backend/app/core/middleware.py - Request middleware → Error handling: uses error handling
backend/app/core/middleware.py - Structured logging → Request context: reads context
backend/app/core/logging.py