# CREATION_NOTES: lexikon/dsgvo

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

## Backup

- Manual snapshot: `docs/backups/blog-snapshots/2026-03-20-150713/` (validate-backup OK at scaffold time).

## Commands (publish pipeline)

- Scaffold: `php v2/scripts/blog/create-new-blog-post.php` (slug `dsgvo`, category `lexikon`, author Hady).
- Body: `php v2/scripts/blog/update-post-content.php --post=dsgvo --category=lexikon --html=docs/content/blog/posts/lexikon/dsgvo/content.html`
- SEO: `seo-meta.json` key `lexikon/dsgvo` → `php v2/scripts/blog/sync-meta-to-posts.php --post=dsgvo --category=lexikon`
- FAQs: `docs/content/blog/posts/lexikon/dsgvo/data/faq-answers-optimized.json` → `php v2/scripts/blog/add-faqs-to-post.php --post=dsgvo --category=lexikon --replace`
- Related carousels: `php v2/scripts/blog/add-new-post-to-related-carousels.php --post=dsgvo --category=lexikon --targets=revisionssicherheit,compliance,zeiterfassungssysteme,arbeitszeiterfassungsgesetz,personalakte-inhalt,stempeluhr,lohnabrechnung,betriebspruefung --write`
- Lead capture: `php v2/scripts/blog/generate-lead-capture-copy.php --post=dsgvo --category=lexikon --write` (after `_slugToBenefit` for `dsgvo`)
- LLM: `php v2/scripts/llms/sync-blog-posts-to-llms.php --add --post=dsgvo --category=lexikon` && `php v2/scripts/llms/sync-blog-posts-to-llms.php --update-counts`

## Redirects / canonical URL

- **2026-03-20:** Entfernt: `.htaccess`-Regel `^insights/lexikon/dsgvo/?$` → `/datenschutz` (301). Die Regel stammte aus der Zeit **ohne** Lexikon-Artikel und hat echte Aufrufe von `/insights/lexikon/dsgvo/` zur statischen Datenschutz-Seite umgeleitet. **Canonical** für den Beitrag ist jetzt der Blog-Post unter `/insights/lexikon/dsgvo/` (wie in `dsgvo.json`).

## Content review (2026-03-20)

- Ergänzt: **§§ 26 ff. BDSG** (Beschäftigtendatenschutz) kurz und neutral; **Art. 6 Abs. 1** als strukturierte Liste (lit. a–f); **Art. 12 Abs. 3** Auskunftsfrist (Monatspraxis + internes Ziel); **Art. 25 + 32** in einem Absatz (Privacy by Design + TOMs); **AV/Art. 28** mit konkreter Frage zu Unterauftragsverarbeiter-Kette; **sieben Grundsätze** mit je einem **HR-Beispiel**; Bewerbungsabsatz: **„Regle“** (du), VVT-Hinweis; Fazit-Satz gestrafft; redundanter Absatz nach Art.-6-Liste entfernt.
- Validierung: `validate-new-post`, `validate-content-flow`, `validate-internal-links-exist --strict`, `validate-section-depth` – OK.

## Cannibalization

- **revisionssicherheit** owns GoBD/Integrität/Nachvollziehbarkeit; **dsgvo** owns EU-Datenschutz im HR (Zwecke, Rechte, AV, TOMs). Explizite Verlinkung und Gegenüberstellungstabelle im Artikel.
- Geplanter Dachbegriff **datenschutz** (Inventory) → ggf. später Kurzverweis; aktuell ein Satz im Fließtext ohne toten Link.

## SERP / data quirks

- **SISTRIX search-intent** collection ended with “Credit limit reached” (tool); ggf. später erneut oder manuell aus SERP/Analytics.
- **PAA:** `paa-questions.json` (SISTRIX) enthielt **109** generische Einträge → **`data/paa-questions-manual.json`** mit 15 HR-/Arbeitgeber-Fragen (Validator: `validate-content-completeness.php` = COMPLETE). `competitive-depth-analysis.md` um **`### PAA`** ergänzt, damit „Content Gaps“ nicht den Rest der Datei einliest.
- **Interne Links:** Dienstplan-Pillar nur unter **`/insights/dienstplan/`** (nicht `/insights/lexikon/dienstplan/`).
- **Firecrawl** remediation für sparse Competitors: wie in Pipeline-Logs üblich teilweise fehlgeschlagen — Inhalt über Outline + HR-Expertise ausgebaut.

## Featured image

- `python3 v2/scripts/blog/generate-blog-featured-image.py --post=dsgvo --category=lexikon` → erfolgreich; Ausgabe u. a. `/insights/bilder/dsgvo-{640,1024,1280}w.webp`, PNG unter `v2/img/insights/dsgvo-featured.png`. Post-JSON (`featured_image`): `src` + `srcset`, **1280×720**, **alt** = Post-Titel. Bei Änderungen am Motiv: `IMAGE_PROMPT.md` anpassen und Skript erneut ausführen.

## add-faq-links.php

- **N/A:** FAQs liegen im Post-JSON (`faqs` array), Rendering über BlogFAQ-Komponente — keine separaten FAQ-Link-Injection nötig.

## Post-deploy (human)

- Google Rich Results Test (URL `https://www.ordio.com/insights/lexikon/dsgvo/`)
- Google Search Console: Indexierung / Prüfung auf Snippet

## Validators (run locally)

- `php v2/scripts/blog/validate-new-post.php --strict --post=dsgvo --category=lexikon`
- `php v2/scripts/blog/validate-content-flow.php --post=dsgvo --category=lexikon`
- `php v2/scripts/blog/validate-pillar-links.php --post=dsgvo --category=lexikon`
- `php v2/scripts/blog/validate-faq-quality.php --post=dsgvo --category=lexikon`
- `php v2/scripts/blog/validate-section-depth.php --post=dsgvo --category=lexikon`
- `php v2/scripts/blog/validate-internal-links-exist.php --post=dsgvo --category=lexikon --strict`
- `php v2/scripts/blog/validate-content-completeness.php --post=dsgvo --category=lexikon`
- `php v2/scripts/blog/compare-content-to-competitors.php --post=dsgvo --category=lexikon`