GPW CONSOLE — RETRO TERMINAL  v1.0  ::  gpwconsole.pl


  System skórowania spółek GPW połączony z live feedem komunikatów
  regulacyjnych ESPI/EBI i analizą sentymentu przez AI.
  Projekt hobbystyczny. Nie do celów komercyjnych.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## ŹRÓDŁO I CHARAKTERYSTYKA DANYCH
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Dane rynkowe    : biznesradar.pl — publiczne statystyki po sesji
  Odświeżanie     : automatyczne — pełny fetch Pn 03:00 (biznesradar, batchowany, ~5h)
                    szybki update cen Pn–Pt 08:00, 09:05 i 17:35 (Yahoo Finance)
                    lub ręcznie: POST /api/v1/admin/fetch
  Komunikaty ESPI : co 2 sekundy, Pn–Pt 07:00–23:00 (Warsaw)
  Analiza AI      : Anthropic Claude — sentyment, typ, streszczenie

  Priorytety źródeł (kolejność stosowania):
  1. biznesradar.pl — rekomendacje analityków, dywidendy, ceny po sesji
                      (pełny fetch Pn 03:00; dane cotygodniowe)
  2. Yahoo Finance  — bieżące ceny i momentum intraday
                      (update 08:00 / 09:05 / 17:35; dobre dla akcji .WA)
                      Indeksy WIG/WIG20: alias WIG-POLAND.WA i WIG20.WA
                      (^WIG i ^WIG20 mają błędne mapowanie na Yahoo)
  3. Zachowana wartość — jeśli żadne źródło nie odpowie, zostaje ostatni
                         znany wynik z poprzedniego fetcha

  ! Dane NIE są podawane w czasie rzeczywistym.
  ! Służą wyłącznie celom demonstracyjnym i edukacyjnym.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## ARCHITEKTURA I TECHNOLOGIA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  System działa jako monolit FastAPI zintegrowany z modelami LLM.
  Do analizy komunikatów regulacyjnych (ESPI/EBI) wykorzystujemy
  Anthropic Claude (Sonnet).

  Import portfela XTB (zakładka [4] PORTFOLIO):
  Parsowanie     : przeglądarka (JavaScript + SheetJS)
  Przechowywanie : localStorage (lokalnie w przeglądarce użytkownika)
  Upload pliku   : BRAK — plik XLSX nigdy nie opuszcza urządzenia
  Sieć           : tylko anonimowe zapytania o aktualne ceny (GET /market/prices)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## OPIS ZAKŁADEK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  [0] CHANGELOG
      Historia wersji projektu, pobierana na żywo z CHANGELOG.md.
      Legenda: [+] nowa funkcja · [*] ulepszenie · [-] bugfix ·
      [!] breaking change · [AI] Claude / ESPI.

  [1] TOP_10
      Ranking spółek GPW według systemu punktowego (maks. 110 pkt):

      A  20 pkt  Dyskonto kursu do mediany ceny docelowej (cap 30%,
                 rekomendacje starsze niż 180 dni pomijane)
      B  15 pkt  Jakość rekomendacji (liczba, domy, wiek, konsensus)
      C  25 pkt  Momentum relatywne vs WIG140, blend 3M/6M (info, patrz CF)
      D  10 pkt  Płynność obrotu — min. 500 000 PLN/sesję lub dyskwal.
      E   5 pkt  Stopa dywidendy (cap 10%)
      F  25 pkt  Sentyment ESPI, ost. 60 dni, analiza AI (info, patrz CF)
      CF 50 pkt  Interakcja C×F — zastępuje C i F w sumie końcowej.
                 Wzór: CF = (0,5×C + 0,5×F) × korekta × 50
                 korekta = ×0,9 gdy |C−F| > 0,5 (sygnały sprzeczne)
                         = ×1,1 gdy C > 0,6 i F > 0,6 (silna zgodność)
                 C i F normalizowane do [0,1]; brak jednego z nich →
                 CF = drugi sygnał × 50, bez korekcji.
      G  10 pkt  Piotroski F-Score — jakość fundamentalna (zysk, bilans,
                 efektywność); 5 pkt neutral dla banków (inna metodologia)
      ─────────────────────────────────────────────────────────────────
      Filtr sektorowy: max 2 spółki z jednego sektora w Top 10.
      Klawisz [r] odświeża ranking bez przeładowania strony.
      Przycisk [+] przy pozycji rozwija uzasadnienie punktacji A-F w
      języku naturalnym (dyskonto, liczba rekomendacji, momentum vs
      WIG, sentyment ESPI) na podstawie surowych danych z API.

  [2] AI_MORNING_BRIEF
      Dzienny skrót rynku generowany przez AI, odświeżany raz dziennie
      (Pon–Pt 08:15). Sekcje: MARKET (zmiana WIG, silne/słabe sektory —
      liczone deterministycznie), SPÓŁKI W CENTRUM UWAGI i SYGNAŁY ALERTÓW
      (wybór algorytmiczny z Top 10 / alertów ESPI, dane informacyjne —
      nie stanowią rekomendacji), PORTFOLIO (sygnały rebalancingu z
      Twojego lokalnego importu XTB), AI SUMMARY.

  [3] LIVE_ESPI
      Live feed komunikatów regulacyjnych ESPI/EBI z bankier.pl.
      Każdy komunikat analizowany przez AI: typ zdarzenia, sentyment
      (−1.0 … +1.0) oraz streszczenie w języku polskim.
      Filtry: ticker, typ zdarzenia, HIDE_ETF (ukrywa fundusze/ETF).
      Klawisz [f] pobiera najnowsze komunikaty.

  [4] PORTFOLIO
      Twój portfel: import z xStation 5 (eksport XLSX) i live P/L
      zaimportowanych pozycji (Yahoo Finance, odświeżane co 10 min).
      Sygnały rebalancingu dla Twoich pozycji: W TOP10 / NOWE /
      POZA TOP10 względem aktualnego Top 10 — z buforem 3 miejsc
      (Top11-13 trzymane bez zmian, sprzedaż dopiero poza Top13).
      W trybie buy-only (WIG < SMA30) lista POZA TOP10 jest
      informacyjna — decyzja o sprzedaży należy do Ciebie.
      Plik XLSX jest przetwarzany lokalnie — żadne dane nie opuszczają
      Twojego komputera.

  [5] STRATEGY
      Portfel strategii (serwerowy) — wyniki historyczne vs benchmark
      WIG. Metryki: stopa zwrotu YTD, średni wynik miesięczny,
      Max Drawdown, Profit Factor, Win Rate.
      Log transakcji z historią rebalancingów (kupione / sprzedane).
      Otwarte pozycje strategii z live P/L (Yahoo Finance, odświeżane
      co 10 min) i sygnałami rebalancingu jak w [4].
      Generowanie miesięcznego raportu i wykonanie rebalancingu
      zgodnie z aktualnym rankingiem Top 10 (operacja nieodwracalna,
      tylko Admin).
      Tryb buy-only: gdy WIG < SMA30 (ostatnie 30 sesji), sprzedaże
      i przycięcia pomijane automatycznie — amber banner [!] this is fine.
      AI Paper Portfolio: eksperymentalny portfel papierowy prowadzony
      przez Claude Sonnet 5 — agent ocenia propozycje rebalancingu
      algorytmu i może odroczyć wybrane transakcje (raz dziennie,
      Pn–Pt o losowej porze 11–15). Notatki między sesjami.

  [6] README
      Dokumentacja systemu — ta strona.

  [7] API
      Dokumentacja REST API. Endpointy, parametry, kody odpowiedzi
      i przykładowe payloady. Wymagany nagłówek X-API-Key.
      Interaktywna dokumentacja Swagger: https://gpwconsole.pl/docs

  [8] ROADMAP
      Plan rozwoju systemu: kamienie milowe, priorytety, status.
      Szczegóły w zakładce [8] ROADMAP.

  [9] CONTACT
      Dane kontaktowe: biznes (root@gpwconsole.pl), wsparcie
      techniczne i dostęp API (sysadmin@gpwconsole.pl), feedback.

  [10] ANALYTICS
      Statystyki odwiedzin serwisu: łączna liczba zdarzeń, popularność
      zakładek, top referrerzy, najczęściej odwiedzane profile spółek
      oraz dzienny trend (PAGE LOAD). Zakres: ostatnie 30 dni (param days).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## STRATEGIA REBALANCINGU ([5] STRATEGY)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  PARAMETRY ALGORYTMU
  ─────────────────────────────────────────────────────────────────────
  Rebalancing           co miesiąc, ~15 dzień miesiąca
  Wpłata                1000 PLN/mies. (konfigurowalna)
  Liczba pozycji        max 10 nowych (bufor trzymania do TOP 13)
  Histereza (bufor)     pozycje #11–#13 trzymane bez zmian (nie sprzedawane)
  Histereza h=2         sprzedaż dopiero po 2 cyklach poza buforem
  Tryb buy-only         blokada sprzedaży i przycięć gdy WIG < SMA30
  Minimalna transakcja  100 PLN (mniejsze różnice pomijane)
  Spółki bez ułamkowych całe akcje (weryfikacja brokera XTB)
  Podatek Belki         informacyjnie (nie odejmowany automatycznie)

  BENCHMARK — WIG140
  ─────────────────────────────────────────────────────────────────────
  Indeks                WIG140 (WIG20 + mWIG40 + sWIG80 = 140 spółek)
  Dlaczego WIG140       przekrój dużych/średnich/małych, bez mikrospółek
  Porównanie            wynik portfela vs zmiana indeksu w tym samym miesiącu
  Prowizje benchmarku   0% (indeks pasywny, bez kosztów transakcyjnych)

  Uwaga: strategia używa cen z zamknięcia sesji w dniu rebalancingu.
  Nie uwzględnia spreadów, prowizji ani poślizgu wykonania — wyniki
  są hipotetyczne. Żywy benchmark to WIG140 cenowy (w skali 1 mies.
  ≈ dochodowy).

  BACKTEST (2017–2026)
  ─────────────────────────────────────────────────────────────────────
  Okres testu           2017–2026 vs WIG140 total return (walk-forward)
  Najbardziej odporny   Top 10 spółek, rebalans co 90 dni (≈produkcja)
  Wynik                 bije benchmark w 97% okien startowych*

  » Pełny raport backtestu (2017–2026) →

  *Wyniki historyczne/hipotetyczne (m.in. survivorship bias, brak
  rzeczywistych kosztów transakcyjnych) — nie stanowią porady
  inwestycyjnej. Szczegółowe zastrzeżenia w raporcie.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## PUBLICZNE STRONY (poza zakładkami)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Poza tą aplikacją (SPA) serwis udostępnia osobne, indeksowalne
  strony HTML — bez logowania, bez klucza API:

  /gpw/{ticker}   Strona profilowa spółki: ranking, dystans do Top 10
                  (ile pkt brakuje i które komponenty są najsłabsze),
                  rozbicie score (A-E + CF), historia 6m, komunikaty ESPI,
                  podsumowanie AI, spółki powiązane z sektora.
  /top10          Aktualna dziesiątka najwyżej ocenianych
                  spółek, nowe wejścia, największe awanse/spadki.
  /ranking        Pełny ranking wszystkich ocenionych spółek,
                  statystyki, rozkład sektorowy, zmiany m/m.
  /backtest       Statyczna migawka backtestu strategii (2016-2026)
                  vs WIG — wykres equity, tabela wariantów, wnioski.
                  Link w zakładce [5] STRATEGY.

  Rankingi (/gpw, /top10, /ranking) odświeżane wraz z cotygodniowym
  fetchem (Pn 03:00); podsumowania AI per spółka raz w tygodniu.
  Strona /backtest jest statyczna (nie odświeża się automatycznie).

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## SKRÓTY KLAWISZOWE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  0 … 9           Przełączanie zakładek
  r               Odśwież scoring (zakładka 1)
  f               Pobierz ESPI (zakładka 3)
  s               Odśwież strategię (zakładka 5)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## WSPARCIE PROJEKTU
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Projekt jest w 100% niezależny i darmowy. Każda postawiona
  "kawa" zasila utrzymanie serwera i przyspiesza wdrażanie
  kolejnych funkcji. Podoba Ci się konsola? Wesprzyj:
  >> https://buycoffee.to/gpwconsole

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## ⚠  LEGAL DISCLAIMER — PRZECZYTAJ PRZED UŻYCIEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  [1] CHARAKTER INFORMACYJNY — NIE DORADZTWO INWESTYCYJNE
  ─────────────────────────────────────────────────────────
  Wszelkie treści publikowane przez gpwconsole.pl — w tym scoring spółek
  (A+B+CF+D+E+G), rankingi, sugestie rebalancingu portfela, analizy
  sentymentu komunikatów ESPI/EBI oraz raporty miesięczne — mają charakter
  wyłącznie INFORMACYJNY i EDUKACYJNY. Są one wynikiem w pełni
  zautomatyzowanego przetwarzania publicznie dostępnych danych rynkowych
  i nie uwzględniają indywidualnej sytuacji finansowej, celów
  inwestycyjnych, horyzontu czasowego ani skłonności do ryzyka
  konkretnego użytkownika.

  Metodologia scoringu (wzory, wagi, źródła danych) jest w pełni jawna —
  patrz zakładka [6] README, sekcja "OPIS ZAKŁADEK" → [1] TOP_10. Operator
  serwisu nie pobiera prowizji od transakcji, nie jest stroną żadnej z
  ocenianych spółek i nie ma interesu finansowego w konkretnym wyniku
  rankingu jakiejkolwiek spółki.

  Prezentowane treści NIE stanowią:
  • rekomendacji inwestycyjnej w rozumieniu art. 3 ust. 1 pkt 35
    Rozporządzenia Parlamentu Europejskiego i Rady (UE) nr 596/2014
    z dnia 16 kwietnia 2014 r. w sprawie nadużyć na rynku (MAR),
  • rekomendacji dotyczącej instrumentów finansowych w rozumieniu
    Rozporządzenia Delegowanego Komisji (UE) 2016/958,
  • doradztwa inwestycyjnego w rozumieniu art. 76 ust. 1 Ustawy z dnia
    29 lipca 2005 r. o obrocie instrumentami finansowymi (t.j. Dz.U.
    2023 poz. 646 z późn. zm.) ani usługi, o której mowa w art. 69
    ust. 2 pkt 5 tej ustawy,
  • usługi zarządzania portfelem instrumentów finansowych (art. 69
    ust. 2 pkt 4 ww. ustawy),
  • analizy inwestycyjnej ani analizy finansowej w rozumieniu
    Dyrektywy MiFID II (2014/65/UE) i aktów wykonawczych,
  • oferty ani zaproszenia do nabycia lub zbycia jakichkolwiek
    instrumentów finansowych.

  Operator serwisu gpwconsole.pl:
  • NIE jest podmiotem nadzorowanym przez Komisję Nadzoru Finansowego
    (KNF) ani żaden inny organ nadzoru finansowego,
  • NIE posiada zezwolenia na prowadzenie działalności maklerskiej,
  • NIE posiada licencji doradcy inwestycyjnego (lista KNF: knf.gov.pl),
  • NIE świadczy żadnych usług regulowanych w rozumieniu MiFID II /
    MiFIR ani polskiej ustawy o obrocie instrumentami finansowymi.

  Algorytm scoringowy A+B+CF+D+E+G jest narzędziem pomocniczym opartym
  na publicznie dostępnych danych. Jego wyniki NIE są prognozą kursów,
  NIE gwarantują zysku i NIE zastępują analizy przeprowadzonej przez
  uprawnionego doradcę inwestycyjnego lub dom maklerski.

  [2] RYZYKO INWESTYCYJNE
  ─────────────────────────────────────────────────────────
  Inwestowanie na Giełdzie Papierów Wartościowych w Warszawie (GPW)
  wiąże się z wysokim ryzykiem utraty części lub całości zainwestowanego
  kapitału. Wyniki historyczne nie gwarantują wyników przyszłych.
  Decyzje inwestycyjne podejmujesz wyłącznie na własną odpowiedzialność
  i ryzyko, po konsultacji z licencjonowanym doradcą inwestycyjnym.

  [3] ŹRÓDŁA DANYCH I ICH WIARYGODNOŚĆ
  ─────────────────────────────────────────────────────────
  Dane rynkowe pobierane są z publicznych serwisów (biznesradar.pl,
  finance.yahoo.com, bankier.pl). Serwis nie gwarantuje ich aktualności,
  kompletności ani poprawności. Komunikaty ESPI/EBI są analizowane
  automatycznie przez model AI (Anthropic Claude) — interpretacja AI
  może być błędna lub niepełna.

  [4] OCHRONA DANYCH OSOBOWYCH (RODO/GDPR)
  ─────────────────────────────────────────────────────────
  Komunikaty ESPI/EBI mogą zawierać dane osobowe (imiona i nazwiska
  członków zarządów, akcjonariuszy). Są to dane publicznie dostępne,
  opublikowane przez spółki w ramach ustawowych obowiązków
  informacyjnych (art. 17 MAR i art. 56 Ustawy o ofercie publicznej).
  Podstawa prawna przetwarzania: prawnie uzasadniony interes
  administratora (art. 6 ust. 1 lit. f RODO) — analiza regulacyjnych
  komunikatów spółek giełdowych w celach informacyjnych i badawczych.
  Obowiązek informacyjny z art. 14 RODO nie ma zastosowania na mocy
  art. 14 ust. 5 lit. b RODO — dane są pozyskiwane ze źródeł
  publicznie dostępnych w rozumieniu prawa.
  Okres retencji danych: 180 dni od daty publikacji komunikatu,
  po czym są automatycznie usuwane.
  Dane tekstowe komunikatów są przekazywane do przetwarzania przez
  Anthropic Inc. (USA) na podstawie Standardowych Klauzul Umownych
  (SCC, art. 46 ust. 2 lit. c RODO) i Data Processing Agreement
  Anthropic. Anthropic nie wykorzystuje tych danych do trenowania
  modeli na podstawie opt-out zgłoszonego przez administratora.
  Osobom, których dane dotyczą, przysługuje prawo dostępu (art. 15),
  sprzeciwu (art. 21), ograniczenia przetwarzania (art. 18) oraz
  wniesienia skargi do Prezesa UODO (uodo.gov.pl).
  Kontakt w sprawach RODO: sysadmin@gpwconsole.pl
  Pliki Excel importowane przez użytkownika są przetwarzane wyłącznie
  lokalnie w przeglądarce (JavaScript) i NIE są wysyłane na serwer.

  [5] WYŁĄCZENIE ODPOWIEDZIALNOŚCI
  ─────────────────────────────────────────────────────────
  Autor i operator serwisu gpwconsole.pl nie ponosi odpowiedzialności
  za jakiekolwiek straty finansowe, decyzje inwestycyjne ani inne
  szkody wynikłe z korzystania z prezentowanych danych lub narzędzi.
  Korzystanie z serwisu jest równoznaczne z akceptacją niniejszych
  warunków.

            GPW CONSOLE — REST API  v1.0  ::  gpwconsole.pl


  BASE URL  https://gpwconsole.pl
  DOCS      https://gpwconsole.pl/docs  (Swagger UI — interaktywna dokumentacja)

  AUTH      Nagłówek: X-API-Key: <twój-klucz>
            Bez klucza: GET /api/v1/health, /site-config, /changelog
            Dwa poziomy klucza:
              • publiczny — odczyt (scores/data/prices/report/
                morning-brief/portfolio/espi GET) — używa go ta strona
              • pełny — wszystko powyżej + POST /espi/sentiments,
                POST /espi/alerts, GET /espi/{id}
            /api/v1/admin/* — osobny mechanizm: tylko z 127.0.0.1,
            klucz API nieistotny (nie w tej warstwie ochrony)
            Brak → 401  ·  Zły klucz → 403  ·  Brak konfiguracji → 503
            Klucz API: napisz na sysadmin@gpwconsole.pl

  PRZYKŁAD  curl -H "X-API-Key: <klucz>" \
              https://gpwconsole.pl/api/v1/market/scores

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## QUICK REFERENCE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  ── SYSTEM ─────────────────────────────────────────────────────────────────
  GET   /api/v1/health                  healthcheck, bez klucza
  GET   /api/v1/changelog               historia wersji, bez klucza

  ── PORTFOLIO ──────────────────────────────────────────────────────────────
  GET   /api/v1/portfolio                pozycje z P/L
  GET   /api/v1/portfolio/live           live P/L Yahoo Finance  (cache 3 min)
  GET   /api/v1/portfolio/history        historia rebalancingów  [?limit=12]

  ── MARKET / SCORING ───────────────────────────────────────────────────────
  GET   /api/v1/market/scores            pełny ranking (total: A+B+CF+D+E+G)
  GET   /api/v1/market/data              dane rynkowe (cache)
  GET   /api/v1/market/prices            live ceny  [?tickers=PKO,CDR,LPP]
  GET   /api/v1/report                   miesięczny raport tekstowy
  GET   /api/v1/morning-brief            AI Morning Brief dzienny  (cache 1h)

  ── ESPI / KOMUNIKATY ──────────────────────────────────────────────────────
  GET   /api/v1/espi                     lista  [?ticker ?typ ?since ?limit …]
  GET   /api/v1/espi/{id}                szczegóły komunikatu
  POST  /api/v1/espi/sentiments          sentyment per ticker  {tickers, days}
  POST  /api/v1/espi/alerts              alerty  STRATA / RESTRUKTURYZACJA

  ── STRONY HTML (bez klucza, poza prefiksem /api/) ────────────────────────
  GET   /gpw/{ticker}                strona profilowa spółki (ranking, score, AI)
  GET   /top10                          strona: Top 10 spółek
  GET   /ranking                        strona: pełny ranking spółek
  GET   /sitemap.xml                    mapa strony (dynamiczna, per ticker)

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## RESPONSE SCHEMAS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  GET /api/v1/health
  { "status": "ok", "espi_active": true,
    "next_rebalancing": "2026-07-31", "market_data_age_minutes": 42 }

  GET /api/v1/changelog
  { "status": { "VERSION": "v1.5.0", "COMMITS": "11", ... },
    "entries": [{ "date": "2026-07-02", "version": "v1.5.0",
      "items": [{ "tag": "+", "text": "Explainable scoring — ..." }] }] }

  GET /api/v1/portfolio/live
  { "mode": "portfolio"|"watchlist", "total_value": 5230.0,
    "total_pnl": 730.0, "total_pnl_pct": 16.2,
    "yahoo_ok": true, "fetched_at": "2026-07-01T10:15:00",
    "positions": [{ "ticker": "PKO", "shares": 10, "avg_price": 45.0,
      "price": 52.3, "pnl": 73.0, "pnl_pct": 16.2, "value": 523.0,
      "source": "live"|"avg" }],
    "recommendations": { "keep": [...], "buy": [...], "sell": [...] } }

  GET /api/v1/market/scores  (total: A+B+CF+D+E+G, C/F informacyjne)
  { "top10": [{ "ticker": "PKO", "score": 74.2,
      "A": 17.8, "B": 10.5, "C": 18.2, "D": 9.1, "E": 3.7, "F": 14.9,
      "CF": 33.1, "has_espi": true,
      "price": 52.30, "avg_target": 68.00, "discount_pct": 23.0,
      "sector": "Banki", "div_pct": 5.2, "age_days": 14,
      "n_recs": 4, "n_houses": 3, "n_buys": 3, "n_holds": 1, "n_sells": 0 }],
    "sector_victims": [...], "wig_mom3": 3.14, "wig_mom6": 5.02,
    "next_rebalancing": "2026-07-31", "warnings": [] }

  GET /api/v1/market/prices
  ?tickers=PKO,CDR,LPP                tickery oddzielone przecinkiem (max 50)
  { "prices": { "PKO": 103.34, "CDR": 224.20 },
    "yahoo_ok": true, "fetched_at": "2026-07-01T10:15:00" }

  GET /api/v1/morning-brief
  { "date": "2026-07-03", "generated_at": "2026-07-03T08:55:00",
    "data": { "date": "2026-07-03", "wig_change": 0.82,
      "strong_sectors": ["Banki"], "weak_sectors": ["Energetyka"],
      "opportunities": [{ "ticker": "PKO",
        "reasons": ["Dyskonto 18% do celu", "3 rekomendacje kupuj"],
        "confidence": 72 }],
      "risks": [{ "ticker": "CDR",
        "reasons": ["Obniżona prognoza wyników"], "confidence": 65 }],
      "summary": ["WIG w lekkim wzroście.", "Sektor bankowy najsilniejszy."] } }
  ("data": null gdy jeszcze nic nie wygenerowano — pierwszy brief pojawia
   się Pon-Pt o 08:55)

  GET /api/v1/espi
  ?ticker=PKO  ?typ_wydarzenia=KONTRAKT  ?min_sentyment=-1.0
  ?since=2026-06-01  ?limit=60  ?offset=0
  { "total": 142, "items": [{ "id": 1, "ticker": "PKO",
      "spolka": "Bacteromic S.A.", "typ_wydarzenia": "KONTRAKT",
      "sentyment": 0.7, "data_publikacji": "30.06.2026 09:14",
      "streszczenie": "...", "url": "https://..." }] }

  POST /api/v1/espi/sentiments
  body: { "tickers": ["PKO", "CDR"], "days": 60 }
  { "PKO": { "count": 4, "avg_sentiment": 0.12,
             "type_counts": { "WYNIKI": 2, "KONTRAKT": 2 } } }
  (tickery bez komunikatów w oknie nie pojawiają się w odpowiedzi)

  POST /api/v1/espi/alerts
  body: { "tickers": ["PKO", "CDR"], "days": 30 }
  [{ "ticker": "CDR", "typ_wydarzenia": "STRATA",
     "streszczenie": "...", "sentyment": -0.8 }]

                    GPW CONSOLE — PRODUCT ROADMAP


  Roadmap przedstawia kierunek rozwoju GPW Console.
  Priorytety są aktualizowane na podstawie opinii użytkowników
  oraz rzeczywistych potrzeb inwestorów.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[✓] MILESTONE 1 — CORE PLATFORM                                        COMPLETED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Fundamenty systemu GPW Console.

  ✓ Retro terminal interface
  ✓ GPW scoring engine (A+B+CF+D+E+G)
  ✓ Portfolio management + Live P/L
  ✓ XTB import
  ✓ AI ESPI analysis
  ✓ REST API + Swagger
  ✓ Public website
  ✓ Security & SEO
  ✓ Auto scheduler
  ✓ Changelog
  ✓ Explainable scoring
  ✓ AI Morning Brief

  Status: COMPLETED

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] MILESTONE 2 — SMART INVESTING
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Rozbudowa narzędzi wspierających podejmowanie decyzji.

  Planned:

  □ AI Morning Brief 2.0
  □ Portfolio Insights
  □ Portfolio Simulator
  □ Custom Scoring
  □ Better AI explanations
  □ Smart Alerts

  Status: IN PROGRESS

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] MILESTONE 3 — MARKET INTELLIGENCE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Rozszerzenie danych wykorzystywanych przez silnik scoringowy.

  Planned:

  □ Economic Calendar
  □ Macro events (NBP / FED / CPI / GDP)
  □ Financial statements
  □ Automatic financial ratios
  □ Better sector analytics

  Status: PLANNED

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] MILESTONE 4 — OPEN PLATFORM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Rozwój ekosystemu oraz integracji.

  Planned:

  □ Contact backend
  □ Email notifications
  □ Broker integrations
  □ Public SDK
  □ Webhooks
  □ PWA support

  Status: PLANNED

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[ ] MILESTONE Ω — PROFESSIONAL MARKET DATA
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Długoterminowa wizja projektu.

  Cel:

  Przejście z publicznych źródeł danych na profesjonalny
  feed rynkowy czasu rzeczywistego.

  Vision:

  ◇ Native GPW market data
  ◇ Real-time quotations
  ◇ Tick-by-tick updates
  ◇ Instant portfolio valuation
  ◇ Live AI analysis
  ◇ Professional-grade infrastructure

  NOTE

  Realizacja wymaga komercyjnego dostępu do danych
  Giełdy Papierów Wartościowych w Warszawie
  oraz odpowiednich licencji.

  Status: LONG-TERM VISION

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Roadmap is continuously updated.

  Suggestions & feedback:

  >> sysadmin@gpwconsole.pl

                        GPW CONSOLE — CONTACT


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ## DANE KONTAKTOWE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  BIZNES     Współpraca, partnerstwo, zapytania komercyjne:
             >> root@gpwconsole.pl

  WSPARCIE   Pytania techniczne, dostęp API, zgłoszenia błędów:
             >> sysadmin@gpwconsole.pl

  FEEDBACK   Pomysły, sugestie, opinie o projekcie:
             >> sysadmin@gpwconsole.pl

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

  Projekt jest hobbystyczny i rozwijany w wolnym czasie.
  Czas odpowiedzi: do 48h w dni robocze.