feat(itim): Add Cluster API v2 endpoint

ref: #248 #356

app/itim/models/clusters.py

@@ -208,7 +208,7 @@ class Cluster(TenancyObject):
                         'organization',
                         'parent_cluster',
                         'cluster_type',
-                        'name'
+                        'name',
                         'is_global',
                     ],
                     "right": [

app/itim/serializers/cluster.py

@@ -0,0 +1,111 @@
+from rest_framework.reverse import reverse
+from rest_framework import serializers
+
+from access.serializers.organization import OrganizationBaseSerializer
+
+from itam.serializers.device import DeviceBaseSerializer
+
+from itim.serializers.cluster_type import ClusterTypeBaseSerializer
+from itim.models.clusters import Cluster
+
+
+
+class ClusterBaseSerializer(serializers.ModelSerializer):
+
+    display_name = serializers.SerializerMethodField('get_display_name')
+
+    def get_display_name(self, item):
+
+        return str( item )
+
+    url = serializers.HyperlinkedIdentityField(
+        view_name="API:_api_v2_cluster-detail", format="html"
+    )
+
+    class Meta:
+
+        model = Cluster
+
+        fields = [
+            'id',
+            'display_name',
+            'name',
+            'url',
+        ]
+
+        read_only_fields = [
+            'id',
+            'display_name',
+            'name',
+            'url',
+        ]
+
+
+class ClusterModelSerializer(ClusterBaseSerializer):
+
+    _urls = serializers.SerializerMethodField('get_url')
+
+    def get_url(self, item):
+
+        return {
+            '_self': reverse("API:_api_v2_cluster-detail", request=self._context['view'].request, kwargs={'pk': item.pk}),
+            'history': reverse(
+                "API:_api_v2_model_history-list",
+                request=self._context['view'].request,
+                kwargs={
+                    'model_class': self.Meta.model._meta.model_name,
+                    'model_id': item.pk
+                }
+            ),
+            'notes': reverse("API:_api_v2_cluster_notes-list", request=self._context['view'].request, kwargs={'cluster_id': item.pk}),
+            'tickets': 'ToDo'
+        }
+
+
+    rendered_config = serializers.JSONField()
+
+
+    class Meta:
+
+        model = Cluster
+
+        fields =  [
+             'id',
+            'organization',
+            'display_name',
+            'name',
+            'model_notes',
+            'parent_cluster',
+            'cluster_type',
+            'config',
+            'rendered_config',
+            'nodes',
+            'devices',
+            'is_global',
+            'created',
+            'modified',
+            '_urls',
+        ]
+
+        read_only_fields = [
+            'id',
+            'display_name',
+            'rendered_config',
+            'created',
+            'modified',
+            '_urls',
+        ]
+
+
+
+class ClusterViewSerializer(ClusterModelSerializer):
+
+    cluster_type = ClusterTypeBaseSerializer( many = False, read_only = True )
+
+    devices = DeviceBaseSerializer( many = True, read_only = True )
+
+    nodes = DeviceBaseSerializer( many = True, read_only = True )
+
+    organization = OrganizationBaseSerializer( many = False, read_only = True )
+
+    parent_cluster = ClusterBaseSerializer( many = False, read_only = True )

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),