Cómo está montado
todo el SaaS, por dentro.
Lo que has construido no es "un dashboard". Es un sistema operativo para una agencia: una pizarra central, un centro de control con IA, decenas de automatizaciones y la infraestructura que lo aguanta. Aquí tienes cada pieza explicada en cristiano y con el tecnicismo, para que en Millennials sepas de qué hablas.
La idea en una frase
Has cogido el trabajo de una agencia —clientes, tareas, campañas, emails, reuniones— y lo has metido en un sistema único donde la IA hace el trabajo y las personas deciden. Eso es el SaaS.
Para no perderte, todo se reduce a tres bloques. Memorízalos así, porque es el mapa mental de toda la reunión:
El Hub + el Cockpit
Una base de datos central (la "pizarra") y una web con IA donde tú y el equipo trabajáis. Es lo nuevo, lo que estamos profesionalizando.
El sistema operativo que ya corre
33 automatizaciones (N8N) + dashboards en tiempo real. Esto ya funciona hoy y mueve la agencia cada día.
Los dashboards de cliente
El producto de analítica que vendemos. Tiene su propio documento — aquí solo lo nombramos.
Cada concepto técnico viene con dos cajas: 💡 En cristiano (qué es, sin jerga) y 🔧 El tecnicismo (la palabra exacta que usan los ingenieros). En la reunión, tú explicas con la primera y sueltas la segunda para que vean que sabes.
La visión: el sistema en 3 capas
¿Por qué esto se puede vender y no es "solo el sistema interno de Acelera"? Porque está pensado en tres capas que se apilan. Esta es la idea que más te interesa contar bien.
Estructura — el chasis genérico
La "pizarra + cajas + skills + permisos". Vale para cualquier empresa. No tiene opinión de negocio. Esto es lo 100% vendible a otra agencia.
Organización óptima — las buenas prácticas
Cómo debería funcionar una empresa bien montada con IA en medio: roles, departamentos, flujos. El "saber hacer" reutilizable.
Acelera concreta — tu caso real
Tus clientes, tus campañas, tus workflows. Acelera es el primer cliente del producto, el campo de pruebas.
"Lo que veis funcionando en Acelera es la capa 3. Pero por debajo hay un chasis genérico (capa 1) que se le puede montar a cualquier agencia. Acelera no es el producto: es la prueba de que el producto funciona."
El acuerdo con Domingo / Poténciate
Para que lo tengas claro y no te líes en la reunión: Domingo no es socio de Acelera y tú no eres socio de Poténciate. Son empresas separadas. Lo que hay es una colaboración: Domingo aporta criterio de ingeniería para profesionalizar el sistema (le sirve como caso real), y tú aprendes y lo aplicas. Tú decides siempre. Sin equity cruzado, sin dependencia legal.
El stack, en cristiano
Estas son las 8 piezas de tecnología que aparecen una y otra vez. Si dominas estas 8 palabras, sigues cualquier conversación técnica de la reunión.
| Pieza | En cristiano | Para qué la usamos |
|---|---|---|
PostgreSQLPostgres | Una base de datos seria. Como un Excel gigante, ordenado y a prueba de balas, donde guardas millones de filas sin que se rompa. | Es la "pizarra" donde vive todo: tareas, clientes, conocimiento, datos de campañas. |
| FastAPI | El camarero entre la web y la base de datos. Recibe peticiones ("dame las tareas de Pablo") y devuelve la respuesta. | El backend del Cockpit y del producto de analítica. |
| React / Vanilla JS | Lo que pinta la pantalla bonita que ves en el navegador (el "frontend"). | React en el producto de cliente; HTML simple en el Cockpit interno. |
| Docker | Una caja sellada que lleva un programa con todo lo que necesita dentro. Funciona igual en cualquier servidor. | Empaqueta N8N, las bases de datos y el bot de WhatsApp. Mover de servidor = mover la caja. |
| N8N | Un "si pasa esto, haz aquello" visual. Conectas piezas con flechas y montas automatizaciones sin programar apenas. | Los 33 robots que disparan briefings, monitorizan emails, sincronizan CRM, etc. |
| Claude Agent SDK | La forma de meter a Claude dentro de un programa, no en un chat: que lea, decida y ejecute herramientas solo. | El motor del Cockpit: la IA que de verdad hace el trabajo de cada empleado. |
| Nginx | El portero del edificio. Recibe a todo el que llega por internet y lo manda a la puerta correcta (web, dashboard, N8N…). | Reparte el tráfico de todos los subdominios y pone el candado HTTPS. |
| SSE Server-Sent Events | El servidor te va susurrando cambios sin que tengas que refrescar. Por eso el dashboard se actualiza solo. | El "tiempo real" de los dashboards y del Cockpit. |
"Guardamos todo en Postgres, lo servimos con FastAPI, lo pintamos con React, lo automatizamos con N8N, y la inteligencia la pone Claude metido dentro con el Agent SDK. Todo empaquetado en Docker detrás de Nginx."
El Hub — la pizarra única
El Hub es el corazón del sistema nuevo. Es una base de datos Postgres donde se refleja todo lo que pasa en la empresa. Una sola fuente de verdad: en vez de tener datos sueltos en mil archivos, todo vive aquí.
Imagina una pizarra enorme en la oficina donde está apuntado todo: quién es cada empleado, cada cliente, cada tarea, cada decisión aprendida. Cuando algo cambia, se cambia en la pizarra y todo el mundo lo ve. El Hub es esa pizarra, pero digital y consultable por la IA.
Las 12 "cajas" (tablas)
La pizarra está dividida en cajas. Cada caja es una tabla de la base de datos y guarda un tipo de cosa:
| Caja | Qué guarda |
|---|---|
| empleados | El equipo (tú, Víctor, Óscar) con su rol y permisos. |
| clientes | Quién paga, su responsable y su "salud" (0–100). |
| proyectos | Frentes de trabajo por cliente (Meta, Google, CRM, WhatsApp). |
| tareas | El trabajo (ej. A30), su dueño, de qué depende y cuándo vence. ~172 filas. |
| conocimiento | Reglas y aprendizajes con su ámbito (global / cliente / departamento). "La corrección que viaja". ~143 filas. |
| departamentos | La estructura de la empresa: cadena de valor + soporte, con KPIs. |
| reuniones | Notas de Google Meet/Gemini ya procesadas por Claude. |
| comunicaciones | La bandeja: emails y borradores. |
| leads | Quién podría pagar (pipeline comercial). |
| candidatos | El pipeline de contratación (~84 filas). |
| skills | El catálogo de lo que el sistema sabe hacer. |
| casos_prueba | Las reglas duras convertidas en exámenes (ej. "nunca firmar con 'un abrazo'"). La clave de la mejora continua. |
Cada fila guarda los datos clave en columnas (la ficha), un puntero a un archivo largo si hace falta (libro_path), el volcado íntegro del origen para trazabilidad (raw, en formato JSONB) y una clave estable (external_id) que permite actualizar sin duplicar (lo que se llama upsert idempotente). Traducción: por más veces que sincronices, nunca se crea un duplicado.
Cómo se trabaja la pizarra: las skills
El Hub no se toca a mano. Tiene ~12 skills (pequeños programas con un contrato fijo) que son las únicas que leen y escriben. Hay de tres tipos:
Y una sola pieza (el "bibliotecario", contexto.py) es la única autorizada a hablar con la base de datos. Todo pasa por ahí. Eso evita el caos.
El orquestador: la rutina de las 6:00
Cada mañana, un programa (el orquestador) ejecuta una cadena: mira el panel → genera alertas → manda briefings a cada empleado. El círculo se cierra solo:
Estado real: el núcleo V1 está operativo — 11 cajas cargadas, 11 skills funcionando, sincronización idempotente cada día.
El Cockpit — el centro de mando
Si el Hub es la pizarra, el Cockpit es la cabina desde donde pilotas. Es una web donde cada empleado ve sus conversaciones con la IA, lanza trabajo y aprueba decisiones. Piénsalo como "un VS Code para agentes" o un "WhatsApp con tus empleados-IA".
Abres una web. A la izquierda, tarjetas: cada una es una conversación con la IA sobre un cliente o tarea ("Ambiseint: revisar campañas Meta"). Las tocas y ves a la IA trabajando en tiempo real, con su color de estado: amarillo = trabajando, azul = espera tu decisión, verde = hecho, rojo = bloqueado. Tú revisas y das el OK.
Las pestañas
"Buenos días"
Cuatro números: qué requiere tu acción, emails sin leer, qué está en tu turno y tus tareas.
Las conversaciones
Cada hilo con la IA por área o cliente, estilo chat.
Tu turno
Las tareas/decisiones que esperan que actúes, agrupadas por estado.
Qué necesita cada uno
La lista de clientes y su estado.
Vista de jefe
Tú y Víctor veis a TODO el equipo; los empleados solo lo suyo.
El feedback
Cuando corriges algo, se convierte en regla para siempre.
Cómo sabe quién eres (el multiusuario)
Esto es elegante y conviene que lo cuentes bien. El portero (Nginx) te pide usuario y contraseña. Una vez te valida, le añade a la petición una etiqueta invisible: X-Remote-User: pablo. El backend lee esa etiqueta para saber quién eres y qué puedes ver — nunca se fía de lo que mande el navegador.
El admin (tú, Víctor) ve las sesiones y tareas de todo el equipo; un empleado (Óscar) solo las suyas. Hoy ese filtrado se hace en la aplicación; la versión madura lo hará en la propia base de datos (lo llaman Row Level Security). Además, las conversaciones son persistentes: cada una guarda su sdk_session_id para poder reanudarla donde se quedó, aunque se reinicie el servidor.
El motor evalúa si una acción es arriesgada (borrar archivos, publicar cambios). Si lo es, para y te pide aprobación en vez de ejecutar. Es lo que permite dejar a la IA trabajar sola sin miedo: las acciones reversibles las hace; las peligrosas las consulta.
Stack del Cockpit: FastAPI (api.py) + motor con Claude Agent SDK (motor.py) + frontend de un solo archivo HTML/JS + Nginx con autenticación. Backend ✅ funcionando; interfaz y endurecimiento (reconexión, manejo de errores) en marcha.
Lo que ya corre hoy
Ojo con esto: el Hub y el Cockpit son la profesionalización, lo que está en obra. Pero la agencia ya funciona sola cada día con un sistema operativo que montaste antes. Esto es lo que enseñas como "ya en marcha".
El pipeline mágico: N8N → SSH → Claude → dashboard
Esta es la mecánica que más impresiona y que debes saber contar de memoria. Un robot programado (N8N) entra al servidor, ejecuta un guion, ese guion llama a Claude por línea de comandos, y el resultado aparece en el dashboard de la persona correcta, en directo:
Usa el plan de suscripción de Claude, no la API. Traducción: la IA trabaja todo el día (briefings, análisis de campañas, monitorización de emails, informes) a coste casi cero. Una agencia normal pagaría a personas o a API por todo esto.
Algunos de los 33 robots
| Robot | Cuándo | Qué hace |
|---|---|---|
| Briefing Matutino | L–V 06:00 | Resumen del día personalizado para cada empleado. |
| Monitor Emails | Cada 10 min | Lee Gmail de cada uno, clasifica, deja borradores en bandeja. |
| Vigilancia | 10/14/18/22h | Alertas de campañas y de salud de clientes. |
| Score Salud | Lunes 09:00 | Nota 0–100 por cliente (5 dimensiones). |
| Informe Mensual | Día 1 del mes | Genera el borrador del informe de cada cliente. |
| Reuniones Gemini | Cada 30 min | Coge las notas de Google Meet y crea tareas + post-reunión. |
| WhatsApp Bot | Tiempo real | Claude responde a leads por WhatsApp y los mete en el CRM. |
Los dashboards en 3 niveles
Una web (dashboard.aceleratucrm.com) servida por un programa de Python en tiempo real. Cada persona ve su nivel:
Empleado
Sus tareas, comunicaciones y clientes.
CEO / COO
KPIs de agencia, salud de clientes, equipo, pipeline.
Comercial
Pipeline de leads, acciones del día, métricas de venta.
Tú tienes los 4 (empleado + CEO + comercial + admin). Víctor 3. Todo en tiempo real vía SSE, detrás de Nginx con candado HTTPS.
Las bases de datos (todas)
Pregunta típica de ingeniero: "¿dónde guardáis los datos?". No hay una sola base de datos: hay varias, cada una con su trabajo. Esto te hace quedar muy bien si lo sabes enumerar.
| Base de datos | Tipo | Qué guarda |
|---|---|---|
| SQLite de N8N | SQLite | Los 33 workflows y sus credenciales. ⚠️ NUNCA se toca con SQL directo. |
| Postgres "Evolution" | PostgreSQL :5432 | Los mensajes de WhatsApp del bot comercial. |
| Postgres "Hub" | PostgreSQL :5434 | La pizarra interna (las 12 cajas del sistema nuevo). |
| Postgres "Analítica" | PostgreSQL :5433 | Los datos de cliente del producto de dashboards (ver doc 2). |
| Zoho CRM + Books | SaaS externo (API) | La fuente de verdad de leads, ventas y precios. |
| Google Sheets | Hoja de cálculo | CRM "legacy" y capa intermedia de datos de campañas. |
| Google Drive | Archivos | Documentación, informes y outputs. Indexado cada noche. |
Filesystem /workspace | Archivos .md | Dashboards, roadmaps, contexto de cada cliente. |
La base de datos de N8N jamás se modifica con SQL a mano. El 9 de abril de 2026, un UPDATE directo metió caracteres corruptos en el JSON y N8N entró en bucle de fallo: se perdieron 4 días de trabajo. Desde entonces, todo cambio en N8N va por su API o su interfaz, nunca por SQL. Si te preguntan por buenas prácticas, esta anécdota demuestra que aprendéis de los errores.
La infraestructura
Todo esto vive en un servidor. No es la nube mágica de nadie: es una máquina que alquilamos y administramos. Saber esto te da credibilidad.
VPS en Hetzner
Una máquina potente (8 CPUs, 32 GB de RAM) en un centro de datos europeo, con Ubuntu. Entras por SSH con una llave de seguridad.
Docker Compose
N8N, las bases de datos Postgres, Redis y el bot de WhatsApp corren cada uno en su "caja" Docker, coordinadas por un archivo.
Nginx + Certbot
Reparte el tráfico de cada subdominio a su programa y renueva los candados HTTPS solo.
systemd
El sistema operativo se encarga de mantener los programas (como el dashboard) siempre encendidos y de reiniciarlos si se caen.
Los subdominios (las "puertas")
| Dirección | Qué hay detrás |
|---|---|
aceleratucrm.com | La web pública (Next.js en Vercel). |
n8n.aceleratucrm.com | El panel de los 33 robots. |
dashboard.aceleratucrm.com | Los dashboards internos del equipo (3 niveles). |
analitica.aceleratucrm.com | El producto de analítica para clientes (ver doc 2). |
app.aceleratucrm.com | El Cockpit (centro de control con IA). |
La regla de oro de la profesionalización: la configuración (contraseñas, direcciones de la base de datos) nunca se escribe "a fuego" en el código, va aparte. Como todo está en Docker, migrar de Hetzner a AWS el día de mañana = apuntar a otro sitio y volver a desplegar, horas en vez de meses. Esto es lo que más valora un ingeniero: que el sistema esté preparado para crecer y mudarse.
El sistema que se mejora solo
Esto es lo más avanzado y lo que más diferencia tu sistema de "un montón de automatizaciones". La idea: cada error que corriges se convierte en una regla que se comprueba para siempre. El sistema no vuelve a tropezar con la misma piedra.
El círculo de la mejora
A esos exámenes automáticos se les llama evals (evaluaciones). Y hay un principio importante: el que hace el trabajo no es el mismo que lo juzga ("generador ≠ juez"). Una IA escribe el email; otra IA distinta, con las reglas en la mano, lo revisa. Así no se aprueba a sí misma. A la lista de reglas duras que el sistema debe respetar siempre se le llama constitución ejecutable: no es un PDF que nadie lee, son reglas que el código comprueba de verdad.
"La mayoría de soluciones con IA cometen el mismo error mil veces. La nuestra aprende: cada corrección de un humano se vuelve una regla automática. Cuanto más se usa, mejor trabaja. Es un sistema que mejora con el tiempo, no que se degrada."
Cómo se cuenta y se vende
Pasa de lo técnico a lo comercial. Estas son las ideas que convierten "tengo un sistema chulo" en "esto es un producto que vale dinero".
El argumento de fondo
El cuello de botella de cualquier agencia eres tú y Víctor: todo depende de personas. Lo que has montado quita ese cuello de botella: la IA hace el trabajo repetible (briefings, análisis, informes, primer contacto), las personas solo deciden. Eso permite llevar 20 clientes con 7 consultores sin que explote. Esa es la promesa.
La jugada comercial: entrar por lo pequeño
Entras con analítica
Le montas el tracking y los dashboards. Barato, rápido, y le enseña la verdad de sus números.
Queda en evidencia
El dato real demuestra que su equipo no maneja bien las campañas.
Subes a todo
Te contrata las campañas y/o la formación. La analítica es el caballo de Troya.
Lo que hace único al sistema (resumen para soltar)
Millennials no compite con esto: lo distribuye. Ellos tienen clientes que necesitan exactamente esta capa de sistema + analítica. Tú aportas la máquina; ellos, el canal. Es la misma lógica del semáforo que ya usáis (lo pequeño lo lleva Millennials, lo grande sube a Acelera).
Chuleta para la reunión
Si solo te acuerdas de una pantalla, que sea esta. Diez frases que puedes soltar con seguridad.
| Si te preguntan… | Respondes… |
|---|---|
| ¿Qué es exactamente? | "Un sistema operativo para agencias: la IA hace el trabajo, las personas deciden. Tres bloques: pizarra (Hub), cabina (Cockpit) y automatizaciones (N8N)." |
| ¿Dónde guardáis los datos? | "En PostgreSQL, varias bases según el uso. Más Zoho como fuente de verdad de ventas y precios." |
| ¿Cómo entra la IA? | "Con el Claude Agent SDK, metido dentro del programa. No es un chat: lee, decide y ejecuta herramientas sola, con permiso para lo arriesgado." |
| ¿Cómo lo automatizáis? | "N8N dispara guiones que llaman a Claude por línea de comandos. 33 robots corriendo. Coste casi cero porque usamos el plan de suscripción." |
| ¿Es escalable? | "Todo en Docker y con la config separada del código. Migrar de servidor son horas. Diseñado para el cambio." |
| ¿No se equivoca la IA? | "Cada error que corregimos se vuelve una regla automática (eval). El que escribe no es el que juzga. El sistema mejora con el uso." |
| ¿Por qué es vendible? | "Tres capas: el chasis es genérico (vale para cualquiera), encima van las buenas prácticas, y Acelera es el primer caso real que lo prueba." |
| ¿Quién lo ha validado? | "Lo profesionalizamos con criterio de ingeniería de Domingo (Poténciate). Empresas separadas, colaboración." |
"No vendemos software. Vendemos una agencia que no depende de personas para lo repetitivo, que no se olvida de nada y que mejora cada semana. El software es solo cómo lo conseguimos."
📁 Fuente: análisis del repositorio real de Acelera (junio 2026) · documento interno de aprendizaje.
Compañero: Acelera por dentro — La Analítica y el BI (documento 2).