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.6.tar.gz (70.8 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.6-py3-none-any.whl (70.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: biznes-1.0.6.tar.gz
  • Upload date:
  • Size: 70.8 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.6.tar.gz
Algorithm Hash digest
SHA256 0995dcefb212defb4ef8a636943960cfb97cf12ee2545c6ed2642d028c230eff
MD5 a99511896229517ff9bdd7cb22d67bf9
BLAKE2b-256 2c9d3bc744e81945bd96ffc5036a2ee743877f14e29f3761951fe8f0e70a59f0

See more details on using hashes here.

File details

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

File metadata

  • Download URL: biznes-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 70.1 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a3e401821351b3cc3742493dc44d2a956448f2ec9516878c01c9557e4ab818ac
MD5 4f26c36dc3ad8a6cdd744ec68281dcad
BLAKE2b-256 0b1355b97c372d975ce7de42937201dff313a76fb91495e8636e910589e627ff

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