# rodolphoraposo/cuscuzdecasa architecture

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

- Interactive diagram: https://gitdiagram.com/rodolphoraposo/cuscuzdecasa
- Repository: https://github.com/rodolphoraposo/cuscuzdecasa

## Overview

Cuscuz de Casa is a digital menu and online ordering site for a local food business. Customers browse dishes, customize a selection, provide delivery or pickup details, review an order summary, and send the order as a WhatsApp comanda. The graph also shows delivery coverage and scheduling rules, the separate encomenda flow, and legal/privacy pages. The main routes and some helpers are evidenced by excerpts and the source index; the detailed behavior of unsampled pages is represented only where the README documents it.

Main entry points: [`src/pages/Pedido.tsx`](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Pedido.tsx) (Order details), [`src/App.tsx`](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/App.tsx) (Route application), [`src/pages/Finalizar.tsx`](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Finalizar.tsx) (Review and finalize), [`src/context/CartContext.tsx`](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/context/CartContext.tsx) (Persistent cart)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_browse["Menu and browsing"]
  node_home["Home and menu<br/>[Home.tsx]"]
  node_menu_data["Menu data<br/>[menu.ts]"]
  node_menu_view["Menu listing<br/>[Cardapio.tsx]"]
  node_product["Product details<br/>[ProductDetail.tsx]"]
  node_photo["Product photos<br/>[FotoProduto.tsx]"]
end

subgraph group_order["Order workflow"]
  node_cart["Persistent cart<br/>[CartContext.tsx]"]
  node_pedido["Order details<br/>[Pedido.tsx]"]
  node_finalize["Review and finalize<br/>[Finalizar.tsx]"]
  node_preview["Comanda preview<br/>[PreviaComanda.tsx]"]
  node_comanda["WhatsApp comanda<br/>[comanda.ts]"]
  node_whatsapp["WhatsApp"]
  node_sent["Order confirmation<br/>[PedidoEnviado.tsx]"]
  node_encomenda["Encomenda orders<br/>[Encomenda.tsx]"]
end

subgraph group_rules["Order rules"]
  node_cep["Postal code lookup<br/>[cep.ts]"]
  node_viacep["ViaCEP"]
  node_coverage["Delivery coverage<br/>[area.ts]"]
  node_geocep["CEP coordinates<br/>[geocep.ts]"]
  node_validation["Order validation<br/>[formulario.ts]"]
  node_schedule["Delivery schedule<br/>[entrega.ts]"]
end

subgraph group_site["Site support"]
  node_app["Route application<br/>[App.tsx]"]
  node_company["Company details<br/>[empresa.ts]"]
  node_legal["Legal and privacy<br/>[Termos.tsx]"]
  node_analytics["Usage analytics<br/>[analytics.ts]"]
  node_navigation["Menu navigation<br/>[navegacao.ts]"]
  node_ui["Shared UI<br/>[ui.tsx]"]
  node_title["Page title<br/>[usePageTitle.ts]"]
  node_noindex["No-index metadata<br/>[useNoIndex.ts]"]
end

node_customer(("Customer"))

node_customer -->|"opens site"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_product
node_app -->|"routes to"| node_pedido
node_app -->|"routes to"| node_finalize
node_app -->|"routes to"| node_encomenda
node_home -->|"renders"| node_menu_view
node_home -->|"queries coverage"| node_coverage
node_menu_view -->|"reads items"| node_menu_data
node_menu_view -->|"renders photos"| node_photo
node_product -->|"reads item"| node_menu_data
node_product -->|"renders photo"| node_photo
node_product -->|"adds selection"| node_cart
node_cart -->|"validates items"| node_menu_data
node_pedido -->|"reads and updates"| node_cart
node_pedido -->|"looks up CEP"| node_cep
node_cep -->|"queries address"| node_viacep
node_pedido -->|"checks delivery area"| node_geocep
node_geocep -->|"calculates coverage"| node_coverage
node_pedido -->|"validates details"| node_validation
node_pedido -->|"checks availability"| node_schedule
node_pedido -->|"continues order"| node_finalize
node_finalize -->|"reads order"| node_cart
node_finalize -->|"builds comanda"| node_comanda
node_finalize -->|"renders preview"| node_preview
node_finalize -->|"sends order"| node_whatsapp
node_whatsapp -.->|"returns to confirmation"| node_sent
node_encomenda -->|"builds comanda"| node_comanda
node_legal -->|"reads details"| node_company
node_app -->|"redirects legacy menu"| node_navigation
node_pedido -.->|"sets title"| node_title
node_pedido -->|"marks private route"| node_noindex
node_pedido -->|"renders controls"| node_ui
node_menu_view -->|"records events"| node_analytics
node_cart -->|"records cart events"| node_analytics

click node_app "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/App.tsx"
click node_home "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Home.tsx"
click node_menu_data "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/data/menu.ts"
click node_menu_view "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/components/Cardapio.tsx"
click node_product "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/ProductDetail.tsx"
click node_photo "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/components/FotoProduto.tsx"
click node_cart "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/context/CartContext.tsx"
click node_pedido "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Pedido.tsx"
click node_cep "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/cep.ts"
click node_coverage "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/area.ts"
click node_geocep "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/geocep.ts"
click node_validation "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/formulario.ts"
click node_schedule "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/entrega.ts"
click node_finalize "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Finalizar.tsx"
click node_preview "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/components/PreviaComanda.tsx"
click node_comanda "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/comanda.ts"
click node_sent "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/PedidoEnviado.tsx"
click node_encomenda "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Encomenda.tsx"
click node_company "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/data/empresa.ts"
click node_legal "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Termos.tsx"
click node_analytics "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/analytics.ts"
click node_navigation "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/navegacao.ts"
click node_ui "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/components/ui.tsx"
click node_title "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/hooks/usePageTitle.ts"
click node_noindex "https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/hooks/useNoIndex.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_home,node_menu_data,node_menu_view,node_product,node_photo toneBlue
class node_cart,node_pedido,node_finalize,node_preview,node_comanda,node_whatsapp,node_sent,node_encomenda toneAmber
class node_cep,node_viacep,node_coverage,node_geocep,node_validation,node_schedule toneMint
class node_app,node_company,node_legal,node_analytics,node_navigation,node_ui,node_title,node_noindex toneRose
class node_customer toneIndigo
```

## Components

### Menu and browsing

- [Home and menu](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Home.tsx): `src/pages/Home.tsx`
- [Menu data](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/data/menu.ts): `src/data/menu.ts`
- [Menu listing](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/components/Cardapio.tsx): `src/components/Cardapio.tsx`
- [Product details](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/ProductDetail.tsx): `src/pages/ProductDetail.tsx`
- [Product photos](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/components/FotoProduto.tsx): `src/components/FotoProduto.tsx`

### Order workflow

- [Persistent cart](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/context/CartContext.tsx): `src/context/CartContext.tsx`
- [Order details](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Pedido.tsx): `src/pages/Pedido.tsx`
- [Review and finalize](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Finalizar.tsx): `src/pages/Finalizar.tsx`
- [Comanda preview](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/components/PreviaComanda.tsx): `src/components/PreviaComanda.tsx`
- [WhatsApp comanda](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/comanda.ts): `src/lib/comanda.ts`
- **WhatsApp**
- [Order confirmation](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/PedidoEnviado.tsx): `src/pages/PedidoEnviado.tsx`
- [Encomenda orders](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Encomenda.tsx): `src/pages/Encomenda.tsx`

### Order rules

- [Postal code lookup](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/cep.ts): `src/lib/cep.ts`
- **ViaCEP**
- [Delivery coverage](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/area.ts): `src/lib/area.ts`
- [CEP coordinates](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/geocep.ts): `src/lib/geocep.ts`
- [Order validation](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/formulario.ts): `src/lib/formulario.ts`
- [Delivery schedule](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/entrega.ts): `src/lib/entrega.ts`

### Site support

- [Route application](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/App.tsx): `src/App.tsx`
- [Company details](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/data/empresa.ts): `src/data/empresa.ts`
- [Legal and privacy](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/pages/Termos.tsx): `src/pages/Termos.tsx`
- [Usage analytics](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/analytics.ts): `src/lib/analytics.ts`
- [Menu navigation](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/lib/navegacao.ts): `src/lib/navegacao.ts`
- [Shared UI](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/components/ui.tsx): `src/components/ui.tsx`
- [Page title](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/hooks/usePageTitle.ts): `src/hooks/usePageTitle.ts`
- [No-index metadata](https://github.com/rodolphoraposo/cuscuzdecasa/blob/main/src/hooks/useNoIndex.ts): `src/hooks/useNoIndex.ts`

### Other components

- **Customer**

## Connections

- Customer → Route application: opens site (evidence: `src/App.tsx`)
- Route application → Home and menu: routes to (evidence: `src/App.tsx`)
- Route application → Product details: routes to (evidence: `src/App.tsx`)
- Route application → Order details: routes to (evidence: `src/App.tsx`)
- Route application → Review and finalize: routes to (evidence: `src/App.tsx`)
- Route application → Encomenda orders: routes to (evidence: `src/App.tsx`)
- Home and menu → Menu listing: renders (evidence: `src/pages/Home.tsx`)
- Home and menu → Delivery coverage: queries coverage (evidence: `src/pages/Home.tsx`)
- Menu listing → Menu data: reads items (evidence: `src/components/Cardapio.tsx`)
- Menu listing → Product photos: renders photos
- Product details → Menu data: reads item (evidence: `src/pages/ProductDetail.tsx`)
- Product details → Product photos: renders photo (evidence: `src/pages/ProductDetail.tsx`)
- Product details → Persistent cart: adds selection (evidence: `src/pages/ProductDetail.tsx`)
- Persistent cart → Menu data: validates items (evidence: `src/context/CartContext.tsx`)
- Order details → Persistent cart: reads and updates (evidence: `src/pages/Pedido.tsx`)
- Order details → Postal code lookup: looks up CEP (evidence: `src/pages/Pedido.tsx`)
- Postal code lookup → ViaCEP: queries address (evidence: `README.md`)
- Order details → CEP coordinates: checks delivery area (evidence: `src/pages/Pedido.tsx`)
- CEP coordinates → Delivery coverage: calculates coverage (evidence: `src/lib/geocep.ts`)
- Order details → Order validation: validates details (evidence: `src/pages/Pedido.tsx`)
- Order details → Delivery schedule: checks availability (evidence: `src/pages/Pedido.tsx`)
- Order details → Review and finalize: continues order (evidence: `README.md`)
- Review and finalize → Persistent cart: reads order (evidence: `src/pages/Finalizar.tsx`)
- Review and finalize → WhatsApp comanda: builds comanda (evidence: `src/pages/Finalizar.tsx`)
- Review and finalize → Comanda preview: renders preview (evidence: `src/pages/Finalizar.tsx`)
- Review and finalize → WhatsApp: sends order (evidence: `README.md`)
- WhatsApp → Order confirmation: returns to confirmation (evidence: `README.md`)
- Encomenda orders → WhatsApp comanda: builds comanda (evidence: `src/pages/Encomenda.tsx`)
- Legal and privacy → Company details: reads details (evidence: `src/pages/Termos.tsx`)
- Route application → Menu navigation: redirects legacy menu (evidence: `src/App.tsx`)
- Order details → Page title: sets title (evidence: `README.md`)
- Order details → No-index metadata: marks private route (evidence: `src/pages/Pedido.tsx`)
- Order details → Shared UI: renders controls (evidence: `src/pages/Pedido.tsx`)
- Menu listing → Usage analytics: records events (evidence: `src/components/Cardapio.tsx`)
- Persistent cart → Usage analytics: records cart events (evidence: `src/context/CartContext.tsx`)
