project-module-architecture

Skill zawierający wytyczne architektoniczne modułu Project z BK-CI. Obejmuje operacje CRUD projektów, zarządzanie członkami zespołu, konfigurację właściwości, zarządzanie etykietami i migrację projektów. Używaj go podczas implementacji funkcji zarządzania projektami, obsługi uprawnień członków, konfiguracji atrybutów projektu lub logiki związanej z projektami w systemie BK-CI. Moduł stanowi fundament całej platformy – wszystkie inne mikroserwisy zależą od Project, a projekt jest najmniejszą jednostką izolacji zasobów.

1. Zapoznaj się ze strukturą modułu Project w katalogu src/backend/ci/core/project/. Moduł dzieli się na cztery główne warstwy: api-project (definicje interfejsów REST i obiekty danych), biz-project (logika biznesowa i implementacja API), model-project (modele danych JOOQ) oraz boot-project (konfiguracja Spring Boot).
2. Gdy rozwijasz funkcje zarządzania projektami, odwołuj się do warstwy api-project, gdzie zdefiniowane są interfejsy dla operacji użytkownika (user), wywołań między serwisami (service) i operacji administracyjnych (op). Zawiera ona ponad 100 klas POJO i definicje stałych.
3. Implementuj logikę biznesową w warstwie biz-project, wykorzystując dostępne serwisy (service/impl), dostęp do danych (dao) i słuchacze zdarzeń (listener). Warstwa zawiera ponad 120 klas obsługujących CRUD, zarządzanie członkami, konfigurację i uprawnienia.
4. Dla operacji na danych projektów korzystaj z warstwy model-project, która dostarcza automatycznie generowane modele JOOQ do interakcji z bazą danych.
5. Jeśli rozszerzasz moduł, użyj przykładowych implementacji z katalogów api-project-sample i biz-project-sample jako szablonów dla nowych interfejsów i serwisów.
6. Pamiętaj, że Project jest modułem bazowym – wszystkie zmiany wpływają na pozostałe mikroserwisy, dlatego zawsze testuj operacje CRUD, zarządzanie uprawnieniami i migracje projektów przed wdrożeniem.