# Changelog — documents

Formato baseado em [Keep a Changelog](https://keepachangelog.com/en/1.0.0/); versionamento semântico.

## [1.1.0] - 2026-08-07

### Added
- **Análise por LLM** (`AnthropicAnalyzer`, Onda 1.1 do PLANO-DOCUMENTOS-IA): com
  `ANTHROPIC_API_KEY`, o `POST /documents/analyze` extrai tipo, datas e número do PDF/imagem via
  modelo multimodal (default Haiku, configurável por `DOCUMENTS_LLM_MODEL`), com **confiança por
  campo** (`fieldConfidences`), **citação do trecho de origem** (`evidence`) e **dupla passada em
  datas** — divergência entre as duas leituras zera o campo e devolve `dateMismatch` (data errada
  é pior que campo vazio). Warnings novos no contrato: `dateMismatch`, `lowConfidence`,
  `llmUnavailable`.
- Fallback gracioso: erro de API, arquivo >10MB ou mime não suportado caem na heurística por nome
  de arquivo com `llmUnavailable` — a análise nunca falha por causa do LLM. Sem a chave, o
  comportamento v1 fica intacto (factory em `document.module.ts`).

## [1.0.0] - 2026-08-07

### Added
- Catálogo legal de postos com 15 obrigações semeadas por migration (Resolução ANP 948/2023,
  CONAMA 273/2000, Portaria INMETRO 227/2022, IN IBAMA 22/2021, NRs 1/7/20/23) e variação por UF
  (`document_type_uf_override`; exemplos: AVCB SP 36 meses, GO 12; LO CETESB 60 meses/120 dias).
- Documentos da loja com trilha de versões (renovação nunca sobrescreve) e upload de PDF em bucket
  GCS privado com URL assinada de vida curta.
- Status derivado na leitura (`valid`/`expiringSoon`/`inRenewal`/`expired`) com a regra do
  protocolo tempestivo: renovação protocolada mantém o documento operante.
- Resumo de conformidade com score 0–100 ponderado por criticidade (interdição 3, multa 2,
  administrativa 1) e contagem de pendências críticas.
- Análise de upload plugável (`DocumentAnalyzer`): v1 heurística por keywords do catálogo;
  OCR/LLM entra no mesmo ponto na v1.1.
- Régua de alertas (lead do tipo/30/15/7/1/vencido) com `GET /alerts/preview`; envio real
  (WhatsApp/e-mail) é v1.2.
- Infra completa: Dockerfile, k8s/hml, cd.yml via Cloud Build — mesmo desenho do `routines`.