Quickstart — Od Zera do Pierwszego Diagramu w 5 Minut

Przewodnik dla nowych użytkowników SOTER. Po jego przejściu będziesz mieć działający model i diagram.

Pełna dokumentacja: → Manual.md | CONTEXT_BOOTSTRAP_FILE.md

Krok 1 — Instalacja (1 min)

Z katalogu projektu:

python ./soter.py install
source ~/.bashrc

Sprawdź czy działa:

soter --version

Krok 2 — Utwórz pierwszy model (2 min)

Utwórz plik models/moj_pierwszy.model:

soter v1

# Podmiot — aktywny aktor
element u-s001()
    type: Subject
    name: "Moja Firma"
    autonomy: true
    role: "Dostawca usług"

# Zasób — co firma wytwarza
element u-o001()
    type: Object
    name: "Usługa IT"
    category: memory
    nature: digital

# Akcja — transformacja
element u-a001()
    type: Action
    name: "Świadczenie usługi"
    intent: "Generowanie przychodu"
    in: u-o001
    out: u-o001

# Relacja podmiot → akcja
relationship u-r001()
    source: u-s001
    target: u-a001

show u-s001

Krok 3 — Uruchom pipeline (30 sek)

soter run models/moj_pierwszy.model

Wynik w katalogu out/:

• moj_pierwszy.sqlite3 — baza danych z modelem
• moj_pierwszy.svg — diagram (jeśli zainstalowany renderer D2)

Krok 4 — Otwórz panel WWW (30 sek)

soter serve

Otwórz http://localhost:8000 w przeglądarce.

Poziomy (Levels): Domyślnie zobaczysz zestaw funkcji odpowiadający implementation_level (np. Level 1). Możesz to zmienić w soter.conf. Logowanie: Jeśli uruchamiasz SOTER w trybie produkcyjnym, użyj linku "Login" w menu, aby uzyskać dostęp do pełnego panelu.

Krok 5 — Utwórz widok (1 min)

Utwórz plik views/podsumowanie.view:

soter v1

view "Podsumowanie_Firmy"
    source: "models/moj_pierwszy.model"
    render:
        mapping: BPMN_2_0

Uruchom:

soter run views/podsumowanie.view

Co dalej?