teqo-backup/scripts/seed-face-consents.mjs
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

159 lines
4.9 KiB
JavaScript

/**
* C242 — provisions the two Consent texts of the selfie search by their stable
* keys (`busca-selfie-fotos` query consent, `busca-selfie-indice` public index
* notice). Idempotent: creates the row when missing, updates the text when the
* repo text changed (Payload versions the consent).
*
* Modes:
* pnpm seed:face-consents plan/dry-run (default) — shows the state; no write
* pnpm seed:face-consents --apply upserts the texts; requires
* FACE_CONSENT_SEED_CONFIRM=1 outside local dev
* and the declared TEQO_ENV matching the
* exact database
*
* The texts are versioned in `scripts/lib/faceConsentTexts.mjs` — the delivery
* that opens the surface owns what the visitor reads.
*/
import { getPayload } from 'payload'
import { FACE_INDEX_CONSENT_KEY, FACE_SEARCH_CONSENT_KEY } from '../src/lib/campaignConsentKeys.ts'
import {
TEQO_ENV_DATABASE_BY_ENV,
assertEnvironmentDatabaseTarget,
assertWriteConfirm,
databaseTarget,
dieWithLabel,
loadCliEnv,
} from './lib/cli.mjs'
import {
FACE_INDEX_CONSENT_PARAGRAPHS,
FACE_INDEX_CONSENT_TEXT,
FACE_SEARCH_CONSENT_PARAGRAPHS,
FACE_SEARCH_CONSENT_TEXT,
} from './lib/faceConsentTexts.mjs'
loadCliEnv()
const die = dieWithLabel('seed:face-consents')
const WRITE_CONFIRM_FLAG = 'FACE_CONSENT_SEED_CONFIRM'
const envLines = Object.entries(TEQO_ENV_DATABASE_BY_ENV)
.map(([environment, database]) => `${environment} (${database})`)
.join(' | ')
const HELP = `
Uso: pnpm seed:face-consents [opções]
Cria/atualiza os dois Consentimentos da busca por selfie:
${FACE_SEARCH_CONSENT_KEY} consentimento da consulta (selfie + biometria)
${FACE_INDEX_CONSENT_KEY} aviso público do índice anônimo do acervo
Modos:
(sem flag) plano/dry-run — estado atual e prévia dos textos; sem escrita
--apply grava os textos (exige ${WRITE_CONFIRM_FLAG}=1 fora do dev local)
Ambiente:
DATABASE_URL alvo (obrigatório em todos os modos)
--apply em alvo não-local/produção exige ${WRITE_CONFIRM_FLAG}=1 e TEQO_ENV=${envLines}
casando o banco exato. O plano é read-only.
`
const upsertConsent = async (payload, key, text) => {
const existing = await payload.find({
collection: 'consent',
where: { key: { equals: key } },
depth: 0,
limit: 1,
overrideAccess: true,
})
const found = existing.docs[0]
if (found) {
await payload.update({
collection: 'consent',
id: found.id,
data: { text },
depth: 0,
overrideAccess: true,
})
return { id: found.id, action: 'updated' }
}
const created = await payload.create({
collection: 'consent',
data: { key, text },
depth: 0,
overrideAccess: true,
})
return { id: created.id, action: 'created' }
}
async function main() {
const argv = process.argv.slice(2)
if (argv.includes('--help') || argv.includes('-h')) {
console.log(HELP)
process.exit(0)
}
const unknown = argv.find((arg) => arg !== '--apply')
if (unknown) die(`argumento desconhecido: ${unknown} — uso: pnpm seed:face-consents [--apply].`)
const apply = argv.includes('--apply')
if (!process.env.DATABASE_URL) die('DATABASE_URL não definida; recusando continuar.')
console.log(`[seed:face-consents] alvo: ${databaseTarget()} | modo: ${apply ? 'apply' : 'plan'}`)
if (apply) {
assertWriteConfirm({
label: 'seed:face-consents',
flag: WRITE_CONFIRM_FLAG,
command: 'pnpm seed:face-consents --apply',
})
assertEnvironmentDatabaseTarget()
}
const config = (await import('../src/payload.config.ts')).default
const payload = await getPayload({ config })
const entries = [
{
key: FACE_SEARCH_CONSENT_KEY,
text: FACE_SEARCH_CONSENT_TEXT,
paragraphs: FACE_SEARCH_CONSENT_PARAGRAPHS,
},
{
key: FACE_INDEX_CONSENT_KEY,
text: FACE_INDEX_CONSENT_TEXT,
paragraphs: FACE_INDEX_CONSENT_PARAGRAPHS,
},
]
for (const entry of entries) {
const existing = await payload.find({
collection: 'consent',
where: { key: { equals: entry.key } },
depth: 0,
limit: 1,
overrideAccess: true,
})
const state = existing.docs[0] ? `existe (#${existing.docs[0].id})` : 'ausente'
console.log(
`[seed:face-consents] ${entry.key}: ${state} | texto com ${entry.paragraphs.length} parágrafo(s)`,
)
if (!apply) continue
const result = await upsertConsent(payload, entry.key, entry.text)
console.log(`[seed:face-consents] ${entry.key}: ${result.action} (#${result.id})`)
}
if (!apply) {
console.log('\n[seed:face-consents] dry-run — use --apply para gravar.')
process.exit(0)
}
console.log('\n[seed:face-consents] OK — Consentimentos da busca por selfie provisionados.')
process.exit(0)
}
main().catch((error) => {
die(error?.message || String(error))
})