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>
99 lines
2.2 KiB
Markdown
99 lines
2.2 KiB
Markdown
# 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
|