feat(itim): Add Cluster API v2 endpoint

ref: #248 #356

app/itim/viewsets/cluster.py

@@ -0,0 +1,86 @@
+from drf_spectacular.utils import extend_schema, extend_schema_view, OpenApiResponse
+
+from api.viewsets.common import ModelViewSet
+
+from itim.serializers.cluster import (
+    Cluster,
+    ClusterModelSerializer,
+    ClusterViewSerializer
+)
+
+
+
+@extend_schema_view(
+    create=extend_schema(
+        summary = 'Create a cluster',
+        description='',
+        responses = {
+            201: OpenApiResponse(description='Device created', response=ClusterViewSerializer),
+            400: OpenApiResponse(description='Validation failed.'),
+            403: OpenApiResponse(description='User is missing create permissions'),
+        }
+    ),
+    destroy = extend_schema(
+        summary = 'Delete a cluster',
+        description = '',
+        responses = {
+            204: OpenApiResponse(description=''),
+            403: OpenApiResponse(description='User is missing delete permissions'),
+        }
+    ),
+    list = extend_schema(
+        summary = 'Fetch all clusters',
+        description='',
+        responses = {
+            200: OpenApiResponse(description='', response=ClusterViewSerializer),
+            403: OpenApiResponse(description='User is missing view permissions'),
+        }
+    ),
+    retrieve = extend_schema(
+        summary = 'Fetch a single cluster',
+        description='',
+        responses = {
+            200: OpenApiResponse(description='', response=ClusterViewSerializer),
+            403: OpenApiResponse(description='User is missing view permissions'),
+        }
+    ),
+    update = extend_schema(exclude = True),
+    partial_update = extend_schema(
+        summary = 'Update a cluster',
+        description = '',
+        responses = {
+            200: OpenApiResponse(description='', response=ClusterViewSerializer),
+            403: OpenApiResponse(description='User is missing change permissions'),
+        }
+    ),
+)
+class ViewSet( ModelViewSet ):
+
+    filterset_fields = [
+        'parent_cluster',
+        'cluster_type',
+        'nodes',
+        'devices',
+    ]
+
+    search_fields = [
+        'name',
+    ]
+
+    model = Cluster
+
+    documentation: str = 'https://nofusscomputing.com/docs/not_model_docs'
+
+    view_description = 'Physical Devices'
+
+    def get_serializer_class(self):
+
+        if (
+            self.action == 'list'
+            or self.action == 'retrieve'
+        ):
+
+            return globals()[str( self.model._meta.verbose_name) + 'ViewSerializer']
+
+
+        return globals()[str( self.model._meta.verbose_name) + 'ModelSerializer']

app/itim/viewsets/index.py

@@ -26,7 +26,7 @@ class Index(CommonViewSet):
         return Response(
             {
                 "change": "ToDo",
-                "cluster": "ToDo",
+                "cluster": reverse('API:_api_v2_cluster-list', request=request),
                 "incident": "ToDo",
                 "problem": "ToDo",
                 "service": reverse('API:_api_v2_service-list', request=request),