Marek4321 commited on
Commit
7ba08b7
·
verified ·
1 Parent(s): 75c2d09

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +48 -236
README.md CHANGED
@@ -1,266 +1,78 @@
1
- # 🎯 Strategic Sandbox v1.0
 
 
 
 
 
 
 
 
 
2
 
3
- Interactive strategy simulation and evaluation tool for strategic planners and brand strategists.
4
 
5
- ## 📋 Overview
 
6
 
7
- **Strategic Sandbox** to narzędzie wspierające strategów w budowaniu, testowaniu i symulowaniu strategii biznesowych w logicznej, pół-obliczeniowej formie.
8
 
9
- Pozwala na:
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
- ## 🚀 Szybki Start
 
 
 
 
 
17
 
18
- ### Instalacja
19
 
20
- 1. Sklonuj lub pobierz projekt:
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
- 4. Otwórz w przeglądarce:
36
- ```
37
- http://localhost:8501
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
- ### Scoring ruchu:
185
- ```
186
- score = (impact × fit) × (1 - risk) / (cost / 100000)
187
- ```
188
 
189
- ### Forecast metryki:
190
  ```
191
- forecast = baseline × (1 + Σ scores_of_linked_moves)
 
192
  ```
193
 
194
- ## 🎨 Design
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
- **Key Insight**: Premium = rytuał + prostota
242
 
243
- **Hypothesis**: Narracja '12 minut do perfekcji' zwiększy CR online o 20%
 
 
 
244
 
245
- **Moves**:
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
- **Results**:
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
- ## 🤝 Wsparcie
256
 
257
- Dla pytań lub zgłaszania błędów:
258
- - Kontakt: staniszewski@heuristica.pl
259
 
260
- ## 📄 Licencja
261
 
262
- Projekt stworzony przez www.Heuristica.pl / Marek Staniszewski
 
 
 
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