BLUNAA.COM

01Projektübersicht

BLUNAA.COM ist die persönliche Website von Blunaa – DJ, Producer und Technik-Enthusiast aus Berlin. Ausgeliefert werden zwei lauffähige Website-Varianten (serverloses HTML für Strato-Basic-Hosting und eine Flask/Python-Version mit SMTP-Mailversand), ergänzt um eine native Android-App und einen separaten FPV-Tuning-Guide.

02Versionshistorie

03Architektur & Struktur

Serverlose HTML-Version (Strato direkt)

blunaa-strato_v4.0/
├── index.html                          ← Hauptseite (13 Sektionen inline)
├── agb.html                            ← AGB als eigene Seite
├── docs.html                           ← Diese Dokumentation
├── doc_flylens75-betaflight46-tuning_v1.0.pdf
├── doc_flylens75-betaflight46-cli_v1.0.txt
├── doc_flylens75-bf2025-12-tuning_v2.0.pdf      (überholt, siehe v3.0)
├── doc_flylens75-bf2025-12-cli_v2.0.txt         (überholt, siehe v3.0)
├── doc_flylens75-bf2025-12-pid-correction_v3.0.pdf  (empfohlen)
├── doc_flylens75-bf2025-12-cli_v3.0.txt             (empfohlen)
├── doc_flylens75-esc-bluejay_v1.0.pdf
├── doc_flylens75-esc-bluejay_v1.0.txt
├── doc_flylens75-fpv-master-guide_v1.0.pdf      (Gesamt-Anleitung, 8 Phasen)
├── doc_android-apk-anleitung_v1.0.pdf
└── images/
    ├── img_hero-bg_orig.jpg
    ├── img_bio-portrait_orig.jpg
    ├── img_logo-header_v4-split.png   ← Hero-Logo (ersetzt Text)
    └── img_{motiv}_{orig|ai-v1..3|web-v1..3}.jpg

Flask/Python-Version (server-basiert)

blunaa-flask_v4.0/
└── v3-python/
    ├── app.py                    ← Flask-App: 15 Routen + APIs
    ├── mail_service.py           ← SMTP E-Mail-Versand (Strato)
    ├── passenger_wsgi.py         ← Strato Phusion Passenger
    ├── requirements.txt          ← flask, gunicorn, python-dotenv
    ├── templates/
    │   ├── base.html             ← Basis (Sidebar, Banner, Mobile, Footer)
    │   ├── pages/                ← 12 Seiten (inkl. agb.html, impressum.html)
    │   └── components/           ← 11 Inhalts-Komponenten
    └── static/
        ├── css/, js/
        └── images/                ← identische Bildbibliothek wie Strato-Version

Android-App

blunaa-android-app_v1.0/
├── app/src/main/
│   ├── java/com/blunaa/app/MainActivity.java   ← WebView-Logik
│   ├── res/layout, values, xml, mipmap-*       ← UI + Icons (5 Dichten)
│   └── AndroidManifest.xml
├── .github/workflows/build-apk.yml             ← Cloud-Build (GitHub Actions)
├── doc_android-apk-anleitung_v1.0.pdf           ← Einsteiger-Bauanleitung
└── README.md

04Funktionen (Features)

• SoundCloud-Player-Einbindung (soundcloud.com/blunaa)
• Event-Liste mit Resident-Advisor-Verlinkung, Blunaa als erster DJ-Act bei jedem Event
• Bildergalerie mit Original- und Alternativ-Bildern je Motiv
• Blog-Sektion (IoT/ESP32, FPV, Amateurfunk-Themen)
• Kontaktformular mit Client- und Server-Validierung
• Impressum als eigener Bereich, AGB als separate Seite mit zwei Zurück-Buttons
• Mobile Hamburger-Menü mit Android-touchend-Fix (vorher: Klick ohne Reaktion auf Android)
• Parallax-Hero-Bereich ohne sichtbaren Rahmen (vorheriger blauer Kasten entfernt)
• BLUNAA-Logo (Split-Color-Variante v4) im Hero-Bereich statt reinem Text — beide Plattformen

05Mobile-Responsiveness

Die Website ist vollständig mobile-optimiert. Die Sidebar verwandelt sich auf kleinen Bildschirmen in ein Overlay-Menü mit Hamburger-Button. Ein vorheriger Bug, bei dem Tippen auf Android-Geräten keine Reaktion zeigte, wurde behoben (siehe Box unten).

Breakpoints

Touch-Optimierungen

• Alle klickbaren Elemente: min-height: 44px (Apple HIG Empfehlung)
• touchend-Listener zusätzlich zu click für zuverlässige Android-Unterstützung
• Body-Scroll wird gesperrt wenn Menü offen (overflow: hidden)
• Menü schließt zuverlässig vor dem Scrollen zur Zielsektion (kein Race-Condition mehr)

Implementierung (Auszug)

function handleLinkTap(e) {
  e.preventDefault();
  e.stopPropagation();
  var target = document.getElementById(link.getAttribute('data-target'));
  closeMenu();
  setTimeout(function() {
    window.scrollTo({ top: targetTop, behavior: 'smooth' });
  }, 350);
}
link.addEventListener('click', handleLinkTap);
link.addEventListener('touchend', handleLinkTap, { passive: false });

06E-Mail-Versand (Strato SMTP)

In der Flask-Version wird das Kontaktformular per Strato SMTP direkt an booking@blunaa.com gesendet. In der serverlosen HTML-Version öffnet das Formular den lokalen E-Mail-Client (mailto:).

Strato SMTP Konfiguration

Setup in 2 Schritten

Schritt 1: Umgebungsvariablen setzen (z. B. in einer lokalen .env-Datei, die nicht mit ausgeliefert wird):

MAIL_USER=booking@blunaa.com
MAIL_PASS=DEIN_STRATO_EMAIL_PASSWORT
MAIL_FROM=booking@blunaa.com
MAIL_TO=booking@blunaa.com

Schritt 2: Testen:

python3 mail_service.py
curl -X POST http://localhost:5000/api/contact \
  -H "Content-Type: application/json" \
  -d '{"name":"Test","email":"test@test.de","subject":"Hallo","message":"Test"}'

Validierungs-Checks (Server-seitig)

• Leere Felder → Fehlerliste mit Feldnamen
• HTML-Tags (<script> etc.) → blockiert
• Sonderzeichen (< > " ' ; & { } \) → blockiert
• SQL-Keywords (SELECT, DROP, UNION…) → blockiert
• E-Mail-Format (RFC-5322 vereinfacht) → validiert
• Maximale Längen (Name 80, E-Mail 120, Nachricht 2000) → geprüft

07Impressum & AGB

Impressum und AGB sind seit v2.6/v3.0 strukturell getrennt:

• Impressum bleibt im Hauptscroll der Website (gesetzlich notwendige Angaben gemäß §5 TMG)
• AGB wurden aus dem Hauptscroll entfernt und liegen auf einer eigenen Seite (agb.html bzw. /agb)
• AGB-Seite hat oben und unten je einen "Zurück zur Hauptseite"-Button
• AGB ist ein eigener, letzter Menüpunkt in der Sidebar
• Personenbezogene Daten (Name) befinden sich ausschließlich im Impressum, nirgendwo sonst auf der Website

Aufruf

08Deployment & Upload

Option A: Serverlos (empfohlen für Strato Basic)

ZIP: blunaa-strato_v4.0.zip

1. ZIP entpacken
2. WinSCP öffnen → Strato FTP/SFTP Verbindung (Port 22)
3. index.html + agb.html + docs.html → Root /html/
4. images/ Ordner → /html/images/
5. Browser: http://blunaa.com aufrufen

Option B: Flask/Python (für SMTP E-Mail)

ZIP: blunaa-flask_v4.0.zip

cd ~/blunaa
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
export MAIL_PASS="DEIN_PASSWORT"   # Umgebungsvariable statt .env-Datei
gunicorn --bind 0.0.0.0:5000 app:app

Option C: Android-App

ZIP: blunaa-android-app_v1.0.zip — siehe Kapitel 10 & 11 für Details.

09Wichtige CLI-Befehle (Web)

Flask starten

cd v3-python
python3 -m venv venv && source venv/bin/activate
pip install -r requirements.txt
python3 app.py

E-Mail testen

python3 mail_service.py

Health-Check

curl http://localhost:5000/api/health

Alle Routen prüfen

python3 -c "
import app
for rule in app.app.url_map.iter_rules():
    print(rule)
"

10Android-App – Übersicht

Native Android-App auf WebView-Basis, die blunaa.com lädt – mit eigenem Icon auf dem Homescreen, statt eines Browser-Tabs.

11APK selbst bauen – Einsteiger-Guide

Vollständige Schritt-für-Schritt-Anleitung als separates PDF beigelegt: doc_android-apk-anleitung_v1.0.pdf. Kurzüberblick der zwei beschriebenen Wege:

Weg A: Android Studio (lokal, empfohlen für Einsteiger)

1. Android Studio kostenlos von developer.android.com/studio herunterladen und installieren
2. Projektordner blunaa-android-app über "Open" öffnen
3. Gradle-Sync abwarten (lädt automatisch alle Abhängigkeiten)
4. Build → Build Bundle(s) / APK(s) → Build APK(s)
5. Fertige Datei: app/build/outputs/apk/debug/app-debug.apk

Weg B: GitHub Actions (Cloud-Build, ohne lokale Installation)

Das Projekt enthält bereits eine fertige Workflow-Datei (.github/workflows/build-apk.yml), die bei jedem Hochladen automatisch eine APK in der Cloud baut – kein eigener Computer mit Android Studio nötig.

# Kurzfassung des automatischen Workflows
on: push                    # startet bei jedem Hochladen
java-version: 17            # wird automatisch eingerichtet
./gradlew assembleDebug     # baut die APK
upload-artifact             # APK steht danach zum Download bereit

Installation auf dem Handy

• APK auf das Handy übertragen (USB, E-Mail, Cloud-Speicher)
• Einstellungen → Apps → "Unbekannte Apps installieren" für die verwendete App erlauben
• APK-Datei antippen → Installieren

13ESC-Configurator & Bluejay Setup — Flywoo Flylens 75 HD O4 2S

Bevor das PID-/Filter-Tuning in Kapitel 14 sinnvoll ist, muss die ESC-Firmware auf dem GOKU F405 BGA 12A 4-in-1 ESC korrekt konfiguriert sein. Der Stack läuft ab Werk meist mit Stock-BLHeli_S (Version 16.7, eingefroren, ohne RPM-Telemetrie). Bluejay ist die von Betaflight offiziell empfohlene Open-Source- Ersatzfirmware für diese Busy-Bee-ESCs und schaltet bidirektionales DShot frei — die technische Grundvoraussetzung für den RPM-Filter im nachfolgenden PID-Guide.

Warum Bluejay statt Stock-BLHeli_S?

• Stock-BLHeli_S: keine RPM-Telemetrie, keine bidirektionale DShot-Unterstützung
• Bluejay: von Betaflight offiziell empfohlen für Busy-Bee-MCU-ESCs (BB1/BB21/BB51)
• Schaltet RPM-Filterung und EDT-Telemetrie frei — Basis für sauberes PID-Tuning
• Kostenlos, Open-Source, über esc-configurator.com direkt im Browser flashbar

Empfohlene Konfiguration (Kernwerte)

Betaflight-seitige Pflicht-Nacharbeit nach dem Flash

set dshot_bidir = ON
set motor_pwm_protocol = DSHOT300
set motor_poles = 12
save

13FPV Drohnen Hub — Website-Struktur

Die FPV-Inhalte sind seit v3.9 nicht mehr als knappe Sektion auf der Hauptseite untergebracht, sondern als eigener Bereich mit Hub-Seite und 5 thematischen Unterseiten — sowohl in der Strato- als auch der Flask-Version identisch.

Design-Entscheidung: eigenständiges dunkles Theme

Die FPV-Unterseiten nutzen bewusst ein eigenständiges, dunkleres Farbschema (statt der Sidebar-Navigation der Hauptseite) — passend zum technischen, Betaflight-CLI-nahen Charakter der Inhalte, mit aufklappbaren Versions-Akkordeons für den Tuning-Verlauf, damit die Seite trotz sieben Versionen übersichtlich bleibt.

14Betaflight Tuning Guide — Flywoo Flylens 75 HD O4 2S

Vollständiger PID- und Filter-Tuning-Guide für den Flywoo Flylens 75 HD O4 2S (GOKU F405 BGA · ROBO 1003 · 1611-3 Props · TBS Crossfire · DJI O4 Air Unit). Liegt in sechs Versionen vor: v1.0 für Betaflight 4.6, v2.0 für Betaflight 2025.12, v3.0 — eine evidenzbasierte PID-Korrektur von v2.0, v4.0 — basierend auf eigenen Blackbox- Flugdaten (Konfiguration), v5.0 — basierend auf echter Zeitreihen-Telemetrie (FFT-Analyse) und v6.0 — vollständiger, verifizierter CLI-Dump (vormals teils fälschlich als "4.7" bezeichnet (offiziell auch "4.6" genannt) — Betaflight ist seit Ende 2025 auf ein kalenderbasiertes Versionsschema YYYY.M.PATCH umgestiegen). PID-Tuning und Filter-Tuning stehen in allen Dokumenten bewusst am Anfang.

v6.0 — Gefundene Dokumentationsfehler (durch zweiten Dump entdeckt)

v6.0 — Vollständige Raten-Konfiguration (erstmals verfügbar)

v5.0 — Filter-Korrektur aus FFT-Analyse (historisch, in v6.0 übernommen)

PID-Werte — tatsächlich geflogen vs. v4.0 (aktuell empfohlen)

Historische Version: PID-Werte Profil 0 — Korrektur v2.0 → v3.0

Diese Tabelle bleibt als Zwischenschritt- Dokumentation erhalten. Aktuell empfohlen ist v4.0 (siehe oben).

Was hat sich in Betaflight 2025.12 geändert?

PID-Werte Profil 0 — Vergleich v1.0 → v2.0 (historische Referenz, überholt)

Diese Tabelle zeigt die ursprüngliche v2.0-Anpassung gegenüber v1.0. Die v2.0-Werte selbst wurden in v3.0 (siehe oben) korrigiert — diese Tabelle bleibt nur als historische Dokumentation der Entwicklung erhalten.

Filter-Tuning — Vergleich v1.0 → v2.0

Neues Tuning-Tool: Chirp Signal Generator (nur 2025.12)

• Einem Switch im Modes-Tab zuweisen ("Chirp/Tuning Mode")
• Im Flug aktivieren: sendet automatisierte Testoszillationen an Roll, Pitch, Yaw
• Blackbox-Log danach präzise auswerten — deutlich genauer als manuelles Stick-Wackeln
• Notch-Frequenzen anpassen, wenn klare Resonanzspitzen sichtbar werden

Wichtigster Workflow-Grundsatz (gilt für beide Versionen)

• RPM-Filter und Motor-Pole-Zahl zuerst korrekt einstellen, vor jedem PID-Tuning
• Bei 2025.12: Board-Alignment vor allem anderen im Setup-Tab visuell prüfen
• Immer nur eine Variable gleichzeitig ändern, mit Blackbox-Logging testen
• Nach Erstflug: Motoren-Temperatur prüfen → bei Überhitzung mehr Filterung, bei Lag weniger
• Kein CLI-diff/dump aus Versionen vor 4.5/2025.12 einfügen — Datenstruktur inkompatibel

15Bildbibliothek (Original + Alternativen)

Alle Bilder folgen ab v3.0 der einheitlichen Namenskonvention: img_{bereich}-{motiv}_{typ}.jpg

Dateiübersicht Bildbibliothek

Beiliegende Dokumente zur Bildbibliothek

• doc_web-bildquellen_v1.0.pdf — Alle 24 Web-Bildvorschläge (3 je Motiv) als Tabelle + Lizenz-Hinweise + Empfehlungen für lizenzsichere Quellen (unsplash, pexels, pixabay)
• doc_web-bildquellen_v1.0.txt — Dieselben Informationen als reine Textdatei

16Dateiübersicht & Namenskonvention (v3.0)

Download-Pakete (aktuelle Versionen)

Beiliegende Dokumente

Wichtige Einzeldateien in den ZIPs

17Datenschutz / DSGVO-Status

Was wurde bereinigt?

• Bürgerlicher Name aus index.html entfernt (alle 4 Vorkommen außerhalb Impressum)
• Bürgerlicher Name aus impressum_content.html (Flask) entfernt
• Impressum enthält nur noch: Blunaa, Adresse, booking@blunaa.com
• DSGVO-Löschungsanfragen an 10 Datenmakler/Plattformen erstellt

Rechtlicher Hinweis (§5 TMG)

DSGVO-Löschungsanfragen

Vollständige Briefvorlagen: doc_dsgvo-loeschungsanfragen_v1.0.txt

18BLUNAA_STATE – Projekt-Flag

Internes State-Flag-System für lückenlose Fortsetzung aller Aufgaben ohne erneute Vollprüfung. Befehl zum Fortfahren: BLUNAA_CONTINUE

Aktueller State (v1.15 – 17.06.2026)

State-Flag Format

╔══════════════════════════════════════════════════════════════╗
║  BLUNAA_STATE vX.X – TT.MM.JJJJ                            ║
║  Fortsetz-Befehl: BLUNAA_CONTINUE                           ║
╠══════════════════════════════════════════════════════════════╣
║  ✅ ERLEDIGT / 📦 ZWISCHENERGEBNISSE / 🔲 OFFEN             ║
╚══════════════════════════════════════════════════════════════╝