# Kurzarbeitergeld-Rechner — documentation

**Tool slug:** `kurzarbeitergeld-rechner`  
**URL:** https://www.ordio.com/tools/kurzarbeitergeld-rechner

## Purpose

Employee-facing calculator: **Netto-Soll** vs **Netto-Ist** (Brutto normal vs Brutto Kurzarbeit), then **Kurzarbeitergeld (ca.)** at 60 % or 67 % of the net difference, with caps. Net payroll logic is shared with the Brutto-Netto-Rechner via [`v2/js/shared/german-monthly-net-from-gross.js`](../../../../v2/js/shared/german-monthly-net-from-gross.js).

## Last research run — 2026-04-01 (SEO skyscraper sprint)

Artifacts in `docs/content/tools/kurzarbeitergeld-rechner/`:

| Artifact | Notes |
|----------|--------|
| `data/keywords-sistrix.json` | Live SISTRIX collection |
| `data/paa-questions.json` | 15 PAA questions |
| `data/competitor-analysis.json` | 10 SERP URLs analyzed |
| `data/competitive-depth-analysis.md` | Includes **editorial target 2.400** Wörter (Cap statt Video-verzerrtem Mittel) |
| `data/gsc-queries.json` | 0 Zeilen (pre-baseline, Route ohne Impressionen) |
| `SERP_ANALYSIS.md` | Intent-Mix, Meta-Hypothesen, GSC-Hinweis |
| `CONTENT_OUTLINE.md` | 14 Skyscraper-Themen für Validator |
| `DATA_DRIVEN_SYNTHESIS.md` | Nach Sprint regeneriert (`generate-tool-data-synthesis.php`) |

**Validators (lokal):** `validate-tool-improvement-readiness.php`, `validate-tool-content-completeness.php`, `audit-tools-content-blocks.py` (mit `--paa` / `--outline`), `verify-faq-jsonld-parity.php --all-tools`, `audit-tools-faq-schema-status.php`, `node scripts/validate-schema-jsonld.js` auf gerendertes HTML.

## Improvement pipeline (content / SEO)

```bash
php v2/scripts/tools/run-tools-improvement-pipeline.php --tool=kurzarbeitergeld-rechner
```

Per-phase scripts live under `v2/scripts/tools/` (keywords, PAA, competitor analysis, outline, etc.). Outputs: `docs/content/tools/kurzarbeitergeld-rechner/data/` and markdown synthesis files.

## Blog ↔ Tool (optional)

Für kontextuelle Lexikon-/Ratgeber-Links zum Thema Kurzarbeit siehe  
[`docs/content/blog/DIENSTPLAN_ZEITERFASSUNG_CLUSTER_TOPIC_UNIVERSE.md`](../../blog/DIENSTPLAN_ZEITERFASSUNG_CLUSTER_TOPIC_UNIVERSE.md) — keine automatische Synchronisation; redaktionell einpflegen.

## Annual update checklist (high burden tool)

- [ ] **Beitragsbemessungsgrenzen** (RV/AV, KV/PV) — align with Brutto-Netto-Rechner / official sources.
- [ ] **KUG Leistungssätze** (60 % / 67 %) — confirm unchanged or updated in SGB III / BMAS guidance.
- [ ] **Maximum Kurzarbeitergeld** (monthly caps) — verify against current Bundesagentur für Arbeit table / PDF.
- [ ] **KUG “Soll” cap** at BBG for reference net — confirm interpretation with official text.
- [ ] Update `v2/js/kurzarbeitergeld/constants.js` source comments + year.
- [ ] Update shared payroll module if tax/SV constants change.
- [ ] Re-run `npm run minify` after JS edits.

## Related internal links

See `docs/data/tools-internal-link-mapping.json` → `kurzarbeitergeld-rechner` (inkl. `/schichtplan`, Midijob-Rechner).

## Cursor rule

`.cursor/rules/tools-pages-kurzarbeitergeld-calculator.mdc` — sources, sprint follow-up, maintenance notes.

## Next steps (after merge / deploy)

### Phase 1 — Direkt nach Deploy (Tag 0–1)

1. **HTTP 200:** `https://www.ordio.com/tools/kurzarbeitergeld-rechner` im Browser und in Search Console „URL-Prüfung“ testen.
2. **Rich Results:** [Google Rich Results Test](https://search.google.com/test/rich-results) mit der Production-URL (WebPage, HowTo, FAQPage, BreadcrumbList, SoftwareApplication).
3. **Lokaler Schema-Check (CI/Release):**  
   `cd v2/pages && php tools_kurzarbeitergeld_rechner.php > /tmp/kug.html`  
   `node scripts/validate-schema-jsonld.js /tmp/kug.html`

### Phase 2 — Social & Assets (Woche 1)

4. **OG-Bild:** Headline live „Kurzarbeitergeld **berechnen** 2026“ — bei visueller Diskrepanz `v2/scripts/og-images/generate-og-image-gemini.py` für Slug `kurzarbeitergeld-rechner` ausführen, WebP nach `v2/img/og/` legen, `v2/config/og-image-registry.php` unverändert lassen sofern Pfad gleich; bei Bedarf `make og-audit` bzw. projektübliches OG-Audit ([NEW_PAGE_OG_AND_SOCIAL_CHECKLIST.md](../../../systems/og-images/NEW_PAGE_OG_AND_SOCIAL_CHECKLIST.md)).

### Phase 3 — Daten & Iteration (Woche 4–8)

5. **GSC Queries:** `php v2/scripts/tools/collect-tool-gsc-queries.php --tool=kurzarbeitergeld-rechner` → `data/gsc-queries.json`; bei Datenlage `generate-tool-data-synthesis.php` erneut fahren und `SERP_ANALYSIS.md` / Title-Varianten B oder C testen ([PAGE_IMPROVEMENT_DATA_PLAYBOOK.md](../../PAGE_IMPROVEMENT_DATA_PLAYBOOK.md)).
6. **Optional GA4:** Aggregates wie in [DATA_COLLECTION_TOOLS.md](../DATA_COLLECTION_TOOLS.md) refreshen, wenn die URL in der Property erfasst wird.

### Laufend

7. **Internal links:** Nach Mapping-Änderungen `php v2/scripts/tools/audit-tools-internal-links.php`.
8. **Content-QA:** `php v2/scripts/tools/validate-tool-content-completeness.php --tool=kurzarbeitergeld-rechner` nach größeren Copy-Änderungen.