django-drf

Django REST Framework patterns. Trigger: When implementing generic DRF APIs (ViewSets, serializers, routers, permissions, filtersets). For Prowler API specifics (RLS/RBAC/Providers), also use prowler-api.

1. Zainstaluj skill w swoim projekcie Django poprzez dodanie go do konfiguracji Claude/Copilota. Skill automatycznie aktywuje się, gdy pracujesz w katalogu api/ i tworzysz nowe ViewSety, serializery lub filtry.

2. Przy implementacji nowego endpointu zacznij od modelu — upewnij się, że używasz UUID jako klucza głównego (UUIDv4 lub UUIDv7), dodaj pola inserted_at i updated_at, oraz zdefiniuj JSONAPIMeta.resource_name dla zgodności ze schematem JSON:API.

3. Utwórz ViewSet dziedziczący z BaseRLSViewSet i zaimplementuj get_queryset() z użyciem select_related() lub prefetch_related() aby uniknąć problemu N+1. Pamiętaj o obsłudze swagger_fake_view dla poprawnego generowania schematu OpenAPI.

4. Zdefiniuj serializery — zawsze oddziel je na operacje: Read (odczyt), Create (tworzenie), Update (aktualizacja) i Include (zagnieżdżone dane). Serializery do zapisu powinny dziedziczyć z BaseWriteSerializer i walidować nieznane pola.

5. Dodaj filtrowanie za pomocą filterset_class zamiast filterset_fields dla bardziej złożonych scenariuszy. Dziedzicz z dostępnych klas bazowych filtrów w projekcie.

6. Skonfiguruj routing bez końcowych slashów (trailing_slash=False), dodaj paginację i uprawnienia dostępu. Skill podpowie konkretne wzorce na każdym etapie — nigdy nie umieszczaj logiki biznesowej w serializerach, używaj dedykowanych serwisów lub narzędzi.