Torch2196
4c3dc94ff2
- 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>
87 lines
2.6 KiB
Markdown
87 lines
2.6 KiB
Markdown
# 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 |
|