🤖 DIRECTRIZ DE ARQUITECTURA (IA)
Este documento es una norma de diseño (Source of Truth). Su propósito es instruir a los desarrolladores y a los Agentes de Inteligencia Artificial sobre cómo programar, estructurar y auto-auditar las bases de datos e interfaces del ecosistema. No es un manual operativo para el usuario final.
Tabla: sys_roles
Definición estructural de los niveles de acceso del ecosistema.
👤 1. Traducción para Humanos
Esta tabla es el «jefe de seguridad» del sistema. Define qué tipo de jerarquías existen en la empresa (SuperAdmin, Gerente, Instructor, Alumno, Piloto). Su único trabajo es existir para que podamos agrupar a las personas en niveles de poder.
🔗 2. Relaciones y Convergencias
- Con
sys_usuarios: Es su relación principal. Cada rol puede tener muchos usuarios asignados, pero un usuario solo tiene un rol. - Con Permisos (Políticas de Seguridad): Esta tabla es la que define si alguien puede ver un botón en la pantalla o no.
⚙️ 3. Automatizaciones (Back-End)
- RLS Automático: El sistema lee esta tabla automáticamente cada vez que alguien inicia sesión, aplicando filtros (Row Level Security) invisibles.
🖥️ 4. Vistas e Interfaces (UX/UI)
- Pantallas y Filtros: Es casi invisible para el usuario normal. Solo los SuperAdmins ven esta tabla en la pestaña «Configuración > Roles del Sistema» para crear nuevas jerarquías si la empresa crece.
💻 5. Estructura Técnica (Para la IA)
| Columna | Tipo de Dato | Descripción / Restricción |
|---|---|---|
id |
SERIAL | Primary Key. |
nombre |
VARCHAR | Unique. (Ej: ‘Gerente’). |
descripcion |
TEXT | Explicación de qué áreas puede ver este rol. |
