teqo-backup/docs/changelog/2026-10-01-c242-c243.md
Francisco Solla cd4942d9e2 feat(C242/C243): abre a busca por selfie a qualquer visitante (escopo B) + seção na homepage
O escopo A/C do gate (PR #1370) é superado por decisão do dono (2026-10-01, aval jurídico declarado): o índice vira anônimo (archivePhotoFace, foto + descritor 128-d, sem nome/vínculo), o enrollment por pessoa morre (faceSubject/faces:enroll removidos) e qualquer visitante encontra as próprias fotos aprovadas.

- faces:index persiste os descritores por foto (transação substitui as linhas + marker = modelo); desaprovar/remover/deletar foto apaga os descritores (hooks + FK cascade)
- POST /api/fotos/selfie casa o vetor da consulta contra o índice em memória (TTL 60 s) e devolve só a interseção com o read aprovado do C233, sem score/nome de terceiro; leave-index apaga os descritores que casarem
- Consentimentos seguem fail-closed: busca-selfie-fotos (consulta) e busca-selfie-indice (aviso público do índice), textos versionados em scripts/lib/faceConsentTexts.mjs e provisionados por pnpm seed:face-consents
- pnpm archive:publish aprova o acervo em lote (draft -> approved; removed nunca) com guardas e recibo
- C243: seção condicional SelfieSearchHomeSection (port do design hi-fi, cenas 390/1280) entre a Central e a newsletter; sem engine/captura na home e sem CTA morto quando fechada
- docs: planos C242/C243, AGENTS-public, runbook §C242, changelog

Provas: gate:fast 457 arquivos/5.055 testes; int full 109/1.075; e2e frontendFotosSelfie 9/9; knip verde.
2026-10-01 12:54:47 -03:00

3.4 KiB

C242/C243 — busca por selfie aberta a qualquer visitante (escopo B) + seção na homepage (2026-10-01): o C234 entregou a busca fechada e no escopo A/C (só quem era inscrito pela assessoria se achava); por decisão do dono na sessão de 2026-10-01, com aval jurídico declarado, o escopo do gate (PR #1370) foi reaberto para B: o índice passa a ser anônimo — descritores 128-d extraídos dos rostos das fotos aprovadas do acervo, persistidos sem nome e sem vínculo com pessoa na collection nova archivePhotoFace (admin.hidden, admin-only), para que qualquer visitante encontre as próprias fotos. O enrollment A/C morre (collection faceSubject, pnpm faces:enroll e a adesão por pessoa foram removidos; migration 20261001_040904_add_archive_photo_face cria a tabela nova com FK ON DELETE CASCADE, dropa a antiga — 0 linhas em produção — e o gerador reordenado à mão para o CASCADE do drop não engolir o DROP CONSTRAINT). O lote pnpm faces:index agora persiste os descritores (transação por foto substitui as linhas + marker faces.checkedKey = modelo); desaprovar/remover/deletar foto apaga os descritores nos hooks da collection (e o FK cobre SQL direto); o endpoint POST /api/fotos/selfie casa o vetor da consulta contra o índice carregado em memória (TTL 60 s, Float32Array, teto defensivo) e devolve só a interseção com o read aprovado do C233 — sem score, sem nome de terceiro; leave-index apaga os descritores que casarem (opt-out de fato). Fail-closed mantido: selfieSearchEnabled segue false, e os dois Consentimentos continuam obrigatórios — busca-selfie-fotos (consentimento da consulta, reescrito) e busca-selfie-indice (reclassificado como aviso público do índice, sem consentHash/elegibilidade por pessoa), com os textos versionados em scripts/lib/faceConsentTexts.mjs e provisionados por pnpm seed:face-consents (guarda TEQO_ENV/FACE_CONSENT_SEED_CONFIRM); a página exige os dois e mostra o aviso completo em <details>. Ops ganhou pnpm archive:publish (lote draft → approved, nunca toca removed, exige canal de remoção válido, guardas + recibo) para as 6.492 fotos nunca publicadas; o runbook §C242 documenta a abertura na ordem (canal → consentimentos → lote → indexação → flag) e o rollback. C243: a homepage pública ganha a seção condicional SelfieSearchHomeSection (design hi-fi docs/plans/busca-selfie-secao-home-ui-design.html, cenas 390/1280) entre a Central e a newsletter — só apresenta e linka (sem engine/captura/fotos/contadores na home), renderizada apenas com álbum publicado + flag + fotos aprovadas (fail-closed: fechada não deixa CTA morto). Copy do fluxo/entrada atualizada para o escopo B (o artefato busca-fotos-por-selfie-ui-design.html foi estendido pelo designer, que também atualizou DESIGN.md §7). Provas: unit 456 arquivos/5.050 testes verdes (novos: findFaceDescriptorPhotoIds, planos dos CLIs, textos de consentimento, gating da home), int full verde 109 arquivos/1.075 testes (índice/purges/endpoint/opt-out/rate limit), e2e frontendFotosSelfie atualizado (descritores em vez de subjects; opt-out por linhas; seção da home aberta/fechada). Pendente de ops (pós-deploy): canal de remoção, seed:face-consents --apply, archive:publish --apply + bust da tag, faces:index --apply e a flag. Planos: docs/plans/busca-selfie-escopo-b.md/-impl.md e docs/plans/busca-selfie-secao-home.md/-impl.md.