---
# System prepended metadata

title: MetaMinds.pro - PRD dla MVP (Minimum Viable Product)

---

# 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:
     ```javascript
     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)
```sql
-- 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
```javascript
// 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
