3d.lehrstun.de/app.py

"""3D-Druck-AG — Flask-Bootstrap.

Nach V8 (siehe docs/decisions.md#E-020): Blueprint-Struktur.
Diese Datei laedt die Konfiguration, registriert Blueprints, definiert
Context-Processor + Error-Handler.

Routen leben in routes/. Externe Services in services/.

Quickstart (lokal):
    python -c "from database import init_db; init_db()"
    python seed.py
    python app.py     # http://localhost:5057
"""
import os
from pathlib import Path

from dotenv import load_dotenv
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
from routes.oeffentlich import bp as bp_oeffentlich
from routes.profil import bp as bp_profil
from routes.admin import bp as bp_admin
from routes.api import bp as bp_api

load_dotenv()

app = Flask(__name__)
app.secret_key = os.environ.get("FLASK_SECRET", "dev-key-bitte-aendern")

# Blueprints registrieren
app.register_blueprint(bp_oeffentlich)
app.register_blueprint(bp_profil)
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)
# ===========================================================================
import markdown as _markdown
from markupsafe import Markup


@app.template_filter("iso_format")
def iso_format_filter(iso_str, format_str="%H:%M"):
    """Parsed einen ISO-Datetime-String und formatiert ihn (strftime)."""
    from datetime import datetime
    try:
        dt = datetime.fromisoformat(iso_str)
    except (TypeError, ValueError):
        return iso_str or ""
    return dt.strftime(format_str)


@app.template_filter("dauer_min")
def dauer_min_filter(start_iso, ende_iso):
    """Berechnet Dauer in ganzen Minuten zwischen zwei ISO-Datetime-Strings."""
    from datetime import datetime
    try:
        s = datetime.fromisoformat(start_iso)
        e = datetime.fromisoformat(ende_iso)
    except (TypeError, ValueError):
        return ""
    return int((e - s).total_seconds() // 60)


@app.template_filter("markdown")
def markdown_filter(text):
    """Rendert Markdown zu HTML und markiert das Ergebnis als 'safe',
    damit Jinja2 die HTML-Tags nicht escaped (sonst sieht man <strong>
    statt fettem Text)."""
    if not text:
        return ""
    html = _markdown.markdown(
        text,
        extensions=["fenced_code", "tables", "nl2br"],
        output_format="html5",
    )
    return Markup(html)


# ===========================================================================
# Context-Processor: in jedem Template verfuegbar
# ===========================================================================

@app.context_processor
def inject_globals():
    return {
        "tier_emoji": tier_emoji,
        "tier_name": tier_name,
    }


# ===========================================================================
# Error-Handler
# ===========================================================================

@app.errorhandler(404)
def err_404(e):
    return render_template("404.html"), 404


@app.errorhandler(500)
def err_500(e):
    return render_template("500.html"), 500


@app.errorhandler(501)
def err_501(e):
    return render_template("501.html"), 501


if __name__ == "__main__":
    # Port via ENV konfigurierbar (lokal 5057, Hetzner 5058 weil meta.lehrstun.de
    # auf 5057 liegt). Debug-Modus auch via ENV, damit Production-Service ohne
    # Debug + Auto-Reload laeuft.
    port = int(os.environ.get("PORT", "5057"))
    debug = os.environ.get("FLASK_DEBUG", "1") == "1"
    app.run(host="0.0.0.0", port=port, debug=debug)