teqo-backup/docs/changelog/2026-10-02-c244.md

3.1 KiB
Raw Blame History

C244 — filtro "Pessoa pública" por reconhecimento facial no álbum (2026-10-02): a faceta pessoa do álbum (/fotos?pessoa=<slug>) e a linha "Quem aparece" deixaram de sair do texto catalog.people da ficha e passaram a listar apenas as figuras públicas do catálogo curado reconhecidas nas fotos pelo índice facial do C240/C242 (decisão do dono de 2026-10-01, aval jurídico registrado). A curadoria é a collection nova faceFigure (admin.hidden não — admin-only, grupo Comunicação; nome público, slug = valor de ?pessoa, active, 1–8 descritores de referência com source/model/addedAt); os descritores são enrolados pela CLI nova pnpm faces:enroll-figure (exige exatamente 1 rosto por retrato, recusa fail-closed, dedupe por vetor, --replace para corrigir; guardas TEQO_ENV + FACE_FIGURE_CONFIRM, recibos sem vetor/bytes) e o catálogo inicial (as 6 figuras nomeadas + os 53 do roster S30, dedupe por slug = 58) pela pnpm seed:face-figures (FACE_FIGURE_SEED_CONFIRM, idempotente por slug, cria sem referências). O vínculo foto↔figura é derivado em leitura (findFaceFigureMatches puro + loadApprovedPhotoFigureMap server-only sobre o MESMO índice anônimo e o cache de 60 s do C240), sem marker novo e sem reprocessar os 18k rostos: o resultado é cacheado em unstable_cache sob a tag archivePhotos e o bust vem dos hooks da ArchivePhoto/FaceFigure, do opt-out (deleteFaceDescriptorMatches agora revalida a tag) e do runbook após os CLIs. A leitura pública com figuras é exclusiva da página (getApprovedArchivePhotoAlbumItems): o endpoint selfie e a rota de mídia seguem no read barato, sem matching nem Consent. Fail-closed: sem a linha do aviso busca-selfie-indice (checada FORA do cache — provisionar vale na hora) ou sem referências/figuras ativas, a faceta fica vazia; o texto do aviso em scripts/lib/faceConsentTexts.mjs foi atualizado para declarar o filtro curado e o limite (nunca terceiros), e o re-seed é a PRIMEIRA etapa do runbook §C244. catalog.people continua conteúdo da ficha/Central e alimenta o q, mas não cria mais a faceta nem "Quem aparece". Migration aditiva 20261001_235632_add_face_figure (face_figure + tabela de referências); sem score em nenhum estado. Provas: unit novo do matcher/pivô (threshold 0,45, modelo, ativa, dedupe, sem score), parser do CLI e catálogo seed (58 slugs únicos), catálogo público/faceSearch atualizados; int novo faceFigureReads (só figura reconhecida em foto aprovada, texto ignorado, figura inativa/modelo alheio, Consent fail-closed, unapproval, opt-out + bust) e faceFigure no lockdown de access; e2e frontendFotos atualizado (figura semeada + rosto indexado; ?pessoa=rui-costa só-texto vira o caso negativo com o texto vazio honesto) — 15/15 com frontendFotosSelfie. Pendente de ops (pós-deploy, ordem do runbook §C244): re-seed do aviso, seed:face-figures --apply, faces:enroll-figure por figura e o bust de archivePhotos; a curadoria das referências e a revisão de falsos positivos por exceção são do dono. Plano: docs/plans/album-pessoa-facial.md/-impl.md.