Gestão do Projeto com Métricas PSM/CID
Introdução
Este documento estabelece a estrutura de acompanhamento do projeto baseada no modelo PSM/CID (Practical Software and Systems Measurement / Common Industry Data). O objetivo é aplicar métricas estruturadas nas três categorias principais exigidas para avaliar o desempenho da equipe durante a execução do projeto de avaliação da qualidade do sistema AgroMart.
Categorias de Métricas PSM/CID
- Desempenho dos Processos - Avalia eficiência e qualidade da execução
- Calendário e Progresso - Monitora cronograma e entregas
- Recursos e Custos - Controla utilização de recursos e investimentos
1. Desempenho dos Processos
1.1 Métricas de Produtividade
1.1.1 Commits e Contribuições
Métrica: Total de commits realizados
- Objetivo: Medir atividade e frequência de contribuições
- Meta esperada: 60-80 commits totais
- Cálculo: 6 membros × 2-3 commits/semana × 12 semanas = 72 commits
- Resultado: 88 commits totais
- Status: ✅ META SUPERADA (88 > 80)
Métrica: Distribuição de commits por membro
- Objetivo: Avaliar participação equilibrada da equipe
- Meta esperada: Cada membro entre 12% e 20% do total
- Cálculo: 100% ÷ 6 membros = 16.6% ± 4%
- Resultado: 7 membros ativos com distribuição mais equilibrada
- gabrielhrlima: 38 commits (43.2%) ⚠️ CONCENTRAÇÃO MUITO ALTA
- xzxjesse: 20 commits (22.7%) ⚠️ ACIMA DA META
- xgomesx: 16 commits (18.2%) ✅ DENTRO DA META
- Ruan-Carvalho: 6 commits (6.8%) ⚠️ ABAIXO DA META
- Matheus Henrique: 4 commits (4.5%) ⚠️ ABAIXO DA META
- PedroGusta: 3 commits (3.4%) ⚠️ ABAIXO DA META
- Mylena Angélica: 1 commits (1.1%) ⚠️ ABAIXO DA META
1.1.2 Qualidade do Código/Documentação
Métrica: Tamanho das alterações
- Objetivo: Avaliar volume de trabalho e granularidade dos commits
- Meta esperada:
- Linhas adicionadas: 2.000-3.000 linhas totais
- Linhas removidas: 800-1.200 linhas totais
- Arquivos modificados: 10-20 arquivos de documentação
- Média de linhas por commit: 50-80 linhas/commit
- Resultado:
- Linhas adicionadas: 18.981 ✅ META SUPERADA (meta: 2.000-3.000)
- Linhas removidas: 556 ⚠️ ABAIXO DA META (meta: 800-1.200)
- Arquivos modificados: 106 ✅ META SUPERADA (meta: 10-20)
- Média de linhas por commit: 222.0 ✅ META SUPERADA (meta: 50-80)
Métrica: Padrões de commit
- Objetivo: Avaliar aderência às convenções estabelecidas
- Meta esperada:
- docs: 70-80% (foco em documentação)
- feat: 10-15% (novas funcionalidades)
- fix: 5-10% (correções)
- refactor: 5-10% (melhorias)
- Resultado:
docs:
- Documentação (52 commits, 93% dos padronizados) ✅ META ATINGIDAfeat:
- Novas funcionalidades (4 commits, 7% dos padronizados) ⚠️ ABAIXO DA METAfix:
- Correções (0 commits, 0%) ⚠️ ABAIXO DA METArefactor:
- Refatoração (0 commits, 0%) ⚠️ ABAIXO DA META- Aderência aos padrões: 63.6% (56 de 88 commits)
1.1.3 Frequência de Integração
Métrica: Commits por dia
- Objetivo: Avaliar consistência e distribuição temporal do trabalho
- Meta esperada: 1-2 commits/dia útil com atividade em 18-25 dias
- Resultado:
- Média de commits/dia: 1.40 commits/dia ✅ META ATINGIDA
- Período total: 63 dias (06/05/2025 - 08/07/2025)
- Principais picos de atividade:
- 28/05/2025: 17 commits
- 07/07/2025: 14 commits
- 08/07/2025: 7 commits
- 02/07/2025: 7 commits
1.2 Métricas de Qualidade dos Processos
1.2.1 Cycle Time (Tempo de Ciclo)
Métrica: Tempo médio para conclusão de tarefas
- Objetivo: Avaliar eficiência na execução de atividades
- Meta esperada: Média de 2-3 dias por tarefa
- Resultado: 0.7 dias por commit ✅ META SUPERADA
- Cálculo: 63 dias ÷ 88 commits = 0.7 dias/commit
1.2.2 Throughput (Taxa de Entrega)
Métrica: Número de artefatos entregues por período
- Objetivo: Medir capacidade de produção da equipe
- Meta esperada: 2-3 artefatos por semana
- Resultado: 11.7 artefatos por semana ✅ META SUPERADA
- Cálculo: 106 arquivos ÷ 9 semanas = 11.7 arquivos/semana
2. Calendário e Progresso
2.1 Análise de Progresso por Fase
Fase | Período Previsto | Período Realizado | Status |
---|---|---|---|
Fase 1: Estabelecer Requisitos | 06/05/2025 - 04/06/2025 | 19/05/2025 - 02/06/2025 | ✅ No prazo |
Fase 2: Especificar a Avaliação | 04/06/2025 - 11/06/2025 | 04/06/2025 - 11/06/2025 | ✅ No prazo |
Fase 3: Projetar a Avaliação | 11/06/2025 - 07/07/2025 | 01/07/2025 - 07/07/2025 | ✅ No prazo |
Fase 4: Executar a Avaliação | 02/07/2025 - 08/07/2025 | 02/07/2025 - 08/07/2025 | ❌ Atrasado |
Análise de Cumprimento de Prazos:
- Total de commits relacionados às fases: 18 de 88 commits (20.5%)
- Commits não categorizados: 70 commits (79.5%)
- Distribuição por fase: Crescente conforme complexidade
- Fase com maior atividade: Fase 4 (Execução) com 9 commits
- Produtividade: Alta (classificação automática baseada em 1.40 commits/dia)
2.2 Velocity da Equipe
2.2.1 Métricas de Velocidade
Métrica: Velocity da equipe
- Objetivo: Avaliar consistência e capacidade de entrega
- Meta esperada: 1-2 commits/dia útil com tendência estável
- Resultado:
- Velocity média: 1.40 commits/dia ✅ META ATINGIDA
- Velocity por membro: 12.6 commits/membro (88 ÷ 7 membros)
- Pico máximo: 17 commits (28/05/2025)
- Atividade recente: 7 commits (08/07/2025)
- Tendência: Concentração de atividade próxima às entregas
2.2.2 Burndown Chart
Métrica: Progresso semanal
- Objetivo: Acompanhar evolução do trabalho ao longo do tempo
- Meta esperada: Variação máxima de ±10% entre planejado e realizado
- Resultado:
Período | Data | Commits Realizados | Atividade (%) | Observações |
---|---|---|---|---|
Última semana | 01-08/07/2025 | 40 commits | 45.5% | Pico de atividade final |
Semana anterior | 24-30/06/2025 | 1 commit | 1.1% | Baixa atividade |
Maio final | 28/05/2025 | 17 commits | 19.3% | Maior pico isolado |
Junho médio | 12/06/2025 | 2 commits | 2.3% | Atividade moderada |
Julho início | 01-04/07/2025 | 12 commits | 13.6% | Aceleração para entrega |
Total | 63 dias | 88 commits | 100% | Meta superada |
3. Recursos e Custos
3.1 Recursos Humanos
3.1.1 Composição da Equipe
Métrica: Composição da equipe
- Objetivo: Avaliar estrutura e participação dos membros
- Meta esperada: 6 membros ativos com participação balanceada
- Resultado:
- Total de membros: 7 membros
- Membros ativos: 7 membros ✅ META ATINGIDA (meta: 6 membros)
- Commits por membro (média): 12.6 commits/membro
- Período de contribuição: 63 dias (06/05/2025 - 08/07/2025)
3.1.2 Distribuição de Esforço
Métrica: Distribuição de esforço
- Objetivo: Avaliar equilíbrio na distribuição de trabalho
- Meta esperada: Distribuição balanceada da contribuição (12-20% por membro)
- Resultado:
Membro | Commits | Participação (%) | Status |
---|---|---|---|
gabrielhrlima | 38 | 43.2% | ⚠️ CONCENTRAÇÃO CRÍTICA |
xzxjesse | 20 | 22.7% | ⚠️ CONCENTRAÇÃO ALTA |
xgomesx | 16 | 18.2% | ✅ BALANCEADO |
Ruan-Carvalho | 6 | 6.8% | ⚠️ BAIXA PARTICIPAÇÃO |
Matheus Henrique | 4 | 4.5% | ⚠️ BAIXA PARTICIPAÇÃO |
PedroGusta | 3 | 3.4% | ⚠️ BAIXA PARTICIPAÇÃO |
Mylena Angélica | 1 | 1.1% | ⚠️ BAIXA PARTICIPAÇÃO |
3.2 Recursos Tecnológicos
3.2.1 Ferramentas Utilizadas
Métrica: Ferramentas utilizadas
- Objetivo: Avaliar adequação e custo das ferramentas
- Meta esperada: Utilização de ferramentas gratuitas (custo total R$ 0,00)
- Resultado:
Categoria | Ferramenta | Custo (R$) | Licença | Status |
---|---|---|---|---|
Controle de Versão | Git + GitHub | R$ 0,00 | Open Source/Gratuita | ✅ ATIVO |
Documentação | Markdown + MkDocs | R$ 0,00 | Open Source | ✅ ATIVO |
Edição | VS Code | R$ 0,00 | Gratuita | ✅ ATIVO |
Comunicação | Discord/WhatsApp | R$ 0,00 | Gratuita | ✅ ATIVO |
Apresentação | Canva | R$ 0,00 | Plano Gratuito | ✅ ATIVO |
Prototipação | Figma | R$ 0,00 | Plano Gratuito | ✅ ATIVO |
Custo Total de Ferramentas: R$ 0,00 ✅ META ATINGIDA
3.2.2 Análise de Custo-Benefício
Métrica: Custo-benefício do projeto
- Objetivo: Avaliar retorno do investimento realizado
- Meta esperada: ROI positivo com custo total máximo de R$ 12.000,00
- Resultado:
Custos Diretos:
- Valor/hora desenvolvedor: R$ 0,00 (projeto acadêmico)
- Período total: 63 dias (06/05/2025 - 08/07/2025)
- Custo de mão de obra: R$ 0,00 (trabalho acadêmico)
- Custo de ferramentas: R$ 0,00 (ferramentas gratuitas)
- Custo de infraestrutura: R$ 0,00 (recursos próprios)
- Custo total: R$ 0,00 ✅ META ATINGIDA
Benefícios Alcançados:
- Produtividade da equipe: Alta (1.40 commits/dia)
- Aderência aos padrões: 63.6% (56 de 88 commits)
- Qualidade da documentação: 106 arquivos estruturados
- Experiência adquirida: Framework PSM/CID implementado
- Volume de trabalho: 18.981 linhas adicionadas
ROI Final: Excelente (benefícios acadêmicos sem custos monetários)
4. Estrutura de Realise
Tags de Marcos:
entrega_01
- Entrega da Parte 1 - Fase 1entrega_02
- Entrega da Parte 1 - Fase 2entrega_02
- Entrega da Parte 1 - Fase 3entrega_03
- Entrega da Parte 2
5. Resultados - Metas
5.1 Análise Geral de Performance
Categoria | Métrica | Meta Estabelecida | Resultado Alcançado | Status | Performance (%) |
---|---|---|---|---|---|
PRODUTIVIDADE | Total de Commits | 60-80 commits | 88 commits | ✅ SUPERADA | 110% |
Linhas Adicionadas | 2.000-3.000 linhas | 18.981 linhas | ✅ SUPERADA | 633% | |
Arquivos Modificados | 10-20 arquivos | 106 arquivos | ✅ SUPERADA | 530% | |
Média Linhas/Commit | 50-80 linhas | 222 linhas | ✅ SUPERADA | 278% | |
Commits/Dia | 1-2 commits/dia | 1.40 commits/dia | ✅ ATINGIDA | 100% | |
QUALIDADE | Aderência Padrões | 70-80% | 63.6% | ⚠️ ABAIXO | 80% |
Linhas Removidas | 800-1.200 linhas | 556 linhas | ⚠️ ABAIXO | 46% | |
Cycle Time | 2-3 dias/tarefa | 0.7 dias/commit | ✅ SUPERADA | 350% | |
Throughput | 2-3 artefatos/semana | 11.7 artefatos/semana | ✅ SUPERADA | 390% | |
EQUIPE | Membros Ativos | 6 membros | 7 membros | ✅ ATINGIDA | 117% |
Distribuição Balanceada | 12-20% por membro | 43.2% máx / 1.1% mín | ⚠️ DESBALANCEADO | 50% | |
Velocity/Membro | - | 12.6 commits/membro | ✅ BOA | - | |
CUSTOS | Custo Total | Máx R$ 12.000 | R$ 0,00 | ✅ SUPERADA | 100% |
Ferramentas | R$ 0,00 | R$ 0,00 | ✅ ATINGIDA | 100% |
5.2 Dashboard de Performance por Categoria
🚀 DESEMPENHO DOS PROCESSOS
Indicador | Status | Observação |
---|---|---|
Volume de Trabalho | ✅ EXCELENTE | 6x acima da meta em linhas de código |
Frequência de Commits | ✅ ÓTIMA | Consistente com 1.4 commits/dia |
Qualidade dos Padrões | ⚠️ ATENÇÃO | 63.6% - necessita melhoria |
Eficiência Temporal | ✅ EXCELENTE | 0.7 dias/commit vs meta 2-3 dias |
📅 CALENDÁRIO E PROGRESSO
Indicador | Status | Observação |
---|---|---|
Cumprimento de Prazos | ✅ BOM | 3 de 4 fases no prazo |
Velocity da Equipe | ✅ ESTÁVEL | 1.4 commits/dia mantido |
Distribuição Temporal | ⚠️ IRREGULAR | Concentração em picos de entrega |
Progresso Geral | ✅ CONCLUÍDO | 88 commits em 63 dias |
👥 RECURSOS E CUSTOS
Indicador | Status | Observação |
---|---|---|
Participação da Equipe | ⚠️ DESBALANCEADA | 2 membros com 66% do trabalho |
Custo-Benefício | ✅ EXCELENTE | R$ 0,00 de custo total |
Utilização de Ferramentas | ✅ EFICIENTE | Todas gratuitas e adequadas |
ROI do Projeto | ✅ MÁXIMO | Alto valor acadêmico sem custos |
5.3 Pontos Críticos Identificados
⚠️ ALERTAS PRIORITÁRIOS
- Concentração de Trabalho: gabrielhrlima (43.2%) e xzxjesse (22.7%) = 66% do total
- Baixa Participação: 4 membros com menos de 7% de contribuição cada
- Aderência aos Padrões: 63.6% abaixo da meta de 70-80%
- Poucas Correções: 0% de commits tipo
fix
erefactor
✅ PONTOS FORTES
- Volume Excepcional: 18.981 linhas (6x a meta)
- Eficiência Alta: 0.7 dias por commit
- Custo Zero: Todas ferramentas gratuitas
- Documentação Rica: 106 arquivos estruturados
5.4 Recomendações para Projetos Futuros
Área | Recomendação | Prioridade |
---|---|---|
Distribuição | Definir cotas mínimas/máximas por membro (10-25%) | 🔴 ALTA |
Padrões | Treinamento em convenções de commit | 🟡 MÉDIA |
Planejamento | Distribuição mais uniforme ao longo do tempo | 🟡 MÉDIA |
Qualidade | Implementar reviews obrigatórias | 🟢 BAIXA |
Monitoramento | Relatórios semanais automáticos | 🟢 BAIXA |
5.5 Score Final PSM/CID
Categoria | Score | Peso | Score Ponderado |
---|---|---|---|
Desempenho dos Processos | 8.5/10 | 40% | 3.4 |
Calendário e Progresso | 8.0/10 | 30% | 2.4 |
Recursos e Custos | 7.5/10 | 30% | 2.25 |
SCORE FINAL | 8.05/10 | 100% | 8.05 |
Classificação: ✅ EXCELENTE (8.0-10.0)
Versão | Descrição | Autor | Data | Revisor | Data de revisão |
---|---|---|---|---|---|
1.0 | Versão inicial da gestão do projeto | Jéssica Eveline | 06/07/2025 | Ruan Carvalho | 08/07/2025 |
1.1 | Versão completa com dados | Jéssica Eveline | 08/07/2025 | Ruan Carvalho | 08/07/2025 |