Migração Inicial — Notion → Git
Data da operação: 13 de maio de 2026.
Este diretório guarda o script (_reorganize.py) que materializou a importação inicial da UDCL do Notion para este repositório Git. É artefato histórico: documenta como a sede operacional saiu de uma exportação Markdown do Notion e chegou na topografia atual (manual/, constituicao/, codigos/, poderes/, etc.).
O que o script fez
Section titled “O que o script fez”- Leu a exportação Markdown do Notion (
UDCL — MANUAL TÉCNICO DE OPERAÇÕES/), tratando-a como fonte read-only. - Mapeou cada um dos 666 arquivos (623
.md+ 42.csv+ 1 página-raiz do Manual) para uma posição na nova estrutura. - Renomeou todos os arquivos e pastas para lowercase-kebab-case ASCII, removendo o ID hexadecimal do Notion do final dos nomes (ex.:
A UNIÃO — NATUREZA, ORIGEM E FUNDAMENTOS 30465fdd5fe5810f88a1e86564678bba.md→manual/01-a-uniao.md). - Reescreveu 511 links internos em 77 arquivos, traduzindo as referências cruzadas do formato Notion (path URL-encoded + hex ID) para caminhos relativos no novo repositório, via tabela
hex-ID → novo caminho. - Detectou e resolveu 2 colisões de nomes (duas páginas distintas com títulos truncados idênticos no Notion) acrescentando os 6 primeiros caracteres do hex original como sufixo desambiguador.
Convenções de migração
Section titled “Convenções de migração”- Páginas-mãe com filhos: arquivo
.mdhomônimo de pasta viraREADME.mddentro da pasta. - Bases Notion: cada base ganha uma pasta própria contendo as linhas individuais (
.md) + os dois snapshots CSV exportados (data.csv,data_all.csv). notion_idpreservado: atos normativos vigentes recebem frontmatter YAML com o hex original para rastreabilidade.
Pendências conhecidas
Section titled “Pendências conhecidas”5 hex IDs aparecem em links mas não estão na exportação. Detalhados em ../../DEBITO-TECNICO.md.
Status
Section titled “Status”Concluído. O script não deve ser re-executado sobre o repositório atual — ele faz clean_dest() no início e apagaria todo o trabalho subsequente. Está aqui como documentação do método, não como ferramenta operacional viva.
Para qualquer ressincronização futura com o Notion, recomenda-se script novo que respeite a topografia já estabelecida.