# brunogfv/kanban-gamificado architecture

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

- Interactive diagram: https://gitdiagram.com/brunogfv/kanban-gamificado
- Repository: https://github.com/brunogfv/kanban-gamificado

## Overview

Kanban Gamificado é uma aplicação pessoal de gestão de tarefas: usuários autenticam-se, organizam tarefas num quadro e acompanham progresso e gamificação. O frontend React chama a API Express; a documentação descreve o backend em camadas de rotas, controllers, services e repositories. PostgreSQL guarda dados transacionais e é a fonte da verdade de XP, nível e streak; MongoDB guarda documentos flexíveis, com gravações de gamificação após conclusão em melhor esforço. Os vínculos entre módulos refletem relações mostradas nos trechos, no índice de fontes ou na arquitetura documentada; subsistemas não amostrados têm apenas relações documentadas.

Main entry points: [`backend/src/services/tarefas.service.js`](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/tarefas.service.js) (Serviço tarefas), [`backend/src/routes`](https://github.com/brunogfv/kanban-gamificado/tree/main/backend/src/routes) (Rotas API), [`frontend/src/api/cliente.js`](https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/api/cliente.js) (Cliente HTTP), [`frontend/src/App.jsx`](https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/App.jsx) (Rotas da aplicação)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Aplicação React"]
  node_app["Rotas da aplicação<br/>[App.jsx]"]
  node_authui["Sessão frontend<br/>[AuthContext.jsx]"]
  node_board["Quadro Kanban<br/>[Quadro.jsx]"]
  node_taskui["Componentes de tarefa"]
  node_taskhooks["Hooks de tarefas<br/>[useTarefas.js]"]
  node_reportsui["Relatórios<br/>[Relatorios.jsx]"]
  node_gamiui["Interface gamificada"]
  node_client["Cliente HTTP<br/>[cliente.js]"]
end

subgraph group_api["API e autenticação"]
  node_express["Aplicação Express<br/>[app.js]"]
  node_routes["Rotas API"]
  node_auth["Autenticação JWT<br/>[auth.service.js]"]
  node_taskctrl["Controller tarefas"]
end

subgraph group_tasks["Tarefas e organização"]
  node_taskservice["Serviço tarefas<br/>[tarefas.service.js]"]
  node_taskrepo["Repositório tarefas"]
  node_notes["Anotações"]
  node_labels["Etiquetas"]
end

subgraph group_progress["Gamificação e relatórios"]
  node_history["Histórico"]
  node_gamification["Serviço gamificação"]
  node_reportservice["Relatórios"]
end

subgraph group_persistence["Persistência"]
  node_pg[("PostgreSQL<br/>[postgres.js]")]
  node_mongo[("Modelos MongoDB<br/>[index.js]")]
end

node_user(("Usuário"))

node_user -->|"usa"| node_app
node_app -->|"roteia"| node_board
node_app -->|"roteia"| node_reportsui
node_board -->|"renderiza"| node_taskui
node_board -->|"usa"| node_taskhooks
node_taskhooks -->|"chama"| node_client
node_reportsui -->|"consulta"| node_client
node_authui -->|"autentica"| node_client
node_client -->|"HTTP/JSON + JWT"| node_express
node_express -->|"monta /api"| node_routes
node_routes -->|"despacha"| node_taskctrl
node_taskctrl -->|"chama"| node_taskservice
node_routes -->|"rotas de sessão"| node_auth
node_routes -.->|"encaminha operações"| node_taskservice
node_taskservice -->|"consulta e grava"| node_taskrepo
node_taskrepo -->|"acessa"| node_pg
node_taskservice -->|"registra eventos"| node_history
node_taskservice -->|"registra conclusão"| node_gamification
node_taskservice -->|"limpa anotações"| node_mongo
node_taskservice -.->|"opera anotações"| node_notes
node_taskservice -.->|"opera etiquetas"| node_labels
node_gamification -->|"consulta dados"| node_pg
node_gamification -->|"grava eventos"| node_mongo
node_reportservice -.->|"consulta relatórios"| node_pg
node_reportservice -.->|"agrega perfil"| node_mongo
node_reportsui -.->|"exibe progresso"| node_gamiui

click node_app "https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/contexts/AuthContext.jsx"
click node_board "https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/pages/Quadro.jsx"
click node_taskui "https://github.com/brunogfv/kanban-gamificado/tree/main/frontend/src/components/tarefas"
click node_taskhooks "https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/hooks/useTarefas.js"
click node_reportsui "https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/pages/Relatorios.jsx"
click node_gamiui "https://github.com/brunogfv/kanban-gamificado/tree/main/frontend/src/components/gamificacao"
click node_client "https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/api/cliente.js"
click node_express "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/app.js"
click node_routes "https://github.com/brunogfv/kanban-gamificado/tree/main/backend/src/routes"
click node_auth "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/auth.service.js"
click node_taskctrl "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/controllers/tarefas.controller.js"
click node_taskservice "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/tarefas.service.js"
click node_taskrepo "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/repositories/tarefas.repository.js"
click node_notes "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/anotacoes.service.js"
click node_labels "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/etiquetas.service.js"
click node_history "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/historico.service.js"
click node_gamification "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/gamificacao.service.js"
click node_reportservice "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/relatorios.service.js"
click node_pg "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/config/postgres.js"
click node_mongo "https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/models/mongo/index.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,node_authui,node_board,node_taskui,node_taskhooks,node_reportsui,node_gamiui,node_client toneBlue
class node_express,node_routes,node_auth,node_taskctrl toneAmber
class node_taskservice,node_taskrepo,node_notes,node_labels toneMint
class node_history,node_gamification,node_reportservice toneRose
class node_pg,node_mongo,node_user toneIndigo
```

## Components

### Aplicação React

- [Rotas da aplicação](https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Sessão frontend](https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/contexts/AuthContext.jsx): `frontend/src/contexts/AuthContext.jsx`
- [Quadro Kanban](https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/pages/Quadro.jsx): `frontend/src/pages/Quadro.jsx`
- [Componentes de tarefa](https://github.com/brunogfv/kanban-gamificado/tree/main/frontend/src/components/tarefas): `frontend/src/components/tarefas`
- [Hooks de tarefas](https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/hooks/useTarefas.js): `frontend/src/hooks/useTarefas.js`
- [Relatórios](https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/pages/Relatorios.jsx): `frontend/src/pages/Relatorios.jsx`
- [Interface gamificada](https://github.com/brunogfv/kanban-gamificado/tree/main/frontend/src/components/gamificacao): `frontend/src/components/gamificacao`
- [Cliente HTTP](https://github.com/brunogfv/kanban-gamificado/blob/main/frontend/src/api/cliente.js): `frontend/src/api/cliente.js`

### API e autenticação

- [Aplicação Express](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/app.js): `backend/src/app.js`
- [Rotas API](https://github.com/brunogfv/kanban-gamificado/tree/main/backend/src/routes): `backend/src/routes`
- [Autenticação JWT](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/auth.service.js): `backend/src/services/auth.service.js`
- [Controller tarefas](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/controllers/tarefas.controller.js): `backend/src/controllers/tarefas.controller.js`

### Tarefas e organização

- [Serviço tarefas](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/tarefas.service.js): `backend/src/services/tarefas.service.js`
- [Repositório tarefas](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/repositories/tarefas.repository.js): `backend/src/repositories/tarefas.repository.js`
- [Anotações](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/anotacoes.service.js): `backend/src/services/anotacoes.service.js`
- [Etiquetas](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/etiquetas.service.js): `backend/src/services/etiquetas.service.js`

### Gamificação e relatórios

- [Histórico](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/historico.service.js): `backend/src/services/historico.service.js`
- [Serviço gamificação](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/gamificacao.service.js): `backend/src/services/gamificacao.service.js`
- [Relatórios](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/services/relatorios.service.js): `backend/src/services/relatorios.service.js`

### Persistência

- [PostgreSQL](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/config/postgres.js): `backend/src/config/postgres.js`
- [Modelos MongoDB](https://github.com/brunogfv/kanban-gamificado/blob/main/backend/src/models/mongo/index.js): `backend/src/models/mongo/index.js`

### Other components

- **Usuário**

## Connections

- Usuário → Rotas da aplicação: usa (evidence: `frontend/src/App.jsx`)
- Rotas da aplicação → Quadro Kanban: roteia (evidence: `frontend/src/App.jsx`)
- Rotas da aplicação → Relatórios: roteia (evidence: `frontend/src/App.jsx`)
- Quadro Kanban → Componentes de tarefa: renderiza (evidence: `frontend/src/pages/Quadro.jsx`)
- Quadro Kanban → Hooks de tarefas: usa (evidence: `frontend/src/pages/Quadro.jsx`)
- Hooks de tarefas → Cliente HTTP: chama (evidence: `frontend/src/hooks/useTarefas.js`)
- Relatórios → Cliente HTTP: consulta (evidence: `frontend/src/pages/Relatorios.jsx`)
- Sessão frontend → Cliente HTTP: autentica (evidence: `frontend/src/contexts/AuthContext.jsx`)
- Cliente HTTP → Aplicação Express: HTTP/JSON + JWT (evidence: `README.md`)
- Aplicação Express → Rotas API: monta /api (evidence: `backend/src/app.js`)
- Rotas API → Controller tarefas: despacha (evidence: `backend/src/routes/tarefas.routes.js`)
- Controller tarefas → Serviço tarefas: chama (evidence: `backend/src/controllers/tarefas.controller.js`)
- Rotas API → Autenticação JWT: rotas de sessão (evidence: `backend/src/routes/auth.routes.js`)
- Rotas API → Serviço tarefas: encaminha operações (evidence: `README.md`)
- Serviço tarefas → Repositório tarefas: consulta e grava (evidence: `backend/src/services/tarefas.service.js`)
- Repositório tarefas → PostgreSQL: acessa (evidence: `backend/src/repositories/tarefas.repository.js`)
- Serviço tarefas → Histórico: registra eventos (evidence: `backend/src/services/tarefas.service.js`)
- Serviço tarefas → Serviço gamificação: registra conclusão (evidence: `backend/src/services/tarefas.service.js`)
- Serviço tarefas → Modelos MongoDB: limpa anotações (evidence: `backend/src/services/tarefas.service.js`)
- Serviço tarefas → Anotações: opera anotações (evidence: `README.md`)
- Serviço tarefas → Etiquetas: opera etiquetas (evidence: `README.md`)
- Serviço gamificação → PostgreSQL: consulta dados (evidence: `backend/src/services/gamificacao.service.js`)
- Serviço gamificação → Modelos MongoDB: grava eventos (evidence: `backend/src/services/gamificacao.service.js`)
- Relatórios → PostgreSQL: consulta relatórios (evidence: `README.md`)
- Relatórios → Modelos MongoDB: agrega perfil (evidence: `README.md`)
- Relatórios → Interface gamificada: exibe progresso (evidence: `README.md`)
