feat: add visibility support to workspaces with domain, DTO, and schema updates

- Introduced `visibility` field to `Workspace` domain, DTO, and database schema
- Added `VisibilityInput` validator with range validation rules
- Updated `WorkspaceHydrator`, `WorkspaceCreator`, and `WorkspaceCreateValidator` to handle `visibility`
- Registered `VisibilityInput` in `ConfigProvider`
- Ensured date tracking with `createdAt` and `updatedAt` fields in relevant components and database schema

Author: BibaltiK

database/migrations/Version20260121203207_CreateWorkspaceTable.php

@@ -19,6 +19,9 @@ public function up(Schema $schema): void
         $table->addColumn('slug', Types::STRING, ['length' => 64,]);
         $table->addColumn('description', Types::STRING, ['length' => 255, 'notnull' => false, 'default' => '']);
         $table->addColumn('details', Types::TEXT, ['notnull' => false, 'default' => '']);
+        $table->addColumn('visibility', Types::SMALLINT, ['unsigned' => true, 'length' => 2, 'default' => 5]);
+        $table->addColumn('createdAt', Types::DATETIME_IMMUTABLE, ['default' => 'CURRENT_TIMESTAMP',]);
+        $table->addColumn('updatedAt', Types::DATETIME_IMMUTABLE, ['default' => 'CURRENT_TIMESTAMP',]);
 
         $table->addPrimaryKeyConstraint(
             PrimaryKeyConstraint::editor()

src/App/Shared/ConfigProvider.php

@@ -6,6 +6,7 @@
 use Laminas\ServiceManager\Factory\InvokableFactory;
 use ownHackathon\Shared\Infrastructure\Service\PaginationTotalPages;
 use ownHackathon\Shared\Middleware\PaginationMiddleware;
+use ownHackathon\Shared\Validator\Input\VisibilityInput;
 
 class ConfigProvider
 {
@@ -30,6 +31,7 @@ public function getDependencies(): array
 
             ],
             'invokables' => [
+                VisibilityInput::class,
             ],
             'factories' => [
                 PaginationMiddleware::class => InvokableFactory::class,

src/App/Shared/Domain/Workspace/WorkspaceInterface.php

@@ -2,6 +2,8 @@
 
 namespace ownHackathon\Shared\Domain\Workspace;
 
+use DateTimeImmutable;
+use Exdrals\Core\Shared\Domain\Enum\Visibility;
 use Ramsey\Uuid\UuidInterface;
 
 interface WorkspaceInterface
@@ -20,5 +22,11 @@ interface WorkspaceInterface
 
     public ?string $details { get; }
 
+    public Visibility $visibility { get; }
+
+    public DateTimeImmutable $createdAt { get; }
+
+    public DateTimeImmutable $updatedAt { get; }
+
     public function with(mixed ...$properties): self;
 }

src/App/Shared/Validator/Input/VisibilityInput.php

@@ -0,0 +1,31 @@
+<?php declare(strict_types=1);
+
+namespace ownHackathon\Shared\Validator\Input;
+
+use Laminas\Filter\Digits;
+use Laminas\Filter\StringTrim;
+use Laminas\InputFilter\Input;
+use Laminas\Validator\NumberComparison;
+
+class VisibilityInput extends Input
+{
+    public function __construct()
+    {
+        parent::__construct('visibility');
+
+        $this->setRequired(true);
+        $this->setFallbackValue(5);
+        $this->setAllowEmpty(false);
+
+        $this->getFilterChain()->attachByName(StringTrim::class);
+        $this->getFilterChain()->attachByName(Digits::class);
+
+        $this->getValidatorChain()->attachByName(
+            NumberComparison::class,
+            [
+                'min' => 1,
+                'max' => 5,
+            ],
+        );
+    }
+}

src/App/Workspace/ConfigProvider.php

@@ -16,6 +16,7 @@
 use ownHackathon\Shared\Infrastructure\Service\PaginationTotalPages;
 use ownHackathon\Shared\Infrastructure\Service\WorkspaceCreatorInterface;
 use ownHackathon\Shared\Middleware\PaginationMiddleware;
+use ownHackathon\Shared\Validator\Input\VisibilityInput;
 use ownHackathon\Workspace\Handler\ListOwnWorkspacesHandler;
 use ownHackathon\Workspace\Handler\WorkspaceCreateHandler;
 use ownHackathon\Workspace\Handler\WorkspaceHandler;
@@ -123,6 +124,7 @@ public function getAbstractFactoryConfig(): array
                 WorkspaceNameInput::class,
                 WorkspaceDescriptionInput::class,
                 WorkspaceDetailsInput::class,
+                VisibilityInput::class,
             ],
             WorkspaceCreateValidatorMiddleware::class => [
                 WorkspaceCreateValidator::class,

src/App/Workspace/DTO/Workspace.php

@@ -9,16 +9,24 @@ public function __construct(
         public string $description,
         public string $owner,
         public string $ownerUuid,
+        public string $details,
+        public int $visibility,
+        public string $createdAt,
+        public string $updatedAt,
     ) {
     }
 
     public static function fromArray(array $data): self
     {
         return new self(
-            $data['name'],
-            $data['description'] ?? '',
-            $data['owner'],
-            $data['ownerUuid']
+            name: $data['name'],
+            description: $data['description'] ?? '',
+            owner: $data['owner'],
+            ownerUuid: $data['ownerUuid'],
+            details: $data['details'],
+            visibility: $data['visibility'],
+            createdAt: $data['createdAt'],
+            updatedAt: $data['updatedAt'],
         );
     }
 }

src/App/Workspace/DTO/WorkspaceRequest.php

@@ -5,7 +5,7 @@
 use Exdrals\Core\Shared\Domain\Enum\DataType;
 use OpenApi\Attributes as OA;
 
-#[OA\Schema(required: ['name'])]
+#[OA\Schema(required: ['name', 'visibility'])]
 readonly class WorkspaceRequest
 {
     public function __construct(
@@ -27,15 +27,22 @@ public function __construct(
             example: 'My own workspace is wonderfully'
         )]
         public ?string $details,
+        #[OA\Property(
+            description: 'The visibility from workspace',
+            type: DataType::INTEGER->value,
+            example: '5'
+        )]
+        public int $visibility
     ) {
     }
 
     public static function fromArray(array $workspace): self
     {
         return new self(
             name: $workspace['name'],
-            description: $workspace['description'],
-            details: $workspace['details'],
+            description: $workspace['description'] ?? null,
+            details: $workspace['details'] ?? null,
+            visibility: (int)$workspace['visibility']
         );
     }
 }

src/App/Workspace/Domain/Workspace.php

@@ -2,6 +2,8 @@
 
 namespace ownHackathon\Workspace\Domain;
 
+use DateTimeImmutable;
+use Exdrals\Core\Shared\Domain\Enum\Visibility;
 use Exdrals\Core\Shared\Trait\CloneReadonlyClassWith;
 use Exdrals\Core\Shared\Utils\Collectible;
 use ownHackathon\Shared\Domain\Workspace\WorkspaceInterface;
@@ -19,6 +21,9 @@ public function __construct(
         public string $slug,
         public ?string $description,
         public ?string $details,
+        public Visibility $visibility,
+        public DateTimeImmutable $createdAt,
+        public DateTimeImmutable $updatedAt,
     ) {
     }
 }

src/App/Workspace/Handler/WorkspaceHandler.php

@@ -2,6 +2,7 @@
 
 namespace ownHackathon\Workspace\Handler;
 
+use Exdrals\Core\Shared\Domain\Enum\DateTimeFormat;
 use Exdrals\Identity\Infrastructure\Persistence\Repository\AccountRepositoryInterface;
 use Fig\Http\Message\StatusCodeInterface as Http;
 use Laminas\Diactoros\Response\JsonResponse;
@@ -32,6 +33,10 @@ public function handle(ServerRequestInterface $request): ResponseInterface
                 'description' => $workspace->description,
                 'owner' => $account->name,
                 'ownerUuid' => $account->uuid->toString(),
+                'details' => $workspace->details,
+                'visibility' => $workspace->visibility->value,
+                'createdAt' => $workspace->createdAt->format(DateTimeFormat::DEFAULT->value),
+                'updatedAt' => $workspace->updatedAt->format(DateTimeFormat::DEFAULT->value),
             ]
         );
 

src/App/Workspace/Infrastructure/Hydrator/WorkspaceHydrator.php

@@ -2,7 +2,10 @@
 
 namespace ownHackathon\Workspace\Infrastructure\Hydrator;
 
+use DateTimeImmutable;
 use Exception;
+use Exdrals\Core\Shared\Domain\Enum\DateTimeFormat;
+use Exdrals\Core\Shared\Domain\Enum\Visibility;
 use Exdrals\Core\Shared\Utils\UuidFactoryInterface;
 use ownHackathon\Shared\Domain\Workspace\WorkspaceCollectionInterface;
 use ownHackathon\Shared\Domain\Workspace\WorkspaceInterface;
@@ -30,6 +33,9 @@ public function hydrate(array $data): WorkspaceInterface
             slug: $data['slug'],
             description: $data['description'],
             details: $data['details'],
+            visibility: Visibility::tryFrom($data['visibility']),
+            createdAt: new DateTimeImmutable($data['createdAt']),
+            updatedAt: new DateTimeImmutable($data['updatedAt']),
         );
     }
 
@@ -57,6 +63,9 @@ public function extract(WorkspaceInterface $object): array
             'slug' => $object->slug,
             'description' => $object->description,
             'details' => $object->details,
+            'visibility' => $object->visibility->value,
+            'createdAt' => $object->createdAt->format(DateTimeFormat::DEFAULT->value),
+            'updatedAt' => $object->updatedAt->format(DateTimeFormat::DEFAULT->value),
         ];
     }