reset

2026-05-28 14:55:09 +02:00
parent 3bbdca4fc3
commit e267b1fe02
17 changed files with 9258 additions and 0 deletions
@@ -0,0 +1,146 @@
+# 🚀 Rollcalculator Beta – Quick Start
+
+## 1. Projekt-Struktur aufbauen
+
+```bash
+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
+
+```bash
+mkdir templates static
+```
+
+## 4. HTML-Datei kopieren
+
+Kopiere deine `roll_calculator.html` in `templates/`:
+```bash
+cp /pfad/zur/roll_calculator.html templates/
+```
+
+## 5. Dependencies installieren
+
+```bash
+pip install -r requirements.txt
+```
+
+## 6. App starten
+
+```bash
+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:**
+
+```python
+# 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:
+
+```json
+[
+  {
+    "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*