# Horux Strategy Platform

Plataforma de Reportes Financieros automatizados a partir de balanzas de comprobación.

## Descripción

Sistema web que permite a empresas subir sus datos contables de múltiples sistemas (CONTPAQi, Aspel, SAP, Odoo, etc.) y obtener:
- Dashboard interactivo con métricas financieras
- Exportación a PDF profesional (32 páginas)
- Clasificación automática de cuentas
- Comparativos entre periodos
- Semáforos de rendimiento

## Stack Tecnológico

| Componente | Tecnología |
|------------|------------|
| Backend | Laravel 11 (API REST) |
| Frontend | React 18 + TypeScript + Vite |
| Autenticación | Laravel Sanctum |
| Base de datos | MySQL / PostgreSQL |
| Gráficas | Recharts |
| PDF | Browsershot (Puppeteer) |
| Estilos | Tailwind CSS |

## Estructura del Proyecto

```
horux-strategy-platform/
├── backend/           # Laravel 11 API
├── frontend/          # React + TypeScript
└── docs/
    └── plans/         # Documentación de diseño
```

## Instalación Rápida

### Backend

```bash
cd backend
composer install
cp .env.example .env
php artisan key:generate
# Configurar base de datos en .env
php artisan migrate --seed
php artisan serve
```

### Frontend

```bash
cd frontend
npm install
npm run dev
```

## Credenciales por defecto

- **Email**: admin@horux360.com
- **Password**: password

## Roles de Usuario

| Rol | Permisos |
|-----|----------|
| **Admin** | Acceso total, configuración global |
| **Analista** | Gestionar clientes, procesar balanzas |
| **Cliente** | Ver dashboard propio, descargar PDFs |
| **Empleado** | Permisos configurables por cliente |

## Sistemas Contables Soportados

- CONTPAQi (implementado)
- Aspel
- SAP
- Odoo
- Alegra
- Parser genérico (CSV/Excel)

## Métricas Calculadas

- **Márgenes**: Bruto, EBITDA, Operativo, Neto, NOPAT, OCF, FCF
- **Retorno**: ROIC, ROE, ROA, ROCE
- **Eficiencia**: Asset Turnover, Días Clientes/Proveedores/Inventario
- **Liquidez**: Current Ratio, Quick Ratio, Cash Ratio
- **Solvencia**: Net Debt/EBITDA, Interest Coverage, Debt Ratio
- **Gestión**: Revenue Growth, CapEx/Revenue, Tax Rate

## Documentación

Ver `docs/plans/` para:
- Diseño del sistema
- Plan de implementación

## Licencia

Propietario - Horux 360