Tipos de Elementos del Checklist

El checklist de onboarding soporta cuatro tipos de elementos, cada uno con un proposito especifico y comportamiento diferente.

Resumen de tipos

Solicitud de Documentos (document_request)

Descripcion

Solicita al candidato que suba uno o mas documentos. Ideal para:

• Identificacion oficial (INE, pasaporte)
• Comprobante de domicilio
• RFC o constancia de situacion fiscal
• Titulos y certificaciones
• Cartas de recomendacion
• CURP
• Acta de nacimiento

Como funciona

1. Reclutador agrega item tipo "Solicitud de Documentos"
2. Sistema crea DocumentRequest vinculado
3. Candidato ve el item en su checklist
4. Candidato navega a "Mis Documentos"
5. Sube los archivos solicitados
6. Sistema marca item como completado automaticamente

Configuracion

Al crear el elemento, puedes:

Usando plantilla (recomendado)

{
  type: "document_request",
  title: "Documentos de Ingreso",
  description: "Favor de subir los siguientes documentos",
  documentRequestTemplateId: 5,  // ID de plantilla
  isRequired: true
}

Items personalizados

{
  type: "document_request",
  title: "Identificacion",
  description: "INE o pasaporte vigente",
  customItems: [
    { name: "INE frente", required: true },
    { name: "INE reverso", required: true }
  ],
  isRequired: true
}

Estados

Sincronizacion automatica

Cuando el candidato sube documentos:

1. DocumentRequest actualiza su estado
2. OnboardingService.syncDocumentRequestStatus() se ejecuta
3. ChecklistItem se marca como completado
4. Progreso del onboarding se recalcula

Solicitud de Firma (signature_request)

Descripcion

Solicita al candidato que firme electronicamente un documento PDF. Ideal para:

• Contrato de trabajo
• Acuerdo de confidencialidad (NDA)
• Politicas de empresa
• Reglamento interno
• Aviso de privacidad
• Carta de aceptacion

Como funciona

1. Reclutador agrega item con documento PDF
2. Sistema crea SignatureRequest
3. Candidato ve el item en su checklist
4. Candidato navega a "Firmar Documento"
5. Revisa PDF y firma electronicamente
6. Sistema marca item como completado

Configuracion

Al crear el elemento:

{
  type: "signature_request",
  title: "Contrato de Trabajo",
  description: "Favor de revisar y firmar el contrato adjunto",
  documentTemplateKey: "templates/contrato-2024.pdf",
  documentTemplateUrl: "https://s3.../contrato-2024.pdf?signed...",
  isRequired: true
}

Flujo de firma

Estados

Expiracion

• Las solicitudes de firma expiran en 30 dias
• Si expira, el reclutador debe crear nueva solicitud

Tarea Manual (manual)

Descripcion

Tareas que requieren accion humana fuera del sistema. Pueden ser completadas por:

• Candidato: Acciones que debe realizar
• Reclutador: Verificaciones internas

Casos de uso

Para candidatos:

• Leer material de bienvenida
• Completar capacitacion externa
• Confirmar datos de contacto
• Agendar cita medica

Para reclutadores:

• Verificar referencias laborales
• Configurar accesos de sistema
• Preparar espacio de trabajo
• Entregar equipo

Como funciona

1. Reclutador agrega tarea manual
2. Aparece en checklist del candidato
3. Candidato lee instrucciones
4. Realiza la accion indicada
5. Marca como completada (candidato o reclutador)

Configuracion

{
  type: "manual",
  title: "Capacitacion de Seguridad",
  description: "Completar el curso online en https://cursos.empresa.com/seguridad y obtener certificado",
  configuration: {
    instructions: "Una vez completado, marca esta tarea como finalizada"
  },
  isRequired: true
}

Quien puede completar

Verificacion

Las tareas manuales confian en el usuario. Si necesitas verificacion:

1. Usa isRequired: true para items criticos
2. Agrega instrucciones claras de evidencia
3. Revisa manualmente antes de cerrar onboarding

Auto-completado (auto_complete)

Descripcion

Elementos que se completan automaticamente cuando se cumple una condicion. Utiles para:

• Verificar que otros items esten completos
• Esperar confirmacion de sistemas externos
• Validar estados de entidades relacionadas

Como funciona

1. Reclutador configura condicion
2. Sistema evalua periodicamente
3. Cuando condicion se cumple
4. Item se marca automaticamente

Configuracion

{
  type: "auto_complete",
  title: "Verificacion de Antecedentes",
  description: "Se completara automaticamente cuando el proveedor confirme",
  configuration: {
    condition: "background_check_passed",
    linkedEntity: "BackgroundCheck",
    linkedEntityId: 123
  },
  isRequired: true
}

Casos de uso

Limitaciones actuales

• Requiere desarrollo custom para nuevas condiciones
• La logica de evaluacion esta en el backend
• No hay UI para configurar condiciones personalizadas

Comparativa de tipos

Ordenamiento de elementos

Campo sortOrder

Cada elemento tiene un sortOrder para controlar el orden de aparicion:

[
  { type: "document_request", sortOrder: 1 },
  { type: "document_request", sortOrder: 2 },
  { type: "signature_request", sortOrder: 3 },
  { type: "manual", sortOrder: 4 }
]

Drag and drop

En el editor de plantillas, puedes reordenar elementos arrastrando:

Elementos requeridos vs opcionales

isRequired: true (default)

• Debe completarse para finalizar onboarding
• Afecta el calculo de progreso
• Bloquea status "completed"

isRequired: false

• Opcional para el candidato
• No afecta progreso ni finalizacion
• Util para extras o nice-to-have

// Item requerido
{
  type: "document_request",
  title: "INE",
  isRequired: true  // Obligatorio
}

// Item opcional
{
  type: "manual",
  title: "Tour por oficinas",
  isRequired: false  // Opcional
}

Mejores practicas

Estructura recomendada

1. Documentos criticos (identificacion, RFC)
2. Documentos secundarios (comprobantes)
3. Firmas (contrato, NDA)
4. Tareas manuales (capacitaciones)
5. Verificaciones automaticas

Descripciones claras

Malo: "Subir documentos"

Bueno: "Sube tu INE por ambos lados (frente y reverso) en formato PDF o imagen"

Malo: "Firmar contrato"

Bueno: "Revisa el contrato de trabajo adjunto. Si tienes dudas, contacta a RRHH antes de firmar"

Agrupacion logica

Considera crear multiples solicitudes de documentos en lugar de una grande:

Mejor:

• "Documentos de Identidad" (INE, CURP)
• "Documentos Fiscales" (RFC, constancia)
• "Documentos Bancarios" (cuenta, CLABE)

Evitar:

• "Todos los documentos" (10+ items en una solicitud)

Proximos pasos

• Plantillas de Onboarding - Crear plantillas con estos elementos
• Gestionar Checklist - Agregar elementos a onboardings activos