workspace-v1/projects/erp-construccion/docs/02-definicion-modulos/MAE-014-finanzas-controlling/README.md
rckrdmrd 66161b1566 feat: Workspace-v1 complete migration with NEXUS v3.4
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
2026-01-04 03:37:42 -06:00

2.3 KiB

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)

@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)

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