Przewodnik administratora

Ten przewodnik śledzi Katarzynę Zielińską, personę administratora platformy, w ścieżkach, które utrzymują DataFlow AI w działaniu — od trzydniowej budowy infrastruktury na zimno, przez codzienne operacje i wdrażanie użytkowników, po reagowanie na incydenty. Kończy się czterofazową ścieżką migracji starszych rozwiązań Specjalisty ds. migracji, wykonywaną przez inżyniera w Centrum Migracji. Każdy krok jest powiązany z konkretnym ekranem, narzędziem lub trasą.

Zanim zaczniesz

Administrator platformy jest operatorem płaszczyzny sterowania. Rolą backendową Katarzyny jest ADMIN (poziom 100 — szczyt hierarchii); jej rolą realmu Keycloak jest złożona rola org_admin; jej personą UX jest admin. Ma wszystkie 28 uprawnień frontendowych oraz pełny dostęp do Konsoli administracyjnej.

Jej dozwolone prefiksy tras obejmują /, /admin, /monitor, /migration, /design-studio, /governance, /connections, /pipelines, /data-browser oraz /templates. W szczególności Konsola administracyjna (/admin) jest widoczna wyłącznie dla persony administratora.

Ścieżka 1 — Początkowa konfiguracja platformy

Postawienie platformy zajmuje trzy intensywne dni.

Dzień 1 — Infrastruktura

1. Katarzyna uruchamia terraform apply względem szablonów IaC.
2. Terraform udostępnia klaster GKE Autopilot w europe-central2.
3. Udostępnia instancję Cloud SQL PostgreSQL dla metadanych platformy.

Oprzyrządowanie: Terraform, GKE, Cloud SQL.

Dzień 2 — Bezpieczeństwo

1. Konfiguruje Keycloak z federacją Active Directory przez LDAPS.
2. Konfiguruje Vault do zarządzania poświadczeniami.
3. Definiuje role RBAC i mapuje do nich grupy AD za pomocą mapowań ról Keycloak.

Oprzyrządowanie: konsola administracyjna Keycloak, Vault, mapowania ról.

Dzień 3 — Łączność

1. Rejestruje konektory, których potrzebuje Polkomtel: Teradata, Snowflake, Databricks, SAP HANA oraz MSSQL.
2. Testuje każde połączenie.
3. Konfiguruje monitorowanie i alertowanie za pomocą Grafana oraz PagerDuty.

Oprzyrządowanie: API rejestracji połączeń, Grafana, PagerDuty.

Ścieżka 2 — Codzienne operacje

Dzień Katarzyny koncentruje się wokół Konsoli administracyjnej oraz wariantu administratora Pulpitu głównego.

08:00 — Poranna kontrola kondycji

1. Otwiera Pulpit administratora (/dashboard, wariant administratora).
2. SystemHealthCard potwierdza, że wszystkie usługi są UP, z CPU na poziomie 34% i pamięcią na poziomie 52%.
3. CostTrackerCard pokazuje wydatki — dziś 142 USD, od początku miesiąca 3847 USD względem budżetu 5000 USD.

Późny poranek — Zarządzanie użytkownikami

1. Nadchodzi żądanie nowego użytkownika od zespołu DBI.
2. Katarzyna przypisuje użytkownika do obszaru roboczego i środowiska.
3. Ich członkostwo w grupie AD automatycznie udostępnia właściwe uprawnienia.

Skalowanie

1. Podczas szczytu na koniec miesiąca uruchamia się alert wysokiego obciążenia CPU.
2. Przegląda wzorce użycia na pulpicie.
3. GKE Autopilot automatycznie skaluje klaster; w razie potrzeby może zastosować ręczne nadpisanie.

Ekrany: HomeDashboard (administrator), SystemHealthCard, CostTrackerCard, ActiveUsersCard, InfrastructureAlertsCard, ScalingEventsCard, ServiceStatusTable, Konsola administracyjna.

Ścieżka 3 — Wdrażanie użytkowników i zespołów

Dodanie nowego użytkownika lub zespołu to rutynowa, ale wieloetapowa ścieżka.

1. Udostępnij użytkownika. Użytkownik jest synchronizowany z Active Directory poprzez federację Keycloak lub tworzony ręcznie w Keycloak z nazwą użytkownika, adresem e-mail, imieniem i nazwiskiem, hasłem tymczasowym oraz rolami realmu. W Konsoli administracyjnej korzysta z karta Użytkownicy → + Utwórz użytkownika i wypełnia okno dialogowe (imię i nazwisko, e-mail *@plk.pl, rola, obszar roboczy, grupy AD, status, przełączniki powiadomień).
2. Przypisz członkostwo w obszarze roboczym. Przypisuje użytkownika do obszaru roboczego za pomocą API usługi metadanych — POST /workspaces/{id}/members z rolą.
3. Utwórz obszar roboczy (jeśli potrzeba). POST /workspaces z nazwą, slugiem i środowiskiem oraz kwotami zasobów — współbieżne uruchomienia, maksymalna liczba potoków danych, magazyn GCS oraz egzekutory Spark.
4. Zarejestruj połączenia. Rejestruje połączenia danych obszaru roboczego i testuje łączność za pomocą POST /connections/{id}/test.

Tabela Mapowanie grup AD w Konsoli administracyjnej czyni to powiązanie jawnym: każdy wiersz pokazuje grupę AD, rolę platformy, którą nadaje, zakres obszaru roboczego oraz liczbę członków.

Ekrany: /admin/users (karty Użytkownicy i Obszary robocze), konsola administracyjna Keycloak, API obszarów roboczych.

Ścieżka 4 — Reagowanie na incydenty

Przebieg prawdziwego incydentu: gwałtowny wzrost awarii potoków danych o 02:00.

Krok 1 — Wykryj i zdiagnozuj

1. Uruchamia się alert PagerDuty P1 — ponad 50 awarii potoków danych.
2. Katarzyna sprawdza Grafanę, która pokazuje skok opóźnienia Teradata o 01:55.
3. Przyczyna źródłowa: konflikt z oknem konserwacji DWH Teradata.

Krok 2 — Koordynuj

1. Koordynuje działania z zespołem DBA Teradata.
2. Teradata wraca do działania o 03:30.

Krok 3 — Odtwórz i wyciągnij wnioski

1. Uruchamia masowe ponowienie wszystkich nieudanych potoków danych z ich punktów kontrolnych.
2. Aktualizuje runbook — dodając okno wykluczenia konserwacji Teradata, aby konflikt nie mógł się powtórzyć.

Ekrany: panel powiadomień / alertów, IncidentPanel, Centrum Monitorowania (w zakresie administratora), Grafana, PagerDuty.

Ścieżka 5 — Migracja starszych rozwiązań (Specjalista ds. migracji, cztery fazy)

Migracja starszych rozwiązań nie ma dedykowanej persony — wykonuje ją inżynier danych pracujący w Centrum Migracji, często we współpracy z administratorem platformy. Zakres RFI to ponad 500 przepływów PowerCenter oraz 50–100 przepływów Alteryx (mniej więcej 550–600 zasobów). Cele: >85% automatycznej konwersji dla PowerCenter oraz >75% dla Alteryx. Typowa partia zajmuje około sześciu tygodni.

Faza 1 — Ocena (Tydzień 1)

1. Wczytaj eksport XML PowerCenter — na przykład 150 obiektów — do Kreatora importu (/migration/import).
2. Kreator automatycznie wykrywa typ pliku (PowerCenter XML / Alteryx YXMD / Nieznany) i pokazuje karty poszczególnych plików z liczbami obiektów.
3. Kliknij Analizuj z AI. Uruchamia się 4-etapowa lista kontrolna — Parsowanie → Analizowanie → Zgodność → Raport — z przewijającym się na żywo kanałem analizy.
4. Przejrzyj Raport zgodności: cztery karty podsumowania (Łączna liczba obiektów, % automatycznie konwertowalnych, % wymagających działań ręcznych, Szacowany wysiłek w godz.), tabela Oceny przepływów ze znacznikami złożoności, wykres podziału według typów obiektów oraz panel Elementów ryzyka. Typowy wynik: 85% automatycznie konwertowalnych, 15% ręcznych.

Ekrany: Kreator importu — FileUploadStep, AnalysisProgressStep, AnalysisFeed, CompatibilityReportStep, WorkflowAssessmentTable.

Faza 2 — Konwersja wsadowa (Tygodnie 2–3)

1. Automatycznie skonwertuj potoki danych za pomocą AI plus reguł — kliknij Rozpocznij konwersję, aby przejść do /migration/conversion.
2. Pulpit konwersji pokazuje karty podsumowania (Łącznie, pierścień Automatycznie skonwertowane, pierścień Ręczne, średnia pewność) oraz tabelę Status konwersji według typu obiektu — Source Qualifier, Expression, Lookup, Filter, Joiner, Custom Java, Router, Other.
3. Przejrzyj każdy skonwertowany potok danych YAML w Design Studio za pomocą akcji karty Otwórz w Design Studio.
4. Napraw oznaczone elementy — na przykład 23 złożone transformacje Java wymagające ręcznej uwagi.

Ekrany: Pulpit konwersji — ConversionSummaryCards, ObjectTypeConversionTable, ConvertedPipelineList, ConfidenceDistributionChart, RiskItemsPanel.

Faza 3 — Walidacja (Tygodnie 4–5)

1. Otwórz Zestaw walidacyjny (/migration/validation) i kliknij Uruchom wszystkie testy.
2. Zestaw uruchamia testy parzystości danych porównujące źródło z celem — liczby wierszy, sumy kontrolne oraz wartości kolumn.
3. Tabela porównania potoków danych pokazuje wyniki; nieudane wiersze rozwijają się do FailureDetail poszczególnych kolumn (oczekiwane vs. rzeczywiste, typ różnicy).
4. Napraw rozbieżności — na przykład 3 potoki danych z przypadkami brzegowymi.

Ekrany: Zestaw walidacyjny — ValidationTestRunner, ValidationResultsTable, DataComparisonView.

Faza 4 — Przełączenie (Tydzień 6)

1. Przeprowadź równoległe uruchomienie — zarówno systemu starszego, jak i DataFlow AI przez jeden tydzień.
2. Zweryfikuj, że oba produkują identyczne wyniki.
3. Wycofz przepływy PowerCenter z eksploatacji.
4. Śledź ogólny postęp w Trackerze postępu migracji (/migration/progress) — oś czasu faz, wykres Gantta, widok postępu partii, karta ETA, metryka prędkości oraz elementy ryzyka.

Ekrany: Tracker postępu migracji — PhaseTimeline, BatchProgress, MigrationEtaCard.

Ścieżka → odsyłacze do ekranów

Dokumentacja Konsoli administracyjnej

Konsola administracyjna (/admin) ma pięć sekcji oraz stopkę Szybkie statystyki.

Typowe szybkie akcje: utworzenie użytkownika (/admin/users → + Utwórz użytkownika), unieważnienie sesji (Bezpieczeństwo → Aktywne sesje → Unieważnij) oraz rotacja klucza API (Bezpieczeństwo → Klucze API → ikona rotacji).

Dokąd dalej

• Ścieżki użytkownika — pełny indeks ścieżek z mapami ASCII.
• Przewodnik inżyniera danych — w tym strona inżyniera w migracji starszych rozwiązań.
• Przewodnik analityka i stewarda — ścieżki dla person tworzących i zarządzających danymi.
• Persony i role — jak persona administratora odwzorowuje się na role backendu i Keycloak.