Allow editing of Order questions (#398)

* Allow editing of Order questions

* Update designs

Author: daveearley

backend/app/DomainObjects/Enums/QuestionTypeEnum.php

@@ -16,4 +16,12 @@ enum QuestionTypeEnum
     case DROPDOWN;
     case MULTI_SELECT_DROPDOWN;
     case DATE;
+
+    public static function getMultipleChoiceTypes(): array
+    {
+        return [
+            self::CHECKBOX,
+            self::MULTI_SELECT_DROPDOWN,
+        ];
+    }
 }

backend/app/DomainObjects/QuestionAndAnswerViewDomainObject.php

@@ -15,13 +15,18 @@ class QuestionAndAnswerViewDomainObject extends AbstractDomainObject
     private int $question_id;
     private ?int $order_id;
     private string $title;
+    private bool $question_required;
+    private ?string $question_description = null;
     private ?string $first_name = null;
     private ?string $last_name = null;
     private array|string $answer;
     private string $belongs_to;
     private ?int $attendee_id = null;
+    private ?string $attendee_public_id = null;
     private string $question_type;
     private int $event_id;
+    private int $question_answer_id;
+    private ?array $question_options = null;
 
     private ?AttendeeDomainObject $attendee = null;
 
@@ -183,19 +188,86 @@ public function setQuestion(?QuestionDomainObject $question): static
         return $this;
     }
 
+    public function getQuestionAnswerId(): int
+    {
+        return $this->question_answer_id;
+    }
+
+    public function setQuestionAnswerId(int $question_answer_id): QuestionAndAnswerViewDomainObject
+    {
+        $this->question_answer_id = $question_answer_id;
+
+        return $this;
+    }
+
+    public function getQuestionDescription(): ?string
+    {
+        return $this->question_description;
+    }
+
+    public function setQuestionDescription(?string $question_description): QuestionAndAnswerViewDomainObject
+    {
+        $this->question_description = $question_description;
+
+        return $this;
+    }
+
+    public function getQuestionRequired(): bool
+    {
+        return $this->question_required;
+    }
+
+    public function setQuestionRequired(bool $question_required): QuestionAndAnswerViewDomainObject
+    {
+        $this->question_required = $question_required;
+
+        return $this;
+    }
+
+    public function getQuestionOptions(): ?array
+    {
+        return $this->question_options;
+    }
+
+    public function setQuestionOptions(?array $question_options): QuestionAndAnswerViewDomainObject
+    {
+        $this->question_options = $question_options;
+
+        return $this;
+    }
+
+    public function getAttendeePublicId(): ?string
+    {
+        return $this->attendee_public_id;
+    }
+
+    public function setAttendeePublicId(?string $attendee_public_id): QuestionAndAnswerViewDomainObject
+    {
+        $this->attendee_public_id = $attendee_public_id;
+
+        return $this;
+    }
+
     public function toArray(): array
     {
         return [
             'question_id' => $this->question_id ?? null,
             'order_id' => $this->order_id ?? null,
             'title' => $this->title ?? null,
+            'question_description' => $this->question_description ?? null,
+            'question_required' => $this->question_required ?? null,
             'last_name' => $this->last_name ?? null,
             'answer' => $this->answer ?? null,
             'belongs_to' => $this->belongs_to ?? null,
             'attendee_id' => $this->attendee_id ?? null,
+            'attendee_public_id' => $this->attendee_public_id ?? null,
             'question_type' => $this->question_type ?? null,
             'first_name' => $this->first_name ?? null,
             'event_id' => $this->event_id ?? null,
+            'product_id' => $this->product_id ?? null,
+            'product_title' => $this->product_title ?? null,
+            'question_answer_id' => $this->question_answer_id ?? null,
+            'question_options' => $this->question_options ?? null,
         ];
     }
 }

backend/app/DomainObjects/QuestionAnswerDomainObject.php

@@ -2,6 +2,35 @@
 
 namespace HiEvents\DomainObjects;
 
+use HiEvents\DomainObjects\Generated\OrderDomainObjectAbstract;
+
 class QuestionAnswerDomainObject extends Generated\QuestionAnswerDomainObjectAbstract
 {
+    private ?OrderDomainObjectAbstract $order = null;
+
+    private ?QuestionDomainObject $question = null;
+
+    public function setOrder(?OrderDomainObjectAbstract $order): QuestionAnswerDomainObject
+    {
+        $this->order = $order;
+
+        return $this;
+    }
+
+    public function getOrder(): ?OrderDomainObjectAbstract
+    {
+        return $this->order;
+    }
+
+    public function setQuestion(?QuestionDomainObject $question): QuestionAnswerDomainObject
+    {
+        $this->question = $question;
+
+        return $this;
+    }
+
+    public function getQuestion(): ?QuestionDomainObject
+    {
+        return $this->question;
+    }
 }

backend/app/DomainObjects/QuestionDomainObject.php

@@ -40,4 +40,20 @@ public function setOptions(array|string|null $options): self
         return $this;
     }
 
+    public function isAnswerValid(mixed $answer): bool
+    {
+        if (!isset($answer)) {
+            return false;
+        }
+
+        if (!$this->isPreDefinedChoice()) {
+            return true;
+        }
+
+        if (is_string($answer)) {
+            return in_array($answer, $this->getOptions(), true);
+        }
+
+        return array_diff((array)$answer, $this->getOptions()) === [];
+    }
 }

backend/app/Http/Actions/Orders/GetOrderAction.php

@@ -7,6 +7,8 @@
 use HiEvents\DomainObjects\OrderItemDomainObject;
 use HiEvents\DomainObjects\QuestionAndAnswerViewDomainObject;
 use HiEvents\Http\Actions\BaseAction;
+use HiEvents\Repository\Eloquent\Value\OrderAndDirection;
+use HiEvents\Repository\Eloquent\Value\Relationship;
 use HiEvents\Repository\Interfaces\OrderRepositoryInterface;
 use HiEvents\Resources\Order\OrderResource;
 use Illuminate\Http\JsonResponse;
@@ -27,7 +29,9 @@ public function __invoke(int $eventId, int $orderId): JsonResponse
         $order = $this->orderRepository
             ->loadRelation(OrderItemDomainObject::class)
             ->loadRelation(AttendeeDomainObject::class)
-            ->loadRelation(QuestionAndAnswerViewDomainObject::class)
+            ->loadRelation(new Relationship(domainObject: QuestionAndAnswerViewDomainObject::class, orderAndDirections: [
+                new OrderAndDirection(order: 'question_id'),
+            ]))
             ->findById($orderId);
 
         return $this->resourceResponse(OrderResource::class, $order);

backend/app/Http/Actions/Questions/EditQuestionAnswerAction.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace HiEvents\Http\Actions\Questions;
+
+use HiEvents\DomainObjects\EventDomainObject;
+use HiEvents\Http\Actions\BaseAction;
+use HiEvents\Http\Request\Questions\EditQuestionAnswerRequest;
+use HiEvents\Services\Application\Handlers\Question\DTO\EditQuestionAnswerDTO;
+use HiEvents\Services\Application\Handlers\Question\EditQuestionAnswerHandler;
+use HiEvents\Services\Domain\Question\Exception\InvalidAnswerException;
+use Illuminate\Http\Response;
+use Illuminate\Validation\ValidationException;
+
+class EditQuestionAnswerAction extends BaseAction
+{
+    public function __construct(
+        private readonly EditQuestionAnswerHandler $editQuestionAnswerHandler,
+    )
+    {
+    }
+
+    public function __invoke(
+        int                       $eventId,
+        int                       $questionId,
+        int                       $questionAnswerId,
+        EditQuestionAnswerRequest $request,
+    ): Response
+    {
+        $this->isActionAuthorized($eventId, EventDomainObject::class);
+
+        try {
+            $this->editQuestionAnswerHandler->handle(new EditQuestionAnswerDTO(
+                questionAnswerId: $questionAnswerId,
+                eventId: $eventId,
+                answer: $request->validated('answer'),
+            ));
+        } catch (InvalidAnswerException $e) {
+            throw ValidationException::withMessages(['answer.answer' => $e->getMessage()]);
+        }
+
+        return $this->noContentResponse();
+    }
+}

backend/app/Http/Request/Questions/EditQuestionAnswerRequest.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace HiEvents\Http\Request\Questions;
+
+use HiEvents\Http\Request\BaseRequest;
+
+class EditQuestionAnswerRequest extends BaseRequest
+{
+    public function rules(): array
+    {
+        return [
+            'answer' => [
+                'nullable',
+                function ($attribute, $value, $fail) {
+                    if (!is_string($value) && !is_array($value)) {
+                        $fail("The {$attribute} must be a string or an array.");
+                    }
+                }
+            ],
+        ];
+    }
+}

backend/app/Models/QuestionAndAnswerView.php

@@ -14,6 +14,7 @@ class QuestionAndAnswerView extends Model
 
     protected $casts = [
         'answer' => 'array',
+        'question_options' => 'array',
     ];
 
     public function attendee(): BelongsTo

backend/app/Models/QuestionAnswer.php

@@ -3,6 +3,7 @@
 namespace HiEvents\Models;
 
 use HiEvents\DomainObjects\Generated\QuestionAnswerDomainObjectAbstract;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
 
 class QuestionAnswer extends BaseModel
 {
@@ -23,4 +24,14 @@ protected function getFillableFields(): array
             QuestionAnswerDomainObjectAbstract::ANSWER,
         ];
     }
+
+    public function order(): BelongsTo
+    {
+        return $this->belongsTo(Order::class);
+    }
+
+    public function question(): BelongsTo
+    {
+        return $this->belongsTo(Question::class);
+    }
 }

backend/app/Repository/Interfaces/RepositoryInterface.php

@@ -5,6 +5,7 @@
 use Exception;
 use HiEvents\DomainObjects\Interfaces\DomainObjectInterface;
 use HiEvents\Repository\Eloquent\Value\OrderAndDirection;
+use HiEvents\Repository\Eloquent\Value\Relationship;
 use Illuminate\Contracts\Pagination\Paginator;
 use Illuminate\Database\Eloquent\Relations\Relation;
 use Illuminate\Pagination\LengthAwarePaginator;
@@ -198,4 +199,6 @@ public function decrementEach(array $where, array $columns, array $extra = []):
     public function incrementEach(array $columns, array $additionalUpdates = [], ?array $where = null);
 
     public function includeDeleted(): static;
+
+    public function loadRelation(string|Relationship $relationship): static;
 }