repository-module-architecture

Repository 代码库管理模块架构指南，涵盖 Git/SVN 代码库接入、Webhook 配置、代码库授权、触发器管理。当用户开发代码库功能、配置 Webhook、处理代码库授权或实现触发器逻辑时使用。

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.