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>
170 lines
9.0 KiB
Markdown
170 lines
9.0 KiB
Markdown
# 2. Arquitectura del Sistema
|
|
|
|
## Diagrama de Componentes
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────┐
|
|
│ FRONTEND (React) │
|
|
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
|
|
│ │ Login │ │Clientes │ │Dashboard│ │ Admin │ │ PdfView │ │
|
|
│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │
|
|
│ └───────────┴───────────┴───────────┴───────────┘ │
|
|
│ │ │
|
|
│ ┌─────────┴─────────┐ │
|
|
│ │ API Service │ │
|
|
│ │ (Axios) │ │
|
|
│ └─────────┬─────────┘ │
|
|
└──────────────────────────────┼──────────────────────────────────┘
|
|
│ HTTP/REST
|
|
▼
|
|
┌──────────────────────────────┴──────────────────────────────────┐
|
|
│ BACKEND (Laravel) │
|
|
│ ┌─────────────────────────────────────────────────────────┐ │
|
|
│ │ Controllers │ │
|
|
│ │ Auth │ Cliente │ Balanza │ Cuenta │ Reporte │ Admin │ │
|
|
│ └───────────────────────────┬─────────────────────────────┘ │
|
|
│ │ │
|
|
│ ┌───────────────────────────┴─────────────────────────────┐ │
|
|
│ │ Services │ │
|
|
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
|
|
│ │ │ Parsers │ │ Clasificador │ │ Calculador │ │ │
|
|
│ │ │ - CONTPAQi │ │ Cuentas │ │ Métricas │ │ │
|
|
│ │ │ - Genérico │ │ │ │ │ │ │
|
|
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
|
|
│ │ ┌──────────────┐ │ │
|
|
│ │ │ Generador │ │ │
|
|
│ │ │ PDF │ │ │
|
|
│ │ └──────────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────────┘ │
|
|
│ │ │
|
|
│ ┌───────────────────────────┴─────────────────────────────┐ │
|
|
│ │ Models │ │
|
|
│ │ User │ Cliente │ Balanza │ Cuenta │ Reporte │ etc. │ │
|
|
│ └───────────────────────────┬─────────────────────────────┘ │
|
|
└──────────────────────────────┼──────────────────────────────────┘
|
|
│
|
|
▼
|
|
┌──────────────────┐
|
|
│ Database │
|
|
│ MySQL/PostgreSQL│
|
|
└──────────────────┘
|
|
```
|
|
|
|
## Estructura de Directorios
|
|
|
|
```
|
|
horux-strategy-platform/
|
|
├── backend/ # Laravel 11 API
|
|
│ ├── app/
|
|
│ │ ├── Http/
|
|
│ │ │ ├── Controllers/
|
|
│ │ │ │ ├── AuthController.php
|
|
│ │ │ │ ├── ClienteController.php
|
|
│ │ │ │ ├── BalanzaController.php
|
|
│ │ │ │ ├── CuentaController.php
|
|
│ │ │ │ ├── ReporteController.php
|
|
│ │ │ │ └── Admin/
|
|
│ │ │ │ ├── UsuarioController.php
|
|
│ │ │ │ ├── GiroController.php
|
|
│ │ │ │ ├── UmbralController.php
|
|
│ │ │ │ └── ReglaMapeeoController.php
|
|
│ │ │ └── Middleware/
|
|
│ │ │ └── RoleMiddleware.php
|
|
│ │ ├── Models/
|
|
│ │ │ ├── User.php
|
|
│ │ │ ├── Cliente.php
|
|
│ │ │ ├── Giro.php
|
|
│ │ │ ├── Balanza.php
|
|
│ │ │ ├── Cuenta.php
|
|
│ │ │ ├── Reporte.php
|
|
│ │ │ ├── ReporteContable.php
|
|
│ │ │ ├── CategoriaContable.php
|
|
│ │ │ ├── Umbral.php
|
|
│ │ │ ├── ReglaMapeo.php
|
|
│ │ │ ├── MapeoCuenta.php
|
|
│ │ │ └── PermisoEmpleado.php
|
|
│ │ └── Services/
|
|
│ │ ├── Parsers/
|
|
│ │ │ ├── ParserInterface.php
|
|
│ │ │ ├── DetectorFormato.php
|
|
│ │ │ ├── ContpaqiParser.php
|
|
│ │ │ └── GenericoParser.php
|
|
│ │ ├── ClasificadorCuentas.php
|
|
│ │ ├── CalculadorMetricas.php
|
|
│ │ └── GeneradorPdf.php
|
|
│ ├── database/
|
|
│ │ ├── migrations/
|
|
│ │ └── seeders/
|
|
│ ├── routes/
|
|
│ │ └── api.php
|
|
│ └── config/
|
|
│
|
|
├── frontend/ # React + TypeScript
|
|
│ ├── src/
|
|
│ │ ├── components/
|
|
│ │ │ ├── charts/
|
|
│ │ │ │ ├── BarChart.tsx
|
|
│ │ │ │ └── LineChart.tsx
|
|
│ │ │ ├── cards/
|
|
│ │ │ │ ├── KPICard.tsx
|
|
│ │ │ │ └── MetricTable.tsx
|
|
│ │ │ ├── forms/
|
|
│ │ │ │ ├── ClienteForm.tsx
|
|
│ │ │ │ ├── UploadBalanza.tsx
|
|
│ │ │ │ └── GenerarReporte.tsx
|
|
│ │ │ └── layout/
|
|
│ │ │ ├── Layout.tsx
|
|
│ │ │ ├── Sidebar.tsx
|
|
│ │ │ └── Header.tsx
|
|
│ │ ├── pages/
|
|
│ │ │ ├── Login.tsx
|
|
│ │ │ ├── Clientes/
|
|
│ │ │ ├── Dashboard/
|
|
│ │ │ ├── PdfView/
|
|
│ │ │ └── Admin/
|
|
│ │ ├── context/
|
|
│ │ │ └── AuthContext.tsx
|
|
│ │ ├── services/
|
|
│ │ │ └── api.ts
|
|
│ │ ├── types/
|
|
│ │ │ └── index.ts
|
|
│ │ └── hooks/
|
|
│ └── public/
|
|
│
|
|
└── docs/ # Documentación
|
|
└── plans/
|
|
```
|
|
|
|
## Flujo de Datos
|
|
|
|
### Subida de Balanza
|
|
```
|
|
1. Usuario sube archivo (PDF/Excel/CSV)
|
|
2. DetectorFormato identifica sistema origen
|
|
3. Parser específico extrae datos
|
|
4. ClasificadorCuentas aplica reglas de mapeo
|
|
5. Cuentas se guardan en BD con clasificación
|
|
6. Cuentas con anomalías se marcan para revisión
|
|
```
|
|
|
|
### Generación de Reporte
|
|
```
|
|
1. Usuario selecciona balanzas a incluir
|
|
2. CalculadorMetricas procesa datos
|
|
3. Se calculan estados financieros
|
|
4. Se calculan 27+ métricas
|
|
5. Se evalúan umbrales para semáforos
|
|
6. Se guardan resultados en JSON
|
|
7. Dashboard muestra resultados
|
|
```
|
|
|
|
### Exportación PDF
|
|
```
|
|
1. Usuario solicita PDF
|
|
2. GeneradorPdf prepara URL con token
|
|
3. Browsershot renderiza PdfView de React
|
|
4. Se genera PDF de 32 páginas
|
|
5. Se guarda en storage
|
|
6. Se descarga al usuario
|
|
```
|