teqo-backup/.env.example
Francisco Solla 671af1e21f
Some checks are pending
Deploy / preflight (push) Waiting to run
Deploy / verify (push) Blocked by required conditions
Deploy / deploy staging (teqo-staging) (push) Blocked by required conditions
Deploy / requeue when main advanced (push) Blocked by required conditions
Deploy / deploy production (teqo-1313) (push) Blocked by required conditions
feat(C232): pré-catalogar o acervo de fotos com IA local e curadoria que vence
Collection archivePhoto ganha o grupo catalog (legenda/descrição/cena/texto
visível/temas/pessoas/município/origem/catalogedAt), curatedFields (o que a
assessoria edita nunca é sobrescrito), takenOn e searchText com índice GIN trgm
(migration aditiva add_archive_photo_catalog); hook beforeValidate deriva o
índice e marca curadoria só em edição humana; pipeline transacional baixa os
bytes privados, prepara JPEG <=1024px com sharp e mescla o VLM local com o
gazetteer/catálogo curado (pessoas só do TEXTO, nunca de rosto); CLI
pnpm archive:catalog (plan/--apply/--verify, recibo honesto, idempotente por
catalogedAt) com engine OpenAI-compatible na rede privada atrás de guarda de
host (ARCHIVE_VISION_ALLOW_REMOTE é o escape); client HTTP com retry/timeout e
parser zod fail-closed; resolver de município extraído para owner compartilhado
com o catálogo de peças delegando; unit/int novos e runbook staging-primeiro.
2026-09-26 12:30:34 -03:00

118 lines
6.4 KiB
Text

# Copy this file to `.env.local` for local development.
#
# For LOCAL DEVELOPMENT, DATABASE_URL must point at the local Postgres started by
# docker-compose (`pnpm db:start`). `pnpm dev` will REFUSE to start against a
# non-local host (e.g. the production Neon database) unless you explicitly set
# ALLOW_REMOTE_DB=true — this is intentional, to protect production data.
DATABASE_URL=postgresql://teqo:teqo@localhost:5432/teqo
PAYLOAD_SECRET=YOUR_SECRET_HERE
# Media storage (OPS52) — Garage S3 (homeserver). When ANY of the four required
# envs (S3_BUCKET, S3_ENDPOINT, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY) is set,
# ALL of them must be: a partial config aborts the boot with the exact missing
# names (fail-closed). When none is set, Payload falls back to local disk storage
# (dev/test). The bucket stays PRIVATE: the app proxies the files through its
# /media/file route (the plugin streams each object from Garage), so no public
# bucket/DNS is needed. Production: S3_BUCKET=teqo-media,
# S3_ENDPOINT=http://100.119.220.31:3900 (tailnet do homeserver). Staging
# (OPS103) has its own bucket `teqo-media-staging` — never share the
# production bucket across environments.
S3_BUCKET=
S3_ENDPOINT=
S3_REGION=garage
S3_ACCESS_KEY_ID=
S3_SECRET_ACCESS_KEY=
# Canonical public origin used in absolute campaign invite links. In production
# this must be an exact HTTPS non-local origin: no credentials, path other than
# `/`, query, or fragment. Production ignores request headers and invite
# creation fails closed when this value is invalid. Development/test accepts
# request-derived origins only for exact localhost, 127.0.0.1, or ::1 hosts and
# normalizes them to HTTP; otherwise this configured origin is the only fallback.
NEXT_PUBLIC_SITE_URL=http://localhost:3000
# S15 — test seam for the on-device card cutout. `1` swaps the MediaPipe engine
# for a deterministic stub (e2e builds and the Playwright webServer only; the
# real engine must run in dev/production). Local E2E_PROD=1 builds set it too:
# NEXT_PUBLIC_CARDS_CUTOUT_STUB=1 pnpm build
NEXT_PUBLIC_CARDS_CUTOUT_STUB=
# Shared secret guarding POST /api/revalidate, which busts ISR cache tags on demand.
# Needed after direct-DB writes (e.g. `pnpm db:seed:posts`, Onda 0 migrations) since those
# bypass the deployed Payload hooks. Default tag is `posts`; allowlisted tags also include
# `global_privacy-policy` for /privacidade. MUST be set in the Vercel project env for production. Generate with e.g. `openssl rand -hex 32`.
REVALIDATE_SECRET=YOUR_REVALIDATE_SECRET_HERE
# Web Push (D2 — /campanha notifications). Generate VAPID keys with: npx web-push generate-vapid-keys
VAPID_PUBLIC_KEY=
VAPID_PRIVATE_KEY=
VAPID_SUBJECT=mailto:campanha@jorgesolla.com.br
NEXT_PUBLIC_VAPID_PUBLIC_KEY=
# Campaign password reset emails (Resend). Required in production for forgot-password.
RESEND_API_KEY=YOUR_RESEND_API_KEY_HERE
CAMPAIGN_EMAIL_FROM=campanha@jorgesolla.com.br
CAMPAIGN_EMAIL_FROM_NAME=Campanha Jorge Solla
# Note: the automated test suite ignores this file and reads .env.test instead,
# and only ever runs against a database whose name ends with "_test".
# DeepSeek API key for the AI-backed features (Sollinha chat, theme search,
# demand titles, cut/piece metadata) — the LLM talks directly to
# api.deepseek.com (cache-hit input is ~6x cheaper than via Deep Infra).
# The app containers read it at runtime: without it, every feature above
# degrades silently to its fallback (runbook: "capacidades de IA").
# Get one at https://platform.deepseek.com/api_keys
DEEPSEEK_API_KEY=YOUR_DEEPSEEK_API_KEY_HERE
# Deep Infra API key for the Sollinha voice transcription (STT, Whisper large-v3)
# — cheapest speech-to-text around ($0.00045/audio min). Get one at https://deepinfra.com
DEEPINFRA_API_KEY=YOUR_DEEPINFRA_API_KEY_HERE
# C114 — Google Calendar mirror (Agenda da Campanha): base64 of the Google Cloud
# service-account JSON key (cat key.json | base64 -w0). The service account must
# be granted "make changes to events" on the campaign's public calendar; the
# calendar ID itself is configured by an admin in the `googleCalendarSync`
# collection. Absent/malformed → the agenda shows "não configurado" and the
# mirror stays off — the Teqo agenda never depends on this.
GOOGLE_CALENDAR_SERVICE_ACCOUNT_KEY=
# C149 — Google OAuth client pair for the "Conectar com o Google" button. Create
# a "Web application" OAuth client in the same GCP project, register the
# redirect URIs (`<public site>/campanha/agenda/google-oauth/callback`, plus the
# local dev origin) and publish the app to production (unverified is fine for
# internal use) so the refresh token does not expire in ~7 days. Absent → the
# dialog falls back to the service-account runbook and the mirror keeps working
# via `GOOGLE_CALENDAR_SERVICE_ACCOUNT_KEY`.
GOOGLE_CALENDAR_OAUTH_CLIENT_ID=
GOOGLE_CALENDAR_OAUTH_CLIENT_SECRET=
# C167 — binary used to cut the exact [início,fim] MP4 of the acervo. Empty
# falls back to `ffmpeg` from PATH (the production image installs it); tests
# point it at a fake binary, and a host without ffmpeg can install it or set
# this to a wrapper.
FFMPEG_PATH=
# C163/C190 — Portal da Transparência API key used by the city/dossiê report
# scripts to fetch official emendas (`JORGE SOLLA`). Optional: without it the
# official emendas block degrades to an explicit gap (never zero silently).
# `pnpm worktree next` mirrors this key into the worktree `.env.local` when it
# is set here, so report builds run with the same source as the main checkout.
PORTAL_TRANSPARENCIA_API_KEY=
# C231 — Flickr API credentials for the photo-archive ingestion
# (`pnpm flickr:import`). FLICKR_USER_ID is the NSID of the account
# (depjorgesolla). Both live only in the env — never in the repo; the key is
# read by the CLI at run time and never stored in receipts.
FLICKR_API_KEY=
FLICKR_USER_ID=
# C232 — vision engine of the photo-archive cataloguing (`pnpm archive:catalog`).
# Any OpenAI-compatible server (Ollama, llama.cpp, vLLM) on the PRIVATE network:
# the citizens' photos must not leave it (a public host is refused unless
# ARCHIVE_VISION_ALLOW_REMOTE=1 is declared). Example: an Ollama box on the LAN
# or tailnet — ARCHIVE_VISION_BASE_URL=http://100.94.122.26:11434/v1.
# ARCHIVE_VISION_API_KEY is only for servers that require a key; never stored in
# receipts, and the endpoint is only called by `--apply`.
ARCHIVE_VISION_BASE_URL=
ARCHIVE_VISION_MODEL=
ARCHIVE_VISION_API_KEY=