147 lines
2.8 KiB
Markdown
147 lines
2.8 KiB
Markdown
# 🚀 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*
|