feat: explore the public opportunity catalogue by corridor

app/Http/Controllers/InvestmentDiscoveryController.php

@@ -26,6 +26,7 @@ class InvestmentDiscoveryController extends Controller
         }
 
         return Inertia::render('investment/catalogue', ['filters' => $filters, 'catalogueUrl' => $request->routeIs('investment.education') ? '/educacao' : '/oportunidades', 'references' => $catalogue->references(false, $filters),
+            'corridorGroups' => ($filters['view'] ?? '') === 'corridors' ? app(\App\Services\OpportunityCorridorExplorer::class)->groups($filters) : [],
             'territorySelection' => app(InvestmentGeography::class)->selection($filters),
             'guides' => app(\App\Services\SectorInvestment::class)->guides(\App\Models\Sector::where('slug', $filters['sector'] ?? '')->where('is_active', true)->whereNotNull('published_at')->first()),
             'results' => $catalogue->query($filters)->paginate(12)->withQueryString(),

app/Services/InvestmentCatalogue.php

@@ -26,7 +26,7 @@ class InvestmentCatalogue
             'cluster_id' => ['nullable', 'uuid'], 'corridor_id' => ['nullable', 'uuid'], 'project_id' => ['nullable', 'uuid'],
             'geo_location_id' => ['nullable', 'uuid'], 'education' => ['nullable', 'boolean'],
             'zee_id' => ['nullable', 'uuid'], 'zfi_id' => ['nullable', 'uuid'], 'park_id' => ['nullable', 'uuid'],
-            'dimension' => ['nullable', 'in:cluster,corridor,zee,zfi'], 'view' => ['nullable', 'in:grid,list,map,combined'],
+            'dimension' => ['nullable', 'in:cluster,corridor,zee,zfi'], 'view' => ['nullable', 'in:grid,list,map,combined,corridors'],
             'maturity_level' => ['nullable', 'integer', 'between:1,8'], 'facets' => ['nullable', 'array', 'max:20'], 'facets.*' => ['integer', 'min:1'],
             'min_amount' => ['nullable', 'numeric', 'min:0', 'max:999999999999'],
             'max_amount' => ['nullable', 'numeric', 'min:0', 'max:999999999999', ...($request->filled('min_amount') ? ['gte:min_amount'] : [])],

app/Services/OpportunityCorridorExplorer.php

@@ -0,0 +1,55 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Opportunity;
+
+/** Read-only grouping of the existing public catalogue. */
+final class OpportunityCorridorExplorer
+{
+    public function groups(array $filters): array
+    {
+        $catalogue = app(InvestmentCatalogue::class);
+        $groups = [];
+        foreach ($catalogue->query($filters)->get() as $record) {
+            $context = $catalogue->context($record->id);
+            $classification = $context['classification'] ?? [];
+            $corridors = collect($context['corridors'])->mapWithKeys(fn ($c) => ['corridor:'.$c->id => $c->name])->all();
+            foreach ($classification as $relation) {
+                if ($relation['target_type'] === 'corridor' && ! in_array($relation['purpose'], ['proximity', 'administrative_boundary'], true)) {
+                    $corridors['corridor:'.$relation['target_id']] = $relation['label'];
+                }
+            }
+            // The approved source names are not aliases for similarly named master records.
+            $source = data_get($record->workflow_context, 'corridor_agribusiness');
+            $chain = null;
+            if (is_array($source) && ($source['source_sha256'] ?? null) === CorridorAgribusinessOpportunities::SOURCE_HASH) {
+                $corridors['source:'.hash('sha256', $source['corridor'])] = $source['corridor'];
+                $chain = $source['chain'];
+            }
+            $chains = collect($classification)->where('target_type', 'chain')->pluck('label')->all();
+            if ($chain) $chains[] = $chain;
+            $stages = collect($classification)->pluck('production_stage')->filter()->unique()->values()->all();
+            // Keep the source's actual activity description rather than inventing stage labels.
+            if ($stages === [] && $chain && ! empty($source['summary'])) $stages = [$source['summary']];
+            $path = collect($context['primary_territory_path'] ?? []);
+            $province = $path->firstWhere('location_type', 'province')->name ?? $record->province;
+            $district = $path->firstWhere('location_type', 'district')->name ?? $record->district;
+            $item = ['id' => $record->id, 'title' => $record->title, 'slug' => $record->slug, 'summary' => $record->summary,
+                'province' => $province, 'district' => $district, 'chains' => array_values(array_unique($chains)),
+                'stages' => $stages, 'maturity_label' => $record->maturity_label];
+            foreach ($corridors ?: ['other' => 'Outras localizações'] as $key => $name) {
+                $groups[$key] ??= ['id' => $key, 'name' => $name, 'opportunities' => []];
+                $groups[$key]['opportunities'][$record->id] = $item;
+            }
+        }
+        foreach ($groups as &$group) {
+            $group['opportunities'] = array_values($group['opportunities']);
+            $group['count'] = count($group['opportunities']);
+            $group['locations'] = array_values(array_unique(array_filter(array_map(fn ($r) => implode(' / ', array_filter([$r['province'], $r['district']])), $group['opportunities']))));
+        }
+        unset($group);
+        uasort($groups, fn ($a, $b) => ($a['id'] === 'other' ? 1 : 0) <=> ($b['id'] === 'other' ? 1 : 0) ?: strnatcasecmp($a['name'], $b['name']));
+        return array_values($groups);
+    }
+}