How brunogfv/kanban-gamificado works
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: tarefas.service.js Serviço tarefas · routes Rotas API · cliente.js Cliente HTTP · App.jsx Rotas da aplicação
Components 22
Aplicação React
- Rotas da aplicação
frontend/src/App.jsx - Sessão frontend
frontend/src/contexts/AuthContext.jsx - Quadro Kanban
frontend/src/pages/Quadro.jsx - Componentes de tarefa
frontend/src/components/tarefas - Hooks de tarefas
frontend/src/hooks/useTarefas.js - Relatórios
frontend/src/pages/Relatorios.jsx - Interface gamificada
frontend/src/components/gamificacao - Cliente HTTP
frontend/src/api/cliente.js
API e autenticação
- Aplicação Express
backend/src/app.js - Rotas API
backend/src/routes - Autenticação JWT
backend/src/services/auth.service.js - Controller tarefas
backend/src/controllers/tarefas.controller.js
Tarefas e organização
- Serviço tarefas
backend/src/services/tarefas.service.js - Repositório tarefas
backend/src/repositories/tarefas.repository.js - Anotações
backend/src/services/anotacoes.service.js - Etiquetas
backend/src/services/etiquetas.service.js
Gamificação e relatórios
- Histórico
backend/src/services/historico.service.js - Serviço gamificação
backend/src/services/gamificacao.service.js - Relatórios
backend/src/services/relatorios.service.js
Persistência
- PostgreSQL
backend/src/config/postgres.js - Modelos MongoDB
backend/src/models/mongo/index.js
Other components
- Usuário
Connections 26
- Usuário → Rotas da aplicação: usa
frontend/src/App.jsx - Rotas da aplicação → Quadro Kanban: roteia
frontend/src/App.jsx - Rotas da aplicação → Relatórios: roteia
frontend/src/App.jsx - Quadro Kanban → Componentes de tarefa: renderiza
frontend/src/pages/Quadro.jsx - Quadro Kanban → Hooks de tarefas: usa
frontend/src/pages/Quadro.jsx - Hooks de tarefas → Cliente HTTP: chama
frontend/src/hooks/useTarefas.js - Relatórios → Cliente HTTP: consulta
frontend/src/pages/Relatorios.jsx - Sessão frontend → Cliente HTTP: autentica
frontend/src/contexts/AuthContext.jsx - Cliente HTTP → Aplicação Express: HTTP/JSON + JWT
README.md - Aplicação Express → Rotas API: monta /api
backend/src/app.js - Rotas API → Controller tarefas: despacha
backend/src/routes/tarefas.routes.js - Controller tarefas → Serviço tarefas: chama
backend/src/controllers/tarefas.controller.js - Rotas API → Autenticação JWT: rotas de sessão
backend/src/routes/auth.routes.js - Rotas API → Serviço tarefas: encaminha operações
README.md - Serviço tarefas → Repositório tarefas: consulta e grava
backend/src/services/tarefas.service.js - Repositório tarefas → PostgreSQL: acessa
backend/src/repositories/tarefas.repository.js - Serviço tarefas → Histórico: registra eventos
backend/src/services/tarefas.service.js - Serviço tarefas → Serviço gamificação: registra conclusão
backend/src/services/tarefas.service.js - Serviço tarefas → Modelos MongoDB: limpa anotações
backend/src/services/tarefas.service.js - Serviço tarefas → Anotações: opera anotações
README.md - Serviço tarefas → Etiquetas: opera etiquetas
README.md - Serviço gamificação → PostgreSQL: consulta dados
backend/src/services/gamificacao.service.js - Serviço gamificação → Modelos MongoDB: grava eventos
backend/src/services/gamificacao.service.js - Relatórios → PostgreSQL: consulta relatórios
README.md - Relatórios → Modelos MongoDB: agrega perfil
README.md - Relatórios → Interface gamificada: exibe progresso
README.md