PummelHummel/Alph in 3D-Druck-AG integriert

Quelle: D:/Claude-Projekte/PummelHummel/feedback_modul/ (Standard-Pattern,
auch in arduino.lehrstun.de + meta.lehrstun.de erprobt). 1:1 nach
3d.lehrstun.de/feedback_modul/ kopiert.

app.py erweitert:
- init_feedback_modul-Aufruf mit unseren Adaptern
- _alph_user_kontext: Lehrer = admin, SuS = profil mit Vorname+Tier,
  Anonym = kein Widget
- _alph_widget_aktiv: liest einstellung.feedback_widget_aktiv
- _alph_admin_unauthorized: Redirect zu admin.admin_login

Hart-Aus via ENV ALPH_DEAKTIVIERT=1 weiterhin moeglich.
Soft-Aus via einstellung.feedback_widget_aktiv='0' (per Admin-Inline-Edit).

DB:
- feedback-Tabelle via feedback_modul.schema.DDL angelegt (idempotent)
- einstellung.feedback_widget_aktiv auf '1' gesetzt (Alpha-Test-Modus)

Test:
- Eingeloggter SuS sieht das Alph-Widget auf /lektion/1
- Anonym (kein Login) sieht es nicht (user_kontext gibt None)
- Admin sieht es mit Rolle 'admin'

Naechster Schritt: Deploy auf Hetzner (3d.lehrstun.de), Markus loggt
sich als Test-Schueler ein und gibt Feedback zu den 14 Lektionen.

app.py

@@ -15,8 +15,9 @@ import os
 from pathlib import Path
 
 from dotenv import load_dotenv
-from flask import Flask, render_template, request
+from flask import Flask, render_template, request, session, redirect, url_for
 
+from database import get_db
 from tiere import tier_emoji, tier_name
 
 # Routes-Blueprints
@@ -37,6 +38,65 @@ app.register_blueprint(bp_admin)
 app.register_blueprint(bp_api)
 
 
+# ===========================================================================
+# Alph-PummelHummel-Feedback-Modul (Pattern aus arduino.lehrstun.de)
+# ===========================================================================
+# Zwei-Stufen-Schalter:
+#  1) Soft-Aus (Default-DB): einstellung.feedback_widget_aktiv = '0'
+#     → Hummel unsichtbar, Modul ist aber geladen (Routen aktiv).
+#     Im Admin-Panel umschaltbar, kein Restart noetig.
+#  2) Hart-Aus: ENV ALPH_DEAKTIVIERT=1 → der ganze Init-Block uebersprungen,
+#     keine Routen, kein Context-Processor. Fuer Notfall. Restart noetig.
+
+def _alph_get_einstellung(schluessel: str, default: str = "0") -> str:
+    """Liefert einen Einstellungs-Wert aus der DB als String."""
+    conn = get_db()
+    row = conn.execute(
+        "SELECT wert FROM einstellung WHERE schluessel = ?", (schluessel,)
+    ).fetchone()
+    conn.close()
+    return row["wert"] if row else default
+
+
+def _alph_user_kontext():
+    """Liefert den User-Kontext fuer das Alph-Widget — bestimmt zugleich,
+    OB das Widget angezeigt wird (None → kein Widget).
+    """
+    if session.get("admin"):
+        return {"rolle": "admin", "tier": "lehrer", "kasten": "-"}
+    if not session.get("profil_id"):
+        return None
+    return {
+        "rolle": "schueler",
+        "tier": session.get("tier", "?"),
+        "kasten": session.get("vorname", "?"),  # bei uns: Vorname statt Kasten-Nummer
+        "profil_id": session.get("profil_id"),
+    }
+
+
+def _alph_widget_aktiv():
+    return _alph_get_einstellung("feedback_widget_aktiv", "0") == "1"
+
+
+def _alph_admin_unauthorized():
+    return redirect(url_for("admin.admin_login"))
+
+
+if os.environ.get("ALPH_DEAKTIVIERT", "0") != "1":
+    from feedback_modul import init_feedback_modul  # noqa: E402
+
+    init_feedback_modul(
+        app,
+        get_db=get_db,
+        app_name="3d-druck-ag",
+        ist_admin=lambda: bool(session.get("admin")),
+        user_kontext=_alph_user_kontext,
+        widget_aktiv=_alph_widget_aktiv,
+        admin_unauthorized=_alph_admin_unauthorized,
+        parent_template="base.html",
+    )
+
+
 # ===========================================================================
 # Markdown-Filter fuer Templates (Pattern wie arduino.lehrstun.de)
 # ===========================================================================