Capacidades del Sistema
Capacidades del Sistema EZY Portal
Sección titulada «Capacidades del Sistema EZY Portal»Esta página resume las capacidades compartidas de EZY Portal que aplican a varios módulos. Mantiene la documentación pública enfocada en comportamiento funcional y evita detalles internos de implementación.
Modelo de Permisos
Sección titulada «Modelo de Permisos»EZY Portal usa un modelo de permisos consistente entre módulos.
- Cada área de capacidad declara permisos de lectura, escritura o administración.
- Las acciones de listado y consulta requieren lectura; crear o modificar requiere escritura; acciones sensibles como cancelar, eliminar o configurar requieren administración.
- Algunas capacidades dependen de permisos principales, para evitar conceder funciones derivadas sin el acceso base.
- Los usuarios internos y las cuentas externas pueden tener visibilidad diferente según el contexto de la cuenta.
- El acceso por región o alcance filtra lecturas y bloquea o advierte operaciones fuera del alcance configurado.
Concurrencia Optimista
Sección titulada «Concurrencia Optimista»Los documentos editables usan control de versión para evitar sobrescrituras silenciosas.
- Cada registro mantiene una versión que cambia después de cada modificación.
- Las actualizaciones deben enviarse con la versión que el usuario abrió originalmente.
- Si otro usuario cambió el registro primero, la operación se rechaza y el usuario debe recargar antes de intentar otra vez.
Consistencia Entre Módulos
Sección titulada «Consistencia Entre Módulos»Los módulos sincronizan cambios mediante eventos para mantener búsquedas, auditoría, caches y procesos relacionados actualizados.
- Los cambios de dominio se publican de forma resiliente para que las dependencias temporales no pierdan información.
- Los consumidores procesan eventos de forma idempotente, evitando duplicados cuando hay reintentos.
- Esta arquitectura permite que los cambios aparezcan en módulos relacionados poco después de ser confirmados.
Escrituras Idempotentes
Sección titulada «Escrituras Idempotentes»Las operaciones de creación y flujo de trabajo pueden usar claves de idempotencia para que los reintentos sean seguros.
- Una solicitud repetida con la misma clave devuelve el resultado original.
- Esto evita duplicados por doble clic, errores de red o reintentos automáticos.
Auditoría
Sección titulada «Auditoría»Los módulos registran eventos de auditoría para las acciones relevantes.
- La auditoría identifica actor, tenant, entidad, cambio y fecha.
- Los eventos siguen el mismo patrón resiliente que otros eventos del sistema.
- Esto permite reportes consistentes de actividad entre módulos.
Integridad de Referencias
Sección titulada «Integridad de Referencias»Cuando un documento referencia datos maestros, EZY Portal protege la integridad de esas relaciones.
- Las referencias se registran al crear o actualizar documentos.
- Las referencias se liberan cuando los documentos se cancelan o eliminan.
- La eliminación de datos maestros en uso se bloquea con un mensaje claro.
Ciclo de Archivo, Papelera y Restauración
Sección titulada «Ciclo de Archivo, Papelera y Restauración»Las entidades operativas usan un ciclo de vida controlado.
- El archivo oculta registros de las vistas operativas sin destruir historial.
- La papelera mantiene registros recuperables según las reglas configuradas.
- Las restauraciones validan permisos, alcance y referencias antes de reactivar datos.
Búsqueda y Frescura
Sección titulada «Búsqueda y Frescura»La búsqueda se actualiza de forma asíncrona.
- Los cambios pueden tardar unos segundos en reflejarse en resultados globales.
- Las páginas de detalle siguen mostrando el estado transaccional más reciente.
- Los filtros por permiso y alcance se aplican antes de mostrar resultados al usuario.