teqo-backup/docs/changelog/2026-10-02-c245.md
Francisco Solla 930db3eb02 feat(C245): catalogar o acervo em produção por camadas — metadados primeiro
A catalogação do C232 nunca rodou em produção: catalog.* zerado nas 6.492
fotos publicadas e o engine de visão fora do ar. O pnpm archive:catalog
ganha --metadata-only: deriva município (gazetteer) e temas do texto já
ingerido, sem engine e sem mídia, grava catalog.metadataCheckedAt
(migration aditiva) e não marca catalogedAt — a fila da IA segue aberta.
Nunca escreve catalog.people (C244 assume a faceta por facial).

A passada de IA passa a carimbar os dois markers; a fila de metadados exclui
linha já catalogada pela IA (não rebaixa o source); o --verify relata as duas
camadas com exit pela selecionada; o --apply de metadados dispensa S3_* e
engine. Runbook §C245: metadados → revalidate archivePhotos → IA.

Closes #1417
2026-10-02 10:17:49 -03:00

1.4 KiB

C245 — catalogação do acervo em produção: camada de metadados sem IA (2026-10-02): a catalogação do C232 nunca rodou em produção (catalog.* zerado nas 6.492 fotos publicadas), e a faceta Município/atividade e a legenda do card dependiam do engine de visão, fora do ar. O pnpm archive:catalog ganha --metadata-only: deriva município (gazetteer) e temas do texto já ingerido — sem engine e sem baixar mídia — usando o mesmo núcleo transacional/fresh-read e os mesmos builders puros, com o texto base extraído num helper compartilhado (archivePhotoCatalogText). A camada grava catalog.metadataCheckedAt (novo marker com migration aditiva add_archive_photo_metadata_checked) e não marca catalogedAt, então a fila da IA segue aberta; nunca escreve catalog.people (a faceta de pessoa é da C244, por facial). A passada de IA passa a carimbar os dois markers, as duas filas convergem (a de metadados exclui linha já catalogada pela IA para não rebaixar o source), o --verify relata as duas camadas (exit 1 pela selecionada) e o --apply de metadados dispensa S3_* e engine — só ARCHIVE_CATALOG_CONFIRM e TEQO_ENV casando o banco. O runbook §C245 documenta a ordem de produção: metadados → POST /api/revalidate?tag=archivePhotos (o write do container de manutenção não busta o ISR) → IA quando o engine subir. Nenhuma UI nova; curadoria vence; nada é publicado.