Files
Investidor-V2/docs/investmoz/ai/coverage.md
T
nala 1106509116
tests / ci (push) Canceled after 0s
vrsao 2
2026-10-08 14:02:01 +02:00

6.3 KiB
Raw Blame History

Cobertura verificada e trabalho restante

Casos do pedido

Caso Implementado nesta etapa Pendente
UC-IA-001 Excertos citados de fontes elegíveis, data/natureza, recusa sem evidência e pedido de revisão Respostas generativas fundamentadas, corpus oficial, assistência pública
UC-IA-002 FTS PT/EN, idioma, fonte, natureza e acesso antes da recuperação; fusão RRF unitariamente testada Embeddings, índice pgvector, reranker e filtros territoriais/multidimensionais completos; RRF ainda não ligado a vectores reais
UC-IA-003 Filtros eliminatórios de publicação/sector/província/maturidade, factores e dados em falta; apenas oportunidades canónicas publicadas Perfil completo, regras institucionais aprovadas, similitude semântica, clusters/corredores/instrumentos/parceiros; pontuação actual conta filtros, não é ponderação financeira
UC-IA-004 Triagem por campos declarados, consentimento específico, sem dados de contacto ou texto livre; não altera pedido/lead Modelo supervisionado, responsável sugerido, idioma/cluster/corredor/horizonte e regras de prioridade aprovadas
UC-IA-005 Fontes expiradas, documentos com checksum repetido, ausência de responsável/próxima acção, geometrias inválidas; alertas em resultados auditados Conflitos semânticos entre fontes, sincronização SuiteCRM e cobertura de todos os domínios
UC-IA-006 Tarefas CRM abertas e vencidas, prazo, referência e acção de revisão sugerida Marcos/dependências, caminho crítico, impacto e orçamento autorizado
UC-IA-007 Pré-visualização extractiva dos primeiros três fragmentos de fonte elegível Resumo generativo completo, reuniões/actas/históricos e extracção de compromissos confirmados

Nenhum caso é declarado integralmente concluído. A aceitação da revisão apenas grava um parecer interno. Não altera estados oficiais, cria compromissos ou transmite dados ao SuiteCRM.

Pipeline RAG de 17 passos

Passos Situação
1–2: recepção e segurança Cadastro canónico, upload apenas texto UTF-8, limite de tamanho, confirmação de autorização, rejeição de fontes confidenciais/restritas; formatos complexos/OCR/antivírus pendentes
3–6: extracção, versão, acesso e fragmentação Texto simples, versão/checksum do documento, metadados de fonte, revisão independente, fragmentos com ID/checksum/posição; divisão por caracteres não substitui tokenização do modelo
7–8: embeddings e pgvector Não executados. Extensão/runtime ausentes. Esquema proposto separado, sem tocar na base partilhada
9–10: índice lexical e ACL tsvector gerado por idioma, GIN; status, validade, classificação, versão e checksum filtrados antes da pesquisa
11–12: híbrido e reranking Algoritmo RRF testado isoladamente; corpus vectorial/modelos não provisionados, logo produção continua lexical
13–15: contexto, geração e suporte Excertos devolvidos como citações; sem geração nem afirmações novas. Verificação semântica de afirmações depende de modelo e avaliação
16–17: fontes e rastreabilidade Fonte/data/natureza/validade, modo, regras, versão de instrução e latência; resultado encriptado; sem falsa confiança probabilística

Metadados

ai_chunks.source_id identifica ai_sources, que referencia documento UUID + versão + checksum. A fonte guarda título, idioma, natureza, URL, proprietário, autorização, datas e estado. Classificação é lida do documento a cada consulta, sem duplicação desactualizada. O fragmento contém conteúdo, idioma, posição, ID e checksum próprios. Metadados sector/actividade/cluster/corredor/território e embedding_model/revision permanecem pendentes; não são preenchidos por inferência.

Gates da fase seguinte

Infraestrutura/modelos → benchmark PT-MZ/EN representativo → escolha por qualidade/segurança/custo → revisão do corpus e da política → adaptadores de geração/embeddings/reranking → pgvector na mesma base → avaliação de recuperação e citações → piloto supervisionado. Falha de fonte ou de modelo deve produzir recusa/fallback identificado, não uma resposta sem suporte.