# luissaraivavet/bordopersonalizados architecture

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

## Overview

Bordô is a static storefront for custom embroidered gifts, with a private local content-management panel. The shopper flow is browsing the catalog, building a bag or requesting a custom quote, then continuing the order conversation through WhatsApp; editorial content is a separate discovery branch. The management flow edits content and photos, saves drafts, previews or exports the site, and can publish selected content through GitHub. Several public-page and server internals were not sampled, so those links are included only where the README documents them.

Main entry points: [`admin_server.py`](https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin_server.py) (Local admin server), [`admin/admin.js`](https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin/admin.js) (Panel interface), [`assets/site.js`](https://github.com/luissaraivavet/bordopersonalizados/blob/main/assets/site.js) (Catalog and bag), [`index.html`](https://github.com/luissaraivavet/bordopersonalizados/blob/main/index.html) (Storefront)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public storefront"]
  node_storefront["Storefront<br/>[index.html]"]
  node_storefront_runtime["Catalog and bag<br/>[site.js]"]
  node_public_content[("Public content<br/>[site.json]")]
  node_content_script["Content runtime data<br/>[content.js]"]
end

subgraph group_editorial["Editorial content"]
  node_blog["Blog<br/>[index.html]"]
  node_blog_articles["Editorial articles"]
  node_list_data[("Guide source data")]
  node_list_generator["Guide generator"]
  node_generated_guides["Shopping guides"]
end

subgraph group_management["Content management"]
  node_editor["Panel interface<br/>[admin.js]"]
  node_admin_page["Panel page<br/>[index.html]"]
  node_admin_server["Local admin server<br/>[admin_server.py]"]
  node_draft_store[("Draft storage")]
  node_media_library[("Photo library")]
end

subgraph group_publishing["Preview and publishing"]
  node_preview_export["Preview and ZIP<br/>[admin_server.py]"]
end

node_shopper(("Shopper"))
node_whatsapp(("WhatsApp"))
node_git_service{{"GitHub"}}
node_pages{{"GitHub Pages"}}

node_shopper -->|"browses"| node_storefront
node_storefront -->|"uses"| node_storefront_runtime
node_storefront_runtime -->|"reads catalog"| node_public_content
node_storefront_runtime -->|"uses content"| node_content_script
node_shopper -->|"continues order"| node_whatsapp
node_blog -.->|"links articles"| node_blog_articles
node_list_data -->|"provides data"| node_list_generator
node_list_generator -->|"generates guides"| node_generated_guides
node_admin_page -.->|"loads interface"| node_editor
node_editor -->|"requests API"| node_admin_server
node_admin_server -->|"reads and writes"| node_draft_store
node_editor -->|"uploads and lists"| node_media_library
node_admin_server -->|"stores uploads"| node_media_library
node_admin_server -->|"validates and writes"| node_public_content
node_admin_server -->|"writes runtime data"| node_content_script
node_editor -->|"opens preview or ZIP"| node_preview_export
node_admin_server -->|"commits and pushes"| node_git_service
node_git_service -->|"triggers deployment"| node_pages

click node_storefront "https://github.com/luissaraivavet/bordopersonalizados/blob/main/index.html"
click node_storefront_runtime "https://github.com/luissaraivavet/bordopersonalizados/blob/main/assets/site.js"
click node_public_content "https://github.com/luissaraivavet/bordopersonalizados/blob/main/content/site.json"
click node_content_script "https://github.com/luissaraivavet/bordopersonalizados/blob/main/assets/content.js"
click node_blog "https://github.com/luissaraivavet/bordopersonalizados/blob/main/blog/index.html"
click node_blog_articles "https://github.com/luissaraivavet/bordopersonalizados/tree/main/blog"
click node_list_data "https://github.com/luissaraivavet/bordopersonalizados/blob/main/scripts/dados_listas_blog.json"
click node_list_generator "https://github.com/luissaraivavet/bordopersonalizados/blob/main/scripts/gerar_listas_blog.py"
click node_generated_guides "https://github.com/luissaraivavet/bordopersonalizados/tree/main/blog"
click node_editor "https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin/admin.js"
click node_admin_page "https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin/index.html"
click node_admin_server "https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin_server.py"
click node_preview_export "https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin_server.py"

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_storefront_runtime,node_public_content,node_content_script toneBlue
class node_blog,node_blog_articles,node_list_data,node_list_generator,node_generated_guides toneAmber
class node_editor,node_admin_page,node_admin_server,node_draft_store,node_media_library toneMint
class node_preview_export toneRose
class node_shopper,node_whatsapp,node_git_service,node_pages toneIndigo
```

## Components

### Public storefront

- [Storefront](https://github.com/luissaraivavet/bordopersonalizados/blob/main/index.html): `index.html`
- [Catalog and bag](https://github.com/luissaraivavet/bordopersonalizados/blob/main/assets/site.js): `assets/site.js`
- [Public content](https://github.com/luissaraivavet/bordopersonalizados/blob/main/content/site.json): `content/site.json`
- [Content runtime data](https://github.com/luissaraivavet/bordopersonalizados/blob/main/assets/content.js): `assets/content.js`

### Editorial content

- [Blog](https://github.com/luissaraivavet/bordopersonalizados/blob/main/blog/index.html): `blog/index.html`
- [Editorial articles](https://github.com/luissaraivavet/bordopersonalizados/tree/main/blog): `blog`
- [Guide source data](https://github.com/luissaraivavet/bordopersonalizados/blob/main/scripts/dados_listas_blog.json): `scripts/dados_listas_blog.json`
- [Guide generator](https://github.com/luissaraivavet/bordopersonalizados/blob/main/scripts/gerar_listas_blog.py): `scripts/gerar_listas_blog.py`
- [Shopping guides](https://github.com/luissaraivavet/bordopersonalizados/tree/main/blog): `blog`

### Content management

- [Panel interface](https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin/admin.js): `admin/admin.js`
- [Panel page](https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin/index.html): `admin/index.html`
- [Local admin server](https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin_server.py): `admin_server.py`
- **Draft storage**
- **Photo library**

### Preview and publishing

- [Preview and ZIP](https://github.com/luissaraivavet/bordopersonalizados/blob/main/admin_server.py): `admin_server.py`

### Other components

- **Shopper**
- **WhatsApp**
- **GitHub**
- **GitHub Pages**

## Connections

- Shopper → Storefront: browses (evidence: `README.md`)
- Storefront → Catalog and bag: uses (evidence: `README.md`)
- Catalog and bag → Public content: reads catalog (evidence: `README.md`)
- Catalog and bag → Content runtime data: uses content (evidence: `README.md`)
- Shopper → WhatsApp: continues order (evidence: `README.md`)
- Blog → Editorial articles: links articles
- Guide source data → Guide generator: provides data (evidence: `scripts/gerar_listas_blog.py`)
- Guide generator → Shopping guides: generates guides (evidence: `scripts/gerar_listas_blog.py`)
- Panel page → Panel interface: loads interface
- Panel interface → Local admin server: requests API (evidence: `admin/admin.js`)
- Local admin server → Draft storage: reads and writes (evidence: `README.md`)
- Panel interface → Photo library: uploads and lists (evidence: `admin/admin.js`)
- Local admin server → Photo library: stores uploads (evidence: `admin_server.py`)
- Local admin server → Public content: validates and writes (evidence: `admin_server.py`)
- Local admin server → Content runtime data: writes runtime data (evidence: `admin_server.py`)
- Panel interface → Preview and ZIP: opens preview or ZIP (evidence: `README.md`)
- Local admin server → GitHub: commits and pushes (evidence: `admin_server.py`)
- GitHub → GitHub Pages: triggers deployment (evidence: `README.md`)
