feat: create dev system

development-system/README.md

@@ -0,0 +1,30 @@
+# Perspektivwerk Terminbuchung – lokales Entwicklungssystem
+
+Diese Ordner enthält eine lokale Annäherung an die öffentlich erkennbare technische Basis von `sufw.de`: Contao (PHP/Symfony), Apache, MariaDB sowie die im Frontend verbreiteten Komponenten Bootstrap 5, jQuery und Slick Carousel.
+
+## Start
+
+Voraussetzungen: Docker Desktop (Compose v2) und optional Node.js 20+ für die TypeScript-Assets.
+
+```powershell
+docker compose up --build
+```
+
+Danach:
+
+- Website/CMS: <http://localhost:8080>
+- Contao-Installation: <http://localhost:8080/contao/install>
+- Datenbankinspektor: <http://localhost:8081> (Server `db`, Benutzer `perspektivwerk`, Passwort `perspektivwerk`, Datenbank `perspektivwerk`)
+
+Für die Frontend-Logik:
+
+```powershell
+npm install
+npm run build
+```
+
+## Abgrenzung zur Originalseite
+
+Die genaue Contao-, PHP- und Template-Version der öffentlichen Seite ist nicht verlässlich aus dem ausgelieferten HTML ableitbar. Das Setup bildet daher die wahrscheinlichste Komponentenfamilie nach; es ist kein Dump der Produktivinstallation. IONOS/Hosting, Matomo-Konfiguration, Inhalte, Templates und Erweiterungen müssen bei Bedarf separat ergänzt werden.
+
+Die Terminlogik liegt zunächst in `src/booking.ts`. Eine spätere Google-Calendar- oder Exchange-Anbindung sollte über eine Backend-API erfolgen, damit keine Secrets im Browser landen.