Organizaciones: tu cartera de clientes

Vista solo para el rol plataforma: cada organización es un cliente que contrata Argumentum, con sus websites, sus usuarios y sus cuotas. Un cliente solo ve lo suyo; tú ves todo el tablero.

Qué ves

• Cartera: organizaciones con su estado (activa/suspendida), websites en uso contra su máximo, y eventos del mes contra su cuota (barra con aviso al 80 % y rojo al 100 %).
• Cuotas por cliente (0 = sin límite): webs máximas, eventos/mes, peticiones de ingesta por minuto (por app), eventos por lote y KB por petición. Vacío = valores por defecto del producto.
• Alta de cliente: nombre + cuotas + usuario admin inicial. La contraseña provisional se muestra una sola vez: cópiala en el alta.

Cómo usarlo

1. Alta: «Nueva organización» → nombre, cuotas y credenciales del admin. El cliente entra en el mismo panel (/panel/) con su usuario y solo ve sus apps.
2. Webs: desde el detalle del cliente crea sus apps (respeta su cuota de webs) o deja que su admin las cree desde «Apps e integración».
3. Suspender: corta la ingesta y el bundle del snippet al instante y deja su panel en solo lectura (para impago, bajas, incidentes). Reactivar lo devuelve todo a la normalidad; los datos nunca se tocan.
4. Cuotas al vuelo: subir o bajar un límite no requiere reiniciar nada; la cuota mensual se reevalúa en cada lote.

Cómo funciona por dentro

• El aislamiento es por app: los datos ya viven particionados por appKey en ClickHouse, la organización vive en la configuración. Borrar un cliente entero es borrar sus apps (y sus eventos con DELETE WHERE appKey IN (...)).
• La cuota mensual se mide con un contador por organización refrescado desde el store cada minuto; la de rate es el limitador clásico por ventana.
• Códigos de rechazo para el integrador de tu cliente: 429 cuota_excedida (estructural), 429 sin código (rate, momentáneo), 413 payload_excedido, 403 org_suspendida.

Consejos

• Da cuotas holgadas al principio y ajústalas con el uso real: la barra del widget «Uso» que ve tu cliente en Ajustes evita sorpresas y tickets.
• El ADMIN_TOKEN equivale a plataforma: úsalo para automatizar altas por API (POST /v1/panel/orgs), no para el día a día.
• Si un cliente pega fuerte, antes de suspender prueba a bajarle reqPorMinuto o activarle el muestreo de eventos en su app.