Files
horux-strategy-platform/docs/01-descripcion-general.md
Torch2196 4c3dc94ff2 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>
2026-01-31 22:24:00 -06:00

2.6 KiB

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