Documentación Funcional para Expertos
Esta guía describe el flujo completo de uso de Floutic para usuarios con rol de Experto.
Resumen del Flujo
[!IMPORTANT] A diferencia de las empresas, los expertos DEBEN verificar su email antes de poder hacer cualquier cosa, incluyendo crear su perfil.
1. Registro
Proceso
- El usuario accede a
/registro - Completa el formulario con:
- Nombre de usuario
- Email profesional
- Contraseña (mínimo 8 caracteres)
- Selecciona rol "Experto"
- Acepta términos y condiciones
- Hace clic en "Crear cuenta"
Email Recibido
📧 Asunto: "Verifica tu dirección de email - Floutic"
El email contiene un enlace de verificación válido por 24 horas.
Redirección Después del Registro
El experto es redirigido directamente a /verificar-email?from=register&role=experto
Estado después del registro
| Atributo | Valor |
|---|---|
email_verified | ❌ No |
perfil | ❌ No existe |
perfil.is_verified | N/A |
Usuario ya registrado con otro rol
Si un usuario intenta registrarse con un email que ya existe:
-
Si ya tiene el mismo rol: El sistema detecta el conflicto y muestra un modal indicando que ya tiene ese rol. Por ejemplo: "Ya tienes una cuenta registrada como Experto"
-
Si tiene un rol diferente: El sistema ofrece añadir el nuevo rol a la cuenta existente. El modal muestra: "Para añadir el rol de Empresa a tu cuenta, necesitas iniciar sesión primero."
[!TIP] Los usuarios pueden tener múltiples roles (experto + empresa) en una sola cuenta. Para añadir un segundo rol, deben iniciar sesión y hacerlo desde la configuración de la cuenta.
2. Verificación de Email
¿Es obligatorio?
SÍ, absolutamente obligatorio. Los expertos no pueden hacer nada hasta verificar su email.
Comportamiento del sistema
- Si intenta acceder al dashboard → Redirigido a
/verificar-email - Si intenta acceder a crear perfil → Redirigido a
/verificar-email - Si intenta hacer login → Redirigido a
/verificar-email
Proceso
- El usuario revisa su bandeja de entrada
- Hace clic en el enlace de verificación
- Es redirigido a
/verificar-email?token=... - El sistema valida el token y marca el email como verificado
- Es redirigido al dashboard de experto
Si el email expiró
- Puede solicitar reenvío desde la página de verificación
- El nuevo enlace también es válido por 24 horas
3. Creación del Perfil de Experto
¿Cuándo puede crear el perfil?
Solo después de verificar el email
Información requerida
| Campo | Obligatorio | Validación |
|---|---|---|
| Biografía | ✅ | Mínimo 50 palabras, máximo 600 palabras |
| Habilidades | ✅ | Mínimo 3 habilidades |
| Tarifa por hora | ✅ | Entre €10 y €1000 |
| Disponibilidad | ✅ | Full-time, Part-time o Freelance |
| Teléfono | ✅ | Con prefijo de país |
| Ubicación | ✅ | Ciudad y país |
| Años de Experiencia | ✅ | Nivel de experiencia profesional |
| Portfolio URL | ❌ | URL válida (https://...) |
| LinkedIn URL | ❌ | URL válida (https://...) |
| GitHub URL | ❌ | URL válida (https://...) |
| Foto de perfil | ❌ | JPEG, PNG o WebP (máx 2MB) |
Validación en tiempo real
El formulario proporciona feedback visual mientras el usuario completa los campos:
- Indicadores de requisitos: Cada campo muestra si cumple los requisitos (✓ verde) o no (○ gris)
- Contador de palabras/caracteres: El campo de biografía muestra el conteo actual
- Bordes dinámicos:
- 🟢 Borde verde = campo válido
- 🔴 Borde rojo = campo con error
- ⚪ Borde gris = campo no tocado
- Validación onBlur: Los errores se muestran al salir del campo
- Botón deshabilitado: El botón de envío se desactiva si el formulario no es válido
[!TIP] El formulario de edición de perfil (
/perfil/experto) tiene las mismas validaciones en tiempo real, incluyendo mínimo 3 habilidades y teléfono obligatorio. La biografía requiere mínimo 50 caracteres en el formulario de edición.
Estado después de crear perfil
| Atributo | Valor |
|---|---|
email_verified | ✅ Sí |
perfil | ✅ Existe |
perfil.verification_status | pending |
Email Recibido (Admin)
📧 El equipo de administración recibe notificación de nuevo perfil para revisar.
4. Verificación del Perfil por Administrador
Proceso
- Un administrador revisa el perfil
- Verifica credenciales y experiencia
- Puede aprobar o rechazar el perfil
Tiempos
- ⏱️ Revisión en menos de 48 horas
Si es Aprobado
perfil.verification_status=approvedperfil.is_verified=true- El experto puede ver proyectos disponibles y aplicar
Si es Rechazado
perfil.verification_status=rejectedperfil.verification_reason= "Razón del rechazo"- El experto puede editar y reenviar el perfil
- Si el rechazo es permanente (
rejection_is_permanent = true), no puede reenviar
Email Recibido
📧 Si aprobado: "¡Tu perfil de experto ha sido verificado!"
- Confirmación de verificación
- Próximos pasos (recibir invitaciones, enviar propuestas)
- Recordatorio para configurar Stripe Connect
- Enlace al dashboard
📧 Si rechazado: "Tu perfil de experto requiere mejoras"
- Explica el motivo del rechazo
- Instrucciones para corregir y reenviar
- Enlace para editar el perfil
5. Datos Fiscales (NIF y Dirección)
¿Cuándo se solicitan?
ANTES de enviar la primera propuesta. Sin datos fiscales completos, el experto no puede aplicar a ningún proyecto.
[!IMPORTANT] Esta validación solo aplica al primer proyecto del experto. Una vez completados, no se vuelven a solicitar.
Información requerida
| Campo | Obligatorio | Descripción |
|---|---|---|
| NIF | ✅ | Número de Identificación Fiscal |
| Nombre fiscal | ✅ | Nombre legal completo |
| Dirección fiscal | ✅ | Dirección para facturación |
| Código postal | ✅ | CP (5 dígitos en España) |
| Ciudad | ✅ | Localidad |
| Provincia | ✅ | Provincia |
| País | ✅ | País (defecto: España) |
[!NOTE] Los datos fiscales son necesarios para la facturación legal y el pago de impuestos.
6. Configuración de Stripe Connect
¿Es obligatorio?
Sí, ANTES de enviar la primera propuesta. Sin Stripe Connect configurado:
- Puede ver proyectos e invitaciones
- NO puede enviar propuestas (error al intentar)
- NO puede recibir pagos
[!IMPORTANT] Esta validación solo aplica al primer proyecto del experto. Una vez configurado, no se vuelve a solicitar.
Requisitos previos
- ✅ Email verificado
- ✅ Perfil verificado
- ✅ Datos fiscales completos
Proceso
- En el dashboard aparece un banner "Configura tus pagos"
- Hacer clic en "Configurar pagos"
- Es redirigido a Stripe para completar onboarding
- Completar información fiscal y bancaria en Stripe
- Al finalizar, vuelve al dashboard
Estados de Stripe Connect
| Estado | Descripción | Puede recibir pagos |
|---|---|---|
requires_onboarding | No ha iniciado | ❌ |
pending | Información incompleta | ❌ |
charges_enabled | Puede recibir cargos | ⚠️ Parcial |
payouts_enabled | Puede recibir transferencias | ✅ Sí |
7. Matriz de Permisos
Sin Email Verificado
| Acción | ¿Permitido? | Notas |
|---|---|---|
| Ver dashboard | ❌ Redirigido | Siempre redirige a verificar email |
| Crear perfil | ❌ No | Requiere email verificado |
| Ver proyectos | ❌ No | Requiere email verificado |
| Cualquier otra acción | ❌ No | Todo bloqueado |
Con Email Verificado pero Sin Perfil
| Acción | ¿Permitido? | Notas |
|---|---|---|
| Ver dashboard | ✅ Sí | Muestra mensaje para crear perfil |
| Crear perfil | ✅ Sí | Primera acción necesaria |
| Ver proyectos disponibles | ❌ No | Requiere perfil |
| Aplicar a proyectos | ❌ No | Requiere perfil |
Con Email Verificado y Perfil Pendiente
| Acción | ¿Permitido? | Notas |
|---|---|---|
| Ver dashboard | ✅ Sí | Muestra estado pendiente |
| Editar perfil | ✅ Sí | Puede mejorar información |
| Ver proyectos disponibles | ⚠️ Limitado | Solo visualización |
| Aplicar a proyectos | ❌ No | Requiere perfil verificado |
| Configurar Stripe | ❌ No | Requiere perfil verificado |
Con Email y Perfil Verificados
| Acción | ¿Permitido? | Notas |
|---|---|---|
| Ver dashboard | ✅ Sí | Acceso completo |
| Ver proyectos disponibles | ✅ Sí | Todos los proyectos |
| Aplicar a proyectos | ✅ Sí | Sin límites |
| Recibir invitaciones | ✅ Sí | De empresas |
| Trabajar en proyectos | ✅ Sí | Completo |
| Configurar Stripe | ✅ Sí | Obligatorio para pagos |
| Recibir pagos | ✅ Sí | Si Stripe está configurado |
8. Flujo de Aplicación a Proyectos
Requisitos previos
- ✅ Email verificado
- ✅ Perfil verificado
Proceso
- Ver proyectos disponibles en la pestaña "Invitaciones"
- Seleccionar un proyecto
- Hacer clic en "Aplicar"
- Completar propuesta:
- Mensaje de presentación
- Presupuesto propuesto
- Tiempo estimado
- Hitos (opcional)
- Enviar aplicación
Estados de Aplicación
9. Trabajo en Proyectos
Flujo de trabajo
Funcionalidades durante el proyecto
- 💬 Chat con la empresa
- 📎 Subir entregables
- 📊 Actualizar estado
- ✅ Marcar hitos completados
Entrega de Hitos
Para marcar un hito como completado, debes usar el formulario de entrega. Este formulario incluye validación en tiempo real para asegurar la calidad de la entrega:
- Título: Obligatorio (mín. 5 caracteres)
- Descripción detallada: Obligatorio (mín. 20 caracteres) - Explica qué has hecho.
- Entregables: Debes listar al menos un item entregable (código, documento, enlace, etc.)
- Archivos adjuntos: Opcional pero recomendado.
Adjuntar Archivos
Puedes adjuntar archivos a tu entrega de hito de dos formas:
- Arrastrar y soltar: Arrastra archivos desde tu ordenador al área designada
- Seleccionar archivos: Haz clic en el área para abrir el selector de archivos
Especificaciones técnicas:
| Aspecto | Límite |
|---|---|
| Archivos máximos | 5 por entrega |
| Tamaño por archivo | 10 MB |
| Formatos permitidos | PDF, DOC, DOCX, TXT, ZIP, RAR, imágenes (JPG, PNG, GIF, WebP) |
Gestión de archivos:
- Los archivos se suben inmediatamente al seleccionarlos
- Puedes eliminar archivos antes de enviar la entrega
- Un indicador de carga muestra el progreso de la subida
- Los archivos subidos aparecen en una lista con nombre y tamaño
[!TIP] El sistema te guiará con bordes rojos y mensajes si falta información. No podrás enviar la entrega hasta que todo esté correcto. Una vez enviada, la empresa revisará tu trabajo y recibirás una notificación (app y email) con el resultado (aprobado, rechazado o necesita revisión).
Estados de los Hitos
- En curso: El hito está activo, el pago está en depósito y puedes trabajar en él.
- Pendiente: El hito está esperando a que se completen los anteriores (o el pago).
- Pago pendiente: La empresa aún no ha depositado el dinero en escrow.
10. Emails que Recibe el Experto
| Momento | Asunto del Email | Contenido |
|---|---|---|
| Registro | Verifica tu dirección de email | Enlace de verificación |
| Perfil aprobado | ¡Tu perfil de experto ha sido verificado! | Confirmación + próximos pasos + Stripe |
| Perfil rechazado | Tu perfil requiere mejoras | Razón + cómo corregir |
| Nueva invitación | Una empresa te ha invitado | Detalles del proyecto |
| Aplicación aceptada | ¡Tu propuesta fue aceptada! | Detalles del proyecto |
| Aplicación rechazada | Actualización sobre tu aplicación | Proyecto no seleccionado |
| Pago listo | Hito listo para pagar | Client puede pagar el hito + Instrucciones para prepararse |
| Pago recibido | Pago en custodia (Escrow) | Fondos asegurados + Autorización para empezar trabajo |
| Revisión de hito | Resultado de la revisión del hito | Estado (aprobado/revision) + feedback |
| Nueva reseña | Has recibido una nueva reseña | Calificación + comentario |
| Cambio de email | Verifica tu dirección de email | Enlace de verificación (sin email de bienvenida posterior) |
[!NOTE] El email de Bienvenida solo se envía tras la primera verificación exitosa de la cuenta. En cambios posteriores de correo electrónico, se enviará el enlace de verificación correspondiente, pero no se repetirá el correo de bienvenida.
11. Pantallas y Redirecciones
Flujo de navegación
URLs principales
| URL | Descripción | Acceso |
|---|---|---|
/dashboard/experto | Dashboard principal | Autenticado + Email verificado |
/perfil/experto | Crear/Editar perfil | Email verificado |
/verificar-email | Verificar email | Sin email verificado |
/proyecto/:id | Ver proyecto asignado | Experto asignado |
/expertos/:id | Perfil público | Público (si verificado) |
12. Perfil Público
¿Cuándo es visible?
Solo cuando:
- ✅ Email verificado
- ✅ Perfil verificado
- ✅ Perfil marcado como "visible públicamente"
Información visible
- Nombre profesional
- Título/Especialización
- Biografía
- Habilidades
- Nivel de experto
- Reseñas y puntuación
- Portfolio (si configurado)
URL del perfil público
/expertos/:username o /expertos/:id
13. Resolución de Problemas
"No puedo acceder al dashboard"
- ¿Tu email está verificado? → El sistema te redirige a verificar
- Revisa tu bandeja de entrada y spam
- Solicita reenvío del email de verificación
"No puedo aplicar a proyectos"
- ¿Has creado tu perfil? → Créalo primero
- ¿Tu perfil está verificado? → Espera aprobación
- ¿Tu perfil fue rechazado? → Revisa razón y corrige
"No puedo recibir pagos"
- ¿Has configurado Stripe Connect? → Hazlo desde el dashboard
- ¿Stripe muestra
payouts_enabled? → Completa la información - Revisa que tu cuenta bancaria esté verificada en Stripe
"Mi perfil fue rechazado"
- Lee la razón del rechazo en el dashboard
- Edita tu perfil corrigiendo los problemas indicados
- Al guardar, se reenviará automáticamente a revisión
- Si dice "rechazo permanente", contacta a soporte
"No recibí el email de verificación"
- Revisa carpeta de spam
- Verifica que el email sea correcto
- Solicita reenvío desde
/verificar-email - Contacta soporte si persiste
"Me pide datos fiscales al ser seleccionado"
Cuando una empresa te selecciona para un proyecto por primera vez:
- Aparecerá un modal pidiendo tus datos fiscales (NIF, Razón Social, Domicilio).
- Estos datos son obligatorios para poder generar las facturas legales de tus servicios.
- Debes completarlos para que el sistema permita a la empresa realizar el pago del hito y asignarte formalmente.
14. Comparativa Rápida: Experto vs Empresa
| Aspecto | Experto | Empresa |
|---|---|---|
| Email verificado obligatorio | ✅ Antes de todo | ⚠️ Después de crear perfil |
| Puede crear perfil sin email | ❌ No | ✅ Sí |
| Verificación de perfil | ✅ Obligatoria | ✅ Obligatoria |
| Stripe Connect | ✅ Obligatorio (para pagos) | ❌ No aplica |
| Perfil público | ✅ Sí (cuando verificado) | ❌ No |