Saltar al contenido principal

Inicio Rápido

Esta guía te ayudará a poner en marcha Floutic rápidamente.

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

# Reconstruir imágenes antes de iniciar
./start-dev.sh --rebuild

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

# Ejecutar tests del backend
./test-dev.sh

# Detener todo
./stop-dev.sh

Windows​

Opción 1: Usando PowerShell (recomendado)

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

# Detener todo
.\stop-dev.ps1

Opción 2: Usando los scripts .bat (doble clic)

  • Doble clic en start-dev.bat para iniciar
  • Doble clic en stop-dev.bat para detener

Desarrollo Manual​

Si prefieres gestionar los contenedores directamente:

# Levantar todos los servicios
docker compose up -d

# Mostrar logs en tiempo real
docker compose logs -f backend
docker compose logs -f frontend

# Detener todo
docker compose down

Servicios Disponibles​

Una vez iniciado el entorno, tendrás acceso a:

ServicioURLDescripción
Frontendhttp://localhost:3000Interfaz de usuario
BackendInternoAPI REST (expuesta en el dominio configurado)
API Docshttps://api.haorp.es/docsSwagger UI
Health Checkdocker compose exec backend curl http://localhost:8000/healthEstado del backend

Verificar que Todo Funciona​

# Verificar estado de servicios
./status-dev.sh

# Verificar backend
docker compose exec backend curl http://localhost:8000/health

# Verificar frontend
curl http://localhost:3000

Próximos Pasos​

  1. Lee la Guía de Instalación para configuración detallada
  2. Revisa la Guía de Desarrollo para empezar a desarrollar
  3. Consulta la Documentación del Backend para entender la API
  4. Explora la Documentación del Frontend para el frontend

Usuarios de Prueba​

Para cargar usuarios de prueba:

# Cargar todos los usuarios de prueba
docker compose exec backend python clean_and_seed.py --scenario full

Credenciales de Acceso​

Admin​

  • Username: admin
  • Contraseña: AdminFloutic2024!

Expertos​

  • Todos los expertos tienen la contraseña: Expert123!
  • Ejemplos: carlos_mendez, ana_lopez, rsanchez_n8n

Empresas​

  • Todas las empresas tienen la contraseña: Company123!
  • Ejemplos: tienda_online, marketing_solutions, logistica_pro

Troubleshooting​

Problemas Comunes​

Los servicios no inician:

  • Verifica que Docker esté ejecutándose
  • Revisa los logs: docker compose logs
  • Asegúrate de que los puertos no estén en uso

Error de conexión a la base de datos:

  • Verifica que PostgreSQL esté saludable: docker compose ps postgres
  • Revisa las variables de entorno en .env

Frontend no carga:

  • Verifica que el backend esté saludable primero
  • Revisa los logs del frontend: docker compose logs frontend

Para más ayuda, consulta la Guía de Troubleshooting.