Spaces:
Build error
Build error
Update README.md
Browse files
README.md
CHANGED
|
@@ -1,266 +1,78 @@
|
|
| 1 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 2 |
|
| 3 |
-
|
| 4 |
|
| 5 |
-
|
|
|
|
| 6 |
|
| 7 |
-
|
| 8 |
|
| 9 |
-
|
| 10 |
-
- ✍️ Strukturalne wprowadzanie strategii (cele, insighty, hipotezy, ruchy)
|
| 11 |
-
- ⚙️ Symulację scoringu i prognozowanie wpływu na metryki
|
| 12 |
-
- 🧠 Ocenę AI spójności logicznej i ryzyk strategii
|
| 13 |
-
- 📊 Wizualizację logiki strategii (graf zależności)
|
| 14 |
-
- 📄 Generowanie raportów (Markdown/JSON)
|
| 15 |
|
| 16 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 17 |
|
| 18 |
-
|
| 19 |
|
| 20 |
-
|
| 21 |
-
```bash
|
| 22 |
-
cd strategic_sandbox
|
| 23 |
-
```
|
| 24 |
|
| 25 |
-
2. Zainstaluj zależności:
|
| 26 |
```bash
|
| 27 |
pip install -r requirements.txt
|
| 28 |
-
```
|
| 29 |
-
|
| 30 |
-
3. Uruchom aplikację:
|
| 31 |
-
```bash
|
| 32 |
streamlit run app.py
|
| 33 |
```
|
| 34 |
|
| 35 |
-
|
| 36 |
-
|
| 37 |
-
|
| 38 |
-
```
|
| 39 |
-
|
| 40 |
-
### Konfiguracja
|
| 41 |
-
|
| 42 |
-
1. **OpenAI API Key**: W panelu bocznym wprowadź swój klucz API OpenAI
|
| 43 |
-
- Klucz zostanie zapisany lokalnie dla kolejnych sesji
|
| 44 |
-
- Potrzebny tylko jeśli chcesz korzystać z funkcji AI Evaluator
|
| 45 |
-
|
| 46 |
-
2. **Przykładowa strategia**: Kliknij **"Load Example"** aby załadować przykładową strategię
|
| 47 |
-
|
| 48 |
-
## 📖 Jak używać
|
| 49 |
-
|
| 50 |
-
### 1. Dashboard
|
| 51 |
-
- Przegląd aktualnej strategii
|
| 52 |
-
- Statystyki (liczba insightów, hipotez, ruchów, metryk)
|
| 53 |
-
- Szybki dostęp do ostatnich wyników symulacji
|
| 54 |
-
|
| 55 |
-
### 2. Strategy Builder
|
| 56 |
-
Buduj strategię krok po kroku w 6 zakładkach:
|
| 57 |
-
|
| 58 |
-
#### 🎯 Goal & Arena
|
| 59 |
-
- Zdefiniuj cel strategiczny
|
| 60 |
-
- Określ metrykę, baseline, target i horyzont czasowy
|
| 61 |
-
- Opisz arenę konkurencji
|
| 62 |
-
|
| 63 |
-
#### 💡 Insights
|
| 64 |
-
- Dodaj insighty rynkowe lub konsumenckie
|
| 65 |
-
- Przypisz źródła dowodów (badania, FGI, etc.)
|
| 66 |
-
|
| 67 |
-
#### 🔬 Hypotheses
|
| 68 |
-
- Sformułuj testowalne hipotezy
|
| 69 |
-
- Powiąż z insightami
|
| 70 |
-
- Określ metrykę i oczekiwaną zmianę
|
| 71 |
-
|
| 72 |
-
#### 🎬 Moves
|
| 73 |
-
- Zdefiniuj konkretne ruchy strategiczne
|
| 74 |
-
- Powiąż z hipotezami
|
| 75 |
-
- Oceń: **impact**, **fit**, **risk**, **cost**
|
| 76 |
-
|
| 77 |
-
#### 📊 Metrics
|
| 78 |
-
- Dodaj metryki sukcesu
|
| 79 |
-
- Określ baseline i target
|
| 80 |
-
|
| 81 |
-
#### ⚖️ Decision Rule
|
| 82 |
-
- Zdefiniuj regułę decyzyjną
|
| 83 |
-
- Np.: "IF CR_online >= 3.4 THEN Scale ELSE Iterate"
|
| 84 |
-
|
| 85 |
-
### 3. Simulation
|
| 86 |
-
- Kliknij **"Run Simulation"**
|
| 87 |
-
- Wyniki:
|
| 88 |
-
- **Scoring ruchów**: `score = (impact × fit) × (1 - risk) / cost`
|
| 89 |
-
- **Ranking ruchów** (tabela i wykres)
|
| 90 |
-
- **Forecast metryk**: `forecast = baseline × (1 + Σscore)`
|
| 91 |
-
- **Wizualizacje**: wykresy słupkowe, scatter plot, graf logiczny
|
| 92 |
-
|
| 93 |
-
### 4. AI Evaluator
|
| 94 |
-
- Wyślij strategię do oceny przez AI
|
| 95 |
-
- Otrzymasz feedback na temat:
|
| 96 |
-
- Spójności logicznej (0-10)
|
| 97 |
-
- Klarowności hipotez
|
| 98 |
-
- Głównych ryzyk
|
| 99 |
-
- Rekomendacji ulepszeń
|
| 100 |
-
|
| 101 |
-
### 5. Report
|
| 102 |
-
- Wygeneruj pełny raport strategii
|
| 103 |
-
- Eksportuj jako:
|
| 104 |
-
- **Markdown** (.md)
|
| 105 |
-
- **JSON** (.json)
|
| 106 |
-
|
| 107 |
-
## 🔧 Architektura
|
| 108 |
|
| 109 |
-
|
| 110 |
-
strategic_sandbox/
|
| 111 |
-
│
|
| 112 |
-
├── app.py # Główny interfejs Streamlit
|
| 113 |
-
├── strategy_core.py # Modele danych i silnik symulacji
|
| 114 |
-
├── requirements.txt # Zależności Python
|
| 115 |
-
├── README.md # Dokumentacja
|
| 116 |
-
│
|
| 117 |
-
├── assets/ # Zasoby graficzne
|
| 118 |
-
│
|
| 119 |
-
└── data/
|
| 120 |
-
├── example.json # Przykładowa strategia
|
| 121 |
-
└── .api_key # Zapisywany klucz API
|
| 122 |
-
```
|
| 123 |
-
|
| 124 |
-
## 📐 Model Danych
|
| 125 |
-
|
| 126 |
-
Strategia składa się z:
|
| 127 |
-
|
| 128 |
-
```python
|
| 129 |
-
{
|
| 130 |
-
"goal": {
|
| 131 |
-
"text": str,
|
| 132 |
-
"metric": str,
|
| 133 |
-
"baseline": float,
|
| 134 |
-
"target": float,
|
| 135 |
-
"horizon": str
|
| 136 |
-
},
|
| 137 |
-
"arena": {
|
| 138 |
-
"market": str,
|
| 139 |
-
"category": str,
|
| 140 |
-
"competitors": [str]
|
| 141 |
-
},
|
| 142 |
-
"insights": [
|
| 143 |
-
{
|
| 144 |
-
"id": str,
|
| 145 |
-
"text": str,
|
| 146 |
-
"evidence": [str]
|
| 147 |
-
}
|
| 148 |
-
],
|
| 149 |
-
"hypotheses": [
|
| 150 |
-
{
|
| 151 |
-
"id": str,
|
| 152 |
-
"text": str,
|
| 153 |
-
"based_on": [str],
|
| 154 |
-
"metric": str,
|
| 155 |
-
"expected_change": float
|
| 156 |
-
}
|
| 157 |
-
],
|
| 158 |
-
"moves": [
|
| 159 |
-
{
|
| 160 |
-
"id": str,
|
| 161 |
-
"text": str,
|
| 162 |
-
"linked_hypothesis": str,
|
| 163 |
-
"impact": float, # 0-1
|
| 164 |
-
"fit": float, # 0-1
|
| 165 |
-
"risk": float, # 0-1
|
| 166 |
-
"cost": float
|
| 167 |
-
}
|
| 168 |
-
],
|
| 169 |
-
"metrics": [
|
| 170 |
-
{
|
| 171 |
-
"id": str,
|
| 172 |
-
"text": str,
|
| 173 |
-
"baseline": float,
|
| 174 |
-
"target": float,
|
| 175 |
-
"unit": str
|
| 176 |
-
}
|
| 177 |
-
],
|
| 178 |
-
"decision": str
|
| 179 |
-
}
|
| 180 |
-
```
|
| 181 |
-
|
| 182 |
-
## 🧮 Formuły
|
| 183 |
|
| 184 |
-
##
|
| 185 |
-
```
|
| 186 |
-
score = (impact × fit) × (1 - risk) / (cost / 100000)
|
| 187 |
-
```
|
| 188 |
|
| 189 |
-
### Forecast metryki:
|
| 190 |
```
|
| 191 |
-
|
|
|
|
| 192 |
```
|
| 193 |
|
| 194 |
-
|
| 195 |
-
|
| 196 |
-
- Czyste, warsztatowe UI w stylu "notebook"
|
| 197 |
-
- Paleta kolorów: biały, jasny szary, niebiesko-turkusowy
|
| 198 |
-
- Czcionki bezszeryfowe (system-ui)
|
| 199 |
-
- Fokus na narzędziu do myślenia, nie prezentacji
|
| 200 |
-
|
| 201 |
-
## 🔐 Bezpieczeństwo
|
| 202 |
-
|
| 203 |
-
- Klucz API OpenAI zapisywany **lokalnie** w `data/.api_key`
|
| 204 |
-
- Nie jest wysyłany nigdzie poza OpenAI API
|
| 205 |
-
- Można usunąć plik `.api_key` aby wyczyścić
|
| 206 |
-
|
| 207 |
-
## 📦 Zależności
|
| 208 |
-
|
| 209 |
-
- **streamlit**: Framework UI
|
| 210 |
-
- **openai**: Integracja z GPT-4
|
| 211 |
-
- **networkx**: Wizualizacja grafów
|
| 212 |
-
- **matplotlib**: Wykresy statyczne
|
| 213 |
-
- **plotly**: Wykresy interaktywne
|
| 214 |
-
- **pandas**: Manipulacja danymi
|
| 215 |
-
- **numpy**: Obliczenia numeryczne
|
| 216 |
-
|
| 217 |
-
## 🗺️ Roadmapa
|
| 218 |
-
|
| 219 |
-
### v0.1 ✅ (Completed)
|
| 220 |
-
- Formularze strategii
|
| 221 |
-
- Scoring i symulacje
|
| 222 |
-
- Export JSON/Markdown
|
| 223 |
-
|
| 224 |
-
### v0.2 (Future)
|
| 225 |
-
- PDF export
|
| 226 |
-
- Więcej typów wizualizacji
|
| 227 |
-
- Import strategii z pliku
|
| 228 |
-
|
| 229 |
-
### v1.0 (Future)
|
| 230 |
-
- Konta użytkowników
|
| 231 |
-
- Wersjonowanie strategii
|
| 232 |
-
- Porównanie strategii
|
| 233 |
-
- Historia symulacji
|
| 234 |
-
|
| 235 |
-
## 💡 Przykłady Użycia
|
| 236 |
-
|
| 237 |
-
### Case Study: Premium Pasta Brand
|
| 238 |
-
|
| 239 |
-
**Goal**: Zwiększyć udział premium do 12% w 2026
|
| 240 |
|
| 241 |
-
|
| 242 |
|
| 243 |
-
**
|
|
|
|
|
|
|
|
|
|
| 244 |
|
| 245 |
-
|
| 246 |
-
1. Test video 15s vs 6s format (Impact: 0.2, Risk: 0.3, Cost: 80k)
|
| 247 |
-
2. Redesign packaging z focus na '12 min' (Impact: 0.35, Risk: 0.5, Cost: 250k)
|
| 248 |
-
3. TV campaign premium storytelling (Impact: 0.4, Risk: 0.4, Cost: 500k)
|
| 249 |
|
| 250 |
-
|
| 251 |
-
- Move m3 (TV campaign) scored highest: 0.0019
|
| 252 |
-
- Forecast CR_online: 3.2% (baseline: 2.8%)
|
| 253 |
-
- Recommendation: Iterate messaging before scaling
|
| 254 |
|
| 255 |
-
|
| 256 |
|
| 257 |
-
|
| 258 |
-
- Kontakt: staniszewski@heuristica.pl
|
| 259 |
|
| 260 |
-
##
|
| 261 |
|
| 262 |
-
|
|
|
|
|
|
|
|
|
|
| 263 |
|
| 264 |
---
|
| 265 |
|
| 266 |
-
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
title: Strategic Sandbox
|
| 3 |
+
emoji: 🎯
|
| 4 |
+
colorFrom: blue
|
| 5 |
+
colorTo: yellow
|
| 6 |
+
sdk: streamlit
|
| 7 |
+
sdk_version: "1.38.0"
|
| 8 |
+
app_file: app.py
|
| 9 |
+
pinned: false
|
| 10 |
+
---
|
| 11 |
|
| 12 |
+
# 🎯 Strategic Sandbox
|
| 13 |
|
| 14 |
+
**Interactive strategy simulation & AI evaluation tool**
|
| 15 |
+
for strategists, planners and brand thinkers.
|
| 16 |
|
| 17 |
+
---
|
| 18 |
|
| 19 |
+
## 🧩 Overview
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 20 |
|
| 21 |
+
**Strategic Sandbox** to narzędzie do:
|
| 22 |
+
- ✍️ Strukturalnego notowania strategii (cele, insighty, hipotezy, ruchy)
|
| 23 |
+
- ⚙️ Symulacji scoringu i wpływu na metryki
|
| 24 |
+
- 🧠 Audytu strategii przez AI (GPT-4)
|
| 25 |
+
- 📊 Wizualizacji zależności i przepływu logicznego
|
| 26 |
+
- 📄 Eksportu raportów (Markdown / JSON)
|
| 27 |
|
| 28 |
+
---
|
| 29 |
|
| 30 |
+
## 🚀 Start
|
|
|
|
|
|
|
|
|
|
| 31 |
|
|
|
|
| 32 |
```bash
|
| 33 |
pip install -r requirements.txt
|
|
|
|
|
|
|
|
|
|
|
|
|
| 34 |
streamlit run app.py
|
| 35 |
```
|
| 36 |
|
| 37 |
+
1. Wprowadź klucz **OpenAI API** w panelu bocznym
|
| 38 |
+
2. Kliknij **"Load Example"** by załadować przykładową strategię
|
| 39 |
+
3. Twórz, testuj, symuluj i oceniaj swoje modele strategiczne
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 40 |
|
| 41 |
+
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 42 |
|
| 43 |
+
## 🧮 Model scoringu
|
|
|
|
|
|
|
|
|
|
| 44 |
|
|
|
|
| 45 |
```
|
| 46 |
+
score = (impact × fit) × (1 - risk) / cost
|
| 47 |
+
forecast = baseline × (1 + Σ scores)
|
| 48 |
```
|
| 49 |
|
| 50 |
+
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 51 |
|
| 52 |
+
## 🧠 Moduły
|
| 53 |
|
| 54 |
+
- **Strategy Builder** — buduj strategię krok po kroku
|
| 55 |
+
- **Simulation** — ranking i wykresy działań
|
| 56 |
+
- **AI Evaluator** — audyt logiki i ryzyk przez GPT-4
|
| 57 |
+
- **Report** — eksport wyników i wizualizacji
|
| 58 |
|
| 59 |
+
---
|
|
|
|
|
|
|
|
|
|
| 60 |
|
| 61 |
+
## 📦 Dependencies
|
|
|
|
|
|
|
|
|
|
| 62 |
|
| 63 |
+
`streamlit`, `openai`, `pandas`, `numpy`, `matplotlib`, `plotly`, `networkx`
|
| 64 |
|
| 65 |
+
---
|
|
|
|
| 66 |
|
| 67 |
+
## 💡 Example
|
| 68 |
|
| 69 |
+
**Goal:** Udział premium 12% do 2026
|
| 70 |
+
**Insight:** Premium = rytuał + prostota
|
| 71 |
+
**Hypothesis:** „12 minut do perfekcji” zwiększy CR online o 20%
|
| 72 |
+
**Result:** Najlepszy ruch – kampania TV premium storytelling (score: 0.0019)
|
| 73 |
|
| 74 |
---
|
| 75 |
|
| 76 |
+
👤 Autor: [Heuristica.pl / Marek Staniszewski](https://www.heuristica.pl)
|
| 77 |
+
📧 staniszewski@heuristica.pl
|
| 78 |
+
📄 MIT License
|