process-module-architecture

Skill Process Module Architecture to przewodnik po wewnętrznej budowie modułu Process w BK-CI, odpowiedzialnego za orkiestrację, planowanie i wykonanie potoków. Obejmuje pięć warstw: API, usługi biznesowe, silnik budowania, dostęp do danych i mechanizm sterowany zdarzeniami. Używaj go, gdy rozwijasz funkcje rdzenia potoku, modyfikujesz logikę budowania lub potrzebujesz zrozumieć, jak działają operacje CRUD na potokach.

1. Zapoznaj się z ogólną strukturą modułu Process, czytając główny dokument architektury. Skill opisuje pięć kluczowych warstw: api-process (interfejsy), biz-base (logika biznesowa), biz-engine (silnik budowania), biz-process (przetwarzanie) i model-process (modele danych). Ta wiedza stanowi fundament do dalszych prac.

2. Określ, którą warstwę musisz zmodyfikować. Jeśli pracujesz nad interfejsami użytkownika, przejdź do dokumentacji API Layer (1-api-layer.md). Jeśli zmieniasz logikę biznesową, zajrzyj do Service Layer (2-service-layer.md). Dla zmian w silniku wykonawczym sprawdź Engine Control (3-engine-control.md).

3. Dla pracy z danymi i bazą danych zapoznaj się z dokumentacją DAO Layer (4-dao-database.md), która zawiera strukturę tabel i operacje dostępu. Jeśli integrujesz nowe zdarzenia lub zmieniasz przepływ zdarzeń, przeczytaj Event Driven (5-event-driven.md).

4. Użyj mapy nawigacyjnej zawartej w skill'u, aby szybko zlokalizować odpowiedni plik referencyjny. Każdy dokument zawiera szczegółową analizę (700–900 linii kodu), więc możesz przejść bezpośrednio do interesującego Cię obszaru.

5. Podczas implementacji funkcji rdzenia potoku (CRUD, planowanie, wykonanie) odwołuj się do odpowiedniej warstwy. Skill pokazuje hierarchię modułów i ich odpowiedzialność, co ułatwia zrozumienie, gdzie dodać nowy kod lub zmienić istniejący.

6. Po zrozumieniu architektury wróć do dokumentacji referencyjnej, aby zanurzyć się w szczegółach implementacji konkretnej warstwy, którą chcesz rozwijać.