# 1. Descripción General

## ¿Qué es Horux Strategy?

Horux Strategy es una plataforma web para generar reportes financieros automatizados a partir de balanzas de comprobación. 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 contables
- Comparativos entre periodos
- Semáforos de rendimiento (indicadores de salud financiera)

## Características Principales

### Para Analistas
- Gestión de múltiples clientes
- Subida y procesamiento de balanzas de comprobación
- Revisión y corrección de anomalías contables
- Generación de reportes financieros
- Exportación a PDF

### Para Clientes
- Dashboard personalizado de su empresa
- Descarga de reportes en PDF
- Gestión de empleados y permisos

### Para Administradores
- Gestión completa de usuarios
- Configuración de umbrales por industria
- Reglas de mapeo contable por sistema
- Catálogo de giros de negocio

## Stack Tecnológico

| Componente | Tecnología |
|------------|------------|
| Backend | Laravel 11 (PHP 8.2+) |
| Frontend | React 18 + TypeScript |
| Build Tool | Vite |
| Base de Datos | MySQL / PostgreSQL |
| Autenticación | Laravel Sanctum (tokens) |
| Gráficas | Recharts |
| Estilos | Tailwind CSS |
| PDF | Browsershot (Puppeteer) |
| Parsing PDF | spatie/pdf-to-text |
| Excel | PhpSpreadsheet |

## Flujo de Trabajo

```
1. Crear Cliente
   └── Nombre, logo, giro, moneda

2. Subir Balanzas (2+ archivos)
   └── PDF, Excel o CSV de diferentes periodos

3. Detección Automática
   └── Sistema identifica origen (CONTPAQi, Aspel, etc.)

4. Clasificación Automática
   └── Mapeo a categorías contables

5. Revisión de Anomalías
   └── Corregir cuentas mal clasificadas

6. Limpieza de Cuentas
   └── Excluir cuentas de estrategia fiscal

7. Generación de Reporte
   └── Cálculo de 27+ métricas

8. Dashboard Interactivo
   └── Visualización de resultados

9. Exportar PDF
   └── Reporte profesional de 32 páginas
```

## Roles de Usuario

| Rol | Descripción | Permisos |
|-----|-------------|----------|
| **Admin** | Superusuario del sistema | Acceso total, configuración global, gestión de umbrales |
| **Analista** | Operador de la plataforma | Gestionar clientes asignados, procesar balanzas, generar reportes |
| **Cliente** | Usuario empresarial | Ver dashboard propio, descargar PDFs, gestionar empleados |
| **Empleado** | Colaborador del cliente | Permisos configurables por el cliente |