Arquitectura

Un núcleo, una celda por sector

La plataforma está pensada para que abrir un sector sea rellenar un archivo, no empezar un proyecto. Esta página cuenta lo justo para entenderlo sin abrir el repositorio, que es privado.

El núcleo

Es lo que comparten todos los sectores y lo único que se construye una vez:

• Registro de módulos. Cada sector se declara en un archivo con su estado (idea, en prueba, en marcha, en pausa, apagado). El núcleo lo valida y lo sincroniza; solo «en prueba» y «en marcha» se programan.
• Motor de datos. Lanza las fuentes de cada sector con tope de resultados y de gasto, y normaliza lo que vuelve.
• Base de datos. PostgreSQL con el histórico: lo que vimos cada semana, los clientes, las entregas y los eventos de coste e ingreso.
• Cola de trabajos. Programaciones y reintentos, con una vuelta por tarea para no pagar dos veces la misma recogida.
• Cola de aprobación. Todo entregable o mensaje externo espera a que una persona lo apruebe, lo edite o lo descarte.
• Cumplimiento. Lista de exclusión común, base legal registrada por contacto, bajas y borrado.
• Métricas. Coste e ingreso por sector en la misma tabla, que es lo que decide si un sector sigue encendido.
• Panel interno. Donde se aprueba, se ejecuta y se ve la salud de todo. Solo por red privada.

Niveles de IA

La regla es usar el nivel más simple que funcione. Casi todo el trabajo de un sector es un flujo fijo —datos, cálculo, redacción, aprobación—, no un agente que explora.

1. 1

   Nivel 1: Código, sin IA

   Cálculos, comparaciones y filtros. Determinista, barato y comprobable con pruebas.

   Bajadas de precio, días publicados, mediana de €/m².

   Es la mayor parte del trabajo
2. 2

   Nivel 2: Una llamada a Claude

   Redactar, clasificar, resumir o puntuar, con la Messages API y nada más.

   El comentario «qué hacer esta semana» del informe.

   Donde hace falta lenguaje
3. 3

   Nivel 3: Flujo con herramientas

   Varios pasos donde el modelo elige entre herramientas nuestras, con enganches para aprobación, registro y coste.

   Preparar una muestra: consultar la base, lanzar una fuente, generar el PDF.

4. 4

   Nivel 4: Agente autónomo

   Investigación abierta, leer y escribir archivos, ejecutar código. Fuera de lo que paga un cliente.

   Estudiar un sector nuevo o prototipar un módulo.

Por qué así: es más barato y más previsible para algo que paga un cliente, es más fácil de probar y de auditar —cada llamada queda registrada con su coste—, y cabe entero en nuestro servidor.

Qué pasa en una semana

1. El domingo por la noche la cola despierta a los agentes del sector.
2. Se recogen las fuentes con su tope de gasto y se guarda lo que se ve.
3. Se compara con la semana anterior: qué es nuevo, qué ha cambiado, qué sigue igual.
4. Se redacta el entregable y queda en espera de aprobación.
5. Una persona lo lee y lo aprueba. Solo entonces se entrega.
6. El coste de la vuelta y el ingreso del sector quedan apuntados.

Decisiones que condicionan todo lo demás

• Todo en TypeScript y en servidor propio. Un solo lenguaje para el núcleo, los sectores y el panel.
• Un sector es configuración. Si un sector necesita código a medida, suele ser señal de que el núcleo tiene un hueco, no de que el sector sea especial.
• Nada sale sin aprobación. Es una decisión de diseño, y por eso está en la cola y no en la buena voluntad de nadie.

¿Quieres el detalle o montar algo parecido en tu sector?Escríbenos.