Histórias de Usuários

Histórias baseadas em entrevistas com diferentes perfis de usuários da UFJ: Info

Requisitos

Especificação detalhada dos requisitos funcionais e não funcionais: Info

Requisitos Funcionais

Requisitos Não-Funcionais

Protótipo Interativo

A plataforma está disponível para teste em: Info

Acesso à Plataforma: https://pfc.heinrik.dev

Fluxos de Usuário Implementados:

• Login/Cadastro de usuários
• Dashboard principal com métricas em tempo real
• Configuração de parâmetros da matriz orçamentária
• Simulação de cenários alternativos
• Geração de relatórios com insights de IA
• Gestão de unidades acadêmicas

Componentes da Interface

Interface construída com Material-UI garantindo acessibilidade e responsividade: Info

• Dashboard Principal: Visão geral com gráficos interativos e métricas-chave
• Calculadora de Matriz: Interface para configuração de pesos e visualização de resultados
• Simulador de Cenários: Ferramenta para teste de múltiplas configurações
• Análise com IA: Interface para interação com insights automatizados
• Gestão de Dados: CRUD completo para unidades acadêmicas
• Relatórios: Geração e exportação de documentos

Dashboard Principal

Visão geral com métricas em tempo real das 8 unidades acadêmicas da UFJ

• Acesso: Página principal após login autenticado
• Funcionalidades:
  • Visualização da distribuição orçamentária atual
  • Gráficos interativos com ApexCharts
  • Métricas consolidadas (maior unidade, menor unidade, amplitude)
  • Filtros e ordenação em tempo real

Calculadora de Matriz Orçamentária

Algoritmo baseado na Matriz OCC adaptado para especificidades da UFJ

• Funcionalidades:
  • Configuração de pesos para diferentes indicadores
  • Cálculo automático de alunos equivalentes
  • Algoritmo de correção de percentual mínimo
  • Redistribuição proporcional automática
  • Resultados em tempo real com validação

Análise Inteligente com IA

Integração com OpenAI GPT-4 e DeepSeek para insights automatizados

• Funcionalidades:
  • Análise contextualizada da distribuição atual
  • Identificação de padrões e anomalias
  • Recomendações de ajustes de pesos
  • Geração de cenários alternativos
  • Relatórios executivos automatizados

Simulação de Cenários

Ferramenta para teste de múltiplas configurações antes da implementação

• Funcionalidades:
  • Múltiplos cenários simultâneos
  • Comparação lado a lado
  • Análise de sensibilidade automática
  • Exportação de resultados
  • Histórico de simulações

Gestão de Unidades Acadêmicas

CRUD completo para manutenção dos dados das 8 unidades da UFJ

• Funcionalidades:
  • Cadastro e edição de unidades
  • Importação/exportação em lote
  • Validação de dados em tempo real
  • Histórico de alterações
  • Backup automático

Sistema de Usuários

Controle de acesso baseado em roles (RBAC) para diferentes perfis

• Perfis Disponíveis:
  • ADMIN: Acesso completo ao sistema
  • MODERADOR: Gestão de dados e análises
  • USER: Visualização e simulações básicas

Estrutura de Dados - Unidades Acadêmicas

Entidade principal contendo todos os indicadores para cálculo da matriz

{
  "id": "uuid-v4",
  "sigla": "ICA",
  "unidade": "Instituto de Ciências Agrárias",
  "alunosMatGrad": 814,
  "alunosMatPos": 65,
  "alunosEquivalentes": 1573,
  "docentes": 55,
  "rap": 14.80,
  "laboratorios": 39,
  "cargaHoraria": 9335,
  "pesquisaProjetos": 94,
  "pesquisaExtensao": 64,
  "conceito": 3.5,
  "createdAt": "2025-01-01T00:00:00Z",
  "updatedAt": "2025-01-01T00:00:00Z"
}
                

Estrutura de Dados - Usuários

Sistema de autenticação com controle de acesso baseado em roles

{
  "id": "uuid-v4",
  "nome": "Eduardo Henrique",
  "email": "admin@ufj.edu.br",
  "password": "hash-bcrypt",
  "roles": ["ADMIN"],
  "status": "ATIVO",
  "createdAt": "2025-01-01T00:00:00Z",
  "lastActivity": "2025-01-15T10:30:00Z"
}
                

Estrutura de Dados - Análise de IA

Resultado das análises geradas pelos modelos de inteligência artificial

{
  "id": "uuid-v4",
  "userId": "uuid-user",
  "modelo": "gpt-4-turbo",
  "prompt": "Analise a distribuição orçamentária...",
  "resultado": {
    "insights": ["Maior concentração no ICA", "Oportunidade no IGEO"],
    "recomendacoes": ["Aumentar peso da pesquisa", "Revisar critérios"],
    "metricas": {
      "amplitude": 23.51,
      "desvio": 8.2
    }
  },
  "createdAt": "2025-01-15T10:30:00Z"
}
                

APIs REST Documentadas:

APIs desenvolvidas seguindo padrões REST com documentação automática via Swagger/OpenAPI.

Principais Endpoints:

• POST /api/v1/autenticacao/entrar - Login de usuários
• GET /api/v1/unidades - Listar unidades acadêmicas
• POST /api/v1/matriz/calcular - Calcular distribuição orçamentária
• POST /api/v1/ia/analise - Gerar análise com IA
• POST /api/v1/matriz/cenarios - Simular cenários alternativos

• Spring Boot 3.x: Framework principal do backend
• Spring Security: Autenticação JWT e autorização RBAC
• Spring Data JPA: Persistência com PostgreSQL
• Swagger/OpenAPI: Documentação automática de APIs
• Micrometer + Prometheus: Métricas e monitoramento

Frontend Libraries:

• Next.js 14: Framework React com SSR/SSG
• Material-UI (MUI) 5.14: Biblioteca de componentes
• ApexCharts: Gráficos interativos e responsivos
• SWR: Cache e sincronização de dados
• React Hook Form: Gerenciamento de formulários

Inteligência Artificial:

• OpenAI GPT-4: Modelo principal para análises gerais
• DeepSeek: Modelo especializado em análises financeiras
• WebClient (Spring): Cliente HTTP reativo para APIs de IA
• Resilience4j: Circuit breaker e retry patterns

Infraestrutura:

• PostgreSQL 14: Banco de dados principal
• Docker: Containerização de microserviços
• GitHub Actions: CI/CD pipeline
• Firebase Hosting: Hospedagem do frontend
• Grafana + Prometheus: Monitoramento e observabilidade