# vector1703/innovexa_project_1 architecture

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

- Interactive diagram: https://gitdiagram.com/vector1703/innovexa_project_1
- Repository: https://github.com/vector1703/innovexa_project_1

## Overview

Innovexa is a women’s fashion storefront backed by an Express API and MongoDB. The principal customer flow is browsing the catalog, managing a cart, checking out into an order, and optionally completing payment through Stripe or the mock flow. Authentication protects customer and administrative operations; catalog, cart, order, and user data are represented by Mongoose models. The graph includes documented capabilities even where their implementation was not sampled. Relationship evidence is limited to excerpts, SOURCE INDEX references, and README statements; unverified client-to-API wiring is not asserted.

Main entry points: [`backend/routes/index.js`](https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/index.js) (API router), [`backend/middleware/authMiddleware.js`](https://github.com/vector1703/innovexa_project_1/blob/main/backend/middleware/authMiddleware.js) (JWT authorization), [`backend/server.js`](https://github.com/vector1703/innovexa_project_1/blob/main/backend/server.js) (Express server), [`backend/controllers/orderController.js`](https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/orderController.js) (Checkout and orders)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_storefront_ui["Storefront UI<br/>[index.html]"]
  node_frontend_api["API client<br/>[api.js]"]
end

subgraph group_api["API and access"]
  node_server["Express server<br/>[server.js]"]
  node_api_router["API router<br/>[index.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_auth_middleware["JWT authorization<br/>[authMiddleware.js]"]
  node_error_middleware["Error handling<br/>[errorMiddleware.js]"]
  node_product_routes["Catalog routes<br/>[productRoutes.js]"]
  node_cart_routes["Cart routes<br/>[cartRoutes.js]"]
  node_order_routes["Order routes<br/>[orderRoutes.js]"]
  node_payment_routes["Payment routes<br/>[paymentRoutes.js]"]
end

subgraph group_commerce["Commerce operations"]
  node_auth_controller["Account management<br/>[authController.js]"]
  node_token["Token generation<br/>[generateToken.js]"]
  node_product_controller["Catalog management"]
  node_seed["Demo catalog seeding<br/>[seed.js]"]
  node_cart_controller["Cart operations<br/>[cartController.js]"]
  node_order_controller["Checkout and orders<br/>[orderController.js]"]
  node_payment_controller["Payment processing"]
end

subgraph group_data["Persistence"]
  node_user_model[("User records<br/>[User.model.js]")]
  node_product_model[("Product records<br/>[Product.model.js]")]
  node_cart_model[("Cart records<br/>[Cart.model.js]")]
  node_order_model[("Order records<br/>[Order.model.js]")]
  node_db_config["Database connection<br/>[db.js]"]
end

node_shopper(("Shopper"))
node_stripe["Stripe"]
node_mongodb[("MongoDB")]

node_shopper -->|"uses"| node_storefront_ui
node_storefront_ui -->|"served by"| node_server
node_frontend_api -.->|"API requests"| node_server
node_server -->|"mounts API"| node_api_router
node_server -->|"connects through"| node_db_config
node_server -->|"handles errors"| node_error_middleware
node_api_router -->|"registers"| node_auth_routes
node_api_router -->|"registers"| node_product_routes
node_api_router -->|"registers"| node_cart_routes
node_api_router -->|"registers"| node_order_routes
node_api_router -->|"registers"| node_payment_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"protects"| node_auth_middleware
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"generates token"| node_token
node_auth_middleware -->|"loads user"| node_user_model
node_product_routes -->|"dispatches"| node_product_controller
node_product_routes -->|"protects admin"| node_auth_middleware
node_product_controller -->|"queries and updates"| node_product_model
node_seed -->|"seeds records"| node_product_model
node_cart_routes -->|"dispatches"| node_cart_controller
node_cart_routes -->|"requires login"| node_auth_middleware
node_cart_controller -->|"reads and writes"| node_cart_model
node_cart_controller -->|"checks stock"| node_product_model
node_order_routes -->|"dispatches"| node_order_controller
node_order_routes -->|"requires login"| node_auth_middleware
node_order_controller -->|"reads and clears"| node_cart_model
node_order_controller -->|"checks and deducts stock"| node_product_model
node_order_controller -->|"creates and updates"| node_order_model
node_payment_routes -->|"dispatches"| node_payment_controller
node_payment_routes -->|"requires login"| node_auth_middleware
node_payment_controller -->|"updates payment"| node_order_model
node_payment_controller -.->|"charges optionally"| node_stripe
node_db_config -->|"connects"| node_mongodb

click node_storefront_ui "https://github.com/vector1703/innovexa_project_1/blob/main/frontend/index.html"
click node_frontend_api "https://github.com/vector1703/innovexa_project_1/blob/main/frontend/js/api.js"
click node_server "https://github.com/vector1703/innovexa_project_1/blob/main/backend/server.js"
click node_api_router "https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/index.js"
click node_auth_routes "https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/authRoutes.js"
click node_auth_middleware "https://github.com/vector1703/innovexa_project_1/blob/main/backend/middleware/authMiddleware.js"
click node_error_middleware "https://github.com/vector1703/innovexa_project_1/blob/main/backend/middleware/errorMiddleware.js"
click node_auth_controller "https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/authController.js"
click node_token "https://github.com/vector1703/innovexa_project_1/blob/main/backend/utils/generateToken.js"
click node_user_model "https://github.com/vector1703/innovexa_project_1/blob/main/backend/models/User.model.js"
click node_product_routes "https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/productRoutes.js"
click node_product_controller "https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/productController.js"
click node_product_model "https://github.com/vector1703/innovexa_project_1/blob/main/backend/models/Product.model.js"
click node_seed "https://github.com/vector1703/innovexa_project_1/blob/main/backend/scripts/seed.js"
click node_cart_routes "https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/cartRoutes.js"
click node_cart_controller "https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/cartController.js"
click node_cart_model "https://github.com/vector1703/innovexa_project_1/blob/main/backend/models/Cart.model.js"
click node_order_routes "https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/orderRoutes.js"
click node_order_controller "https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/orderController.js"
click node_order_model "https://github.com/vector1703/innovexa_project_1/blob/main/backend/models/Order.model.js"
click node_payment_routes "https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/paymentRoutes.js"
click node_payment_controller "https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/paymentController.js"
click node_db_config "https://github.com/vector1703/innovexa_project_1/blob/main/backend/config/db.js"

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_storefront_ui,node_frontend_api toneBlue
class node_server,node_api_router,node_auth_routes,node_auth_middleware,node_error_middleware,node_product_routes,node_cart_routes,node_order_routes,node_payment_routes,node_mongodb toneAmber
class node_auth_controller,node_token,node_product_controller,node_seed,node_cart_controller,node_order_controller,node_payment_controller toneMint
class node_user_model,node_product_model,node_cart_model,node_order_model,node_db_config toneRose
class node_shopper,node_stripe toneIndigo
```

## Components

### Storefront

- [Storefront UI](https://github.com/vector1703/innovexa_project_1/blob/main/frontend/index.html): `frontend/index.html`
- [API client](https://github.com/vector1703/innovexa_project_1/blob/main/frontend/js/api.js): `frontend/js/api.js`

### API and access

- [Express server](https://github.com/vector1703/innovexa_project_1/blob/main/backend/server.js): `backend/server.js`
- [API router](https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/index.js): `backend/routes/index.js`
- [Authentication routes](https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [JWT authorization](https://github.com/vector1703/innovexa_project_1/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`
- [Error handling](https://github.com/vector1703/innovexa_project_1/blob/main/backend/middleware/errorMiddleware.js): `backend/middleware/errorMiddleware.js`
- [Catalog routes](https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/productRoutes.js): `backend/routes/productRoutes.js`
- [Cart routes](https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/cartRoutes.js): `backend/routes/cartRoutes.js`
- [Order routes](https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/orderRoutes.js): `backend/routes/orderRoutes.js`
- [Payment routes](https://github.com/vector1703/innovexa_project_1/blob/main/backend/routes/paymentRoutes.js): `backend/routes/paymentRoutes.js`

### Commerce operations

- [Account management](https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Token generation](https://github.com/vector1703/innovexa_project_1/blob/main/backend/utils/generateToken.js): `backend/utils/generateToken.js`
- [Catalog management](https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Demo catalog seeding](https://github.com/vector1703/innovexa_project_1/blob/main/backend/scripts/seed.js): `backend/scripts/seed.js`
- [Cart operations](https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/cartController.js): `backend/controllers/cartController.js`
- [Checkout and orders](https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [Payment processing](https://github.com/vector1703/innovexa_project_1/blob/main/backend/controllers/paymentController.js): `backend/controllers/paymentController.js`

### Persistence

- [User records](https://github.com/vector1703/innovexa_project_1/blob/main/backend/models/User.model.js): `backend/models/User.model.js`
- [Product records](https://github.com/vector1703/innovexa_project_1/blob/main/backend/models/Product.model.js): `backend/models/Product.model.js`
- [Cart records](https://github.com/vector1703/innovexa_project_1/blob/main/backend/models/Cart.model.js): `backend/models/Cart.model.js`
- [Order records](https://github.com/vector1703/innovexa_project_1/blob/main/backend/models/Order.model.js): `backend/models/Order.model.js`
- [Database connection](https://github.com/vector1703/innovexa_project_1/blob/main/backend/config/db.js): `backend/config/db.js`

### Other components

- **Shopper**
- **Stripe**
- **MongoDB**

## Connections

- Shopper → Storefront UI: uses (evidence: `README.md`)
- Storefront UI → Express server: served by (evidence: `backend/server.js`)
- API client → Express server: API requests
- Express server → API router: mounts API (evidence: `backend/server.js`)
- Express server → Database connection: connects through (evidence: `backend/server.js`)
- Express server → Error handling: handles errors (evidence: `backend/server.js`)
- API router → Authentication routes: registers (evidence: `backend/routes/index.js`)
- API router → Catalog routes: registers (evidence: `backend/routes/index.js`)
- API router → Cart routes: registers (evidence: `backend/routes/index.js`)
- API router → Order routes: registers (evidence: `backend/routes/index.js`)
- API router → Payment routes: registers (evidence: `backend/routes/index.js`)
- Authentication routes → Account management: dispatches (evidence: `backend/routes/authRoutes.js`)
- Authentication routes → JWT authorization: protects (evidence: `backend/routes/authRoutes.js`)
- Account management → User records: reads and writes (evidence: `backend/controllers/authController.js`)
- Account management → Token generation: generates token (evidence: `backend/controllers/authController.js`)
- JWT authorization → User records: loads user (evidence: `backend/middleware/authMiddleware.js`)
- Catalog routes → Catalog management: dispatches (evidence: `backend/routes/productRoutes.js`)
- Catalog routes → JWT authorization: protects admin (evidence: `backend/routes/productRoutes.js`)
- Catalog management → Product records: queries and updates (evidence: `backend/controllers/productController.js`)
- Demo catalog seeding → Product records: seeds records (evidence: `backend/scripts/seed.js`)
- Cart routes → Cart operations: dispatches (evidence: `backend/routes/cartRoutes.js`)
- Cart routes → JWT authorization: requires login (evidence: `backend/routes/cartRoutes.js`)
- Cart operations → Cart records: reads and writes (evidence: `backend/controllers/cartController.js`)
- Cart operations → Product records: checks stock (evidence: `backend/controllers/cartController.js`)
- Order routes → Checkout and orders: dispatches (evidence: `backend/routes/orderRoutes.js`)
- Order routes → JWT authorization: requires login (evidence: `backend/routes/orderRoutes.js`)
- Checkout and orders → Cart records: reads and clears (evidence: `backend/controllers/orderController.js`)
- Checkout and orders → Product records: checks and deducts stock (evidence: `backend/controllers/orderController.js`)
- Checkout and orders → Order records: creates and updates (evidence: `backend/controllers/orderController.js`)
- Payment routes → Payment processing: dispatches (evidence: `backend/routes/paymentRoutes.js`)
- Payment routes → JWT authorization: requires login (evidence: `backend/routes/paymentRoutes.js`)
- Payment processing → Order records: updates payment (evidence: `backend/controllers/paymentController.js`)
- Payment processing → Stripe: charges optionally (evidence: `backend/controllers/paymentController.js`)
- Database connection → MongoDB: connects (evidence: `README.md`)
