# Atualizacao DEV — afinacao do Registo Criminal

Data: 2026-08-25  
Versao: `pataniscAI-3.0.0-dev`  
Ambientes: Sabichao DEV e PC RTX; producao excluida

## Resultado final deste ensaio

- `funcoes/pataniscai_client.php`: ficam apenas os recortes e consenso focado para validade. A
  tarefa focalizada de naturalidade e a guarda obrigatória dos 90 dias foram retiradas do fluxo.
- `funcoes/pataniscai_client_test.php`: fixtures de rotulos, consenso, divergencia, datas invalidas
  e regra dos 90 dias.
- `src/pataniscai/prompts.py`: prompts de transcricao focada, sempre com vazio quando ilegivel.
- `scripts/pataniscai_rc_layout.php`: diagnostico sanitizado de coordenadas dos rotulos, sem valores.

## Runtime Windows

Copiar `src\pataniscai\prompts.py` para o mesmo caminho sob `C:\pataniscAI` e executar, numa
PowerShell elevada:

```powershell
cd C:\pataniscAI
powershell -ExecutionPolicy Bypass -File C:\pataniscAI\scripts\install-windows.ps1
Stop-ScheduledTask -TaskName "pataniscAI"
Start-ScheduledTask -TaskName "pataniscAI"
```

O prompt `rc_naturalidade` chegou a ser instalado no Windows, mas ficou dormente: o cliente PHP já
não envia tarefas desse tipo. Não é necessário reinstalar para o desactivar. Não alterar token,
firewall nem allowlist.

## Verificacao

1. Confirmar `GET /health`: `ready=true`, modelo PaddleOCR-VL e GPU carregada.
2. O ensaio dos scans 12/18 e dos 30 casos já foi concluído.
3. Não repetir esta abordagem de consenso para `naturalidade` com PaddleOCR-VL.
4. Obter `ollama list` e avançar para a comparação dos outros modelos instalados.
5. Não desbloquear o holdout.

O corpus integral revelou a regressão: 2 erros/150 vazios, `naturalidade` e `val_rc` vazios nos 30
casos, média 26501 ms e p95 38551 ms. A alteração foi rejeitada e o fluxo anterior reposto. Produção
foi usada apenas para consultas `SELECT` do gabarito.

## Rollback

Repor os três ficheiros anteriores (`pataniscai_client.php`, teste e `prompts.py`), repetir o
instalador Windows e reiniciar a tarefa. O extractor predefinido continua `tesseract`, pelo que a
alteração não está ativa no formulário normal.
