Initial commit: Horux Strategy Platform

- Laravel 11 backend with API REST
- React 18 + TypeScript + Vite frontend
- Multi-parser architecture for accounting systems (CONTPAQi, Aspel, SAP)
- 27+ financial metrics calculation
- PDF report generation with Browsershot
- Complete documentation (10 documents)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

docs/01-descripcion-general.md

@@ -0,0 +1,86 @@
+# 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 |