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

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