Update README.md

README.md

@@ -1,10 +1,266 @@
+# 🎯 Strategic Sandbox v1.0
+
+Interactive strategy simulation and evaluation tool for strategic planners and brand strategists.
+
+## 📋 Overview
+
+**Strategic Sandbox** to narzędzie wspierające strategów w budowaniu, testowaniu i symulowaniu strategii biznesowych w logicznej, pół-obliczeniowej formie.
+
+Pozwala na:
+- ✍️ Strukturalne wprowadzanie strategii (cele, insighty, hipotezy, ruchy)
+- ⚙️ Symulację scoringu i prognozowanie wpływu na metryki
+- 🧠 Ocenę AI spójności logicznej i ryzyk strategii
+- 📊 Wizualizację logiki strategii (graf zależności)
+- 📄 Generowanie raportów (Markdown/JSON)
+
+## 🚀 Szybki Start
+
+### Instalacja
+
+1. Sklonuj lub pobierz projekt:
+```bash
+cd strategic_sandbox
+```
+
+2. Zainstaluj zależności:
+```bash
+pip install -r requirements.txt
+```
+
+3. Uruchom aplikację:
+```bash
+streamlit run app.py
+```
+
+4. Otwórz w przeglądarce:
+```
+http://localhost:8501
+```
+
+### Konfiguracja
+
+1. **OpenAI API Key**: W panelu bocznym wprowadź swój klucz API OpenAI
+   - Klucz zostanie zapisany lokalnie dla kolejnych sesji
+   - Potrzebny tylko jeśli chcesz korzystać z funkcji AI Evaluator
+
+2. **Przykładowa strategia**: Kliknij **"Load Example"** aby załadować przykładową strategię
+
+## 📖 Jak używać
+
+### 1. Dashboard
+- Przegląd aktualnej strategii
+- Statystyki (liczba insightów, hipotez, ruchów, metryk)
+- Szybki dostęp do ostatnich wyników symulacji
+
+### 2. Strategy Builder
+Buduj strategię krok po kroku w 6 zakładkach:
+
+#### 🎯 Goal & Arena
+- Zdefiniuj cel strategiczny
+- Określ metrykę, baseline, target i horyzont czasowy
+- Opisz arenę konkurencji
+
+#### 💡 Insights
+- Dodaj insighty rynkowe lub konsumenckie
+- Przypisz źródła dowodów (badania, FGI, etc.)
+
+#### 🔬 Hypotheses
+- Sformułuj testowalne hipotezy
+- Powiąż z insightami
+- Określ metrykę i oczekiwaną zmianę
+
+#### 🎬 Moves
+- Zdefiniuj konkretne ruchy strategiczne
+- Powiąż z hipotezami
+- Oceń: **impact**, **fit**, **risk**, **cost**
+
+#### 📊 Metrics
+- Dodaj metryki sukcesu
+- Określ baseline i target
+
+#### ⚖️ Decision Rule
+- Zdefiniuj regułę decyzyjną
+- Np.: "IF CR_online >= 3.4 THEN Scale ELSE Iterate"
+
+### 3. Simulation
+- Kliknij **"Run Simulation"**
+- Wyniki:
+  - **Scoring ruchów**: `score = (impact × fit) × (1 - risk) / cost`
+  - **Ranking ruchów** (tabela i wykres)
+  - **Forecast metryk**: `forecast = baseline × (1 + Σscore)`
+  - **Wizualizacje**: wykresy słupkowe, scatter plot, graf logiczny
+
+### 4. AI Evaluator
+- Wyślij strategię do oceny przez AI
+- Otrzymasz feedback na temat:
+  - Spójności logicznej (0-10)
+  - Klarowności hipotez
+  - Głównych ryzyk
+  - Rekomendacji ulepszeń
+
+### 5. Report
+- Wygeneruj pełny raport strategii
+- Eksportuj jako:
+  - **Markdown** (.md)
+  - **JSON** (.json)
+
+## 🔧 Architektura
+
+```
+strategic_sandbox/
+│
+├── app.py                 # Główny interfejs Streamlit
+├── strategy_core.py       # Modele danych i silnik symulacji
+├── requirements.txt       # Zależności Python
+├── README.md              # Dokumentacja
+│
+├── assets/                # Zasoby graficzne
+│
+└── data/
+    ├── example.json       # Przykładowa strategia
+    └── .api_key           # Zapisywany klucz API
+```
+
+## 📐 Model Danych
+
+Strategia składa się z:
+
+```python
+{
+  "goal": {
+    "text": str,
+    "metric": str,
+    "baseline": float,
+    "target": float,
+    "horizon": str
+  },
+  "arena": {
+    "market": str,
+    "category": str,
+    "competitors": [str]
+  },
+  "insights": [
+    {
+      "id": str,
+      "text": str,
+      "evidence": [str]
+    }
+  ],
+  "hypotheses": [
+    {
+      "id": str,
+      "text": str,
+      "based_on": [str],
+      "metric": str,
+      "expected_change": float
+    }
+  ],
+  "moves": [
+    {
+      "id": str,
+      "text": str,
+      "linked_hypothesis": str,
+      "impact": float,      # 0-1
+      "fit": float,         # 0-1
+      "risk": float,        # 0-1
+      "cost": float
+    }
+  ],
+  "metrics": [
+    {
+      "id": str,
+      "text": str,
+      "baseline": float,
+      "target": float,
+      "unit": str
+    }
+  ],
+  "decision": str
+}
+```
+
+## 🧮 Formuły
+
+### Scoring ruchu:
+```
+score = (impact × fit) × (1 - risk) / (cost / 100000)
+```
+
+### Forecast metryki:
+```
+forecast = baseline × (1 + Σ scores_of_linked_moves)
+```
+
+## 🎨 Design
+
+- Czyste, warsztatowe UI w stylu "notebook"
+- Paleta kolorów: biały, jasny szary, niebiesko-turkusowy
+- Czcionki bezszeryfowe (system-ui)
+- Fokus na narzędziu do myślenia, nie prezentacji
+
+## 🔐 Bezpieczeństwo
+
+- Klucz API OpenAI zapisywany **lokalnie** w `data/.api_key`
+- Nie jest wysyłany nigdzie poza OpenAI API
+- Można usunąć plik `.api_key` aby wyczyścić
+
+## 📦 Zależności
+
+- **streamlit**: Framework UI
+- **openai**: Integracja z GPT-4
+- **networkx**: Wizualizacja grafów
+- **matplotlib**: Wykresy statyczne
+- **plotly**: Wykresy interaktywne
+- **pandas**: Manipulacja danymi
+- **numpy**: Obliczenia numeryczne
+
+## 🗺️ Roadmapa
+
+### v0.1 ✅ (Completed)
+- Formularze strategii
+- Scoring i symulacje
+- Export JSON/Markdown
+
+### v0.2 (Future)
+- PDF export
+- Więcej typów wizualizacji
+- Import strategii z pliku
+
+### v1.0 (Future)
+- Konta użytkowników
+- Wersjonowanie strategii
+- Porównanie strategii
+- Historia symulacji
+
+## 💡 Przykłady Użycia
+
+### Case Study: Premium Pasta Brand
+
+**Goal**: Zwiększyć udział premium do 12% w 2026
+
+**Key Insight**: Premium = rytuał + prostota
+
+**Hypothesis**: Narracja '12 minut do perfekcji' zwiększy CR online o 20%
+
+**Moves**:
+1. Test video 15s vs 6s format (Impact: 0.2, Risk: 0.3, Cost: 80k)
+2. Redesign packaging z focus na '12 min' (Impact: 0.35, Risk: 0.5, Cost: 250k)
+3. TV campaign premium storytelling (Impact: 0.4, Risk: 0.4, Cost: 500k)
+
+**Results**:
+- Move m3 (TV campaign) scored highest: 0.0019
+- Forecast CR_online: 3.2% (baseline: 2.8%)
+- Recommendation: Iterate messaging before scaling
+
+## 🤝 Wsparcie
+
+Dla pytań lub zgłaszania błędów:
+- Kontakt: staniszewski@heuristica.pl
+
+## 📄 Licencja
+
+Projekt stworzony przez www.Heuristica.pl / Marek Staniszewski
+
 ---
-title: StrategicSandbox
-emoji: ⚡
-colorFrom: yellow
-colorTo: indigo
-sdk: static
-pinned: false
----
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+