Skip to content
Documentación Jean d'Arc
GitHub

Schema de Remuneraciones

Este módulo gestiona el cálculo de remuneraciones, liquidaciones, leyes sociales e historial de pagos. Está diseñado bajo una arquitectura Master-Detail y fuertemente integrado con el plan contable.

Arquitectura General

Section titled “Arquitectura General”

El schema remuneraciones centraliza toda la lógica de nómina. Su núcleo es la relación entre la cabecera de la liquidación y sus detalles desglosados concepto por concepto.

Componentes Principales

Section titled “Componentes Principales”

1. Maestro de Empleados

Section titled “1. Maestro de Empleados”

Tabla empleados. Contiene la información contractual, personal y previsional. Es la base para cualquier cálculo.

2. Definición de Conceptos

Section titled “2. Definición de Conceptos”

Tabla conceptos_remuneracion. Catálogo maestro que define:

  • Qué es: Haber, Descuento, Aporte Patronal.
  • Cómo se calcula: Fórmula, Monto Fijo, Porcentaje.
  • Dónde se contabiliza: Cuentas de Gasto, Pasivo, etc.

3. Motor de Cálculo

Section titled “3. Motor de Cálculo”

Arquitectura Híbrida (TypeScript + PostgreSQL).

  1. Orchestrator: Calcula haberes y descuentos usando lógica de negocio en TypeScript (ver Motor de Cálculo).
  2. Repositorio: Obtiene contratos y asistencia de forma eficiente.
  3. Persistencia: Guarda el resultado final en liquidaciones y su detalle.

Flujo de Datos

Section titled “Flujo de Datos”
graph TD
    EMP[Empleados] --> CALC(Motor de Cálculo)
    CON[Conceptos] --> CALC
    NOV[Novedades/Asistencia] --> CALC
    
    CALC -->|Genera| LIQ[Liquidaciones Header]
    CALC -->|Desglosa| DET[Liquidaciones Detalle]
    
    DET -.->|Imputación| CONT[Contabilidad]

Ubicación del Código

Section titled “Ubicación del Código”

Todos los objetos de base de datos se encuentran en: Nostromo/db/accounting_template/remuneraciones/

  • Funciones (Lógica): /fx
  • Procedimientos (Orquestación): /sp

4. Procesos Mensuales

Section titled “4. Procesos Mensuales”

Una vez calculadas las liquidaciones, el sistema permite ejecutar procesos de consolidación: