Metadata-Version: 2.4
Name: biznes
Version: 1.0.1
Summary: Edukacyjna gra symulująca zakładanie startupu w Polsce
Author-email: Softreck <info@softreck.dev>
License: MIT
Project-URL: Homepage, https://github.com/softreck/biznes
Project-URL: Documentation, https://github.com/softreck/biznes#readme
Project-URL: Repository, https://github.com/softreck/biznes
Project-URL: Issues, https://github.com/softreck/biznes/issues
Keywords: startup,education,game,simulation,Poland,business
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Polish
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Education
Classifier: Topic :: Games/Entertainment :: Simulation
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0; extra == "dev"
Requires-Dist: black>=23.0; extra == "dev"
Requires-Dist: isort>=5.0; extra == "dev"
Requires-Dist: mypy>=1.0; extra == "dev"
Dynamic: license-file

# 🎮 Biznes - Symulator Startupu dla Founderów

Edukacyjna gra konsolowa symulująca zakładanie i prowadzenie startupu w Polsce. Naucz się podejmować kluczowe decyzje biznesowe, prawne i finansowe w bezpiecznym środowisku.

## 🎯 Cel gry

Gra **Biznes** ma na celu edukację osób planujących założenie startupu poprzez praktyczne symulowanie:

- Weryfikacji potencjalnego wspólnika
- Negocjacji podziału equity
- Wyboru formy prawnej (PSA vs Sp. z o.o.)
- Tworzenia zabezpieczeń prawnych (vesting, good/bad leaver, tag-along)
- Zarządzania finansami i runway
- Reagowania na losowe zdarzenia rynkowe
- Podejmowania strategicznych decyzji

## 🚀 Instalacja

```bash
# Klonowanie repozytorium
git clone https://github.com/softreck/biznes.git
cd biznes

# Instalacja w trybie deweloperskim
pip install -e .

# Lub bezpośrednie uruchomienie
python -m biznes
```

## 📖 Jak grać

### Uruchomienie

```bash
# Po instalacji
biznes

# Lub bezpośrednio
python -m biznes.shell
```

### Podstawowe komendy

| Komenda | Opis |
|---------|------|
| `start` | Rozpocznij nową grę |
| `status` | Pokaż aktualny stan firmy |
| `miesiac` | Przejdź do następnego miesiąca |
| `ryzyko` | Analiza ryzyka |
| `finanse` | Szczegóły finansowe |
| `equity` | Podział udziałów (cap table) |
| `umowa` | Status umowy wspólników |
| `nauka` | Materiały edukacyjne |
| `slownik` | Słownik pojęć startupowych |
| `zapisz` | Zapisz stan gry |
| `eksport` | Eksportuj konfigurację do YAML |
| `pomoc` | Wyświetl pomoc |
| `wyjscie` | Zakończ grę |

## 🎓 Czego się nauczysz?

### Formy prawne
- **PSA (Prosta Spółka Akcyjna)** - idealna dla startupów z equity
- **Sp. z o.o.** - klasyczna forma dla bootstrappingu

### Podział equity
- Wycena MVP metodą kosztową
- Fair podział między technical i business co-founderami
- ESOP pool dla przyszłych pracowników

### Zabezpieczenia prawne
- **Vesting** - stopniowe nabywanie udziałów (4 lata, 1 rok cliff)
- **Good/Bad leaver** - warunki odejścia wspólnika
- **Tag-along** - prawo przyłączenia do sprzedaży
- **Drag-along** - prawo pociągnięcia do sprzedaży
- **NDA** - klauzula poufności
- **Non-compete** - zakaz konkurencji

### Weryfikacja partnera
- Sprawdzanie w KRS (ekrs.ms.gov.pl)
- Rejestry dłużników (BIG, KRD, ERIF)
- Red flags do rozpoznania

### Finanse startupu
- MRR (Monthly Recurring Revenue)
- Burn rate i runway
- Wycena firmy
- Rundy inwestycyjne i rozwodnienie

## 🎲 Mechanika gry

### Etapy konfiguracji

1. **Dane gracza** - Twoja rola (technical/business)
2. **MVP** - Czy masz gotowy prototyp? Wycena.
3. **Partner** - Weryfikacja, co wnosi
4. **Equity** - Podział udziałów z rekomendacją
5. **Forma prawna** - PSA czy Sp. z o.o.?
6. **Zabezpieczenia** - Klauzule w umowie wspólników
7. **Cele** - MRR, klienci, runway
8. **Symulacja** - Trudność, zdarzenia losowe

### Symulacja miesięczna

Każdy miesiąc:
- Automatyczny wzrost klientów i MRR
- Spalanie gotówki (burn rate)
- 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ą

## 📁 Struktura projektu

```
biznes/
├── src/biznes/
│   ├── __init__.py
│   ├── shell.py           # Główny interfejs
│   ├── core/
│   │   ├── __init__.py
│   │   └── models.py      # Modele danych
│   └── scenarios/
│       ├── __init__.py
│       └── engine.py      # Silnik scenariuszy
├── data/
│   └── game_config.yaml   # Pełna konfiguracja gry
├── templates/
├── pyproject.toml
└── README.md
```

## 📊 Plik konfiguracyjny YAML

Gra zapisuje wszystkie parametry do pliku YAML, który może służyć jako:
- Dokumentacja założeń startupu
- Podstawa do dyskusji z prawnikiem
- Materiał do negocjacji z partnerem

Przykład eksportowanej konfiguracji:

```yaml
player:
  name: Jan
  role: technical

mvp:
  has_mvp: true
  hours_invested: 400
  hourly_rate: 150
  external_costs: 10000
  calculated_value: 70000

partner:
  name: Anna
  capital: 20000
  customers: 5
  industry_experience_years: 8
  verified:
    krs: true
    debts: true

equity:
  player_percentage: 55
  partner_percentage: 35
  esop_pool: 10

legal:
  preferred_form: psa
  vesting_months: 48
  cliff_months: 12
  protections:
    tag_along: true
    good_bad_leaver: true
    ip_protection: true
    non_compete: true
    non_compete_months: 12

targets:
  6_months:
    mrr: 10000
    customers: 50
  12_months:
    mrr: 30000
    customers: 150
```

## 🏆 Warunki zwycięstwa

- Osiągnięcie zdefiniowanych celów MRR i liczby klientów
- Zachowanie dodatniego runway
- Uniknięcie bankructwa

## 💀 Warunki porażki

- Gotówka spada poniżej zera
- Bankructwo firmy

## 🛠️ Rozwój

```bash
# Instalacja zależności deweloperskich
pip install -e ".[dev]"

# Testy
pytest

# Formatowanie kodu
black src/
isort src/

# Sprawdzenie typów
mypy src/
```

## 📜 Licencja

MIT License

## 🙏 Podziękowania

Gra powstała na bazie wiedzy o polskim prawie spółek, mechanizmach equity w startupach i doświadczeniach founders z ekosystemu polskich startupów.

---

**Powodzenia w budowaniu Twojego startupu!** 🚀
