horux-strategy-platform/docs/03-instalacion.md

3. Instalación y Configuración

Requisitos del Sistema

Backend

• PHP 8.2 o superior
• Composer 2.x
• MySQL 8.0+ o PostgreSQL 14+
• Extensiones PHP: pdo_mysql, openssl, mbstring, fileinfo, gd

Frontend

• Node.js 18 o superior
• npm o yarn

Para generación de PDF

• Node.js (para Puppeteer)
• Chromium (se instala automáticamente)

---

Instalación en Windows

Opción 1: Usando Laragon (Recomendado)

1. Descargar Laragon

   • Visita https://laragon.org/download/
   • Descarga la versión "Full" (incluye PHP, MySQL, Composer)
   • Instala y ejecuta Laragon

2. Configurar el proyecto

   # Copia el proyecto a C:\laragon\www\horux-strategy-platform
   
   # Abre la terminal de Laragon (clic derecho > Terminal)
   cd horux-strategy-platform\backend
   composer install
   copy .env.example .env
   php artisan key:generate
   

3. Crear base de datos

   • En Laragon, clic en "Database" > "MySQL"
   • Crea una base de datos llamada horux_strategy

4. Ejecutar migraciones

   php artisan migrate --seed
   

5. Iniciar backend

   php artisan serve
   

6. Iniciar frontend (otra terminal)

   cd horux-strategy-platform\frontend
   npm install
   npm run dev
   

Opción 2: Instalación Manual

1. Instalar PHP

   • Descarga de https://windows.php.net/download/
   • Versión: VS16 x64 Thread Safe
   • Extrae en C:\php
   • Agrega C:\php al PATH del sistema
   • Copia php.ini-development a php.ini
   • Edita php.ini y habilita:

     extension=pdo_mysql
     extension=openssl
     extension=mbstring
     extension=fileinfo
     extension=gd
     

2. Instalar Composer

   • Descarga de https://getcomposer.org/download/
   • Ejecuta el instalador

3. Instalar MySQL

   • Descarga de https://dev.mysql.com/downloads/mysql/
   • Durante instalación, anota usuario y contraseña

4. Configurar proyecto (igual que Opción 1, pasos 2-6)

---

Instalación en Linux/Mac

# Clonar o copiar el proyecto
cd horux-strategy-platform

# Backend
cd backend
composer install
cp .env.example .env
php artisan key:generate

# Configurar .env con datos de MySQL
nano .env

# Migraciones
php artisan migrate --seed
php artisan serve

# Frontend (otra terminal)
cd ../frontend
npm install
npm run dev

---

Configuración del Archivo .env

# Aplicación
APP_NAME="Horux Strategy"
APP_ENV=local
APP_DEBUG=true
APP_URL=http://localhost:8000
FRONTEND_URL=http://localhost:5173

# Base de Datos
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=horux_strategy
DB_USERNAME=root
DB_PASSWORD=tu_password

# Sanctum (autenticación)
SANCTUM_STATEFUL_DOMAINS=localhost:5173,127.0.0.1:5173

---

Verificación de Instalación

Backend

# Verificar que el servidor responde
curl http://localhost:8000/api/giros
# Debe retornar lista de giros en JSON

Frontend

# Abrir en navegador
http://localhost:5173
# Debe mostrar página de login

Credenciales de Prueba

• Email: admin@horux360.com
• Password: password

---

Solución de Problemas

Error: "php" no es reconocido

• Verifica que PHP está en el PATH del sistema
• Reinicia la terminal

Error: SQLSTATE Connection refused

• Verifica que MySQL está corriendo
• Verifica credenciales en .env

Error: CORS

• Verifica FRONTEND_URL en .env
• Verifica config/cors.php

Error: 419 Page Expired

• Ejecuta php artisan config:clear
• Verifica SANCTUM_STATEFUL_DOMAINS

---

Despliegue en Producción

Backend

composer install --optimize-autoloader --no-dev
php artisan config:cache
php artisan route:cache
php artisan view:cache

Frontend

npm run build
# Servir carpeta dist/ con nginx/apache

Variables de Producción

APP_ENV=production
APP_DEBUG=false
FRONTEND_URL=https://tu-dominio.com