# fullcycle-gt4/food-promotion architecture

> Architecture diagram of the GitHub repository fullcycle-gt4/food-promotion, 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/fullcycle-gt4/food-promotion
- Repository: https://github.com/fullcycle-gt4/food-promotion

## Overview

Este repositório é uma interface React para compras e administração de produtos com preços promocionais, carrinho e pedidos; embora o README a descreva como um microserviço de promoções, a árvore e as fontes mostradas são de uma aplicação web. O fluxo principal vai do catálogo à criação do pedido, com áreas separadas de autenticação e administração de produtos e pedidos. Os serviços de produto e pedido mantêm dados em memória e usam dados iniciais; não há banco ou API externa evidenciada nas fontes fornecidas. Algumas telas administrativas e de cliente constam na árvore, mas não foram inspecionadas em detalhe.

Main entry points: [`src/App.jsx`](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/App.jsx) (Rotas da aplicação), [`src/services/index.js`](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/index.js) (Serviços da aplicação), [`src/pages/client/Catalog.jsx`](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/Catalog.jsx) (Catálogo), [`src/services/orderService.js`](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/orderService.js) (Serviço de pedidos)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Aplicação e acesso"]
  node_app_routes["Rotas da aplicação<br/>[App.jsx]"]
  node_auth_guard["Guarda de acesso<br/>[RequireAuth.jsx]"]
  node_auth_pages["Login e cadastro<br/>[Login.jsx]"]
end

subgraph group_shop["Compra do cliente"]
  node_catalog["Catálogo<br/>[Catalog.jsx]"]
  node_product_detail["Detalhe do produto<br/>[ProductDetail.jsx]"]
  node_cart_page["Carrinho e checkout<br/>[Cart.jsx]"]
  node_my_orders["Pedidos do cliente<br/>[MyOrders.jsx]"]
  node_client_profile["Perfil do cliente<br/>[Profile.jsx]"]
end

subgraph group_admin["Administração"]
  node_admin_products["Lista de produtos<br/>[Products.jsx]"]
  node_product_form["Cadastro de produto<br/>[ProductForm.jsx]"]
  node_admin_orders["Gestão de pedidos<br/>[Orders.jsx]"]
  node_admin_profile["Perfil administrativo<br/>[Profile.jsx]"]
end

subgraph group_data["Estado e serviços"]
  node_auth_state["Estado de autenticação<br/>[AuthContext.jsx]"]
  node_cart_state["Estado do carrinho<br/>[CartContext.jsx]"]
  node_service_facade["Serviços da aplicação<br/>[index.js]"]
  node_product_service["Serviço de produtos<br/>[productService.js]"]
  node_order_service["Serviço de pedidos<br/>[orderService.js]"]
  node_user_service["Serviço de usuários<br/>[userService.js]"]
  node_http_mock["Utilitários de serviço<br/>[http.js]"]
end

subgraph group_shared["Componentes compartilhados"]
  node_async_hook["Carregamento assíncrono<br/>[useAsync.js]"]
  node_product_card["Cartão de produto<br/>[ProductCard.jsx]"]
  node_ui_components["Componentes de interface<br/>[ui.jsx]"]
  node_toast["Notificações<br/>[Toast.jsx]"]
  node_format_utils["Formatação monetária<br/>[format.js]"]
  node_date_utils["Datas e vencimento<br/>[date.js]"]
  node_labels_utils["Rótulos de status<br/>[labels.js]"]
  node_masks_utils["Máscaras de entrada<br/>[masks.js]"]
end

node_customer(("Cliente"))
node_admin_user(("Administrador"))

node_customer -->|"acessa"| node_app_routes
node_admin_user -->|"acessa"| node_app_routes
node_app_routes -->|"protege rotas"| node_auth_guard
node_app_routes -->|"roteia para"| node_auth_pages
node_app_routes -->|"roteia para"| node_catalog
node_app_routes -->|"roteia para"| node_product_detail
node_app_routes -->|"roteia para"| node_cart_page
node_app_routes -->|"roteia para"| node_my_orders
node_app_routes -->|"roteia para"| node_client_profile
node_app_routes -->|"roteia para"| node_admin_products
node_app_routes -->|"roteia para"| node_product_form
node_app_routes -->|"roteia para"| node_admin_orders
node_app_routes -->|"roteia para"| node_admin_profile
node_auth_guard -->|"consulta usuário"| node_auth_state
node_auth_pages -->|"usa autenticação"| node_auth_state
node_auth_state -->|"chama serviços"| node_service_facade
node_catalog -->|"consulta produtos"| node_service_facade
node_catalog -->|"carrega dados"| node_async_hook
node_catalog -->|"adiciona ao carrinho"| node_cart_state
node_catalog -->|"exibe itens"| node_product_card
node_product_detail -->|"consulta produto"| node_service_facade
node_product_detail -->|"carrega dados"| node_async_hook
node_product_detail -->|"adiciona ao carrinho"| node_cart_state
node_cart_page -->|"cria pedido"| node_service_facade
node_cart_page -->|"lê e atualiza"| node_cart_state
node_cart_page -->|"usa usuário"| node_auth_state
node_my_orders -->|"consulta pedidos"| node_service_facade
node_admin_products -->|"gerencia produtos"| node_service_facade
node_admin_products -->|"carrega dados"| node_async_hook
node_product_form -->|"salva produto"| node_service_facade
node_product_form -->|"carrega dados"| node_async_hook
node_admin_orders -->|"gerencia pedidos"| node_service_facade
node_admin_orders -->|"carrega dados"| node_async_hook
node_admin_profile -->|"atualiza perfil"| node_service_facade
node_client_profile -.->|"usa serviços"| node_service_facade
node_service_facade -->|"exporta serviço"| node_product_service
node_service_facade -->|"exporta serviço"| node_order_service
node_service_facade -->|"exporta serviço"| node_user_service
node_product_service -->|"usa utilitários"| node_http_mock
node_product_service -->|"calcula vencimento"| node_date_utils
node_order_service -->|"busca produto"| node_product_service
node_order_service -->|"baixa estoque"| node_product_service
node_order_service -->|"usa utilitários"| node_http_mock
node_order_service -->|"calcula retirada"| node_date_utils
node_product_card -->|"usa interface"| node_ui_components
node_ui_components -->|"formata preços"| node_format_utils
node_ui_components -->|"calcula vencimento"| node_date_utils
node_ui_components -->|"exibe status"| node_labels_utils

click node_app_routes "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/App.jsx"
click node_auth_guard "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/components/RequireAuth.jsx"
click node_auth_pages "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/auth/Login.jsx"
click node_auth_state "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/context/AuthContext.jsx"
click node_catalog "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/Catalog.jsx"
click node_product_detail "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/ProductDetail.jsx"
click node_cart_page "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/Cart.jsx"
click node_cart_state "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/context/CartContext.jsx"
click node_my_orders "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/MyOrders.jsx"
click node_admin_products "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/admin/Products.jsx"
click node_product_form "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/admin/ProductForm.jsx"
click node_admin_orders "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/admin/Orders.jsx"
click node_admin_profile "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/admin/Profile.jsx"
click node_client_profile "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/Profile.jsx"
click node_service_facade "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/index.js"
click node_product_service "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/productService.js"
click node_order_service "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/orderService.js"
click node_user_service "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/userService.js"
click node_http_mock "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/http.js"
click node_async_hook "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/hooks/useAsync.js"
click node_product_card "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/components/ProductCard.jsx"
click node_ui_components "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/components/ui.jsx"
click node_toast "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/components/Toast.jsx"
click node_format_utils "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/utils/format.js"
click node_date_utils "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/utils/date.js"
click node_labels_utils "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/utils/labels.js"
click node_masks_utils "https://github.com/fullcycle-gt4/food-promotion/blob/main/src/utils/masks.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_app_routes,node_auth_guard,node_auth_pages,node_customer toneBlue
class node_catalog,node_product_detail,node_cart_page,node_my_orders,node_client_profile toneAmber
class node_admin_products,node_product_form,node_admin_orders,node_admin_profile toneMint
class node_auth_state,node_cart_state,node_service_facade,node_product_service,node_order_service,node_user_service,node_http_mock toneRose
class node_async_hook,node_product_card,node_ui_components,node_toast,node_format_utils,node_date_utils,node_labels_utils,node_masks_utils,node_admin_user toneIndigo
```

## Components

### Aplicação e acesso

- [Rotas da aplicação](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/App.jsx): `src/App.jsx`
- [Guarda de acesso](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/components/RequireAuth.jsx): `src/components/RequireAuth.jsx`
- [Login e cadastro](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/auth/Login.jsx): `src/pages/auth/Login.jsx`

### Compra do cliente

- [Catálogo](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/Catalog.jsx): `src/pages/client/Catalog.jsx`
- [Detalhe do produto](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/ProductDetail.jsx): `src/pages/client/ProductDetail.jsx`
- [Carrinho e checkout](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/Cart.jsx): `src/pages/client/Cart.jsx`
- [Pedidos do cliente](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/MyOrders.jsx): `src/pages/client/MyOrders.jsx`
- [Perfil do cliente](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/client/Profile.jsx): `src/pages/client/Profile.jsx`

### Administração

- [Lista de produtos](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/admin/Products.jsx): `src/pages/admin/Products.jsx`
- [Cadastro de produto](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/admin/ProductForm.jsx): `src/pages/admin/ProductForm.jsx`
- [Gestão de pedidos](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/admin/Orders.jsx): `src/pages/admin/Orders.jsx`
- [Perfil administrativo](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/pages/admin/Profile.jsx): `src/pages/admin/Profile.jsx`

### Estado e serviços

- [Estado de autenticação](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Estado do carrinho](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/context/CartContext.jsx): `src/context/CartContext.jsx`
- [Serviços da aplicação](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/index.js): `src/services/index.js`
- [Serviço de produtos](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/productService.js): `src/services/productService.js`
- [Serviço de pedidos](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/orderService.js): `src/services/orderService.js`
- [Serviço de usuários](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/userService.js): `src/services/userService.js`
- [Utilitários de serviço](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/services/http.js): `src/services/http.js`

### Componentes compartilhados

- [Carregamento assíncrono](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/hooks/useAsync.js): `src/hooks/useAsync.js`
- [Cartão de produto](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/components/ProductCard.jsx): `src/components/ProductCard.jsx`
- [Componentes de interface](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/components/ui.jsx): `src/components/ui.jsx`
- [Notificações](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/components/Toast.jsx): `src/components/Toast.jsx`
- [Formatação monetária](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/utils/format.js): `src/utils/format.js`
- [Datas e vencimento](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/utils/date.js): `src/utils/date.js`
- [Rótulos de status](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/utils/labels.js): `src/utils/labels.js`
- [Máscaras de entrada](https://github.com/fullcycle-gt4/food-promotion/blob/main/src/utils/masks.js): `src/utils/masks.js`

### Other components

- **Cliente**
- **Administrador**

## Connections

- Cliente → Rotas da aplicação: acessa (evidence: `src/App.jsx`)
- Administrador → Rotas da aplicação: acessa (evidence: `src/App.jsx`)
- Rotas da aplicação → Guarda de acesso: protege rotas (evidence: `src/App.jsx`)
- Rotas da aplicação → Login e cadastro: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Catálogo: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Detalhe do produto: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Carrinho e checkout: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Pedidos do cliente: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Perfil do cliente: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Lista de produtos: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Cadastro de produto: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Gestão de pedidos: roteia para (evidence: `src/App.jsx`)
- Rotas da aplicação → Perfil administrativo: roteia para (evidence: `src/App.jsx`)
- Guarda de acesso → Estado de autenticação: consulta usuário (evidence: `src/components/RequireAuth.jsx`)
- Login e cadastro → Estado de autenticação: usa autenticação (evidence: `src/pages/auth/Login.jsx`)
- Estado de autenticação → Serviços da aplicação: chama serviços (evidence: `src/context/AuthContext.jsx`)
- Catálogo → Serviços da aplicação: consulta produtos (evidence: `src/pages/client/Catalog.jsx`)
- Catálogo → Carregamento assíncrono: carrega dados (evidence: `src/pages/client/Catalog.jsx`)
- Catálogo → Estado do carrinho: adiciona ao carrinho (evidence: `src/pages/client/Catalog.jsx`)
- Catálogo → Cartão de produto: exibe itens (evidence: `src/pages/client/Catalog.jsx`)
- Detalhe do produto → Serviços da aplicação: consulta produto (evidence: `src/pages/client/ProductDetail.jsx`)
- Detalhe do produto → Carregamento assíncrono: carrega dados (evidence: `src/pages/client/ProductDetail.jsx`)
- Detalhe do produto → Estado do carrinho: adiciona ao carrinho (evidence: `src/pages/client/ProductDetail.jsx`)
- Carrinho e checkout → Serviços da aplicação: cria pedido (evidence: `src/pages/client/Cart.jsx`)
- Carrinho e checkout → Estado do carrinho: lê e atualiza (evidence: `src/pages/client/Cart.jsx`)
- Carrinho e checkout → Estado de autenticação: usa usuário (evidence: `src/pages/client/Cart.jsx`)
- Pedidos do cliente → Serviços da aplicação: consulta pedidos
- Lista de produtos → Serviços da aplicação: gerencia produtos (evidence: `src/pages/admin/Products.jsx`)
- Lista de produtos → Carregamento assíncrono: carrega dados (evidence: `src/pages/admin/Products.jsx`)
- Cadastro de produto → Serviços da aplicação: salva produto (evidence: `src/pages/admin/ProductForm.jsx`)
- Cadastro de produto → Carregamento assíncrono: carrega dados (evidence: `src/pages/admin/ProductForm.jsx`)
- Gestão de pedidos → Serviços da aplicação: gerencia pedidos (evidence: `src/pages/admin/Orders.jsx`)
- Gestão de pedidos → Carregamento assíncrono: carrega dados (evidence: `src/pages/admin/Orders.jsx`)
- Perfil administrativo → Serviços da aplicação: atualiza perfil (evidence: `src/pages/admin/Profile.jsx`)
- Perfil do cliente → Serviços da aplicação: usa serviços
- Serviços da aplicação → Serviço de produtos: exporta serviço (evidence: `src/services/index.js`)
- Serviços da aplicação → Serviço de pedidos: exporta serviço (evidence: `src/services/index.js`)
- Serviços da aplicação → Serviço de usuários: exporta serviço (evidence: `src/services/index.js`)
- Serviço de produtos → Utilitários de serviço: usa utilitários (evidence: `src/services/productService.js`)
- Serviço de produtos → Datas e vencimento: calcula vencimento (evidence: `src/services/productService.js`)
- Serviço de pedidos → Serviço de produtos: busca produto (evidence: `src/services/orderService.js`)
- Serviço de pedidos → Serviço de produtos: baixa estoque (evidence: `src/services/orderService.js`)
- Serviço de pedidos → Utilitários de serviço: usa utilitários (evidence: `src/services/orderService.js`)
- Serviço de pedidos → Datas e vencimento: calcula retirada (evidence: `src/services/orderService.js`)
- Cartão de produto → Componentes de interface: usa interface (evidence: `src/components/ProductCard.jsx`)
- Componentes de interface → Formatação monetária: formata preços (evidence: `src/components/ui.jsx`)
- Componentes de interface → Datas e vencimento: calcula vencimento (evidence: `src/components/ui.jsx`)
- Componentes de interface → Rótulos de status: exibe status (evidence: `src/components/ui.jsx`)
