# dr3nulja/raamatupood architecture

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

- Interactive diagram: https://gitdiagram.com/dr3nulja/raamatupood
- Repository: https://github.com/dr3nulja/raamatupood

## Overview

RaamatuPood is a full-stack bookstore: shoppers discover books, manage a cart, check out with shipping and Stripe, then review orders and manage their profile; administrators manage catalog metadata and orders. The graph also includes the documented Auth0 sign-in/profile flow, reviews, localization, and API security. Source excerpts are selective, so some subsystem links rely on README statements; unsampled route internals are not inferred.

Main entry points: [`app/auth/callback/route.ts`](https://github.com/dr3nulja/raamatupood/blob/main/app/auth/callback/route.ts) (Auth callback), [`app/catalog/page.tsx`](https://github.com/dr3nulja/raamatupood/blob/main/app/catalog/page.tsx) (Catalog browsing), [`app/api/orders/route.ts`](https://github.com/dr3nulja/raamatupood/blob/main/app/api/orders/route.ts) (Order API), [`components/admin/AdminDashboardView.tsx`](https://github.com/dr3nulja/raamatupood/blob/main/components/admin/AdminDashboardView.tsx) (Admin dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Book discovery"]
  node_catalog_ui["Catalog browsing<br/>[page.tsx]"]
  node_book_detail["Book details"]
  node_reviews["Book reviews<br/>[route.ts]"]
  node_catalog_api["Catalog API<br/>[route.ts]"]
  node_catalog_types["Catalog types<br/>[catalogTypes.ts]"]
end

subgraph group_purchase["Cart and checkout"]
  node_cart_state["Cart state<br/>[cartStore.ts]"]
  node_cart_api["Cart API<br/>[route.ts]"]
  node_session_cart["Session cart<br/>[sessionCart.ts]"]
  node_checkout_ui["Checkout page<br/>[page.tsx]"]
  node_checkout_action["Checkout action<br/>[checkout.tsx]"]
  node_checkout_logic["Checkout logic<br/>[createCheckout.ts]"]
  node_orders_api["Order API<br/>[route.ts]"]
end

subgraph group_identity["Identity and accounts"]
  node_auth_entry["Auth routes<br/>[route.ts]"]
  node_auth_callback["Auth callback<br/>[route.ts]"]
  node_auth_flow["Auth flow<br/>[flow.ts]"]
  node_auth0_config["Auth0 client<br/>[auth0.ts]"]
  node_profile["Profile management<br/>[route.ts]"]
  node_account["Account and orders<br/>[ProfilePage.tsx]"]
end

subgraph group_operations["Store operations"]
  node_admin_ui["Admin dashboard"]
  node_admin_books["Book management<br/>[AdminBooksView.tsx]"]
  node_metadata["Category and author management"]
  node_admin_orders["Order management"]
end

subgraph group_platform["Shared platform"]
  node_database[("MySQL database")]
  node_security["API security<br/>[api-guard.ts]"]
  node_translations["Translations<br/>[useTranslation.ts]"]
  node_button["UI button<br/>[Button.tsx]"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
end

node_customer(("Shopper"))
node_admin_user(("Administrator"))
node_stripe["Stripe payments"]
node_auth0_service["Auth0 identity"]

node_customer -->|"browses"| node_catalog_ui
node_catalog_ui -->|"fetches books"| node_catalog_api
node_catalog_ui -->|"uses types"| node_catalog_types
node_customer -->|"views book"| node_book_detail
node_book_detail -->|"reads and submits"| node_reviews
node_customer -->|"rates books"| node_reviews
node_customer -->|"manages cart"| node_cart_state
node_cart_state -->|"reads and writes"| node_session_cart
node_cart_state -.->|"syncs cart"| node_cart_api
node_customer -->|"checks out"| node_checkout_ui
node_checkout_ui -->|"submits checkout"| node_checkout_action
node_checkout_action -->|"creates checkout"| node_checkout_logic
node_checkout_logic -->|"processes payment"| node_stripe
node_customer -->|"views orders"| node_orders_api
node_orders_api -->|"reads and writes orders"| node_database
node_customer -->|"signs in"| node_auth_entry
node_auth_entry -->|"configures login"| node_auth0_config
node_auth0_config -->|"authenticates"| node_auth0_service
node_auth_callback -->|"uses configuration"| node_auth0_config
node_auth_callback -->|"checks profile state"| node_auth_flow
node_auth_callback -->|"parses cart"| node_session_cart
node_auth_callback -->|"merges user cart"| node_database
node_customer -->|"manages account"| node_account
node_account -.->|"updates profile"| node_profile
node_admin_user -->|"manages store"| node_admin_ui
node_admin_ui -->|"manages books"| node_admin_books
node_admin_ui -->|"manages metadata"| node_metadata
node_admin_ui -->|"manages orders"| node_admin_orders
node_catalog_api -->|"reads catalog"| node_database
node_reviews -->|"reads and writes reviews"| node_database
node_cart_api -->|"reads and writes cart"| node_database
node_admin_books -->|"manages inventory"| node_database
node_metadata -.->|"manages metadata"| node_database
node_admin_orders -.->|"manages orders"| node_database
node_catalog_api -->|"wraps requests"| node_security
node_cart_api -->|"wraps requests"| node_security
node_reviews -->|"wraps requests"| node_security
node_orders_api -->|"wraps requests"| node_security
node_orders_api -->|"uses client"| node_prisma
node_prisma -->|"accesses"| node_database
node_catalog_ui -->|"localizes UI"| node_translations
node_checkout_ui -->|"renders controls"| node_button
node_metadata -->|"renders controls"| node_button

click node_catalog_ui "https://github.com/dr3nulja/raamatupood/blob/main/app/catalog/page.tsx"
click node_book_detail "https://github.com/dr3nulja/raamatupood/blob/main/components/BookDetailsClient.tsx"
click node_reviews "https://github.com/dr3nulja/raamatupood/blob/main/app/api/reviews/route.ts"
click node_catalog_api "https://github.com/dr3nulja/raamatupood/blob/main/app/api/books/route.ts"
click node_catalog_types "https://github.com/dr3nulja/raamatupood/blob/main/lib/api/catalogTypes.ts"
click node_cart_state "https://github.com/dr3nulja/raamatupood/blob/main/stores/cartStore.ts"
click node_cart_api "https://github.com/dr3nulja/raamatupood/blob/main/app/api/cart/route.ts"
click node_session_cart "https://github.com/dr3nulja/raamatupood/blob/main/lib/cart/sessionCart.ts"
click node_checkout_ui "https://github.com/dr3nulja/raamatupood/blob/main/app/checkout/page.tsx"
click node_checkout_action "https://github.com/dr3nulja/raamatupood/blob/main/app/actions/checkout.tsx"
click node_checkout_logic "https://github.com/dr3nulja/raamatupood/blob/main/lib/checkout/createCheckout.ts"
click node_orders_api "https://github.com/dr3nulja/raamatupood/blob/main/app/api/orders/route.ts"
click node_auth_entry "https://github.com/dr3nulja/raamatupood/blob/main/app/auth/login/route.ts"
click node_auth_callback "https://github.com/dr3nulja/raamatupood/blob/main/app/auth/callback/route.ts"
click node_auth_flow "https://github.com/dr3nulja/raamatupood/blob/main/lib/auth/flow.ts"
click node_auth0_config "https://github.com/dr3nulja/raamatupood/blob/main/lib/auth0.ts"
click node_profile "https://github.com/dr3nulja/raamatupood/blob/main/app/api/profile/route.ts"
click node_account "https://github.com/dr3nulja/raamatupood/blob/main/components/account/ProfilePage.tsx"
click node_admin_ui "https://github.com/dr3nulja/raamatupood/blob/main/components/admin/AdminDashboardView.tsx"
click node_admin_books "https://github.com/dr3nulja/raamatupood/blob/main/components/admin/AdminBooksView.tsx"
click node_metadata "https://github.com/dr3nulja/raamatupood/blob/main/components/admin/MetadataManager.tsx"
click node_admin_orders "https://github.com/dr3nulja/raamatupood/blob/main/components/admin/AdminOrdersView.tsx"
click node_security "https://github.com/dr3nulja/raamatupood/blob/main/lib/security/api-guard.ts"
click node_translations "https://github.com/dr3nulja/raamatupood/blob/main/hooks/useTranslation.ts"
click node_button "https://github.com/dr3nulja/raamatupood/blob/main/components/ui/Button.tsx"
click node_prisma "https://github.com/dr3nulja/raamatupood/blob/main/lib/prisma.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_catalog_ui,node_book_detail,node_reviews,node_catalog_api,node_catalog_types toneBlue
class node_cart_state,node_cart_api,node_session_cart,node_checkout_ui,node_checkout_action,node_checkout_logic,node_orders_api toneAmber
class node_auth_entry,node_auth_callback,node_auth_flow,node_auth0_config,node_profile,node_account toneMint
class node_admin_ui,node_admin_books,node_metadata,node_admin_orders toneRose
class node_database,node_security,node_translations,node_button,node_prisma,node_customer,node_admin_user,node_stripe,node_auth0_service toneIndigo
```

## Components

### Book discovery

- [Catalog browsing](https://github.com/dr3nulja/raamatupood/blob/main/app/catalog/page.tsx): `app/catalog/page.tsx`
- [Book details](https://github.com/dr3nulja/raamatupood/blob/main/components/BookDetailsClient.tsx): `components/BookDetailsClient.tsx`
- [Book reviews](https://github.com/dr3nulja/raamatupood/blob/main/app/api/reviews/route.ts): `app/api/reviews/route.ts`
- [Catalog API](https://github.com/dr3nulja/raamatupood/blob/main/app/api/books/route.ts): `app/api/books/route.ts`
- [Catalog types](https://github.com/dr3nulja/raamatupood/blob/main/lib/api/catalogTypes.ts): `lib/api/catalogTypes.ts`

### Cart and checkout

- [Cart state](https://github.com/dr3nulja/raamatupood/blob/main/stores/cartStore.ts): `stores/cartStore.ts`
- [Cart API](https://github.com/dr3nulja/raamatupood/blob/main/app/api/cart/route.ts): `app/api/cart/route.ts`
- [Session cart](https://github.com/dr3nulja/raamatupood/blob/main/lib/cart/sessionCart.ts): `lib/cart/sessionCart.ts`
- [Checkout page](https://github.com/dr3nulja/raamatupood/blob/main/app/checkout/page.tsx): `app/checkout/page.tsx`
- [Checkout action](https://github.com/dr3nulja/raamatupood/blob/main/app/actions/checkout.tsx): `app/actions/checkout.tsx`
- [Checkout logic](https://github.com/dr3nulja/raamatupood/blob/main/lib/checkout/createCheckout.ts): `lib/checkout/createCheckout.ts`
- [Order API](https://github.com/dr3nulja/raamatupood/blob/main/app/api/orders/route.ts): `app/api/orders/route.ts`

### Identity and accounts

- [Auth routes](https://github.com/dr3nulja/raamatupood/blob/main/app/auth/login/route.ts): `app/auth/login/route.ts`
- [Auth callback](https://github.com/dr3nulja/raamatupood/blob/main/app/auth/callback/route.ts): `app/auth/callback/route.ts`
- [Auth flow](https://github.com/dr3nulja/raamatupood/blob/main/lib/auth/flow.ts): `lib/auth/flow.ts`
- [Auth0 client](https://github.com/dr3nulja/raamatupood/blob/main/lib/auth0.ts): `lib/auth0.ts`
- [Profile management](https://github.com/dr3nulja/raamatupood/blob/main/app/api/profile/route.ts): `app/api/profile/route.ts`
- [Account and orders](https://github.com/dr3nulja/raamatupood/blob/main/components/account/ProfilePage.tsx): `components/account/ProfilePage.tsx`

### Store operations

- [Admin dashboard](https://github.com/dr3nulja/raamatupood/blob/main/components/admin/AdminDashboardView.tsx): `components/admin/AdminDashboardView.tsx`
- [Book management](https://github.com/dr3nulja/raamatupood/blob/main/components/admin/AdminBooksView.tsx): `components/admin/AdminBooksView.tsx`
- [Category and author management](https://github.com/dr3nulja/raamatupood/blob/main/components/admin/MetadataManager.tsx): `components/admin/MetadataManager.tsx`
- [Order management](https://github.com/dr3nulja/raamatupood/blob/main/components/admin/AdminOrdersView.tsx): `components/admin/AdminOrdersView.tsx`

### Shared platform

- **MySQL database**
- [API security](https://github.com/dr3nulja/raamatupood/blob/main/lib/security/api-guard.ts): `lib/security/api-guard.ts`
- [Translations](https://github.com/dr3nulja/raamatupood/blob/main/hooks/useTranslation.ts): `hooks/useTranslation.ts`
- [UI button](https://github.com/dr3nulja/raamatupood/blob/main/components/ui/Button.tsx): `components/ui/Button.tsx`
- [Prisma client](https://github.com/dr3nulja/raamatupood/blob/main/lib/prisma.ts): `lib/prisma.ts`

### Other components

- **Shopper**
- **Administrator**
- **Stripe payments**
- **Auth0 identity**

## Connections

- Shopper → Catalog browsing: browses (evidence: `README.md`)
- Catalog browsing → Catalog API: fetches books (evidence: `app/catalog/page.tsx`)
- Catalog browsing → Catalog types: uses types (evidence: `app/catalog/page.tsx`)
- Shopper → Book details: views book (evidence: `README.md`)
- Book details → Book reviews: reads and submits (evidence: `components/BookDetailsClient.tsx`)
- Shopper → Book reviews: rates books (evidence: `README.md`)
- Shopper → Cart state: manages cart (evidence: `README.md`)
- Cart state → Session cart: reads and writes (evidence: `stores/cartStore.ts`)
- Cart state → Cart API: syncs cart
- Shopper → Checkout page: checks out (evidence: `README.md`)
- Checkout page → Checkout action: submits checkout (evidence: `app/checkout/page.tsx`)
- Checkout action → Checkout logic: creates checkout (evidence: `app/actions/checkout.tsx`)
- Checkout logic → Stripe payments: processes payment (evidence: `README.md`)
- Shopper → Order API: views orders (evidence: `README.md`)
- Order API → MySQL database: reads and writes orders (evidence: `app/api/orders/route.ts`)
- Shopper → Auth routes: signs in (evidence: `README.md`)
- Auth routes → Auth0 client: configures login (evidence: `app/auth/login/route.ts`)
- Auth0 client → Auth0 identity: authenticates (evidence: `README.md`)
- Auth callback → Auth0 client: uses configuration (evidence: `app/auth/callback/route.ts`)
- Auth callback → Auth flow: checks profile state (evidence: `app/auth/callback/route.ts`)
- Auth callback → Session cart: parses cart (evidence: `app/auth/callback/route.ts`)
- Auth callback → MySQL database: merges user cart (evidence: `README.md`)
- Shopper → Account and orders: manages account (evidence: `README.md`)
- Account and orders → Profile management: updates profile
- Administrator → Admin dashboard: manages store (evidence: `README.md`)
- Admin dashboard → Book management: manages books (evidence: `README.md`)
- Admin dashboard → Category and author management: manages metadata (evidence: `components/admin/MetadataManager.tsx`)
- Admin dashboard → Order management: manages orders (evidence: `README.md`)
- Catalog API → MySQL database: reads catalog (evidence: `app/api/books/route.ts`)
- Book reviews → MySQL database: reads and writes reviews (evidence: `app/api/reviews/route.ts`)
- Cart API → MySQL database: reads and writes cart (evidence: `app/api/cart/route.ts`)
- Book management → MySQL database: manages inventory (evidence: `README.md`)
- Category and author management → MySQL database: manages metadata
- Order management → MySQL database: manages orders
- Catalog API → API security: wraps requests (evidence: `app/api/books/route.ts`)
- Cart API → API security: wraps requests (evidence: `app/api/cart/route.ts`)
- Book reviews → API security: wraps requests (evidence: `app/api/reviews/route.ts`)
- Order API → API security: wraps requests (evidence: `app/api/orders/route.ts`)
- Order API → Prisma client: uses client (evidence: `app/api/orders/route.ts`)
- Prisma client → MySQL database: accesses (evidence: `README.md`)
- Catalog browsing → Translations: localizes UI (evidence: `app/catalog/page.tsx`)
- Checkout page → UI button: renders controls (evidence: `app/checkout/page.tsx`)
- Category and author management → UI button: renders controls (evidence: `components/admin/MetadataManager.tsx`)
