Enhance API documentation and schema management by implementing explicit tag configurations for Swagger and ReDoc. Introduce postprocessing hooks to filter auto-generated tags, ensuring only defined tags are used. Update viewsets across various modules to utilize the new tagging system, improving clarity and organization in API documentation.

backend/igny8_core/auth/urls.py

@@ -7,10 +7,11 @@ from rest_framework.routers import DefaultRouter
 from rest_framework.views import APIView
 from rest_framework.response import Response
 from rest_framework import status, permissions
+from drf_spectacular.utils import extend_schema
 from .views import (
     GroupsViewSet, UsersViewSet, AccountsViewSet, SubscriptionsViewSet,
     SiteUserAccessViewSet, PlanViewSet, SiteViewSet, SectorViewSet,
-    IndustryViewSet, SeedKeywordViewSet, AuthViewSet
+    IndustryViewSet, SeedKeywordViewSet
 )
 from .serializers import RegisterSerializer, LoginSerializer, ChangePasswordSerializer, UserSerializer
 from .models import User
@@ -29,9 +30,14 @@ router.register(r'sites', SiteViewSet, basename='site')
 router.register(r'sectors', SectorViewSet, basename='sector')
 router.register(r'industries', IndustryViewSet, basename='industry')
 router.register(r'seed-keywords', SeedKeywordViewSet, basename='seed-keyword')
-router.register(r'auth', AuthViewSet, basename='auth')
+# Note: AuthViewSet removed - using direct APIView endpoints instead (login, register, etc.)
 
 
+@extend_schema(
+    tags=['Authentication'],
+    summary='User Registration',
+    description='Register a new user account'
+)
 class RegisterView(APIView):
     """Registration endpoint."""
     permission_classes = [permissions.AllowAny]
@@ -52,6 +58,11 @@ class RegisterView(APIView):
         }, status=status.HTTP_400_BAD_REQUEST)
 
 
+@extend_schema(
+    tags=['Authentication'],
+    summary='User Login',
+    description='Authenticate user and receive JWT tokens'
+)
 class LoginView(APIView):
     """Login endpoint."""
     permission_classes = [permissions.AllowAny]
@@ -123,6 +134,11 @@ class LoginView(APIView):
         }, status=status.HTTP_400_BAD_REQUEST)
 
 
+@extend_schema(
+    tags=['Authentication'],
+    summary='Change Password',
+    description='Change user password'
+)
 class ChangePasswordView(APIView):
     """Change password endpoint."""
     permission_classes = [permissions.IsAuthenticated]
@@ -151,6 +167,11 @@ class ChangePasswordView(APIView):
         }, status=status.HTTP_400_BAD_REQUEST)
 
 
+@extend_schema(
+    tags=['Authentication'],
+    summary='Get Current User',
+    description='Get information about the currently authenticated user'
+)
 class MeView(APIView):
     """Get current user information."""
     permission_classes = [permissions.IsAuthenticated]

backend/igny8_core/auth/views.py

@@ -10,6 +10,7 @@ from django.contrib.auth import authenticate
 from django.utils import timezone
 from django.db import transaction
 from django_filters.rest_framework import DjangoFilterBackend
+from drf_spectacular.utils import extend_schema, extend_schema_view
 from igny8_core.api.base import AccountModelViewSet
 from igny8_core.api.authentication import JWTAuthentication, CSRFExemptSessionAuthentication
 from igny8_core.api.response import success_response, error_response
@@ -33,6 +34,10 @@ import jwt
 # 1. GROUPS - Define user roles and permissions across the system
 # ============================================================================
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+)
 class GroupsViewSet(viewsets.ViewSet):
     """
     ViewSet for managing user roles and permissions (Groups).
@@ -119,6 +124,14 @@ class GroupsViewSet(viewsets.ViewSet):
 # 2. USERS - Manage global user records and credentials
 # ============================================================================
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    create=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+    update=extend_schema(tags=['Authentication']),
+    partial_update=extend_schema(tags=['Authentication']),
+    destroy=extend_schema(tags=['Authentication']),
+)
 class UsersViewSet(AccountModelViewSet):
     """
     ViewSet for managing global user records and credentials.
@@ -246,6 +259,14 @@ class UsersViewSet(AccountModelViewSet):
 # 3. ACCOUNTS - Register each unique organization/user space
 # ============================================================================
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    create=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+    update=extend_schema(tags=['Authentication']),
+    partial_update=extend_schema(tags=['Authentication']),
+    destroy=extend_schema(tags=['Authentication']),
+)
 class AccountsViewSet(AccountModelViewSet):
     """
     ViewSet for managing accounts (unique organization/user spaces).
@@ -303,6 +324,14 @@ class AccountsViewSet(AccountModelViewSet):
 # 4. SUBSCRIPTIONS - Control plan level, limits, and billing per account
 # ============================================================================
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    create=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+    update=extend_schema(tags=['Authentication']),
+    partial_update=extend_schema(tags=['Authentication']),
+    destroy=extend_schema(tags=['Authentication']),
+)
 class SubscriptionsViewSet(AccountModelViewSet):
     """
     ViewSet for managing subscriptions (plan level, limits, billing per account).
@@ -356,6 +385,14 @@ class SubscriptionsViewSet(AccountModelViewSet):
 # 5. SITE USER ACCESS - Assign users access to specific sites within account
 # ============================================================================
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    create=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+    update=extend_schema(tags=['Authentication']),
+    partial_update=extend_schema(tags=['Authentication']),
+    destroy=extend_schema(tags=['Authentication']),
+)
 class SiteUserAccessViewSet(AccountModelViewSet):
     """
     ViewSet for managing Site-User access permissions.
@@ -394,6 +431,10 @@ class SiteUserAccessViewSet(AccountModelViewSet):
 # SUPPORTING VIEWSETS (Sites, Sectors, Industries, Plans, Auth)
 # ============================================================================
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+)
 class PlanViewSet(viewsets.ReadOnlyModelViewSet):
     """
     ViewSet for listing active subscription plans.
@@ -420,6 +461,14 @@ class PlanViewSet(viewsets.ReadOnlyModelViewSet):
             )
 
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    create=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+    update=extend_schema(tags=['Authentication']),
+    partial_update=extend_schema(tags=['Authentication']),
+    destroy=extend_schema(tags=['Authentication']),
+)
 class SiteViewSet(AccountModelViewSet):
     """ViewSet for managing Sites."""
     serializer_class = SiteSerializer
@@ -655,6 +704,14 @@ class SiteViewSet(AccountModelViewSet):
         )
 
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    create=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+    update=extend_schema(tags=['Authentication']),
+    partial_update=extend_schema(tags=['Authentication']),
+    destroy=extend_schema(tags=['Authentication']),
+)
 class SectorViewSet(AccountModelViewSet):
     """ViewSet for managing Sectors."""
     serializer_class = SectorSerializer
@@ -692,6 +749,10 @@ class SectorViewSet(AccountModelViewSet):
         )
 
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+)
 class IndustryViewSet(viewsets.ReadOnlyModelViewSet):
     """
     ViewSet for industry templates.
@@ -727,6 +788,10 @@ class IndustryViewSet(viewsets.ReadOnlyModelViewSet):
             )
 
 
+@extend_schema_view(
+    list=extend_schema(tags=['Authentication']),
+    retrieve=extend_schema(tags=['Authentication']),
+)
 class SeedKeywordViewSet(viewsets.ReadOnlyModelViewSet):
     """
     ViewSet for SeedKeyword - Global reference data (read-only for non-admins).
@@ -776,6 +841,12 @@ class SeedKeywordViewSet(viewsets.ReadOnlyModelViewSet):
 # AUTHENTICATION ENDPOINTS (Register, Login, Change Password, Me)
 # ============================================================================
 
+@extend_schema_view(
+    register=extend_schema(tags=['Authentication']),
+    login=extend_schema(tags=['Authentication']),
+    change_password=extend_schema(tags=['Authentication']),
+    refresh_token=extend_schema(tags=['Authentication']),
+)
 class AuthViewSet(viewsets.GenericViewSet):
     """Authentication endpoints.
     Unified API Standard v1.0 compliant