Skip to main content

Interaktywny symulator startupu - edukacyjna gra o zakładaniu firmy w Polsce

Project description

🚀 BIZNES - Symulator Startupu v2.0

Interaktywna gra edukacyjna o zakładaniu firmy w Polsce. Naucz się vestingu, umów wspólników, form prawnych i finansów startupowych.

img.png

✨ Co nowego w v2.0

  • Interaktywne menu akcji - każdego miesiąca widzisz co możesz zrobić
  • Konsekwencje decyzji - przed każdą akcją widzisz korzyści i ryzyka
  • Blokady z wyjaśnieniem - dlaczego nie możesz wykonać danej akcji
  • Dynamiczny vesting - śledzenie cliff i vested udziałów
  • Losowe zdarzenia - realistyczne sytuacje biznesowe

🎮 Szybki start

# Instalacja (wersja tekstowa)
pip install -e .

# Instalacja z TUI (nawigacja strzałkami)
pip install -e ".[tui]"

# Uruchomienie - wersja tekstowa
biznes

# Uruchomienie - wersja TUI (strzałki, Enter, bez pisania)
biznes-tui

🖥️ Tryb TUI (Textual)

Nowy tryb z pełną nawigacją klawiaturą:

  • ↑↓ - wybór opcji
  • Enter - zatwierdź
  • Esc - wróć
  • M/S/F/E/H/Q - skróty klawiszowe

📋 Komendy

Komenda Opis
start Nowa gra z konfiguracją
miesiac Następny miesiąc + menu akcji (max 2 akcje)
akcje Pokaż dostępne akcje
historia Historia decyzji i zdarzeń
status Stan firmy
finanse Szczegóły finansowe
equity Cap table
ryzyko Analiza zagrożeń
nauka Materiały edukacyjne
slownik Słownik pojęć

🎯 Przykład rozgrywki

biznes> start

ETAP 1/6: Twoje dane
Twoje imię [Founder]: Jan

Twoja rola?
  1. Technical (programista)
     → Konsekwencja: Twój czas = wartość MVP
  2. Business (sprzedaż)
     → Konsekwencja: Potrzebujesz technicznego co-foundera

...

════════════════════════════════════════════════════════════
  MIESIĄC 1
════════════════════════════════════════════════════════════

📊 SYTUACJA:
   Gotówka: 10,000 PLN
   MRR: 0 PLN | Klienci: 0
   Runway: 2 mies

────────────────────────────────────────────────────────────
  DOSTĘPNE AKCJE
────────────────────────────────────────────────────────────

⚖️ PRAWNE:
  1. ✓ Załóż spółkę [ZALECANE]
     Zarejestruj PSA w KRS
  2. ✓ Podpisz umowę wspólników (SHA) ⚠️ BEZ UMOWY RYZYKUJESZ WSZYSTKO!
     Formalna umowa regulująca prawa founderów

🔧 PRODUKT:
  3. ✓ Rozwijaj MVP [ZALECANE]
     Kontynuuj prace nad produktem

📚 Czego się nauczysz

  • Formy prawne: PSA vs Sp. z o.o. - kiedy która
  • Vesting: 48 miesięcy, cliff 12 miesięcy, dlaczego to ważne
  • Good/Bad leaver: Ochrona przed odejściem partnera
  • Tag-along/Drag-along: Prawa przy sprzedaży
  • Wycena MVP: Metoda kosztowa (godziny × stawka)
  • Podział equity: Czynniki wpływające na udziały
  • Weryfikacja partnera: KRS, rejestry dłużników

🎲 Mechanika gry

Każdy miesiąc:

  • Losowe zdarzenia (pozytywne i negatywne)
  • Aktualizacja vestingu
  • Sprawdzanie warunków sukcesu/porażki

Zdarzenia losowe

Pozytywne:

  • Viral marketing
  • Strategiczny partner
  • Enterprise klient
  • Nagroda branżowa

Negatywne:

  • Konkurent z dużym funding
  • Kluczowy pracownik odchodzi
  • Konflikt między founderami
  • MVP nie spełnia oczekiwań
  • Problem z płynnością

🔧 Wymagania

  • Python 3.8+
  • Terminal z obsługą UTF-8 i kolorów ANSI

📄 Licencja

MIT License - Softreck 2025

🤝 Wsparcie

Masz pytania? Otwórz issue na GitHubie!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

biznes-1.0.8.tar.gz (92.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

biznes-1.0.8-py3-none-any.whl (87.0 kB view details)

Uploaded Python 3

File details

Details for the file biznes-1.0.8.tar.gz.

File metadata

  • Download URL: biznes-1.0.8.tar.gz
  • Upload date:
  • Size: 92.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for biznes-1.0.8.tar.gz
Algorithm Hash digest
SHA256 e5632ef4a970279a7d5f076e940b0fd157675780cfebe6b1b34fb9f10624fe5e
MD5 17f8abe9ed3b854352a2fdac5e914db0
BLAKE2b-256 693478c04d1647105a4177554139c74c3597192aee58df9b1ca16ad8436ea1b8

See more details on using hashes here.

File details

Details for the file biznes-1.0.8-py3-none-any.whl.

File metadata

  • Download URL: biznes-1.0.8-py3-none-any.whl
  • Upload date:
  • Size: 87.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for biznes-1.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 50a4e0fa4f42ca61bc322e23239c2bea70955387ab297828c49e660abf535208
MD5 355bbedd6f6fb05713a86a7c70220fdf
BLAKE2b-256 633b7cb12e43b271dcae0512285b416978fa6261135c1f4dbdc94580376a5e0d

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page