Saltar al contenido principal

Bienvenido a Floutic

Floutic es el marketplace especializado en automatización de procesos para pymes. Conectamos empresas españolas con expertos verificados en n8n, Make, Zapier y Airtable.

🎯 ¿Qué es Floutic?​

Floutic es una plataforma completa que facilita la contratación de expertos en automatización mediante un sistema de proyectos curados con validación administrativa. La plataforma incluye:

  • Sistema de proyectos con tres tipos de contratación (privada, curada y desde perfil)
  • Pagos Escrow con Stripe Connect para garantizar transacciones seguras
  • Chat interno para comunicación entre empresas y expertos
  • Sistema de reseñas bidireccional para construir reputación
  • Panel de administración completo con dashboard Kanban
  • Integración con GoHighLevel para gestión de CRM
  • Sistema de hitos secuenciales para entregas y pagos parciales

🚀 Inicio Rápido​

Requisitos Previos​

  • Docker Desktop (incluye Docker y Docker Compose)
  • curl (instalado por defecto en macOS/Linux/WSL)
  • Opcional: Node.js 20.19.5+ y Python 3.11+ si deseas ejecutar servicios fuera de Docker

Inicio Rápido con Scripts​

Linux/WSL/macOS​

# Iniciar todo el entorno de desarrollo
./start-dev.sh

# Ver estado de los servicios
./status-dev.sh

# Ejecutar tests
./test-dev.sh

# Detener todo
./stop-dev.sh

Windows​

# Iniciar todo el entorno de desarrollo
.\start-dev.ps1

# Detener todo
.\stop-dev.ps1

Servicios Disponibles​

ServicioURLDescripción
Frontendhttp://localhost:3000Interfaz de usuario
BackendInternoAPI REST (expuesta en el dominio configurado)
API Docshttps://api.haorp.es/docsSwagger UI
Documentaciónhttps://doc.haorp.esEsta documentación

🛠️ Stack Tecnológico​

Backend​

  • FastAPI - Framework web Python moderno y rápido
  • PostgreSQL - Base de datos relacional
  • SQLAlchemy - ORM con soporte async
  • Redis - Cache y sesiones
  • Stripe - Procesamiento de pagos
  • GoHighLevel - CRM integrado

Frontend​

  • Astro - Framework SSR
  • React - Componentes interactivos
  • Tailwind CSS - Estilos
  • shadcn/ui - Componentes UI accesibles
  • Zustand - Gestión de estado
  • Playwright - Testing E2E

📚 Estructura de la Documentación​

Esta documentación está organizada en las siguientes secciones:

🎯 Características Principales​

✅ Sistema de Autenticación y Perfiles​

  • Autenticación JWT segura con refresh tokens en HttpOnly cookies
  • Sistema de session_id único por ventana
  • Cookies con SameSite=Strict para máximo aislamiento
  • Perfiles unificados de empresa y experto
  • Sistema de verificación de perfiles por admin

✅ Marketplace y Proyectos​

  • Marketplace de proyectos con filtros avanzados
  • Sistema de hitos secuenciales con entregas y revisiones
  • Sistema de propuestas con selección de expertos
  • Sistema de invitaciones de expertos a proyectos
  • URLs públicas SEO friendly para expertos

✅ Dashboards Optimizados​

  • Dashboard de empresa - Gestión completa de proyectos
  • Dashboard de experto - Interfaz con pestañas organizadas
  • Dashboard admin Kanban - Vista unificada con 6 columnas

✅ Sistema de Comunicación​

  • Chat interno completo con archivos, edición y moderación
  • Notificaciones en tiempo real vía WebSocket
  • Centro de notificaciones con filtros y reconexión manual
  • Webhooks externos por usuario para integración con n8n

✅ Pagos y Escrow​

  • Pagos escrow con Stripe Connect
  • Primer pago automático al seleccionar experto
  • Liberación en cascada con payout automatizado
  • Sincronización automática de estados de pago

🧪 Testing​

Floutic incluye una suite completa de tests:

  • Backend: 781+ tests pasando (incluyendo 63 tests de GHL v2.2)
  • Frontend: 507 tests unitarios pasando + 31 tests E2E de seguridad
  • Cobertura completa de funcionalidades críticas

🔒 Seguridad​

Floutic implementa un sistema de seguridad completo:

  • Autenticación JWT segura con HttpOnly cookies
  • Protección CSRF con tokens
  • Rate limiting multi-nivel
  • Security headers completos (HSTS, CSP, etc.)
  • Input validation y protección XSS
  • RBAC completo
  • RGPD compliance

Ver la sección de Seguridad para más detalles.

📖 Próximos Pasos​

  1. Lee la Guía de Inicio Rápido
  2. Revisa la Documentación del Backend
  3. Explora la Documentación del Frontend
  4. Consulta las Guías de Despliegue

🤝 Contribución​

¿Quieres contribuir? Revisa nuestra documentación de desarrollo y testing para empezar.

📞 Soporte​

¡Bienvenido a Floutic! 🎉