Sistema NEXUS v3.4 migrado con: Estructura principal: - core/orchestration: Sistema SIMCO + CAPVED (27 directivas, 28 perfiles) - core/catalog: Catalogo de funcionalidades reutilizables - shared/knowledge-base: Base de conocimiento compartida - devtools/scripts: Herramientas de desarrollo - control-plane/registries: Control de servicios y CI/CD - orchestration/: Configuracion de orquestacion de agentes Proyectos incluidos (11): - gamilit (submodule -> GitHub) - trading-platform (OrbiquanTIA) - erp-suite con 5 verticales: - erp-core, construccion, vidrio-templado - mecanicas-diesel, retail, clinicas - betting-analytics - inmobiliaria-analytics - platform_marketing_content - pos-micro, erp-basico Configuracion: - .gitignore completo para Node.js/Python/Docker - gamilit como submodule (git@github.com:rckrdmrd/gamilit-workspace.git) - Sistema de puertos estandarizado (3005-3199) Generated with NEXUS v3.4 Migration System EPIC-010: Configuracion Git y Repositorios
84 lines
2.3 KiB
Markdown
84 lines
2.3 KiB
Markdown
# MAE-014: Finanzas y Controlling
|
|
|
|
**Módulo:** Gestión Financiera y Control de Gestión
|
|
**Story Points:** 55 | **Prioridad:** Alta | **Fase:** 2 (Enterprise)
|
|
|
|
## Descripción General
|
|
|
|
Sistema integral para gestión financiera de proyectos de construcción, incluyendo flujo de efectivo, cuentas por cobrar/pagar, conciliación bancaria, y control de gestión con KPIs financieros.
|
|
|
|
## Alcance Funcional
|
|
|
|
### 1. Flujo de Efectivo (Cash Flow)
|
|
- Proyección de ingresos y egresos
|
|
- Flujo real vs proyectado
|
|
- Alertas de liquidez
|
|
- Escenarios what-if
|
|
|
|
### 2. Cuentas por Cobrar (CxC)
|
|
- Facturación a clientes
|
|
- Antigüedad de saldos
|
|
- Gestión de cobranza
|
|
- Conciliación de pagos
|
|
|
|
### 3. Cuentas por Pagar (CxP)
|
|
- Registro de facturas de proveedores
|
|
- Programación de pagos
|
|
- Antigüedad de saldos
|
|
- Control de vencimientos
|
|
|
|
### 4. Conciliación Bancaria
|
|
- Importación de estados de cuenta
|
|
- Match automático de movimientos
|
|
- Partidas en conciliación
|
|
- Reportes de conciliación
|
|
|
|
### 5. Control de Gestión
|
|
- Dashboard financiero ejecutivo
|
|
- KPIs por proyecto y empresa
|
|
- Análisis de rentabilidad
|
|
- Presupuesto vs real
|
|
|
|
## Componentes Técnicos
|
|
|
|
### Backend (NestJS + TypeORM)
|
|
```typescript
|
|
@Module({
|
|
imports: [TypeOrmModule.forFeature([
|
|
CashFlow, Invoice, Payment, BankStatement,
|
|
Receivable, Payable, BankReconciliation
|
|
])],
|
|
providers: [
|
|
CashFlowService, InvoiceService, PaymentService,
|
|
BankReconciliationService, ControllingService
|
|
],
|
|
controllers: [FinanceController, ControllingController]
|
|
})
|
|
export class FinanceModule {}
|
|
```
|
|
|
|
### Base de Datos (PostgreSQL)
|
|
```sql
|
|
CREATE SCHEMA finance;
|
|
|
|
CREATE TYPE finance.transaction_type AS ENUM ('income', 'expense');
|
|
CREATE TYPE finance.payment_status AS ENUM ('pending', 'partial', 'paid', 'overdue');
|
|
CREATE TYPE finance.reconciliation_status AS ENUM ('pending', 'matched', 'exception');
|
|
```
|
|
|
|
## Integraciones
|
|
|
|
- **MAI-008 (Estimaciones):** Generación automática de CxC desde estimaciones
|
|
- **MAI-004 (Compras):** Registro automático de CxP desde órdenes de compra
|
|
- **MAI-012 (Contratos):** Montos contratados para proyecciones
|
|
|
|
## Métricas Clave
|
|
|
|
- **Liquidez:** Días de cobertura de efectivo
|
|
- **DSO:** Days Sales Outstanding (días de cobranza)
|
|
- **DPO:** Days Payable Outstanding (días de pago)
|
|
- **Rentabilidad:** Margen por proyecto
|
|
|
|
---
|
|
**Generado:** 2025-11-21
|