feat: implement Presentation layer for POST /api/v1/favorites / お気に入り追加のPresentation層実装

src/app/Packages/Features/Controller/FavoriteController.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Packages\Features\Controller;
+
+use App\Http\Controllers\Controller;
+use App\Packages\Features\CommandUseCases\UseCase\Favorite\AddFavoriteUseCase;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Log;
+use Throwable;
+
+class FavoriteController extends Controller
+{
+    public function addFavorite(
+        Request $request,
+        AddFavoriteUseCase $useCase,
+    ): JsonResponse {
+        try {
+            $useCase->handle(
+                $request->user()->id,
+                (int) $request->input('world_heritage_id'),
+            );
+
+            return response()->json([
+                'status' => 'success',
+            ], 201);
+        } catch (Throwable $throwable) {
+            if ($throwable->getMessage() === 'User not found.') {
+                return response()->json([
+                    'status'  => 'error',
+                    'message' => 'User not found.',
+                ], 404);
+            }
+
+            Log::error('Failed to add favorite', [
+                'message' => $throwable->getMessage(),
+                'trace'   => $throwable->getTraceAsString(),
+            ]);
+
+            return response()->json([
+                'status'  => 'error',
+                'message' => 'Internal Server Error',
+            ], 500);
+        }
+    }
+}

src/app/Packages/Features/Tests/FavoriteControllerTest.php

@@ -0,0 +1,113 @@
+<?php
+
+namespace App\Packages\Features\Tests;
+
+use App\Models\User;
+use App\Models\WorldHeritage;
+use App\Packages\Domains\Favorite\Interface\FavoriteRepositoryInterface;
+use App\Packages\Features\CommandUseCases\UseCase\Favorite\AddFavoriteUseCase;
+use Illuminate\Support\Facades\DB;
+use Mockery;
+use RuntimeException;
+use Tests\TestCase;
+
+class FavoriteControllerTest 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('user_favorite')->truncate();
+            DB::connection('mysql')->table('personal_access_tokens')->truncate();
+            WorldHeritage::truncate();
+            User::truncate();
+            DB::connection('mysql')->statement('SET FOREIGN_KEY_CHECKS=1;');
+        }
+    }
+
+    private function seedUser(): User
+    {
+        return User::create([
+            'first_name'              => 'John',
+            'last_name'               => 'Doe',
+            'email'                   => 'john@example.com',
+            'password'                => bcrypt('secret123'),
+            'age_range'               => '20s',
+            'subscription_tier'       => 'free',
+            'subscription_expires_at' => null,
+        ]);
+    }
+
+    private function seedWorldHeritage(int $id): WorldHeritage
+    {
+        return WorldHeritage::create([
+            'id'             => $id,
+            'official_name'  => 'Example Site',
+            'name'           => 'Example Site',
+            'region'         => 'Asia',
+            'category'       => 'Cultural',
+            'criteria'       => ['i'],
+            'year_inscribed' => 2000,
+        ]);
+    }
+
+    public function test_addFavorite_returns_201_and_persists_favorite_when_authenticated(): void
+    {
+        $user          = $this->seedUser();
+        $worldHeritage = $this->seedWorldHeritage(1);
+        $token         = $user->createToken('auth-token')->plainTextToken;
+
+        $response = $this->withToken($token)
+            ->postJson('/api/v1/favorites', ['world_heritage_id' => $worldHeritage->id]);
+
+        $response->assertStatus(201)
+            ->assertJsonFragment(['status' => 'success']);
+
+        $this->assertDatabaseHas('user_favorite', [
+            'user_id'                => $user->id,
+            'world_heritage_site_id' => $worldHeritage->id,
+        ]);
+    }
+
+    public function test_addFavorite_returns_401_when_unauthenticated(): void
+    {
+        $worldHeritage = $this->seedWorldHeritage(1);
+
+        $response = $this->postJson('/api/v1/favorites', ['world_heritage_id' => $worldHeritage->id]);
+
+        $response->assertStatus(401);
+    }
+
+    public function test_addFavorite_returns_500_on_unexpected_error(): void
+    {
+        $user  = $this->seedUser();
+        $token = $user->createToken('auth-token')->plainTextToken;
+
+        $repository = Mockery::mock(FavoriteRepositoryInterface::class);
+        $repository->shouldReceive('addFavorite')
+            ->andThrow(new RuntimeException('Unexpected error'));
+
+        $this->app->instance(AddFavoriteUseCase::class, new AddFavoriteUseCase($repository));
+
+        $response = $this->withToken($token)
+            ->postJson('/api/v1/favorites', ['world_heritage_id' => 1]);
+
+        $response->assertStatus(500)
+            ->assertJsonFragment([
+                'status'  => 'error',
+                'message' => 'Internal Server Error',
+            ]);
+    }
+}

src/routes/api.php

@@ -1,6 +1,7 @@
 <?php
 
 use App\Packages\Features\Controller\AuthController;
+use App\Packages\Features\Controller\FavoriteController;
 use App\Packages\Features\Controller\UserController;
 use App\Packages\Features\Controller\WorldHeritageController;
 use Illuminate\Support\Facades\Route;
@@ -26,4 +27,8 @@
         Route::patch('/{id}', 'updateUser');
         Route::delete('/{id}', 'deleteUser');
     });
+
+    Route::controller(FavoriteController::class)->prefix('favorites')->middleware('auth:sanctum')->group(function (): void {
+        Route::post('/', 'addFavorite');
+    });
 });