beetask/specification/product-description.md
Gabriel Santana de Menezes 090f2888d0 project scaffold
2026-04-21 15:58:44 -04:00

205 lines
3.6 KiB
Markdown

# 📄 PRD — Sistema de Gestão de Tempo e Tarefas
## 🧭 Nome do Projeto
TimeTrack (nome provisório)
---
## 🎯 Objetivo
Permitir que colaboradores registrem e acompanhem o tempo gasto em tarefas, enquanto gestores e donos da organização monitoram produtividade, alocação de tempo e eficiência operacional.
---
## 👥 Atores do Sistema
### 🔹 Dono (Owner)
* Nível mais alto da organização
* Responsável por gerenciar usuários e estrutura
### 🔹 Gestor (Manager)
* Acompanha desempenho do time
* Analisa métricas e relatórios
### 🔹 Colaborador (Employee)
* Registra tarefas
* Controla tempo de trabalho
---
## 🏢 Estrutura Organizacional
* O sistema deve suportar múltiplas organizações
* Cada organização contém:
* Dono (1)
* Gestores (N)
* Colaboradores (N)
### Regras:
* Apenas o Dono pode:
* Adicionar Gestores e Colaboradores
* Aprovar pedidos de entrada na organização
* Colaboradores podem solicitar participação em uma organização
---
## 🧩 Funcionalidades Principais
### 👨‍💻 Colaborador
#### Registro de tarefas
* Criar tarefa com:
* Nome
* Descrição
* Categoria
* Projeto
* Status (ex: aberta, em andamento, concluída)
#### Controle de tempo
* Iniciar tarefa
* Pausar tarefa
* Retomar tarefa
* Finalizar tarefa
#### Relatórios
* Relatório mensal:
* Horas trabalhadas por mês
* Agrupamento por categoria
* Agrupamento por projeto
#### Dashboard diário
* Tarefas trabalhadas no dia anterior
* Tarefas abertas (planejamento do dia atual)
---
### 📊 Gestor
#### Monitoramento de equipe
* Tempo gasto por colaborador em tarefas
* Tempo gasto por projeto
#### Métricas de produtividade
* Relação:
* Horas trabalhadas / horas disponíveis
* Visualização por:
* Dia
* Semana
* Mês
---
### 👑 Dono
#### Gestão de usuários
* Criar colaboradores e gestores
* Aprovar solicitações de entrada
#### Gestão organizacional
* Criar e gerenciar organização
* Visão global de métricas (igual ou superior ao gestor)
---
## 🧠 Regras de Negócio
* Uma tarefa deve pertencer a:
* Um colaborador
* Um projeto
* Uma categoria
* Uma tarefa pode ter múltiplos períodos de tempo (start/pause)
* O tempo total de uma tarefa = soma dos períodos ativos
* Apenas uma tarefa pode estar ativa por colaborador ao mesmo tempo (regra recomendada)
* Horas disponíveis podem ser:
* Configuráveis por organização ou colaborador
### 📁 Projetos
* Um projeto pode ter:
* Um ou mais gestores responsáveis
* Gestores associados a um projeto podem:
* Visualizar métricas e tarefas relacionadas ao projeto
* Acompanhar desempenho dos colaboradores naquele projeto
---
## 📊 Métricas e Indicadores
* Total de horas trabalhadas
* Horas por projeto
* Horas por categoria
* Eficiência:
* horas trabalhadas / horas disponíveis
* Ranking de produtividade (opcional)
---
## 🗂️ Entidades Principais
* Organization
* User
* role: OWNER | MANAGER | EMPLOYEE
* Project
* relação N:N com gestores
* Task
* TimeEntry (períodos de tempo)
* Category
* MembershipRequest
---
## 🚫 Fora de Escopo (Inicial)
* Integração com folha de pagamento
* Controle financeiro
* Chat interno
* Notificações em tempo real
* App mobile (primeira versão web)
---
## ⚙️ Stack Sugerida (alinhada com seu perfil)
* Frontend: React + TypeScript
* Backend: Java + Quarkus
* Autenticação: Keycloak
* Banco: PostgreSQL
---
## 🔮 Possíveis Evoluções
* Integração com calendário (Google/Outlook)
* Alertas de produtividade
* IA para sugestão de tarefas
* Previsão de tempo de execução
* Relatórios avançados com BI
---