Chore/add main iamge url

src/app/Console/Commands/AlgoliaImportWorldHeritages.php

@@ -69,6 +69,7 @@ public function handle(): int
                 'world_heritage_sites.criteria',
                 'world_heritage_sites.year_inscribed',
                 'world_heritage_sites.is_endangered',
+                'world_heritage_sites.main_image_url',
             ])
             ->chunkById($chunk, function ($rows) use ($client, $indexName, $dryRun, &$processed): void {
                 $objects = [];
@@ -136,7 +137,8 @@ public function handle(): int
                         'criteria' => $row->criteria,
                         'year_inscribed' => $row->year_inscribed !== null ? (int) $row->year_inscribed : null,
                         'is_endangered' => (bool) $row->is_endangered,
-                        'thumbnail_url' => $row->images->first()?->url,
+                        'main_image_url' => $row->main_image_url,
+                        'thumbnail_url' => $row->main_image_url ?? $row->images->first()?->url,
                         'state_party_codes' => $statePartyCodes,
                         'country_names_jp' => $countryCount > 1 ? $countryNamesJp : [],
                     ];

src/app/Console/Commands/ImportWorldHeritageSiteFromSplitFile.php

@@ -97,6 +97,7 @@ public function handle(): int
                 'longitude' => $this->toNullableFloat($row['longitude'] ?? null),
                 'short_description' => $this->toNullableString($row['short_description'] ?? null),
                 'unesco_site_url' => $this->toNullableString($row['unesco_site_url'] ?? null),
+                'main_image_url' => $this->toNullableString($row['main_image_url'] ?? null),
                 'created_at' => $now,
                 'updated_at' => $now,
             ];

src/app/Console/Commands/SplitWorldHeritageJson.php

@@ -743,6 +743,7 @@ private function normalizeSiteRowImportReady(array $row, int $siteId): array
             'longitude' => isset($lon) ? (is_numeric($lon) ? (float) $lon : null) : null,
             'short_description' => $this->stringOrNull($row['short_description_en'] ?? null),
             'unesco_site_url' => $this->stringOrNull($row['unesco_site_url'] ?? ($row['url'] ?? null)),
+            'main_image_url' => $this->stringOrNull($row['image_url'] ?? ($row['main_image_url'] ?? null)),
         ];
     }
 
@@ -818,6 +819,8 @@ private function mergeSiteRowPreferExisting(array $existing, array $incoming): a
             $existing['unesco_site_url'] = $unescoUrl;
         }
 
+        $fill('main_image_url', $incoming['image_url'] ?? ($incoming['main_image_url'] ?? null));
+
         return $existing;
     }
 

src/app/Models/WorldHeritage.php

@@ -35,6 +35,7 @@ class WorldHeritage extends Model
         'longitude',
         'short_description',
         'unesco_site_url',
+        'main_image_url',
     ];
 
     protected $hidden = [

src/app/Packages/Domains/WorldHeritageQueryService.php

@@ -47,6 +47,7 @@ public function getAllHeritages(
                 'world_heritage_sites.longitude',
                 'world_heritage_sites.short_description',
                 'world_heritage_sites.unesco_site_url',
+                'world_heritage_sites.main_image_url',
             ])
             ->with([
                 'countries' => static function ($q): void {
@@ -198,6 +199,7 @@ public function getHeritageById(int $id): WorldHeritageDto
             'state_parties_meta' => $statePartiesMeta,
             'short_description_jp' => $heritage->descriptions->short_description_ja,
             'images' => $imageCollection->toArray(),
+            'main_image_url' => $heritage->main_image_url,
         ]);
     }
 
@@ -321,6 +323,7 @@ private function buildWorldHeritagePayload($heritage): array
             'short_description' => $heritage->short_description,
             'image_url' => $heritage->images->first()?->url,
             'unesco_site_url' => $heritage->unesco_site_url,
+            'main_image_url' => $heritage->main_image_url,
             'short_description_jp' => $heritage->descriptions?->short_description_ja,
             'state_parties' => $statePartyCodeList,
             'state_parties_meta' => $statePartiesMeta,

src/app/Packages/Domains/WorldHeritageReadQueryService.php

@@ -34,6 +34,7 @@ public function findByIdsPreserveOrder(array $ids): Collection
                 'world_heritage_sites.longitude',
                 'world_heritage_sites.short_description',
                 'world_heritage_sites.unesco_site_url',
+                'world_heritage_sites.main_image_url',
             ])
             ->with([
                 'countries' => static function ($q): void {

src/app/Packages/Features/QueryUseCases/Dto/WorldHeritageDto.php

@@ -27,6 +27,7 @@ public function __construct(
         private readonly ?string $shortDescriptionJp = null,
         private readonly array $statePartyCodes = [],
         private readonly array $statePartiesMeta = [],
+        private readonly ?string $mainImageUrl = null,
     ){}
 
 
@@ -125,6 +126,11 @@ public function getUnescoSiteUrl(): ?string
         return $this->unescoSiteUrl;
     }
 
+    public function getMainImageUrl(): ?string
+    {
+        return $this->mainImageUrl;
+    }
+
     public function getStatePartyCodes(): array
     {
         return $this->statePartyCodes ?: $this->getStatePartyCodesOrFallback();

src/app/Packages/Features/QueryUseCases/Dto/WorldHeritageDtoCollection.php

@@ -44,7 +44,8 @@ public function toSummaryArray(): array
                 'unesco_site_url' => $heritage->getUnescoSiteUrl(),
                 'state_party_codes' => $heritage->getStatePartyCodes(),
                 'state_parties_meta' => $heritage->getStatePartiesMeta(),
-                'thumbnail' => $heritage->getThumbnailUrl(),
+                'thumbnail_url' => $heritage->getMainImageUrl()
+                    ?? ($heritage->getImages()[0]['url'] ?? null),
             ];
         }, $this->heritages);
     }

src/app/Packages/Features/QueryUseCases/Factory/Dto/WorldHeritageDetailFactory.php

@@ -48,6 +48,7 @@ public static function build(array $data): WorldHeritageDto
             shortDescriptionJp: $data['short_description_jp'] ?? null,
             statePartyCodes: $statePartyCodes,
             statePartiesMeta: $statePartiesMeta,
+            mainImageUrl: $data['main_image_url'] ?? null,
         );
     }
 

src/app/Packages/Features/QueryUseCases/Factory/Dto/WorldHeritageSummaryFactory.php

@@ -63,6 +63,7 @@ public static function build(array $data): WorldHeritageDto
             shortDescriptionJp: $data['short_description_jp'] ?? null,
             statePartyCodes: $statePartyCodes,
             statePartiesMeta: $statePartiesMeta,
+            mainImageUrl: $data['main_image_url'] ?? null,
         );
     }
 

src/app/Packages/Features/QueryUseCases/Tests/Dto/WorldHeritageDtoCollectionTest.php

@@ -211,8 +211,8 @@ public function test_summary_array_matches_expected_with_thumbnail(): void
             $this->assertArrayNotHasKey('images', $item);
             $this->assertArrayNotHasKey('imageUrl', $item);
             $this->assertArrayNotHasKey('state_parties', $item);
-            $this->assertArrayHasKey('thumbnail', $item);
-            $this->assertTrue(is_string($item['thumbnail']) || is_null($item['thumbnail']));
+            $this->assertArrayHasKey('thumbnail_url', $item);
+            $this->assertTrue(is_string($item['thumbnail_url']) || is_null($item['thumbnail_url']));
 
             return collect($item)->keyBy(static fn($v, $k) => Str::snake($k))->toArray();
         })->toArray();

src/app/Packages/Features/QueryUseCases/Tests/ViewModel/WorldHeritageSummaryViewModelFactoryTest.php

@@ -141,7 +141,7 @@ private function mockDto(): WorldHeritageDto
         $mock->shouldReceive('getStatePartiesMeta')
             ->andReturn($this->arrayData()['state_parties_meta']);
 
-        $mock->shouldReceive('getThumbnailUrl')
+        $mock->shouldReceive('getMainImageUrl')
             ->andReturn($this->arrayData()['thumbnail_url']);
 
         $mock->shouldReceive('getCountryNameJp')

src/app/Packages/Features/QueryUseCases/Tests/ViewModel/WorldHeritageViewModelCollectionFactoryTest.php

@@ -7,7 +7,6 @@
 use App\Packages\Features\QueryUseCases\Factory\ViewModel\WorldHeritageViewModelCollectionFactory;
 use App\Packages\Features\QueryUseCases\ViewModel\WorldHeritageViewModelCollection;
 use Tests\TestCase;
-use App\Packages\Features\QueryUseCases\Dto\ImageDto;
 
 class WorldHeritageViewModelCollectionFactoryTest extends TestCase
 {
@@ -103,15 +102,6 @@ private function arrayData(): array
     private function mockDtoCollection(): WorldHeritageDtoCollection
     {
         $dtos = array_map(static function (array $data) {
-            $thumbnail = isset($data['thumbnail_url']) && $data['thumbnail_url']
-                ? new ImageDto(
-                    id: $data['id'] ?? 0,
-                    url: $data['thumbnail_url'],
-                    sortOrder: 0,
-                    isPrimary: true,
-                )
-                : null;
-
             return new WorldHeritageDto(
                 id: $data['id'],
                 officialName: $data['official_name'],
@@ -131,11 +121,12 @@ private function mockDtoCollection(): WorldHeritageDtoCollection
                 bufferZoneHectares: $data['buffer_zone_hectares'] ?? null,
                 shortDescription: $data['short_description'] ?? null,
                 images: null,
-                imageUrl: $thumbnail,
+                imageUrl: null,
                 unescoSiteUrl: $data['unesco_site_url'] ?? null,
                 shortDescriptionJp: $data['short_description_jp'] ?? null,
                 statePartyCodes: $data['state_party_codes'] ?? ($data['state_parties'] ?? []),
-                statePartiesMeta: $data['state_parties_meta'] ?? []
+                statePartiesMeta: $data['state_parties_meta'] ?? [],
+                mainImageUrl: $data['thumbnail_url'] ?? null,
             );
         }, $this->arrayData());
 

src/app/Packages/Features/QueryUseCases/ViewModel/WorldHeritageViewModel.php

@@ -12,7 +12,8 @@ public function __construct(
 
     public function getThumbnailUrl(): ?string
     {
-        return $this->dto->getThumbnailUrl();
+        return $this->dto->getMainImageUrl()
+            ?? ($this->dto->getImages()[0]['url'] ?? null);
     }
 
     public function getId(): int

src/database/migrations/2026_05_04_000000_add_main_image_url_to_world_heritage_sites.php

@@ -0,0 +1,22 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::table('world_heritage_sites', function (Blueprint $table) {
+            $table->string('main_image_url', 2048)->nullable()->after('short_description');
+        });
+    }
+
+    public function down(): void
+    {
+        Schema::table('world_heritage_sites', function (Blueprint $table) {
+            $table->dropColumn('main_image_url');
+        });
+    }
+};