El envase vuelve
Un botellón de 20 L sale, y vuelve. Un POS que solo sabe vender lo cuenta como perdido: el inventario deja de cuadrar al primer día.
Aquazaku
El sistema de gestión de una planta de agua en Campo de la Cruz, Atlántico. Esta documentación se escribe mientras se construye — si algo no está acá, no existe.
114reglas de negocio
1.057tests
8decisiones registradas
49páginas
Qué hace distinto a este sistema
Sección titulada «Qué hace distinto a este sistema»Aquazaku produce y vende agua. No es un revendedor: tiene planta de empaque. Y eso mete tres cosas que un punto de venta común no tiene.
La base tiene dueño
Cada base prestada está en una dirección concreta y hay que poder reclamarla ahí. No es stock: es un préstamo con nombre.
El agua se pierde en el camino
Entra agua cruda y sale menos: los filtros rechazan cerca del 30 %, y lavar botellones gasta más. Cuadrar litros contra producto envasado atraviesa las dos pérdidas.
Y el suministro municipal no es continuo. Los 13.000 litros de almacenamiento son lo que sostiene el servicio cuando la red no da agua — así que saber cuántos días de producción quedan es el indicador crítico de la planta.
Por dónde entrar
Sección titulada «Por dónde entrar»El negocio, antes que el código
Pacas, botellones, rutas, el ciclo de recarga y las 107 reglas que gobiernan el sistema. Es el mejor lugar para empezar.
Por qué está hecho así
Ocho decisiones registradas con contexto, alternativas y consecuencias — desde el patrón BFF hasta por qué los invariantes viven en la base.
La API y sus contratos
Endpoints, autenticación, permisos por rol y la auditoría que registra toda acción sensible.
El sistema de diseño
La marca, los tokens, y cómo está construido el vidrio y el agua que usa el producto.
Cómo se usa esta documentación
Sección titulada «Cómo se usa esta documentación»Se escribe a medida que se construye, no después. Cada decisión técnica queda registrada como un ADR en Decisiones técnicas, con lo que se consideró y lo que se descartó.
Las reglas de negocio tienen identificador propio —RN-STK-08, RN-ACC-02— y
el código las cita por ese nombre. Cuando una regla cambia, se puede encontrar
todo lo que la implementa.
Y lo que todavía no se sabe también está escrito: las preguntas abiertas viven en Qué falta preguntar, numeradas, con por qué importa cada una. Una pregunta sin responder es una decisión que alguien va a tomar sin darse cuenta.