docs: Documentação de Processo, Gestao Agil e Metricas

docs: Documentação de Processo, Gestao Agil e Metricas

🎯 Descrição

Formalizar a metodologia de trabalho utilizada pela equipe durante o desenvolvimento do projeto.

Como não utilizamos ferramentas externas de gestão (como Jira), precisamos documentar no repositório como o fluxo ágil foi adaptado, como as tarefas foram rastreadas e quais métricas de engenharia foram alcançadas.


✅ Objetivo

Evidenciar a organização do time e a qualidade do processo de desenvolvimento. Esta documentação prova que o software não foi apenas “codificado”, mas sim planejado, gerido e metrificado seguindo boas práticas de engenharia de software.


📝 Tarefas

Criar o arquivo docs/Agile.md contendo:

  • Story Map: Visão geral da jornada do usuário e priorização (MVP vs V1).
  • Estrutura de Requisitos: Definição de Épicos, Features e User Stories.
  • Rastreabilidade: Explicação do fluxo Issue -> PR -> Commit.
  • Ritos Ágeis: Descrição de como foram feitas as plannings, dailies e reviews.
  • Métricas de Engenharia:
    • Cobertura de Testes (Coverage).
    • Frequência de Commits.
    • Vazão de PRs.
    • Classificação de trabalho (Features vs Bugs).
  • Políticas de Branch: Documentação do Git Flow adaptado utilizado.

📊 Critérios de Aceitação

  • Arquivo de documentação criado e versionado no repositório.
  • As métricas apresentadas devem ser reais e extraídas do histórico do GitHub/Jest.
  • O fluxo de rastreabilidade deve corresponder à realidade dos PRs fechados.

Documentação presente em: