Pular para o conteúdo

Operação

Status

Um retrato honesto, de agora, do que está implementado contra o que está especificado, mas ainda não construído. architecture.md, configuration.md, security.md e api.md documentam o contrato: o desenho dos adendos, que é vinculante independentemente do que esteja em disco em um dia qualquer. Esta página documenta a implementação, reconferida em 2026-09-24 contra services/, deploy/ e apps/web, até o Adendo v0.5 (identidade, auditoria, dashboards e APM) e o Adendo v0.7 (leads de contato). Trate-a como um retrato, não como uma garantia, e prefira-a a adivinhar você mesmo a partir da árvore de código.

O que entrou depois de 2026-09-24 não está nas tabelas abaixo: single sign-on e o segundo fator (identity.md), logs armazenados (logs.md), controle de ingestão (ingestion.md), Orbit SQL (sql.md), a fatura da AWS no FinOps (finops-aws.md) e o arquivo no S3 (archive.md). Onde esta página e uma dessas discordarem, vale a outra página.

Esta página acompanha o status do projeto. Não há página de uptime de serviço hospedado, porque não existe um serviço SRE Orbit multi-tenant para monitorar. Veja architecture.md para entender por quê: nada neste produto roda em qualquer lugar além da sua própria conta.

O que funciona, peça por peça

PeçaStatus
Usuários, sessões e papéisImplementado e testado. Contas locais no orbit-api, sessões assinadas e revogáveis de 12 h em um cookie HttpOnly, três papéis embutidos e papéis personalizados sobre doze permissões, checadas em toda rota; o primeiro administrador vem do Secret, das contas de demonstração ou de um código de configuração de uso único; as páginas de login, de conta e de administração no Deck. O cargo test em services/rust/orbit-api cobre as regras, inclusive com um teste de que toda rota exige uma permissão. Veja identity.md.
Trilha de auditoriaImplementado. Todo login, toda mudança e toda recusa viram um evento JSONL gravado com fsync, com histograma, facetas, uma linguagem de busca e exportação em CSV no Deck e pela API; retenção por dia. Por si só, não detecta adulteração. Veja audit.md.
DashboardsImplementado. Cinco dashboards nativos, um editor com seis tipos de painel, linhas, limites e autocomplete de PromQL, variáveis dos tipos consulta, personalizada e intervalo, o modelo JSON, importação do Grafana (convertida no navegador) e salvamentos versionados que se recusam a sobrescrever uma versão mais nova. Veja dashboards.md.
Traces e APMImplementado. Um receptor OTLP/HTTP no orbit-stack com write-ahead log, um head em memória e segmentos com checksum; métricas de span e séries de service graph com os nomes do Tempo; as páginas de serviços, de serviço, de mapa, de busca e de trace no Deck; a loja de demonstração no compose e atrás de demo.shop.enabled no chart. Veja apm.md.
AlertasImplementado, derivado. Seis regras sobre os objetos do cluster (não há Alertmanager neste build), cada uma com uma seção de runbook em alerts.md; reconhecimentos e silenciamentos guardados pelo orbit-api e auditados.
Leads de contatoImplementado (Adendo v0.7). Gravados em ORBIT_DATA_DIR/leads antes de o formulário do site receber a resposta, listados em /deck/admin/leads e, opcionalmente, enviados por POST para ORBIT_CONTACT_WEBHOOK_URL.
Nocturne AIImplementado. Transmite pelo web e pelo orbit-api; as ferramentas de cluster dele leem o orbit-api com a sessão de quem pergunta, então ele lê o que essa pessoa pode ler. Sem provedor configurado, ele roda o provedor mock.
Fonte ao vivo do orbit-apiImplementado para Kubernetes; os custos são uma estimativa. Clusters, nodes, workloads, events e PersistentVolumes pela API do Kubernetes (kube-rs); uso vindo de metrics.k8s.io ou do engine (ORBIT_USAGE_SOURCE); FinOps a partir de uma tabela embutida de preços on-demand de us-east-1, marcada como "source": "list-price". O AWS Cost Explorer não está ligado.
orbit-stack, o engine de métricasImplementado e medido. Remote-write na entrada, PromQL na saída, com os números em benchmark.md. O WAL, o spill e a compactação da rodada mais recente ainda não foram medidos por um relatório em bench/runs/.
Benchmark de traces contra o Grafana TempoExecutado, rodada 2, executada de novo por um crítico independente. Os números de trace anteriores foram retirados. À frente na leitura de trace por id, no ingest e na memória, e no resumo de serviços e no mapa de serviços com 50.000 traces; a busca só fica à frente para valores comuns nos dados recentes e é mais lenta que o Tempo para um valor raro ou ausente com 3,4 M de spans; o resumo e o mapa são mais lentos na primeira leitura depois de um flush. Os números, com a tabela de derrotas, estão só no benchmark.md e no CLAIMS.md.
O web, o proxy dele e a autenticação própriaImplementado. O proxy de /api/* (GET, POST, PUT, PATCH, DELETE) anexa o bearer e a sessão no servidor, recusa mutações cross-site e só libera escritas em workloads com o token de operador; HTTP Basic na frente de toda rota, exceto /healthz, que agora o próprio web responde. pnpm check:proxy e pnpm check:auth provam as duas coisas.
Chart HelmImplementado. Tudo o que está acima, mais components.orbit-api.persistence e singleWriter, as chaves de identidade no Secret, demo.shop.* e o WEB_TRUST_PROXY derivado do ingress.
ComposeImplementado. Cinco serviços, com o orbit-shop, os volumes nomeados orbit-api-data e orbit-stack-data, e dados e contas de demonstração por padrão.
Manifestos purosImplementado, com duas lacunas. O diretório de dados do orbit-api vem em um emptyDir (usar um claim é uma edição manual documentada em install/kubectl.md), e não há loja de demonstração neste caminho.
ORBIT_AUTH_MODE=oidcNão implementado. Recusa-se a iniciar com um erro nomeado em vez de entregar meio verificador. O single sign-on das pessoas é outra coisa: um admin configura o Google ou um provedor OpenID Connect em Admin > Integrações (identity.md).

Tetos conhecidos

Cada um destes é um comentário ponytail: no código-fonte que nomeia o seu caminho de upgrade, ou uma regra do CONTRACT.md:

  • O orbit-api roda uma única réplica. Identidade, dashboards e a trilha de auditoria ficam em um armazenamento em arquivos com um único escritor; um rollout ou a perda de um node vira uma breve lacuna no console. O caminho de upgrade é o Postgres.
  • A trilha de auditoria é varrida, não indexada. Uma consulta lê os arquivos diários da janela dela.
  • Sem SCIM, sem escopo por cluster ou por dashboard.
  • Traces só por OTLP/HTTP. Sem listener gRPC, sem métricas ou logs OTLP, sem amostragem, um único node, e nem os links de span nem os escopos são guardados.
  • Os alertas são derivados. Seis regras, sempre disparando, sem roteamento e sem histórico.
  • O FinOps é uma estimativa por preço de tabela. Sem fatura, sem comparação mês a mês, sem previsão.
  • O engine roda em um único node. Sem replicação, sem object storage, só remote-write 1.0.
  • O compose registra o endereço do web para todo visitante na trilha de auditoria, porque nada na frente do web identifica o cliente (audit.md).

O que isso significa se você for instalar hoje

  • Faça login primeiro. Toda página do Deck precisa de um usuário. Coloque o primeiro administrador no Secret (ORBIT_ADMIN_USER, ORBIT_ADMIN_PASSWORD_VERIFIER) ou leia o código de configuração de uso único no log do orbit-api; o compose e os dados de demonstração criam admin, editor e viewer com a senha de demonstração da instalação, impressa uma vez nesse log. Veja identity.md.
  • Dê um volume ao orbit-api. O values-prod.yaml e o values-eks.yaml já dão; os defaults do chart e os manifestos puros usam um emptyDir, que perde todas as contas e todas as linhas de auditoria junto com o pod. Faça backup do volume (operations.md).
  • Deixe ORBIT_TRUSTED_PROXIES vazia. O web ganha confiança pelo bearer dele, e o endereço do cliente vem do ingress (WEB_TRUST_PROXY). Atrás de um load balancer ou de uma CDN, a borda precisa repassar o cliente, ou a trilha de auditoria registra o load balancer (audit.md).
  • Envie traces por OTLP/HTTP para o orbit-stack na porta 8082, com o bearer dele, e nomeie o namespace do seu Collector em components.orbit-stack.networkPolicy.allowFromNamespaces (apm.md).
  • Produção é um cluster ao vivo ou nada: values-prod.yaml e os manifestos puros definem ORBIT_DEMO_DATA=false e vinculam o ClusterRole somente-leitura; ORBIT_AUTH_MODE=oidc ainda se recusa a iniciar.

Para onde ir em seguida

  • O que mudou e por quê: changelog.md.
  • O alvo para o qual você está instalando, independentemente das lacunas de hoje: configuration.md, architecture.md.
  • O README.md da raiz carrega a mesma honestidade na escala da raiz do repositório, para quem ainda não abriu docs/.