Dashboard AdminView and Constraints

[lmdelbahia]

📘 TechNote – Vista del Dashboard para el Rol Administrador

👤 Rol: Admin

El rol Administrador tiene acceso amplio al sistema a través del panel de control (dashboard), con permisos diferenciados por sección. Este documento detalla las funcionalidades disponibles, las acciones permitidas y los comportamientos esperados del sistema ante operaciones sensibles.

---

📂 Secciones del Dashboard y Permisos

1. Usuarios

• Puede crear, editar y eliminar usuarios.
• Tipos de usuarios gestionables: admin, creador, manager.

2. Creadores

• Puede crear, editar y eliminar creadores.

3. Clientes

• Puede crear, editar y eliminar clientes.

4. Publicaciones

• Puede crear, editar y eliminar publicaciones.

5. Bitácora

• Solo puede visualizar los registros.
• No tiene permisos para modificar ni eliminar entradas.

6. Configuración

• Puede modificar configuraciones existentes.
• No tiene permisos para crear ni eliminar configuraciones.

7. Sectores de Negocio

• Puede crear, editar y eliminar sectores.

---

🔁 Comportamientos Especiales

Eliminación de Sector de Negocio

• Al eliminar un sector, todas las publicaciones asociadas deben actualizar su campo business_sector_id a -1.
• Este valor indica que las publicaciones quedan asociadas al sector virtual "Otros".

Eliminación de Creador

• Al eliminar un creador, todas las publicaciones asociadas deben actualizar su campo creator_id a -1.

---

📝 Registro de Acciones en Bitácora

Las siguientes acciones deben ser registradas automáticamente en la bitácora del sistema:

1. Eliminación de un usuario

   • Se registra el nombre del administrador que ejecutó la acción y los datos del usuario eliminado.

2. Eliminación de un cliente

   • Se registra el nombre del administrador y los datos del cliente eliminado.

3. Eliminación de una publicación

   • Se registra el nombre del administrador y los datos de la publicación eliminada.

4. Modificación del campo publication_avai de un cliente

   • Se registra el nombre del administrador, el cliente afectado, el valor anterior y el nuevo valor asignado.

---

🛡️ Manejo de FK con Valor -1

Todas las consultas que involucren claves foráneas (FK) con valor -1 deben estar controladas explícitamente para evitar excepciones no manejadas.

• El valor -1 indica una relación “no definida” o “desconocida” que debe tratarse como una entidad virtual o nula.
• El sistema debe validar si el valor del FK es -1 antes de intentar acceder al objeto relacionado.
• Las vistas, endpoints y procesos de serialización deben implementar estas validaciones para garantizar la estabilidad del sistema.