Version: 3.3 | Fecha: septiembre de 2026
Nucleo: 1 – Usuarios y Perfiles
Categoria WordPress: Modulo de Gestion de Usuarios

🧭 1. Como encontrar todo sobre Usuarios

La gestion de usuarios no vive en una sola etiqueta. El contenido esta distribuido en un ecosistema de etiquetas especializadas, cada una agrupando un aspecto diferente:

Mapa de Etiquetas

Estructura de la documentacion

Arquitectura Global de Datos (los 8 Nucleos)
    |
    +-- ESTE DOCUMENTO (Instructivo Maestro de Usuarios)
            |
            +-- Modulo de Gestion de Usuarios (frontend)
            +-- Nucleo 1 en Supabase (tablas SQL)
            +-- Roles del Ecosistema IDEA (arquitectura + listado maestro)
            +-- Categoria 25: Roles, Permisos y Automatizacion
            +-- Etiqueta: Soporte al usuario (tickets, atencion)
            +-- Etiqueta: Expediente (expedientes por tipo)
            +-- Etiqueta: Instructor (rol de instructor)

Capitulos del Modulo

📚 2. Generalidades — ¿Que es el Sistema de Usuarios?

Concepto de Usuario

Se define como la identidad digital unica de toda persona (natural o juridica) que interactua con el Ecosistema IDEA. Este registro trasciende el cargo o la relacion comercial, permitiendo que un individuo sea reconocido de forma consistente en el sistema, ya sea como aspirante (CIA/CC), empleado, instructor, proveedor, empresa o cliente de retail.

La identidad es el nucleo sobre el cual se activan o desactivan los roles y privilegios operativos.

Experiencia de usuario

Los principios UX obligatorios del sistema son: guias interactivas y tutoriales de onboarding, tips contextuales en cada pantalla, navegacion adaptativa (el usuario solo ve los modulos que le corresponden), busqueda inteligente global, notificaciones no invasivas, diseño responsivo mobile-first, acceso rapido a lo mas usado y retroalimentacion visual inmediata. Cada pantalla del sistema debe validarse contra estos principios antes de publicarse; se desarrollaran en detalle en instructivos especificos de UX.

Secciones del Sistema

El Modulo de Gestion de Usuarios es, por si solo, un sistema completo. Se divide en Secciones: cada seccion es un sub-modulo que agrupa las funciones, pantallas y datos que un usuario ve segun su relacion con IDEA. Una misma cuenta puede tener acceso a multiples secciones simultaneamente.

Inteligencia Artificial integrada (Vertex AI)

• Nivel 1 — IA para el Usuario: guia de tramites paso a paso, consulta de informacion de su cuenta en vivo (Supabase), recordatorios proactivos de vencimientos, solicitud de cursos con disponibilidad real y gestion de pagos.
• Nivel 2 — IA para el Personal: procesamiento automatico de tramites, coordinacion de instructores por WhatsApp, congelamiento/descongelamiento con trazabilidad, generacion de reportes en lenguaje natural y preparacion de documentacion para auditorias INAC.
• Arquitectura tecnica: Vertex AI (Gemini) + Function Calling (Supabase Edge Functions) + canales WhatsApp/SMS/Email + Supabase como fuente de verdad, respetando siempre RLS y capabilities (la IA no ve ni hace mas de lo autorizado).

Los instructivos detallados sobre configuracion de agentes IA, prompts, funciones disponibles y limites operativos se desarrollaran en una categoria dedicada. Ver tambien: Modulo de Agentes Inteligentes (IA).

Caracteristicas de diseño

🔑 3. Identidad, Roles y Accesos (resumen)

Para garantizar la seguridad, la trazabilidad historica y la escalabilidad, el sistema separa la informacion en tres capas independientes y maleables:

Las capas operan como un embudo de permisos: primero se valida la identidad y el estatus, luego se activan las herramientas de los roles asignados y finalmente se filtra por privilegios especificos. Los roles se asignan tambien de forma automatica segun las acciones del usuario (comprar → Cliente, matricularse → Alumno, etc.).

💽 4. Conexion con la Arquitectura de Base de Datos (Nucleo 1)

Este instructivo es la fuente de la verdad humana del Nucleo 1. La implementacion tecnica vive en Supabase:

4.1 Diagrama de relaciones

                    +---------------------+
                    |   public.profiles   |  <-- Tabla Maestra (Nucleo 1)
                    |  (Cedula/RIF = PK)  |
                    +---------+-----------+
                              |
          +-------------------+-------------------+
          |                   |                   |
  +-------v--------+ +-------v--------+ +-------v--------+
  |  metadata_     | |  expedientes_  | |  historial_    |
  |  instructores  | |  inac          | |  academico     |
  |  (tallas,      | |  (docs INAC,   | |  (notas,       |
  |   licencias)   | |   certificados)| |   vuelos,      |
  +----------------+ +----------------+ |   materias)    |
                                        +----------------+

4.2 Regla «Celula Madre»

La tabla public.profiles es la Celula Madre del ERP. Ninguna tabla en ningun otro Nucleo puede referenciar a una persona sin que esa persona exista primero en profiles. Si cambias un dato aqui, se refleja automaticamente en OMA, CIA, Administracion y todas las divisiones.

🔄 5. Transicion Airtable a Supabase

5.1 Sistema heredado (Derogado)

Nota sobre Migracion Financiera: La transicion del historial de pagos (WooCommerce y tabla 1500) es el proceso mas critico. Se realizara mediante un ETL meticuloso, primero en un entorno de pruebas cerrado («sandbox») antes de pasarlo al ecosistema real. El detalle completo estara en el Capitulo 09: Migracion y ETL.

5.2 Flujo de integridad de datos en Supabase

1. Identidad: Registro o reconocimiento del individuo (Cedula/RIF como llave unica)
2. Expansion: El sistema activa las tablas relacionadas segun el rol (Academia, OMA, Ventas)
3. Documentacion: Los soportes se integran en el Modulo de Archivologia vinculado al ID de Supabase
4. Activacion de Servicios: El flujo Pedido → Reporte → Confirmacion activa los permisos en todas las tablas derivadas de forma instantanea

🔗 6. Instructivos relacionados

6.1 Core del sistema

6.2 Expedientes y fichas

6.3 Soporte al usuario

6.4 Academico (vinculados al usuario)

6.5 Comunicaciones, IA y Fidelidad

🚀 7. Proximos Pasos

• Completar el Capitulo 04: Instructivos de automatizacion de roles (flujos compra a alumno)
• Completar el Capitulo 05: Detalle del sistema de multi-compromiso financiero
• Completar el Capitulo 09: Plan de migracion ETL (Airtable + WooCommerce a Supabase)
• Disenar el SQL schema del Nucleo 1 en Supabase (public.profiles y satelites)
• Clasificar los articulos de expedientes y academicos en sus capitulos (06 y 07)
• Disenar la interfaz del Modulo de Gestion de Usuarios en el frontend
• Desarrollar «Normas de Roles y Accesos del Sistema» (reglas de asignacion/revocacion, actualmente en construccion)
• Verificar los enlaces de etiquetas del Mapa de Etiquetas (§1): la etiqueta «Gestion de usuarios» no respondia y se reemplazo por la categoria 25.

Version 3.3 – El enlace de la etiqueta «Gestion de usuarios» (roto) se reemplazo por la categoria «25. Roles, Permisos y Automatizacion»; corregido el enlace de la categoria del modulo (slug mal escrito). Version 3.2 – La «Descripcion de Roles de Usuario» se fusiono en Roles del Ecosistema IDEA; se elimino el bloque <style> visible. Version 3.1 – Conversion a formato resumen.