# pomptrash/eb.bijuteria architecture

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

- Interactive diagram: https://gitdiagram.com/pomptrash/eb.bijuteria
- Repository: https://github.com/pomptrash/eb.bijuteria

## Overview

EB Bijuterias is a small online jewelry storefront with an admin panel for managing its catalog and inventory. Shoppers browse and filter products, add available stock to a persistent cart, and prepare an order message for WhatsApp; the shown workflow does not include payment or order persistence. Administrators log in, view dashboard data, and manage categories and products, including product images. The graph reflects the sampled calls and indexed references; sales are only marked as forthcoming in the admin navigation, so no sales workflow is inferred.

Main entry points: [`src/lib/prisma.js`](https://github.com/pomptrash/eb.bijuteria/blob/main/src/lib/prisma.js) (Prisma client), [`src/app/admin/actions.js`](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/actions.js) (Login and logout), [`src/app/admin/categorias/actions.js`](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/actions.js) (Category actions), [`src/app/admin/categorias/page.js`](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/page.js) (Category page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer storefront"]
  node_store_page["Store page<br/>[page.js]"]
  node_catalog["Catalog display<br/>[storeFront.js]"]
end

subgraph group_cart["Cart and checkout"]
  node_cart_state["Cart state<br/>[cartContext.js]"]
  node_cart_drawer["Cart drawer<br/>[cartDrawer.js]"]
end

subgraph group_admin["Admin catalog"]
  node_admin_login["Admin login<br/>[page.js]"]
  node_admin_actions["Login and logout<br/>[actions.js]"]
  node_admin_layout["Admin layout<br/>[layout.js]"]
  node_dashboard["Admin dashboard<br/>[page.js]"]
  node_category_page["Category page<br/>[page.js]"]
  node_category_actions["Category actions<br/>[actions.js]"]
  node_category_form["Category form<br/>[categoryForm.js]"]
  node_category_table["Category table<br/>[categoryTable.js]"]
  node_category_modal["Edit category"]
  node_product_page["Product page<br/>[page.js]"]
  node_product_actions["Product actions<br/>[actions.js]"]
  node_product_table["Product table<br/>[productTable.js]"]
  node_product_form["Product form"]
  node_image_uploader["Image uploader"]
end

subgraph group_platform["Data and integrations"]
  node_auth["Session auth<br/>[auth.js]"]
  node_prisma["Prisma client<br/>[prisma.js]"]
  node_database[("PostgreSQL data<br/>[schema.prisma]")]
  node_cloudinary_lib["Image upload<br/>[cloudinary.js]"]
end

node_shopper(("Shopper"))
node_whatsapp(("WhatsApp"))
node_admin_user(("Administrator"))
node_cloudinary(("Cloudinary"))

node_shopper -->|"opens"| node_store_page
node_store_page -->|"loads catalog"| node_prisma
node_store_page -->|"renders"| node_catalog
node_catalog -->|"uses cart"| node_cart_state
node_cart_drawer -->|"uses cart"| node_cart_state
node_cart_drawer -->|"opens checkout"| node_whatsapp
node_admin_user -->|"opens"| node_admin_login
node_admin_login -->|"submits login"| node_admin_actions
node_admin_actions -->|"checks admin"| node_prisma
node_admin_actions -->|"creates session"| node_auth
node_admin_layout -->|"verifies session"| node_auth
node_admin_layout -->|"uses logout"| node_admin_actions
node_dashboard -->|"reads metrics"| node_prisma
node_category_page -->|"loads categories"| node_prisma
node_category_page -->|"renders"| node_category_form
node_category_page -->|"renders"| node_category_table
node_category_form -->|"submits form"| node_category_actions
node_category_table -->|"uses actions"| node_category_actions
node_category_table -->|"opens editor"| node_category_modal
node_category_modal -->|"submits update"| node_category_actions
node_category_actions -->|"writes categories"| node_prisma
node_product_page -->|"loads products"| node_prisma
node_product_page -->|"renders"| node_product_table
node_product_table -->|"opens editor"| node_product_form
node_product_table -->|"uses actions"| node_product_actions
node_product_form -->|"submits product"| node_product_actions
node_product_form -->|"renders"| node_image_uploader
node_product_actions -->|"writes products"| node_prisma
node_image_uploader -->|"uploads images"| node_cloudinary_lib
node_cloudinary_lib -->|"sends image"| node_cloudinary
node_prisma -.->|"accesses data"| node_database

click node_store_page "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/page.js"
click node_catalog "https://github.com/pomptrash/eb.bijuteria/blob/main/src/components/storeFront.js"
click node_cart_state "https://github.com/pomptrash/eb.bijuteria/blob/main/src/context/cartContext.js"
click node_cart_drawer "https://github.com/pomptrash/eb.bijuteria/blob/main/src/components/cartDrawer.js"
click node_admin_login "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/login/page.js"
click node_admin_actions "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/actions.js"
click node_admin_layout "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/layout.js"
click node_dashboard "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/dashboard/page.js"
click node_category_page "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/page.js"
click node_category_actions "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/actions.js"
click node_category_form "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/categoryForm.js"
click node_category_table "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/categoryTable.js"
click node_category_modal "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/editCategoryModal.js"
click node_product_page "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/page.js"
click node_product_actions "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/actions.js"
click node_product_table "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/productTable.js"
click node_product_form "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/productFormModal.js"
click node_image_uploader "https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/productImageUploader.js"
click node_auth "https://github.com/pomptrash/eb.bijuteria/blob/main/src/lib/auth.js"
click node_prisma "https://github.com/pomptrash/eb.bijuteria/blob/main/src/lib/prisma.js"
click node_database "https://github.com/pomptrash/eb.bijuteria/blob/main/prisma/schema.prisma"
click node_cloudinary_lib "https://github.com/pomptrash/eb.bijuteria/blob/main/src/lib/cloudinary.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_store_page,node_catalog toneBlue
class node_cart_state,node_cart_drawer toneAmber
class node_admin_login,node_admin_actions,node_admin_layout,node_dashboard,node_category_page,node_category_actions,node_category_form,node_category_table,node_category_modal,node_product_page,node_product_actions,node_product_table,node_product_form,node_image_uploader toneMint
class node_auth,node_prisma,node_database,node_cloudinary_lib toneRose
class node_shopper,node_whatsapp,node_admin_user,node_cloudinary toneIndigo
```

## Components

### Customer storefront

- [Store page](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/page.js): `src/app/page.js`
- [Catalog display](https://github.com/pomptrash/eb.bijuteria/blob/main/src/components/storeFront.js): `src/components/storeFront.js`

### Cart and checkout

- [Cart state](https://github.com/pomptrash/eb.bijuteria/blob/main/src/context/cartContext.js): `src/context/cartContext.js`
- [Cart drawer](https://github.com/pomptrash/eb.bijuteria/blob/main/src/components/cartDrawer.js): `src/components/cartDrawer.js`

### Admin catalog

- [Admin login](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/login/page.js): `src/app/admin/login/page.js`
- [Login and logout](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/actions.js): `src/app/admin/actions.js`
- [Admin layout](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/layout.js): `src/app/admin/layout.js`
- [Admin dashboard](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/dashboard/page.js): `src/app/admin/dashboard/page.js`
- [Category page](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/page.js): `src/app/admin/categorias/page.js`
- [Category actions](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/actions.js): `src/app/admin/categorias/actions.js`
- [Category form](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/categoryForm.js): `src/app/admin/categorias/categoryForm.js`
- [Category table](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/categoryTable.js): `src/app/admin/categorias/categoryTable.js`
- [Edit category](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/categorias/editCategoryModal.js): `src/app/admin/categorias/editCategoryModal.js`
- [Product page](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/page.js): `src/app/admin/produtos/page.js`
- [Product actions](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/actions.js): `src/app/admin/produtos/actions.js`
- [Product table](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/productTable.js): `src/app/admin/produtos/productTable.js`
- [Product form](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/productFormModal.js): `src/app/admin/produtos/productFormModal.js`
- [Image uploader](https://github.com/pomptrash/eb.bijuteria/blob/main/src/app/admin/produtos/productImageUploader.js): `src/app/admin/produtos/productImageUploader.js`

### Data and integrations

- [Session auth](https://github.com/pomptrash/eb.bijuteria/blob/main/src/lib/auth.js): `src/lib/auth.js`
- [Prisma client](https://github.com/pomptrash/eb.bijuteria/blob/main/src/lib/prisma.js): `src/lib/prisma.js`
- [PostgreSQL data](https://github.com/pomptrash/eb.bijuteria/blob/main/prisma/schema.prisma): `prisma/schema.prisma`
- [Image upload](https://github.com/pomptrash/eb.bijuteria/blob/main/src/lib/cloudinary.js): `src/lib/cloudinary.js`

### Other components

- **Shopper**
- **WhatsApp**
- **Administrator**
- **Cloudinary**

## Connections

- Shopper → Store page: opens
- Store page → Prisma client: loads catalog (evidence: `src/app/page.js`)
- Store page → Catalog display: renders (evidence: `src/app/page.js`)
- Catalog display → Cart state: uses cart (evidence: `src/components/storeFront.js`)
- Cart drawer → Cart state: uses cart (evidence: `src/components/cartDrawer.js`)
- Cart drawer → WhatsApp: opens checkout (evidence: `src/components/cartDrawer.js`)
- Administrator → Admin login: opens
- Admin login → Login and logout: submits login (evidence: `src/app/admin/login/page.js`)
- Login and logout → Prisma client: checks admin (evidence: `src/app/admin/actions.js`)
- Login and logout → Session auth: creates session (evidence: `src/app/admin/actions.js`)
- Admin layout → Session auth: verifies session (evidence: `src/app/admin/layout.js`)
- Admin layout → Login and logout: uses logout (evidence: `src/app/admin/layout.js`)
- Admin dashboard → Prisma client: reads metrics (evidence: `src/app/admin/dashboard/page.js`)
- Category page → Prisma client: loads categories (evidence: `src/app/admin/categorias/page.js`)
- Category page → Category form: renders (evidence: `src/app/admin/categorias/page.js`)
- Category page → Category table: renders (evidence: `src/app/admin/categorias/page.js`)
- Category form → Category actions: submits form (evidence: `src/app/admin/categorias/categoryForm.js`)
- Category table → Category actions: uses actions (evidence: `src/app/admin/categorias/categoryTable.js`)
- Category table → Edit category: opens editor (evidence: `src/app/admin/categorias/categoryTable.js`)
- Edit category → Category actions: submits update (evidence: `src/app/admin/categorias/editCategoryModal.js`)
- Category actions → Prisma client: writes categories (evidence: `src/app/admin/categorias/actions.js`)
- Product page → Prisma client: loads products (evidence: `src/app/admin/produtos/page.js`)
- Product page → Product table: renders (evidence: `src/app/admin/produtos/page.js`)
- Product table → Product form: opens editor (evidence: `src/app/admin/produtos/productTable.js`)
- Product table → Product actions: uses actions (evidence: `src/app/admin/produtos/productTable.js`)
- Product form → Product actions: submits product (evidence: `src/app/admin/produtos/productFormModal.js`)
- Product form → Image uploader: renders (evidence: `src/app/admin/produtos/productFormModal.js`)
- Product actions → Prisma client: writes products (evidence: `src/app/admin/produtos/actions.js`)
- Image uploader → Image upload: uploads images (evidence: `src/app/admin/produtos/productImageUploader.js`)
- Image upload → Cloudinary: sends image (evidence: `src/lib/cloudinary.js`)
- Prisma client → PostgreSQL data: accesses data
