Pulpit główny

Pulpit główny to ekran, na którym każdy użytkownik ląduje natychmiast po zalogowaniu do platformy DataFlow AI. Jest w pełni adaptujący się do roli: układ, widżety, kafelki KPI i szybkie akcje zmieniają się w zależności od tego, która z czterech person jest aktywna, więc inżynier danych, analityk biznesowy, administrator platformy i opiekun danych — każdy otrzymuje powierzchnię zbudowaną pod pracę, którą faktycznie wykonuje.

Nowy tutaj? Do czego służy ten ekran

Pulpit główny to Twój punkt startowy — ekran, który pojawia się w chwili logowania. Jego zadaniem jest zapewnienie szybkiego, ogólnego podsumowania Twojej pracy zanim przejdziesz gdziekolwiek dalej, abyś od razu widział, czy coś wymaga uwagi.

Jest adaptujący się do roli, co po prostu oznacza, że pulpit przeorganizowuje się, aby pasować do Twojej pracy:

• Inżynier danych widzi kondycję potoków i ostatnie awarie — rzeczy, które naprawia.
• Analityk biznesowy widzi własne potoki danych, świeżość danych oraz pole do rozmowy z AI.
• Administrator platformy widzi kondycję systemu, koszty i aktywnych użytkowników — rzeczy, którymi zarządza.
• Opiekun danych widzi oceny jakości danych oraz kolejkę potoków oczekujących na przegląd.

Dwa pojęcia, które zobaczysz na tej stronie:

• KPI — kluczowy wskaźnik efektywności (ang. Key Performance Indicator): jedna ważna liczba pokazana na małym kafelku (na przykład „487 / 500 potoków sprawnych"). Wiersz tych kafelków to pasek KPI.
• Persona — rola, za jaką platforma Cię uważa. Zwykle jest ustalana na podstawie Twojego logowania i decyduje, którą wersję pulpitu widzisz.

Co robi pulpit

Pulpit główny szybko odpowiada na jedno pytanie: „Co teraz wymaga mojej uwagi?" Stosuje wzorzec pasek KPI, a potem zagłębianie się — nagłówek powitalny, szybkie akcje specyficzne dla persony, pasek 4–6 kafelków KPI oraz jeden lub dwa panele zagłębiania pokazujące ostatnią aktywność.

Każdy panel jest niezależnie izolowany od błędów: jeśli pojedyncze wywołanie API zawiedzie, ten jeden panel pokazuje element ponawiania, podczas gdy reszta strony działa dalej. Zewnętrzny ErrorBoundary jest ostatnią siatką bezpieczeństwa, więc pulpit nigdy nie zniknie całkowicie.

Trasa: / przekierowuje do /dashboard. Plik wejściowy: src/pages/HomeDashboard.tsx.

Kto z niego korzysta

Aktywna persona jest przechowywana w utrwalonym personaStore Zustand (klucz localStorage dataflow-persona) i odczytywana przy każdym renderze, więc przełączenie persony ponownie renderuje panele w miejscu bez ponownego uwierzytelniania.

Wspólna powłoka

Każdy wariant pulpitu jest renderowany wewnątrz tej samej powłoki aplikacji, więc nawigacja jest spójna niezależnie od persony.

+---------------------------------------------------------------------------+
| [=] DataFlow AI                       [?]  [bell (3)]  [Anna Kowalska v]   |  <- TopBar
+--------+------------------------------------------------------------------+
|        |                                                                  |
| SIDE   |   <main id="main-content">                                       |
| BAR    |     ... persona dashboard renders here ...                       |
| (240/  |                                                                  |
|  60px) |                                                          [ * ]  |  <- AI Copilot FAB
+--------+------------------------------------------------------------------+

Powłoka podłącza również Ctrl/Cmd+K do otwierania wyszukiwania globalnego.

Anatomia pulpitu persony

Każdy wariant dzieli tę samą umowę czterech stref, wyrażoną przez stabilne identyfikatory testowe:

Każdy kafelek KPI jest powiązany z prawdziwym wywołaniem API opakowanym w hak useRetry, który ponawia z wykładniczym wycofywaniem oraz losowym przesunięciem przy przejściowych awariach.

Pulpit inżyniera danych (Anna)

Pulpit inżyniera używa siatki trójkolumnowej i niebieskiego banera powitalnego.

+---------------------------------------------------------------------------+
|  GREETING BANNER  "Good morning, Anna"            Tuesday, 3 Mar 2026      |
+---------------------------------------------------------------------------+
| PIPELINE STATUS CARD  | RECENT FAILURES CARD  | AI INSIGHTS CARD          |
|  487 / 500 healthy    |  wf_E112  Sybase...   |  Push-down optimization   |
|  [==green==][r][yel]  |  wf_CDR   ORA-01652   |  Schema drift  [Review]   |
+---------------------------------------------------------------------------+
| QUICK ACTIONS:  [+ New Pipeline] [Play View Runs] [Design Studio] [AI Chat]|
+---------------------------------------------------------------------------+
| RECENT ACTIVITY FEED (col-span-2)        | PIPELINE HEALTH TREND          |
|  o wf_SAP_Replika completed (2.3m)       |  7-day success-rate line chart |
|  o wf_E112 FAILED                        |  Avg: 97.4%   Trend: +0.3%     |
+---------------------------------------------------------------------------+

Kluczowe widżety

Za kulisami

Pulpit inżyniera pobiera dane z api/pipelines (listPipelines, getPipelineRuns) oraz api/monitoring (getDashboardMetrics, getAlerts).

Pulpit analityka biznesowego (Marek)

Siatka dwukolumnowa ze szmaragdowym banerem powitalnym, skoncentrowana na własnych potokach analityka i samoobsługowym dostępie do danych.

+---------------------------------------------------------------------------+
|  GREETING BANNER  "All 5 of your pipelines ran successfully."             |
+---------------------------------------------------------------------------+
| MY PIPELINES CARD  5/5         | AI CHAT QUICK ENTRY                      |
|  o wf_Sales_Daily_Extract      |  [ Ask me anything about your data... ]  |
|  o wf_Customer_Churn_Report    |  pills: Export CRM | Churn trends | ...   |
+---------------------------------------------------------------------------+
| DATA FRESHNESS CARD            | RECENT EXTRACTS CARD                     |
|  CRM   [==green==] 23 min ago  |  Q1 Revenue by Region  Excel  [Download] |
|  CDR   [==yellow=] 3 hrs ago   |  Subscriber List       CSV    [Download] |
+---------------------------------------------------------------------------+
| SCHEDULED PIPELINES TABLE (full width)                                    |
+---------------------------------------------------------------------------+

Za kulisami: api/dataProducts oraz api/gdpr (lista DSAR).

Pulpit administratora platformy (Katarzyna)

Siatka trójkolumnowa z fioletowym banerem, zorientowana na operacje platformy.

+---------------------------------------------------------------------------+
|  GREETING BANNER  "All systems operational. 47 active users today."       |
+---------------------------------------------------------------------------+
| SYSTEM HEALTH      | COST TRACKER          | ACTIVE USERS                  |
|  CPU 34%  Mem 52%  |  Today $142           |   47 users today              |
|  Uptime 99.97%     |  Month $3,847 (77%)   |   Engineers 23 | Analysts 14  |
+---------------------------------------------------------------------------+
| INFRASTRUCTURE ALERTS (col-span-2)         | SCALING EVENTS                |
|  GKE Autoscaler 8->14 pods   [Acknowledge] |  GKE Pods 8 -> 14             |
+---------------------------------------------------------------------------+
| SERVICE STATUS TABLE (full width)                                         |
+---------------------------------------------------------------------------+

Za kulisami: api/admin (listUsers, listWorkspaces, getAuditLogs) oraz api/monitoring (fetchCostSummary, fetchCostAnomalies).

Pulpit opiekuna danych (Tomasz)

Pulpit z bursztynowym banerem do pracy nadzorczej: kolejka przeglądów, oceny jakości i punkty wejścia do pochodzenia danych. Pulpit opiekuna używa siatki trójkolumnowej w górnym wierszu i siatki dwukolumnowej w drugim wierszu.

+---------------------------------------------------------------------------+
|  GREETING BANNER  "Quality score is 97.3% (+0.2%). 3 reviews pending."    |
+---------------------------------------------------------------------------+
| OVERALL QUALITY SCORE | QUALITY BY DOMAIN   | PENDING REVIEWS         (3) |
|  97.3%  (ring +0.2%)  |  CRM 98.1% Bill 97.8|  wf_Subscriber_Churn_v2    |
|  1,847 / 1,900 pass   |  Net 97.2% CDR 94.1%|  Score 94/100   [Review]   |
+---------------------------------------------------------------------------+
| LINEAGE ALERTS                             | RECENT AUDIT EVENTS         |
+---------------------------------------------------------------------------+
| QUALITY TREND CHART (full width)                                          |
+---------------------------------------------------------------------------+

Kluczowe widżety

Niezaliczająca lub o niskim trendzie domena (CDR na poziomie 94,1%, −1,2% w danych przykładowych) najpierw przyciąga wzrok — dokładnie ten zbiór danych, który opiekun powinien zbadać. Kliknięcie dowolnego paska domeny otwiera /governance/quality/{domainId}; kliknięcie przeglądu otwiera /governance/reviews/{id}.

Za kulisami: api/governance (listReviews) oraz api/gdpr (zaległe DSAR-y).

Wprowadzenie przy pierwszym uruchomieniu

Zupełnie nowy użytkownik nie ląduje na pulpicie „na zimno". Pierwsze logowanie uruchamia kreatora Wprowadzenia (/onboarding) — prowadzone, sześcioetapowe doświadczenie pierwszego uruchomienia — a możliwa do odrzucenia nakładka wycieczki podświetla strefy pulpitu w miejscu.

Wycieczka jest świadoma persony: wskazuje widżety istotne dla aktywnej roli i pomija moduły, których ta rola nigdy nie widzi. Po odrzuceniu lub ukończeniu wycieczka nie pojawia się ponownie; możesz uruchomić ją później z Pomoc i dokumentacja w stopce paska bocznego.

Ścieżki kliknięć

Triage awarii potoku (inżynier)

1. Zaloguj się — lądujesz na /dashboard.
2. Zlokalizuj RecentFailuresCard w górnym wierszu.
3. Przeczytaj fragment błędu i znacznik czasu na każdej pozycji awarii.
4. Kliknij pozycję awarii — platforma przechodzi do /monitor/runs/{runId}.
5. Na stronie szczegółów uruchomienia przeczytaj panel diagnozy AI, aby poznać przyczynę źródłową.

Rozpoczęcie budowy nowego potoku

1. Z pulpitu znajdź pasek Szybkie akcje.
2. Kliknij Nowy potok.
3. Platforma przechodzi do Studia projektowania (/design-studio) z pustym płótnem.

Potwierdzenie alertu infrastruktury (administrator)

1. Na pulpicie administratora znajdź InfrastructureAlertsCard.
2. Zidentyfikuj alert, który nadal pokazuje przycisk [Acknowledge] (tylko niepotwierdzone alerty).
3. Kliknij [Acknowledge].
4. Alert zostaje oznaczony jako potwierdzony, a przycisk znika z tego wiersza.

Zapytanie AI o swoje dane (analityk)

1. Na pulpicie analityka znajdź kartę AIChatQuickEntry.
2. Albo wpisz pytanie w pole tekstowe i naciśnij Enter, albo kliknij pigułkę szybkiej podpowiedzi, taką jak Pokaż mi trendy odejść abonentów.
3. AI Copilot otwiera się pod /ai-copilot?q=... z Twoją podpowiedzią wstępnie wypełnioną i gotową do wysłania.

Otwarcie jednego ze swoich harmonogramowanych potoków (analityk)

1. Przewiń do ScheduledPipelinesTable na dole pulpitu.
2. Przeskanuj kolumnę Status w poszukiwaniu dowolnej niezielonej kropki.
3. Kliknij wiersz potoku, aby zagłębić się w jego widok szczegółowy.

Częste pytania

Dlaczego mój pulpit wygląda inaczej niż pulpit kolegi? Pulpit adaptuje się do roli. Inżynier danych, analityk biznesowy, administrator platformy i opiekun danych — każdy widzi układ zbudowany wokół swojej pracy. Jeśli dwie osoby w tej samej roli widzą inne dane, zwykle dzieje się tak, ponieważ znajdują się w różnych obszarach roboczych.

Czym jest „persona" i czy mogę zmienić swoją? Persona to rola, za jaką platforma Cię traktuje. W normalnej sesji pochodzi z Twojego firmowego logowania (Keycloak) i jest ustawiana przez administratora. Decyduje, który pulpit i które pozycje paska bocznego widzisz. Aby zmienić swoją rzeczywistą rolę, skontaktuj się z administratorem obszaru roboczego.

Jeden z kafelków mojego pulpitu pokazuje błąd — czy platforma nie działa? Niemal na pewno nie. Każdy panel wczytuje swoje dane niezależnie, więc awaria pojedynczego kafelka zwykle oznacza jedną krótką czkawkę backendu. Kliknij element ponawiania na tym jednym panelu; nie musisz przeładowywać całej strony.

Co oznaczają kolorowe liczby na kafelkach KPI? Są to liczby na żywo pobierane bezpośrednio z platformy. Zielony zwykle oznacza zdrowy, czerwony oznacza, że coś wymaga uwagi. Każdy kafelek jest klikalny i prowadzi do ekranu, na którym możesz na niego zareagować.

Właśnie zalogowałem się po raz pierwszy i pojawił się kreator — co to jest? To kreator wprowadzenia, prowadzona, sześcioetapowa konfiguracja pierwszego uruchomienia. Pomaga wybrać personę, nazwać obszar roboczy, utworzyć pierwsze połączenie i odbyć krótką wycieczkę. Większość kroków możesz pominąć. Po ukończeniu nie pojawia się ponownie, ale możesz uruchomić wycieczkę ponownie z Pomoc i dokumentacja w pasku bocznym.

Jak dostać się stąd do asystenta AI? Kliknij przycisk z iskrą w prawym dolnym rogu dowolnego ekranu lub — na pulpicie analityka — wpisz pytanie w pole szybkiego wejścia czatu AI. Tak czy inaczej AI Copilot otwiera się z Twoim pytaniem gotowym do wysłania.

Jak często pulpit się odświeża? Kafelki KPI pobierają dane na żywo przy wczytaniu i ponawiają automatycznie przy przejściowej awarii. Do ciągle aktualizowanego statusu uruchomień Centrum monitorowania jest ekranem zbudowanym do śledzenia w czasie rzeczywistym.

Podsumowanie API

Wszystkie wywołania przechodzą przez wspólnego klienta Axios (api/client.ts), który wstrzykuje token okaziciela Keycloak, dodaje token CSRF do żądań modyfikujących i automatycznie konwertuje odpowiedzi snake_case na camelCase.