Calculadora Laboral - Solución .NET

📖 Descripción

Esta solución contiene una implementación completa de cálculos de nómina para Colombia, migrada desde una implementación TypeScript a C# con MCP Server. El proyecto incluye todas las regulaciones laborales colombianas y un conjunto completo de pruebas unitarias.

🏗️ Estructura de la Solución

CalculadoraLaboral.sln
├── calculadoraLaboral.McpServer/     # Proyecto principal (MCP Server)
│   ├── src/
│   │   ├── Domain/
│   │   │   ├── Constants/            # Parámetros anuales y tarifas
│   │   │   ├── Models/               # Modelos de datos y enums
│   │   │   └── Services/             # Lógica de negocio de cálculos
│   │   ├── Infrastructure/           # Infraestructura JSON-RPC
│   │   ├── Tools/                    # Handlers de herramientas MCP
│   │   ├── McpServer.cs             # Servidor MCP principal
│   │   └── Program.cs               # Punto de entrada
│   └── calculadoraLaboral.McpServer.csproj
├── calculadoraLaboral.Tests/        # Proyecto de pruebas unitarias
│   ├── TiposHorasExtraTests.cs      # Pruebas tipos de horas extras
│   ├── PrestacionesSocialesTests.cs # Pruebas prestaciones sociales
│   ├── SeguridadSocialTests.cs      # Pruebas seguridad social y Ley 1393
│   ├── ExoneracionParafiscalesTests.cs # Pruebas exoneración parafiscales
│   ├── IntegracionTests.cs          # Pruebas de integración completas
│   └── calculadoraLaboral.Tests.csproj
└── Bitakora.Calculadoras/           # Implementación TypeScript original (referencia)

⚡ Comandos Rápidos

Compilar toda la solución

dotnet build CalculadoraLaboral.sln

Ejecutar todas las pruebas

dotnet test CalculadoraLaboral.sln

Ejecutar solo el MCP Server

dotnet run --project calculadoraLaboral.McpServer

Ejecutar pruebas con detalles

dotnet test calculadoraLaboral.Tests --verbosity detailed

🎯 Funcionalidades Implementadas

✅ Cálculos de Nómina

• Salarios: Ordinario e Integral con validaciones
• Auxilio de Transporte: Elegibilidad y cálculo automático
• Horas Extras: 17 tipos diferentes con factores específicos
• Prestaciones Sociales: Prima, Cesantías, Vacaciones, Interés Cesantías
• Seguridad Social: Salud, Pensión, ARL con Ley 1393
• Parafiscales: CCF, ICBF, SENA con exoneración

✅ Regulaciones Colombianas

• Ley 1393: Ajuste base seguridad social para altos pagos no salariales
• Exoneración Parafiscales: Para ingresos < 10 SMLV
• Salario Integral: Prestaciones específicas = 0
• Topes y Límites: 25 SMLV máximo, validaciones mínimas

✅ Tipos de Horas Extras Completos

HED    (1.25)  // Hora extra diurna
HEN    (1.75)  // Hora extra nocturna  
HEFD   (2.05)  // Hora extra festiva diurna
HEFN   (2.55)  // Hora extra festiva nocturna
RN     (0.35)  // Recargo nocturno
RDD    (0.80)  // Recargo dominical diurno ocasional compensado
RDN    (1.15)  // Recargo dominical nocturno ocasional compensado
RDDHC  (1.8)   // Recargo dominical diurno habitual compensado
RDNHC  (2.15)  // Recargo dominical nocturno habitual compensado
RDDONC (1.8)   // Recargo dominical diurno ocasional no compensado
RDNONC (2.15)  // Recargo dominical nocturno ocasional no compensado

📊 Cobertura de Pruebas

• 66 pruebas unitarias implementadas
• 60 pruebas pasando (90.9% éxito)
• Cobertura completa de todos los cálculos
• Casos edge y validaciones incluidas

Tipos de Pruebas

• Unitarias: Cada servicio individualmente
• Integración: Flujos completos de liquidación
• Validación: Casos límite y errores
• Regresión: Comparación con implementación TypeScript

🚀 Diferencias Migradas

Esta implementación C# corrige las siguientes diferencias encontradas en la migración desde TypeScript:

1. ✅ 6 tipos de horas extras faltantes agregados
2. ✅ Ley 1393 implementada para cálculo seguridad social
3. ✅ Exoneración parafiscales para ingresos <

... View full README on GitHub