. */ declare(strict_types=1); namespace App\Entity\Parts; use ApiPlatform\Doctrine\Orm\Filter\DateFilter; use ApiPlatform\Doctrine\Orm\Filter\OrderFilter; use ApiPlatform\Metadata\ApiFilter; use ApiPlatform\Metadata\ApiProperty; use ApiPlatform\Metadata\ApiResource; use ApiPlatform\Metadata\Delete; use ApiPlatform\Metadata\Get; use ApiPlatform\Metadata\GetCollection; use ApiPlatform\Metadata\Link; use ApiPlatform\Metadata\Patch; use ApiPlatform\Metadata\Post; use ApiPlatform\OpenApi\Model\Operation; use ApiPlatform\Serializer\Filter\PropertyFilter; use App\ApiPlatform\Filter\LikeFilter; use App\Entity\Attachments\Attachment; use App\Repository\Parts\StorelocationRepository; use Doctrine\DBAL\Types\Types; use Doctrine\Common\Collections\ArrayCollection; use App\Entity\Attachments\StorageLocationAttachment; use App\Entity\Base\AbstractPartsContainingDBElement; use App\Entity\Base\AbstractStructuralDBElement; use App\Entity\Parameters\StorageLocationParameter; use App\Entity\UserSystem\User; use Doctrine\Common\Collections\Collection; use Doctrine\ORM\Mapping as ORM; use Symfony\Component\Serializer\Annotation\Groups; use Symfony\Component\Validator\Constraints as Assert; /** * This entity represents a storage location, where parts can be stored. * @extends AbstractPartsContainingDBElement */ #[ORM\Entity(repositoryClass: StorelocationRepository::class)] #[ORM\Table('`storelocations`')] #[ORM\Index(name: 'location_idx_name', columns: ['name'])] #[ORM\Index(name: 'location_idx_parent_name', columns: ['parent_id', 'name'])] #[ApiResource( operations: [ new Get(security: 'is_granted("read", object)'), new GetCollection(security: 'is_granted("@storelocations.read")'), new Post(securityPostDenormalize: 'is_granted("create", object)'), new Patch(security: 'is_granted("edit", object)'), new Delete(security: 'is_granted("delete", object)'), ], normalizationContext: ['groups' => ['location:read', 'api:basic:read'], 'openapi_definition_name' => 'Read'], denormalizationContext: ['groups' => ['location:write', 'api:basic:write', 'attachment:write', 'parameter:write'], 'openapi_definition_name' => 'Write'], )] #[ApiResource( uriTemplate: '/storage_locations/{id}/children.{_format}', operations: [ new GetCollection( openapi: new Operation(summary: 'Retrieves the children elements of a storage location.'), security: 'is_granted("@storelocations.read")' ) ], uriVariables: [ 'id' => new Link(fromProperty: 'children', fromClass: Manufacturer::class) ], normalizationContext: ['groups' => ['location:read', 'api:basic:read'], 'openapi_definition_name' => 'Read'] )] #[ApiFilter(PropertyFilter::class)] #[ApiFilter(LikeFilter::class, properties: ["name", "comment"])] #[ApiFilter(DateFilter::class, strategy: DateFilter::EXCLUDE_NULL)] #[ApiFilter(OrderFilter::class, properties: ['name', 'id', 'addedDate', 'lastModified'])] class StorageLocation extends AbstractPartsContainingDBElement { #[ORM\OneToMany(targetEntity: self::class, mappedBy: 'parent')] #[ORM\OrderBy(['name' => 'ASC'])] protected Collection $children; #[ORM\ManyToOne(targetEntity: self::class, inversedBy: 'children')] #[ORM\JoinColumn(name: 'parent_id')] #[Groups(['location:read', 'location:write'])] #[ApiProperty(readableLink: false, writableLink: false)] protected ?AbstractStructuralDBElement $parent = null; #[Groups(['location:read', 'location:write'])] protected string $comment = ''; /** * @var MeasurementUnit|null The measurement unit, which parts can be stored in here */ #[ORM\ManyToOne(targetEntity: MeasurementUnit::class)] #[ORM\JoinColumn(name: 'storage_type_id')] #[Groups(['location:read', 'location:write'])] protected ?MeasurementUnit $storage_type = null; /** @var Collection */ #[Assert\Valid] #[ORM\OneToMany(targetEntity: StorageLocationParameter::class, mappedBy: 'element', cascade: ['persist', 'remove'], orphanRemoval: true)] #[ORM\OrderBy(['group' => 'ASC', 'name' => 'ASC'])] #[Groups(['location:read', 'location:write'])] protected Collection $parameters; /** * @var bool When this attribute is set, it is not possible to add additional parts or increase the instock of existing parts. */ #[Groups(['full', 'import', 'location:read', 'location:write'])] #[ORM\Column(type: Types::BOOLEAN)] protected bool $is_full = false; /** * @var bool When this property is set, only one part (but many instock) is allowed to be stored in this store location. */ #[Groups(['full', 'import', 'location:read', 'location:write'])] #[ORM\Column(type: Types::BOOLEAN)] protected bool $only_single_part = false; /** * @var bool When this property is set, it is only possible to increase the instock of parts, that are already stored here. */ #[Groups(['full', 'import', 'location:read', 'location:write'])] #[ORM\Column(type: Types::BOOLEAN)] protected bool $limit_to_existing_parts = false; /** * @var User|null The owner of this storage location */ #[Assert\Expression('this.getOwner() == null or this.getOwner().isAnonymousUser() === false', message: 'validator.part_lot.owner_must_not_be_anonymous')] #[ORM\ManyToOne(targetEntity: User::class)] #[ORM\JoinColumn(name: 'id_owner', onDelete: 'SET NULL')] #[Groups(['location:read', 'location:write'])] protected ?User $owner = null; /** * @var bool If this is set to true, only parts lots, which are owned by the same user as the store location are allowed to be stored here. */ #[ORM\Column(type: Types::BOOLEAN, options: ['default' => false])] #[Groups(['location:read', 'location:write'])] protected bool $part_owner_must_match = false; /** * @var Collection */ #[Assert\Valid] #[ORM\OneToMany(targetEntity: StorageLocationAttachment::class, mappedBy: 'element', cascade: ['persist', 'remove'], orphanRemoval: true)] #[Groups(['location:read', 'location:write'])] protected Collection $attachments; #[ORM\ManyToOne(targetEntity: StorageLocationAttachment::class)] #[ORM\JoinColumn(name: 'id_preview_attachment', onDelete: 'SET NULL')] #[Groups(['location:read', 'location:write'])] protected ?Attachment $master_picture_attachment = null; #[Groups(['location:read'])] protected ?\DateTimeInterface $addedDate = null; #[Groups(['location:read'])] protected ?\DateTimeInterface $lastModified = null; /******************************************************************************** * * Getters * *********************************************************************************/ /** * Get the "is full" attribute. * * When this attribute is set, it is not possible to add additional parts or increase the instock of existing parts. * * @return bool * true if the store location is full * * false if the store location isn't full */ public function isFull(): bool { return $this->is_full; } /** * When this property is set, only one part (but many instock) is allowed to be stored in this store location. */ public function isOnlySinglePart(): bool { return $this->only_single_part; } public function setOnlySinglePart(bool $only_single_part): self { $this->only_single_part = $only_single_part; return $this; } /** * When this property is set, it is only possible to increase the instock of parts, that are already stored here. */ public function isLimitToExistingParts(): bool { return $this->limit_to_existing_parts; } public function setLimitToExistingParts(bool $limit_to_existing_parts): self { $this->limit_to_existing_parts = $limit_to_existing_parts; return $this; } public function getStorageType(): ?MeasurementUnit { return $this->storage_type; } public function setStorageType(?MeasurementUnit $storage_type): self { $this->storage_type = $storage_type; return $this; } /** * Returns the owner of this storage location */ public function getOwner(): ?User { return $this->owner; } /** * Sets the owner of this storage location */ public function setOwner(?User $owner): StorageLocation { $this->owner = $owner; return $this; } /** * If this is set to true, only parts lots, which are owned by the same user as the store location are allowed to be stored here. */ public function isPartOwnerMustMatch(): bool { return $this->part_owner_must_match; } /** * If this is set to true, only parts lots, which are owned by the same user as the store location are allowed to be stored here. */ public function setPartOwnerMustMatch(bool $part_owner_must_match): StorageLocation { $this->part_owner_must_match = $part_owner_must_match; return $this; } /******************************************************************************** * * Setters * *********************************************************************************/ /** * Change the "is full" attribute of this store location. * * "is_full" = true means that there is no more space in this storelocation. * This attribute is only for information, it has no effect. * * @param bool $new_is_full * true means that the storelocation is full * * false means that the storelocation isn't full */ public function setIsFull(bool $new_is_full): self { $this->is_full = $new_is_full; return $this; } public function __construct() { parent::__construct(); $this->children = new ArrayCollection(); $this->parameters = new ArrayCollection(); $this->attachments = new ArrayCollection(); } }