精准计算肯尼亚2024/2025年度工资税，涵盖PAYE累进税率、SHIF医保(2.75%)、NSSF养老金及住房税(1.5%)，自动适配税率更新。
说明：
## 核心功能与用法
`kenya-tax-rates` 是一个专为肯尼亚薪资场景设计的 Node.js 计算库，提供从毛薪到净薪的完整链条计算。核心入口包括 `calculatePayroll()` 返回完整薪资拆解（应税收入、各项扣除、雇主缴纳部分），以及 `getNetSalary()` 快速获取净薪数字。支持模块化调用单项计算器：PAYE（5档累进10%-35%）、SHIF（2.75%无上限，最低KES 300）、NSSF（自动识别2024/2025两档上限）、住房税（1.5%）。
## 显著优点
– **时效性强**：内置2024年10月SHIF取代NHIF、2025年2月NSSF新上限等最新政策，通过日期参数自动切换税率版本，避免手动更新。
– **计算粒度完整**：不仅计算员工扣除项，同时返回雇主缴纳的NSSF和住房税，满足双向对账需求。
– **税务优化支持**：内置个人减免（KES 2,400/月）、保险减免（保费15%上限KES 5,000）及养老金扣除（上限KES 30,000），可合法降低应税基数。
– **TypeScript友好**：提供完整类型定义，IDE 自动补全降低配置错误。
## 潜在局限与风险
– **地域单一**：仅适配肯尼亚税法，跨境多辖区场景需额外集成。
– **依赖政策同步**：虽自动切换版本，但若肯尼亚政府临时调整税率（如年中修订），需等待库作者更新 npm 包。
– **边缘场景覆盖**：未明确说明年终奖、离职补偿金等特殊收入的税务处理；外币薪资汇率转换需调用方预处理。
– **精度风险**：金融计算涉及浮点数，文档未说明是否采用整数分（cents）精确运算，高薪资场景建议审计验证。
## 适合人群
– 肯尼亚本地企业 HR/财务系统的开发者
– 跨境支付平台（如 Deel、Remote）需集成肯尼亚薪资模块的工程师
– 为肯尼亚雇员提供薪资计算工具的自雇人士或会计师
## 常规风险提示
– **合规依赖**：开源库非官方 KRA（肯尼亚税务局）产品，关键计算结果建议与 KRA iTax 系统交叉校验。
– **数据隐私**：处理真实员工薪资时，注意 Node.js 运行环境的日志脱敏，避免将 `grossSalary` 等敏感字段输出到未加密日志。
– **版本锁定**：生产环境建议锁定具体 npm 版本，防止自动升级引入未预期的税率变更。
