# alokm74/swadexpress architecture

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

- Interactive diagram: https://gitdiagram.com/alokm74/swadexpress
- Repository: https://github.com/alokm74/swadexpress

## Overview

Swad Express is a full-stack food-ordering application: customers browse restaurants and food, manage carts and orders, and restaurant owners administer their restaurant. The React frontend routes customer and owner experiences and calls a Spring Boot API; the backend handles authentication, restaurant and ingredient operations, with MySQL persistence and Razorpay as a payment integration. The graph emphasizes the principal roles and sampled relationships. Other product capabilities are represented from the source tree and README; unsampled implementation details and their connections are not asserted.

Main entry points: [`frontend/swad-express-frontend/src/Router/CustomerRouter.jsx`](https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/Router/CustomerRouter.jsx) (Customer experience), [`frontend/swad-express-frontend/src/App.jsx`](https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/App.jsx) (App bootstrap), [`SwadExpress/src/main/java/com/swadExpress/controller/AuthController.java`](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AuthController.java) (Authentication API), [`SwadExpress/src/main/java/com/swadExpress/controller/AdminRestaurantController.java`](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AdminRestaurantController.java) (Restaurant management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_app["App bootstrap<br/>[App.jsx]"]
  node_customer_ui["Customer experience<br/>[CustomerRouter.jsx]"]
  node_admin_ui["Owner experience<br/>[AdminRouter.jsx]"]
  node_auth_ui["Authentication UI<br/>[Auth.jsx]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth_api["Authentication API"]
  node_profile_api["User profiles"]
  node_user_details["Security user lookup"]
  node_email_service["Email service<br/>[EmailService.java]"]
  node_email_templates["Email templates"]
end

subgraph group_restaurant["Restaurant operations"]
  node_restaurant_api["Restaurant management"]
  node_food_api["Food catalog"]
  node_ingredient_api["Ingredient inventory"]
  node_events_api["Restaurant events"]
  node_restaurant_service["Restaurant service"]
  node_ingredient_service["Ingredient service"]
  node_food_service["Food service<br/>[FoodService.java]"]
end

subgraph group_commerce["Ordering and payments"]
  node_cart_api["Shopping cart"]
  node_orders_api["Order processing"]
  node_payments_api["Payment checkout"]
end

subgraph group_persistence["Backend persistence"]
  node_mysql[("MySQL database")]
  node_user_repository[("User repository")]
  node_food_repository[("Food repository")]
end

node_customer(("Customer"))
node_owner(("Restaurant owner"))
node_razorpay["Razorpay"]

node_customer -->|"uses"| node_customer_ui
node_owner -->|"uses"| node_admin_ui
node_app -->|"routes"| node_customer_ui
node_app -->|"renders"| node_auth_ui
node_app -->|"loads user"| node_auth_api
node_app -->|"loads cart"| node_cart_api
node_customer_ui -->|"renders"| node_auth_ui
node_admin_ui -->|"requests restaurant"| node_restaurant_api
node_customer_ui -.->|"calls API"| node_restaurant_api
node_customer_ui -.->|"calls API"| node_cart_api
node_customer_ui -.->|"calls API"| node_orders_api
node_customer_ui -.->|"calls API"| node_payments_api
node_auth_api -->|"looks up users"| node_user_repository
node_auth_api -->|"sends email"| node_email_service
node_auth_api -->|"builds email"| node_email_templates
node_profile_api -->|"uses repository"| node_user_repository
node_user_details -->|"finds user"| node_user_repository
node_ingredient_api -->|"checks ownership"| node_restaurant_service
node_ingredient_api -->|"manages inventory"| node_ingredient_service
node_food_service -->|"uses repository"| node_food_repository
node_restaurant_api -.->|"persists data"| node_mysql
node_food_api -.->|"persists data"| node_mysql
node_cart_api -.->|"persists data"| node_mysql
node_orders_api -.->|"persists data"| node_mysql
node_payments_api -.->|"integrates payment"| node_razorpay

click node_app "https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/App.jsx"
click node_customer_ui "https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/Router/CustomerRouter.jsx"
click node_admin_ui "https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/Router/AdminRouter.jsx"
click node_auth_ui "https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/Auth/Auth.jsx"
click node_auth_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AuthController.java"
click node_profile_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/UserController.java"
click node_user_details "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/impl/CustomUserDetailsService.java"
click node_restaurant_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AdminRestaurantController.java"
click node_food_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AdminFoodController.java"
click node_ingredient_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/IngredientController.java"
click node_events_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AdminEventController.java"
click node_cart_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/CartController.java"
click node_orders_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/CustomerOrderController.java"
click node_payments_api "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/RazorpayController.java"
click node_restaurant_service "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/RestaurantService.java"
click node_ingredient_service "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/IngredientService.java"
click node_food_service "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/FoodService.java"
click node_user_repository "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/repository/UserRepository.java"
click node_food_repository "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/repository/FoodRepository.java"
click node_email_service "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/EmailService.java"
click node_email_templates "https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/util/EmailTemplateBuilder.java"

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_customer_ui,node_admin_ui,node_auth_ui toneBlue
class node_auth_api,node_profile_api,node_user_details,node_email_service,node_email_templates toneAmber
class node_restaurant_api,node_food_api,node_ingredient_api,node_events_api,node_restaurant_service,node_ingredient_service,node_food_service toneMint
class node_cart_api,node_orders_api,node_payments_api toneRose
class node_mysql,node_user_repository,node_food_repository,node_customer,node_owner,node_razorpay toneIndigo
```

## Components

### React application

- [App bootstrap](https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/App.jsx): `frontend/swad-express-frontend/src/App.jsx`
- [Customer experience](https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/Router/CustomerRouter.jsx): `frontend/swad-express-frontend/src/Router/CustomerRouter.jsx`
- [Owner experience](https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/Router/AdminRouter.jsx): `frontend/swad-express-frontend/src/Router/AdminRouter.jsx`
- [Authentication UI](https://github.com/alokm74/swadexpress/blob/main/frontend/swad-express-frontend/src/Auth/Auth.jsx): `frontend/swad-express-frontend/src/Auth/Auth.jsx`

### Identity and profiles

- [Authentication API](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AuthController.java): `SwadExpress/src/main/java/com/swadExpress/controller/AuthController.java`
- [User profiles](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/UserController.java): `SwadExpress/src/main/java/com/swadExpress/controller/UserController.java`
- [Security user lookup](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/impl/CustomUserDetailsService.java): `SwadExpress/src/main/java/com/swadExpress/service/impl/CustomUserDetailsService.java`
- [Email service](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/EmailService.java): `SwadExpress/src/main/java/com/swadExpress/service/EmailService.java`
- [Email templates](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/util/EmailTemplateBuilder.java): `SwadExpress/src/main/java/com/swadExpress/util/EmailTemplateBuilder.java`

### Restaurant operations

- [Restaurant management](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AdminRestaurantController.java): `SwadExpress/src/main/java/com/swadExpress/controller/AdminRestaurantController.java`
- [Food catalog](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AdminFoodController.java): `SwadExpress/src/main/java/com/swadExpress/controller/AdminFoodController.java`
- [Ingredient inventory](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/IngredientController.java): `SwadExpress/src/main/java/com/swadExpress/controller/IngredientController.java`
- [Restaurant events](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/AdminEventController.java): `SwadExpress/src/main/java/com/swadExpress/controller/AdminEventController.java`
- [Restaurant service](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/RestaurantService.java): `SwadExpress/src/main/java/com/swadExpress/service/RestaurantService.java`
- [Ingredient service](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/IngredientService.java): `SwadExpress/src/main/java/com/swadExpress/service/IngredientService.java`
- [Food service](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/service/FoodService.java): `SwadExpress/src/main/java/com/swadExpress/service/FoodService.java`

### Ordering and payments

- [Shopping cart](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/CartController.java): `SwadExpress/src/main/java/com/swadExpress/controller/CartController.java`
- [Order processing](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/CustomerOrderController.java): `SwadExpress/src/main/java/com/swadExpress/controller/CustomerOrderController.java`
- [Payment checkout](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/controller/RazorpayController.java): `SwadExpress/src/main/java/com/swadExpress/controller/RazorpayController.java`

### Backend persistence

- **MySQL database**
- [User repository](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/repository/UserRepository.java): `SwadExpress/src/main/java/com/swadExpress/repository/UserRepository.java`
- [Food repository](https://github.com/alokm74/swadexpress/blob/main/SwadExpress/src/main/java/com/swadExpress/repository/FoodRepository.java): `SwadExpress/src/main/java/com/swadExpress/repository/FoodRepository.java`

### Other components

- **Customer**
- **Restaurant owner**
- **Razorpay**

## Connections

- Customer → Customer experience: uses (evidence: `README.md`)
- Restaurant owner → Owner experience: uses (evidence: `README.md`)
- App bootstrap → Customer experience: routes (evidence: `frontend/swad-express-frontend/src/App.jsx`)
- App bootstrap → Authentication UI: renders (evidence: `frontend/swad-express-frontend/src/App.jsx`)
- App bootstrap → Authentication API: loads user (evidence: `frontend/swad-express-frontend/src/App.jsx`)
- App bootstrap → Shopping cart: loads cart (evidence: `frontend/swad-express-frontend/src/App.jsx`)
- Customer experience → Authentication UI: renders (evidence: `frontend/swad-express-frontend/src/Router/CustomerRouter.jsx`)
- Owner experience → Restaurant management: requests restaurant (evidence: `frontend/swad-express-frontend/src/Router/AdminRouter.jsx`)
- Customer experience → Restaurant management: calls API (evidence: `README.md`)
- Customer experience → Shopping cart: calls API (evidence: `README.md`)
- Customer experience → Order processing: calls API (evidence: `README.md`)
- Customer experience → Payment checkout: calls API (evidence: `README.md`)
- Authentication API → User repository: looks up users (evidence: `SwadExpress/src/main/java/com/swadExpress/controller/AuthController.java`)
- Authentication API → Email service: sends email (evidence: `SwadExpress/src/main/java/com/swadExpress/controller/AuthController.java`)
- Authentication API → Email templates: builds email (evidence: `SwadExpress/src/main/java/com/swadExpress/controller/AuthController.java`)
- User profiles → User repository: uses repository (evidence: `SwadExpress/src/main/java/com/swadExpress/controller/UserController.java`)
- Security user lookup → User repository: finds user (evidence: `SwadExpress/src/main/java/com/swadExpress/service/impl/CustomUserDetailsService.java`)
- Ingredient inventory → Restaurant service: checks ownership (evidence: `SwadExpress/src/main/java/com/swadExpress/controller/IngredientController.java`)
- Ingredient inventory → Ingredient service: manages inventory (evidence: `SwadExpress/src/main/java/com/swadExpress/controller/IngredientController.java`)
- Food service → Food repository: uses repository (evidence: `SwadExpress/src/main/java/com/swadExpress/service/FoodService.java`)
- Restaurant management → MySQL database: persists data (evidence: `README.md`)
- Food catalog → MySQL database: persists data (evidence: `README.md`)
- Shopping cart → MySQL database: persists data (evidence: `README.md`)
- Order processing → MySQL database: persists data (evidence: `README.md`)
- Payment checkout → Razorpay: integrates payment (evidence: `README.md`)
