Ir al contenido
Aquazaku Docs

Dominio

El corazón del sistema. Acá viven las reglas del negocio, escritas en el lenguaje del negocio y no en el de la base de datos.

Antes de modelar una tabla o diseñar un endpoint, la regla se entiende y se escribe acá. Sin esto terminamos con un CRUD que no representa cómo trabaja Aquazaku realmente.

Mapa del dominio

Sección titulada «Mapa del dominio»

Seguido en el orden en que fluye el negocio: el agua entra, se convierte en producto, y el producto sale.

Área Qué define
Producción y agua Tanques en litros, envasado diario y conversión a producto
Stock de producto Producto por ubicación
Botellones y bases Los dos activos retornables y su trazabilidad
Ventas Qué es una venta, cómo se anula, cómo se cobra, crédito
Clientes Identidad, saldo, crédito y asignación a ruta
Proveedores y compras Reposición de insumos y su impacto en stock
Rutas y rendición Carga, operación en calle y cierre del día
Roles y permisos admin, seller, pos — quién puede hacer qué, y sobre qué datos

Cómo se escriben las reglas

Sección titulada «Cómo se escriben las reglas»

Toda regla tiene un identificador estable. No es burocracia: es lo que te permite escribir un test que dice // RN-VEN-02 y que dentro de un año alguien entienda por qué ese test existe.

RN-VEN-02
│  │   └── número correlativo dentro del área
│  └────── área del dominio
└───────── Regla de Negocio
Prefijo Área
RN-PRD Producción y agua
RN-VEN Ventas
RN-STK Stock de producto
RN-ENV Botellones (por cantidad)
RN-BAS Bases (por unidad identificada)
RN-CLI Clientes
RN-PRO Proveedores y compras
RN-RUT Rutas y rendición
RN-ACC Acceso, roles y permisos

Cada regla se escribe con esta estructura:

### RN-VEN-02 — Una venta confirmada no se edita


**Estado:** Supuesto


Enunciado corto y verificable de la regla.


**Por qué:** el motivo de negocio. Sin esto la regla es una opinión.

Estados de una regla

Sección titulada «Estados de una regla»
Estado Significa
✅ Confirmada Validada con Aquazaku. Se puede implementar.
🟡 Supuesto La propusimos nosotros. No implementar sin confirmar.
🔴 En conflicto Dos fuentes dicen cosas distintas. Hay que resolver antes de seguir.

Reglas de las reglas

Sección titulada «Reglas de las reglas»
  1. Una regla se enuncia de forma verificable. Si no podés escribir un test que la compruebe, todavía no es una regla — es una intención.
  2. Una regla nunca cambia de número. Si queda obsoleta se marca como derogada y se escribe una nueva.
  3. El número de regla se cita en el código y en los tests. El código explica cómo; la regla explica por qué.