# victorbarsanele/barbearia-agendamento-ia architecture

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

- Interactive diagram: https://gitdiagram.com/victorbarsanele/barbearia-agendamento-ia
- Repository: https://github.com/victorbarsanele/barbearia-agendamento-ia

## Overview

Barbearia IA combina um painel administrativo para cadastros e agenda com automação de agendamentos pelo WhatsApp usando IA. O fluxo administrativo passa do painel à API e às regras de negócio; o fluxo automatizado chega pelo webhook, usa Gemini e pode escalar para atendimento humano. O README documenta essas capacidades, mas os trechos de código são parciais: relações sem evidência direta foram omitidas ou marcadas como não verificadas.

Main entry points: [`painel/src/services/api.ts`](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/api.ts) (Cliente HTTP), [`src/lib/prisma.ts`](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/lib/prisma.ts) (PostgreSQL), [`painel/src/App.tsx`](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/App.tsx) (Aplicação do painel), [`painel/src/pages/ClientesPage.tsx`](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/pages/ClientesPage.tsx) (Gestão de clientes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_panel["Painel administrativo"]
  node_panel_app["Aplicação do painel<br/>[App.tsx]"]
  node_appointments_ui["Operação de agenda"]
  node_client_ui["Gestão de clientes<br/>[ClientesPage.tsx]"]
  node_package_ui["Pacotes de clientes"]
  node_appointment_client["Serviço de agendamentos"]
  node_client_client["Serviço de clientes"]
  node_package_client["Serviço de pacotes"]
  node_api_client["Cliente HTTP<br/>[api.ts]"]
end

subgraph group_api["API e domínio"]
  node_server["Servidor Fastify<br/>[server.ts]"]
  node_appointment_route["Rotas de agenda"]
  node_appointment_controller["Controlador de agenda"]
  node_appointment_domain["Regras de agendamento"]
  node_schedule_rules["Regras de funcionamento"]
  node_client_controller["Controlador de clientes"]
  node_client_domain["Regras de clientes<br/>[cliente.service.ts]"]
  node_package_controller["Controlador de pacotes"]
  node_package_domain["Regras de pacotes<br/>[pacote.service.ts]"]
end

subgraph group_automation["Automação WhatsApp"]
  node_webhook_controller["Tratamento de webhook"]
  node_gemini["Conversação e ferramentas IA<br/>[gemini.service.ts]"]
  node_whatsapp["Evolution API"]
  node_human(("Atendimento humano"))
  node_google_ai["Google Gemini"]
end

subgraph group_data["Persistência"]
  node_appointment_repo["Repositório de agenda"]
  node_client_repo["Repositório de clientes"]
  node_package_repo["Repositório de pacotes"]
  node_service_repo["Repositório de serviços"]
  node_database[("PostgreSQL<br/>[prisma.ts]")]
end

node_operator(("Equipe da barbearia"))

node_operator -->|"opera"| node_panel_app
node_panel_app -->|"roteia"| node_appointments_ui
node_panel_app -->|"roteia"| node_client_ui
node_client_ui -->|"abre"| node_package_ui
node_package_ui -->|"consulta"| node_package_client
node_package_ui -->|"usa dados"| node_client_client
node_client_ui -->|"consulta"| node_client_client
node_appointment_client -->|"envia requisições"| node_api_client
node_client_client -->|"envia requisições"| node_api_client
node_package_client -->|"envia requisições"| node_api_client
node_api_client -.->|"acessa API"| node_server
node_server -->|"registra"| node_appointment_route
node_appointment_route -->|"despacha"| node_appointment_controller
node_appointment_controller -->|"invoca"| node_appointment_domain
node_appointment_domain -->|"valida horários"| node_schedule_rules
node_appointment_domain -->|"consulta e grava"| node_appointment_repo
node_client_controller -->|"invoca"| node_client_domain
node_package_controller -->|"invoca"| node_package_domain
node_server -->|"registra rota"| node_webhook_controller
node_webhook_controller -->|"processa conversa"| node_gemini
node_gemini -.->|"consulta IA"| node_google_ai
node_whatsapp -.->|"envia eventos"| node_webhook_controller
node_gemini -->|"escala casos"| node_human
node_appointment_repo -->|"lê e grava"| node_database
node_client_repo -->|"lê e grava"| node_database
node_package_repo -->|"acessa"| node_database
node_service_repo -->|"acessa"| node_database
node_client_domain -.->|"usa"| node_client_repo
node_package_domain -.->|"usa"| node_package_repo

click node_panel_app "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/App.tsx"
click node_appointments_ui "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/pages/NovoAgendamentoPage.tsx"
click node_client_ui "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/pages/ClientesPage.tsx"
click node_package_ui "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/components/PacoteClienteModal.tsx"
click node_appointment_client "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/agendamentos.service.ts"
click node_client_client "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/clientes.service.ts"
click node_package_client "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/pacoteCliente.service.ts"
click node_api_client "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/api.ts"
click node_server "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/server.ts"
click node_appointment_route "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/routes/agendamento.routes.ts"
click node_appointment_controller "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/controllers/agendamento.controller.ts"
click node_appointment_domain "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/agendamento.service.ts"
click node_schedule_rules "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/horario-funcionamento.service.ts"
click node_client_controller "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/controllers/cliente.controller.ts"
click node_client_domain "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/cliente.service.ts"
click node_package_controller "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/controllers/pacote.controller.ts"
click node_package_domain "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/pacote.service.ts"
click node_webhook_controller "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/controllers/webhook.controller.ts"
click node_gemini "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/gemini.service.ts"
click node_appointment_repo "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/repositories/agendamento.repository.ts"
click node_client_repo "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/repositories/cliente.repository.ts"
click node_package_repo "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/repositories/pacote.repository.ts"
click node_service_repo "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/repositories/servico.repository.ts"
click node_database "https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/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_panel_app,node_appointments_ui,node_client_ui,node_package_ui,node_appointment_client,node_client_client,node_package_client,node_api_client toneBlue
class node_server,node_appointment_route,node_appointment_controller,node_appointment_domain,node_schedule_rules,node_client_controller,node_client_domain,node_package_controller,node_package_domain toneAmber
class node_webhook_controller,node_gemini,node_whatsapp,node_human,node_google_ai toneMint
class node_appointment_repo,node_client_repo,node_package_repo,node_service_repo,node_database toneRose
class node_operator toneIndigo
```

## Components

### Painel administrativo

- [Aplicação do painel](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/App.tsx): `painel/src/App.tsx`
- [Operação de agenda](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/pages/NovoAgendamentoPage.tsx): `painel/src/pages/NovoAgendamentoPage.tsx`
- [Gestão de clientes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/pages/ClientesPage.tsx): `painel/src/pages/ClientesPage.tsx`
- [Pacotes de clientes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/components/PacoteClienteModal.tsx): `painel/src/components/PacoteClienteModal.tsx`
- [Serviço de agendamentos](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/agendamentos.service.ts): `painel/src/services/agendamentos.service.ts`
- [Serviço de clientes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/clientes.service.ts): `painel/src/services/clientes.service.ts`
- [Serviço de pacotes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/pacoteCliente.service.ts): `painel/src/services/pacoteCliente.service.ts`
- [Cliente HTTP](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/painel/src/services/api.ts): `painel/src/services/api.ts`

### API e domínio

- [Servidor Fastify](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/server.ts): `server.ts`
- [Rotas de agenda](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/routes/agendamento.routes.ts): `src/routes/agendamento.routes.ts`
- [Controlador de agenda](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/controllers/agendamento.controller.ts): `src/controllers/agendamento.controller.ts`
- [Regras de agendamento](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/agendamento.service.ts): `src/services/agendamento.service.ts`
- [Regras de funcionamento](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/horario-funcionamento.service.ts): `src/services/horario-funcionamento.service.ts`
- [Controlador de clientes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/controllers/cliente.controller.ts): `src/controllers/cliente.controller.ts`
- [Regras de clientes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/cliente.service.ts): `src/services/cliente.service.ts`
- [Controlador de pacotes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/controllers/pacote.controller.ts): `src/controllers/pacote.controller.ts`
- [Regras de pacotes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/pacote.service.ts): `src/services/pacote.service.ts`

### Automação WhatsApp

- [Tratamento de webhook](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/controllers/webhook.controller.ts): `src/controllers/webhook.controller.ts`
- [Conversação e ferramentas IA](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/services/gemini.service.ts): `src/services/gemini.service.ts`
- **Evolution API**
- **Atendimento humano**
- **Google Gemini**

### Persistência

- [Repositório de agenda](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/repositories/agendamento.repository.ts): `src/repositories/agendamento.repository.ts`
- [Repositório de clientes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/repositories/cliente.repository.ts): `src/repositories/cliente.repository.ts`
- [Repositório de pacotes](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/repositories/pacote.repository.ts): `src/repositories/pacote.repository.ts`
- [Repositório de serviços](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/repositories/servico.repository.ts): `src/repositories/servico.repository.ts`
- [PostgreSQL](https://github.com/victorbarsanele/barbearia-agendamento-ia/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`

### Other components

- **Equipe da barbearia**

## Connections

- Equipe da barbearia → Aplicação do painel: opera (evidence: `README.md`)
- Aplicação do painel → Operação de agenda: roteia (evidence: `painel/src/App.tsx`)
- Aplicação do painel → Gestão de clientes: roteia (evidence: `painel/src/App.tsx`)
- Gestão de clientes → Pacotes de clientes: abre (evidence: `painel/src/pages/ClientesPage.tsx`)
- Pacotes de clientes → Serviço de pacotes: consulta (evidence: `painel/src/components/PacoteClienteModal.tsx`)
- Pacotes de clientes → Serviço de clientes: usa dados (evidence: `painel/src/components/PacoteClienteModal.tsx`)
- Gestão de clientes → Serviço de clientes: consulta (evidence: `painel/src/pages/ClientesPage.tsx`)
- Serviço de agendamentos → Cliente HTTP: envia requisições (evidence: `painel/src/services/agendamentos.service.ts`)
- Serviço de clientes → Cliente HTTP: envia requisições (evidence: `painel/src/services/clientes.service.ts`)
- Serviço de pacotes → Cliente HTTP: envia requisições (evidence: `painel/src/services/pacoteCliente.service.ts`)
- Cliente HTTP → Servidor Fastify: acessa API
- Servidor Fastify → Rotas de agenda: registra (evidence: `server.ts`)
- Rotas de agenda → Controlador de agenda: despacha (evidence: `src/routes/agendamento.routes.ts`)
- Controlador de agenda → Regras de agendamento: invoca (evidence: `src/controllers/agendamento.controller.ts`)
- Regras de agendamento → Regras de funcionamento: valida horários (evidence: `src/services/agendamento.service.ts`)
- Regras de agendamento → Repositório de agenda: consulta e grava (evidence: `src/services/agendamento.service.ts`)
- Controlador de clientes → Regras de clientes: invoca (evidence: `src/controllers/cliente.controller.ts`)
- Controlador de pacotes → Regras de pacotes: invoca (evidence: `src/controllers/pacote.controller.ts`)
- Servidor Fastify → Tratamento de webhook: registra rota (evidence: `server.ts`)
- Tratamento de webhook → Conversação e ferramentas IA: processa conversa (evidence: `src/controllers/webhook.controller.ts`)
- Conversação e ferramentas IA → Google Gemini: consulta IA (evidence: `README.md`)
- Evolution API → Tratamento de webhook: envia eventos (evidence: `README.md`)
- Conversação e ferramentas IA → Atendimento humano: escala casos (evidence: `src/services/gemini.service.ts`)
- Repositório de agenda → PostgreSQL: lê e grava (evidence: `src/repositories/agendamento.repository.ts`)
- Repositório de clientes → PostgreSQL: lê e grava (evidence: `src/repositories/cliente.repository.ts`)
- Repositório de pacotes → PostgreSQL: acessa (evidence: `src/repositories/pacote.repository.ts`)
- Repositório de serviços → PostgreSQL: acessa (evidence: `src/repositories/servico.repository.ts`)
- Regras de clientes → Repositório de clientes: usa
- Regras de pacotes → Repositório de pacotes: usa (evidence: `src/services/pacote.service.ts`)
