init

docs/VALIDATION.md

@@ -0,0 +1,30 @@
+# Prüfstand 1.1
+
+Lokale Prüfung am 09.11.2026 unter Python 3.12:
+
+- 19 pytest-Tests bestanden (6,40 Sekunden).
+- Django system check ohne Fehler.
+- makemigrations --check --dry-run: keine fehlenden Migrationen.
+- pip check: keine widersprüchlichen installierten Abhängigkeiten.
+- Python-Dateien kompilierbar, Shellskripte mit bash -n geprüft.
+- Apache-/Nginx-Konfigurationen aus beiden Vorlagen erfolgreich erzeugt.
+- NiceGUI-Navigation mit User-Simulation getestet; keine visuelle Browserabnahme.
+
+Die Datenbanktests liefen lokal mit SQLite. Echte PostgreSQL-Integration, Redis,
+Celery-Worker, Flower-Neustart, SMTP, Reverse-Proxy/TLS und dilibAI wurden hier
+nicht Ende-zu-Ende ausgeführt. Es wurden keine Produktionsserver verändert.
+
+Für PostgreSQL eine separate Testdatenbank und einen Testbenutzer mit CREATEDB
+verwenden (pytest erzeugt und entfernt seine Testdatenbank):
+
+```bash
+export DATABASE_URL='postgresql://TESTBENUTZER:PASSWORT@127.0.0.1:5432/dashboard_test'
+export CACHE_URL='redis://127.0.0.1:6379/6'
+.venv/bin/pytest --ds=config.postgres_test_settings -q
+```
+
+Den PostgreSQL-Testlauf nicht mit Produktionszugangsdaten ausführen. Die beigefügte
+GitHub-Actions-Konfiguration richtet einen eigenen PostgreSQL-Testdienst ohne
+Docker ein. Dieser CI-Lauf wurde hier nicht ausgeführt. Für die laufenden Dienste
+steht `manage.py doctor --workers` zur Verfügung; die Betriebsabnahme ist in
+OPERATIONS.md beschrieben.