feat: implement Login API across all layers / ユーザーログインAPIの全層実装

.github/workflows/static_analysis.yml

@@ -0,0 +1,41 @@
+name: Static Analysis
+
+on:
+  pull_request:
+    types: [opened, synchronize]
+    paths:
+      - "src/**/*.php"
+  workflow_dispatch: {}
+
+jobs:
+  mago:
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: "8.2"
+          coverage: none
+          tools: composer
+
+      - name: Cache Composer dependencies
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/composer
+          key: ${{ runner.os }}-composer-${{ hashFiles('src/composer.lock') }}
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-progress
+        working-directory: ./src
+
+      - name: Setup Mago
+        uses: nhedger/setup-mago@v1
+
+      - name: Run Mago lint
+        run: ./vendor/bin/mago lint
+        working-directory: ./src

src/.gitignore

@@ -1,4 +1,5 @@
 /.phpunit.cache
+/.composer
 /node_modules
 /public/build
 /public/hot

src/app/Models/User.php

@@ -3,9 +3,11 @@
 namespace App\Models;
 
 use Illuminate\Foundation\Auth\User as Authenticatable;
+use Laravel\Sanctum\HasApiTokens;
 
 class User extends Authenticatable
 {
+    use HasApiTokens;
     protected $table = 'users';
 
     protected $fillable = [

src/app/Packages/Domains/User/Factory/UserEntityFactory.php

@@ -5,6 +5,7 @@
 use App\Packages\Domains\User\Factory\SubscriptionFactory;
 use App\Packages\Domains\User\UserEntity;
 use App\Packages\Domains\User\AgeRange;
+use App\Packages\Domains\User\ValueObject\Email;
 
 final class UserEntityFactory
 {
@@ -20,7 +21,7 @@ public static function build(array $data): UserEntity
             id: isset($data['id']) ? (int) $data['id'] : null,
             firstName: $data['first_name'],
             lastName: $data['last_name'],
-            email: $data['email'],
+            email: new Email($data['email']),
             ageRange: AgeRange::from($data['age_range']),
             subscription: $subscription,
             passwordHash: $data['password_hash'] ?? null,

src/app/Packages/Domains/User/Interface/TokenServiceInterface.php

@@ -0,0 +1,12 @@
+<?php
+
+namespace App\Packages\Domains\User\Interface;
+
+use App\Packages\Domains\User\UserEntity;
+
+interface TokenServiceInterface
+{
+    public function createToken(UserEntity $entity): string;
+
+    public function revokeAllTokens(UserEntity $entity): void;
+}

src/app/Packages/Domains/User/Interface/UserRepositroyInterface.php

@@ -4,6 +4,7 @@
 
 use App\Packages\Domains\User\UserEntity;
 use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
+use App\Packages\Domains\User\ValueObject\Email;
 
 interface UserRepositroyInterface
 {
@@ -14,4 +15,6 @@ public function findById(int $id): ?UserDto;
     public function updateUser(UserEntity $entity): UserDto;
 
     public function deleteUser(int $id): void;
+
+    public function findByEmail(Email $email): ?UserEntity;
 }

src/app/Packages/Domains/User/Service/SanctumTokenService.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Packages\Domains\User\Service;
+
+use App\Models\User;
+use App\Packages\Domains\User\Interface\TokenServiceInterface;
+use App\Packages\Domains\User\UserEntity;
+use RuntimeException;
+
+class SanctumTokenService implements TokenServiceInterface
+{
+    public function createToken(UserEntity $entity): string
+    {
+        $user = User::find($entity->getId());
+
+        if ($user === null) {
+            throw new RuntimeException('User not found.');
+        }
+
+        return $user->createToken('auth-token')->plainTextToken;
+    }
+
+    public function revokeAllTokens(UserEntity $entity): void
+    {
+        $user = User::find($entity->getId());
+
+        if ($user === null) {
+            throw new RuntimeException('User not found.');
+        }
+
+        $user->tokens()->delete();
+    }
+}

src/app/Packages/Domains/User/Tests/Factory/UserEntityFactoryTest.php

@@ -30,7 +30,7 @@ public function test_build_returns_user_entity_with_correct_values(): void
         $this->assertSame($data['id'], $entity->getId());
         $this->assertSame($data['first_name'], $entity->getFirstName());
         $this->assertSame($data['last_name'], $entity->getLastName());
-        $this->assertSame($data['email'], $entity->getEmail());
+        $this->assertSame($data['email'], $entity->getEmail()->value());
         $this->assertSame(AgeRange::Teens, $entity->getAgeRange());
         $this->assertTrue($entity->getSubscription()->isFree());
         $this->assertNull($entity->getPasswordHash());

src/app/Packages/Domains/User/Tests/Service/SanctumTokenServiceTest.php

@@ -0,0 +1,136 @@
+<?php
+
+namespace App\Packages\Domains\User\Tests\Service;
+
+use App\Models\User;
+use App\Packages\Domains\User\Factory\UserEntityFactory;
+use App\Packages\Domains\User\Service\SanctumTokenService;
+use App\Packages\Domains\User\UserEntity;
+use Faker\Factory as FakerFactory;
+use Illuminate\Support\Facades\DB;
+use Tests\TestCase;
+
+class SanctumTokenServiceTest extends TestCase
+{
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $this->truncate();
+    }
+
+    protected function tearDown(): void
+    {
+        $this->truncate();
+        parent::tearDown();
+    }
+
+    private function truncate(): void
+    {
+        if (env('APP_ENV') === 'testing') {
+            DB::connection('mysql')->statement('SET FOREIGN_KEY_CHECKS=0;');
+            DB::connection('mysql')->table('personal_access_tokens')->truncate();
+            User::truncate();
+            DB::connection('mysql')->statement('SET FOREIGN_KEY_CHECKS=1;');
+        }
+    }
+
+    private function service(): SanctumTokenService
+    {
+        return new SanctumTokenService();
+    }
+
+    private function seedUser(array $overrides = []): User
+    {
+        $faker = FakerFactory::create();
+
+        return User::create(array_merge([
+            'first_name'              => $faker->firstName(),
+            'last_name'               => $faker->lastName(),
+            'email'                   => $faker->unique()->safeEmail(),
+            'password'                => bcrypt('password'),
+            'age_range'               => 'teens',
+            'subscription_tier'       => 'free',
+            'subscription_expires_at' => null,
+        ], $overrides));
+    }
+
+    private function buildEntityFromUser(User $user): UserEntity
+    {
+        return UserEntityFactory::build([
+            'id'                      => $user->id,
+            'first_name'              => $user->first_name,
+            'last_name'               => $user->last_name,
+            'email'                   => $user->email,
+            'age_range'               => $user->age_range,
+            'subscription_tier'       => $user->subscription_tier,
+            'subscription_expires_at' => $user->subscription_expires_at,
+            'password_hash'           => $user->password,
+        ]);
+    }
+
+    public function test_createToken_returns_plain_text_token(): void
+    {
+        $user   = $this->seedUser();
+        $entity = $this->buildEntityFromUser($user);
+
+        $token = $this->service()->createToken($entity);
+
+        $this->assertIsString($token);
+        $this->assertNotEmpty($token);
+        $this->assertDatabaseHas('personal_access_tokens', [
+            'tokenable_id'   => $user->id,
+            'tokenable_type' => User::class,
+        ]);
+    }
+
+    public function test_createToken_throws_when_user_not_found(): void
+    {
+        $entity = UserEntityFactory::build([
+            'id'                      => 999999,
+            'first_name'              => 'Ghost',
+            'last_name'               => 'User',
+            'email'                   => 'ghost@example.com',
+            'age_range'               => 'teens',
+            'subscription_tier'       => 'free',
+            'subscription_expires_at' => null,
+        ]);
+
+        $this->expectException(\RuntimeException::class);
+        $this->expectExceptionMessage('User not found.');
+
+        $this->service()->createToken($entity);
+    }
+
+    public function test_revokeAllTokens_deletes_tokens_for_user(): void
+    {
+        $user   = $this->seedUser();
+        $entity = $this->buildEntityFromUser($user);
+
+        $user->createToken('token-1');
+        $user->createToken('token-2');
+
+        $this->service()->revokeAllTokens($entity);
+
+        $this->assertDatabaseMissing('personal_access_tokens', [
+            'tokenable_id' => $user->id,
+        ]);
+    }
+
+    public function test_revokeAllTokens_throws_when_user_not_found(): void
+    {
+        $entity = UserEntityFactory::build([
+            'id'                      => 999999,
+            'first_name'              => 'Ghost',
+            'last_name'               => 'User',
+            'email'                   => 'ghost@example.com',
+            'age_range'               => 'teens',
+            'subscription_tier'       => 'free',
+            'subscription_expires_at' => null,
+        ]);
+
+        $this->expectException(\RuntimeException::class);
+        $this->expectExceptionMessage('User not found.');
+
+        $this->service()->revokeAllTokens($entity);
+    }
+}

src/app/Packages/Domains/User/Tests/UserEntityTest.php

@@ -6,6 +6,7 @@
 use App\Packages\Domains\User\Subscription\Subscription;
 use App\Packages\Domains\User\Subscription\SubscriptionTier;
 use App\Packages\Domains\User\UserEntity;
+use App\Packages\Domains\User\ValueObject\Email;
 use Faker\Factory as FakerFactory;
 use PHPUnit\Framework\TestCase;
 
@@ -20,7 +21,7 @@ private function buildEntity(array $overrides = []): UserEntity
             id:           array_key_exists('id', $overrides) ? $overrides['id'] : $faker->unique()->randomNumber(5),
             firstName:    $overrides['first_name']    ?? $faker->firstName(),
             lastName:     $overrides['last_name']     ?? $faker->lastName(),
-            email:        $overrides['email']         ?? $faker->unique()->safeEmail(),
+            email:        isset($overrides['email']) ? new Email($overrides['email']) : new Email($faker->unique()->safeEmail()),
             ageRange:     $overrides['age_range']     ?? AgeRange::Twenties,
             subscription: $overrides['subscription']  ?? $subscription,
             passwordHash: $overrides['password_hash'] ?? null,
@@ -60,7 +61,7 @@ public function test_getFullName_concatenates_first_and_last_name(): void
     public function test_getEmail_returns_correct_value(): void
     {
         $entity = $this->buildEntity(['email' => 'john@example.com']);
-        $this->assertSame('john@example.com', $entity->getEmail());
+        $this->assertSame('john@example.com', $entity->getEmail()->value());
     }
 
     public function test_getAgeRange_returns_correct_enum(): void

src/app/Packages/Domains/User/Tests/UserRepositoryTest.php

@@ -9,6 +9,7 @@
 use App\Packages\Domains\User\Subscription\SubscriptionTier;
 use App\Packages\Domains\User\UserEntity;
 use App\Packages\Domains\User\UserRepository;
+use App\Packages\Domains\User\ValueObject\Email;
 use App\Packages\Features\QueryUseCases\Dto\User\UserDto;
 use Faker\Factory as FakerFactory;
 use Illuminate\Support\Facades\DB;
@@ -138,4 +139,38 @@ public function test_deleteUser_throws_exception_when_user_not_found(): void
 
         $this->repository()->deleteUser(999999);
     }
+
+    public function test_findByEmail_returns_user_entity_when_user_exists(): void
+    {
+        $user = $this->seedUser(['email' => 'john@example.com']);
+
+        $result = $this->repository()->findByEmail(new Email('john@example.com'));
+
+        $this->assertInstanceOf(UserEntity::class, $result);
+        $this->assertSame($user->email, $result->getEmail()->value());
+        $this->assertSame($user->first_name, $result->getFirstName());
+        $this->assertSame($user->last_name, $result->getLastName());
+    }
+
+    public function test_findByEmail_returns_null_when_user_does_not_exist(): void
+    {
+        $result = $this->repository()->findByEmail(new Email('notfound@example.com'));
+
+        $this->assertNull($result);
+    }
+
+    public function test_findByEmail_returns_correct_password_hash(): void
+    {
+        $plainPassword = 'secret123';
+        $this->seedUser([
+            'email'    => 'hash@example.com',
+            'password' => bcrypt($plainPassword),
+        ]);
+
+        $result = $this->repository()->findByEmail(new Email('hash@example.com'));
+
+        $this->assertNotNull($result->getPasswordHash());
+        $this->assertTrue(password_verify($plainPassword, $result->getPasswordHash()));
+    }
+
 }