EGP UnB

Contexto e Objetivo

Complexidade do Fluxo de Informação

O diagrama a seguir ilustra a densa rede de trocas de dados gerenciada pelo EGP, revelando como múltiplos atores, formatos e fronteiras se entrelaçam:

• Múltiplos atores: catadores, cooperativas, equipe acadêmica da UnB e parceiros na Holanda, Dinamarca e Portugal.
• Fluxo bidirecional: envio de requisitos e recebimento de feedback e artefatos a cada semestre.
• Integração global: consolidação e distribuição de documentos (PDF, Excel, Markdown) entre instituições nacionais e internacionais.
• Alta rotatividade: renovação semestral de participantes exige reindexação constante e recontextualização de conteúdos.
• Processamento simultâneo: extração, limpeza, indexação e apresentação de grandes volumes de informação em paralelo.

Objetivos

O padrão cíclico de formação de turmas e renovação semestral de participantes representa um desafio crítico: a cada entrada de novos membros, perdemos parte do histórico de decisões, requisitos e artefatos construídos. Isso causa retrabalho, atrasos e dificulta a continuidade das atividades.

• Preservar o histórico acadêmico: Centralizar e organizar todas as versões de requisitos, documentos e entregas anteriores.
• Onboarding eficiente: Permitir que novos participantes acessem em segundos o contexto completo do projeto, sem depender exclusivamente de veteranos.
• Continuidade de conhecimento: Garantir que decisões e aprendizados de semestres passados sejam facilmente recuperáveis e reutilizáveis.
• Automatização inteligente: Empregar IA para indexar, classificar e hierarquizar automaticamente documentos em diferentes formatos (PDF, Excel, Markdown).
• Redução de retrabalho: Minimizar esforços duplicados na busca e interpretação de artefatos de semestres anteriores.

Visão Geral do Sistema

• Escopo: Criar uma plataforma que preserve todo o histórico acadêmico e de requisitos de forma funcionalmente adequada e facilite auditorias de qualidade baseadas na ISO/IEC 25010 (SQuaRE).

• Solução:
  • In progress. Tutoriais: Guias passo a passo direcionados a papéis fixos da equipe (desenvolvedor, designer, PSP2), garantindo treinamento padronizado e alinhamento de processos.
  • Alpha Access. Wiki: Ferramenta inteligente com IA para busca semântica em arquivos classificados (PDF, Excel, Markdown), permitindo recuperação rápida e contextualizada de informações.
    
    Acessar Projeto
  • Em breve. Coleta de dados em tempo real: Monitoramento contínuo de interações e artefatos, alimentando índices e modelos com informações sempre atualizadas
  • Em breve. Dashboards temporais: Visualizações interativas que exibem a evolução histórica de métricas e atividades do projeto ao longo do tempo
• Benefícios:
  • Melhoria na usabilidade para novos participantes (Usabilidade).
  • Maior manutenibilidade dos artefatos (Manutenibilidade).
  • Portabilidade de dados entre ambientes acadêmicos e internacionais (Portabilidade).
  • Redução de retrabalho e atrasos causados pela rotatividade semestral.

Facilidade de Busca

• Índices Inteligentes: Criação de índices invertidos combinados com embeddings para consultas semânticas.
• Refinamento Automático: Ajuste dinâmico de stopwords e filtros contextuais para resultados mais precisos.
• Integração Multi-formato: Pesquisa unificada em documentos PDF, planilhas Excel e arquivos Markdown.

Importância da Documentação

Para garantir a sustentabilidade do projeto, adotamos padrões de metadados claros (títulos, datas, autores, labels), além de sumários automáticos gerados pela própria ferramenta. Isso:

• Facilita a colaboração entre membros acadêmicos e técnicos;
• Reduz erros e retrabalho ao buscar requisitos antigos;
• Permite auditoria e rastreabilidade de mudanças ao longo do tempo.

Estudo de Caso: Educado Docs (MkDocs)

Como exemplo prático, a documentação oficial do Educado ilustra bem os conceitos aqui apresentados:

Referências

• Documentação Oficial Educado (MkDocs)
• Leffingwell, D.; Widrig, D., Managing Software Requirements: A Use Case Approach, 2nd Edition, Addison-Wesley, 2003.
• Cockburn, A., Writing Effective Use Cases: A Practical Guide, 1st Edition, Addison-Wesley, 2000.
• Ambler, S., Agile Modeling: Effective Practices for Extreme Programming and the Unified Process, Wiley, 2002.
• IREB e.V., CPRE Foundation Level Syllabus, Version 1.1.0, September 2022.
• Sommerville, I., Software Engineering, 9th Edition, Pearson Prentice Hall, 2011.
• Beck, K.; Andres, C., Extreme Programming Explained: Embrace Change, 2nd Edition, Addison-Wesley Professional, 2004.
• Preece, J.; Rogers, Y.; Sharp, H., Interaction Design: Beyond Human-Computer Interaction, 4th Edition, Wiley, 2015.
• Nielsen, J., Usability Engineering, Morgan Kaufmann, 1994.
• ISO/IEC 25010, Systems and software engineering — SQuaRE — System and software quality models, 2011.
• ISO/IEC 25051, Software engineering — Systems and software Quality Requirements and Evaluation (SQuaRE) — Requirements for quality of Ready to Use Software Product (RUSP) and instructions for testing, 2014