DJ-Software: Engine, Analyse, Sammlung, Oberfläche und Fernsteuerung

.env.example

@@ -0,0 +1,28 @@
+# Kopie als .env anlegen und ausfüllen. .env ist in .gitignore — Keys gehören
+# niemals ins Repo.
+
+# --- Musikgenerierung ---------------------------------------------------
+
+# ElevenLabs Music — vorgesehener Startadapter (siehe docs/APIS.md)
+ELEVENLABS_API_KEY=
+
+# Suno — aktuell KEINE öffentliche API verfügbar (Stand August 2026).
+# Platzhalter für den Fall, dass die Bewerbung beim Partner-Programm
+# durchgeht. Bis dahin leer lassen.
+SUNO_API_KEY=
+
+# Stable Audio (Stability AI) — Alternative für instrumentale Texturen
+STABILITY_API_KEY=
+
+# --- Samples ------------------------------------------------------------
+
+# Freesound APIv2 — kostenlos für nicht-kommerzielle Nutzung
+FREESOUND_API_KEY=
+
+# --- Lokale Pfade -------------------------------------------------------
+
+# Wohin generierte Tracks geschrieben werden
+GENERATED_DIR=./generated
+
+# Bestehende Traktor-Sammlung für den Import (docs/TRAKTOR-REFERENZ.md)
+# TRAKTOR_COLLECTION_PATH=

.github/workflows/ci.yml

@@ -0,0 +1,45 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  check:
+    name: fmt, clippy, tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      # CPAL bindet unter Linux gegen ALSA.
+      - name: ALSA-Header installieren
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libasound2-dev
+
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: rustfmt, clippy
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Formatierung
+        run: cargo fmt --all -- --check
+
+      - name: Clippy
+        run: cargo clippy --all-targets -- -D warnings
+
+      - name: Tests
+        run: cargo test --all
+
+      # Das Freigabe-Gatter ist Python und braucht keine laufende Anlage —
+      # geprüft wird das Gatter, nicht die Anwendung. Ohne diesen Schritt wären
+      # seine Wächter Dekoration: Sie liefen nur, wenn jemand daran denkt.
+      - name: Freigabe-Gatter
+        run: |
+          python3 -m pip install --quiet pytest
+          python3 -m pytest -q mcp/musik/tests/test_freigabe.py

.gitignore

@@ -3,6 +3,12 @@
 .env.*
 !.env.example
 
+# Rust — Cargo.lock wird bewusst eingecheckt (Anwendung, keine Bibliothek)
+/target/
+
+# Analyse-Sidecars (aus dem Audio reproduzierbar)
+.musik-analyse/
+
 # Node
 node_modules/
 dist/