add admin command

backend/app/Console/Commands/EnsureInitialAdminCommand.php

@@ -0,0 +1,36 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\User\InitialAdminCredentialsProvider;
+use App\User\UseCases\EnsureInitialAdmin\EnsureInitialAdmin;
+use App\User\UseCases\EnsureInitialAdmin\EnsureInitialAdminRequest;
+use Illuminate\Console\Command;
+
+class EnsureInitialAdminCommand extends Command
+{
+    protected $signature = 'rabbi-gerzi:ensure-initial-admin';
+
+    protected $description = 'Create the configured initial admin if missing';
+
+    public function __construct(
+        private EnsureInitialAdmin $ensureInitialAdmin,
+        private InitialAdminCredentialsProvider $credentialsProvider,
+    ) {
+        parent::__construct();
+    }
+
+    public function handle(): int
+    {
+        $credentials = $this->credentialsProvider->getCredentials();
+
+        $this->ensureInitialAdmin->execute(new EnsureInitialAdminRequest(
+            email: $credentials->getEmail(),
+            password: $credentials->getPassword(),
+        ));
+
+        $this->info('initial admin is ready');
+
+        return self::SUCCESS;
+    }
+}

backend/app/Providers/AppServiceProvider.php

@@ -11,6 +11,8 @@ use App\Auth\SystemClock;
 use App\Auth\TokenGenerator;
 use App\Shared\Files\Filesystem;
 use App\Shared\Files\LaravelFilesystem;
+use App\User\EnvironmentInitialAdminCredentialsProvider;
+use App\User\InitialAdminCredentialsProvider;
 use Illuminate\Support\ServiceProvider;
 
 class AppServiceProvider extends ServiceProvider
@@ -33,6 +35,10 @@ class AppServiceProvider extends ServiceProvider
             Filesystem::class,
             LaravelFilesystem::class,
         );
+        $this->app->bind(
+            InitialAdminCredentialsProvider::class,
+            EnvironmentInitialAdminCredentialsProvider::class,
+        );
         $this->app->bind(
             AuthCookieSettings::class,
             function (): AuthCookieSettings {

backend/app/User/EnvironmentInitialAdminCredentialsProvider.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\User;
+
+use RuntimeException;
+
+class EnvironmentInitialAdminCredentialsProvider implements
+    InitialAdminCredentialsProvider
+{
+    public function getCredentials(): InitialAdminCredentials
+    {
+        return new InitialAdminCredentials(
+            email: $this->requiredEnvironmentValue(
+                'RABBI_GERZI_INITIAL_ADMIN_EMAIL',
+            ),
+            password: $this->requiredEnvironmentValue(
+                'RABBI_GERZI_INITIAL_ADMIN_PASSWORD',
+            ),
+        );
+    }
+
+    private function requiredEnvironmentValue(string $key): string
+    {
+        $value = getenv($key);
+        if (! is_string($value) || trim($value) === '') {
+            throw new RuntimeException("$key is required");
+        }
+
+        return $value;
+    }
+}

backend/app/User/InitialAdminCredentials.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\User;
+
+class InitialAdminCredentials
+{
+    public function __construct(
+        private string $email,
+        private string $password,
+    ) {
+    }
+
+    public function getEmail(): string
+    {
+        return $this->email;
+    }
+
+    public function getPassword(): string
+    {
+        return $this->password;
+    }
+}

backend/app/User/InitialAdminCredentialsProvider.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace App\User;
+
+interface InitialAdminCredentialsProvider
+{
+    public function getCredentials(): InitialAdminCredentials;
+}

backend/bootstrap/app.php

@@ -1,5 +1,6 @@
 <?php
 
+use App\Console\Commands\EnsureInitialAdminCommand;
 use Illuminate\Foundation\Application;
 use Illuminate\Foundation\Configuration\Exceptions;
 use Illuminate\Foundation\Configuration\Middleware;
@@ -10,6 +11,9 @@ return Application::configure(basePath: dirname(__DIR__))
         commands: __DIR__ . '/../routes/console.php',
         health: '/up',
     )
+    ->withCommands([
+        EnsureInitialAdminCommand::class,
+    ])
     ->withMiddleware(function (Middleware $middleware): void {
         //
     })

backend/tests/Unit/User/UseCases/EnsureInitialAdminCommandTest.php

@@ -7,6 +7,7 @@ use App\Shared\ValueObject\EmailAddress;
 use App\User\InitialAdminCredentials;
 use App\User\InitialAdminCredentialsProvider;
 use App\User\UseCases\EnsureInitialAdmin\EnsureInitialAdmin;
+use Illuminate\Container\Container;
 use Symfony\Component\Console\Tester\CommandTester;
 use Tests\Fakes\FakeHasher;
 use Tests\Fakes\FakeUserRepository;
@@ -25,6 +26,7 @@ class EnsureInitialAdminCommandTest extends TestCase
                 'secret-password',
             ),
         );
+        $command->setLaravel($this->consoleContainer());
 
         $commandTester = new CommandTester($command);
         $statusCode = $commandTester->execute([]);
@@ -67,4 +69,15 @@ class EnsureInitialAdminCommandTest extends TestCase
             }
         };
     }
+
+    private function consoleContainer(): Container
+    {
+        return new class extends Container
+        {
+            public function runningUnitTests(): bool
+            {
+                return true;
+            }
+        };
+    }
 }