Fuente única de los roles del ecosistema: qué es un rol, cómo funciona en el sistema (arquitectura de 3 capas) y cuáles existen (listado maestro). Lo consultan Gerencia, RRHH y Administración al redactar contratos, descripciones de cargo y organigramas; Admin al asignar roles; y los agentes de IA y el equipo de desarrollo al construir el sistema de permisos. (Ver RT-34.)
⭐ Fuente única · Nivel N5 Rev. 3.5 · BORRADOR · Septiembre 2026
- Qué es un rol en el ecosistema
- Arquitectura de 3 capas en el sistema
- Capa 1 — Identidad y Estatus
- Capa 2 — Listado Maestro de Roles · la escalera de mando
- Capa 3 — Privilegios
- Cómo interactúan las capas
- Automatización de roles
- Matriz de seguridad del Núcleo 1
- Decisiones pendientes de la Dirección
- Gobernanza, responsables y aplicabilidad
- Información relacionada
1. Qué es un rol en el ecosistema 🎯
Decimos ecosistema y no «sistema» a propósito. El ecosistema es el ERP, pero también es la organización —departamentos, cargos, línea de mando— y la relación laboral o comercial de cada persona con la casa —contratos, descripciones de cargo, evaluaciones—. Un rol vive en los tres lugares a la vez.
Se nombra una sola vez, aquí, y ese mismo nombre se usa en el sistema, en el contrato y en el organigrama.
Cada rol tiene tres caras. Son el mismo rol visto desde tres lugares distintos:
| Ejemplo: «Coordinador de Sede» | Cómo aparece |
|---|---|
| 💻 Sistema | Código coordinador, acceso N3, ve las operaciones de su sede |
| 🏢 Organización | Sede asignada, reporta al gerente de sede, conduce a vendedores e instructores de esa sede |
| 📄 Contrato y RRHH | Su contrato dice «Coordinador de Sede», su descripción de cargo es la de ese rol y se evalúa contra ella |
2. Arquitectura de 3 capas en el sistema 🧱
Dentro del ERP, para garantizar seguridad, trazabilidad histórica y escalabilidad, la información se separa en tres capas independientes:
| Capa | Pregunta que responde | Contenido |
|---|---|---|
| 1 · Identidad y Estatus | ¿Quién es y cómo está? | Datos personales, tipo de persona, estatus operativo |
| 2 · Roles | ¿Qué hace? | Roles funcionales y de mando — el Listado Maestro |
| 3 · Privilegios | ¿Qué puede tocar? | Llaves de acción (CRUD) y privilegios especiales |
3. Capa 1 — Identidad y Estatus 🪪
| Campo | Descripción |
|---|---|
| Identidad única | Un único registro base por persona (cédula/RIF como llave única, nombre, email). Evita duplicados si un alumno es, a su vez, empleado. |
| Tipo de persona | Natural o jurídica (empresa, proveedor, institución). |
3.1 Estatus operativo
| Estatus | Descripción | Acceso |
|---|---|---|
| Activo | Relación vigente | Total según roles asignados |
| Inactivo | Relación finalizada | Bloqueado; nombre y firma se preservan en registros históricos |
| Suspendido (automatización financiera) | Restricción automática por mora (cuotas vencidas) o sanción disciplinaria | Pierde al instante el portal académico, la asistencia y la carga de exámenes. Solo conserva Pagos y Soporte. |
| Prospecto | Registro inicial captado por Ventas | Sin expediente formal activo |
4. Capa 2 — Listado Maestro de Roles 🗂️
Una identidad puede tener uno o varios roles a la vez. Hasta ahora cada rol se nombraba de tres maneras según el artículo; esta tabla las reconcilia:
| Vista | Ejemplo | Para qué sirve |
|---|---|---|
| Nombre humano | «Coordinador de Sede» | Cómo lo llama la gente — y cómo aparece en contratos, descripciones de cargo y organigramas |
| Código de sistema | coordinador |
Cómo lo entiende el ERP (Matriz de Capacidades) |
| Acceso N1–N6 | N3 | Qué documentación ve (Niveles de Instructivos) |
Leyenda: ✓ = conciliado · ⚠️ = candidato propuesto, pendiente de validación. Los códigos usan snake_case.
| Rol | Qué hace | Código | Acceso | Estado |
|---|---|---|---|---|
| 4.1 · Familia Cliente | ||||
| Estudiante CIA | Alumno de aviación con matrícula vigente | alumno |
N1 | ✓ |
| Estudiante CC | Alumno de cursos cortos o complementarios | alumno |
N1 | ✓ |
| Exalumno | Historial preservado, sin matrícula activa | alumno (inactivo) |
N1 | ⚠️ |
| Cliente de Aerotienda | Comprador en la Aerotienda | cliente |
N1 | ✓ |
| Cliente IDEA Bar & Bistró | Comprador en el Bar/Bistró | cliente |
N1 | ✓ |
| Cliente Empresarial de CIA | Persona jurídica (empresa, aerolínea) | cliente |
N1 | ⚠️ |
| Proveedor | Persona o empresa que suministra a la casa; ve su perfil, no lo edita | proveedor ⚠️ |
N1 | ⚠️ |
| 4.2 · Familia Académica / Técnica | ||||
| Instructor de Tierra | LMS y cursos teóricos | instructor |
N2 | ✓ |
| Instructor de Vuelo | TMS, bitácoras y simulador | instructor |
N2 | ✓ |
| Jefe de Instrucción | Supervisa al equipo de instrucción | director_academico ⚠️ |
N3 ⚠️ | ⚠️ |
| Asistente de Jefe de Instrucción | Apoyo al Jefe de Instrucción | — por definir | N3 ⚠️ | ⚠️ |
| Mecánico OMA | Mantenimiento de aeronaves | tecnico_oma |
N2 ⚠️ | ⚠️ |
| 4.3 · Familia Operativa | ||||
| Vendedor | Equipo comercial | comercial |
N2 | ✓ |
| Publicista Foráneo | Acceso externo limitado | comercial ⚠️ |
N2 ⚠️ | ⚠️ |
| Coordinador de Sede | Supervisión local | coordinador |
N3 | ✓ |
| Coordinador de Aerotienda | Gestión operativa de la tienda | coordinador ⚠️ |
N3 ⚠️ | ⚠️ |
| Planificación | Asignación de recursos | coordinador ⚠️ |
N3 ⚠️ | ⚠️ |
| Contratado por Honorarios | Personal externo por proyecto | — por definir | por definir | ⚠️ |
| Agente del CCO | Monitoreo y supervisión operacional | — (no existe código cco) |
N4 | ⚠️ |
| 4.3.1 · Departamento de Diseño (Estructura del Departamento) — nuevo, Sep. 2026 | ||||
| Diseñador/a | Integrante de una coordinación del Departamento de Diseño | disenador ⚠️ (nuevo) |
N3 ⚠️ | ⚠️ |
| Coordinador/a de Cursos Regulares | Diseña, activa y vigila los cursos regulares | disenador + mando ⚠️ |
N3 ⚠️ | ⚠️ |
| Coordinador/a de Cursos Especiales | Diseña los cursos especiales y procesa sus pedidos | disenador + mando ⚠️ |
N3 ⚠️ | ⚠️ |
| Coordinador/a de Servicios Complementarios | Diseña la náutica, el bistró, los cafetines y los servicios que no son cursos | disenador + mando ⚠️ |
N3 ⚠️ | ⚠️ |
| Coordinador/a de Publicidad | Piezas, campañas y protocolos de publicidad de todos los productos | disenador + mando ⚠️ |
N3 ⚠️ | ⚠️ |
| Coordinador/a de Diseño Académico | Pénsum, material, estándar y mejora continua de todos los cursos | disenador + mando ⚠️ |
N3 ⚠️ | ⚠️ |
| Jefe/a del Departamento de Diseño | Conduce las cinco coordinaciones | disenador + gerente ⚠️ |
N5 | ⚠️ |
| 4.4 · Familia Administrativa | ||||
| Admin Nivel 1 | Operación diaria: facturación, egresos, registros | administrativo |
N3 ⚠️ | ⚠️ |
| Admin Nivel 2 | Supervisión, auditoría, anulaciones, gestión de roles | administrativo ⚠️ |
N4 ⚠️ | ⚠️ |
| Contador | Contabilidad y estados financieros | contador |
N4 ⚠️ | ⚠️ |
| RRHH | Gestión del personal, contratos y descripciones de cargo | rrhh |
N4 ⚠️ | ⚠️ |
| Director Académico | Conducción académica del CIA/CC | director_academico |
N5 ⚠️ | ⚠️ |
| Director OMA | Conducción del taller de mantenimiento | director_oma |
N5 ⚠️ | ⚠️ |
| 4.5 · Familia Línea de Mando — se suma al rol funcional (ver la escalera) | ||||
| M1 · Líder de grupo | Coordina a un grupo pequeño en su tarea diaria | lider_grupo ⚠️ |
N2 ⚠️ | ⚠️ |
| M2 · Supervisor | Vigila la ejecución y el cumplimiento del procedimiento | supervisor ⚠️ |
N3 ⚠️ | ⚠️ |
| M3 · Subgerente | Subordinado al gerente; lo reemplaza en sus acciones cuando no está | subgerente ⚠️ |
N4 ⚠️ | ⚠️ |
| M4 · Gerente | Responde por los resultados de su departamento o sede | gerente ⚠️ (nuevo) |
N5 | ⚠️ |
| M5 · Dirección Operativa — COO | Conduce la operación de todas las gerencias; responde al CEO | coo ⚠️ |
N6 | ⚠️ |
| M5 · Dirección Operativa — CFO | Conduce las finanzas de la casa; responde al CEO | cfo ⚠️ |
N6 | ⚠️ |
| M6 · CEO | Máxima autoridad ejecutiva. Conduce a la Dirección Operativa y responde a los Directivos | ceo ⚠️ |
N6 | ⚠️ |
| — · Directivo (bloque de gobierno) | Corre en paralelo a la escalera: recibe el reporte y elige al CEO | directivo ⚠️ |
N6 | ⚠️ |
| 4.6 · Familia Sistema / Transversal | ||||
| Superadministrador | Control técnico total del sistema (TIC) | superadmin |
N6 ⚠️ | ⚠️ |
| Soporte | Atención a usuarios y resolución de incidencias | soporte |
por definir | ⚠️ |
| Auditor | Revisión en solo lectura | auditor |
por definir | ⚠️ |
4.5 en dibujo · La escalera de mando 🪜
TIVOS
👔
La conducción superior la ejercen tres personas: el CEO desde M6 y el COO y el CFO desde M5.
comercial + gerente; un jefe de instructores puede tener instructor + supervisor. Y en el contrato se lee igual: «Vendedor — Gerente de Ventas, sede Caracas». Qué significa cada nivel y cómo debe ser quien lo ocupa se explica en el ⭐ Instructivo Maestro de Gerencia; aquí vive su registro como rol.
5. Capa 3 — Privilegios 🔑
Los privilegios son llaves específicas que se activan o desactivan dentro de cada rol.
| Ver | Consultar información |
| Crear | Registrar información nueva |
| Editar | Modificar información existente |
| Anular/Borrar | Eliminar o anular registros |
| Firma digital | Validar bitácoras o certificados |
| Capacidad de descuento | Modificar precios en POS con límites |
| Conciliación | Verificar ingresos bancarios |
| Vista multidivisión | Saltar entre empresas (CIA / OMA) sin cambiar de usuario |
| Edición de capas | Modificar interfaces mediante Antigravity |
6. Cómo interactúan las capas 🔽
Las tres capas operan como un embudo de permisos cada vez que alguien ingresa:
- Capa 1 — quién es y su estatus. El sistema verifica que exista y esté Activo. Si está suspendido, pierde todos sus roles salvo Pagos y Soporte.
- Capa 2 — qué sombreros tiene puestos. Ve solo las herramientas de sus roles. Si es Instructor y a la vez Alumno, ve ambos portales bajo su misma identidad.
- Capa 3 — qué puede hacer hoy. Dentro de sus roles se filtran sus privilegios: un Vendedor ve pedidos, pero solo quien tiene la llave de Conciliación aprueba un pago bancario.
Cómo se configura. Todo se gestiona desde una interfaz administrativa visual: el administrador entra al perfil y enciende o apaga roles y privilegios marcando casillas, sin tocar código.
7. Automatización de roles ⚙️
Los roles no se asignan solo a mano: el sistema activa roles automáticamente según lo que hace el usuario.
| Acción del usuario | Rol que se activa | Metadata adicional |
|---|---|---|
| Compra cualquier producto o servicio | cliente (automático) |
Historial de pedidos vinculado |
| Esa compra es un curso o grupo | alumno (automático) |
Servicio activado + grupo |
| Es asignado a un grupo de clases | Hereda la metadata del grupo | Sede, horario, instructor |
| Es contratado como personal | Rol funcional + nivel de mando (manual + auto) | Departamento, cargo, tipo de contrato — los mismos del contrato firmado |
| Se le asigna ruta de vuelo | alumno de línea de vuelo |
Expediente INAC, instructor de vuelo |
El detalle de estos flujos está en Automatización de Roles y Flujos del Sistema.
8. Matriz de seguridad del Núcleo 1 🛡️
Quién ve y quién edita perfiles, con los nombres del Listado Maestro (extraída de la Arquitectura Global de Datos, sección 4):
| Rol | ¿VE perfiles? | ¿EDITA perfiles? |
|---|---|---|
| Directivo | Todos | Todos |
| Admin Nivel 1 / Nivel 2 | Todos | Sí, con restricciones |
| Instructor (Tierra y Vuelo) | Solo el propio | Solo el propio |
| Mecánico OMA | Solo el propio | Solo el propio |
| Vendedor | Solo el propio | Solo el propio |
| Estudiante (CIA y CC) | Solo el propio | Solo el propio |
| Proveedor | Solo el propio | Ninguno |
9. Decisiones pendientes de la Dirección ⚖️
- Códigos de la Línea de Mando (§4.5): confirmar
lider_grupo,supervisor,subgerente,gerente,coo,cfo,ceoydirectivo, y el acceso N de cada uno. ¿superadmines una persona real o solo un rol técnico de TIC? - Cómo se deciden los asuntos de los tres (CEO, COO y CFO): ¿por consenso, por mayoría, o con voto de calidad del CEO cuando no hay acuerdo?
- Admin Nivel 1 y Nivel 2: ¿ambos son
administrativo, o el Nivel 2 escoordinador? ¿Qué acceso N tiene cada uno? - Agente del CCO (N4): no existe código
cco. ¿Cuál le corresponde? - Roles sin código (Asistente de Jefe de Instrucción, Contratado por Honorarios) y roles con código dudoso (Jefe de Instrucción, Publicista Foráneo, Planificación, Coordinador de Aerotienda, Proveedor): asignar su
snake_case. - Instructor: ¿un solo código
instructordiferenciado por privilegios, o dos códigos (Tierra / Vuelo)? - Las otras dos caras del rol (§1): ¿se agregan a esta tabla columnas de departamento, tipo de contrato y enlace a la descripción de cargo? Hoy solo existe la ficha de Requisitos para ser Gerente; el resto de los roles aún no tiene descripción de cargo escrita.
- Departamento de Diseño (§4.3.1): confirmar el código nuevo
disenador, qué nivel de mando M lleva cada «Coordinador/a de ___» (¿M1 líder de grupo o M2 supervisor?) y si el Jefe/a del Departamento esgerente(M4).
Cuando se resuelvan, las ⚠️ pasan a ✓ y el documento sube de revisión.
10. Gobernanza, responsables y aplicabilidad 🏛️
- Contratos, descripciones de cargo y organigramas usan los nombres de aquí. Un cargo que no está en el listado no se contrata hasta crearlo aquí.
- La Matriz de Capacidades define qué puede tocar cada código; los códigos oficiales son los de aquí.
- Los Niveles de Instructivos definen qué documentación ve cada nivel N; el nivel de cada rol se lee de aquí.
- El Instructivo Maestro de Gerencia explica qué es y cómo debe ser cada nivel de mando; su registro como rol vive aquí.
| Responsable | Función |
|---|---|
| Directivo / CEO | Aprueba roles nuevos y privilegios especiales |
| RRHH | Redacta contratos y descripciones de cargo con los nombres del listado, y pide la creación de un rol nuevo antes de contratar un cargo que no existe |
| Admin Nivel 2 | Asigna y revoca roles en el sistema, en coherencia con el contrato vigente de la persona |
| TIC | Mantiene la implementación técnica (RLS, capabilities, automatizaciones) |
Aplicabilidad: todo el Ecosistema IDEA — CIA, CC, Aerotienda, Bistró, Base Náutica, OMA y divisiones administrativas — en el sistema, en la organización y en la contratación. Es referencia obligatoria para cualquier contrato, descripción de cargo, organigrama, módulo, interfaz o automatización que nombre, asigne o valide roles.
11. Información relacionada 🔗
- ⭐ Instructivo Maestro de Gestión de Usuarios — documento padre del módulo (Núcleo 1).
- ⭐ Instructivo Maestro de Gerencia — la cara organizacional: qué es cada nivel de mando y cómo debe ser quien lo ocupa.
- 🎨 Estructura del Departamento de Diseño — las coordinaciones de la §4.3.1 y quién las cubre hoy.
- 🗝️ Directivos · Bloque de Gobierno · 👔 CEO · COO · CFO · 🧭 COO — los cargos de mayor nivel.
- 📋 Requisitos para ser Gerente — ejemplo de la cara contractual: la descripción de cargo de un rol.
- Perfil humano del empleado — contra qué se evalúa a la persona que ocupa un rol.
- Matriz de Capacidades y Privilegios — qué puede tocar cada código.
- Normas de Roles y Accesos del Sistema — reglas de asignación y revocación.
- Automatización de Roles y Flujos — flujos que activan roles.
- Niveles de Instructivos — Acceso por Perfil — qué documentación ve cada nivel N1–N6.
- Arquitectura Global de Datos — fuente arquitectónica del Núcleo 1.
Módulo de Gestión de Usuarios · Cap. 25 — Roles, Permisos y Automatización | Roles del Ecosistema IDEA | Rev. 3.5 (Borrador) — Septiembre 2026
Rev. 3.5: se agrega la §4.3.1 · Departamento de Diseño con el rol base Diseñador/a (código nuevo disenador), los cinco «Coordinador/a de ___» y el Jefe/a del Departamento, todos como candidatos ⚠️; nueva decisión pendiente n.º 8. Rev. 3.4: el CEO queda solo en M6; la Dirección Operativa (M5) la forman el COO y el CFO. Rev. 3.3: Dirección Operativa como equipo de tres con el CEO dentro (superada). Rev. 3.2: «Alta Gerencia» sustituida; M6 · CEO. Rev. 3.1: escalera incrustada en §4.5. Rev. 3: §1 «Qué es un rol en el ecosistema». Rev. 2: fusión con «Descripción de Roles de Usuario». Rev. 1: creación del listado canónico (Julio 2026).