# industry-pages Full Instructions

## Industry Page Purpose

Target specific verticals (Gastronomie, Einzelhandel, Pflege, Handwerk und Industrie, Freizeit und Kultur) with authentic industry-specific messaging, use cases, and pain points.

## Vertical-Specific Messaging Requirements

### Gastronomie (Hospitality)

**Pain Points:**

- Schichtbetrieb, Saisonale Schwankungen, Hohe Fluktuation, Trinkgeldabrechnung, Jugendschutz

**Use Cases:**

- Restaurant, Café, Bar, Food Truck, Caterer, Hotel, Franchise

**Key Features:**

- Schichtplanung, Zeiterfassung, Trinkgeldverwaltung, Mobile Apps

**Compliance:**

- ArbZG, Mindestlohn, Jugendschutzgesetz (JuSchG)

**Terminology:**

- "Servicekräfte", "Küchenpersonal", "Stoßzeiten", "Saisongeschäft"

### Einzelhandel (Retail)

**Pain Points:**

- Standortübergreifende Planung, Filialleiter-Entlastung, Saisonale Bedarfe, Personalkostenkontrolle

**Use Cases:**

- Fachhandel, Lebensmittel, Textil, Elektronik, Baumärkte, Franchise-Ketten

**Key Features:**

- Filialübergreifende Planung, Aufgabenmanagement, Zeiterfassung, Kostenkontrolle

**Compliance:**

- ArbZG, Ladenschlussgesetz, Mindestlohn, Jugendschutzgesetz

**Terminology:**

- "Filialleiter", "Verkaufspersonal", "Stoßzeiten", "Inventur", "Öffnungszeiten"

### Pflege (Healthcare)

**Pain Points:**

- 24-Stunden-Dienste, Fachkräftemangel, Compliance, Dokumentationspflicht, Qualifikationsplanung

**Use Cases:**

- Pflegeheime, Ambulante Pflege, Krankenhäuser, Reha-Einrichtungen

**Key Features:**

- Qualifikationsplanung, Dokumentation, Zeiterfassung, Abwesenheiten, 24-Stunden-Schichten

**Compliance:**

- ArbZG, Pflegegesetze, Arbeitszeiterfassung, Fachkraftquote

**Terminology:**

- "Pflegekräfte", "Fachkraftquote", "Schichtdienst", "Dokumentation", "Qualifikationen"

### Handwerk und Industrie (Crafts & Industry)

**Pain Points:**

- Projektplanung, Baustellen-Koordination, Überstunden, Materialverwaltung, Mobilität

**Use Cases:**

- Handwerksbetriebe, Bauunternehmen, Produktionsbetriebe

**Key Features:**

- Projektplanung, Mobile Zeiterfassung, Überstundenverwaltung, Aufgaben, Baustellen

**Compliance:**

- ArbZG, Mindestlohn, Arbeitszeiterfassung

**Terminology:**

- "Gesellen", "Baustellen", "Projekte", "Überstunden", "Montage"

### Freizeit und Kultur (Leisure & Culture)

**Pain Points:**

- Event-basierte Planung, Saisonalität, Teilzeitkräfte, Wechselnde Standorte

**Use Cases:**

- Fitnessstudios, Kinos, Theater, Museen, Freizeitparks, Event-Locations

**Key Features:**

- Event-Planung, Flexible Schichten, Standortverwaltung, Zeiterfassung

**Compliance:**

- ArbZG, Mindestlohn, Jugendschutzgesetz

**Terminology:**

- "Trainer", "Events", "Saisonbetrieb", "Veranstaltungen", "Kurse"

---

## Industry Schema Requirements

### Industry Schema (Unique to Industry Pages)

```json
{
  "@context": "https://schema.org",
  "@type": "Industry",
  "name": "[Industry Name]",
  "description": "[Industry overview]",
  "industryCode": {
    "@type": "DefinedTerm",
    "termCode": "[NACE/WZ Code]",
    "name": "[Code Name]"
  },
  "parentIndustry": "[Broader Category]",
  "subIndustries": ["[Sub-vertical 1]", "[Sub-vertical 2]"],
  "typicalChallenges": ["[Pain Point 1]", "[Pain Point 2]", "[Pain Point 3]"],
  "regulatoryRequirements": [
    "[Compliance Requirement 1]",
    "[Compliance Requirement 2]"
  ],
  "customerCount": "[Number of Ordio customers in vertical]",
  "marketShare": "[Percentage of Ordio customer base]"
}
```

**Industry Codes (NACE/WZ):**

- **Gastronomie:** I5610 (Gaststätten, Restaurants, Imbissstuben)
- **Einzelhandel:** G47 (Einzelhandel, ohne Handel mit Kraftfahrzeugen)
- **Pflege:** Q87 (Heime, ohne Erholungs- und Ferienheime)
- **Handwerk:** F43 (Vorbereitende Baustellenarbeiten, Bauinstallation und sonstiges Ausbaugewerbe)
- **Freizeit:** R93 (Erbringung von Dienstleistungen des Sports, der Unterhaltung und der Erholung)

### Service Schema

```json
{
  "@type": "Service",
  "name": "Ordio für [Industry]",
  "description": "[How Ordio serves this vertical]",
  "provider": {
    "@type": "Organization",
    "name": "Ordio GmbH"
  },
  "serviceType": "Personalverwaltungssoftware",
  "areaServed": {
    "@type": "Country",
    "name": "Deutschland"
  },
  "audience": {
    "@type": "Audience",
    "audienceType": "[Industry] mit Mitarbeitern"
  }
}
```

### Standard Schemas

Also include (from global.mdc):

- WebPage schema
- BreadcrumbList schema

---

## Copy Patterns (Industry-Specific)

See `.cursor/rules/shared-patterns.mdc` for universal copy guidelines (du tone, Ordio mentions, competitor language, copy quality).

### Hero Headline Pattern

**Formula:** Ordio für [Industry] – [Industry-Specific Pain Point Solved]

### CTA Button Pattern (Hero Section)

**CRITICAL:** Use proper wrapper div that doesn't conflict with CTA component's internal alignment.

```php
<p class="mx-auto lg:container max-w-md text-lg mb-6 px-4 lg:px-0">
    Intelligente Schichtplanerstellung, die Mitarbeitende in der {Industry} miteinbezieht! Transparente Planung für {industry-specific description}.
</p>
<div class="px-4 lg:px-0">
    <?php
    $ctaPositionLeft = 'true';
    $ctaButtonsAOS = 'false';
    $ctaButtonsLight = 'yes';
    $showCallbackButton = 'yes';
    include '../base/include_ctabuttons.php';
    ?>
</div>
```

**Key Points:**

- ❌ **NEVER use:** `<div class="flex lg:block justify-center items-center">` - conflicts with CTA component
- ✅ **ALWAYS use:** `<div class="px-4 lg:px-0">` - provides mobile padding without conflicts
- CTA component handles its own alignment via `justify-center mx-auto` when `ctaPositionLeft = 'false'`
- Use `px-4 lg:px-0` for left-aligned CTAs in hero sections

### CTA Button Pattern (Centered - Testimonial Sections)

For centered CTA buttons in testimonial sections (after "Du bist in bester Gesellschaft"):

```php
<p class="max-w-[660px] text-center text-[16px] leading-[140%] lg:text-[22px] lg:leading-[140%] lg:tracking-[-0.3px] mx-auto opacity-80 mb-9 px-4 sm:px-6">Wir haben Ordio mit mehr als 13 Jahren Erfahrung im eigenen Schichtbetrieb gegründet und gemeinsam mit Unternehmern verschiedenster Branchen für jeden Betrieb mit flexiblen Schichten optimiert.</p>
<div class="px-4 sm:px-6 lg:px-0">
    <?php
    $ctaPositionLeft = 'false';
    $ctaButtonsAOS = 'false';
    $ctaButtonsLight = 'yes';
    $showCallbackButton = 'yes';
    include '../base/include_ctabuttons.php';
    ?>
</div>
```

**Key Points:**

- Paragraph padding: `px-4 sm:px-6` (not `px-6`)
- CTA wrapper: `px-4 sm:px-6 lg:px-0` for centered buttons
- `ctaPositionLeft = 'false'` triggers component's `justify-center mx-auto` alignment

Examples:

- "Ordio für Gastronomie – Dienstplanung ohne Chaos, Zeiterfassung ohne Fehler"
- "Ordio für Einzelhandel – Filialübergreifend planen, Filialleiter entlasten"
- "Ordio für Pflege – 24-Stunden-Dienste rechtssicher planen"

### Challenge Section Pattern

**Structure:** List 3-5 authentic industry pain points with brief explanations

Example (Gastronomie):

```
**Herausforderungen in der Gastronomie:**
- **Stoßzeiten abdecken:** Montags wenig Personal, samstags Hochbetrieb
- **Saisonale Schwankungen:** Im Sommer Biergarten, im Winter ruhiger
- **Hohe Fluktuation:** Ständig neue Aushilfen und Teilzeitkräfte
- **Trinkgeld korrekt abrechnen:** Aushändigung, Aufteilung, Dokumentation
```

**Use industry terminology** naturally (Filialleiter not Standortmanager, Pflegekräfte not Mitarbeiter).

### Use Case Pattern

**Structure:** Real scenarios from the industry, not generic examples

❌ **BAD (Generic):** "Ein Unternehmen nutzt Ordio für Schichtplanung"

✅ **GOOD (Industry-Specific):**

- **Gastronomie:** "Restaurant-Kette mit 5 Standorten plant Servicekräfte und Küchenpersonal zentral"
- **Einzelhandel:** "Textilkette mit 12 Filialen koordiniert Verkaufspersonal und Inventur-Termine"
- **Pflege:** "Pflegeheim mit 50 Pflegekräften plant 24-Stunden-Dienste und berücksichtigt Qualifikationen"

**Each use case should:**

- Name specific industry context (Restaurant, Filiale, Pflegeheim)
- Mention industry-specific roles (Servicekräfte, Verkaufspersonal, Pflegekräfte)
- Reference industry pain points (Stoßzeiten, Inventur, 24-Stunden-Dienste)

### FAQ Pattern for Industry Pages

**Count:** Most industry surfaces stay **tighter** (see `FAQ_WEBSITE_STANDARD.md`). **Flagship Branchen LPs** with a docs-pipeline SSOT (e.g. [`gastronomie/faq-answers-optimized.json`](../../docs/content/pages/industry-pages/gastronomie/faq-answers-optimized.json)) may use **12–15** Q&As when **GSC query export**, **SISTRIX** (`collect-page-keywords-sistrix.php --page=...`), and (optional) **Serper PAA** support the breadth — still **one** FAQPage, 40–80 words per answer, no duplication of the whole page body.

**Address industry-specific objections:**

**Gastronomie:**

- "Können Kellner auch Trinkgeld digital abrechnen?"
- "Wie plane ich Aushilfen für Stoßzeiten?"
- "Ist Ordio für saisonale Schwankungen geeignet?"

**Einzelhandel:**

- "Kann ich Dienstpläne für alle Filialen zentral erstellen?"
- "Wie entlaste ich Filialleiter bei der Planung?"
- "Funktioniert Ordio mit Öffnungszeiten und Ladenschlussgesetz?"

**Pflege:**

- "Berücksichtigt Ordio Qualifikationen bei der Planung?"
- "Kann ich 24-Stunden-Dienste abbilden?"
- "Ist Ordio für die Fachkraftquote geeignet?"

**Include Ordio mention in 1-2 FAQ answers** (not all), naturally integrated with industry context.

**FAQ JSON-LD (SSOT):** Industry pages that use `v2/data/industry-faqs/*.json` + `render-faq-json.php` must emit **one** FAQPage script after `footer.php` via `include-marketing-faq-jsonld.php` (set `$ordio_faq_json_relpath`). Do not duplicate `FAQPage` in `<head>` `@graph`. Verify: `php v2/scripts/dev-helpers/verify-faq-jsonld-parity.php --all-misc-faqs`, `php v2/scripts/dev-helpers/audit-marketing-faq-ssot.php`.

---

## Meta Tags (Industry-Specific)

### Title Pattern

```html
<title>Ordio für [Industry] – [Key Benefit for Vertical] - Ordio</title>
```

Examples:

- "Ordio für Gastronomie – Dienstplanung & Zeiterfassung für Restaurants - Ordio"
- "Ordio für Einzelhandel – Filialübergreifende Personalplanung - Ordio"

### Description Pattern

```html
<meta
  name="description"
  content="Ordio für [Industry]: [Industry-Specific Benefit 1]. [Industry-Specific Benefit 2]. [Compliance Reference]. Kostenlos testen."
/>
```

Use industry terminology in description.

---

## Validation Checklist (Industry-Specific)

See `.cursor/rules/shared-patterns.mdc` for universal validation checklist.

**Industry-Specific:**

- [ ] Hero addresses authentic industry pain points (not generic)
- [ ] Challenges section lists real vertical problems
- [ ] Use cases feel real and include industry terminology
- [ ] Industry terminology used correctly throughout (Filialleiter, Pflegekräfte, etc.)
- [ ] FAQ addresses industry-specific objections
- [ ] Industry schema includes correct NACE/WZ code
- [ ] Industry schema lists accurate customer count and market share
- [ ] Service schema audience references correct vertical
- [ ] Compliance requirements mentioned (ArbZG, Ladenschlussgesetz, etc.)
- [ ] Customer logos/testimonials from same industry
- [ ] No generic software language; industry context throughout

---

## Common Industry Page Pitfalls

### Generic Software Language

❌ **BAD:** "Ordio ist eine Software für Personalverwaltung"

✅ **GOOD:**

- **Gastronomie:** "Ordio plant Servicekräfte für Stoßzeiten und rechnet Trinkgeld automatisch ab"
- **Einzelhandel:** "Ordio koordiniert Verkaufspersonal über alle Filialen hinweg"
- **Pflege:** "Ordio plant Pflegekräfte unter Berücksichtigung von Qualifikationen und Fachkraftquote"

### Inauthentic Use Cases

❌ **BAD:** "Ein Kunde nutzt Ordio erfolgreich"

✅ **GOOD:** "Café-Kette mit 3 Standorten plant 25 Servicekräfte und Baristas zentral, berücksichtigt Stoßzeiten am Wochenende und saisonale Schwankungen im Sommer"

### Wrong Terminology

❌ **BAD:**

- "Mitarbeiter" (too generic for Pflege → use "Pflegekräfte")
- "Standortmanager" (wrong for Einzelhandel → use "Filialleiter")
- "Arbeiter" (wrong for Gastronomie → use "Servicekräfte" or "Küchenpersonal")

✅ **GOOD:** Use industry-specific role names consistently

### Missing Compliance Context

Each industry has specific regulations:

- **Gastronomie:** ArbZG, Mindestlohn, Jugendschutzgesetz
- **Einzelhandel:** ArbZG, Ladenschlussgesetz, Mindestlohn
- **Pflege:** ArbZG, Pflegegesetze, Fachkraftquote
- **Handwerk:** ArbZG, Mindestlohn, Arbeitszeiterfassung
- **Freizeit:** ArbZG, Mindestlohn, Jugendschutzgesetz

**Mention at least once** in hero, benefits, or FAQ.

---

## Industry FAQ: keyword research and FAQ data

- **Registry & pipeline:** [`docs/content/pages/marketing-pages-registry.json`](../../docs/content/pages/marketing-pages-registry.json) lists industry/marketing LPs. Orchestrator: `bash v2/scripts/marketing-pages/run-page-research-pipeline.sh <page-id>`. Full steps: [`INDUSTRY_PAGE_SEO_DATA_WORKFLOW.md`](../../docs/content/pages/industry-pages/INDUSTRY_PAGE_SEO_DATA_WORKFLOW.md). Per-page `data/` holds `target-keywords.json`, `keywords-sistrix.json`, `faq-research.json`, `performance-gsc.json`; **SISTRIX** credits log with blog (`v2/data/blog/sistrix-credits-log.json`). Higher `sistrix_limits` in the registry apply only to **explicit** collection runs.
- **Example (Gastronomie vertical `/branchen/gastronomie`):** Registry `page_id` **`gastronomie`** — pipeline: `collect-page-keywords-sistrix.php --page=gastronomie`, `data/target-keywords.json` under [`gastronomie/data/`](../../docs/content/pages/industry-pages/gastronomie/data/). Live PHP: [`branchen_gastronomie_neu.php`](../../v2/pages/branchen_gastronomie_neu.php); FAQ SSOT [`gastronomie/faq-answers-optimized.json`](../../docs/content/pages/industry-pages/gastronomie/faq-answers-optimized.json); narrative research [`GASTRO_NEU_KEYWORD_RESEARCH.md`](../../docs/content/pages/industry-pages/GASTRO_NEU_KEYWORD_RESEARCH.md). **`/branchen/gastronomie-neu`** 301s to **`/branchen/gastronomie`** — do not treat `-neu` as a separate registry `page_id`.
- **APIs:** Serper/Firecrawl scripts + env keys (see workflow); **GSC** via Search Console CSV → `gsc-product-export.php --marketing-page=…`. Spot MCP research follows [`mcp-usage.mdc`](mcp-usage.mdc).
- **People Also Ask:** `serper-paa-research.py` merges into `data/faq-research.json`; supplement with competitor FAQ headings and [`hospitality-documentation.md`](../../docs/content/pages/industry-pages/hospitality-documentation.md) where Serper returns sparse PAA.

---

## Reference Documentation

For detailed workflows:

- `docs/guides/PAGE_TYPE_GUIDES.md` – Quick reference for industry pages
- `docs/ai/cursor-playbook.md` – Cursor-specific prompting patterns

For similar page types:

- Product pages (product-pages.mdc) – Similar feature marketing patterns
- Comparison pages (comparison-pages-core.mdc, comparison-pages-content.mdc) – Similar audience-specific positioning

## Related Documentation

See [docs/ai/RULE_TO_DOC_MAPPING.md](../../docs/ai/RULE_TO_DOC_MAPPING.md) for complete mapping.

**Key Documentation:**

- [docs/guides/PAGE_TYPE_GUIDES.md](../../docs/guides/PAGE_TYPE_GUIDES.md) - `docs/guides/PAGE_TYPE_GUIDES.md` - Page type quick reference
- [docs/content/pages/industry-pages/INDUSTRY_PAGES_INVENTORY.md](../../docs/content/pages/industry-pages/INDUSTRY_PAGES_INVENTORY.md) - `docs/content/pages/industry-pages/INDUSTRY_PAGES_INVENTORY.md` - Industry pages list
- [docs/guides/tools-pages/README.md](../../docs/guides/tools-pages/README.md) - `docs/guides/tools-pages/README.md` - Tools documentation index
- [docs/guides/tools-pages/TOOL_DOCUMENTATION_TEMPLATE.md](../../docs/guides/tools-pages/TOOL_DOCUMENTATION_TEMPLATE.md) - `docs/guides/tools-pages/TOOL_DOCUMENTATION_TEMPLATE.md` - Documentation template
- [docs/guides/tools-pages/TOOLS_INVENTORY.md](../../docs/guides/tools-pages/TOOLS_INVENTORY.md) - `docs/guides/tools-pages/TOOLS_INVENTORY.md` - Complete tool list
- [docs/guides/tools-pages/TOOLS_MAINTENANCE_GUIDE.md](../../docs/guides/tools-pages/TOOLS_MAINTENANCE_GUIDE.md) - `docs/guides/tools-pages/TOOLS_MAINTENANCE_GUIDE.md` - Annual update process
- [docs/guides/tools-pages/DOCUMENTATION_STRUCTURE.md](../../docs/guides/tools-pages/DOCUMENTATION_STRUCTURE.md) - `docs/guides/tools-pages/DOCUMENTATION_STRUCTURE.md` - Structure guide
- [docs/guides/tools-pages/TOOLS_INVENTORY.md](../../docs/guides/tools-pages/TOOLS_INVENTORY.md) - `docs/guides/tools-pages/TOOLS_INVENTORY.md` - Tools inventory (consolidated)
- [docs/content/tools/TOOLS_DOCUMENTATION_QUALITY_REPORT.md](../../docs/content/tools/TOOLS_DOCUMENTATION_QUALITY_REPORT.md) - `docs/content/tools/TOOLS_DOCUMENTATION_QUALITY_REPORT.md` - Quality assessment (legacy)
- [docs/guides/tools-pages/README.md](../../docs/guides/tools-pages/README.md) - `docs/guides/tools-pages/README.md` - Tools documentation index