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ça | Status |
|---|---|
| Usuários, sessões e papéis | Implementado 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 auditoria | Implementado. 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. |
| Dashboards | Implementado. 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 APM | Implementado. 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. |
| Alertas | Implementado, 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 contato | Implementado (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 AI | Implementado. 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-api | Implementado 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étricas | Implementado 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 Tempo | Executado, 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ópria | Implementado. 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 Helm | Implementado. 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. |
| Compose | Implementado. 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 puros | Implementado, 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=oidc | Nã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-apiroda 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
webpara todo visitante na trilha de auditoria, porque nada na frente dowebidentifica 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 doorbit-api; o compose e os dados de demonstração criamadmin,editoreviewercom a senha de demonstração da instalação, impressa uma vez nesse log. Vejaidentity.md. - Dê um volume ao
orbit-api. Ovalues-prod.yamle ovalues-eks.yamljá dão; os defaults do chart e os manifestos puros usam umemptyDir, 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_PROXIESvazia. Owebganha 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-stackna porta8082, com o bearer dele, e nomeie o namespace do seu Collector emcomponents.orbit-stack.networkPolicy.allowFromNamespaces(apm.md). - Produção é um cluster ao vivo ou nada:
values-prod.yamle os manifestos puros definemORBIT_DEMO_DATA=falsee vinculam o ClusterRole somente-leitura;ORBIT_AUTH_MODE=oidcainda 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.mdda raiz carrega a mesma honestidade na escala da raiz do repositório, para quem ainda não abriudocs/.