用途
Monaco Payslip Calculator 用于计算摩纳哥工资单（bulletin de salaire），包括毛工资（salaire brut）、雇主和雇员的社会保障缴款，以及净工资。它面向需要处理摩纳哥社会保障体系（Caisses Sociales de Monaco）缴款比例和上限的场景。
主要能力
- 计算标准雇员和家庭雇员（gens de maison）等类型的工资单。
- 按类别计算雇员缴款，主要类别包括：Maladie（健康保险）、Vieillesse（养老/退休）、Chômage（失业）、Accidents du travail（工伤）、Allocations familiales（家庭津贴）。
- 计算雇主缴款，并得出雇主总成本（毛工资 + 雇主缴款）。
- 输出完整工资单，包含雇员部分（毛工资、按类别列出的雇员缴款、税前净工资、应付净工资）、雇主部分（按类别列出的雇主缴款、雇主缴款总额、雇主总成本）以及汇总（社会保障缴款总额、实际比例）。
- 支持多种输出格式：JSON、文本、PDF 就绪。
- 包含验证和错误处理。
使用方式
技能会先收集所需信息，若用户未提供则询问：
必需：
- 毛月薪（salaire brut mensuel）
- 雇员类型：标准雇员、家庭雇员（gens de maison）或其他
- 雇佣状态：全职或兼职
可选但建议提供：
- 工作时长（兼职时）
- 特殊津贴或奖金
- 年中计算时的年初至今（YTD）金额
- 任何特定扣款或福利
随后依据 references/contribution_rates.md 中的参考数据确定雇主和雇员的社会保障缴款比例、适用的上限或阈值，以及适用的税率。
通过脚本执行计算：
python3 scripts/payslip_calculator.py \
--gross-salary <amount> \
--employee-type <type> \
--output-format <json|pdf|txt>
也可在回复中直接使用 Python 模块进行交互式计算：
# Read and execute the calculator script
exec(open('scripts/payslip_calculator.py').read())
# Create calculator instance
calculator = MonacoPayslipCalculator(
gross_salary=3500.00,
employee_type='standard'
)
# Calculate contributions
result = calculator.calculate()
# Display results
print(f"Gross Salary: €{result['gross_salary']:.2f}")
print(f"Employee Contributions: €{result['employee_total']:.2f}")
print(f"Net Salary: €{result['net_salary']:.2f}")
print(f"Employer Contributions: €{result['employer_total']:.2f}")
print(f"Total Employer Cost: €{result['total_cost']:.2f}")
计算完成后，以完整工资单形式呈现结果，并附简要说明：适用的缴款类别、使用的阈值或特殊计算、摩纳哥社会保障官方资源链接，以及用户如何在官方计算器上验证计算。
计算结构
标准缴款结构如下：
GROSS SALARY (Salaire Brut)
├─ Employee Contributions (Cotisations Salariales)
│ ├─ Health Insurance (Maladie)
│ ├─ Pension (Vieillesse)
│ ├─ Unemployment (Chômage)
│ └─ Other applicable contributions
└─ NET SALARY (Salaire Net)
Separately calculated:
EMPLOYER CONTRIBUTIONS (Cotisations Patronales)
├─ Health Insurance
├─ Pension
├─ Unemployment
├─ Work Accidents
├─ Family Allowances
└─ Other applicable contributions
TOTAL EMPLOYER COST = Gross Salary + Employer Contributions
适用场景
当用户提出以下需求时适用：
- 计算摩纳哥工资单或 bulletin de salaire
- 计算摩纳哥雇员的社会保障缴款
- 询问摩纳哥雇主成本或雇员净工资
- 了解摩纳哥工资计算的明细
- 提及 "Caisses Sociales" 或摩纳哥雇佣计算
资源
scripts/
- payslip_calculator.py：摩纳哥工资单主计算引擎，处理标准雇员和家庭雇员计算，支持多种输出格式（JSON、文本、PDF 就绪），包含验证和错误处理。
references/
- contribution_rates.md：当前摩纳哥社会保障缴款比例，包含按类别的雇主比例、按类别的雇员比例、阈值和上限、特殊情况与豁免、最后更新日期和官方来源。
assets/
- payslip_template.txt：格式化工资单输出的文本模板。
- example_payslips/：供参考的示例工资单计算。
数据来源
缴款比例和计算规则应依据以下来源核实：
- 摩纳哥社会保障官方 Caisses Sociales de Monaco 网站：https://www.caisses-sociales.mc/
- 摩纳哥雇主门户：https://employeur.caisses-sociales.mc/
- 摩纳哥官方立法和法令
注意：由于官方计算器 URL 返回访问错误，用户应手动核实当前缴款比例，并用准确数据更新 references/contribution_rates.md。
限制
- 该技能计算标准工资单要素。复杂情况（外派身份、特殊制度等）可能需要额外核实。
- 不包含税务计算，因为摩纳哥有基于国籍和居住身份的特殊税务规则。
- 关键计算应始终由摩纳哥官方机构或合格会计师核实。
- 缴款比例必须在参考文件中保持最新。
- 缴款比例会变动，应始终以 Caisses Sociales de Monaco 的最新比例为准。
- 部分缴款有最高工资上限（plafonds），缴款仅适用于一定金额以内。
- 家庭雇员（gens de maison）适用不同比例。
- 所有金额均以欧元（€）计。