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>
108 lines
2.5 KiB
Markdown
108 lines
2.5 KiB
Markdown
# Horux Strategy Platform - Backend
|
|
|
|
API REST con Laravel 11 para la plataforma de reportes financieros.
|
|
|
|
## Requisitos
|
|
|
|
- PHP 8.2+
|
|
- Composer
|
|
- MySQL 8.0+ o PostgreSQL 14+
|
|
- Node.js 18+ (para Browsershot/PDF)
|
|
|
|
## Instalación
|
|
|
|
```bash
|
|
# Instalar dependencias
|
|
composer install
|
|
|
|
# Copiar configuración
|
|
cp .env.example .env
|
|
|
|
# Generar key
|
|
php artisan key:generate
|
|
|
|
# Configurar base de datos en .env
|
|
# DB_DATABASE=horux_strategy
|
|
# DB_USERNAME=root
|
|
# DB_PASSWORD=
|
|
|
|
# Ejecutar migraciones y seeders
|
|
php artisan migrate --seed
|
|
|
|
# Crear link storage
|
|
php artisan storage:link
|
|
|
|
# Iniciar servidor
|
|
php artisan serve
|
|
```
|
|
|
|
## Credenciales por defecto
|
|
|
|
- **Admin**: admin@horux360.com / password
|
|
|
|
## Endpoints principales
|
|
|
|
### Autenticación
|
|
- `POST /api/login` - Iniciar sesión
|
|
- `POST /api/logout` - Cerrar sesión
|
|
- `GET /api/user` - Usuario actual
|
|
|
|
### Clientes
|
|
- `GET /api/clientes` - Listar clientes
|
|
- `POST /api/clientes` - Crear cliente
|
|
- `GET /api/clientes/{id}` - Ver cliente
|
|
- `PUT /api/clientes/{id}` - Actualizar cliente
|
|
- `DELETE /api/clientes/{id}` - Eliminar cliente
|
|
|
|
### Balanzas
|
|
- `GET /api/clientes/{id}/balanzas` - Listar balanzas
|
|
- `POST /api/clientes/{id}/balanzas` - Subir balanza
|
|
- `GET /api/balanzas/{id}/cuentas` - Ver cuentas
|
|
- `PUT /api/balanzas/{id}/exclusiones` - Actualizar exclusiones
|
|
|
|
### Reportes
|
|
- `GET /api/clientes/{id}/reportes` - Listar reportes
|
|
- `POST /api/clientes/{id}/reportes` - Generar reporte
|
|
- `GET /api/reportes/{id}` - Ver reporte
|
|
- `GET /api/reportes/{id}/pdf` - Descargar PDF
|
|
|
|
### Administración (solo admin)
|
|
- `GET/POST/PUT/DELETE /api/admin/usuarios`
|
|
- `GET/POST/PUT/DELETE /api/admin/giros`
|
|
- `GET/POST/PUT/DELETE /api/admin/umbrales`
|
|
- `GET/POST/PUT/DELETE /api/admin/reglas-mapeo`
|
|
|
|
## Estructura de carpetas
|
|
|
|
```
|
|
app/
|
|
├── Http/Controllers/
|
|
│ ├── AuthController.php
|
|
│ ├── ClienteController.php
|
|
│ ├── BalanzaController.php
|
|
│ ├── CuentaController.php
|
|
│ ├── ReporteController.php
|
|
│ └── Admin/
|
|
├── Models/
|
|
├── Services/
|
|
│ ├── Parsers/
|
|
│ │ ├── ParserInterface.php
|
|
│ │ ├── ContpaqiParser.php
|
|
│ │ ├── GenericoParser.php
|
|
│ │ └── DetectorFormato.php
|
|
│ ├── ClasificadorCuentas.php
|
|
│ ├── CalculadorMetricas.php
|
|
│ └── GeneradorPdf.php
|
|
└── ...
|
|
```
|
|
|
|
## Agregar nuevo parser
|
|
|
|
1. Crear clase en `app/Services/Parsers/` implementando `ParserInterface`
|
|
2. Registrar en `DetectorFormato::__construct()`
|
|
3. Agregar reglas de mapeo en seeder
|
|
|
|
## Licencia
|
|
|
|
Propietario - Horux 360
|