Copiloto Acadêmico e Serviços Cognitivos (Cortex AI Gateway / JEV)

🤖 Copiloto Acadêmico & Serviços Cognitivos (Cortex AI Gateway / JEV)

O Academic Companion (acad) centraliza 100% de suas capacidades de inteligência artificial através do Cortex AI Gateway e do JEV (Juizado de Evidências e Validação). A aplicação ACAD não possui dependência direta de SDKs de provedores externos (como Google Gemini API/SDK): toda invocação de modelos fundacionais, geração estruturada e validação cognitiva é orquestrada pelo Cortex via cliente interno M2M seguro (CortexInternalClient).

Todos os serviços cognitivos substituem integralmente dados estáticos ou mocks por inteligência artificial em tempo real, mantendo rigoroso controle de governança, persistência relacional no PostgreSQL e débito de tokens da carteira do estudante.

🏗️ Arquitetura do Hub Cognitivo

[ Frontend Discente (React 19 / Vite) ]
        │ (React Query Hooks)
        ▼
[ Backend Express 5 REST API ]
        │ (safeParse Zod Schema)
        ├── 1. WalletService.debitTokens()     ──► Debita tokens na carteira
        ├── 2. Trajectory Context Builder      ──► Consulta Prisma (Perfil, Vivências, Memórias)
        ├── 3. CortexInternalClient (M2M)      ──► Comunicação autenticada com Cortex AI Gateway / JEV
        └── 4. PostgreSQL Relacional           ──► Persistência em Conversation, Message, AcademicMemory

1. Gateway Cognitivo Centralizado (Cortex)

Cliente: CortexInternalClient (apps/backend/src/infra/cortex.client.ts).
Segurança M2M: Autenticação via segredo interno CORTEX_INTERNAL_SECRET e header de identificação X-Consumer-Service: acad.
Governança & Resiliência: Fallbacks automáticos para endpoints dedicados (/process/lattes/validate, /process/summarize, /jev/evaluate) e orquestração estruturada via /copilot/chat. Em caso de indisponibilidade de rede, serviços críticos contam com fallback heurístico local garantindo zero downtime.

🎯 Serviços Cognitivos Implementados no ACAD

1. Copiloto Acadêmico (`/api/assistant`)

O Copiloto atua como um mentor de trajetória acadêmica de elite, contextualizado nos desafios do ensino superior e pesquisa:

Injeção de Contexto Dinâmico (Zero Hallucination Prompt): A cada mensagem, o sistema injeta no contexto:
- Nome do discente, universidade, curso, semestre e matrícula;
- Metas acadêmicas declaradas;
- Links para Lattes e LinkedIn;
- As 5 vivências práticas mais recentes (Projetos, IC, Monitorias, Estágios, Extensão);
- Os 5 últimos registros do diário e memórias reflexivas.
Histórico Multi-Turn: Thread de mensagens persistida no PostgreSQL (Conversation e Message).
Custo: 5 tokens por consulta.

2. Resumo Cognitivo de Editais (`/api/opportunities/:id/summarize`)

Extrai automaticamente um dossiê executivo de editais de bolsas, intercâmbios ou vagas:

Resumo executivo em 2 a 3 frases;
Benefícios e remuneração financeira;
Critérios de elegibilidade em tópicos;
Prazos críticos e etapas seletivas;
Dicas estratégicas para maximizar a chance de aprovação;
Persistência em Cache: Armazenado na coluna ai_summary da tabela opportunities.
Custo: 3 tokens por extração.

3. LinkedIn Impact Builder (`/api/integrations/linkedin`)

Capacita o estudante a transformar produções acadêmicas em autoridade profissional:

Gerador de Publicações: Gera posts estruturados em 3 tons distintos: Técnico, Storytelling e Executivo.
Otimizador de Perfil: Produz Headlines de alto impacto, resumos biográficos para o campo “Sobre” e palavras-chave de visibilidade.
Custo: 3 tokens por geração.

4. Higienização & Validação Cognitiva de Trajetória / Lattes (`/api/memories/lattes/ai-validate`)

Processamento cognitivo inteligente acionado no modal de inserção em lote de acontecimentos e importação do Currículo Lattes:

Separação ABNT & Limpeza de Título: Isola o título real e conciso do trabalho, artigo, palestra ou projeto, expurgando citações extensas de autores no padrão ABNT (ex: SOUSA, F. D. ; SILVA, A.) e detalhes de revistas/periódicos para o corpo do registro.
Normalização Temporal Estrita: Converte datas parciais ou anuais para o padrão UTC ISO 8601 (YYYY-MM-DDTHH:mm:ss.sssZ).
Classificação Taxonômica Rigorosa: Categoriza automaticamente o registro nos tipos canônicos do ACAD (CONQUISTA, APRENDIZADO, REFLEXAO, INSIGHT, DUVIDA).
Geração Inteligente de Tags: Adiciona tags acadêmicas contextuais (['Artigo', 'Publicação Científica', 'CNPq', ...]).
Deduplicação Semântica: Funde e consolida publicações ou participações duplicadas com grafias ou citações variantes.
Auditoria & Confiança: Fornece badges visuais com status (VALIDATED, ADJUSTED, WARNING), índice de confiança (0 a 100%) e relatório de ajustes aplicados.
Resiliência Offline: Na eventual indisponibilidade temporária do Cortex, o serviço aplica sanitização heurística baseada em regras sem interromper o fluxo do usuário.

💳 Economia de Tokens & Transparência

Toda operação de IA gera um registro imutável em TokenTransaction no banco de dados com:

type: AI_USAGE
amount: -N (débito de saldo)
description: Consulta Copiloto Acadêmico (Cortex/JEV) / Resumo Cognitivo de Edital / Higienização Cognitiva Lattes
createdAt: TIMESTAMP

O saldo é debitado atomicamente via transação Prisma, garantindo consistência estrita mesmo sob concorrência.