Jak spisać swój proces tak, żeby dało się z niego zbudować aplikację dla całej branży?
Spisz proces w pięciu warstwach: role, kroki, dokumenty, wyjątki, decyzje — jedna ścieżka główna od pierwszego zdarzenia do zapłaty. Wariant, który powtarza się u co najmniej trzech znanych Ci firm, wpisujesz jako parametr, nie jako wyjątek. Notacji uczyć się nie musisz: w badaniu 120 diagramów BPMN przeciętny model używał 9 konstrukcji (CAiSE 2008).
Z czego składa się zapis procesu, z którego da się zbudować aplikację?
Z pięciu warstw: role, kroki, dokumenty, wyjątki i decyzje. Z takiego zapisu zespół techniczny policzy ekrany, pola i uprawnienia. Z opowieści „jak to u nas wygląda” nie policzy niczego, bo nie wiadomo, gdzie kończy się jeden krok, a zaczyna następny.
Warstwy zapisujesz w tej kolejności, bo każda następna korzysta z poprzedniej. Role mówią, kto siada przed ekranem. Kroki układają jedną ścieżkę główną od pierwszego zdarzenia do zapłaty. Dokumenty pokazują, co na każdym kroku wchodzi i co z niego wychodzi.
Wyjątki to sytuacje, w których ścieżka się łamie: klient odwołuje, brakuje podpisu, towar wraca, termin przepada. Decyzje to miejsca, w których ktoś wybiera wariant według warunku — i akurat one najczęściej siedzą wyłącznie w Twojej głowie.
Notacji uczyć się nie musisz. Standard BPMN w wersji 2.0.2 opublikowano w styczniu 2014 roku, a wcześniejsza wersja tej notacji (BPMN 2.0.1) jest normą ISO/IEC 19510:2013 o statusie opublikowanej i potwierdzonej (odczyt 16 września 2026).
W analizie 120 diagramów BPMN regularnie używano mniej niż 20 % słownika tej notacji, przeciętny model zawierał 9 różnych konstrukcji, a modele o podobnej złożoności miały wspólne zwykle 4–5 z nich (badanie z 2008 roku). Tabela i numerowana lista wystarczą, jeśli mają te same pięć warstw.
| Element procesu | Pytanie, które musisz sobie zadać | Częsty błąd | Koszt błędu (ekrany, rundy poprawek) |
|---|---|---|---|
| Role i uprawnienia | Kto wykonuje ten krok, kto go zatwierdza, a kto tylko podgląda? | jedna rola „pracownik” zamiast trzech różnych | komplet ekranów i uprawnień dorabiany po kodzie, do tego druga runda akceptacji ekranów |
| Ścieżka główna | Od jakiego zdarzenia zaczyna się praca i co kończy sprawę dla klienta? | start od „przychodzi zlecenie”, bez tego, kto i gdzie je wpisuje | ekran bez wejścia z interfejsu — u nas blokuje wdrożenie do czasu wskazania, kto na niego trafia |
| Dokumenty i dane | Co powstaje na tym kroku i które pola są obowiązkowe? | „wysyłamy dokument” bez listy pól i bez wzoru | formularz projektowany drugi raz, przy dokumencie formalnym także wydruk i numeracja |
| Wyjątki | Co się dzieje, gdy sprawa nie idzie po kolei, i kto to naprawia? | wyjątki „dogadywane telefonicznie”, więc nieopisane | brak statusów, stanów pustych i ekranów błędu — użytkownik zostaje na ekranie bez wyjścia |
| Decyzje | Jaki warunek przesądza o wyborze i jakie są wszystkie możliwe wyniki? | „to zależy od sytuacji” zamiast warunku i listy wyników | automatyzacje i powiadomienia przepisywane po pierwszym tygodniu na żywo |
| Nazewnictwo | Jak nazywacie ten obiekt u siebie, a jak nazywają go inne firmy z branży? | cztery nazwy tego samego obiektu w jednym dokumencie | etykiety i nagłówki poprawiane na wszystkich ekranach, na których obiekt występuje |
Kolumna kosztu opisuje pracę, która wraca: te same ekrany, drugą akceptację, przepisaną automatyzację. U nas budżet poprawek na krok to trzy rundy krytyki, a czwarta nie startuje — zamiast niej zapada decyzja, co wchodzi teraz, a co do następnej wersji (stan na 16 września 2026).
Co powstaje po drodze: siedem dokumentów, które ktoś musi zamknąć
Zapis procesu to nie jeden plik, tylko siedem artefaktów — każdy w innej formie i każdy z osobą, która go zamyka. Kolejność nie jest dowolna: każdy artefakt blokuje coś konkretnego w budowie, dopóki nie jest gotowy.
- Słownik branży — tabela: nazwa obiektu, co znaczy, jak mówią o nim inne firmy. Zamyka praktyk. Bez niego nie da się nazwać ekranów ani pól, a każda kolejna firma przyniesie własne słowo na to samo.
- Mapa ról — tabela: rola, co robi, czego nie widzi, kto ją nadaje. Zamyka praktyk. Blokuje logowanie, panele i zasady dostępu do danych; rola dopisana po kodzie to komplet ekranów od nowa.
- Ścieżka główna — numerowana lista kroków, jedno zdanie na krok, każde zaczyna się czasownikiem. Zamyka praktyk. Blokuje policzenie ekranów, a więc wycenę i termin — bez niej nie ma czego liczyć.
- Katalog dokumentów i pól — co wchodzi i co wychodzi na każdym kroku, które pola są obowiązkowe. Zamyka praktyk, a przy dokumentach formalnych także osoba, która za nie odpowiada w firmie. Blokuje formularze, wydruki i wymianę danych z innymi programami.
- Rejestr wyjątków — tabela: co poszło nie tak, jak często, kto naprawia, co dzieje się wtedy z dokumentem. Zamyka praktyk. Blokuje statusy, stany puste i ekrany błędu, czyli sporą część pracy nad panelem.
- Tabele decyzji — jeden wiersz to jedna kombinacja warunków i jej wynik. Zamyka praktyk. Blokuje automatyzacje i powiadomienia. Sama tabela decyzyjna ma własny standard: notację DMN w wersji 1.5, opublikowaną w sierpniu 2024 roku.
- Lista parametrów per firma — ustawienia, które każda firma zmienia u siebie, z wartością domyślną. Zamyka praktyk. Blokuje wpuszczenie drugiej firmy: bez tej listy każdy jej wariant trafia do kodu zamiast do ustawień.
Żaden z tych dokumentów nie jest jeszcze zakresem pierwszej wersji aplikacji. Zakres powstaje później, ma inne elementy i inne kryteria — opisaliśmy go w tekście o zakresie pierwszej wersji. Materiały, decyzje i dostępy, bez których budowa staje, to jeszcze inna lista: wkład zamawiającego.
Gdy proces jest spisany, następne pytanie brzmi: co z tego musi umieć aplikacja w konkretnej branży. Tak wygląda gotowa lista wymagań dla jednej z nich — co musi umieć aplikacja dla biura nieruchomości.
„Jak u mnie” kontra „jak w branży” — co jest parametrem, a co wyjątkiem?
Różnica między Twoją firmą a resztą branży rzadko jest innym procesem. To zwykle inne wartości w tych samych miejscach: inna nazwa, inny próg, inna osoba zatwierdzająca, dwa kroki zamienione kolejnością.
Reguła, którą stosujemy przy zapisie: wariant, który zobaczysz u co najmniej trzech znanych Ci firm, wpisujesz jako parametr. Dlaczego trzy? Przy jednej firmie nie odróżnisz branży od własnego nawyku, przy dwóch — reguły od przypadku. Trzecia zamienia anegdotę we wzór, a ustawienie w panelu kosztuje mniej niż drugi ekran.
Wariant, który wymaga innego ekranu albo innego dokumentu, parametrem nie jest — to osobna wersja i osobny koszt. Wariant, który zdarza się raz na kwartał u jednej firmy, zostaje wyjątkiem opisanym w procedurze, a nie funkcją w aplikacji.
W ponad 300 rozmowach o pomysłach na aplikację, które prowadziliśmy między czerwcem a wrześniem 2026 (ręczna klasyfikacja opisów pomysłu, stan 16.09.2026), 6 na 10 pomysłów to narzędzie dla firm z własnej branży, a 1 na 5 — platforma łącząca dwie strony branży.
Zapis dla siebie i zapis dla dziesięciu firm różnią się prawie wyłącznie listą parametrów. Dlatego kolumnę „u mnie” prowadzisz od pierwszego dnia obok kolumny „u innych”; dopisanie jej później oznacza przejście przez cały proces drugi raz. Kiedy budować od razu dla wielu firm, rozstrzyga osobny tekst o pierwszej wersji dla wielu firm.
Zapis sprawdzasz ekranami, nie dyskusją. U nas ekrany powstają przed logiką i to one są testem zapisu: ekran, do którego nie prowadzi żadne wejście z interfejsu, wstrzymuje wdrożenie, dopóki nie wiadomo, kto i kiedy na niego trafia.
Gotowy ekran porównujemy z zaakceptowanym planem ekranów, a zmiana planu po starcie budowy jest wykrywana i wymaga osobnej zgody — nie dzieje się przy okazji. To jest moment, w którym brakujący krok w Twoim zapisie widać gołym okiem, jeszcze zanim powstanie logika.
Konkurent jako partner: czyj proces zostaje w aplikacji, gdy wchodzi druga firma?
Konkurent nie kupi aplikacji, która każe mu pracować po Twojemu — kupi taką, w której jego sposób pracy jest ustawieniem. Dlatego pierwsza rozmowa z nim nie dotyczy funkcji, tylko trzech rzeczy: nazw, progów i tego, kto zatwierdza.
- Widzi swój język na ekranie. Etykiety z jego słownika, nie z Twojego. To pierwszy dowód, że aplikacja jest branżowa, a nie „Twoją firmą w internecie”. Kosztuje jedną kolumnę w słowniku pojęć na każdą firmę.
- Dostaje swoje progi jako ustawienia. Terminy, stawki, kolejność akceptacji. Powiedz wprost, zanim padnie pytanie: wariant powtarzalny u trzech firm wchodzi jako parametr, wariant jednej firmy zostaje wyjątkiem w procedurze.
- Może wyjść z własnymi danymi. Eksport w czytelnym formacie i termin usunięcia konta ustalone z góry. Boi się dwóch rzeczy: że jego klienci i marże staną się Twoim materiałem oraz że wyjście będzie kosztowało go bazę klientów.
- Wie, co się stanie z jego wymaganiem. Kto je zgłasza, kto decyduje, w jakim terminie dostaje odpowiedź. Sposoby zbierania wymagań bez rozdawania pomysłu opisuje osobny tekst serii.
Oddzielenie danych każdej firmy jest przy tym warunkiem, nie dodatkiem, i rozstrzyga się przy projekcie bazy — czyli po stronie zespołu technicznego, nie Twojej.
Zapisz trzy rzeczy, zanim wejdzie druga firma: które ustawienia należą do niej, co się dzieje, gdy dwie firmy chcą przeciwnych zachowań w tym samym kroku, i czy z danych wszystkich firm powstają zestawienia zbiorcze — a jeśli tak, za czyją zgodą i w jakiej postaci.
Co zostaje po Twojej stronie, a co robi zespół, który buduje
Z pięciu warstw zapisu cztery są nieprzenaszalne. Nikt poza Tobą nie wie, co się dzieje, gdy klient odwołuje w piątek po południu, ani po czym poznać, że sprawa jest zamknięta. Piąta warstwa, decyzje, jest wspólna: Ty podajesz warunek i wyniki, zespół zamienia je w regułę, którą da się wykonać i przetestować.
| Obszar | Po Twojej stronie (praktyk) | Po stronie zespołu, który buduje i utrzymuje |
|---|---|---|
| Słownik i nazwy | nazwy obiektów, synonimy innych firm, rozstrzygnięcie sporu o nazwę | spójne użycie nazw na ekranach, w powiadomieniach i dokumentach |
| Ścieżka główna | kolejność kroków i to, co kończy sprawę dla klienta | zamiana kroków na ekrany, statusy i uprawnienia |
| Wyjątki | które się zdarzają, jak często i kto je dziś naprawia | stany puste, ekrany błędu, powroty do poprzedniego kroku |
| Decyzje i progi | warunek i wszystkie wyniki, także te rzadkie | wykonanie reguły i test dla każdej kombinacji |
| Parametry per firma | które ustawienia firma zmienia u siebie i jakie są domyślne | miejsce na ustawienia, konta firm, oddzielenie ich danych |
| Akceptacje | ekrany, plan ekranów, kryteria „gotowe” dla ścieżki głównej | zgłoszenie do akceptacji, ślad wersji, poprawki w budżecie rund |
| Pierwsi partnerzy | rozmowy, pilot, kolejność wdrożeń w branży | gotowość techniczna: konta firm, wczytanie danych, eksport |
| Architektura i utrzymanie | decyzja, że budujemy, i odpowiedź na pytania o proces | baza, kod, bezpieczeństwo, płatności, aktualizacje po starcie |
Podział jest ostry z powodu kosztu błędu po obu stronach. Proces opisany przez kogoś z zewnątrz poprawia się potem w kodzie, a kod poprawiany przez praktyka kończy się awarią w tygodniu rozliczeń. Ile kosztuje samo posiadanie aplikacji przez trzy lata, policzył osobny rachunek — to inne pytanie niż zapis procesu.
Jedno zostaje niezmiennie po Twojej stronie: rozstrzyganie sporów o proces. Zespół techniczny powie, co jest wykonalne i ile kosztuje, ale nie rozsądzi, czy w tej branży najpierw jedzie się na oględziny, czy najpierw wystawia kosztorys.
Najczęstsze pytania
Czy muszę nauczyć się BPMN albo innej notacji?
Nie. Notacja pomaga przy przekazaniu procesu programistom, ale nie jest warunkiem. W analizie 120 diagramów BPMN regularnie używano mniej niż 20 % słownika notacji, a przeciętny model zawierał 9 różnych konstrukcji (badanie z 2008 roku). Tabela, numerowana lista i jedno zdanie na krok dają zespołowi to samo, co diagram, pod warunkiem że mają wszystkie pięć warstw.
Mój proces jest w głowie, a nie w dokumentach — od czego zacząć?
Od trzech ostatnich zamkniętych spraw, przeglądanych wstecz: od faktury do pierwszego telefonu. Wypisz wszystko, czego dotykałeś po drodze: wiadomości, arkusze, zdjęcia, podpisy, przelewy. To daje ścieżkę główną i katalog dokumentów w jedno popołudnie. Wyjątki dopisujesz przez kolejny tydzień, na bieżąco, bo z pamięci prawie nigdy nie wychodzą kompletne.
Jak szczegółowo opisywać pojedynczy krok?
Jeden krok to jedno zdanie zaczynające się czasownikiem, jedna osoba i jeden wynik. Jeśli opis wymaga trzech zdań, to są trzy kroki. Jeśli w środku zmienia się osoba wykonująca, to też są dwa kroki, bo między nimi coś musi zostać przekazane. Zbyt drobny podział poznasz po tym, że kolejne kroki nie zmieniają żadnego dokumentu ani statusu.
Czy spisany proces to już zakres pierwszej wersji aplikacji?
Nie. Proces opisuje, jak pracuje branża; zakres pierwszej wersji mówi, co z tego zostanie zbudowane najpierw, czego świadomie nie będzie i po czym poznać odbiór. Zwykle pierwsza wersja obsługuje jedną ścieżkę główną i najczęstsze wyjątki, a rzadkie warianty zostają przy telefonie. Bez spisanego procesu zakresu nie da się jednak zamknąć ani policzyć.
Źródła
- Object Management Group — Business Process Model and Notation (BPMN) 2.0.2, dokument formal/13-12-09, publikacja styczeń 2014 — https://www.omg.org/spec/BPMN/2.0.2/ (odczyt 16.09.2026)
- ISO/IEC 19510:2013 — Information technology. Object Management Group Business Process Model and Notation (edycja 1 z lipca 2013, status: norma opublikowana i potwierdzona, identyczna z OMG BPMN 2.0.1) — https://www.iso.org/standard/62652.html (odczyt 16.09.2026)
- M. zur Muehlen, J. Recker — How Much Language Is Enough? Theoretical and Practical Use of the Business Process Modeling Notation, CAiSE 2008 (analiza 120 diagramów: poniżej 20 % słownika w regularnym użyciu, przeciętny model 9 konstrukcji, 4–5 wspólnych) — https://link.springer.com/chapter/10.1007/978-3-540-69534-9_35 (publikacja 2008, odczyt 16.09.2026)
- Object Management Group — Decision Model and Notation (DMN) 1.5, publikacja sierpień 2024 (tabele decyzyjne jako standard zapisu decyzji) — https://www.omg.org/spec/DMN/1.5/ (odczyt 16.09.2026)
- Zapis procesu, ekrany przed logiką, osiągalność widoków i budżet rund poprawek w naszych wdrożeniach — praktyka zespołu — https://jakzrobicaplikacje.pl/o-serwisie/#skad (stan na 16.09.2026)
- Ponad 300 rozmów o pomysłach na aplikację prowadzonych między czerwcem a wrześniem 2026, ręczna klasyfikacja opisów pomysłu — zestawienie redakcji — https://jakzrobicaplikacje.pl/o-serwisie/#skad (stan na 16.09.2026)
Tekst przygotował Agent AI Tomka Niedźwieckiego — treść wygenerowana przez sztuczną inteligencję na podstawie własnych wdrożeń zespołu, dokumentacji dostawców i źródeł podanych wyżej, sprawdzona w osobnym przebiegu weryfikacji faktów i zredagowana. Za fakty odpowiada Tomek Niedźwiecki. Ostatnia weryfikacja: 16 września 2026.