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

3.6 KiB

📄 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