El trabajo de cada rol (capítulo 6) se guarda en git, el sistema de control de versiones que usa casi todo el desarrollo de software. Este capítulo explica cómo, y por qué git y no otra cosa.
Un servidor propio, un repositorio por rol
El trabajo vive en un servidor de git propio, pensado para que muchos agentes suban cambios a la vez. Cada rol de cada negocio tiene su repositorio, y la carpeta work/ de ese rol es una copia de él. Cada persona tiene, además, un repositorio privado para lo suyo, que nunca forma parte del trabajo del rol.
El servidor guarda los datos de cada repositorio en una base Postgres y los archivos en disco. Se descartaron una base más simple (que no soporta bien muchas escrituras a la vez) y un servicio de almacenamiento de un proveedor (por depender de él para algo tan central).
Credenciales por repositorio
Las conversaciones no corren git por su cuenta: lo corre el runtime (capítulo 13), con una credencial de vida corta que solo sirve para el repositorio de ese rol. Un pequeño servicio aparte emite esas credenciales, limitadas por prefijo, de modo que ninguna pieza que corre en la máquina tenga una llave capaz de abrir todos los repositorios.
Cómo se guarda
- Antes de cada turno se trae lo último de la rama principal; después de cada turno se sube.
- Cada cambio lleva como autor el nombre de la conversación que lo hizo y, en el mensaje, la entrega que lo motivó.
- Si la business factory corre en más de un lugar (por ejemplo, en una computadora de la oficina y en la nube), cada cambio dice de qué lado se hizo, en una línea final del mensaje. Así, la historia y cualquier conflicto muestran quién escribió qué.
- Cada conversación trabaja en su propia copia de trabajo de git, para no mezclar archivos a medio escribir de otra; la alternativa de una sola copia compartida se descartó justamente por eso.
- Nunca se fuerza una subida. Si dos cambios chocan y el texto se puede combinar, se combina. Si no, el cambio propio se sube a una rama de conflicto con el nombre de la conversación y la fecha, y se le avisa a la principal del rol, que decide cuál queda.
Por qué git
Git no es la elección obvia para el trabajo de un área de ventas. Lo es por tres razones:
- historia y vuelta atrás: cada cambio queda con quién y cuándo, se puede comparar y se puede deshacer (capítulo 6);
- recuperación: si la máquina se pierde, el trabajo está entero en el servidor;
- convivencia: la misma business factory puede correr en dos lugares a la vez sobre los mismos repositorios, y git sabe combinar lo que cada lado escribió.
Lo que no se toma del desarrollo de software es su ritual: en una business factory, los roles de negocio guardan directamente en la rama principal, sin ramas por cambio ni revisiones, porque no es una software factory.
Los datos en tabla: un depósito por rol
Para los datos en forma de tabla (capítulo 6), git no sirve: los archivos de datos binarios no se combinan. La forma propuesta usa herramientas abiertas:
- cada conversación trabaja en una base local, con DuckDB y el formato DuckLake;
- una copia central, también DuckLake, con su catálogo en Postgres y los datos en un almacenamiento de objetos, un espacio por negocio, detrás del coordinador;
- el runtime sincroniza: trae, sube lo que cambió y, si hay un conflicto, lo aparta para que se decida («traer, decidir, subir»).
Cabe una nota técnica que salió de las pruebas: el catálogo de DuckLake sobre un archivo DuckDB no admite varias escrituras a la vez, y sobre una base SQLite o Postgres sí. Es el tipo de detalle que decide si un diseño funciona con una conversación o con muchas.
Recapitulando, cada rol tiene un repositorio en un servidor de git propio, el runtime guarda cada turno con el nombre de la conversación y su lado, nada se fuerza, y los datos en tabla van a un depósito aparte con herramientas abiertas. En el siguiente capítulo, se verá cómo llegan los agentes a los sistemas del negocio, por dentro.