Previsões — projeção de série

Selo

• Motor: Determinístico (sem LLM)
• Maturidade: Preview
• Medição: Verificável por teste

1. O que faz

Projeta alguns períodos à frente de uma série do painel, com uma faixa provável em vez de um número seco, e informa quanto essa projeção costuma errar no seu próprio histórico.

2. Determinístico ou LLM?

100% determinístico. Não há LLM. É uma regressão linear (linha de tendência) com faixa derivada do erro dos resíduos, mais um backtest walk-forward que mede a qualidade. Sem I/O, reproduzível.

Parâmetros:

• Mínimo de pontos para projetar: 6 (FORECAST_MIN_POINTS) — abaixo disso, devolve null (nenhuma projeção).
• Máximo de períodos projetados: 24.
• A faixa (~95%) abre conforme se afasta do último dado — projetar 12 meses não tem a mesma confiança de projetar 1.

3. Dados enviados e egress

Nenhum. Roda no nosso servidor sobre o snapshot. Nada sai do produto, nenhum token.

4. Privacidade e retenção

Não há egress. A avaliação de qualidade (walk-forward) só usa o próprio histórico da série, sem vazamento do futuro para o ajuste — e há teste provando isso.

5. Tokens, custo e orçamento

Não se aplica — determinístico, custo de IA zero.

6. Como ligar, quem pode usar e como desligar

Recurso de visualização do painel (por widget). Não passa por verificações de envio externo e de orçamento.

7. Recusas

• Histórico insuficiente para projetar (< 6 pontos) → não projeta (retorna null).
• Histórico insuficiente para avaliar a previsão → veredito insuficiente e nenhum número de qualidade sai: "MAPE sobre 2 pontos convenceria exatamente quem não deveria ser convencido."

8. Limitações e ausência de causalidade

• É uma regressão linear simples: não captura sazonalidade, ciclos nem mudanças de regime. As limitações são exibidas junto de qualquer previsão, inclusive a "confiável" (LIMITACOES_PREVISAO).
• A avaliação usa o próprio histórico (backtest) — desempenho passado não garante o futuro.
• Projetar tendência não é afirmar causa: a linha diz "se continuar como veio", não "isto vai acontecer" nem "X causa Y".
• O veredito é honesto — confiavel só quando erra pouco (MAPE ≤ 15%, quando mensurável) e a faixa cumpre o que promete (≥ 80% dos reais dentro dela); senão, instavel.

9. Como validar

• Reprodutibilidade e sem vazamento: a projeção é determinística e o backtest walk-forward não enxerga o futuro (a mesma série produz sempre a mesma projeção e a mesma qualidade).
• Sem números quando insuficiente: série curta → veredito insuficiente, sem métrica de qualidade.
• Faixa cresce com a distância: confira que a faixa provável abre em períodos mais distantes.
• Sem egress: nenhuma chamada externa, nenhum evento ai.usage.