better repo organization, added legal texts

docs/checkout wizard flow.txt

@@ -0,0 +1,31 @@
+die webseite benötigt einen modernen checkout, der die seite nicht neu lädt, sondern immer nur den jeweiligen schritt anzeigt. Er soll wir ein Multi-Step Wizard aufgebaut sein. Er startet von der Paket-Auswahlseite kommend mit der bestätigung des Pakets anhand der package_id.
+Schritt 1: gewähltes Paket
+
+Anzeige des ausgewählten pakets mit allen details. möglichkeit, ein anderes paket (aber nur gleichartig, also wenn das paket vom typ "endcustomer" ist, nur solche andere pakete anzeigen, wenn das Paket vom Typ "reseller" ist, nur solche pakete anzeigen).
+
+schritt  2: "login" und "registrierung" 
+nahtlose integration beider formular mit umschalter. Loginformular: fehleingaben sollen direkt am formular und per toast sichtbar sein. Der erfolgreiche Login sollte das sichtbare formular ersetzen mit "Sie sind nun eingeloggt" => weiter zum nächsten schritt. toast-benachrichtigung. Fehler bei der registrierung sollen im formular widergespiegelt werden. ist der nutzer angemeldet, soll beides nicht mehr sichtbar sein, sondern "Sie sind bereits eingeloggt". Eine erfolgreiche Registrierung loggt den nutzer mit status "purchase_pending" ein und leitet zu schritt 3.
+Frage klären: kann man den login oder die registrierung ersetzen durch daten von paypal/strip registrierung (callback)?
+
+schritt 3: Zahlung
+pakettyp "endcustomer": 
+auswahl paypal / Stripe. Buttons für "Mit PayPal bezahlen" und "Mit Stripe bezahlen" anzeigen. Der Benutzer klickt einen aus.
+Zahlungsinitierung:
+PayPal: Umleitung zu PayPal's Express Checkout (via API-Call in Laravel-Controller, z. B. create_order). Der Benutzer loggt sich bei PayPal ein, bestätigt den Einmalkauf (keine Subscription-Option). Rückleitung mit Token zur Bestätigung (Webhook oder Redirect-Handler).
+Stripe: Client-seitige Integration mit Stripe Elements (React-Komponente in Ihrer PWA). Der Benutzer gibt Kartendaten ein (ohne Umleitung), oder nutzt Stripe Checkout (hosted Page). Backend-Call zu Stripe API für PaymentIntent erstellen und bestätigen.
+Bestätigung: Nach Zahlung (z. B. 29,99 €) wird der Kauf im Backend gespeichert (z. B. TenantPackage::createPurchase()), Zugang freigeschaltet (z. B. Event-Zugriff via EventController), und der Benutzer sieht eine Erfolgsseite.
+Fehlerbehandlung: Abbruch → Zurück zur Bestellübersicht mit Fehlermeldung (z. B. "Zahlung fehlgeschlagen").
+
+pakettyp "reseller": 
+PayPal: 
+Nutzung von PayPal Subscriptions API (in Laravel via SDK). Erstellen eines Subscription-Plans (z. B. create_subscription), Umleitung zu PayPal für Autorisierung. Der Benutzer stimmt wiederkehrenden Abbuchungen zu. Rückleitung mit Subscription-ID, die im Backend (z. B. PackagePurchases) gespeichert wird. Webhooks für Updates (z. B. Kündigung).
+Stripe: 
+Erstellen eines Subscription-Plans via Stripe Dashboard/API (z. B. stripe.subscriptions.create()). Client-seitig: Stripe Elements für SetupIntent (Kartenspeicherung), dann Subscription aktivieren. Keine Umleitung nötig, wenn Sie benutzerdefinierte UI bauen. Backend-Handling für Billing-Cycles, Invoices und Webhooks (z. B. für invoice.paid).
+Bestätigung: Erste Zahlung erfolgt sofort, Subscription startet. Backend-Update: Reseller-Status aktivieren (z. B. in Tenants-Tabelle), Willkommens-E-Mail. 
+Für Kündigungen: Link im profil und in der Admin-PWA (z. B. via Filament).
+Fehlerbehandlung: Bei Kartenablehnung → Retry-Option oder Wechsel zu anderem Anbieter. Proration bei Paket-Wechsel (z. B. via Stripe's Proration-Feature).
+
+Schritt 4: Abschluss und bestätigen der bestellung, falls noch erforderlich.
+Bestätigungsseite mit link zum tenant-admin bereich. Ergänzen des profilmenüs um den link zum tenant-admin.
+
+bei allem die lokalisierung beachten

docs/legal/agb-de.md

@@ -0,0 +1,118 @@
+# Allgemeine Geschäftsbedingungen (AGB) für „Die Fotospiel App“
+
+**Stand:** Oktober 2025
+
+**Anbieter:**  
+Sören Eberhardt-Biermann  
+Schweriner Str. 15  
+19306 Neustadt-Glewe  
+Mobil 0173 / 9266802
+W-IdNr. DE 428754098  
+E-Mail: [Kontakt siehe Impressum](https://fotospiel.app/impressum)
+
+---
+
+## 1. Geltungsbereich
+Diese AGB regeln sämtliche Nutzungsverträge über die App und Online-Dienste „Die Fotospiel App“ zwischen dem Anbieter und den Kunden (Veranstalter, Agenturen, Reseller oder – bei Direktbuchung – Verbraucher).  
+Abweichende Bedingungen finden keine Anwendung, es sei denn sie werden vom Anbieter schriftlich bestätigt.  
+Für Teilnehmer (Gäste) gelten ergänzend die Nutzungsbedingungen des jeweiligen Events.
+
+---
+
+## 2. Leistungsbeschreibung
+1. Die App ermöglicht Veranstaltern die Durchführung von Foto-Events mit Aufgaben, bei denen Gäste Bilder hochladen, ansehen und bewerten können.  
+2. Der Leistungsumfang richtet sich nach dem gebuchten Paket (Upload-Limit, Anzahl Aufgaben, Teilnehmerzahl, Design-Optionen u. a.).  
+3. Die Bereitstellung erfolgt als **Software-as-a-Service** (SaaS) über Server der Hetzner Online GmbH in Deutschland.
+
+---
+
+## 3. Vertragsschluss
+Der Vertrag kommt zustande, wenn der Kunde ein Paket bucht und der Anbieter die Buchung elektronisch bestätigt (z. B. per E-Mail).  
+Die Darstellung auf der Website stellt kein bindendes Angebot dar.
+
+---
+
+## 4. Nutzungsrechte an der App
+Der Kunde erhält für die gebuchte Laufzeit ein einfaches, nicht übertragbares Nutzungsrecht zur vertragsgemäßen Verwendung der App.  
+Quellcode, Design und Systemarchitektur bleiben alleiniges Eigentum des Anbieters.  
+Eine Weitergabe oder kommerzielle Vermietung ist nur bei vorliegendem Resellervertrag zulässig.
+
+---
+
+## 5. Pflichten des Kunden
+1. Der Kunde trägt die Verantwortung für sämtliche von ihm oder seinen Teilnehmern eingestellten Inhalte.  
+2. Er hat sicherzustellen, dass die Teilnehmer über die Zwecke der Verarbeitung informiert sind und Einwilligungen (z. B. bei Abbildungen von Personen) vorliegen.  
+3. Verboten sind rechtswidrige, jugendgefährdende oder verletzende Inhalte. Der Anbieter kann solche Beiträge löschen oder sperren.  
+4. Zugangsdaten dürfen nicht an Dritte weitergegeben werden.
+
+---
+
+## 6. Pflichten der Teilnehmer
+Teilnehmer dürfen nur Fotos hochladen, an denen sie die erforderlichen Rechte besitzen.  
+Sie räumen dem Veranstalter eine einfache, zeitlich auf die Event- und Galerie-Dauer begrenzte Nutzungslizenz ein.  
+Der Anbieter verwendet Inhalte ausschließlich zur technischen Bereitstellung (Speicherung, Anzeige, Sicherungskopie).
+
+---
+
+## 7. Preise und Zahlung
+1. Es gelten die auf der Website veröffentlichten Preise zum Zeitpunkt der Buchung.  
+2. Alle Preise verstehen sich einschließlich gesetzlicher Umsatzsteuer.  
+3. Die Zahlung erfolgt im Voraus über **PayPal** oder **Stripe Checkout** (Kreditkarte, Apple Pay, Google Pay u. a.).  
+4. Bei Nutzung dieser Dienste gelten zusätzlich die AGB und Datenschutzhinweise der jeweiligen Anbieter:  
+    – PayPal (Europe) S.à r.l. et Cie, S.C.A., L-2449 Luxembourg  
+    – Stripe Payments Europe Ltd., Dublin, Irland  
+5. Der Anbieter erhält von diesen Diensten nur Zahlungs- und Statusinformationen zur Abwicklung.  
+6. Rechnungen werden elektronisch bereitgestellt.
+
+---
+
+## 8. Verfügbarkeit und Wartung
+Der Anbieter bemüht sich um eine hohe Verfügbarkeit (Hosting bei Hetzner).  
+Kurzzeitige Ausfälle durch Wartung, Updates oder höhere Gewalt sind möglich.  
+Ein konkreter Verfügbarkeitsgrad wird nicht geschuldet.
+
+---
+
+## 9. Haftung
+1. Der Anbieter haftet bei Vorsatz und grober Fahrlässigkeit uneingeschränkt.  
+2. Bei einfacher Fahrlässigkeit nur bei Verletzung wesentlicher Pflichten und begrenzt auf den vorhersehbaren Schaden.  
+3. Keine Haftung für rechtswidrige Inhalte oder Verluste durch unsachgemäße Nutzung.  
+4. Haftung für Personenschäden bleibt unberührt.
+
+---
+
+## 10. Datenschutz
+1. Personenbezogene Daten werden gemäß der **Datenschutzerklärung** verarbeitet ([https://fotospiel.app/datenschutz](https://fotospiel.app/datenschutz)).  
+2. Der Betrieb erfolgt auf Servern der **Hetzner Online GmbH**, mit der ein Auftragsverarbeitungsvertrag besteht.  
+3. Analysen erfolgen mit **Matomo**, nur mit technisch notwendigen Cookies.
+
+---
+
+## 11. Laufzeit und Kündigung
+Der Vertrag endet automatisch nach Ablauf der gebuchten Event- bzw. Galeriedauer.  
+Eine ordentliche Kündigung während der Laufzeit ist ausgeschlossen.  
+Das Recht zur außerordentlichen Kündigung aus wichtigem Grund bleibt bestehen.
+
+---
+
+## 12. Löschung und Sperrung von Inhalten
+Der Anbieter ist berechtigt, Inhalte oder Konten zu löschen oder zu sperren, wenn Rechtsverstöße oder Beschwerden vorliegen oder technische Gründe es erfordern.
+
+---
+
+## 13. Änderungen der AGB
+Änderungen werden dem Kunden in Textform mitgeteilt. Widerspricht der Kunde nicht innerhalb eines Monats, gelten die neuen AGB als angenommen.
+
+---
+
+## 14. Streitbeilegung und Gerichtsstand
+1. Es gilt deutsches Recht unter Ausschluss des UN-Kaufrechts.  
+2. Gerichtsstand für Kaufleute ist Neustadt-Glewe.  
+3. Die EU-Kommission stellt eine Plattform zur Online-Streitbeilegung (OS) bereit: <https://ec.europa.eu/consumers/odr>  
+   Der Anbieter ist nicht verpflichtet und nicht bereit, an einem Streitbeilegungsverfahren vor einer Verbraucherschlichtungsstelle teilzunehmen.
+
+---
+
+## 15. Schlussbestimmungen
+Sollten einzelne Bestimmungen unwirksam sein, bleibt die Wirksamkeit der übrigen unberührt.  
+Nebenabreden bedürfen der Textform.

docs/legal/agb-en.md

@@ -0,0 +1,119 @@
+# Terms and Conditions (T&C) for "The Fotospiel App"
+
+**Last updated:** October 2025
+
+**Provider:**  
+Sören Eberhardt-Biermann  
+Schweriner Str. 15  
+19306 Neustadt-Glewe, Germany  
+Mobile +49 173 9266802
+Business ID: DE 428754098  
+Email: [Contact via imprint](https://fotospiel.app/impressum)
+
+---
+
+## 1. Scope
+These Terms govern all usage agreements for the app and online services "The Fotospiel App" between the Provider and Customers (event organizers, agencies, resellers, or—if booked directly—consumers).  
+Deviating conditions shall not apply unless expressly confirmed in writing by the Provider.  
+For event participants (guests), the respective event’s participant terms apply in addition.
+
+---
+
+## 2. Description of Services
+1. The App allows organizers to host photo events with creative tasks where guests can upload, view, and like photos.  
+2. The scope of services depends on the selected package (upload limits, number of tasks, participants, design options, etc.).  
+3. The service is provided as **Software-as-a-Service (SaaS)** via servers of Hetzner Online GmbH, Germany.
+
+---
+
+## 3. Conclusion of Contract
+A contract is formed when the Customer books a package and the Provider confirms the booking electronically (e.g., by email).  
+The presentation on the website does not constitute a binding offer.
+
+---
+
+## 4. Rights of Use
+The Customer receives a simple, non-transferable right to use the App for the booked period.  
+All source code, design, and infrastructure remain the sole property of the Provider.  
+Transfer or subleasing is only permitted under an existing reseller agreement.
+
+---
+
+## 5. Customer Obligations
+1. The Customer is responsible for all content uploaded by themselves or their participants.  
+2. The Customer must ensure that participants are informed about data processing purposes and that required consents (e.g., image rights) are obtained.  
+3. Unlawful, offensive, or harmful content is prohibited; the Provider may remove or block such content.  
+4. Access data must be kept confidential.
+
+---
+
+## 6. Participant Obligations
+Participants may upload only photos for which they hold the necessary rights.  
+They grant the organizer a simple, time-limited license for use during the event and gallery period.  
+The Provider uses such content solely for technical purposes (storage, display, backups).
+
+---
+
+## 7. Prices and Payment
+1. Prices valid at the time of booking apply.  
+2. All prices include VAT, unless otherwise stated.  
+3. Payment is made in advance via **PayPal** or **Stripe Checkout** (credit card, Apple Pay, Google Pay, etc.).  
+4. The payment process is governed by the respective provider’s terms:  
+   – PayPal (Europe) S.à r.l. et Cie, S.C.A., L-2449 Luxembourg  
+   – Stripe Payments Europe Ltd., Dublin, Ireland  
+5. The Provider only receives transaction and payment status data necessary for processing.  
+6. Invoices are issued electronically.
+
+---
+
+## 8. Availability and Maintenance
+The Provider strives for high availability (hosting via Hetzner).  
+Short interruptions due to maintenance, updates, or force majeure may occur.  
+No specific uptime is guaranteed.
+
+---
+
+## 9. Liability
+1. The Provider is fully liable for intent and gross negligence.  
+2. For ordinary negligence, liability is limited to essential contractual obligations and foreseeable damages.  
+3. The Provider is not liable for unlawful content or data loss caused by improper use.  
+4. Liability for personal injury remains unaffected.
+
+---
+
+## 10. Data Protection
+1. Personal data is processed in accordance with the **Privacy Policy** ([https://fotospiel.app/datenschutz](https://fotospiel.app/datenschutz)).  
+2. Operation takes place on servers of **Hetzner Online GmbH** under a data processing agreement (Art. 28 GDPR).  
+3. Web analytics are conducted via **Matomo**, using only technically necessary cookies.
+
+---
+
+## 11. Term and Termination
+The contract ends automatically after the booked event or gallery period expires.  
+Ordinary termination during the contract term is excluded.  
+The right to extraordinary termination for good cause remains unaffected.
+
+---
+
+## 12. Deletion and Suspension
+The Provider may delete or suspend content or accounts if legal violations, complaints, or technical issues arise.
+
+---
+
+## 13. Amendments
+The Provider will inform Customers of changes in text form.  
+If the Customer does not object within one month, the new terms are deemed accepted.
+
+---
+
+## 14. Dispute Resolution and Jurisdiction
+1. German law applies, excluding the UN Convention on Contracts for the International Sale of Goods.  
+2. For merchants, the place of jurisdiction is Neustadt-Glewe, Germany.  
+3. The EU Commission provides an online dispute resolution (ODR) platform: <https://ec.europa.eu/consumers/odr>  
+   The Provider is neither obliged nor willing to participate in consumer arbitration proceedings.
+
+---
+
+## 15. Final Provisions
+Should any provision be invalid, the remaining provisions remain in effect.  
+Side agreements require text form.

docs/legal/datenschutz-de.md

@@ -0,0 +1,124 @@
+# Datenschutzerklärung
+**Stand:** Oktober 2025
+
+## 1. Verantwortlicher
+Verantwortlich für die Datenverarbeitung im Sinne der Datenschutz-Grundverordnung (DSGVO):
+
+**Sören Eberhardt-Biermann**  
+Schweriner Str. 15  
+19306 Neustadt-Glewe  
+Deutschland  
+
+E-Mail: info@fotospiel.app
+Website: [https://fotospiel.app](https://fotospiel.app)
+
+---
+
+## 2. Allgemeines zur Datenverarbeitung
+Wir verarbeiten personenbezogene Daten ausschließlich im Rahmen der geltenden Datenschutzgesetze, insbesondere der DSGVO und des BDSG.  
+Die Nutzung der Fotospiel App ist grundsätzlich nur mit den personenbezogenen Daten erforderlich, die für die Durchführung eines Foto-Events und die Bereitstellung der Funktionen notwendig sind.
+
+---
+
+## 3. Arten der verarbeiteten Daten
+- Veranstalterdaten: Name, E-Mail-Adresse, Zahlungsinformationen (über PayPal/Stripe), Eventdaten (Titel, Datum, Aufgaben, Bilder)
+- Nutzerdaten (Gäste): hochgeladene Fotos, Anzeigename (frei wählbar), Reaktionen/Likes
+- Technische Daten: IP-Adresse, Browsertyp, Zeitstempel, Geräteinformationen
+- Kommunikationsdaten: Inhalte von Kontaktanfragen über das Formular oder per E-Mail
+
+---
+
+## 4. Zweck und Rechtsgrundlage der Verarbeitung
+| Zweck der Verarbeitung | Rechtsgrundlage | Beschreibung |
+|------------------------|----------------|---------------|
+| Bereitstellung der App und Durchführung von Veranstaltungen | Art. 6 Abs. 1 lit. b DSGVO | Nutzung der App durch Veranstalter und Gäste |
+| Speicherung und Anzeige von Fotos innerhalb des Events | Art. 6 Abs. 1 lit. b DSGVO | Durchführung der Fotospiel-Funktionalität |
+| Abrechnung und Zahlungsabwicklung | Art. 6 Abs. 1 lit. b, lit. c DSGVO | Nutzung der Dienste von PayPal und Stripe |
+| Webanalyse über Matomo (selbst gehostet) | Art. 6 Abs. 1 lit. f DSGVO | Statistische Auswertung zur Verbesserung der App |
+| Sicherheit, Server-Logs | Art. 6 Abs. 1 lit. f DSGVO | Sicherstellung des Betriebs, Fehleranalyse |
+| Beantwortung von Kontaktanfragen | Art. 6 Abs. 1 lit. f oder lit. b DSGVO | Kommunikation mit Nutzern und Interessenten |
+
+---
+
+## 5. Hosting und Auftragsverarbeitung
+Unsere Server werden bei **Hetzner Online GmbH**, Industriestr. 25, 91710 Gunzenhausen, Deutschland, betrieben.  
+Mit Hetzner besteht ein Vertrag zur Auftragsverarbeitung (Art. 28 DSGVO).  
+Die Verarbeitung erfolgt ausschließlich innerhalb der EU.
+
+---
+
+## 6. Zahlungsabwicklung
+Die Zahlungsabwicklung erfolgt über **PayPal (Europe) S.à r.l. et Cie, S.C.A.** und **Stripe Payments Europe, Ltd.**  
+Bei der Zahlung werden personenbezogene Daten an diese Dienstleister übermittelt.  
+Wir speichern keine Zahlungs- oder Kreditkartendaten.  
+Rechtsgrundlage: Art. 6 Abs. 1 lit. b und lit. c DSGVO.
+
+Datenschutzhinweise der Anbieter:  
+- PayPal: https://www.paypal.com/de/webapps/mpp/ua/privacy-full  
+- Stripe: https://stripe.com/de/privacy
+
+---
+
+## 7. Webanalyse mit Matomo
+Wir verwenden **Matomo** (lokal gehostet) zur Analyse des Nutzerverhaltens.  
+Es werden keine Daten an Dritte übermittelt.  
+IP-Adressen werden anonymisiert gespeichert.  
+Nur technisch notwendige Cookies werden gesetzt.  
+Rechtsgrundlage: Art. 6 Abs. 1 lit. f DSGVO.
+
+---
+
+## 8. Cookies
+Es werden ausschließlich technisch notwendige Cookies verwendet.  
+Rechtsgrundlage: Art. 6 Abs. 1 lit. f DSGVO.  
+Eine Einwilligung ist nicht erforderlich.
+
+---
+
+## 9. Löschfristen
+| Datenart | Löschfrist | Begründung |
+|-----------|-------------|-------------|
+| Fotos | Innerhalb von 30 Tagen nach Ablauf der Event-Speicherdauer | Automatische Löschung |
+| Benutzerkonten (Gastgeber) | Nach 24 Monaten Inaktivität | Vertragserfüllung abgeschlossen |
+| Zahlungsdaten | 10 Jahre | Gesetzliche Aufbewahrungspflichten |
+| Server-Logs | 7 Tage | IT-Sicherheit |
+| Kontaktanfragen | Max. 6 Monate | Nach Bearbeitung gelöscht |
+
+---
+
+## 10. Weitergabe an Dritte
+Eine Weitergabe erfolgt nur an:
+- Zahlungsdienstleister (PayPal, Stripe)
+- Hoster (Hetzner)
+- Gesetzlich erforderliche Stellen (z. B. Finanzbehörden)
+
+Keine Übermittlung in Drittländer außerhalb der EU.
+
+---
+
+## 11. Rechte der betroffenen Personen
+Betroffene Personen haben folgende Rechte:
+- Auskunft (Art. 15 DSGVO)
+- Berichtigung (Art. 16 DSGVO)
+- Löschung (Art. 17 DSGVO)
+- Einschränkung (Art. 18 DSGVO)
+- Datenübertragbarkeit (Art. 20 DSGVO)
+- Widerspruch (Art. 21 DSGVO)
+
+# Zur Ausübung genügt eine Mitteilung an: info@fotospiel.app
+
+---
+
+## 12. Widerruf von Einwilligungen
+Sofern die Verarbeitung auf Einwilligung beruht, kann diese jederzeit mit Wirkung für die Zukunft widerrufen werden.
+
+---
+
+## 13. Sicherheit der Datenverarbeitung
+Wir setzen technische und organisatorische Maßnahmen zur Sicherung Ihrer Daten ein (z. B. Verschlüsselung, Zugriffsbeschränkungen, Backups).
+
+---
+
+## 14. Änderungen dieser Datenschutzerklärung
+Wir behalten uns vor, diese Datenschutzerklärung anzupassen.  
+Die jeweils aktuelle Fassung ist unter [https://fotospiel.app/datenschutz](https://fotospiel.app/datenschutz) abrufbar.

docs/legal/datenschutz-en.md

@@ -0,0 +1,123 @@
+# Privacy Policy
+**Last updated:** October 2025
+
+## 1. Data Controller
+Responsible under the General Data Protection Regulation (GDPR):
+
+**Sören Eberhardt-Biermann**  
+Schweriner Str. 15  
+19306 Neustadt-Glewe  
+Germany  
+
+Email: info@fotospiel.app
+Website: [https://fotospiel.app](https://fotospiel.app)
+
+---
+
+## 2. General Information
+We process personal data in compliance with the GDPR and the German Federal Data Protection Act (BDSG).  
+Use of the Fotospiel App requires only the personal data necessary to host and participate in photo events.
+
+---
+
+## 3. Types of Data Processed
+- Organizer data: name, email address, payment information (via PayPal/Stripe), event details (title, date, photo tasks, photos)
+- Guest data: uploaded photos, display name (optional), likes/reactions
+- Technical data: IP address, browser type, timestamp, device information
+- Communication data: messages sent via contact form or email
+
+---
+
+## 4. Purpose and Legal Basis of Processing
+| Purpose | Legal Basis | Description |
+|----------|--------------|-------------|
+| Providing the app and hosting events | Art. 6(1)(b) GDPR | Contract performance |
+| Storing and displaying photos | Art. 6(1)(b) GDPR | Core feature of the app |
+| Payment processing and invoicing | Art. 6(1)(b), (c) GDPR | Use of PayPal and Stripe services |
+| Web analytics via Matomo | Art. 6(1)(f) GDPR | Statistical analysis to improve the app |
+| Server logs and security | Art. 6(1)(f) GDPR | Ensuring system security |
+| Responding to inquiries | Art. 6(1)(f) or (b) GDPR | Communication with users |
+
+---
+
+## 5. Hosting and Data Processing
+Our servers are operated by **Hetzner Online GmbH**, Industriestr. 25, 91710 Gunzenhausen, Germany.  
+A data processing agreement pursuant to Art. 28 GDPR is in place.  
+All processing takes place within the EU.
+
+---
+
+## 6. Payment Processing
+Payments are handled by **PayPal (Europe) S.à r.l. et Cie, S.C.A.** and **Stripe Payments Europe, Ltd.**  
+We do not store payment or credit card data.  
+Legal basis: Art. 6(1)(b) and (c) GDPR.
+
+Privacy policies:  
+- PayPal: https://www.paypal.com/de/webapps/mpp/ua/privacy-full  
+- Stripe: https://stripe.com/de/privacy
+
+---
+
+## 7. Web Analytics with Matomo
+We use **Matomo** (self-hosted) for anonymous usage analysis.  
+No data is shared with third parties.  
+IP addresses are anonymized.  
+Only technically necessary cookies are used.  
+Legal basis: Art. 6(1)(f) GDPR.
+
+---
+
+## 8. Cookies
+Only technically necessary cookies are used.  
+Legal basis: Art. 6(1)(f) GDPR.  
+No consent is required.
+
+---
+
+## 9. Data Retention Periods
+| Data Type | Retention Period | Reason |
+|------------|------------------|--------|
+| Photos | Deleted within 30 days after the booked storage period ends | Automatic deletion |
+| User accounts (hosts) | Deleted after 24 months of inactivity | Contract completed |
+| Payment data | 10 years | Legal retention obligations |
+| Server logs | 7 days | IT security |
+| Contact messages | Max. 6 months | After processing completed |
+
+---
+
+## 10. Data Disclosure
+Data is only shared with:
+- Payment providers (PayPal, Stripe)
+- Hosting provider (Hetzner)
+- Public authorities when legally required
+
+No data is transferred outside the EU.
+
+---
+
+## 11. Data Subject Rights
+You have the following rights under GDPR:
+- Right of access (Art. 15)
+- Right to rectification (Art. 16)
+- Right to erasure (Art. 17)
+- Right to restriction of processing (Art. 18)
+- Right to data portability (Art. 20)
+- Right to object (Art. 21)
+
+Requests may be sent to: info@fotospiel.app
+
+---
+
+## 12. Withdrawal of Consent
+If processing is based on consent, you may withdraw it at any time with future effect.
+
+---
+
+## 13. Data Security
+We apply appropriate technical and organizational measures to secure your data, including encryption, access controls, and backups.
+
+---
+
+## 14. Changes to this Privacy Policy
+We may update this Privacy Policy to reflect legal or functional changes.  
+The current version is always available at [https://fotospiel.app/privacy](https://fotospiel.app/privacy).

docs/legal/impressum-de.md

@@ -0,0 +1,62 @@
+# Impressum
+
+**Angaben gemäß § 5 TMG**
+
+Sören Eberhardt-Biermann  
+handelnd unter **„Die Fotospiel.App“**  
+Schweriner Str. 15  
+19306 Neustadt-Glewe  
+Deutschland  
+
+**Kontakt**  
+Telefon: 0173 / 926 6802  
+E-Mail: info@fotospiel.app  
+
+**Verantwortlich für den Inhalt nach § 18 Abs. 2 MStV:**  
+Sören Eberhardt-Biermann  
+Schweriner Str. 15  
+19306 Neustadt-Glewe  
+
+---
+
+## Wirtschafts-Identifikationsnummer
+
+Wirtschafts-Identifikationsnummer gemäß § 139c Abgabenordnung: **DE428754098**  
+*(Hinweis: Keine Umsatzsteuer-Identifikationsnummer nach § 27a UStG vergeben.)*
+
+---
+
+## Haftungsausschluss (Disclaimer)
+
+### Haftung für Inhalte
+Die Inhalte dieser Website wurden mit größter Sorgfalt erstellt. Für die Richtigkeit, Vollständigkeit und Aktualität der Inhalte kann der Anbieter jedoch keine Gewähr übernehmen.  
+Als Diensteanbieter ist der Anbieter gemäß § 7 Abs. 1 TMG für eigene Inhalte auf diesen Seiten nach den allgemeinen Gesetzen verantwortlich. Nach §§ 8 bis 10 TMG ist der Anbieter jedoch nicht verpflichtet, übermittelte oder gespeicherte fremde Informationen zu überwachen oder nach Umständen zu forschen, die auf eine rechtswidrige Tätigkeit hinweisen. Verpflichtungen zur Entfernung oder Sperrung der Nutzung von Informationen nach den allgemeinen Gesetzen bleiben hiervon unberührt. Eine diesbezügliche Haftung ist jedoch erst ab dem Zeitpunkt der Kenntnis einer konkreten Rechtsverletzung möglich. Bei Bekanntwerden entsprechender Rechtsverletzungen wird der Anbieter diese Inhalte umgehend entfernen.
+
+### Haftung für Links
+Das Angebot enthält Links zu externen Websites Dritter, auf deren Inhalte der Anbieter keinen Einfluss hat. Deshalb kann der Anbieter für diese fremden Inhalte auch keine Gewähr übernehmen. Für die Inhalte der verlinkten Seiten ist stets der jeweilige Anbieter oder Betreiber der Seiten verantwortlich. Bei Bekanntwerden von Rechtsverletzungen werden derartige Links umgehend entfernt.
+
+### Urheberrecht
+Die durch den Seitenbetreiber erstellten Inhalte und Werke auf dieser Website unterliegen dem deutschen Urheberrecht. Beiträge Dritter sind als solche gekennzeichnet.  
+Die Vervielfältigung, Bearbeitung, Verbreitung und jede Art der Verwertung außerhalb der Grenzen des Urheberrechts bedürfen der schriftlichen Zustimmung des jeweiligen Autors bzw. Erstellers.  
+Downloads und Kopien dieser Seite sind nur für den privaten, nicht kommerziellen Gebrauch gestattet.
+
+---
+
+## Bild- und Grafiknachweise
+
+Sofern auf dieser Website Bilder, Icons oder Grafiken Dritter verwendet werden, sind deren Quellen und Lizenzhinweise entsprechend gekennzeichnet oder in einer separaten Quellenübersicht angegeben.
+
+---
+
+## Alternative Streitbeilegung gemäß Art. 14 Abs. 1 ODR-VO und § 36 VSBG
+
+Die Europäische Kommission stellt eine Plattform zur Online-Streitbeilegung (OS) bereit:  
+[https://ec.europa.eu/consumers/odr/](https://ec.europa.eu/consumers/odr/)  
+
+Der Anbieter ist weder verpflichtet noch bereit, an Streitbeilegungsverfahren vor einer Verbraucherschlichtungsstelle teilzunehmen.
+
+---
+
+## Hinweis zur Geschäftsform
+
+Der Anbieter betreibt die Website als Einzelunternehmer. Eine Eintragung im Handelsregister besteht nicht.

docs/legal/impressum-en.md

@@ -0,0 +1,73 @@
+# Legal Notice (Impressum)
+
+**Information according to § 5 German Telemedia Act (TMG)**
+
+Sören Eberhardt-Biermann  
+doing business as **"Die Fotospiel.App"**  
+Schweriner Str. 15  
+19306 Neustadt-Glewe  
+Germany  
+
+**Contact**  
+Phone: +49 173 9266802  
+E-Mail: info@fotospiel.app  
+
+**Responsible for the content according to § 18 (2) German State Media Treaty (MStV):**  
+Sören Eberhardt-Biermann  
+Schweriner Str. 15  
+19306 Neustadt-Glewe  
+Germany  
+
+---
+
+## Business Identification Number
+
+Business Identification Number according to § 139c Fiscal Code (Abgabenordnung): **DE428754098**  
+*(Note: No VAT Identification Number according to § 27a German VAT Act has been issued.)*
+
+---
+
+## Disclaimer
+
+### Liability for Content
+The contents of this website were created with the greatest possible care.  
+However, the provider assumes no liability for the correctness, completeness, or up-to-date nature of the content.  
+As a service provider, the provider is responsible for its own content on these pages under the general laws in accordance with § 7 (1) TMG.  
+According to §§ 8 to 10 TMG, the provider is not obligated to monitor transmitted or stored third-party information or to investigate circumstances indicating illegal activity.  
+Obligations to remove or block the use of information in accordance with general laws remain unaffected.  
+However, liability in this regard is only possible from the time of knowledge of a specific infringement.  
+Upon becoming aware of such legal violations, the provider will remove this content immediately.
+
+### Liability for Links
+This website contains links to external websites of third parties, the content of which the provider has no influence over.  
+Therefore, the provider cannot assume any liability for this external content.  
+The respective provider or operator of the linked pages is always responsible for their content.  
+Links will be removed immediately upon notification of any infringement.
+
+### Copyright
+The content and works created by the site operator on this website are subject to German copyright law.  
+Contributions by third parties are marked as such.  
+Reproduction, editing, distribution, and any kind of exploitation outside the limits of copyright law require the written consent of the respective author or creator.  
+Downloads and copies of this site are permitted only for private, non-commercial use.
+
+---
+
+## Image and Graphic Credits
+
+If third-party images, icons, or graphics are used on this website, their sources and license information are properly indicated or listed in a separate reference section.
+
+---
+
+## Online Dispute Resolution according to Art. 14 (1) ODR-VO and § 36 VSBG
+
+The European Commission provides a platform for Online Dispute Resolution (ODR):  
+[https://ec.europa.eu/consumers/odr/](https://ec.europa.eu/consumers/odr/)  
+
+The provider is neither obliged nor willing to participate in dispute resolution proceedings before a consumer arbitration board.
+
+---
+
+## Note on Business Form
+
+The provider operates this website as a sole proprietor.  
+No entry in the commercial register exists.

docs/wireframes/PWA_Wireframes.txt

@@ -0,0 +1,189 @@
+
+# 📱 PWA Wireframes (Markdown)
+
+## Landingpage
+--------------------------------------------------
+HEADER
+[ Willkommen bei Fotochallenge 🎉 ]
+
+HAUPTBEREICH
+Eingabe-Feld: [ QR-Code / Event-PIN ]
+Button: [ ➡️ Event beitreten ]
+
+FOOTER
+(none)
+--------------------------------------------------
+
+## Profil-Setup
+--------------------------------------------------
+HEADER
+[ Profil erstellen ]
+
+HAUPTBEREICH
+Eingabefeld: [ Dein Name ]
+Option: Avatar wählen (Rund-Icons)
+
+Button: [ ✅ Starten ]
+--------------------------------------------------
+
+## Startseite (Home)
+--------------------------------------------------
+HEADER
+[ Hochzeit Anna & Tom 🎉 ]   (Avatar rechts)
+📸 Dein Fotospiel zur Hochzeit – mach Aufgaben & teile Momente
+
+INFO-BAR
+👥 37 Gäste online   |   ✅ 142 Aufgaben gelöst
+
+HAUPTBEREICH
+[ 🎲 Aufgabe ziehen ]          (großer Button, primär)
+[ 😊 Wie fühlst du dich? ]     (großer Button, sekundär)
+
+(kleiner Link unterhalb:)
+[ 📸 Einfach ein Foto machen ]
+
+GALERIE / FEED
+Filter: [ Neueste ]  [ Beliebt ]  [ Meine ]
+
+Foto-Kacheln mit ❤️ Like-Icon
+--------------------------------------------------
+FOOTER-NAVI
+🏠 Start    🎲 Aufgaben    🏆 Achievements    🖼️ Galerie
+--------------------------------------------------
+
+## Aufgaben-Picker
+--------------------------------------------------
+HEADER
+[ 🎲 Aufgabe ziehen ]  (X schließen)
+
+HAUPTBEREICH
+Option A: Zufallsaufgabe sofort anzeigen
+Option B: Stimmung wählen (Emoji-Grid)
+
+😊 Emotionen (Grid):
+🤪 Albern   🕺 Energetisch   🤗 Herzlich
+😎 Cool     🧑‍🤝‍🧑 Gemeinsam  🧠 Kreativ
+😌 Ruhig    🎯 Mutig
+
+Optional:
+Slider "Energie-Level"
+[ 🔋 niedrig | 🔋 mittel | 🔋 hoch ]
+
+BUTTON
+[ 👉 Aufgabe anzeigen ]
+--------------------------------------------------
+
+## Aufgaben-Detail (Karte)
+--------------------------------------------------
+HEADER
+[ 🤪 Albern ]   (X schließen)
+
+AUFGABEN-KARTE
+📸 Aufgabe:
+"Mach ein Selfie, bei dem alle in die falsche Richtung schauen."
+
+⏱️ Dauer: < 1 Min     👥 Gruppengröße: 2–5
+
+BUTTONS
+[ 📷 Los geht’s ] (Foto machen/hochladen)
+[ ↻ Neue Aufgabe ] (gleiche Stimmung)
+[ 😊 Andere Stimmung wählen ] (zurück zum Picker)
+--------------------------------------------------
+
+## Kamera/Upload
+--------------------------------------------------
+HEADER
+[ 📷 Foto aufnehmen ]
+
+HAUPTBEREICH
+[ Kamera öffnen ] oder [ Foto hochladen ]
+
+Nach Upload:
+✅ „Foto erfolgreich hochgeladen 🎉“
+
+BUTTON
+[ Galerie ansehen ]
+--------------------------------------------------
+
+## Galerie (Übersicht)
+--------------------------------------------------
+HEADER
+[ 📸 Galerie ]  (Filter oben)
+
+FILTER
+[ Neueste ] [ Beliebt ] [ Meine ]
+
+FOTOS (Kachel- oder Feed-Ansicht)
+[ ❤️ 12 ] Foto 1
+[ ❤️  5 ] Foto 2
+[ ❤️ 21 ] Foto 3
+...
+
+Tap → öffnet Foto-Detail
+--------------------------------------------------
+
+## Foto-Detailansicht
+--------------------------------------------------
+HEADER
+[ X Schließen ]
+
+HAUPTBEREICH
+📷 Foto im Vollbild
+
+UNTER DEM FOTO
+❤️ 23 Likes   🎉 4 Reaktionen
+📸 Aufgabe: "Gruppenfoto mit mindestens 5 Personen"
+👤 Hochgeladen von: „Lisa“
+
+BUTTON
+[ ❤️ Like ]
+--------------------------------------------------
+
+## Achievements / Erfolge
+--------------------------------------------------
+HEADER
+[ 🏆 Meine Erfolge ]
+
+HAUPTBEREICH
+Badges:
+🎊 Erstes Foto
+🏅 5 Aufgaben erledigt
+🔥 Beliebtestes Foto
+👯 Gruppenfoto-König
+
+Fortschritt-Balken: (xx / yy Aufgaben)
+--------------------------------------------------
+
+## Optionale Seiten
+
+### Slideshow / Präsentation
+--------------------------------------------------
+HEADER
+[ 📽️ Slideshow-Modus ]
+
+HAUPTBEREICH
+- Vollbild-Diashow der Galerie
+- Automatischer Wechsel alle 5 Sek.
+- Anzeige: Likes & Aufgabe
+--------------------------------------------------
+
+### Admin-Panel
+--------------------------------------------------
+HEADER
+[ 👑 Admin-Panel ]
+
+HAUPTBEREICH
+- Fotos moderieren (löschen, hervorheben)
+- Teilnehmer-Übersicht
+--------------------------------------------------
+
+### Event-Abschluss
+--------------------------------------------------
+HEADER
+[ 🎉 Danke fürs Mitmachen! ]
+
+HAUPTBEREICH
+- Zusammenfassung: Anzahl Fotos, Aufgaben, Likes
+- QR-Code oder Link zur Online-Galerie
+- „Bis bald ❤️“
+--------------------------------------------------