v1.0.0 — Karta platformy

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)

1. Ź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.
2. Integracje / SelAssist — autorski konektor Subiekt GT ↔ BigQuery (SelAssist) + natywne transfery (BigQuery Data Transfer Service) dla Google Ads / GA4 / Merchant.
3. Hurtownia — BigQuery, projekt enterprise-bi-platform, zbiory danych: subiekt_data, analytics_data, analytics_283671122 (GA4 export), facebook_data, gmc_data.
4. Modelowanie — widoki SQL (view_pl_kanalowy, view_sprzedaz_z_marka, view_bl_logistyka, view_social_kpi_monthly, …), modele BQML ARIMA dla prognozy sprzedaży, tabela ai_advisor_commentary na wyniki AI.
5. Wizualizacja — raport Looker Studio „SN Enterprise BI Platform” (11 stron).
6. 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)

1. 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).
2. Atrybut „kategoria produktu” — weryfikacja techniczna (BigQuery INFORMATION_SCHEMA): w tabelach produktowych subiekt_data kolumna „kategoria” nie istnieje. Dostępne są: marka (view_sprzedaz_z_marka) i typ_klienta. Kolumna kategoria_kosztu istnieje tylko w koszty_operacyjne (klasyfikacja kosztów, nie produktów). Do dorobienia: źródło kategorii produktowej (mapowanie z Presta / Allegro / GMC google_product_category albo słownik wewnętrzny).
3. Ś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.
4. 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.
5. 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.