Guía: Flujo Completo de Proyecto (Empresa)

Esta guía te lleva paso a paso a través del proceso completo de crear, gestionar y completar un proyecto en Floutic como empresa.

Resumen del Flujo

Registro → Perfil → Crear Proyecto (Borrador/Publicar) → Validación Admin → Recibir Propuestas →
Seleccionar Experto → Configurar Escrow → Gestionar Hitos → Aprobar Entregas →
Completar Proyecto → Reseña

Paso 1: Registro y Configuración Inicial

1.1 Registro de Empresa

1. Accede a la página de registro: /registro

2. Completa el formulario:

   • Email (debe ser único, validación al salir del campo)
   • Username (debe ser único, mínimo 3 caracteres, solo letras, números, guiones y guiones bajos, no puede ser igual a la contraseña, validación al salir del campo)
   • Password (mínimo 8 caracteres, 1 mayúscula, 1 minúscula, 1 número, 1 carácter especial - requisitos visibles desde el principio, validación al salir del campo)
   • Confirmar contraseña (debe coincidir con la contraseña, validación al salir del campo)
   • Selecciona rol(es): Empresa (puedes seleccionar también Experto si quieres tener ambos roles)
   • Acepta términos y condiciones (obligatorio)

   Nota sobre validación: Todos los campos validan automáticamente al salir del campo (onBlur), mostrando mensajes de error específicos. Los requisitos de contraseña se muestran siempre debajo del campo de contraseña.

3. Confirma tu email (si está habilitado)

4. Inicia sesión con tus credenciales

Nota sobre Multi-Rol: Puedes seleccionar tanto Empresa como Experto durante el registro. Esto te dará acceso a ambos dashboards y funcionalidades. Cada rol tiene su propio perfil independiente.

1.2 Crear Perfil de Empresa

Primera vez que accedes al dashboard:

1. Ve a tu dashboard: /dashboard/empresa
2. Completa tu perfil:
   • Información básica de la empresa
   • Descripción de necesidades
   • Industria y sector
   • Datos fiscales (CIF y País obligatorios para crear proyectos)
3. Guarda el perfil

⚠️ Requisitos para crear proyectos:

1. Email verificado: Debes verificar tu dirección de email antes de crear proyectos. Revisa tu bandeja de entrada y haz clic en el enlace de verificación.
2. Perfil completo: Debes completar tu perfil de empresa con toda la información requerida.
3. Perfil verificado: Tu perfil debe estar verificado por el equipo de Floutic (normalmente toma 24-48 horas).
4. Datos fiscales completos: Necesitas tener datos fiscales completos (CIF y País obligatorios) para crear tu primer proyecto. Si intentas crear un proyecto sin datos fiscales completos, se mostrará un modal bloqueante solicitándolos.

Paso 2: Crear un Proyecto

Floutic ofrece tres tipos de contratación. Elige el que mejor se adapte a tu situación:

Tipo 1: Proyecto Privado (Conoces al Experto)

Cuándo usar: Ya conoces al experto o tienes una relación previa.

Pasos:

1. Navega al perfil del experto: /expertos/[id] o /perfil/experto/[id]
2. Haz clic en "Solicitar Presupuesto"
3. Completa el formulario (datos del experto ya están pre-rellenados):
   • Título del proyecto: Describe brevemente qué necesitas
   • Descripción: Detalla tus necesidades y objetivos
   • Categoría: Selecciona la categoría más apropiada
   • Skills requeridas: Selecciona las habilidades necesarias
   • Presupuesto estimado: Rango de presupuesto
   • Fecha límite: Cuándo necesitas el proyecto completado (opcional, debe ser igual o posterior a hoy)
4. Envía la solicitud: Al enviar, el proyecto se crea automáticamente como pendiente de publicación (pending_publication) y se envía a validación administrativa.
5. El sistema te redirigirá automáticamente a tu dashboard tras el éxito.

Tipo 2: Proyecto Curado (Sin Experto Específico)

Cuándo usar: No conoces expertos o quieres comparar varias opciones.

Pasos:

1. Ve a tu dashboard: /dashboard/empresa
2. Haz clic en "Crear Proyecto" o ve a /publicar-proyecto
3. Completa el formulario:
   • Título del proyecto
   • Descripción detallada: Explica claramente qué necesitas
   • Categoría y skills: Ayuda a los admins a encontrar expertos adecuados
   • Presupuesto estimado
   • Fecha límite: (opcional) Debe ser igual o posterior a la fecha actual
   • Hitos sugeridos (opcional): Puedes sugerir hitos que te gustaría tener
4. Elige una opción de envío:
   • 📤 Publicar Proyecto: El proyecto se envía directamente para validación administrativa (estado pending_publication). Se muestra un mensaje informando sobre la revisión previa.
   • ✏️ Guardar como borrador: El proyecto se guarda para seguir editándolo más tarde (estado draft). No es visible para los admins ni expertos todavía.
5. Tras el éxito, serás redirigido automáticamente a tu dashboard en 2 segundos.

Lo que pasa después:

• Un admin revisa tu proyecto
• El admin selecciona 3-5 expertos cualificados
• El proyecto se publica como curado (solo visible para expertos invitados)
• Los expertos invitados reciben notificación

Tipo 3: Contratación desde Marketplace

Cuándo usar: Estás explorando el marketplace y encuentras un experto interesante.

Pasos:

1. Navega el marketplace: /expertos o /marketplace
2. Filtra expertos por:
   • Skills
   • Nivel (Global/Pro/Enterprise)
   • Rating
   • Disponibilidad
3. Haz clic en un experto para ver su perfil completo
4. Haz clic en "Solicitar Presupuesto"
5. Completa el formulario (similar a Tipo 1)
6. Envía la solicitud

Paso 3: Validación Administrativa

Estado: pending_publication → published_private o published_curated

Qué esperar:

1. Notificación: Recibirás una notificación cuando el admin revise tu proyecto
2. Tiempo de espera: Normalmente 24-48 horas
3. Posibles resultados:
   • ✅ Aprobado: El proyecto se publica
   • ❌ Rechazado: Recibirás un motivo y podrás editar y reenviar
   • 📝 Solicitud de cambios: El admin puede pedir más información

Mientras esperas:

• Puedes editar el borrador desde tu dashboard (el formulario de edición es idéntico al de creación)
• Puedes cancelar el proyecto si cambias de opinión

Nota importante:

• El formulario de "Editar borrador" tiene la misma estructura, campos y validaciones que el formulario de "Publicar proyecto"
• Las habilidades requeridas son opcionales en ambos formularios
• Todos los campos tienen las mismas etiquetas y notas aclaratorias

Paso 4: Recibir Propuestas

Estado: bidding (recibiendo propuestas)

4.1 Ver Propuestas

1. Ve a tu dashboard: /dashboard/empresa
2. Haz clic en el proyecto que está recibiendo propuestas
3. Ve a la pestaña "Propuestas"

4.2 Comparar Propuestas

Cada propuesta incluye:

• Presupuesto propuesto: Precio total del proyecto
• Tiempo estimado: Cuánto tiempo tomará completar
• Hitos propuestos: Desglose del trabajo en hitos
• Mensaje del experto: Por qué es adecuado para el proyecto
• Rating del experto: Reputación y reseñas anteriores
• Experiencia relevante: Proyectos similares completados

Vista comparativa:

• Puedes ver todas las propuestas lado a lado
• Filtrar por presupuesto, tiempo o rating
• Ver detalles completos de cada experto

4.3 Seleccionar un Experto

1. Revisa todas las propuestas cuidadosamente
2. Haz clic en "Ver Perfil Completo" para más información
3. Haz clic en "Aceptar Propuesta" en la propuesta elegida
4. Confirma la selección

Estado cambia a: assigned (experto asignado)

Widget dinámico: Una vez seleccionado el experto, el widget de la barra lateral cambia de "Expertos Invitados" a "✓ Experto Asignado", mostrando:

• Nombre y avatar del experto seleccionado
• Badge "Seleccionado"
• Botones rápidos: "Ver perfil" e "Ir al chat"
• Estado del proyecto (Pendiente de pago / En progreso / Completado)

[!NOTE] Las propuestas de los demás expertos se rechazan automáticamente y cada uno recibe una notificación empática animándoles a seguir adelante.

Paso 5: Configurar Escrow (Pago Seguro)

Estado: assigned → in_progress

5.1 Configuración Inicial

Cuando aceptas una propuesta:

1. Se crea automáticamente un PaymentIntent en Stripe
2. El dinero se reserva en Escrow (no se cobra aún)
3. Estado del pago: pending (pendiente de captura)

5.2 Flujo de Pago Escrow

Cómo funciona:

1. Al aceptar propuesta: Se reserva el dinero (no se cobra)
2. Cuando experto completa hito: El dinero se mueve a held (retenido)
3. Al aprobar entrega: El dinero se captura y se transfiere al experto
4. Si rechazas entrega: El dinero vuelve a pending

Estados del pago:

• pending: Dinero reservado, esperando trabajo
• held: Dinero retenido, trabajo completado
• captured: Dinero transferido al experto
• refunded: Reembolsado (si cancelas proyecto)

Paso 6: Gestionar Hitos y Entregas

Estado: in_progress → in_review → completed

6.1 Ver Progreso del Proyecto

1. Ve al detalle del proyecto: /proyecto/[id]
2. Pestaña "Hitos": Ver timeline de hitos
3. Estado de cada hito:
   • ⏳ Pendiente: Aún no iniciado
   • 🔄 En Progreso: Experto trabajando
   • ✅ Completado: Entregado y aprobado
   • ❌ Rechazado: Necesita cambios

6.2 Aprobar Entregas

Cuando el experto sube una entrega:

1. Recibirás notificación de nueva entrega
2. Ve al proyecto → Pestaña "Hitos"
3. Haz clic en el hito con entrega pendiente
4. Revisa la entrega:
   • Descarga archivos
   • Revisa comentarios del experto
   • Verifica que cumple los requisitos
5. Toma una decisión:
   • ✅ Aprobar: El hito se marca como completado y el pago se procesa
   • ❌ Rechazar: Solicita cambios con comentarios específicos

Aprobar entrega:

• El hito cambia a completed
• El pago del hito se captura y transfiere al experto
• El experto puede continuar con el siguiente hito

Rechazar entrega:

• El hito vuelve a in_progress
• El experto recibe tus comentarios
• El experto puede subir una nueva versión

6.3 Comunicación con el Experto

Chat integrado:

1. Ve al proyecto → Pestaña "Chat"
2. Envía mensajes al experto
3. Sube archivos si necesitas compartir información (máximo 10MB por archivo)
4. Recibe notificaciones cuando el experto responde

Funcionalidades del chat:

Característica	Descripción
Indicador de actividad	Muestra cuándo fue la última vez que el otro usuario estuvo activo ("Activo hace 5 min", "Activo ayer", etc.)
Avatares con borde de color	🔵 Azul para empresas, 🟢 Verde para expertos - útil para identificar quién escribió cada mensaje
Drag & Drop de archivos	Arrastra archivos directamente al chat para subirlos
Confirmación al eliminar	Los mensajes propios se pueden eliminar con confirmación previa
Edición de mensajes	Puedes editar tus mensajes después de enviarlos
Límite de archivos	Máximo 10MB por archivo - se muestra error si se excede

Indicador de actividad:

• 🟢 Activo ahora: Actividad en los últimos 5 minutos
• 🟢 Activo hace X min: Actividad en la última hora
• 🟡 Activo hace Xh: Actividad en las últimas 24 horas
• ⚪ Activo ayer / hace X días: Actividad más antigua

Paso 7: Completar el Proyecto

Estado: in_progress → completed

7.1 Verificar Completitud

Todos los hitos deben estar completados:

1. Revisa el timeline de hitos
2. Verifica que todos están marcados como ✅ Completados
3. Confirma que estás satisfecho con el trabajo

7.2 Marcar como Completado

Opciones:

• Automático: Cuando todos los hitos están aprobados
• Manual: Puedes marcar el proyecto como completado desde el dashboard

Estado final: completed

Paso 8: Reseña y Reputación

Después de completar el proyecto:

8.1 Dejar Reseña al Experto

1. Ve al proyecto completado
2. Haz clic en "Dejar Reseña"
3. Completa el formulario:
   • Rating: 1-5 estrellas
   • Comentario: Opcional pero recomendado
4. Envía la reseña

Características:

• Puedes editar tu reseña en cualquier momento
• La reseña es visible públicamente en el perfil del experto
• Ayuda a otros usuarios a tomar decisiones

8.2 Recibir Reseña

El experto también puede dejarte una reseña:

• Aparecerá en tu perfil público
• Ayuda a construir tu reputación como empresa
• Otros expertos pueden ver tu historial

Flujo de Disputas (Si es Necesario)

Si hay problemas durante el proyecto:

Crear una Disputa

1. Ve al proyecto → Pestaña "Disputa"
2. Haz clic en "Crear Disputa"
3. Describe el problema:
   • Explica qué salió mal
   • Sube evidencia (capturas, archivos)
   • Especifica qué esperas como solución
4. Envía la disputa

Proceso de mediación:

1. Un admin revisa la disputa
2. El admin se comunica con ambas partes
3. Se busca una solución justa
4. El proyecto puede continuar o cancelarse según el caso

Resumen de Estados del Proyecto

Estado	Descripción	Tu Acción
draft	Borrador en edición (no enviado)	Editar o enviar para validación
pending_publication	Enviado y esperando validación admin	Esperar o editar
published_private / published_curated	Publicado	Esperar propuestas
bidding	Recibiendo propuestas	Revisar y seleccionar
assigned	Experto seleccionado	Configurar escrow
in_progress	En ejecución	Gestionar hitos y comunicarte
in_review	En revisión	Aprobar o rechazar entregas
completed	Finalizado	Dejar reseña
disputed	En disputa	Participar en mediación

Consejos y Mejores Prácticas

Para Obtener Mejores Resultados

1. Sé específico en la descripción: Cuanta más información, mejores propuestas recibirás
2. Define hitos claros: Los hitos bien definidos facilitan el seguimiento
3. Comunícate regularmente: Usa el chat para mantener comunicación fluida
4. Revisa entregas cuidadosamente: Aprobar solo cuando estés satisfecho
5. Deja reseñas constructivas: Ayuda a la comunidad y al experto

Evitar Problemas

1. Completa tu perfil: Para poder facturar legalmente, necesitamos completar tus datos fiscales. El CIF y el País son necesarios antes de ser asignado a un proyecto.
2. Define presupuesto realista: Un presupuesto muy bajo puede no atraer buenos expertos
3. Sé claro en expectativas: Evita malentendidos comunicándote claramente
4. Revisa propuestas completamente: Compara todas las opciones antes de decidir
5. No canceles sin motivo: Las cancelaciones afectan tu reputación

Próximos Pasos

• Guía de Experto - Cómo aplicar a proyectos y gestionar hitos
• Guía de Admin - Cómo validar y curar proyectos
• Guía de Pagos - Detalles del sistema Escrow
• Guía de Reseñas - Sistema de reseñas bidireccional