# Survey Bundle

Proprietäres Contao-5.7-Bundle für ein Umfrage-System.

Das Bundle stellt Frontend- und Backend-Funktionen für die Erstellung, Verwaltung, Veröffentlichung und Auswertung von Umfragen bereit. Dazu gehören insbesondere öffentliche Umfrageaufrufe über Link-Schlüssel, Redaktions- und Zuordnungslogik für Mitglieder, Ergebnisdarstellungen im Frontend sowie Exportfunktionen für Excel und PDF.

Ziel des Bundles ist eine möglichst native Integration in Contao, sodass Umfragen sich wie ein regulärer Bestandteil der bestehenden System- und Redaktionsumgebung verhalten.

## Dokumentation

Architektur, Zustandslogik, bewusste Produktentscheidungen und Einstiegspunkte sind ausführlich in [`AI_HANDOVER.md`](AI_HANDOVER.md) beschrieben.

Zwei wiederkehrend relevante technische Konventionen:

- **CSRF in Frontend-Aktionsformularen:** Jedes POST-Formular sendet **zwei** Tokens – `REQUEST_TOKEN` (Contaos globaler Frontend-Gate) und `_token` (`csrf_token('<aktion>-' ~ id)`, im Controller via `isCsrfTokenValid` geprüft). Beide sind nötig.
- **Saubere Link-URLs:** Reader und Ergebnisseite werden als Pfad adressiert (`/<seite>/<alias>`). Erzeugung über `['parameters' => '/'.$alias]`, Auslesen über `Input::get('auto_item')` (markiert den Route-Parameter als benutzt – sonst Contao-404).

Nach Änderungen an DCA, Backend-CSS oder JS:

```bash
php vendor/bin/contao-console assets:install public --symlink --relative
php vendor/bin/contao-console cache:clear --env=prod
```

## Rechtlicher Hinweis

Dieses Bundle ist proprietär und nicht zur öffentlichen Weitergabe bestimmt.

Copyright (c) Mummert Media. Alle Rechte vorbehalten.

Die Nutzung, Vervielfältigung, Veränderung, Veröffentlichung oder Weitergabe ist ausschließlich im Rahmen der ausdrücklich von Mummert freigegebenen internen oder vertraglich geregelten Verwendung zulässig. Eine Nutzung durch Dritte ohne vorherige schriftliche Zustimmung ist nicht gestattet.

Es wird keine Open-Source-Lizenz für dieses Bundle eingeräumt.