From 54af8fc92e17b094db1bc044ac17bf0b2928cfa1 Mon Sep 17 00:00:00 2001
From: Alex Zamponi <562324+alexz707@users.noreply.github.com>
Date: Thu, 23 May 2024 17:21:44 +0200
Subject: [PATCH] Add tag create, read and update controllers

---
 config/tags.yaml                              |  25 ++++
 src/Exception/InvalidParentIdException.php    |  31 +++++
 .../Request/CreateTagRequestBody.php          |  34 ++++++
 .../Request/UpdateTagRequestBody.php          |  34 ++++++
 src/Tag/Controller/CollectionController.php   |  89 ++++++++++++++
 src/Tag/Controller/CreateController.php       |  77 ++++++++++++
 src/Tag/Controller/GetController.php          |  63 ++++++++++
 src/Tag/Controller/UpdateController.php       |  71 +++++++++++
 src/Tag/Hydrator/TagHydrator.php              |  62 ++++++++++
 src/Tag/Hydrator/TagHydratorInterface.php     |  23 ++++
 src/Tag/Repository/TagRepository.php          | 114 ++++++++++++++++++
 src/Tag/Repository/TagRepositoryInterface.php |  21 ++++
 src/Tag/Request/CreateTagParameters.php       |  49 ++++++++
 src/Tag/Request/TagsParameters.php            |  44 +++++++
 src/Tag/Request/UpdateTagParameters.php       |  49 ++++++++
 src/Tag/Schema/Tag.php                        |  89 ++++++++++++++
 src/Tag/Service/TagService.php                |  56 +++++++++
 src/Tag/Service/TagServiceInterface.php       |  18 +++
 18 files changed, 949 insertions(+)
 create mode 100644 config/tags.yaml
 create mode 100644 src/Exception/InvalidParentIdException.php
 create mode 100644 src/Tag/Attributes/Request/CreateTagRequestBody.php
 create mode 100644 src/Tag/Attributes/Request/UpdateTagRequestBody.php
 create mode 100644 src/Tag/Controller/CollectionController.php
 create mode 100644 src/Tag/Controller/CreateController.php
 create mode 100644 src/Tag/Controller/GetController.php
 create mode 100644 src/Tag/Controller/UpdateController.php
 create mode 100644 src/Tag/Hydrator/TagHydrator.php
 create mode 100644 src/Tag/Hydrator/TagHydratorInterface.php
 create mode 100644 src/Tag/Repository/TagRepository.php
 create mode 100644 src/Tag/Repository/TagRepositoryInterface.php
 create mode 100644 src/Tag/Request/CreateTagParameters.php
 create mode 100644 src/Tag/Request/TagsParameters.php
 create mode 100644 src/Tag/Request/UpdateTagParameters.php
 create mode 100644 src/Tag/Schema/Tag.php
 create mode 100644 src/Tag/Service/TagService.php
 create mode 100644 src/Tag/Service/TagServiceInterface.php

diff --git a/config/tags.yaml b/config/tags.yaml
new file mode 100644
index 000000000..047c57741
--- /dev/null
+++ b/config/tags.yaml
@@ -0,0 +1,25 @@
+services:
+  _defaults:
+    autowire: true
+    autoconfigure: true
+    public: false
+
+  # controllers are imported separately to make sure they're public
+  # and have a tag that allows actions to type-hint services
+  Pimcore\Bundle\StudioBackendBundle\Tag\Controller\:
+    resource: '../src/Tag/Controller'
+    public: true
+    tags: [ 'controller.service_arguments' ]
+
+  Pimcore\Bundle\StudioBackendBundle\Tag\Repository\TagRepositoryInterface:
+    class: Pimcore\Bundle\StudioBackendBundle\Tag\Repository\TagRepository
+
+  Pimcore\Bundle\StudioBackendBundle\Tag\Hydrator\TagHydratorInterface:
+    class: Pimcore\Bundle\StudioBackendBundle\Tag\Hydrator\TagHydrator
+
+  # Services
+  Pimcore\Bundle\StudioBackendBundle\Tag\Service\TagServiceInterface:
+    class: Pimcore\Bundle\StudioBackendBundle\Tag\Service\TagService
+
+
+
diff --git a/src/Exception/InvalidParentIdException.php b/src/Exception/InvalidParentIdException.php
new file mode 100644
index 000000000..e57293437
--- /dev/null
+++ b/src/Exception/InvalidParentIdException.php
@@ -0,0 +1,31 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Exception;
+
+/**
+ * @internal
+ */
+final class InvalidParentIdException extends AbstractApiException
+{
+    public function __construct(int $parentId)
+    {
+        parent::__construct(400, sprintf(
+            'Invalid parent id: %s',
+            $parentId
+        ));
+    }
+}
diff --git a/src/Tag/Attributes/Request/CreateTagRequestBody.php b/src/Tag/Attributes/Request/CreateTagRequestBody.php
new file mode 100644
index 000000000..98b945e71
--- /dev/null
+++ b/src/Tag/Attributes/Request/CreateTagRequestBody.php
@@ -0,0 +1,34 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Attributes\Request;
+
+use Attribute;
+use OpenApi\Attributes\JsonContent;
+use OpenApi\Attributes\RequestBody;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\CreateTagParameters;
+
+#[Attribute(Attribute::TARGET_METHOD)]
+final class CreateTagRequestBody extends RequestBody
+{
+    public function __construct()
+    {
+        parent::__construct(
+            required: true,
+            content: new JsonContent(ref: CreateTagParameters::class)
+        );
+    }
+}
diff --git a/src/Tag/Attributes/Request/UpdateTagRequestBody.php b/src/Tag/Attributes/Request/UpdateTagRequestBody.php
new file mode 100644
index 000000000..a18a573ed
--- /dev/null
+++ b/src/Tag/Attributes/Request/UpdateTagRequestBody.php
@@ -0,0 +1,34 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Attributes\Request;
+
+use Attribute;
+use OpenApi\Attributes\JsonContent;
+use OpenApi\Attributes\RequestBody;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\UpdateTagParameters;
+
+#[Attribute(Attribute::TARGET_METHOD)]
+final class UpdateTagRequestBody extends RequestBody
+{
+    public function __construct()
+    {
+        parent::__construct(
+            required: true,
+            content: new JsonContent(ref: UpdateTagParameters::class)
+        );
+    }
+}
diff --git a/src/Tag/Controller/CollectionController.php b/src/Tag/Controller/CollectionController.php
new file mode 100644
index 000000000..56aa0b924
--- /dev/null
+++ b/src/Tag/Controller/CollectionController.php
@@ -0,0 +1,89 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Controller;
+
+use OpenApi\Attributes\Get;
+use Pimcore\Bundle\StudioBackendBundle\Controller\AbstractApiController;
+use Pimcore\Bundle\StudioBackendBundle\Exception\InvalidQueryTypeException;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Content\ItemsJson;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Parameters\Query\ElementTypeParameter;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Parameters\Query\FilterParameter;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Parameters\Query\PageParameter;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Parameters\Query\PageSizeParameter;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Parameters\Query\ParentIdParameter;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\BadRequestResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\MethodNotAllowedResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnauthorizedResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnprocessableContentResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnsupportedMediaTypeResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\SuccessResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Config\Tags;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\TagsParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Schema\Tag;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Service\TagServiceInterface;
+use Pimcore\Bundle\StudioBackendBundle\Util\Traits\PaginatedResponseTrait;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpKernel\Attribute\MapQueryString;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Serializer\SerializerInterface;
+
+/**
+ * @internal
+ */
+final class CollectionController extends AbstractApiController
+{
+    use PaginatedResponseTrait;
+
+    public function __construct(
+        SerializerInterface $serializer,
+        private readonly TagServiceInterface $tagService,
+    ) {
+        parent::__construct($serializer);
+    }
+
+    /**
+     * @throws InvalidQueryTypeException
+     */
+    #[Route('/tags', name: 'pimcore_studio_api_tags', methods: ['GET'])]
+    //#[IsGranted('STUDIO_API')]
+    #[Get(
+        path: self::API_PATH . '/tags',
+        operationId: 'getTags',
+        summary: 'Get all tags for a parent id. You can filter by type and query',
+        security: self::SECURITY_SCHEME,
+        tags: [Tags::Tags->name]
+    )]
+    #[PageParameter]
+    #[PageSizeParameter]
+    #[ElementTypeParameter(false, null)]
+    #[FilterParameter]
+    #[ParentIdParameter]
+    #[SuccessResponse(
+        description: 'Tags filtered based on type and query parameters',
+        content: new ItemsJson(Tag::class)
+    )]
+    #[BadRequestResponse]
+    #[UnauthorizedResponse]
+    #[MethodNotAllowedResponse]
+    #[UnsupportedMediaTypeResponse]
+    #[UnprocessableContentResponse]
+    public function getTags(
+        #[MapQueryString] TagsParameters $parameters): JsonResponse
+    {
+        return $this->jsonResponse(['items' => $this->tagService->listTags($parameters)]);
+    }
+}
diff --git a/src/Tag/Controller/CreateController.php b/src/Tag/Controller/CreateController.php
new file mode 100644
index 000000000..d129e881d
--- /dev/null
+++ b/src/Tag/Controller/CreateController.php
@@ -0,0 +1,77 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Controller;
+
+use OpenApi\Attributes\JsonContent;
+use OpenApi\Attributes\Post;
+use Pimcore\Bundle\StudioBackendBundle\Controller\AbstractApiController;
+use Pimcore\Bundle\StudioBackendBundle\Exception\NotWriteableException;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\BadRequestResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\MethodNotAllowedResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnauthorizedResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnprocessableContentResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnsupportedMediaTypeResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\SuccessResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Config\Tags;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Attributes\Request\CreateTagRequestBody;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\CreateTagParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Schema\Tag;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Service\TagServiceInterface;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpKernel\Attribute\MapRequestPayload;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Serializer\SerializerInterface;
+
+/**
+ * @internal
+ */
+final class CreateController extends AbstractApiController
+{
+    public function __construct(
+        SerializerInterface $serializer,
+        private readonly TagServiceInterface $tagService,
+    ) {
+        parent::__construct($serializer);
+    }
+
+    /**
+     * @throws NotWriteableException
+     */
+    #[Route('/tag', name: 'pimcore_studio_api_create_tag', methods: ['POST'])]
+    #[POST(
+        path: self::API_PATH . '/tag',
+        operationId: 'createTag',
+        summary: 'Creating a new tag',
+        security: self::SECURITY_SCHEME,
+        tags: [Tags::Tags->name]
+    )]
+    #[CreateTagRequestBody]
+    #[SuccessResponse(
+        description: 'Tag data as json',
+        content: new JsonContent(ref: Tag::class, type: 'object')
+    )]
+    #[BadRequestResponse]
+    #[UnauthorizedResponse]
+    #[MethodNotAllowedResponse]
+    #[UnsupportedMediaTypeResponse]
+    #[UnprocessableContentResponse]
+    public function createTag(#[MapRequestPayload] CreateTagParameters $parameters): JsonResponse
+    {
+
+        return $this->jsonResponse($this->tagService->createTag($parameters));
+    }
+}
diff --git a/src/Tag/Controller/GetController.php b/src/Tag/Controller/GetController.php
new file mode 100644
index 000000000..e968d71d5
--- /dev/null
+++ b/src/Tag/Controller/GetController.php
@@ -0,0 +1,63 @@
+<?php
+declare(strict_types=1);
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Controller;
+
+use OpenApi\Attributes\Get;
+use OpenApi\Attributes\JsonContent;
+use Pimcore\Bundle\StudioBackendBundle\Controller\AbstractApiController;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Parameters\Path\IdParameter;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\MethodNotAllowedResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\NotFoundResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnauthorizedResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnprocessableContentResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\Error\UnsupportedMediaTypeResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\SuccessResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Config\Tags;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Schema\Tag;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Service\TagServiceInterface;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Serializer\SerializerInterface;
+
+/**
+ * @internal
+ */
+final class GetController extends AbstractApiController
+{
+    public function __construct(
+        SerializerInterface $serializer,
+        private readonly TagServiceInterface $tagService,
+    )
+    {
+        parent::__construct($serializer);
+    }
+
+    #[Route('/tags/{id}', name: 'pimcore_studio_api_get_tag', methods: ['GET'])]
+    //#[IsGranted('STUDIO_API')]
+    #[Get(
+        path: self::API_PATH . '/tags/{id}',
+        operationId: 'getTagById',
+        description: 'Get tag based on the tag ID',
+        summary: 'Get tag by ID',
+        security: self::SECURITY_SCHEME,
+        tags: [Tags::Tags->name]
+    )]
+    #[IdParameter(type: 'tag')]
+    #[SuccessResponse(
+        description: 'Tag data as json',
+        content: new JsonContent(ref: Tag::class)
+    )]
+    #[UnauthorizedResponse]
+    #[NotFoundResponse]
+    #[MethodNotAllowedResponse]
+    #[UnsupportedMediaTypeResponse]
+    #[UnprocessableContentResponse]
+    public function getTags(int $id): JsonResponse
+    {
+        return $this->jsonResponse(
+            $this->tagService->getTag($id)
+
+        );
+    }
+}
diff --git a/src/Tag/Controller/UpdateController.php b/src/Tag/Controller/UpdateController.php
new file mode 100644
index 000000000..491965f18
--- /dev/null
+++ b/src/Tag/Controller/UpdateController.php
@@ -0,0 +1,71 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Controller;
+
+use OpenApi\Attributes\JsonContent;
+use OpenApi\Attributes\Put;
+use OpenApi\Attributes\Schema;
+use Pimcore\Bundle\StudioBackendBundle\Controller\AbstractApiController;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Parameters\Path\IdParameter;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\DefaultResponses;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Attributes\Response\SuccessResponse;
+use Pimcore\Bundle\StudioBackendBundle\OpenApi\Config\Tags;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Attributes\Request\UpdateTagRequestBody;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\UpdateTagParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Schema\Tag;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Service\TagServiceInterface;
+use Pimcore\Bundle\StudioBackendBundle\Util\Constants\HttpResponseCodes;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpKernel\Attribute\MapRequestPayload;
+use Symfony\Component\Routing\Attribute\Route;
+use Symfony\Component\Serializer\SerializerInterface;
+
+/**
+ * @internal
+ */
+final class UpdateController extends AbstractApiController
+{
+    public function __construct(
+        SerializerInterface $serializer,
+        private readonly TagServiceInterface $tagService,
+    ) {
+        parent::__construct($serializer);
+    }
+
+    #[Route('/tags/{id}', name: 'pimcore_studio_api_update_tag', methods: ['PUT'])]
+    #[Put(
+        path: self::API_PATH . '/tags/{id}',
+        operationId: 'updateTag',
+        summary: 'Update a tag',
+        security: self::SECURITY_SCHEME,
+        tags: [Tags::Tags->name]
+    )]
+    #[IdParameter(type: 'tag', schema: new Schema(type: 'integer', example: 10))]
+    #[UpdateTagRequestBody]
+    #[SuccessResponse(
+        description: 'Updated tag data as json',
+        content: new JsonContent(ref: Tag::class, type: 'object')
+    )]
+    #[DefaultResponses([
+        HttpResponseCodes::UNAUTHORIZED,
+        HttpResponseCodes::NOT_FOUND,
+    ])]
+    public function updateTag(int $id, #[MapRequestPayload] UpdateTagParameters $parameters): JsonResponse
+    {
+        return $this->jsonResponse($this->tagService->updateTag($id, $parameters));
+    }
+}
diff --git a/src/Tag/Hydrator/TagHydrator.php b/src/Tag/Hydrator/TagHydrator.php
new file mode 100644
index 000000000..44f0cdac2
--- /dev/null
+++ b/src/Tag/Hydrator/TagHydrator.php
@@ -0,0 +1,62 @@
+<?php
+declare(strict_types=1);
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Hydrator;
+
+use Pimcore\Bundle\StudioBackendBundle\Icon\Service\IconServiceInterface;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Schema\Tag;
+use Pimcore\Model\Element\Tag as ElementTag;
+
+/**
+ * @internal
+ */
+final readonly class TagHydrator implements TagHydratorInterface
+{
+    public function __construct(private readonly IconServiceInterface $iconService)
+    {
+    }
+
+    public function hydrate(ElementTag $tag): Tag {
+        return new Tag(
+            id: $tag->getId(),
+            parentId: $tag->getParentId(),
+            text: $tag->getName(),
+            path: $tag->getNamePath(),
+            hasChildren: $tag->hasChildren(),
+            iconName: $this->iconService->getIconForTag()
+        );
+    }
+
+    public function hydrateRecursive(ElementTag $tag): Tag {
+        $children = [];
+        foreach ($tag->getChildren() as $child) {
+            $children[] = $this->hydrateRecursive($child);
+        }
+
+        $result = $this->hydrate($tag);
+        $result->setChildren($children);
+        return $result;
+    }
+
+    /**
+     * @param array<int, ElementTag> $tags
+     * @return array<int, Tag>
+     */
+    public function hydrateNestedList(array $tags): array {
+        $tagMap = [];
+        $nestedTags = [];
+
+        foreach ($tags as $tag) {
+            $tagMap[$tag->getId()] = $this->hydrate($tag);
+        }
+
+        foreach ($tagMap as $tag) {
+            if ($tag->getParentId() === 0 || !array_key_exists($tag->getParentId(), $tagMap)) {
+                $nestedTags[] = $tag;
+                continue;
+            }
+            $tagMap[$tag->getParentId()]->addChild($tag);
+        }
+        return $nestedTags;
+    }
+}
\ No newline at end of file
diff --git a/src/Tag/Hydrator/TagHydratorInterface.php b/src/Tag/Hydrator/TagHydratorInterface.php
new file mode 100644
index 000000000..684f8e48c
--- /dev/null
+++ b/src/Tag/Hydrator/TagHydratorInterface.php
@@ -0,0 +1,23 @@
+<?php
+declare(strict_types=1);
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Hydrator;
+
+use Pimcore\Bundle\StudioBackendBundle\Tag\Schema\Tag;
+use Pimcore\Model\Element\Tag as ElementTag;
+
+/**
+ * @internal
+ */
+interface TagHydratorInterface
+{
+    public function hydrate(ElementTag $tag): Tag;
+
+    public function hydrateRecursive(ElementTag $tag): Tag;
+
+    /**
+     * @param array<int, ElementTag> $tags
+     * @return array<int, Tag>
+     */
+    public function hydrateNestedList(array $tags): array;
+}
\ No newline at end of file
diff --git a/src/Tag/Repository/TagRepository.php b/src/Tag/Repository/TagRepository.php
new file mode 100644
index 000000000..1788761da
--- /dev/null
+++ b/src/Tag/Repository/TagRepository.php
@@ -0,0 +1,114 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Repository;
+
+use Pimcore\Bundle\StaticResolverBundle\Models\Tag\TagResolver;
+use Pimcore\Bundle\StudioBackendBundle\Exception\ElementNotFoundException;
+use Pimcore\Bundle\StudioBackendBundle\Security\Service\SecurityServiceInterface;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\CreateTagParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\TagsParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\UpdateTagParameters;
+use Pimcore\Bundle\StudioBackendBundle\Util\Traits\ElementProviderTrait;
+use Pimcore\Model\Element\Tag;
+use Pimcore\Model\Element\Tag\Listing as TagListing;
+
+/**
+ * @internal
+ */
+final readonly class TagRepository implements TagRepositoryInterface
+{
+    use ElementProviderTrait;
+
+    public function __construct(
+        private SecurityServiceInterface $securityService,
+        private TagResolver $tagResolver
+    ) {
+    }
+
+    public function getTagById(int $id): Tag {
+        $tag = $this->tagResolver->getById($id);
+        if (!$tag) {
+            throw new ElementNotFoundException($id);
+        }
+        return $tag;
+    }
+
+    public function listTags(TagsParameters $parameters): TagListing
+    {
+        $tagList = new TagListing();
+        $tagList->setOrderKey('name');
+
+        if ($parameters->getParentId() !== null) {
+            $tagList->setCondition('parentId = ?', $parameters->getParentId());
+        }
+
+        if ($parameters->getFilter() === null) {
+            return $tagList;
+        }
+
+        $filterTagList = new TagListing();
+        $filterTagList->setCondition(
+            'LOWER(`name`) LIKE ?',
+            ['%' . $filterTagList->escapeLike(mb_strtolower($parameters->getFilter())) . '%']
+        );
+
+        $filterIds = [0];
+        foreach ($filterTagList->load() as $filterTag) {
+            $filterIds[] = $filterTag->getId();
+            if ($filterTag->getParentId() === 0) {
+                continue;
+            }
+
+            $ids = explode('/', $filterTag->getIdPath());
+            foreach ($ids as $id) {
+                if ($id !== '') {
+                    $filterIds[] = (int)$id;
+                }
+            }
+        }
+
+        $filterIds = array_unique(array_values($filterIds));
+        $tagList->setConditionVariablesFromSetCondition([]);
+        $tagList->setCondition('id IN('.implode(',', $filterIds).')');
+
+        return $tagList;
+    }
+
+    public function addTag(CreateTagParameters $params): Tag
+    {
+        $new = new Tag();
+        $new->setParentId($params->getParentId());
+        $new->setName($params->getName());
+        $new->save();
+        return $new;
+    }
+
+    public function updateTag(int $id, UpdateTagParameters $params): Tag
+    {
+        $tag = $this->getTagById($id);
+
+        if ($params->getParentId() !== null) {
+            $tag->setParentId($params->getParentId());
+        }
+
+        if ($params->getName() !== null) {
+            $tag->setName($params->getName());
+        }
+        $tag->save();
+        return $tag;
+    }
+}
diff --git a/src/Tag/Repository/TagRepositoryInterface.php b/src/Tag/Repository/TagRepositoryInterface.php
new file mode 100644
index 000000000..9744fe955
--- /dev/null
+++ b/src/Tag/Repository/TagRepositoryInterface.php
@@ -0,0 +1,21 @@
+<?php
+declare(strict_types=1);
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Repository;
+
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\CreateTagParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\TagsParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\UpdateTagParameters;
+use Pimcore\Model\Element\Tag;
+use Pimcore\Model\Element\Tag\Listing as TagListing;
+
+/**
+ * @internal
+ */
+interface TagRepositoryInterface
+{
+    public function getTagById(int $id): Tag;
+    public function listTags(TagsParameters $parameters): TagListing;
+    public function addTag(CreateTagParameters $params): Tag;
+    public function updateTag(int $id, UpdateTagParameters $params): Tag;
+}
\ No newline at end of file
diff --git a/src/Tag/Request/CreateTagParameters.php b/src/Tag/Request/CreateTagParameters.php
new file mode 100644
index 000000000..5a80d86b6
--- /dev/null
+++ b/src/Tag/Request/CreateTagParameters.php
@@ -0,0 +1,49 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Request;
+
+use OpenApi\Attributes\Property;
+use OpenApi\Attributes\Schema;
+
+/**
+ * @internal
+ */
+#[Schema(
+    title: 'Create Tag Parameters',
+    description: 'Parameters for creating a new tag',
+    type: 'object'
+)]
+final readonly class CreateTagParameters
+{
+    public function __construct(
+        #[Property(description: 'Parent id', type: 'int', example: 0)]
+        private int $parentId,
+        #[Property(description: 'Tag name', type: 'string', example: 'tag 1')]
+        private string $name,
+    ) {
+    }
+
+    public function getParentId(): int
+    {
+        return $this->parentId;
+    }
+
+    public function getName(): string
+    {
+        return $this->name;
+    }
+}
diff --git a/src/Tag/Request/TagsParameters.php b/src/Tag/Request/TagsParameters.php
new file mode 100644
index 000000000..97822391d
--- /dev/null
+++ b/src/Tag/Request/TagsParameters.php
@@ -0,0 +1,44 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Request;
+
+use Pimcore\Bundle\StudioBackendBundle\Request\CollectionParameters;
+
+/**
+ * @internal
+ */
+final readonly class TagsParameters extends CollectionParameters
+{
+    public function __construct(
+        int $page,
+        int $pageSize,
+        private ?int $parentId,
+        private ?string $filter,
+    ) {
+        parent::__construct($page, $pageSize);
+    }
+
+    public function getParentId(): ?int
+    {
+        return $this->parentId;
+    }
+
+    public function getFilter(): ?string
+    {
+        return $this->filter;
+    }
+}
diff --git a/src/Tag/Request/UpdateTagParameters.php b/src/Tag/Request/UpdateTagParameters.php
new file mode 100644
index 000000000..ea223be8a
--- /dev/null
+++ b/src/Tag/Request/UpdateTagParameters.php
@@ -0,0 +1,49 @@
+<?php
+declare(strict_types=1);
+
+/**
+ * Pimcore
+ *
+ * This source file is available under two different licenses:
+ * - GNU General Public License version 3 (GPLv3)
+ * - Pimcore Commercial License (PCL)
+ * Full copyright and license information is available in
+ * LICENSE.md which is distributed with this source code.
+ *
+ *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
+ *  @license    http://www.pimcore.org/license     GPLv3 and PCL
+ */
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Request;
+
+use OpenApi\Attributes\Property;
+use OpenApi\Attributes\Schema;
+
+/**
+ * @internal
+ */
+#[Schema(
+    title: 'Change Tag Parameters',
+    description: 'Parameters for changing a tag',
+    type: 'object'
+)]
+final readonly class UpdateTagParameters
+{
+    public function __construct(
+        #[Property(description: 'Parent id', type: 'int', example: 0)]
+        private ?int $parentId,
+        #[Property(description: 'Tag name', type: 'string', example: 'tag 1')]
+        private ?string $name,
+    ) {
+    }
+
+    public function getParentId(): ?int
+    {
+        return $this->parentId;
+    }
+
+    public function getName(): ?string
+    {
+        return $this->name;
+    }
+}
diff --git a/src/Tag/Schema/Tag.php b/src/Tag/Schema/Tag.php
new file mode 100644
index 000000000..072b4d5e9
--- /dev/null
+++ b/src/Tag/Schema/Tag.php
@@ -0,0 +1,89 @@
+<?php
+declare(strict_types=1);
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Schema;
+
+use OpenApi\Attributes\Items;
+use OpenApi\Attributes\Property;
+use OpenApi\Attributes\Schema;
+use Pimcore\Bundle\StudioBackendBundle\Util\Schema\AdditionalAttributesInterface;
+use Pimcore\Bundle\StudioBackendBundle\Util\Traits\AdditionalAttributesTrait;
+
+/**
+ * @internal
+ */
+#[Schema(
+    title: 'Tag',
+    type: 'object'
+)]
+final class Tag implements AdditionalAttributesInterface
+{
+    use AdditionalAttributesTrait;
+
+    public function __construct(
+        #[Property(description: 'tag ID', type: 'integer', example: 2)]
+        private readonly int $id,
+        #[Property(description: 'parent tag ID', type: 'integer', example: 0)]
+        private readonly int $parentId,
+        #[Property(description: 'tag text', type: 'string', example: 'Tag 1')]
+        private readonly string $text,
+        #[Property(description: 'path', type: 'string', example: '/test')]
+        private readonly string $path,
+        #[Property(description: 'has children', type: 'bool', example: false)]
+        private readonly bool $hasChildren,
+        #[Property(description: 'IconName', type: 'string', example: 'pimcore_icon_pdf')]
+        private readonly string $iconName,
+        #[Property(description: 'children', type: 'array', items: new Items(type: Tag::class, example: new Tag(id: 3, parentId: 0, text: 'Tag 2', path: '/test/2', hasChildren: false, iconName: 'pimcore_icon_pdf')))]
+        private array $children = [],
+    ) {
+
+    }
+
+    public function getId(): int
+    {
+        return $this->id;
+    }
+
+    public function getParentId(): int
+    {
+        return $this->parentId;
+    }
+
+    public function isHasChildren(): bool
+    {
+        return $this->hasChildren;
+    }
+
+    public function getPath(): string
+    {
+        return $this->path;
+    }
+
+    public function getText(): string
+    {
+        return $this->text;
+    }
+
+    public function getChildren(): array
+    {
+        return $this->children;
+    }
+
+    /**
+     * @param array<int, Tag> $children
+     */
+    public function setChildren(array $children): void
+    {
+        $this->children = $children;
+    }
+
+    public function addChild(Tag $child): void
+    {
+        $this->children[] = $child;
+    }
+
+    public function getIconName(): string
+    {
+        return $this->iconName;
+    }
+}
diff --git a/src/Tag/Service/TagService.php b/src/Tag/Service/TagService.php
new file mode 100644
index 000000000..b9c6c6672
--- /dev/null
+++ b/src/Tag/Service/TagService.php
@@ -0,0 +1,56 @@
+<?php
+declare(strict_types=1);
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Service;
+
+use Pimcore\Bundle\StudioBackendBundle\Exception\ElementNotFoundException;
+use Pimcore\Bundle\StudioBackendBundle\Exception\InvalidParentIdException;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Hydrator\TagHydratorInterface;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Repository\TagRepositoryInterface;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\CreateTagParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\TagsParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\UpdateTagParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Schema\Tag;
+
+/**
+ * @internal
+ */
+final readonly class TagService implements TagServiceInterface
+{
+    public function __construct(
+        private TagRepositoryInterface $tagRepository,
+        private TagHydratorInterface $tagHydrator
+    ) {
+    }
+
+    public function getTag(int $id): Tag
+    {
+        return $this->tagHydrator->hydrateRecursive($this->tagRepository->getTagById($id));
+    }
+
+    public function listTags(TagsParameters $parameters): array
+    {
+        $tags = $this->tagRepository->listTags($parameters);
+        return $this->tagHydrator->hydrateNestedList($tags->load());
+    }
+
+    public function createTag(CreateTagParameters $tag): Tag
+    {
+        if ($tag->getParentId() !== 0) {
+            try {
+                $this->tagRepository->getTagById($tag->getParentId());
+            } catch (ElementNotFoundException) {
+                throw new InvalidParentIdException($tag->getParentId());
+            }
+        }
+
+        return $this->tagHydrator->hydrate($this->tagRepository->addTag($tag));
+    }
+
+    public function updateTag(int $id, UpdateTagParameters $parameters): Tag
+    {
+        $tag = $this->tagRepository->getTagById($id);
+
+        return $this->tagHydrator->hydrate($this->tagRepository->updateTag($id, $parameters));
+    }
+}
\ No newline at end of file
diff --git a/src/Tag/Service/TagServiceInterface.php b/src/Tag/Service/TagServiceInterface.php
new file mode 100644
index 000000000..740545437
--- /dev/null
+++ b/src/Tag/Service/TagServiceInterface.php
@@ -0,0 +1,18 @@
+<?php
+declare(strict_types=1);
+
+namespace Pimcore\Bundle\StudioBackendBundle\Tag\Service;
+
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\CreateTagParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Request\TagsParameters;
+use Pimcore\Bundle\StudioBackendBundle\Tag\Schema\Tag;
+
+/**
+ * @internal
+ */
+interface TagServiceInterface
+{
+    public function getTag(int $id): Tag;
+    public function listTags(TagsParameters $parameters): array;
+    public function createTag(CreateTagParameters $tag): Tag;
+}
\ No newline at end of file