Relatório de maturidade - TP1 - Projeto de GPS-FlaCaGaVi

Gestão de Projetos de Software (2026-2) — Relatório de Avaliação do Módulo 1

Autor

Prof. Aléssio Miranda Júnior

Data de Publicação

2026-09-21

Data de Modificação

26/10/2026

1. Resumo da Rubrica de Avaliação (5,0 Pontos)

Critério Descrição Peso Nota Obtida Evidência Principal
1. Identidade e Equipe README.md com logo, membros (@username), papéis e stack tecnológica 0,5 0.5 ✅ Completo
2. Project Charter docs/PROJECT_CHARTER.md com objetivos SMART, justificativa WokDex e escopo 0,8 0.8 ✅ Completo
3. EAP / WBS docs/EAP.md com decomposição hierárquica e códigos numéricos 0,8 0.8 ✅ Mermaid + Numeração
4. Diretrizes de Prompt docs/DIRETRIZES_PROMPT.md com postura socrática e exemplos de diálogo 0,7 0.7 ✅ Completo com Exemplos
5. Backlog no GitLab 4 Milestones, Issues com labels/estimativas, dependências e todos membros 1,2 1.2 65 Issues, 4 Milestones
6. Spike Técnico / MVP Código de consumo da API LLM integrado via Merge Request 1,0 1.0 ✅ Spike + MR integrado
TOTAL Pontuação Consolidada do Checkpoint 01 5,0 5.0 pts ✅ Concluído no Prazo

2. Participação e Métricas Individuais dos Membros

Avaliação do envolvimento de cada integrante cadastrado oficialmente:

Integrante Matrícula Usuário GitLab Commits Issues Criadas Issues Atribuídas MRs Criados MRs Revisados Nível de Engajamento
Flávio Samora 20243007295 @FlavioCorcini 5 0 16 11 0 🟢 Alto
Gabriel Silva Gonçalves 20243008757 @Mewndigo 4 0 15 2 0 🟢 Alto
Vitor Cardoso 20243001059 @Vitor 12 0 17 12 11 🟢 Alto
Carlos Eufrazio 20233007620 @Carlos_Matheus_2005 40 65 17 5 18 🟢 Alto

3. Auditoria Detalhada dos Artefatos de Documentação

📄 README.md

  • Arquivo presente: ✅ Sim
  • Identificação dos membros com login: ✅ Sim
  • Descrição da Stack Tecnológica: ✅ Sim

📄 docs/PROJECT_CHARTER.md (Termo de Abertura)

  • Arquivo presente: ✅ Sim
  • Objetivos SMART definidos: ✅ Sim
  • Fronteiras de Escopo (Dentro / Fora): ✅ Sim

📄 docs/EAP.md (Estrutura Analítica do Projeto)

  • Arquivo presente: ✅ Sim
  • Diagrama Mermaid ou visual: ✅ Sim
  • Numeração hierárquica de pacotes: ✅ Sim

📄 docs/DIRETRIZES_PROMPT.md (Filosofia do Bot)

  • Arquivo presente: ✅ Sim
  • Postura socrática e investigativa: ✅ Sim
  • Exemplos práticos de diálogos (O que deve / não deve fazer): ✅ Sim

⚡ Spike Técnico de Conexão com a LLM

  • Evidências no Repositório: Diretório encontrado: BackEnd/, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/client/GeminiApiClient.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/config/GeminiProperties.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/dto/GeminiRequest.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/dto/GeminiResponse.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/exception/GeminiApiException.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/exception/GeminiAuthenticationException.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/exception/GeminiException.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/exception/GeminiInvalidResponseException.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/exception/GeminiTimeoutException.java, Arquivo de spike/código: BackEnd/tsunderebot/src/main/java/br/com/faddygraph/tsunderebot/service/GeminiService.java, Arquivo de spike/código: BackEnd/tsunderebot/src/test/java/br/com/faddygraph/tsunderebot/service/GeminiServiceTest.java
  • Merge Request associado: ✅ Identificado MR de integração

4. Governança no GitLab: Milestones, Issues e MRs

  • Total de Commits: 86 (30 no prazo, 56 após o prazo)
  • Total de Issues Cadastradas: 65
  • Total de Milestones: 4
  • Total de Merge Requests: 30
  • Dependência Bloqueante Mapeada: ✅ Sim (vínculo is blocked by ativo)
  • Uso de Estimativas de Tempo: ✅ Sim

Amostra de Issues do Projeto

# Título da Issue Autor Responsáveis Labels Estado
#74 [M3] Apoio ao Back: cenários e dados de teste, revisão de MRs e aceite do MVP @Carlos_Matheus_2005 @Vitor BackEnd, Docs opened
#73 [M3] Atualizar REQUISITOS e RISCOS e escrever o GUIA_USUARIO.md @Carlos_Matheus_2005 @Vitor Docs opened
#72 [M3] Testes de regressão de comportamento do prompt (com mocks/fixtures) @Carlos_Matheus_2005 @Vitor Prompt opened
#71 [M3] Reexecutar os 3 casos reais e os testes adversariais com protocolo reproduzível @Carlos_Matheus_2005 @Vitor Docs, Em Produção, Prompt opened
#70 [M3] Aplicar o prompt v1.1 no DIRETRIZES_PROMPT.md e alinhar os documentos @Carlos_Matheus_2005 @Vitor Docs, Prompt closed
#69 [M3] Pipeline do backend: lint (Checkstyle), testes, build/deploy e segredos @Carlos_Matheus_2005 @FlavioCorcini BackEnd, Em Produção opened
#68 [M3] CORS, contrato da API e documento de arquitetura (ARQUITETURA.md) @Carlos_Matheus_2005 @FlavioCorcini BackEnd, Docs closed
#67 [M3] Testes automatizados do backend sem chamar a API real do Gemini @Carlos_Matheus_2005 @FlavioCorcini BackEnd opened
#66 [M3] Robustez de entrada: validação, sanitização, limites e logs seguros @Carlos_Matheus_2005 @FlavioCorcini BackEnd opened
#65 [M3] Histórico de conversa por sessão (sessionId) no backend @Carlos_Matheus_2005 @FlavioCorcini BackEnd opened
#64 [M3] Sprint Review, CHANGELOG com vínculos, riscos atualizados e fechamento da Milestone 3 @Carlos_Matheus_2005 @Carlos_Matheus_2005 Docs opened
#63 [M3] Organizar Boards, labels, limites de WIP, branch protegida e Milestones @Carlos_Matheus_2005 @Carlos_Matheus_2005 Docs closed
#62 [M3] Testes automatizados do FrontEnd (serviço HTTP e componente de chat) @Carlos_Matheus_2005 @Carlos_Matheus_2005 FrontEnd opened
#61 [M3] Renderizar código e Markdown nas respostas e ajustar responsividade (apoio ao Front) @Carlos_Matheus_2005 @Carlos_Matheus_2005 FrontEnd opened
#60 [M3] Pipeline do FrontEnd: lint, build e testes do Angular no GitLab CI @Carlos_Matheus_2005 @Carlos_Matheus_2005 FrontEnd opened

5. Diagnóstico de Maturidade do Projeto

NotaEscopo e evidências analisadas

Foram analisados relatorio_projeto_flacagavi.qmd e trabalhos-baixados/flamagavi, que contém documentação, frontend e backend Java com cliente Gemini. Não há README na raiz da cópia; docs/README.md foi localizado. A cópia pode não refletir estado remoto atual, MRs ou variáveis configuradas.

Síntese executiva

O grupo apresenta forte materialização técnica e de gestão, com backend, frontend, documentação e backlog detalhado. Há evidência de integração com LLM e planejamento explícito para resiliência, testes e validação pedagógica. O principal ponto de consolidação é tornar a identidade do projeto e a entrada de leitura mais claras na raiz do repositório. No Módulo 2, o avanço deve priorizar a integração vertical e os limites pedagógicos antes de ampliar funcionalidades.

Quadro de maturidade

Dimensão Estágio Evidências Risco ou limitação
Identidade e visão Em desenvolvimento Charter e documentos locais; frontend e backend com identidade técnica. README de raiz não foi localizado; a descoberta do projeto fica prejudicada.
Escopo e requisitos Consistente Charter, EAP e requisitos presentes. Validar critérios de aceite e coerência entre persona e requisitos.
Planejamento e rastreabilidade Avançado Milestones, estimativas, dependência bloqueante e issues para todo o ciclo. Histórico de execução do board não foi validado localmente.
Viabilidade técnica e segurança Consistente Cliente Gemini, propriedades e DTOs no backend; item para variáveis de ambiente e rate limit. Não se verificou configuração segura nem execução da integração.
Qualidade documental e colaboração Consistente Documentação, frontend, backend e evidência de MRs/revisões. Ausência de README na raiz reduz a qualidade de entrada; não prova ausência no remoto.

Evidências positivas verificáveis

  • BackEnd/tsunderebot inclui GeminiApiClient.java, GeminiProperties.java e DTOs de requisição.
  • FrontEnd/tsunbot.html e documentação de charter, EAP e requisitos estão presentes.
  • A auditoria registra issues para prompt socrático, integração HTTP, validação de recusa e CI.

Lacunas e riscos priorizados

  • P0: a ausência de README na raiz da cópia é verificável e prejudica onboarding; não permite concluir que o remoto atual tenha a mesma lacuna.
  • P1: integração com Gemini precisa demonstrar configuração externa de chave, timeout e tratamento de falha.
  • P1: validação pedagógica da persona precisa evitar que a identidade estilística sobreponha a ajuda graduada.

Recomendações para o Módulo 2

  • P0: criar ou restaurar README de raiz que conecte visão, execução, ambiente e documentação.
  • P0: demonstrar fluxo vertical com critérios de aceite para entrada, resposta graduada e erro de API.
  • P1: versionar matriz de diálogos para validar recusa de código pronto e progressão de pistas.
  • P2: registrar ADR curta sobre arquitetura, segredos e limites do provedor.

Perguntas de validação

  1. Onde está a instrução oficial de execução do projeto para um novo integrante?
  2. Como GeminiProperties recebe configurações sem expor segredo?
  3. Como a persona Tsundere preserva clareza, respeito e progressão pedagógica?

Nota metodológica

Análise assistida por LLM, baseada em evidências documentais locais e relatório heurístico. Requer revisão docente e não substitui a avaliação formal.

6. Considerações e Ajustes Finais do Docente

Parecer Geral: ✅ Concluído no Prazo com nota calculada em 5.0 / 5,0.

Observações do Professor: [ ] Revisão validada sem ressalvas [ ] Ajuste manual de nota necessário: ______

Comentários adicionais:

Voltar ao Relatório Consolidado (TP1) | Ir para o Dashboard Geral

De volta ao topo