MaxKB/apps/knowledge/serializers/knowledge_version.py

# coding=utf-8
"""
    @project: MaxKB
    @Author：虎虎
    @file： KnowledgeVersionSerializer.py
    @date：2025/11/28 18:00
    @desc:
"""
from typing import Dict

from django.db.models import QuerySet
from rest_framework import serializers

from django.utils.translation import gettext_lazy as _

from common.db.search import page_search
from common.exception.app_exception import AppApiException
from knowledge.models import KnowledgeWorkflowVersion, Knowledge


class KnowledgeWorkflowVersionEditSerializer(serializers.Serializer):
    name = serializers.CharField(required=False, max_length=128, allow_null=True, allow_blank=True,
                                 label=_("Version Name"))


class KnowledgeVersionModelSerializer(serializers.ModelSerializer):
    class Meta:
        model = KnowledgeWorkflowVersion
        fields = ['id', 'name', 'workspace_id', 'knowledge_id', 'work_flow', 'publish_user_id', 'publish_user_name',
                  'create_time',
                  'update_time']


class KnowledgeWorkflowVersionQuerySerializer(serializers.Serializer):
    knowledge_id = serializers.UUIDField(required=True, label=_("Knowledge ID"))
    name = serializers.CharField(required=False, allow_null=True, allow_blank=True,
                                 label=_("summary"))


class KnowledgeWorkflowVersionSerializer(serializers.Serializer):
    workspace_id = serializers.CharField(required=False, label=_("Workspace ID"))

    class Query(serializers.Serializer):
        workspace_id = serializers.CharField(required=False, allow_null=True, allow_blank=True, label=_("Workspace ID"))

        def get_query_set(self, query):
            query_set = QuerySet(KnowledgeWorkflowVersion).filter(knowledge_id=query.get('knowledge_id'))
            if 'name' in query and query.get('name') is not None:
                query_set = query_set.filter(name__contains=query.get('name'))
            if 'workspace_id' in self.data and self.data.get('workspace_id') is not None:
                query_set = query_set.filter(workspace_id=self.data.get('workspace_id'))
            return query_set.order_by("-create_time")

        def list(self, query, with_valid=True):
            if with_valid:
                self.is_valid(raise_exception=True)
                KnowledgeWorkflowVersionQuerySerializer(data=query).is_valid(raise_exception=True)
            query_set = self.get_query_set(query)
            return [KnowledgeVersionModelSerializer(v).data for v in query_set]

        def page(self, query, current_page, page_size, with_valid=True):
            if with_valid:
                self.is_valid(raise_exception=True)
            return page_search(current_page, page_size,
                               self.get_query_set(query),
                               post_records_handler=lambda v: KnowledgeVersionModelSerializer(v).data)

    class Operate(serializers.Serializer):
        workspace_id = serializers.CharField(required=False, allow_null=True, allow_blank=True, label=_("Workspace ID"))
        knowledge_id = serializers.UUIDField(required=True, label=_("Knowledge ID"))
        knowledge_version_id = serializers.UUIDField(required=True,
                                                     label=_("Knowledge version ID"))

        def is_valid(self, *, raise_exception=False):
            super().is_valid(raise_exception=True)
            workspace_id = self.data.get('workspace_id')
            query_set = QuerySet(Knowledge).filter(id=self.data.get('knowledge_id'))
            if workspace_id:
                query_set = query_set.filter(workspace_id=workspace_id)
            if not query_set.exists():
                raise AppApiException(500, _('Knowledge id does not exist'))

        def one(self, with_valid=True):
            if with_valid:
                self.is_valid(raise_exception=True)
            knowledge_version = QuerySet(KnowledgeWorkflowVersion).filter(knowledge_id=self.data.get('knowledge_id'),
                                                                          id=self.data.get(
                                                                              'knowledge_version_id')).first()
            if knowledge_version is not None:
                return KnowledgeVersionModelSerializer(knowledge_version).data
            else:
                raise AppApiException(500, _('Workflow version does not exist'))

        def edit(self, instance: Dict, with_valid=True):
            if with_valid:
                self.is_valid(raise_exception=True)
                KnowledgeWorkflowVersionEditSerializer(data=instance).is_valid(raise_exception=True)
            knowledge_version = QuerySet(KnowledgeWorkflowVersion).filter(knowledge_id=self.data.get('knowledge_id'),
                                                                          id=self.data.get(
                                                                              'knowledge_version_id')).first()
            if knowledge_version is not None:
                name = instance.get('name', None)
                if name is not None and len(name) > 0:
                    knowledge_version.name = name
                knowledge_version.save()
                return KnowledgeVersionModelSerializer(knowledge_version).data
            else:
                raise AppApiException(500, _('Workflow version does not exist'))