Tipos de Items de Onboarding

El sistema ofrece 4 tipos de items para configurar el checklist de onboarding.

Resumen de Tipos

1. Solicitud de Documentos (document_request)

Descripcion

Crea una solicitud de documentos automaticamente cuando se inicializa el onboarding.

El candidato:

• Ve lista de documentos requeridos
• Sube cada documento
• Espera aprobacion si configurado
• Item se completa cuando todos estan listos

Configuracion

Dos modos disponibles:

Modo A: Desde Plantilla

• Seleccionar plantilla de documentos existente
• Se crea DocumentRequest con items de la plantilla
• Reutiliza configuracion ya definida

Modo B: Documentos Personalizados

• Definir documentos inline
• Especificar: nombre, descripcion, obligatorio
• Se crea DocumentRequest con items custom

Ejemplo de Configuracion

Item: "Documentos de Identidad" Tipo: document_request

Opcion A - Plantilla:

• Usar plantilla: "Docs de Contratacion"
• (Ya tiene INE, CURP, RFC configurados)

Opcion B - Personalizado:

• Documento 1: INE/IFE (obligatorio)
• Documento 2: CURP (obligatorio)
• Documento 3: RFC (opcional)
• Documento 4: NSS (opcional)

Comportamiento

Al inicializar onboarding:

1. Sistema crea DocumentRequest
2. DocumentRequest tiene DocumentRequestItems
3. Candidato ve en "Mis Solicitudes"
4. Candidato sube documentos

Al completar documentos:

1. DocumentRequest cambia a "completed"
2. Sistema detecta el cambio
3. OnboardingChecklistItem se marca "completed"
4. Progreso del onboarding se actualiza

Sincronizacion

2. Solicitud de Firma (signature_request)

Descripcion

Crea una solicitud de firma electronica para contratos y acuerdos.

El candidato:

• Ve el documento a firmar
• Dibuja/captura su firma
• Firma se registra con timestamp
• Item se completa cuando firma

Configuracion

Requiere:

• Documento plantilla (PDF) en S3
• Titulo descriptivo
• Instrucciones (opcional)
• Obligatorio o no

El documento puede ser:

• Contrato de trabajo
• Acuerdo de confidencialidad (NDA)
• Politicas de la empresa
• Consentimiento de datos
• Cualquier documento legal

Ejemplo de Configuracion

Item: "Contrato de Trabajo" Tipo: signature_request

• Documento: contratos/contrato_trabajo_2024.pdf
• Descripcion: "Revisa el contrato y firmalo digitalmente"
• Obligatorio: Si
• Expiracion: 30 dias (automatico)

Comportamiento

Al inicializar onboarding:

1. Sistema crea SignatureRequest
   • postulantId: ID del candidato
   • documentTemplateKey: S3 key del PDF
   • expiresAt: fecha + 30 dias
   • verificationToken: UUID unico
2. SignatureRequest tiene status: "pending_postulant"

Al firmar:

1. Candidato ve documento en modal
2. Dibuja firma en canvas
3. Sistema registra:
   • Firma (imagen base64)
   • IP del firmante
   • User agent (navegador)
   • Timestamp
4. Status cambia a "completed"
5. Checklist item se completa automaticamente

Sincronizacion

3. Tarea Manual (manual)

Descripcion

Tareas que el candidato marca como completadas manualmente. No tienen verificacion automatica.

Ideal para:

• Lecturas y capacitaciones
• Configuraciones que no se pueden verificar
• Tareas fisicas (recoger credencial, etc.)
• Confirmaciones de entendimiento
• Checklists de preparacion

Configuracion

Campos:

• Titulo: Nombre de la tarea
• Descripcion: Explicacion detallada
• Instrucciones: Pasos a seguir (opcional)
• Obligatorio: Si/No

Ejemplo de Configuracion

Item: "Leer Manual del Empleado" Tipo: manual

• Descripcion: "Descarga y lee el manual completo"
• Instrucciones:

  1. Descarga el manual desde: https://empresa.com/manual
  2. Lee las secciones 1-5 (obligatorias)
  3. Familiarizate con politicas de la empresa
  4. Marca como completado cuando termines

• Obligatorio: No

Comportamiento

En la vista del candidato:

El candidato ve la tarea con estado "Pendiente", la descripcion, y un boton [Marcar como Completado].

Al hacer click:

1. Estado cambia a "completed"
2. Se registra completedAt y completedById
3. Progreso del onboarding se actualiza

Usos Comunes

Lecturas:

• Manual del empleado
• Codigo de conducta
• Politicas de seguridad
• Reglamento interno

Configuraciones:

• Configurar email corporativo
• Instalar software requerido
• Configurar VPN
• Activar autenticacion 2FA

Tareas fisicas:

• Recoger credencial en RH
• Tomar foto para gafete
• Asistir a orientacion
• Conocer equipo de trabajo

Confirmaciones:

• Confirmar fecha de inicio
• Confirmar horario de trabajo
• Aceptar politicas
• Confirmar datos bancarios

4. Auto-Completar (auto_complete)

Descripcion

Items que se completan automaticamente cuando se cumple una condicion especifica.

Uso avanzado para:

• Integraciones con otros sistemas
• Verificaciones automaticas
• Triggers de automatizacion
• Condiciones personalizadas

Configuracion

Campos:

• Titulo: Nombre del item
• Descripcion: Que representa
• Condicion: Logica de auto-completado
• Configuracion JSON (para integraciones)

Este tipo es para casos avanzados y puede requerir desarrollo custom.

Ejemplo de Uso

Item: "Verificacion de Antecedentes" Tipo: auto_complete

• Descripcion: "Se completara cuando el proveedor confirme la verificacion"
• Configuracion:

{
  "trigger": "external_webhook",
  "provider": "background_check_service",
  "expectedStatus": "approved"
}

Cuando el webhook recibe confirmacion, el item se marca como completado.

Comparativa de Tipos

Iconos y Colores

En la interfaz:

document_request:

• Icono: Documento
• Color: Azul (#1890ff)
• Tag: "Documentos"

signature_request:

• Icono: Firma
• Color: Morado (#722ed1)
• Tag: "Firma"

manual:

• Icono: Check
• Color: Verde (#52c41a)
• Tag: "Manual"

auto_complete:

• Icono: Rayo
• Color: Naranja (#fa8c16)
• Tag: "Automatico"

Elegir el Tipo Correcto

Pregunta: ¿Que necesito del candidato?

• ¿Subir archivos/documentos? - Usa: document_request
• ¿Firmar un documento legal? - Usa: signature_request
• ¿Confirmar que hizo algo? - Usa: manual
• ¿Completar sin accion del candidato? - Usa: auto_complete

Proximos Pasos

• Solicitud de Documentos - Detalle del tipo document_request
• Firmas Digitales - Detalle del tipo signature_request
• Tareas Manuales - Detalle del tipo manual