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>
This commit is contained in:
2026-01-31 22:24:00 -06:00
commit 4c3dc94ff2
107 changed files with 10701 additions and 0 deletions

98
README.md Normal file
View File

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