Added custom part status (#1053)

* Benutzerdefinierten Bauteilstatus einführen

* PartCustomStateController hinzufügen

* Umstellung Migrationen bzgl. Multi-Plattform-Support.
Zunächst MySQL, SQLite Statements integrieren.

* Postgre Statements integrieren

* Semikolon in Migration entfernen

* Migration für PartCustomState aktualisieren

* Benutzerdefinierten Bauteilstatus in TableSettings aufnehmen

* PartCustomStateControllerTest: Attribute für PHPUnit-Gruppen umgestellt

* PartCustomState: Mapping für Parameter korrigieren

* PartCustomState: Darstellung und Zuordnung von Anhängen ergänzt

Die Sidebar wurde um die Anzeige des benutzerdefinierten Bauteilstatus erweitert, inklusive Vorschaubild, sofern vorhanden.

* Migrationen zusammenführen

* PartCustomState: Anpassungen bzgl. Tests

* PartCustomStateEndpoint hinzufügen

* Made custom part states plural for consistency with other entity captions

* Fixed phpunit error

* Fixed phpstan issues

---------

Co-authored-by: Marcel Diegelmann <marcel.diegelmann@gmail.com>
Co-authored-by: Jan Böhmer <mail@jan-boehmer.de>

src/Command/Migrations/ImportPartKeeprCommand.php

@@ -121,6 +121,11 @@ class ImportPartKeeprCommand extends Command
         $count = $this->datastructureImporter->importPartUnits($data);
         $io->success('Imported '.$count.' measurement units.');
 
+        //Import the custom states
+        $io->info('Importing custom states...');
+        $count = $this->datastructureImporter->importPartCustomStates($data);
+        $io->success('Imported '.$count.' custom states.');
+
         //Import manufacturers
         $io->info('Importing manufacturers...');
         $count = $this->datastructureImporter->importManufacturers($data);

src/Controller/AdminPages/BaseAdminController.php

@@ -232,6 +232,7 @@ abstract class BaseAdminController extends AbstractController
             'timeTravel' => $timeTravel_timestamp,
             'repo' => $repo,
             'partsContainingElement' => $repo instanceof PartsContainingRepositoryInterface,
+            'showParameters' => !($this instanceof PartCustomStateController),
         ]);
     }
 
@@ -382,6 +383,7 @@ abstract class BaseAdminController extends AbstractController
             'import_form' => $import_form,
             'mass_creation_form' => $mass_creation_form,
             'route_base' => $this->route_base,
+            'showParameters' => !($this instanceof PartCustomStateController),
         ]);
     }
 

src/Controller/AdminPages/PartCustomStateController.php

@@ -0,0 +1,83 @@
+<?php
+/**
+ * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony).
+ *
+ * Copyright (C) 2019 - 2022 Jan Böhmer (https://github.com/jbtronics)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace App\Controller\AdminPages;
+
+use App\Entity\Attachments\PartCustomStateAttachment;
+use App\Entity\Parameters\PartCustomStateParameter;
+use App\Entity\Parts\PartCustomState;
+use App\Form\AdminPages\PartCustomStateAdminForm;
+use App\Services\ImportExportSystem\EntityExporter;
+use App\Services\ImportExportSystem\EntityImporter;
+use App\Services\Trees\StructuralElementRecursionHelper;
+use Doctrine\ORM\EntityManagerInterface;
+use Symfony\Component\HttpFoundation\RedirectResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+
+/**
+ * @see \App\Tests\Controller\AdminPages\PartCustomStateControllerTest
+ */
+#[Route(path: '/part_custom_state')]
+class PartCustomStateController extends BaseAdminController
+{
+    protected string $entity_class = PartCustomState::class;
+    protected string $twig_template = 'admin/part_custom_state_admin.html.twig';
+    protected string $form_class = PartCustomStateAdminForm::class;
+    protected string $route_base = 'part_custom_state';
+    protected string $attachment_class = PartCustomStateAttachment::class;
+    protected ?string $parameter_class = PartCustomStateParameter::class;
+
+    #[Route(path: '/{id}', name: 'part_custom_state_delete', methods: ['DELETE'])]
+    public function delete(Request $request, PartCustomState $entity, StructuralElementRecursionHelper $recursionHelper): RedirectResponse
+    {
+        return $this->_delete($request, $entity, $recursionHelper);
+    }
+
+    #[Route(path: '/{id}/edit/{timestamp}', name: 'part_custom_state_edit', requirements: ['id' => '\d+'])]
+    #[Route(path: '/{id}', requirements: ['id' => '\d+'])]
+    public function edit(PartCustomState $entity, Request $request, EntityManagerInterface $em, ?string $timestamp = null): Response
+    {
+        return $this->_edit($entity, $request, $em, $timestamp);
+    }
+
+    #[Route(path: '/new', name: 'part_custom_state_new')]
+    #[Route(path: '/{id}/clone', name: 'part_custom_state_clone')]
+    #[Route(path: '/')]
+    public function new(Request $request, EntityManagerInterface $em, EntityImporter $importer, ?PartCustomState $entity = null): Response
+    {
+        return $this->_new($request, $em, $importer, $entity);
+    }
+
+    #[Route(path: '/export', name: 'part_custom_state_export_all')]
+    public function exportAll(EntityManagerInterface $em, EntityExporter $exporter, Request $request): Response
+    {
+        return $this->_exportAll($em, $exporter, $request);
+    }
+
+    #[Route(path: '/{id}/export', name: 'part_custom_state_export')]
+    public function exportEntity(PartCustomState $entity, EntityExporter $exporter, Request $request): Response
+    {
+        return $this->_exportEntity($entity, $exporter, $request);
+    }
+}

src/DataFixtures/DataStructureFixtures.php

@@ -24,6 +24,7 @@ namespace App\DataFixtures;
 
 use App\Entity\Attachments\AttachmentType;
 use App\Entity\Base\AbstractStructuralDBElement;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\ProjectSystem\Project;
 use App\Entity\Parts\Category;
 use App\Entity\Parts\Footprint;
@@ -50,7 +51,7 @@ class DataStructureFixtures extends Fixture implements DependentFixtureInterface
     {
         //Reset autoincrement
         $types = [AttachmentType::class, Project::class, Category::class, Footprint::class, Manufacturer::class,
-            MeasurementUnit::class, StorageLocation::class, Supplier::class,];
+            MeasurementUnit::class, StorageLocation::class, Supplier::class, PartCustomState::class];
 
         foreach ($types as $type) {
             $this->createNodesForClass($type, $manager);

src/DataTables/Filters/PartFilter.php

@@ -41,6 +41,7 @@ use App\Entity\Parts\Category;
 use App\Entity\Parts\Footprint;
 use App\Entity\Parts\Manufacturer;
 use App\Entity\Parts\MeasurementUnit;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\Parts\PartLot;
 use App\Entity\Parts\StorageLocation;
 use App\Entity\Parts\Supplier;
@@ -86,6 +87,7 @@ class PartFilter implements FilterInterface
     public readonly EntityConstraint $lotOwner;
 
     public readonly EntityConstraint $measurementUnit;
+    public readonly EntityConstraint $partCustomState;
     public readonly TextConstraint $manufacturer_product_url;
     public readonly TextConstraint $manufacturer_product_number;
     public readonly IntConstraint $attachmentsCount;
@@ -128,6 +130,7 @@ class PartFilter implements FilterInterface
         $this->favorite = new BooleanConstraint('part.favorite');
         $this->needsReview = new BooleanConstraint('part.needs_review');
         $this->measurementUnit = new EntityConstraint($nodesListBuilder, MeasurementUnit::class, 'part.partUnit');
+        $this->partCustomState = new EntityConstraint($nodesListBuilder, PartCustomState::class, 'part.partCustomState');
         $this->mass = new NumberConstraint('part.mass');
         $this->dbId = new IntConstraint('part.id');
         $this->ipn = new TextConstraint('part.ipn');

src/DataTables/PartsDataTable.php

@@ -174,6 +174,19 @@ final class PartsDataTable implements DataTableTypeInterface
                     return $tmp;
                 }
             ])
+            ->add('partCustomState', TextColumn::class, [
+                'label' => $this->translator->trans('part.table.partCustomState'),
+                'orderField' => 'NATSORT(_partCustomState.name)',
+                'render' => function($value, Part $context): string {
+                    $partCustomState = $context->getPartCustomState();
+
+                    if ($partCustomState === null) {
+                        return '';
+                    }
+
+                    return htmlspecialchars($partCustomState->getName());
+                }
+            ])
             ->add('addedDate', LocaleDateTimeColumn::class, [
                 'label' => $this->translator->trans('part.table.addedDate'),
             ])
@@ -309,6 +322,7 @@ final class PartsDataTable implements DataTableTypeInterface
             ->addSelect('footprint')
             ->addSelect('manufacturer')
             ->addSelect('partUnit')
+            ->addSelect('partCustomState')
             ->addSelect('master_picture_attachment')
             ->addSelect('footprint_attachment')
             ->addSelect('partLots')
@@ -327,6 +341,7 @@ final class PartsDataTable implements DataTableTypeInterface
             ->leftJoin('orderdetails.supplier', 'suppliers')
             ->leftJoin('part.attachments', 'attachments')
             ->leftJoin('part.partUnit', 'partUnit')
+            ->leftJoin('part.partCustomState', 'partCustomState')
             ->leftJoin('part.parameters', 'parameters')
             ->where('part.id IN (:ids)')
             ->setParameter('ids', $ids)
@@ -344,6 +359,7 @@ final class PartsDataTable implements DataTableTypeInterface
             ->addGroupBy('suppliers')
             ->addGroupBy('attachments')
             ->addGroupBy('partUnit')
+            ->addGroupBy('partCustomState')
             ->addGroupBy('parameters');
 
         //Get the results in the same order as the IDs were passed
@@ -415,6 +431,10 @@ final class PartsDataTable implements DataTableTypeInterface
             $builder->leftJoin('part.partUnit', '_partUnit');
             $builder->addGroupBy('_partUnit');
         }
+        if (str_contains($dql, '_partCustomState')) {
+            $builder->leftJoin('part.partCustomState', '_partCustomState');
+            $builder->addGroupBy('_partCustomState');
+        }
         if (str_contains($dql, '_parameters')) {
             $builder->leftJoin('part.parameters', '_parameters');
             //Do not group by many-to-* relations, as it would restrict the COUNT having clauses to be maximum 1

src/Entity/Attachments/Attachment.php

@@ -97,7 +97,7 @@ use function in_array;
 #[DiscriminatorMap(typeProperty: '_type', mapping: self::API_DISCRIMINATOR_MAP)]
 abstract class Attachment extends AbstractNamedDBElement
 {
-    private const ORM_DISCRIMINATOR_MAP = ['Part' => PartAttachment::class, 'Device' => ProjectAttachment::class,
+    private const ORM_DISCRIMINATOR_MAP = ['Part' => PartAttachment::class, 'PartCustomState' => PartCustomStateAttachment::class, 'Device' => ProjectAttachment::class,
         'AttachmentType' => AttachmentTypeAttachment::class,
         'Category' => CategoryAttachment::class, 'Footprint' => FootprintAttachment::class, 'Manufacturer' => ManufacturerAttachment::class,
         'Currency' => CurrencyAttachment::class, 'Group' => GroupAttachment::class, 'MeasurementUnit' => MeasurementUnitAttachment::class,
@@ -107,7 +107,8 @@ abstract class Attachment extends AbstractNamedDBElement
     /*
      * The discriminator map used for API platform. The key should be the same as the api platform short type (the @type JSONLD field).
      */
-    private const API_DISCRIMINATOR_MAP = ["Part" => PartAttachment::class, "Project" => ProjectAttachment::class, "AttachmentType" => AttachmentTypeAttachment::class,
+    private const API_DISCRIMINATOR_MAP = ["Part" => PartAttachment::class, "PartCustomState" => PartCustomStateAttachment::class, "Project" => ProjectAttachment::class,
+        "AttachmentType" => AttachmentTypeAttachment::class,
         "Category" => CategoryAttachment::class, "Footprint" => FootprintAttachment::class, "Manufacturer" => ManufacturerAttachment::class,
         "Currency" => CurrencyAttachment::class, "Group" => GroupAttachment::class, "MeasurementUnit" => MeasurementUnitAttachment::class,
         "StorageLocation" => StorageLocationAttachment::class, "Supplier" => SupplierAttachment::class, "User" => UserAttachment::class, "LabelProfile" => LabelAttachment::class];

src/Entity/Attachments/PartCustomStateAttachment.php

@@ -0,0 +1,45 @@
+<?php
+/**
+ * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony).
+ *
+ * Copyright (C) 2019 - 2022 Jan Böhmer (https://github.com/jbtronics)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace App\Entity\Attachments;
+
+use App\Entity\Parts\PartCustomState;
+use App\Serializer\APIPlatform\OverrideClassDenormalizer;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+use Symfony\Component\Serializer\Attribute\Context;
+
+/**
+ * An attachment attached to a part custom state element.
+ * @extends Attachment<PartCustomState>
+ */
+#[UniqueEntity(['name', 'attachment_type', 'element'])]
+#[ORM\Entity]
+class PartCustomStateAttachment extends Attachment
+{
+    final public const ALLOWED_ELEMENT_CLASS = PartCustomState::class;
+
+    #[ORM\ManyToOne(targetEntity: PartCustomState::class, inversedBy: 'attachments')]
+    #[ORM\JoinColumn(name: 'element_id', nullable: false, onDelete: 'CASCADE')]
+    #[Context(denormalizationContext: [OverrideClassDenormalizer::CONTEXT_KEY => self::ALLOWED_ELEMENT_CLASS])]
+    protected ?AttachmentContainingDBElement $element = null;
+}

src/Entity/Base/AbstractDBElement.php

@@ -33,6 +33,7 @@ use App\Entity\Attachments\LabelAttachment;
 use App\Entity\Attachments\ManufacturerAttachment;
 use App\Entity\Attachments\MeasurementUnitAttachment;
 use App\Entity\Attachments\PartAttachment;
+use App\Entity\Attachments\PartCustomStateAttachment;
 use App\Entity\Attachments\ProjectAttachment;
 use App\Entity\Attachments\StorageLocationAttachment;
 use App\Entity\Attachments\SupplierAttachment;
@@ -40,6 +41,7 @@ use App\Entity\Attachments\UserAttachment;
 use App\Entity\Parameters\AbstractParameter;
 use App\Entity\Parts\Category;
 use App\Entity\PriceInformations\Pricedetail;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\ProjectSystem\Project;
 use App\Entity\ProjectSystem\ProjectBOMEntry;
 use App\Entity\Parts\Footprint;
@@ -68,7 +70,41 @@ use Symfony\Component\Serializer\Annotation\Groups;
  * Every database table which are managed with this class (or a subclass of it)
  *          must have the table row "id"!! The ID is the unique key to identify the elements.
  */
-#[DiscriminatorMap(typeProperty: 'type', mapping: ['attachment_type' => AttachmentType::class, 'attachment' => Attachment::class, 'attachment_type_attachment' => AttachmentTypeAttachment::class, 'category_attachment' => CategoryAttachment::class, 'currency_attachment' => CurrencyAttachment::class, 'footprint_attachment' => FootprintAttachment::class, 'group_attachment' => GroupAttachment::class, 'label_attachment' => LabelAttachment::class, 'manufacturer_attachment' => ManufacturerAttachment::class, 'measurement_unit_attachment' => MeasurementUnitAttachment::class, 'part_attachment' => PartAttachment::class, 'project_attachment' => ProjectAttachment::class, 'storelocation_attachment' => StorageLocationAttachment::class, 'supplier_attachment' => SupplierAttachment::class, 'user_attachment' => UserAttachment::class, 'category' => Category::class, 'project' => Project::class, 'project_bom_entry' => ProjectBOMEntry::class, 'footprint' => Footprint::class, 'group' => Group::class, 'manufacturer' => Manufacturer::class, 'orderdetail' => Orderdetail::class, 'part' => Part::class, 'pricedetail' => Pricedetail::class, 'storelocation' => StorageLocation::class, 'part_lot' => PartLot::class, 'currency' => Currency::class, 'measurement_unit' => MeasurementUnit::class, 'parameter' => AbstractParameter::class, 'supplier' => Supplier::class, 'user' => User::class])]
+#[DiscriminatorMap(typeProperty: 'type', mapping: [
+    'attachment_type' => AttachmentType::class,
+    'attachment' => Attachment::class,
+    'attachment_type_attachment' => AttachmentTypeAttachment::class,
+    'category_attachment' => CategoryAttachment::class,
+    'currency_attachment' => CurrencyAttachment::class,
+    'footprint_attachment' => FootprintAttachment::class,
+    'group_attachment' => GroupAttachment::class,
+    'label_attachment' => LabelAttachment::class,
+    'manufacturer_attachment' => ManufacturerAttachment::class,
+    'measurement_unit_attachment' => MeasurementUnitAttachment::class,
+    'part_attachment' => PartAttachment::class,
+    'part_custom_state_attachment' => PartCustomStateAttachment::class,
+    'project_attachment' => ProjectAttachment::class,
+    'storelocation_attachment' => StorageLocationAttachment::class,
+    'supplier_attachment' => SupplierAttachment::class,
+    'user_attachment' => UserAttachment::class,
+    'category' => Category::class,
+    'project' => Project::class,
+    'project_bom_entry' => ProjectBOMEntry::class,
+    'footprint' => Footprint::class,
+    'group' => Group::class,
+    'manufacturer' => Manufacturer::class,
+    'orderdetail' => Orderdetail::class,
+    'part' => Part::class,
+    'part_custom_state' => PartCustomState::class,
+    'pricedetail' => Pricedetail::class,
+    'storelocation' => StorageLocation::class,
+    'part_lot' => PartLot::class,
+    'currency' => Currency::class,
+    'measurement_unit' => MeasurementUnit::class,
+    'parameter' => AbstractParameter::class,
+    'supplier' => Supplier::class,
+    'user' => User::class]
+)]
 #[ORM\MappedSuperclass(repositoryClass: DBElementRepository::class)]
 abstract class AbstractDBElement implements JsonSerializable
 {

src/Entity/LogSystem/CollectionElementDeleted.php

@@ -46,6 +46,7 @@ use App\Entity\Attachments\AttachmentType;
 use App\Entity\Attachments\AttachmentTypeAttachment;
 use App\Entity\Attachments\CategoryAttachment;
 use App\Entity\Attachments\CurrencyAttachment;
+use App\Entity\Attachments\PartCustomStateAttachment;
 use App\Entity\Attachments\ProjectAttachment;
 use App\Entity\Attachments\FootprintAttachment;
 use App\Entity\Attachments\GroupAttachment;
@@ -58,6 +59,8 @@ use App\Entity\Attachments\UserAttachment;
 use App\Entity\Base\AbstractDBElement;
 use App\Entity\Contracts\LogWithEventUndoInterface;
 use App\Entity\Contracts\NamedElementInterface;
+use App\Entity\Parameters\PartCustomStateParameter;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\ProjectSystem\Project;
 use App\Entity\Parameters\AbstractParameter;
 use App\Entity\Parameters\AttachmentTypeParameter;
@@ -158,6 +161,7 @@ class CollectionElementDeleted extends AbstractLogEntry implements LogWithEventU
                 Part::class => PartParameter::class,
                 StorageLocation::class => StorageLocationParameter::class,
                 Supplier::class => SupplierParameter::class,
+                PartCustomState::class => PartCustomStateParameter::class,
                 default => throw new \RuntimeException('Unknown target class for parameter: '.$this->getTargetClass()),
             };
         }
@@ -173,6 +177,7 @@ class CollectionElementDeleted extends AbstractLogEntry implements LogWithEventU
                 Manufacturer::class => ManufacturerAttachment::class,
                 MeasurementUnit::class => MeasurementUnitAttachment::class,
                 Part::class => PartAttachment::class,
+                PartCustomState::class => PartCustomStateAttachment::class,
                 StorageLocation::class => StorageLocationAttachment::class,
                 Supplier::class => SupplierAttachment::class,
                 User::class => UserAttachment::class,

src/Entity/LogSystem/LogTargetType.php

@@ -34,6 +34,7 @@ use App\Entity\Parts\Manufacturer;
 use App\Entity\Parts\MeasurementUnit;
 use App\Entity\Parts\Part;
 use App\Entity\Parts\PartAssociation;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\Parts\PartLot;
 use App\Entity\Parts\StorageLocation;
 use App\Entity\Parts\Supplier;
@@ -71,6 +72,7 @@ enum LogTargetType: int
     case PART_ASSOCIATION = 20;
     case BULK_INFO_PROVIDER_IMPORT_JOB = 21;
     case BULK_INFO_PROVIDER_IMPORT_JOB_PART = 22;
+    case PART_CUSTOM_STATE = 23;
 
     /**
      * Returns the class name of the target type or null if the target type is NONE.
@@ -102,6 +104,7 @@ enum LogTargetType: int
             self::PART_ASSOCIATION => PartAssociation::class,
             self::BULK_INFO_PROVIDER_IMPORT_JOB => BulkInfoProviderImportJob::class,
             self::BULK_INFO_PROVIDER_IMPORT_JOB_PART => BulkInfoProviderImportJobPart::class,
+            self::PART_CUSTOM_STATE => PartCustomState::class
         };
     }
 

src/Entity/Parameters/AbstractParameter.php

@@ -73,7 +73,8 @@ use function sprintf;
 #[ORM\DiscriminatorMap([0 => CategoryParameter::class, 1 => CurrencyParameter::class, 2 => ProjectParameter::class,
     3 => FootprintParameter::class, 4 => GroupParameter::class, 5 => ManufacturerParameter::class,
     6 => MeasurementUnitParameter::class, 7 => PartParameter::class, 8 => StorageLocationParameter::class,
-    9 => SupplierParameter::class, 10 => AttachmentTypeParameter::class])]
+    9 => SupplierParameter::class, 10 => AttachmentTypeParameter::class,
+    12 => PartCustomStateParameter::class])]
 #[ORM\Table('parameters')]
 #[ORM\Index(columns: ['name'], name: 'parameter_name_idx')]
 #[ORM\Index(columns: ['param_group'], name: 'parameter_group_idx')]
@@ -105,7 +106,7 @@ abstract class AbstractParameter extends AbstractNamedDBElement implements Uniqu
         "AttachmentType" => AttachmentTypeParameter::class, "Category" => CategoryParameter::class, "Currency" => CurrencyParameter::class,
         "Project" => ProjectParameter::class, "Footprint" => FootprintParameter::class, "Group" => GroupParameter::class,
         "Manufacturer" => ManufacturerParameter::class, "MeasurementUnit" => MeasurementUnitParameter::class,
-        "StorageLocation" => StorageLocationParameter::class, "Supplier" => SupplierParameter::class];
+        "StorageLocation" => StorageLocationParameter::class, "Supplier" => SupplierParameter::class, "PartCustomState" => PartCustomStateParameter::class];
 
     /**
      * @var string The class of the element that can be passed to this attachment. Must be overridden in subclasses.

src/Entity/Parameters/PartCustomStateParameter.php

@@ -0,0 +1,65 @@
+<?php
+/*
+ * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony).
+ *
+ *  Copyright (C) 2019 - 2022 Jan Böhmer (https://github.com/jbtronics)
+ *
+ *  This program is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU Affero General Public License as published
+ *  by the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU Affero General Public License for more details.
+ *
+ *  You should have received a copy of the GNU Affero General Public License
+ *  along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+/**
+ * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony).
+ *
+ * Copyright (C) 2019 - 2022 Jan Böhmer (https://github.com/jbtronics)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+namespace App\Entity\Parameters;
+
+use App\Entity\Base\AbstractDBElement;
+use App\Entity\Parts\PartCustomState;
+use App\Repository\ParameterRepository;
+use App\Serializer\APIPlatform\OverrideClassDenormalizer;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
+use Symfony\Component\Serializer\Attribute\Context;
+
+#[UniqueEntity(fields: ['name', 'group', 'element'])]
+#[ORM\Entity(repositoryClass: ParameterRepository::class)]
+class PartCustomStateParameter extends AbstractParameter
+{
+    final public const ALLOWED_ELEMENT_CLASS = PartCustomState::class;
+
+    /**
+     * @var PartCustomState the element this para is associated with
+     */
+    #[ORM\ManyToOne(targetEntity: PartCustomState::class, inversedBy: 'parameters')]
+    #[ORM\JoinColumn(name: 'element_id', nullable: false, onDelete: 'CASCADE')]
+    #[Context(denormalizationContext: [OverrideClassDenormalizer::CONTEXT_KEY => self::ALLOWED_ELEMENT_CLASS])]
+    protected ?AbstractDBElement $element = null;
+}

src/Entity/Parts/Part.php

@@ -107,7 +107,7 @@ use Symfony\Component\Validator\Context\ExecutionContextInterface;
     denormalizationContext: ['groups' => ['part:write', 'api:basic:write', 'eda_info:write', 'attachment:write', 'parameter:write'], 'openapi_definition_name' => 'Write'],
 )]
 #[ApiFilter(PropertyFilter::class)]
-#[ApiFilter(EntityFilter::class, properties: ["category", "footprint", "manufacturer", "partUnit"])]
+#[ApiFilter(EntityFilter::class, properties: ["category", "footprint", "manufacturer", "partUnit", "partCustomState"])]
 #[ApiFilter(PartStoragelocationFilter::class, properties: ["storage_location"])]
 #[ApiFilter(LikeFilter::class, properties: ["name", "comment", "description", "ipn", "manufacturer_product_number"])]
 #[ApiFilter(TagFilter::class, properties: ["tags"])]

src/Entity/Parts/PartCustomState.php

@@ -0,0 +1,127 @@
+<?php
+/**
+ * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony).
+ *
+ * Copyright (C) 2019 - 2022 Jan Böhmer (https://github.com/jbtronics)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace App\Entity\Parts;
+
+use ApiPlatform\Metadata\ApiProperty;
+use App\Entity\Attachments\Attachment;
+use App\Entity\Attachments\PartCustomStateAttachment;
+use ApiPlatform\Doctrine\Common\Filter\DateFilterInterface;
+use ApiPlatform\Doctrine\Orm\Filter\DateFilter;
+use ApiPlatform\Doctrine\Orm\Filter\OrderFilter;
+use ApiPlatform\Metadata\ApiFilter;
+use ApiPlatform\Metadata\ApiResource;
+use ApiPlatform\Metadata\Delete;
+use ApiPlatform\Metadata\Get;
+use ApiPlatform\Metadata\GetCollection;
+use ApiPlatform\Metadata\Patch;
+use ApiPlatform\Metadata\Post;
+use ApiPlatform\Serializer\Filter\PropertyFilter;
+use App\ApiPlatform\Filter\LikeFilter;
+use App\Entity\Base\AbstractPartsContainingDBElement;
+use App\Entity\Base\AbstractStructuralDBElement;
+use App\Entity\Parameters\PartCustomStateParameter;
+use App\Repository\Parts\PartCustomStateRepository;
+use Doctrine\Common\Collections\ArrayCollection;
+use Doctrine\Common\Collections\Collection;
+use Doctrine\Common\Collections\Criteria;
+use Doctrine\ORM\Mapping as ORM;
+use Symfony\Component\Serializer\Annotation\Groups;
+use Symfony\Component\Validator\Constraints as Assert;
+
+/**
+ * This entity represents a custom part state.
+ * If an organisation uses Part-DB and has its custom part states, this is useful.
+ *
+ * @extends AbstractPartsContainingDBElement<PartCustomStateAttachment,PartCustomStateParameter>
+ */
+#[ORM\Entity(repositoryClass: PartCustomStateRepository::class)]
+#[ORM\Table('`part_custom_states`')]
+#[ORM\Index(columns: ['name'], name: 'part_custom_state_name')]
+#[ApiResource(
+    operations: [
+        new Get(security: 'is_granted("read", object)'),
+        new GetCollection(security: 'is_granted("@part_custom_states.read")'),
+        new Post(securityPostDenormalize: 'is_granted("create", object)'),
+        new Patch(security: 'is_granted("edit", object)'),
+        new Delete(security: 'is_granted("delete", object)'),
+    ],
+    normalizationContext: ['groups' => ['part_custom_state:read', 'api:basic:read'], 'openapi_definition_name' => 'Read'],
+    denormalizationContext: ['groups' => ['part_custom_state:write', 'api:basic:write'], 'openapi_definition_name' => 'Write'],
+)]
+#[ApiFilter(PropertyFilter::class)]
+#[ApiFilter(LikeFilter::class, properties: ["name"])]
+#[ApiFilter(DateFilter::class, strategy: DateFilterInterface::EXCLUDE_NULL)]
+#[ApiFilter(OrderFilter::class, properties: ['name', 'id', 'addedDate', 'lastModified'])]
+class PartCustomState extends AbstractPartsContainingDBElement
+{
+    /**
+     * @var string The comment info for this element as markdown
+     */
+    #[Groups(['part_custom_state:read', 'part_custom_state:write', 'full', 'import'])]
+    protected string $comment = '';
+
+    #[ORM\OneToMany(mappedBy: 'parent', targetEntity: self::class, cascade: ['persist'])]
+    #[ORM\OrderBy(['name' => Criteria::ASC])]
+    protected Collection $children;
+
+    #[ORM\ManyToOne(targetEntity: self::class, inversedBy: 'children')]
+    #[ORM\JoinColumn(name: 'parent_id')]
+    #[Groups(['part_custom_state:read', 'part_custom_state:write'])]
+    #[ApiProperty(readableLink: false, writableLink: false)]
+    protected ?AbstractStructuralDBElement $parent = null;
+
+    /**
+     * @var Collection<int, PartCustomStateAttachment>
+     */
+    #[Assert\Valid]
+    #[ORM\OneToMany(targetEntity: PartCustomStateAttachment::class, mappedBy: 'element', cascade: ['persist', 'remove'], orphanRemoval: true)]
+    #[ORM\OrderBy(['name' => Criteria::ASC])]
+    #[Groups(['part_custom_state:read', 'part_custom_state:write'])]
+    protected Collection $attachments;
+
+    #[ORM\ManyToOne(targetEntity: PartCustomStateAttachment::class)]
+    #[ORM\JoinColumn(name: 'id_preview_attachment', onDelete: 'SET NULL')]
+    #[Groups(['part_custom_state:read', 'part_custom_state:write'])]
+    protected ?Attachment $master_picture_attachment = null;
+
+    /** @var Collection<int, PartCustomStateParameter>
+     */
+    #[Assert\Valid]
+    #[ORM\OneToMany(mappedBy: 'element', targetEntity: PartCustomStateParameter::class, cascade: ['persist', 'remove'], orphanRemoval: true)]
+    #[ORM\OrderBy(['name' => 'ASC'])]
+    #[Groups(['part_custom_state:read', 'part_custom_state:write'])]
+    protected Collection $parameters;
+
+    #[Groups(['part_custom_state:read'])]
+    protected ?\DateTimeImmutable $addedDate = null;
+    #[Groups(['part_custom_state:read'])]
+    protected ?\DateTimeImmutable $lastModified = null;
+
+    public function __construct()
+    {
+        parent::__construct();
+        $this->children = new ArrayCollection();
+        $this->attachments = new ArrayCollection();
+        $this->parameters = new ArrayCollection();
+    }
+}

src/Entity/Parts/PartTraits/AdvancedPropertyTrait.php

@@ -23,6 +23,7 @@ declare(strict_types=1);
 namespace App\Entity\Parts\PartTraits;
 
 use App\Entity\Parts\InfoProviderReference;
+use App\Entity\Parts\PartCustomState;
 use Doctrine\DBAL\Types\Types;
 use App\Entity\Parts\Part;
 use Doctrine\ORM\Mapping as ORM;
@@ -73,6 +74,14 @@ trait AdvancedPropertyTrait
     #[Groups(['full', 'part:read'])]
     protected InfoProviderReference $providerReference;
 
+    /**
+     * @var ?PartCustomState the custom state for the part
+     */
+    #[Groups(['extended', 'full', 'import', 'part:read', 'part:write'])]
+    #[ORM\ManyToOne(targetEntity: PartCustomState::class)]
+    #[ORM\JoinColumn(name: 'id_part_custom_state')]
+    protected ?PartCustomState $partCustomState = null;
+
     /**
      * Checks if this part is marked, for that it needs further review.
      */
@@ -180,7 +189,24 @@ trait AdvancedPropertyTrait
         return $this;
     }
 
+    /**
+     * Gets the custom part state for the part
+     * Returns null if no specific part state is set.
+     */
+    public function getPartCustomState(): ?PartCustomState
+    {
+        return $this->partCustomState;
+    }
 
+    /**
+     * Sets the custom part state.
+     *
+     * @return $this
+     */
+    public function setPartCustomState(?PartCustomState $partCustomState): self
+    {
+        $this->partCustomState = $partCustomState;
 
-
+        return $this;
+    }
 }

src/Form/AdminPages/PartCustomStateAdminForm.php

@@ -0,0 +1,27 @@
+<?php
+/**
+ * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony).
+ *
+ * Copyright (C) 2019 - 2022 Jan Böhmer (https://github.com/jbtronics)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+declare(strict_types=1);
+
+namespace App\Form\AdminPages;
+
+class PartCustomStateAdminForm extends BaseEntityAdminForm
+{
+}

src/Form/Filters/LogFilterType.php

@@ -130,6 +130,7 @@ class LogFilterType extends AbstractType
                 LogTargetType::PART_ASSOCIATION => 'part_association.label',
                 LogTargetType::BULK_INFO_PROVIDER_IMPORT_JOB => 'bulk_info_provider_import_job.label',
                 LogTargetType::BULK_INFO_PROVIDER_IMPORT_JOB_PART => 'bulk_info_provider_import_job_part.label',
+                LogTargetType::PART_CUSTOM_STATE => 'part_custom_state.label',
             },
         ]);
 

src/Form/Filters/PartFilterType.php

@@ -32,6 +32,7 @@ use App\Entity\Parts\Category;
 use App\Entity\Parts\Footprint;
 use App\Entity\Parts\Manufacturer;
 use App\Entity\Parts\MeasurementUnit;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\Parts\StorageLocation;
 use App\Entity\Parts\Supplier;
 use App\Entity\ProjectSystem\Project;
@@ -139,6 +140,11 @@ class PartFilterType extends AbstractType
             'entity_class' => MeasurementUnit::class
         ]);
 
+        $builder->add('partCustomState', StructuralEntityConstraintType::class, [
+            'label' => 'part.edit.partCustomState',
+            'entity_class' => PartCustomState::class
+        ]);
+
         $builder->add('lastModified', DateTimeConstraintType::class, [
             'label' => 'lastModified'
         ]);

src/Form/Part/PartBaseType.php

@@ -30,6 +30,7 @@ use App\Entity\Parts\Manufacturer;
 use App\Entity\Parts\ManufacturingStatus;
 use App\Entity\Parts\MeasurementUnit;
 use App\Entity\Parts\Part;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\PriceInformations\Orderdetail;
 use App\Form\AttachmentFormType;
 use App\Form\ParameterType;
@@ -171,6 +172,12 @@ class PartBaseType extends AbstractType
                 'disable_not_selectable' => true,
                 'label' => 'part.edit.partUnit',
             ])
+            ->add('partCustomState', StructuralEntityType::class, [
+                'class' => PartCustomState::class,
+                'required' => false,
+                'disable_not_selectable' => true,
+                'label' => 'part.edit.partCustomState',
+            ])
             ->add('ipn', TextType::class, [
                 'required' => false,
                 'empty_data' => null,

src/Repository/Parts/PartCustomStateRepository.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of Part-DB (https://github.com/Part-DB/Part-DB-symfony).
+ *
+ * Copyright (C) 2019 - 2022 Jan Böhmer (https://github.com/jbtronics)
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published
+ * by the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program.  If not, see <https://www.gnu.org/licenses/>.
+ */
+namespace App\Repository\Parts;
+
+use App\Entity\Parts\PartCustomState;
+use App\Repository\AbstractPartsContainingRepository;
+use InvalidArgumentException;
+
+class PartCustomStateRepository extends AbstractPartsContainingRepository
+{
+    public function getParts(object $element, string $nameOrderDirection = "ASC"): array
+    {
+        if (!$element instanceof PartCustomState) {
+            throw new InvalidArgumentException('$element must be an PartCustomState!');
+        }
+
+        return $this->getPartsByField($element, $nameOrderDirection, 'partUnit');
+    }
+
+    public function getPartsCount(object $element): int
+    {
+        if (!$element instanceof PartCustomState) {
+            throw new InvalidArgumentException('$element must be an PartCustomState!');
+        }
+
+        return $this->getPartsCountByField($element, 'partUnit');
+    }
+}

src/Security/Voter/AttachmentVoter.php

@@ -22,6 +22,7 @@ declare(strict_types=1);
 
 namespace App\Security\Voter;
 
+use App\Entity\Attachments\PartCustomStateAttachment;
 use App\Services\UserSystem\VoterHelper;
 use Symfony\Bundle\SecurityBundle\Security;
 use App\Entity\Attachments\AttachmentContainingDBElement;
@@ -99,6 +100,8 @@ final class AttachmentVoter extends Voter
                 $param = 'measurement_units';
             } elseif (is_a($subject, PartAttachment::class, true)) {
                 $param = 'parts';
+            } elseif (is_a($subject, PartCustomStateAttachment::class, true)) {
+                $param = 'part_custom_states';
             } elseif (is_a($subject, StorageLocationAttachment::class, true)) {
                 $param = 'storelocations';
             } elseif (is_a($subject, SupplierAttachment::class, true)) {

src/Security/Voter/ParameterVoter.php

@@ -22,6 +22,7 @@ declare(strict_types=1);
  */
 namespace App\Security\Voter;
 
+use App\Entity\Parameters\PartCustomStateParameter;
 use App\Services\UserSystem\VoterHelper;
 use Symfony\Bundle\SecurityBundle\Security;
 use App\Entity\Base\AbstractDBElement;
@@ -97,6 +98,8 @@ final class ParameterVoter extends Voter
             $param = 'measurement_units';
         } elseif (is_a($subject, PartParameter::class, true)) {
             $param = 'parts';
+        } elseif (is_a($subject, PartCustomStateParameter::class, true)) {
+            $param = 'part_custom_states';
         } elseif (is_a($subject, StorageLocationParameter::class, true)) {
             $param = 'storelocations';
         } elseif (is_a($subject, SupplierParameter::class, true)) {

src/Security/Voter/StructureVoter.php

@@ -23,6 +23,7 @@ declare(strict_types=1);
 namespace App\Security\Voter;
 
 use App\Entity\Attachments\AttachmentType;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\ProjectSystem\Project;
 use App\Entity\Parts\Category;
 use App\Entity\Parts\Footprint;
@@ -53,6 +54,7 @@ final class StructureVoter extends Voter
         Supplier::class => 'suppliers',
         Currency::class => 'currencies',
         MeasurementUnit::class => 'measurement_units',
+        PartCustomState::class => 'part_custom_states',
     ];
 
     public function __construct(private readonly VoterHelper $helper)

src/Services/Attachments/AttachmentSubmitHandler.php

@@ -30,6 +30,7 @@ use App\Entity\Attachments\AttachmentUpload;
 use App\Entity\Attachments\CategoryAttachment;
 use App\Entity\Attachments\CurrencyAttachment;
 use App\Entity\Attachments\LabelAttachment;
+use App\Entity\Attachments\PartCustomStateAttachment;
 use App\Entity\Attachments\ProjectAttachment;
 use App\Entity\Attachments\FootprintAttachment;
 use App\Entity\Attachments\GroupAttachment;
@@ -80,6 +81,7 @@ class AttachmentSubmitHandler
         //The mapping used to determine which folder will be used for an attachment type
         $this->folder_mapping = [
             PartAttachment::class => 'part',
+            PartCustomStateAttachment::class => 'part_custom_state',
             AttachmentTypeAttachment::class => 'attachment_type',
             CategoryAttachment::class => 'category',
             CurrencyAttachment::class => 'currency',

src/Services/Attachments/PartPreviewGenerator.php

@@ -23,6 +23,7 @@ declare(strict_types=1);
 namespace App\Services\Attachments;
 
 use App\Entity\Parts\Footprint;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\ProjectSystem\Project;
 use App\Entity\Parts\Category;
 use App\Entity\Parts\StorageLocation;

src/Services/EDA/KiCadHelper.php

@@ -233,6 +233,10 @@ class KiCadHelper
             }
             $result["fields"]["Part-DB Unit"] = $this->createField($unit);
         }
+        if ($part->getPartCustomState() !== null) {
+            $customState = $part->getPartCustomState()->getName();
+            $result["fields"]["Part-DB Custom state"] = $this->createField($customState);
+        }
         if ($part->getMass()) {
             $result["fields"]["Mass"] = $this->createField($part->getMass() . ' g');
         }

src/Services/ElementTypeNameGenerator.php

@@ -37,6 +37,7 @@ use App\Entity\Parts\Manufacturer;
 use App\Entity\Parts\MeasurementUnit;
 use App\Entity\Parts\Part;
 use App\Entity\Parts\PartAssociation;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\Parts\PartLot;
 use App\Entity\Parts\StorageLocation;
 use App\Entity\Parts\Supplier;
@@ -83,6 +84,7 @@ class ElementTypeNameGenerator
             PartAssociation::class => $this->translator->trans('part_association.label'),
             BulkInfoProviderImportJob::class => $this->translator->trans('bulk_info_provider_import_job.label'),
             BulkInfoProviderImportJobPart::class => $this->translator->trans('bulk_info_provider_import_job_part.label'),
+            PartCustomState::class => $this->translator->trans('part_custom_state.label'),
         ];
     }
 

src/Services/EntityMergers/Mergers/PartMerger.php

@@ -65,6 +65,7 @@ class PartMerger implements EntityMergerInterface
         $this->useOtherValueIfNotNull($target, $other, 'footprint');
         $this->useOtherValueIfNotNull($target, $other, 'category');
         $this->useOtherValueIfNotNull($target, $other, 'partUnit');
+        $this->useOtherValueIfNotNull($target, $other, 'partCustomState');
 
         //We assume that the higher value is the correct one for minimum instock
         $this->useLargerValue($target, $other, 'minamount');

src/Services/EntityURLGenerator.php

@@ -27,6 +27,7 @@ use App\Entity\Attachments\AttachmentType;
 use App\Entity\Attachments\PartAttachment;
 use App\Entity\Base\AbstractDBElement;
 use App\Entity\Parameters\PartParameter;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\ProjectSystem\Project;
 use App\Entity\LabelSystem\LabelProfile;
 use App\Entity\Parts\Category;
@@ -107,6 +108,7 @@ class EntityURLGenerator
             MeasurementUnit::class => 'measurement_unit_edit',
             Group::class => 'group_edit',
             LabelProfile::class => 'label_profile_edit',
+            PartCustomState::class => 'part_custom_state_edit',
         ];
 
         try {
@@ -213,6 +215,7 @@ class EntityURLGenerator
             MeasurementUnit::class => 'measurement_unit_edit',
             Group::class => 'group_edit',
             LabelProfile::class => 'label_profile_edit',
+            PartCustomState::class => 'part_custom_state_edit',
         ];
 
         return $this->urlGenerator->generate($this->mapToController($map, $entity), ['id' => $entity->getID()]);
@@ -243,6 +246,7 @@ class EntityURLGenerator
             MeasurementUnit::class => 'measurement_unit_edit',
             Group::class => 'group_edit',
             LabelProfile::class => 'label_profile_edit',
+            PartCustomState::class => 'part_custom_state_edit',
         ];
 
         return $this->urlGenerator->generate($this->mapToController($map, $entity), ['id' => $entity->getID()]);
@@ -274,6 +278,7 @@ class EntityURLGenerator
             MeasurementUnit::class => 'measurement_unit_new',
             Group::class => 'group_new',
             LabelProfile::class => 'label_profile_new',
+            PartCustomState::class => 'part_custom_state_new',
         ];
 
         return $this->urlGenerator->generate($this->mapToController($map, $entity));
@@ -305,6 +310,7 @@ class EntityURLGenerator
             MeasurementUnit::class => 'measurement_unit_clone',
             Group::class => 'group_clone',
             LabelProfile::class => 'label_profile_clone',
+            PartCustomState::class => 'part_custom_state_clone',
         ];
 
         return $this->urlGenerator->generate($this->mapToController($map, $entity), ['id' => $entity->getID()]);
@@ -350,6 +356,7 @@ class EntityURLGenerator
             MeasurementUnit::class => 'measurement_unit_delete',
             Group::class => 'group_delete',
             LabelProfile::class => 'label_profile_delete',
+            PartCustomState::class => 'part_custom_state_delete',
         ];
 
         return $this->urlGenerator->generate($this->mapToController($map, $entity), ['id' => $entity->getID()]);

src/Services/ImportExportSystem/PartKeeprImporter/PKDatastructureImporter.php

@@ -29,6 +29,7 @@ use App\Entity\Parts\Category;
 use App\Entity\Parts\Footprint;
 use App\Entity\Parts\Manufacturer;
 use App\Entity\Parts\MeasurementUnit;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\Parts\StorageLocation;
 use App\Entity\Parts\Supplier;
 use Doctrine\ORM\EntityManagerInterface;
@@ -148,6 +149,26 @@ class PKDatastructureImporter
         return is_countable($partunit_data) ? count($partunit_data) : 0;
     }
 
+    public function importPartCustomStates(array $data): int
+    {
+        if (!isset($data['partcustomstate'])) {
+            throw new \RuntimeException('$data must contain a "partcustomstate" key!');
+        }
+
+        $partCustomStateData = $data['partcustomstate'];
+        foreach ($partCustomStateData as $partCustomState) {
+            $customState = new PartCustomState();
+            $customState->setName($partCustomState['name']);
+
+            $this->setIDOfEntity($customState, $partCustomState['id']);
+            $this->em->persist($customState);
+        }
+
+        $this->em->flush();
+
+        return is_countable($partCustomStateData) ? count($partCustomStateData) : 0;
+    }
+
     public function importCategories(array $data): int
     {
         if (!isset($data['partcategory'])) {

src/Services/ImportExportSystem/PartKeeprImporter/PKPartImporter.php

@@ -91,6 +91,8 @@ class PKPartImporter
                     $this->setAssociationField($entity, 'partUnit', MeasurementUnit::class, $part['partUnit_id']);
                 }
 
+                $this->setAssociationField($entity, 'partCustomState', MeasurementUnit::class, $part['partCustomState_id']);
+
                 //Create a part lot to store the stock level and location
                 $lot = new PartLot();
                 $lot->setAmount((float) ($part['stockLevel'] ?? 0));

src/Services/LabelSystem/SandboxedTwigFactory.php

@@ -133,7 +133,7 @@ final class SandboxedTwigFactory
         Supplier::class => ['getShippingCosts', 'getDefaultCurrency'],
         Part::class => ['isNeedsReview', 'getTags', 'getMass', 'getIpn', 'getProviderReference',
             'getDescription', 'getComment', 'isFavorite', 'getCategory', 'getFootprint',
-            'getPartLots', 'getPartUnit', 'useFloatAmount', 'getMinAmount', 'getAmountSum', 'isNotEnoughInstock', 'isAmountUnknown', 'getExpiredAmountSum',
+            'getPartLots', 'getPartUnit', 'getPartCustomState', 'useFloatAmount', 'getMinAmount', 'getAmountSum', 'isNotEnoughInstock', 'isAmountUnknown', 'getExpiredAmountSum',
             'getManufacturerProductUrl', 'getCustomProductURL', 'getManufacturingStatus', 'getManufacturer',
             'getManufacturerProductNumber', 'getOrderdetails', 'isObsolete',
             'getParameters', 'getGroupedParameters',

src/Services/Trees/ToolsTreeBuilder.php

@@ -29,6 +29,7 @@ use App\Entity\Parts\Footprint;
 use App\Entity\Parts\Manufacturer;
 use App\Entity\Parts\MeasurementUnit;
 use App\Entity\Parts\Part;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\Parts\StorageLocation;
 use App\Entity\Parts\Supplier;
 use App\Entity\PriceInformations\Currency;
@@ -217,6 +218,12 @@ class ToolsTreeBuilder
                 $this->urlGenerator->generate('label_profile_new')
             ))->setIcon('fa-fw fa-treeview fa-solid fa-qrcode');
         }
+        if ($this->security->isGranted('read', new PartCustomState())) {
+            $nodes[] = (new TreeViewNode(
+                $this->translator->trans('tree.tools.edit.part_custom_state'),
+                $this->urlGenerator->generate('part_custom_state_new')
+            ))->setIcon('fa-fw fa-treeview fa-solid fa-tools');
+        }
         if ($this->security->isGranted('create', new Part())) {
             $nodes[] = (new TreeViewNode(
                 $this->translator->trans('tree.tools.edit.part'),

src/Services/UserSystem/PermissionPresetsHelper.php

@@ -102,6 +102,7 @@ class PermissionPresetsHelper
         $this->permissionResolver->setAllOperationsOfPermission($perm_holder, 'attachment_types', PermissionData::ALLOW);
         $this->permissionResolver->setAllOperationsOfPermission($perm_holder, 'currencies', PermissionData::ALLOW);
         $this->permissionResolver->setAllOperationsOfPermission($perm_holder, 'measurement_units', PermissionData::ALLOW);
+        $this->permissionResolver->setAllOperationsOfPermission($perm_holder, 'part_custom_states', PermissionData::ALLOW);
         $this->permissionResolver->setAllOperationsOfPermission($perm_holder, 'suppliers', PermissionData::ALLOW);
         $this->permissionResolver->setAllOperationsOfPermission($perm_holder, 'projects', PermissionData::ALLOW);
 
@@ -131,6 +132,7 @@ class PermissionPresetsHelper
         $this->permissionResolver->setAllOperationsOfPermissionExcept($permHolder, 'attachment_types', PermissionData::ALLOW, ['import']);
         $this->permissionResolver->setAllOperationsOfPermissionExcept($permHolder, 'currencies', PermissionData::ALLOW, ['import']);
         $this->permissionResolver->setAllOperationsOfPermissionExcept($permHolder, 'measurement_units', PermissionData::ALLOW, ['import']);
+        $this->permissionResolver->setAllOperationsOfPermissionExcept($permHolder, 'part_custom_states', PermissionData::ALLOW, ['import']);
         $this->permissionResolver->setAllOperationsOfPermissionExcept($permHolder, 'suppliers', PermissionData::ALLOW, ['import']);
         $this->permissionResolver->setAllOperationsOfPermissionExcept($permHolder, 'projects', PermissionData::ALLOW, ['import']);
 

src/Settings/BehaviorSettings/PartTableColumns.php

@@ -46,6 +46,7 @@ enum PartTableColumns : string implements TranslatableInterface
     case FAVORITE = "favorite";
     case MANUFACTURING_STATUS = "manufacturing_status";
     case MPN = "manufacturer_product_number";
+    case CUSTOM_PART_STATE = 'partCustomState';
     case MASS = "mass";
     case TAGS = "tags";
     case ATTACHMENTS = "attachments";
@@ -63,4 +64,4 @@ enum PartTableColumns : string implements TranslatableInterface
 
         return $translator->trans($key, locale: $locale);
     }
-}
+}

src/Settings/BehaviorSettings/TableSettings.php

@@ -68,7 +68,7 @@ class TableSettings
     #[Assert\All([new Assert\Type(PartTableColumns::class)])]
     public array $partsDefaultColumns = [PartTableColumns::NAME, PartTableColumns::DESCRIPTION,
         PartTableColumns::CATEGORY, PartTableColumns::FOOTPRINT, PartTableColumns::MANUFACTURER,
-        PartTableColumns::LOCATION, PartTableColumns::AMOUNT];
+        PartTableColumns::LOCATION, PartTableColumns::AMOUNT, PartTableColumns::CUSTOM_PART_STATE];
 
     #[SettingsParameter(label: new TM("settings.behavior.table.preview_image_min_width"),
         formOptions: ['attr' => ['min' => 1, 'max' => 100]],

src/Twig/EntityExtension.php

@@ -24,6 +24,7 @@ namespace App\Twig;
 
 use App\Entity\Attachments\Attachment;
 use App\Entity\Base\AbstractDBElement;
+use App\Entity\Parts\PartCustomState;
 use App\Entity\ProjectSystem\Project;
 use App\Entity\LabelSystem\LabelProfile;
 use App\Entity\Parts\Category;
@@ -115,6 +116,7 @@ final class EntityExtension extends AbstractExtension
             Currency::class => 'currency',
             MeasurementUnit::class => 'measurement_unit',
             LabelProfile::class => 'label_profile',
+            PartCustomState::class => 'part_custom_state',
         ];
 
         foreach ($map as $class => $type) {