Data wydania: 2026-04-20
Typ wydania: Bazowa karta systemowa (punkt odniesienia dla changeloga)
📌 Czym jest Enterprise BI Platform
Kompletna platforma analityki handlowej, łącząca dane ze sprzedaży (Subiekt GT / BaseLinker / Allegro / Presta), reklamy (Google Ads, GA4, Meta Ads), Merchant Center, Facebook Page i Heatmapy UX w jednym hurtowni BigQuery, nad którą działają dashboardy Looker Studio, prognozy BQML (ARIMA) i konwersacyjny AI Advisor.
Wersja 1.0.0 opisuje stan produktu na dzień publikacji — bez listy zmian, bo to punkt zerowy, od którego liczymy kolejne wydania.
🏗️ Architektura (warstwy)
- Źródła danych — Subiekt GT (ERP), BaseLinker, Allegro, PrestaShop, Google Ads, GA4, Meta Ads (API), TikTok Ads (gotowe do podłączenia), Google Merchant Center, Facebook Page Insights, dane heatmapy UX.
- Integracje / SelAssist — autorski konektor Subiekt GT ↔ BigQuery (SelAssist) + natywne transfery (BigQuery Data Transfer Service) dla Google Ads / GA4 / Merchant.
- Hurtownia — BigQuery, projekt
enterprise-bi-platform, zbiory danych:subiekt_data,analytics_data,analytics_283671122(GA4 export),facebook_data,gmc_data. - Modelowanie — widoki SQL (
view_pl_kanalowy,view_sprzedaz_z_marka,view_bl_logistyka,view_social_kpi_monthly, …), modele BQML ARIMA dla prognozy sprzedaży, tabelaai_advisor_commentaryna wyniki AI. - Wizualizacja — raport Looker Studio „SN Enterprise BI Platform” (11 stron).
- AI — EBI AI Advisor (osobna aplikacja Cloud Run, konwersacja z BigQuery w czasie rzeczywistym) + AI Advisor Daily Report (strona w Lookerze generowana przez kod własny).
📊 Zakres dashboardów (Looker Studio, stan v1.0.0)
| # | Strona | Co zawiera |
|---|---|---|
| 1 | Rentowność kanałów | 7 scorecardów KPI, tabela wg kanału (8 kanałów), wykres słupkowy dual-axis |
| 2 | Klastry cen | 6 klastrów produktowych (Masa / Obroty bez zysku / Gwiazdy / Rentowne / Ukryty potencjał / Liderzy), bubble chart, ~7290 produktów |
| 3 | Benchmark cen | 2575 SKU, porównanie Presta / Allegro / cena benchmark |
| 4 | GA4 / Ads | 10 scorecardów, lejek konwersji, 19 kampanii |
| 5 | BL / BaseLinker | 3 scorecardy, 64 sposoby dostawy, pie chart |
| 6 | AI Advisor Daily Report | Focus dnia, KPI (wczoraj), prognoza BQML ARIMA, problemy (PILNE / WAŻNE), anomalie, rekomendacje GMC |
| 7 | Sprzedaż łączna | 5 scorecardów, 16992 produkty, pie kanałów |
| 8 | YoY | Słupki miesiąc × rok (2020–2026) |
| 9 | Prognoza sprzedaży | BQML ARIMA, historia + prognoza |
| 10 | Social Media | FB Page, 2 metryki (startowy zakres — do rozbudowy) |
| 11 | UX Heatmapa | Custom KDE heatmap na screenshocie strony |
🤖 EBI AI Advisor (aplikacja Cloud Run)
Adres: https://ai-advisor-chat-908120234763.europe-west1.run.app/
Funkcje w v1.0.0:
- Górne scorecardy dzienne: Przychód, Marża, Liczba zamówień, Δ vs średnia 30d, Top kanał, Data.
- Chat LLM pracujący bezpośrednio na danych BigQuery (bez eksportu, bez wiedzy „zamrożonej”).
- Szybkie podpowiedzi: „Jak wyglądała sprzedaż wczoraj?”, „Które produkty mają ujemną marżę?”, „Który kanał jest najbardziej rentowny?”, „Co powinienem poprawić w tym tygodniu?”
Miejsce w architekturze: samodzielna aplikacja webowa (Cloud Run, region europe-west1). Dostęp dla klienta odbywa się przez osobny link — nie jest to dashboard Looker.
✅ Stan zgodności www ↔ Looker (v1.0.0)
Wszystkie punkty z opisu oferty na stronie platformy są zmapowane:
- BaseLinker + SelAssist — zostają jako dwa odrębne, zgodne z opisem byty (SelAssist = integracja ERP → BQ; BL = kanał e-commerce).
- Rentowność kanałów, YoY, Prognoza, Klastry, Benchmark, Sprzedaż łączna, GA4/Ads, BL/BaseLinker, AI Advisor Daily Report, UX Heatmapa — zaimplementowane, OK.
- EBI AI Advisor Chat — uruchomiony jako osobna aplikacja Cloud Run.
Zidentyfikowane braki v1.0.0 (backlog na v1.X)
- Mailing AI Advisor — w prezentacjach i w opisie na www mowa o wysyłce raportu dziennego mailem. W v1.0.0 raport istnieje jako strona Lookera; automatyczny mailing do dorobienia (planowane v1.1).
- Atrybut „kategoria produktu” — weryfikacja techniczna (BigQuery INFORMATION_SCHEMA): w tabelach produktowych
subiekt_datakolumna „kategoria” nie istnieje. Dostępne są:marka(view_sprzedaz_z_marka) ityp_klienta. Kolumnakategoria_kosztuistnieje tylko wkoszty_operacyjne(klasyfikacja kosztów, nie produktów). Do dorobienia: źródło kategorii produktowej (mapowanie z Presta / Allegro / GMCgoogle_product_categoryalbo słownik wewnętrzny). - Ścieżki nawigacji UX — w v1.0.0 UX ogranicza się do heatmapy KDE. Ścieżki (flow / funnel UX) do dorobienia — planowane v1.1/v1.2.
- Social Media — rozbudowa — Meta Ads API podłączone, ale brak dostępu do kampanii klienta; TikTok Ads gotowy do podłączenia (brak aktywnych kampanii po stronie klienta). Rozbudowa zakresu po udostępnieniu danych.
- Drill-down — planowane v1.1 (Opcja 1: drill-down wbudowany + Opcja 2: Eksplorator transakcji jako osobna strona).
🔢 Schemat wersjonowania
MAJOR.MINOR.PATCH (SemVer-style dla produktu biznesowego):
- MAJOR — zmiana koncepcji platformy, nowa warstwa architektury, migracje łamiące kompatybilność.
- MINOR — nowa funkcja / nowa strona dashboardu / nowy model / nowe źródło danych.
- PATCH — poprawka, kosmetyka, uzupełnienie opisu.
Każde wydanie otrzymuje wpis w changelogu z odpowiednim tagiem:
- Nowość (indeksowane) — nowe funkcje / nowe wydania minor+.
- Ulepszenie (noindex) — drobne udogodnienia istniejących funkcji.
- Poprawka (noindex) — bugfixy, korekty danych.
📅 Plan najbliższych wersji (orientacyjny)
- v1.1 — Drill-down (wbudowany + Eksplorator transakcji), automatyczny mailing AI Advisora, uzupełnienie atrybutu kategorii produktowej.
- v1.2 — Ścieżki nawigacji UX (flow / funnel), rozbudowa Social Media po udostępnieniu danych.
- v1.X — nowe źródła (TikTok Ads po udostępnieniu kampanii), model retencji klienta.
Wpis bazowy — od niego liczone są zmiany w changelogu platformy.