Rede Campo Tasks
Webapp de gerenciamento de tarefas com múltiplos níveis de usuários.
Visão Geral
Objetivo: Substituir o gerenciamento de tarefas em planilhas por uma plataforma colaborativa com comunicação em tempo real, rastreabilidade de solicitações e visibilidade consolidada por papel de usuário.
Público-alvo: Equipes internas — Admin, Coordenadores, Devs e Solicitantes.
Status atual: planejando
Documentação
Requisitos
Arquitetura
Banco de Dados
API
- redecampo-auth-api
- redecampo-users-api
- redecampo-projects-api
- redecampo-tasks-api
- redecampo-tags-api
- redecampo-requests-api
- redecampo-chat-api
- redecampo-notifications-api
Permissões
Fluxos de Uso
- redecampo-fluxo-autenticacao
- redecampo-fluxo-primeiro-login
- redecampo-fluxo-gestao-usuarios
- redecampo-fluxo-solicitacao
- redecampo-fluxo-execucao-tarefa
- redecampo-fluxo-gestao-projeto
- redecampo-fluxo-chat
Stack
Frontend: Flutter Web + MobX
Backend: Node.js + TypeScript + Fastify + Zod + JWT + MariaDB + TypeORM
Tempo real: WebSocket via @fastify/websocket
Docs: Swagger autodocumentado em /docs via @fastify/swagger + @fastify/swagger-ui
Detalhes completos: redecampo-stack-tecnica
Tipos de Usuário
| Tipo | Papel no Sistema |
|---|---|
| Admin | Controle total — usuários, projetos, configurações |
| Coordenador | Cria e gerencia tarefas, aprova/rejeita solicitações |
| Dev | Executa tarefas atribuídas, atualiza status |
| Solicitante | Abre solicitações, acompanha tarefas geradas |
Detalhes completos: redecampo-permissoes
O que cada pasta faz
Inbox/
Entrada de ideias brutas. Qualquer coisa que surgir cai aqui primeiro e é processada depois.
Requisitos/
O que o sistema precisa fazer e por quê. Problema, escopo, restrições e decisões tomadas.
Features/
Funcionalidades detalhadas — comportamento, critérios de aceite e impacto por papel de usuário.
Bugs/
Erros encontrados — o que quebrou, por que e como foi resolvido.
Arquitetura/
Decisões técnicas com alternativas consideradas e trade-offs.
Banco-de-dados/
Modelagem de dados — entidades, campos, relacionamentos e regras de negócio.
API/
Endpoints — rotas, métodos, permissões, schemas Zod, contratos de entrada/saída.
Fluxos/
Jornadas do usuário — passo a passo, regras aplicadas e tratamento de erros.
Permissoes/
Quem pode fazer o quê — regras de acesso centralizadas por papel.
Pesquisa/
Estudos técnicos realizados antes de decisões de stack ou arquitetura.
Snippets/
Trechos de código reutilizáveis — helpers, schemas base, middlewares.
Referência/
Links e documentações externas relevantes.
Diário/
Histórico diário de desenvolvimento — o que foi feito, bloqueios e próximos passos.
Roadmap/
Plano de evolução por fase — pendente, em andamento e descartado.
Templates/
Modelos prontos para criar novas notas com consistência.
Como criar notas
| O que criar | Template | Pasta |
|---|---|---|
| Nova feature | template-feature | Features/ |
| Novo bug | template-bug | Bugs/ |
| Endpoint API | template-endpoint-api | API/ |
| Fluxo de uso | template-fluxo | Fluxos/ |
| Modelagem de dados | template-modelagem-dados | Banco-de-dados/ |
| Decisão técnica | template-decisao-arquitetura | Arquitetura/ |
| Regras de acesso | template-permissoes | Permissoes/ |
| Estudo técnico | template-pesquisa | Pesquisa/ |
| Nota do dia | template-nota-diaria | Diário/YYYY/MM/ |
| Código reutilizável | template-snippet | Snippets/ |
| Link externo | template-referencia | Referência/ |
Fluxo de trabalho
- Capturar → Tudo entra em
Inbox/primeiro - Processar → Mover para a pasta certa usando o template adequado
- Conectar → Sempre linkar features, bugs e decisões a esta nota
- Propagar → Após qualquer alteração, verificar se outros arquivos precisam ser atualizados (ver regras em CLAUDE)
- Revisar → Usar template-nota-diaria ao fechar o dia