Sk 09 Financial Calculations

2) Reportes financieros (dashboard/reportes)

Fuente de verdad: src/services/reporte.service.ts.

• Para reportes, se usan “movimientos ejecutados”:
  • ESTADOS_EJECUTADOS = ['APROBADO', 'PAGADO']
• Esto representa:
  • APROBADO: comprometido/ejecutado a nivel financiero (aunque no esté pagado)
  • PAGADO: ejecutado y pagado

Fórmula de saldo (conceptual)

Saldo calculado (según contexto)

Se deriva de:

• saldoInicial
• • ingresos (según estado aplicable)
• • traspasos entrada (según estado aplicable)
• • egresos (según estado aplicable)
• • traspasos salida (según estado aplicable)

Donde “estado aplicable” depende del contexto:

• Arqueo: solo PAGADO
• Reportes: APROBADO + PAGADO

Estado de arqueo

• SIN_SALDO_REAL si no hay saldo real
• CUADRADO si diferencia <= tolerancia (0.01)
• SOBRANTE si saldoReal > saldoCalculado
• FALTANTE si saldoReal < saldoCalculado

Aprobación automática por categoría

Fuente: src/services/movimiento.service.ts + tests tests/categorias/aprobacion-automatica.test.ts.

• Si una categoría tiene requiereAprobacion=false: el movimiento puede pasar a APROBADO al crear (si no está efectuado).
• Si requiereAprobacion=true y montoMaxSinAprobacion está definido:
  • Si monto <= montoMaxSinAprobacion → APROBADO
  • Si monto > montoMaxSinAprobacion → PENDIENTE

Cuentas globales y compartidas (multi-negocio)

Fuente: schema cuentasBanco.esGlobal + tabla cuentaNegocio.

• esGlobal=true: cuenta visible para cualquier negocio.
• esGlobal=false: cuenta visible si:
  • cuentasBanco.negocioId coincide, o
  • existe cuentaNegocio(cuentaId, negocioId) (cuenta compartida).

Traspasos

• Siempre crear 2 movimientos en una transacción:
  • TRASPASO_SALIDA (origen)
  • TRASPASO_ENTRADA (destino)
• Ambos vinculados por self-reference (traspasoRefId)