| # 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). |
|
|
