# drenzzz/mitra-wiradoor-sumbar architecture

> Architecture diagram of the GitHub repository drenzzz/mitra-wiradoor-sumbar, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/drenzzz/mitra-wiradoor-sumbar
- Repository: https://github.com/drenzzz/mitra-wiradoor-sumbar

## Overview

Wiradoor Sumatera Barat is a company-profile site and e-catalog with guest checkout, customer inquiries, and an admin operations panel. The main transaction runs from browsing and adding products to a guest order saved as PENDING, followed by WhatsApp payment confirmation and admin-managed status updates. The graph also preserves the documented CMS, portfolio, analytics, exports, SEO, and email capabilities. Some subsystem links are based on README descriptions because their implementation files were not sampled; unsampled details are not inferred.

Main entry points: [`src/app/api/orders/route.ts`](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/orders/route.ts) (Order API), [`src/db/index.ts`](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/db/index.ts) (PostgreSQL data), [`src/app/api/reports/route.ts`](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/reports/route.ts) (Reports API), [`src/components/guest/checkout/checkout-form.tsx`](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/components/guest/checkout/checkout-form.tsx) (Checkout form)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Public storefront"]
  node_storefront_pages["Storefront pages<br/>[page.tsx]"]
  node_catalog["Product catalog"]
  node_product_detail["Product detail<br/>[page.tsx]"]
  node_seo["SEO metadata<br/>[sitemap.ts]"]
end

subgraph group_commerce["Commerce workflow"]
  node_cart["Persistent cart<br/>[use-cart.ts]"]
  node_checkout_page["Checkout page"]
  node_checkout_form["Checkout form<br/>[checkout-form.tsx]"]
  node_order_api["Order API<br/>[route.ts]"]
  node_order_service["Order services<br/>[order.service.ts]"]
end

subgraph group_admin["Admin operations"]
  node_order_admin["Order management<br/>[page.tsx]"]
  node_reports_api["Reports API<br/>[route.ts]"]
  node_report_service["Report analytics<br/>[report.service.ts]"]
  node_media["Image uploads<br/>[route.ts]"]
  node_exports["Report exports<br/>[export-utils.ts]"]
end

subgraph group_content["Content and engagement"]
  node_article_admin_api["Article API<br/>[route.ts]"]
  node_article_service["Article services<br/>[article.service.ts]"]
  node_portfolio_api["Portfolio category API<br/>[route.ts]"]
  node_portfolio_service["Portfolio category service"]
  node_inquiry["Customer inquiries<br/>[route.ts]"]
end

subgraph group_platform["Platform services"]
  node_orders_db[("PostgreSQL data<br/>[index.ts]")]
  node_auth["Authentication<br/>[route.ts]"]
  node_permissions["Role permissions<br/>[permissions.ts]"]
  node_email["Email notifications<br/>[mail.ts]"]
end

node_visitor(("Guest visitor"))
node_cloudinary[("Cloudinary")]
node_whatsapp(("WhatsApp confirmation"))

node_visitor -->|"browses"| node_storefront_pages
node_storefront_pages -->|"opens catalog"| node_catalog
node_catalog -->|"views product"| node_product_detail
node_visitor -->|"adds products"| node_cart
node_cart -->|"continues to"| node_checkout_page
node_checkout_page -->|"renders"| node_checkout_form
node_checkout_form -->|"reads items"| node_cart
node_checkout_form -->|"submits order"| node_order_api
node_order_api -->|"writes order"| node_orders_db
node_order_api -->|"fetches orders"| node_order_service
node_order_api -->|"checks session"| node_auth
node_order_api -->|"confirms payment"| node_whatsapp
node_order_admin -->|"manages orders"| node_order_api
node_order_admin -->|"updates status"| node_orders_db
node_visitor -->|"sends inquiry"| node_inquiry
node_article_admin_api -->|"delegates"| node_article_service
node_article_admin_api -->|"checks access"| node_permissions
node_article_service -->|"reads and writes"| node_orders_db
node_portfolio_api -->|"delegates"| node_portfolio_service
node_portfolio_service -->|"reads and writes"| node_orders_db
node_reports_api -->|"requests data"| node_report_service
node_reports_api -->|"checks access"| node_permissions
node_report_service -->|"reads transactions"| node_orders_db
node_reports_api -->|"exports reports"| node_exports
node_media -->|"uploads images"| node_cloudinary
node_seo -->|"supports discovery"| node_storefront_pages
node_order_api -.->|"notifies"| node_email

click node_storefront_pages "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/(guest)/page.tsx"
click node_catalog "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/components/guest/catalog/product-catalog.tsx"
click node_product_detail "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/(guest)/produk/%5Bslug%5D/page.tsx"
click node_cart "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/hooks/use-cart.ts"
click node_checkout_page "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/components/guest/checkout/order-page-client.tsx"
click node_checkout_form "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/components/guest/checkout/checkout-form.tsx"
click node_order_api "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/orders/route.ts"
click node_order_service "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/services/order.service.ts"
click node_orders_db "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/db/index.ts"
click node_order_admin "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/(admin)/admin/orders/page.tsx"
click node_auth "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/auth/%5B...nextauth%5D/route.ts"
click node_permissions "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/config/permissions.ts"
click node_article_admin_api "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/articles/route.ts"
click node_article_service "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/services/article.service.ts"
click node_portfolio_api "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/portfolio-categories/route.ts"
click node_portfolio_service "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/services/portfolio-category.service.ts"
click node_inquiry "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/inquiries/route.ts"
click node_reports_api "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/reports/route.ts"
click node_report_service "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/services/report.service.ts"
click node_media "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/upload/route.ts"
click node_email "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/mail.ts"
click node_seo "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/sitemap.ts"
click node_exports "https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/export-utils.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_pages,node_catalog,node_product_detail,node_seo toneBlue
class node_cart,node_checkout_page,node_checkout_form,node_order_api,node_order_service,node_cloudinary toneAmber
class node_order_admin,node_reports_api,node_report_service,node_media,node_exports toneMint
class node_article_admin_api,node_article_service,node_portfolio_api,node_portfolio_service,node_inquiry toneRose
class node_orders_db,node_auth,node_permissions,node_email,node_visitor,node_whatsapp toneIndigo
```

## Components

### Public storefront

- [Storefront pages](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/(guest)/page.tsx): `src/app/(guest)/page.tsx`
- [Product catalog](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/components/guest/catalog/product-catalog.tsx): `src/components/guest/catalog/product-catalog.tsx`
- [Product detail](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/(guest)/produk/%5Bslug%5D/page.tsx): `src/app/(guest)/produk/[slug]/page.tsx`
- [SEO metadata](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/sitemap.ts): `src/app/sitemap.ts`

### Commerce workflow

- [Persistent cart](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/hooks/use-cart.ts): `src/hooks/use-cart.ts`
- [Checkout page](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/components/guest/checkout/order-page-client.tsx): `src/components/guest/checkout/order-page-client.tsx`
- [Checkout form](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/components/guest/checkout/checkout-form.tsx): `src/components/guest/checkout/checkout-form.tsx`
- [Order API](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/orders/route.ts): `src/app/api/orders/route.ts`
- [Order services](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/services/order.service.ts): `src/lib/services/order.service.ts`

### Admin operations

- [Order management](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/(admin)/admin/orders/page.tsx): `src/app/(admin)/admin/orders/page.tsx`
- [Reports API](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/reports/route.ts): `src/app/api/reports/route.ts`
- [Report analytics](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/services/report.service.ts): `src/lib/services/report.service.ts`
- [Image uploads](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/upload/route.ts): `src/app/api/upload/route.ts`
- [Report exports](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/export-utils.ts): `src/lib/export-utils.ts`

### Content and engagement

- [Article API](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/articles/route.ts): `src/app/api/articles/route.ts`
- [Article services](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/services/article.service.ts): `src/lib/services/article.service.ts`
- [Portfolio category API](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/portfolio-categories/route.ts): `src/app/api/portfolio-categories/route.ts`
- [Portfolio category service](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/services/portfolio-category.service.ts): `src/lib/services/portfolio-category.service.ts`
- [Customer inquiries](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/inquiries/route.ts): `src/app/api/inquiries/route.ts`

### Platform services

- [PostgreSQL data](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/db/index.ts): `src/db/index.ts`
- [Authentication](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/app/api/auth/%5B...nextauth%5D/route.ts): `src/app/api/auth/[...nextauth]/route.ts`
- [Role permissions](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/config/permissions.ts): `src/lib/config/permissions.ts`
- [Email notifications](https://github.com/drenzzz/mitra-wiradoor-sumbar/blob/main/src/lib/mail.ts): `src/lib/mail.ts`

### Other components

- **Guest visitor**
- **Cloudinary**
- **WhatsApp confirmation**

## Connections

- Guest visitor → Storefront pages: browses
- Storefront pages → Product catalog: opens catalog
- Product catalog → Product detail: views product
- Guest visitor → Persistent cart: adds products
- Persistent cart → Checkout page: continues to
- Checkout page → Checkout form: renders (evidence: `src/components/guest/checkout/order-page-client.tsx`)
- Checkout form → Persistent cart: reads items (evidence: `src/components/guest/checkout/checkout-form.tsx`)
- Checkout form → Order API: submits order
- Order API → PostgreSQL data: writes order (evidence: `src/app/api/orders/route.ts`)
- Order API → Order services: fetches orders (evidence: `src/app/api/orders/route.ts`)
- Order API → Authentication: checks session (evidence: `src/app/api/orders/route.ts`)
- Order API → WhatsApp confirmation: confirms payment
- Order management → Order API: manages orders
- Order management → PostgreSQL data: updates status
- Guest visitor → Customer inquiries: sends inquiry
- Article API → Article services: delegates (evidence: `src/app/api/articles/route.ts`)
- Article API → Role permissions: checks access (evidence: `src/app/api/articles/route.ts`)
- Article services → PostgreSQL data: reads and writes (evidence: `src/lib/services/article.service.ts`)
- Portfolio category API → Portfolio category service: delegates (evidence: `src/app/api/portfolio-categories/route.ts`)
- Portfolio category service → PostgreSQL data: reads and writes (evidence: `src/lib/services/portfolio-category.service.ts`)
- Reports API → Report analytics: requests data (evidence: `src/app/api/reports/route.ts`)
- Reports API → Role permissions: checks access (evidence: `src/app/api/reports/route.ts`)
- Report analytics → PostgreSQL data: reads transactions (evidence: `src/lib/services/report.service.ts`)
- Reports API → Report exports: exports reports
- Image uploads → Cloudinary: uploads images
- SEO metadata → Storefront pages: supports discovery
- Order API → Email notifications: notifies
