Preview, GA-candidato, Roadmap, NÃO MEDIDO

Selo de estado: Preview (teto atual do produto) · Curso ACD-100 — Fundamentos Ingestia · Aula 2 de 10 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai interpretar o selo e o que ele proíbe prometer — classificar qualquer página da documentação ou recurso do produto pelo estado e dizer a um cliente ou colega o que pode e o que não pode ser prometido hoje.

Vídeo#

Identificador no manifesto: acd-100-02-selos-de-estado-preview · duração-alvo 5 min · tela do produto: /overview.

Roteiro de gravação (5 capítulos):

#	Minutagem-alvo	Capítulo	Tela do produto
1	0:00–0:30	Abertura: título + selo. Por que uma aula inteira sobre um selo: é a diferença entre "implementado" e "certificado em nuvem".	`/overview`
2	0:30–1:45	A legenda: `GA-candidato`, `Preview`, `Roadmap`. Teto = Preview; nenhum GA. Ler a tabela em voz alta.	`/docs/primeiros-passos`
3	1:45–2:45	Dois rótulos a mais: Fora de GA (tabela de superfícies de integração) e NÃO MEDIDO (vocabulário de Dados).	`/docs/suporte/status-e-limitacoes` · `/docs/data`
4	2:45–4:00	Lendo um selo misto na prática: página com `GA-candidato` para conta/MFA e `Preview` para provisionamento — a regra do mais conservador.	`/docs/primeiros-passos/conta-organizacao-workspace`
5	4:00–5:00	O que não prometer (lista de "não prometemos hoje") e o "faça você mesmo": classificar três docs.	`/docs/suporte/status-e-limitacoes`

Conteúdo#

Por que existe um selo

Toda página da documentação começa com uma linha Selo de estado. Ele é derivado da matriz de estados do produto — 90 recursos mapeados, nenhum GA, teto Preview — e é atualizado junto com o código: mudança de estado é mudança de doc no mesmo release.

A frase que resume a regra está na própria legenda: recurso implementado não é o mesmo que recurso certificado em nuvem. O selo existe para que ninguém — vendedor, analista, dono — prometa o que o produto ainda não provou fora do ambiente de teste.

Os estados

Rótulo	O que significa	O que você pode dizer	O que você NÃO pode dizer
`GA-candidato`	Motor provado por testes automatizados de referência, com resultado idêntico a cada execução. Teto ainda Preview: sem SLA, sem certificação de nuvem.	"Provado por testes; comportamento determinístico."	"É GA", "tem SLA", "certificado em produção".
`Preview`	O caminho existe e é documentado, mas depende de infraestrutura paga, credencial real ou validação humana ainda não exercida. Sem SLA; sujeito a ajustes.	"Funciona e está documentado; sem garantia de uptime/latência."	Qualquer número de SLA, uptime, latência ou custo garantido.
`Roadmap`	Arquitetura ainda não construída. Não disponível.	"Está planejado."	"Já dá para usar"; não construa integração sobre ele.
Fora de GA	Existe no código, não liberado para uso externo hoje (ex.: API REST `/api/v1/query` e `/api/v1/tables`).	"Existe, não está aberto; use a alternativa indicada (OData)."	"Está disponível."
NÃO MEDIDO	Marca de medição, não de disponibilidade: métricas de nuvem (latência, custo faturado, uptime, RPO/RTO) não foram medidas e, por isso, não são publicadas.	"Não publicamos esse número."	"Não funciona" — e também não "funciona garantido".

A documentação de Dados refina o Preview em dois graus: Preview (provado) — caminho provado por teste determinístico e suíte de contrato — e Preview (limitado) — código pronto com guarda honesta, mas o caminho real (credencial, infra paga) ainda não exercido ponta a ponta. Há ainda Blocked: barreira dura, sem evidência executável, não aparece como disponível.

NÃO MEDIDO descreve a medição, não uma fila de liberação

A página do pipeline medalhão diz isso com todas as letras: a execução depende de o ambiente de nuvem do workspace estar configurado — sem ele, falha com mensagem em vez de fingir sucesso. Em produção, nada finge.

A regra do mais conservador

Uma página costuma cobrir várias capacidades, e o selo do cabeçalho junta todas. Exemplo real: Conta, organização e workspace traz GA-candidato para conta, organização, workspace e MFA, mas provisionamento do datalake em nuvem = Preview. Para efeito de promessa, vale o mais conservador: você pode dizer que o cadastro e o MFA são provados por testes; não pode dizer que a criação dos datasets no BigQuery está certificada.

A Academy segue a mesma regra: o selo de cada aula é o mínimo entre as capacidades citadas, e "GA" nunca aparece.

Como aparece no produto

O selo não fica só na documentação:

No catálogo de conectores, cada cartão traz o estado público: Disponível, Acesso limitado (pode exigir habilitação) ou Planejado. Um item Planejado não aparece como opção de cadastro — de propósito — e não é uma conexão utilizável.
Na tabela de superfícies de integração (Status e limitações): chave de API, OData v4, kit Power BI/Excel e Embed SDK são Preview; a API REST de consulta é Fora de GA; assinatura de webhooks, API de escrita e chave de API por membro são Roadmap.
Em custo: todo valor em BRL exibido no produto é projeção, não preço faturado garantido.

O que o selo proíbe prometer

A seção "O que NÃO prometemos hoje" é a lista para colar na parede:

Sem SLA — nenhum número de uptime, latência ou throughput como garantia.
Sem RPO/RTO como promessa contratual.
Sem "paridade total com o Power BI".
Isolamento entre clientes é fail-closed por desenho, mas a certificação "provado em produção" em nuvem ainda está pendente.
Custo em BRL é projeção. Entrega real de e-mail transacional pode não estar habilitada no ambiente.

Em resumo: o que está barrado hoje são promessas de latência, custo faturado, RPO/RTO, uptime, paridade total, API REST como GA, entrega de e-mail garantida e isolamento "provado em produção". Conectores externos, SSO/SCIM e WhatsApp/PDF/PPTX são Preview com limitações declaradas. Nada disso pode ser ensinado, vendido ou cobrado em exame como "disponível".

Exemplo: a pergunta da diretoria

Na Comércio Aurora, a diretoria pede a João: "podemos receber o painel por e-mail toda segunda?". João abre a página de compartilhamento e lê o selo: assinatura com RLS no envio = GA-candidato; entrega real por e-mail = Preview (domínio ainda não verificado; em demonstração o envio é simulado). A resposta honesta: "configurar a assinatura, sim; garantir que o e-mail chega, ainda não — e eu consigo mostrar isso na doc".

Erros comuns

Ler GA-candidato como GA. O "candidato" é o que importa.
Ler NÃO MEDIDO como "quebrado". É um número não publicado, não um recurso recusado.
Construir sobre Roadmap ou Fora de GA. A própria tabela de troubleshooting diz: não construa integração crítica sobre isso.
Citar o custo previsto como preço. É estimativa (dry-run simulado).

Se a doc diz X e o app faz Y

Trate como possível divergência de estado e abra um chamado citando a página e a URL. A doc é a fonte da verdade do estado; divergência é defeito, não detalhe.

Faça você mesmo#

Classifique três documentos pelo selo:

Abra /docs/primeiros-passos e leia a Legenda de estados. Anote as três linhas da tabela em uma frase cada.
Abra /docs/primeiros-passos/conta-organizacao-workspace. No cabeçalho, separe: o que está em GA-candidato e o que está em Preview na mesma página. Qual selo vale para a promessa? Por quê?
Abra /docs/data/pipeline-medalhao. Localize a marca NÃO MEDIDO e escreva o que ela descreve (medição) e o que ela não descreve (fila de liberação).
Abra /docs/suporte/status-e-limitacoes. Na tabela de superfícies, aponte uma linha Preview, uma Fora de GA e uma Roadmap.
Para cada uma das três páginas, escreva a frase que você diria a um cliente no formato "hoje podemos X; não prometemos Y".
Guarde as três frases: elas são o modelo de resposta para qualquer "isso já está pronto?".

Você terminou quando classificou as três páginas, dividiu corretamente a página de selo misto e consegue explicar NÃO MEDIDO sem usar a palavra "não funciona".

Checagem rápida#

Três perguntas no final da aula, corrigidas no servidor. A aula só conta como concluída depois da checagem.

Documentação relacionada#

Capacidades ensinadas#

C00.6 — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".