Visão geral
Atreides
Serviço de previsão de demanda da Guidance, responsável por snapshots, treino de candidatos, promoção de campeão e rastreabilidade operacional.
O Atreides cobre o ciclo operacional de previsão da plataforma:
- materialização de snapshots de demanda;
- treino de candidatos e promoção de campeão;
- predição batch sobre campeãs ativas;
- persistência de metadados, artefatos e rastreabilidade por Airflow.
O que a engine precisa garantir
- Integridade de estado: invariantes de domínio bloqueiam estados inválidos.
- Confiabilidade operacional: treino roda em DAGs Airflow com retry explícito.
- Rastreabilidade: versões, métricas e artefatos permanecem auditáveis.
- Isolamento arquitetural: domínio e aplicação não dependem de infraestrutura.
Leitura recomendada
- Quickstart para subir API, Airflow e backing services localmente.
- Fluxos principais para entender snapshot e treino.
- Arquitetura para ver fronteiras do sistema.
- Modelos ML para ver onde ficam as integrações concretas de modelagem.
- Configuração de model definition para payloads e exemplos reais.
- Airflow e jobs para DAG, tasks e retry.
- Predição batch para entender a exceção de inferência deste serviço command-side.
- Modelo de domínio para invariantes e objetos centrais.
- Code map para encontrar o código certo sem navegar na árvore inteira.
- Execução programática local para Jupyter, script direto e HTTP + Airflow.
Estrutura desta documentação
| Pergunta | Página |
|---|---|
| Como subir o sistema localmente? | Quickstart |
| Como rodar em Jupyter ou em script direto? | Execução programática local |
| Como os fluxos críticos funcionam? | Fluxos principais |
| Como as camadas se separam? | Arquitetura |
| Como o suporte a modelos ML se organiza? | Modelos ML |
| Como as estratégias Nixtla funcionam? | Nixtla |
Como configurar um ModelDefinition útil? | Configuração de model definition |
| Como Airflow e os jobs se comportam? | Airflow e jobs |
| Onde a série de treino é projetada? | Projeção de séries de treino |
| Como a predição batch funciona? | Predição batch |
| Onde snapshots e artefatos são gravados? | Storage e artefatos |
| Quais são os objetos de negócio centrais? | Modelo de domínio |
| Como operar runtime, jobs e deploy? | Runtime e deploy |
| Como validar mudanças? | Development e qualidade |
| Onde ficam os módulos no repositório? | Code map |