Gestión de Cargos

1. Qué es y para qué existe

La entidad Cargo (Job Title) es el componente core que define las responsabilidades y atributos técnicos de un rol dentro de la plataforma. Su propósito es estandarizar la estructura organizacional y servir de base para la segmentación en módulos de Desempeño, Capacitación y el Motor de Cálculo.

2. Cuándo usarlo / Cuándo no

Usar cuando:
- Se requiere dar de alta un nuevo rol operativo en la organización.
- Es necesario actualizar la denominación de un cargo manteniendo la trazabilidad.
- Se busca jerarquizar la estructura mediante Familias y Niveles.
No usar cuando:
- Se desea realizar una distinción meramente geográfica (ej. "Vendedor Chile" vs "Vendedor Perú"). Para esto se deben utilizar Unidades Organizacionales.
- Se busca eliminar un registro por error; en su lugar, se debe utilizar el estado "Archivado".

3. Tipo de acción y nivel de riesgo

Tipo de acción: Global / Acción Masiva.
Nivel de riesgo: Crítico / Irreversible.
- Justificación: El Código de Cargo es la llave primaria inmutable. Un error en la definición del código requiere el archivado del registro y la pérdida de la relación directa en la línea de tiempo del ID anterior.

4. Impacto y dependencias entre módulos

La gestión de cargos tiene efectos en cascada sobre los siguientes componentes:

Entidad / Módulo	Tipo de Dependencia	Lógica de Impacto
Módulo de Posiciones	Bloqueante	No se permite archivar un cargo si existen posiciones activas vinculadas a personas. El cargo solo se libera si la posición queda vacante o es eliminada.
Familias y Niveles	Pre-existencia	El sistema no crea familias o niveles "al vuelo" durante la carga masiva. Deben existir previamente o la carga fallará.
Máster de Personas	Estructural	Si un cargo es archivado, los colaboradores asociados que no utilicen el módulo de posiciones quedarán en estado "Sin Cargo".
Nómina	Desincronizada	Importante: Los campos de descripción de cargos en el módulo de Nómina no se sincronizan con las definiciones del Core. Cambios realizados en Core deben replicarse manualmente en Nómina si se requiere paridad.

5. Estados del sistema involucrados

Activo: Estado por defecto. El cargo es elegible en todos los selectores, filtros de búsqueda y procesos operativos vigentes.
Archivado:
- Visibilidad: El cargo deja de ser elegible para nuevas asignaciones y desaparece de los filtros de módulos activos (Reclutamiento, Desempeño).
- Persistencia: El registro se mantiene en la base de datos. En reportes históricos (data retroactiva), el nombre del cargo seguirá siendo visible para asegurar la integridad de la auditoría.

6. Procedimiento (Lógica de Sistema)

Creación y Actualización

Identificador Único: El sistema utiliza el Código del Cargo como llave primaria.
Lógica de Match: Durante una carga masiva, si el código existe, el sistema actualiza el atributo Nombre. Si el código no existe, crea un nuevo registro.
Inmutabilidad: El código no puede ser editado por interfaz ni por carga masiva una vez creado.

Eliminación Lógica

Para archivar masivamente, se debe marcar la columna discarded con una x. El sistema validará que no existan dependencias activas antes de procesar el cambio de estado.

7. Automatización con IA (Rankmi AI)

El sistema cuenta con un agente de IA especializado en la generación de Descriptores de Cargo. Esta funcionalidad permite poblar automáticamente los siguientes campos lógicos:

Misión y Visión del rol.
Principales acciones y Tareas: Definición operativa del cargo.
Jerarquía y Relaciones: Autoridad, relaciones internas y externas.
Perfil de Egreso: Educación requerida, habilidades técnicas, idiomas y requerimientos específicos.
Dimensiones: Alcance del cargo y otros campos complementarios.

Nota de Producto: El uso de IA optimiza la creación de perfiles, pero la validación final del descriptor sigue siendo responsabilidad del administrador para asegurar la alineación con la cultura organizacional.

8. Alertas críticas

Sincronización de Nómina: No asuma que al actualizar un descriptor o nombre en el Core, este se verá reflejado en el módulo de Nómina. Actualmente son repositorios de datos independientes.
Validación Case-Sensitive: El sistema diferencia entre mayúsculas y minúsculas para Familias y Niveles (ej: "Sistemas" ≠ "sistemas"). Una discrepancia aquí causará el rechazo de la fila en la carga masiva.
Código de Cargo: Asegúrese de definir un estándar de codificación antes de la primera subida, ya que no podrá ser corregido posteriormente sin archivar el registro.

9. Checklist antes / después

Antes de la gestión masiva:

Validar que todas las Familias de Cargo del Excel ya existan en el sistema.
Validar que todos los Niveles de Cargo del Excel ya existan en el sistema.
Asegurar que no existan códigos duplicados con diferentes nombres en el archivo.

Después de la gestión masiva:

Descargar el catálogo de cargos y verificar que el conteo de registros coincida con el archivo cargado.
Auditar que no existan personas en el estado "Sin Cargo" producto de un archivado masivo accidental.
Si se usa Nómina, actualizar manualmente los registros espejo si corresponde.

10. Errores comunes

Error de Llave Primaria: Intentar cambiar un código de cargo en el Excel pensando que el sistema renombrará el código. Resultado: El sistema creará un cargo duplicado con el nuevo código.
Falla de Dependencia: Intentar archivar un cargo vinculado a posiciones ocupadas. El sistema rechazará la acción por seguridad de la data.

11. FAQ de producto

P: ¿Por qué el cargo sigue apareciendo en reportes si ya lo archivé? R: Por integridad histórica. Si el colaborador tuvo ese cargo en el pasado, el reporte debe mostrarlo. Sin embargo, ya no podrás asignárselo a nadie nuevo.

P: ¿Puedo usar la IA para actualizar cargos masivamente? R: La IA actúa a nivel de descriptor (ficha individual). Las acciones masivas de creación de la entidad "Cargo" deben realizarse vía Excel.

P: ¿Qué pasa si dejo el código vacío en la carga masiva? R: La fila será rechazada. El código es obligatorio para garantizar la unicidad del registro.