# Horux Strategy Platform - Backend

API REST con Laravel 11 para la plataforma de reportes financieros.

## Requisitos

- PHP 8.2+
- Composer
- MySQL 8.0+ o PostgreSQL 14+
- Node.js 18+ (para Browsershot/PDF)

## Instalación

```bash
# Instalar dependencias
composer install

# Copiar configuración
cp .env.example .env

# Generar key
php artisan key:generate

# Configurar base de datos en .env
# DB_DATABASE=horux_strategy
# DB_USERNAME=root
# DB_PASSWORD=

# Ejecutar migraciones y seeders
php artisan migrate --seed

# Crear link storage
php artisan storage:link

# Iniciar servidor
php artisan serve
```

## Credenciales por defecto

- **Admin**: admin@horux360.com / password

## Endpoints principales

### Autenticación
- `POST /api/login` - Iniciar sesión
- `POST /api/logout` - Cerrar sesión
- `GET /api/user` - Usuario actual

### Clientes
- `GET /api/clientes` - Listar clientes
- `POST /api/clientes` - Crear cliente
- `GET /api/clientes/{id}` - Ver cliente
- `PUT /api/clientes/{id}` - Actualizar cliente
- `DELETE /api/clientes/{id}` - Eliminar cliente

### Balanzas
- `GET /api/clientes/{id}/balanzas` - Listar balanzas
- `POST /api/clientes/{id}/balanzas` - Subir balanza
- `GET /api/balanzas/{id}/cuentas` - Ver cuentas
- `PUT /api/balanzas/{id}/exclusiones` - Actualizar exclusiones

### Reportes
- `GET /api/clientes/{id}/reportes` - Listar reportes
- `POST /api/clientes/{id}/reportes` - Generar reporte
- `GET /api/reportes/{id}` - Ver reporte
- `GET /api/reportes/{id}/pdf` - Descargar PDF

### Administración (solo admin)
- `GET/POST/PUT/DELETE /api/admin/usuarios`
- `GET/POST/PUT/DELETE /api/admin/giros`
- `GET/POST/PUT/DELETE /api/admin/umbrales`
- `GET/POST/PUT/DELETE /api/admin/reglas-mapeo`

## Estructura de carpetas

```
app/
├── Http/Controllers/
│   ├── AuthController.php
│   ├── ClienteController.php
│   ├── BalanzaController.php
│   ├── CuentaController.php
│   ├── ReporteController.php
│   └── Admin/
├── Models/
├── Services/
│   ├── Parsers/
│   │   ├── ParserInterface.php
│   │   ├── ContpaqiParser.php
│   │   ├── GenericoParser.php
│   │   └── DetectorFormato.php
│   ├── ClasificadorCuentas.php
│   ├── CalculadorMetricas.php
│   └── GeneradorPdf.php
└── ...
```

## Agregar nuevo parser

1. Crear clase en `app/Services/Parsers/` implementando `ParserInterface`
2. Registrar en `DetectorFormato::__construct()`
3. Agregar reglas de mapeo en seeder

## Licencia

Propietario - Horux 360