RollCalculator/With Authentification/QUICKSTART.md

🚀 Rollcalculator Beta – Quick Start

1. Projekt-Struktur aufbauen

mkdir rollcalculator-beta
cd rollcalculator-beta

2. Dateien herunterladen/kopieren

Kopiere diese Dateien aus dem Output-Ordner:

• app.py
• requirements.txt
• README.md

3. Templates-Ordner erstellen

mkdir templates static

4. HTML-Datei kopieren

Kopiere deine roll_calculator.html in templates/:

cp /pfad/zur/roll_calculator.html templates/

5. Dependencies installieren

pip install -r requirements.txt

6. App starten

python app.py

✅ Server läuft unter: http://localhost:5000

---

🔐 Teste die Authentication

Öffne http://localhost:5000 im Browser

Test-Login:

• Benutzer: beta
• Passwort: rollcalc_beta_2026

---

📁 Finale Verzeichnis-Struktur

rollcalculator-beta/
├── app.py                      # Flask-Server
├── requirements.txt            # Dependencies
├── README.md                   # Dokumentation
├── access_log.json             # (wird auto-erstellt)
├── templates/
│   └── roll_calculator.html    # Deine HTML-Datei
└── static/
    └── (optional: JSON, Service Worker, etc.)

---

🔧 Anpassungen vor Beta-Release

In app.py ändern:

# Zeile 15-16: Passwörter aktualisieren
BETA_USERS = {
    "beta": "DEIN_SICHERES_PASSWORT_HIER",
    "naue": "WEITERES_PASSWORT_HIER"
}

# Zeile 22-24: Admin-Passwort
ADMIN_USERS = {
    "admin": "ADMIN_PASSWORT_SEHR_SICHER"
}

---

📊 Access Logs prüfen

Nach einigen Logins: access_log.json öffnen und schauen:

[
  {
    "timestamp": "2026-05-28T12:17:03.123456",
    "username": "beta",
    "endpoint": "/",
    "method": "GET",
    "status": 200
  }
]

---

✅ Checkliste vor Production

• Passwörter in app.py aktualisiert
• roll_calculator.html in templates/ vorhanden
• python app.py startet ohne Fehler
• Anmeldung funktioniert (Test-User)
• HTTPS/Reverse-Proxy geplant
• Access-Logs-Archivierung geplant
• Admin-Dashboard für Monitoring erwünscht?

---

🆘 Häufige Probleme

Problem: jinja2.exceptions.TemplateNotFound → Lösung: templates/roll_calculator.html muss existieren

Problem: 401 Unauthorized → Das ist normal! Gib Credentials ein (z.B. beta/rollcalc_beta_2026)

Problem: ModuleNotFoundError: No module named 'flask' → Lösung: pip install -r requirements.txt

---

🎯 Nächste Schritte

1. Tests: Alle Funktionen mit echten Benutzern testen
2. Monitoring: Access-Logs regelmäßig überprüfen
3. Feedback: Beta-Tester-Feedback sammeln
4. Production: Nach Release-Freigabe produktiv nehmen

---

Viel Erfolg mit der Beta-Phase! 🚀

Martin Tazl
Roll Calculator – Naue GmbH & Co. KG