Ler o problema da empresa e desenhar a solução

Selo de estado: Preview (teto atual do produto) · Curso ACD-260 — Arquitetura de solução · Aula 1 de 8 · Atualizado em 2026-10-04.

Objetivo#

Ao final desta aula você vai traduzir perguntas de negócio em camadas e decidir a ordem de construção — e vai saber dizer, com justificativa, o que não entra na primeira entrega.

Vídeo#

Identificador: acd-260-01-ler-o-problema-da-empresa · Duração-alvo: 9 min · Tela: /overview.

Roteiro (capítulos):

1. 0:00–1:10 — O caso da Comércio Aurora (/overview) — seis filiais, um ERP, uma planilha de metas e três pedidos incompatíveis na mesma reunião.
2. 1:10–3:00 — As quatro perguntas que abrem qualquer desenho — que decisão isto sustenta, com que frescor, quem pode ver, quanto vale.
3. 3:00–5:00 — Da pergunta à camada (/sources) — o mapa pergunta → conexão → Bronze → Silver → Gold → modelo → painel → distribuição.
4. 5:00–6:40 — A ordem de construção (/dags) — por que a IA é a última camada e o que acontece quando ela é a primeira.
5. 6:40–8:00 — O que você recusa — os três pedidos que o desenho devolve na primeira semana, e como devolver.
6. 8:00–9:00 — O artefato — o desenho de uma página que vira o contrato da implantação.

Conteúdo#

O caso

A Comércio Aurora tem seis filiais, 42 pessoas, um ERP, uma planilha de metas que a controladoria mantém à mão e uma conta de anúncios. O plano contratado é o Growth e o time de dados é uma pessoa — a Maria, que também cuida do suporte interno. Na reunião de abertura aparecem três pedidos:

• o diretor quer a receita do dia anterior por filial antes das 8h;
• o gerente de Campinas quer "o mesmo painel", mas vendo só a filial dele;
• a controladoria quer fechar o mês conciliando ERP e metas.

Quem começa pela ferramenta responde "vamos montar um painel". Quem desenha a solução começa por outra coisa: a pergunta que cada pessoa precisa responder, e a decisão que depende dela.

As quatro perguntas que abrem qualquer desenho

Para cada pedido, responda nesta ordem — e escreva a resposta:

No caso da Aurora, as respostas reorganizam tudo. O pedido do diretor é "ontem" — e "antes das 8h" é um requisito de agenda, não de tempo real. O pedido do gerente é o mesmo painel com segurança por linha: um painel, não seis. O pedido da controladoria é conciliação mensal: ele tolera dado de D-1, mas exige que a regra de qualidade seja explícita, porque o número vai para o fechamento.

Da pergunta à camada

Só então o desenho vira camadas. O produto tem um caminho único — o medalhão — e cada pergunta aponta para um ponto dele:

A ordem de construção é essa mesma, de cima para baixo — e ela não é negociável, porque cada camada consome a de cima. A diferença entre uma implantação que entrega em três semanas e uma que atola em três meses quase sempre é inverter essa ordem: montar o painel sobre a Bronze "só para mostrar", e depois descobrir que o número tem pedido cancelado dentro.

O que precisa existir agora e o que pode esperar

Desenhar é também decidir o que não entra. Para a Aurora, o recorte da primeira entrega:

O que você recusa — e como

Três pedidos chegam e o desenho devolve:

• "Queremos tempo real." O que a pergunta pede é "antes das 8h", que uma agenda noturna resolve. Tempo real é outro custo e outro arranjo de nuvem (aulas 2 e 5). Devolva assim: "o número do dia anterior fica pronto às 2h; se depois medirmos que a decisão muda dentro do dia, revisitamos o modo de dados."
• "Já que estamos nisso, queremos 40 painéis." Um painel que ninguém abre custa manutenção e crédito de refresh. Devolva com a pergunta 1: "qual decisão cada um sustenta?" — a lista encolhe sozinha.
• "A IA pode ler o ERP direto e responder no WhatsApp." A IA lê a visão segura do próprio usuário, não a origem. Sem Silver e sem RLS, ela não tem o que ler sem vazar.

Recusar com justificativa não é dizer não ao cliente: é escrever a razão agora para não discutir a mesma coisa no terceiro mês.

Organização é estrutura, workspace é isolamento

Antes de desenhar, fixe o vocabulário que sustenta todas as decisões das aulas 3 e 4: a organização é uma camada puramente administrativa — ela diz quais workspaces existem e quem os administra, e nunca concede acesso aos dados de nenhum deles. O workspace é a unidade de isolamento real: datalake dedicado (aurora_bronze/_silver/_gold), pessoas, plano e cobrança. Acesso a dado exige membership no workspace, e a verificação é fail-closed: contexto de organização ausente ou divergente ⇒ negado.

Erros comuns de desenho

• Começar pelo painel. O painel é a última coisa visível e a última a ser construída.
• Confundir "antes das 8h" com tempo real. Um é agenda; o outro é arquitetura.
• Prometer um painel por pessoa. Isso é RLS, não duplicação de painel.
• Tratar a organização como atalho para dados. Ela não é — por desenho.
• Deixar a lista de perguntas na cabeça. O desenho de uma página existe para que a terceira reunião não recomece a primeira.

Faça você mesmo#

O produto desta aula é um artefato de decisão, não um clique: um desenho de solução de uma página que você mostraria ao cliente. Abra /overview no console só para conferir o que já existe no workspace de treino Aurora Varejo; o resto é escrito.

1. Liste as perguntas de negócio do caso (diretor, gerente, controladoria) — uma linha cada, na voz de quem pergunta.
2. Para cada pergunta, responda as quatro perguntas da tabela e escreva a resposta ao lado.
3. Monte a coluna camadas: para cada pergunta, marque até onde ela precisa chegar (conexão, Bronze, Silver, Gold, modelo, painel, RLS, IA).
4. Escreva a ordem de construção numerada, da conexão ao que for a última camada do seu desenho.
5. Escreva o recorte: duas colunas, "entra na primeira entrega" e "espera", com uma justificativa de uma linha por item que espera.
6. Escreva as três recusas com a frase que você diria ao cliente — não "não dá", mas a razão e a alternativa.
7. Confira no console que cada camada do seu desenho tem onde existir (/sources, /dags, /dashboards) e corrija o desenho se alguma não tiver.

Você terminou quando: a página cabe em uma folha, cada pergunta de negócio tem uma camada e uma ordem, e você consegue defender em voz alta por que a IA não está na primeira entrega e o que foi recusado.

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#

• data/pipeline-medalhao
• administracao/organizacao-e-workspaces
• ai/index

Capacidades ensinadas#

C11.1 · C02.1 — o selo exibido na aula é sempre o estado mais conservador entre as capacidades citadas; nada aqui é "GA".