# A busca deve respeitar o contentor

Esta semana ponho a busca de corpus sobre os fragmentos governados, acrescento fusão híbrida e deixo a recuperação seguir uma subárvore OTCS em vez do monte inteiro.

Language: pt
Canonical: https://avanticomplex.com/pt/blog/search-must-respect-the-container-pt/

Published: 2026-07-05T18:00:00.000Z

Um corpus a que não podes fazer uma pergunta é só um armazém. Esta semana acrescento busca semântica sobre a tabela de fragmentos governados, fusão híbrida, filtro ACL e alcance hierárquico de contentor para uma consulta ficar dentro de uma subárvore de herança OTCS. Também acrescento um ingester generalizado de repos. A afirmação não é que o recall agora é excelente. A afirmação é que a busca finalmente tem um contentor, um filtro de permissão e um lugar para escrever fragmentos de um projeto.

## O caminho errado

A busca habitual é global. Tudo na tabela vetorial é candidato. Uma pergunta sobre o plano de arquivos de um departamento não deve recuperar as frases de outro porque soam parecidas. Permissões do arquivo devem continuar a restringir o acerto.

## O que realmente acrescentei

A busca semântica corre sobre `chunk_embeddings_v2`. RRF híbrido funde com a léxica. Filtro ACL no mesmo caminho. Alcance hierárquico com chaves de subárvore OTCS. O ingester escreve nessa tabela. Backfill para documentos já sob Alfresco. CLI de recuperação e uma skill de Q&A. A telemetria de busca entrou e saiu por uma retenção do operador; não a trato como observatório entregue.

CI tem suite completa contra Postgres, fluxo só manual. Índice único em file\_id. Isto é busca sobre os meus próprios corpora. Não transformo este post no nome de um cliente.

## O próximo teste

Uma consulta apontada a uma subárvore, com ACL ligado, mostrando que uma frase parecida fora do contentor não volta. Até isso ser medido, isto é um contrato de busca que posso chamar.

* * *

**Base histórica:** commits da VALESKA `5925b17`, `c92b4e8`, `d64ae8b`, `bf5d139`, 2–5 de julho de 2026.


## Translations
- en: https://avanticomplex.com/en/blog/search-must-respect-the-container/
- es: https://avanticomplex.com/es/blog/search-must-respect-the-container-es/
- pt: https://avanticomplex.com/pt/blog/search-must-respect-the-container-pt/