# Resources Recurring Audit Guide

**Last Updated:** 2026-03-18

This guide documents values and content that require recurring audits across resources (templates, tools, downloads). Run in December or early January when labor law values and year references change.

## Values Requiring Annual Updates

### Labor Law Values

**Source:** [docs/content/LABOR_LAW_VALUES_2026.md](../../content/LABOR_LAW_VALUES_2026.md)

| Value | 2026 | Affected Files |
|-------|------|----------------|
| Mindestlohn | 13,90 €/h | pillar_dienstplan.php, tools_roi_rechner_schichtplanung.php, tools_midijob_rechner.php, download_trinkgeld.php, tools_arbeitszeitrechner.php |
| Minijob-Grenze | 603 €/Monat | lohnabrechnung-vorlage, tools_midijob_rechner.php, dienstplan-excel-vorlage, schichtplan-excel-vorlage, wochenplan-vorlage |
| Midijob-Bereich | 603,01 € – 2.000 € | lohnabrechnung-vorlage, tools_midijob_rechner.php |
| public-data.json | minimum_wage, minijob_threshold | v2/systems/excel-template-generator/data/template-formulas/public-data.json |

### Year References

| Location | Update |
|----------|--------|
| Meta titles/descriptions | Zeiterfassung 202X, Praxis-Guide 202X |
| H1 headlines | download_zeiterfassung.php |
| Guide names in schema | download_index.php ItemList |
| Gesetzesentwurf references | download_zeiterfassung.php (Gesetzesentwurf 202X) |
| tools_index_data.php | für 202X, Steuern 202X, Minijobs 202X |
| downloads_index_data.php | Zeiterfassung 202X, Praxis-Guide 202X |
| templates_index_data.php | Mindestlohn in descriptions |

### Template Content Blocks

| Template | Files to Check |
|----------|----------------|
| lohnabrechnung-vorlage | content/content.md, content-blocks.json, data/faq-answers-optimized.json |
| dienstplan-excel-vorlage | content-blocks.json (Minijob 520→603) |
| schichtplan-excel-vorlage | content-blocks.json, content/content.md |
| wochenplan-vorlage | content-blocks.json, content/content.md |

**Content style:** Keep template content blocks opportunities-driven (benefits, value, outcomes) rather than count-driven (metrics like „1.700 Unternehmen“, „50% Planungszeit“). Use qualitative phrasing: „Viele Unternehmen“, „erheblich Planungszeit“, „deutlich weniger Fehler“, „spürbare Zeitersparnis“. See `.cursor/rules/templates-pages-content-blocks.mdc`.

## Metrics Requiring Verification

See [docs/content/RESOURCES_METRICS_SOURCES.md](../../content/RESOURCES_METRICS_SOURCES.md) for full list. Key items:

- 60% Unternehmen nicht compliant (Zeiterfassung)
- 82% weniger Fluktuation (Onboarding)
- 60–70% Produktivität (Onboarding)
- €30.000 Bußgelder (verified – ArbZG §22)

## Audit Checklist

Run annually (December/January) or when laws change:

1. [ ] Verify new values on BMAS and Minijob-Zentrale
2. [ ] Update `public-data.json` (minimum_wage, minijob_threshold)
3. [ ] Run `python3 v2/scripts/dev-helpers/audit-year-references.py`
4. [ ] Grep for old labor law values: `grep -r "12,82\|12\.82\|520\|556\|538" v2/pages docs/systems/templates --include="*.php" --include="*.md" --include="*.json"` (exclude SVG paths, template-quality-scorer)
5. [ ] Update download pages: download_zeiterfassung.php, download_trinkgeld.php
6. [ ] Update template content: lohnabrechnung-vorlage, dienstplan, schichtplan, wochenplan
7. [ ] Update tools: tools_midijob_rechner.php, tools_roi_rechner_schichtplanung.php, pillar_dienstplan.php
8. [ ] Run `php v2/scripts/templates/sync-template-content-blocks.php --template=lohnabrechnung-vorlage` (and others if content.md changed)
9. [ ] Verify metrics in RESOURCES_METRICS_SOURCES.md
10. [ ] Run `make validate` or `make pre-deploy`
11. [ ] Manual preview: /download/zeiterfassung, /download/trinkgeld-bargeldlose-gastronomie, /vorlagen/lohnabrechnung-vorlage

## 2026 Audit Cycle – Completed (2026-03-18)

**Labor law & year updates:** Mindestlohn 12,82→13,90 €; Minijob 520/556/538→603 €; 2025→2026 in download_zeiterfassung, index data, template content.  
**Metrics:** Restored original values (60%, 82%, €2.500) in download pages; documented in RESOURCES_METRICS_SOURCES.md.  
**Content:** Opportunities-driven language in template blocks; internal links added (Stundenzettel, Arbeitszeiterfassungsgesetz, Minijob-Rechner, Arbeitszeitrechner).  
**Validation:** `make validate` run; pre-existing PHPStan/ESLint issues remain (no new failures from audit changes). Index data files (tools, downloads, templates) have no 2025 references.

**softwareVersion:** Updated "2025.1" → "2026.1" in cello_einladung.php, paid_paid.php, paid_schichtbetriebe.php, paid_nonbrand.php, kostenlos-testen.php, compare_staffomatic.php.

**Internal links:** Added missing links to templates (onboarding-checkliste), tools (stundenlohnrechner, zuschlagsrechner), downloads (zeiterfassung, lohnabrechnungen, onboarding-checklist, trinkgeld). All pass validation.

**Next steps (manual):**
- [ ] Manual preview: /download/zeiterfassung, /download/trinkgeld-bargeldlose-gastronomie, /vorlagen/lohnabrechnung-vorlage, /vorlagen/arbeitszeiterfassung-excel-vorlage
- [ ] Add citations for metrics (60%, 82%, €2.500) in RESOURCES_METRICS_SOURCES.md when sources available

## Related Documentation

- [LABOR_LAW_VALUES_2026.md](../../content/LABOR_LAW_VALUES_2026.md) – Single source of truth for labor law values
- [RESOURCES_METRICS_SOURCES.md](../../content/RESOURCES_METRICS_SOURCES.md) – Metrics verification status
- [INDEX_PAGES_ANNUAL_UPDATE_GUIDE.md](../index-pages/INDEX_PAGES_ANNUAL_UPDATE_GUIDE.md) – Index pages checklist
- [.cursor/rules/index-pages-annual-update.mdc](../../../.cursor/rules/index-pages-annual-update.mdc) – Cursor rule for index updates