# darlan000/darlan-workspace architecture

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

## Overview

O produto é um workspace web para cadastro/login, aprovação de usuários e acesso a ferramentas de impressão: cálculo de lombada e geração de gabarito em PDF. O fluxo principal passa pelo cadastro ou login, segue para o painel protegido e então para a ferramenta escolhida. O servidor usa Supabase para usuários e Telegram para aprovação; JWT protege as rotas do painel. O README documenta a geração de PDF, mas a implementação correspondente não foi amostrada; as ligações dessa funcionalidade refletem apenas a documentação.

Main entry points: [`src/routers/usuarios.js`](https://github.com/darlan000/darlan-workspace/blob/main/src/routers/usuarios.js) (Rotas de usuário), [`src/routers/painelRoutes.js`](https://github.com/darlan000/darlan-workspace/blob/main/src/routers/painelRoutes.js) (Rotas do painel), [`server.js`](https://github.com/darlan000/darlan-workspace/blob/main/server.js) (Servidor Express), [`src/services/telegramService.js`](https://github.com/darlan000/darlan-workspace/blob/main/src/services/telegramService.js) (Aprovação Telegram)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Interface web"]
  node_login["Login e cadastro<br/>[index.html]"]
  node_panel["Painel de ferramentas<br/>[painel.html]"]
  node_lombada_ui["Formulário de lombada"]
  node_pdf_ui["Gerador de gabarito"]
end

subgraph group_identity["Acesso e usuários"]
  node_auth_routes["Rotas de usuário<br/>[usuarios.js]"]
  node_signup_check["Validação de cadastro"]
  node_login_check["Validação de login<br/>[validacaologin.js]"]
  node_jwt_cookie["Cookie JWT<br/>[token.js]"]
  node_auth_guard["Proteção de rotas<br/>[verificarToken.js]"]
end

subgraph group_tools["Ferramentas"]
  node_panel_routes["Rotas do painel<br/>[painelRoutes.js]"]
  node_lombada_calc["Cálculo lombada"]
  node_pdf_generator["Geração de PDF<br/>[geradorgabarito.js]"]
end

subgraph group_integrations["Integrações"]
  node_supabase[("Banco Supabase<br/>[supabase.js]")]
  node_telegram_service["Aprovação Telegram<br/>[telegramService.js]"]
  node_telegram_bot["Bot Telegram<br/>[telegram.js]"]
end

node_visitor(("Pessoa usuária"))
node_server["Servidor Express<br/>[server.js]"]

node_visitor -->|"inicia acesso"| node_login
node_login -->|"envia cadastro/login"| node_auth_routes
node_server -->|"monta em /api"| node_auth_routes
node_server -->|"monta em /painel"| node_panel_routes
node_server -->|"serve arquivos"| node_login
node_auth_routes -->|"valida cadastro"| node_signup_check
node_auth_routes -->|"valida login"| node_login_check
node_auth_routes -->|"grava/consulta usuário"| node_supabase
node_auth_routes -->|"gera cookie"| node_jwt_cookie
node_auth_routes -->|"notifica cadastro"| node_telegram_service
node_telegram_service -->|"envia mensagem"| node_telegram_bot
node_telegram_service -->|"atualiza aprovação"| node_supabase
node_panel_routes -->|"protege rotas"| node_auth_guard
node_panel_routes -->|"serve página"| node_panel
node_panel_routes -->|"serve página"| node_lombada_ui
node_panel_routes -->|"serve página"| node_pdf_ui
node_panel_routes -->|"despacha cálculo"| node_lombada_calc
node_visitor -->|"escolhe ferramenta"| node_panel
node_lombada_ui -.->|"solicita cálculo"| node_lombada_calc
node_pdf_ui -.->|"solicita geração"| node_pdf_generator

click node_server "https://github.com/darlan000/darlan-workspace/blob/main/server.js"
click node_login "https://github.com/darlan000/darlan-workspace/blob/main/public/index.html"
click node_panel "https://github.com/darlan000/darlan-workspace/blob/main/src/pages/painel.html"
click node_lombada_ui "https://github.com/darlan000/darlan-workspace/blob/main/src/pages/calculodelombada.html"
click node_pdf_ui "https://github.com/darlan000/darlan-workspace/blob/main/src/pages/geradorgabarito.html"
click node_auth_routes "https://github.com/darlan000/darlan-workspace/blob/main/src/routers/usuarios.js"
click node_signup_check "https://github.com/darlan000/darlan-workspace/blob/main/src/middlewares/validacaoCadastro.js"
click node_login_check "https://github.com/darlan000/darlan-workspace/blob/main/src/middlewares/validacaologin.js"
click node_jwt_cookie "https://github.com/darlan000/darlan-workspace/blob/main/src/services/token.js"
click node_auth_guard "https://github.com/darlan000/darlan-workspace/blob/main/src/middlewares/verificarToken.js"
click node_supabase "https://github.com/darlan000/darlan-workspace/blob/main/src/config/supabase.js"
click node_telegram_service "https://github.com/darlan000/darlan-workspace/blob/main/src/services/telegramService.js"
click node_telegram_bot "https://github.com/darlan000/darlan-workspace/blob/main/src/config/telegram.js"
click node_panel_routes "https://github.com/darlan000/darlan-workspace/blob/main/src/routers/painelRoutes.js"
click node_lombada_calc "https://github.com/darlan000/darlan-workspace/blob/main/src/controllers/calculodelombada.js"
click node_pdf_generator "https://github.com/darlan000/darlan-workspace/blob/main/src/controllers/geradorgabarito.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_login,node_panel,node_lombada_ui,node_pdf_ui toneBlue
class node_auth_routes,node_signup_check,node_login_check,node_jwt_cookie,node_auth_guard toneAmber
class node_panel_routes,node_lombada_calc,node_pdf_generator toneMint
class node_supabase,node_telegram_service,node_telegram_bot toneRose
class node_visitor toneIndigo
class node_server toneTeal
```

## Components

### Interface web

- [Login e cadastro](https://github.com/darlan000/darlan-workspace/blob/main/public/index.html): `public/index.html`
- [Painel de ferramentas](https://github.com/darlan000/darlan-workspace/blob/main/src/pages/painel.html): `src/pages/painel.html`
- [Formulário de lombada](https://github.com/darlan000/darlan-workspace/blob/main/src/pages/calculodelombada.html): `src/pages/calculodelombada.html`
- [Gerador de gabarito](https://github.com/darlan000/darlan-workspace/blob/main/src/pages/geradorgabarito.html): `src/pages/geradorgabarito.html`

### Acesso e usuários

- [Rotas de usuário](https://github.com/darlan000/darlan-workspace/blob/main/src/routers/usuarios.js): `src/routers/usuarios.js`
- [Validação de cadastro](https://github.com/darlan000/darlan-workspace/blob/main/src/middlewares/validacaoCadastro.js): `src/middlewares/validacaoCadastro.js`
- [Validação de login](https://github.com/darlan000/darlan-workspace/blob/main/src/middlewares/validacaologin.js): `src/middlewares/validacaologin.js`
- [Cookie JWT](https://github.com/darlan000/darlan-workspace/blob/main/src/services/token.js): `src/services/token.js`
- [Proteção de rotas](https://github.com/darlan000/darlan-workspace/blob/main/src/middlewares/verificarToken.js): `src/middlewares/verificarToken.js`

### Ferramentas

- [Rotas do painel](https://github.com/darlan000/darlan-workspace/blob/main/src/routers/painelRoutes.js): `src/routers/painelRoutes.js`
- [Cálculo lombada](https://github.com/darlan000/darlan-workspace/blob/main/src/controllers/calculodelombada.js): `src/controllers/calculodelombada.js`
- [Geração de PDF](https://github.com/darlan000/darlan-workspace/blob/main/src/controllers/geradorgabarito.js): `src/controllers/geradorgabarito.js`

### Integrações

- [Banco Supabase](https://github.com/darlan000/darlan-workspace/blob/main/src/config/supabase.js): `src/config/supabase.js`
- [Aprovação Telegram](https://github.com/darlan000/darlan-workspace/blob/main/src/services/telegramService.js): `src/services/telegramService.js`
- [Bot Telegram](https://github.com/darlan000/darlan-workspace/blob/main/src/config/telegram.js): `src/config/telegram.js`

### Other components

- **Pessoa usuária**
- [Servidor Express](https://github.com/darlan000/darlan-workspace/blob/main/server.js): `server.js`

## Connections

- Pessoa usuária → Login e cadastro: inicia acesso (evidence: `README.md`)
- Login e cadastro → Rotas de usuário: envia cadastro/login (evidence: `README.md`)
- Servidor Express → Rotas de usuário: monta em /api (evidence: `server.js`)
- Servidor Express → Rotas do painel: monta em /painel (evidence: `server.js`)
- Servidor Express → Login e cadastro: serve arquivos (evidence: `server.js`)
- Rotas de usuário → Validação de cadastro: valida cadastro (evidence: `src/routers/usuarios.js`)
- Rotas de usuário → Validação de login: valida login (evidence: `src/routers/usuarios.js`)
- Rotas de usuário → Banco Supabase: grava/consulta usuário (evidence: `src/routers/usuarios.js`)
- Rotas de usuário → Cookie JWT: gera cookie (evidence: `src/routers/usuarios.js`)
- Rotas de usuário → Aprovação Telegram: notifica cadastro (evidence: `src/routers/usuarios.js`)
- Aprovação Telegram → Bot Telegram: envia mensagem (evidence: `src/services/telegramService.js`)
- Aprovação Telegram → Banco Supabase: atualiza aprovação (evidence: `src/services/telegramService.js`)
- Rotas do painel → Proteção de rotas: protege rotas (evidence: `src/routers/painelRoutes.js`)
- Rotas do painel → Painel de ferramentas: serve página (evidence: `src/routers/painelRoutes.js`)
- Rotas do painel → Formulário de lombada: serve página (evidence: `src/routers/painelRoutes.js`)
- Rotas do painel → Gerador de gabarito: serve página (evidence: `src/routers/painelRoutes.js`)
- Rotas do painel → Cálculo lombada: despacha cálculo (evidence: `src/routers/painelRoutes.js`)
- Pessoa usuária → Painel de ferramentas: escolhe ferramenta (evidence: `README.md`)
- Formulário de lombada → Cálculo lombada: solicita cálculo
- Gerador de gabarito → Geração de PDF: solicita geração (evidence: `README.md`)
