Intranet

Belluco Advogados

Acesso rápido aos sistemas do escritório. Dica: pressione a tecla indicada no canto de cada cartão para abrir direto.

Indexar jurisprudências — passo a passo

O portal roda só no Lenovo, de propósito: conversão, embeddings e indexação são trabalho pesado, e usam a GPU de lá. A VPS serve a busca. O Lenovo produz, a VPS serve.

  1. Subir o Qdrant (antes de tudo)

    O banco vetorial local vive em C:\qdrant e não sobe sozinho com o Windows — sem ele, todo documento falha na etapa de indexação (conexão recusada 127.0.0.1:6333). Numa janela própria do Prompt de Comando:

    cd C:\qdrant
    qdrant.exe

    A janela mostra o log e precisa ficar aberta durante toda a indexação. Para conferir que respondeu (em outra janela):

    curl.exe http://127.0.0.1:6333/collections

    A operação usa três janelas: Qdrant (esta), portal (passo seguinte) e uma livre. Nunca publique para a VPS se a coleção local estiver incompleta — confira o points_count antes.

  2. Subir o portal

    No Prompt de Comando:

    cd C:\projetos\juris_factory_portal
    .venv\Scripts\activate
    python run.py

    Depois abra http://127.0.0.1:8001. Escuta só na própria máquina — nem a rede do escritório alcança.

    Se não subir, refaça o ambiente: python -m venv .venv, ativar, pip install -r requirements.txt.

  3. Conferir a GPU antes de um lote grande

    A home mostra GPU ou CPU. Em CPU, os embeddings levam horas onde a GPU leva minutos — vale resolver antes de subir centenas de acórdãos.

  4. Enviar os acórdãos

    Marque o toggle “Lote de jurisprudência” — é ele que liga a extração automática de processo, data, vara, relator, resultado, temas e ementa.

    Com o toggle marcado, só três campos são pedidos:

    • Área do direito
    • Tema pesquisado, em kebab-case (ex.: horas-extras-intervalo)
    • Tribunal/Vara pesquisada — trava de conferência, não é gravada

    Arquivo repetido não passa: o portal confere por hash. Reenviar a mesma pasta não duplica nem custa processamento.

  5. Processar

    O upload não processa sozinho — clique em “Processar todos”. Um documento por vez.

    O caminho de cada um: convertendo → convertido → manifesto → embeddings → indexando → indexed.

    metadata_review_required é o status que mais aparece em lote grande, e é a trava funcionando: o tribunal divergiu do escopo declarado ou faltou campo essencial. Abra o documento e aprove ou corrija — a indexação fica bloqueada até então.

  6. Publicar para a VPS

    Com a fila limpa, clique em “LENOVO ENVIAR PARA VPS”.

    O botão bloqueia enquanto houver documento aguardando, processando, em revisão de metadados ou com falha — a mensagem diz quantos de cada. Documento indexed e duplicado não bloqueiam.

  7. Conferir que chegou

    Busque na Biblioteca por um termo do lote novo. É a prova de ponta a ponta.

    A Biblioteca consulta um alias (juris_factory_chunks), não a coleção pelo nome. É isso que permite publicar uma coleção inteira e só então virar o ponteiro, sem a busca sair do ar. Coleção nova com o alias ainda na antiga = chegou, mas não entrou em uso.

Detalhes completos: juris_factory_portal/docs/operar-indexacao-no-lenovo.md