Cadastro de Edição ICDB a Partir de Nota Bruta

Use quando Hugo falar dados incompletos de uma nova edição e pedir para preparar ou editar a aba editions.

Fonte oficial de cadastro:

https://docs.google.com/spreadsheets/d/1gmRa1MMCPYPWUgRBpVXV9OQ6xUWu5CHKUE6ZBKQ9d74/edit?gid=163253672#gid=163253672

Fluxo MVP

Transformar a fala solta em uma linha candidata.
Ler a aba editions atual para checar duplicidade e conflitos.
Separar campos conhecidos de pendências.
Gerar edition_slug, token e link quando cidade/UF/mês estiverem claros.
Só escrever na planilha se Hugo pedir escrita e se não houver colisão ou ambiguidade.
Rodar dry-run antes do append real.
Depois do append, reler a planilha e confirmar a linha inserida.

Campos da Linha

project_slug
edition_slug
token
active
title
event_date
event_date_reservation_status
capacity
link
webapp_slugs
trainer

Defaults

project_slug: icdb.
active: 1 se for edição real em preparação.
capacity: 100, salvo dado diferente.
event_date_reservation_status: pesquisando quando ainda não há data/local.
event_date: vazio quando só existe mês.
title: Cidade/UF Mês.

Geração Técnica

Para novas edições, usar o slug canônico novo:

icdb-{cidade_slug}-{uf}-{pais}-{AAAAMM}

Exemplos:

icdb-rio-rj-br-202607
icdb-campinas-sp-br-202608
icdb-sao-luis-ma-br-202610

Os slugs antigos como icdb21-202606, icdb11-202607 e icdb63-202607 ficam como legado/crosswalk. Não usar para novas edições, salvo pedido explícito.

Gerar token como uma string aleatória curta de 7 a 8 caracteres com letras minúsculas e números, conferindo antes se não existe na aba.

O link é derivado:

https://app.reorganize.com.br/ckl/icdb/{edition_slug}?t={token}

Script de Apoio

Usar o script versionado:

.venv/bin/python rz-coo/agents/events-NEHEMIAH/scripts/append_icdb_edition.py \
  --edition-slug icdb-campinas-sp-br-202608 \
  --title "Campinas/SP Agosto" \
  --trainer "Li Lizardi" \
  --status pesquisando \
  --capacity 100 \
  --active 1 \
  --dry-run

Se o dry-run estiver correto, repetir sem --dry-run. O script:

lê a aba antes de escrever;
bloqueia edition_slug duplicado;
bloqueia title duplicado;
gera token único quando --token não é informado;
monta o link da Suprema automaticamente.

Exemplo

Entrada:

campinas com Li Lizardi sem data, sem local ainda, vai ser em agosto

Linha candidata:

project_slug: icdb
edition_slug: icdb-campinas-sp-br-202608
token: gerar aleatório único
active: 1
title: Campinas/SP Agosto
event_date:
event_date_reservation_status: pesquisando
capacity: 100
link: https://app.reorganize.com.br/ckl/icdb/icdb-campinas-sp-br-202608?t={token}
webapp_slugs:
trainer: Li Lizardi

Pendências:

token único, data exata, local, webapp_slugs

Resposta curta esperada:

Entendi como edição candidata: Campinas/SP Agosto, com Li Lizardi.
Slug candidato: icdb-campinas-sp-br-202608.
Ainda não escrevi porque falta confirmar escrita e gerar token único sem colisão.

Caso Validado

Em 2026-06-15, o fluxo foi validado com:

Campinas/SP Agosto
edition_slug: icdb-campinas-sp-br-202608
token: iocc00k9
status: pesquisando
capacity: 100
trainer: Li Lizardi

O append funcionou e a linha foi confirmada por releitura da aba EDITIONS.

Comentar sobre este guia