# Urlaubsrückstellung Lexikon Post – Creation Notes

**Last Updated:** 2026-03-20

## Key Decisions

### Content Differentiation

| Term | Scope |
|------|-------|
| **Urlaubsanspruch** | Arbeitsrecht – Anspruch auf bezahlte freie Tage (BUrlG) |
| **Resturlaub** | HR – konkret offene Tage inkl. Übertrag |
| **Urlaubsentgelt** | Lohn – Bemessung / Entgeltfortzahlung (§ 11 BUrlG) |
| **Urlaubsrückstellung** | Handelsbilanz – Rückstellung für noch nicht erfüllte Urlaubsverpflichtung (§ 249 HGB) |

### Comparison H2

Table H2 **Urlaubsrückstellung vs. Urlaubsanspruch vs. Resturlaub vs. Urlaubsentgelt** is the primary disambiguation for mixed SERP/PAA intent.

### Resource Mapping

- **Products:** `/payroll`, `/abwesenheiten`, `/arbeitszeiterfassung`, `/schichtplan`, `/dokumentenmanagement`, `/digitale-personalakte`
- **Pillars (related + in copy):** `/insights/zeiterfassung`, `/insights/dienstplan`
- **Tools:** `/tools/urlaubsanspruch-rechner`, `/tools/arbeitstage-rechner`, `/tools/zuschlagsrechner`, `/tools/elterngeldrechner`, `/tools/brutto-netto-rechner`

### `related_posts` (curated)

Order: pillars zeiterfassung + dienstplan, then **lohnbuchhaltung**, **urlaubsentgelt**, **urlaubsanspruch**, **resturlaub**, **lohnabrechnung**, **urlaubsplanung**, **abwesenheitsmanagement**, **arbeitsentgelt**, **fehlzeiten**.

Automated `suggest-related-posts.php --write` scored irrelevant lexikon slugs (slug has no hyphens → weak overlap); replaced with manual list.

### Carousel targets (`add-new-post-to-related-carousels.php --write`)

`lohnbuchhaltung`, `urlaubsentgelt`, `urlaubsanspruch`, `resturlaub`, `lohnabrechnung`, `urlaubsplanung`, `abwesenheitsmanagement`, `fehlzeiten`

### PAA / FAQs

- **validate-content-completeness:** PAA phrase *wie löse ich urlaubsrückstellungen auf?* needed keywords in body/FAQ; added dedicated FAQ (also in `faq-answers-optimized.json`).
- **Final FAQ count:** 15; FAQ quality EXCELLENT; FAQ schema OK.

### Competitor pipeline

DATEV row stayed thin after Firecrawl; SERP/competitor analysis leans on Haufe/NWB-style sources (documented in `SERP_ANALYSIS.md`).

### Copy fixes for validators

- **validate-content-flow:** Regex `Häufig.*?Fragen` false positives on *häufig … Feinfragen* and *bemessen* → *messe* in `blog-product-feature-mapping`. Reworded: *Würdigungsfragen* → *Bewertungs- und Abgrenzungsthemen*; *führt häufig zu* → *führt oft zu*; intro *bemessen* → *bewertet*; Bilanzstichtag *neu bemessen* → *neu bewertet*; *Sonderevents* → *Sonderfällen*.
- **Featured image alt:** `fix-featured-image-alt.php` → full colon title + `| Ordio`.

### Lead capture

Added `_slugToBenefit['urlaubsrueckstellung']` in `generate-lead-capture-copy.php`; pattern written to `v2/data/lead_capture_copy.php`.

### LLM manifest

`sync-blog-posts-to-llms.php --add`; `validate-llms-metadata.py --report` OK.

### Browser / Rich Results

| Check | Status (2026-03-20) |
|-------|---------------------|
| Local HTTP `GET /insights/lexikon/urlaubsrueckstellung/` | **200** – body includes main H2 (e.g. „Was ist eine Urlaubsrückstellung?“), table wrapper / structured content, JSON-LD present (`FAQPage` / `ld+json` markers in HTML) |
| Cursor browser MCP | Not available in agent session – use Chrome DevTools locally for layout/mobile |
| **https://www.ordio.com/insights/lexikon/urlaubsrueckstellung/** | Fetch **timed out** (likely not deployed yet) |

**After deploy:** run [Google Rich Results Test](https://search.google.com/test/rich-results) on the **canonical** live URL; confirm FAQPage + Article (and no critical errors). Re-test if FAQ count or `content.html` changes.

### Next steps (human / deploy)

1. Commit: post JSON, `seo-meta.json`, `llms*.txt`, `lead_capture_copy.php`, `generate-lead-capture-copy.php`, sibling carousel JSON updates, docs under `docs/content/blog/posts/lexikon/urlaubsrueckstellung/`, checklist line in `LEXIKON_NEW_POST_CHECKLIST.md`.
2. Deploy to environment that serves `v2/data/blog/posts`.
3. Rich Results Test + spot-check FAQs carousel on **mobile** width.
4. FAQ one-off file `data/faq-paa-aufloesung.json` was **removed** after merge into `faq-answers-optimized.json`; source of truth for edits: that file + `add-faqs-to-post.php` / post `faqs`.

### Snapshot backup

Blog snapshot: `docs/backups/blog-snapshots/2026-03-20-053950`

### Content revision (2026-03-20, quality pass)

- **§ 249 HGB / BUrlG:** Removed oversimplified „sechs Monate / wirtschaftlich reif“-Erklärung; replaced with **ungewisse Verbindlichkeit**, **verdienter Anspruch**, **durchsetzbare Tage** + Link **Urlaubsanspruch**.
- **Depth:** Teilzeit/Stundenkonten-Absatz; Praxishinweis Individual vs. Durchschnitt; **Rollforward**-Absatz; erweiterte Checkliste (HR/Lohn-Delta, fristgerechte Payroll-Änderungen).
- **Ordio / Produkte:** Intro verlinkt **Abwesenheiten** + **Payroll**; Ordio-Absatz präzisiert Datenfluss ohne Bilanzberatung.
- **Wortzahl:** ~1,819 (Ziel 1,700); `compare-content-to-competitors.php` PASS.
- **Validator trap:** „häufig in Stunden“ vermieden (`Häufig.*?Fragen`-Regex); stattdessen „typischerweise“.