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.7.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.7-py3-none-any.whl (87.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: biznes-1.0.7.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.7.tar.gz
Algorithm Hash digest
SHA256 760acfbdd84ecdc71932dbe897ce7155125c011cf244d6687b7fccb98f1d4bf2
MD5 52fe8524f6274da6bf3ee8d0e154a84d
BLAKE2b-256 c3a9c057ca594e32c5882099129226fd0beb2418f1b17fa7c24f492f99405815

See more details on using hashes here.

File details

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

File metadata

  • Download URL: biznes-1.0.7-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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 07cafb8c804126233c7cb8bcda0fa39361d66e79eb8e180814a24fb4a5bacd83
MD5 b109dedd0412a45c07b92d92fa504582
BLAKE2b-256 7767c3d5225a191d27ba0f6f51379eb7fc7c1b2b0acc18470800ad836d347125

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