Preguntas frecuentes

Compendio de dudas operativas y técnicas.

General

¿HUMAE es una bolsa de trabajo pública?

No. Es una plataforma privada. Las vacantes son confidenciales y solo el equipo HUMAE + la empresa dueña tienen visibilidad. Los candidatos tampoco ven las vacantes directamente — solo reciben invitaciones si un recruiter los asigna.

¿Cuánto cuesta usar HUMAE?

• Candidato: 499 MXN por 6 meses de membresía.
• Empresa cliente: cobro por vacante / por contratación (negociación con el equipo HUMAE, no manejado por la plataforma en el MVP).
• Admin/recruiter HUMAE: interno, sin cobro.

¿Puedo usar HUMAE desde mi celular?

Sí. El frontend es responsive. No hay app nativa en el MVP, pero la web funciona bien en móvil (Chrome, Safari, Firefox).

¿HUMAE funciona fuera de México?

El MVP está optimizado para México (MXN + es_MX). Los catálogos de ubicación incluyen estados y ciudades de MX + algunos países latinoamericanos. Internacionalización completa en fase 2.

Candidatos

¿Qué pasa si mi membresía expira a media entrevista?

La entrevista sigue en pie. Solo se invisibiliza tu perfil en el directorio para nuevas búsquedas. Tus asignaciones activas y entrevistas agendadas continúan.

¿Puedo estar en HUMAE sin pagar?

Puedes registrarte y construir tu perfil gratis. Pero no apareces en el directorio hasta contratar la membresía. Si un recruiter ya te tenía en asignaciones, ahí permaneces.

¿Cómo cancelo mi membresía?

La membresía NO se cancela por inactividad — simplemente expira a los 180 días. Si quieres cancelación anticipada (con posible refund), contacta soporte desde /contacto.

¿Otro candidato puede ver mi información?

No. Un candidato solo ve su propio perfil. Los demás son invisibles.

¿Las empresas ven mi teléfono/email?

No directamente. La empresa ve tu perfil sin datos de contacto. Cuando confirmas una entrevista, el recruiter de HUMAE hace el puente.

¿Puedo postularme yo mismo a vacantes?

No en el MVP. Las vacantes son privadas y el recruiter HUMAE es quien hace la postulación por ti. Si te interesa una vacante específica, puedes notarlo en tu perfil o al recruiter directamente.

¿Puedo tener varios empleos activos buscados?

Sí. Puedes ser asignado a múltiples vacantes simultáneamente.

Empresas

¿Cómo empieza mi empresa a usar HUMAE?

1. Contacta al equipo HUMAE.
2. Se crea tu Company y se te asigna un recruiter.
3. Recibes invitación por email para crear tu cuenta.
4. Publicas tu primera vacante.

¿Puedo ver todos los candidatos de HUMAE?

No. Solo ves los candidatos que tu recruiter asignado te presenta (los que están en stage presented o posterior de tus vacantes). El directorio completo es de uso exclusivo del equipo HUMAE.

¿Puedo invitar a más miembros de mi empresa?

Sí. Como owner, puedes invitar más company_user desde /me/empresa/miembros. Roles: owner, manager, viewer.

¿Puedo publicar varias vacantes?

Sí, sin límite. Cada una es independiente.

¿Cuánto tarda HUMAE en presentarme candidatos?

Depende de la vacante. En promedio: 24–72h para la primera ronda de candidatos presentados.

Reclutadores HUMAE

¿Cómo se me asignan vacantes?

Un admin te asigna explícitamente (assigned_recruiter_id). Recibes email + in-app notification.

¿Puedo compartir asignaciones con otros recruiters?

En el MVP, una asignación tiene un solo assigned_by (quien la creó). Pero múltiples recruiters pueden tocar la misma asignación (añadir notas, mover stages, agendar entrevistas). Solo uno figura como dueño.

¿Cómo bajo un CV?

GET /api/v1/recruiter/candidates/{id}/cv.pdf — desde el perfil del candidato, botón "Descargar CV".

Admin

¿Cómo creo un nuevo recruiter?

Desde /admin/usuarios → "Nuevo usuario" → rol recruiter → se envía invitación por email con setup de password.

¿Puedo ver cuántos candidatos hay registrados hoy?

Sí. /admin/reportes → KPI "Candidatos" → filtros de fecha.

¿Cómo hago un refund de una membresía?

1. Refund en Stripe Dashboard (https://dashboard.stripe.com/payments).
2. Luego /admin/memberships/{id}/cancel con reason: "refund" en HUMAE.

¿Dónde veo los logs del sistema?

En el servidor: humae_backend/storage/logs/laravel-YYYY-MM-DD.log.

¿Puedo exportar todos los datos?

Sí, endpoints:

• /admin/export/candidates.csv
• /admin/export/vacancies.csv
• /admin/export/payments.csv

Técnico

¿Qué ocurre si Stripe está caído?

• Candidato no puede iniciar checkout (devuelve error).
• Webhooks no llegan (Stripe los reintenta cuando vuelve).
• Candidatos con pagos en progreso quedan en pending hasta que Stripe se recupere.

¿Qué ocurre si el Postfix local está caído o puerto 25 bloqueado?

• Laravel recibe connect refused del SMTP y mete el job en failed_jobs.
• Reiniciar Postfix: sudo systemctl restart postfix.
• Reintentar jobs: php artisan queue:retry all.
• Si Postfix sí aceptó pero no pudo entregar saliente, los mensajes quedan en su propia cola (mailq) hasta maximal_queue_lifetime (1 día por default) y luego rebotan con un NDR.

¿Dónde se hospedan los archivos subidos?

En el disco del mismo servidor del backend (bajo storage/app/public/ para avatares y storage/app/private/ para documentos sensibles). Nunca en public_path() directo. Ver Storage local.

¿Cuántos usuarios soporta el MVP?

• Backend: sin problemas hasta ~10,000 usuarios activos (en infra estándar).
• DB: índices optimizados para queries del directorio y pipeline.
• Frontend: bundle ≈ 130 KB first load, carga bien en 4G.

¿Cómo levanto el stack localmente?

# Con Docker
docker compose up -d

# O individual:
cd humae_backend && composer install && php artisan migrate --seed && php artisan serve
cd humae_frontend && npm install && npm run dev
cd humae_docs && npm install && npm run dev

Ver README.md del monorepo.

¿Hay API pública?

No. Toda la API requiere autenticación con Sanctum. No hay endpoints públicos de consulta (excepto /health y /contact).

¿Hay SDK para integrar?

No en el MVP. La API es REST JSON; cualquier cliente HTTP puede consumirla.

¿Cómo reporto un bug?

Desde /contacto en la plataforma, o email a soporte@humae.com.mx. Incluye:

• URL donde ocurrió.
• Pasos para reproducir.
• Screenshot si aplica.
• Navegador + sistema operativo.

Privacidad y seguridad

¿HUMAE vende datos de candidatos?

No. Los datos de candidatos son privados y solo se comparten con empresas cliente en el contexto de una asignación activa.

¿Quién ve mi CV?

• Tú, siempre.
• Recruiters de HUMAE, cuando apareces en el directorio.
• Empresas cliente, solo cuando un recruiter te asigna formalmente a su vacante.

¿Cómo protegen mi contraseña?

Bcrypt con 12 rounds (default de Laravel en prod). Nunca almacenada en texto plano.

¿Puedo eliminar mi cuenta?

Sí. Desde /me/cuenta → "Eliminar cuenta". Es un soft delete: tus datos se marcan inactivos, se deshabilita el login, pero se conservan 90 días para cumplimiento de auditoría y reportes. Después de 90 días, puedes solicitar eliminación completa por GDPR/LFPDPPP.

¿Se puede entrar desde un dispositivo sin mi permiso?

Solo con tu contraseña + token válido. Si sospechas compromiso:

1. Cambia tu contraseña.
2. Todos los tokens Sanctum activos se revocan automáticamente.
3. Tendrás que loguearte de nuevo en todos tus dispositivos.

Contacto

¿No encuentras tu respuesta?

• Candidatos y empresas: /contacto en la plataforma.
• Equipo interno HUMAE: Slack #humae-support.
• Seguridad: security@humae.com.mx (GPG disponible).

---

Manual actualizado: abril 2026.

Para documentación técnica canónica, ver ARCHITECTURE.md del repositorio.