# athilingam3336-dotcom/cloudcrackerfinalyearproject architecture

> Architecture diagram of the GitHub repository athilingam3336-dotcom/cloudcrackerfinalyearproject, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/athilingam3336-dotcom/cloudcrackerfinalyearproject
- Repository: https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject

## Overview

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: [`backend/app/api/v1/router.py`](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/api/v1/router.py) (API v1 router), [`frontend/src/navigation`](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/navigation) (Navigation), [`backend/app/main.py`](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/main.py) (FastAPI runtime), [`backend/app/api/v1/admin`](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/admin) (Administration routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Customer app"]
  node_app["Mobile/web app<br/>[App.tsx]"]
  node_navigation["Navigation"]
  node_auth_screen["Authentication screens"]
  node_shop_screens["Shopping screens"]
  node_checkout_screens["Cart and checkout"]
  node_profile_screens["Account screens"]
  node_admin_screens["Admin screens"]
end

subgraph group_api["Backend API"]
  node_api_entry["FastAPI runtime<br/>[main.py]"]
  node_api_router["API v1 router<br/>[router.py]"]
  node_auth_routes["Authentication routes<br/>[auth.py]"]
  node_catalog_routes["Catalog routes"]
  node_cart_order_routes["Cart and order routes"]
  node_payment_routes["Payment routes"]
  node_customer_routes["Customer routes"]
  node_admin_routes["Administration routes"]
end

subgraph group_domain["Commerce services"]
  node_auth_service["Authentication service<br/>[auth_service.py]"]
  node_review_service["Review service<br/>[review_service.py]"]
  node_dashboard_service["Dashboard and reports"]
  node_email_service["Email delivery<br/>[email_service.py]"]
  node_commerce_services["Commerce services"]
end

subgraph group_data["Persistence and runtime"]
  node_repositories["Repositories"]
  node_documents["Commerce documents"]
  node_database[("MongoDB<br/>[database.py]")]
  node_settings["Runtime configuration<br/>[config.py]"]
  node_error_handlers["Error handling<br/>[handlers.py]"]
end

node_shopper(("Shopper"))
node_instagram["Instagram OAuth"]
node_email_provider["Email provider"]

node_shopper -.->|"uses"| node_app
node_app -->|"renders"| node_navigation
node_navigation -.->|"routes to"| node_auth_screen
node_navigation -.->|"routes to"| node_shop_screens
node_navigation -.->|"routes to"| node_checkout_screens
node_navigation -.->|"routes to"| node_profile_screens
node_navigation -.->|"routes to"| node_admin_screens
node_app -.->|"calls API"| node_api_entry
node_api_entry -->|"mounts"| node_api_router
node_api_entry -->|"connects"| node_database
node_api_entry -->|"registers"| node_error_handlers
node_api_entry -->|"dispatches scheduled report"| node_admin_routes
node_api_router -->|"registers"| node_auth_routes
node_api_router -->|"registers"| node_catalog_routes
node_api_router -->|"registers"| node_cart_order_routes
node_api_router -->|"registers"| node_payment_routes
node_api_router -->|"registers"| node_customer_routes
node_api_router -->|"registers"| node_admin_routes
node_auth_routes -->|"uses"| node_auth_service
node_auth_service -->|"exchanges OAuth"| node_instagram
node_customer_routes -->|"uses"| node_review_service
node_review_service -->|"uses review and product repositories"| node_repositories
node_review_service -->|"checks purchases"| node_documents
node_admin_routes -->|"uses reports"| node_dashboard_service
node_admin_routes -->|"sends reports"| node_email_service
node_dashboard_service -.->|"composes report email"| node_email_service
node_email_service -.->|"delivers email"| node_email_provider
node_database -->|"initializes models"| node_documents
node_commerce_services -.->|"persists domain data"| node_repositories
node_repositories -.->|"reads and writes"| node_documents
node_api_entry -->|"loads configuration"| node_settings

click node_app "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/frontend/App.tsx"
click node_navigation "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/navigation"
click node_auth_screen "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Authentication"
click node_shop_screens "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Home"
click node_checkout_screens "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Checkout"
click node_profile_screens "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Profile"
click node_admin_screens "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Admin"
click node_api_entry "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/main.py"
click node_api_router "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/api/v1/router.py"
click node_auth_routes "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/api/v1/auth/auth.py"
click node_catalog_routes "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/products"
click node_cart_order_routes "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/orders"
click node_payment_routes "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/payment"
click node_customer_routes "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/reviews"
click node_admin_routes "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/admin"
click node_auth_service "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/services/auth_service.py"
click node_review_service "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/services/review_service.py"
click node_dashboard_service "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/services/dashboard_service.py"
click node_email_service "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/services/email_service.py"
click node_commerce_services "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/services"
click node_repositories "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/repositories"
click node_documents "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/models"
click node_database "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/core/database.py"
click node_settings "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/core/config.py"
click node_error_handlers "https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/exceptions/handlers.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_navigation,node_auth_screen,node_shop_screens,node_checkout_screens,node_profile_screens,node_admin_screens toneBlue
class node_api_entry,node_api_router,node_auth_routes,node_catalog_routes,node_cart_order_routes,node_payment_routes,node_customer_routes,node_admin_routes toneAmber
class node_auth_service,node_review_service,node_dashboard_service,node_email_service,node_commerce_services toneMint
class node_repositories,node_documents,node_database,node_settings,node_error_handlers toneRose
class node_shopper,node_instagram,node_email_provider toneIndigo
```

## Components

### Customer app

- [Mobile/web app](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/frontend/App.tsx): `frontend/App.tsx`
- [Navigation](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/navigation): `frontend/src/navigation`
- [Authentication screens](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Authentication): `frontend/src/screens/Authentication`
- [Shopping screens](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Home): `frontend/src/screens/Home`
- [Cart and checkout](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Checkout): `frontend/src/screens/Checkout`
- [Account screens](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Profile): `frontend/src/screens/Profile`
- [Admin screens](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/frontend/src/screens/Admin): `frontend/src/screens/Admin`

### Backend API

- [FastAPI runtime](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/main.py): `backend/app/main.py`
- [API v1 router](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/api/v1/router.py): `backend/app/api/v1/router.py`
- [Authentication routes](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/api/v1/auth/auth.py): `backend/app/api/v1/auth/auth.py`
- [Catalog routes](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/products): `backend/app/api/v1/products`
- [Cart and order routes](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/orders): `backend/app/api/v1/orders`
- [Payment routes](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/payment): `backend/app/api/v1/payment`
- [Customer routes](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/reviews): `backend/app/api/v1/reviews`
- [Administration routes](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/api/v1/admin): `backend/app/api/v1/admin`

### Commerce services

- [Authentication service](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/services/auth_service.py): `backend/app/services/auth_service.py`
- [Review service](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/services/review_service.py): `backend/app/services/review_service.py`
- [Dashboard and reports](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/services/dashboard_service.py): `backend/app/services/dashboard_service.py`
- [Email delivery](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/services/email_service.py): `backend/app/services/email_service.py`
- [Commerce services](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/services): `backend/app/services`

### Persistence and runtime

- [Repositories](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/repositories): `backend/app/repositories`
- [Commerce documents](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/tree/main/backend/app/models): `backend/app/models`
- [MongoDB](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Runtime configuration](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/core/config.py): `backend/app/core/config.py`
- [Error handling](https://github.com/athilingam3336-dotcom/cloudcrackerfinalyearproject/blob/main/backend/app/exceptions/handlers.py): `backend/app/exceptions/handlers.py`

### Other components

- **Shopper**
- **Instagram OAuth**
- **Email provider**

## Connections

- Shopper → Mobile/web app: uses
- Mobile/web app → Navigation: renders (evidence: `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 (evidence: `backend/app/main.py`)
- FastAPI runtime → MongoDB: connects (evidence: `backend/app/main.py`)
- FastAPI runtime → Error handling: registers (evidence: `backend/app/main.py`)
- FastAPI runtime → Administration routes: dispatches scheduled report (evidence: `backend/app/main.py`)
- API v1 router → Authentication routes: registers (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Catalog routes: registers (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Cart and order routes: registers (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Payment routes: registers (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Customer routes: registers (evidence: `backend/app/api/v1/router.py`)
- API v1 router → Administration routes: registers (evidence: `backend/app/api/v1/router.py`)
- Authentication routes → Authentication service: uses (evidence: `backend/app/api/v1/auth/auth.py`)
- Authentication service → Instagram OAuth: exchanges OAuth (evidence: `backend/app/services/auth_service.py`)
- Customer routes → Review service: uses (evidence: `backend/app/api/v1/reviews/reviews.py`)
- Review service → Repositories: uses review and product repositories (evidence: `backend/app/services/review_service.py`)
- Review service → Commerce documents: checks purchases (evidence: `backend/app/services/review_service.py`)
- Administration routes → Dashboard and reports: uses reports (evidence: `backend/app/api/v1/admin/reports.py`)
- Administration routes → Email delivery: sends reports (evidence: `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 (evidence: `backend/app/core/database.py`)
- Commerce services → Repositories: persists domain data (evidence: `backend/app/services/review_service.py`)
- Repositories → Commerce documents: reads and writes (evidence: `backend/app/repositories/review_repository.py`)
- FastAPI runtime → Runtime configuration: loads configuration (evidence: `backend/app/main.py`)
