ASM_PNS_C/Koncepcja 0.1.md

# AdReactions – MVP 1.0 [KM]

## Projekt

AdReactions to aplikacja SaaS, która pozwala na przeprowadzenie eksperymentów (predykcji)  postrzegania (Eye Tracking) emocji (Facial Coding) z zastosowaniem modeli AI, w tym również modelu AI ASM PNS. Eksperymenty prowadzone są przez klientów na wczytanych reklamach, banerach i materiałach marketingowych.

## Stack technologiczny

- Front-end: React / shadcn/ui + tailwind
- Back-end: Node.js
- Data base, Storage, Auth: Supabase

## Wersja językowe

Obsługiwane języki w MVP 1.0 to:

- Polski
- Angielski

W kolejnych wersjach planowane jest dodanie innych wersji językowych.

## Struktura organizacji, ról, uprawnień

- Organizacja:
    - Posiada Administratora
    - Posiada Użytkowników
    - Posiada Gości
    - Posiada Projekty
- Role
    - Super administrator - posiada dostęp do panelu administracyjnego, w którym może zarządzać organizacjami, użytkownikami, modelami AI. Super administrator może przejść do każdej z organizacji w systemie. Jeśli Super administrator wchodzi do organizacji to może w niej poruszać się tak jak Administrator.
    - Administrator - Administrator organizacji powstaje podczas rejestracji Organizacji. Prawa administratora mogą zostać przekazane do innego użytkownika przez administratora.
    - Użytkownik - Każdy użytkownik w platformie posiada własne niezależne konto.
- Uprawnienia
    - Administrator - Posiada uprawnienia do każdego projektu, rozliczeń, planów i ustawień. Może tworzyć nowe projekty i eksperymenty bez ograniczeń.
    - Użytkownik - może posiadać uprawnienia:
        - Tworzenia nowych projektów
        - Przeglądania wszystkich projektów
        - Edytowania wszystkich projektów
        - Usuwania wszystkich projektów
        - Zapraszanie użytkowników do wszystkich projektów
        - Użytkownik może również otrzymać uprawnienia w ramach projektu takie jak:
            - Usuwanie, edycja i zapraszanie użytkowników
            - Edycja i zapraszanie użytkowników
            - Przeglądanie

## Struktura modułów platformy

- Panel administracyjny
    - Dostęp do panelu możliwy tylko dla Super administratorów.
    - Zarządzanie całą aplikacją
        - Zarządzanie wszystkimi organizacjami
        - Zarządzanie wszystkimi użytkownikami
    - Modele AI
        - Zarządzanie konfiguracją modeli AI
- Panel użytkownika - Dostęp dla użytkownika po rejestracji / zalogowaniu. Z tego miejsca użytkownik może:
    - przejść do wybranej organizacji
    - dodać nową organizację (może dodać tylko jedną nową organizację)
    - zmienić dane
    - zmienić email
    - zmienić hasło.
- Panel organizacji - Panel dla Administratora i użytkowników. Panel zawiera:
    - Projekty organizacji
        - Eksperymenty projektu
    - Galeria kreacji

## Struktura UX

- Topbar
    - Wybór organizacji
    - Wyszukiwarka - Pozwala na wyszukiwanie projektów, kreacji, eksperymentów.
- Sitebar
    - Menu panelu
    - Menu użytkownika
    - Sitebar ukrywa się w trybie mobilnym
- Workspace
    - Obszar roboczy
    

---

## Panel **organizacji**

### Sitebar

- Dashboard
- Projekty
- Galeria

### **Dashboard**

Strona służy jako szybki zbiorczy podgląd do podstawowych rezultatów. Na tej stronie powinny pojawić się pola z podstawowymi KPI:

- Galeria (liczba kreacji w bazie danych)
- Projekty (liczba projektów)
- Eksperymenty (liczba eksperymentów)

Pod KPI powinny być przyciski:

- Dodaj kreację do Galerii
- Utwórz nowy Projekt
- Przejdź do ostatniego eksperymentu

Pod przyciskami powinna znaleźć się lista Projektów z możliwością przejścia do danego projektu.

## **Galeria**

Strona jest dedykowana do zarządzania galerią kreacji Organizacji.

Przycisk u góry: Dodaj kreację do Galerii (przestrzeń ładowania pliku krecji do Galerii).

Poniżej: Kreacje ostatnio dodane do Galerii (kafelki kreacji).

Poniżej: Galeria  wszystkich kreacji  i w razie potrzeby przewijanych slajderem ilustrującym wszystkie kreacje dodane do Galerii.

Po kliknięciu w daną kreację zostanie ona powiększona w drawer po prawej stronie. Drawer grafiki zaprezentuje:

- Powiększoną grafikę
- Listę eksperymentów wraz z informacją o projekcie, w których była ta grafika stosowana. Użytkownik z tego poziomu może przejść do danego eksperymentu i/lub projektu.

## **Projekty**

Strona jest dedykowana do zarządzania projektami.

Na tej stronie widzimy :

- Na górze:
- Przycisk: Nowy projekt

Pod nim listę z nazwami projektów, informacją czy były to projekty ET czy FT, czy ET+FT.

### Panel projektu

Użytkownik na tej stronie zarządza projektem. Może je przeglądać, weryfikować konfigurację eksperymentu. Może usuwać całe projekty, usuwać poszczególne eksperymenty oraz udostępniać projekty innym użytkownikom.

### **Nowy projekt**

W ramach projektu można realizować wiele eksperymentów.

Każdy projekt ma szereg powiązanych z nim elementów tj:

- **Nazwa projektu** - nadawana przez właściciela projektu.
- **Galeria  projektu -**  Galeria kreacji dodanych do danego projektu. Mogą to być grafiki pochodzące z aktualnej Galerii organizacji lub tylko Projektu. W ramach 1 eksperymentu można analizować maksymalnie 3 kreacje / grafiki (A, B i C). Ilość załączanych grafik jest ograniczona limitem miejsca na dysku stosownym dla danej subskrypcji. Można tę przestrzeń poszerzać za określoną ilość punktów / coinów zgodnie o aktualnym cennikiem przestrzeni dyskowej.

### Projekt

**Galeria eksperymentów:**

To galeria wszystkich eksperymentów zrealizowanych w ramach projektu ze wskazaniem ich kluczowych parametrów tj Rodzaj technologii (ET, FC, ET+FC, Rodzaj testu A, AB, ABC..). Nazwę użytkownika, który przygotował eksperyment.

### **Nowy eksperyment**

Każdy zakładany eksperyment musi zostać odpowiednio skonfigurowany do przeprowadzenia analizy predykcyjnej odpowiadające zamierzeniom użytkownika. Użytkownik w procesie konfiguracji określa podstawowe parametry badania.

#### Krok 1 - Cel i grupa docelowa

**Cel:** Opisowy lub z listy np. maksymalizacja uwagi na CTA, Minimalizacja frustracji, Skrócenie czasu dotarcia do wybranego AOI, etc.

**Słowniki celów predefiniowanych:**

1. Która kreacja lepiej sprzedaje?
2. Czy CTA działa?
3. Czy kreacja działa od pierwszych sekund?
4. Która kreacja zostaje w pamięci?
5. Która kreacja najlepiej buduje markę?
6. Czy odbiorca widzi najważniejszy przekaz?
7. Czy przekaz jest zrozumiały?
8. Która kreacja najbardziej się wyróżnia?
9. Czy kreacja angażuje, czy jest obojętna?
10. Która kreacja najlepiej pasuje do grupy docelowej?
11. Czy kreacja budzi negatywne reakcje?
12. Która kreacja jest najbezpieczniejsza?
13. Który styl komunikacji działa lepiej?
14. Czy ekran prowadzi użytkownika do celu?
15. Które opakowanie lepiej przyciąga klienta?

**Grupa docelowa:** Wskazanie grupy docelowej (cechy metryczkowe lub gotowe presety kilku cech w ramach jednej kategorii np.  Generacja Z, Silver etc.

**Grupy docelowe:**

**Wiek:**

- Młodzież (do 25 lat)
- Dorośli (26-64 lat)
- Seniorzy (66 i więcej)

**Płeć:**

- Kobieta
- Mężczyzna

**Miejsce Zamieszkania:**

- Miejscowośc do 19 tys mieszkańców
- Miasto 20–50 tys. mieszkańców
- Miasto 50–100 tys. mieszkańców
- Miasto 100–500 tys. mieszkańców
- Miasto powyżej 500 tys. mieszkańców

**Wyksztalcenie:**

- Podstawowe
- Zasadnicze zawodowe
- Średnie
- Wyższe
- Wyższe / Tytuł naukowy

**Dochód:**

- Niski - Do minimalnej krajowej (MK)
- Średni - Powyżej MK do Średniej Krajowej (ŚK)
- Wysoki - Powyżej ŚK

**Neuroatypowość:**

- **Brak / Neurotypowy**
- ASD - Spektrum autyzmu
- ADHD - Nadpobudliwość ruchowa
- Zaburzenia Depresyjne

**Profile opisowe:**

- NT - Profil Neurotypowy
- DE - Profil Wykluczony Cyfrowo
- SE - Profil Silver Economy
- GZ - Gen-Z/Digital Native

#### Krok 2 - Parametry

**Rodzaj analizy:** Eye Tracking, Facial Coding, ET+FC.

**Rodzaj testu:** Do wyboru mamy test:

- A - Jedna kreacja
- AB - Dwie kreacje
- ABC - Trzy kreacje

**Czas obserwacji:** 1s, 3s, 5s, 10s, 15s, 20s

**Zakres raportu:** Elementy, z których składa się raport finalny tj. Opis ogólny kreacji, Lista obiektów, Lista i opis AOI, Mapy Cieplne, Ścieżki Fiksacji, Ścieżka AOI, Analiza Kognitywna, Wizualizacje dynamiczne 1-20s, Wizualizacje statyczne 1s, 3s, 5s, 10s, 15s, 20s, Tabela porównawcza z metrykami.

#### Krok 3 - Studio

**Obiekty:** na poszczególnych materiałach wybranych do analizy Użytkownik może sam wskazać obiekty do analizy (zaznaczając ich obszar i nadając im nazwy) lub skorzystać z identyfikacji obiektów przez AI, a następnie może je skorygować (obszar i nazwy) lub usunąć decydując, które obiekty pozostawia do analizy kognitywnej.

**Słownik Obiektów:**

- Architektura
- Celebryci
- Chemia
- Edukacja
- Elektronika
- Fabryki
- Finanse
- Handel
- Inne
- Kosmetyki
- Logistyka
- Militaria
- Motoryzacja
- Osoby
- Przemysł
- Przyroda
- Sport
- Ubrania
- Zwierzęta
- Żywność
- ….

**AOI (obszary zainteresowania):** na poszczególnych materiałach wybranych do analizy Użytkownik może sam wskazać AOI do analizy (zaznaczają ich obszar i nadając im nazwy) lub skorzystać z identyfikacji AOI i obiektów przez AI, a następnie może je skorygować (obszar i nazwy) lub usunąć decydując, które AOI pozostawia do analizy kognitywnej.

**Słownik AOI**

- Call to Action (CTA)
- Dowód społeczny
- Key Visual
- Kod QR
- Kolorystyka
- Kontakt
- Korzyści
- Kupon
- Layout
- Logo
- Mapa
- Nagłówek
- Narracja
- Numer katalogowy
- Regulaminy
- Slogan
- Ton komunikacji
- Treść
- Typografia
- Tło
- ….

#### Krok 4 - Raport

**Raport składa się z:**

- Opis ogólny kreacji
- Lista obiektów
- Lista i opis AOI
- Mapy Cieplne
    - Wizualizacje dynamiczne od 1 do 20s
    - Wizualizacje statyczne 1s, 3s, 5s, 10s, 15s, 20s
- Ścieżki Fiksacji
    - Wizualizacje dynamiczne od 1 do 20s
    - Wizualizacje statyczne 1s, 3s, 5s, 10s, 15s, 20s
- Ścieżka AOI
- Analiza kognitywna
- Tabela porównawcza z metrykami

**Warunki prezentacji danych raportu:**

- Jeśli to eksprgyment  AB to cześci składowe raportu dotyczą 2 kreacji.
- Jeśli to eksprgyment ABC to cześci składowe raportu dotyczą 3 kreacji.

**Opcje pobierania i udostępniania raportu**:

- **Udostępnianie:** Zgodnie z uprawnieniami projektu (wyżej). Możliwość udostępnienia wyników jako link do eksperymentu.
- **Pobieranie:** Pobieranie raportu z wyników eksperymentu w formie PDF.

#### Logi

Super administrator po wejściu na eksperyment posiada również dostęp do logów z przeprowadzonego eksperymentu. Wszystkie działani i ustawienia użytkownika w eksperymencie oraz wszystkie wysłane i odebrane dane z modeli AI.

---

## Panel administracyjny

### Sitebar

- Dashboard
- Organizacje
- Użytkownicy
- Proces i modele AI
- Logi

### Dashboard

Prezentuje dane taki jak:

- Liczba organizacji i zmiana w ciągu 30 dni (graficznie i liczbowo)
- Liczba użytkowników i zmiana w ciągu 30 dni (graficznie i liczbowo)
- Liczba kreacji i zmiana w ciągu 30 dni (graficznie i liczbowo)
- Liczba przeprowadzonych eksperymentów i zmiana w ciągu 30 dni (graficznie i liczbowo)

### Organizacje

Lista organizacji w podstawowymi danymi i wyszukiwarką. Po wejściu w daną organizację można zarządzać:

- Danymi organizacji
- Użytkownikami
- Kredytami (punktami) dostępnymi globalnie dla klienta i tymi kredytami dodawanymi każdego miesiąca.
- Można również dezaktywować organizację / aktywować. Organizację, którą zdezaktywowano można zarchiwizować.

### Użytkownicy

Lista organizacji w podstawowymi danymi i wyszukiwarką. 

### Proces i modele AI

Lista procesów realizowanych w eksperymentach (zamknięta lista) oraz model AI, który realizuje dany proces.

### Logi

Logi z całego systemu pozwalające na filtrowanie wg użytkowników, organizacji, daty (od do), rodzaju operacji.

---

## Use case 1:

1. Rejestracja użytkownika.
2. Logowanie do platformy.
3. Utworzenie organizacji.
4. Dodanie w galerii nowych kreacji (materiałów graficznych) przeznaczonych do eksperymentów.
5. Utworzenie nowego projektu
    1. Utworzenie w ramach projektu eksperymentu w tym:
        - Podanie celu i grupy docelowej
        - Wybranie rodzaju ABC i dodanie 3 kreacji (materiałów graficznych) do eksperymentu.
        - Konfiguracja parametrów
        - Nie wykonywanie zmian w Studio.
    2. Wygenerowanie raportu z analizy
    3. Eksport raportu z analizy do PDF
    4. Udostępnianie raportu dla innych użytkowników z opcją do edycji (Editor) lub tylko do podglądu.
    5. Wykorzystanie eksperymentu jako podstawy do innego eksperymentu. W eksperymencie pojawia się opcja “Zmień ten eksperyment”.
    6. Po kliknięciu na “Zmień ten eksperyment” użytkownik jest proszony o podanie nowej nazwy i jest przekierowany do Kroku 1 eksperymentu, który został utworzony na podstawie poprzedniego.

## Use case 2:

Ze zmianami w Studio

1. Rejestracja użytkownika.
2. Logowanie do platformy.
3. Utworzenie organizacji.
4. Dodanie w galerii nowych kreacji (materiałów graficznych) przeznaczonych do eksperymentów.
5. Utworzenie nowego projektu
    1. Utworzenie w ramach projektu eksperymentu w tym:
        - Podanie celu np.  **Która kreacja lepiej sprzedaje?**
        - Podanie grupy docelowej np.:
            - **Wiek:**
                - Młodzież (do 25 lat)
            - **Płeć:**
                - Kobieta
            - **Miejsce Zamieszkania:**
                - Miejscowośc do 19 tys mieszkańców
            - **Wyksztalcenie:**
                - Wyższe
            - **Dochód:**
                - Średni - Powyżej MK do Średniej Krajowej (ŚK)
            - **Neuroatypowość:**
                - Brak
        - Wybranie rodzaju analizy A, AB, AC, BC, ABC
            - **ABC**
        - Dodanie 3 kreacji (materiałów graficznych) do eksperymentu.
            - Materiał 1
            - Materiał 2
            - Materiał 3
        - Konfiguracja parametrów metryk ET, FC, ET + FC.
            - Zgodnie ze wskazaniem celu
        - Nie wykonywanie zmian w Studio.
            - Obiekty i AOI wskazane przez AI
    2. Wygenerowanie raportu z analizy
    3. Eksport raportu z analizy do PDF + XLS (Tabele z danymi porównawczymi z metryk, AVI - dynamiczne mapy cieple i ścieżki fiksacji)
    4. Udostępnianie raportu dla innych użytkowników z opcją do edycji (Editor) lub tylko do podglądu.
        - 1 osoba jako Editor
        - 1 osoba jako Viwer
    5. Wykorzystanie eksperymentu jako podstawy do innego eksperymentu. W eksperymencie pojawia się opcja “Edytuj”.
    6. Po kliknięciu na “Edytuj” użytkownik jest proszony o podanie nowej nazwy i jest przekierowany do Kroku 1 eksperymentu, który został utworzony na podstawie poprzedniego.