# 🚀 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*