AMO — Advertising Market Optimization

Plataforma web que conecta anunciantes con medios hiperlocales de Colombia para contratar, ejecutar, medir y liquidar pauta digital de forma estandarizada. Este repositorio contiene el front-end (Next.js) y el esquema de la base de datos (Supabase).

Si vas a desarrollar con un agente de IA, empieza por AGENTS.md.

Qué incluye hoy

• Acceso seguro: ingreso solo por invitación, verificación en dos pasos (TOTP) obligatoria para el equipo interno, recuperación de contraseña, cierre por inactividad y límite de intentos.
• Administración: usuarios, roles personalizados con matriz de permisos, bitácora de auditoría inmutable con visor de diferencias, registro de accesos y configuración del sistema (tarifas versionadas, comisiones, umbrales, parámetros tributarios).
• Analítica: paneles de inicio por rol, explorador geográfico en tres niveles (mundo → Colombia → municipios), siete reportes con exportación a Excel y PDF, e insights automáticos.
• Operación (consulta): medios, anunciantes, campañas, ofertas y asignaciones con su línea de tiempo.
• Base de datos completa del negocio: máquinas de estado, motor de precios configurable, reserva atómica de cupos, liquidaciones, disputas, notificaciones y procesos programados.
• Identidad visual propia: tema oscuro (principal) y claro, logo e iconos, animaciones y diseño responsive para escritorio, tablet y móvil.

Requisitos

• Node.js ≥ 22.12 y pnpm 12
• Un proyecto de Supabase (Postgres 17) y un token público de Mapbox
• Opcional: CLI de Supabase (supabase login) para regenerar tipos y aplicar migraciones

Puesta en marcha

pnpm install
cp .env.example .env.local      # completa las variables (cada una está documentada en el archivo)
pnpm dev                        # http://localhost:3000

Variables de entorno

Variable	Uso
NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY	Conexión pública a Supabase
SUPABASE_SECRET_KEY	Clave secreta (solo servidor): gestión de usuarios y procedimientos privilegiados
NEXT_PUBLIC_MAPBOX_TOKEN, NEXT_PUBLIC_MAPBOX_STYLE	Mapas (restringe el token por URL)
NEXT_PUBLIC_SITE_URL	URL pública del sitio (enlaces de invitación y recuperación)
AMO_SERVIDOR_SECRET	Secreto compartido servidor ↔ base de datos (también guardado en Supabase Vault)
AMO_CIFRADO_KEY	Clave de cifrado de datos sensibles (k1:<base64 de 32 bytes>)
SUPERADMIN_EMAIL	Correo del primer superadministrador
AMO_SMTP_CONFIGURADO	true cuando Supabase Auth tenga SMTP propio
AMO_CSP_MODO	enforce (por defecto) o report

El build falla con un mensaje claro si falta una variable obligatoria.

Entornos

Entorno	Supabase	Variables	Datos
Producción	oriuuuaczpncmtglfgpv (ca-central-1)	.env.produccion	Solo los reales (nació vacío)
Develop	depbmnlpfnrcsbqlwxxd (us-east-1)	.env.develop, .env.db.develop	Banco de pruebas antes de producción
Local	supabase start (Docker)	.env.local	15 meses de demo y cuentas de prueba (pnpm db:local)

.env.produccion (ignorado por git; Next no lo carga en local) contiene las variables que se importan en Vercel. Los scripts de arranque apuntan a otro entorno con AMO_ARCHIVO_ENTORNO, p. ej. AMO_ARCHIVO_ENTORNO=.env.produccion pnpm bootstrap:superadmin. Lo que crea datos de prueba (E2E, cuentas de pista, demo, carrera de cupos) se niega a correr contra producción.

Base de datos

Las migraciones están en supabase/migrations/ y son inmutables. Para un proyecto nuevo (así se montó producción):

This is the beginning of the README. Read the rest at the original. Read the full README ↗