# boooobly/creso-site architecture

> Architecture diagram of the GitHub repository boooobly/creso-site, 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/boooobly/creso-site
- Repository: https://github.com/boooobly/creso-site

## Overview

Creso Site is a print and advertising-services website: customers explore service pages, configure or price work, and submit orders or leads; staff manage orders and site content. The graph preserves the documented product areas visible in the tree, including baget framing, service-specific requests, portfolio, reviews, and admin tools. Edges cite explicit excerpts, SOURCE INDEX references, or the README; unsampled routes and integrations are not assumed to call one another.

Main entry points: [`src/app/api/orders/route.ts`](https://github.com/boooobly/creso-site/blob/main/src/app/api/orders/route.ts) (Baget orders), [`src/app/api`](https://github.com/boooobly/creso-site/tree/main/src/app/api) (Service requests), [`src/app/api/leads/route.ts`](https://github.com/boooobly/creso-site/blob/main/src/app/api/leads/route.ts) (Lead submissions), [`src/lib/notifications/outbox.ts`](https://github.com/boooobly/creso-site/blob/main/src/lib/notifications/outbox.ts) (Notification outbox)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer experience"]
  node_service_site["Service pages"]
  node_service_forms["Service forms"]
  node_baget_ui["Baget configurator<br/>[BagetFilters.tsx]"]
  node_milling_ui["Milling experience"]
  node_reviews_ui["Review experience<br/>[ReviewsClient.tsx]"]
end

subgraph group_intake["Orders and requests"]
  node_orders_api["Baget orders<br/>[route.ts]"]
  node_service_api["Service requests"]
  node_leads_api["Lead submissions<br/>[route.ts]"]
  node_upload_store["Customer uploads<br/>[server.ts]"]
  node_request_guard["Request protection<br/>[anti-spam.ts]"]
  node_reviews_api["Review API<br/>[route.ts]"]
end

subgraph group_core["Order processing"]
  node_order_service["Service order adapter"]
  node_order_creation["Order creation<br/>[createOrder.ts]"]
  node_idempotency["Idempotency<br/>[idempotency.ts]"]
  node_database[("Application database<br/>[prisma.ts]")]
  node_notifications["Notification outbox<br/>[outbox.ts]"]
  node_email["Email delivery<br/>[email.ts]"]
  node_telegram["Telegram delivery<br/>[telegram.ts]"]
end

subgraph group_admin["Administration"]
  node_admin_panel["Admin panel"]
  node_admin_services["Admin services"]
end

subgraph group_content["Catalog and engagement"]
  node_baget_catalog["Baget catalog<br/>[sheetsCatalog.ts]"]
  node_pricing["Pricing calculations"]
  node_portfolio_reviews["Portfolio and reviews<br/>[page.tsx]"]
end

node_visitor(("Customer"))

node_visitor -->|"browses"| node_service_site
node_service_site -->|"renders"| node_milling_ui
node_service_site -->|"renders"| node_baget_ui
node_service_forms -.->|"submits requests"| node_service_api
node_baget_ui -.->|"submits order"| node_orders_api
node_visitor -->|"submits lead"| node_leads_api
node_orders_api -->|"guards request"| node_request_guard
node_leads_api -->|"guards request"| node_request_guard
node_service_api -->|"creates service order"| node_order_service
node_leads_api -->|"creates service order"| node_order_service
node_orders_api -->|"creates order"| node_order_creation
node_order_service -->|"delegates to"| node_order_creation
node_order_creation -->|"persists order"| node_database
node_orders_api -->|"reads key"| node_idempotency
node_service_api -->|"reads key"| node_idempotency
node_orders_api -->|"reads upload references"| node_upload_store
node_service_api -->|"reads customer files"| node_upload_store
node_orders_api -->|"loads catalog"| node_baget_catalog
node_service_api -->|"calculates quote"| node_pricing
node_orders_api -->|"processes jobs"| node_notifications
node_leads_api -->|"processes jobs"| node_notifications
node_notifications -->|"dispatches email"| node_email
node_notifications -->|"dispatches Telegram"| node_telegram
node_admin_panel -.->|"uses admin services"| node_admin_services
node_visitor -->|"submits review"| node_reviews_api
node_reviews_ui -.->|"presents reviews"| node_portfolio_reviews

click node_service_site "https://github.com/boooobly/creso-site/tree/main/src/app/(public)"
click node_service_forms "https://github.com/boooobly/creso-site/tree/main/src/components"
click node_baget_ui "https://github.com/boooobly/creso-site/blob/main/src/components/baget/BagetFilters.tsx"
click node_milling_ui "https://github.com/boooobly/creso-site/blob/main/src/components/milling/MillingPageClient.tsx"
click node_reviews_ui "https://github.com/boooobly/creso-site/blob/main/src/components/ReviewsClient.tsx"
click node_orders_api "https://github.com/boooobly/creso-site/blob/main/src/app/api/orders/route.ts"
click node_service_api "https://github.com/boooobly/creso-site/tree/main/src/app/api"
click node_leads_api "https://github.com/boooobly/creso-site/blob/main/src/app/api/leads/route.ts"
click node_upload_store "https://github.com/boooobly/creso-site/blob/main/src/lib/customer-uploads/server.ts"
click node_request_guard "https://github.com/boooobly/creso-site/blob/main/src/lib/anti-spam.ts"
click node_order_service "https://github.com/boooobly/creso-site/blob/main/src/lib/orders/createServiceRequestOrder.ts"
click node_order_creation "https://github.com/boooobly/creso-site/blob/main/src/lib/orders/createOrder.ts"
click node_idempotency "https://github.com/boooobly/creso-site/blob/main/src/lib/orders/idempotency.ts"
click node_database "https://github.com/boooobly/creso-site/blob/main/src/lib/db/prisma.ts"
click node_notifications "https://github.com/boooobly/creso-site/blob/main/src/lib/notifications/outbox.ts"
click node_email "https://github.com/boooobly/creso-site/blob/main/src/lib/notifications/email.ts"
click node_telegram "https://github.com/boooobly/creso-site/blob/main/src/lib/notifications/telegram.ts"
click node_baget_catalog "https://github.com/boooobly/creso-site/blob/main/src/lib/baget/sheetsCatalog.ts"
click node_pricing "https://github.com/boooobly/creso-site/tree/main/src/lib/calculations"
click node_admin_panel "https://github.com/boooobly/creso-site/tree/main/src/app/admin/(panel)"
click node_admin_services "https://github.com/boooobly/creso-site/tree/main/src/lib/admin"
click node_portfolio_reviews "https://github.com/boooobly/creso-site/blob/main/src/app/(public)/portfolio/page.tsx"
click node_reviews_api "https://github.com/boooobly/creso-site/blob/main/src/app/api/reviews/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_service_site,node_service_forms,node_baget_ui,node_milling_ui,node_reviews_ui toneBlue
class node_orders_api,node_service_api,node_leads_api,node_upload_store,node_request_guard,node_reviews_api toneAmber
class node_order_service,node_order_creation,node_idempotency,node_database,node_notifications,node_email,node_telegram toneMint
class node_admin_panel,node_admin_services toneRose
class node_baget_catalog,node_pricing,node_portfolio_reviews,node_visitor toneIndigo
```

## Components

### Customer experience

- [Service pages](https://github.com/boooobly/creso-site/tree/main/src/app/(public)): `src/app/(public)`
- [Service forms](https://github.com/boooobly/creso-site/tree/main/src/components): `src/components`
- [Baget configurator](https://github.com/boooobly/creso-site/blob/main/src/components/baget/BagetFilters.tsx): `src/components/baget/BagetFilters.tsx`
- [Milling experience](https://github.com/boooobly/creso-site/blob/main/src/components/milling/MillingPageClient.tsx): `src/components/milling/MillingPageClient.tsx`
- [Review experience](https://github.com/boooobly/creso-site/blob/main/src/components/ReviewsClient.tsx): `src/components/ReviewsClient.tsx`

### Orders and requests

- [Baget orders](https://github.com/boooobly/creso-site/blob/main/src/app/api/orders/route.ts): `src/app/api/orders/route.ts`
- [Service requests](https://github.com/boooobly/creso-site/tree/main/src/app/api): `src/app/api`
- [Lead submissions](https://github.com/boooobly/creso-site/blob/main/src/app/api/leads/route.ts): `src/app/api/leads/route.ts`
- [Customer uploads](https://github.com/boooobly/creso-site/blob/main/src/lib/customer-uploads/server.ts): `src/lib/customer-uploads/server.ts`
- [Request protection](https://github.com/boooobly/creso-site/blob/main/src/lib/anti-spam.ts): `src/lib/anti-spam.ts`
- [Review API](https://github.com/boooobly/creso-site/blob/main/src/app/api/reviews/route.ts): `src/app/api/reviews/route.ts`

### Order processing

- [Service order adapter](https://github.com/boooobly/creso-site/blob/main/src/lib/orders/createServiceRequestOrder.ts): `src/lib/orders/createServiceRequestOrder.ts`
- [Order creation](https://github.com/boooobly/creso-site/blob/main/src/lib/orders/createOrder.ts): `src/lib/orders/createOrder.ts`
- [Idempotency](https://github.com/boooobly/creso-site/blob/main/src/lib/orders/idempotency.ts): `src/lib/orders/idempotency.ts`
- [Application database](https://github.com/boooobly/creso-site/blob/main/src/lib/db/prisma.ts): `src/lib/db/prisma.ts`
- [Notification outbox](https://github.com/boooobly/creso-site/blob/main/src/lib/notifications/outbox.ts): `src/lib/notifications/outbox.ts`
- [Email delivery](https://github.com/boooobly/creso-site/blob/main/src/lib/notifications/email.ts): `src/lib/notifications/email.ts`
- [Telegram delivery](https://github.com/boooobly/creso-site/blob/main/src/lib/notifications/telegram.ts): `src/lib/notifications/telegram.ts`

### Administration

- [Admin panel](https://github.com/boooobly/creso-site/tree/main/src/app/admin/(panel)): `src/app/admin/(panel)`
- [Admin services](https://github.com/boooobly/creso-site/tree/main/src/lib/admin): `src/lib/admin`

### Catalog and engagement

- [Baget catalog](https://github.com/boooobly/creso-site/blob/main/src/lib/baget/sheetsCatalog.ts): `src/lib/baget/sheetsCatalog.ts`
- [Pricing calculations](https://github.com/boooobly/creso-site/tree/main/src/lib/calculations): `src/lib/calculations`
- [Portfolio and reviews](https://github.com/boooobly/creso-site/blob/main/src/app/(public)/portfolio/page.tsx): `src/app/(public)/portfolio/page.tsx`

### Other components

- **Customer**

## Connections

- Customer → Service pages: browses (evidence: `README.md`)
- Service pages → Milling experience: renders (evidence: `src/components/milling/MillingPageClient.tsx`)
- Service pages → Baget configurator: renders
- Service forms → Service requests: submits requests
- Baget configurator → Baget orders: submits order
- Customer → Lead submissions: submits lead (evidence: `src/app/api/leads/route.ts`)
- Baget orders → Request protection: guards request (evidence: `src/app/api/orders/route.ts`)
- Lead submissions → Request protection: guards request (evidence: `src/app/api/leads/route.ts`)
- Service requests → Service order adapter: creates service order (evidence: `src/app/api/wide-format-order/route.ts`)
- Lead submissions → Service order adapter: creates service order (evidence: `src/app/api/leads/route.ts`)
- Baget orders → Order creation: creates order (evidence: `src/app/api/orders/route.ts`)
- Service order adapter → Order creation: delegates to (evidence: `src/lib/orders/createServiceRequestOrder.ts`)
- Order creation → Application database: persists order (evidence: `src/lib/orders/createOrder.ts`)
- Baget orders → Idempotency: reads key (evidence: `src/app/api/orders/route.ts`)
- Service requests → Idempotency: reads key (evidence: `src/app/api/wide-format-order/route.ts`)
- Baget orders → Customer uploads: reads upload references (evidence: `src/app/api/orders/route.ts`)
- Service requests → Customer uploads: reads customer files (evidence: `src/app/api/wide-format-order/route.ts`)
- Baget orders → Baget catalog: loads catalog (evidence: `src/app/api/orders/route.ts`)
- Service requests → Pricing calculations: calculates quote (evidence: `src/app/api/wide-format-order/route.ts`)
- Baget orders → Notification outbox: processes jobs (evidence: `src/app/api/orders/route.ts`)
- Lead submissions → Notification outbox: processes jobs (evidence: `src/app/api/leads/route.ts`)
- Notification outbox → Email delivery: dispatches email (evidence: `src/lib/notifications/outbox.ts`)
- Notification outbox → Telegram delivery: dispatches Telegram (evidence: `src/lib/notifications/outbox.ts`)
- Admin panel → Admin services: uses admin services
- Customer → Review API: submits review (evidence: `src/app/api/reviews/route.ts`)
- Review experience → Portfolio and reviews: presents reviews
