# MetaMinds.pro - PRD dla MVP
## Wersja 0.1 | Luty 2025

### 1. Cel MVP
Stworzenie działającej wersji platformy optymalizującej kampanie Meta Ads z wykorzystaniem zasady 80/20, skupiającej się na kluczowych metykach ROAS i CPA.

### 2. Kluczowe Funkcjonalności MVP

#### 2.1 Podstawowe Funkcje
1. Podłączenie konta Meta Ads
- Autoryzacja przez Meta Business API
- Pobieranie podstawowych danych kampanii
- Obsługa jednego konta na użytkownika

2. Dashboard Kampanii
- Wyświetlanie ROAS i CPA w czasie rzeczywistym
- Lista aktywnych kampanii
- Podstawowe statystyki (wydatki, konwersje)

3. Automatyczna Optymalizacja
- Podstawowe reguły optymalizacji budżetu:

     const podstawoweReguly = {
       zwiekszenieBudzetu: {
         warunki: [
           { metryka: 'ROAS', operator: '>', wartosc: 200, akcja: 'zwieksz_budzet', procent: 20 }
         ]
       },
       zmniejszenieBudzetu: {
         warunki: [
           { metryka: 'ROAS', operator: '<', wartosc: 100, akcja: 'zmniejsz_budzet', procent: 30 }
         ]
       }
     }

### 3. Architektura MVP

#### 3.1 Baza Danych (Supabase)

-- Minimalna struktura bazy danych

-- uzytkownicy
id uuid primary key
email text
created_at timestamp

-- konta_meta
id uuid primary key
user_id uuid references uzytkownicy(id)
meta_account_id text
access_token text
created_at timestamp

-- kampanie
id uuid primary key
konto_meta_id uuid references konta_meta(id)
nazwa text
dzienny_budzet float
status text
created_at timestamp

-- metryki
id uuid primary key
kampania_id uuid references kampanie(id)
roas float
cpa float
wydatki float
konwersje integer
data_pomiaru timestamp

#### 3.2 API Endpoints

// Podstawowe endpointy
GET /api/kampanie            // Lista kampanii
GET /api/kampanie/:id        // Szczegóły kampanii
GET /api/metryki/:kampaniaId // Metryki kampanii
POST /api/optymalizacja      // Uruchomienie optymalizacji

### 4. Interfejs Użytkownika MVP

#### 4.1 Kluczowe Ekrany
1. Strona logowania
- Logowanie przez email
- Przycisk połączenia z Meta

2. Dashboard główny
- Wykres ROAS/CPA
- Lista kampanii
- Wskaźniki wydajności

3. Widok kampanii
- Szczegóły kampanii
- Historia optymalizacji
- Przyciski kontrolne

### 5. Integracje MVP

#### 5.1 Meta API
- Podstawowa integracja z Meta Marketing API
- Scope uprawnień:
- ads_read
- ads_management
- business_management

#### 5.2 Supabase
- Autentykacja
- Baza danych
- Real-time updates

### 6. Metryki Sukcesu MVP

#### 6.1 Cele Biznesowe
- Minimum 10 aktywnych użytkowników
- Średnia poprawa ROAS o 20%
- Czas zaoszczędzony: 5h/tydzień/użytkownik

#### 6.2 Cele Techniczne
- Czas odpowiedzi API < 1s
- Dostępność systemu 99%
- Skuteczność optymalizacji > 80%

### 7. Harmonogram MVP

#### Tydzień 1-2
- Setup projektu
- Integracja z Meta API
- Podstawowa struktura bazy danych

#### Tydzień 3-4
- Dashboard główny
- System autoryzacji
- Pobieranie danych kampanii

#### Tydzień 5-6
- Implementacja reguł optymalizacji
- Testy z użytkownikami
- Poprawki i stabilizacja

#### Tydzień 7-8
- Soft launch
- Zbieranie feedbacku
- Przygotowanie do pełnego launchu

### 8. Ograniczenia MVP

#### 8.1 Funkcjonalne
- Tylko podstawowe reguły optymalizacji
- Brak niestandardowych raportów
- Jeden poziom uprawnień użytkownika
- Brak integracji z zewnętrznymi platformami

#### 8.2 Techniczne
- Limit 100 kampanii na konto
- Aktualizacja danych co 1h
- Brak API dla klientów
- Podstawowe zabezpieczenia

### 9. Następne Kroki

#### 9.1 Priorytetowe Funkcje po MVP
1. Zaawansowane reguły optymalizacji
2. System raportowania
3. Wielopoziomowe uprawnienia
4. Integracje z dodatkowymi platformami

#### 9.2 Plan Rozwoju
- Zbieranie feedbacku od pierwszych użytkowników
- Identyfikacja kluczowych potrzeb
- Planowanie wersji 1.0