ccnl-engine 0.1.0__py3-none-any.whl

ccnl_engine/__init__.py

@@ -0,0 +1 @@
+"""ccnl_engine package."""

ccnl_engine/contracts/__init__.py

@@ -0,0 +1 @@
+"""CCNL contract data and loaders."""

ccnl_engine/contracts/data/__init__.py

@@ -0,0 +1 @@
+"""Bundled CCNL contract JSON data files."""

ccnl_engine/contracts/data/acconciatura-estetica-confartigianato.json

@@ -0,0 +1,412 @@
+{
+  "schema_version": "0.3",
+  "meta": {
+    "id": "acconciatura-estetica-confartigianato",
+    "name": "CCNL Acconciatura ed Estetica — Confartigianato/CNA",
+    "cnel_code": "H515",
+    "sector": "acconciatura ed estetica",
+    "tax_sector": "artigianato",
+    "signatories": [
+      "Confartigianato Benessere-Acconciatori",
+      "CNA Unione Benessere e Sanità",
+      "Casartigiani",
+      "CLAAI",
+      "FILCAMS-CGIL",
+      "FISASCAT-CISL",
+      "UILTUCS-UIL"
+    ],
+    "sources": [
+      {
+        "url": "https://www.confartigianatomarcatrevigiana.it/wp-content/uploads/2024/09/ccnl-benessere-app.prof-fino-30.9.24.pdf",
+        "type": "official_contract",
+        "agreement_date": "2024-05-20"
+      },
+      {
+        "url": "https://www.studiomion.it/tabelle-retributive/tabelle-retributive-acconciatura-estetica/",
+        "type": "table",
+        "agreement_date": "2024-05-20"
+      },
+      {
+        "url": "https://www.ilccnl.it/contratto/acconciatura-estetica/",
+        "type": "table",
+        "agreement_date": null
+      }
+    ],
+    "extraction": {
+      "method": "manual",
+      "model": null,
+      "timestamp": "2026-09-02T00:00:00",
+      "human_reviewed": true
+    }
+  },
+  "coverage": {
+    "layer_1": "implemented",
+    "layer_2": "implemented",
+    "notes": [
+      "INFO: SALARY MODEL: conglobated (minimi tabellari conglobati — contingenza and EDR fully absorbed). Back-calculation: May 2024 L3=1379.00/173=7.97 EUR/h; L2=1454.58/173=8.41 EUR/h; L1=1592.29/173=9.20 EUR/h — consistent divisor confirms conglobated model (lexplain.it + ilccnl.it).",
+      "INFO: TRANCHE DATES: four tranches — 2024-05-01 (retroactive, renewal signed 20 May 2024), 2025-01-01, 2026-01-01, 2026-10-01. Source: studiomion.it salary tables; cross-checked ilccnl.it for Jan 2026 values.",
+      "INFO: HOURLY DIVISOR: 173, derived from 40-hour work week (Art. 12 CCNL). Formula: 40 h/week × 52/12 = 173.33, rounded to 173 per contract usage. Confirmed: 1379.00/7.97=173.0 (L3 May 2024).",
+      "INFO: ADDITIONAL MONTHS: 13 (tredicesima only). Source: ilccnl.it Art. 40; informaimpresa.it ('tredici mensilità' explicitly stated as basis for Responsabile Tecnico allowance calculation).",
+      "INFO: SENIORITY: biennale (every 24 months), maximum 5 scatti. Per-level amounts: L1=9.30, L2=8.26, L3=7.75, L4=7.23 EUR/scatto. Source: ilccnl.it (current database), cross-checked CISL 2013 PDF (amounts unchanged by 2024 renewal, which only introduced a 6 EUR apprentice-specific scatto).",
+      "INFO: APPRENTICESHIP Gruppo 1 (acconciatori, estetisti, tricologi, tatuatori → destination level 3, max 5 years), track 'gruppo_1'. Primary source: Confartigianato Marca Trevigiana PDF (ccnl-benessere-app.prof-fino-30.9.24.pdf) for the pre-Oct-2024 table; post-Oct-2024 update (filcams.cgil.it + fisascat.it) raised months 1-12 from 65% to 70%, making months 1-18 uniformly 70%. Modelled table: 0-18=70%, 18-24=78%, 24-36=85%, 36-48=90%, 48-54=95%, 54+=100%.",
+      "SIMPLIFICATION: APPRENTICESHIP Gruppo 2 (manicure/pedicure → level 3, max 18 months, 70%/80%/100%), track 'gruppo_2': the three percentages are mapped to 6-month periods (0-6, 6-12, 12-18). Select with Apprentice(track='gruppo_2'); without a track name level 3 is ambiguous.",
+      "SIMPLIFICATION: APPRENTICESHIP DURATION (TAB.3): the 6-month reduction for post-secondary qualification holders (Gruppo 1: 54 months instead of 60) is not modelled; the standard 60-month table applies.",
+      "INFO: APPRENTICE SENIORITY: apprentice-specific scatto of 6 EUR (Art. 25 of the 2024 renewal, from 2024-10-01) modelled as seniority_increments.apprentice_amount.",
+      "INFO: RESPONSABILE TECNICO: 100 EUR x 13 mensilità for workers designated Responsabile Tecnico at level 1 or 2, modelled as a role-scoped allowance (role 'responsabile_tecnico').",
+      "INFO: PRE-MAY-2024 SALARY: the final tranche of the 2022 renewal (from 2023-02-01: L1=1511.46, L2=1380.74, L3=1309.00, L4=1234.19) is modelled; earlier periods are not.",
+      "INFO: INPS: reuses 2026-artigianato.json (ARTIGIANATO sector).",
+      "INFO: APPRENTICESHIP Gruppo 3 (impiegati amministrativi, destination level 2, 3 anni / 6 semestri): 70/70/70/78/85/85 per semester. Source: consulenza.it circolare acconciatura 2024; lexplain.it tabella apprendistato acconciatori (medium-high confidence: two concordant secondary sources; primary accordo tables not online)."
+    ]
+  },
+  "parameters": {
+    "hourly_divisor": {
+      "periods": [
+        {
+          "valid_from": "2023-02-01",
+          "valid_until": null,
+          "value": "173"
+        }
+      ]
+    },
+    "additional_months": {
+      "periods": [
+        {
+          "valid_from": "2023-02-01",
+          "valid_until": null,
+          "value": "13"
+        }
+      ]
+    },
+    "seniority_increments": {
+      "cadence_months": 24,
+      "maximum_count": 5,
+      "amount_by_level": {
+        "4": {
+          "periods": [
+            {
+              "valid_from": "2023-02-01",
+              "valid_until": null,
+              "value": "7.23"
+            }
+          ]
+        },
+        "3": {
+          "periods": [
+            {
+              "valid_from": "2023-02-01",
+              "valid_until": null,
+              "value": "7.75"
+            }
+          ]
+        },
+        "2": {
+          "periods": [
+            {
+              "valid_from": "2023-02-01",
+              "valid_until": null,
+              "value": "8.26"
+            }
+          ]
+        },
+        "1": {
+          "periods": [
+            {
+              "valid_from": "2023-02-01",
+              "valid_until": null,
+              "value": "9.30"
+            }
+          ]
+        }
+      },
+      "apprentice_amount": {
+        "periods": [
+          {
+            "valid_from": "2024-10-01",
+            "valid_until": null,
+            "value": "6.00"
+          }
+        ]
+      }
+    }
+  },
+  "levels": [
+    {
+      "code": "4",
+      "order": 1,
+      "description": "Level 4 — auxiliary worker / entry-level apprentice",
+      "base_salary": {
+        "periods": [
+          {
+            "valid_from": "2023-02-01",
+            "valid_until": "2024-05-01",
+            "value": "1234.19"
+          },
+          {
+            "valid_from": "2024-05-01",
+            "valid_until": "2025-01-01",
+            "value": "1300.19"
+          },
+          {
+            "valid_from": "2025-01-01",
+            "valid_until": "2026-01-01",
+            "value": "1347.33"
+          },
+          {
+            "valid_from": "2026-01-01",
+            "valid_until": "2026-10-01",
+            "value": "1387.87"
+          },
+          {
+            "valid_from": "2026-10-01",
+            "valid_until": null,
+            "value": "1406.73"
+          }
+        ]
+      },
+      "fixed_allowances": [],
+      "category": "operaio"
+    },
+    {
+      "code": "3",
+      "order": 2,
+      "description": "Level 3 — qualified worker (hairdresser/beautician)",
+      "base_salary": {
+        "periods": [
+          {
+            "valid_from": "2023-02-01",
+            "valid_until": "2024-05-01",
+            "value": "1309.00"
+          },
+          {
+            "valid_from": "2024-05-01",
+            "valid_until": "2025-01-01",
+            "value": "1379.00"
+          },
+          {
+            "valid_from": "2025-01-01",
+            "valid_until": "2026-01-01",
+            "value": "1429.00"
+          },
+          {
+            "valid_from": "2026-01-01",
+            "valid_until": "2026-10-01",
+            "value": "1472.00"
+          },
+          {
+            "valid_from": "2026-10-01",
+            "valid_until": null,
+            "value": "1492.00"
+          }
+        ]
+      },
+      "fixed_allowances": [],
+      "category": "operaio"
+    },
+    {
+      "code": "2",
+      "order": 3,
+      "description": "Level 2 — specialist worker / technical supervisor",
+      "base_salary": {
+        "periods": [
+          {
+            "valid_from": "2023-02-01",
+            "valid_until": "2024-05-01",
+            "value": "1380.74"
+          },
+          {
+            "valid_from": "2024-05-01",
+            "valid_until": "2025-01-01",
+            "value": "1454.58"
+          },
+          {
+            "valid_from": "2025-01-01",
+            "valid_until": "2026-01-01",
+            "value": "1507.32"
+          },
+          {
+            "valid_from": "2026-01-01",
+            "valid_until": "2026-10-01",
+            "value": "1552.68"
+          },
+          {
+            "valid_from": "2026-10-01",
+            "valid_until": null,
+            "value": "1573.78"
+          }
+        ]
+      },
+      "fixed_allowances": [
+        {
+          "code": "RESPONSABILE_TECNICO",
+          "description": "Technical Supervisor Allowance (employer designation), 100 EUR x 13 monthly payments",
+          "monthly": {
+            "periods": [
+              {
+                "valid_from": "2023-02-01",
+                "valid_until": null,
+                "value": "100.00"
+              }
+            ]
+          },
+          "role": "responsabile_tecnico"
+        }
+      ],
+      "category": "operaio"
+    },
+    {
+      "code": "1",
+      "order": 4,
+      "description": "Level 1 — technical director / senior supervisor",
+      "base_salary": {
+        "periods": [
+          {
+            "valid_from": "2023-02-01",
+            "valid_until": "2024-05-01",
+            "value": "1511.46"
+          },
+          {
+            "valid_from": "2024-05-01",
+            "valid_until": "2025-01-01",
+            "value": "1592.29"
+          },
+          {
+            "valid_from": "2025-01-01",
+            "valid_until": "2026-01-01",
+            "value": "1650.02"
+          },
+          {
+            "valid_from": "2026-01-01",
+            "valid_until": "2026-10-01",
+            "value": "1699.67"
+          },
+          {
+            "valid_from": "2026-10-01",
+            "valid_until": null,
+            "value": "1722.76"
+          }
+        ]
+      },
+      "fixed_allowances": [
+        {
+          "code": "RESPONSABILE_TECNICO",
+          "description": "Technical Supervisor Allowance (employer designation), 100 EUR x 13 monthly payments",
+          "monthly": {
+            "periods": [
+              {
+                "valid_from": "2023-02-01",
+                "valid_until": null,
+                "value": "100.00"
+              }
+            ]
+          },
+          "role": "responsabile_tecnico"
+        }
+      ],
+      "category": "impiegato"
+    }
+  ],
+  "apprenticeship": [
+    {
+      "type": "percentage",
+      "name": "gruppo_1",
+      "destination_levels": [
+        "3"
+      ],
+      "periods": [
+        {
+          "months_from": 0,
+          "months_until": 18,
+          "percentage": "0.70"
+        },
+        {
+          "months_from": 18,
+          "months_until": 24,
+          "percentage": "0.78"
+        },
+        {
+          "months_from": 24,
+          "months_until": 36,
+          "percentage": "0.85"
+        },
+        {
+          "months_from": 36,
+          "months_until": 48,
+          "percentage": "0.90"
+        },
+        {
+          "months_from": 48,
+          "months_until": 54,
+          "percentage": "0.95"
+        },
+        {
+          "months_from": 54,
+          "months_until": null,
+          "percentage": "1.00"
+        }
+      ]
+    },
+    {
+      "type": "percentage",
+      "name": "gruppo_2",
+      "destination_levels": [
+        "3"
+      ],
+      "periods": [
+        {
+          "months_from": 0,
+          "months_until": 6,
+          "percentage": "0.70"
+        },
+        {
+          "months_from": 6,
+          "months_until": 12,
+          "percentage": "0.80"
+        },
+        {
+          "months_from": 12,
+          "months_until": null,
+          "percentage": "1.00"
+        }
+      ]
+    },
+    {
+      "type": "percentage",
+      "name": "gruppo_3",
+      "destination_levels": [
+        "2"
+      ],
+      "periods": [
+        {
+          "months_from": 0,
+          "months_until": 6,
+          "percentage": "0.70"
+        },
+        {
+          "months_from": 6,
+          "months_until": 12,
+          "percentage": "0.70"
+        },
+        {
+          "months_from": 12,
+          "months_until": 18,
+          "percentage": "0.70"
+        },
+        {
+          "months_from": 18,
+          "months_until": 24,
+          "percentage": "0.78"
+        },
+        {
+          "months_from": 24,
+          "months_until": 30,
+          "percentage": "0.85"
+        },
+        {
+          "months_from": 30,
+          "months_until": null,
+          "percentage": "0.85"
+        }
+      ]
+    }
+  ]
+}