docs/PENDENCIAS.md

Pendências — CCO Apoena

Estado: réplica funcional (todos os endpoints respondem 200, dados reais jan–jun/2026). Itens abaixo são melhorias/decisões que ficaram para uma próxima rodada.

Dados / cadastros

• API REST de cadastros (F2M_BEARER_TOKEN) — as tabelas liberacoes_lavra e teores_ouro (cadastro de liberações + teor de Au por liberação) vêm da API REST *-ws.miningcontrol.cloud/webservice com Bearer JWT. Não temos o token da Apoena nem a URL confirmada. Sem isso, /api/liberacoes retorna painel vazio (degrada gracioso, campo indisponivel). Obter o token e confirmar F2M_API_BASE no tenant Apoena. Obs: o teor de Au já vem na base 7 (pivot_qualidade.AU) — o cadastro REST acrescenta o cruzamento liberação×bancada×validade.

LLM (OpenRouter)

• OPENROUTER_KEY inválida — a key herdada do cco (sk-or-v1...) retorna 401 "User not found" (revogada/conta inexistente). Afeta /api/analise (análise textual) e o chat LLM — degrada gracioso (fallback heurístico cobre, o painel ainda gera o snapshot). Para reativar a análise por LLM: gerar uma key nova em openrouter.ai e atualizar o secret OPENROUTER_KEY do Space (e o .env.local).

Artefatos calibrados (gerados a partir do DB Apoena)

• dashboard_apn/equipment_categories.json — classificação produção/marginal/infra (gerado por scripts/classify_equipments.py).
• viagens_baseline.duckdb — baseline 90d de saúde de viagens (gerado por scripts/build_viagens_baseline.py). Sem ele, /api/viagens_saude = "indisponível".
• dashboard_apn/thresholds_calibrados.json — percentis de fila/viagens/ciclo p/ recomendações (gerado por dashboard_apn/calibrar_thresholds.py). Há fallbacks embutidos enquanto ausente.
• cycle_benchmarks.json — regressão cota×dmt×ciclo. O de Almas (50.8-0.111*cota+1.017*dmt) não vale para Apoena. Recalibrar. Atenção: em Apoena cota extraída de LIB_<NNNN> é id de liberação, não cota métrica — a regressão precisa de outra variável ou recalibração.

Não portados (decisão de escopo)

• Deploy HF — feito: Space gabrielsapucaia02/cco-apn (público, RUNNING) via scripts/deploy_hf.py. Writer autossuficiente (DB embutido + poll F2M).
• GPS / câmeras: removidos por escopo (Sorteio de Pesagem depende de GPS — removido junto).
• seed_equipamento_perfil.py: as listas nominais (cemitério/quadrantes/reincidentes) são conhecimento manual de Almas. equipamento_perfil fica vazio → enriquecimento de relatórios apenas não adiciona tags (sem quebrar). Repovoar com radiografia da Apoena se desejado.
• Tests (tests/): suíte do cco não portada (fixtures dependem de schema/dados Almas).

Limpezas opcionais

• dashboard_apn/static/index.html: as views ocultas (Mapa, Viagens, Câmeras, Pesagem) ainda têm DOM morto com onclick para funções removidas. São inalcançáveis (sem aba) e protegidas por type-guards — não chamam endpoints mortos. Remover num passo de limpeza se quiser.
• dashboard_apn/recomendacoes_*.py: alguns comentários/docstrings ilustrativos ainda citam nomes de equipamento de Almas ('EH 087'). Não afeta execução.
• scout_apoena.py (raiz): probe inicial de descoberta das bases. Pode ser removido (scripts/validate_schema.py cobre o profiling).