GOAT BRIDGE — INSTALACJA W WINDOWS
==================================

1. Kliknij plik ZIP prawym przyciskiem i wybierz „Wyodrębnij wszystkie”.
2. Otwórz wypakowany folder.
3. Uruchom plik START-TUTAJ.bat. Otworzy on instalator w systemowym oknie cmd.exe.
   Jeżeli wolisz, możesz bezpośrednio uruchomić ZAINSTALUJ-GOAT-Bridge.cmd.
4. Wskaż foldery eksportów R Trader Pro, DeepCharts oraz opcjonalnie XTB,
   IBKR lub innego brokera.
5. Po instalacji GOAT Bridge uruchomi się w czarnym oknie.
6. Skopiuj wyświetlony token i wklej go w GOAT Ledger → Połączenia.
7. Dla każdego kolejnego konta wybierz jego mapowanie w GOAT Ledger i użyj
   „Połącz z chmurą”. Bridge zachowa wszystkie wcześniejsze parowania.
   Aby bezpiecznie usunąć mapowanie, najpierw kliknij przy nim „Rozłącz chmurę”.
   Gdy Bridge był wyłączony, uruchom go i kliknij „Wyczyść Bridge”, aby usunąć lokalną kolejkę tego konta.
8. Aby odbierać wykonania Rithmic/Lucid na żywo, uruchom z katalogu instalacji
   plik Uruchom-Rithmic-Na-Zywo.cmd. Wskaż pobrany od Rithmic folder 0.90.0.0,
   wybierz system z listy i podaj dane logowania w lokalnym oknie. Hasło nie
   jest zapisywane i nie jest wysyłane do GOAT Ledger.

GOAT Bridge wymaga oficjalnej wersji Node.js 20 lub nowszej:
https://nodejs.org/en/download/

DIAGNOSTYKA
-----------

Po instalacji uruchom Sprawdz-GOAT-Bridge.cmd, jeżeli Bridge nie startuje albo
nie widzi raportów. Diagnostyka sprawdzi wersję Node.js, kompletność plików,
konfigurację, dostęp do folderów, zapis lokalnego stanu i port. Nie loguje się
do brokera i nie wysyła danych na zewnątrz.

BEZPIECZEŃSTWO
--------------

- Bridge działa tylko na adresie 127.0.0.1, czyli na Twoim komputerze.
- Ma dostęp tylko do wskazanych folderów eksportów.
- Nie zapisuje loginu ani hasła do platformy.
- Nie potrafi składać, zmieniać ani anulować zleceń.
- Lokalny token parowania nie zmienia się po restarcie Bridge.
- Pakiet nie pobiera podczas instalacji żadnych dodatkowych skryptów.
- Otwarte pozycje są wyceniane wyłącznie wtedy, gdy adapter dostarcza świeżą
  cenę. Przy braku ceny journal wyświetla ten stan wprost.

POZYCJE DŁUGOTERMINOWE I ADAPTERY
---------------------------------

Raport XTB lub innego brokera można umieszczać w trzecim obserwowanym folderze.
Strumień wykonania/ceny może zasilać Bridge plikiem NDJSON przez:

  node "%LOCALAPPDATA%\GOATBridge\adapter-runtime.mjs" --file replay.ndjson --provider xtb --token TOKEN

Bezpośredni Rithmic wymaga oficjalnego dostępu R|Protocol/Plugin Mode. Gotowe
wejście znajduje się w rithmic-adapter.mjs; nie zapisuje danych logowania.
Oficjalny dostęp do R|Protocol można założyć pod adresem:
https://signup.rithmic.com/sdk/sdk.html
Rithmic Test nie wymaga conformance na etapie budowy. Przed dostępem do
produkcji Rithmic wymaga conformance oraz danych wydanych przez brokera lub FCM.
Jeśli Bridge jest chwilowo wyłączony lub restartuje się, adapter zatrzymuje
zaległą paczkę, ponawia wysyłkę i zachowuje kolejność kolejnych wykonań.
Parametr --outbox-file zapisuje kolejkę lokalnie, aby przetrwała także restart
adaptera lub komputera.

Jeżeli Windows pokaże ostrzeżenie „Nieznany wydawca”, oznacza to, że pakiet
nie ma jeszcze płatnego podpisu cyfrowego. Nie wyłączaj programu antywirusowego.
Sprawdź, czy plik został pobrany z https://goatledger.pl.
AKTUALIZACJA CEN POZYCJI XTB / DLUGOTERMINOWYCH

Po uruchomieniu GOAT Bridge możesz uruchomić plik
"Uruchom-Adapter-Notowan.cmd". Adapter cyklicznie odczytuje ceny z pliku JSON
i aktualizuje niezrealizowany wynik otwartych pozycji. Nie loguje się do brokera
i nie może składać zleceń. Nie prosi ponownie o token: odczytuje lokalny token
bezpośrednio ze stanu uruchomionego GOAT Bridge i nie pokazuje go na liście procesów.

Przykładowa zawartość pliku z cenami:
{"AAPL":231.50,"VWCE.DE":137.42}

Jeżeli źródło i raport brokera używają innych symboli, można wskazać dodatkowy
plik mapowania, np. {"AAPL":"AAPL.US"}.
