# verstappenrb18/viet-motor-parts architecture

> Architecture diagram of the GitHub repository verstappenrb18/viet-motor-parts, 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/verstappenrb18/viet-motor-parts
- Repository: https://github.com/verstappenrb18/viet-motor-parts

## Overview

Viet Motor Parts is a motorcycle-parts commerce application with customer shopping, product/vehicle compatibility checking, checkout and order tracking, plus administrative catalog and order management. The graph includes these distinct domain areas and the loan calculator. Source excerpts support the calculator, product-detail, order-detail, invoice-email, and database-seeding relationships shown; other API and page wiring is not asserted where the sampled source does not establish it.

Main entry points: [`viet-motor-parts/app/seed/route.ts`](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/seed/route.ts) (Database Seed), [`viet-motor-parts/app/(default)/orders/[id]/page.tsx`](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/%5Bid%5D/page.tsx) (Order Tracking), [`viet-motor-parts/app/(default)/products/page.tsx`](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/products/page.tsx) (Product Catalog), [`viet-motor-parts/app/(default)/products/[id]/page.tsx`](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/products/%5Bid%5D/page.tsx) (Product Detail)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_storefront["Storefront Pages<br/>[page.tsx]"]
  node_product_catalog["Product Catalog<br/>[page.tsx]"]
  node_product_detail["Product Detail<br/>[page.tsx]"]
  node_compatibility["Compatibility Check"]
  node_calculator_ui["Loan Calculator UI"]
  node_loan_calculation["Loan Calculation<br/>[calculation.ts]"]
end

subgraph group_commerce["Cart And Checkout"]
  node_cart["Shopping Cart"]
  node_checkout["Checkout<br/>[checkoutPage.tsx]"]
  node_paypal["PayPal Checkout<br/>[page.tsx]"]
  node_orders["Order Tracking<br/>[page.tsx]"]
  node_order_lookup["Order Lookup<br/>[fetchOrderbyID.ts]"]
end

subgraph group_operations["Catalog And Orders"]
  node_order_admin["Order Administration<br/>[fetchOrders.ts]"]
  node_order_status["Status Controls"]
  node_categories["Category Management<br/>[fetchCategories.ts]"]
  node_vehicles["Vehicle Management<br/>[fetchVehicles.ts]"]
  node_product_admin["Product Management<br/>[createProducts.ts]"]
end

subgraph group_services["Application Services"]
  node_paypal_service["PayPal API<br/>[route.js]"]
  node_invoice_api["Invoice Email API<br/>[route.js]"]
  node_email_template["Invoice Email Template<br/>[generateEmail.ts]"]
end

subgraph group_data["Persistence"]
  node_database_connection["Database Connection<br/>[db.ts]"]
  node_category_model["Category Model<br/>[category.ts]"]
  node_vehicle_model["Compatible Vehicle Model"]
  node_product_model["Product Model<br/>[product.ts]"]
  node_order_model["Order Model<br/>[order.ts]"]
  node_invoice_model["Invoice Model<br/>[invoice.ts]"]
  node_user_model["User Model<br/>[users.ts]"]
  node_viet_motor_parts_seed["Database Seed<br/>[route.ts]"]
end

node_customer(("Shopper"))
node_admin(("Administrator"))
node_mongo[("MongoDB")]

node_customer -->|"browses"| node_storefront
node_admin -->|"manages catalog"| node_product_admin
node_admin -->|"manages orders"| node_order_admin
node_product_catalog -->|"loads categories"| node_categories
node_product_catalog -.->|"opens product"| node_product_detail
node_product_detail -->|"renders"| node_compatibility
node_calculator_ui -->|"calculates"| node_loan_calculation
node_customer -.->|"adds items"| node_cart
node_cart -.->|"continues to"| node_checkout
node_checkout -.->|"selects payment"| node_paypal
node_paypal -.->|"uses payment API"| node_paypal_service
node_customer -.->|"tracks order"| node_orders
node_orders -->|"fetches order"| node_order_lookup
node_orders -->|"renders controls"| node_order_status
node_invoice_api -->|"generates email"| node_email_template
node_database_connection -->|"connects to"| node_mongo
node_viet_motor_parts_seed -->|"connects"| node_database_connection
node_viet_motor_parts_seed -->|"seeds categories"| node_category_model
node_viet_motor_parts_seed -->|"seeds vehicles"| node_vehicle_model
node_viet_motor_parts_seed -->|"seeds products"| node_product_model
node_viet_motor_parts_seed -->|"seeds orders"| node_order_model
node_viet_motor_parts_seed -->|"references invoices"| node_invoice_model
node_viet_motor_parts_seed -->|"references users"| node_user_model

click node_storefront "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/page.tsx"
click node_product_catalog "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/products/page.tsx"
click node_product_detail "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/products/%5Bid%5D/page.tsx"
click node_compatibility "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/components/CompatibilityCheckPage.tsx"
click node_calculator_ui "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/calculator/clientComponent.tsx"
click node_loan_calculation "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/calculator/calculation.ts"
click node_cart "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/cart/useShoppingCart.tsx"
click node_checkout "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/checkout/checkoutPage.tsx"
click node_paypal "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/checkout/paypal/page.tsx"
click node_paypal_service "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/api/paypal/createOrder/route.js"
click node_orders "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/%5Bid%5D/page.tsx"
click node_order_lookup "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/%5Bid%5D/fetchOrderbyID.ts"
click node_order_admin "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/admin/fetchOrders.ts"
click node_order_status "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/%5Bid%5D/changeOrderStatusModal.tsx"
click node_categories "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/categories/fetchCategories.ts"
click node_vehicles "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/vehicles/fetchVehicles.ts"
click node_product_admin "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/products/add/createProducts.ts"
click node_invoice_api "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/api/sendInvoice/route.js"
click node_email_template "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/api/sendInvoice/generateEmail.ts"
click node_database_connection "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/db.ts"
click node_category_model "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/category.ts"
click node_vehicle_model "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/compatiblevehicle.ts"
click node_product_model "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/product.ts"
click node_order_model "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/order.ts"
click node_invoice_model "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/invoice.ts"
click node_user_model "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/users.ts"
click node_viet_motor_parts_seed "https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/seed/route.ts"

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,node_product_catalog,node_product_detail,node_compatibility,node_calculator_ui,node_loan_calculation toneBlue
class node_cart,node_checkout,node_paypal,node_orders,node_order_lookup,node_mongo toneAmber
class node_order_admin,node_order_status,node_categories,node_vehicles,node_product_admin toneMint
class node_paypal_service,node_invoice_api,node_email_template toneRose
class node_database_connection,node_category_model,node_vehicle_model,node_product_model,node_order_model,node_invoice_model,node_user_model,node_viet_motor_parts_seed,node_customer,node_admin toneIndigo
```

## Components

### Storefront

- [Storefront Pages](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/page.tsx): `viet-motor-parts/app/(default)/page.tsx`
- [Product Catalog](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/products/page.tsx): `viet-motor-parts/app/(default)/products/page.tsx`
- [Product Detail](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/products/%5Bid%5D/page.tsx): `viet-motor-parts/app/(default)/products/[id]/page.tsx`
- [Compatibility Check](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/components/CompatibilityCheckPage.tsx): `viet-motor-parts/app/components/CompatibilityCheckPage.tsx`
- [Loan Calculator UI](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/calculator/clientComponent.tsx): `viet-motor-parts/app/(default)/calculator/clientComponent.tsx`
- [Loan Calculation](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/calculator/calculation.ts): `viet-motor-parts/app/(default)/calculator/calculation.ts`

### Cart And Checkout

- [Shopping Cart](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/cart/useShoppingCart.tsx): `viet-motor-parts/app/(default)/cart/useShoppingCart.tsx`
- [Checkout](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/checkout/checkoutPage.tsx): `viet-motor-parts/app/(default)/checkout/checkoutPage.tsx`
- [PayPal Checkout](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/checkout/paypal/page.tsx): `viet-motor-parts/app/(default)/checkout/paypal/page.tsx`
- [Order Tracking](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/%5Bid%5D/page.tsx): `viet-motor-parts/app/(default)/orders/[id]/page.tsx`
- [Order Lookup](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/%5Bid%5D/fetchOrderbyID.ts): `viet-motor-parts/app/(default)/orders/[id]/fetchOrderbyID.ts`

### Catalog And Orders

- [Order Administration](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/admin/fetchOrders.ts): `viet-motor-parts/app/(default)/orders/admin/fetchOrders.ts`
- [Status Controls](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/orders/%5Bid%5D/changeOrderStatusModal.tsx): `viet-motor-parts/app/(default)/orders/[id]/changeOrderStatusModal.tsx`
- [Category Management](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/categories/fetchCategories.ts): `viet-motor-parts/app/(default)/categories/fetchCategories.ts`
- [Vehicle Management](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/vehicles/fetchVehicles.ts): `viet-motor-parts/app/(default)/vehicles/fetchVehicles.ts`
- [Product Management](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/(default)/products/add/createProducts.ts): `viet-motor-parts/app/(default)/products/add/createProducts.ts`

### Application Services

- [PayPal API](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/api/paypal/createOrder/route.js): `viet-motor-parts/app/api/paypal/createOrder/route.js`
- [Invoice Email API](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/api/sendInvoice/route.js): `viet-motor-parts/app/api/sendInvoice/route.js`
- [Invoice Email Template](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/api/sendInvoice/generateEmail.ts): `viet-motor-parts/app/api/sendInvoice/generateEmail.ts`

### Persistence

- [Database Connection](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/db.ts): `viet-motor-parts/app/lib/db.ts`
- [Category Model](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/category.ts): `viet-motor-parts/app/lib/models/category.ts`
- [Compatible Vehicle Model](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/compatiblevehicle.ts): `viet-motor-parts/app/lib/models/compatiblevehicle.ts`
- [Product Model](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/product.ts): `viet-motor-parts/app/lib/models/product.ts`
- [Order Model](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/order.ts): `viet-motor-parts/app/lib/models/order.ts`
- [Invoice Model](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/invoice.ts): `viet-motor-parts/app/lib/models/invoice.ts`
- [User Model](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/lib/models/users.ts): `viet-motor-parts/app/lib/models/users.ts`
- [Database Seed](https://github.com/verstappenrb18/viet-motor-parts/blob/main/viet-motor-parts/app/seed/route.ts): `viet-motor-parts/app/seed/route.ts`

### Other components

- **Shopper**
- **Administrator**
- **MongoDB**

## Connections

- Shopper → Storefront Pages: browses
- Administrator → Product Management: manages catalog
- Administrator → Order Administration: manages orders
- Product Catalog → Category Management: loads categories (evidence: `viet-motor-parts/app/(default)/products/page.tsx`)
- Product Catalog → Product Detail: opens product
- Product Detail → Compatibility Check: renders (evidence: `viet-motor-parts/app/(default)/products/[id]/page.tsx`)
- Loan Calculator UI → Loan Calculation: calculates (evidence: `viet-motor-parts/app/(default)/calculator/clientComponent.tsx`)
- Shopper → Shopping Cart: adds items
- Shopping Cart → Checkout: continues to
- Checkout → PayPal Checkout: selects payment
- PayPal Checkout → PayPal API: uses payment API
- Shopper → Order Tracking: tracks order
- Order Tracking → Order Lookup: fetches order (evidence: `viet-motor-parts/app/(default)/orders/[id]/page.tsx`)
- Order Tracking → Status Controls: renders controls (evidence: `viet-motor-parts/app/(default)/orders/[id]/page.tsx`)
- Invoice Email API → Invoice Email Template: generates email (evidence: `viet-motor-parts/app/api/sendInvoice/route.js`)
- Database Connection → MongoDB: connects to (evidence: `viet-motor-parts/app/lib/db.ts`)
- Database Seed → Database Connection: connects (evidence: `viet-motor-parts/app/seed/route.ts`)
- Database Seed → Category Model: seeds categories (evidence: `viet-motor-parts/app/seed/route.ts`)
- Database Seed → Compatible Vehicle Model: seeds vehicles (evidence: `viet-motor-parts/app/seed/route.ts`)
- Database Seed → Product Model: seeds products (evidence: `viet-motor-parts/app/seed/route.ts`)
- Database Seed → Order Model: seeds orders (evidence: `viet-motor-parts/app/seed/route.ts`)
- Database Seed → Invoice Model: references invoices (evidence: `viet-motor-parts/app/seed/route.ts`)
- Database Seed → User Model: references users (evidence: `viet-motor-parts/app/seed/route.ts`)
