calculadoralaboralmcpserver

劳动计算器-解决方案。净

📖 描述

该解决方案包含哥伦比亚工资计算的完整实现，使用MCP服务器从TypeScript实现迁移到C#。该项目包括哥伦比亚的所有劳工法规和一套完整的单元测试。

🏗️ 溶液结构

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)

⚡ 快速命令

编译整个解决方案

dotnet build CalculadoraLaboral.sln

执行所有测试

dotnet test CalculadoraLaboral.sln

仅运行MCP服务器

dotnet run --project calculadoraLaboral.McpServer

运行详细的测试

dotnet test calculadoraLaboral.Tests --verbosity detailed

🎯 功能实现

✅ 工资计算

• 工资：普通和全面的验证
• 运输援助：资格和自动计算
• Horas附加：17种不同类型和特定因素
• 社会福利：保费、失业、假期、利息损失
• 社会保障：健康，养老金，ARL，第1393号法律
• 副坐骨的CCF、ICBF、SENA免责声明

✅ 哥伦比亚法规

• 莱伊1393高非工资支付的基本社会保障调整
• 准税务豁免：对于收入\<10 SMLV
• 综合工资：具体福利=0
• 上限和限制：25 SMLV最大，最小验证

✅ Tipos de Horas附加内容

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

📊 测试覆盖率

• 66单元测试 已实施
• 60项测试通过 （成功率90.9%）
• 全面覆盖 在所有计算中
• 边缘案例 包括验证

测试类型

• 单位：每个服务单独
• 整合：完整的结算流程
• 验证：极限情况和错误
• 后悔：与TypeScript实现的比较

🚀 迁移差异

这个C#实现纠正了从TypeScript迁移时发现的以下差异：

1. ✅ 6种缺少加班 已添加
2. ✅ 莱伊1393 用于计算社会保障
3. ✅ 准检察官豁免 对于收入\<10 SMLV
4. ✅ 福利综合工资 更正（保费、失业、利息=0）
5. ✅ 夜间附加费因素 从1.35更正为0.35
6. ✅ 年度参数 更新至2026年

🔧 要求

• .NET 9.0 o上级
• x单位 用于测试
• Windows/Linux/macOS 兼容

📝 使用 MCP 服务器

MCP服务器通过JSON-RPC 2.0协议公开工资计算功能：

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "calcular_nomina",
    "arguments": {
      "salario_basico": 3000000,
      "tipo_salario": "Ordinario",
      "pagos_salariales": 500000,
      "pagos_no_salariales": 200000,
      "horas_extras": {},
      "auxilio_transporte": true,
      "vive_cerca": false,
      "clase_riesgo": "II"
    }
  }
}

🏆 项目状态

• ✅ Migración Completa：100%奇偶校验与TypeScript实现
• ✅ 实施的测试：广泛覆盖所有计算
• ✅ 法律遵守：所有实施的哥伦比亚法规
• ✅ 坚固的建筑：清洁和可维护的设计
• ✅ 准备生产：验证和测试

🤝 贡献

为该项目做出贡献：

1. 叉库
2. Crear全景特写(git checkout -b feature/nueva-funcionalidad)
3. 提交更改(git commit -am 'Agregar nueva funcionalidad')
4. 推拉拉马(git push origin feature/nueva-funcionalidad)
5. Crear Pull请求

📄 许可证

这个项目是在麻省理工学院的许可下进行的。查看文件 LICENSE 更多细节。

______________________________________________________________________

发展与❤️ 哥伦比亚工资的精确计算