How athilingam3336-dotcom/cloudcrackerfinalyearproject works
Meera Crackers is a fireworks e-commerce application with a React Native/Expo client and FastAPI backend. The customer journey spans discovery, cart and wishlist management, checkout/payment, and post-purchase reviews; administration covers catalog, orders, inventory, users, and reports. The backend separates HTTP routes, services, repositories, and MongoDB documents. Source evidence is partial: several capabilities are visible in the route tree and router registration, but their internal calls and most client-to-API wiring were not sampled, so those relationships are omitted or marked unverified.
Main entry points: router.py API v1 router · navigation Navigation · main.py FastAPI runtime · admin Administration routes
Components 28
Customer app
- Mobile/web app
frontend/App.tsx - Navigation
frontend/src/navigation - Authentication screens
frontend/src/screens/Authentication - Shopping screens
frontend/src/screens/Home - Cart and checkout
frontend/src/screens/Checkout - Account screens
frontend/src/screens/Profile - Admin screens
frontend/src/screens/Admin
Backend API
- FastAPI runtime
backend/app/main.py - API v1 router
backend/app/api/v1/router.py - Authentication routes
backend/app/api/v1/auth/auth.py - Catalog routes
backend/app/api/v1/products - Cart and order routes
backend/app/api/v1/orders - Payment routes
backend/app/api/v1/payment - Customer routes
backend/app/api/v1/reviews - Administration routes
backend/app/api/v1/admin
Commerce services
- Authentication service
backend/app/services/auth_service.py - Review service
backend/app/services/review_service.py - Dashboard and reports
backend/app/services/dashboard_service.py - Email delivery
backend/app/services/email_service.py - Commerce services
backend/app/services
Persistence and runtime
- Repositories
backend/app/repositories - Commerce documents
backend/app/models - MongoDB
backend/app/core/database.py - Runtime configuration
backend/app/core/config.py - Error handling
backend/app/exceptions/handlers.py
Other components
- Shopper
- Instagram OAuth
- Email provider
Connections 31
- Shopper → Mobile/web app: uses
- Mobile/web app → Navigation: renders
frontend/App.tsx - Navigation → Authentication screens: routes to
- Navigation → Shopping screens: routes to
- Navigation → Cart and checkout: routes to
- Navigation → Account screens: routes to
- Navigation → Admin screens: routes to
- Mobile/web app → FastAPI runtime: calls API
- FastAPI runtime → API v1 router: mounts
backend/app/main.py - FastAPI runtime → MongoDB: connects
backend/app/main.py - FastAPI runtime → Error handling: registers
backend/app/main.py - FastAPI runtime → Administration routes: dispatches scheduled report
backend/app/main.py - API v1 router → Authentication routes: registers
backend/app/api/v1/router.py - API v1 router → Catalog routes: registers
backend/app/api/v1/router.py - API v1 router → Cart and order routes: registers
backend/app/api/v1/router.py - API v1 router → Payment routes: registers
backend/app/api/v1/router.py - API v1 router → Customer routes: registers
backend/app/api/v1/router.py - API v1 router → Administration routes: registers
backend/app/api/v1/router.py - Authentication routes → Authentication service: uses
backend/app/api/v1/auth/auth.py - Authentication service → Instagram OAuth: exchanges OAuth
backend/app/services/auth_service.py - Customer routes → Review service: uses
backend/app/api/v1/reviews/reviews.py - Review service → Repositories: uses review and product repositories
backend/app/services/review_service.py - Review service → Commerce documents: checks purchases
backend/app/services/review_service.py - Administration routes → Dashboard and reports: uses reports
backend/app/api/v1/admin/reports.py - Administration routes → Email delivery: sends reports
backend/app/api/v1/admin/reports.py - Dashboard and reports → Email delivery: composes report email
- Email delivery → Email provider: delivers email
- MongoDB → Commerce documents: initializes models
backend/app/core/database.py - Commerce services → Repositories: persists domain data
backend/app/services/review_service.py - Repositories → Commerce documents: reads and writes
backend/app/repositories/review_repository.py - FastAPI runtime → Runtime configuration: loads configuration
backend/app/main.py