Merge pull request #339 from dotkernel/issue-325

Issue #325: Implemented enums in database

Author: arhimede

config/autoload/doctrine.global.php

@@ -2,7 +2,10 @@
 
 declare(strict_types=1);
 
+use Api\Admin\DBAL\Types\AdminStatusEnumType;
 use Api\App\Entity\EntityListenerResolver;
+use Api\User\DBAL\Types\UserResetPasswordStatusEnumType;
+use Api\User\DBAL\Types\UserStatusEnumType;
 use Doctrine\Persistence\Mapping\Driver\MappingDriverChain;
 use Dot\Cache\Adapter\ArrayAdapter;
 use Dot\Cache\Adapter\FilesystemAdapter;
@@ -27,9 +30,12 @@
             ],
         ],
         'types'         => [
-            UuidType::NAME                  => UuidType::class,
-            UuidBinaryType::NAME            => UuidBinaryType::class,
-            UuidBinaryOrderedTimeType::NAME => UuidBinaryOrderedTimeType::class,
+            UuidType::NAME                        => UuidType::class,
+            UuidBinaryType::NAME                  => UuidBinaryType::class,
+            UuidBinaryOrderedTimeType::NAME       => UuidBinaryOrderedTimeType::class,
+            AdminStatusEnumType::NAME             => AdminStatusEnumType::class,
+            UserStatusEnumType::NAME              => UserStatusEnumType::class,
+            UserResetPasswordStatusEnumType::NAME => UserResetPasswordStatusEnumType::class,
         ],
         'fixtures'      => getcwd() . '/data/doctrine/fixtures',
         'configuration' => [

data/doctrine/fixtures/AdminLoader.php

@@ -6,37 +6,35 @@
 
 use Api\Admin\Entity\Admin;
 use Api\Admin\Entity\AdminRole;
-use Api\User\Entity\User;
+use Api\Admin\Enum\AdminStatusEnum;
 use Doctrine\Common\DataFixtures\DependentFixtureInterface;
 use Doctrine\Common\DataFixtures\FixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 
-/**
- * Class AdminLoader
- * @package Api\Fixtures
- */
+use function assert;
+
 class AdminLoader implements FixtureInterface, DependentFixtureInterface
 {
     public function load(ObjectManager $manager): void
     {
         $adminRoleRepository = $manager->getRepository(AdminRole::class);
 
-        /** @var AdminRole $adminRole */
         $adminRole = $adminRoleRepository->findOneBy([
             'name' => AdminRole::ROLE_ADMIN,
         ]);
+        assert($adminRole instanceof AdminRole);
 
-        /** @var AdminRole $superUserRole */
         $superUserRole = $adminRoleRepository->findOneBy([
             'name' => AdminRole::ROLE_SUPERUSER,
         ]);
+        assert($superUserRole instanceof AdminRole);
 
         $admin = (new Admin())
             ->setIdentity('admin')
             ->usePassword('dotkernel')
             ->setFirstName('DotKernel')
             ->setLastName('Admin')
-            ->setStatus(User::STATUS_ACTIVE)
+            ->setStatus(AdminStatusEnum::Active)
             ->addRole($adminRole)
             ->addRole($superUserRole);
 

data/doctrine/fixtures/AdminRoleLoader.php

@@ -8,10 +8,6 @@
 use Doctrine\Common\DataFixtures\FixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 
-/**
- * Class AdminRoleLoader
- * @package Api\Fixtures
- */
 class AdminRoleLoader implements FixtureInterface
 {
     public function load(ObjectManager $manager): void

data/doctrine/fixtures/OAuthClientLoader.php

@@ -9,10 +9,6 @@
 use Doctrine\Common\DataFixtures\FixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 
-/**
- * Class OAuthClientLoader
- * @package Api\Fixtures
- */
 class OAuthClientLoader extends AbstractFixture implements FixtureInterface
 {
     public function load(ObjectManager $manager): void

data/doctrine/fixtures/OAuthScopeLoader.php

@@ -8,10 +8,6 @@
 use Doctrine\Common\DataFixtures\FixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 
-/**
- * Class OAuthScopeLoader
- * @package Api\Fixtures
- */
 class OAuthScopeLoader implements FixtureInterface
 {
     public function load(ObjectManager $manager): void

data/doctrine/fixtures/UserLoader.php

@@ -7,34 +7,33 @@
 use Api\User\Entity\User;
 use Api\User\Entity\UserDetail;
 use Api\User\Entity\UserRole;
+use Api\User\Enum\UserStatusEnum;
 use Doctrine\Common\DataFixtures\DependentFixtureInterface;
 use Doctrine\Common\DataFixtures\FixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 
-/**
- * Class UserLoader
- * @package Api\Fixtures
- */
+use function assert;
+
 class UserLoader implements FixtureInterface, DependentFixtureInterface
 {
     public function load(ObjectManager $manager): void
     {
         $userRoleRepository = $manager->getRepository(UserRole::class);
 
-        /** @var UserRole $guestRole */
         $guestRole = $userRoleRepository->findOneBy([
             'name' => UserRole::ROLE_GUEST,
         ]);
+        assert($guestRole instanceof UserRole);
 
-        /** @var UserRole $userRole */
         $userRole = $userRoleRepository->findOneBy([
             'name' => UserRole::ROLE_USER,
         ]);
+        assert($userRole instanceof UserRole);
 
         $user = (new User())
             ->setIdentity('[email protected]')
             ->usePassword('dotkernel')
-            ->setStatus(User::STATUS_ACTIVE)
+            ->setStatus(UserStatusEnum::Active)
             ->setIsDeleted(false)
             ->setHash(User::generateHash())
             ->addRole($guestRole)

data/doctrine/fixtures/UserRoleLoader.php

@@ -8,10 +8,6 @@
 use Doctrine\Common\DataFixtures\FixtureInterface;
 use Doctrine\Persistence\ObjectManager;
 
-/**
- * Class UserRoleLoader
- * @package Api\Fixtures
- */
 class UserRoleLoader implements FixtureInterface
 {
     public function load(ObjectManager $manager): void

data/doctrine/migrations/Version20240613153602.php renamed to data/doctrine/migrations/Version20241030082958.php

@@ -10,7 +10,7 @@
 /**
  * Auto-generated Migration: Please modify to your needs!
  */
-final class Version20240613153602 extends AbstractMigration
+final class Version20241030082958 extends AbstractMigration
 {
     public function getDescription(): string
     {
@@ -20,7 +20,7 @@ public function getDescription(): string
     public function up(Schema $schema): void
     {
         // this up() migration is auto-generated, please modify it to your needs
-        $this->addSql('CREATE TABLE admin (uuid BINARY(16) NOT NULL, identity VARCHAR(100) NOT NULL, firstName VARCHAR(191) NOT NULL, lastName VARCHAR(191) NOT NULL, password VARCHAR(100) NOT NULL, status VARCHAR(20) NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, UNIQUE INDEX UNIQ_880E0D766A95E9C4 (identity), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
+        $this->addSql('CREATE TABLE admin (uuid BINARY(16) NOT NULL, identity VARCHAR(100) NOT NULL, firstName VARCHAR(191) NOT NULL, lastName VARCHAR(191) NOT NULL, password VARCHAR(100) NOT NULL, status ENUM(\'active\', \'inactive\') DEFAULT \'active\' NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, UNIQUE INDEX UNIQ_880E0D766A95E9C4 (identity), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE admin_roles (userUuid BINARY(16) NOT NULL, roleUuid BINARY(16) NOT NULL, INDEX IDX_1614D53DD73087E9 (userUuid), INDEX IDX_1614D53D88446210 (roleUuid), PRIMARY KEY(userUuid, roleUuid)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE admin_role (uuid BINARY(16) NOT NULL, name VARCHAR(30) NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, UNIQUE INDEX UNIQ_7770088A5E237E06 (name), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE oauth_access_tokens (id INT UNSIGNED AUTO_INCREMENT NOT NULL, user_id VARCHAR(25) DEFAULT NULL, token VARCHAR(100) NOT NULL, revoked TINYINT(1) DEFAULT 0 NOT NULL, expires_at DATETIME NOT NULL, client_id INT UNSIGNED DEFAULT NULL, INDEX IDX_CA42527C19EB6921 (client_id), PRIMARY KEY(id)) DEFAULT CHARACTER SET utf8mb4');
@@ -30,11 +30,11 @@ public function up(Schema $schema): void
         $this->addSql('CREATE TABLE oauth_clients (id INT UNSIGNED AUTO_INCREMENT NOT NULL, name VARCHAR(40) NOT NULL, secret VARCHAR(100) DEFAULT NULL, redirect VARCHAR(191) NOT NULL, revoked TINYINT(1) DEFAULT 0 NOT NULL, isConfidential TINYINT(1) DEFAULT 0 NOT NULL, user_id BINARY(16) DEFAULT NULL, INDEX IDX_13CE8101A76ED395 (user_id), PRIMARY KEY(id)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE oauth_refresh_tokens (id INT UNSIGNED AUTO_INCREMENT NOT NULL, revoked TINYINT(1) DEFAULT 0 NOT NULL, expires_at DATETIME NOT NULL, access_token_id INT UNSIGNED DEFAULT NULL, INDEX IDX_5AB6872CCB2688 (access_token_id), PRIMARY KEY(id)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE oauth_scopes (id INT UNSIGNED AUTO_INCREMENT NOT NULL, scope VARCHAR(191) NOT NULL, PRIMARY KEY(id)) DEFAULT CHARACTER SET utf8mb4');
-        $this->addSql('CREATE TABLE user (uuid BINARY(16) NOT NULL, identity VARCHAR(191) NOT NULL, password VARCHAR(191) NOT NULL, status VARCHAR(20) NOT NULL, isDeleted TINYINT(1) NOT NULL, hash VARCHAR(64) NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, UNIQUE INDEX UNIQ_8D93D6496A95E9C4 (identity), UNIQUE INDEX UNIQ_8D93D649D1B862B8 (hash), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
+        $this->addSql('CREATE TABLE user (uuid BINARY(16) NOT NULL, identity VARCHAR(191) NOT NULL, password VARCHAR(191) NOT NULL, status ENUM(\'active\', \'pending\') DEFAULT \'pending\' NOT NULL, isDeleted TINYINT(1) NOT NULL, hash VARCHAR(64) NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, UNIQUE INDEX UNIQ_8D93D6496A95E9C4 (identity), UNIQUE INDEX UNIQ_8D93D649D1B862B8 (hash), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE user_roles (userUuid BINARY(16) NOT NULL, roleUuid BINARY(16) NOT NULL, INDEX IDX_54FCD59FD73087E9 (userUuid), INDEX IDX_54FCD59F88446210 (roleUuid), PRIMARY KEY(userUuid, roleUuid)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE user_avatar (uuid BINARY(16) NOT NULL, name VARCHAR(191) NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, userUuid BINARY(16) DEFAULT NULL, UNIQUE INDEX UNIQ_73256912D73087E9 (userUuid), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE user_detail (uuid BINARY(16) NOT NULL, firstName VARCHAR(191) DEFAULT NULL, lastName VARCHAR(191) DEFAULT NULL, email VARCHAR(191) NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, userUuid BINARY(16) DEFAULT NULL, UNIQUE INDEX UNIQ_4B5464AED73087E9 (userUuid), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
-        $this->addSql('CREATE TABLE user_reset_password (uuid BINARY(16) NOT NULL, expires DATETIME NOT NULL, hash VARCHAR(64) NOT NULL, status VARCHAR(20) NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, userUuid BINARY(16) DEFAULT NULL, UNIQUE INDEX UNIQ_D21DE3BCD1B862B8 (hash), INDEX IDX_D21DE3BCD73087E9 (userUuid), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
+        $this->addSql('CREATE TABLE user_reset_password (uuid BINARY(16) NOT NULL, expires DATETIME NOT NULL, hash VARCHAR(64) NOT NULL, status ENUM(\'completed\', \'requested\') DEFAULT \'requested\' NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, userUuid BINARY(16) DEFAULT NULL, UNIQUE INDEX UNIQ_D21DE3BCD1B862B8 (hash), INDEX IDX_D21DE3BCD73087E9 (userUuid), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('CREATE TABLE user_role (uuid BINARY(16) NOT NULL, name VARCHAR(20) NOT NULL, created DATETIME NOT NULL, updated DATETIME DEFAULT NULL, UNIQUE INDEX UNIQ_2DE8C6A35E237E06 (name), PRIMARY KEY(uuid)) DEFAULT CHARACTER SET utf8mb4');
         $this->addSql('ALTER TABLE admin_roles ADD CONSTRAINT FK_1614D53DD73087E9 FOREIGN KEY (userUuid) REFERENCES admin (uuid)');
         $this->addSql('ALTER TABLE admin_roles ADD CONSTRAINT FK_1614D53D88446210 FOREIGN KEY (roleUuid) REFERENCES admin_role (uuid)');

src/Admin/src/DBAL/Types/AdminStatusEnumType.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Api\Admin\DBAL\Types;
+
+use Api\Admin\Enum\AdminStatusEnum;
+use Api\App\DBAL\Types\AbstractEnumType;
+
+class AdminStatusEnumType extends AbstractEnumType
+{
+    public const NAME = 'admin_status_enum';
+
+    protected function getEnumClass(): string
+    {
+        return AdminStatusEnum::class;
+    }
+
+    public function getName(): string
+    {
+        return self::NAME;
+    }
+}

src/Admin/src/Entity/Admin.php

@@ -4,6 +4,7 @@
 
 namespace Api\Admin\Entity;
 
+use Api\Admin\Enum\AdminStatusEnum;
 use Api\Admin\Repository\AdminRepository;
 use Api\App\Entity\AbstractEntity;
 use Api\App\Entity\PasswordTrait;
@@ -22,13 +23,6 @@ class Admin extends AbstractEntity implements UserEntityInterface
     use PasswordTrait;
     use TimestampsTrait;
 
-    public const STATUS_ACTIVE   = 'active';
-    public const STATUS_INACTIVE = 'inactive';
-    public const STATUSES        = [
-        self::STATUS_ACTIVE,
-        self::STATUS_INACTIVE,
-    ];
-
     #[ORM\Column(name: "identity", type: "string", length: 100, unique: true)]
     protected string $identity = '';
 
@@ -41,8 +35,8 @@ class Admin extends AbstractEntity implements UserEntityInterface
     #[ORM\Column(name: "password", type: "string", length: 100)]
     protected string $password = '';
 
-    #[ORM\Column(name: "status", type: "string", length: 20)]
-    protected string $status = self::STATUS_ACTIVE;
+    #[ORM\Column(type: 'admin_status_enum', options: ['default' => AdminStatusEnum::Active])]
+    protected AdminStatusEnum $status = AdminStatusEnum::Active;
 
     #[ORM\ManyToMany(targetEntity: AdminRole::class)]
     #[ORM\JoinTable(name: "admin_roles")]
@@ -122,12 +116,12 @@ public function setPassword(string $password): self
         return $this;
     }
 
-    public function getStatus(): string
+    public function getStatus(): AdminStatusEnum
     {
         return $this->status;
     }
 
-    public function setStatus(string $status): self
+    public function setStatus(AdminStatusEnum $status): self
     {
         $this->status = $status;
 
@@ -178,21 +172,21 @@ public function hasRoles(): bool
 
     public function activate(): self
     {
-        $this->status = self::STATUS_ACTIVE;
+        $this->status = AdminStatusEnum::Active;
 
         return $this;
     }
 
     public function deactivate(): self
     {
-        $this->status = self::STATUS_INACTIVE;
+        $this->status = AdminStatusEnum::Inactive;
 
         return $this;
     }
 
     public function isActive(): bool
     {
-        return $this->status === self::STATUS_ACTIVE;
+        return $this->status === AdminStatusEnum::Active;
     }
 
     public function getIdentifier(): string