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:
98
README.md
Normal file
98
README.md
Normal 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
|
||||
Reference in New Issue
Block a user