br
5fff17531d
mail drin
fehlende routen drin
prod-reife erreicht.
TODOS:
Deine aktuellen offenen TODOs
1. Rate-Limiting (Spam-Schutz VOR dem reCAPTCHA)
Das reCAPTCHA hält zwar Bots ab, aber wenn jemand böswillig ein Script schreibt, das 1.000 POST-Requests pro Sekunde an /api/v1/submissions sendet, muss dein Backend jedes Mal Google kontaktieren und die Datenbank befragen. Das frisst Server-Ressourcen.
Todo: Einbinden von Flask-Limiter und Absichern der API-Route (z.B. max. 10 Submissions pro Minute pro IP-Adresse oder Tenant).
2. Billing & Feature-Enforcement (Limits pro Tenant durchsetzen)
Die Mandanten-Architektur und das config-Feld im JSON existieren bereits. Aber wir erzwingen diese Limits aktuell nicht im Backend.
Todo: Im Dashboard (templates/admin/tenants/view.html) UI-Controls einbauen, um Feature-Flags für einen Tenant festzulegen:
max_forms (z.B. 1 für Free-User, 10 für Pro-User).
allow_instant_mail (Dürfen E-Mails an den Tenant gesendet werden?).
allow_autoresponder (Darf der Autoresponder für Endkunden genutzt werden?).
Todo: Diese Limits hart im Backend (beim Erstellen von Forms und beim Mailversand) kontrollieren. (Der Mailer prüft das zwar schon halbwegs, das UI zum Pflegen fehlt aber noch komplett).
3. E-Mail Templates aufwerten (HTML statt Plain-Text)
Bisher versendet der Service E-Mails als reinen Text (plain). Für eine professionelle SaaS-Lösung sollten diese Mails ansprechend aussehen.
Todo: Im services/mailer.py den MIMEMultipart so erweitern, dass er saubere HTML-Mails aus einem Jinja2-Template (templates/emails/...) generiert, inklusive Branding/Logo deines Services.
4. Frontend-Snippet "Graceful Degradation"
Das embed.js arbeitet aktuell sehr gut. Aber was ist, wenn das Formeleon-Backend mal für 5 Minuten down ist?
Todo: Einen sauberen Timeout im fetch einbauen und dem Endkunden auf der Webseite eine schöne, fallback HTML-Meldung anzeigen ("Entschuldigung, das Formular ist momentan nicht erreichbar"), anstatt dass sich das Script lautlos in der Console mit einem CORS/Network-Error verabschiedet.
5. CI/CD Pipeline (Deployment)
Wenn der Code fertig ist, willst du ihn sicher nicht immer händisch per git pull auf deinen Produktionsserver schieben und dort docker compose up tippen.
Todo: Eine simple Pipeline (Github Actions / Gitea Actions) anlegen, die den Code testet und automatisch auf dem Zielserver ausrollt.
76 lines
2.7 KiB
Python
76 lines
2.7 KiB
Python
# ==============================================================================
|
|
# Formeleon - Multi-tenant Form Generator
|
|
# Author: Björn Runden <br@runden.net>
|
|
# Module: services/exporter.py
|
|
# Description: Service for exporting form submissions.
|
|
# ==============================================================================
|
|
|
|
import csv
|
|
import json
|
|
import io
|
|
from typing import List, Dict, Any
|
|
from flask import Response
|
|
from models import Submission
|
|
|
|
class ExporterService:
|
|
"""Service to handle generating exports for submissions."""
|
|
|
|
@classmethod
|
|
def generate_csv_response(cls, submissions: List[Submission], filename: str = "export.csv") -> Response:
|
|
"""
|
|
Generates a Flask Response containing a CSV stream of the given submissions.
|
|
"""
|
|
# Determine all possible fields from the payloads
|
|
all_keys = set()
|
|
for sub in submissions:
|
|
if isinstance(sub.payload, dict):
|
|
all_keys.update(sub.payload.keys())
|
|
|
|
fieldnames = ['ID', 'Date', 'Form', 'Status', 'reCAPTCHA'] + sorted(list(all_keys))
|
|
|
|
si = io.StringIO()
|
|
writer = csv.DictWriter(si, fieldnames=fieldnames)
|
|
writer.writeheader()
|
|
|
|
for sub in submissions:
|
|
row = {
|
|
'ID': sub.id,
|
|
'Date': sub.created_at.strftime('%Y-%m-%d %H:%M:%S'),
|
|
'Form': sub.form_config.name if sub.form_config else 'Unknown',
|
|
'Status': sub.status.value,
|
|
'reCAPTCHA': sub.recaptcha_score if sub.recaptcha_score is not None else ''
|
|
}
|
|
if isinstance(sub.payload, dict):
|
|
row.update(sub.payload)
|
|
writer.writerow(row)
|
|
|
|
output = si.getvalue()
|
|
|
|
return Response(
|
|
output,
|
|
mimetype="text/csv",
|
|
headers={"Content-disposition": f"attachment; filename={filename}"}
|
|
)
|
|
|
|
@classmethod
|
|
def generate_json_response(cls, submissions: List[Submission], filename: str = "export.json") -> Response:
|
|
"""
|
|
Generates a Flask Response containing a JSON array of the given submissions.
|
|
"""
|
|
data = []
|
|
for sub in submissions:
|
|
data.append({
|
|
'id': sub.id,
|
|
'date': sub.created_at.isoformat(),
|
|
'form_name': sub.form_config.name if sub.form_config else None,
|
|
'status': sub.status.value,
|
|
'recaptcha_score': sub.recaptcha_score,
|
|
'payload': sub.payload
|
|
})
|
|
|
|
return Response(
|
|
json.dumps(data, indent=2),
|
|
mimetype="application/json",
|
|
headers={"Content-disposition": f"attachment; filename={filename}"}
|
|
)
|