initial release: GizerBridge v1.0

2026-05-22 12:27:27 +02:00
commit b2e4a8b46a
23 changed files with 2773 additions and 0 deletions
@@ -0,0 +1,118 @@
+# GizerBridge – Sierra Chart → Tralgo Analytics
+
+Überträgt abgeschlossene Trades automatisch von Sierra Chart (Wine/Bottles/Lutris)
+an Tralgo Analytics.
+
+---
+
+## Installation
+
+### Schritt 1 – Terminal öffnen
+
+Rechtsklick auf den Desktop → **"Terminal öffnen"**
+(oder im App-Menü nach "Terminal" suchen)
+
+### Schritt 2 – In den App-Ordner wechseln
+
+```
+cd ~/Downloads/gizerbridge
+```
+
+### Schritt 3 – Installations-Script ausführen
+
+```
+bash install.sh
+```
+
+Das Script installiert alle benötigten Komponenten automatisch.
+
+### Schritt 4 – App starten
+
+Im App-Menü (z. B. Activities) nach **"GizerBridge"** suchen und starten.
+
+---
+
+## Erster Start – Einrichtung
+
+Beim ersten Start öffnet sich automatisch das **Einstellungs-Fenster**:
+
+| Feld | Was hier einzutragen ist |
+|------|--------------------------|
+| **API Key** | Der `transfer_token` aus deinem Tralgo-Konto |
+| **Tralgo E-Mail** | Deine Login-E-Mail (nur zur Anzeige) |
+| **SC DTC Host** | Normalerweise `localhost` |
+| **SC DTC Port** | Normalerweise `11099` |
+| **Konten** | Kontonamen genau wie in Sierra Chart (z. B. `4PRO-RQTPUT`, `Sim1.simulated`) |
+| **Instrumente** | Gewünschte Instrumente aktivieren, Tick-Werte prüfen |
+
+Nach dem Speichern startet die App sofort mit der Überwachung.
+
+---
+
+## Tralgo-Login (einmalig pro 30 Tage)
+
+Damit die App Zugriff auf dein Konto hat, muss Firefox bei tralgo.app eingeloggt sein:
+
+1. **Firefox öffnen** und `tralgo.app` aufrufen
+2. Mit **E-Mail und Passwort** einloggen
+3. Den **2FA-Code** aus der E-Mail eingeben
+4. **"Für 30 Tage merken" aktivieren** ← Das ist wichtig!
+
+Die App liest den Login-Cookie aus Firefox – dein Passwort wird nirgends gespeichert oder übertragen.
+
+---
+
+## System-Tray Icon
+
+Nach dem Start erscheint ein farbiger Status-Dot auf dem Tray-Icon:
+
+- **Grün** – App läuft, wartet auf neue Trades
+- **Gelb** – Initialisierung
+- **Rot** – Fehler (Cookie abgelaufen, Verbindungsproblem, o.ä.)
+
+Rechtsklick auf das Icon → Öffnen · Manueller Import · Einstellungen · Log · Beenden
+
+### Kein Tray-Icon sichtbar? (GNOME)
+
+GNOME zeigt Tray-Icons nur mit der **AppIndicator Extension**:
+
+1. Im Browser `extensions.gnome.org` öffnen
+2. Nach **"AppIndicator and KStatusNotifierItem Support"** suchen
+3. Extension installieren und aktivieren
+4. GizerBridge neu starten
+
+---
+
+## Was passiert im Hintergrund?
+
+- Die App verbindet sich via DTC-Protokoll direkt mit Sierra Chart (localhost:11099)
+- Beim **ersten Start** werden bereits vorhandene Trades als "bekannt" markiert
+  und **nicht** übertragen (verhindert Duplikate)
+- Nur **neue** Trades nach dem Start werden an Tralgo gesendet
+- Bereits gesendete Trade-IDs werden in `~/.gizerbridge_sent.json` gespeichert
+- Die Konfiguration liegt in `~/.gizerbridge_config.json` (nur für dich lesbar)
+
+---
+
+## Sicherheit
+
+- **Kein Passwort** wird gespeichert oder übertragen
+- Die Firefox-Cookie-Datenbank wird nur als temporäre Kopie gelesen (nie verändert)
+- Die Config-Datei mit dem API Key hat Zugriffsrechte `600` (nur dein Benutzer)
+
+---
+
+## Fehlerbehebung
+
+| Problem | Lösung |
+|---------|--------|
+| "Cookie fehlt" Popup | In Firefox bei tralgo.app neu einloggen, "Für 30 Tage merken" aktivieren |
+| Rotes Icon, Übertragungsfehler | Internetverbindung prüfen; Status-Fenster für Details öffnen |
+| Keine Trades erkannt | Kontonamen in den Einstellungen mit SC-Kontonamen abgleichen |
+| DTC-Verbindungsfehler | Sierra Chart öffnen, DTC-Server auf Port 11099 aktivieren |
+
+Log der letzten 50 Aktionen: Rechtsklick auf Tray-Icon → **"Log"**
+
+---
+
+*Ein Projekt von [GizerLabs](https://gizerlabs.com)*