refactor(backend): reorganize domains into Core, Commerce, Ticketing and Shared

app/Shared/Logging/documentacion/README.md

@@ -0,0 +1,25 @@
+# Dominio Logging
+
+## Propósito
+
+Registra cambios relevantes de valores en modelos de negocio, indicando tenant, atributo, valor anterior/nuevo, fecha y actor.
+
+## Componentes
+
+- `Models/ValueChange.php`: entrada persistida del historial, relacionada polimórficamente con el objeto modificado.
+- `Models/Concerns/LogsValueChanges.php`: trait reutilizable que escucha actualizaciones del modelo.
+- `Enums/ValueChangeActorType.php`: distingue cambios realizados por usuario o por el sistema.
+
+## Uso
+
+Un modelo consumidor debe:
+
+1. Usar el trait `LogsValueChanges`.
+2. Declarar la propiedad `loggedAttributes` con los atributos auditables.
+3. Implementar `valueChangeTenantCode()`.
+
+El trait solo registra atributos configurados que efectivamente cambiaron. Si existe un usuario autenticado lo asocia al cambio; en caso contrario marca al sistema como actor.
+
+## API y dependencias
+
+No expone rutas HTTP. `Purchase` lo utiliza para auditar cambios de estado y `Sale` consulta esas modificaciones para reportes.