Diário — Semana 8 (29/09/2026)
Período: 27/09 a 29/09/2026
Quem trabalhou: Luiza (@LuizaMaluf), Márcio (@DeM4rcio), Moura (@thegm445), Iago (@iagorrr)
Pauta: fechar a E1 (28/09) — identidade dos conselhos no main, site de documentação no ar e o make test rodando também no macOS.
O que foi feito
- Identidade dos conselhos no
main(PR #11, mergeado em 27/09): os 125 nomes da planilha em 82 conselhos, com o ADR 0004. O conteúdo está no diário de 26/09. - Histórico de nomes do órgão (issue #12, aberta e fechada pelo Iago em 27/09):
orgao_nomeaceitava intervalos sobrepostos e buracos. - Site de documentação em VitePress, publicado pelo GitHub Pages (PR #13, 28/09): as páginas são os
.mddo próprio repositório; só a página inicial e a "Entrega E1" foram escritas para o site. - Página "Jornada do dado", com diagrama Mermaid e a etapa do RAG (PR #16, 28/09), e a frase de abertura do site (PR #14).
- Teste do esquema no macOS (PR #15, 28/09).
O que foi medido
| Medida | Valor | Onde conferir |
|---|---|---|
| PR #13 (site) | 12 arquivos, +3.123 −1, 1 commit | PR #13 |
| PR #16 (jornada do dado) | 8 arquivos, +1.632 −77, 3 commits | PR #16 |
| Build do site, sem link quebrado | 14 páginas | AI-USAGE.md, 28/09 |
make test completo no Mac, depois do PR #15 | infra 5/5, esquema 26/26, planilha 21/21, conselhos 27/27, carga 15/15 — 94 verificações | AI-USAGE.md, 28/09 |
| Atos da planilha de 2020 em diante (quando o INLABS começa a servir) | 4 de 215 | consulta ao banco, registrada no AI-USAGE.md e na página "Jornada do dado" |
| Deploy do site logo depois do merge do PR #13 | falhou com HTTP 404; a API do repositório dizia has_pages: false | AI-USAGE.md, 28/09 |
| PRs de 28/09 revisados por outra pessoa da squad | 0 de 4 (#13, #14, #15 e #16 foram mergeados pela autora) | PRs e AI-USAGE.md |
O que surpreendeu
- O build passou e o deploy falhou. O GitHub Pages não estava ligado no repositório, e só o dono consegue ligar. O erro (HTTP 404 no passo de deploy) não diz isso; foi a API que disse.
- Um caractere quebrava o
make testno macOS. Opastedo macOS exige o-para ler da entrada:paste -sd,viroupaste -sd, -. No Linux as duas formas funcionam, por isso ninguém tinha visto. - Um erro que não era bug. Antes de achar o
paste, um erro decodigo_siorgfoi investigado e descartado: vinha de doismake resetrodando ao mesmo tempo no mesmo banco. - Só 4 dos 215 atos classificados caem no período que o INLABS serve. A planilha é quase toda anterior a 2020, então o gabarito da pesquisadora quase não cobre o que a ingestão vai trazer.
- O plugin do Mermaid exigiu ajuste de build: declarar dependências CommonJS e um link de
node_modulesna raiz para o modo de desenvolvimento.
O que foi decidido
- O site não duplica documentação. As páginas são os
.mddo repositório (README, ADRs, diários, relatórios de carga), e os links para.csv,.py,.sqle pastas são reescritos para o GitHub. - A página "Entrega E1" segue a ordem do checklist da disciplina, cada item com o link da evidência.
- O diagrama da jornada usa linguagem para leigos. A primeira versão, horizontal e com termos como "Bronze · Parquet", foi descartada.
- A validação da classificação pela pesquisadora saiu do fluxo do diagrama. Isso deixa a página em desacordo com o ADR 0001, que justifica o OLTP pelo julgamento humano da curadoria.
O que ficou em aberto
- Decidir entre manter a validação da pesquisadora como opcional ou revisar o ADR 0001.
- Como validar a classificação com só 4 atos rotulados no período do INLABS — ficou como decisão pendente da E2.
- Os quatro PRs de 28/09 entraram sem revisão de outra pessoa; a partir da semana 9 os PRs passaram a ter revisor.
Nota sobre uso de IA
O site, a página da jornada, o diagrama, o diagnóstico do deploy e a correção do teste no macOS foram feitos com auxílio de Claude Code, e estão registrados um a um no AI-USAGE.md (entradas de 28/09). Este diário foi redigido com Claude Code em 11/10, a partir dessas entradas e dos PRs #11, #13, #14, #15 e #16; os números da tabela foram conferidos na API do GitHub e no AI-USAGE.md, não de memória. A lista de quem trabalhou saiu dos autores dos PRs e das issues, e não de uma ata de reunião.