Documentación Funcional para Empresas

Esta guía describe el flujo completo de uso de Floutic para usuarios con rol de Empresa.

Resumen del Flujo

1. Registro

Proceso

1. El usuario accede a /registro
2. Completa el formulario con:
   • Nombre de usuario
   • Email corporativo
   • Contraseña (mínimo 8 caracteres)
   • Selecciona rol "Empresa"
3. Acepta términos y condiciones
4. 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.

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:

1. 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 Empresa"

2. 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 Experto a tu cuenta, necesitas iniciar sesión primero."

[!TIP] Los usuarios pueden tener múltiples roles (empresa + experto) 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?

No inmediatamente. Las empresas pueden crear su perfil sin verificar el email primero.

Sin embargo, después de crear el perfil, deben verificar el email para poder:

• Publicar proyectos
• Solicitar presupuestos a expertos
• Acceder a funcionalidades completas

Proceso

1. El usuario revisa su bandeja de entrada
2. Hace clic en el enlace de verificación
3. Es redirigido a /verificar-email?token=...
4. El sistema valida el token y marca el email como verificado

Si el email expiró

• Puede solicitar reenvío desde la página de verificación
• Puede solicitar reenvío desde el banner amarillo que aparece en la aplicación

---

3. Creación del Perfil de Empresa

¿Cuándo puede crear el perfil?

✅ Inmediatamente después del registro (no requiere email verificado)

Redirección automática

Cuando una empresa accede al dashboard sin perfil:

• Es redirigida automáticamente a /perfil/crear

Información requerida

Campo	Obligatorio	Descripción
Nombre de la empresa	✅	Nombre legal o comercial
Descripción	✅	Descripción de la empresa y servicios
Sector/Industria	✅	Industria o sector de actividad
Ubicación	✅	Ciudad y país donde opera
Teléfono	✅	Teléfono de contacto con prefijo
Tamaño de empresa	✅	Número de empleados (1-5, 6-20, 21-50, 50+)
CIF/NIF	✅	Código de identificación fiscal (formato: B12345678)
Sitio web	❌	URL del sitio web corporativo
Tipo de empresa	❌	Ecommerce, Agencia, SaaS, Otro
Persona de contacto	❌	Nombre del contacto principal
Email de empresa	❌	Email corporativo (diferente al de cuenta)

Datos fiscales (obligatorios)

Los datos fiscales son requeridos desde el primer momento para poder operar en la plataforma:

Campo	Obligatorio	Validación
CIF/NIF	✅	Letra + 8 dígitos (ej: B12345678)
Nombre Fiscal	✅	Mínimo 2 caracteres
Dirección Fiscal	✅	Mínimo 5 caracteres
Código Postal	✅	5 dígitos exactos
Ciudad	✅	Mínimo 2 caracteres
Provincia	✅	Mínimo 2 caracteres
País	✅	Por defecto: España (obligatorio para validación)

Estado después de crear perfil

Atributo	Valor
email_verified	❔ Puede ser No aún
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

1. Un administrador revisa el perfil
2. Puede aprobar o rechazar el perfil

Tiempos

• ⏱️ Revisión en menos de 48 horas

Si es Aprobado

• perfil.verification_status = approved
• perfil.is_verified = true
• La empresa puede publicar proyectos

Si es Rechazado

• perfil.verification_status = rejected
• perfil.verification_reason = "Razón del rechazo"
• La empresa puede editar y reenviar el perfil

Email Recibido

📧 Si aprobado: "¡Tu perfil de empresa ha sido verificado!"

• Contiene confirmación de verificación
• Próximos pasos (publicar proyectos, solicitar presupuestos)
• Enlace al dashboard

📧 Si rechazado: "Tu perfil de empresa requiere mejoras"

• Explica el motivo del rechazo
• Instrucciones para corregir y reenviar
• Enlace para editar el perfil

---

5. Matriz de Permisos

Sin Email Verificado

Acción	¿Permitido?	Notas
Ver dashboard	⚠️ Redirigido	Redirige a crear perfil o verificar email
Crear perfil	✅ Sí	Único paso permitido sin email
Publicar proyecto	❌ No	Requiere email verificado
Solicitar presupuesto	❌ No	Requiere email verificado
Ver expertos	❌ No	Requiere email verificado
Editar perfil	❌ No	Requiere email verificado

Con Email Verificado pero Perfil Pendiente

Acción	¿Permitido?	Notas
Ver dashboard	✅ Sí	Muestra estado pendiente
Editar perfil	✅ Sí	Puede mejorar información
Publicar proyecto	❌ No	Requiere perfil verificado
Solicitar presupuesto	❌ No	Requiere perfil verificado
Ver expertos	✅ Sí	Solo visualización

Con Email y Perfil Verificados

Acción	¿Permitido?	Notas
Ver dashboard	✅ Sí	Acceso completo
Publicar proyectos	✅ Sí	Sin límites
Solicitar presupuestos	✅ Sí	Directamente a expertos
Ver y contactar expertos	✅ Sí	Completo
Gestionar proyectos	✅ Sí	Todos los estados
Realizar pagos	✅ Sí	Vía Stripe
Dejar reseñas	✅ Sí	Al completar proyectos
Seleccionar expertos	✅ Sí	Para sus proyectos

---

6. Datos Fiscales

¿Cuándo se solicitan?

Los datos fiscales son obligatorios desde el registro inicial y deben completarse en el formulario de onboarding de empresa. Todos los campos fiscales (excepto País) son requeridos para poder crear el perfil.

Modal de Datos Fiscales (Primer Proyecto)

Cuando una empresa intenta publicar su primer proyecto sin haber completado los datos fiscales, el sistema muestra automáticamente un modal bloqueante solicitando los datos:

Características del Modal

• 🔒 Bloqueante: No se puede cerrar sin completar los datos
• 📋 Título: "Datos Fiscales de la Empresa"
• ✏️ Campos obligatorios: CIF, Nombre Fiscal, Dirección, CP, Ciudad, Provincia
• ✅ Botón: "Guardar y Continuar" (deshabilitado hasta completar)

Información requerida

Campo	Obligatorio	Validación
CIF/NIF	✅	Formato: Letra + 8 dígitos (ej: B12345678)
Nombre Fiscal	✅	Mínimo 2 caracteres
Dirección Fiscal	✅	Mínimo 5 caracteres
Código Postal	✅	5 dígitos exactos
Ciudad	✅	Mínimo 2 caracteres
Provincia	✅	Mínimo 2 caracteres
País	✅	Obligatorio para validación de schema (ej: España)

Validación en tiempo real

El formulario de perfil muestra validación instantánea:

• ✅ Indicadores de requisitos - Cada campo muestra si cumple los requisitos (✓ verde / ○ gris)
• ✅ Bordes dinámicos - Verde cuando válido, rojo cuando inválido
• ✅ Botón deshabilitado - No se puede guardar hasta completar todos los campos obligatorios

Indicador visual de estado fiscal

El formulario muestra un banner de estado:

• 🟢 Verde - "Datos fiscales completos ✓" (todos los campos completados)
• 🔵 Azul - "CIF válido - Completa el resto de datos fiscales"
• 🟡 Ámbar - "Completa todos los datos fiscales obligatorios"

[!IMPORTANT] Todos los campos fiscales (excepto País) son obligatorios para poder guardar el perfil de empresa. Esta información es necesaria para la facturación legal en España.

---

7. Flujo de Publicación de Proyecto

Requisitos previos

• ✅ Email verificado
• ✅ Perfil de empresa verificado (o al menos pendiente)
• ✅ CIF/NIF completado en datos fiscales

Proceso

1. Acceder a "Publicar Proyecto" desde el dashboard
2. Completar formulario con validación en tiempo real:
   • Título del proyecto (mín. 10 caracteres, máx. 200)
   • Descripción detallada (mín. 50 caracteres, máx. 2000)
   • Presupuesto (EUR) (mayor a 0€, máximo 100.000€)
   • Categoría (opcional, desplegable)
   • Duración estimada (opcional)
   • Urgencia (opcional)
   • Fecha límite (opcional, no puede ser anterior a hoy)
   • Habilidades requeridas (opcional, seleccionables con botones visuales)
3. Elige el tipo de envío:
   • 📤 Publicar Proyecto: El proyecto se envía directamente para revisión (estado pending_publication). Aparece un mensaje indicando que el equipo lo revisará antes de ser visible.
   • ✏️ Guardar como borrador: El proyecto se guarda en estado draft para seguir editándolo más tarde.
4. Redirección automática: Tras el éxito, el sistema te redirige automáticamente al dashboard empresarial en 2 segundos.
5. El proyecto pasa a revisión administrativa si fue publicado.

Validación en tiempo real

El formulario de proyecto incluye validación instantánea:

• ✅ Indicadores de requisitos - Muestra si cada requisito se cumple (ej: "Mínimo 10 caracteres ✓")
• ✅ Contador de caracteres - Muestra progreso (ej: "125/200")
• ✅ Borde verde - Los campos válidos se marcan con borde verde
• ✅ Borde rojo - Los campos con error se marcan con borde rojo
• ✅ Botón deshabilitado - No se puede publicar hasta que todos los campos obligatorios sean válidos
• ✅ Resumen de errores - Al final del formulario se muestra un listado de todos los errores pendientes

Estados del Proyecto

[!IMPORTANT] Flujo Payment-First: Desde 2024, cuando la empresa selecciona un experto, el proyecto pasa a estado payment_pending y solo se inicia (in_progress) después de confirmar el pago del primer hito. El dinero se mantiene en escrow hasta que la empresa apruebe el trabajo.

Gestión de Borradores

Los proyectos en estado draft (borrador) pueden ser:

• ✏️ Editados: Desde la página de detalle del proyecto, botón "Editar borrador"
  • El formulario de edición es idéntico al formulario de creación (/publicar-proyecto)
  • Misma estructura, mismos campos, mismas validaciones y mismas notas aclaratorias
  • Las habilidades requeridas son opcionales (igual que en la creación)
• 📤 Enviados a validación: Botón "Enviar a validación" para que el admin revise

  Nota: Durante la validación, el administrador asignará una talla al proyecto (XS-XL) y seleccionará los expertos más adecuados si es un proyecto curado.

• 🗑️ Eliminados: Botón "Eliminar" en la página de detalle del proyecto

[!WARNING] La eliminación de un proyecto es permanente y no se puede deshacer. Aparecerá un diálogo de confirmación antes de eliminar.

Para eliminar un borrador:

1. Accede al proyecto desde el dashboard o url directa /proyecto/{id}
2. En la cabecera del proyecto, haz clic en el botón rojo "Eliminar"
3. Confirma la eliminación en el diálogo
4. Serás redirigido al dashboard

---

8. Selección de Experto y Pago Inicial

Flujo Payment-First

Cuando un experto aplica a tu proyecto y decides seleccionarlo, el sistema sigue un flujo de pago obligatorio antes de iniciar el proyecto:

Estados del Proyecto durante la Selección

Estado	Descripción
published	Proyecto visible, expertos pueden aplicar
payment_pending	Experto seleccionado, esperando pago del primer hito
in_progress	Pago confirmado, proyecto activo

Protección Escrow

El pago se mantiene en escrow seguro:

• 🔒 El dinero se retiene hasta que apruebes el trabajo
• ✅ Solo se libera cuando aceptas la entrega del hito
• 🔔 Notificación automática: El experto recibe una notificación inmediata (app y email) con tu feedback y el resultado de la revisión.
• ⏳ Próximo Hito: Al liberar un pago y activarse el siguiente hito, el experto recibirá una notificación automática indicando que el nuevo hito ya está disponible para que realices el pago, permitiéndole preparar el siguiente paso del trabajo.

Si Cierras el Modal de Pago

Si cierras el modal de pago sin completarlo:

1. El proyecto permanece en estado payment_pending
2. El experto sigue seleccionado
3. Aparece una notificación en el dashboard recordándote el pago pendiente
4. En la propuesta del experto verás dos botones:
   • 💳 Completar Pago: Reabre el modal para completar el pago
   • ❌ Cancelar Selección: Cancela explícitamente la selección

[!NOTE] El experto NO es notificado hasta que completes el pago. Esto te permite cerrar el modal y volver más tarde sin perder la selección.

Si Cancelas Explícitamente la Selección

Si decides cancelar la selección (botón "Cancelar Selección"):

1. El proyecto vuelve a estado published
2. El experto es desasignado
3. La propuesta del experto vuelve a estado pending
4. Puedes seleccionar al mismo u otro experto

[!TIP] Puedes revisar el detalle del hito y el monto antes de confirmar el pago en el modal.

Revisión de Entregas de Hitos

Cuando el experto completa un hito y envía una entrega, recibirás una notificación. Para revisar la entrega:

1. Accede al proyecto desde tu dashboard
2. En la sección de hitos, haz clic en "Revisar Entrega"
3. Se abrirá un modal con:
   • Descripción del trabajo realizado
   • Lista de entregables completados
   • Archivos adjuntos (si los hay)

Descargar Archivos Adjuntos

Si el experto adjuntó archivos a su entrega:

• Los verás listados en la sección "Archivos Adjuntos"
• Cada archivo muestra su nombre y un enlace "Descargar"
• Haz clic en "Descargar" para obtener el archivo

Formatos soportados: PDF, DOC, DOCX, TXT, ZIP, RAR, imágenes (JPG, PNG, GIF, WebP)

Opciones de Revisión

Acción	Efecto
Aprobar	Libera el pago y activa el siguiente hito
Solicitar Revisión	Devuelve al experto con comentarios para mejoras
Rechazar	Si rechazas 3 veces, el proyecto se cancela

[!WARNING] Considera usar "Solicitar Revisión" en lugar de "Rechazar" para dar al experto la oportunidad de mejorar su trabajo.

---

9. Solicitud de Presupuesto a Experto

Requisitos previos

• ✅ Email verificado
• ✅ Perfil de empresa verificado (no basta con pendiente)

[!IMPORTANT] Si tu perfil está pendiente de verificación o ha sido rechazado, verás un mensaje indicando el estado y no podrás acceder al formulario de solicitud.

Proceso

1. Desde el directorio de expertos, seleccionar un experto
2. Hacer clic en "Solicitar Presupuesto"
3. Completar formulario similar a publicar proyecto
4. El experto recibe notificación y puede responder con propuesta

---

10. Emails que Recibe la Empresa

Momento	Asunto del Email	Contenido
Registro	Verifica tu dirección de email	Enlace de verificación
Perfil aprobado	¡Tu perfil ha sido verificado!	Confirmación + siguiente paso
Perfil rechazado	Tu perfil requiere cambios	Razón + cómo corregir
Proyecto publicado	Tu proyecto está publicado	Detalles del proyecto
Nuevo aplicante	Un experto ha aplicado a tu proyecto	Detalles del experto
Propuesta recibida	Nueva propuesta de presupuesto	Detalles de la propuesta
Proyecto completado	Proyecto finalizado	Invitación a dejar reseña
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/empresa	Dashboard principal	Autenticado
/perfil/crear	Crear perfil de empresa	Sin perfil
/perfil/empresa	Editar perfil	Con perfil
/publicar	Publicar nuevo proyecto	Perfil verificado
/expertos	Ver directorio de expertos	Autenticado
/proyecto/:id	Ver detalles de proyecto	Propietario

---

12. Resolución de Problemas

"No puedo publicar proyectos"

1. ¿Tu email está verificado? → Verifica en /verificar-email
2. ¿Tu perfil está aprobado? → Espera aprobación o revisa estado en dashboard
3. ¿Tienes los datos fiscales completados? → Si es tu primer proyecto, aparecerá un modal para completarlos (CIF, Razón Social y Domicilio Fiscal completo)

"Apareció un modal pidiendo datos fiscales al publicar"

Esto es normal cuando es tu primer proyecto:

1. Los datos fiscales son obligatorios para poder facturar legalmente
2. Debes completar: CIF (ej: B12345678), Razón Social / Nombre Fiscal y Domicilio Fiscal completo (Calle, CP, Ciudad, Provincia)
3. Haz clic en "Guardar y Continuar"
4. El modal se cerrará y el sistema te permitirá proceder con la publicación si todo es correcto

[!TIP] Puedes completar tus datos fiscales antes desde /perfil/empresa para evitar que aparezca este modal.

"¿Cómo elimino un proyecto en borrador?"

1. Ve a la página de detalle del proyecto: /proyecto/{id}
2. Haz clic en el botón rojo "Eliminar" en la cabecera
3. Confirma la eliminación en el diálogo
4. El proyecto se eliminará permanentemente

[!NOTE] Solo se pueden eliminar proyectos en estado draft. Una vez enviado a validación o publicado, no se puede eliminar.

"No recibí el email de verificación"

1. Revisa carpeta de spam
2. Solicita reenvío desde el banner amarillo
3. Contacta soporte si persiste

"Mi perfil fue rechazado"

1. Lee la razón del rechazo en el dashboard
2. Edita tu perfil corrigiendo los problemas
3. Al guardar, se reenviará automáticamente a revisión