# Arquitectura recomendada para Truevi

## Decisión ejecutiva

No conviene ejecutar capturadores dentro del mismo servidor que publica esta página.
Usar cuatro zonas:

1. **Sitio público**: contenido estático detrás de CDN/WAF.
2. **Portal autenticado**: aplicación separada para operadores.
3. **API y orquestador**: identidad, permisos, casos, políticas y estados.
4. **Workers de captura**: infraestructura efímera y aislada que procesa trabajos de una cola.

La separación limita el impacto de una captura hostil, reduce el acceso a evidencia y
permite escalar cada parte de forma independiente.

## Lenguajes recomendados

### Sitio público

La entrega actual usa HTML semántico, CSS y JavaScript sin dependencias. Es la opción con
menor superficie para una landing. Si el equipo necesita un CMS o muchas páginas, migrar
a **Astro + TypeScript** y generar HTML estático.

### Portal de operadores

**TypeScript + React/Next.js** es una combinación práctica por ecosistema, tipado y
disponibilidad de desarrolladores. El portal solo consume la API; no debe contener claves
de servicios ni lógica probatoria.

### API y orquestador

**Go** es la recomendación principal: binarios simples, buen rendimiento concurrente,
tipado estático y operación predecible. Usar librerías estándar, análisis estático,
versiones fijadas y generación de SBOM.

### Capturadores

- **Rust** para componentes que manipulan artefactos no confiables, verificadores,
  empaquetado y hashing: su seguridad de memoria reduce una clase importante de fallos.
- **TypeScript/Node.js + Playwright** para automatización de navegadores, dentro de
  contenedores o microVM efímeras. Es la opción con mejor soporte práctico para captura web.
- **Go** para el agente que recibe el trabajo, controla límites y sube resultados.

No hay un lenguaje “seguro” por sí solo. El aislamiento, la validación, los permisos
mínimos, las actualizaciones y la auditoría pesan tanto como el lenguaje.

## Flujo de alto nivel

```text
Usuario
  │
  ▼
Portal (app.truevi.tld) ──OIDC/MFA──► Proveedor de identidad
  │
  ▼
API Gateway (api.truevi.tld)
  │ validación + autorización + idempotencia
  ▼
Orquestador ─────► PostgreSQL (casos, políticas, estados)
  │
  ├──────────────► Cola de trabajos
  │                    │
  │                    ▼
  │              Worker efímero por intento
  │                    │
  │                    ├──► Red de salida controlada
  │                    └──► Object Storage WORM
  │
  └──────────────► Ledger de auditoría append-only
```

## Servidor recomendado

### Piloto serio

- Sitio público: CDN estática (Cloudflare Pages, CloudFront/S3 o equivalente).
- Portal/API: 2 instancias o contenedores administrados, cada uno con 2 vCPU y 4 GB RAM.
- PostgreSQL administrado: 2 vCPU, 4–8 GB RAM, cifrado, backups y recuperación a un punto.
- Redis/cola administrada o NATS/SQS según proveedor.
- Object storage compatible con S3, versionado y Object Lock.
- Workers: pool de 2–4 vCPU y 4–8 GB RAM **por captura concurrente**, con autoscaling a cero.

No comprar un único VPS grande para todo. Un navegador controlado puede consumir memoria,
procesar contenido hostil o quedar bloqueado; debe poder descartarse sin afectar la API.

### Producción

- Dos zonas de disponibilidad para API, base y cola.
- WAF, protección DDoS, rate limiting y TLS 1.2/1.3.
- KMS/HSM administrado para claves; separar claves de cifrado y firma.
- Backups inmutables y prueba periódica de restauración.
- Métricas, trazas, logs centralizados y alertas.
- Registro de imágenes, firma de artefactos de build, escaneo de dependencias y SBOM.
- Entornos separados: desarrollo, staging y producción sin compartir credenciales ni evidencia.

La capacidad final depende de concurrencia, duración media, fuentes, peso de artefactos,
retención y región. Medir un piloto antes de reservar infraestructura.

## Dominio

No hace falta cambiar el dominio solo para incorporar preservadores, siempre que la marca
y la titularidad estén consolidadas. Separar por subdominios:

```text
www.truevi.tld       sitio público
app.truevi.tld       portal autenticado
api.truevi.tld       API pública
verify.truevi.tld    verificación de reportes/paquetes
status.truevi.tld    estado del servicio
```

Los workers no necesitan un subdominio público. Deben operar en una red privada y tomar
trabajos desde la cola.

Antes de publicar, verificar:

- titular registral, renovación automática y MFA en registrador;
- DNSSEC si el TLD/proveedor lo soporta;
- CAA limitado a la autoridad certificadora elegida;
- SPF, DKIM y DMARC para correo;
- bloqueo de transferencia y contactos de recuperación separados;
- certificados independientes o automatizados sin wildcard innecesario.

Cambiar de dominio solo si el actual es difícil de pronunciar, tiene conflictos de marca,
historial de reputación negativo o no está bajo control exclusivo de la empresa. Para una
decisión definitiva hace falta conocer el dominio actual.

## Controles de aplicación

- OIDC Authorization Code + PKCE, MFA y sesiones cortas.
- RBAC/ABAC por organización, caso y acción; denegar por defecto.
- Idempotency keys para creación de trabajos.
- Validación estricta de URL y mitigación SSRF antes y durante la captura.
- Objetos firmados con hash y manifiesto canonicalizado.
- Timestamps en UTC y, si corresponde, TSA externa RFC 3161.
- Logs append-only con correlación entre usuario, caso, trabajo, intento y artefacto.
- Descargas con autorización puntual y URLs prefirmadas de vida corta.
- Borrado sujeto a retención legal; nunca “editar” evidencia ya sellada.
- Revisión humana para conectores que requieran acceso a cuentas.

## Cabeceras para el sitio público

Configurar en el CDN:

```http
Content-Security-Policy: default-src 'self'; script-src 'self'; style-src 'self'; img-src 'self' data:; connect-src 'self' https://api.truevi.tld; font-src 'self'; object-src 'none'; base-uri 'self'; frame-ancestors 'none'; form-action 'self'; upgrade-insecure-requests
Strict-Transport-Security: max-age=63072000; includeSubDomains; preload
X-Content-Type-Options: nosniff
Referrer-Policy: strict-origin-when-cross-origin
Permissions-Policy: camera=(), microphone=(), geolocation=(), payment=(), usb=()
Cross-Origin-Opener-Policy: same-origin
```

HSTS con `includeSubDomains` y `preload` solo después de confirmar que **todos** los
subdominios funcionan exclusivamente por HTTPS.

## Aspectos legales y operativos pendientes

- Política de privacidad y base legal para datos personales.
- Términos de uso y política de uso aceptable.
- Acuerdos de tratamiento y subprocesadores.
- Matriz de retención por tipo de cliente/caso.
- Procedimiento de incidentes y notificación.
- Criterios documentados de alcance de cada conector.
- Revisión profesional de mensajes comerciales: evitar afirmar “validez legal garantizada”,
  “certificado ISO” o equivalentes sin respaldo.
