4.1 Nivel 1 — Contexto

Actores principales:

• Usuario

  Usa KPIAds para gestionar múltiples proyectos y ver sus resultados.

• KPIAds

  Sistema que unifica datos dispersos y los transforma en métricas accionables.

• Plataformas externas

  • Shopify, WooCommerce, PrestaShop
  • Meta Ads, Google Ads

Relaciones:

1. El usuario entra en KPIAds (web) y gestiona clientes/proyectos.
2. KPIAds se conecta a tiendas y cuentas publicitarias usando APIs externas.
3. KPIAds ingesta y normaliza datos (ingresos, gasto, etc.).
4. KPIAds calcula métricas (ROAS, CAC…).
5. La agencia ve todo eso en un panel y toma decisiones.

4.2 Nivel 2 — Containers

1. Aplicación Laravel (Monolito por dominios)

• Endpoints API (REST)
• Panel web
• Dominios: Clientes, Proyectos, Ingesta, Métricas, Auth
• Lógica de negocio, validaciones, casos de uso
• Exposición de endpoints para frontend y para integraciones

2. MySQL