# Amputek Ecosystem Architecture Manifesto

Dieses Dokument beschreibt die Architektur und das Zusammenspiel der vier Hauptprojekte im Gravity-Workspace.

## Übersicht der Komponenten

1. **MakeMusic Studio (Kern-DAW)**
   - **Technologie:** Capacitor / Web-Technologien (HTML, CSS, JS), WASM, PyInstaller (Python Backend).
   - **Rolle:** Das Herzstück. Eine 64-Kanal-DSP-Audioworkstation mit hochdetaillierter Skeuomorphismus-Oberfläche ("High-End Dark Industrial").
   - **Features:** Hardware-Simulation, VST-Support, Echtzeit-Metering (33ms Loop), Oszilloskop-Visualizer, AI-Vocalist (ONNX), JamMesh-Server.

2. **Amputek Companion**
   - **Technologie:** React Native (Expo).
   - **Rolle:** Mobile Fernsteuerung.
   - **Features:** Verbindet sich via `StudioSyncService.js` (WebSockets) mit der Desktop-Instanz. Ermöglicht Remote-Steuerung von Transport-Befehlen (Play, Stop, Record) und bietet Remote-Ansichten für Equalizer und Mischpult.

3. **PhilPic_Project**
   - **Technologie:** Flutter.
   - **Rolle:** Standalone-Dienstprogramm zur KI-gestützten Bildgenerierung und -bearbeitung.
   - **Features:** Nutzt lokal integrierte ONNX-Modelle (z. B. UNet-Tensoren) für die Bildverarbeitung. 

4. **VST-Creator**
   - **Technologie:** Python (PyInstaller).
   - **Rolle:** Toolchain zur Kompilierung von VSTs und Standalone-Audio-Executables.
   - **Features:** Liest Signatur-Skripte und Audio-Logik, kompiliert diese via `export_standalone.py` zu verteilbaren Executables (`Legacy-VST-Master.exe`).

5. **ImageRescueFinder**
   - **Technologie:** .NET (C# Console/WPF).
   - **Rolle:** Utility-Tool zur Datenrettung.
   - **Features:** Prüft Dateien auf "Magic Bytes" (Signatur-Validierung), um gelöschte oder beschädigte Bilder (JPG/PNG) zuverlässig wiederherzustellen.

## Netzwerk-Topologie (JamMesh)

Das **JamMesh** ist das proprietäre Netzwerkprotokoll des Ökosystems.
* **Server:** Die MakeMusic-Instanz öffnet einen lokalen WebSocket-Server (Port `8765`), wenn die "KI-Wall" (Netzwerk-Firewall) konfiguriert ist.
* **Client:** Die `AmputekCompanion`-App klinkt sich als Client ein. Das Setup nutzt JSON-Payloads für `SYNC_STATE` und `TRANSPORT_PLAY/STOP`.

> [!TIP]
> Die Trennung von Audio-Logik (WASM/Python) und UI (HTML/React Native) garantiert, dass die Echtzeit-Audio-Latenz (0ms Feedback) nicht durch UI-Overhead beeinträchtigt wird.