Sistemas transversales

TL;DR

Los sistemas transversales son la infra compartida que sostiene a todos los módulos del producto. No tienen UI propia (salvo casos puntuales como el selector de tema o el panel de upgrade): son contratos, integraciones y reglas que aplican en cada request, render y deploy.

Mapa de páginas

• Plans y billing (Stripe) — los tres planes (esencial / pro / enterprise), gating por feature, webhook de Stripe con idempotencia y los gaps conocidos entre lo prometido y lo implementado.
• IA (Anthropic SDK) — tres acciones server que usan Claude Haiku: parser de PDFs de partidos, Risk Advisor (gated pro/enterprise) y predicción de carga multi-métrica.
• Email (Resend) — envío transaccional vía Resend API (no SMTP), invitaciones, magic-links y captura de errores en Sentry.
• Sentry — monitoreo en client + server + edge, con scrubbing de PII clínica y release tracking por commit SHA.
• CI/CD — pipelines de GitHub Actions: build, deploy a Cloudflare Workers, migraciones de Supabase y deploy de este sitio de docs.
• Sistema de temas — dark por defecto, light vía data-theme="light", CSS custom properties y branding por organización.
• Internacionalización — tres locales con next-intl, cobertura real por idioma y tooling de traducción.
• Multi-tenant — aislamiento por organization_id y RLS.
• PWA y push — service worker, instalación y push notifications staff → jugador.
• White-label — slug por org, detección pasiva de subdomain (fase 1) y roadmap.
• Dev-login (interno, draft) — bypass de login para desarrollo local, gated por NODE_ENV y DEV_LOGIN_SECRET.

Reglas universales

• Nunca hardcodear colores — siempre CSS custom properties. Ver Temas.
• Nunca hardcodear strings visibles — todo pasa por t(). Ver i18n.
• Todo dato está aislado por org — RLS + filtros explícitos por organization_id. Ver Multi-tenant.
• Toda escritura sensible va por server action o webhook, nunca desde el cliente con la service-role key.