repository-module-architecture

Przewodnik architektoniczny modułu Repository dla BK-CI, obejmujący integrację repozytoriów Git/SVN, konfigurację webhooków, zarządzanie dostępem i wyzwalacze. Użyj tej umiejętności podczas tworzenia funkcji repozytoriów, konfigurowania webhooków, obsługi autoryzacji kodów źródłowych lub implementowania logiki wyzwalaczy. Moduł wspiera GitHub, GitLab, TGit, P4 i inne platformy hostingowe z uwierzytelnianiem OAuth, SSH i HTTP.

1. Zapoznaj się ze strukturą modułu Repository w BK-CI, która dzieli się na warstwy: api-repository (definicje interfejsów REST), biz-repository (logika biznesowa i implementacje), biz-base-scm (operacje Git/SVN), model-repository (modele danych JOOQ) oraz moduły startowe i pluginy. 2. Zidentyfikuj typ repozytorium, które chcesz obsługiwać (Git, TGit, GitHub, GitLab, SVN, P4) i odpowiadającą mu enumerację (np. CODE_GIT, GITHUB). Każdy typ obsługuje różne metody uwierzytelniania: OAuth, SSH lub HTTP. 3. Jeśli konfigurujesz webhooks, skorzystaj z warstwy API w module api-repository oraz implementacji w biz-repository/resources, gdzie znajdziesz dedykowane serwisy dla GitHub i SCM. 4. Do zarządzania autoryzacją i dostępem do repozytoriów wykorzystaj serwisy OAuth2 i autoryzacyjne z warstwy biz-repository/service, które obsługują różne mechanizmy uwierzytelniania dla każdego typu platformy. 5. Dla wyzwalaczy i automatyzacji opartej na zdarzeniach z repozytoriów, implementuj logikę w warstwie service, korzystając z dostępnych serwisów ładujących (loader) i usług specjalistycznych dla konkretnych typów kodów źródłowych. 6. Rozszerzaj funkcjonalność za pomocą pluginów (np. plugin-github, plugin-tapd) lub dodawaj nowe typy repozytoriów, rozszerzając strukturę modułu zgodnie z istniejącym wzorcem warstwowym.