# Zuschlagsrechner 2026 Update - Next Steps & Testing Guide

**Last Updated:** 2026-03-29

## Overview

This document provides comprehensive testing instructions and verification steps for the Zuschlagsrechner 2026 update.

### Nach Deployment (Skyscraper-Refresh März 2026)

- **Google Rich Results Test:** `https://www.ordio.com/tools/zuschlagsrechner` prüfen (WebPage, HowTo mit `url` je Step, FAQPage, kein `aggregateRating` auf **WebApplication des Rechners** – Hinweis: globales **Organization**-JSON aus `head.php` kann weiterhin `aggregateRating` enthalten).
- **GSC:** Performance für die URL in 2–4 Wochen prüfen; Metriken in `docs/guides/tools-pages/data/zuschlagsrechner-gsc-ga-template.md` einpflegen (derzeit: Seed-Queries eingetragen, **echte Zahlen pending** bis GSC-Export).

### Schema-Check (lokal erledigt, 2026-03-29)

Auf `http://localhost:8003/tools/zuschlagsrechner` (Docker) geprüft:

- Ein **page-spezifisches** `application/ld+json` mit `@graph` enthält: `WebPage`, `WebApplication` **ohne** `aggregateRating`, `Calculator`, `HowTo` mit `totalTime` **PT3M** und **vier** `HowToStep`-Einträgen inkl. `url` (`#zuschlag-step-stundenlohn`, …), `FAQPage` mit **15** Fragen.
- Optional wiederholen nach Deploy:

```bash
curl -sS "http://localhost:8003/tools/zuschlagsrechner" | tr '\n' ' ' | grep -o 'application/ld+json[^<]*' | head -1
# Oder: Seitenquelltext nach "Zuschlagsrechner 2026: Nacht-, Sonn-" und FAQPage durchsuchen
```

**Production:** Bis zum nächsten Release kann `www.ordio.com` noch ältere HTML-/Schema-Versionen ausliefern – Rich Results Test dort **nach** Deploy ausführen.

### Nächste inhaltliche / SEO-Schritte (nach Livegang)

1. GSC- und optional GA4-Daten ins Template schreiben; schwache Queries mit internen Links oder Snippet-Anpassungen iterieren.
2. In 2–4 Wochen: Impressions/Clicks der URL und der Head-Query `zuschlagsrechner` vergleichen.
3. Optional: `CONTENT_OUTLINE.md` weiter mit echten PAA aus GSC „Queries“ befüllen (derzeit auto-generierte H2-Liste weicht von der **live** erzählten Struktur ab – siehe Outline-Notiz).

## Pre-Deployment Checklist

### Code Quality ✅

- [x] No linter errors
- [x] No console.log statements
- [x] Minified files regenerated
- [x] All year references updated (2025 → 2026)

### Content Accuracy ✅

- [x] All rate references match §3b EStG
- [x] Nachtzuschlag time periods clarified
- [x] Special holiday rates documented
- [x] Samstagszuschlag legal status clarified
- [x] All FAQs updated

## Manual Testing Checklist

### 1. Calculator Functionality

#### Default Rates Test

**Test Case:** Verify calculator works with default rates

**Steps:**
1. Navigate to `/tools/zuschlagsrechner`
2. Enter base wage: €15/hour
3. Enter Nachtstunden: 8 hours
4. Verify Nachtzuschlag default: 25%
5. Enter Sonntagsstunden: 4 hours
6. Verify Sonntagszuschlag default: 50%
7. Enter Feiertagsstunden: 8 hours
8. Verify Feiertagszuschlag default: 100%
9. Enter Samstagsstunden: 4 hours
10. Verify Samstagszuschlag default: 25%

**Expected Results:**
- Nachtzuschlag: €30.00 (8h × €15 × 25%)
- Sonntagszuschlag: €30.00 (4h × €15 × 50%)
- Feiertagszuschlag: €120.00 (8h × €15 × 100%)
- Samstagszuschlag: €15.00 (4h × €15 × 25%)
- Total Zuschlag: €195.00
- Total Earnings: €315.00 (€120 base + €195 surcharge)

#### Custom Rates Test

**Test Case:** Test with custom rates above steuerfreie limits

**Steps:**
1. Enter base wage: €18/hour
2. Enter Feiertagsstunden: 8 hours
3. Set Feiertagszuschlag to 125%
4. Verify calculation
5. Set Feiertagszuschlag to 150%
6. Verify calculation

**Expected Results:**
- At 125%: €180.00 (8h × €18 × 125%)
- At 150%: €216.00 (8h × €18 × 150%)

#### Multiple Surcharge Types Test

**Test Case:** Test with multiple surcharge types simultaneously

**Steps:**
1. Enter base wage: €20/hour
2. Enter Nachtstunden: 4 hours (Nachtzuschlag: 25%)
3. Enter Sonntagsstunden: 4 hours (Sonntagszuschlag: 50%)
4. Enter Feiertagsstunden: 4 hours (Feiertagszuschlag: 125%)
5. Verify all calculations

**Expected Results:**
- Nachtzuschlag: €20.00 (4h × €20 × 25%)
- Sonntagszuschlag: €40.00 (4h × €20 × 50%)
- Feiertagszuschlag: €100.00 (4h × €20 × 125%)
- Total Zuschlag: €160.00
- Total Earnings: €240.00 (€80 base + €160 surcharge)

### 2. Content Verification

#### Feiertagszuschlag Rates

**Test Case:** Verify Feiertagszuschlag rate information is correct

**Steps:**
1. Scroll to "Steuerfreie Zuschläge" section
2. Verify Feiertagszuschlag card shows: "Steuerfrei bis: 125% (reguläre Feiertage), 150% (besondere Feiertage)"
3. Scroll to table
4. Verify table shows: "125% (regulär), 150% (besonders)"
5. Scroll to "Besondere Feiertage" section
6. Verify section lists: 24.12 ab 14 Uhr, 25./26.12, 1. Mai (150%)
7. Verify section lists: 31.12 ab 14 Uhr (125%)

**Expected Results:**
- All content shows correct rates (125%/150%)
- Special holidays clearly listed
- Examples provided

#### Nachtzuschlag Time Periods

**Test Case:** Verify Nachtzuschlag time period information is correct

**Steps:**
1. Scroll to Nachtzuschlag card
2. Verify shows: "Steuerfreie Periode: 20:00-06:00 Uhr (bis zu 25% steuerfrei)"
3. Verify shows: "ArbZG-Definition: 23:00-06:00 Uhr"
4. Verify shows: "Besonderer Fall: 0:00-4:00 Uhr (bis zu 40% steuerfrei)"
5. Scroll to "40% Nachtzuschlag Regel" section
6. Verify section explains conditions and provides examples

**Expected Results:**
- Steuerfreie Periode clearly stated as 20:00-06:00 Uhr
- ArbZG definition clarified as 23:00-06:00 Uhr
- 40% special case explained

#### Samstagszuschlag Legal Status

**Test Case:** Verify Samstagszuschlag legal status is clear

**Steps:**
1. Scroll to Samstagszuschlag card
2. Verify shows: "Steuerfrei: Nicht automatisch steuerfrei - hängt vom Tarifvertrag ab"
3. Verify shows: "Hinweis: Keine gesetzliche Pflicht - nur bei Tarifvertrag oder Arbeitsvertrag"
4. Scroll to table
5. Verify table shows yellow badge: "Nicht automatisch steuerfrei"

**Expected Results:**
- Legal status clearly stated
- Steuerfrei conditions explained
- No misleading "steuerfrei" claims

### 3. FAQ Verification

#### FAQ: "Welche Zuschläge sind steuerfrei?"

**Test Case:** Verify FAQ answer is accurate

**Steps:**
1. Scroll to FAQ section
2. Open "Welche Zuschläge sind steuerfrei?"
3. Verify answer includes:
   - Nachtzuschlag: 25% (20:00-06:00), 40% (0:00-4:00 special case)
   - Sonntagszuschlag: 50%
   - Feiertagszuschlag: 125% (regular), 150% (special holidays)
   - Samstagszuschlag: Not automatically steuerfrei

**Expected Results:**
- All rates accurate
- Special cases mentioned
- Samstagszuschlag status clarified

#### FAQ: "Ist der Nachtzuschlag ab 20 Uhr steuerfrei?"

**Test Case:** Verify FAQ answer is correct (was previously incorrect)

**Steps:**
1. Scroll to FAQ section
2. Open "Ist der Nachtzuschlag ab 20 Uhr steuerfrei?"
3. Verify answer states: "Ja, der Nachtzuschlag ist bereits ab 20:00 Uhr steuerfrei!"
4. Verify explains: Steuerfreie Periode 20:00-06:00 Uhr, ArbZG-Definition 23:00-06:00 Uhr
5. Verify mentions 40% special case

**Expected Results:**
- Answer is correct (was previously incorrect)
- Time periods clarified
- Special case mentioned

### 4. Tooltips Verification

#### Nachtzuschlag Tooltip

**Test Case:** Verify tooltip shows correct information

**Steps:**
1. Hover over Nachtzuschlag tooltip icon
2. Verify tooltip shows: "Steuerfreie Periode: 20:00-06:00 Uhr (bis zu 25% steuerfrei). Besonderer Fall: 0:00-4:00 Uhr bis zu 40% steuerfrei, wenn Arbeit vor Mitternacht begonnen wurde."

**Expected Results:**
- Tooltip shows correct time periods
- 40% special case mentioned

#### Feiertagszuschlag Tooltip

**Test Case:** Verify tooltip shows correct rates

**Steps:**
1. Hover over Feiertagszuschlag tooltip icon
2. Verify tooltip shows: "Steuerfreie Grenzen: 125% (reguläre Feiertage, 31.12 ab 14 Uhr), 150% (24.12 ab 14 Uhr, 25./26.12, 1. Mai)"

**Expected Results:**
- Tooltip shows correct rates (125%/150%)
- Special holidays listed

#### Samstagszuschlag Tooltip

**Test Case:** Verify tooltip clarifies legal status

**Steps:**
1. Hover over Samstagszuschlag tooltip icon
2. Verify tooltip shows: "Keine gesetzliche Pflicht. Steuerfrei-Status hängt vom Tarifvertrag ab."

**Expected Results:**
- Tooltip clarifies legal status
- Steuerfrei conditions explained

### 5. Export Functionality

#### CSV Export Test

**Test Case:** Verify CSV export includes correct rates

**Steps:**
1. Enter test data:
   - Base wage: €15/hour
   - Nachtstunden: 8 (25%)
   - Sonntagsstunden: 4 (50%)
   - Feiertagsstunden: 8 (100%)
2. Click "CSV exportieren"
3. Open CSV file
4. Verify rates shown correctly
5. Verify calculations correct

**Expected Results:**
- CSV includes all surcharge types
- Rates shown correctly
- Calculations accurate

#### PDF Export Test

**Test Case:** Verify PDF export includes correct rates

**Steps:**
1. Enter test data (same as CSV test)
2. Click "PDF exportieren"
3. Open PDF file
4. Verify rates shown correctly
5. Verify calculations correct
6. Verify formatting correct

**Expected Results:**
- PDF includes all surcharge types
- Rates shown correctly
- Calculations accurate
- Formatting professional

### 6. Edge Cases

#### Zero Hours Test

**Test Case:** Verify calculator handles zero hours correctly

**Steps:**
1. Enter base wage: €15/hour
2. Set all hours to 0
3. Verify total shows €0.00
4. Set only Nachtstunden: 8 hours
5. Verify only Nachtzuschlag calculated

**Expected Results:**
- Zero hours result in zero surcharge
- Only non-zero hours calculated

#### Very High Rates Test

**Test Case:** Verify calculator handles rates above steuerfreie limits

**Steps:**
1. Enter base wage: €20/hour
2. Enter Feiertagsstunden: 8 hours
3. Set Feiertagszuschlag to 200%
4. Verify calculation: €320.00 (8h × €20 × 200%)

**Expected Results:**
- Calculator accepts rates above steuerfreie limits
- Calculation correct (note: above steuerfreie limit, taxable portion)

#### Decimal Hours Test

**Test Case:** Verify calculator handles decimal hours

**Steps:**
1. Enter base wage: €15/hour
2. Enter Nachtstunden: 7.5 hours
3. Verify calculation: €28.13 (7.5h × €15 × 25%)

**Expected Results:**
- Decimal hours accepted
- Calculation accurate

### 7. Schema Markup Verification

#### Schema datePublished

**Test Case:** Verify schema datePublished is 2026

**Steps:**
1. View page source
2. Search for `datePublished`
3. Verify shows: `"2026-01-01T00:00:00+01:00"`

**Expected Results:**
- Schema datePublished is 2026-01-01

#### FAQPage Schema

**Test Case:** Verify FAQPage schema includes updated answers

**Steps:**
1. View page source
2. Search for `FAQPage`
3. Verify FAQ answers match updated content
4. Verify "Welche Zuschläge sind steuerfrei?" answer includes 125%/150% rates
5. Verify "Ist der Nachtzuschlag ab 20 Uhr steuerfrei?" answer is correct

**Expected Results:**
- FAQPage schema includes all FAQs
- Answers match updated content

### 8. Meta Tags Verification

#### Title Tag

**Test Case:** Verify title tag shows 2026

**Steps:**
1. View page source
2. Search for `<title>`
3. Verify shows: "Zuschlagsrechner 2026: Nacht- & Feiertagszuschläge berechnen - Ordio"

**Expected Results:**
- Title includes "2026"

#### Meta Description

**Test Case:** Verify meta description shows 2026

**Steps:**
1. View page source
2. Search for `meta name="description"`
3. Verify shows: "Zuschlagsrechner 2026: Nacht-, Sonn- und Feiertagszuschläge berechnen..."

**Expected Results:**
- Meta description includes "2026"

#### OG Tags

**Test Case:** Verify OG tags show 2026

**Steps:**
1. View page source
2. Search for `og:title` and `og:description`
3. Verify both include "2026"

**Expected Results:**
- OG tags include "2026"

## Browser Testing

### Desktop Browsers

- [ ] Chrome (latest)
- [ ] Firefox (latest)
- [ ] Safari (latest)
- [ ] Edge (latest)

### Mobile Browsers

- [ ] Chrome Mobile
- [ ] Safari Mobile
- [ ] Firefox Mobile

### Test Scenarios

1. **Responsive Design:** Verify calculator works on mobile devices
2. **Touch Interactions:** Verify tooltips work on touch devices
3. **Form Inputs:** Verify number inputs work correctly on mobile
4. **Exports:** Verify CSV/PDF exports work on mobile

## Performance Testing

### Page Load

- [ ] Page loads within 2 seconds
- [ ] Calculator initializes correctly
- [ ] No JavaScript errors in console

### Calculation Speed

- [ ] Calculations complete instantly
- [ ] No lag when changing inputs
- [ ] Export generation completes within 2 seconds

## Accessibility Testing

- [ ] Tooltips accessible via keyboard
- [ ] Form labels properly associated
- [ ] Color contrast meets WCAG AA standards
- [ ] Screen reader compatibility

## Deployment Checklist

### Pre-Deployment

- [x] All code changes reviewed
- [x] All content verified
- [x] All documentation updated
- [x] Minified files regenerated
- [x] No console.log statements
- [x] No linter errors

### Post-Deployment

- [ ] Verify page loads correctly
- [ ] Verify calculator functions correctly
- [ ] Verify exports work correctly
- [ ] Verify schema markup validates (Google Rich Results Test)
- [ ] Monitor for errors (first 24 hours)

## Rollback Plan

If issues are discovered post-deployment:

1. **Immediate:** Revert to previous version via git
2. **Investigation:** Review error logs
3. **Fix:** Address issues in development
4. **Re-deploy:** After verification

## Success Criteria

✅ All calculator functions work correctly
✅ All content shows accurate 2026 rates
✅ All FAQs are accurate
✅ All tooltips show correct information
✅ Exports work correctly
✅ Schema markup validates
✅ Meta tags show 2026
✅ No JavaScript errors
✅ Page loads within performance targets
✅ Mobile responsive

## Notes

- Calculator defaults kept at 100% for Feiertagszuschlag (common practice)
- Content clarifies steuerfreie limits (125%/150%)
- All critical issues resolved
- Documentation updated

## Contact

For questions or issues, contact: hady@ordio.com