Skip to content

docs(lago): o cartão da etapa 1, o lago da empresa nasce e some - #1231

Draft
leandrotcawork wants to merge 3 commits into
mainfrom
feat/conexus-lago1-cartao
Draft

leandrotcawork wants to merge 3 commits into
mainfrom
feat/conexus-lago1-cartao

Conversation

@leandrotcawork

@leandrotcawork leandrotcawork commented Nov 22, 2026 •

Copy link
Copy Markdown
Collaborator

Why

O cartão da etapa 1 do lago (trilha Dados), "O lago da empresa nasce e some", escrito a partir do estudo conexus-lago1-estudo e das respostas do fundador a ele ("6.a 7a 8a 9a 10a", 2026-11-21). Ele espera neste PR em rascunho (delivery L5), porque o Registro e conformidade ainda fecha e a mudança de método vem antes. O fundador lê e aprova a página de manhã ("2. A", 2026-11-22). Nada aqui é mesclado.

What changed

  • docs/steps/o-lago-da-empresa-nasce-e-some.md, o cartão novo: a página do fundador, 6 unidades em 3 grupos, os critérios, a matriz de estados, a tabela de falhas, a tabela de referência com 23 linhas e as 20 decisões do firstmate.
  • Na página do fundador, três decisões novas:
    • F, como conter o poder largo que o papel de serviço do CloudFormation recebe. O P3 do estudo achou que ele precisa ser administrador do lago. A recomendação é a receita por endereço fixo, presa por cloudformation:TemplateUrl.
    • G, as permissões da tabela lake.company_lake (data D11).
    • H, tirar da conta de laboratório as peças feitas à mão em 19/11.
  • Decisões técnicas do firstmate que o cartão leva:
    • o P2 roda na construção, numa região sem a ligação do S3 Tables (L.6);
    • o papel de serviço vira administrador do lago com MutationType: APPEND (L.9).

Scope

Só documentos. Nenhum código, nenhuma mudança na AWS nem no servidor, nada em docs/approvals/. A linha de aprovação proposta está fora do repositório, na pasta da tarefa (approval-line.md).

Tradeoffs

  • O cartão parte da mudança de método mesclada (o dublê da AWS, a C56, a S31 e a D25). Se ela mesclar com outra forma, o firstmate relê a seção "Antes da construção".
  • Com a F (b), o critério 4, o 10 e o 30 e o depósito das receitas mudam. O U1 diz como.

Blast Radius

Só docs/steps/. O processo fica vermelho em second-card enquanto o PR não for rascunho (L5). Na prática ele roda com CONEXUS_DRAFT=true.

Verification

  • CONEXUS_DRAFT=true npm run check passou em tudo, menos em check:workflows, que precisa de Docker e não roda neste ambiente. Nenhum workflow mudou.
  • npm run docs: 236 documentos ok. São 2.499 palavras por unidade fora da página, abaixo das 2.500.
  • Leitura independente (conexus-scope, passo 8) por um leitor Sonnet que não o escreveu. A primeira volta deu 10 Bloqueia, 8 Fechamento e 5 Nit, tratados em 7c00e4b5; o delta e as correções dele (8a3a37b6) estão num comentário deste PR.

Generated by Claude Code

reviewer added 3 commits November 22, 2026 01:58
…reparação antes das provas, toda recusa num estado, as decisões F, G e H em palavras simples

Copy link
Copy Markdown
Collaborator Author

A leitura do cartão (conexus-scope, passo 8)

Leitor: Sonnet, que não escreveu o cartão, com as oito perguntas de references/card.md, o estudo e o main em 4d143a99.

Primeira volta, em 953cb3c4: 10 Bloqueia, 8 Fechamento, 5 Nit. Os principais:

  • Bloqueia, permissões.
    • Faltava CAPABILITY_NAMED_IAM e cloudformation:TagResource.
    • O papel de serviço podia reescrever os papéis da plataforma.
    • O Hub podia assumir o leitor de qualquer empresa.
    • A trava TemplateUrl não tinha recusa ao vivo.
  • Bloqueia, estados. A função de estado deixava "Criando…" para sempre em seis recusas da AWS. A exclusão do cliente com o lago em criação nunca andava.
  • Bloqueia, ordem e testes.
    • A preparação da conta vinha depois das provas que dependem dela.
    • A frase nova de CLIENT_DELETION_PENDING quebrava dois testes de tela fora da unidade.
    • A configuração e o compose.yaml não estavam em nenhuma unidade.
  • Bloqueia, decisão G. Ela se apoiava numa analogia falsa com company_database: lá o login do operador só lê e apaga.

Todos tratados em 7c00e4b5:

  • A PreparationStack e o passo a passo foram para a U1.
  • O critério 55 diz que toda recusa termina num estado que a tela mostra.
  • O critério 4 ganhou quatro recusas ao vivo.
  • A página do fundador foi reescrita em palavras simples, e a H virou uma decisão própria.

Delta, 953cb3c4..7c00e4b5.

  • Das 27 conclusões, 23 fecharam, 3 fecharam em parte e nenhuma ficou aberta.
  • O delta trouxe 4 Fechamento e 3 Nit novos:
    • a ordem dos critérios 66 e 67;
    • o passo 5 do roteiro precisa de uma sessão de teste do firstmate marcada com a empresa A;
    • subir o client-s3 mexia em builder/git/copy/;
    • o dono da frase em hub-api;
    • o nome do papel do Lake Formation;
    • a região vazia depois do cdk destroy;
    • o tamanho da U1.
  • Todos tratados em 8a3a37b6, menos o último: a U1 fica com cerca de 880 linhas, abaixo do teto da etapa. Se o contexto apertar na construção, ela se divide entre a preparação e a plataforma.
  • Esse último commit traz só Fechamento e Nit e não voltou ao leitor.

O que a leitura deixou dito. O P2, a trava TemplateUrl e o aws:ResourceTag do S3 Tables não estão provados. O cartão os põe como provas da U1, com "Parar se" para cada um.


Generated by Claude Code

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant