# Content Cluster Mapping

**Last Updated:** 2026-03-18  
**Total Clusters:** 9  
**Total Pages:** 360 (see `docs/data/blog-cluster-mapping.json` for current count and cluster_distribution)

## Overview

This document maps all blog content into thematic clusters and shows their relationships to pillar pages. This structure helps inform content strategy, internal linking, and SEO optimization.

## Cluster Definitions and Keyword Rules

Cluster assignment uses keyword-based classification (see `v2/scripts/blog/audit-cluster-mapping-coverage.py` and `add-missing-posts-to-cluster-mapping.php`). Order of checks matters; more specific clusters are evaluated first.

| Cluster | Definition | Example Keywords |
|---------|------------|------------------|
| **pflege** | Healthcare/nursing industry content | pflege, gesundheitswesen, arbeitsschutzvorschriften_im_gesundheitswesen, dienstplan_pflege |
| **einzelhandel** | Retail industry content | einzelhandel, personalmangel_einzelhandel, filiale, filialplanung |
| **gastronomie** | Restaurant/hospitality content | gastronomie, gastro, restaurant, digitalisierung_restaurants |
| **tools** | Calculators, templates, tools | rechner, calculator, berechnung, vorlage, muster, checkliste |
| **lohnabrechnung** | Payroll, tax, compensation | lohnabrechnung, lohn, gehalt, lohnsteuer, mindestlohn, zuschlag |
| **compliance** | Legal, work law, compliance | compliance, arbzg, arbeitsschutz, kuendigung, abmahnung, betriebspruefung |
| **zeiterfassung** | Time tracking, working hours | zeiterfassung, arbeitszeiterfassung, stundenzettel, arbeitszeitgesetz, pausenzeiten |
| **dienstplan** | Shift planning, scheduling | dienstplan, schichtplanung, schichtplan, urlaubsplanung, personaleinsatzplanung |
| **personalverwaltung** | HR, personnel management | personalverwaltung, personal, onboarding, personalakte, recruiting |

**Pflege as primary cluster:** Pflege is a primary cluster for industry-specific posts (e.g. `dienstplan-pflege`, `arbeitsschutzvorschriften-im-gesundheitswesen`). When content is clearly healthcare/nursing-focused, use `primary_cluster: pflege` rather than secondary.

**Performance:** At ~157KB (360 posts), `load_cluster_mapping()` remains fast (~0.4ms/load). Uses static cache; no change needed unless profiling shows a bottleneck.

## Cluster Structure

```
Pillar Pages (2)
├── Dienstplan Pillar
│   ├── Dienstplan Cluster (14 pages)
│   ├── Compliance Cluster (38 pages) [related]
│   ├── Gastronomie Cluster (19 pages) [related]
│   ├── Pflege Cluster (5 pages) [related]
│   └── Tools Cluster (25 pages) [related]
│
└── Zeiterfassung Pillar
    ├── Zeiterfassung Cluster (24 pages)
    ├── Compliance Cluster (38 pages) [related]
    ├── Gastronomie Cluster (19 pages) [related]
    ├── Lohnabrechnung Cluster (15 pages) [related]
    └── Tools Cluster (25 pages) [related]

Supporting Clusters
├── Personalverwaltung Cluster (60 pages)
├── Compliance Cluster (38 pages)
├── Tools Cluster (25 pages)
├── Gastronomie Cluster (19 pages)
├── Lohnabrechnung Cluster (15 pages)
├── Dienstplan Cluster (14 pages)
├── Pflege Cluster (5 pages)
└── Einzelhandel Cluster (2 pages)
```

## Cluster Details

### 1. Dienstplan Cluster

**Size:** 10 pages (updated Jan 2026)  
**Average Words:** ~1,200  
**Pillar Relationship:** Primary cluster for Dienstplan pillar
**Blog Support:** 0 links to pillar page ❌ (critical gap identified)

**Key Topics:**

- Dienstplan erstellen
- Schichtplanung
- Dienstplan Modelle (Rahmen-, Rollierend, Wöchentlich, Monats-, Jahres-)
- Dienstplan Software
- Dienstplan Vorlagen
- Dienstplan Gesetz

**Sample Pages:**

- `/insights/ratgeber/dienstplan-gesetz/`
- `/insights/ratgeber/dienstplan-erstellen/`
- `/insights/lexikon/schichtmodelle/`
- `/insights/lexikon/24-stunden-schicht/`

**Content Gaps:**

- Dienstplan Software Vergleich
- Dienstplan Apps detailliert
- Dienstplan für kleine Teams (<10 Mitarbeiter)
- Dienstplan Automatisierung mit KI

**Linking Opportunities:**

- Link to Dienstplan pillar from all 10 pages (CRITICAL - currently 0 links)
- Link to product_schichtplanung page (CRITICAL - currently 0 links)
- Link to templates_dienstplan page (CRITICAL - currently 0 links)
- Link to comparison pages (Dienstplan Software) (CRITICAL - currently 0 links)

**Status (Jan 2026):** Critical gaps identified - see [Blog Linking Analysis](../../../content/blog/INTERNAL_LINKING_ANALYSIS.md)

### 2. Zeiterfassung Cluster

**Size:** 7 pages (updated Jan 2026)  
**Average Words:** ~1,250  
**Pillar Relationship:** Primary cluster for Zeiterfassung pillar
**Blog Support:** 0 links to pillar page ❌ (critical gap identified)

**Key Topics:**

- Zeiterfassung Gesetz
- Digitale Zeiterfassung
- Zeiterfassung Apps
- Arbeitszeiterfassung Pflicht
- Zeiterfassung Excel
- Zeiterfassung Branchen

**Sample Pages:**

- `/insights/ratgeber/zeiterfassung-app/`
- `/insights/ratgeber/zeiterfassung-gastronomie-pflicht/`
- `/insights/ratgeber/ueberstunden-erfassen/`
- `/insights/lexikon/arbeitszeiterfassungsgesetz/`
- `/insights/lexikon/arbeitszeitkonto/`

**Content Gaps:**

- Zeiterfassung Systeme Vergleich
- Zeiterfassung Integrationen (DATEV, etc.)
- Zeiterfassung für mobile Teams
- Zeiterfassung Compliance Checklisten
- Zeiterfassung Apps Vergleich

**Linking Opportunities:**

- Link to Zeiterfassung pillar from all 7 pages (CRITICAL - currently 0 links)
- Link to product_arbeitszeiterfassung page (CRITICAL - currently 0 links)
- Link to tools pages (Zeiterfassung Rechner) (315 links present, can improve)
- Link to comparison pages (Zeiterfassung Software) (CRITICAL - currently 0 links)

**Status (Jan 2026):** Critical gaps identified - see [Blog Linking Analysis](../../../content/blog/INTERNAL_LINKING_ANALYSIS.md)

### 3. Compliance Cluster

**Size:** 38 pages  
**Average Words:** ~1,150  
**Pillar Relationship:** Supports both Dienstplan and Zeiterfassung pillars

**Key Topics:**

- Arbeitszeitgesetz (ArbZG)
- Compliance Vorschriften
- Rechtliche Grundlagen
- Arbeitsschutz
- Gesetzliche Pflichten

**Sample Pages:**

- `/insights/lexikon/arbeitsschutzvorschriften-und-programme/`
- `/insights/ratgeber/arbeitsschutzvorschriften-kultur-und-freizeitbranche/`
- `/insights/ratgeber/arbeitsschutzvorschriften-im-gesundheitswesen/`
- `/insights/lexikon/arbeitszeiterfassungsgesetz/`

**Content Gaps:**

- Compliance Checklisten
- ArbZG Updates 2025
- Compliance für verschiedene Branchen
- Compliance Best Practices

**Linking Opportunities:**

- Link to both pillar pages where relevant
- Link to compliance-related product pages
- Create compliance hub page (potential new pillar)

### 4. Gastronomie Cluster

**Size:** 19 pages  
**Average Words:** ~1,100  
**Pillar Relationship:** Supports both pillars with industry-specific content

**Key Topics:**

- Gastronomie Digitalisierung
- Restaurant Schichtplanung
- Gastro Zeiterfassung
- Gastronomie Best Practices

**Sample Pages:**

- `/insights/ratgeber/digitalisierung-restaurants/`
- `/insights/ratgeber/fehler-digitalisierung-gastronomie/`
- `/insights/ratgeber/zeiterfassung-gastronomie-pflicht/`
- `/insights/ratgeber/kostenkontrolle-im-restaurant/`

**Content Gaps:**

- Gastronomie-spezifische Dienstplan Modelle
- Trinkgeldabrechnung
- Saisonale Schichtplanung
- Gastro Compliance Checklisten

**Linking Opportunities:**

- Link to industry_gastronomie page
- Link to both pillar pages
- Link to relevant product pages

### 5. Lohnabrechnung Cluster

**Size:** 15 pages  
**Average Words:** ~1,200  
**Pillar Relationship:** Supports Zeiterfassung pillar (data flow)

**Key Topics:**

- Lohnabrechnung
- Gehaltsabrechnung
- Lohnsteuer
- Abrechnungsprozesse

**Sample Pages:**

- `/insights/lexikon/lohnabrechnung/`
- `/insights/lexikon/lohnsteuerbescheinigung/`
- `/insights/lexikon/arbeitsbescheinigung/`

**Content Gaps:**

- Lohnabrechnung Software Vergleich
- DATEV Integration
- Lohnabrechnung Automatisierung
- Lohnabrechnung für verschiedene Branchen

**Linking Opportunities:**

- Link to Zeiterfassung pillar
- Link to product_payroll page
- Link to tools pages (Brutto-Netto-Rechner)

### 6. Personalverwaltung Cluster

**Size:** 60 pages (largest cluster)  
**Average Words:** ~1,266  
**Pillar Relationship:** Supports both pillars (foundational HR content)

**Key Topics:**

- Personalverwaltung
- Mitarbeiterverwaltung
- HR-Prozesse
- Personalakte
- HR-Begriffe

**Sample Pages:**

- `/insights/lexikon/personalfragebogen/`
- `/insights/lexikon/personalakte-inhalt/`
- `/insights/lexikon/employer-branding/`
- `/insights/lexikon/organigramm/`

**Content Gaps:**

- Personalverwaltung Software Vergleich
- HR-Automatisierung
- Personalverwaltung Best Practices
- HR für verschiedene Unternehmensgrößen

**Linking Opportunities:**

- Link to both pillar pages where relevant
- Link to product pages
- Potential for new HR/Personalverwaltung pillar

### 7. Tools Cluster

**Size:** 25 pages  
**Average Words:** ~1,100  
**Pillar Relationship:** Supports both pillars with practical tools

**Key Topics:**

- Excel Vorlagen
- Rechner
- Tools
- Generatoren

**Sample Pages:**

- Various lexikon entries mentioning tools/templates
- References to calculators and generators

**Content Gaps:**

- Dedicated tool pages
- Tool comparisons
- Tool integration guides

**Linking Opportunities:**

- Link to tools pages
- Link to templates pages
- Link to both pillar pages

### 8. Pflege Cluster

**Size:** 5 pages  
**Average Words:** ~1,200  
**Pillar Relationship:** Supports Dienstplan pillar (industry-specific)

**Key Topics:**

- Pflege Dienstplanung
- Pflege Schichtplanung
- Pflege Compliance

**Sample Pages:**

- `/insights/ratgeber/dienstplan-pflege/`
- `/insights/ratgeber/arbeitsschutzvorschriften-im-gesundheitswesen/`

**Content Gaps:**

- More Pflege-specific content needed
- 24-Stunden-Schicht für Pflege
- Pflege Compliance detailliert
- Pflege Personalplanung

**Linking Opportunities:**

- Link to Dienstplan pillar
- Link to industry_pflege page
- Expand cluster with more content

### 9. Einzelhandel Cluster

**Size:** 2 pages (smallest cluster)  
**Average Words:** ~1,100  
**Pillar Relationship:** Supports both pillars (industry-specific)

**Key Topics:**

- Einzelhandel Personalplanung
- Filialplanung

**Sample Pages:**

- `/insights/ratgeber/personalmangel-einzelhandel/`

**Content Gaps:**

- Significant expansion needed
- Einzelhandel-spezifische Dienstplanung
- Filialübergreifende Planung
- Einzelhandel Compliance

**Linking Opportunities:**

- Link to both pillar pages
- Link to industry_einzelhandel page
- Major expansion opportunity

## Cluster-to-Pillar Mapping

### Dienstplan Pillar → Clusters

**Primary:** Dienstplan (14 pages)  
**Secondary:** Compliance (38 pages), Gastronomie (19 pages), Pflege (5 pages), Tools (25 pages)  
**Total Supporting Content:** ~101 pages

**Linking Strategy:**

- Link from Dienstplan cluster pages to pillar
- Link from related cluster pages where contextually relevant
- Create "Related Articles" sections on pillar page

### Zeiterfassung Pillar → Clusters

**Primary:** Zeiterfassung (24 pages)  
**Secondary:** Compliance (38 pages), Gastronomie (19 pages), Lohnabrechnung (15 pages), Tools (25 pages)  
**Total Supporting Content:** ~121 pages

**Linking Strategy:**

- Link from Zeiterfassung cluster pages to pillar
- Link from related cluster pages where contextually relevant
- Create "Related Articles" sections on pillar page

## Content Gap Analysis

### High-Priority Gaps

1. **Comparison Content:** No dedicated comparison pages linked from blog
2. **Template Links:** Zero links from blog to template pages
3. **Tool Integration:** Only 1 link to tools pages
4. **Industry-Specific:** Einzelhandel cluster needs major expansion
5. **Cross-Cluster Links:** Limited linking between related clusters

### Medium-Priority Gaps

1. **FAQ Content:** Most blog posts lack FAQ sections
2. **Visual Content:** Limited use of images/infographics
3. **Case Studies:** Few real-world examples
4. **Update Frequency:** Some content may be outdated

### Low-Priority Gaps

1. **Content Depth:** Some posts could be more comprehensive
2. **Internal Linking:** Could be more strategic
3. **Schema Markup:** FAQ schema missing in most posts

## Recommendations

1. **Strengthen Cluster Connections:** Add more cross-cluster links
2. **Build Pillar Links:** Ensure all cluster pages link to relevant pillars
3. **Expand Thin Clusters:** Focus on Einzelhandel and Pflege clusters
4. **Create Hub Pages:** Consider compliance hub page
5. **Link to Tools/Templates:** Connect blog posts to practical resources
6. **Add Comparison Links:** Link to comparison pages where relevant

## Implementation Priority

1. **Phase 1:** Add pillar page links from cluster pages
2. **Phase 2:** Link to tools and templates pages
3. **Phase 3:** Expand thin clusters (Einzelhandel, Pflege)
4. **Phase 4:** Add comparison page links
5. **Phase 5:** Create new hub pages if needed