docs: delimit simulator closure to two code gaps and monthly export proof

.dockerignore

@@ -0,0 +1,16 @@
+.git
+.idea
+.agents
+.codex
+node_modules
+vendor
+public/build
+storage/logs
+storage/framework/cache
+storage/framework/sessions
+storage/framework/views
+tests
+Doc
+docs
+*.zip
+.phpunit.result.cache

.env.example

@@ -4,6 +4,11 @@ APP_KEY=
 APP_DEBUG=true
 APP_URL=http://localhost:8000
 
+# Separate from publication. Bind only an explicitly authorised published rule version.
+INVESTMOZ_IVA_CONSUMER_ENABLED=false
+INVESTMOZ_IVA_CONSUMER_RULE_ID=
+INVESTMOZ_IVA_CONSUMER_RULE_VERSION=0
+
 APP_LOCALE=en
 APP_FALLBACK_LOCALE=en
 APP_FAKER_LOCALE=en_US

AGENTS.md

@@ -1,5 +1,13 @@
 # Instruções permanentes do projeto InvesteMoz
 
+## Percurso adaptativo — decisão expressa da Tempo, 23/10/2026
+
+Carteira/projectos âncora e percurso adaptativo têm diagnósticos distintos, mas fazem parte da mesma experiência e responsabilidade de correcção. Separar o diagnóstico não autoriza adiamento, desligamento do percurso ou perda de contexto entre corredor/localização, oportunidades, associações documentadas a âncoras/clusters, dossier e simulador. A reposição prioritária só se considera demonstrada com causa delimitada e disponibilidade recuperada, reutilizando o inventário e os recibos existentes; melhorias noutro ponto não a comprovam. Consultar os registos de reposição antes de voltar a declarar causa desconhecida ou registos desaparecidos.
+
+Apresentar apenas o necessário ao investimento em preparação, com entrada por ideia, oportunidade, sector ou localização, reutilizando informação válida e autorizada da oportunidade, perfil, organização, dossier e fontes anteriores. As etapas são adaptáveis, não seis formulários obrigatórios. Não sobrescrever edições deliberadas; explicar divergências e impactos antes da confirmação. Conservar escolhas ao avançar, regressar, actualizar e autenticar-se. Seleccionar opções únicas e pedir apenas dados em falta ou desactualizados.
+
+Ocultar campos e acções sem aplicação, conservando explicação breve e histórico; desconhecido não significa não aplicável. Na selecção múltipla, partilhar dados comuns sem perder os requisitos específicos de cada oportunidade. Consulta pública livre; autenticação no momento de manifestar interesse ou iniciar operação privada. Relatórios e exportações devem reflectir o contexto e as etapas efectivamente aplicáveis. O utilizador deve perceber onde está, o que falta e a próxima acção. Aperfeiçoar os componentes existentes por incrementos e registar cobertura na matriz existente; esta instrução não declara concluída a sua implementação transversal.
+
 ## Regras permanentes do InvesteMoz — decisão da Tempo, 12/10/2026
 
 1. O portal InvesteMoz é propriedade da Tempo, Lda.
@@ -39,3 +47,20 @@ Referenciar estas orientações nos requisitos correspondentes da matriz existen
 - Preservar o ficheiro original, a proveniência, o identificador exacto, a edição/data, o hash e o histórico. Não marcar autenticidade, vigência, direitos ou scan como confirmados sem evidência.
 - Para fontes fiscais, inventariar também as fontes não analisadas e os diplomas/artigos sem correspondência documental. Parâmetros ausentes ou ambiguidades permanecem indeterminados; não usar zero nem a taxa mais recente como substituto.
 - Antes de aplicar mudanças em dados activos, confirmar backup/restauro e a acção autenticada que continua necessária. Testes e migrações devem usar exclusivamente uma base QA isolada com guarda contra a base activa.
+
+
+## Execução das fontes e decisões — orientação permanente da Tempo, 22/10/2026
+
+A legislação, os formulários e os procedimentos oficiais disponibilizados são fontes válidas para implementar os requisitos. As decisões e procedimentos da Tempo orientam a sua utilização no portal. Traduzir essas fontes em campos, regras, documentos, cálculos e percursos executáveis com rastreabilidade, sem exigir nova validação jurídica genérica ou criar aprovadores, restrições ou condições por interpretação do Codex.
+
+Uma divergência concreta deve identificar os trechos, períodos e comportamento afectados; prosseguir com os restantes requisitos. Uma decisão de implementação em falta deve ser apresentada especificamente à Tempo, sem a substituir por regra inventada. Rever e remover bloqueios anteriores sem fundamento numa fonte aplicável ou decisão expressa da Tempo, preservando dados e histórico. A rastreabilidade explica a execução e não constitui uma autoridade adicional. Mantêm-se os limites autorizados de QA e das alterações no activo.
+
+## Preservação do concluído — pedido expresso da Tempo, 23/10/2026
+
+Antes de avançar com novas rondas de testes/validações, inventariar na matriz e no manual existentes as funcionalidades concluídas e as funcionalidades desaparecidas, e repor as perdas confirmadas. Preservar as aprovações, dados, originais, relações, versões, histórico e acessos já concluídos. Não transformar uma entrega anterior em funcionalidade nova nem exigir novamente a decisão organizacional já registada.
+
+Comparar código, schema, dados, configuração e permissões entre o último estado demonstrado e o destino. Distinguir eliminação, perda de visibilidade, diferença de ambiente, pendência real e estado documental desactualizado; uma página vazia ou a falta de nova prova não apagam a aceitação anterior. Reutilizar as provas aceites e conferir apenas o delta da reposição. Cada entrega seguinte deve explicar qualquer redução do âmbito previamente disponível, em vez de a aceitar como consequência normal da implementação.
+
+Transporte privado não equivale à revogação de uma divulgação anterior aprovada. Reconciliar a decisão anterior de forma delimitada e auditada, sem publicar automaticamente conteúdos novos, reviver exemplares arquivados ou sobrescrever edições posteriores. Mantêm-se backup/restauro, autenticação e os limites concretos de cada tarefa.
+
+Escolha técnica de verificação: comparar dados protegidos por segurança por linha (RLS) com identidades e contexto de acesso equivalentes. Uma leitura da aplicação sem actor pode ocultar registos que o utilizador do backup consegue ler; confirmar essa diferença antes de declarar perda ou propor reposição. Esta orientação não altera permissões do portal nem autoriza contornar RLS numa operação da equipa.

app/Console/Commands/RegisterFiscalQaDraft.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Console\Commands;
+
+use App\Models\InvestmentLegalSource;
+use App\Models\User;
+use App\Services\SimulationTaxParameterResolver;
+use App\Services\SimulationTaxRuleExpression;
+use App\Services\SimulationTaxRuleGovernance;
+use App\Support\IsolatedQaDatabase;
+use Illuminate\Console\Command;
+
+/** Explicit registration: never run during migration, deployment or document import. */
+class RegisterFiscalQaDraft extends Command
+{
+    protected $signature = 'fiscal:qa-register-iva {actor : Existing QA editor ID} {source : Existing accepted legal source UUID}';
+
+    protected $description = 'Cadastrar apenas o rascunho IVA do primeiro lote numa base QA isolada, sem publicação';
+
+    public function handle(SimulationTaxRuleGovernance $governance): int
+    {
+        abort_unless(IsolatedQaDatabase::allowsSchemaChanges(), 403, 'O cadastro deste lote só é permitido na base QA isolada.');
+        $actor = User::findOrFail($this->argument('actor'));
+        $source = InvestmentLegalSource::findOrFail($this->argument('source'));
+        abort_unless($source->validation_status === 'validated' && $source->diploma === 'Lei 22/2022'
+            && $source->article === 'Artigo 17(1)', 422, 'Seleccione a referência aceite da taxa geral, Lei 22/2022, artigo 17(1).');
+        $payload = json_decode(file_get_contents(database_path('qa/iva-general-net-v1.json')), true, flags: JSON_THROW_ON_ERROR);
+        $actualHash = hash_file('sha256', base_path('docs/investmoz/simulations/source-archive/Lei-22-2022-IVA-republicada-BR-250-2-suplemento.pdf'));
+        abort_unless(hash_equals($payload['source_sha256'], $actualHash), 422, 'O exemplar não corresponde ao hash da ficha.');
+        $payload['legal_source_id'] = (string) $source->id;
+        app(SimulationTaxRuleExpression::class)->validate($payload['rule_definition']);
+        app(SimulationTaxParameterResolver::class)->validateParameters($payload['parameters']);
+        $existing = $governance->listing($actor, ['rule_code' => $payload['rule_code']])->getCollection()
+            ->firstWhere('rule_version', 1);
+        if ($existing) {
+            foreach ($payload as $field => $value) {
+                $stored = $existing->attributesToArray()[$field] ?? null;
+                abort_unless($stored == $value, 409, 'O cadastro existente difere desta ficha; não será sobrescrito.');
+            }
+            abort_unless($existing->status === 'draft', 409, 'A versão existente já não é um rascunho.');
+            $this->line(json_encode(['id' => $existing->id, 'status' => 'draft', 'reused' => true], JSON_THROW_ON_ERROR));
+
+            return self::SUCCESS;
+        }
+        $rule = $governance->create($actor, $payload);
+        $this->line(json_encode(['id' => $rule->id, 'status' => $rule->status, 'reused' => false], JSON_THROW_ON_ERROR));
+
+        return self::SUCCESS;
+    }
+}

app/Http/Controllers/Api/V1/SimulationController.php

@@ -37,11 +37,17 @@ class SimulationController extends Controller
         $token = $actorId === null ? $request->header('X-Simulation-Token') : null;
         abort_if($actorId === null && (! is_string($token) || strlen($token) < 32 || strlen($token) > 256), 422, 'X-Simulation-Token opaco gerado pelo cliente é obrigatório para execução anónima.');
         $validated = $request->validated();
-        $data = ['base' => (string) $validated['base'], 'rate' => (string) $validated['rate'],
-            'reduction' => (string) ($validated['reduction'] ?? '0'), 'organization_id' => $validated['organization_id'] ?? null];
-        $organizationId = $data['organization_id'] ?? null;
+        $organizationId = $validated['organization_id'] ?? null;
         $execution->authorizeOrganization($actorId, $organizationId);
-        $result = $execution->create($data, $actorId, $organizationId, $token, $key);
+        if (($validated['scenario_kind'] ?? null) === 'fiscal_rule_published') {
+            $input = array_intersect_key($validated, array_flip(['base', 'currency', 'reference_date', 'operation', 'scope_declared', 'monthly_sales', 'sales_vat_basis']));
+            $input['scope_declared'] = (bool) $input['scope_declared'];
+            $result = $execution->createPublishedFiscal($input, $actorId, $organizationId, $token, $key);
+        } else {
+            $data = ['base' => (string) $validated['base'], 'rate' => (string) $validated['rate'],
+                'reduction' => (string) ($validated['reduction'] ?? '0')];
+            $result = $execution->create($data, $actorId, $organizationId, $token, $key);
+        }
         $simulation = $result['simulation'];
         $body = ['data' => $simulation, 'replayed' => $result['replayed']];
         if ($actorId === null) {

app/Http/Controllers/Api/V1/SimulationTaxParameterController.php

@@ -19,13 +19,15 @@ class SimulationTaxParameterController extends Controller
             $input['period_start'],
             $input['period_end'],
             $input['context'] ?? [],
+            $input['component'] === 'IVA',
         );
 
         return response()->json([
             'component' => $input['component'],
             'period' => ['start' => $input['period_start'], 'end' => $input['period_end']],
             'assumptions' => $input['context'] ?? [],
-            'parameters' => $data,
+            'parameters' => $input['component'] === 'IVA' ? $data['parameters'] : $data,
+            'diagnostics' => $input['component'] === 'IVA' ? $data['diagnostics'] : [],
         ])->header('Cache-Control', 'no-store');
     }
 }

app/Http/Controllers/CorridorAgribusinessController.php

@@ -0,0 +1,73 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Opportunity;
+use App\Services\CorridorAgribusinessOpportunities;
+use App\Services\OpportunityManagement;
+use App\Services\OpportunityPromotion;
+use App\Services\PortalProfileAccess;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Inertia\Inertia;
+
+final class CorridorAgribusinessController extends Controller
+{
+    private function manifest(CorridorAgribusinessOpportunities $service): string
+    {
+        return hash('sha256', json_encode($service->entries(), JSON_THROW_ON_ERROR));
+    }
+
+    public function show(Request $request, CorridorAgribusinessOpportunities $service)
+    {
+        $access = app(PortalProfileAccess::class);
+        abort_unless($access->internalAssignment($request->user(), 'investment_project') || $access->has($request->user(), 'publisher'), 403);
+        $records = Opportunity::withTrashed()->whereIn('management_creation_key', array_column($service->entries(), 'key'))->get()->keyBy('management_creation_key');
+        foreach ($records as $record) abort_unless($access->canView($request->user(), $record), 403);
+        return Inertia::render('management/corridor-agribusiness', ['manifestHash' => $this->manifest($service),
+            'canRegister' => (bool) $access->internalAssignment($request->user(), 'investment_project'),
+            'entries' => array_map(function ($entry) use ($records) {
+                $r = $records->get($entry['key']);
+                return [...$entry, 'id' => $r?->id, 'status' => $r?->status, 'href' => $r ? '/oportunidades/'.$r->slug : null];
+            }, $service->entries())]);
+    }
+
+    public function register(Request $request, CorridorAgribusinessOpportunities $service)
+    {
+        $data = $request->validate(['manifest_hash' => 'required|string|size:64', 'confirm' => 'required|accepted']);
+        abort_unless(hash_equals($this->manifest($service), $data['manifest_hash']), 409, 'A fonte mudou; recupere a prévia.');
+        $access = app(PortalProfileAccess::class);
+        $grant = $access->internalAssignment($request->user(), 'investment_project');
+        abort_unless($grant && $access->mfa($request->user()), 403, 'Use a designação existente e MFA recente.');
+        return response()->json(['records' => $service->register($request->user(), $grant->organization_id)]);
+    }
+
+    public function preview(Request $request, CorridorAgribusinessOpportunities $service)
+    {
+        $previews = [];
+        foreach ($service->entries() as $entry) {
+            $record = Opportunity::where('management_creation_key', $entry['key'])->firstOrFail();
+            $input = data_get($record->workflow_context, 'promotional_summary.input');
+            abort_unless(is_array($input), 409, 'Complete a selecção pública na divulgação individual.');
+            $previews[] = ['id' => $record->id, ...app(OpportunityPromotion::class)->preview($request->user(), $record,
+                [...$input, 'source_date' => $input['source_date'] ?: null, 'action' => 'disclose', 'etag' => app(OpportunityManagement::class)->etag($record)])];
+        }
+        return response()->json(['previews' => $previews]);
+    }
+
+    public function disclose(Request $request, CorridorAgribusinessOpportunities $service)
+    {
+        $data = $request->validate(['confirm' => 'required|accepted', 'reason' => 'required|string|min:20|max:1000',
+            'previews' => 'required|array|size:34', 'previews.*.id' => 'required|integer|distinct',
+            'previews.*.token' => 'required|string|max:300000', 'previews.*.operation_key' => 'required|uuid|distinct']);
+        $expected = Opportunity::whereIn('management_creation_key', array_column($service->entries(), 'key'))->pluck('id')->sort()->values()->all();
+        $supplied = array_column($data['previews'], 'id'); sort($supplied);
+        abort_unless($expected === $supplied && count($expected) === 34, 409, 'A prévia deve identificar exactamente as 34 fichas deste lote.');
+        return response()->json(DB::transaction(function () use ($request, $data) {
+            $result = [];
+            foreach ($data['previews'] as $preview) $result[] = app(OpportunityPromotion::class)->confirm($request->user(), $preview['id'],
+                [...$preview, 'confirm' => true, 'reason' => $data['reason']]);
+            return ['records' => $result];
+        }));
+    }
+}

app/Http/Controllers/EditorialArticleController.php

@@ -81,31 +81,18 @@ class EditorialArticleController extends Controller
         app(\App\Services\DocumentManagementAccess::class)->assertEditableResource(request()->user(), $id);
         $r = DB::table('portal_resources')->find($id);
         abort_unless($r, 404);
-        $content = $r->editorial_content ? json_decode($r->editorial_content, true) : null;
-        if ($content === null) {
-            $document = DB::table('documents')->find($r->document_id);
-            if ($document && $document->status === 'active' && $document->malware_scan_status === 'clean'
-                && in_array($document->media_type, ['text/plain', 'application/json'], true)) {
-                $binary = app(VerifiedDocumentBinary::class)->respond($document);
-                $bytes = $binary instanceof \Symfony\Component\HttpFoundation\BinaryFileResponse
-                    ? file_get_contents($binary->getFile()->getPathname()) : $binary->getContent();
-                $original = json_decode($bytes, true);
-                if (is_array($original) && ($original['format'] ?? '') === 'investmoz-legacy-article-v1') {
-                    $html = preg_replace('~</(?:p|div|li|h[1-6])>|<br\s*/?>~i', "\n\n", $original['content_html'] ?? '');
-                    $content = ['body' => trim(html_entity_decode(strip_tags($html), ENT_QUOTES | ENT_HTML5, 'UTF-8')), 'image_resource_id' => null];
-                }
-            }
-        }
-
-        return Inertia::render('portal/article-editor', ['resource' => ['id' => $r->id, 'title' => $r->title, 'metadata_version' => $r->metadata_version],
-            'content' => $content, 'images' => $this->publicResources()->whereIn('d.media_type', ['image/png', 'image/jpeg', 'image/webp'])->get(['r.id', 'r.title']),
-            'revisions' => DB::table('portal_resource_revisions')->where('resource_id', $id)->orderByDesc('revision_no')->get(['revision_no', 'change_type', 'created_at'])]);
+        $reading = app(\App\Services\EditorialReading::class);
+        $original = $reading->original($r);
+        $content = $reading->content($r, $original);
+        return Inertia::render('portal/article-editor', ['resource' => ['id' => $r->id, 'title' => $r->title, 'metadata_version' => $r->metadata_version, 'published' => (bool) $r->published],
+            'content' => $content, 'source' => $original ? array_intersect_key($original, array_flip(['source_url', 'published_at', 'modified_at', 'legacy_id', 'image_source_url'])) : null, 'images' => $this->publicResources()->whereIn('d.media_type', ['image/png', 'image/jpeg', 'image/webp'])->get(['r.id', 'r.title']),
+            'revisions' => DB::table('portal_resource_revisions')->where('resource_id', $id)->orderByDesc('revision_no')->get(['revision_no', 'change_type', 'created_at'])])->toResponse(request())->header('Cache-Control', 'private, no-store');
     }
 
     public function save(Request $request, int $id)
     {
         $this->installed();
-        $data = $request->validate(['body' => ['required', 'string', 'max:100000'], 'image_resource_id' => ['nullable', 'integer'], 'metadata_version' => ['required', 'integer', 'min:1']]);
+        $data = $this->validateContent($request);
         DB::transaction(function () use ($request, $id, $data) {
             $r = DB::table('portal_resources')->where('id', $id)->lockForUpdate()->first();
             abort_unless($r, 404);
@@ -118,7 +105,7 @@ class EditorialArticleController extends Controller
             if ($body === '') {
                 throw ValidationException::withMessages(['body' => 'Escreva o corpo do artigo.']);
             }
-            $content = ['format' => 1, 'body' => $body, 'image_resource_id' => $data['image_resource_id'] ?? null];
+            $content = $this->edition($r, $data);
             $revision = (int) $r->metadata_version + 1;
             DB::table('portal_resources')->where('id', $id)->update(['editorial_content' => json_encode($content, JSON_THROW_ON_ERROR), 'published' => false, 'approved_by' => null, 'metadata_version' => $revision, 'last_reviewed_by' => $request->user()->id, 'last_reviewed_at' => now(), 'updated_at' => now()]);
             $resource = DB::table('portal_resources')->find($id);
@@ -130,16 +117,46 @@ class EditorialArticleController extends Controller
         return redirect('/management/portal-services/resources/'.$id.'/article')->with('success', 'Artigo guardado como rascunho. Publique expressamente no acervo quando estiver pronto.');
     }
 
-    public function show(int $id)
+    private function validateContent(Request $request): array
+    {
+        return $request->validate(['body' => ['required', 'string', 'max:100000'], 'image_resource_id' => ['nullable', 'integer'], 'image_mode' => ['nullable', 'in:original,selected,none'], 'metadata_version' => ['required', 'integer', 'min:1']]);
+    }
+
+    private function edition(object $resource, array $data): array
+    {
+        $reading = app(\App\Services\EditorialReading::class);
+        $original = $reading->original($resource);
+        $mode = $data['image_mode'] ?? (!empty($data['image_resource_id']) ? 'selected' : 'none');
+        if ($mode === 'selected') abort_unless(!empty($data['image_resource_id']) && $reading->publicResources()->where('r.id', $data['image_resource_id'])->whereIn('d.media_type', ['image/png', 'image/jpeg', 'image/webp'])->exists(), 422, 'Escolha uma imagem pública disponível na biblioteca.');
+        return ['format' => 1, 'body' => trim($data['body']), 'image_mode' => $mode, 'image_resource_id' => $mode === 'selected' ? (int)$data['image_resource_id'] : null,
+            'preserve_original_html' => $original && trim($data['body']) === $reading->plain($original['content_html'])];
+    }
+
+    public function preview(Request $request, int $id)
     {
         $this->installed();
-        $r = $this->publicResources()->where('r.id', $id)->first(['r.id', 'r.title', 'r.description', 'r.editorial_content', 'r.document_id', 'd.issuer']);
-        abort_unless($r && $r->editorial_content, 404);
-        $content = json_decode($r->editorial_content, true);
-        // Recheck the original bytes using the same binary gate as the library.
-        $binary = app(VerifiedDocumentBinary::class)->respond($this->publicResources()->where('r.id', $id)->first(['r.*', 'd.*']));
-        $image = ! empty($content['image_resource_id']) ? $this->publicResources()->where('r.id', $content['image_resource_id'])->whereIn('d.media_type', ['image/png', 'image/jpeg', 'image/webp'])->value('r.id') : null;
+        app(\App\Services\DocumentManagementAccess::class)->assertEditableResource($request->user(), $id);
+        $resource = DB::table('portal_resources')->find($id); abort_unless($resource, 404);
+        return Inertia::render('portal/article', ['article' => app(\App\Services\EditorialReading::class)->reading($resource, null, true)])
+            ->toResponse($request)->header('Cache-Control', 'private, no-store')->header('X-Robots-Tag', 'noindex, nofollow');
+    }
 
-        return Inertia::render('portal/article', ['article' => ['id' => $id, 'title' => $r->title, 'description' => $r->description, 'author' => $r->issuer, 'body' => $content['body'], 'image_url' => $image ? '/documentos/'.$image.'/view' : null, 'original_url' => '/documentos/'.$id]]);
+    public function previewContent(Request $request, int $id)
+    {
+        $this->installed();
+        app(\App\Services\DocumentManagementAccess::class)->assertEditableResource($request->user(), $id);
+        $resource = DB::table('portal_resources')->find($id); abort_unless($resource, 404);
+        $data = $this->validateContent($request);
+        abort_unless((int)$resource->metadata_version === (int)$data['metadata_version'], 409, 'A revisão mudou; recupere antes de rever a prévia.');
+        return response()->json(['article' => app(\App\Services\EditorialReading::class)->reading($resource, $this->edition($resource, $data), true)])
+            ->header('Cache-Control', 'private, no-store')->header('X-Robots-Tag', 'noindex, nofollow');
+    }
+
+    public function show(Request $request, int $id)
+    {
+        $this->installed();
+        $resource = app(\App\Services\EditorialReading::class)->publicResources()->where('r.id', $id)->first(['r.*']);
+        abort_unless($resource, 404);
+        return Inertia::render('portal/article', ['article' => app(\App\Services\EditorialReading::class)->reading($resource)])->toResponse($request)->header('Cache-Control', 'private, no-store');
     }
 }

app/Http/Controllers/InvestmentComplementController.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Services\InvestmentComplements;
+use Illuminate\Http\Request;
+
+final class InvestmentComplementController extends Controller
+{
+    public function index(Request $request, InvestmentComplements $service)
+    {
+        $data = $request->validate(['origin' => [\Illuminate\Validation\Rule::requiredIf(!$request->has('contexts')), 'nullable', 'string', 'max:100'], 'territory_id' => 'nullable|uuid',
+            'contexts' => 'sometimes|array|max:100', 'contexts.*' => 'array:origin,territory_id', 'contexts.*.origin' => 'required|string|max:100', 'contexts.*.territory_id' => 'nullable|uuid']);
+        $items = [];
+        $issues = [];
+        foreach ($data['contexts'] ?? [['origin' => $data['origin'], 'territory_id' => $data['territory_id'] ?? null]] as $context) {
+            try {
+                $items = [...$items, ...$service->options($context['origin'], $context['territory_id'] ?? null)];
+            } catch (\Illuminate\Database\Eloquent\ModelNotFoundException|\Symfony\Component\HttpKernel\Exception\HttpException $e) {
+                $status = $e instanceof \Symfony\Component\HttpKernel\Exception\HttpException ? $e->getStatusCode() : 404;
+                if (!isset($data['contexts']) || $status !== 404) throw $e;
+                $issues[] = ['origin' => $context['origin'], 'message' => 'Uma referência escolhida deixou de estar disponível para consulta pública. A relação guardada conserva-se no dossier; os outros complementos continuam disponíveis.'];
+            }
+        }
+        return response()->json(isset($data['contexts']) ? ['items' => $items, 'issues' => $issues] : $items)->header('Cache-Control', 'private, no-store');
+    }
+}

app/Http/Controllers/InvestmentDiscoveryController.php

@@ -26,7 +26,9 @@ 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(),
             'favourites' => $request->user() ? DB::table('opportunity_favourites')->where('user_id', $request->user()->id)->pluck('opportunity_id') : [],
             'territorial' => $this->territorial($filters)]);
@@ -87,7 +89,7 @@ class InvestmentDiscoveryController extends Controller
         $data = $request->validate(['zone_id' => ['nullable', 'uuid'], 'from_dossier' => ['nullable', 'uuid']]);
         $dossierOrigin = isset($data['from_dossier']) ? InvestmentPortfolioController::visible()->whereKey($data['from_dossier'])->firstOrFail() : null;
         if ($dossierOrigin) {
-            $linked = false;
+            $linked = in_array($record->id, app(\App\Services\CorridorAgribusinessOpportunities::class)->portfolioOpportunityIds($dossierOrigin), true);
             foreach (['projects' => 'project_id', 'clusters' => 'cluster_id', 'corridors' => 'corridor_id'] as $relation => $foreign) {
                 if ($dossierOrigin->$foreign && DB::table('opportunity_'.$relation)->where('opportunity_id', $record->id)->where($foreign, $dossierOrigin->$foreign)->exists()) {
                     $linked = true;
@@ -105,7 +107,8 @@ class InvestmentDiscoveryController extends Controller
         $returnFilters = $request->query();
         unset($returnFilters['zone_id'], $returnFilters['from_dossier']);
 
-        return Inertia::render('investment/detail', ['record' => $record, 'context' => $catalogue->context($record->id), 'zone_origin' => $origin,
+        return Inertia::render('investment/detail', ['complements' => app(\App\Services\InvestmentComplements::class)->options('opportunity:'.$record->id), 'record' => $record, 'context' => $catalogue->context($record->id), 'zone_origin' => $origin,
+            'guides' => app(\App\Services\SectorInvestment::class)->guides($record->sector),
             'dossierOrigin' => $dossierOrigin ? ['id' => $dossierOrigin->id, 'title' => $dossierOrigin->title] : null,
             'returnUrl' => $returnFilters === [] ? '/oportunidades' : '/oportunidades?'.http_build_query($returnFilters)]);
     }

app/Http/Controllers/InvestmentLegalSourceController.php

@@ -40,6 +40,7 @@ class InvestmentLegalSourceController extends Controller
         $data = $request->validate(['version_no' => ['required', 'integer', 'min:1']]);
 
         return DB::transaction(function () use ($request, $id, $action, $data) {
+            DB::select('select pg_advisory_xact_lock(261022, hashtext(?))', [$id]);
             $source = InvestmentLegalSource::whereKey($id)->lockForUpdate()->firstOrFail();
             abort_if((int) $source->version_no !== (int) $data['version_no'], 409, 'Versão alterada.');
             if ($action === 'validate') {

app/Http/Controllers/InvestmentPortfolioController.php

@@ -61,8 +61,15 @@ class InvestmentPortfolioController extends Controller
     {
         $management = $request->routeIs('management.portfolio*');
         $filters = $request->validate(['q' => ['nullable', 'string', 'max:120'], 'kind' => ['nullable', 'in:corridor,cluster,project'],
+            'sector' => ['nullable', 'string', 'max:500'],
             'province_id' => ['nullable', 'uuid'], 'district_id' => ['nullable', 'uuid'], 'admin_post_id' => ['nullable', 'uuid'], 'locality_id' => ['nullable', 'uuid']]);
         $query = $management ? InvestmentDossier::query() : self::visible();
+        $sectorOptions = ($management ? InvestmentDossier::query() : self::visible())
+            ->whereNotNull('content->sector')->get()->pluck('content.sector')
+            ->filter(fn ($sector) => is_string($sector) && trim($sector) !== '')->unique()->sort()->values();
+        if (! empty($filters['sector'])) {
+            $query->where('content->sector', $filters['sector']);
+        }
         if (! empty($filters['kind'])) {
             $query->whereNotNull($filters['kind'].'_id');
         }
@@ -76,7 +83,7 @@ class InvestmentPortfolioController extends Controller
         }
 
         return Inertia::render('portfolio/index', ['records' => $query->orderBy('title')->paginate(30)->withQueryString(),
-            'management' => $management, 'filters' => $filters, 'territorySelection' => $territorySelection]);
+            'management' => $management, 'filters' => $filters, 'sectors' => $sectorOptions, 'territorySelection' => $territorySelection]);
     }
 
     public function show(Request $request, string $id): Response
@@ -105,6 +112,7 @@ class InvestmentPortfolioController extends Controller
 
         $opportunities = Opportunity::published()->where(function ($query) use ($record) {
             $query->whereRaw('false');
+            $query->orWhereIn('id', app(\App\Services\CorridorAgribusinessOpportunities::class)->portfolioOpportunityIds($record));
             foreach (['clusters' => 'cluster_id', 'corridors' => 'corridor_id', 'projects' => 'project_id'] as $relation => $foreign) {
                 if ($record->$foreign) {
                     $query->orWhereIn('id', DB::table('opportunity_'.$relation)->where($foreign, $record->$foreign)->select('opportunity_id'));
@@ -130,12 +138,19 @@ class InvestmentPortfolioController extends Controller
                 ->orderByDesc('updated_at')->limit(10)->get(['id', 'version', 'updated_at'])
             : collect();
 
-        return Inertia::render('portfolio/show', ['record' => $record, 'related' => $related, 'management' => $management, 'zones' => $zones,
+        return Inertia::render('portfolio/show', ['complements' => $management ? [] : app(\App\Services\InvestmentComplements::class)->options('portfolio:'.$record->id), 'record' => $record, 'related' => $related, 'management' => $management, 'zones' => $zones,
             'anchorProject' => $anchorProject, 'existingSubmissions' => $existingSubmissions,
             'geography' => app(InvestmentRelations::class)->dossier($record, $management),
             'origin' => $origin ? ['id' => $origin->id, 'title' => $origin->title] : null, 'opportunities' => $opportunities, 'chains' => $chains]);
     }
 
+    public function resumeInterest(Request $request, string $id): RedirectResponse
+    {
+        self::visible()->findOrFail($id);
+        $data = $request->validate(['catalogue_query' => ['nullable', 'string', 'max:4000']]);
+        return redirect('/carteira/'.$id.'?'.http_build_query([...$data, 'prepare_interest' => '1']));
+    }
+
     public function save(Request $request, InvestmentDossier $dossier): RedirectResponse
     {
         $data = $request->validate(['version_no' => ['required', 'integer', 'min:1'], 'title' => ['required', 'string', 'max:255'], 'source' => ['required', 'string', 'max:2000'],

app/Http/Controllers/InvestmentSubmissionController.php

@@ -170,8 +170,10 @@ class InvestmentSubmissionController extends Controller
             // Binding does not save form edits or assert that the context has been reviewed.
             $this->event($row, $request, 'context_bound');
             $desk->event($desk->case($request->user(), $case->id), $request->user(), 'manifestation_context_bound', ['submission_id' => $id, 'previous_case_version' => (int) $case->version]);
+
             return ['case_id' => $case->id, 'version' => $row->version, 'case_version' => (int) $case->version + 1, 'replayed' => false];
         }, 3);
+
         return response()->json($result);
     }
 
@@ -190,11 +192,14 @@ class InvestmentSubmissionController extends Controller
     {
         $required = $submitting ? 'required' : 'nullable';
         $data = $request->validate(['version' => ['required', 'integer', 'min:1'],
-            'payload' => ['required', 'array:full_name,email,phone,country,residence_country_code,incorporation_country_code,organization_country_snapshot,declared_origin_country_code,organisation,representative_role,experience,investment_capacity,profile_id,sector,objective,participation_id,partnership_id,estimated_amount,currency,horizon,location,cluster_ids,corridor_ids,project_ids,contact_consent,other_details'],
+            'payload' => ['required', 'array:context_opportunity,context_opportunity_snapshot,context_reuse,full_name,email,phone,country,residence_country_code,incorporation_country_code,organization_country_snapshot,declared_origin_country_code,organisation,representative_role,experience,investment_capacity,profile_id,sector,objective,participation_id,partnership_id,estimated_amount,currency,horizon,location,cluster_ids,corridor_ids,project_ids,contact_consent,other_details'],
             'payload.organization_country_snapshot' => ['sometimes', 'array', 'max:10'],
             'payload.residence_country_code' => ['nullable', 'string', app(CountryCatalogue::class)->rule()],
             'payload.incorporation_country_code' => ['nullable', 'string', app(CountryCatalogue::class)->rule()],
             'payload.declared_origin_country_code' => ['nullable', 'string', app(CountryCatalogue::class)->rule()],
+            'payload.context_opportunity' => ['nullable', 'string', 'max:100'],
+            'payload.context_opportunity_snapshot' => ['nullable', 'string', 'max:200000'],
+            'payload.context_reuse' => ['nullable', 'string', 'max:10000'],
             'payload.other_details' => ['nullable', 'string', 'max:5000'],
             'payload.full_name' => [$required, 'string', ...($submitting ? ['min:3'] : []), 'max:150'], 'payload.email' => [$required, $submitting ? 'email:rfc' : 'string', 'max:150'],
             'payload.phone' => ['nullable', 'string', 'max:30'], 'payload.country' => [$submitting ? 'required_without:payload.declared_origin_country_code' : 'nullable', 'nullable', 'string', 'max:100'],
@@ -244,6 +249,9 @@ class InvestmentSubmissionController extends Controller
             }
         }
 
+        $bound = DB::table('desk_cases')->where('submission_id', $request->route('id'))->where('user_id', $request->user()->id)->whereNotNull('journey_id')->first();
+        if ($bound) $data['payload'] = app(\App\Services\InvestmentConsumerScope::class)->bind($request->user(), $bound->id, $data['payload'], $submitting);
+        else unset($data['payload']['context_opportunity'], $data['payload']['context_opportunity_snapshot']);
         return $data;
     }
 
@@ -263,7 +271,7 @@ class InvestmentSubmissionController extends Controller
         $version = DB::transaction(function () use ($request, $id, $data) {
             $row = $this->owned($request, $id, true, true);
             abort_unless($row->status === 'draft' && $row->version === (int) $data['version'], 409, 'Rascunho alterado. Recarregue antes de guardar.');
-            $row->update(['payload' => $this->preserveCountrySource($row, $data['payload']), 'version' => $row->version + 1]);
+            $row->update([...(isset($data['payload']['context_opportunity']) ? ['opportunity_id'=>(int)substr($data['payload']['context_opportunity'],12)] : []), 'payload' => $this->preserveCountrySource($row, $data['payload']), 'version' => $row->version + 1]);
             InvestmentSpecificNeed::where('submission_id', $id)->delete();
             foreach ($data['needs'] ?? [] as $need) {
                 InvestmentSpecificNeed::create([...$need, 'submission_id' => $id]);
@@ -307,7 +315,8 @@ class InvestmentSubmissionController extends Controller
                     return InterestRequest::findOrFail($row->interest_request_id)->reference;
                 }
                 abort_unless($row->version === (int) $data['version'], 409, 'Rascunho alterado. Recarregue.');
-                $opportunity = $row->opportunity_id ? Opportunity::published()->findOrFail($row->opportunity_id) : null;
+                $scopeKey = $data['payload']['context_opportunity'] ?? null;
+                $opportunity = $scopeKey ? Opportunity::published()->findOrFail(substr($scopeKey,12)) : ($row->opportunity_id ? Opportunity::published()->findOrFail($row->opportunity_id) : null);
                 if ($row->dossier_id) {
                     InvestmentPortfolioController::visible()->findOrFail($row->dossier_id);
                 }
@@ -328,12 +337,14 @@ class InvestmentSubmissionController extends Controller
                         'sector_interest' => $p['sector'], 'message' => $p['objective'], 'privacy_consent' => true, 'consented_at' => now(),
                         'status' => 'received', 'source_page' => '/investidor/manifestacoes/'.$id,
                         'metadata' => ['submission_id' => $id, 'portal_user_id' => $request->user()->id, 'dossier_id' => $row->dossier_id,
+                            'context_opportunity' => $p['context_opportunity'] ?? null,
+                            'context_opportunity_snapshot' => $p['context_opportunity_snapshot'] ?? null,
                             'declared_origin_country_code' => $p['declared_origin_country_code'] ?? null,
                             'residence_country_code' => $p['residence_country_code'] ?? null,
                             'incorporation_country_code' => $p['incorporation_country_code'] ?? null,
                             ...(isset($p['organization_country_snapshot']) ? ['organization_country_snapshot' => $p['organization_country_snapshot']] : []),
                             ...($zoneOrigin ? ['zone_origin' => (array) $zoneOrigin] : [])]]));
-                $row->update(['payload' => $p, 'version' => $row->version + 1, 'interest_request_id' => $interest->id, 'status' => 'submitted']);
+                $row->update(['opportunity_id'=>$opportunity?->id, 'payload' => $p, 'version' => $row->version + 1, 'interest_request_id' => $interest->id, 'status' => 'submitted']);
                 InvestmentSpecificNeed::where('submission_id', $id)->delete();
                 foreach ($data['needs'] ?? [] as $need) {
                     InvestmentSpecificNeed::create([...$need, 'submission_id' => $id]);

app/Http/Controllers/InvestmentTerritoryController.php

@@ -19,12 +19,21 @@ class InvestmentTerritoryController extends Controller
         $data = $request->validate(['territory_id' => ['required', 'uuid']]);
         $profile = $request->is('minhas-oportunidades/*');
         $management = $request->is('management/*') || $profile;
+        $actor = $request->user();
+        $access = app(PortalProfileAccess::class);
+        // The general consumers use this same endpoint while authenticated.
+        // Reuse the read access already granted by the private cadastral routes.
+        $profileAccess = $actor && $actor->hasVerifiedEmail()
+            && ($access->grants($actor) !== [] || $access->superuser($actor));
+        $internal = $profileAccess || ($actor?->hasVerifiedEmail() && $actor->can('manage-portal'));
         if ($management) {
-            $access = app(PortalProfileAccess::class);
-            abort_unless($profile ? ($access->grants($request->user()) !== [] || $access->superuser($request->user())) : $request->user()?->can('manage-portal'), 403);
+            abort_unless($profile ? $profileAccess : $internal, 403);
         }
 
-        return response()->json(app(TerritoryGeometry::class)->context($data['territory_id'], $management));
+        return response()->json([
+            ...app(TerritoryGeometry::class)->context($data['territory_id'], $internal),
+            'geometry_scope' => $internal ? 'authorized_internal' : 'public',
+        ])->header('Cache-Control', 'private, no-store');
     }
 
     private const TABLES = ['opportunities' => 'opportunities', 'projects' => 'projects', 'clusters' => 'economic_clusters', 'corridors' => 'development_corridors', 'zones' => 'investment_zones'];

app/Http/Controllers/InvestorContextController.php

@@ -11,6 +11,36 @@ use Inertia\Inertia;
 
 final class InvestorContextController extends Controller
 {
+    private function entryComplements(Request $request): array
+    {
+        $data = $request->validate(['complement_origin' => 'nullable|string|max:100', 'complement_code' => 'required_with:complement_origin|string|max:40',
+            'complement_target' => 'nullable|string|max:100', 'complement_territory' => 'nullable|uuid']);
+        if (empty($data['complement_origin'])) return [];
+        return app(\App\Services\InvestmentComplements::class)->resolve([['origin' => $data['complement_origin'], 'code' => $data['complement_code'],
+            'target' => $data['complement_target'] ?? null, 'territory_id' => $data['complement_territory'] ?? null]]);
+    }
+
+    private function entryChoices(Request $r, InvestorContext $context): array
+    {
+        $data = $r->validate(['source' => 'nullable|string|max:100', 'from_dossier' => 'nullable|uuid', 'opportunities' => 'sometimes|array|max:100', 'opportunities.*' => 'integer|distinct|min:1',
+            'province_id' => 'nullable|uuid', 'district_id' => 'nullable|uuid', 'admin_post_id' => 'nullable|uuid', 'locality_id' => 'nullable|uuid']);
+        $source = !empty($data['source']) ? $context->reference($data['source']) : null;
+        $ids = $data['opportunities'] ?? (($source['kind'] ?? '') === 'opportunity' ? [$source['id']] : []);
+        abort_if(!empty($data['from_dossier']) && !$ids, 422, 'Escolha a oportunidade associada à ficha da carteira.');
+        $path = app(InvestmentGeography::class)->selection($data);
+        $input = array_map(fn($id) => ['source' => 'opportunity:'.$id, ...($path ? ['territory' => 'territory:'.$path[array_key_last($path)]->id] : [])], $ids);
+        if (!empty($data['from_dossier'])) $input[0]['portfolio_origins'] = [$data['from_dossier']];
+        foreach ($this->entryComplements($r) as $complement) {
+            $keys = array_filter([$complement['origin']['key'], $complement['target']['key'] ?? null], fn($key) => str_starts_with($key, 'opportunity:'));
+            foreach ($keys as $key) {
+                if (in_array($key, array_column($input, 'source'), true)) continue;
+                $input[] = ['source' => $key, ...($complement['territory_id'] ? ['territory' => 'territory:'.$complement['territory_id']] : []),
+                    ...(str_starts_with($complement['origin']['key'], 'portfolio:') ? ['portfolio_origins' => [substr($complement['origin']['key'], 10)]] : [])];
+            }
+        }
+        return app(\App\Services\InvestmentOpportunityChoices::class)->resolve($input, [], true);
+    }
+
     public function current(Request $r, InvestorContext $context)
     {
         return response()->json($context->current($r->user()));
@@ -23,7 +53,8 @@ final class InvestorContextController extends Controller
 
     public function show(Request $r, string $id, InvestorContext $context)
     {
-        return response()->json($context->view($r->user(), $id));
+        $data = $r->validate(['opportunity' => 'nullable|string|max:100']);
+        return response()->json($context->view($r->user(), $id, $data['opportunity'] ?? null));
     }
 
     public function options(Request $r, InvestorContext $context)
@@ -33,12 +64,56 @@ final class InvestorContextController extends Controller
         return response()->json($context->options($d['q'] ?? ''));
     }
 
+    public function corridorOptions(Request $r)
+    {
+        $data = $r->validate(['corridor' => ['nullable', \Illuminate\Validation\Rule::in(array_keys(config('investment_corridors')))], 'territory' => 'nullable|uuid']);
+        $service = app(\App\Services\InvestmentCorridorContext::class);
+        return response()->json(['corridors' => collect(config('investment_corridors'))->map(fn($entry,$key)=>['key'=>$key,'name'=>$entry['name'],'provinces'=>$service->provinces($key)])->values(),
+            'parks' => $service->parks($data['corridor'] ?? null, $data['territory'] ?? null)]);
+    }
+
+    public function saveDraft(Request $r, string $id, InvestorContext $context)
+    {
+        return response()->json($context->saveDraft($r->user(), $id, $r->all()));
+    }
+
     public function edit(Request $r, string $id, InvestorContext $context)
     {
         $data = $context->view($r->user(), $id);
         abort_unless($data['can_write'], 403);
 
-        return Inertia::render('investor-path/context', ['initial' => $data, 'options' => $context->options(), 'source' => $r->query('source') ? $context->reference($r->validate(['source' => 'required|string|max:100'])['source']) : null, 'territorySelection' => isset($data['context']['selection']['territory']) ? app(InvestmentGeography::class)->path($data['context']['selection']['territory']['id']) : []]);
+        $entries = $this->entryChoices($r, $context);
+        $choices = $entries ?: null;
+        $source = $r->query('source') ? $context->reference($r->validate(['source' => 'required|string|max:100'])['source']) : null;
+        if ($choices === null && ($source['kind'] ?? '') === 'opportunity') $choices = app(\App\Services\InvestmentOpportunityChoices::class)->resolve([['source' => $source['key']]]);
+        $explicitChoices=$choices;
+        $selectionKey=$r->validate(['selection_key'=>'nullable|uuid'])['selection_key']??null;
+        $entryKey=fn($c)=>$c['opportunity']['key'].($selectionKey?'@'.$selectionKey:'');
+        $entrySources=array_map($entryKey,$explicitChoices??[]);
+        if ($choices !== null) $choices = app(\App\Services\InvestmentOpportunityChoices::class)->mergeEntries($data['context']['opportunity_choices'] ?? [], $choices);
+        $draft = $context->draft($r->user(), $id);
+        if ($draft && isset($draft['opportunity_choices'])) {
+            $recovered = app(\App\Services\InvestmentOpportunityChoices::class)->resolve($draft['opportunity_choices'], $data['context']['opportunity_choices'] ?? [], true);
+            $new=array_filter($explicitChoices??[],fn($c)=>!in_array($entryKey($c),$draft['entry_sources']??[],true));
+            $choices = app(\App\Services\InvestmentOpportunityChoices::class)->mergeEntries($recovered, array_values($new));
+        }
+        $differences = [];
+        foreach ($explicitChoices ?? [] as $entry) {
+            $kept = collect($choices ?? [])->firstWhere('opportunity.key', $entry['opportunity']['key']);
+            if ($kept && ($kept['territory']['key'] ?? null) !== ($entry['territory']['key'] ?? null)) $differences[] = ['title'=>$entry['opportunity']['title'],'saved'=>$kept['territory']['title']??'Por definir','requested'=>$entry['territory']['title']??'Por definir'];
+        }
+        $complements = isset($draft['complements']) ? app(\App\Services\InvestmentComplements::class)->resolve($draft['complements'], $data['context']['complements'] ?? []) : ($data['context']['complements'] ?? []);
+        $entryTerritory = null;
+        if (($source['kind'] ?? null) === 'portfolio') {
+            $path = app(InvestmentGeography::class)->selection($r->validate(['province_id' => 'nullable|uuid', 'district_id' => 'nullable|uuid', 'admin_post_id' => 'nullable|uuid', 'locality_id' => 'nullable|uuid']));
+            if ($path) $entryTerritory = $context->reference('territory:'.$path[array_key_last($path)]->id);
+        }
+        foreach ($this->entryComplements($r) as $entry) {
+            $tag = 'complement:'.hash('sha256', $entry['key'].'@'.($selectionKey ?? ''));
+            $entrySources[] = $tag;
+            if (!in_array($tag, $draft['entry_sources'] ?? [], true)) $complements = collect([...$complements, $entry])->unique('key')->values()->all();
+        }
+        return Inertia::render('investor-path/context', ['entryTerritory' => $entryTerritory, 'entryComplements' => $complements, 'entryLocationDifferences'=>$differences,'entrySources'=>$entrySources,'draft' => $draft, 'requestedChoices' => $choices, 'initial' => $data, 'options' => $context->options(), 'source' => $source, 'territorySelection' => isset($data['context']['selection']['territory']) ? app(InvestmentGeography::class)->path($data['context']['selection']['territory']['id']) : ($entryTerritory ? app(InvestmentGeography::class)->path($entryTerritory['id']) : [])]);
     }
 
     public function preview(Request $r, string $id, InvestorContext $context)
@@ -55,8 +130,16 @@ final class InvestorContextController extends Controller
     {
         $d = $r->validate(['source' => 'nullable|string|max:100', 'step' => ['nullable', 'regex:/^S(0[1-9]|1[0-9])$/']]);
         $ref = isset($d['source']) ? $context->reference($d['source']) : null;
+        $submissionId = $r->validate(['submission' => 'nullable|uuid'])['submission'] ?? null;
+        $entrySubmission = null;
+        if ($submissionId) {
+            $submission = \App\Models\InvestmentSubmission::where('id', $submissionId)->where('user_id', $r->user()->id)->where('status', 'draft')->firstOrFail();
+            abort_unless(($ref['kind'] ?? null) === 'portfolio' && $submission->dossier_id === $ref['id'], 422, 'Conserve a ficha de origem da manifestação.');
+            $entrySubmission = ['id' => $submission->id, 'version' => $submission->version];
+        }
 
-        return Inertia::render('investor-path/context-start', ['contexts' => $path->contexts($r->user()), 'source' => $ref, 'step' => $d['step'] ?? null]);
+        $choices = $this->entryChoices($r, $context);
+        return Inertia::render('investor-path/context-start', ['entrySubmission' => $entrySubmission, 'entryComplements' => $this->entryComplements($r), 'entryQuery' => $r->only(['complement_origin', 'complement_code', 'complement_target', 'complement_territory', 'from_dossier', 'province_id', 'district_id', 'admin_post_id', 'locality_id']), 'opportunityChoices' => $choices, 'contexts' => $path->contexts($r->user()), 'source' => $ref, 'step' => $d['step'] ?? null]);
     }
 
     public function installation(Request $r, InvestorContextInstallation $install)

app/Http/Controllers/InvestorPathController.php

@@ -88,7 +88,8 @@ class InvestorPathController extends Controller
 
     public function show(Request $request, string $id, InvestorPath $path): JsonResponse|Response
     {
-        $data = $path->view($request->user(), $id);
+        $choice = $request->validate(['opportunity' => 'nullable|string|max:100'])['opportunity'] ?? null;
+        $data = $path->view($request->user(), $id, $choice);
 
         return $request->expectsJson() ? response()->json($data) : Inertia::render('investor-path/show', $data);
     }

app/Http/Controllers/OpportunityManagementController.php

@@ -103,6 +103,7 @@ class OpportunityManagementController extends Controller
         $records = $query->orderByDesc('id')->paginate(20)->withQueryString();
         $records->getCollection()->each(function (Opportunity $r) use ($access, $service, $request) {
             $r->setAttribute('can_edit', $access->canEdit($request->user(), $r));
+            $r->setAttribute('can_promote', app(\App\Services\OpportunityPromotion::class)->allowed($request->user(), $r));
             $r->setAttribute('working_status', $access->state($r));
             $r->setAttribute('publication', $r->publicationPresentation());
             $r->setAttribute('draft_title', $service->values($r)['canonical']['official_title'] ?? $r->title);
@@ -130,6 +131,7 @@ class OpportunityManagementController extends Controller
             'profileReauthenticationRequired' => $record && $record->owner_user_id !== null
                 ? app(OpportunityProfileWorkflow::class)->reauthenticationRequired($request->user(), $record) : false,
             'publicationState' => $record?->publicationPresentation(),
+            'promotionHref' => $record && app(\App\Services\OpportunityPromotion::class)->allowed($request->user(), $record) ? '/minhas-oportunidades/'.$record->id.'/divulgacao' : null,
             'canonicalResponse' => $record?->owner_user_id !== null ? app(OpportunityCanonicalResponse::class)->read($request->user(), $record) : null,
             'canEditDraft' => $record ? $access->canEdit($request->user(), $record) : false,
             'workflowParticipants' => $record && $record->owner_user_id !== null ? app(OpportunityProfileWorkflow::class)->participants($request->user(), $record) : ['validators' => [], 'publishers' => []],

app/Http/Controllers/OpportunityPromotionController.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\Opportunity;
+use App\Services\OpportunityPromotion;
+use Illuminate\Http\Request;
+use Inertia\Inertia;
+
+final class OpportunityPromotionController extends Controller
+{
+    public function show(Request $request, int $id, OpportunityPromotion $service): \Inertia\Response
+    {
+        return Inertia::render('management/opportunity-promotion', $service->editor($request->user(), Opportunity::findOrFail($id)));
+    }
+
+    public function preview(Request $request, int $id, OpportunityPromotion $service): \Illuminate\Http\JsonResponse
+    {
+        return response()->json($service->preview($request->user(), Opportunity::findOrFail($id), $request->all()));
+    }
+
+    public function confirm(Request $request, int $id, OpportunityPromotion $service): \Illuminate\Http\JsonResponse
+    {
+        return response()->json($service->confirm($request->user(), $id, $request->all()));
+    }
+}

app/Http/Controllers/PortalServicesController.php

@@ -9,6 +9,7 @@ use App\Services\CountryCatalogue;
 use App\Services\IdempotencyConflict;
 use App\Services\InterestSubmission;
 use App\Services\LegacyContent;
+use App\Services\PortalProfileAccess;
 use App\Services\Malware\MalwareScanner;
 use App\Services\VerifiedDocumentBinary;
 use App\Services\VirtualDesk;
@@ -274,7 +275,7 @@ class PortalServicesController extends Controller
             'resource' => $resource,
             'backUrl' => $backUrl,
             'downloadUrl' => route('services.download', ['id' => $id]),
-            'articleUrl' => Schema::hasColumn('portal_resources','editorial_content') && DB::table('portal_resources')->where('id',$id)->whereNotNull('editorial_content')->exists() ? '/artigos/'.$id : null,
+            'articleUrl' => $this->articleUrl($id),
         ]);
     }
 
@@ -297,6 +298,7 @@ class PortalServicesController extends Controller
 
     public function manage(Request $request, MalwareScanner $scanner): Response
     {
+        $managementFilters = $request->validate(['q' => 'nullable|string|max:150', 'state' => 'nullable|in:draft,published,withdrawn', 'intent' => 'nullable|in:document,legislation']);
         $access = app(\App\Services\DocumentManagementAccess::class);
         if (! $access->full($request->user())) {
             $documents = $access->documents($request->user())->where('status', '!=', 'deleted');
@@ -304,7 +306,7 @@ class PortalServicesController extends Controller
             $health['signatures_at'] = $health['signatures_at']?->format(DATE_ATOM);
 
             $editorial = $access->editorial($request->user());
-            $resources = $editorial ? $access->editorialResources($request->user())->orderByDesc('r.updated_at')
+            $resources = $editorial ? $this->filterManagedResources($access->editorialResources($request->user()), $managementFilters)->orderByDesc('r.updated_at')
                 ->get(['r.*', 'd.file_name', 'd.media_type', 'd.size_bytes', 'd.issuer', 'd.status as file_status', 'd.data_classification', 'd.version_no as file_version', 'd.rights_status as file_rights_status', 'd.malware_scan_status', 'd.malware_failure_reason']) : collect();
             $links = DB::table('portal_resource_links')->whereIn('resource_id', $resources->pluck('id'))->orderBy('id')->get()->groupBy('resource_id');
             $revisions = DB::table('portal_resource_revisions')->whereIn('resource_id', $resources->pluck('id'))->orderByDesc('revision_no')->get(['resource_id', 'revision_no', 'change_type', 'actor_user_id', 'created_at'])->groupBy('resource_id');
@@ -313,6 +315,7 @@ class PortalServicesController extends Controller
                 $resource->revisions = $revisions->get($resource->id, collect())->values();
             });
             return Inertia::render('portal/manage', [
+                'managementFilters' => $managementFilters, 'associationOptions' => $this->contentAssociations($request),
                 'documentAccessOnly' => ! $editorial, 'editorialScopeOnly' => $editorial, 'resources' => $resources, 'partnerships' => [], 'territories' => [],
                 'requirementCatalogue' => [], 'requirementAssociationsEnabled' => false,
                 'disclosureAuthorization' => null, 'incompleteCount' => $resources->filter(fn ($r) => ! $r->description || ! $r->issuer || ! $r->source_url || $r->source_confirmation === 'unconfirmed' || $r->legal_status === 'unknown' || $r->rights_status === 'unconfirmed')->count(), 'possibleDuplicates' => $resources->whereNotNull('duplicate_of_resource_id')->count(),
@@ -331,7 +334,7 @@ class PortalServicesController extends Controller
             ->where('external_id', 'document-repository-disclosure-authorization-2026-10-06-v1')
             ->where('action', 'public_disclosure_authorized')->first(['external_id', 'occurred_at', 'after_data']);
         $disclosureAuthorizationData = $disclosureAuthorization ? json_decode($disclosureAuthorization->after_data, true) : null;
-        $resources = DB::table('portal_resources as r')->join('documents as d', 'd.id', '=', 'r.document_id')->orderByDesc('r.updated_at')->limit(200)
+        $resources = $this->filterManagedResources(DB::table('portal_resources as r')->join('documents as d', 'd.id', '=', 'r.document_id')->whereNull('d.deleted_at'), $managementFilters)->orderByDesc('r.updated_at')->limit(200)
             ->get(['r.*', 'd.file_name', 'd.media_type', 'd.size_bytes', 'd.issuer', 'd.status as file_status', 'd.data_classification', 'd.version_no as file_version', 'd.rights_status as file_rights_status', 'd.malware_scan_status', 'd.malware_failure_reason']);
         $links = DB::table('portal_resource_links')->whereIn('resource_id', $resources->pluck('id'))->orderBy('id')->get()->groupBy('resource_id');
         $resources->each(fn ($resource) => $resource->links = $links->get($resource->id, collect())->values());
@@ -342,6 +345,7 @@ class PortalServicesController extends Controller
         $malwareHealth['signatures_at'] = $malwareHealth['signatures_at']?->format(DATE_ATOM);
 
         return Inertia::render('portal/manage', ['resources' => $resources,
+            'managementFilters' => $managementFilters, 'associationOptions' => $this->contentAssociations($request),
             'requirementCatalogue' => $this->requirementEvidenceEnabled()
                 ? collect(is_array($catalogue = config('document-requirements.catalogue', [])) ? $catalogue : [])->map(fn ($item, $key) => ['key' => $key, ...$item])->values()
                 : collect(),
@@ -367,6 +371,39 @@ class PortalServicesController extends Controller
             'possibleDuplicates' => DB::table('portal_resources')->whereNotNull('duplicate_of_resource_id')->count()]);
     }
 
+    private function filterManagedResources(Builder $query, array $filters): Builder
+    {
+        if (! empty($filters['q'])) {
+            $term = '%'.addcslashes($filters['q'], '%_\\').'%';
+            $query->where(fn ($q) => $q->where('r.title', 'ilike', $term)->orWhere('r.document_number', 'ilike', $term)->orWhere('d.issuer', 'ilike', $term)->orWhere('d.file_name', 'ilike', $term));
+        }
+        if (! empty($filters['state'])) {
+            $query->where('r.published', $filters['state'] === 'published');
+            if ($filters['state'] !== 'published') {
+                $method = $filters['state'] === 'withdrawn' ? 'whereExists' : 'whereNotExists';
+                $query->$method(fn ($q) => $q->selectRaw('1')->from('portal_resource_revisions as history')->whereColumn('history.resource_id', 'r.id')->whereIn('history.change_type', ['unpublished', 'withdrawn']));
+            }
+        }
+        return $query;
+    }
+
+    private function contentAssociations(Request $request): array
+    {
+        $access = app(\App\Services\DocumentManagementAccess::class);
+        $resources = $access->full($request->user()) ? DB::table('portal_resources as r')->join('documents as d', 'd.id', '=', 'r.document_id')->whereNull('d.deleted_at')
+            : ($access->editorial($request->user()) ? $access->editorialResources($request->user()) : null);
+        $documents = $resources ? $resources->orderBy('r.title')->get(['r.id as value', 'r.title as label', 'r.document_type']) : collect();
+        return [
+            'sector' => \App\Models\Sector::choices()->orderBy('name')->get(['id as value', 'name as label']),
+            'territory' => app(\App\Services\InvestmentGeography::class)->publicReferences()->orderBy('name')->get(['id as value', 'name as label']),
+            'opportunity' => app(PortalProfileAccess::class)->scope(\App\Models\Opportunity::query(), $request->user())->orderBy('title')->get(['id as value', 'title as label']),
+            'document' => $documents,
+            'procedure' => $documents->where('document_type', 'procedure')->values(),
+            'stage' => collect(config('virtual-desk.steps', []))->map(fn ($step, $key) => ['value' => $key, 'label' => $step['title']])->values(),
+            'activity' => app(\App\Services\EconomicReferenceCatalog::class)->activities()->map(fn ($row) => ['value' => $row->id, 'label' => $row->display_label])->values(),
+        ];
+    }
+
     public function upload(Request $request): RedirectResponse
     {
         $this->validateManagement($request, ['file' => ['required', 'file', 'mimetypes:application/pdf,text/plain,text/csv,image/jpeg,image/png,image/webp,application/msword,application/vnd.openxmlformats-officedocument.wordprocessingml.document,application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,application/vnd.oasis.opendocument.text'.(app(LegacyContent::class)->available() ? ',application/json' : ''), 'max:10240'],
@@ -399,7 +436,7 @@ class PortalServicesController extends Controller
 
         ScanDocumentForMalware::dispatch($id)->afterCommit();
 
-        return to_route('services.manage')->with('success', 'Documento recebido em armazenamento privado e quarentena. Não aparece na biblioteca pública até validação e publicação explícitas.');
+        return to_route('services.manage', array_filter(['intent' => in_array($request->input('intent'), ['document', 'legislation'], true) ? $request->input('intent') : null]))->with('uploaded_document_id', $id)->with('success', 'Documento recebido em armazenamento privado e quarentena. Não aparece na biblioteca pública até validação e publicação explícitas.');
     }
 
     public function resource(Request $request): RedirectResponse
@@ -663,7 +700,7 @@ class PortalServicesController extends Controller
             'data_classification' => ['nullable', 'in:internal,public'],
             'source_reference' => ['required', 'string', 'min:10', 'max:2000'],
             'legislation' => ['required', 'boolean'], 'essential' => ['required', 'boolean'],
-            'associations' => ['nullable', 'array', 'max:40'], 'associations.*.target_type' => ['required', 'in:theme,module,activity,stage,procedure,entity,territory,document,investment_type,legal_source'.($this->requirementEvidenceEnabled() ? ',requirement' : '')],
+            'associations' => ['nullable', 'array', 'max:40'], 'associations.*.target_type' => ['required', 'in:theme,module,activity,stage,procedure,entity,territory,document,investment_type,legal_source,sector,opportunity'.($this->requirementEvidenceEnabled() ? ',requirement' : '')],
             'associations.*.target_key' => ['required', 'string', 'max:180'],
             'associations.*.review_status' => ['nullable', 'in:pending,confirmed'],
             'associations.*.relationship' => ['required', 'in:applies_to,supports,version_of,translation_of,amends,repeals,implements,cites,related_to'],
@@ -829,4 +866,17 @@ SQL, [$id]);
 
         return $ids ?: [$id];
     }
+    private function articleUrl(int $id): ?string
+    {
+        if (!Schema::hasColumn('portal_resources', 'editorial_content')) return null;
+        $resource = DB::table('portal_resources')->find($id);
+        if (!$resource) return null;
+        if ($resource->editorial_content !== null) return '/artigos/'.$id;
+        try {
+            return app(\App\Services\EditorialReading::class)->original($resource) ? '/artigos/'.$resource->id : null;
+        } catch (\Symfony\Component\HttpKernel\Exception\HttpException) {
+            return null;
+        }
+    }
+
 }

app/Http/Controllers/ProcurementController.php

@@ -0,0 +1,138 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Services\Procurement;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+use Inertia\Inertia;
+
+class ProcurementController extends Controller
+{
+    private const STATE_SQL = "CASE WHEN v.payload->>'procedural_state' IN ('cancelled','results') THEN v.payload->>'procedural_state' WHEN ((v.payload->>'deadline')::timestamp AT TIME ZONE (v.payload->>'timezone'))<=CURRENT_TIMESTAMP THEN 'deadline_ended' WHEN v.payload->>'extended'='true' THEN 'extended' ELSE 'open' END";
+
+    private function query(Procurement $service)
+    {
+        abort_unless($service->available(), 404);
+
+        return DB::table('portal_tenders as t')->join('portal_tender_versions as v', fn ($q) => $q->on('v.id', '=', 't.published_version_id')->on('v.tender_id', '=', 't.id'))->whereNotNull('v.published_at');
+    }
+
+    public function index(Request $request, Procurement $service)
+    {
+        $filters = $request->validate(['q' => 'nullable|string|max:150', 'entity' => 'nullable|uuid', 'sector' => 'nullable|integer', 'territory' => 'nullable|uuid', 'modality' => 'nullable|string|max:200', 'financier' => 'nullable|string|max:200', 'state' => 'nullable|in:open,extended,deadline_ended,cancelled,results', 'deadline_before' => 'nullable|date_format:Y-m-d', 'regime' => 'nullable|in:state,external,private,other']);
+        $filters = array_filter($filters, fn ($value) => $value !== null && $value !== '');
+        $query = $this->query($service);
+        if (! empty($filters['q'])) {
+            $query->where(fn ($q) => $q->whereRaw("v.payload->>'title' ILIKE ?", ['%'.$filters['q'].'%'])->orWhereRaw("v.payload->>'object' ILIKE ?", ['%'.$filters['q'].'%'])->orWhereRaw("v.payload->>'reference' ILIKE ?", ['%'.$filters['q'].'%']));
+        }
+        foreach (['entity' => 'organization_id', 'sector' => 'sector_id', 'modality' => 'modality', 'financier' => 'financier', 'regime' => 'regime'] as $filter => $field) {
+            if (! empty($filters[$filter])) {
+                $query->whereRaw('v.payload->>? = ?', [$field, (string) $filters[$filter]]);
+            }
+        }
+        if (! empty($filters['territory'])) {
+            $query->whereRaw("v.payload->>'territory_id' IN (WITH RECURSIVE scope(id,depth) AS (SELECT id,0 FROM geo_locations WHERE id=? AND deleted_at IS NULL UNION ALL SELECT c.id,s.depth+1 FROM geo_locations c JOIN scope s ON c.parent_id=s.id WHERE c.deleted_at IS NULL AND s.depth<4) SELECT id::text FROM scope)", [$filters['territory']]);
+        }
+        if (! empty($filters['state'])) {
+            $query->whereRaw(self::STATE_SQL.' = ?', [$filters['state']]);
+        }
+        if (! empty($filters['deadline_before'])) {
+            $query->whereRaw("left(v.payload->>'deadline',10)<=?", [$filters['deadline_before']]);
+        }
+        $rows = $query->select('t.id', 'v.id as vid')->orderByDesc('v.published_at')->paginate(20)->withQueryString();
+        $rows->through(fn ($r) => ['id' => $r->id, ...$this->summary($service, $r->vid)]);
+        $facets = $this->query($service)->get(['v.payload'])->map(fn ($r) => json_decode($r->payload, true));
+        $options = [];
+        foreach (['entity' => ['organization_id', 'organization_name'], 'sector' => ['sector_id', 'sector_name'], 'territory' => ['territory_id', 'territory_name'], 'modality' => ['modality', 'modality'], 'financier' => ['financier', 'financier']] as $name => [$value,$label]) {
+            $options[$name] = $facets->filter(fn ($p) => ! empty($p[$value]))->map(fn ($p) => ['id' => (string) $p[$value], 'name' => $p[$label]])->unique('id')->values();
+        }
+
+        return Inertia::render('procurement/index', ['items' => $rows, 'filters' => $filters, 'options' => $options, 'regimes' => config('procurement.regimes'), 'management' => $service->access($request->user())])->toResponse($request)->header('Cache-Control', 'private, no-store');
+    }
+
+    private function summary(Procurement $service, string $vid): array
+    {
+        $v = $service->publishedVersion($vid);
+
+        return ['publication' => $v, 'state' => $service->state($v)];
+    }
+
+    public function show(Request $request, string $id, Procurement $service)
+    {
+        return $this->detail($request, $id, $service, false);
+    }
+
+    public function print(Request $request, string $id, Procurement $service)
+    {
+        return $this->detail($request, $id, $service, true);
+    }
+
+    private function detail(Request $request, string $id, Procurement $service, bool $print)
+    {
+        $row = $this->query($service)->where('t.id', $id)->firstOrFail(['t.id', 'v.id as vid']);
+        $filters = $request->only(['q', 'entity', 'sector', 'territory', 'modality', 'financier', 'state', 'deadline_before', 'regime', 'page']);
+
+        return Inertia::render('procurement/show', ['id' => $id, ...$this->summary($service, $row->vid), 'printMode' => $print, 'backUrl' => '/concursos'.($filters ? '?'.http_build_query($filters) : ''),
+            'history' => DB::table('portal_tender_versions')->where('tender_id', $id)->whereNotNull('published_at')->orderBy('version')->pluck('id')->map(fn ($vid) => $service->publishedVersion($vid)),
+            'watching' => $request->user() && DB::table('portal_tender_watches')->where('tender_id', $id)->where('user_id', $request->user()->id)->exists()])->toResponse($request)->header('Cache-Control', 'private, no-store');
+    }
+
+    public function manage(Request $request, Procurement $service)
+    {
+        $service->guard($request->user());
+
+        return Inertia::render('procurement/manage', ['items' => DB::table('portal_tenders')->orderByDesc('updated_at')->get(['id', 'draft', 'version', 'published_version_id'])->map(fn ($r) => ['id' => $r->id, 'title' => json_decode($r->draft, true)['title'] ?? 'Rascunho sem título', 'version' => $r->version, 'published' => (bool) $r->published_version_id])])->toResponse($request)->header('Cache-Control', 'private, no-store');
+    }
+
+    public function edit(Request $request, Procurement $service, ?string $id = null)
+    {
+        $service->guard($request->user());
+        $r = $id ? $service->record($id) : null;
+
+        return Inertia::render('procurement/edit', ['record' => $r ? ['id' => $id, 'version' => $r->version, 'draft' => json_decode($r->draft, true), 'published' => (bool) $r->published_version_id] : null,
+            'references' => $service->references($request->user()), 'history' => $id ? DB::table('portal_tender_versions')->where('tender_id', $id)->orderByDesc('version')->get(['version', 'act', 'reason', 'actor_id', 'published_at', 'created_at']) : []])->toResponse($request)->header('Cache-Control', 'private, no-store');
+    }
+
+    public function save(Request $request, Procurement $service, ?string $id = null)
+    {
+        $id = $service->save($request->user(), $id, $request->all());
+
+        return redirect('/management/concursos/'.$id)->with('success', 'Rascunho guardado. A publicação anterior permanece intacta.');
+    }
+
+    public function preview(Request $request, string $id, Procurement $service)
+    {
+        return response()->json($service->preview($request->user(), $id, (string) $request->input('act')))->header('Cache-Control', 'private, no-store');
+    }
+
+    public function publish(Request $request, string $id, Procurement $service)
+    {
+        $service->publish($request->user(), $id, $request->all());
+
+        return redirect('/management/concursos/'.$id)->with('success', 'Acto publicado, com versão e auditoria. Nenhuma proposta recebida pelo portal.');
+    }
+
+    public function watch(Request $request, string $id, Procurement $service)
+    {
+        $row = $this->query($service)->where('t.id', $id)->firstOrFail(['v.id']);
+        DB::table('portal_tender_watches')->updateOrInsert(['tender_id' => $id, 'user_id' => $request->user()->id], ['seen_version_id' => $row->id, 'created_at' => now(), 'updated_at' => now()]);
+
+        return back()->with('success', 'Concurso guardado para acompanhamento. Isto não apresenta uma proposta.');
+    }
+
+    public function unwatch(Request $request, string $id, Procurement $service)
+    {
+        abort_unless($service->available(), 404);
+        DB::table('portal_tender_watches')->where('tender_id', $id)->where('user_id', $request->user()->id)->delete();
+
+        return back();
+    }
+
+    public function watched(Request $request, Procurement $service)
+    {
+        $rows = $this->query($service)->join('portal_tender_watches as w', 'w.tender_id', '=', 't.id')->where('w.user_id', $request->user()->id)->get(['t.id', 'v.id as vid', 'w.seen_version_id'])->map(fn ($r) => ['id' => $r->id, 'changed' => $r->seen_version_id !== $r->vid, ...$this->summary($service, $r->vid)]);
+
+        return Inertia::render('procurement/manage', ['watched' => true, 'items' => $rows])->toResponse($request)->header('Cache-Control', 'private, no-store');
+    }
+}

app/Http/Controllers/PublicGeographyController.php

@@ -11,8 +11,13 @@ class PublicGeographyController extends Controller
 {
     public function options(Request $request, InvestmentGeography $geography): JsonResponse
     {
-        $data = $request->validate(['type' => ['required', 'in:province,district,admin_post,locality'], 'id' => ['nullable', 'uuid'], 'parent_id' => ['nullable', 'uuid'], 'q' => ['nullable', 'string', 'max:100'], 'page' => ['nullable', 'integer', 'min:1']]);
+        $data = $request->validate(['corridor' => ['nullable', \Illuminate\Validation\Rule::in(array_keys(config('investment_corridors')))], 'type' => ['required', 'in:province,district,admin_post,locality'], 'id' => ['nullable', 'uuid'], 'parent_id' => ['nullable', 'uuid'], 'q' => ['nullable', 'string', 'max:100'], 'page' => ['nullable', 'integer', 'min:1']]);
         $query = $geography->publicReferences()->where('location_type', $data['type']);
+        if (!empty($data['corridor'])) {
+            $corridors = app(\App\Services\InvestmentCorridorContext::class);
+            if ($data['type'] === 'province') $query->whereIn('id', array_column($corridors->provinces($data['corridor']), 'id'));
+            elseif (!$corridors->compatible($data['corridor'], $data['parent_id'] ?? null)) abort(422, 'O território não pertence ao corredor escolhido.');
+        }
         if (! empty($data['id'])) {
             $query->where('id', $data['id']);
         }
@@ -29,6 +34,6 @@ class PublicGeographyController extends Controller
                 ->orWhereRaw('source_code ILIKE ?', [$term]));
         }
 
-        return response()->json($query->orderBy('name')->orderBy('id')->paginate(100, ['id', 'name', 'parent_id', 'location_type', 'source_code']));
+        return response()->json($query->orderBy('name')->orderBy('id')->paginate(100, ['id', 'name', 'parent_id', 'location_type', 'source_code'])->withQueryString());
     }
 }

app/Http/Controllers/SimulationFiscalSourceController.php

@@ -0,0 +1,46 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use App\Models\InvestmentLegalSource;
+use App\Services\SimulationTaxGovernanceAccess;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\DB;
+
+/** Explicit fiscal curation of an identified official source; not an independent legal opinion. */
+final class SimulationFiscalSourceController extends Controller
+{
+    public function store(Request $request): JsonResponse
+    {
+        SimulationTaxGovernanceAccess::requireRole($request->user(), 'editors');
+        $data = $request->validate([
+            'title' => ['required', 'string', 'max:255'], 'url' => ['required', 'url:https', 'max:2000'],
+            'diploma' => ['required', 'string', 'max:255'], 'article' => ['required', 'string', 'max:255'],
+            'competent_entity' => ['required', 'string', 'max:255'], 'valid_from' => ['required', 'date_format:Y-m-d'],
+            'valid_until' => ['nullable', 'date_format:Y-m-d', 'after_or_equal:valid_from'],
+            'sha256' => ['required', 'regex:/^[a-f0-9]{64}$/D'],
+            'citation' => ['required', 'string', 'min:10', 'max:2000'],
+            'official_origin' => ['required', 'string', 'min:10', 'max:2000'],
+        ]);
+
+        return DB::transaction(function () use ($request, $data): JsonResponse {
+            $actor = $request->user();
+            $acceptance = ['scope' => 'fiscal_parameters', 'basis' => 'Tempo-official-sources-20261008',
+                'responsible_user_id' => $actor->id, 'sha256' => $data['sha256'], 'citation' => $data['citation'],
+                'official_origin' => $data['official_origin'], 'accepted_at' => now()->toISOString(),
+                'legal_opinion' => false, 'independent_review' => false];
+            unset($data['sha256'], $data['citation'], $data['official_origin']);
+            $source = InvestmentLegalSource::create([...$data, 'owner_id' => $actor->id, 'validator_id' => null,
+                'validation_status' => 'pending', 'validated_at' => null, 'version_no' => 1, 'fiscal_acceptance' => $acceptance]);
+            DB::table('audit_events')->insert(['source_system' => 'simulation-fiscal-maintenance',
+                'entity_type' => 'investment_legal_sources', 'entity_id' => $source->id, 'actor_user_id' => $actor->id,
+                'action' => 'official_source_acceptance', 'after_data' => json_encode([
+                    'source' => $source->attributesToArray(), 'basis' => $acceptance,
+                    'sha256' => hash('sha256', $source->toJson()),
+                ], JSON_THROW_ON_ERROR)]);
+
+            return response()->json($source->fresh(), 201);
+        });
+    }
+}

app/Http/Controllers/SimulationTaxRuleGovernanceController.php

@@ -2,17 +2,51 @@
 
 namespace App\Http\Controllers;
 
+use App\Services\SimulationFiscalQaPreview;
 use App\Services\SimulationTaxParameterResolver;
 use App\Services\SimulationTaxRuleExpression;
 use App\Services\SimulationTaxRuleGovernance;
+use App\Support\IsolatedQaDatabase;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\Validator;
 use Illuminate\Validation\ValidationException;
+use Inertia\Inertia;
+use Inertia\Response;
 use InvalidArgumentException;
 
 class SimulationTaxRuleGovernanceController extends Controller
 {
+    public function qaReview(Request $request, string $id, SimulationTaxRuleGovernance $governance): Response
+    {
+        abort_unless(IsolatedQaDatabase::allowsSchemaChanges(), 404);
+        $rule = $governance->show($request->user(), $id);
+        abort_unless($rule->status === 'draft' && $rule->rule_code === 'IVA-GERAL-BASE-LIQUIDA', 422,
+            'Seleccione o rascunho do primeiro lote fiscal.');
+
+        return Inertia::render('management/fiscal-qa-review', ['rule' => [
+            'id' => $rule->id, 'code' => $rule->rule_code, 'version' => $rule->rule_version,
+        ]]);
+    }
+
+    public function qaPreview(Request $request, string $id, SimulationFiscalQaPreview $preview): JsonResponse
+    {
+        abort_unless(IsolatedQaDatabase::allowsSchemaChanges(), 404);
+        $key = $request->header('Idempotency-Key');
+        abort_unless(is_string($key) && strlen($key) >= 16 && strlen($key) <= 128, 428, 'Idempotency-Key é obrigatório.');
+        $input = $request->validate([
+            'base' => ['required', 'string', 'max:40', 'regex:/^(?:0|[1-9][0-9]*)(?:\.[0-9]+)?$/D'],
+            'reference_date' => ['required', 'date_format:Y-m-d'],
+            'currency' => ['required', 'in:MZN'],
+            'operation' => ['required', 'in:internal_general_net'],
+        ]);
+        $result = $preview->create($request->user(), $id, $input, $key);
+        $simulation = $result['simulation'];
+
+        return response()->json(['data' => $simulation, 'replayed' => $result['replayed']], $result['replayed'] ? 200 : 202)
+            ->header('Location', url('/api/v1/simulations/'.$simulation->id));
+    }
+
     public function index(Request $request, SimulationTaxRuleGovernance $governance): JsonResponse
     {
         $filters = $request->validate([

app/Http/Controllers/VirtualDeskController.php

@@ -119,8 +119,8 @@ class VirtualDeskController extends Controller
 
     public function createRequest(Request $request, string $id, VirtualDesk $desk): JsonResponse|RedirectResponse
     {
-        $data = $request->validate(['service_version_id' => 'required|uuid', 'client_key' => 'required|uuid']);
-        $row = $desk->createRequest($request->user(), $id, $data['service_version_id'], $data['client_key']);
+        $data = $request->validate(['service_version_id' => 'required|uuid', 'client_key' => 'required|uuid', 'opportunity' => 'nullable|string|max:100']);
+        $row = $desk->createRequest($request->user(), $id, $data['service_version_id'], $data['client_key'], $data['opportunity'] ?? null);
 
         return $request->expectsJson() ? response()->json(['id' => $row->id, 'version' => $row->version], 201) : redirect('/balcao-virtual/pedidos/'.$row->id);
     }

app/Http/Middleware/EnsureScopedEditorial.php

@@ -14,7 +14,7 @@ class EnsureScopedEditorial
             return $next($request);
         }
         abort_unless($access->editorial($actor), 403);
-        $allowed = in_array($request->route()->getName(), ['editorial.edit', 'editorial.save', 'services.resource', 'services.resource.update'], true)
+        $allowed = in_array($request->route()->getName(), ['editorial.edit', 'editorial.save', 'editorial.preview', 'editorial.preview-content', 'services.resource', 'services.resource.update'], true)
             || ($request->route()->getName() === 'services.moderate' && $request->route('type') === 'resources');
         abort_unless($allowed, 403);
         if ($request->route('id') !== null) {

app/Http/Middleware/EnsureScopedPortalAdministration.php

@@ -1,31 +1,41 @@
 <?php
+
 namespace App\Http\Middleware;
+
+use App\Services\PortalProfileAccess;
+use App\Services\ScopedPortalAdministration;
+use App\Services\SimulationTaxGovernanceAccess;
 use Closure;
 use Illuminate\Http\Request;
 use Symfony\Component\HttpFoundation\Response;
-use App\Services\ScopedPortalAdministration;
 
 final class EnsureScopedPortalAdministration
 {
     public function handle(Request $request, Closure $next): Response
     {
-        $actor=$request->user();abort_unless($actor,403);
-        $scope=app(ScopedPortalAdministration::class);
-        $path=$request->path();
-        $interests=$request->is('management/interests','management/interests/*','api/v1/investment/admin/interests/*');
-        // Exact areas of P1; unrelated management, fiscal rules and private records keep their gate.
-        $catalogue=$request->is('management/economic-references/lot-01','management/economic-references/lot-01/*',
-            'management/education','management/education/*','management/investment/references','management/investment/references/*','api/v1/investment/admin/references','api/v1/investment/admin/references/*',
-            'management/investment/zones','management/investment/zones/*','api/v2/investment/admin/zones','api/v2/investment/admin/zones/*',
-            'management/balcao/atribuicoes','management/balcao/atribuicoes/*','management/balcao/servicos',
-            'management/balcao/fontes') || ($request->isMethod('GET') && $path==='management/balcao-install');
-        $allowed=$interests ? $scope->interestOperator($actor) : ($catalogue && $scope->administrative($actor));
-        abort_unless($allowed || ($actor->can('manage-portal') && !app(\App\Services\PortalProfileAccess::class)->has($actor,'auditor')),403,'Acesso reservado ao âmbito já designado.');
-        $response=$next($request);
-        if (!$request->isMethod('GET') && $response->getStatusCode()<400) {
-            app(\App\Services\PortalProfileAccess::class)->audit($actor,'scoped_administration',[
-                'method'=>$request->method(),'route'=>$request->route()?->uri(),'scope'=>$interests?'assigned-interest':'catalogue-administration']);
+        $actor = $request->user();
+        abort_unless($actor !== null, 403);
+        $scope = app(ScopedPortalAdministration::class);
+        $path = $request->path();
+        $interests = $request->is('management/interests', 'management/interests/*', 'api/v1/investment/admin/interests/*');
+        // Fiscal maintenance reuses authorised administration; unrelated gates remain unchanged.
+        $geometryRead = $request->isMethod('GET') && $path === 'management/territory-geometries';
+        $catalogue = $geometryRead || $request->is('management/territory-geometry-import', 'management/territory-geometry-import/*',
+            'management/economic-references/lot-01', 'management/economic-references/lot-01/*',
+            'management/education', 'management/education/*', 'management/investment/references', 'management/investment/references/*', 'api/v1/investment/admin/references', 'api/v1/investment/admin/references/*',
+            'management/investment/zones', 'management/investment/zones/*', 'api/v2/investment/admin/zones', 'api/v2/investment/admin/zones/*',
+            'management/balcao/atribuicoes', 'management/balcao/atribuicoes/*', 'management/balcao/servicos',
+            'management/balcao/fontes') || ($request->isMethod('GET') && $path === 'management/balcao-install');
+        $fiscal = $request->is('api/v2/investment/admin/tax-rules', 'api/v2/investment/admin/tax-rules/*',
+            'api/v2/investment/admin/tax-rule-sources', 'management/investment/tax-rules/*');
+        $allowed = ($fiscal && SimulationTaxGovernanceAccess::maintainer($actor)) || ($interests ? $scope->interestOperator($actor) : ($catalogue && $scope->administrative($actor)));
+        abort_unless($allowed || ($actor->can('manage-portal') && ! app(PortalProfileAccess::class)->has($actor, 'auditor')), 403, 'Acesso reservado ao âmbito já designado.');
+        $response = $next($request);
+        if (! $request->isMethod('GET') && $response->getStatusCode() < 400) {
+            app(PortalProfileAccess::class)->audit($actor, 'scoped_administration', [
+                'method' => $request->method(), 'route' => $request->route()?->uri(), 'scope' => $fiscal ? 'fiscal-maintenance' : ($interests ? 'assigned-interest' : 'catalogue-administration')]);
         }
+
         return $response;
     }
 }

app/Http/Middleware/HandleInertiaRequests.php

@@ -51,8 +51,10 @@ class HandleInertiaRequests extends Middleware
         return [
             ...parent::share($request),
             'name' => config('app.name'),
+            'procurementEnabled' => app(\App\Services\Procurement::class)->available(),
             'homologationReserved' => (bool) config('portal.homologation_only', false),
             'profileAccess' => app(PortalProfileAccess::class)->navigation($request->user()),
+            'contentManagementHref' => app(\App\Services\ContentManagement::class)->access($request->user()) !== [] ? '/gestao-conteudos' : null,
             'portalOperator' => config('portal.operator_name'),
             'portalInstitutionalContactEmail' => filter_var(config('portal.institutional_contact_email'), FILTER_VALIDATE_EMAIL) ?: null,
             'legacyContentEnabled' => app(LegacyContent::class)->available(),
@@ -68,7 +70,7 @@ class HandleInertiaRequests extends Middleware
                 'create' => ['label' => 'Nova oportunidade', 'href' => '/management/opportunities/create'],
                 'installationHref' => '/management/opportunity-management-install',
             ] : null,
-            'flash' => ['success' => fn () => $request->session()->get('success'), 'warning' => fn () => $request->session()->get('warning')],
+            'flash' => ['success' => fn () => $request->session()->get('success'), 'warning' => fn () => $request->session()->get('warning'), 'uploaded_document_id' => fn () => $request->session()->get('uploaded_document_id')],
             'scopedAdministration' => $request->user() && app(\App\Services\ScopedPortalAdministration::class)->administrative($request->user()) ? [
                 ['label'=>'Zonas e parques','href'=>'/management/investment/zones'],
                 ['label'=>'Referências económicas','href'=>'/management/economic-references/lot-01'],

app/Http/Middleware/ProtectProfileOpportunity.php

@@ -29,7 +29,9 @@ class ProtectProfileOpportunity
             if ($record && ($record->owner_user_id !== null || str_starts_with($request->path(), 'minhas-oportunidades'))) {
                 abort_if($record->owner_user_id === null && str_starts_with($request->path(), 'minhas-oportunidades'), 403, 'Registo legado não convertido para a política v1.');
                 $access = app(PortalProfileAccess::class);
-                $access->authorize($request->user(), $request->isMethod('GET') || str_ends_with($request->path(), '/workflow') || str_ends_with($request->path(), '/preview') || $request->is('minhas-oportunidades/*/classification/review') ? 'view' : 'edit', $record);
+                // The promotional controller checks its own scoped disclosure capability,
+                // like workflow decisions; publication does not grant draft editing.
+                $access->authorize($request->user(), $request->isMethod('GET') || str_ends_with($request->path(), '/workflow') || str_ends_with($request->path(), '/preview') || $request->is('minhas-oportunidades/*/classification/review', 'minhas-oportunidades/*/divulgacao/previa', 'minhas-oportunidades/*/divulgacao/confirmar') ? 'view' : 'edit', $record);
                 abort_if($request->is('management/opportunity-origin/apply'), 403, 'O cadastro privado v1 não usa a classificação editorial dos exemplos legados.');
                 abort_if($request->isMethod('POST') && str_ends_with($request->path(), '/lifecycle') && ! str_contains($request->path(), '/resources/'), 403, 'Use o workflow com decisões segregadas; o perfil não concede exclusão.');
             }

app/Http/Requests/ResolveSimulationTaxParametersRequest.php

@@ -21,7 +21,7 @@ class ResolveSimulationTaxParametersRequest extends FormRequest
             'component' => ['required', 'in:IRPC,IVA,ISPC,IRPS,INSS,RETENCOES,DIREITOS_ADUANEIROS,ICE'],
             'period_start' => ['required', 'date_format:Y-m-d'],
             'period_end' => ['required', 'date_format:Y-m-d', 'after_or_equal:period_start'],
-            'context' => ['sometimes', 'array:fiscal_periodicity,fiscal_operation,fiscal_residency_assessment,fiscal_residency_country,fiscal_income_category,fiscal_establishments,fiscal_documentation,fiscal_customs_code,fiscal_vat_refund_state'],
+            'context' => ['sometimes', 'array:currency,fiscal_periodicity,fiscal_operation,fiscal_residency_assessment,fiscal_residency_country,fiscal_income_category,fiscal_establishments,fiscal_documentation,fiscal_customs_code,fiscal_vat_refund_state'],
             'context.*' => ['string', 'max:160'],
         ];
     }

app/Http/Requests/StoreLandAssistanceCaseRequest.php

@@ -19,7 +19,9 @@ class StoreLandAssistanceCaseRequest extends FormRequest
     {
         $payload = $this->validated('payload');
 
-        return is_array($payload) ? $payload : [];
+        if (!is_array($payload)) return [];
+        if (!empty($payload['investor_path_case_id'])) return app(\App\Services\InvestmentConsumerScope::class)->bind($this->user(), $payload['investor_path_case_id'], $payload, $this->routeIs('land-assistance.support'));
+        return \Illuminate\Support\Arr::except($payload, ['context_opportunity', 'context_opportunity_snapshot']);
     }
 
     public function authorize(): bool
@@ -33,7 +35,10 @@ class StoreLandAssistanceCaseRequest extends FormRequest
         return [
             'version' => [$this->isMethod('post') && ! $this->routeIs('land-assistance.support') ? 'nullable' : 'required', 'integer', 'min:1'],
             'context_revision' => ['nullable', 'integer', 'min:0'], 'context_reviewed' => ['nullable', 'boolean'],
-            'payload' => ['required', 'array:support_kind,request_description,project_reference,investor_path_case_id,applicant_category,full_name,contact_person,email,phone,preferred_contact,country,declared_origin_country_code,nationality,representative_name,representative_role,representation_basis,nuit,constitution_or_residency_note,area_status,parcels,purpose,activity,known_occupants,occupant_description,known_improvements,improvements_description,prior_right_status,prior_right_description,conflict_status,conflict_description,official_process,attachments_to_follow,exploration_plan,consultation,additional_information,truth_declaration,contact_consent'],
+            'payload' => ['required', 'array:context_opportunity,context_opportunity_snapshot,context_reuse,support_kind,request_description,project_reference,investor_path_case_id,applicant_category,full_name,contact_person,email,phone,preferred_contact,country,declared_origin_country_code,nationality,representative_name,representative_role,representation_basis,nuit,constitution_or_residency_note,area_status,parcels,purpose,activity,known_occupants,occupant_description,known_improvements,improvements_description,prior_right_status,prior_right_description,conflict_status,conflict_description,official_process,attachments_to_follow,exploration_plan,consultation,additional_information,truth_declaration,contact_consent'],
+            'payload.context_opportunity' => ['nullable', 'string', 'max:100'],
+            'payload.context_opportunity_snapshot' => ['nullable', 'string', 'max:200000'],
+            'payload.context_reuse' => ['nullable', 'string', 'max:10000'],
             'payload.support_kind' => ['nullable', 'in:investment,home,family_exploitation,recognition,regularization,delimitation,change_of_use,transfer,existing_process,conflict_guidance,other'],
             'payload.request_description' => ['nullable', 'string', 'max:4000'],
             'payload.project_reference' => ['nullable', 'string', 'max:160'],

app/Http/Requests/StoreSimulationFormDraftRequest.php

@@ -37,7 +37,7 @@ class StoreSimulationFormDraftRequest extends FormRequest
             'contact_province', 'contact_district', 'preferred_channel',
         ];
         $economic = [
-            'journey_type', 'detail_level', 'business_plan_snapshot', 'financial_tools_snapshot', 'project_team_snapshot', 'project_execution_snapshot', 'purpose', 'manifestation_type', 'preferred_language', 'project_title', 'project_summary', 'project_problem', 'target_customers', 'value_proposition', 'market_assumption', 'market_source', 'project_milestones', 'selection_labels', 'project_type',
+            'context_opportunity', 'context_applicability_snapshot', 'investment_regime', 'context_reuse', 'compatible_fields_snapshot', 'published_iva_base', 'published_iva_currency', 'published_iva_date', 'published_iva_scope', 'monthly_iva_settings', 'monthly_iva_snapshot', 'journey_type', 'detail_level', 'business_plan_snapshot', 'financial_tools_snapshot', 'cashflow_snapshot', 'project_team_snapshot', 'project_execution_snapshot', 'purpose', 'manifestation_type', 'preferred_language', 'project_title', 'project_summary', 'project_problem', 'target_customers', 'value_proposition', 'market_assumption', 'market_source', 'project_milestones', 'selection_labels', 'project_type',
             'competitor_assumption', 'sales_channel_assumption', 'marketing_approach', 'location_rationale', 'project_risk_responses_snapshot', 'project_questionnaire_version',
             'customer_validation_status', 'cost_estimate_status', 'location_assessment_status', 'funding_status', 'receivables_timing_status',
             'project_type_other', 'sector_id', 'activity_id', 'products_services', 'maturity_stage', 'expected_start_date',
@@ -50,7 +50,7 @@ class StoreSimulationFormDraftRequest extends FormRequest
             'environmental_category', 'community_benefits', 'tax_calculation', 'fiscal_scenario_mode', 'base', 'rate', 'reduction',
             'sales_taxable', 'sales_exempt', 'sales_zero_rate', 'exports', 'deductible_costs', 'non_deductible_costs',
             'carried_losses', 'payroll', 'outbound_payments', 'imports', 'claimed_benefits', 'reference_date',
-            'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'fiscal_quarter', 'fiscal_reference_date', 'irps_salary_view', 'fiscal_component', 'fiscal_income_category', 'fiscal_residency_assessment',
+            'fiscal_currency', 'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'fiscal_quarter', 'fiscal_reference_date', 'irps_salary_view', 'fiscal_component', 'fiscal_income_category', 'fiscal_residency_assessment',
             'fiscal_operation', 'fiscal_activity', 'fiscal_establishments', 'fiscal_documentation',
             'fiscal_customs_code', 'fiscal_vat_refund_state',
             'offer_or_demand', 'opportunity_type', 'opportunity_type_other', 'opportunity_description',
@@ -71,6 +71,18 @@ class StoreSimulationFormDraftRequest extends FormRequest
             'economic_snapshot.detail_level' => ['nullable', 'in:simple,advanced'],
             'economic_snapshot.business_plan_snapshot' => ['nullable', 'string', 'max:60000'],
             'economic_snapshot.financial_tools_snapshot' => ['nullable', 'string', 'max:30000'],
+            'economic_snapshot.cashflow_snapshot' => ['nullable', 'string', 'max:20000'],
+            'economic_snapshot.context_applicability_snapshot' => ['nullable', 'string', 'max:1000000'],
+            'economic_snapshot.context_opportunity' => ['nullable', 'string', 'max:100'],
+            'economic_snapshot.investment_regime' => ['nullable', 'in:general,industrial_park,zee,zfi'],
+            'economic_snapshot.context_reuse' => ['nullable', 'string', 'max:10000'],
+            'economic_snapshot.compatible_fields_snapshot' => ['nullable', 'string', 'max:10000'],
+            'economic_snapshot.published_iva_base' => ['nullable', 'string', 'max:40'],
+            'economic_snapshot.published_iva_currency' => ['nullable', 'string', 'max:3'],
+            'economic_snapshot.published_iva_date' => ['nullable', 'string', 'max:10'],
+            'economic_snapshot.published_iva_scope' => ['nullable', 'string', 'in:yes,no'],
+            'economic_snapshot.monthly_iva_settings' => ['nullable', 'string', 'max:2000'],
+            'economic_snapshot.monthly_iva_snapshot' => ['nullable', 'string', 'max:60000'],
             'economic_snapshot.project_team_snapshot' => ['nullable', 'string', 'max:30000'],
             'economic_snapshot.project_execution_snapshot' => ['nullable', 'string', 'max:30000'],
             'economic_snapshot.project_risk_responses_snapshot' => ['nullable', 'string', 'max:30000'],
@@ -278,7 +290,7 @@ class StoreSimulationFormDraftRequest extends FormRequest
                     'currency', 'funds_origin_countries', 'environmental_category', 'tax_calculation', 'fiscal_scenario_mode', 'offer_or_demand',
                     'opportunity_type', 'confidentiality', 'publish_requested', 'terms_accepted', 'truth_declaration',
                     'reuse_simulation', 'contact_authorisation', 'publication_authorisation', 'public_fields_confirmation', 'validation_acknowledged',
-                    'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'fiscal_quarter', 'fiscal_reference_date', 'irps_salary_view', 'fiscal_component', 'fiscal_income_category', 'fiscal_residency_assessment', 'fiscal_operation',
+                    'fiscal_currency', 'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'fiscal_quarter', 'fiscal_reference_date', 'irps_salary_view', 'fiscal_component', 'fiscal_income_category', 'fiscal_residency_assessment', 'fiscal_operation',
                     'fiscal_documentation', 'fiscal_vat_refund_state'],
                 'personal_snapshot.selection_labels' => ['person_type', 'investor_origin', 'tax_residency_country', 'fiscal_residency_country', 'entity_stage', 'legal_form', 'preferred_channel'],
             ];

app/Http/Requests/StoreSimulationRequest.php

@@ -11,10 +11,71 @@ class StoreSimulationRequest extends FormRequest
         return true;
     }
 
+    public function messages(): array
+    {
+        return [
+            'required' => 'Preencha o campo :attribute. As entradas foram preservadas.',
+            'string' => 'Indique :attribute em formato textual.',
+            'regex' => 'Indique uma base decimal positiva ou zero, com ponto decimal e sem separadores de milhares.',
+            'max' => 'O campo :attribute excede o tamanho permitido.',
+            'in' => 'A opção indicada em :attribute não pertence a este cálculo.',
+            'date_format' => 'Indique uma data de exigibilidade válida.',
+            'boolean' => 'Indique se declara o enquadramento da operação.',
+            'prohibited' => 'O campo :attribute não pode ser definido pelo cliente neste cálculo.',
+            'array' => 'Indique uma lista válida em :attribute.',
+            'monthly_sales.min' => 'Indique pelo menos um mês de vendas.',
+            'monthly_sales.max' => 'Este lote aceita até 12 meses dentro de 2026.',
+            'monthly_sales.*.date.regex' => 'Indique o primeiro dia de um mês de 2026.',
+            'monthly_sales.*.date.distinct' => 'Cada mês deve aparecer apenas uma vez.',
+            'monthly_sales.*.amount.present' => 'Indique o valor das vendas ou deixe-o explicitamente sem informação.',
+        ];
+    }
+
+    public function attributes(): array
+    {
+        return ['base' => 'base tributável', 'currency' => 'moeda', 'reference_date' => 'data de exigibilidade',
+            'operation' => 'operação', 'scope_declared' => 'declaração de enquadramento', 'scenario_kind' => 'tipo de cálculo',
+            'rule_id' => 'regra', 'rule_version' => 'versão da regra', 'rate' => 'taxa', 'reduction' => 'redução',
+            'monthly_sales' => 'vendas mensais', 'monthly_sales.*.date' => 'mês da projecção',
+            'monthly_sales.*.amount' => 'vendas declaradas do mês', 'sales_vat_basis' => 'tratamento do IVA nos preços'];
+    }
+
     /** @return array<string, list<mixed>> */
     public function rules(): array
     {
+        if ($this->input('scenario_kind') === 'fiscal_rule_published') {
+            if ($this->exists('monthly_sales')) {
+                return [
+                    'scenario_kind' => ['required', 'in:fiscal_rule_published'],
+                    'monthly_sales' => ['required', 'array', 'min:1', 'max:12'],
+                    'monthly_sales.*' => ['required', 'array:date,amount'],
+                    'monthly_sales.*.date' => ['required', 'date_format:Y-m-d', 'regex:/^2026-\d{2}-01$/D', 'distinct'],
+                    'monthly_sales.*.amount' => ['present', 'nullable', 'string', 'max:40', 'regex:/^\d+(?:\.\d+)?$/D'],
+                    'sales_vat_basis' => ['required', 'in:net,included,unknown'],
+                    'currency' => ['required', 'in:MZN'],
+                    'scope_declared' => ['required', 'boolean'],
+                    'organization_id' => ['nullable', 'uuid', 'exists:organizations,id'],
+                    'base' => ['prohibited'], 'rate' => ['prohibited'], 'reduction' => ['prohibited'],
+                    'rule_id' => ['prohibited'], 'rule_version' => ['prohibited'], 'fiscal_preview' => ['prohibited'],
+                ];
+            }
+
+            return [
+                'scenario_kind' => ['required', 'in:fiscal_rule_published'],
+                'base' => ['required', 'string', 'max:40', 'regex:/^\d+(?:\.\d+)?$/'],
+                'currency' => ['required', 'in:MZN'],
+                'reference_date' => ['required', 'date_format:Y-m-d'],
+                'operation' => ['required', 'in:internal_general_net'],
+                'scope_declared' => ['required', 'boolean'],
+                'organization_id' => ['nullable', 'uuid', 'exists:organizations,id'],
+                'rate' => ['prohibited'], 'reduction' => ['prohibited'],
+                'rule_id' => ['prohibited'], 'rule_version' => ['prohibited'],
+                'fiscal_preview' => ['prohibited'],
+            ];
+        }
+
         return [
+            'scenario_kind' => ['sometimes', 'in:custom_planning'],
             'base' => ['required', 'numeric', 'min:0'],
             'rate' => ['required', 'numeric', 'between:0,100'],
             'reduction' => ['required', 'numeric', 'between:0,100'],

app/Jobs/RunSimulation.php

@@ -4,6 +4,7 @@ namespace App\Jobs;
 
 use App\Models\Simulation;
 use App\Services\SimulationExecution;
+use App\Support\IsolatedQaDatabase;
 use Illuminate\Bus\Queueable;
 use Illuminate\Contracts\Queue\ShouldQueue;
 use Illuminate\Foundation\Bus\Dispatchable;
@@ -62,29 +63,39 @@ class RunSimulation implements ShouldQueue
                 throw new \RuntimeException('Simulation has no scenario.');
             }
             $input = json_decode($scenario->parameters, true, flags: JSON_THROW_ON_ERROR);
-            $row = DB::selectOne('select (CAST(? AS numeric) * CAST(? AS numeric) / 100 * (1 - CAST(? AS numeric) / 100))::text as value', [$input['base'], $input['rate'], $input['reduction']]);
             $resultId = (string) Str::uuid();
             $engineVersion = 'portal-arithmetic-v1+simulation-v'.$simulation->version_no;
-            $result = ['base' => $input['base'], 'rate_percent' => $input['rate'], 'reduction_percent' => $input['reduction'], 'scenario_kind' => 'custom_planning', 'indicative_total' => $row->value,
-                'currency' => null, 'legal_interpretation' => false, 'formula_version' => 'portal-arithmetic-v1',
-                'contract_version' => 1,
-                'context' => [
-                    'reference_date' => substr((string) $scenario->created_at, 0, 10),
-                    'currency' => null,
-                    'currency_fraction_digits' => null,
-                    'scenario_id' => (string) $scenario->id,
-                    'scenario_version' => (int) $scenario->version_no,
-                    'engine_version' => $engineVersion,
-                    'ruleset_version' => null,
-                ],
-                'result' => [
-                    'status' => 'calculated',
-                    'value' => (string) $row->value,
-                    'unit' => null,
-                    'explanation' => 'Resultado aritmético determinístico; não constitui cálculo nem conclusão fiscal.',
-                    'missing_inputs' => [],
-                    'source_ids' => [],
-                ]];
+            if (in_array($input['scenario_kind'] ?? null, ['fiscal_rule_qa_preview', 'fiscal_rule_published'], true)) {
+                if ($input['scenario_kind'] === 'fiscal_rule_qa_preview') {
+                    abort_unless(IsolatedQaDatabase::allowsSchemaChanges(), 404);
+                }
+                $result = $input['fiscal_preview'];
+                $engineVersion = $result['context']['engine_version'];
+                $result['context']['scenario_id'] = (string) $scenario->id;
+                $result['context']['scenario_version'] = (int) $scenario->version_no;
+            } else {
+                $row = DB::selectOne('select (CAST(? AS numeric) * CAST(? AS numeric) / 100 * (1 - CAST(? AS numeric) / 100))::text as value', [$input['base'], $input['rate'], $input['reduction']]);
+                $result = ['base' => $input['base'], 'rate_percent' => $input['rate'], 'reduction_percent' => $input['reduction'], 'scenario_kind' => 'custom_planning', 'indicative_total' => $row->value,
+                    'currency' => null, 'legal_interpretation' => false, 'formula_version' => 'portal-arithmetic-v1',
+                    'contract_version' => 1,
+                    'context' => [
+                        'reference_date' => substr((string) $scenario->created_at, 0, 10),
+                        'currency' => null,
+                        'currency_fraction_digits' => null,
+                        'scenario_id' => (string) $scenario->id,
+                        'scenario_version' => (int) $scenario->version_no,
+                        'engine_version' => $engineVersion,
+                        'ruleset_version' => null,
+                    ],
+                    'result' => [
+                        'status' => 'calculated',
+                        'value' => (string) $row->value,
+                        'unit' => null,
+                        'explanation' => 'Resultado aritmético determinístico; não constitui cálculo nem conclusão fiscal.',
+                        'missing_inputs' => [],
+                        'source_ids' => [],
+                    ]];
+            }
             $json = json_encode($result, JSON_THROW_ON_ERROR | JSON_UNESCAPED_SLASHES);
             $canonicalResult = DB::selectOne('select CAST(? AS jsonb)::text as canonical', [$json])->canonical;
             $resultHash = hash('sha256', $canonicalResult);
@@ -96,11 +107,25 @@ class RunSimulation implements ShouldQueue
             DB::table('simulation_jobs')->where('id', $job->id)->update(['status' => 'succeeded', 'finished_at' => now(), 'updated_at' => now()]);
             DB::table('simulation_reports')->insert(['id' => (string) Str::uuid(), 'simulation_id' => $simulation->id, 'version_no' => $scenario->version_no,
                 'status' => 'ready', 'report_snapshot' => $json, 'report_sha256' => $resultHash, 'created_at' => now(), 'updated_at' => now()]);
-            $sourceJson = json_encode($input, JSON_THROW_ON_ERROR);
+            $sourceJson = json_encode(isset($result['fiscal_provenance']) ? [
+                'base' => $result['base'], 'currency' => $result['currency'],
+                'reference_date' => $result['context']['reference_date'],
+                'context' => $result['fiscal_provenance']['context'], 'scope_status' => $result['fiscal_provenance']['scope_status'],
+            ] : $input, JSON_THROW_ON_ERROR);
             $canonicalSource = DB::selectOne('select CAST(? AS jsonb)::text as canonical', [$sourceJson])->canonical;
             DB::table('simulation_result_sources')->insertOrIgnore(['id' => (string) Str::uuid(), 'result_id' => $resultId,
                 'source_type' => 'user_input', 'source_id' => $scenario->id, 'source_version' => (string) $scenario->version_no,
                 'source_snapshot' => $sourceJson, 'source_sha256' => hash('sha256', $canonicalSource), 'created_at' => now()]);
+            if (isset($result['fiscal_provenance'])) {
+                $provenance = $result['fiscal_provenance'];
+                $provenanceJson = json_encode($provenance, JSON_THROW_ON_ERROR);
+                $canonicalProvenance = DB::selectOne('select CAST(? AS jsonb)::text as canonical', [$provenanceJson])->canonical;
+                DB::table('simulation_result_sources')->insert([
+                    'id' => (string) Str::uuid(), 'result_id' => $resultId, 'source_type' => $input['scenario_kind'] === 'fiscal_rule_published' ? 'tax_rule_published' : 'tax_rule_draft',
+                    'source_id' => $provenance['rule']['id'], 'source_version' => (string) $provenance['rule']['rule_version'],
+                    'source_snapshot' => $provenanceJson, 'source_sha256' => hash('sha256', $canonicalProvenance), 'created_at' => now(),
+                ]);
+            }
             DB::table('simulation_audit_events')->insert(['simulation_id' => $simulation->id, 'actor_user_id' => $simulation->owner_user_id,
                 'action' => 'simulation.completed', 'correlation_id' => $simulation->id, 'data' => json_encode(['result_sha256' => hash('sha256', $json), 'attempt' => $job->attempts + 1], JSON_THROW_ON_ERROR), 'occurred_at' => now()]);
         }, 3);

app/Models/InvestmentLegalSource.php

@@ -16,4 +16,9 @@ class InvestmentLegalSource extends Model
     use HasUuids;
 
     protected $guarded = ['id'];
+
+    protected function casts(): array
+    {
+        return ['fiscal_acceptance' => 'array'];
+    }
 }

app/Models/Opportunity.php

@@ -31,6 +31,13 @@ class Opportunity extends Model
 
     protected $appends = ['maturity_catalogue_version'];
 
+    public function toArray(): array
+    {
+        $data = parent::toArray();
+        if (isset($data['description'])) $data['description'] = \App\Services\OpportunityPublicText::description($this, $data['description']);
+        return $data;
+    }
+
     public function getMaturityCatalogueVersionAttribute(): ?string
     {
         // Only published metadata is public; never expose the current private draft.
@@ -68,7 +75,8 @@ class Opportunity extends Model
         $scope = $public ? 'public' : ($visible && $this->owner_user_id !== null ? 'restricted' : 'unpublished');
 
         return ['scope' => $scope, 'public_catalog' => $public, 'label' => match ($scope) {
-            'public' => 'Publicada no catálogo público',
+            'public' => data_get($this->workflow_context, 'publication.purpose') === 'promotional_preparation'
+                ? 'Resumo divulgado — Em preparação; não autoriza execução' : 'Publicada no catálogo público',
             'restricted' => 'Disponibilizada com acesso restrito — perfis e organização autorizados',
             default => 'Sem versão disponibilizada; aprovação interna é uma etapa distinta',
         }];

app/Services/ApprovedAdministrativeBoundaries.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Services;
+
+use RuntimeException;
+
+/** Public read projection authorized by Tempo; source rows and originals stay private. */
+class ApprovedAdministrativeBoundaries
+{
+    public const HASH = '06ab905fcf9b19115c3521bf81de03f37873880f7765f229b9e1f79d99df7adc';
+
+    /** @var array<string,array<string,string>>|null */
+    private ?array $items = null;
+
+    /** @return array<string,array<string,string>> */
+    public function snapshots(): array
+    {
+        if ($this->items !== null) {
+            return $this->items;
+        }
+        $contents = file_get_contents(base_path('docs/investmoz/unification/approved-administrative-boundaries-20261024.json'));
+        if ($contents === false || ! hash_equals(self::HASH, hash('sha256', str_replace("\r\n", "\n", $contents)))) {
+            throw new RuntimeException('Approved administrative boundary manifest changed.');
+        }
+        $manifest = json_decode($contents, true, 512, JSON_THROW_ON_ERROR);
+        if (count($manifest['items']) !== 408) {
+            throw new RuntimeException('Exact 408-boundary scope required.');
+        }
+        $this->items = array_column($manifest['items'], null, 'id');
+
+        return $this->items;
+    }
+
+    public function allows(string $id, string $territoryId, string $geometryHash, string $propertiesHash): bool
+    {
+        $item = $this->snapshots()[$id] ?? null;
+
+        return $item !== null && $item['territory_id'] === $territoryId
+            && hash_equals($item['geometry_sha256'], $geometryHash)
+            && hash_equals($item['properties_sha256'], $propertiesHash);
+    }
+}

app/Services/ApprovedAnchorTerritories.php

@@ -0,0 +1,106 @@
+<?php
+
+namespace App\Services;
+
+use Illuminate\Support\Facades\DB;
+use RuntimeException;
+
+/** Exact replay of the 28 accepted links into the transported project identities. */
+final class ApprovedAnchorTerritories
+{
+    public const HASH = 'd2893d0a638d630435aca1890f79a8094dc58eb65bbdd65a470bb685fa075190';
+
+    /** @return array{manifest_sha256:string,projects:list<array<string,mixed>>,links:list<array<string,mixed>>} */
+    public function plan(): array
+    {
+        $file = base_path('docs/investmoz/unification/approved-anchor-territories-20261023.json');
+        $contents = is_file($file) ? file_get_contents($file) : false;
+        if ($contents !== false) {
+            $contents = str_replace("\r\n", "\n", $contents);
+        }
+        if ($contents === false || ! hash_equals(self::HASH, hash('sha256', $contents))) {
+            throw new RuntimeException('Reviewed territorial manifest changed.');
+        }
+        $manifest = json_decode($contents, true, 512, JSON_THROW_ON_ERROR);
+        if (count($manifest['items']) !== 28) {
+            throw new RuntimeException('Exact 28-link scope required.');
+        }
+        $projects = [];
+        $links = [];
+        foreach ($manifest['items'] as $item) {
+            $project = DB::table('projects')->where('id', $item['project_id'])->whereNull('deleted_at')->first();
+            $dossier = DB::table('investment_dossiers')->where('id', $item['dossier_id'])->whereNull('deleted_at')->first();
+            if (! $project || $project->code !== $item['code'] || ! $dossier || $dossier->project_id !== $project->id
+                || ! hash_equals($item['content_sha256'], hash('sha256', $dossier->content))
+                || ! hash_equals($item['source_sha256'], hash('sha256', $dossier->source))) {
+                throw new RuntimeException('Project identity or documentary source changed: '.$item['code']);
+            }
+            $original = $item['original_relation'];
+            $geo = DB::table('geo_locations')->where('id', $original['geo_location_id'])->whereNull('deleted_at')->first();
+            foreach (['location_type', 'source_code', 'parent_id', 'data_classification'] as $field) {
+                if (! $geo || $item['territory'][$field] !== $geo->$field) {
+                    throw new RuntimeException('Territory identity changed: '.$original['geo_location_id']);
+                }
+            }
+            $metadata = $projects[$project->id]['after_metadata'] ?? json_decode($project->metadata, true, 512, JSON_THROW_ON_ERROR);
+            $key = $geo->id.':'.$original['role'];
+            $evidence = $item['evidence'];
+            // Preserve the original dossier id in evidence and explicitly map the destination.
+            $evidence['transported_dossier_id'] = $dossier->id;
+            if (isset($metadata['documented_location_sources'][$key]) && $metadata['documented_location_sources'][$key] != $evidence) {
+                throw new RuntimeException('Existing territorial evidence differs; no overwrite: '.$item['code']);
+            }
+            $projects[$project->id] ??= ['id' => $project->id, 'code' => $project->code, 'before_version' => (int) $project->version_no, 'before_metadata' => json_decode($project->metadata, true, 512, JSON_THROW_ON_ERROR)];
+            $metadata['documented_location_sources'][$key] = $evidence;
+            $projects[$project->id]['after_metadata'] = $metadata;
+            $existing = DB::table('project_locations')->where('project_id', $project->id)->where('geo_location_id', $geo->id)->where('role', $original['role'])->first();
+            if ($existing && ($existing->deleted_at || $existing->data_classification !== 'public')) {
+                throw new RuntimeException('Archived or restricted territorial relation must not be revived.');
+            }
+            $identity = DB::table('project_locations')->where('id', $original['id'])->first();
+            if ($identity && (! $existing || $identity->id !== $existing->id)) {
+                throw new RuntimeException('Historical relation identity is already occupied.');
+            }
+            $links[] = ['code' => $item['code'], 'already_present' => (bool) $existing, 'row' => [...$original, 'project_id' => $project->id]];
+        }
+
+        return ['manifest_sha256' => self::HASH, 'projects' => array_values($projects), 'links' => $links];
+    }
+
+    /** Caller supplies an authenticated, backed-up transaction; no source publication changes.
+     * @param  array{manifest_sha256:string,projects:list<array<string,mixed>>,links:list<array<string,mixed>>}  $plan
+     * @return array<string,int>
+     */
+    public function apply(array $plan): array
+    {
+        if (DB::transactionLevel() < 1 || $this->plan() !== $plan) {
+            throw new RuntimeException('Reviewed transaction and unchanged preview required.');
+        }
+        $inserted = 0;
+        $updated = 0;
+        foreach ($plan['projects'] as $project) {
+            if ($project['before_metadata'] == $project['after_metadata']) {
+                continue;
+            }
+            $count = DB::table('projects')->where('id', $project['id'])->where('version_no', $project['before_version'])->update([
+                'metadata' => json_encode($project['after_metadata'], JSON_THROW_ON_ERROR), 'version_no' => $project['before_version'] + 1, 'updated_at' => now(),
+            ]);
+            if ($count !== 1) {
+                throw new RuntimeException('Concurrent project change.');
+            }
+            DB::table('audit_events')->insert(['source_system' => 'approved-anchor-territories-recovery-v1', 'external_id' => self::HASH.':'.$project['id'], 'entity_type' => 'projects', 'entity_id' => $project['id'], 'action' => 'accepted_territories_restored',
+                'data_classification' => 'public', 'before_data' => json_encode(['version_no' => $project['before_version'], 'metadata' => $project['before_metadata']], JSON_THROW_ON_ERROR),
+                'after_data' => json_encode(['version_no' => $project['before_version'] + 1, 'manifest_sha256' => self::HASH, 'metadata' => $project['after_metadata'], 'new_approval' => false], JSON_THROW_ON_ERROR)]);
+            $updated++;
+        }
+        foreach ($plan['links'] as $link) {
+            if ($link['already_present']) {
+                continue;
+            }
+            DB::table('project_locations')->insert($link['row']);
+            $inserted++;
+        }
+
+        return ['relations_restored' => $inserted, 'projects_updated' => $updated, 'new_dossiers' => 0, 'publication_changes' => 0];
+    }
+}

app/Services/ContentManagement.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Opportunity;
+use App\Models\User;
+use Illuminate\Support\Facades\DB;
+
+/** Navigation over existing authorisations; never grants a role or publishes content. */
+final class ContentManagement
+{
+    public function access(?User $actor): array
+    {
+        if (! $actor || ! $actor->hasVerifiedEmail()) return [];
+        $profiles = app(PortalProfileAccess::class);
+        $navigation = $profiles->navigation($actor);
+        $legacy = $profiles->legacyWriteAllowed($actor);
+        $documents = app(DocumentManagementAccess::class);
+        $editor = $documents->full($actor) || $documents->editorial($actor);
+        $upload = $editor || $documents->limited($actor);
+        $result = [];
+        if (app(Procurement::class)->available() && app(Procurement::class)->access($actor)) $result['procurement'] = ['index' => '/management/concursos', 'create' => '/management/concursos/novo'];
+        if ($legacy || ($navigation['mine'] ?? null) || ($navigation['review'] ?? null)) {
+            $result['opportunities'] = ['index' => $legacy ? '/management/opportunities' : '/minhas-oportunidades',
+                'create' => $legacy ? '/management/opportunities/create' : ($navigation['create'] ?? null), 'profileWorkflow' => ! $legacy];
+        }
+        if ($upload) $result['documents'] = ['index' => '/management/portal-services', 'edit' => $editor];
+        return $result;
+    }
+
+    public function view(User $actor): array
+    {
+        $access = $this->access($actor);
+        abort_unless($access !== [], 403);
+        $counts = [];
+        if (isset($access['opportunities'])) {
+            $counts['opportunities'] = app(PortalProfileAccess::class)->scope(Opportunity::query(), $actor)
+                ->selectRaw("COALESCE(workflow_context->>'working_state',status) as state, count(*) as total")
+                ->groupByRaw("COALESCE(workflow_context->>'working_state',status)")->pluck('total', 'state');
+        }
+        if (isset($access['documents'])) {
+            $documents = app(DocumentManagementAccess::class);
+            $query = $documents->full($actor) ? DB::table('portal_resources as r')->join('documents as d', 'd.id', '=', 'r.document_id')->whereNull('d.deleted_at')
+                : ($access['documents']['edit'] ? $documents->editorialResources($actor) : null);
+            $counts['documents'] = $query ? $query->select('r.published', DB::raw('count(*) as total'))->groupBy('r.published')->get()
+                ->mapWithKeys(fn ($row) => [$row->published ? 'published' : 'unpublished' => (int) $row->total]) : [];
+        }
+        return ['access' => $access, 'counts' => $counts];
+    }
+}

app/Services/CorridorAgribusiness.php

@@ -0,0 +1,83 @@
+<?php
+
+namespace App\Services;
+
+use DOMDocument;
+use DOMElement;
+
+/** Supplement the six named agribusiness sections without changing corridor masters or source documents. */
+final class CorridorAgribusiness
+{
+    public function enrich(string $html, array $links = []): string
+    {
+        $data = json_decode(file_get_contents(__DIR__.'/../../database/data/corridor-investment-opportunities.json'), true, 512, JSON_THROW_ON_ERROR);
+        $doc = new DOMDocument;
+        $previous = libxml_use_internal_errors(true);
+        try {
+            $doc->loadHTML('<?xml encoding="UTF-8"><html><body>'.$html.'</body></html>', LIBXML_NONET);
+            $body = $doc->getElementsByTagName('body')->item(0);
+            if (! $body) {
+                return $html;
+            }
+            $changed = false;
+            foreach ($data['groups'] as $index => $group) {
+                $marker = 'agronegocio-oportunidades-'.($index + 1);
+                if ($doc->getElementById($marker)) {
+                    continue;
+                }
+                foreach (iterator_to_array($body->childNodes) as $heading) {
+                    if (! $heading instanceof DOMElement) {
+                        continue;
+                    }
+                    $name = preg_replace('/^[a-f]\)\s*/u', '', trim($heading->textContent));
+                    if ($name !== $group['name']) {
+                        continue;
+                    }
+                    $chains = $heading->nextSibling;
+                    while ($chains && ! $chains instanceof DOMElement) {
+                        $chains = $chains->nextSibling;
+                    }
+                    // Insert only into the exact named section and its existing priority-chain paragraph.
+                    if (! $chains || ! str_starts_with(trim($chains->textContent), 'Cadeias de valor prioritárias:')) {
+                        continue;
+                    }
+                    $fragment = $doc->createDocumentFragment();
+                    $label = $doc->createElement('p');
+                    $strong = $doc->createElement('strong');
+                    $strong->appendChild($doc->createTextNode('Oportunidades de investimento em agronegócio:'));
+                    $label->appendChild($strong);
+                    $fragment->appendChild($label);
+                    $list = $doc->createElement('ul');
+                    $list->setAttribute('id', $marker);
+                    foreach ($group['opportunities'] as $itemIndex => $opportunity) {
+                        $item = $doc->createElement('li');
+                        $chain = $doc->createElement('strong');
+                        $chain->appendChild($doc->createTextNode($opportunity['chain'].': '));
+                        $item->appendChild($chain);
+                        $item->appendChild($doc->createTextNode($opportunity['description']));
+                        if (isset($links[$index][$itemIndex])) {
+                            $item->appendChild($doc->createTextNode(' '));
+                            $link = $doc->createElement('a');
+                            $link->setAttribute('href', $links[$index][$itemIndex]);
+                            $link->appendChild($doc->createTextNode('Conhecer a oportunidade e iniciar o roteiro'));
+                            $item->appendChild($link);
+                        }
+                        $list->appendChild($item);
+                    }
+                    $fragment->appendChild($list);
+                    $source = $doc->createElement('p');
+                    $source->appendChild($doc->createTextNode('Fonte das oportunidades: '.$data['source']));
+                    $fragment->appendChild($source);
+                    $body->insertBefore($fragment, $chains->nextSibling);
+                    $changed = true;
+                    break;
+                }
+            }
+
+            return $changed ? implode('', array_map(fn ($node) => $doc->saveHTML($node), iterator_to_array($body->childNodes))) : $html;
+        } finally {
+            libxml_clear_errors();
+            libxml_use_internal_errors($previous);
+        }
+    }
+}

app/Services/CorridorAgribusinessOpportunities.php

@@ -0,0 +1,97 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Opportunity;
+use App\Models\Sector;
+use App\Models\User;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+use Ramsey\Uuid\Uuid;
+
+/** Source-defined opportunities; never infer a master corridor, site or promoter. */
+final class CorridorAgribusinessOpportunities
+{
+    public const SOURCE_HASH = '1473b06c48aa234e771660e3f2a51b9d2e4e1943bd52d878e0ae854ee6657055';
+
+    /** Documentary cross-reference only; keep the two source designations and master records intact. */
+    public function portfolioOpportunityIds(\App\Models\InvestmentDossier $dossier): array
+    {
+        if (!$dossier->corridor_id || data_get($dossier->content, 'code') !== 'COR-02') return [];
+        // COR-02 is Beira e Centro in investment-portfolio.json. The seven entries are explicitly
+        // grouped under Corredor da Beira in the accepted source, not selected by province/name search.
+        $keys = collect($this->entries())->where('corridor', 'Corredor da Beira')->pluck('key');
+        return Opportunity::published()->whereIn('management_creation_key', $keys)
+            ->where('workflow_context->corridor_agribusiness->source_sha256', self::SOURCE_HASH)->pluck('id')->all();
+    }
+    public const LIMITATIONS = 'Promotor, implantação exacta, área, montante, financiamento, viabilidade e licenças não indicados nesta fonte. O corredor é um enquadramento documental; não identifica uma parcela nem confirma disponibilidade.';
+
+    public function entries(): array
+    {
+        $data = json_decode(file_get_contents(database_path('data/corridor-investment-opportunities.json')), true, 512, JSON_THROW_ON_ERROR);
+        if ($data['source_sha256'] !== self::SOURCE_HASH) throw new \RuntimeException('Fonte divergente; reconciliar antes de cadastrar.');
+        $sector = Sector::where('slug', 'agronegocio')->where('is_active', true)->whereNull('deleted_at')->firstOrFail();
+        $entries = [];
+        foreach ($data['groups'] as $g => $group) {
+            foreach ($group['opportunities'] as $i => $item) {
+                $key = (string) Uuid::uuid5(Uuid::NAMESPACE_URL, 'investmoz:agronegocio:'.self::SOURCE_HASH.':'.$g.':'.$i);
+                $title = Str::limit($item['chain'].' — '.$group['name'], 150, '…');
+                $description = $item['description']."\n\nEnquadramento documental: ".$group['name'].".\n\nFonte: ".$data['source'].'; SHA-256 '.self::SOURCE_HASH.".\n\n".self::LIMITATIONS;
+                $entries[] = ['key' => $key, 'group' => $g, 'index' => $i, 'corridor' => $group['name'], 'chain' => $item['chain'],
+                    'source' => $data['source'], 'source_sha256' => self::SOURCE_HASH, 'title' => $title,
+                    'summary' => $item['description'], 'description' => $description, 'sector_id' => $sector->id];
+            }
+        }
+        if (count($entries) !== 34) throw new \RuntimeException('O lote deve conter as 34 entradas da fonte.');
+        return $entries;
+    }
+
+    public function register(User $actor, string $organization): array
+    {
+        // The caller uses the ordinary profile creation route and its approved scope.
+        abort_unless(str_starts_with(request()->path(), 'minhas-oportunidades'), 422);
+        return DB::transaction(function () use ($actor, $organization) {
+            DB::select('SELECT pg_advisory_xact_lock(231026, 34)');
+            $result = [];
+            foreach ($this->entries() as $entry) {
+                $record = Opportunity::withTrashed()->where('management_creation_key', $entry['key'])->first();
+                if ($record) {
+                    abort_unless(app(PortalProfileAccess::class)->canView($actor, $record), 403);
+                    abort_unless(data_get($record->workflow_context, 'corridor_agribusiness.source_sha256') === self::SOURCE_HASH, 409);
+                    // Recovery never overwrites editorial changes, withdrawal or archive.
+                    $result[] = ['id' => $record->id, 'created' => false, 'key' => $entry['key']];
+                    continue;
+                }
+                $record = app(OpportunityManagement::class)->save($actor, ['creation_key' => $entry['key'], 'organization_id' => $organization,
+                    'opportunity_category' => 'investment_project', 'sector_id' => $entry['sector_id'],
+                    'title' => $entry['title'], 'summary' => $entry['summary'], 'description' => $entry['description'],
+                    'canonical' => ['opportunity_category' => 'investment_project', 'official_title' => $entry['title'],
+                        'executive_summary' => $entry['summary'], 'demand_statement' => $entry['description'], 'sector_id' => $entry['sector_id']],
+                    'reason' => 'Cadastro privado das 34 oportunidades de agronegócio solicitado pela Tempo em 23/10/2026; não constitui publicação nem aprovação de execução.']);
+                $context = $record->workflow_context ?? [];
+                $context['corridor_agribusiness'] = $entry;
+                $context['promotional_summary'] = ['input' => ['title' => $entry['title'], 'summary' => $entry['summary'],
+                    'description' => $entry['description'], 'source_reference' => $entry['source'].'; SHA-256 '.self::SOURCE_HASH,
+                    'limitations' => self::LIMITATIONS, 'edition' => '', 'source_date' => '', 'territory_ids' => [], 'sector_id' => $entry['sector_id']]];
+                $record->workflow_context = $context;
+                $record->maturity_label = 'Em preparação';
+                $record->save();
+                DB::table('audit_events')->insert(['source_system' => 'corridor-agribusiness-registration', 'entity_type' => 'opportunity',
+                    'action' => 'private_source_registered', 'actor_user_id' => $actor->id, 'data_classification' => 'restricted',
+                    'after_data' => json_encode(['record_id' => $record->id, 'source' => $entry, 'no_publication' => true, 'no_master_relation_inferred' => true], JSON_THROW_ON_ERROR)]);
+                $result[] = ['id' => $record->id, 'created' => true, 'key' => $entry['key']];
+            }
+            return $result;
+        });
+    }
+
+    public function articleLinks(): array
+    {
+        $records = Opportunity::published()->whereIn('management_creation_key', array_column($this->entries(), 'key'))->get()->keyBy('management_creation_key');
+        $links = [];
+        foreach ($this->entries() as $entry) {
+            if ($record = $records->get($entry['key'])) $links[$entry['group']][$entry['index']] = '/oportunidades/'.$record->slug;
+        }
+        return $links;
+    }
+}

app/Services/DocumentManagementAccess.php

@@ -26,8 +26,9 @@ class DocumentManagementAccess
     /** Restore the approved editorial operation without a global management grant. */
     public function editorial(User $actor): bool
     {
-        return config('portal.homologation_only', false)
-            && in_array(strtolower(trim($actor->email)), config('homologation_editorial.accounts', []), true)
+        // Tempo's named editorial designation does not depend on whether the
+        // site's technical reviewer reservation is enabled.
+        return in_array(strtolower(trim($actor->email)), config('homologation_editorial.accounts', []), true)
             && app(PortalProfileAccess::class)->superuser($actor)
             && ! app(PortalProfileAccess::class)->has($actor, 'auditor')
             && app(PortalProfileAccess::class)->mfa($actor);
@@ -49,6 +50,11 @@ class DocumentManagementAccess
                             ->where('d.external_id', $item['external_id']);
                     });
                 }
+                foreach (json_decode(file_get_contents(config_path('legacy_editorial_resources.json')), true, 512, JSON_THROW_ON_ERROR) as $item) {
+                    // These exact original bytes contain the legacy identity/source.
+                    // Destination upload IDs differ; the approved file scope does not.
+                    $query->orWhere('d.sha256', $item['sha256']);
+                }
             });
     }
 

app/Services/EditorialReading.php

@@ -0,0 +1,130 @@
+<?php
+
+namespace App\Services;
+
+use GuzzleHttp\Psr7\Uri;
+use GuzzleHttp\Psr7\UriResolver;
+use Illuminate\Support\Facades\DB;
+use Symfony\Component\HttpFoundation\BinaryFileResponse;
+use Symfony\Component\HttpKernel\Exception\HttpException;
+
+/** Reads verified originals without writing a derived edition or changing publication. */
+final class EditorialReading
+{
+    public function publicResources()
+    {
+        return DB::table('portal_resources as r')->join('documents as d', 'd.id', '=', 'r.document_id')
+            ->where('r.published', true)->where('r.rights_status', 'authorized')->where('d.rights_status', 'authorized')
+            ->where('d.status', 'active')->where('d.data_classification', 'public')->whereNull('d.deleted_at')
+            ->where('d.malware_scan_status', 'clean')->whereColumn('d.sha256', 'd.malware_scanned_sha256');
+    }
+
+    public function original(object $resource): ?array
+    {
+        $document = DB::table('documents')->find($resource->document_id);
+        if (! $document || $document->status !== 'active' || $document->malware_scan_status !== 'clean' || ! in_array($document->media_type, ['text/plain', 'application/json'], true)) {
+            return null;
+        }
+        $binary = app(VerifiedDocumentBinary::class)->respond($document);
+        $bytes = $binary instanceof BinaryFileResponse ? file_get_contents($binary->getFile()->getPathname()) : $binary->getContent();
+        if (! is_string($bytes) || strlen($bytes) > 10485760) {
+            return null;
+        }
+        $original = json_decode($bytes, true);
+
+        return is_array($original) && ($original['format'] ?? '') === 'investmoz-legacy-article-v1' && is_string($original['content_html'] ?? null) ? $original : null;
+    }
+
+    public function plain(string $html): string
+    {
+        return trim(html_entity_decode(strip_tags(preg_replace('~</(?:p|div|li|h[1-6]|tr)>|<br\s*/?>~i', "\n\n", $html)), ENT_QUOTES | ENT_HTML5, 'UTF-8'));
+    }
+
+    public function content(object $resource, ?array $original): array
+    {
+        return $resource->editorial_content ? json_decode($resource->editorial_content, true, 512, JSON_THROW_ON_ERROR)
+            : ['body' => $this->plain($original['content_html'] ?? ''), 'image_resource_id' => null, 'image_mode' => 'original', 'preserve_original_html' => true];
+    }
+
+    private function sourceUrl(mixed $url, ?string $base = null): ?string
+    {
+        if (! is_string($url) || trim($url) === '') {
+            return null;
+        }
+        try {
+            $absolute = $base ? (string) UriResolver::resolve(new Uri($base), new Uri($url)) : $url;
+
+            return filter_var($absolute, FILTER_VALIDATE_URL) && in_array(strtolower((string) parse_url($absolute, PHP_URL_SCHEME)), ['http', 'https'], true) ? $absolute : null;
+        } catch (\InvalidArgumentException) {
+            return null;
+        }
+    }
+
+    public function reading(object $resource, ?array $override = null, bool $private = false): array
+    {
+        $original = $this->original($resource);
+        $content = $override ?? $this->content($resource, $original);
+        abort_unless(trim($content['body'] ?? '') !== '', 404, 'Este documento não contém um artigo legível.');
+        $document = DB::table('documents')->find($resource->document_id);
+        // The original is verified above; ordinary text adaptations retain the binary gate too.
+        app(VerifiedDocumentBinary::class)->respond($document);
+        $mode = $content['image_mode'] ?? (! empty($content['image_resource_id']) ? 'selected' : 'none');
+        $originalImageUrl = $this->sourceUrl($original['image_source_url'] ?? null, $original['source_url'] ?? null);
+        $expectedImageSha = $original['image_sha256'] ?? null;
+        if (! $expectedImageSha && $originalImageUrl === 'https://investemoz.tempo.co.mz/images/tempo-background.png') {
+            foreach (json_decode(file_get_contents(config_path('legacy_editorial_resources.json')), true, 512, JSON_THROW_ON_ERROR) as $accepted) {
+                if ($accepted['sha256'] === $document->sha256) {
+                    $expectedImageSha = $accepted['original_image_sha256'] ?? null;
+                    break;
+                }
+            }
+        }
+        $images = $this->publicResources()->whereIn('d.media_type', ['image/png', 'image/jpeg', 'image/webp']);
+        $image = null;
+        if ($mode === 'selected' && ! empty($content['image_resource_id'])) {
+            $image = (clone $images)->where('r.id', $content['image_resource_id'])->first(['r.id', 'r.title']);
+        }
+        if ($mode === 'original' && $original) {
+            $image = (clone $images)->where(function ($q) use ($expectedImageSha, $originalImageUrl) {
+                $q->whereRaw('1=0');
+                if ($expectedImageSha) {
+                    $q->orWhere('d.sha256', $expectedImageSha);
+                } elseif ($originalImageUrl) {
+                    $q->orWhere('r.source_url', $originalImageUrl)->orWhere('d.original_source', $originalImageUrl);
+                }
+            })->first(['r.id', 'r.title']);
+        }
+        if ($image) {
+            // A public flag alone never licenses missing or changed image bytes.
+            $binary = (clone $images)->where('r.id', $image->id)->first(['d.*']);
+            try {
+                app(VerifiedDocumentBinary::class)->respond($binary);
+            } catch (HttpException) {
+                $image = null;
+            }
+        }
+        $originalFormat = $original && ($content['preserve_original_html'] ?? false) && $content['body'] === $this->plain($original['content_html']);
+        $html = $originalFormat ? app(LegacyContent::class)->sanitize($original['content_html'], true) : null;
+        $imageReferences = [];
+        if ($original) {
+            preg_match_all('~<img\b[^>]*\bsrc\s*=\s*([\'"])(.*?)\1~is', $original['content_html'], $matches);
+            foreach ($matches[2] as $source) {
+                $url = $this->sourceUrl(html_entity_decode($source, ENT_QUOTES | ENT_HTML5, 'UTF-8'), $original['source_url'] ?? null);
+                if ($url) {
+                    $imageReferences[] = $url;
+                }
+            }
+        }
+
+        return ['id' => $resource->id, 'title' => $resource->title, 'description' => $resource->description,
+            'author' => $document->issuer, 'body' => $content['body'], 'html' => $html,
+            'image_url' => $image ? '/documentos/'.$image->id.'/view' : null,
+            'image_notice' => $mode === 'selected' && ! $image ? 'A imagem escolhida está indisponível para divulgação; a selecção mantém-se na edição.' : ($mode === 'original' && ! $image && ! empty($original['image_source_url']) ? 'Imagem de origem referenciada, mas sem exemplar público verificado na biblioteca. A referência original mantém-se preservada.' : null),
+            'source_url' => $this->sourceUrl($original['source_url'] ?? $resource->source_url),
+            'published_at' => $original['published_at'] ?? null, 'modified_at' => $original['modified_at'] ?? null,
+            'legacy_id' => $original['legacy_id'] ?? null, 'image_source_url' => $originalImageUrl, 'image_expected_sha256' => $expectedImageSha, 'image_references' => array_values(array_unique($imageReferences)),
+            'metadata_version' => $resource->metadata_version, 'private_preview' => $private,
+            'original_url' => $private ? '/management/documents/'.$resource->document_id.'/download' : '/documentos/'.$resource->id,
+        ];
+    }
+}

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'] : [])],
@@ -231,16 +231,25 @@ class InvestmentCatalogue
                 } elseif (in_array($relation, ['clusters', 'corridors'], true)) {
                     $query->whereIn('id', $this->publicStructureIds($relation, $foreign));
                 } else {
-                    $query->whereIn('id', InvestmentPortfolioController::visible()->whereNotNull($foreign)->pluck($foreign));
+                    $query->whereIn('id', app(OpportunityClassification::class)->targets('project')->select('id'));
                 }
             }
             if (! $management && $path !== [] && $relation !== 'locations') {
                 $dossiers = InvestmentPortfolioController::visible();
                 app(InvestmentGeography::class)->constrainDossiersToTerritories($dossiers,
                     app(InvestmentGeography::class)->descendants($path[array_key_last($path)]->id));
-                $query->whereIn('id', $dossiers->whereNotNull($foreign)->select($foreign));
+                $territories = app(InvestmentGeography::class)->descendants($path[array_key_last($path)]->id);
+                $query->where(fn ($area) => $area->whereIn('primary_territory_id', $territories)
+                    ->orWhereIn('id', $dossiers->whereNotNull($foreign)->select($foreign)));
             }
             $result[$relation] = $query->orderBy('name')->get(['id', 'name']);
+            if (! $management && $relation !== 'locations') {
+                $dossiers = InvestmentPortfolioController::visible()->whereIn($foreign, $result[$relation]->pluck('id'))
+                    ->orderBy('id')->get(['id', $foreign])->unique($foreign)->keyBy($foreign);
+                $result[$relation]->each(function ($record) use ($dossiers): void {
+                    $record->url = isset($dossiers[$record->id]) ? '/carteira/'.$dossiers[$record->id]->id : null;
+                });
+            }
         }
 
         $zones = app(InvestmentZones::class)->visible();
@@ -250,24 +259,15 @@ class InvestmentCatalogue
                 ['province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'geo_location_id']));
         }
         $result['zones'] = $zones->orderBy('name')->get(['id', 'name', 'category']);
-        if (! $management && ($path !== [] || ! empty($territoryFilters['sector']))) {
-            $scope = \Illuminate\Support\Arr::only($territoryFilters, ['sector','province_id','district_id','admin_post_id','locality_id','include_national']);
-            $available = ['chain' => [], 'activity' => []];
-            $this->query($scope)->reorder()->chunkById(200, function ($records) use (&$available) {
-                foreach ($records as $record) {
-                    foreach (app(OpportunityClassification::class)->publicRows($record) as $row) {
-                        if (isset($available[$row['target_type']])) $available[$row['target_type']][] = $row['target_id'];
-                    }
-                    foreach (['subsector_id','economic_activity_id'] as $key) {
-                        $id = $record->workflow_context['publication']['taxonomy'][$key] ?? null;
-                        if ($id) $available['activity'][] = $id;
-                    }
-                }
-            }, 'opportunities.id', 'id');
-            foreach ($available as $kind => $ids) {
-                $result['classification']['targets'][$kind] = collect($result['classification']['targets'][$kind])->whereIn('id', $ids)->values();
-            }
+        if (! $management && $path !== []) {
+            // A chain's documented scope comes from its public cluster, never
+            // from the opportunities surviving the current search.
+            $ids = app(OpportunityClassification::class)->targets('chain')
+                ->whereIn('cluster_id', $result['clusters']->pluck('id'))->pluck('id');
+            $result['classification']['targets']['chain'] = collect($result['classification']['targets']['chain'])->whereIn('id', $ids)->values();
         }
+        // Activities are a public classification catalogue, not evidence of
+        // investment availability in a territory or sector.
 
         return $result;
     }
@@ -292,6 +292,10 @@ class InvestmentCatalogue
                 }
             }
         });
+        if (!empty($selected['corridor_id'])) {
+            $dossier = InvestmentPortfolioController::visible()->where('corridor_id', $selected['corridor_id'])->first();
+            if ($dossier) $ids['corridor_id'] = array_values(array_unique([...($ids['corridor_id'] ?? []), ...app(CorridorAgribusinessOpportunities::class)->portfolioOpportunityIds($dossier)]));
+        }
         return $ids;
     }
 
@@ -308,6 +312,18 @@ class InvestmentCatalogue
     /** @return array<string,mixed> */
     public function context(int $id, bool $management = false): array
     {
+        $opportunity = Opportunity::findOrFail($id);
+        if (! $management && data_get($opportunity->workflow_context, 'publication.purpose') === OpportunityPromotion::PURPOSE) {
+            // Promotional disclosure includes only its explicit public coverage.
+            // Private profiles, source evidence and other dossier relations are not auto-published.
+            $public = ['profile' => null, 'facets' => collect(), 'zones' => collect(), 'classification' => [], 'source_evidence' => [],
+                'primary_territory_path' => app(InvestmentGeography::class)->path($opportunity->primary_territory_id, true),
+                'opportunity_locations' => app(InvestmentRelations::class)->opportunityLocations($id)];
+            foreach (self::RELATIONS as $relation => $_) $public[$relation] = collect();
+            $public['locations'] = DB::table('opportunity_locations as l')->join('geo_locations as g', 'g.id', '=', 'l.geo_location_id')
+                ->where('l.opportunity_id', $id)->where('g.data_classification', 'public')->whereNull('g.deleted_at')->get(['g.id', 'g.name']);
+            return $public;
+        }
         $result = ['profile' => DB::table('opportunity_profiles')->where('opportunity_id', $id)->first(),
             'facets' => DB::table('opportunity_facets as f')->join('investment_reference_options as o', 'o.id', '=', 'f.option_id')
                 ->where('f.opportunity_id', $id)->get(['o.id', 'o.group', 'o.label'])];

app/Services/InvestmentComplements.php

@@ -0,0 +1,157 @@
+<?php
+
+namespace App\Services;
+
+use App\Http\Controllers\InvestmentPortfolioController;
+use App\Models\Opportunity;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Support\Str;
+
+/** Resolve documented complements without creating opportunities or master relations. */
+final class InvestmentComplements
+{
+    private const TERMS = [
+        'irrigation' => ['Regadio', 'regadio|irrigação|irrigacao'],
+        'storage' => ['Silos e armazenagem', 'silos?|armazenagem|armazenamento'],
+        'cold' => ['Cadeia de frio', 'frio|refrigeração'],
+        'processing' => ['Processamento', 'processamento|transformação|moagem'],
+        'spinning' => ['Fiação', 'fiação|fiacao'],
+        'logistics' => ['Logística', 'logística|logistica|transporte'],
+        'certification' => ['Certificação', 'certificação|certificacao'],
+        'training' => ['Formação', 'formação|formacao'],
+        'finance' => ['Financiamento', 'financiamento|serviços financeiros'],
+    ];
+
+    public function options(string $origin, ?string $territory = null): array
+    {
+        [$originKind, $originId] = array_pad(explode(':', $origin, 2), 2, '');
+        abort_unless(($originKind === 'portfolio' && Str::isUuid($originId)) || ($originKind === 'opportunity' && ctype_digit($originId)), 422, 'Origem complementar inválida.');
+        $principal = null;
+        $relationEvidence = [];
+        if (str_starts_with($origin, 'portfolio:')) {
+            $record = InvestmentPortfolioController::visible()->addSelect('version_no')->findOrFail(substr($origin, 10));
+            $text = trim(($record->content['focus'] ?? '')."\n".($record->content['gaps'] ?? '')."\n".($record->content['description'] ?? ''));
+            $reference = ['key' => $origin, 'title' => $record->title, 'href' => '/carteira/'.$record->id, 'version' => $record->version_no];
+            $ids = app(CorridorAgribusinessOpportunities::class)->portfolioOpportunityIds($record);
+            foreach (['projects' => 'project_id', 'clusters' => 'cluster_id', 'corridors' => 'corridor_id'] as $relation => $foreign) {
+                if ($record->$foreign) $ids = [...$ids, ...DB::table('opportunity_'.$relation)->where($foreign, $record->$foreign)->pluck('opportunity_id')->all()];
+            }
+            $basis = $record->source;
+            foreach (array_unique($ids) as $id) $relationEvidence[$id] = ['type' => 'portfolio', 'origin' => $origin, 'source' => $basis];
+            $serviceOrigins = [['dossier', $record->id]];
+            foreach (['project_id' => 'project', 'cluster_id' => 'cluster'] as $foreign => $type) {
+                if ($record->$foreign) $serviceOrigins[] = [$type, $record->$foreign];
+            }
+        } else {
+            $reference = app(InvestorContext::class)->reference($origin);
+            abort_unless($reference['kind'] === 'opportunity', 422);
+            $principal = Opportunity::published()->findOrFail($reference['id']);
+            $text = $principal->summary;
+            $basis = 'Resumo cadastrado da oportunidade '.$principal->reference;
+            $projects = DB::table('opportunity_projects')->where('opportunity_id', $principal->id)->pluck('project_id');
+            $links = DB::table('complementary_project_links')->whereIn('anchor_project_id', $projects)
+                ->whereNull('deleted_at')->where('data_classification', 'public')->get(['id', 'anchor_project_id', 'complementary_project_id', 'relation_type', 'version_no']);
+            $targetProjects = DB::table('opportunity_projects')->whereIn('project_id', $links->pluck('complementary_project_id'))->get();
+            $ids = [$principal->id, ...$targetProjects->pluck('opportunity_id')->all()];
+            $relationEvidence[$principal->id] = ['type' => 'same_fiche', 'source' => $basis];
+            foreach ($targetProjects as $targetProject) $relationEvidence[$targetProject->opportunity_id] = ['type' => 'complementary_project',
+                'links' => $links->where('complementary_project_id', $targetProject->project_id)->values()->map(fn($link) => (array)$link)->all()];
+            foreach (Opportunity::published()->whereIn('id', $ids)->where('id', '!=', $principal->id)->get() as $linked) $text .= "\n".$linked->summary;
+            if (count($ids) > 1) $basis .= '; relações complementares públicas entre projectos';
+            $serviceOrigins = [['investment', (string) $principal->id]];
+            $classification = app(OpportunityClassification::class);
+            $principalChains = collect($classification->publicRows($principal))->where('target_type', 'chain')->filter(fn($r) => !empty($r['source_reference']));
+            $chains = $principalChains->pluck('target_id')->all();
+            if ($chains) {
+                Opportunity::published()->whereNot('id', $principal->id)->chunkById(100, function ($records) use (&$ids, &$relationEvidence, $chains, $principalChains, $classification) {
+                    foreach ($records as $candidate) {
+                        $related = collect($classification->publicRows($candidate))->where('target_type', 'chain')->filter(fn($r) => !empty($r['source_reference']));
+                        $shared = array_intersect($chains, $related->pluck('target_id')->all());
+                        if ($shared) {
+                            $ids[] = $candidate->id;
+                            $relationEvidence[$candidate->id] ??= ['type' => 'value_chain', 'principal' => $principalChains->whereIn('target_id', $shared)->values()->all(), 'target' => $related->whereIn('target_id', $shared)->values()->all()];
+                        }
+                    }
+                });
+            }
+        }
+        $territoryReference = $territory ? app(InvestorContext::class)->reference('territory:'.$territory) : null;
+        $candidates = Opportunity::published()->whereIn('id', array_unique($ids))->get();
+        $items = [];
+        foreach (self::TERMS as $code => [$label, $pattern]) {
+            if (!preg_match('/\b(?:'.$pattern.')\b/iu', $text, $match)) continue;
+            $offers = [];
+            foreach ($candidates as $candidate) {
+                // A common corridor alone does not prove the component. Keep the supporting excerpt.
+                if (!preg_match('/\b(?:'.$pattern.')\b/iu', $candidate->title."\n".$candidate->summary, $evidence)) continue;
+                // Mentioning a need for funding/training in a project's summary is not an offer.
+                if (in_array($code, ['certification', 'training', 'finance'], true) && !preg_match('/\b(?:'.$pattern.')\b/iu', $candidate->title)) continue;
+                if (in_array($code, ['certification', 'training', 'finance'], true) && preg_match('/\b(?:necessidade|pedido|procura)\b/iu', $candidate->title)) continue;
+                if ($territory && $candidate->primary_territory_id && !$this->compatible($territory, $candidate->primary_territory_id)) continue;
+                $offers[] = ['key' => 'opportunity:'.$candidate->id, 'title' => $candidate->title, 'href' => '/oportunidades/'.$candidate->slug,
+                    'relationship' => $relationEvidence[$candidate->id] ?? null,
+                    'version' => $candidate->management_version, 'evidence' => $evidence[0], 'location' => ($principal && $principal->id === $candidate->id ? 'Componente referido na própria ficha. ' : '').($candidate->primary_territory_id ? app(InvestorContext::class)->reference('territory:'.$candidate->primary_territory_id)['title'] : 'Implantação por definir')];
+            }
+            // Services are concrete published offerings explicitly associated with this source.
+            $services = [];
+            if (in_array($code, ['certification', 'training', 'finance'], true) && Schema::hasTable('partnership_origins') && Schema::hasTable('partnership_interests')) {
+                if ($serviceOrigins) {
+                    $services = DB::table('portal_partnerships as p')->join('partnership_origins as o', 'o.partnership_id', '=', 'p.id')
+                        ->where(function ($q) use ($serviceOrigins) {
+                            foreach ($serviceOrigins as [$type, $id]) $q->orWhere(fn($q) => $q->where('o.type', $type)->where('o.target_id', $id));
+                        })->where('p.status', 'published')->where('p.kind', 'offering')
+                        ->where('p.partnership_type', $code === 'finance' ? 'finance' : 'training')
+                        ->when($code !== 'finance', fn($q) => $q->where(fn($q) => $q->where('p.title', 'ilike', '%'.$match[0].'%')->orWhereRaw("p.payload->>'summary' ILIKE ?", ['%'.$match[0].'%'])))->distinct()->get(['p.id', 'p.title'])
+                        ->filter(function ($p) use ($territory) {
+                            if (!$territory) return true;
+                            $locations = DB::table('partnership_locations')->where('partnership_id', $p->id)->pluck('geo_location_id');
+                            return $locations->isEmpty() || $locations->contains(fn($id) => $this->compatible($territory, $id));
+                        })->map(fn ($p) => ['key' => 'partnership:'.$p->id, 'title' => $p->title, 'href' => '/parcerias/'.$p->id, 'location' => 'Consultar âmbito na oferta'])->values()->all();
+                }
+            }
+            $excerpt = collect(explode("\n", $text))->first(fn($line) => preg_match('/\b(?:'.$pattern.')\b/iu', $line));
+            $items[] = ['code' => $code, 'title' => $label, 'origin' => $reference, 'territory_id' => $territory, 'territory' => $territoryReference,
+                'source' => $basis, 'excerpt' => $excerpt, 'source_sha256' => hash('sha256', $text), 'opportunities' => $offers, 'services' => $services];
+        }
+        return $items;
+    }
+
+    private function compatible(string $a, string $b): bool
+    {
+        if ($a === $b) return true;
+        $geo = app(InvestmentGeography::class);
+        return in_array($b, $geo->descendants($a), true) || in_array($a, $geo->descendants($b), true);
+    }
+
+    public function resolve(array $input, array $previous = []): array
+    {
+        $resolved = [];
+        foreach ($input as $choice) {
+            $target = $choice['target'] ?? null;
+            $old = collect($previous)->first(fn($r) => $r['origin']['key'] === $choice['origin'] && $r['code'] === $choice['code'] && ($r['target']['key'] ?? null) === $target && ($r['territory_id'] ?? null) === ($choice['territory_id'] ?? null));
+            try {
+                $item = collect($this->options($choice['origin'], $choice['territory_id'] ?? null))->firstWhere('code', $choice['code']);
+            } catch (\Illuminate\Database\Eloquent\ModelNotFoundException $e) {
+                if (!$old) throw $e;
+                $item = null;
+            } catch (\Symfony\Component\HttpKernel\Exception\HttpException $e) {
+                if (!$old || $e->getStatusCode() !== 404) throw $e;
+                $item = null;
+            }
+            $offer = $target && $item ? collect([...$item['opportunities'], ...$item['services']])->firstWhere('key', $target) : null;
+            if ($old && (!$item || ($target && !$offer) || (!$target && ($item['opportunities'] || $item['services'])))) {
+                $resolved[$old['key']] = [...$old, 'availability' => 'review_required'];
+                continue;
+            }
+            abort_unless($item, 422, 'Complemento sem referência documentada neste investimento.');
+            abort_if($target && !$offer, 422, 'A oferta complementar deixou de estar disponível neste contexto.');
+            abort_if(!$target && ($item['opportunities'] || $item['services']), 422, 'Já existe uma oferta relacionada; seleccione a ficha correspondente.');
+            $key = hash('sha256', $choice['origin'].'|'.$choice['code'].'|'.($target ?? 'idea').'|'.($choice['territory_id'] ?? ''));
+            $resolved[$key] = ['key' => $key, 'origin' => $item['origin'], 'code' => $item['code'], 'title' => $item['title'],
+                'kind' => $target ? (str_starts_with($target, 'opportunity:') ? 'opportunity' : 'service') : 'need',
+                'target' => $offer, 'territory_id' => $item['territory_id'], 'territory' => $item['territory'], 'source' => $item['source'], 'excerpt' => $item['excerpt'], 'source_sha256' => $item['source_sha256']];
+        }
+        return array_values($resolved);
+    }
+}

app/Services/InvestmentConsumerScope.php

@@ -0,0 +1,85 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\User;
+use Illuminate\Support\Arr;
+
+/** An identified opportunity within the authorised dossier, never the account's last choice. */
+final class InvestmentConsumerScope
+{
+    public function key(array $context, ?string $key, bool $required = false): ?string
+    {
+        $choices = $context['opportunity_choices'] ?? [];
+        $key = $key ?: (count($choices) === 1 ? $choices[0]['opportunity']['key'] : null);
+        abort_if($key && !collect($choices)->contains('opportunity.key', $key), 422, 'Escolha uma oportunidade deste dossier.');
+        abort_if($required && count($choices) > 1 && !$key, 422, 'Escolha a oportunidade em tratamento.');
+        return $key;
+    }
+
+    public function facts(array $payload, array $context, ?string $key): array
+    {
+        $key = $this->key($context, $key);
+        $path = $payload['investor_path'] ?? [];
+        $defaults = ['land_needed' => 'unknown', 'external_funding' => 'unknown', 'viability' => 'unknown'];
+        // A dossier-wide dispensation cannot decide a distinct opportunity's needs.
+        if ($key && count($context['opportunity_choices'] ?? []) > 1) return [...$defaults, ...($path['opportunity_facts'][$key] ?? [])];
+        if ($key && isset($path['opportunity_facts'][$key])) return [...$defaults, ...$path['opportunity_facts'][$key]];
+        if (count($context['opportunity_choices'] ?? []) > 1) return $defaults;
+        return [...$defaults, ...($path['facts'] ?? [])];
+    }
+
+    public function context(array $context, ?string $key): array
+    {
+        $choices = $context['opportunity_choices'] ?? [];
+        if (!$choices) return $context;
+        $key = $key ?: (count($choices) === 1 ? $choices[0]['opportunity']['key'] : null);
+        $choice = $key ? collect($choices)->firstWhere('opportunity.key', $key) : null;
+        abort_if($key && !$choice, 422, 'Escolha uma oportunidade deste dossier.');
+        $specific = ['project_summary', 'sector_id', 'sector', 'province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location', 'special_zone_id', 'investment_regime'];
+        $context['fields'] = Arr::except($context['fields'], $specific);
+        $context['provenance'] = Arr::except($context['provenance'] ?? [], $specific);
+        $context['selection'] = Arr::except($context['selection'], ['opportunity', 'territory', 'park']);
+        if (!$choice) {
+            $context['opportunity_choices'] = [];
+            $context['requirements_assessment']['requirements'] = [];
+            return $context;
+        }
+        $context['selection']['opportunity'] = $choice['opportunity'];
+        $context['fields'] = [...$context['fields'], ...Arr::only($choice['opportunity']['fields'], $specific)];
+        foreach (Arr::only($choice['opportunity']['fields'], $specific) as $field => $value) $context['provenance'][$field] = Arr::only($choice['opportunity'], ['key','kind','id','title','version','sha256']);
+        unset($context['selection']['sector']);
+        if (!empty($context['fields']['sector_id'])) $context['selection']['sector'] = app(InvestorContext::class)->reference('sector:'.$context['fields']['sector_id']);
+        if ($choice['territory']) {
+            $context['selection']['territory'] = $choice['territory'];
+            $context['fields'] = [...Arr::except($context['fields'], array_keys(InvestmentGeography::FIELDS)), ...$choice['territory']['fields']];
+            foreach ($choice['territory']['fields'] as $field => $value) $context['provenance'][$field] = Arr::only($choice['territory'], ['key','kind','id','title','version','sha256']);
+        } else {
+            $context['fields'] = Arr::except($context['fields'], ['province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location']);
+        }
+        $park = $choice['park'] ?? null;
+        if ($park) $context['selection']['park'] = $park;
+        $context['fields']['special_zone_id'] = $park['id'] ?? '';
+        $context['fields']['investment_regime'] = $park['fields']['investment_regime'] ?? 'general';
+        $context['opportunity_choices'] = [$choice];
+        $context['requirements_assessment']['requirements'] = array_values(array_filter($context['requirements_assessment']['requirements'] ?? [], fn($r) => $r['opportunity_key'] === $key));
+        $context['consumer_opportunity'] = $choice;
+        $context['complements'] = array_values(array_filter($context['complements'] ?? [], fn($c) => ($c['origin']['key'] ?? null) === $key || ($c['target']['key'] ?? null) === $key || in_array(substr($c['origin']['key'] ?? '',10),array_column($choice['portfolio_origins'] ?? [],'id'),true)));
+        $context['dependency_hash'] = app(InvestorContext::class)->dependencyHash(['opportunity_choices'=>[$choice], 'fields'=>Arr::except($context['fields'],['project_title','project_summary']), 'complements'=>$context['complements']]);
+        return $context;
+    }
+
+    public function bind(User $actor, string $id, array $payload, bool $required = false): array
+    {
+        $case = app(VirtualDesk::class)->case($actor, $id, true);
+        $context = app(InvestorContext::class)->state($case);
+        $scoped = $this->context($context, $payload['context_opportunity'] ?? null);
+        $choice = $scoped['consumer_opportunity'] ?? null;
+        abort_if($required && count($context['opportunity_choices'] ?? []) > 1 && !$choice, 422, 'Escolha a oportunidade em tratamento antes de submeter.');
+        if (!$choice) return Arr::except($payload, ['context_opportunity', 'context_opportunity_snapshot']);
+        // Canonical server snapshot; client text cannot establish a different origin or territory.
+        $payload['context_opportunity'] = $choice['opportunity']['key'];
+        $payload['context_opportunity_snapshot'] = json_encode(['context_id' => $id, 'revision' => $context['revision'], 'choice' => $choice, 'requirements' => $scoped['requirements_assessment'] ?? null], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
+        return $payload;
+    }
+}

app/Services/InvestmentContextRequirements.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace App\Services;
+
+/** Preparation within the existing path; no licence, DUAT or fiscal benefit is granted. */
+final class InvestmentContextRequirements
+{
+    public const VERSION = 'context-requirements-20261023';
+
+    public function assess(array $context): array
+    {
+        $rows = [];
+        foreach ($context['opportunity_choices'] ?? [] as $choice) {
+            $activities = $choice['activities'] ?? [];
+            $key = $choice['opportunity']['key'];
+            $common = ['opportunity_key' => $key, 'opportunity_title' => $choice['opportunity']['title']];
+            $add = function ($code, $title, $state, $step, $authority, $documents, $basis, $url) use (&$rows, $common) {
+                $rows[] = [...$common, 'code' => $code, 'title' => $title, 'state' => $state, 'step' => $step,
+                    'authority' => $authority, 'documents' => $documents, 'basis' => $basis, 'source_url' => $url,
+                    'decision' => 'Preparação; enquadramento e acto concreto conservam confirmação na etapa correspondente.'];
+            };
+            $add('geography', 'Localização e geolocalização', $choice['territory'] ? 'selected' : 'missing', 'S09', 'Cadastro territorial e serviços de cadastro competentes',
+                ['Referência administrativa confirmada', 'Planta/esboço e coordenadas quando disponíveis; não inventar polígonos'],
+                'Referência territorial escolhida no dossier; não comprova disponibilidade nem direito de uso.', '/investimentos');
+            $add('land', 'Acesso à terra e DUAT', 'conditional', 'S10', 'Serviços de cadastro e órgão competente para o pedido territorial concreto',
+                ['Fundamento do uso: DUAT, arrendamento ou situação declarada', 'Planta/esboço do local; documentação do pedido correspondente'],
+                'Regulamento de Investimento, artigos 9(1)(c)–(d) e 14(1)(c)–(d). A preparação distingue DUAT e arrendamento; escolher território não atribui terra.', PrivateInvestmentPreparation::SOURCE.'#page=42');
+            $add('environment', 'Enquadramento ambiental', 'conditional', 'S08', 'Autoridade de Avaliação do Impacto Ambiental; competência central/provincial conforme categorização',
+                ['Descrição da actividade, dimensão e localização', 'Instrumento ambiental definido pela categorização competente; acto e condições quando emitidos'],
+                'Decreto 54/2015: a natureza, dimensão e localização determinam o enquadramento; a categoria não é deduzida do corredor ou do sector.', 'https://sibmoz.gov.mz/legal-framework/');
+            $add('sector', 'Licenciamento sectorial', $activities ? 'declared' : 'missing', 'S08', 'BAU, IP e autoridade sectorial competente conforme a actividade',
+                ['Actividades efectivas e modalidade', 'Requerimento e anexos da modalidade aplicável; acto quando emitido'],
+                'Identificar as actividades efectivas antes de seleccionar o procedimento. O nome Agronegócio não escolhe uma licença única.', 'https://www.bau.gov.mz/nossos-servicos/');
+            foreach (['processing' => ['Licenciamento industrial', 'Decreto 22/2014'], 'trade' => ['Licenciamento comercial', 'Decreto 34/2013']] as $activity => [$title, $basis]) {
+                if (in_array($activity, $activities, true)) $add($activity, $title, 'conditional', 'S08', 'BAU, IP / entidade licenciadora da modalidade',
+                    ['Caracterização do estabelecimento e actividade', 'Documentos e regime aplicáveis, incluindo simplificado ou mera comunicação quando preenchidas as suas condições'],
+                    $basis.'; regimes 39/2017 e 27/2023 no catálogo oficial BAU. Dimensão e modalidade ainda devem ser especificadas; não se selecciona automaticamente o regime.', 'https://www.bau.gov.mz/legislacao/');
+            }
+            foreach (['water' => 'Uso de água', 'forestry' => 'Actividade florestal', 'animal' => 'Actividade pecuária', 'transport' => 'Transporte e logística'] as $activity => $title) {
+                if (in_array($activity, $activities, true)) $add($activity, $title, 'undetermined', 'S08', 'Autoridade sectorial competente a identificar para a modalidade declarada',
+                    ['Modalidade e dimensão da actividade', 'Fonte e documentação sectorial específica a associar ao dossier'],
+                    'Actividade declarada; a referência do lote não contém o procedimento específico. Não se considera dispensada ou autorizada.', 'https://www.apiex.gov.mz/wp-content/uploads/2024/01/Mozambique-Business-Licensing-Guide.pdf');
+            }
+        }
+        return ['version' => self::VERSION, 'requirements' => $rows,
+            'fiscal_notice' => 'Localização, corredor, cluster ou projecto âncora não activam benefícios fiscais. O simulador mantém as condições, fonte, período e âmbito próprios; condições ausentes permanecem indeterminadas.'];
+    }
+}

app/Services/InvestmentCorridorContext.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Opportunity;
+use Illuminate\Support\Facades\DB;
+
+final class InvestmentCorridorContext
+{
+    public function key(Opportunity $record): ?string
+    {
+        $name = data_get($record->workflow_context, 'corridor_agribusiness.corridor');
+        foreach (config('investment_corridors') as $key => $entry) if ($entry['name'] === $name) return $key;
+        return null;
+    }
+
+    public function provinces(string $key): array
+    {
+        $entry = config('investment_corridors.'.$key);
+        abort_unless(is_array($entry), 422, 'Seleccione um corredor disponível.');
+        $records = app(InvestmentGeography::class)->publicReferences()->where('location_type', 'province')
+            ->whereIn('source_code', $entry['provinces'])->get(['id', 'name', 'parent_id', 'location_type', 'source_code'])->all();
+        abort_unless(count($records) === count($entry['provinces']), 503, 'Não foi possível recuperar todas as províncias deste corredor. Tente novamente.');
+        return $records;
+    }
+
+    public function compatible(string $key, ?string $territory): bool
+    {
+        if (!$territory) return true;
+        $path = app(InvestmentGeography::class)->path($territory);
+        return $path !== [] && in_array($path[0]->id, array_column($this->provinces($key), 'id'), true);
+    }
+
+    /** Both membership in the selected area and documented public zone coverage are required. */
+    public function parks(?string $key, ?string $territory): array
+    {
+        if (!$key || !$territory) return [];
+        abort_unless($this->compatible($key, $territory), 422, 'A localização não pertence ao corredor escolhido.');
+        $selectedPath = array_column(app(InvestmentGeography::class)->path($territory), 'id');
+        $candidates = app(InvestmentZones::class)->visible()->whereIn('category', ['industrial_park', 'zee', 'zfi'])->orderBy('name')->get();
+        $result = [];
+        foreach ($candidates as $zone) {
+            $ids = DB::table('investment_zone_locations')->where('zone_id', $zone->id)->where('validation_status', 'validated')
+                ->whereIn('scope_type', ['legal_scope', 'administrative', 'site'])
+                ->where(fn($q)=>$q->whereNull('valid_from')->orWhereDate('valid_from','<=',today()))
+                ->where(fn($q)=>$q->whereNull('valid_until')->orWhereDate('valid_until','>=',today()))->get(['geo_location_id','scope_type'])->all();
+            if ($zone->primary_territory_id) $ids[] = (object)['geo_location_id'=>$zone->primary_territory_id,'scope_type'=>'site'];
+            foreach ($ids as $link) {
+                $id=$link->geo_location_id;
+                if (!$this->compatible($key, $id)) continue;
+                $path = array_column(app(InvestmentGeography::class)->path($id), 'id');
+                if (in_array($territory, $path, true) || ($link->scope_type==='legal_scope' && in_array($id, $selectedPath, true))) {
+                    $result[] = $zone->only(['id', 'name', 'category', 'version_no']); break;
+                }
+            }
+        }
+        return $result;
+    }
+}

app/Services/InvestmentOpportunityChoices.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace App\Services;
+
+use App\Http\Controllers\InvestmentPortfolioController;
+use App\Models\Opportunity;
+use Illuminate\Support\Facades\DB;
+
+/** Multiple identified references in the existing encrypted investment context. */
+final class InvestmentOpportunityChoices
+{
+    public function portfolioOrigins(array $ids, int $opportunity): array
+    {
+        $origins = [];
+        foreach (array_unique($ids) as $id) {
+            $record = InvestmentPortfolioController::visible()->addSelect('version_no')->findOrFail($id);
+            $kind = null;
+            if (in_array($opportunity, app(CorridorAgribusinessOpportunities::class)->portfolioOpportunityIds($record), true)) $kind = 'corridor';
+            foreach (['projects' => 'project_id', 'clusters' => 'cluster_id', 'corridors' => 'corridor_id'] as $relation => $foreign) {
+                if ($record->$foreign && DB::table('opportunity_'.$relation)->where('opportunity_id', $opportunity)->where($foreign, $record->$foreign)->exists()) $kind = rtrim($relation, 's');
+            }
+            abort_unless($kind, 422, 'A associação escolhida não pertence a esta oportunidade.');
+            $origins[] = ['id' => $record->id, 'title' => $record->title, 'kind' => $kind, 'href' => '/carteira/'.$record->id,
+                'version' => $record->version_no, 'sha256' => hash('sha256', json_encode([$record->title, $record->source, $record->content], JSON_THROW_ON_ERROR))];
+        }
+        return $origins;
+    }
+
+    /** Add explicitly consulted associations without resetting saved geography or deliberate answers. */
+    public function mergeEntries(array $saved, array $entries): array
+    {
+        foreach ($entries as $entry) {
+            $index = array_search($entry['opportunity']['key'], array_column(array_column($saved, 'opportunity'), 'key'), true);
+            if ($index === false) { $saved[] = $entry; continue; }
+            $origins = collect([...($saved[$index]['portfolio_origins'] ?? []), ...($entry['portfolio_origins'] ?? [])])->unique('id')->values()->all();
+            if ($origins) $saved[$index]['portfolio_origins'] = $origins;
+        }
+        return $saved;
+    }
+
+    public function resolve(array $choices, array $previous = [], bool $pending = false): array
+    {
+        $result = [];
+        foreach ($choices as $choice) {
+            $ref = app(InvestorContext::class)->reference($choice['source']);
+            abort_unless($ref['kind'] === 'opportunity', 422, 'Seleccione uma ficha de oportunidade.');
+            $record = Opportunity::findOrFail($ref['id']);
+            $old = collect($previous)->first(fn ($row) => $row['opportunity']['key'] === $ref['key']);
+            $origins = $this->portfolioOrigins($choice['portfolio_origins'] ?? array_column($old['portfolio_origins'] ?? [], 'id'), (int) $record->id);
+            $corridors = app(InvestmentCorridorContext::class);
+            $corridor = $choice['corridor_key'] ?? $old['corridor_key'] ?? $corridors->key($record);
+            $provinces = $corridor ? $corridors->provinces($corridor) : [];
+            $documented = $record->primary_territory_id;
+            $territory = array_key_exists('territory', $choice) ? $choice['territory'] : ($documented ? 'territory:'.$documented : null);
+            if (!$territory && count($provinces) === 1) $territory = 'territory:'.$provinces[0]->id;
+            if ($corridor && $territory) abort_unless($corridors->compatible($corridor, substr($territory, 10)), 422, 'A localização não pertence ao corredor escolhido.');
+            $previousTerritory = $old['territory']['key'] ?? null;
+            $newAlternative = $documented && $territory !== 'territory:'.$documented
+                && (! $old || ($old['documented_territory_id'] ?? null) !== $documented || $territory !== $previousTerritory);
+            $corridorChanged = $old && ($old['corridor_key'] ?? $corridors->key($record)) !== $corridor;
+            $incompatibleOld = $corridorChanged && $previousTerritory && !$corridors->compatible($corridor, substr($previousTerritory, 10));
+            if (!$pending && ($newAlternative || ($previousTerritory && $territory !== $previousTerritory && !$incompatibleOld))) {
+                abort_unless(! empty($choice['confirm_location_change']) && mb_strlen(trim($choice['location_reason'] ?? '')) >= 20,
+                    422, 'Uma localização documentada ou já confirmada só muda por escolha explícita, com confirmação e motivo.');
+            }
+            $location = $territory ? app(InvestorContext::class)->reference($territory) : null;
+            abort_unless($location === null || $location['kind'] === 'territory', 422);
+            $parkKey = array_key_exists('park', $choice) ? $choice['park'] : ($old['park']['key'] ?? null);
+            $park = $parkKey ? app(InvestorContext::class)->reference($parkKey) : null;
+            if ($park) {
+                $eligible = $corridor ? array_column($corridors->parks($corridor, $location['id'] ?? null), 'id') : [];
+                if (!in_array($park['id'], $eligible, true)) {
+                    abort_if(!empty($choice['park']), 422, 'A zona ou parque não é compatível com a localização desta oportunidade.');
+                    $park = null;
+                }
+                abort_unless(!$park || $park['kind'] === 'park', 422);
+            }
+            $result[] = ['opportunity' => $ref, 'territory' => $location, ...($origins ? ['portfolio_origins' => $origins] : []),
+                'park' => $park,
+                'corridor_key' => $corridor, 'corridor_name' => $corridor ? config('investment_corridors.'.$corridor.'.name') : null,
+                'allowed_provinces' => array_map(fn($p)=>(array)$p, $provinces),
+                'territory_path' => $location ? array_map(fn ($node) => \Illuminate\Support\Arr::only((array) $node, ['id', 'name', 'parent_id', 'location_type']), app(InvestmentGeography::class)->path($location['id'], true)) : [],
+                'activities' => $choice['activities'] ?? ($old['activities'] ?? []),
+                'documented_territory_id' => $documented, 'location_reason' => $choice['location_reason'] ?? '',
+                'location_state' => $location ? ($documented && $territory === 'territory:'.$documented ? 'documented' : 'investor_selected') : 'undetermined',
+                'location_changed_explicitly' => $old && $territory === $previousTerritory ? (bool) ($old['location_changed_explicitly'] ?? false) : (bool) ($choice['confirm_location_change'] ?? false),
+                'coverage' => data_get($record->workflow_context, 'corridor_agribusiness.corridor'),
+                'source' => data_get($record->workflow_context, 'corridor_agribusiness.source'),
+                'source_sha256' => data_get($record->workflow_context, 'corridor_agribusiness.source_sha256')];
+        }
+        return $result;
+    }
+}

app/Services/InvestorContext.php

@@ -5,6 +5,7 @@ namespace App\Services;
 use App\Models\ExistingBusiness;
 use App\Models\Opportunity;
 use App\Models\Sector;
+use App\Models\SimulationFormDraft;
 use App\Models\User;
 use Illuminate\Database\Eloquent\ModelNotFoundException;
 use Illuminate\Support\Arr;
@@ -12,6 +13,7 @@ use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Schema;
 use Illuminate\Support\Facades\Validator;
 use Illuminate\Support\Str;
+use Illuminate\Validation\Rule;
 use Symfony\Component\HttpKernel\Exception\HttpException;
 
 /** Context belongs to the existing encrypted dossier. Sources remain read-only. */
@@ -21,10 +23,71 @@ final class InvestorContext
 
     public const SOURCE = 'investor-context';
 
-    public const FIELDS = ['project_title', 'project_summary', 'sector_id', 'sector', 'province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location'];
+    public const FIELDS = ['project_title', 'project_summary', 'sector_id', 'sector', 'province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location', 'currency', 'expected_start_date', 'fiscal_period', 'fiscal_periodicity', 'fiscal_month', 'investor_origin', 'person_type', 'entity_stage', 'tax_residency_country', 'fiscal_residency_country', 'activity_id', 'project_type', 'maturity_stage', 'special_zone_id', 'investment_regime', ...PrivateInvestmentPreparation::FIELDS];
 
     public function __construct(private readonly VirtualDesk $desk) {}
 
+    public function draft(User $actor, string $id): ?array
+    {
+        $case = $this->desk->case($actor, $id, true);
+        $draft = $this->desk->decode($case->payload)['investor_path']['context_drafts'][(string)$actor->id] ?? null;
+        return $draft ? [...$draft, 'needs_review' => (int)$draft['version'] !== (int)$case->version] : null;
+    }
+
+    public function saveDraft(User $actor, string $id, array $input): array
+    {
+        $case=$this->desk->case($actor,$id,true);
+        abort_if($case->closed_at,409);
+        $sequence = (int)($input['draft_sequence'] ?? 0);
+        $entrySources=Validator::make($input,['entry_sources'=>'sometimes|array|max:200','entry_sources.*'=>'string|max:100'])->validate()['entry_sources']??[];
+        unset($input['draft_sequence'],$input['entry_sources']);
+        abort_unless($sequence > 0, 422);
+        $data = $this->input($input);
+        if (isset($data['complements'])) app(InvestmentComplements::class)->resolve($data['complements'], $this->state($case)['complements'] ?? []);
+        foreach ($data['selection'] as $slot=>$key) {
+            if (!$key) continue;
+            $ref=$this->reference($key);
+            abort_unless(in_array($ref['kind'],$slot==='opportunity'?['opportunity','business']:[$slot],true),422,'Referência incompatível com a escolha.');
+        }
+        foreach ($data['opportunity_choices'] ?? [] as $choice) {
+            $ref = $this->reference($choice['source']);
+            abort_unless($ref['kind'] === 'opportunity', 422);
+            $record = Opportunity::findOrFail($ref['id']);
+            app(InvestmentOpportunityChoices::class)->portfolioOrigins($choice['portfolio_origins'] ?? [], (int) $record->id);
+            $key = $choice['corridor_key'] ?? app(InvestmentCorridorContext::class)->key($record);
+            if (!empty($choice['territory'])) {
+                $location = $this->reference($choice['territory']);
+                abort_unless($location['kind'] === 'territory', 422);
+                if ($key) abort_unless(app(InvestmentCorridorContext::class)->compatible($key, $location['id']), 422, 'A localização não pertence ao corredor escolhido.');
+            }
+        }
+        if (isset($data['opportunity_choices'])) app(InvestmentOpportunityChoices::class)->resolve($data['opportunity_choices'], $this->state($case)['opportunity_choices'] ?? [], true);
+        if (!empty($data['selection']['park'])) {
+            $first=$data['opportunity_choices'][0] ?? null;
+            $source=$first['source'] ?? $data['selection']['opportunity'] ?? null;
+            if ($source && str_starts_with($source,'opportunity:')) {
+                $key=$first['corridor_key'] ?? app(InvestmentCorridorContext::class)->key(Opportunity::findOrFail(substr($source,12)));
+                if ($key) {
+                    $territory=$first['territory'] ?? $data['selection']['territory'] ?? null;
+                    $ids=app(InvestmentCorridorContext::class)->provinces($key);
+                    $territory=$territory ? substr($territory,10) : (count($ids)===1?$ids[0]->id:null);
+                    $park=$this->reference($data['selection']['park']);
+                    abort_unless($park['kind']==='park' && in_array($park['id'],array_column(app(InvestmentCorridorContext::class)->parks($key,$territory),'id'),true),422,'A zona ou parque não tem enquadramento compatível documentado nesta localização.');
+                }
+            }
+        }
+        return DB::transaction(function () use ($actor, $id, $data, $sequence, $entrySources) {
+            $case = $this->desk->case($actor, $id, true, true);
+            abort_if($case->closed_at || (int)$case->version !== (int)$data['version'], 409, 'O dossier mudou. Recupere os dados antes de continuar.');
+            $payload = $this->desk->decode($case->payload);
+            $previous = $payload['investor_path']['context_drafts'][(string)$actor->id] ?? [];
+            abort_if(($previous['draft_sequence'] ?? 0) > $sequence, 409, 'Existe um rascunho mais recente. Recupere o dossier antes de continuar.');
+            $payload['investor_path']['context_drafts'][(string)$actor->id] = [...$data, 'draft_sequence' => $sequence, 'entry_sources'=>array_values(array_unique([...($previous['entry_sources']??[]),...$entrySources]))];
+            DB::table('desk_cases')->where('id', $id)->update(['payload' => $this->desk->encode($payload)]);
+            return ['saved' => true];
+        });
+    }
+
     public function installed(): bool
     {
         return Schema::hasTable('investor_navigation_preferences');
@@ -34,12 +97,33 @@ final class InvestorContext
     {
         $payload = $this->desk->decode($case->payload);
 
-        return $payload['investor_path']['context'] ?? ['revision' => 0, 'selection' => [],
+        $context = $payload['investor_path']['context'] ?? ['revision' => 0, 'selection' => [],
             'fields' => ['project_title' => $case->title], 'provenance' => ['project_title' => ['kind' => 'dossier', 'id' => $case->id, 'version' => $case->version]], 'review_steps' => []];
+        // Explicit dossier anchor only: never the account's most recent simulation or another owner's draft.
+        if (($case->simulation_id ?? null) && request()->user()?->id === (int) $case->user_id) {
+            $draft = SimulationFormDraft::whereKey($case->simulation_id)->where('owner_user_id', $case->user_id)->whereNull('deleted_at')->first();
+            if ($draft) {
+                $values = [...SimulationFormDraft::decryptSnapshot($draft->personal_snapshot), ...SimulationFormDraft::decryptSnapshot($draft->economic_snapshot)];
+                foreach (Arr::only($values, self::FIELDS) as $key => $value) {
+                    if (is_scalar($value) && (string) $value !== '' && (! array_key_exists($key, $context['fields']) || ($context['provenance'][$key]['kind'] ?? null) === 'linked_simulation')) {
+                        $context['fields'][$key] = (string) $value;
+                        $context['provenance'][$key] = ['kind' => 'linked_simulation', 'id' => $draft->id, 'version' => $draft->version_no, 'sha256' => $draft->snapshot_sha256];
+                    }
+                }
+            }
+        }
+        if (!empty($context['opportunity_choices']) && !array_key_exists('park', $context['opportunity_choices'][0])) $context['opportunity_choices'][0]['park'] = $context['selection']['park'] ?? null;
+        $zone = $context['selection']['park'] ?? null;
+        $context['fields']['investment_regime'] = $zone['fields']['investment_regime'] ?? 'general';
+        $context['fields']['special_zone_id'] = $zone['id'] ?? '';
+
+        return $context;
     }
 
     public function dependencyHash(array $selection): string
     {
+        unset($selection['portfolio'], $selection['selection']['portfolio']);
+        if (isset($selection['opportunity_choices'])) $selection['opportunity_choices'] = array_map(fn($choice)=>Arr::except($choice,['portfolio_origins']),$selection['opportunity_choices']);
         return hash('sha256', json_encode(Arr::sortRecursive($selection), JSON_THROW_ON_ERROR));
     }
 
@@ -53,17 +137,20 @@ final class InvestorContext
         $documents = [];
         $visibility = 'public';
         $state = null;
+        $zoneAnalysis = null;
         if ($kind === 'opportunity') {
             abort_unless(ctype_digit($id), 422, 'Identificador de oportunidade inválido.');
             $o = Opportunity::with('sector')->findOrFail((int) $id);
             $published = Opportunity::published()->whereKey($o->id)->exists();
-            if (!$published) {
+            if (! $published) {
                 abort_unless(request()->user() && $o->status !== 'archived' && app(PortalProfileAccess::class)->canView(request()->user(), $o), 404, 'Ficha privada indisponível neste âmbito.');
                 $visibility = 'private';
                 $state = app(PortalProfileAccess::class)->state($o);
             }
-            if (request()->user()) $documents = app(OpportunityLibrarySupport::class)->snapshot(request()->user(), $o);
-            $draft = !$published ? app(OpportunityManagement::class)->values($o) : [];
+            if (request()->user()) {
+                $documents = app(OpportunityLibrarySupport::class)->snapshot(request()->user(), $o);
+            }
+            $draft = ! $published ? app(OpportunityManagement::class)->values($o) : [];
             $title = $draft['canonical']['official_title'] ?? $o->title;
             $href = $published ? '/oportunidades/'.$o->slug : '/minhas-oportunidades/'.$o->id.'/view';
             $version = $o->management_version;
@@ -82,6 +169,18 @@ final class InvestorContext
             if ($o->primary_territory_id) {
                 $fields = [...$fields, ...$this->territoryFields($o->primary_territory_id)];
             }
+        } elseif ($kind === 'portfolio') {
+            abort_unless(Str::isUuid($id), 422);
+            $dossier = \App\Http\Controllers\InvestmentPortfolioController::visible()->findOrFail($id);
+            $title = $dossier->title;
+            $href = '/carteira/'.$id;
+            // Documentary coverage is not the investor's chosen implantation.
+            $version = DB::table('investment_dossiers')->where('id', $id)->value('version_no');
+            $fields = ['project_title' => $title, 'project_summary' => $dossier->content['description'] ?? $dossier->content['focus'] ?? ''];
+            $state = 'documented_origin';
+            $zoneAnalysis = ['source' => $dossier->source, 'documented_sector' => $dossier->content['sector'] ?? null,
+                'documented_location' => $dossier->content['location'] ?? $dossier->content['region'] ?? null,
+                'geography' => app(InvestmentRelations::class)->dossier($dossier), 'available_opportunity' => false];
         } elseif ($kind === 'business') {
             abort_unless(config('existing-business.enabled') && Str::isUuid($id), 404);
             $o = ExistingBusiness::published()->with('sector')->findOrFail($id);
@@ -122,19 +221,28 @@ final class InvestorContext
             $fields = $this->territoryFields($id);
         } elseif ($kind === 'park') {
             abort_unless(Str::isUuid($id), 422);
-            $p = app(InvestmentZones::class)->visible()->where('category', 'industrial_park')->findOrFail($id);
+            $p = app(InvestmentZones::class)->visible()->whereIn('category', ['industrial_park', 'zee', 'zfi'])->findOrFail($id);
             $title = $p->name;
+            $fields = ['special_zone_id' => (string) $p->id, 'investment_regime' => (string) $p->category];
             $version = $p->version_no;
+            $zoneAnalysis = ['conditions' => app(InvestmentZoneOperationalDetails::class)->publicData($p)['conditions'] ?? [],
+                'source' => $p->legal_source_id ? DB::table('investment_legal_sources')->where('id', $p->legal_source_id)->first(['title', 'url', 'diploma', 'article', 'valid_from', 'valid_until']) : null,
+                'recognition' => 'undetermined', 'executable_benefit' => false];
             $href = '/zonas/'.$id;
             if ($p->primary_territory_id) {
-                $fields = $this->territoryFields($p->primary_territory_id);
+                $fields = [...$fields, ...$this->territoryFields($p->primary_territory_id)];
             }
         } else {
             abort(422, 'Tipo de referência inválido.');
         }
         $fields = array_filter($fields, fn ($v) => is_scalar($v) && trim((string) $v) !== '');
         $record = ['key' => $key, 'kind' => $kind, 'id' => $id, 'title' => $title, 'version' => $version, 'href' => $href, 'fields' => $fields];
-        if ($documents || $visibility === 'private') $record += ['documents' => $documents, 'visibility' => $visibility, 'state' => $state];
+        if ($zoneAnalysis !== null) {
+            $record['analysis'] = $zoneAnalysis;
+        }
+        if ($documents || $visibility === 'private') {
+            $record += ['documents' => $documents, 'visibility' => $visibility, 'state' => $state];
+        }
 
         return [...$record, 'sha256' => hash('sha256', json_encode($record, JSON_THROW_ON_ERROR))];
     }
@@ -170,7 +278,11 @@ final class InvestorContext
         }
         if (request()->user()) {
             $private = app(PortalProfileAccess::class)->scope(Opportunity::query(), request()->user())->where('status', '!=', 'published')->where('status', '!=', 'archived')->when($query, fn ($q) => $q->where('title', 'ilike', '%'.$query.'%'))->orderBy('title')->limit(51)->get();
-            foreach ($private as $o) if (app(PortalProfileAccess::class)->canView(request()->user(), $o)) $items[] = ['key' => 'opportunity:'.$o->id, 'title' => $o->title.' — preparação privada', 'kind' => 'opportunity'];
+            foreach ($private as $o) {
+                if (app(PortalProfileAccess::class)->canView(request()->user(), $o)) {
+                    $items[] = ['key' => 'opportunity:'.$o->id, 'title' => $o->title.' — preparação privada', 'kind' => 'opportunity'];
+                }
+            }
         }
         if (config('existing-business.enabled')) {
             foreach (ExistingBusiness::published()->when($query, fn ($q) => $q->where('public_title', 'ilike', '%'.$query.'%'))->orderBy('public_title')->limit(51)->get(['id', 'public_title']) as $o) {
@@ -179,7 +291,7 @@ final class InvestorContext
         }
 
         return ['opportunities' => $items, 'search_limited' => count($items) > 50, 'sectors' => Sector::choices()->orderBy('name')->get(['id', 'name', 'slug']),
-            'parks' => app(InvestmentZones::class)->visible()->where('category', 'industrial_park')->orderBy('name')->get(['id', 'name', 'version_no'])];
+            'parks' => app(InvestmentZones::class)->visible()->whereIn('category', ['industrial_park', 'zee', 'zfi'])->orderBy('name')->get(['id', 'name', 'category', 'version_no'])];
     }
 
     public function current(User $actor): array
@@ -232,10 +344,32 @@ final class InvestorContext
 
     private function input(array $input): array
     {
-        abort_if(array_diff(array_keys($input), ['version', 'selection', 'declarations', 'replace_fields', 'preview_hash', 'operation_key', 'confirm', '_token']), 422, 'Campo de controlo desconhecido.');
+        abort_if(array_diff(array_keys($input), ['complements', 'opportunity_choices', 'version', 'selection', 'declarations', 'replace_fields', 'preview_hash', 'operation_key', 'confirm', 'document_links', '_token']), 422, 'Campo de controlo desconhecido.');
 
-        return Validator::make($input, ['version' => 'required|integer|min:1', 'selection' => 'present|array:opportunity,sector,territory,park',
-            'selection.*' => 'nullable|string|max:100', 'declarations' => 'nullable|array:project_title,project_summary', 'declarations.project_title' => 'nullable|string|max:200', 'declarations.project_summary' => 'nullable|string|max:5000',
+        abort_if(! app(PrivateInvestmentPreparation::class)->available() && (! empty($input['document_links']) || array_intersect(array_keys(is_array($input['declarations'] ?? null) ? $input['declarations'] : []), PrivateInvestmentPreparation::FIELDS)), 409, 'Esta preparação ainda não está disponível neste ambiente. As respostas foram preservadas.');
+
+        $inputRules = [
+            'document_links' => 'sometimes|array:'.implode(',', PrivateInvestmentPreparation::DOCUMENTS),
+            'document_links.*' => 'nullable|uuid',
+        ];
+        foreach (app(PrivateInvestmentPreparation::class)->questions() as $question) {
+            $inputRules['declarations.'.$question['key']] = isset($question['options']) ? ['nullable', Rule::in(array_keys($question['options']))] : ['nullable', 'regex:/^\d+(?:\.\d+)?$/D', 'numeric', 'min:0', 'max:999999999999999999'];
+        }
+
+        return Validator::make($input, [...$inputRules,
+            'complements' => 'sometimes|array|max:100', 'complements.*' => 'array:origin,code,target,territory_id',
+            'complements.*.origin' => 'required|string|max:100', 'complements.*.code' => 'required|string|max:40',
+            'complements.*.target' => 'nullable|string|max:100', 'complements.*.territory_id' => 'nullable|uuid',
+            'opportunity_choices' => 'sometimes|array|max:100', 'opportunity_choices.*' => 'array:source,territory,location_reason,confirm_location_change,activities,corridor_key,portfolio_origins,park',
+            'opportunity_choices.*.portfolio_origins' => 'sometimes|array|max:100', 'opportunity_choices.*.portfolio_origins.*' => 'uuid',
+            'opportunity_choices.*.corridor_key' => ['sometimes', 'nullable', Rule::in(array_keys(config('investment_corridors')))],
+            'opportunity_choices.*.activities' => 'sometimes|array', 'opportunity_choices.*.activities.*' => 'string|distinct|in:production,processing,trade,transport,water,forestry,animal',
+            'opportunity_choices.*.park' => 'sometimes|nullable|string|max:100',
+            'opportunity_choices.*.source' => 'required|string|distinct|max:100', 'opportunity_choices.*.territory' => 'nullable|string|max:100',
+            'opportunity_choices.*.location_reason' => 'nullable|string|max:2000', 'opportunity_choices.*.confirm_location_change' => 'sometimes|boolean',
+            'version' => 'required|integer|min:1', 'selection' => 'present|array:portfolio,opportunity,sector,territory,park',
+            'selection.*' => 'nullable|string|max:100', 'declarations' => 'nullable|array:project_title,project_summary,currency,expected_start_date,investor_origin,person_type,entity_stage,tax_residency_country,fiscal_residency_country,project_type,maturity_stage,'.implode(',', PrivateInvestmentPreparation::FIELDS), 'declarations.project_title' => 'nullable|string|max:200', 'declarations.project_summary' => 'nullable|string|max:5000',
+            'declarations.currency' => 'nullable|regex:/^[A-Z]{3}$/', 'declarations.expected_start_date' => 'nullable|date_format:Y-m-d', 'declarations.investor_origin' => 'nullable|in:national,foreign,mixed', 'declarations.person_type' => 'nullable|in:singular,collective,sole_trader,consortium', 'declarations.entity_stage' => 'nullable|in:existing,being_formed', 'declarations.tax_residency_country' => ['nullable', 'string', app(CountryCatalogue::class)->rule()], 'declarations.fiscal_residency_country' => ['nullable', 'string', app(CountryCatalogue::class)->rule()], 'declarations.project_type' => 'nullable|string|max:100', 'declarations.maturity_stage' => 'nullable|string|max:100',
             'replace_fields' => 'nullable|array', 'replace_fields.*' => 'string|in:'.implode(',', self::FIELDS)])->validate();
     }
 
@@ -247,7 +381,41 @@ final class InvestorContext
         abort_unless((int) $case->version === $data['version'], 409, 'O dossier mudou; recupere a versão atual.');
         app(InvestorPath::class)->view($actor, $id);
         $old = $this->state($case);
+        $complements = array_key_exists('complements', $data) ? app(InvestmentComplements::class)->resolve($data['complements'], $old['complements'] ?? []) : ($old['complements'] ?? []);
+        $links = $old['preparation_documents'] ?? [];
+        foreach ($data['document_links'] ?? [] as $key => $document) {
+            if ($document) {
+                abort_unless(DB::table('desk_documents as l')->join('documents as d', 'd.id', '=', 'l.document_id')->where('l.case_id', $id)->where('d.id', $document)->whereNull('d.deleted_at')->exists(), 422, 'Seleccione um documento já associado a este dossier; os dados anteriores foram preservados.');
+                $links[$key] = $document;
+            } else {
+                unset($links[$key]);
+            }
+        }
+        $choices = $old['opportunity_choices'] ?? [];
+        if (! array_key_exists('opportunity_choices', $data) && array_key_exists('territory', $data['selection'])) {
+            $source = $data['selection']['opportunity'] ?? ($old['selection']['opportunity']['key'] ?? null);
+            if ($source && str_starts_with($source, 'opportunity:')) {
+                $documented = Opportunity::findOrFail(substr($source, 12))->primary_territory_id;
+                abort_if($documented && $data['selection']['territory'] !== 'territory:'.$documented, 422,
+                    'Confirme a alternativa territorial por ficha e indique o motivo; a localização documentada foi preservada.');
+            }
+        }
+        if (array_key_exists('opportunity_choices', $data)) {
+            $choices = app(InvestmentOpportunityChoices::class)->resolve($data['opportunity_choices'], $choices);
+            $data['selection']['opportunity'] = $choices[0]['opportunity']['key'] ?? null;
+            // Shared fields concern the first identified opportunity; other sites remain separate.
+            $data['selection']['territory'] = $choices[0]['territory']['key'] ?? null;
+            if (array_key_exists('park', $data['opportunity_choices'][0] ?? [])) $data['selection']['park'] = $choices[0]['park']['key'] ?? null;
+        } elseif (array_key_exists('opportunity', $data['selection']) && $choices !== []) {
+            abort(422, 'Actualize a selecção identificada de oportunidades; não substitua silenciosamente o conjunto por uma ficha.');
+        }
         $selection = $old['selection'];
+        foreach ($complements as $complement) {
+            if (($complement['availability'] ?? '') === 'review_required') continue;
+            foreach ([$complement['origin']['key'], $complement['target']['key'] ?? ''] as $key) {
+                if (str_starts_with($key, 'opportunity:')) abort_unless(in_array($key, array_column(array_column($choices, 'opportunity'), 'key'), true), 422, 'Conserve a oportunidade escolhida ou retire explicitamente a sua relação complementar.');
+            }
+        }
         foreach ($data['selection'] as $slot => $key) {
             if ($key === null || $key === '') {
                 unset($selection[$slot]);
@@ -259,6 +427,16 @@ final class InvestorContext
             abort_unless(in_array($ref['kind'], $expected, true), 422, 'Referência incompatível com a dimensão.');
             $selection[$slot] = $ref;
         }
+        $corridor = $choices[0]['corridor_key'] ?? (isset($selection['opportunity']) && $selection['opportunity']['kind'] === 'opportunity'
+            ? app(InvestmentCorridorContext::class)->key(Opportunity::findOrFail($selection['opportunity']['id'])) : null);
+        if ($corridor && isset($selection['territory'])) abort_unless(app(InvestmentCorridorContext::class)->compatible($corridor, $selection['territory']['id']), 422, 'A localização não pertence ao corredor escolhido.');
+        if ($corridor && isset($selection['park'])) {
+            $eligible = array_column(app(InvestmentCorridorContext::class)->parks($corridor, $selection['territory']['id'] ?? null), 'id');
+            if (!in_array($selection['park']['id'], $eligible, true)) {
+                abort_if(!empty($data['selection']['park']), 422, 'A zona ou parque não tem enquadramento compatível documentado nesta localização.');
+                unset($selection['park']);
+            }
+        }
         // A new opportunity may propose its explicitly stored sector; it never matches names.
         if (isset($data['selection']['opportunity']) && ! array_key_exists('sector', $data['selection']) && isset($selection['opportunity']['fields']['sector_id'])) {
             if (Sector::where('is_active', true)->whereKey($selection['opportunity']['fields']['sector_id'])->exists()) {
@@ -267,7 +445,7 @@ final class InvestorContext
         }
         $proposed = [];
         $origins = [];
-        foreach (['opportunity', 'sector', 'park', 'territory'] as $slot) {
+        foreach (['portfolio', 'opportunity', 'sector', 'park', 'territory'] as $slot) {
             if (in_array($slot, ['park', 'territory'], true) && array_intersect(array_keys($selection[$slot]['fields'] ?? []), array_keys(InvestmentGeography::FIELDS))) {
                 foreach (['province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location'] as $key) {
                     unset($proposed[$key],$origins[$key]);
@@ -299,30 +477,65 @@ final class InvestorContext
         }
         // Remove inherited subordinate geography only when its source was actually replaced.
         foreach ($fields as $key => $value) {
-            if (! array_key_exists($key, $proposed) && in_array($key, ['province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location', 'sector_id', 'sector'], true) && isset($provenance[$key]['key'])) {
+            if (! array_key_exists($key, $proposed) && in_array($key, ['province_id', 'district_id', 'admin_post_id', 'locality_id', 'province', 'district', 'location', 'sector_id', 'sector', 'special_zone_id', 'investment_regime'], true) && isset($provenance[$key]['key'])) {
                 unset($fields[$key],$provenance[$key]);
             }
         }
+        if ($corridor) {
+            foreach (['province_id','district_id','admin_post_id','locality_id','province','district','location'] as $key) {
+                if (isset($selection['territory']['fields'][$key])) {
+                    $fields[$key]=(string)$selection['territory']['fields'][$key];
+                    $provenance[$key]=Arr::except($selection['territory'],['fields']);
+                } else unset($fields[$key],$provenance[$key]);
+            }
+            $fields['special_zone_id']=$selection['park']['id']??'';
+            $fields['investment_regime']=$selection['park']['fields']['investment_regime']??'general';
+        }
         $replaced = [];
         foreach (array_unique([...array_keys($old['fields']), ...array_keys($fields)]) as $key) {
             if (($old['fields'][$key] ?? null) !== ($fields[$key] ?? null)) {
                 $replaced[] = ['field' => $key, 'before' => $old['fields'][$key] ?? null, 'after' => $fields[$key] ?? null];
             }
         }
-        foreach (['opportunity', 'sector', 'territory', 'park'] as $slot) {
+        foreach (['portfolio', 'opportunity', 'sector', 'territory', 'park'] as $slot) {
             if (($old['selection'][$slot] ?? null) !== ($selection[$slot] ?? null)) {
                 $changed[] = $slot;
             }
         }
-        $dependencyChanged = $this->dependencyHash($old['selection']) !== $this->dependencyHash($selection);
+        $changedFields = array_column($replaced, 'field');
+        if ($complements !== ($old['complements'] ?? [])) $changed[] = 'complements';
+        $choicesChanged = $choices !== ($old['opportunity_choices'] ?? []);
+        $choiceInputsChanged = array_map(fn($c)=>Arr::except($c,['portfolio_origins']),$choices) !== array_map(fn($c)=>Arr::except($c,['portfolio_origins']),$old['opportunity_choices']??[]);
+        if ($choiceInputsChanged) $changed = array_values(array_unique([...$changed, 'opportunity', 'territory']));
+        elseif ($choicesChanged) $changed[] = 'portfolio_origins';
+        $conditionsChanged = (bool) array_intersect($changedFields, array_diff(self::FIELDS, ['project_title', 'project_summary']));
+        $dependencyChanged = $choiceInputsChanged || in_array('complements', $changed, true) || $this->dependencyHash($old['selection']) !== $this->dependencyHash($selection) || $conditionsChanged;
+        $privateConditionsChanged = (bool) array_intersect($changedFields, PrivateInvestmentPreparation::FIELDS);
+        $calculationInputsChanged = $choiceInputsChanged || $this->dependencyHash($old['selection']) !== $this->dependencyHash($selection) || (bool) array_intersect($changedFields, array_diff(self::FIELDS, ['project_title', 'project_summary', ...array_diff(PrivateInvestmentPreparation::FIELDS, ['total_investment', 'area_required', 'area_unit'])]));
         $payload = $this->desk->decode($case->payload);
         $results = $payload['investor_path']['results'] ?? [];
         $requests = DB::table('desk_requests')->where('case_id', $id)->orderBy('id')->get(['id', 'status', 'protocol', 'version'])->all();
         $steps = $dependencyChanged ? array_values(array_unique([...(array_intersect($changed, ['opportunity', 'sector']) ? ['S02', 'S03', 'S04', 'S08', 'S12', 'S13', 'S14', 'S15', 'S17'] : []), ...(array_intersect($changed, ['territory', 'park']) ? ['S08', 'S09', 'S10', 'S11', 'S17'] : [])])) : [];
-        $plan = ['case_id' => $id, 'version' => (int) $case->version, 'revision' => (int) $old['revision'], 'selection' => $selection, 'fields' => $fields, 'provenance' => $provenance,
-            'updated' => $replaced, 'maintained' => $kept, 'changed_dimensions' => $changed, 'dependent_results' => (int) $case->user_id === $actor->id && $dependencyChanged ? array_map(fn ($r) => ['id' => $r['id'], 'engine' => $r['engine']], $results) : [],
-            'requests' => $requests, 'review_steps' => $steps, 'dependency_changed' => $dependencyChanged, 'documents_preserved' => DB::table('desk_documents')->where('case_id', $id)->count(),
+        if (array_intersect($changedFields, array_diff(self::FIELDS, ['project_title', 'project_summary', ...PrivateInvestmentPreparation::FIELDS]))) {
+            $steps = array_values(array_unique([...$steps, 'S02', 'S03', 'S08', 'S12', 'S13', 'S17']));
+        }
+        if ($privateConditionsChanged) {
+            $steps = array_values(array_unique([...$steps, 'S02', 'S05', 'S06', 'S07']));
+        }
+        if (in_array('complements', $changed, true)) $steps = array_values(array_unique([...$steps, 'S02', 'S08']));
+        $privatePreparation = null;
+        if (app(PrivateInvestmentPreparation::class)->available()) {
+            $docs = $this->preparationDocuments($id);
+            $beforePreparation = app(PrivateInvestmentPreparation::class)->assess($old, $docs);
+            $afterPreparation = app(PrivateInvestmentPreparation::class)->assess(['fields' => $fields, 'selection' => $selection, 'preparation_documents' => $links], $docs);
+            $privatePreparation = ['before' => $beforePreparation, 'after' => $afterPreparation];
+        }
+        $plan = ['complements' => $complements, 'opportunity_choices' => $choices, 'case_id' => $id, 'version' => (int) $case->version, 'revision' => (int) $old['revision'], 'selection' => $selection, 'fields' => $fields, 'provenance' => $provenance,
+            'preparation_documents' => $links, 'private_investment' => $privatePreparation,
+            'updated' => $replaced, 'maintained' => $kept, 'changed_dimensions' => $changed, 'dependent_results' => (int) $case->user_id === $actor->id && $calculationInputsChanged ? array_map(fn ($r) => ['id' => $r['id'], 'engine' => $r['engine']], $results) : [],
+            'requests' => $requests, 'review_steps' => $steps, 'dependency_changed' => $dependencyChanged, 'calculation_inputs_changed' => $calculationInputsChanged, 'documents_preserved' => DB::table('desk_documents')->where('case_id', $id)->count(),
             'notice' => 'Não confirma incentivos, licenças, disponibilidade de terra, reserva ou autorização. Submissões e decisões anteriores mantêm o conteúdo enviado.'];
+        $plan['requirements_assessment'] = app(InvestmentContextRequirements::class)->assess(['opportunity_choices' => $choices, 'fields' => $fields]);
         $hash = hash_hmac('sha256', json_encode(Arr::sortRecursive([$actor->id, $data, $plan]), JSON_THROW_ON_ERROR), config('app.key'));
 
         return [...$plan, 'preview_hash' => $hash];
@@ -349,7 +562,7 @@ final class InvestorContext
             $before = $this->state($case);
             $plan = $this->preview($actor, $id, $input);
             abort_unless(hash_equals($plan['preview_hash'], $control['preview_hash']), 409, 'O dossier ou uma fonte mudou desde a prévia; compare novamente.');
-            if (! $plan['changed_dimensions'] && ! $plan['updated'] && empty($input['declarations']) && empty($input['replace_fields'])) {
+            if (! $plan['changed_dimensions'] && ! $plan['updated'] && empty($input['declarations']) && empty($input['replace_fields']) && empty($input['document_links'])) {
                 $result = ['case_id' => $id, 'version' => (int) $case->version, 'revision' => $before['revision'], 'changed' => false, 'replayed' => false];
                 DB::table('audit_events')->insert(['source_system' => self::SOURCE, 'entity_type' => 'desk_cases', 'entity_id' => $id, 'actor_user_id' => $actor->id, 'correlation_id' => $control['operation_key'], 'action' => 'context_unchanged', 'data_classification' => 'restricted', 'after_data' => json_encode(['case_id' => $id, 'request_hash' => $requestHash, 'result' => $result], JSON_THROW_ON_ERROR)]);
 
@@ -361,14 +574,17 @@ final class InvestorContext
             foreach ($plan['review_steps'] as $step) {
                 $review[$step] = ['revision' => $revision, 'reason' => 'O contexto mudou; reveja os pressupostos e a evidência aplicável.'];
             }
-            $context = ['revision' => $revision, 'selection' => $plan['selection'], 'fields' => $plan['fields'], 'provenance' => $plan['provenance'], 'review_steps' => $review,
-                'dependency_hash' => $this->dependencyHash($plan['selection']), 'updated_at' => now()->toIso8601String(), 'updated_by' => $actor->id];
-            if ($plan['dependency_changed']) {
+            $context = ['opportunity_choices' => $plan['opportunity_choices'], 'preparation_documents' => $plan['preparation_documents'], 'preparation_snapshot' => $plan['private_investment']['after'] ?? $before['preparation_snapshot'] ?? null, 'revision' => $revision, 'selection' => $plan['selection'], 'fields' => $plan['fields'], 'provenance' => $plan['provenance'], 'review_steps' => $review,
+                'dependency_hash' => $this->dependencyHash([...($plan['opportunity_choices'] !== [] ? ['opportunity_choices' => $plan['opportunity_choices']] : []), ...($plan['complements'] ? ['complements' => $plan['complements']] : []), 'selection' => $plan['selection'], 'fields' => Arr::except($plan['fields'], ['project_title', 'project_summary'])]), 'updated_at' => now()->toIso8601String(), 'updated_by' => $actor->id];
+            $context['requirements_assessment'] = $plan['requirements_assessment'];
+            $context['complements'] = $plan['complements'];
+            if ($plan['calculation_inputs_changed']) {
                 foreach ($payload['investor_path']['results'] ?? [] as $i => $r) {
                     $payload['investor_path']['results'][$i] = [...$r, 'context_state' => 'review_required', 'context_invalidated_revision' => $revision, 'context_invalidated_at' => now()->toIso8601String()];
                 }
             }
             $payload['investor_path']['context'] = $context;
+            unset($payload['investor_path']['context_drafts'][(string)$actor->id]);
             DB::table('desk_cases')->where('id', $id)->update(['payload' => $this->desk->encode($payload), 'title' => $context['fields']['project_title'] ?? $case->title, 'version' => $case->version + 1, 'updated_at' => now()]);
             $this->desk->event($this->desk->case($actor, $id), $actor, 'investment_context_changed', ['before' => $before, 'after' => $context, 'affected_result_ids' => array_column($plan['dependent_results'], 'id'), 'preserved_request_ids' => array_column($plan['requests'], 'id')]);
             $result = ['case_id' => $id, 'version' => (int) $case->version + 1, 'revision' => $revision, 'replayed' => false];
@@ -378,12 +594,15 @@ final class InvestorContext
         }, 3);
     }
 
-    public function view(User $actor, string $id): array
+    public function view(User $actor, string $id, ?string $opportunity = null): array
     {
         $case = $this->desk->case($actor, $id);
         abort_unless($this->desk->owns($actor, $case, false) || $actor->can('manage-portal'), 403);
         $ctx = $this->state($case);
-        $path = app(InvestorPath::class)->view($actor, $id);
+        $ctx['land_preparation'] = $this->landPreparation($case, $opportunity);
+        $path = app(InvestorPath::class)->view($actor, $id, $opportunity);
+        $ctx['path_applicability'] = ['definition_id' => $path['definition_id'], 'definition_version' => $path['definition_version'], 'source_sha256' => $path['source_sha256'],
+            'steps' => array_values(array_map(fn ($step) => Arr::only($step, ['code', 'title', 'applicability', 'reason', 'state', 'context_review_required']), array_filter($path['steps'], fn ($step) => ! empty($step['branch']))))];
 
         $simulatorRevision = null;
         if ((int) $case->user_id === $actor->id && $case->simulation_id) {
@@ -396,18 +615,79 @@ final class InvestorContext
             }
         }
 
-        return ['simulator_context_revision' => $simulatorRevision, 'case' => $path['case'], 'context' => $ctx, 'steps' => array_map(fn ($s) => Arr::only($s, ['code', 'title', 'state', 'context_review_required']), $path['steps']),
+        $preparation = app(PrivateInvestmentPreparation::class)->available() ? app(PrivateInvestmentPreparation::class)->assess(app(InvestmentConsumerScope::class)->context($ctx, $opportunity), $this->preparationDocuments($id)) : null;
+        $ctx['preparation_assessment'] = $preparation;
+
+        $prefill = $this->prefill($ctx, $opportunity);
+        $saved = $this->desk->decode($case->payload);
+        if (!empty($saved['reuse_consent'])) {
+            $contacts = array_filter(['email' => $saved['email'] ?? null, 'phone' => $saved['profile']['phone'] ?? null], fn($v) => is_string($v) && $v !== '');
+            $prefill['simulator'] = [...$contacts, ...$prefill['simulator']];
+            $prefill['land'] = [...$contacts, ...(!empty($saved['name']) ? ['full_name' => $saved['name']] : []), ...$prefill['land']];
+        }
+        return ['private_investment' => $preparation, 'preparation_documents' => $this->preparationDocuments($id), 'simulator_context_revision' => $simulatorRevision, 'case' => $path['case'], 'context' => $ctx, 'steps' => array_map(fn ($s) => Arr::only($s, ['code', 'title', 'state', 'context_review_required']), $path['steps']),
             'can_write' => $path['canWrite'], 'next' => $path['next'], 'results' => $path['results'], 'requests' => $path['requests'],
-            'prefill' => $this->prefill($ctx), 'notice' => 'A seleção apoia a preparação e não confirma benefícios, licenças, direitos ou disponibilidade.'];
+            'prefill' => $prefill, 'notice' => 'A seleção apoia a preparação e não confirma benefícios, licenças, direitos ou disponibilidade.'];
     }
 
-    public function prefill(array $ctx): array
+    public function preparationDocuments(string $id): array
     {
-        $f = $ctx['fields'];
-        $sim = Arr::only($f, ['project_title', 'project_summary', 'sector_id', 'province_id', 'district_id', 'admin_post_id', 'locality_id']);
+        return DB::table('desk_documents as l')->join('documents as d', 'd.id', '=', 'l.document_id')->where('l.case_id', $id)->whereNull('d.deleted_at')->get(['l.id', 'l.document_id', 'd.file_name', 'd.status', 'd.malware_scan_status', 'd.version_no', 'd.sha256'])->map(fn ($row) => (array) $row)->all();
+    }
 
+    public function landPreparation(\stdClass $case, ?string $opportunity = null): array
+    {
+        $payload = $this->desk->decode($case->payload);
+        $ctx = $this->state($case);
+        $key = app(InvestmentConsumerScope::class)->key($ctx, $opportunity);
+        $path = $payload['investor_path'] ?? [];
+        $need = app(InvestmentConsumerScope::class)->facts($payload, $ctx, $key)['land_needed'];
+
+        return ['need' => in_array($need, ['yes', 'no'], true) ? $need : 'unknown', 'reason' => $key ? ($path['opportunity_fact_reasons'][$key]['land_needed'] ?? '') : ($path['fact_reasons']['land_needed'] ?? '')];
+    }
+
+    public function prefill(array $ctx, ?string $opportunity = null): array
+    {
+        $original = $ctx;
+        $ctx = app(InvestmentConsumerScope::class)->context($ctx, $opportunity);
+        $f = $ctx['fields'];
+        $sim = Arr::except(Arr::only($f, self::FIELDS), ['sector', 'province', 'district', 'location', ...array_diff(PrivateInvestmentPreparation::FIELDS, ['total_investment', 'area_required', 'area_unit'])]);
+        // Entering this tool from an investment dossier selects the existing investment-analysis route.
+        // The reconciliation preserves any purpose deliberately chosen in an existing simulator draft.
+        $sim += ['journey_type' => 'investor', 'journey_type_label' => 'Avaliar o meu investimento', 'purpose' => 'simulate_only', 'purpose_label' => 'Apenas simular'];
+        if (($ctx['land_preparation']['need'] ?? null) === 'yes') {
+            $tenure = ['duat' => ['duat', 'DUAT'], 'lease' => ['leased', 'Arrendado']][$f['site_tenure'] ?? ''] ?? null;
+            if ($tenure) [$sim['land_status'], $sim['land_status_label']] = $tenure;
+        }
+        // Human labels travel with the exact existing identifiers, not inferred locations.
+        foreach (app(InvestmentGeography::class)->publicReferences()->whereIn('id', array_values(Arr::only($f, array_keys(InvestmentGeography::FIELDS))))->get(['id', 'name']) as $place) {
+            foreach (array_keys(InvestmentGeography::FIELDS) as $key) {
+                if (($f[$key] ?? null) === $place->id) $sim[$key.'_label'] = $place->name;
+            }
+        }
+        if (! empty($f['sector_id']) && ($sector = Sector::where('is_active', true)->find($f['sector_id']))) $sim['sector_id_label'] = $sector->name;
+        $zone = $ctx['selection']['park'] ?? null;
+        $sim['context_applicability_snapshot'] = json_encode([
+            'version' => 1, 'context_revision' => $ctx['revision'],
+            'consumer_opportunity' => $ctx['consumer_opportunity']['opportunity']['key'] ?? null,
+            'portfolio_origin' => $ctx['selection']['portfolio'] ?? null,
+            'zone' => $zone ? Arr::only($zone, ['id', 'title', 'href', 'version', 'sha256', 'fields', 'analysis']) : null,
+            'provenance' => $ctx['provenance'],
+            'opportunity_choices' => $ctx['opportunity_choices'] ?? [],
+            'complements' => $ctx['complements'] ?? [],
+            'requirements_assessment' => $ctx['requirements_assessment'] ?? null,
+            'path' => $ctx['path_applicability'] ?? null,
+            'land_preparation' => $ctx['land_preparation'] ?? null,
+            'field_provenance' => array_map(fn($origin) => Arr::only($origin, ['kind', 'title', 'version', 'context_revision']), $ctx['provenance'] ?? []),
+            'preparation' => isset($ctx['preparation_assessment']) ? Arr::except($ctx['preparation_assessment'], ['questions']) : null,
+            'fields' => Arr::only($f, ['investor_origin', 'tax_residency_country', 'entity_stage', 'currency', 'expected_start_date', 'investment_regime']),
+            'notice' => 'Referências e declarações para preparação; sem reconhecimento automático de elegibilidade ou benefício.',
+        ], JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
+
+        $scoped = app(InvestmentConsumerScope::class)->context($original, $opportunity);
+        $f = $scoped['fields'];
         return ['simulator' => $sim, 'land' => array_filter(['project_reference' => $f['project_title'] ?? null, 'activity' => $f['sector'] ?? null, 'purpose' => $f['project_summary'] ?? null, 'parcels' => [Arr::only($f, array_keys(InvestmentGeography::FIELDS))]], fn ($v) => $v !== null),
             'desk' => array_filter(['title' => $f['project_title'] ?? null, 'territory_id' => $f['locality_id'] ?? $f['admin_post_id'] ?? $f['district_id'] ?? $f['province_id'] ?? null, 'location_source' => isset($f['province_id']) ? 'Referência consultada no contexto v'.($ctx['revision'] ?? 0).': '.($f['location'] ?? 'território identificado').'. Não confirma disponibilidade.' : null, 'description' => $f['project_summary'] ?? null, 'sector' => $f['sector'] ?? null, ...Arr::only($f, array_keys(InvestmentGeography::FIELDS))], fn ($v) => $v !== null),
-            'submission' => array_filter(['sector' => $f['sector'] ?? null, 'objective' => $f['project_summary'] ?? null, 'location' => $f['location'] ?? null], fn ($v) => $v !== null)];
+            'submission' => array_filter(['currency' => $f['currency'] ?? null, 'sector' => $f['sector'] ?? null, 'objective' => $f['project_summary'] ?? null, 'location' => $f['location'] ?? null], fn ($v) => $v !== null)];
     }
 }

app/Services/InvestorPath.php

@@ -68,7 +68,7 @@ final class InvestorPath
     }
 
     /** @return array<string,mixed> */
-    public function view(User $actor, string $id): array
+    public function view(User $actor, string $id, ?string $opportunity = null): array
     {
         abort_unless($this->available(), 404);
         $case = $this->desk->case($actor, $id);
@@ -79,18 +79,26 @@ final class InvestorPath
         $payload = $this->desk->decode($case->payload);
         $path = $payload['investor_path'] ?? [];
         $context = app(InvestorContext::class)->state($case);
-        $facts = $path['facts'] ?? ['land_needed' => 'unknown', 'external_funding' => 'unknown', 'viability' => 'unknown'];
+        $scope = app(InvestmentConsumerScope::class);
+        $opportunity = $scope->key($context, $opportunity);
+        $allChoices = $context['opportunity_choices'] ?? [];
+        $facts = $scope->facts($payload, $context, $opportunity);
+        $factReasons = $opportunity ? ($path['opportunity_fact_reasons'][$opportunity] ?? []) : ($path['fact_reasons'] ?? []);
+        $context = $scope->context($context, $opportunity);
         $records = DB::table('journey_steps')->where('journey_id', $journey->id)->whereNull('deleted_at')->get()->keyBy('step_code');
         $steps = [];
         foreach ($definition['steps'] as $step) {
             $row = $records->get($step['code']);
             abort_unless($row !== null, 409, 'Etapa em falta; reparar a instalação sem reconstruir o histórico.');
             $detail = $this->desk->decode($row->path_detail);
+            if ($opportunity && (count($allChoices) > 1 || isset($detail['opportunities'][$opportunity]))) {
+                $detail = $detail['opportunities'][$opportunity] ?? ['state' => 'not_started'];
+            }
             $value = $step['branch'] ? ($facts[$step['branch']] ?? 'unknown') : 'yes';
             $applicable = $value === 'unknown' ? 'undetermined' : ($value === 'no' ? 'not_needed_for_preparation' : 'applicable');
             $state = $value === 'no' ? 'dispensed' : $detail['state'];
             $steps[] = [...$step, 'id' => $row->id, 'version' => $row->version_no, 'state' => $state, 'saved_state' => $detail['state'],
-                'applicability' => $applicable, 'reason' => $value === 'no' ? ($path['fact_reasons'][$step['branch']] ?? '') : ($detail['reason'] ?? ''),
+                'applicability' => $applicable, 'reason' => $value === 'no' ? ($factReasons[$step['branch']] ?? '') : ($detail['reason'] ?? ''),
                 'detail' => $detail, 'preparation_allowed' => $value !== 'no',
                 'action_gaps' => []];
         }
@@ -136,22 +144,29 @@ final class InvestorPath
         $documents = DB::table('desk_documents as l')->join('documents as d', 'd.id', '=', 'l.document_id')
             ->where('l.case_id', $id)->whereNull('d.deleted_at')
             ->when(! $owner && ! $manager, fn ($q) => $q->where(fn ($p) => $p->whereNull('l.request_id')->orWhereIn('l.request_id', $requests->pluck('id'))))
-            ->get(['l.id', 'l.document_id', 'd.file_name', 'd.status', 'd.malware_scan_status']);
+            ->get(['l.id', 'l.document_id', 'd.file_name', 'd.status', 'd.malware_scan_status', 'd.version_no', 'd.sha256']);
         // Only the private draft owner can receive the financial snapshot/result. Dossier access alone is insufficient.
         $results = (int) $case->user_id === $actor->id ? ($path['results'] ?? []) : [];
         $next = collect($steps)->first(fn ($step) => $step['preparation_allowed'] && ! in_array($step['state'], ['completed', 'approved', 'waiting_external', 'submitted', 'reviewing'], true));
 
         $landCase = (int) $case->user_id === $actor->id
             ? LandAssistanceCase::where('user_id', $actor->id)->latest('updated_at')->get()
-                ->first(fn ($land) => ($land->payload['investor_path_case_id'] ?? null) === $id) : null;
+                ->first(fn ($land) => ($land->payload['investor_path_case_id'] ?? null) === $id
+                    && (!$allChoices || ($opportunity && ($land->payload['context_opportunity'] ?? null) === $opportunity))) : null;
 
-        return ['case' => ['id' => $id, 'title' => $case->title, 'version' => $case->version, 'closed' => $case->closed_at !== null],
+        $preparation = ($owner || $manager) && app(PrivateInvestmentPreparation::class)->available() ? app(PrivateInvestmentPreparation::class)->assess($context, $documents->map(fn ($d) => (array) $d)->all()) : null;
+        if ($preparation && $preparation['enabled']) {
+            $next = ['code' => 'S06', 'title' => $preparation['next'], 'action' => 'Preparar', 'href' => '/investimentos/'.$id.'/contexto/editar#preparation-questions'];
+        }
+
+        return ['private_investment' => $preparation, 'case' => ['id' => $id, 'title' => $case->title, 'version' => $case->version, 'closed' => $case->closed_at !== null],
             'journey_id' => $journey->id, 'definition_id' => $version->id, 'definition_version' => $version->version_no, 'source_sha256' => $definition['source_sha256'],
-            'phases' => $definition['phases'], 'steps' => $steps, 'facts' => $facts, 'fact_reasons' => $path['fact_reasons'] ?? [],
+            'phases' => $definition['phases'], 'steps' => $steps, 'facts' => $facts, 'fact_reasons' => $factReasons,
+            'context_opportunity' => $opportunity, 'opportunity_options' => $allChoices,
             'fintech' => ($owner || $manager) && (isset($path['fintech']) || collect($path['sector_contexts'] ?? [])->contains(fn ($s) => in_array($s['slug'], ['fintech', 'tecnologias-de-informacao', 'mercado-financeiro'], true)) || collect($path['content_sources'] ?? [])->contains('return_href', '/tech-fintech')) ? app(FintechInvestment::class)->view($payload, $steps) : null,
             'canWrite' => $owner && ! $case->closed_at, 'canReview' => $manager && (int) $case->user_id !== $actor->id && ! $case->closed_at,
-            'next' => $next ? ['code' => $next['code'], 'title' => $next['title'], 'action' => 'Preparar', 'href' => '#'.$next['code']] : null,
-            'investment_context' => ($owner || $manager) ? $context : null,
+            'next' => $next ? ['code' => $next['code'], 'title' => $next['title'], 'action' => 'Preparar', 'href' => $next['href'] ?? '#'.$next['code']] : null,
+            'investment_context' => ($owner || $manager) ? [...$context, 'opportunity_choices' => $opportunity ? $context['opportunity_choices'] : $allChoices] : null,
             'results' => $results, 'requests' => $requests, 'documents' => $documents,
             'zone_contexts' => ($owner || $manager) ? ($path['zone_contexts'] ?? []) : [],
             'sector_contexts' => ($owner || $manager) ? ($path['sector_contexts'] ?? []) : [],
@@ -162,25 +177,31 @@ final class InvestorPath
                 ->get(['id', 'title', 'status', 'version_no', 'due_at', 'assignee_user_id']),
             'services' => DB::table('desk_service_versions')->where('status', 'published')->orderByDesc('version')->get(['id', 'code', 'definition'])
                 ->unique('code')->values()->map(fn ($s) => ['id' => $s->id, 'title' => json_decode($s->definition, true)['title']]),
-            'tools' => ['simulator' => (int) $case->user_id === $actor->id ? '/simulador-fiscal?context='.$id.($case->simulation_id ? '&draft='.$case->simulation_id : '') : null,
-                'desk' => '/balcao-virtual/dossiers/'.$id, 'guidance' => '/balcao-virtual/dossiers/'.$id.'/orientacao',
+            'tools' => ['simulator' => (int) $case->user_id === $actor->id ? '/simulador-fiscal?context='.$id.($case->simulation_id ? '&draft='.$case->simulation_id : '').($opportunity ? '&opportunity='.urlencode($opportunity) : '') : null,
+                'desk' => '/balcao-virtual/dossiers/'.$id.($opportunity ? '?opportunity='.urlencode($opportunity) : ''), 'guidance' => '/balcao-virtual/dossiers/'.$id.'/orientacao',
                 'library' => '/documentos?context='.$id, 'opportunities' => '/oportunidades?context='.$id, 'territory' => '/zonas?context='.$id, 'partners' => '/parcerias/painel?context='.$id,
-                'land' => (int) $case->user_id === $actor->id ? ($landCase ? '/investidor/terra-duat/'.$landCase->id : '/investidor/terra-duat/novo?context='.$id) : null]];
+                'land' => ($facts['land_needed'] ?? 'unknown') !== 'no' && (int) $case->user_id === $actor->id ? ($landCase ? '/investidor/terra-duat/'.$landCase->id : '/investidor/terra-duat/novo?context='.$id.($opportunity ? '&opportunity='.urlencode($opportunity) : '')) : null]];
     }
 
     /** @param array<string,mixed> $input */
     public function facts(User $actor, string $id, array $input): void
     {
-        $data = Validator::make($input, ['version' => 'required|integer|min:1',
+        $data = Validator::make($input, ['version' => 'required|integer|min:1', 'context_opportunity' => 'nullable|string|max:100',
             'land_needed' => ['required', Rule::in(['yes', 'no', 'unknown'])], 'external_funding' => ['required', Rule::in(['yes', 'no', 'unknown'])],
             'viability' => ['required', Rule::in(['unknown', 'proceed', 'reformulate', 'archive'])],
             'reason' => 'required|string|min:3|max:3000'])->validate();
         DB::transaction(function () use ($actor, $id, $data): void {
             $case = $this->writable($actor, $id, $data['version']);
             $payload = $this->desk->decode($case->payload);
+            $choice = app(InvestmentConsumerScope::class)->key(app(InvestorContext::class)->state($case), $data['context_opportunity'] ?? null, true);
             foreach (['land_needed', 'external_funding', 'viability'] as $key) {
-                $payload['investor_path']['facts'][$key] = $data[$key];
-                $payload['investor_path']['fact_reasons'][$key] = $data['reason'];
+                if ($choice) {
+                    $payload['investor_path']['opportunity_facts'][$choice][$key] = $data[$key];
+                    $payload['investor_path']['opportunity_fact_reasons'][$choice][$key] = $data['reason'];
+                } else {
+                    $payload['investor_path']['facts'][$key] = $data[$key];
+                    $payload['investor_path']['fact_reasons'][$key] = $data['reason'];
+                }
             }
             $this->savePayload($case, $payload);
             $this->desk->event($this->desk->case($actor, $id), $actor, 'path_applicability_declared', $data);
@@ -190,7 +211,7 @@ final class InvestorPath
     /** @param array<string,mixed> $input */
     public function stage(User $actor, string $id, string $code, array $input): void
     {
-        $data = Validator::make($input, ['version' => 'required|integer|min:1', 'state' => ['required', Rule::in(array_diff(InvestorPathDefinition::STATES, ['dispensed']))],
+        $data = Validator::make($input, ['version' => 'required|integer|min:1', 'context_opportunity' => 'nullable|string|max:100', 'state' => ['required', Rule::in(array_diff(InvestorPathDefinition::STATES, ['dispensed']))],
             'reason' => 'required|string|min:3|max:3000', 'action' => ['required', Rule::in(['prepare', 'submit', 'execute', 'operate', 'review', 'record_external'])],
             'document_id' => 'nullable|uuid', 'authority' => 'nullable|string|max:200', 'reference' => 'nullable|string|max:300',
             'context_revision' => 'nullable|integer|min:0', 'context_reviewed' => 'nullable|boolean', 'decision_date' => 'nullable|date_format:Y-m-d|before_or_equal:today'])->validate();
@@ -198,7 +219,8 @@ final class InvestorPath
             $case = $this->desk->case($actor, $id, false, true);
             abort_if($case->closed_at, 409);
             abort_unless((int) $case->version === $data['version'], 409, 'O dossier mudou; recupere a versão actual.');
-            $view = $this->view($actor, $id);
+            $key = app(InvestmentConsumerScope::class)->key(app(InvestorContext::class)->state($case), $data['context_opportunity'] ?? null, true);
+            $view = $this->view($actor, $id, $key);
             $step = $this->findStep($view, $code);
             abort_unless($step !== null && $step['preparation_allowed'], 422, 'Etapa dispensada de preparação; altere os pressupostos com fundamento.');
             $state = $data['state'];
@@ -233,7 +255,10 @@ final class InvestorPath
             }
             abort_if($state === 'completed' && ($step['context_review_required'] ?? false) && (! (bool) ($data['context_reviewed'] ?? false) || ($data['context_revision'] ?? -1) !== ($view['investment_context']['revision'] ?? 0)), 422, 'O contexto desta etapa exige nova conferência fundamentada; o registo anterior permanece no histórico.');
             $detail = [...$data, 'context_dependency_hash' => $view['investment_context']['dependency_hash'] ?? null, 'fintech_fingerprint' => $view['fintech']['review_fingerprints'][$code] ?? null, 'scope' => $scope, 'actor_id' => $actor->id, 'recorded_at' => now()->toIso8601String()];
-            DB::table('journey_steps')->where('id', $step['id'])->update(['path_detail' => $this->desk->encode($detail),
+            $stored = $this->desk->decode(DB::table('journey_steps')->where('id', $step['id'])->value('path_detail'));
+            if ($key) $stored['opportunities'][$key] = $detail;
+            else $stored = [...$stored, ...$detail];
+            DB::table('journey_steps')->where('id', $step['id'])->update(['path_detail' => $this->desk->encode($stored),
                 'status' => in_array($state, ['completed', 'approved'], true) ? 'completed' : ($state === 'not_started' ? 'pending' : 'active'),
                 'version_no' => $step['version'] + 1, 'updated_at' => now()]);
             DB::table('desk_cases')->where('id', $id)->update(['version' => $case->version + 1, 'updated_at' => now()]);
@@ -262,11 +287,12 @@ final class InvestorPath
             abort_unless(is_array($parsed) && ($parsed['version'] ?? null) === 1 && is_array($parsed['data'] ?? null), 422, 'Snapshot financeiro incompatível.');
             $payload = $this->desk->decode($case->payload);
             $context = app(InvestorContext::class)->state($case);
+            $opportunity = app(InvestmentConsumerScope::class)->key($context, $economic['context_opportunity'] ?? null, true);
             if ($context['revision'] > 0) {
                 abort_unless(($data['context_revision'] ?? -1) === $context['revision'], 409, 'O contexto mudou; recupere e confira os pressupostos antes de devolver o resultado.');
                 abort_unless($data['context_reviewed'] ?? false, 422, 'Confirme a revisão dos pressupostos financeiros para este contexto.');
             }
-            $resultKey = hash('sha256', $draft->id.':'.$draft->version_no.':'.$snapshot.':context:'.$context['revision']);
+            $resultKey = hash('sha256', $draft->id.':'.$draft->version_no.':'.$snapshot.':context:'.$context['revision'].($opportunity ? ':'.$opportunity : ''));
             foreach ($payload['investor_path']['results'] ?? [] as $result) {
                 if ($result['source_key'] === $resultKey) {
                     return $result;
@@ -275,6 +301,7 @@ final class InvestorPath
             abort_unless((int) $case->version === $data['version'], 409, 'Recupere a versão actual do dossier.');
             $result = ['id' => (string) Str::uuid(), 'source_key' => $resultKey, 'draft_id' => $draft->id, 'draft_version' => $draft->version_no,
                 'snapshot_sha256' => $draft->snapshot_sha256, 'financial_snapshot' => $snapshot,
+                'context_opportunity' => $opportunity,
                 'currency' => $economic['currency'] ?? null, 'engine' => 'financial-calculators:v1',
                 'kind' => 'local_calculation_inputs', 'context_state' => 'current', 'context_revision' => $context['revision'], 'context_dependency_hash' => $context['dependency_hash'] ?? app(InvestorContext::class)->dependencyHash([]), 'recorded_at' => now()->toIso8601String()];
             $payload['investor_path']['results'][] = $result;

app/Services/LegacyContent.php

@@ -35,7 +35,7 @@ final class LegacyContent
     }
 
     /** @return array<string, mixed> */
-    public function article(string $slug = 'agronegocio'): array
+    public function article(string $slug = 'agronegocio', bool $includeRelated = true): array
     {
         abort_unless($this->available(), 404);
         $identity = config('legacy_content.articles.'.$slug);
@@ -78,15 +78,31 @@ final class LegacyContent
                 $image = $this->publicResources()->where('r.id', $adaptation['image_resource_id'])->whereIn('d.media_type', ['image/png', 'image/jpeg', 'image/webp'])->first();
             }
         }
+        if ($slug === 'agronegocio') {
+            $localHtml = app(CorridorAgribusiness::class)->enrich($localHtml, app(CorridorAgribusinessOpportunities::class)->articleLinks());
+        }
         preg_match_all('~href="([^"]+)"~i', $localHtml, $existingLinks);
         $alreadyLinked = array_map(fn ($href) => html_entity_decode($href, ENT_QUOTES | ENT_HTML5, 'UTF-8'), $existingLinks[1]);
-        $relatedArticles = array_values(array_filter($this->related($identity['group'], $slug), fn ($item) => !in_array($item['href'], $alreadyLinked, true)));
+        $relatedArticles = [];
+        if ($includeRelated) {
+            foreach ($this->related($identity['group'], $slug) as $item) {
+                if (in_array($item['href'], $alreadyLinked, true)) continue;
+                try {
+                    $relatedArticles[] = $this->article($item['slug'], false);
+                } catch (\Symfony\Component\HttpKernel\Exception\HttpException $error) {
+                    if ($error->getStatusCode() !== 404) throw $error;
+                }
+            }
+        }
 
         return ['id' => (int) $row->resource_id, 'document_id' => $row->id, 'version' => (int) $row->metadata_version,
             'sha256' => trim($row->sha256), 'title' => $source['title'], 'author' => $source['author'],
             'legacy_id' => $source['legacy_id'], 'legacy_category' => $source['legacy_category'],
             'published_at' => $source['published_at'], 'modified_at' => $source['modified_at'], 'source_url' => $source['source_url'],
-            'href' => '/'.$slug, 'html' => $localHtml,
+            'href' => '/'.$slug, 'html' => $localHtml, 'summary' => self::excerpt($localHtml),
+            'opportunities_href' => $sector ? '/oportunidades?sector='.rawurlencode($sector->slug) : null,
+            'opportunities_label' => $sector ? 'Ver oportunidades de '.$sector->name : null,
+            'has_opportunities' => count($opportunities) > 0,
             'landing_href' => '/explorar/'.$identity['group'], 'start_href' => '/investimentos/a-partir-de/'.$slug,
             'group' => config('legacy_content.groups.'.$identity['group']),
             'related_articles' => $relatedArticles,
@@ -101,6 +117,22 @@ final class LegacyContent
             'consultation_state' => 'public', 'legal_state' => 'not_applicable', 'calculation_use' => false];
     }
 
+    /** An excerpt of the displayed edition, never a claim about returns or availability. */
+    public static function excerpt(string $html): string
+    {
+        $plain = html_entity_decode(strip_tags($html), ENT_QUOTES | ENT_HTML5, 'UTF-8');
+        if (str_contains($plain, 'Hotelaria e resorts') && str_contains($plain, 'Ecoturismo')
+            && str_contains($plain, 'Infraestruturas turísticas') && str_contains($plain, 'Oportunidades Regionais')) {
+            return 'Conheça os temas de turismo e hospitalidade abordados no guia: hotelaria, ecoturismo, infraestruturas de apoio e referências regionais. Use este enquadramento para preparar a sua ideia de investimento.';
+        }
+        preg_match_all('~<p\b[^>]*>(.*?)</p>~isu', $html, $paragraphs);
+        foreach ([...($paragraphs[1] ?? []), $html] as $paragraph) {
+            $text = trim(preg_replace('/\s+/u', ' ', html_entity_decode(strip_tags($paragraph), ENT_QUOTES | ENT_HTML5, 'UTF-8')));
+            if (mb_strlen($text) >= 60) return \Illuminate\Support\Str::limit($text, 320);
+        }
+        return trim(html_entity_decode(strip_tags($html), ENT_QUOTES | ENT_HTML5, 'UTF-8'));
+    }
+
     /** Resolve a library identity, preserving the already stored source URLs and versions. */
     /** @return array<string, mixed> */
     public function articleForResource(int $resourceId): array
@@ -250,7 +282,7 @@ final class LegacyContent
     }
 
     /** Allow presentation markup only. No scripts, styles, events, embeds or remote image execution. */
-    public function sanitize(string $html): string
+    public function sanitize(string $html, bool $preserveStructure = false): string
     {
         $doc = new DOMDocument;
         $old = libxml_use_internal_errors(true);
@@ -267,7 +299,7 @@ final class LegacyContent
             }
             $headingOffset = 2 - (empty($sourceLevels) ? 2 : min($sourceLevels));
             $previousHeading = 1;
-            $clean = function (DOMNode $node) use (&$clean, $doc, $headingOffset, &$previousHeading): void {
+            $clean = function (DOMNode $node) use (&$clean, $doc, $headingOffset, &$previousHeading, $preserveStructure): void {
                 foreach (iterator_to_array($node->childNodes) as $child) {
                     if (! $child instanceof DOMElement) {
                         continue;
@@ -282,7 +314,7 @@ final class LegacyContent
                         $node->replaceChild($section, $child);
                         $child = $section;
                     }
-                    if (! in_array(strtolower($child->tagName), ['p', 'strong', 'b', 'em', 'i', 'ul', 'ol', 'li', 'br', 'h2', 'h3', 'h4', 'h5', 'h6', 'blockquote', 'a'], true)) {
+                    if (! in_array(strtolower($child->tagName), array_merge(['p', 'strong', 'b', 'em', 'i', 'ul', 'ol', 'li', 'br', 'h2', 'h3', 'h4', 'h5', 'h6', 'blockquote', 'a'], $preserveStructure ? ['div', 'span', 'small', 'section', 'table', 'caption', 'thead', 'tbody', 'tfoot', 'tr', 'th', 'td', 'figure', 'figcaption'] : []), true)) {
                         $node->removeChild($child);
 
                         continue;

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);
+    }
+}

app/Services/OpportunityManagement.php

@@ -27,6 +27,9 @@ class OpportunityManagement
     public function values(Opportunity $record): array
     {
         $base = $record->only(self::FIELDS);
+        if (data_get($record->workflow_context, 'publication.purpose') === OpportunityPromotion::PURPOSE) {
+            $base = [...$base, ...($record->workflow_context['promotional_private_base'] ?? [])];
+        }
         $draft = $record->management_draft ? json_decode($record->management_draft, true, 512, JSON_THROW_ON_ERROR) : [];
 
         return [...$base, ...($this->closed($record) ? $draft : array_intersect_key($draft, array_flip(self::PRIVATE_DRAFT_FIELDS)))];

app/Services/OpportunityPromotion.php

@@ -0,0 +1,168 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Opportunity;
+use App\Models\User;
+use Illuminate\Support\Facades\Crypt;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Validator;
+use Illuminate\Support\Str;
+use Illuminate\Validation\Rule;
+
+/** Tempo's promotional disclosure, independent of investment execution approval. */
+final class OpportunityPromotion
+{
+    public const PURPOSE = 'promotional_preparation';
+    public const NOTICE = 'Em preparação. A divulgação não confirma financiamento, disponibilidade de terreno, licenças ou autorização de execução do investimento.';
+
+    public function allowed(User $actor, Opportunity $record): bool
+    {
+        $access = app(PortalProfileAccess::class);
+        if ($record->trashed() || $record->owner_user_id === null || ! $access->canView($actor, $record)
+            || $access->has($actor, 'auditor') || in_array($record->status, ['archived', 'rejected'], true)) return false;
+        // Never overwrite a normal approved publication or its workflow decisions.
+        if ($record->published_at && data_get($record->workflow_context, 'publication.purpose') !== self::PURPOSE) return false;
+        $internal = $access->internalAssignment($actor, $record->opportunity_category);
+        return ($internal && $access->promoterRecordScope($actor, $record) && $access->operational($actor, 'edit', $record->id))
+            || ($access->scoped($actor, 'publisher', $record->organization_id, $record->opportunity_category)
+                && $access->operational($actor, 'publish', $record->id));
+    }
+
+    private function authorize(User $actor, Opportunity $record): void
+    {
+        abort_unless($this->allowed($actor, $record), 403, 'A designação e o âmbito existentes não autorizam esta divulgação.');
+        if (! app(PortalProfileAccess::class)->mfa($actor)) {
+            throw new \Illuminate\Http\Exceptions\HttpResponseException(response()->json(['message' => 'Confirme a entrada normal com MFA recente para divulgar.'], 403)->header('X-Portal-Reauthentication', 'required'));
+        }
+    }
+
+    public function editor(User $actor, Opportunity $record): array
+    {
+        abort_unless($this->allowed($actor, $record), 403);
+        $saved = data_get($record->workflow_context, 'promotional_summary', []);
+        // Only previously public text is recovered automatically. No private contact/document is copied.
+        $existing = data_get($record->workflow_context, 'publication.purpose') === self::PURPOSE;
+        $form = $saved['input'] ?? ['title' => $existing ? $record->title : '', 'summary' => $existing ? $record->summary : '',
+            'description' => $existing ? $record->description : '', 'source_reference' => '', 'edition' => '', 'source_date' => '',
+            'limitations' => '', 'territory_ids' => $existing ? DB::table('opportunity_locations')->where('opportunity_id', $record->id)->pluck('geo_location_id')->all() : [],
+            'sector_id' => $record->sector_id];
+        return ['record' => ['id' => $record->id, 'reference' => $record->reference], 'etag' => app(OpportunityManagement::class)->etag($record),
+            'initial' => $form, 'publicNow' => $existing && $record->status === 'published',
+            'reauthenticationRequired' => ! app(PortalProfileAccess::class)->mfa($actor),
+            'sectors' => \App\Models\Sector::catalog()->orderBy('name')->get(['id', 'name']),
+            'territories' => app(InvestmentGeography::class)->publicReferences()->orderBy('name')->get(['id', 'name', 'location_type']),
+            'history' => DB::table('audit_events')->where('source_system', 'tempo-preparation-publication')
+                ->where('after_data->record_id', $record->id)->orderByDesc('occurred_at')->get(['id', 'action', 'actor_user_id', 'occurred_at'])];
+    }
+
+    public function preview(User $actor, Opportunity $record, array $input): array
+    {
+        $this->authorize($actor, $record);
+        $data = Validator::make($input, ['etag' => 'required|string|size:64', 'action' => 'required|in:disclose,withdraw',
+            'title' => 'required_if:action,disclose|nullable|string|max:255', 'summary' => 'required_if:action,disclose|nullable|string|max:499',
+            'description' => 'nullable|string|max:6000', 'limitations' => 'nullable|string|max:2500',
+            'source_reference' => 'nullable|string|max:2000', 'edition' => 'nullable|string|max:150', 'source_date' => 'nullable|date_format:Y-m-d',
+            'sector_id' => ['nullable', 'integer', Rule::in(\App\Models\Sector::catalog()->pluck('id')->all())],
+            'territory_ids' => 'sometimes|array|max:30', 'territory_ids.*' => 'required|uuid|distinct',
+        ])->validate();
+        abort_unless(hash_equals(app(OpportunityManagement::class)->etag($record), $data['etag']), 409, 'A ficha mudou. Reabra antes de preparar outra prévia.');
+        if ($data['action'] === 'withdraw') abort_unless(data_get($record->workflow_context, 'publication.purpose') === self::PURPOSE, 409);
+        $paths = [];
+        foreach ($data['territory_ids'] ?? [] as $id) {
+            $path = app(InvestmentGeography::class)->path($id, true);
+            abort_unless(count($path) > 0 && collect($path)->contains('id', $id), 422, 'Seleccione apenas territórios públicos existentes.');
+            $paths[] = $path;
+        }
+        $text = fn ($key) => trim(strip_tags($data[$key] ?? ''));
+        $body = implode("\n\n", array_filter([$text('description'), self::NOTICE,
+            'Limitações e lacunas: '.($text('limitations') ?: 'Informação ainda por completar.'),
+            'Fonte: '.($text('source_reference') ?: 'Não indicada.'), 'Edição: '.($text('edition') ?: 'Não indicada.'),
+            'Data-base: '.($data['source_date'] ?? 'Não indicada.')]));
+        $body = OpportunityPublicText::description($record, $body);
+        $projection = ['title' => $text('title'), 'summary' => $text('summary'), 'description' => $body,
+            'sector_id' => $data['sector_id'] ?? null, 'maturity_label' => 'Em preparação', 'notice' => self::NOTICE,
+            'territories' => array_map(fn ($p) => ['id' => end($p)->id, 'label' => implode(' / ', array_column($p, 'name'))], $paths)];
+        if ($data['action'] === 'disclose') abort_unless($projection['title'] !== '' && $projection['summary'] !== '', 422, 'Indique título e resumo em texto simples.');
+        if ($data['action'] === 'withdraw') $projection = [...$projection, ...$record->only(['title', 'summary', 'description', 'sector_id', 'maturity_label'])];
+        $payload = ['actor_id' => $actor->id, 'record_id' => $record->id, 'etag' => $data['etag'], 'action' => $data['action'],
+            'input' => $data, 'projection' => $projection, 'expires' => now()->addMinutes(15)->timestamp];
+        return ['action' => $data['action'], 'projection' => $projection, 'token' => Crypt::encryptString(json_encode($payload, JSON_THROW_ON_ERROR)),
+            'current' => $record->only(['title', 'summary', 'description', 'status']), 'writes' => false];
+    }
+
+    public function confirm(User $actor, int $id, array $input): array
+    {
+        $data = Validator::make($input, ['token' => 'required|string|max:300000', 'operation_key' => 'required|uuid',
+            'confirm' => 'required|accepted', 'reason' => 'required|string|min:10|max:1000'])->validate();
+        try { $preview = json_decode(Crypt::decryptString($data['token']), true, flags: JSON_THROW_ON_ERROR); }
+        catch (\Throwable) { abort(422, 'Prévia inválida. Prepare outra prévia.'); }
+        abort_unless(($preview['actor_id'] ?? null) === $actor->id && ($preview['record_id'] ?? null) === $id, 403);
+        return DB::transaction(function () use ($actor, $id, $data, $preview) {
+            DB::select('SELECT pg_advisory_xact_lock(hashtext(?))', ['promotional-operation:'.$data['operation_key']]);
+            $record = Opportunity::whereKey($id)->lockForUpdate()->firstOrFail();
+            $this->authorize($actor, $record);
+            $digest = hash('sha256', $data['token'].'|'.$data['reason']);
+            $replay = DB::table('audit_events')->where('source_system', 'tempo-preparation-publication')
+                ->where('after_data->operation_key', $data['operation_key'])->first();
+            if ($replay) {
+                $prior = json_decode($replay->after_data, true);
+                abort_unless($prior['record_id'] === $id && (int) $replay->actor_user_id === $actor->id && hash_equals($prior['request_hash'], $digest), 409, 'Chave usada noutra operação.');
+                return ['id' => $id, 'replayed' => true, 'message' => 'Operação já registada; nenhuma alteração repetida.'];
+            }
+            abort_unless(($preview['expires'] ?? 0) >= now()->timestamp, 409, 'A prévia expirou. Prepare outra prévia.');
+            abort_unless(hash_equals(app(OpportunityManagement::class)->etag($record), $preview['etag']), 409, 'Alteração concorrente: a ficha foi preservada. Reabra e reveja a nova versão.');
+            $before = $record->getRawOriginal();
+            $oldLocations = DB::table('opportunity_locations')->where('opportunity_id', $id)->pluck('geo_location_id')->all();
+            $context = $record->workflow_context ?? [];
+            if ($preview['action'] === 'withdraw') {
+                $record->status = 'suspended';
+                $record->published_at = null;
+                $context['publication']['visibility'] = 'withdrawn';
+                $action = 'promotional_summary_withdrawn';
+            } else {
+                $p = $preview['projection'];
+                if ($p['sector_id'] !== null) abort_unless(\App\Models\Sector::catalog()->whereKey($p['sector_id'])->exists(), 409, 'O sector deixou de estar disponível no catálogo. Prepare outra prévia.');
+                $paths = [];
+                foreach ($preview['input']['territory_ids'] ?? [] as $territory) {
+                    $path = app(InvestmentGeography::class)->path($territory, true);
+                    abort_unless(count($path) && collect($path)->contains('id', $territory), 409, 'Um território deixou de estar disponível. Prepare outra prévia.');
+                    $paths[] = $path;
+                }
+                $currentTerritories = array_map(fn ($path) => ['id' => end($path)->id, 'label' => implode(' / ', array_column($path, 'name'))], $paths);
+                abort_unless($currentTerritories === $p['territories'], 409, 'O enquadramento territorial mudou. Prepare outra prévia.');
+                // Preserve the original private draft bytes; retain its former base
+                // columns in the existing hidden context before projecting public text.
+                $context['promotional_private_base'] ??= $record->only(OpportunityManagement::FIELDS);
+                $context['working_state'] ??= app(PortalProfileAccess::class)->state($record);
+                $context['promotional_summary'] = ['input' => $preview['input'], 'projection' => $p];
+                $context['publication'] = ['visibility' => 'public', 'purpose' => self::PURPOSE, 'actor_id' => $actor->id,
+                    'at' => now()->toIso8601String(), 'execution_approved' => false, 'private_draft_preserved' => true];
+                $action = data_get($before, 'status') === 'published' ? 'promotional_summary_updated' : 'promotional_summary_published';
+                foreach (['title', 'summary', 'description', 'sector_id', 'maturity_label'] as $field) $record->{$field} = $p[$field];
+                foreach (['promoter_name', 'promoter_type', 'financing_modality', 'expected_impact', 'maturity_level', 'estimated_investment_amount', 'estimated_investment_currency'] as $field) $record->{$field} = null;
+                $main = $paths[0] ?? [];
+                $record->primary_territory_id = $main ? end($main)->id : null;
+                $record->province = collect($main)->firstWhere('location_type', 'province')?->name;
+                $record->district = collect($main)->firstWhere('location_type', 'district')?->name;
+                $record->geography_scope = count($paths) > 1 ? 'multiple' : ($main ? 'specific' : 'unspecified');
+                DB::table('opportunity_locations')->where('opportunity_id', $id)->delete();
+                foreach ($preview['input']['territory_ids'] ?? [] as $territory) DB::table('opportunity_locations')->insert(['opportunity_id' => $id, 'geo_location_id' => $territory]);
+                $record->status = 'published';
+                $record->is_featured = false;
+                $record->last_validated_at = null;
+                $record->published_at = now();
+            }
+            $record->workflow_context = $context;
+            $record->management_version++;
+            $record->save();
+            DB::table('audit_events')->insert(['source_system' => 'tempo-preparation-publication', 'entity_type' => 'opportunity',
+                'actor_user_id' => $actor->id, 'action' => $action, 'data_classification' => 'restricted', 'correlation_id' => (string) Str::uuid(),
+                'before_data' => json_encode(['record_id' => $id, 'record' => $before, 'territories' => $oldLocations], JSON_THROW_ON_ERROR),
+                'after_data' => json_encode(['record_id' => $id, 'operation_key' => $data['operation_key'], 'request_hash' => $digest,
+                    'reason' => $data['reason'], 'projection' => $preview['projection'], 'execution_approved' => false,
+                    'record' => $record->getRawOriginal()], JSON_THROW_ON_ERROR)]);
+            return ['id' => $id, 'replayed' => false, 'message' => $preview['action'] === 'withdraw' ? 'Resumo retirado; cadastro e histórico preservados.' : 'Resumo divulgado como Em preparação. Não autoriza execução do investimento.'];
+        });
+    }
+}

app/Services/OpportunityPublicText.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Opportunity;
+
+/** Presentation only: originals, editorial fields and audit records remain intact. */
+final class OpportunityPublicText
+{
+    public static function description(Opportunity $record, string $text): string
+    {
+        $source = data_get($record->workflow_context, 'corridor_agribusiness');
+        if (! is_array($source) || ($source['source_sha256'] ?? null) !== CorridorAgribusinessOpportunities::SOURCE_HASH) return $text;
+
+        $hash = CorridorAgribusinessOpportunities::SOURCE_HASH;
+        $sourceLine = 'Fonte: '.$source['source'].'; SHA-256 '.$hash;
+        $paragraphs = explode("\n\n", $text);
+        $result = [];
+        foreach ($paragraphs as $paragraph) {
+            $paragraph = trim($paragraph);
+            if (in_array($paragraph, [$sourceLine, $sourceLine.'.', 'Edição: Não indicada.', 'Data-base: Não indicada.',
+                'Limitações e lacunas: '.CorridorAgribusinessOpportunities::LIMITATIONS,
+                OpportunityPromotion::NOTICE], true)) continue;
+            if ($paragraph === 'Enquadramento documental: '.$source['corridor'].'.') $paragraph = $source['corridor'].'.';
+            if ($paragraph === CorridorAgribusinessOpportunities::LIMITATIONS) {
+                $paragraph = 'A localização exacta, a disponibilidade de terreno e as condições do investimento serão definidas durante a preparação do projecto.';
+            }
+            if ($paragraph !== '') $result[] = $paragraph;
+        }
+        return implode("\n\n", $result);
+    }
+}

app/Services/PortalProfileAccess.php

@@ -184,7 +184,9 @@ class PortalProfileAccess
 
     public function canCreate(User $actor, ?string $organization, string $type): bool
     {
-        $included = in_array($type, OpportunityCanonicalContract::BASE_CATEGORIES, true) || app(OpportunityModularProfiles::class)->enabled();
+        // Draft preparation is allowed within the assigned modality. Executable
+        // submission support is checked separately by the canonical contract.
+        $included = in_array($type, OpportunityManagement::CATEGORIES, true);
 
         // This is creation as an authorized Promotor, never an exceptional SU act.
         return $included && $this->available() && $this->scoped($actor, 'promoter', $organization, $type) && ! $this->has($actor, 'auditor');
@@ -370,7 +372,8 @@ class PortalProfileAccess
             foreach (json_decode($grant->opportunity_types, true, 512, JSON_THROW_ON_ERROR) as $type) {
                 $key = ($grant->organization_id ?? 'individual').'|'.$type;
                 if (! isset($seen[$key]) && $this->canCreate($actor, $grant->organization_id, $type)) {
-                    $contexts[] = ['organization_id' => $grant->organization_id, 'type' => $type];
+                    $contexts[] = ['organization_id' => $grant->organization_id,
+                        'organization_name' => $grant->organization_id ? DB::table('organizations')->where('id', $grant->organization_id)->value('name') : null, 'type' => $type];
                     $seen[$key] = true;
                 }
             }

app/Services/PrivateInvestmentPreparation.php

@@ -0,0 +1,189 @@
+<?php
+
+namespace App\Services;
+
+use Brick\Math\BigDecimal;
+
+/** Adapter of the dossier's declared context to preparation of a private-investment request. No tax or entitlement decision. */
+final class PrivateInvestmentPreparation
+{
+    public const VERSION = 'private-investment-preparation-2026-v1';
+
+    public const SOURCE = 'https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf';
+
+    public const HASH = 'ba1e9eaabfec5d0c4cb2d9f2444a6860f7a90f222034764197829be402d408ed';
+
+    public const FIELDS = ['investment_form', 'investment_preparation', 'investment_activity_scope', 'implementation_mode', 'capital_origin', 'site_tenure', 'project_concession', 'significant_implications', 'land_extension', 'forest_concession', 'forest_concession_hectares', 'total_investment', 'area_required', 'area_unit'];
+
+    public const DOCUMENTS = ['identity', 'registration', 'name_reservation', 'site_plan', 'lease', 'duat', 'representation_license', 'feasibility', 'financial_capacity', 'foreign_capital'];
+
+    public function available(): bool
+    {
+        return (bool) config('investor-path.private_preparation', false);
+    }
+
+    public function questions(): array
+    {
+        $tri = ['unknown' => 'Por determinar', 'yes' => 'Sim', 'no' => 'Não'];
+
+        return [
+            ['key' => 'investment_preparation', 'label' => 'Pretende preparar o pedido de garantias/incentivos ao investimento privado?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 2'],
+            ['key' => 'investment_activity_scope', 'label' => 'Natureza efectiva da actividade do projecto', 'options' => ['unknown' => 'Por determinar', 'general' => 'Outra actividade económica', 'extractive' => 'Prospecção, pesquisa ou produção extractiva', 'processing' => 'Processamento industrial mineiro/petrolífero', 'public_nonprofit' => 'Investimento público ou exclusivamente social/sem fins lucrativos'], 'source' => 'Lei 8/2023, artigos 2 e 22'],
+            ['key' => 'investment_form', 'label' => 'Tipo deste investimento', 'options' => ['unknown' => 'Por determinar', 'direct' => 'Directo', 'indirect' => 'Indirecto'], 'source' => 'Lei 8/2023, artigo 14(b); Regulamento, artigo 13', 'help' => 'O limiar monetário do artigo 13 aplica-se ao investimento directo. A forma indirecta não é convertida silenciosamente em directa.'],
+            ['key' => 'implementation_mode', 'label' => 'Modalidade da empresa implementadora', 'options' => ['unknown' => 'Por determinar', 'domestic_entity' => 'Empresa constituída/em constituição em Moçambique', 'foreign_representation' => 'Representação comercial estrangeira'], 'source' => 'Regulamento 8/2024, artigo 9(2)'],
+            ['key' => 'capital_origin', 'label' => 'Origem dos capitais/recursos deste investimento', 'options' => ['unknown' => 'Por determinar', 'national' => 'Nacionais', 'external' => 'Provenientes do exterior', 'mixed' => 'Mistos'], 'source' => 'Lei 8/2023, glossário; Regulamento, artigos 4–6'],
+            ['key' => 'site_tenure', 'label' => 'Fundamento declarado da utilização das instalações', 'options' => ['unknown' => 'Por determinar', 'lease' => 'Arrendamento', 'duat' => 'DUAT'], 'source' => 'Regulamento, artigos 9(1)(d) e 14(1)(d)'],
+            ['key' => 'project_concession', 'label' => 'O empreendimento é PPP ou concessão empresarial?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 22(1)(b)(ii)'],
+            ['key' => 'significant_implications', 'label' => 'Existem previsíveis implicações económicas, ambientais, de segurança ou saúde pública que exijam autorização?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 22(1)(b)(i)', 'help' => 'Declare o enquadramento conhecido; o nome do sector não responde a esta pergunta. Sem fundamento suficiente, mantenha por determinar.'],
+            ['key' => 'land_extension', 'label' => 'O projecto requer extensão de terra?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 22(1)(b)(iii)'],
+            ['key' => 'forest_concession', 'label' => 'O projecto requer concessão florestal?', 'options' => $tri, 'source' => 'Lei 8/2023, artigo 22(1)(b)(iv)'],
+            ['key' => 'forest_concession_hectares', 'label' => 'Área da concessão florestal (hectares)', 'type' => 'number', 'when' => ['field' => 'forest_concession', 'equals' => 'yes'], 'source' => 'Lei 8/2023, artigo 22(1)(b)(iv)'],
+            ['key' => 'total_investment', 'label' => 'Valor total do investimento na moeda do projecto', 'type' => 'number', 'source' => 'Regulamento, artigo 13(2)'],
+            ['key' => 'area_required', 'label' => 'Área de terra requerida', 'type' => 'number', 'when' => ['field' => 'land_extension', 'equals' => 'yes'], 'source' => 'Lei 8/2023, artigo 22(1)(b)(iii)'],
+            ['key' => 'area_unit', 'label' => 'Unidade da área requerida', 'options' => ['ha' => 'Hectares', 'm2' => 'Metros quadrados'], 'when' => ['field' => 'land_extension', 'equals' => 'yes'], 'source' => 'Conversão de unidade exacta; não é benefício ou condição adicional'],
+        ];
+    }
+
+    private function number(array $f, string $key): ?BigDecimal
+    {
+        $value = $f[$key] ?? '';
+
+        return is_scalar($value) && preg_match('/^\d+(?:\.\d+)?$/D', (string) $value) ? BigDecimal::of((string) $value) : null;
+    }
+
+    public function assess(array $context, array $documents = []): array
+    {
+        $f = $context['fields'] ?? [];
+        $missing = [];
+        $answer = function (string $key) use ($f, &$missing): ?bool {
+            if (! in_array($f[$key] ?? '', ['yes', 'no'], true)) {
+                $missing[] = $key;
+
+                return null;
+            }
+
+            return $f[$key] === 'yes';
+        };
+        $enabled = ($f['investment_preparation'] ?? '') === 'yes';
+        $date = $f['expected_start_date'] ?? '';
+        $period = preg_match('/^2026-\d{2}-\d{2}$/D', $date) === 1;
+        $scope = $f['investment_activity_scope'] ?? 'unknown';
+        $covered = in_array($scope, ['general', 'processing'], true);
+        $mode = 'indeterminate';
+        $reasons = [];
+        if ($enabled) {
+            if (! $date) {
+                $missing[] = 'expected_start_date';
+            }
+            if ($scope === 'unknown' || $scope === '') {
+                $missing[] = 'investment_activity_scope';
+            }
+            if (empty($f['currency'])) {
+                $missing[] = 'currency';
+            }
+            if ($covered && $period) {
+                $triggers = [];
+                if ($scope === 'processing') {
+                    $triggers['processing'] = true;
+                    $reasons[] = 'Processamento industrial mineiro/petrolífero: Lei 8/2023, artigo 22(1)(b)(v).';
+                }
+                $amount = $this->number($f, 'total_investment');
+                $triggers['amount'] = $amount && ($f['currency'] ?? '') === 'MZN' && ($f['investment_form'] ?? '') === 'direct' ? $amount->isGreaterThan('32000000000') : null;
+                if (! in_array($f['investment_form'] ?? '', ['direct', 'indirect'], true)) {
+                    $missing[] = 'investment_form';
+                }
+                if (($f['investment_form'] ?? '') === 'indirect') {
+                    $reasons[] = 'Investimento indirecto: a classificação pela dimensão e o encaminhamento monetário não são determinados por este lote. As restantes condições documentadas continuam avaliadas.';
+                }
+                if (! $amount) {
+                    $missing[] = 'total_investment';
+                }
+                if (($f['currency'] ?? '') !== 'MZN') {
+                    $reasons[] = 'A condição monetária não é determinada noutra moeda: não se fez conversão.';
+                }
+                foreach (['project_concession', 'significant_implications'] as $key) {
+                    $triggers[$key] = $answer($key);
+                }
+                $land = $answer('land_extension');
+                if ($land === true) {
+                    $area = $this->number($f, 'area_required');
+                    $unit = $f['area_unit'] ?? '';
+                    if (! $area) {
+                        $missing[] = 'area_required';
+                    }if (! in_array($unit, ['ha', 'm2'], true)) {
+                        $missing[] = 'area_unit';
+                    }
+                    $triggers['land_extension'] = $area && in_array($unit, ['ha', 'm2'], true) ? $area->isGreaterThanOrEqualTo($unit === 'ha' ? '10000' : '100000000') : null;
+                } else {
+                    $triggers['land_extension'] = $land;
+                }
+                $forest = $answer('forest_concession');
+                if ($forest === true) {
+                    $area = $this->number($f, 'forest_concession_hectares');
+                    if (! $area) {
+                        $missing[] = 'forest_concession_hectares';
+                    }$triggers['forest_concession'] = $area ? $area->isGreaterThan('100000') : null;
+                } else {
+                    $triggers['forest_concession'] = $forest;
+                }
+                foreach (['amount' => 'Valor superior a 32 mil milhões MZN — R13(2), R21(2)(a)', 'project_concession' => 'PPP/concessão empresarial — Lei 8/2023, art. 22(1)(b)(ii), R21(2)(b)', 'significant_implications' => 'Implicações significativas declaradas — Lei 8/2023, art. 22(1)(b)(i), R21(1)', 'land_extension' => 'Extensão de terra igual/superior a 10 mil hectares — Lei 8/2023, art. 22(1)(b)(iii), R21(2)(c)', 'forest_concession' => 'Concessão florestal superior a 100 mil hectares — Lei 8/2023, art. 22(1)(b)(iv), R21(2)(d)'] as $condition => $description) {
+                    if (($triggers[$condition] ?? null) === true) {
+                        $reasons[] = $description.'.';
+                    }
+                }
+                $mode = in_array(true, $triggers, true) ? 'authorization' : (in_array(null, $triggers, true) ? 'indeterminate' : 'registration');
+                $reasons[] = $mode === 'authorization' ? 'Foi identificada uma condição de autorização; as restantes condições desconhecidas não foram presumidas negativas.' : ($mode === 'registration' ? 'As condições de autorização deste lote foram declaradas negativas e o montante não ultrapassa o limite.' : 'Falta resolver pelo menos uma condição de autorização.');
+            }
+            foreach (['implementation_mode', 'capital_origin', 'site_tenure', 'entity_stage'] as $key) {
+                if (empty($f[$key]) || $f[$key] === 'unknown') {
+                    $missing[] = $key;
+                }
+            }
+        }
+        if ($mode === 'authorization' && in_array(true, array_intersect_key($triggers, array_flip(['amount', 'project_concession', 'land_extension', 'forest_concession'])), true)) {
+            $missing = array_values(array_diff($missing, ['investment_form', 'project_concession', 'significant_implications', 'land_extension', 'forest_concession', 'forest_concession_hectares', 'area_required', 'area_unit', 'total_investment']));
+        }
+        $base = $enabled && $covered && $period ? true : null;
+        if (! $enabled || in_array($scope, ['extractive', 'public_nonprofit'], true) || ($date && ! $period)) {
+            $base = false;
+        }
+        $rules = [
+            ['identity', 'Identificação do investidor', $base, 'S06', 'R9(1)(a) / R14(1)(a)', 41, 'Identificação do proponente do pedido.'],
+            ['registration', 'Certidão de registo comercial', $base === true ? (($f['entity_stage'] ?? '') === 'existing' ? true : (($f['entity_stage'] ?? '') === 'being_formed' ? false : null)) : $base, 'S05', 'R9(1)(b) / R14(1)(b)', 41, 'Alternativa para empresa já registada.'],
+            ['name_reservation', 'Reserva da denominação social', $base === true ? (($f['entity_stage'] ?? '') === 'being_formed' ? true : (($f['entity_stage'] ?? '') === 'existing' ? false : null)) : $base, 'S05', 'R9(1)(b) / R14(1)(b)', 41, 'Alternativa para empresa em constituição.'],
+            ['site_plan', 'Planta ou esboço do local', $base, 'S06', 'R9(1)(c) / R14(1)(c)', 42, 'Local de implantação identificado; não certifica disponibilidade.'],
+        ];
+        foreach (['lease' => 'Contrato de arrendamento', 'duat' => 'Título DUAT'] as $key => $label) {
+            $rules[] = [$key, $label, $base === true ? (($f['site_tenure'] ?? 'unknown') === 'unknown' ? null : ($f['site_tenure'] ?? '') === $key) : $base, 'S06', 'R9(1)(d) / R14(1)(d)', 42, 'Alternativa correspondente à utilização declarada das instalações.'];
+        }
+        $rules[] = ['representation_license', 'Licença de representação comercial', $base === true ? (($f['implementation_mode'] ?? 'unknown') === 'unknown' ? null : ($f['implementation_mode'] ?? '') === 'foreign_representation') : $base, 'S06', 'R9(2)', 42, 'Só para a modalidade representação comercial estrangeira; não decorre da nacionalidade.'];
+        foreach (['feasibility' => 'Estudo de viabilidade técnica e económico-financeira', 'financial_capacity' => 'Comprovação da capacidade financeira'] as $key => $label) {
+            $rules[] = [$key, $label, $base === true ? ($mode === 'indeterminate' ? null : $mode === 'authorization') : $base, 'S02', 'R14(1)–(2)', 45, 'Integra a preparação do pedido de autorização.'];
+        }
+        $rules[] = ['foreign_capital', 'Prova de realização/registo do aporte externo', $base === true ? (($f['capital_origin'] ?? 'unknown') === 'unknown' ? null : in_array($f['capital_origin'] ?? '', ['external', 'mixed'], true)) : $base, 'S06', 'R5(1)–(5)', 39, 'Preparação específica do aporte externo; formalidades cambiais concretas não calculadas.'];
+        $links = $context['preparation_documents'] ?? [];
+        $requirements = [];
+        foreach ($rules as [$key,$label,$applies,$stage,$article,$page,$reason]) {
+            $doc = isset($links[$key]) ? collect($documents)->firstWhere('document_id', $links[$key]) : null;
+            $requirements[] = ['key' => $key, 'label' => $label, 'state' => $applies === false ? 'not_applicable' : ($applies === null ? 'indeterminate' : ($doc ? 'associated' : 'missing')), 'required' => $applies === true, 'document_id' => $links[$key] ?? null, 'document' => $doc, 'stage' => $stage, 'reason' => $reason, 'source' => ['reference' => $article, 'url' => self::SOURCE.'#page='.$page, 'sha256' => self::HASH, 'period' => '2026; Regulamento desde 07/03/2024'], 'legal_verification' => 'not_inferred'];
+        }
+        $authoritySource = ['reference' => 'R13(1)', 'url' => self::SOURCE.'#page=45'];
+        $zone = $context['selection']['park'] ?? null;
+        $amount = $this->number($f, 'total_investment');
+        $authority = 'Por determinar neste lote';
+        if ($base === true && $mode === 'registration' && $amount && ($f['currency'] ?? '') === 'MZN') {
+            $special = in_array($zone['fields']['investment_regime'] ?? '', ['zee', 'zfi'], true);
+            $authority = $special ? ($amount->isLessThanOrEqualTo('6500000000') ? 'APIEX — condicionado ao enquadramento ZEE/ZFI efectivamente reconhecido' : 'Ministro que superintende Finanças') : ($amount->isLessThanOrEqualTo('3500000000') ? 'Governador da Província' : ($amount->isLessThanOrEqualTo('6500000000') ? 'APIEX' : 'Ministro que superintende Finanças'));
+        }
+        if ($base === true && $mode === 'authorization') {
+            $council = array_intersect_key($triggers, array_flip(['amount', 'project_concession', 'land_extension', 'forest_concession']));
+            $authority = in_array(true, $council, true) ? 'Conselho de Ministros' : (in_array(null, $council, true) ? 'Autorização identificada; completar as condições em falta para distinguir a entidade decisória' : 'Ministro que superintende Finanças; eventual submissão ao Conselho de Ministros nos termos do R21(3)');
+            $authoritySource = ['reference' => 'R21(1)–(3)', 'url' => self::SOURCE.'#page=50'];
+        }
+
+        $labels = array_column($this->questions(), 'label', 'key') + ['currency' => 'Moeda do projecto', 'expected_start_date' => 'Data prevista de início', 'entity_stage' => 'Situação da entidade'];
+        $missingLabels = array_map(fn ($key) => $labels[$key] ?? $key, array_values(array_unique($missing)));
+
+        return ['version' => self::VERSION, 'enabled' => $enabled, 'period_covered' => $period, 'scope_covered' => $covered, 'mode' => $mode, 'reason' => $reasons, 'missing_fields' => array_values(array_unique($missing)), 'missing_labels' => $missingLabels, 'questions' => $this->questions(), 'requirements' => $requirements, 'authority' => $authority, 'authority_source' => $authoritySource, 'next' => $base === false ? 'Rever o âmbito/período; este lote não cobre o pedido' : ($mode === 'indeterminate' ? 'Completar condições do enquadramento' : ($mode === 'authorization' ? 'Preparar estudo e documentos do pedido de autorização' : 'Preparar documentos do pedido de mero registo')), 'calculation_notice' => 'O regime procedimental não altera a taxa de IVA. Reutilize a simulação geral apenas no seu âmbito e período; benefícios, apuramento final e conversão cambial não são presumidos.', 'source' => ['url' => self::SOURCE, 'sha256' => self::HASH], 'notice' => 'Preparação informativa baseada em declarações; documentos associados não constituem validação jurídica, certificado ou submissão à Administração.'];
+    }
+}

app/Services/Procurement.php

@@ -0,0 +1,287 @@
+<?php
+
+namespace App\Services;
+
+use App\Models\Opportunity;
+use App\Models\User;
+use Carbon\CarbonImmutable;
+use Illuminate\Database\Query\Builder;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+use Illuminate\Support\Facades\Validator;
+use Illuminate\Support\Str;
+use Illuminate\Validation\ValidationException;
+
+/** Publication of notices; never receives bids or changes the linked investment. */
+final class Procurement
+{
+    public const TEXT = ['title', 'reference', 'responsible_unit', 'modality', 'object', 'object_kind', 'quantities', 'financier', 'instrument', 'edition', 'rule_source', 'financing_agreement', 'eligibility', 'requirements', 'proposal_validity', 'guarantee_status', 'guarantees', 'delivery_channel', 'delivery_address', 'delivery_url', 'public_contact', 'dissemination', 'origin_url', 'origin_published_at', 'clarifications_at', 'deadline', 'opening_at', 'timezone', 'minimum_source', 'minimum_edition', 'minimum_modality', 'minimum_day_basis', 'result', 'internal_notes', 'public_reason', 'minimum_working_days', 'minimum_holidays', 'minimum_calendar_source'];
+
+    public function available(): bool
+    {
+        return config('procurement.enabled') && Schema::hasTable('portal_tenders');
+    }
+
+    public function access(?User $actor): bool
+    {
+        if (! $actor || ! $actor->hasVerifiedEmail()) {
+            return false;
+        }
+        $docs = app(DocumentManagementAccess::class);
+
+        return ! app(PortalProfileAccess::class)->has($actor, 'auditor') && ($docs->full($actor) || $docs->editorial($actor));
+    }
+
+    public function guard(?User $actor): void
+    {
+        abort_unless($this->available(), 404);
+        abort_unless($this->access($actor), 403, 'Use a autorização editorial já atribuída.');
+    }
+
+    public function references(User $actor): array
+    {
+        $this->guard($actor);
+        $editable = app(DocumentManagementAccess::class)->documents($actor)->select('id');
+
+        return ['regimes' => config('procurement.regimes'), 'acts' => config('procurement.acts'),
+            'organizations' => DB::table('organizations')->whereNull('deleted_at')->orderBy('name')->get(['id', 'name']),
+            'sectors' => DB::table('sectors')->orderBy('name')->get(['id', 'name']),
+            'territories' => app(InvestmentGeography::class)->references(true)->orderBy('name')->get(['id', 'name', 'location_type']),
+            'opportunities' => app(PortalProfileAccess::class)->scope(Opportunity::query(), $actor)->orderBy('title')->get(['id', 'title']),
+            'projects' => DB::table('projects')->whereNull('deleted_at')->whereIn('data_classification', ['internal', 'public'])->orderBy('name')->get(['id', 'name']),
+            'documents' => DB::table('portal_resources as r')->join('documents as d', 'd.id', '=', 'r.document_id')->whereNull('d.deleted_at')
+                ->where(fn ($q) => $q->whereIn('d.id', $editable)->orWhere(fn ($p) => $p->where('r.published', true)->where('d.data_classification', 'public')))
+                ->orderBy('r.title')->get(['r.id', 'r.title', 'r.published', 'd.malware_scan_status'])];
+    }
+
+    public function record(string $id): object
+    {
+        abort_unless($this->available(), 404);
+
+        return DB::table('portal_tenders')->where('id', $id)->firstOrFail();
+    }
+
+    public function save(User $actor, ?string $id, array $input): string
+    {
+        $this->guard($actor);
+        $v = Validator::make($input, ['version' => 'required|integer|min:0', 'reason' => 'required|string|min:20|max:1000', 'draft' => 'required|array']);
+        $v->validate();
+        $draft = $this->normalize($actor, $input['draft']);
+
+        return DB::transaction(function () use ($actor, $id, $input, $draft) {
+            $old = $id ? DB::table('portal_tenders')->where('id', $id)->lockForUpdate()->firstOrFail() : null;
+            abort_unless((int) ($old->version ?? 0) === (int) $input['version'], 409, 'A versão mudou; recupere o concurso antes de guardar.');
+            $id ??= (string) Str::uuid();
+            $version = ($old->version ?? 0) + 1;
+            if ($old) {
+                DB::table('portal_tenders')->where('id', $id)->update(['draft' => json_encode($draft, JSON_THROW_ON_ERROR), 'version' => $version, 'updated_at' => now()]);
+            } else {
+                DB::table('portal_tenders')->insert(['id' => $id, 'draft' => json_encode($draft, JSON_THROW_ON_ERROR), 'version' => $version, 'created_by' => $actor->id, 'created_at' => now(), 'updated_at' => now()]);
+            }
+            $this->version($actor, $id, $version, 'draft', $draft, $input['reason'], false);
+
+            return $id;
+        });
+    }
+
+    private function normalize(User $actor, array $input): array
+    {
+        $rules = array_fill_keys(self::TEXT, 'nullable|string|max:12000');
+        $rules = [...$rules, 'regime' => 'nullable|in:state,external,private,other', 'organization_id' => 'nullable|uuid|exists:organizations,id',
+            'opportunity_id' => 'nullable|integer|exists:opportunities,id', 'project_id' => 'nullable|uuid|exists:projects,id', 'sector_id' => 'nullable|integer|exists:sectors,id',
+            'territory_id' => 'nullable|uuid|exists:geo_locations,id', 'contact_authorized' => 'boolean', 'minimum_days' => 'nullable|integer|min:0|max:3650',
+            'lots' => 'array|max:100', 'lots.*' => 'array:code,description,quantities', 'lots.*.code' => 'required|string|max:80|distinct', 'lots.*.description' => 'required|string|max:3000', 'lots.*.quantities' => 'nullable|string|max:1500',
+            'attachments' => 'array|max:100', 'attachments.*' => 'array:resource_id,public,purpose', 'attachments.*.resource_id' => 'required|integer|exists:portal_resources,id', 'attachments.*.public' => 'required|boolean', 'attachments.*.purpose' => 'required|string|max:150'];
+        foreach (['origin_url', 'delivery_url', 'rule_source'] as $url) {
+            $rules[$url] = 'nullable|url:http,https|max:2000';
+        }
+        $data = Validator::make($input, $rules)->validate();
+        if (! empty($data['opportunity_id'])) {
+            abort_unless(app(PortalProfileAccess::class)->scope(Opportunity::query(), $actor)->whereKey($data['opportunity_id'])->exists(), 403);
+        }
+        if (! empty($data['project_id'])) {
+            abort_unless(DB::table('projects')->where('id', $data['project_id'])->whereNull('deleted_at')->whereIn('data_classification', ['internal', 'public'])->exists(), 422);
+        }
+        foreach ($data['attachments'] ?? [] as $attachment) {
+            $resource = DB::table('portal_resources')->where('id', $attachment['resource_id'])->firstOrFail();
+            abort_unless($this->publicDocuments()->where('r.id', $resource->id)->exists() || app(DocumentManagementAccess::class)->documents($actor)->where('id', $resource->document_id)->exists(), 403);
+        }
+
+        return $data;
+    }
+
+    public function preview(User $actor, string $id, string $act): array
+    {
+        $this->guard($actor);
+        $record = $this->record($id);
+        abort_unless(array_key_exists($act, config('procurement.acts')), 422);
+        $p = json_decode($record->draft, true, 512, JSON_THROW_ON_ERROR);
+        Validator::make($p, array_fill_keys(['title', 'reference', 'organization_id', 'modality', 'object', 'regime', 'instrument', 'edition', 'rule_source', 'origin_published_at', 'deadline', 'delivery_channel', 'timezone'], 'required'))->validate();
+        Validator::make($p, ['timezone' => 'timezone', 'object_kind' => 'nullable|in:works,goods,services,mixed,other', 'guarantee_status' => 'nullable|in:required,not_required,unknown'])->validate();
+        Validator::make($p, ['public_reason' => 'required|string|min:20|max:1000'])->validate();
+        $dates = [];
+        foreach (['origin_published_at', 'clarifications_at', 'deadline', 'opening_at'] as $field) {
+            if (empty($p[$field])) {
+                continue;
+            }
+            $validator = Validator::make([$field => $p[$field]], [$field => 'date_format:Y-m-d\TH:i']);
+            $validator->validate();
+            $dates[$field] = CarbonImmutable::createFromFormat('!Y-m-d\TH:i', $p[$field], $p['timezone']);
+        }
+        $this->require($dates['deadline']->greaterThan($dates['origin_published_at']), 'deadline', 'Entrega anterior à publicação de origem.');
+        if (isset($dates['clarifications_at'])) {
+            $this->require($dates['clarifications_at']->betweenIncluded($dates['origin_published_at'], $dates['deadline']), 'clarifications_at', 'Esclarecimentos fora do período de publicação/entrega.');
+        }
+        if (isset($dates['opening_at'])) {
+            $this->require($dates['opening_at']->greaterThanOrEqualTo($dates['deadline']), 'opening_at', 'A abertura indicada é anterior à entrega.');
+        }
+        if (($p['guarantee_status'] ?? '') === 'required') {
+            $this->require(! empty($p['guarantees']), 'guarantees', 'Descreva a garantia documentada exigida.');
+        }
+        if (isset($p['minimum_days'])) {
+            foreach (['minimum_source', 'minimum_edition', 'minimum_modality', 'minimum_day_basis'] as $field) {
+                $this->require(! empty($p[$field]), $field, 'Identifique fonte, edição, modalidade e contagem do prazo mínimo.');
+            }
+            $this->require($p['minimum_modality'] === $p['modality'], 'minimum_modality', 'A regra indicada pertence a outra modalidade.');
+            $earliest = $dates['origin_published_at'];
+            if ($p['minimum_day_basis'] === 'business') {
+                $this->require(! empty($p['minimum_calendar_source']), 'minimum_calendar_source', 'Identifique a fonte do calendário de dias úteis e feriados.');
+                $weekdays = array_filter(array_map('trim', explode(',', (string) ($p['minimum_working_days'] ?? ''))));
+                $this->require(count($weekdays) > 0 && ! array_diff($weekdays, ['1', '2', '3', '4', '5', '6', '7']), 'minimum_working_days', 'Indique os dias de trabalho documentados (1=segunda, 7=domingo).');
+                $holidays = array_values(array_filter(preg_split('/[\s,;]+/', (string) ($p['minimum_holidays'] ?? ''))));
+                Validator::make(['dates' => $holidays], ['dates' => 'array|max:1000', 'dates.*' => 'date_format:Y-m-d'])->validate();
+                for ($left = (int) $p['minimum_days'],$iterations = 0; $left > 0; $iterations++) {
+                    $this->require($iterations < 36500, 'minimum_days', 'Calendário insuficiente para calcular o prazo indicado.');
+                    $earliest = $earliest->addDay();
+                    if (in_array((string) $earliest->isoWeekday(), $weekdays, true) && ! in_array($earliest->format('Y-m-d'), $holidays, true)) {
+                        $left--;
+                    }
+                }
+            } else {
+                $this->require($p['minimum_day_basis'] === 'calendar', 'minimum_day_basis', 'Identifique dias corridos ou calendário de dias úteis documentado.');
+                $earliest = $earliest->addDays((int) $p['minimum_days']);
+            }
+            $this->require($dates['deadline']->greaterThanOrEqualTo($earliest), 'deadline', 'Prazo inferior ao mínimo documentado para esta modalidade/edição/calendário.');
+        }
+        $previous = $record->published_version_id ? $this->publishedVersion($record->published_version_id) : null;
+        $this->require($previous ? $act !== 'initial' : $act === 'initial', 'act', $previous ? 'O anúncio inicial já existe; publique um acto associado.' : 'Publique primeiro o anúncio inicial.');
+        if ($previous) {
+            $before = $previous['payload'];
+            if (($before['deadline'] ?? '') !== $p['deadline'] || ($before['timezone'] ?? '') !== $p['timezone']) {
+                $this->require($act === 'extension', 'act', 'Uma mudança do prazo exige acto de prorrogação, com data anterior e nova.');
+            }
+            if ($act === 'extension') {
+                $this->require($dates['deadline']->greaterThan(CarbonImmutable::parse($before['deadline'], $before['timezone'])), 'deadline', 'A prorrogação deve avançar o prazo anterior.');
+                $p['deadline_previous'] = $before['deadline'];
+                $p['timezone_previous'] = $before['timezone'];
+            }
+            $p['extended'] = ($before['extended'] ?? false) || $act === 'extension';
+            $p['procedural_state'] = $before['procedural_state'] ?? null;
+        }
+        if ($act === 'award') {
+            $p['procedural_state'] = 'results';
+        }
+        if ($act === 'cancellation') {
+            $p['procedural_state'] = 'cancelled';
+        }
+        if (in_array($act, ['award', 'cancellation', 'other'], true)) {
+            $this->require(! empty($p['result']), 'result', 'Descreva o acto ou resultado documentado.');
+        }
+        $p['organization_name'] = DB::table('organizations')->where('id', $p['organization_id'])->whereNull('deleted_at')->value('name');
+        $this->require((bool) $p['organization_name'], 'organization_id', 'Entidade eliminada; recupere a referência.');
+        $p['sector_name'] = empty($p['sector_id']) ? null : DB::table('sectors')->where('id', $p['sector_id'])->value('name');
+        $p['territory_name'] = empty($p['territory_id']) ? null : app(InvestmentGeography::class)->references(true)->where('id', $p['territory_id'])->value('name');
+        if (! empty($p['territory_id'])) {
+            $this->require((bool) $p['territory_name'], 'territory_id', 'Referência territorial indisponível.');
+        }
+        unset($p['internal_notes']);
+        if (! ($p['contact_authorized'] ?? false)) {
+            unset($p['public_contact']);
+        }
+        $attachments = [];
+        foreach ($p['attachments'] ?? [] as $item) {
+            if (! $item['public']) {
+                continue;
+            }
+            $doc = $this->publicDocuments()->where('r.id', $item['resource_id'])->first(['r.id', 'r.title', 'd.sha256', 'd.id as document_id']);
+            $this->require((bool) $doc, 'attachments', 'Anexo público exige publicação autorizada, scan limpo e direitos sem restrição na biblioteca.');
+            $attachments[] = [...$item, 'title' => $doc->title, 'sha256' => trim($doc->sha256), 'document_id' => $doc->document_id];
+        }
+        $p['attachments'] = $attachments;
+        if (! empty($p['opportunity_id'])) {
+            $o = Opportunity::published()->whereKey($p['opportunity_id'])->first(['id', 'title', 'slug']);
+            $p['opportunity'] = $o ? ['title' => $o->title, 'url' => '/oportunidades/'.$o->slug] : null;
+        }
+        if (! empty($p['project_id'])) {
+            $p['project_name'] = DB::table('projects')->where('id', $p['project_id'])->whereNull('deleted_at')->where('data_classification', 'public')->value('name');
+        }
+        unset($p['opportunity_id'],$p['project_id']);
+        $plan = ['id' => $id, 'version' => $record->version, 'act' => $act, 'payload' => $p];
+        $plan['hash'] = hash_hmac('sha256', json_encode($plan, JSON_THROW_ON_ERROR), config('app.key'));
+
+        return $plan;
+    }
+
+    public function publish(User $actor, string $id, array $input): void
+    {
+        $this->guard($actor);
+        Validator::make($input, ['hash' => 'required|string|size:64', 'act' => 'required|string', 'reason' => 'required|string|min:20|max:1000'])->validate();
+        DB::transaction(function () use ($actor, $id, $input) {
+            $record = DB::table('portal_tenders')->where('id', $id)->lockForUpdate()->firstOrFail();
+            $plan = $this->preview($actor, $id, $input['act']);
+            abort_unless(hash_equals($plan['hash'], $input['hash']), 409, 'Prévia alterada; reveja o conteúdo antes de publicar.');
+            abort_unless($input['reason'] === $plan['payload']['public_reason'], 409, 'O motivo público deve coincidir com a prévia.');
+            $version = $record->version + 1;
+            $vid = $this->version($actor, $id, $version, $input['act'], $plan['payload'], $input['reason'], true);
+            DB::table('portal_tenders')->where('id', $id)->update(['published_version_id' => $vid, 'version' => $version, 'updated_at' => now()]);
+        });
+    }
+
+    private function version(User $actor, string $id, int $version, string $act, array $payload, string $reason, bool $published): string
+    {
+        $vid = (string) Str::uuid();
+        DB::table('portal_tender_versions')->insert(['id' => $vid, 'tender_id' => $id, 'version' => $version, 'act' => $act, 'payload' => json_encode($payload, JSON_THROW_ON_ERROR), 'reason' => $reason, 'actor_id' => $actor->id, 'published_at' => $published ? now() : null, 'created_at' => now()]);
+        DB::table('audit_events')->insert(['source_system' => 'procurement', 'entity_type' => 'portal_tenders', 'entity_id' => $id, 'actor_user_id' => $actor->id, 'action' => $published ? 'notice_published' : 'tender_draft_saved', 'data_classification' => 'internal', 'after_data' => json_encode(['version_id' => $vid, 'act' => $act, 'reason' => $reason], JSON_THROW_ON_ERROR)]);
+
+        return $vid;
+    }
+
+    public function publicDocuments(): Builder
+    {
+        return DB::table('portal_resources as r')->join('documents as d', 'd.id', '=', 'r.document_id')->where('r.published', true)->where('r.rights_status', '!=', 'restricted')->where('d.rights_status', '!=', 'restricted')->where('d.data_classification', 'public')->where('d.status', 'active')->whereNull('d.deleted_at')->where('d.malware_scan_status', 'clean')->whereColumn('d.sha256', 'd.malware_scanned_sha256')
+            ->where(fn ($q) => $q->whereNull('d.source_system')->orWhereNotIn('d.source_system', ['opportunity-resources', 'opportunity-image-derivatives']))
+            ->whereNotExists(fn ($q) => $q->selectRaw('1')->from('opportunity_documents as od')->whereColumn('od.document_id', 'd.id')->whereRaw("NOT jsonb_exists(COALESCE(od.payload,'{}'::jsonb),'library_source')"))
+            ->whereNotExists(fn ($q) => $q->selectRaw('1')->from('opportunity_images as oi')->whereColumn('oi.document_id', 'd.id')->whereRaw("NOT jsonb_exists(COALESCE(oi.payload,'{}'::jsonb),'library_source')"));
+    }
+
+    public function publishedVersion(string $id): array
+    {
+        $v = DB::table('portal_tender_versions')->where('id', $id)->whereNotNull('published_at')->firstOrFail();
+        $p = json_decode($v->payload, true, 512, JSON_THROW_ON_ERROR);
+        foreach ($p['attachments'] ?? [] as $i => $item) {
+            $p['attachments'][$i]['available'] = $this->publicDocuments()->where('r.id', $item['resource_id'])->where('d.id', $item['document_id'])->where('d.sha256', $item['sha256'])->exists();
+        }
+
+        return ['id' => $v->id, 'version' => $v->version, 'act' => $v->act, 'payload' => $p, 'published_at' => $v->published_at, 'reason' => $v->reason];
+    }
+
+    public function state(array $version): string
+    {
+        $p = $version['payload'];
+        if (in_array($p['procedural_state'] ?? '', ['cancelled', 'results'], true)) {
+            return $p['procedural_state'];
+        }
+        if (CarbonImmutable::parse($p['deadline'], $p['timezone'])->isPast()) {
+            return 'deadline_ended';
+        }
+
+        return ($p['extended'] ?? false) ? 'extended' : 'open';
+    }
+
+    private function require(bool $condition, string $field, string $message): void
+    {
+        if (! $condition) {
+            throw ValidationException::withMessages([$field => $message]);
+        }
+    }
+}

app/Services/SectorInvestment.php

@@ -37,19 +37,7 @@ final class SectorInvestment
     public function publicView(Sector $sector): array
     {
         $query = SectorOrganization::opportunities($sector);
-        $articles = [];
-        if (app(LegacyContent::class)->available()) {
-            foreach (self::CONTENT[$sector->slug] ?? [] as $slug) {
-                try {
-                    $a = app(LegacyContent::class)->article($slug);
-                    $articles[] = ['title' => $a['title'], 'href' => $a['href'], 'image' => $a['image'], 'sha256' => $a['sha256'], 'scope' => $slug === 'tech-fintech' && $sector->slug !== 'fintech' ? 'Especialização Fintech; não representa todo o setor.' : 'Conteúdo educativo relacionado; não é uma oportunidade concreta.'];
-                } catch (HttpException $e) {
-                    if ($e->getStatusCode() !== 404) {
-                        throw $e;
-                    }
-                }
-            }
-        }
+        $articles = $this->guides($sector);
         $relations = [];
         foreach (['projects' => 'project_id', 'clusters' => 'cluster_id', 'corridors' => 'corridor_id'] as $table => $foreign) {
             $ids = DB::table('opportunity_'.$table)->whereIn('opportunity_id', (clone $query)->select('id'))->pluck($foreign);
@@ -74,6 +62,26 @@ final class SectorInvestment
             'content_notice' => $sector->slug === 'mercado-financeiro' ? 'O artigo geral de Mercado Financeiro permanece vazio e não foi publicado. A preparação de negócios neste setor está disponível.' : null];
     }
 
+    /** Published guides for an explicit sector; never inferred from proximity. */
+    public function guides(?Sector $sector): array
+    {
+        if (! $sector) return [];
+        $articles = [];
+        if (app(LegacyContent::class)->available()) {
+            foreach (self::CONTENT[$sector->slug] ?? [] as $slug) {
+                try {
+                    $a = app(LegacyContent::class)->article($slug, false);
+                    $articles[] = \Illuminate\Support\Arr::only($a, ['title', 'href', 'image', 'sha256', 'summary', 'author', 'opportunities_href', 'opportunities_label', 'has_opportunities']);
+                } catch (HttpException $e) {
+                    if ($e->getStatusCode() !== 404) {
+                        throw $e;
+                    }
+                }
+            }
+        }
+        return $articles;
+    }
+
     public function attach(User $actor, string $id, array $input): void
     {
         $data = Validator::make($input, ['version' => 'required|integer|min:1', 'sector_slug' => 'required|string|max:150'])->validate();

app/Services/SimulationExecution.php

@@ -4,6 +4,7 @@ namespace App\Services;
 
 use App\Jobs\RunSimulation;
 use App\Models\Simulation;
+use App\Support\IsolatedQaDatabase;
 use Illuminate\Http\Request;
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Str;
@@ -17,15 +18,39 @@ final class SimulationExecution
      */
     public function create(array $data, ?int $actorId, ?string $organizationId, ?string $token, string $key): array
     {
-        $tokenHash = $actorId === null ? hash_hmac('sha256', (string) $token, (string) config('app.key')) : null;
-        $scope = $actorId !== null ? (string) $actorId : ($tokenHash ?? 'anonymous');
-        $scopeHash = hash('sha256', $scope);
-        $keyHash = hash('sha256', strtolower($key));
         $payload = ['base' => (string) $data['base'], 'rate' => (string) $data['rate'], 'reduction' => (string) $data['reduction'], 'scenario_kind' => 'custom_planning', 'organization_id' => $organizationId];
+
+        return $this->createPayload($payload, $actorId, $organizationId, $token, $key);
+    }
+
+    public function createFiscalQaPreview(array $snapshot, int $actorId, string $key): array
+    {
+        abort_unless(IsolatedQaDatabase::allowsSchemaChanges(), 404);
+        abort_unless(($snapshot['scenario_kind'] ?? null) === 'fiscal_rule_qa_preview'
+            && in_array($snapshot['result']['status'] ?? null, ['calculated', 'indeterminate'], true)
+            && ($snapshot['presentation']['rounding_applied'] ?? null) === false, 422);
+
+        return $this->createPayload(['scenario_kind' => 'fiscal_rule_qa_preview', 'fiscal_preview' => $snapshot, 'organization_id' => null],
+            $actorId, null, null, $key);
+    }
+
+    public function createPublishedFiscal(array $input, ?int $actorId, ?string $organizationId, ?string $token, string $key): array
+    {
+        $payload = ['scenario_kind' => 'fiscal_rule_published', 'fiscal_input' => $input, 'organization_id' => $organizationId];
+
+        return $this->createPayload($payload, $actorId, $organizationId, $token, $key,
+            fn (): array => app(SimulationPublishedFiscal::class)->admit($input));
+    }
+
+    private function createPayload(array $payload, ?int $actorId, ?string $organizationId, ?string $token, string $key, ?callable $admit = null): array
+    {
+        $tokenHash = $actorId === null ? hash_hmac('sha256', (string) $token, (string) config('app.key')) : null;
+        $scopeHash = hash('sha256', $actorId !== null ? (string) $actorId : ($tokenHash ?? 'anonymous'));
+        $keyHash = hash('sha256', strtolower($key));
         ksort($payload);
         $payloadHash = hash('sha256', json_encode($payload, JSON_THROW_ON_ERROR));
 
-        return DB::transaction(function () use ($actorId, $organizationId, $token, $tokenHash, $scopeHash, $keyHash, $payloadHash, $payload): array {
+        return DB::transaction(function () use ($actorId, $organizationId, $token, $tokenHash, $scopeHash, $keyHash, $payloadHash, $payload, $admit): array {
             $this->setContext($actorId, $tokenHash);
             DB::select('select pg_advisory_xact_lock(261001, hashtext(?))', [$scopeHash.$keyHash]);
             $receipt = DB::table('simulation_idempotency')->where('scope_hash', $scopeHash)->where('key_hash', $keyHash)->first();
@@ -37,6 +62,10 @@ final class SimulationExecution
                 return ['simulation' => Simulation::with(['scenarios', 'reports'])->whereKey((string) $receipt->simulation_id)->firstOrFail(), 'token' => null, 'replayed' => true];
             }
 
+            if ($admit !== null) {
+                $payload['fiscal_preview'] = $admit();
+            }
+
             $plainToken = $actorId === null ? $token : null;
             $tokenHash = $actorId === null ? hash_hmac('sha256', $plainToken, (string) config('app.key')) : null;
             $this->setContext($actorId, $tokenHash);
@@ -44,7 +73,9 @@ final class SimulationExecution
             $simulation = Simulation::create([
                 'id' => $id, 'questionnaire_version_id' => '61000100-0000-4000-8000-000000000001', 'owner_user_id' => $actorId, 'organization_id' => $organizationId,
                 'anonymous_token_hash' => $tokenHash, 'status' => 'queued', 'version_no' => 1,
-                'input_snapshot' => $payload, 'calculation_snapshot' => ['engine' => 'portal-arithmetic-v1', 'formula' => 'base * rate / 100 * (1 - reduction / 100)', 'legal_rate_source' => null],
+                'input_snapshot' => $payload, 'calculation_snapshot' => in_array($payload['scenario_kind'], ['fiscal_rule_qa_preview', 'fiscal_rule_published'], true)
+                    ? ['engine' => $payload['fiscal_preview']['context']['engine_version'], 'mode' => $payload['fiscal_preview']['fiscal_provenance']['mode'], 'arithmetic' => 'exact_decimal_no_rounding']
+                    : ['engine' => 'portal-arithmetic-v1', 'formula' => 'base * rate / 100 * (1 - reduction / 100)', 'legal_rate_source' => null],
             ]);
             $scenarioId = (string) Str::uuid();
             DB::table('simulation_scenarios')->insert([
@@ -85,6 +116,8 @@ final class SimulationExecution
         return DB::transaction(function () use ($id, $scenarioId, $data, $request): Simulation {
             $this->setContext($request->user()?->id, $this->tokenHash($request));
             $simulation = Simulation::whereNull('deleted_at')->lockForUpdate()->findOrFail($id);
+            abort_if(in_array($simulation->input_snapshot['scenario_kind'] ?? null, ['fiscal_rule_qa_preview', 'fiscal_rule_published'], true), 422,
+                'Crie uma nova pré-visualização fiscal; este snapshot conserva a regra e as entradas originais.');
             $this->requireMatch($request, $simulation);
             $scenario = DB::table('simulation_scenarios')->where('simulation_id', $id)->where('id', $scenarioId)->lockForUpdate()->first();
             abort_if($scenario === null, 404);

app/Services/SimulationFiscalQaPreview.php

@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services;
+
+use App\Models\InvestmentLegalSource;
+use App\Models\User;
+use App\Support\IsolatedQaDatabase;
+use Illuminate\Support\Facades\DB;
+
+/** Exact operation-level IVA calculation against an explicit QA draft; never a payment/return total. */
+final class SimulationFiscalQaPreview
+{
+    public function create(User $actor, string $ruleId, array $input, string $key): array
+    {
+        abort_unless(IsolatedQaDatabase::allowsSchemaChanges(), 404);
+
+        return DB::transaction(function () use ($actor, $ruleId, $input, $key): array {
+            $rule = app(SimulationTaxRuleGovernance::class)->show($actor, $ruleId);
+            abort_unless($rule->status === 'draft' && $rule->rule_code === 'IVA-GERAL-BASE-LIQUIDA', 422,
+                'Seleccione o rascunho do primeiro lote fiscal.');
+            abort_if(collect($rule->rule_definition['nodes'] ?? [])->contains(fn (array $node): bool => ($node['op'] ?? null) === 'round'), 422,
+                'Este percurso preserva o valor exacto e não aplica arredondamento automático.');
+            $source = InvestmentLegalSource::findOrFail($rule->legal_source_id);
+            $version = $rule->attributesToArray();
+            $version['source'] = $source->attributesToArray();
+            $date = $input['reference_date'];
+            $context = ['operation' => $input['operation'], 'currency' => $input['currency']];
+            $missing = [];
+            $resolution = [];
+            $evaluation = null;
+            if ($date < '2026-01-01' || $date > '2026-12-31') {
+                $missing[] = 'demonstrated_coverage';
+            } else {
+                $resolution = app(SimulationTaxParameterResolver::class)->resolveDraftForQa([$version], 'IVA', $date, $date, $context);
+                $rate = collect($resolution)->firstWhere('parameter_code', 'IVA_GENERAL_RATE');
+                if (($rate['status'] ?? null) !== 'resolved' || ($rate['unit'] ?? null) !== 'percent') {
+                    $missing[] = 'eligible_parameter';
+                } else {
+                    $evaluation = app(SimulationTaxRuleExpression::class)->evaluate($rule->rule_definition,
+                        ['base_tributavel' => $input['base']], ['iva_general_rate' => $rate['value']]);
+                }
+            }
+            $snapshot = app(SimulationFiscalSnapshot::class)->build($version, $input, $resolution, $evaluation, $missing);
+
+            return app(SimulationExecution::class)->createFiscalQaPreview($snapshot, $actor->id, $key);
+        });
+    }
+}

app/Services/SimulationFiscalSnapshot.php

@@ -0,0 +1,58 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services;
+
+use Brick\Math\BigRational;
+
+/** Shared snapshot representation; eligibility is resolved by each admission adapter. */
+final class SimulationFiscalSnapshot
+{
+    public function build(array $version, array $input, array $resolution, ?array $evaluation, array $missing, bool $published = false): array
+    {
+        $date = $input['reference_date'];
+        $context = ['operation' => $input['operation'], 'currency' => $input['currency']];
+        $exact = ($evaluation['status'] ?? null) === 'determinate'
+            ? (string) BigRational::of($evaluation['result'])->toBigDecimal()
+            : null;
+        if ($exact === null && $missing === []) {
+            $missing = $evaluation['missing'] ?? ['eligible_parameter'];
+        }
+        $snapshot = [
+            'contract_version' => 1, 'scenario_kind' => $published ? 'fiscal_rule_published' : 'fiscal_rule_qa_preview',
+            'base' => $input['base'], 'currency' => $input['currency'], 'indicative_total' => $exact,
+            'legal_interpretation' => false, 'formula_version' => 'investmoz.tax.v1',
+            'context' => [
+                'reference_date' => $date, 'currency' => $input['currency'], 'currency_fraction_digits' => 2,
+                'scenario_id' => null, 'scenario_version' => 1, 'engine_version' => $published ? 'fiscal-published-v1' : 'fiscal-draft-preview-v1',
+                'ruleset_version' => $version['rule_code'].':'.$version['rule_version'],
+            ],
+            'result' => [
+                'status' => $exact === null ? 'indeterminate' : 'calculated', 'value' => $exact, 'unit' => 'MZN',
+                'explanation' => $exact === null
+                    ? 'IVA indeterminado: o contexto, a fonte ou o período não permitem resolver o parâmetro deste lote QA.'
+                    : 'IVA calculado com precisão decimal exacta, sem arredondamento. Ensaio QA de regra em rascunho; enquadramento declarado, não validado. Não é saldo de declaração nem valor a pagar.',
+                'missing_inputs' => $missing, 'source_ids' => [(string) $version['legal_source_id']],
+            ],
+            'presentation' => ['value' => $exact, 'currency' => $input['currency'], 'rounding_applied' => false, 'purpose' => 'operation_tax_not_payment'],
+            // Exact rational steps supplement the decimal result; no float conversion.
+            'intermediate' => $evaluation,
+            'fiscal_provenance' => [
+                'mode' => $published ? 'published_version' : 'qa_draft_only', 'scope_status' => ($input['scope_declared'] ?? true) ? 'user_declared' : 'undetermined', 'context' => $context,
+                'rounding_policy' => $version['rounding_policy'], 'resolution' => $resolution,
+                'rule' => $version, 'source_acceptance' => 'Fonte oficial aceite pela decisão Tempo de 08/10/2026; não constitui aprovação jurídica desta operação ou publicação da regra.',
+            ],
+        ];
+
+        if ($published) {
+            $snapshot['result']['explanation'] = $exact === null
+                ? 'IVA indeterminado: falta contexto, fonte ou parâmetro elegível para esta operação.'
+                : 'IVA calculado pela versão publicada identificada, sem arredondamento. Enquadramento declarado, não validado. Não é saldo de declaração nem valor a pagar.';
+            $snapshot['fiscal_provenance']['admitted_at'] = now()->toISOString();
+            $snapshot['fiscal_provenance']['source_acceptance'] = 'Fonte oficial aceite pela Tempo em 08/10/2026; não constitui validação jurídica desta operação.';
+        }
+
+        return $snapshot;
+    }
+}

app/Services/SimulationFiscalSourceAcceptance.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace App\Services;
+
+final class SimulationFiscalSourceAcceptance
+{
+    public static function eligible(array $source, ?string $hash = null): bool
+    {
+        if (($source['validation_status'] ?? null) === 'validated') {
+            return true;
+        }
+        $basis = $source['fiscal_acceptance'] ?? null;
+
+        return ($source['validation_status'] ?? null) === 'pending' && is_array($basis)
+            && ($basis['scope'] ?? null) === 'fiscal_parameters'
+            && ($basis['basis'] ?? null) === 'Tempo-official-sources-20261008'
+            && preg_match('/^[a-f0-9]{64}$/D', (string) ($basis['sha256'] ?? '')) === 1
+            && ($hash === null || $basis['sha256'] === $hash);
+    }
+}

app/Services/SimulationFormDrafts.php

@@ -60,9 +60,11 @@ final class SimulationFormDrafts
                 throw new HttpException(409, 'Já existe um rascunho activo. Carregue-o antes de guardar novas alterações.');
             }
 
+            if ($case) $data['economic_snapshot'] = $this->landContext($data['economic_snapshot'], $case);
+            $snapshotHash = hash('sha256', json_encode($this->canonical($data), JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE));
             $draft = SimulationFormDraft::query()->create([
                 'id' => (string) Str::uuid(), 'owner_user_id' => $actorId, 'anonymous_token_hash' => $tokenHash,
-                'version_no' => 1, 'create_key_hash' => $keyHash, 'create_payload_hash' => $payloadHash, 'snapshot_sha256' => $payloadHash,
+                'version_no' => 1, 'create_key_hash' => $keyHash, 'create_payload_hash' => $payloadHash, 'snapshot_sha256' => $snapshotHash,
                 'personal_snapshot' => SimulationFormDraft::encryptSnapshot($data['personal_snapshot']),
                 'economic_snapshot' => SimulationFormDraft::encryptSnapshot($data['economic_snapshot']),
                 'expires_at' => $actorId === null ? now()->addDays(30) : null,
@@ -89,6 +91,7 @@ final class SimulationFormDrafts
             $this->checkContext($request, $draft);
             $this->requireMatch($request, $draft);
             $previousEconomic = SimulationFormDraft::decryptSnapshot($draft->economic_snapshot);
+            $data['economic_snapshot'] = $this->preserveInactiveLandStatus($draft, $data['economic_snapshot'], $previousEconomic, $actorId);
             if (($data['economic_snapshot']['reuse_simulation'] ?? null) === 'no') {
                 unset($data['economic_snapshot']['simulation_sources']);
             } elseif (is_array($previousEconomic['simulation_sources'] ?? null)) {
@@ -456,6 +459,39 @@ final class SimulationFormDrafts
         return $query;
     }
 
+    private function preserveInactiveLandStatus(SimulationFormDraft $draft, array $economic, array $previous, ?int $actorId): array
+    {
+        if (! $actorId || ! config('investor-path.enabled') || ! app(VirtualDesk::class)->installed()) return $economic;
+        // Use the real owner-bound dossier even if a request omits its context parameter.
+        $case = DB::table('desk_cases')->where('simulation_id', $draft->id)->where('user_id', $actorId)->first();
+        if (! $case) return $economic;
+        return $this->landContext($economic, $case, $previous);
+    }
+
+    private function landContext(array $economic, \stdClass $case, ?array $previous = null): array
+    {
+        $snapshot = json_decode($economic['context_applicability_snapshot'] ?? $previous['context_applicability_snapshot'] ?? '', true);
+        $key = $economic['context_opportunity'] ?? $snapshot['consumer_opportunity'] ?? null;
+        $key = app(InvestmentConsumerScope::class)->key(app(InvestorContext::class)->state($case), is_string($key) ? $key : null);
+        $decision = app(InvestorContext::class)->landPreparation($case, $key);
+        if ($decision['need'] !== 'yes' && $previous !== null) {
+            if (array_key_exists('land_status', $previous)) $economic['land_status'] = $previous['land_status'];
+            else unset($economic['land_status']);
+            if (isset($previous['selection_labels']['land_status'])) $economic['selection_labels']['land_status'] = $previous['selection_labels']['land_status'];
+            else unset($economic['selection_labels']['land_status']);
+        }
+        $snapshot = json_decode($economic['context_applicability_snapshot'] ?? $previous['context_applicability_snapshot'] ?? '', true);
+        if (! is_array($snapshot) || ($snapshot['version'] ?? null) !== 1) {
+            $snapshot = ['version' => 1, 'context_revision' => app(InvestorContext::class)->state($case)['revision']];
+        }
+        $snapshot['land_preparation'] = $decision;
+        $snapshot['consumer_opportunity'] = $key;
+        if ($key) $economic['context_opportunity'] = $key;
+        $economic['context_applicability_snapshot'] = json_encode($snapshot, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
+
+        return $economic;
+    }
+
     private function checkContext(Request $request, SimulationFormDraft $draft): void
     {
         $context = $request->input('context');

app/Services/SimulationIvaDiagnostics.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Services;
+
+/** Explains a failed selection; never changes answers, eligibility or calculation. */
+final class SimulationIvaDiagnostics
+{
+    public function explain(array $versions, string $start, string $end, array $context): array
+    {
+        $diagnostics = [];
+        foreach ($versions as $version) {
+            $parameter = $version['parameters']['IVA_GENERAL_RATE'] ?? null;
+            if (! is_array($parameter)) {
+                continue;
+            }
+            $issues = [];
+            $add = function (string $category, ?string $field, string $label, mixed $received, string $expected, string $message) use (&$issues): void {
+                $issues[] = compact('category', 'field', 'label', 'received', 'expected', 'message');
+            };
+            if ($start < $version['valid_from'] || ($version['valid_until'] !== null && $end > $version['valid_until'])) {
+                $add('period_unavailable', 'fiscal_period', 'Período', "$start a $end", $version['valid_from'].' a '.($version['valid_until'] ?? 'sem data final indicada'), 'Esta versão da regra não abrange todo o período seleccionado. Não altere a data real da operação para obter um resultado.');
+            }
+            foreach ($parameter['conditions'] ?? [] as $key => $expected) {
+                $received = $context[$key] ?? null;
+                if ($received === $expected) {
+                    continue;
+                }
+                if ($key === 'currency') {
+                    $category = $received === null || $received === '' ? 'missing_field' : (preg_match('/^[A-Z]{3}$/D', $received) ? 'out_of_scope' : 'invalid_value');
+                    $add($category, 'fiscal_currency', 'Moeda', $received, $expected, $category === 'missing_field' ? 'Indique a moeda da operação.' : 'Esta versão aceita apenas '.$expected.'. Reveja a moeda ou utilize um cálculo adequado à operação; a resposta não foi alterada.');
+                } elseif ($key === 'operation' && ! array_key_exists('operation', $context) && $expected === 'internal_general_net' && in_array($context['fiscal_operation'] ?? null, ['import', 'export', 'non_resident', 'refund'], true)) {
+                    $add('out_of_scope', 'fiscal_operation', 'Operação', $context['fiscal_operation'], 'Operação interna à taxa geral, sobre base líquida já apurada', 'A operação declarada está excluída desta versão. Utilize um cálculo adequado à operação; não altere a resposta para obter um resultado.');
+                } elseif ($key === 'operation' && ! array_key_exists('operation', $context)) {
+                    $add('system_configuration', 'fiscal_operation', 'Operação', $context['fiscal_operation'] ?? null, $expected === 'internal_general_net' ? 'Operação interna à taxa geral, sobre base líquida já apurada' : $expected, 'Limitação de integração do sistema: esta consulta não comunica o enquadramento específico exigido pela versão. A resposta genérica não permite inferi-lo. Utilize o formulário IVA — taxa geral, com declaração explícita do âmbito; não altere respostas para forçar compatibilidade.');
+                } elseif ($key === 'operation') {
+                    $add($received === null || $received === '' ? 'missing_field' : 'out_of_scope', 'fiscal_operation', 'Operação', $received, $expected === 'internal_general_net' ? 'Operação interna à taxa geral, sobre base líquida já apurada' : $expected, 'A operação não está abrangida por esta versão; utilize um cálculo adequado à operação declarada.');
+                } else {
+                    $add('system_configuration', null, 'Configuração da regra', null, 'Condições publicadas ligadas a campos deste formulário', 'O sistema não consegue relacionar todas as condições desta versão com o formulário. Não é uma falha das suas respostas.');
+                }
+            }
+            if (! SimulationFiscalSourceAcceptance::eligible($version['source'] ?? [], $version['source_sha256'] ?? null)
+                || ($version['source_version_no'] ?? null) !== ($version['source']['version_no'] ?? null)
+                || ($version['rule_definition']['language'] ?? null) !== 'investmoz.tax.v1') {
+                $add('system_configuration', null, 'Regra', null, 'Versão publicada com fonte e configuração coerentes', 'A configuração ou a fonte da regra não permite resolver este parâmetro. Não altere as respostas; é necessária correcção do sistema.');
+            }
+            if ($issues !== []) {
+                $source = array_intersect_key($version['source'] ?? [], array_flip(['title', 'diploma', 'article', 'url']));
+                $diagnostics[] = ['label' => 'IVA — taxa geral', 'rule_version' => $version['rule_version'], 'validity' => ['start' => $version['valid_from'], 'end' => $version['valid_until']], 'source' => $source, 'issues' => $issues];
+            }
+        }
+
+        return $diagnostics;
+    }
+}

app/Services/SimulationPublishedFiscal.php

@@ -0,0 +1,136 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Services;
+
+use App\Models\InvestmentLegalSource;
+use App\Models\SimulationTaxRuleVersion;
+use Brick\Math\BigRational;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+
+/** Admission freezes eligibility without granting the public consumer governance write access. */
+final class SimulationPublishedFiscal
+{
+    public function availability(): array
+    {
+        $enabled = (bool) config('simulation-fiscal-consumer.enabled');
+        $eligible = $enabled && $this->boundRule()->where('status', 'published')->exists();
+
+        return ['enabled' => $eligible, 'coverage_start' => '2026-01-01', 'coverage_end' => '2026-12-31',
+            'message' => $eligible ? 'IVA geral sobre base líquida disponível; enquadramento declarado.'
+                : 'O cálculo de IVA geral sobre base líquida está indisponível para novas execuções. Os históricos mantêm-se acessíveis.'];
+    }
+
+    private function boundRule(): Builder
+    {
+        if (! Str::isUuid((string) config('simulation-fiscal-consumer.rule_id')) || config('simulation-fiscal-consumer.rule_version') < 1) {
+            return SimulationTaxRuleVersion::query()->whereRaw('false');
+        }
+
+        return SimulationTaxRuleVersion::query()->whereKey(config('simulation-fiscal-consumer.rule_id'))
+            ->where('rule_version', config('simulation-fiscal-consumer.rule_version'))
+            ->where('rule_code', 'IVA-GERAL-BASE-LIQUIDA')->where('component', 'IVA')
+            ->where('scope_key', 'mz.internal-general-net.mzn');
+    }
+
+    public function admit(array $input, bool $missingBase = false): array
+    {
+        if (isset($input['monthly_sales'])) {
+            return $this->admitMonthly($input);
+        }
+        // Called inside createPayload, after idempotent replay, never by the worker.
+        abort_unless(DB::transactionLevel() > 0, 500);
+        abort_unless(config('simulation-fiscal-consumer.enabled'), 503,
+            'O cálculo de IVA está temporariamente indisponível. Os dados e históricos foram preservados.');
+        DB::select('select pg_advisory_xact_lock_shared(261021, hashtext(?))', [(string) config('simulation-fiscal-consumer.rule_id')]);
+        $rule = $this->boundRule()->first();
+        abort_unless($rule && $rule->status === 'published', 503,
+            'A versão autorizada de IVA não está disponível para novas execuções. Os históricos foram preservados.');
+        abort_if($input['reference_date'] < '2026-01-01' || $input['reference_date'] > '2026-12-31', 422,
+            'Este cálculo abrange apenas exigibilidade em 2026. As entradas foram preservadas.');
+        abort_if(collect($rule->rule_definition['nodes'] ?? [])->contains(fn (array $node): bool => ($node['op'] ?? null) === 'round'), 422,
+            'A versão seleccionada não é compatível com o cálculo exacto deste consumidor.');
+        DB::select('select pg_advisory_xact_lock_shared(261022, hashtext(?))', [(string) $rule->legal_source_id]);
+        $source = InvestmentLegalSource::whereKey($rule->legal_source_id)->firstOrFail();
+        // Publish calculation provenance, not private governance notes or staff identifiers.
+        $version = array_intersect_key($rule->attributesToArray(), array_flip([
+            'id', 'rule_code', 'rule_version', 'component', 'scope_key', 'status', 'valid_from', 'valid_until',
+            'legal_source_id', 'source_version_no', 'source_sha256', 'rule_definition', 'parameters', 'rounding_policy',
+        ]));
+        $version['source'] = array_intersect_key($source->attributesToArray(), array_flip([
+            'id', 'title', 'url', 'diploma', 'article', 'competent_entity', 'valid_from', 'valid_until', 'validation_status', 'version_no',
+        ]));
+        $resolution = app(SimulationTaxParameterResolver::class)->resolvePublishedForPeriod('IVA',
+            $input['reference_date'], $input['reference_date'], ['currency' => $input['currency'], 'operation' => $input['operation']]);
+        $rate = collect($resolution)->firstWhere('parameter_code', 'IVA_GENERAL_RATE');
+        $missing = [];
+        if ($missingBase) {
+            $missing[] = 'taxable_sales';
+        }
+        $evaluation = null;
+        if (! ($input['scope_declared'] ?? false)) {
+            $missing[] = 'operation_scope';
+        }
+        if (($rate['status'] ?? null) !== 'resolved' || ($rate['unit'] ?? null) !== 'percent'
+            || ($rate['rule_id'] ?? null) !== (string) $rule->id
+            || (int) ($rate['rule_version'] ?? 0) !== (int) $rule->rule_version) {
+            $missing[] = 'eligible_parameter';
+        }
+        if ($missing === []) {
+            $evaluation = app(SimulationTaxRuleExpression::class)->evaluate($rule->rule_definition,
+                ['base_tributavel' => $input['base']], ['iva_general_rate' => $rate['value']]);
+        }
+
+        return app(SimulationFiscalSnapshot::class)->build($version, $input, $resolution, $evaluation, $missing, true);
+    }
+
+    private function admitMonthly(array $input): array
+    {
+        $rows = [];
+        $baseTotal = BigRational::zero();
+        $vatTotal = BigRational::zero();
+        $complete = true;
+        $previous = null;
+        foreach ($input['monthly_sales'] as $sale) {
+            abort_unless($previous === null || $sale['date'] === date('Y-m-d', strtotime($previous.' +1 month')), 422, 'A projecção deve conter meses consecutivos, sem duplicações.');
+            $previous = $sale['date'];
+            $known = $sale['amount'] !== null && $sale['amount'] !== '';
+            $net = $input['sales_vat_basis'] === 'net';
+            $month = $this->admit(['base' => $known && $net ? $sale['amount'] : null,
+                'currency' => $input['currency'], 'reference_date' => $sale['date'],
+                'operation' => 'internal_general_net', 'scope_declared' => $input['scope_declared']], ! $known || ! $net);
+            $snapshot ??= $month;
+            $rate = collect($month['fiscal_provenance']['resolution'])->firstWhere('parameter_code', 'IVA_GENERAL_RATE');
+            $vat = $month['result']['value'];
+            $status = ! $known ? 'missing_sales' : (! $net ? 'unsupported_basis' : ($vat === null ? 'indeterminate' : 'calculated'));
+            $rows[] = ['date' => $sale['date'], 'sales_declared' => $sale['amount'],
+                'net_sales' => $known && $net ? $sale['amount'] : null,
+                'rate' => $vat !== null && ($rate['status'] ?? null) === 'resolved' ? $rate['value'] : null,
+                'vat' => $vat, 'gross_sales' => $vat === null ? null : (string) BigRational::of($sale['amount'])->plus($vat)->toBigDecimal(),
+                'status' => $status, 'rule_id' => $month['fiscal_provenance']['rule']['id'],
+                'rule_version' => $month['fiscal_provenance']['rule']['rule_version']];
+            if ($vat === null) {
+                $complete = false;
+            } else {
+                $baseTotal = $baseTotal->plus($sale['amount']);
+                $vatTotal = $vatTotal->plus($vat);
+            }
+        }
+        $value = $complete ? (string) $vatTotal->toBigDecimal() : null;
+        $snapshot['base'] = $complete ? (string) $baseTotal->toBigDecimal() : null;
+        $snapshot['indicative_total'] = $value;
+        $snapshot['result']['value'] = $value;
+        $snapshot['result']['status'] = $complete ? 'calculated' : 'indeterminate';
+        $snapshot['result']['missing_inputs'] = $complete ? [] : ['monthly_sales_or_net_basis_or_scope'];
+        $snapshot['result']['explanation'] = 'IVA mensal sobre vendas declaradas sem IVA, pela versão publicada congelada na admissão. Valores com IVA incluído ou sem informação permanecem indeterminados. Não é imposto final a pagar.';
+        $snapshot['presentation']['value'] = $value;
+        $snapshot['intermediate'] = null;
+        $snapshot['monthly_projection'] = ['input' => $input, 'rows' => $rows,
+            'cash_treatment' => 'Informação separada da tesouraria: os recebimentos declarados não são aumentados pelo IVA nem o IVA é deduzido como custo ou imposto a pagar. Calendário de cobrança e liquidação fiscal não é inferido.'];
+
+        return $snapshot;
+    }
+}

app/Services/SimulationTaxGovernanceAccess.php

@@ -8,15 +8,24 @@ final class SimulationTaxGovernanceAccess
 {
     private const ROLES = ['editors', 'reviewers', 'approvers', 'publishers'];
 
+    public static function maintainer(User $user): bool
+    {
+        return $user->hasVerifiedEmail() && ! app(PortalProfileAccess::class)->has($user, 'auditor') && ($user->can('manage-portal')
+            || app(ScopedPortalAdministration::class)->administrative($user));
+    }
+
     public static function requireRole(User $user, string $role): void
     {
         abort_unless(in_array($role, self::ROLES, true), 500, 'Função de governação desconhecida.');
-        abort_unless(in_array(strtolower($user->email), config('simulation-tax-governance.'.$role, []), true),
+        abort_unless(self::maintainer($user) || in_array(strtolower($user->email), config('simulation-tax-governance.'.$role, []), true),
             403, 'O utilizador não está designado para esta função de governação fiscal.');
     }
 
     public static function requireAnyRole(User $user): void
     {
+        if (self::maintainer($user)) {
+            return;
+        }
         foreach (self::ROLES as $role) {
             if (in_array(strtolower($user->email), config('simulation-tax-governance.'.$role, []), true)) {
                 return;

app/Services/SimulationTaxParameterResolver.php

@@ -4,6 +4,7 @@ declare(strict_types=1);
 
 namespace App\Services;
 
+use App\Support\IsolatedQaDatabase;
 use Brick\Math\BigRational;
 use DateTimeImmutable;
 use Illuminate\Support\Facades\DB;
@@ -16,32 +17,32 @@ final class SimulationTaxParameterResolver
     public function validateParameters(array $parameters): void
     {
         if ($parameters === [] || count($parameters) > 100) {
-            throw new InvalidArgumentException('Provide between 1 and 100 versioned parameters.');
+            throw new InvalidArgumentException('Indique entre 1 e 100 parâmetros versionados.');
         }
         foreach ($parameters as $code => $parameter) {
             if (! is_string($code) || ! preg_match('/^[A-Z][A-Z0-9._-]{1,63}$/', $code) || ! is_array($parameter)
                 || array_diff(array_keys($parameter), ['value', 'unit', 'conditions']) !== []
                 || array_diff(['value', 'unit', 'conditions'], array_keys($parameter)) !== []) {
-                throw new InvalidArgumentException('Each parameter requires only value, unit, and conditions.');
+                throw new InvalidArgumentException('Cada parâmetro deve conter apenas valor, unidade e condições.');
             }
             if ((! is_string($parameter['value']) && ! is_int($parameter['value'])) || (string) $parameter['value'] === ''
                 || ! is_string($parameter['unit']) || ! preg_match('/^[a-z][a-z0-9._-]{0,31}$/', $parameter['unit'])
                 || ! is_array($parameter['conditions'])) {
-                throw new InvalidArgumentException('Invalid parameter value, unit, or conditions.');
+                throw new InvalidArgumentException('Reveja o valor, a unidade e as condições do parâmetro.');
             }
             $isNumericValue = preg_match('/^-?\d+(?:\.\d+)?$/', (string) $parameter['value']) === 1;
             if (in_array($parameter['unit'], ['percent', 'mzn', 'amount', 'days', 'count', 'mzn_per_unit', 'per_unit'], true) && ! $isNumericValue) {
-                throw new InvalidArgumentException('Numeric parameter units require a plain decimal value.');
+                throw new InvalidArgumentException('Esta unidade requer um valor numérico decimal.');
             }
             if ($isNumericValue) {
                 $value = BigRational::of((string) $parameter['value']);
                 if ($value->isNegative() || ($parameter['unit'] === 'percent' && $value->compareTo(100) > 0)) {
-                    throw new InvalidArgumentException('Numeric parameters cannot be negative; percentages must be between 0 and 100.');
+                    throw new InvalidArgumentException('Os valores não podem ser negativos; as percentagens devem estar entre 0 e 100.');
                 }
             }
             foreach ($parameter['conditions'] as $condition => $expected) {
                 if (! is_string($condition) || ! is_string($expected)) {
-                    throw new InvalidArgumentException('Conditions must be a flat map of string assumptions.');
+                    throw new InvalidArgumentException('Indique as condições numa lista simples de nomes e valores em texto.');
                 }
             }
         }
@@ -52,32 +53,34 @@ final class SimulationTaxParameterResolver
      * never executes a tax formula and requires each parameter to declare context.
      *
      * @param  array<string,string>  $context
-     * @return list<array<string,mixed>>
+     * @return list<array<string,mixed>>|array{parameters:list<array<string,mixed>>,diagnostics:list<array<string,mixed>>}
      */
-    public function resolvePublishedForPeriod(string $component, string $periodStart, string $periodEnd, array $context): array
+    public function resolvePublishedForPeriod(string $component, string $periodStart, string $periodEnd, array $context, bool $diagnostics = false): array
     {
         $start = $this->date($periodStart);
         $end = $this->date($periodEnd);
         if ($end < $start || $start->diff($end)->days > 365) {
-            throw new InvalidArgumentException('Invalid effective period.');
+            throw new InvalidArgumentException('Reveja o período de aplicação indicado.');
         }
 
         $rows = DB::table('simulation_tax_rule_versions as rule')
             ->join('investment_legal_sources as source', 'source.id', '=', 'rule.legal_source_id')
             ->where('rule.component', $component)
             ->where('rule.status', 'published')
-            ->whereDate('rule.valid_from', '<=', $periodEnd)
-            ->where(fn ($query) => $query->whereNull('rule.valid_until')->orWhereDate('rule.valid_until', '>=', $periodStart))
-            ->where('source.validation_status', 'validated')
+            ->when(! $diagnostics, fn ($query) => $query->whereDate('rule.valid_from', '<=', $periodEnd)
+                ->where(fn ($query) => $query->whereNull('rule.valid_until')->orWhereDate('rule.valid_until', '>=', $periodStart)))
+            ->where(fn ($query) => $query->where('source.validation_status', 'validated')->orWhere(fn ($fiscal) => $fiscal->where('source.validation_status', 'pending')->where('source.fiscal_acceptance->scope', 'fiscal_parameters')
+                ->where('source.fiscal_acceptance->basis', 'Tempo-official-sources-20261008')
+                ->whereRaw("source.fiscal_acceptance->>'sha256'=rule.source_sha256")))
             ->whereColumn('source.version_no', 'rule.source_version_no')
-            ->whereDate('source.valid_from', '<=', $periodStart)
-            ->where(fn ($query) => $query->whereNull('source.valid_until')->orWhereDate('source.valid_until', '>=', $periodEnd))
+            ->when(! $diagnostics, fn ($query) => $query->whereDate('source.valid_from', '<=', $periodStart)
+                ->where(fn ($query) => $query->whereNull('source.valid_until')->orWhereDate('source.valid_until', '>=', $periodEnd)))
             ->select([
                 'rule.id', 'rule.rule_code', 'rule.rule_version', 'rule.component', 'rule.scope_key',
                 'rule.valid_from', 'rule.valid_until', 'rule.parameters', 'rule.rule_definition',
                 'rule.source_version_no', 'rule.source_sha256',
                 'source.title as source_title', 'source.diploma as source_diploma', 'source.article as source_article',
-                'source.url as source_url', 'source.validation_status as source_validation_status',
+                'source.url as source_url', 'source.validation_status as source_validation_status', 'source.fiscal_acceptance',
                 'source.version_no as source_current_version', 'source.valid_from as source_valid_from',
                 'source.valid_until as source_valid_until',
             ])
@@ -110,6 +113,7 @@ final class SimulationTaxParameterResolver
                     'article' => $row->source_article,
                     'url' => $row->source_url,
                     'validation_status' => $row->source_validation_status,
+                    'fiscal_acceptance' => is_array($row->fiscal_acceptance) ? $row->fiscal_acceptance : json_decode($row->fiscal_acceptance ?? 'null', true),
                     'version_no' => (int) $row->source_current_version,
                     'valid_from' => (string) $row->source_valid_from,
                     'valid_until' => $row->source_valid_until === null ? null : (string) $row->source_valid_until,
@@ -117,7 +121,11 @@ final class SimulationTaxParameterResolver
             ];
         })->all());
 
-        return $this->resolveAvailableParameters($versions, $component, $periodStart, $periodEnd, $context);
+        $parameters = $this->resolveAvailableParameters($versions, $component, $periodStart, $periodEnd, $context);
+
+        $resolvedIva = array_filter($parameters, fn (array $parameter): bool => $parameter['parameter_code'] === 'IVA_GENERAL_RATE' && $parameter['status'] === 'resolved');
+
+        return $diagnostics ? ['parameters' => $parameters, 'diagnostics' => $resolvedIva !== [] ? [] : (new SimulationIvaDiagnostics)->explain($versions, $periodStart, $periodEnd, $context)] : $parameters;
     }
 
     /**
@@ -126,15 +134,31 @@ final class SimulationTaxParameterResolver
      * @return list<array<string,mixed>>
      */
     public function resolveAvailableParameters(array $versions, string $component, string $periodStart, string $periodEnd, array $context): array
+    {
+        return $this->resolveWithStatus($versions, $component, $periodStart, $periodEnd, $context, 'published');
+    }
+
+    /** Explicit draft preview. Never used by the published-parameter API. */
+    public function resolveDraftForQa(array $versions, string $component, string $periodStart, string $periodEnd, array $context): array
+    {
+        abort_unless(IsolatedQaDatabase::allowsSchemaChanges(), 404);
+
+        return $this->resolveWithStatus($versions, $component, $periodStart, $periodEnd, $context, 'draft');
+    }
+
+    private function resolveWithStatus(array $versions, string $component, string $periodStart, string $periodEnd, array $context, string $requiredStatus): array
     {
         $start = $this->date($periodStart);
         $end = $this->date($periodEnd);
+        if ($end < $start || $start->diff($end)->days > 365) {
+            throw new InvalidArgumentException('Reveja o período de aplicação indicado.');
+        }
         $groups = [];
 
         foreach ($versions as $version) {
             if (($version['component'] ?? null) !== $component
-                || ($version['status'] ?? null) !== 'published'
-                || ($version['source']['validation_status'] ?? null) !== 'validated'
+                || ($version['status'] ?? null) !== $requiredStatus
+                || ! SimulationFiscalSourceAcceptance::eligible($version['source'] ?? [], $version['source_sha256'] ?? null)
                 || (int) ($version['source_version_no'] ?? 0) !== (int) ($version['source']['version_no'] ?? -1)
                 || ! $this->overlaps($version, $start, $end)
                 || ! $this->covers($version['source'], $start) || ! $this->covers($version['source'], $end)
@@ -232,7 +256,7 @@ final class SimulationTaxParameterResolver
                 || ($version['component'] ?? null) !== $component
                 || ($version['scope_key'] ?? null) !== $scopeKey
                 || ! $this->covers($version, $date)
-                || ($version['source']['validation_status'] ?? null) !== 'validated'
+                || ! SimulationFiscalSourceAcceptance::eligible($version['source'] ?? [], $version['source_sha256'] ?? null)
                 || (int) ($version['source_version_no'] ?? 0) !== (int) ($version['source']['version_no'] ?? -1)
                 || ! $this->covers($version['source'], $date)
                 || ! preg_match('/^[a-f0-9]{64}$/D', (string) ($version['source_sha256'] ?? ''))) {
@@ -315,7 +339,7 @@ final class SimulationTaxParameterResolver
     {
         $parsed = DateTimeImmutable::createFromFormat('!Y-m-d', $date);
         if ($parsed === false || $parsed->format('Y-m-d') !== $date) {
-            throw new InvalidArgumentException('Effective date must use YYYY-MM-DD.');
+            throw new InvalidArgumentException('Indique uma data de aplicação válida no formato ano-mês-dia.');
         }
 
         return $parsed;

app/Services/SimulationTaxRuleExpression.php

@@ -95,16 +95,16 @@ final class SimulationTaxRuleExpression
     private function topologicalOrder(array $definition): array
     {
         if (($definition['language'] ?? null) !== self::LANGUAGE || ! is_array($definition['nodes'] ?? null) || ! is_string($definition['result'] ?? null)) {
-            throw new InvalidArgumentException('Unsupported expression definition.');
+            throw new InvalidArgumentException('O formato da expressão não é suportado.');
         }
         $nodes = $definition['nodes'];
         if ($nodes === [] || count($nodes) > 100) {
-            throw new InvalidArgumentException('Expression must contain between 1 and 100 nodes.');
+            throw new InvalidArgumentException('A expressão deve conter entre 1 e 100 elementos.');
         }
 
         foreach ($nodes as $id => $node) {
             if (! is_string($id) || ! preg_match('/^[a-z][a-z0-9_]{0,47}$/', $id) || ! is_array($node) || ! is_string($node['op'] ?? null)) {
-                throw new InvalidArgumentException('Invalid expression node.');
+                throw new InvalidArgumentException('Reveja o elemento indicado na expressão.');
             }
             $op = $node['op'];
             $allowedFields = match ($op) {
@@ -112,40 +112,40 @@ final class SimulationTaxRuleExpression
                 'literal' => ['op', 'value'],
                 'add', 'subtract', 'multiply', 'divide', 'min', 'max' => ['op', 'args'],
                 'round' => ['op', 'args', 'scale', 'mode'],
-                default => throw new InvalidArgumentException('Expression operation is not allowed.'),
+                default => throw new InvalidArgumentException('Esta operação não é suportada na expressão.'),
             };
             if (array_diff(array_keys($node), $allowedFields) !== [] || array_diff($allowedFields, array_keys($node)) !== []) {
-                throw new InvalidArgumentException('Expression node has missing or unsupported fields.');
+                throw new InvalidArgumentException('Há campos em falta ou não suportados num elemento da expressão.');
             }
             if (in_array($op, ['input', 'parameter'], true) && (! is_string($node['key']) || ! preg_match('/^[a-z][a-z0-9_.-]{0,79}$/', $node['key']))) {
-                throw new InvalidArgumentException('Invalid input or parameter key.');
+                throw new InvalidArgumentException('Reveja o identificador da entrada ou do parâmetro.');
             }
             if ($op === 'literal') {
                 $this->number($node['value']);
             }
             if (isset($node['args'])) {
                 if (! is_array($node['args'])) {
-                    throw new InvalidArgumentException('Invalid expression arguments.');
+                    throw new InvalidArgumentException('Reveja os argumentos da expressão.');
                 }
                 $count = count($node['args']);
                 $validCount = $op === 'round' ? $count === 1 : ($op === 'subtract' || $op === 'divide' ? $count === 2 : $count >= 2 && $count <= 20);
                 if (! $validCount || count(array_filter($node['args'], 'is_string')) !== $count) {
-                    throw new InvalidArgumentException('Invalid expression arguments.');
+                    throw new InvalidArgumentException('Reveja os argumentos da expressão.');
                 }
             }
             if ($op === 'round' && (! is_int($node['scale']) || $node['scale'] < 0 || $node['scale'] > 12 || ! isset(self::ROUNDING[$node['mode']]))) {
-                throw new InvalidArgumentException('Invalid explicit rounding configuration.');
+                throw new InvalidArgumentException('Reveja a configuração de arredondamento.');
             }
         }
 
         if (! array_key_exists($definition['result'], $nodes)) {
-            throw new InvalidArgumentException('Expression result references an unknown node.');
+            throw new InvalidArgumentException('O resultado da expressão refere um elemento inexistente.');
         }
         $state = [];
         $order = [];
         $visit = function (string $id) use (&$visit, &$state, &$order, $nodes): void {
             if (($state[$id] ?? 0) === 1) {
-                throw new InvalidArgumentException('Expression dependency graph contains a cycle.');
+                throw new InvalidArgumentException('A expressão contém uma dependência circular.');
             }
             if (($state[$id] ?? 0) === 2) {
                 return;
@@ -153,7 +153,7 @@ final class SimulationTaxRuleExpression
             $state[$id] = 1;
             foreach ($nodes[$id]['args'] ?? [] as $dependency) {
                 if (! is_string($dependency) || ! array_key_exists($dependency, $nodes)) {
-                    throw new InvalidArgumentException('Expression references an unknown node.');
+                    throw new InvalidArgumentException('A expressão refere um elemento inexistente.');
                 }
                 $visit($dependency);
             }
@@ -191,13 +191,13 @@ final class SimulationTaxRuleExpression
         if ($op === 'min' || $op === 'max') {
             return array_reduce(array_slice($args, 1), static fn (BigRational $carry, BigRational $value): BigRational => ($op === 'min' ? $carry->compareTo($value) <= 0 : $carry->compareTo($value) >= 0) ? $carry : $value, $args[0]);
         }
-        throw new InvalidArgumentException('Expression operation is not allowed.');
+        throw new InvalidArgumentException('Esta operação não é suportada na expressão.');
     }
 
     private function number(mixed $value): BigRational
     {
         if ((! is_string($value) && ! is_int($value)) || ! preg_match('/^-?\d+(?:\.\d+)?$/', (string) $value)) {
-            throw new InvalidArgumentException('Numbers must be plain decimal strings or integers.');
+            throw new InvalidArgumentException('Introduza valores numéricos decimais ou inteiros.');
         }
 
         return BigRational::of((string) $value);

app/Services/SimulationTaxRuleGovernance.php

@@ -65,6 +65,8 @@ final class SimulationTaxRuleGovernance
 
         return DB::transaction(function () use ($actor, $id, $version, $action, $evidence): SimulationTaxRuleVersion {
             $this->setContext($actor);
+            // Serialize public admission with publication/suspension, without widening RLS.
+            DB::select('select pg_advisory_xact_lock(261021, hashtext(?))', [$id]);
             $rule = SimulationTaxRuleVersion::query()->lockForUpdate()->findOrFail($id);
             $this->matchVersion($rule, $version);
             $next = ['version_no' => $version + 1];
@@ -78,15 +80,12 @@ final class SimulationTaxRuleGovernance
                     break;
                 case 'review':
                 case 'reject':
-                    abort_unless((int) $rule->author_id !== $actor->id, 403, 'O autor não pode rever a própria regra.');
                     abort_unless($rule->status === 'submitted', 422, 'A regra tem de estar submetida para revisão.');
                     $this->sourceStillValid($rule);
                     $next += ['status' => $action === 'review' ? 'reviewed' : 'rejected', 'reviewer_id' => $actor->id,
                         'review_evidence' => $evidence, 'reviewed_at' => now()];
                     break;
                 case 'approve':
-                    abort_unless((int) $rule->author_id !== $actor->id && (int) $rule->reviewer_id !== $actor->id, 403,
-                        'Autor e revisor não podem aprovar a mesma regra.');
                     abort_unless($rule->status === 'reviewed', 422, 'A regra tem de estar revista antes da aprovação.');
                     $this->sourceStillValid($rule);
                     $next += ['status' => 'approved', 'approver_id' => $actor->id,
@@ -94,9 +93,6 @@ final class SimulationTaxRuleGovernance
                     break;
                 case 'publish':
                     abort_unless($rule->status === 'approved', 422, 'A regra tem de estar aprovada antes da publicação.');
-                    abort_unless((int) $rule->author_id !== $actor->id && (int) $rule->reviewer_id !== $actor->id
-                        && (int) $rule->approver_id !== $actor->id, 403,
-                        'Autor, revisor e aprovador não podem publicar a mesma regra.');
                     $this->sourceStillValid($rule);
                     $this->assertNoPublishedOverlap($rule);
                     $next += ['status' => 'published', 'publisher_id' => $actor->id,
@@ -155,7 +151,11 @@ final class SimulationTaxRuleGovernance
         $source = InvestmentLegalSource::query()->whereKey($data['legal_source_id'])->firstOrFail();
         abort_unless(preg_match('/^[a-f0-9]{64}$/D', (string) $data['source_sha256']) === 1, 422,
             'Indique o SHA-256 do exemplar oficial efectivamente revisto.');
-        abort_unless($source->validation_status === 'validated', 422, 'A fonte jurídica ainda não foi validada.');
+        abort_unless(SimulationFiscalSourceAcceptance::eligible($source->attributesToArray(), $data['source_sha256']), 422,
+            'A fonte ainda não está aceite para este cadastro fiscal.');
+        abort_if(is_array($source->fiscal_acceptance)
+            && ($source->fiscal_acceptance['sha256'] ?? null) !== $data['source_sha256'], 422,
+            'O hash da regra deve corresponder ao exemplar registado na aceitação da fonte fiscal.');
         abort_unless($source->valid_from <= $data['valid_from']
             && ($source->valid_until === null || ($data['valid_until'] !== null && $source->valid_until >= $data['valid_until']))
             && ($data['valid_until'] !== null || $source->valid_until === null), 422,
@@ -167,7 +167,8 @@ final class SimulationTaxRuleGovernance
     private function sourceStillValid(SimulationTaxRuleVersion $rule): void
     {
         $source = InvestmentLegalSource::query()->lockForUpdate()->find($rule->legal_source_id);
-        abort_unless($source !== null && $source->validation_status === 'validated'
+        abort_unless($source !== null && SimulationFiscalSourceAcceptance::eligible($source->attributesToArray(), $rule->source_sha256)
+            && (! is_array($source->fiscal_acceptance) || ($source->fiscal_acceptance['sha256'] ?? null) === $rule->source_sha256)
             && (int) $source->version_no === (int) $rule->source_version_no
             && $source->valid_from <= $rule->valid_from->format('Y-m-d')
             && ($source->valid_until === null || ($rule->valid_until !== null && $source->valid_until >= $rule->valid_until->format('Y-m-d')))

app/Services/TerritoryGeometry.php

@@ -14,16 +14,31 @@ final class TerritoryGeometry
         abort_unless($geography->references($management)->where('id', $id)->exists(), 404);
         $path = $geography->path($id, $management);
         $ids = array_map(fn ($node) => $node->id, $path);
+        $approved = app(ApprovedAdministrativeBoundaries::class);
         $rows = DB::table('geo_geometries as g')->join('geo_locations as l', 'l.id', '=', 'g.geo_location_id')
             ->whereIn('g.geo_location_id', $ids)->whereNull('g.deleted_at')->whereNull('l.deleted_at')
-            ->whereIn('g.data_classification', $management ? ['internal', 'public'] : ['public'])
+            ->where(function ($query) use ($management, $approved) {
+                $query->where('g.data_classification', 'public');
+                $query->orWhere(function ($internal) use ($management, $approved) {
+                    $internal->where('g.data_classification', 'internal');
+                    if (! $management) {
+                        $internal->whereIn('g.id', array_keys($approved->snapshots()));
+                    }
+                });
+            })
             ->whereRaw("g.properties->>'purpose' = 'administrative_boundary'")
             ->whereIn('g.geometry_type', ['polygon', 'multipolygon'])
             ->whereRaw('ST_IsValid(g.geom) AND NOT ST_IsEmpty(g.geom) AND ST_SRID(g.geom)=4326')
             ->orderBy('g.geo_location_id')->orderBy('g.id')->limit(101)
             ->get(['g.id', 'g.geo_location_id', 'l.name', 'l.location_type', 'g.properties', 'g.data_classification',
-                DB::raw('ST_AsGeoJSON(ST_SimplifyPreserveTopology(g.geom,0.0001),6) as geometry')]);
-        $areas = $rows->take(100)->map(function ($row) use ($id) {
+                DB::raw('ST_AsGeoJSON(ST_SimplifyPreserveTopology(g.geom,0.0001),6) as geometry'),
+                DB::raw("encode(sha256(ST_AsEWKB(g.geom)),'hex') as geometry_sha256"),
+                DB::raw("encode(sha256(convert_to(g.properties::text,'UTF8')),'hex') as properties_sha256")]);
+        if (! $management) {
+            $rows = $rows->filter(fn ($row) => $row->data_classification === 'public'
+                || $approved->allows($row->id, $row->geo_location_id, $row->geometry_sha256, $row->properties_sha256))->values();
+        }
+        $areas = $rows->take(100)->map(function ($row) use ($id, $management) {
             $source = json_decode($row->properties, true, 512, JSON_THROW_ON_ERROR);
 
             return ['id' => $row->id, 'territory_id' => $row->geo_location_id, 'location_type' => $row->location_type,
@@ -31,7 +46,7 @@ final class TerritoryGeometry
                 'title' => 'Limite administrativo: '.$row->name, 'purpose' => 'administrative_boundary',
                 'source_reference' => $source['authority'] ?? null, 'source_date' => $source['source_version'] ?? null,
                 'source_url' => $source['source_url'] ?? null, 'source_sha256' => $source['source_sha256'] ?? null,
-                'data_classification' => $row->data_classification, 'legal_currentness' => $source['legal_currentness'] ?? 'not_determined', 'url' => ''];
+                'data_classification' => $management ? $row->data_classification : 'public', 'legal_currentness' => $source['legal_currentness'] ?? 'not_determined', 'url' => ''];
         })->all();
 
         return ['territory_id' => $id, 'territory_registered' => true,

app/Services/TerritoryGeometryImport.php

@@ -20,7 +20,7 @@ class TerritoryGeometryImport
 
     private function guard(User $actor, bool $write = false): void
     {
-        abort_unless($actor->can('manage-portal'), 403);
+        abort_unless($actor->can('manage-portal') || app(ScopedPortalAdministration::class)->administrative($actor), 403);
         abort_unless(config('geometry-import.enabled'), 503, 'Importação cartográfica não disponibilizada.');
         if (! $write) {
             return;

app/Services/VirtualDesk.php

@@ -170,11 +170,11 @@ class VirtualDesk
         });
     }
 
-    public function createRequest(User $actor, string $caseId, string $serviceId, string $clientKey): \stdClass
+    public function createRequest(User $actor, string $caseId, string $serviceId, string $clientKey, ?string $opportunity = null): \stdClass
     {
         abort_unless(Str::isUuid($serviceId) && Str::isUuid($clientKey), 422);
 
-        return DB::transaction(function () use ($actor, $caseId, $serviceId, $clientKey) {
+        return DB::transaction(function () use ($actor, $caseId, $serviceId, $clientKey, $opportunity) {
             $case = $this->case($actor, $caseId, true, true);
             abort_if($case->closed_at, 409, 'Dossier encerrado.');
             $service = DB::table('desk_service_versions')->where('id', $serviceId)->where('status', 'published')->first();
@@ -197,7 +197,10 @@ class VirtualDesk
                 $this->event($case, $actor, 'request_prefill_prepared', ['draft_id' => $draft->id, 'draft_version' => $draft->version_no, 'snapshot_sha256' => $draft->snapshot_sha256, 'fields' => ['title', 'description']]);
             }
             $context = app(InvestorContext::class)->state($case);
-            $mapped = app(InvestorContext::class)->prefill($context)['desk'];
+            if (count($context['opportunity_choices'] ?? []) > 1 && !$opportunity) $payload['description'] = '';
+            $mapped = app(InvestorContext::class)->prefill($context, $opportunity)['desk'];
+            if ($opportunity) $payload['context_opportunity'] = $opportunity;
+            $payload = app(InvestmentConsumerScope::class)->bind($actor, $caseId, $payload);
             $serviceFields = json_decode($service->definition, true)['fields'];
             foreach (['territory_id' => 'territory_id', 'location_source' => 'location_source', 'title' => 'title', 'description' => 'description', 'sector' => 'sector', 'province_id' => 'province_id', 'district_id' => 'district_id', 'admin_post_id' => 'admin_post_id', 'locality_id' => 'locality_id'] as $field => $source) {
                 if (isset($serviceFields[$field],$mapped[$source]) && (empty($payload[$field]) || in_array($field, ['title', 'description'], true) && $context['revision'] > 0)) {
@@ -230,6 +233,12 @@ class VirtualDesk
             $draft = SimulationFormDraft::query()->whereKey($draft->id)->lockForUpdate()->firstOrFail();
         }
         $economic = SimulationFormDraft::decryptSnapshot($draft->economic_snapshot);
+        $contextChoices = app(InvestorContext::class)->state($case)['opportunity_choices'] ?? [];
+        if (count($contextChoices) > 1) {
+            $snapshot = json_decode($economic['context_applicability_snapshot'] ?? '{}', true);
+            $draftChoices = $snapshot['opportunity_choices'] ?? [];
+            if (count($draftChoices) !== 1 || ($draftChoices[0]['opportunity']['key'] ?? null) !== ($payload['context_opportunity'] ?? null)) return null;
+        }
         $description = (string) ($economic['project_summary'] ?? '');
         if (trim($description) === '') {
             return null;
@@ -250,7 +259,10 @@ class VirtualDesk
      * @return array<string,mixed> */
     public function validateFields(array $payload, array $definition, bool $submitting): array
     {
-        $rules = ['payload' => ['required', 'array:'.implode(',', [...array_keys($definition['fields']), 'country', 'declared_origin_country_code'])],
+        $rules = ['payload' => ['required', 'array:'.implode(',', [...array_keys($definition['fields']), 'country', 'declared_origin_country_code', 'context_reuse', 'context_opportunity', 'context_opportunity_snapshot'])],
+            'payload.context_opportunity' => ['nullable', 'string', 'max:100'],
+            'payload.context_opportunity_snapshot' => ['nullable', 'string', 'max:200000'],
+            'payload.context_reuse' => ['nullable', 'string', 'max:10000'],
             'payload.country' => ['nullable', 'string', 'max:100', app(CountryCatalogue::class)->legacyCountryRule()],
             'payload.declared_origin_country_code' => ['nullable', 'string', app(CountryCatalogue::class)->rule()]];
         foreach ($definition['fields'] as $key => $field) {
@@ -333,6 +345,9 @@ class VirtualDesk
                 }
             }
             $payload = $this->validateFields($data['payload'], $this->definition($request), $submit);
+            if ($request->status !== 'returned' || in_array('context_opportunity', json_decode($request->editable_fields ?? '[]', true), true)) {
+                $payload = app(InvestmentConsumerScope::class)->bind($actor, $request->case_id, $payload, $submit);
+            }
             if ($request->status === 'returned') {
                 $editable = json_decode($request->editable_fields ?? '[]', true);
                 $previous = $this->decode($request->payload);
@@ -388,7 +403,7 @@ class VirtualDesk
                 abort_if($this->owns($actor, $case, false), 403, 'O proponente não pode analisar ou decidir o seu próprio pedido.');
                 abort_unless($actor->can('manage-portal') || (int) $request->analyst_id === $actor->id, 403);
                 if (in_array($data['status'], ['accepted', 'rejected', 'closed'], true)) {
-                    abort_unless(app(ScopedPortalAdministration::class)->deskDecision($actor,$request), 403);
+                    abort_unless(app(ScopedPortalAdministration::class)->deskDecision($actor, $request), 403);
                 }
                 abort_unless(in_array($data['status'], config('virtual-desk.transitions.'.$request->status, []), true), 409, 'Transição inválida.');
             }
@@ -412,13 +427,13 @@ class VirtualDesk
 
         return DB::transaction(function () use ($actor, $id, $data) {
             $case = $this->case($actor, $id, false, true);
-            abort_unless($this->owns($actor, $case) || app(ScopedPortalAdministration::class)->deskCaseDecision($actor,$case->id), 403);
+            abort_unless($this->owns($actor, $case) || app(ScopedPortalAdministration::class)->deskCaseDecision($actor, $case->id), 403);
             abort_unless((int) $case->version === (int) $data['version'], 409);
             $workflow = json_decode($case->workflow, true, 512, JSON_THROW_ON_ERROR);
             $current = $workflow[$data['stage']];
             $decision = in_array($data['status'], ['completed', 'not_applicable'], true);
             if ($decision) {
-                abort_unless(app(ScopedPortalAdministration::class)->deskCaseDecision($actor,$case->id) && ! $this->owns($actor, $case, false), 403, 'Conclusão documental exige revisão interna por outra pessoa autorizada.');
+                abort_unless(app(ScopedPortalAdministration::class)->deskCaseDecision($actor, $case->id) && ! $this->owns($actor, $case, false), 403, 'Conclusão documental exige revisão interna por outra pessoa autorizada.');
                 abort_unless(trim($data['evidence'] ?? '') !== '', 422, 'Identifique a evidência documental.');
                 foreach ($current['dependencies'] as $dependency) {
                     abort_unless(in_array($workflow[$dependency]['status'], ['completed', 'not_applicable'], true) || (($data['exception'] ?? false) && ($data['document_id'] ?? null)), 422, 'Dependência '.$dependency.' pendente; uma exceção exige evidência própria.');

bootstrap/app.php

@@ -1,6 +1,7 @@
 <?php
 
 use App\Http\Middleware\AuditProfileDecision;
+use App\Http\Middleware\EnsureHomologationAccess;
 use App\Http\Middleware\EnsureSimulationRecoveryCookie;
 use App\Http\Middleware\HandleAppearance;
 use App\Http\Middleware\HandleInertiaRequests;
@@ -30,7 +31,7 @@ return Application::configure(basePath: dirname(__DIR__))
         $middleware->encryptCookies(except: ['appearance', 'sidebar_state', EnsureSimulationRecoveryCookie::NAME]);
 
         $middleware->web(append: [
-            \App\Http\Middleware\EnsureHomologationAccess::class,
+            EnsureHomologationAccess::class,
             PortalProfileSession::class,
             ProtectPrivilegedIdentity::class,
             AuditProfileDecision::class,
@@ -68,6 +69,28 @@ return Application::configure(basePath: dirname(__DIR__))
             fn (Request $request) => $request->is('api/*') || $request->expectsJson(),
         );
         $exceptions->respond(function (Response $response, Throwable $exception, Request $request): Response {
+            if (($request->is('api/*') || $request->expectsJson()) && $response->getStatusCode() >= 400) {
+                $body = json_decode((string) $response->getContent(), true);
+                $genericMessages = [
+                    'Not Found' => 'O registo não foi encontrado ou não está acessível nesta conta.',
+                    'Not found.' => 'O registo não foi encontrado ou não está acessível nesta conta.',
+                    'Forbidden' => 'Esta conta não tem acesso a esta operação.',
+                    'Forbidden.' => 'Esta conta não tem acesso a esta operação.',
+                    'Unauthenticated.' => 'Entre na sua conta para continuar esta operação.',
+                    'CSRF token mismatch.' => 'A sessão expirou. Entre novamente antes de repetir a operação.',
+                    'Too Many Attempts.' => 'Foram feitas várias tentativas. Aguarde um pouco e tente novamente.',
+                    'Server Error' => 'Não foi possível concluir a operação. Tente novamente.',
+                ];
+                if (is_array($body) && is_string($body['message'] ?? null) && isset($genericMessages[$body['message']])) {
+                    $body['message'] = $genericMessages[$body['message']];
+                    $response->setContent(json_encode($body, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR));
+                } elseif (is_array($body) && is_string($body['message'] ?? null)
+                    && $response->getStatusCode() === 404 && str_starts_with($body['message'], 'The route ')
+                    && str_ends_with($body['message'], ' could not be found.')) {
+                    $body['message'] = $genericMessages['Not Found'];
+                    $response->setContent(json_encode($body, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR));
+                }
+            }
             if ($request->is('api/*')) {
                 $response->headers->set(
                     'X-Correlation-ID',

config/app.php

@@ -78,7 +78,7 @@ return [
     |
     */
 
-    'locale' => env('APP_LOCALE', 'en'),
+    'locale' => env('APP_LOCALE', 'pt'),
 
     'fallback_locale' => env('APP_FALLBACK_LOCALE', 'en'),
 

config/investment_corridors.php

@@ -0,0 +1,13 @@
+<?php
+
+// Functional configuration expressly defined by Tempo, 23/10/2026.
+// Codes identify the existing national territorial registry; no geometry is inferred.
+return [
+    'pemba-lichinga' => ['name' => 'Corredor de Pemba–Lichinga', 'provinces' => ['02', '01']],
+    'nacala' => ['name' => 'Corredor de Nacala', 'provinces' => ['03']],
+    'vale-zambeze' => ['name' => 'Corredor do Vale do Zambeze', 'provinces' => ['05', '04']],
+    'beira' => ['name' => 'Corredor da Beira', 'provinces' => ['07', '06']],
+    'limpopo' => ['name' => 'Corredor do Limpopo', 'provinces' => ['09']],
+    // Tempo's final clarification: both Maputo Province and Maputo City.
+    'maputo' => ['name' => 'Corredor de Maputo', 'provinces' => ['10', '11']],
+];

config/investor-path.php

@@ -2,6 +2,7 @@
 
 return [
     // Explicit opt-in after authenticated installation; never infer activation from schema/ready.
+    'private_preparation' => env('PRIVATE_INVESTMENT_PREPARATION_ENABLED', false),
     'enabled' => env('INVESTOR_PATH_ENABLED', false),
     'definition_id' => '61000919-0000-4000-8000-000000000001',
 ];

config/legacy_editorial_resources.json

@@ -0,0 +1,170 @@
+[
+  {
+    "external_id": "legacy-tempo-post-62413-20170626",
+    "sha256": "b471c1afd7235f359acdcc16a93088f77e1f988706c8d3c4d4f11c5d560aea47",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-73945-20170731",
+    "sha256": "2aa0ce0eb305bfdf93e390a978d3694d0fbc0129034077b68cebce418f878415",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-76474-20170808",
+    "sha256": "8f769aec4715449d056c8c25294060b2ff290ec0893c28e9bdcc4e8092fc75f5",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-62414-20170626",
+    "sha256": "a040c0b7cb95dd7f053f4d13662dd58b2b06453b6fa61a2d531d0257a8db8c17",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-62418-20170626",
+    "sha256": "e8ccafa68f0d1aa80f2e41d9e09f7b13e7c653a8472a731798cfd5e04ce2963e",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-75002-20170804",
+    "sha256": "7b6fbd998be2b47b96e9a4724560c192c502709fa308d6590c0797ddcdb10544",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-73246-20170728",
+    "sha256": "430ee8674c71104fc126bed2911d676f150ac623857a1ada75662987fd9ac390",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-77232-20170811",
+    "sha256": "27544d3127803b7495bef9fd633147d0225d8c31816c4d59ed05a2edd59de070",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-62416-20170626",
+    "sha256": "ac575ce340571192552c89b63f0bd62a84dbc47828e6930133af5ff70e249319",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-62929-20170627",
+    "sha256": "488017b062c6760659d9147b7f12aea4afd8d824121adb9462e2c7a2ae58437b",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-62649-20170626",
+    "sha256": "38a858713472759a2d20a308bdd9d8afa9cfb76dcaf8d11ca709e89261573e42",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-62739-20170626",
+    "sha256": "5870fc0fad9bb7af537b7b1468151cde138b1b886ce846c7be25647b630245dd",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-62854-20170627",
+    "sha256": "44b1ba9d593bb625cf53de8909e78eb0b3129742c3ec9d58ec68c984e8930bce",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-63128-20170627",
+    "sha256": "74be8f29e5053f53ab1a39a2f63208145c30f23357ca6d78b637dd02bf9c1fb4",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-63181-20170627",
+    "sha256": "3d0f9ac14d36156d8178e33f8616d6406f31ea4cd69c8308cbf4227586d7ccb3",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-63146-20170627",
+    "sha256": "542353466cc6d82b651619c495f138b0576a4be41d21aad194ae2005050cb1bc",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-62688-20170626",
+    "sha256": "a210a789b06d425822f4124f74226a2b27246c086c5ec5f041f1b2237d7c2b65",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-63248-20170628",
+    "sha256": "6c30e61197b8568332af6d9b19bbba7ad8665b3873bb031a8c8aedd41536b060",
+    "kind": "historico_noticioso",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173220-20260616",
+    "sha256": "5b76c3d84dcf7f9a489686d90e3857ae6536705c918e841310bb42b354e80976",
+    "kind": "setorial",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173222-20260616",
+    "sha256": "e64d7063d1ac4dda028c97e1ba64938d2a9e426a0b630c57ee5df52a41312cc7",
+    "kind": "setorial",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173482-20260915",
+    "sha256": "6f888e133a779c719073246f89bcae150198e5897c0e7d9b7ba75f54c54a7830",
+    "kind": "trabalho_domestico",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173484-20260915",
+    "sha256": "297df455a9c6fd1f0ab7ca7bbe124ce483c86fe55be26baa695f03089b3ac049",
+    "kind": "trabalho_domestico",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173478-20260915",
+    "sha256": "d4e320ed99dd9d53d205e47932f73651976d43081d5d39f2bfc2996901408644",
+    "kind": "trabalho_domestico",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173480-20260915",
+    "sha256": "c3ee6401eda5b582c61969b5e3b74fdf26ef34ca481b1aca8c4c309d845147ae",
+    "kind": "trabalho_domestico",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173476-20260915",
+    "sha256": "72fbf28391db4804e0637b64e7f59e9fa597812a2681b4562dc3d6dfb4093a30",
+    "kind": "trabalho_domestico",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173470-20260915",
+    "sha256": "26feeae6b8d04972c7a64ee360583cccdcaeb4b0d8795fd7bc2fd3c38866cc19",
+    "kind": "trabalho_domestico",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173474-20260915",
+    "sha256": "9fa741a17b746bfa2f3ce7b6ce1d2bb34d3a35d3b58330b0554f9e0a6844f049",
+    "kind": "trabalho_domestico",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  },
+  {
+    "external_id": "legacy-tempo-post-173463-20260915",
+    "sha256": "4f34b7bac4b3030c0614844d379f6e3cfad1b7f6ea3db575a58c33ae033b0e73",
+    "kind": "trabalho_domestico",
+    "original_image_sha256": "28f41f12e10ab34545d8e432f6e8c74f86960e17e0c4a9956f514bcde4881eaa"
+  }
+]

config/portal.php

@@ -23,7 +23,7 @@ return [
     'opportunity_other_qa_subtypes' => [],
     'operator_name' => env('PORTAL_OPERATOR_NAME'),
     // Tempo, 19/10/2026: institutional contact; commercial department remains separate.
-    'institutional_contact_email' => env('PORTAL_INSTITUTIONAL_CONTACT_EMAIL', 'info@tempo.co.mz'),
+    'institutional_contact_email' => env('PORTAL_INSTITUTIONAL_CONTACT_EMAIL', 'comercial@tempo.co.mz'),
     'support' => [
         'email' => env('PORTAL_SUPPORT_EMAIL'),
         'phone' => env('PORTAL_SUPPORT_PHONE'),

config/procurement.php

@@ -0,0 +1,7 @@
+<?php
+
+return [
+    'enabled' => (bool) env('PROCUREMENT_ENABLED', false),
+    'regimes' => ['state' => 'Contratação pública do Estado', 'external' => 'Financiamento externo', 'private' => 'Concurso privado', 'other' => 'Outro regime documentado'],
+    'acts' => ['initial' => 'Anúncio inicial', 'clarification' => 'Esclarecimento', 'correction' => 'Rectificação', 'extension' => 'Prorrogação', 'award' => 'Resultado / adjudicação', 'cancellation' => 'Cancelamento', 'other' => 'Outro acto'],
+];

config/simulation-fiscal-consumer.php

@@ -0,0 +1,8 @@
+<?php
+
+return [
+    // Publication and consumer exposure are separate Tempo decisions.
+    'enabled' => env('INVESTMOZ_IVA_CONSUMER_ENABLED', false),
+    'rule_id' => env('INVESTMOZ_IVA_CONSUMER_RULE_ID'),
+    'rule_version' => (int) env('INVESTMOZ_IVA_CONSUMER_RULE_VERSION', 0),
+];

config/simulation-tax-governance.php

@@ -1,8 +1,9 @@
 <?php
 
 return [
-    // These lists are deliberately empty by default. A portal manager and MFA are
-    // also required; governance roles never activate rules in the calculation engine.
+    // Optional specific assignments. Existing authorised administration can maintain
+    // fiscal parameters with MFA, without four people or four email designations.
+    // Rule publication never activates the calculation consumer by itself.
     'editors' => array_values(array_filter(array_map('strtolower', array_map('trim', explode(',', (string) env('INVESTMOZ_TAX_RULE_EDITORS', '')))))),
     'reviewers' => array_values(array_filter(array_map('strtolower', array_map('trim', explode(',', (string) env('INVESTMOZ_TAX_RULE_REVIEWERS', '')))))),
     'approvers' => array_values(array_filter(array_map('strtolower', array_map('trim', explode(',', (string) env('INVESTMOZ_TAX_RULE_APPROVERS', '')))))),

database/data/corridor-investment-opportunities.json

@@ -0,0 +1,181 @@
+{
+  "source": "investimentos nos corredores.docx",
+  "source_sha256": "1473b06c48aa234e771660e3f2a51b9d2e4e1943bd52d878e0ae854ee6657055",
+  "introduction": "Os corredores de desenvolvimento integram cadeias de valor prioritárias que podem ser apresentadas no portal InvesteMoz como oportunidades concretas de investimento na produção, transformação, logística e comercialização. Para cada corredor, são destacadas abaixo as oportunidades associadas aos produtos com maior potencial.",
+  "segments": [
+    "Produção primária e fornecimento de insumos",
+    "Processamento e transformação agro-industrial",
+    "Armazenagem, cadeia de frio e logística",
+    "Embalagem, distribuição, comercialização e exportação",
+    "Infraestruturas e serviços de apoio às cadeias de valor"
+  ],
+  "groups": [
+    {
+      "name": "Corredor de Pemba–Lichinga",
+      "opportunities": [
+        {
+          "chain": "Batata, trigo, feijão, milho e soja",
+          "description": "Produção comercial, armazenamento e processamento de batata, trigo, feijão, milho e soja."
+        },
+        {
+          "chain": "Algodão",
+          "description": "Descaroçamento, fiação e produção de óleo e derivados de algodão."
+        },
+        {
+          "chain": "Sésamo",
+          "description": "Limpeza, prensagem, embalagem e exportação de sésamo."
+        },
+        {
+          "chain": "Florestas",
+          "description": "Viveiros, plantações comerciais, madeira processada e produtos florestais sustentáveis."
+        },
+        {
+          "chain": "Avicultura",
+          "description": "Produção de rações, incubação, criação, abate e cadeia de frio para avicultura."
+        }
+      ]
+    },
+    {
+      "name": "Corredor de Nacala",
+      "opportunities": [
+        {
+          "chain": "Mandioca",
+          "description": "Produção e transformação de mandioca em farinha, amido e outros derivados."
+        },
+        {
+          "chain": "Milho, amendoim e sésamo",
+          "description": "Produção, armazenagem e processamento de milho, amendoim e sésamo."
+        },
+        {
+          "chain": "Algodão",
+          "description": "Descaroçamento e transformação de algodão."
+        },
+        {
+          "chain": "Frutas e caju",
+          "description": "Pomares, processamento, embalagem e exportação de frutas e caju."
+        },
+        {
+          "chain": "Florestas",
+          "description": "Silvicultura comercial, madeira processada e produtos florestais."
+        },
+        {
+          "chain": "Avicultura",
+          "description": "Produção de rações, criação, abate e distribuição de produtos avícolas."
+        }
+      ]
+    },
+    {
+      "name": "Corredor do Vale do Zambeze",
+      "opportunities": [
+        {
+          "chain": "Arroz",
+          "description": "Produção irrigada, moagem, embalagem e comercialização de arroz."
+        },
+        {
+          "chain": "Milho e batata",
+          "description": "Produção, secagem, armazenagem e transformação de milho e batata."
+        },
+        {
+          "chain": "Sésamo",
+          "description": "Limpeza, prensagem e exportação de sésamo."
+        },
+        {
+          "chain": "Algodão",
+          "description": "Descaroçamento e transformação de algodão."
+        },
+        {
+          "chain": "Avicultura",
+          "description": "Produção de rações, incubação, criação e abate de aves."
+        },
+        {
+          "chain": "Bovinos e caprinos",
+          "description": "Criação, engorda, abate, processamento de carne e cadeia de frio para bovinos e caprinos."
+        }
+      ]
+    },
+    {
+      "name": "Corredor da Beira",
+      "opportunities": [
+        {
+          "chain": "Milho, trigo e arroz",
+          "description": "Produção, silos, moagem e processamento de milho, trigo e arroz."
+        },
+        {
+          "chain": "Soja",
+          "description": "Esmagamento de soja, produção de óleo vegetal e fabrico de rações."
+        },
+        {
+          "chain": "Hortícolas",
+          "description": "Produção irrigada, conservação, embalagem e distribuição de hortícolas."
+        },
+        {
+          "chain": "Sésamo",
+          "description": "Limpeza, prensagem e exportação de sésamo."
+        },
+        {
+          "chain": "Açúcar",
+          "description": "Produção e refinação de açúcar e aproveitamento de subprodutos."
+        },
+        {
+          "chain": "Florestas",
+          "description": "Plantações comerciais, processamento de madeira e produtos florestais."
+        },
+        {
+          "chain": "Carne bovina",
+          "description": "Criação, engorda, abate, processamento e cadeia de frio para carne bovina."
+        }
+      ]
+    },
+    {
+      "name": "Corredor do Limpopo",
+      "opportunities": [
+        {
+          "chain": "Arroz",
+          "description": "Produção irrigada, moagem, embalagem e comercialização de arroz."
+        },
+        {
+          "chain": "Hortícolas",
+          "description": "Produção em estufas e campo aberto, conservação, embalagem e distribuição de hortícolas."
+        },
+        {
+          "chain": "Carne vermelha",
+          "description": "Criação, engorda, abate, processamento e cadeia de frio para carne vermelha."
+        },
+        {
+          "chain": "Avicultura",
+          "description": "Produção de rações, incubação, criação, abate e distribuição de produtos avícolas."
+        },
+        {
+          "chain": "Infraestruturas e serviços de apoio",
+          "description": "Infraestruturas de irrigação, armazenagem, transporte refrigerado e centros de comercialização."
+        }
+      ]
+    },
+    {
+      "name": "Corredor de Maputo",
+      "opportunities": [
+        {
+          "chain": "Arroz",
+          "description": "Produção irrigada, moagem, embalagem e fornecimento de arroz aos mercados urbanos e regionais."
+        },
+        {
+          "chain": "Hortícolas",
+          "description": "Produção, conservação, embalagem, transformação e distribuição de hortícolas."
+        },
+        {
+          "chain": "Carne vermelha",
+          "description": "Criação, engorda, abate, processamento, distribuição e exportação regional de carne vermelha."
+        },
+        {
+          "chain": "Avicultura",
+          "description": "Produção de rações, incubação, criação, abate e comercialização de produtos avícolas."
+        },
+        {
+          "chain": "Infraestruturas e serviços de apoio",
+          "description": "Plataformas logísticas, centros de distribuição, cadeia de frio e serviços de exportação."
+        }
+      ]
+    }
+  ],
+  "sector": "Agronegócio"
+}

database/migrations/2026_10_21_130000_correct_fiscal_maintenance_actor_constraints.php

@@ -0,0 +1,68 @@
+<?php
+
+use App\Support\IsolatedQaDatabase;
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Support\Facades\DB;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        if (! IsolatedQaDatabase::allowsSchemaChanges()) {
+            throw new LogicException('Ensaie esta correcção apenas numa base QA isolada. A aplicação no destino exige decisão, backup/restauro e acção autenticada.');
+        }
+
+        // Only fiscal rule maintenance changes. Opportunity/zone workflow checks remain intact.
+        DB::statement('ALTER TABLE simulation_tax_rule_versions DROP CONSTRAINT tax_rule_stage_evidence_check, DROP CONSTRAINT tax_rule_approval_check, DROP CONSTRAINT tax_rule_publication_check');
+        DB::statement("ALTER TABLE simulation_tax_rule_versions
+            ADD CONSTRAINT tax_rule_stage_evidence_check CHECK(status NOT IN ('reviewed','rejected','approved','published','suspended','archived') OR (reviewer_id IS NOT NULL AND submitted_at IS NOT NULL AND reviewed_at IS NOT NULL AND length(trim(review_evidence))>=20)),
+            ADD CONSTRAINT tax_rule_approval_check CHECK(status NOT IN ('approved','published','suspended','archived') OR (approver_id IS NOT NULL AND approved_at IS NOT NULL AND length(trim(approval_evidence))>=20)),
+            ADD CONSTRAINT tax_rule_publication_check CHECK(status NOT IN ('published','suspended','archived') OR (publisher_id IS NOT NULL AND published_at IS NOT NULL AND length(trim(publication_evidence))>=20))");
+
+        DB::statement('ALTER TABLE investment_legal_sources ADD COLUMN fiscal_acceptance jsonb NULL');
+        DB::statement("ALTER TABLE investment_legal_sources ADD CONSTRAINT investment_legal_source_fiscal_acceptance_check CHECK (
+            fiscal_acceptance IS NULL OR COALESCE((
+                fiscal_acceptance->>'scope'='fiscal_parameters' AND
+                fiscal_acceptance->>'basis'='Tempo-official-sources-20261008' AND
+                fiscal_acceptance->>'responsible_user_id'=owner_id::text AND
+                fiscal_acceptance->>'sha256' ~ '^[a-f0-9]{64}$' AND
+                fiscal_acceptance->>'legal_opinion'='false' AND fiscal_acceptance->>'independent_review'='false' AND
+                length(trim(fiscal_acceptance->>'citation'))>=10 AND
+                length(trim(fiscal_acceptance->>'official_origin'))>=10
+            ), false))");
+        DB::statement('DROP POLICY simulation_tax_rule_versions_public_read ON simulation_tax_rule_versions');
+        DB::statement("CREATE POLICY simulation_tax_rule_versions_public_read ON simulation_tax_rule_versions FOR SELECT USING (
+            status='published' AND EXISTS (SELECT 1 FROM investment_legal_sources source
+                WHERE source.id=simulation_tax_rule_versions.legal_source_id
+                AND (source.validation_status='validated' OR (source.validation_status='pending'
+                    AND source.fiscal_acceptance->>'scope'='fiscal_parameters'
+                    AND source.fiscal_acceptance->>'basis'='Tempo-official-sources-20261008'
+                    AND source.fiscal_acceptance->>'sha256'=simulation_tax_rule_versions.source_sha256))
+                AND source.version_no=simulation_tax_rule_versions.source_version_no
+                AND source.valid_from<=simulation_tax_rule_versions.valid_from
+                AND (source.valid_until IS NULL OR (simulation_tax_rule_versions.valid_until IS NOT NULL AND source.valid_until>=simulation_tax_rule_versions.valid_until))
+                AND (simulation_tax_rule_versions.valid_until IS NOT NULL OR source.valid_until IS NULL)))");
+
+    }
+
+    public function down(): void
+    {
+        if (! IsolatedQaDatabase::allowsSchemaChanges()) {
+            throw new LogicException('Reversão permitida apenas em QA isolado.');
+        }
+        $used = DB::table('investment_legal_sources')->whereNotNull('fiscal_acceptance')->exists()
+            || DB::table('simulation_tax_rule_versions')->whereRaw('reviewer_id=author_id OR approver_id=author_id OR approver_id=reviewer_id OR publisher_id=author_id OR publisher_id=reviewer_id OR publisher_id=approver_id')->exists();
+        if ($used) {
+            throw new LogicException('Reversão recusada: conservar os cadastros e históricos legítimos; desactivar novas execuções em vez de apagar registos.');
+        }
+        DB::statement('ALTER TABLE simulation_tax_rule_versions DROP CONSTRAINT tax_rule_stage_evidence_check, DROP CONSTRAINT tax_rule_approval_check, DROP CONSTRAINT tax_rule_publication_check');
+        DB::statement("ALTER TABLE simulation_tax_rule_versions
+            ADD CONSTRAINT tax_rule_stage_evidence_check CHECK(status NOT IN ('reviewed','rejected','approved','published','suspended','archived') OR (reviewer_id IS NOT NULL AND reviewer_id<>author_id AND submitted_at IS NOT NULL AND reviewed_at IS NOT NULL AND length(trim(review_evidence))>=20)),
+            ADD CONSTRAINT tax_rule_approval_check CHECK(status NOT IN ('approved','published','suspended','archived') OR (approver_id IS NOT NULL AND approver_id<>author_id AND approver_id<>reviewer_id AND approved_at IS NOT NULL AND length(trim(approval_evidence))>=20)),
+            ADD CONSTRAINT tax_rule_publication_check CHECK(status NOT IN ('published','suspended','archived') OR (publisher_id IS NOT NULL AND publisher_id<>author_id AND publisher_id<>reviewer_id AND publisher_id<>approver_id AND published_at IS NOT NULL AND length(trim(publication_evidence))>=20))");
+        DB::statement('DROP POLICY simulation_tax_rule_versions_public_read ON simulation_tax_rule_versions');
+        (require __DIR__.'/2026_10_03_190000_allow_public_read_of_published_tax_parameters.php')->up();
+        DB::statement('ALTER TABLE investment_legal_sources DROP CONSTRAINT investment_legal_source_fiscal_acceptance_check');
+        DB::statement('ALTER TABLE investment_legal_sources DROP COLUMN fiscal_acceptance');
+    }
+};

database/migrations/2026_10_22_230000_create_portal_tenders.php

@@ -0,0 +1,50 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    public function up(): void
+    {
+        Schema::create('portal_tenders', function (Blueprint $t) {
+            $t->uuid('id')->primary();
+            $t->jsonb('draft');
+            $t->unsignedInteger('version')->default(1);
+            $t->uuid('published_version_id')->nullable();
+            $t->foreignId('created_by')->constrained('users')->restrictOnDelete();
+            $t->timestampsTz();
+        });
+        Schema::create('portal_tender_versions', function (Blueprint $t) {
+            $t->uuid('id')->primary();
+            $t->foreignUuid('tender_id')->constrained('portal_tenders')->restrictOnDelete();
+            $t->unsignedInteger('version');
+            $t->string('act', 24);
+            $t->jsonb('payload');
+            $t->text('reason');
+            $t->foreignId('actor_id')->constrained('users')->restrictOnDelete();
+            $t->timestampTz('published_at')->nullable();
+            $t->timestampTz('created_at')->useCurrent();
+            $t->unique(['tender_id', 'version']);
+        });
+        Schema::create('portal_tender_watches', function (Blueprint $t) {
+            $t->foreignUuid('tender_id')->constrained('portal_tenders')->restrictOnDelete();
+            $t->foreignId('user_id')->constrained('users')->restrictOnDelete();
+            $t->uuid('seen_version_id')->nullable();
+            $t->timestampsTz();
+            $t->primary(['tender_id', 'user_id']);
+        });
+    }
+
+    public function down(): void
+    {
+        if (DB::table('portal_tenders')->exists()) {
+            throw new RuntimeException('Preserve procedures, acts and history; use a reviewed data reversal.');
+        }
+        Schema::dropIfExists('portal_tender_watches');
+        Schema::dropIfExists('portal_tender_versions');
+        Schema::dropIfExists('portal_tenders');
+    }
+};

database/qa/iva-general-net-v1.json

@@ -0,0 +1,38 @@
+{
+  "rule_code": "IVA-GERAL-BASE-LIQUIDA",
+  "rule_version": 1,
+  "component": "IVA",
+  "scope_key": "mz.internal-general-net.mzn",
+  "valid_from": "2023-01-01",
+  "valid_until": null,
+  "source_sha256": "ea1b0dc6f5cf6e595f6d9a19e7042f398999e0087caef1785f6e8fac571b5f53",
+  "rule_definition": {
+    "language": "investmoz.tax.v1",
+    "nodes": {
+      "base": {"op": "input", "key": "base_tributavel"},
+      "rate": {"op": "parameter", "key": "iva_general_rate"},
+      "hundred": {"op": "literal", "value": "100"},
+      "product": {"op": "multiply", "args": ["base", "rate"]},
+      "intermediate": {"op": "divide", "args": ["product", "hundred"]}
+    },
+    "result": "intermediate"
+  },
+  "parameters": {
+    "IVA_GENERAL_RATE": {
+      "value": "16",
+      "unit": "percent",
+      "conditions": {"operation": "internal_general_net", "currency": "MZN"}
+    }
+  },
+  "rounding_policy": {
+    "status": "not_applied",
+    "precision": "exact_decimal",
+    "method": "none",
+    "ties": "not_applicable_without_rounding",
+    "aggregation": "single_declared_taxable_base",
+    "purpose": "operation_tax_not_payment",
+    "evidence": "Orientação expressa Tempo: calcular este lote IVA sem arredondamento automático; ficha v1.2",
+    "coverage_start": "2026-01-01",
+    "coverage_end": "2026-12-31"
+  }
+}

deploy/local/Dockerfile.node

@@ -0,0 +1,19 @@
+FROM node:22-bookworm AS node
+
+FROM php:8.4-cli-bookworm
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends libpq-dev libzip-dev unzip git curl \
+    && docker-php-ext-install -j"$(nproc)" pdo_pgsql pgsql zip \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=node /usr/local/bin/node /usr/local/bin/node
+COPY --from=node /usr/local/lib/node_modules /usr/local/lib/node_modules
+RUN ln -s ../lib/node_modules/npm/bin/npm-cli.js /usr/local/bin/npm \
+    && ln -s ../lib/node_modules/npm/bin/npx-cli.js /usr/local/bin/npx \
+    && ln -s ../lib/node_modules/corepack/dist/corepack.js /usr/local/bin/corepack
+
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci --no-audit --no-fund
+COPY . .

deploy/local/Dockerfile.php

@@ -0,0 +1,13 @@
+FROM php:8.4-cli-bookworm
+
+RUN apt-get update \
+    && apt-get install -y --no-install-recommends libpq-dev libzip-dev unzip git curl \
+    && docker-php-ext-install -j"$(nproc)" pdo_pgsql pgsql zip \
+    && rm -rf /var/lib/apt/lists/*
+
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
+WORKDIR /var/www/html
+COPY composer.json composer.lock ./
+RUN composer install --no-interaction --prefer-dist --no-progress --no-scripts
+COPY . .
+RUN composer dump-autoload --optimize

docs/investmoz/InvestMoz-levantamento-funcional-profissional.html

@@ -0,0 +1,176 @@
+<!DOCTYPE html>
+<html lang="pt">
+<head>
+<meta charset="utf-8">
+<title>InvestMoz — Levantamento funcional e modelos</title>
+<style>
+@page { size: A4; margin: 18mm 17mm 18mm 17mm; }
+body { font-family: Aptos, Calibri, Arial, sans-serif; color:#1d2939; font-size:10.5pt; line-height:1.42; }
+h1 { color:#123d68; font-size:26pt; margin:0 0 8pt; }
+h2 { color:#123d68; font-size:17pt; border-bottom:2px solid #13a789; padding-bottom:5pt; margin-top:24pt; }
+h3 { color:#145b82; font-size:13pt; margin:17pt 0 5pt; }
+p { margin:5pt 0 8pt; }
+.cover { padding-top:100pt; page-break-after:always; }
+.kicker { text-transform:uppercase; letter-spacing:2px; color:#138a77; font-weight:bold; }
+.subtitle { color:#52657a; font-size:15pt; }
+.meta { margin-top:35pt; padding:12pt; background:#eff6fb; border-left:4px solid #1d75bd; }
+.callout { background:#fff7e8; border-left:4px solid #ee9b20; padding:9pt 12pt; margin:12pt 0; }
+.note { color:#52657a; font-size:9pt; }
+table { border-collapse:collapse; width:100%; margin:8pt 0 14pt; font-size:9.2pt; }
+th { background:#123d68; color:white; text-align:left; padding:6pt; }
+td { border:1px solid #cbd5e1; padding:5pt 6pt; vertical-align:top; }
+tr:nth-child(even) td { background:#f5f8fb; }
+.diagram { text-align:center; margin:12pt 0; page-break-inside:avoid; }
+.diagram svg { width:100%; height:auto; }
+.legend { color:#52657a; font-size:9pt; }
+.small { font-size:9pt; }
+.pagebreak { page-break-before:always; }
+ul { margin-top:3pt; }
+</style>
+</head>
+<body>
+<section class="cover">
+<p class="kicker">Documento de análise funcional</p>
+<h1>InvestMoz</h1>
+<p class="subtitle">Levantamento profissional do projecto, casos de uso reais, actores e diagramas</p>
+<div class="meta"><b>Data:</b> 9 de Outubro de 2026<br><b>Âmbito:</b> aplicação Laravel/React e documentação do repositório Investidor-V2<br><b>Versão:</b> 1.0 · análise do código e dos documentos disponíveis</div>
+<p style="margin-top:42pt;font-size:13pt">Portal de descoberta de oportunidades e serviços de investimento, ligado a fluxos autenticados de candidatura, tratamento institucional, evidência documental e acompanhamento.</p>
+<p class="note" style="margin-top:55pt">Documento técnico-funcional. A presença de uma rota, tabela, job ou descrição não demonstra, por si só, activação em produção.</p>
+</section>
+
+<h2>1. Sumário executivo</h2>
+<p>O InvestMoz é uma plataforma digital que aproxima investidores, promotores e instituições. A experiência começa no portal público, onde se consultam sectores, oportunidades, negócios existentes, território, zonas e serviços. A partir daí, a pessoa pode manifestar interesse, iniciar uma simulação ou pedir apoio. Os percursos que exigem continuidade passam para a área autenticada, onde se mantêm perfil, rascunhos, candidaturas, anexos e comunicação.</p>
+<p>Do lado institucional, os pedidos podem ser revistos e acompanhados por CRM local, tarefas, revisões e eventos. A plataforma também contém domínios de catálogo territorial, zonas de investimento, documentação, governação fiscal, educação e competências, assistência de terra, parcerias, balcão virtual e IA baseada em fontes.</p>
+<div class="callout"><b>Leitura funcional:</b> trata-se de uma plataforma de encaminhamento e gestão de jornadas de investimento, e não apenas de um catálogo de anúncios. A camada pública informa e capta pedidos; a camada autenticada conserva o trabalho; a camada de gestão analisa, valida e decide segundo permissões e evidência.</div>
+<p>O README descreve a base inicial de sectores, oportunidades e manifestações de interesse. Rotas, controladores, migrations e documentação de domínio mostram uma solução mais abrangente. O levantamento de casos detalhados tem 24 casos de uso; este relatório acrescenta cenários concretos, diagramas UML/ER e a leitura da frequência dos eventos.</p>
+
+<h2>2. O que o projecto faz</h2>
+<table><tr><th>Capacidade</th><th>Valor para o utilizador</th><th>Exemplos de dados</th></tr>
+<tr><td>Descoberta pública</td><td>Encontrar oportunidades, negócios, sectores, serviços e referências territoriais.</td><td>sectors, opportunities, existing_businesses, investment_zones</td></tr>
+<tr><td>Captação de interesse</td><td>Enviar manifestação associada a uma oportunidade ou negócio, com consentimento.</td><td>interest_requests, consents, receipts</td></tr>
+<tr><td>Jornada do investidor</td><td>Guardar itens, criar dossier/submissão, anexar documentos e acompanhar mensagens.</td><td>investment_submissions, revisions, messages, attachments</td></tr>
+<tr><td>Tratamento institucional</td><td>Qualificar pedidos, atribuir responsável, criar tarefas e acompanhar a negociação.</td><td>leads, contacts, crm_opportunities, tasks, activities</td></tr>
+<tr><td>Planeamento territorial</td><td>Relacionar projectos, clusters, corredores, localizações e zonas.</td><td>projects, economic_clusters, development_corridors, geo_locations</td></tr>
+<tr><td>Documentos e evidência</td><td>Preservar origem, versões, hash, scan, classificação e autorização de divulgação.</td><td>documents, document_versions, malware_scans, associations</td></tr>
+<tr><td>Simulação e regras fiscais</td><td>Guardar rascunhos, executar simulações com parâmetros/fontes rastreáveis e governar versões.</td><td>simulations, scenarios, results, tax_rule_versions, legal_sources</td></tr>
+<tr><td>Serviços complementares</td><td>Registar educação, assistência de terra, parcerias, balcão virtual e apoio com IA.</td><td>training needs, land cases, partnerships, desk cases, ai runs</td></tr></table>
+
+<h2>3. Actores e fronteiras de acesso</h2>
+<table><tr><th>Actor</th><th>O que pretende</th><th>Zona típica</th></tr>
+<tr><td>Visitante</td><td>Consultar conteúdos públicos e iniciar interesse, apoio ou simulação.</td><td>Portal público</td></tr>
+<tr><td>Investidor / utilizador registado</td><td>Manter perfil, favoritos, rascunhos, submissões, anexos e mensagens.</td><td>Área autenticada</td></tr>
+<tr><td>Promotor / proprietário de negócio</td><td>Registar ou actualizar negócio e responder a pedidos de informação.</td><td>Área autenticada e workflow de revisão</td></tr>
+<tr><td>Gestor de portal / CRM</td><td>Rever interesses, qualificar leads, atribuir tarefas e gerir conteúdos.</td><td>Gestão interna</td></tr>
+<tr><td>Gestor territorial</td><td>Manter projectos, relações, zonas, geometria e referências territoriais.</td><td>Gestão interna</td></tr>
+<tr><td>Revisor documental / gestor fiscal</td><td>Validar metadados, evidência, versões e regras sob as respectivas funções.</td><td>Gestão restrita</td></tr>
+<tr><td>Agente de serviço / parceiro institucional</td><td>Tratar casos ou colaborar em parcerias e salas.</td><td>Serviços e colaboração</td></tr>
+<tr><td>Administrador / worker</td><td>Gerir segurança/configuração ou executar trabalho assíncrono autorizado.</td><td>Administração / sistema</td></tr></table>
+<p class="note">Os nomes acima são papéis funcionais consolidados. A autorização efectiva depende das policies, middleware, MFA, configuração e permissões em vigor.</p>
+
+<h2>4. Diagrama de casos de uso com actores</h2>
+<p>O diagrama destaca actores (“bonecos”) e os principais serviços que usam. As associações mostram interacções típicas; não indicam que todos os serviços estejam activos na mesma instalação.</p>
+<div class="diagram">
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1050 610" role="img" aria-label="Diagrama UML de casos de uso InvestMoz com actores">
+<defs><style>.actor{stroke:#173b60;stroke-width:3;fill:none}.line{stroke:#728397;stroke-width:1.7}.uc{fill:#eef6fc;stroke:#2778b8;stroke-width:2}.txt{font:16px Arial;fill:#17324d}.label{font:bold 15px Arial;fill:#17324d}.boundary{fill:#fbfdff;stroke:#9bb0c3;stroke-width:2;stroke-dasharray:8 5}</style></defs>
+<rect x="220" y="22" width="795" height="558" rx="14" class="boundary"/><text x="245" y="52" class="label">Sistema InvestMoz</text>
+<!-- stick actors -->
+<g class="actor"><circle cx="95" cy="115" r="17"/><path d="M95 132v65m-30-38h60m-30 38-27 42m27-42 27 42"/></g><text x="50" y="245" class="label">Visitante</text>
+<g class="actor"><circle cx="95" cy="335" r="17"/><path d="M95 352v65m-30-38h60m-30 38-27 42m27-42 27 42"/></g><text x="37" y="465" class="label">Investidor</text>
+<g class="actor"><circle cx="95" cy="510" r="17"/><path d="M95 527v45m-30-25h60m-30 25-22 33m22-33 22 33"/></g><text x="15" y="606" class="label">Gestor</text>
+<g class="actor"><circle cx="1025" cy="165" r="15"/><path d="M1025 180v55m-25-33h50m-25 33-22 36m22-36 22 36"/></g><text x="979" y="267" class="label">Revisor</text>
+<g class="actor"><circle cx="1025" cy="400" r="15"/><path d="M1025 415v55m-25-33h50m-25 33-22 36m22-36 22 36"/></g><text x="967" y="502" class="label">Parceiro</text>
+<!-- use cases -->
+<g><ellipse cx="410" cy="112" rx="145" ry="31" class="uc"/><text x="410" y="118" text-anchor="middle" class="txt">Consultar catálogo e mapa</text>
+<ellipse cx="730" cy="112" rx="145" ry="31" class="uc"/><text x="730" y="118" text-anchor="middle" class="txt">Pesquisar oportunidade/negócio</text>
+<ellipse cx="410" cy="205" rx="145" ry="31" class="uc"/><text x="410" y="211" text-anchor="middle" class="txt">Manifestar interesse</text>
+<ellipse cx="730" cy="205" rx="145" ry="31" class="uc"/><text x="730" y="211" text-anchor="middle" class="txt">Executar simulação</text>
+<ellipse cx="410" cy="300" rx="145" ry="31" class="uc"/><text x="410" y="306" text-anchor="middle" class="txt">Criar candidatura / dossier</text>
+<ellipse cx="730" cy="300" rx="145" ry="31" class="uc"/><text x="730" y="306" text-anchor="middle" class="txt">Anexar e acompanhar documentos</text>
+<ellipse cx="410" cy="397" rx="145" ry="31" class="uc"/><text x="410" y="403" text-anchor="middle" class="txt">Tratar interesse no CRM</text>
+<ellipse cx="730" cy="397" rx="145" ry="31" class="uc"/><text x="730" y="403" text-anchor="middle" class="txt">Validar e publicar conteúdo</text>
+<ellipse cx="410" cy="495" rx="145" ry="31" class="uc"/><text x="410" y="501" text-anchor="middle" class="txt">Gerir território e zonas</text>
+<ellipse cx="730" cy="495" rx="145" ry="31" class="uc"/><text x="730" y="501" text-anchor="middle" class="txt">Colaborar em parceria/serviço</text></g>
+<!-- actor associations -->
+<g class="line"><path d="M112 115H264M112 115 585 112M112 145 265 195M112 355 265 300M112 370 265 300M112 388 585 300M112 515 265 397M112 525 265 495M112 540 585 495M1008 175 875 397M1008 190 875 300M1008 410 875 495"/></g>
+</svg></div>
+<p class="legend">Exemplo do percurso mais comum: visitante pesquisa → manifesta interesse → investidor cria/acompanha candidatura → gestão trata o pedido → revisão e decisão.</p>
+
+<h2>5. Casos de uso reais — jornadas ilustrativas</h2>
+<h3>UC-A — Investidor encontra oportunidade e manifesta interesse</h3>
+<ol><li>O visitante consulta sectores, filtra oportunidades por localização e abre o detalhe.</li><li>Escolhe “manifestar interesse”, informa contacto, modalidade e mensagem, e aceita o consentimento aplicável.</li><li>O sistema valida o alvo, regista o pedido e, quando configurado, um recibo/idempotência.</li><li>O investidor pode autenticar-se para guardar a oportunidade ou avançar para uma submissão.</li><li>Um gestor consulta o pedido, verifica consentimentos, atribui responsável, qualifica e cria tarefa de seguimento.</li><li>As alterações relevantes ficam no histórico; notificações e integrações só são consideradas entregues quando o disparo e o serviço estiverem confirmados.</li></ol>
+<p><b>Resultado:</b> pedido rastreável ligado à oportunidade e encaminhado para tratamento. <b>Entidades:</b> Opportunity, Investor/User, InterestRequest, Consent, Lead, Task, AuditEvent.</p>
+<h3>UC-B — Proprietário submete um negócio para divulgação</h3>
+<ol><li>O proprietário cria rascunho e informa modalidade, objectos, localização e documentos de suporte.</li><li>Submete o registo; o estado passa para revisão conforme o workflow aplicável.</li><li>O gestor analisa e pode aprovar, rejeitar ou pedir informação complementar.</li><li>O revisor documental confere original, hash, versão, scan e autorização de divulgação.</li><li>Só após as validações necessárias o conteúdo pode ser publicado ao público; publicação não altera a situação jurídica do documento.</li></ol>
+<p><b>Resultado:</b> negócio com histórico e decisão rastreável. <b>Estados documentados:</b> draft → submitted → in_review → approved → published, com ramos needs_information, rejected, withdrawn, suspended e archived.</p>
+<h3>UC-C — Gestor territorial valida zona e relações</h3>
+<ol><li>O gestor regista a zona e a referência/fonte pertinente.</li><li>Associa localização, operador, categoria, geometria e relações com projectos, clusters ou corredores.</li><li>As relações sem evidência verificada permanecem pendentes e identificadas.</li><li>Um revisor valida a evidência e as regras de publicação; alterações ficam versionadas.</li><li>A zona só aparece no portal conforme estado e autorização de divulgação.</li></ol>
+<h3>UC-D — Utilizador guarda um rascunho e executa simulação</h3>
+<ol><li>O utilizador preenche o formulário; os dados incompletos podem ser guardados como rascunho recuperável.</li><li>Quando solicita o cálculo, o sistema selecciona questionário e parâmetros elegíveis.</li><li>O job de simulação executa após a transacção e grava cenários, resultados, obrigações e fontes usadas.</li><li>O relatório pode ser consultado; o rascunho continua distinto do cálculo executado.</li></ol>
+<div class="callout"><b>Regra de integridade:</b> importar ou publicar fonte documental não activa automaticamente uma regra fiscal. Parâmetros ausentes/ambíguos permanecem indeterminados.</div>
+<h3>UC-E — Parceiros colaboram numa parceria ou serviço</h3>
+<p>Um actor cria uma proposta; outro manifesta interesse; após aceitação, os participantes podem colaborar numa sala, trocar mensagens/documentos e acompanhar marcos. O balcão virtual segue padrão semelhante para pedidos de serviço: registo, análise, pedido de documentos, eventos, revisão e resolução.</p>
+
+<h2>6. Diagrama de classes (visão lógica)</h2>
+<p>O diagrama apresenta as classes de domínio principais, atributos representativos e operações. É uma vista funcional; não reproduz todos os campos nem métodos Laravel.</p>
+<div class="diagram"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1100 690" role="img" aria-label="Diagrama UML de classes InvestMoz">
+<defs><style>.box{fill:#fff;stroke:#276c9b;stroke-width:2}.head{fill:#e8f2f9}.ct{font:14px Arial;fill:#17324d}.ch{font:bold 15px Arial;fill:#123d68}.rel{stroke:#60768b;stroke-width:1.8;fill:none}.mult{font:12px Arial;fill:#455b70}</style></defs>
+<!-- classes -->
+<g><rect x="30" y="30" width="220" height="120" rx="5" class="box"/><rect x="30" y="30" width="220" height="32" class="head"/><text x="140" y="52" text-anchor="middle" class="ch">User</text><text x="44" y="82" class="ct">id, email, verified_at</text><text x="44" y="105" class="ct">2FA / passkeys</text><text x="44" y="132" class="ct">+ authenticate()</text>
+<rect x="315" y="30" width="220" height="120" rx="5" class="box"/><rect x="315" y="30" width="220" height="32" class="head"/><text x="425" y="52" text-anchor="middle" class="ch">Investor</text><text x="329" y="82" class="ct">id, user_id, profile</text><text x="329" y="105" class="ct">company interests</text><text x="329" y="132" class="ct">+ manageProfile()</text>
+<rect x="600" y="30" width="220" height="120" rx="5" class="box"/><rect x="600" y="30" width="220" height="32" class="head"/><text x="710" y="52" text-anchor="middle" class="ch">Opportunity</text><text x="614" y="82" class="ct">sector, slug, status</text><text x="614" y="105" class="ct">location, investment</text><text x="614" y="132" class="ct">+ publish()</text>
+<rect x="865" y="30" width="205" height="120" rx="5" class="box"/><rect x="865" y="30" width="205" height="32" class="head"/><text x="967" y="52" text-anchor="middle" class="ch">Sector</text><text x="879" y="82" class="ct">id, name, slug</text><text x="879" y="105" class="ct">active / published</text><text x="879" y="132" class="ct">+ listOpportunities()</text>
+<rect x="30" y="230" width="235" height="130" rx="5" class="box"/><rect x="30" y="230" width="235" height="32" class="head"/><text x="147" y="252" text-anchor="middle" class="ch">InterestRequest</text><text x="44" y="282" class="ct">target, contact, consent</text><text x="44" y="305" class="ct">status, submitted_at</text><text x="44" y="338" class="ct">+ submit() / qualify()</text>
+<rect x="325" y="230" width="235" height="130" rx="5" class="box"/><rect x="325" y="230" width="235" height="32" class="head"/><text x="442" y="252" text-anchor="middle" class="ch">Lead / Task</text><text x="339" y="282" class="ct">owner, next_action</text><text x="339" y="305" class="ct">due_at, status</text><text x="339" y="338" class="ct">+ assign() / complete()</text>
+<rect x="620" y="230" width="235" height="130" rx="5" class="box"/><rect x="620" y="230" width="235" height="32" class="head"/><text x="737" y="252" text-anchor="middle" class="ch">Submission</text><text x="634" y="282" class="ct">owner, target, state</text><text x="634" y="305" class="ct">revisions, needs</text><text x="634" y="338" class="ct">+ save() / submit()</text>
+<rect x="910" y="230" width="160" height="130" rx="5" class="box"/><rect x="910" y="230" width="160" height="32" class="head"/><text x="990" y="252" text-anchor="middle" class="ch">Document</text><text x="924" y="282" class="ct">hash, source</text><text x="924" y="305" class="ct">version, status</text><text x="924" y="338" class="ct">+ scan()</text>
+<rect x="30" y="450" width="235" height="130" rx="5" class="box"/><rect x="30" y="450" width="235" height="32" class="head"/><text x="147" y="472" text-anchor="middle" class="ch">Project / Zone</text><text x="44" y="502" class="ct">territory, geometry</text><text x="44" y="525" class="ct">relations, evidence</text><text x="44" y="558" class="ct">+ validate() / publish()</text>
+<rect x="325" y="450" width="235" height="130" rx="5" class="box"/><rect x="325" y="450" width="235" height="32" class="head"/><text x="442" y="472" text-anchor="middle" class="ch">Simulation</text><text x="339" y="502" class="ct">questionnaire, input</text><text x="339" y="525" class="ct">scenario, result, sources</text><text x="339" y="558" class="ct">+ execute() / report()</text>
+<rect x="620" y="450" width="235" height="130" rx="5" class="box"/><rect x="620" y="450" width="235" height="32" class="head"/><text x="737" y="472" text-anchor="middle" class="ch">TaxRuleVersion</text><text x="634" y="502" class="ct">source, dates, parameters</text><text x="634" y="525" class="ct">review / approval state</text><text x="634" y="558" class="ct">+ resolveForPeriod()</text>
+<rect x="910" y="450" width="160" height="130" rx="5" class="box"/><rect x="910" y="450" width="160" height="32" class="head"/><text x="990" y="472" text-anchor="middle" class="ch">AuditEvent</text><text x="924" y="502" class="ct">actor, entity</text><text x="924" y="525" class="ct">action, time</text><text x="924" y="558" class="ct">+ record()</text></g>
+<!-- relations -->
+<g class="rel"><path d="M250 90H315M535 90H600M820 90H865M140 150V230M425 150V230M710 150V230M265 295H325M560 295H620M855 295H910M140 360V450M442 360V450M737 360V450M855 515H910M250 130 900 470"/></g>
+<g class="mult"><text x="270" y="82">1 : 0..1</text><text x="547" y="82">0..*</text><text x="834" y="82">1</text><text x="148" y="205">1 : 0..*</text><text x="273" y="286">0..1</text><text x="567" y="286">1..*</text><text x="861" y="286">0..*</text><text x="145" y="435">1 : 0..*</text><text x="450" y="435">1 : 0..*</text></g>
+</svg></div>
+<p class="note">A relação exacta Investor/User, a associação Submission/target e os vínculos Document/entidade podem ser opcionais ou implementados por tabelas polimórficas/de junção; confirme no schema antes de gerar código ou migrações.</p>
+
+<h2>7. Diagrama de relacionamento (ER simplificado)</h2>
+<div class="diagram"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 1080 560" role="img" aria-label="Diagrama de relacionamento das entidades InvestMoz">
+<defs><style>.e{fill:#edf5fb;stroke:#2477b6;stroke-width:2}.et{font:bold 15px Arial;fill:#123d68}.r{stroke:#61788d;stroke-width:2;fill:none}.rt{font:12px Arial;fill:#40566b}</style></defs>
+<g><rect x="35" y="45" width="155" height="60" rx="9" class="e"/><text x="112" y="81" text-anchor="middle" class="et">SECTOR</text><rect x="260" y="45" width="180" height="60" rx="9" class="e"/><text x="350" y="81" text-anchor="middle" class="et">OPPORTUNITY</text><rect x="515" y="45" width="190" height="60" rx="9" class="e"/><text x="610" y="81" text-anchor="middle" class="et">INTEREST_REQUEST</text><rect x="805" y="45" width="160" height="60" rx="9" class="e"/><text x="885" y="81" text-anchor="middle" class="et">INVESTOR</text>
+<rect x="35" y="205" width="155" height="60" rx="9" class="e"/><text x="112" y="241" text-anchor="middle" class="et">USER</text><rect x="260" y="205" width="180" height="60" rx="9" class="e"/><text x="350" y="241" text-anchor="middle" class="et">SUBMISSION</text><rect x="515" y="205" width="190" height="60" rx="9" class="e"/><text x="610" y="241" text-anchor="middle" class="et">DOCUMENT</text><rect x="805" y="205" width="160" height="60" rx="9" class="e"/><text x="885" y="241" text-anchor="middle" class="et">AUDIT_EVENT</text>
+<rect x="35" y="365" width="155" height="60" rx="9" class="e"/><text x="112" y="401" text-anchor="middle" class="et">PROJECT</text><rect x="260" y="365" width="180" height="60" rx="9" class="e"/><text x="350" y="401" text-anchor="middle" class="et">CLUSTER</text><rect x="515" y="365" width="190" height="60" rx="9" class="e"/><text x="610" y="401" text-anchor="middle" class="et">INVESTMENT_ZONE</text><rect x="805" y="365" width="160" height="60" rx="9" class="e"/><text x="885" y="401" text-anchor="middle" class="et">LEGAL_SOURCE</text>
+<rect x="145" y="490" width="180" height="55" rx="9" class="e"/><text x="235" y="523" text-anchor="middle" class="et">SIMULATION</text><rect x="450" y="490" width="180" height="55" rx="9" class="e"/><text x="540" y="523" text-anchor="middle" class="et">TAX_RULE_VERSION</text><rect x="755" y="490" width="180" height="55" rx="9" class="e"/><text x="845" y="523" text-anchor="middle" class="et">SIMULATION_RESULT</text></g>
+<g class="r"><path d="M190 75H260M440 75H515M705 75H805M190 235H260M440 235H515M705 235H805M190 395H260M440 395H515M705 395H805M235 425V490M325 518H450M630 518H755M350 105V205M610 105V205M610 265V365M885 105V205M885 425V455H540V490"/></g>
+<g class="rt"><text x="210" y="67">1 : N</text><text x="465" y="67">1 : N</text><text x="730" y="67">N : 0..1</text><text x="210" y="227">1 : N</text><text x="462" y="227">N : M* via links</text><text x="730" y="227">1 : N</text><text x="210" y="387">N : M*</text><text x="462" y="387">N : M*</text><text x="730" y="387">1 : N</text><text x="235" y="466">1 : N</text><text x="346" y="510">1 : N</text><text x="650" y="510">1 : N</text><text x="354" y="160">1 : N</text><text x="617" y="160">association</text><text x="894" y="160">actor</text><text x="670" y="448">source</text></g>
+</svg></div>
+<p class="note">N:M = muitos-para-muitos, normalmente resolvido por tabela de associação. Ligações genéricas de documentos/auditoria podem não ser FKs directas. Este mapa é uma vista funcional, não um substituto do ERD integral em docs/investmoz/erd.mmd e do dicionário de dados.</p>
+
+<h2>8. Eventos e frequência</h2>
+<table><tr><th>Evento/processo</th><th>Gatilho</th><th>Frequência confirmada</th><th>Leitura operacional</th></tr>
+<tr><td>Escalar tarefas vencidas</td><td>Scheduler Laravel</td><td>A cada 15 minutos; sem sobreposição configurada</td><td>Cadência declarada em routes/console.php. O scheduler do servidor tem de estar activo.</td></tr>
+<tr><td>Executar simulação (RunSimulation)</td><td>Pedido de cálculo aceite</td><td>Por pedido, via fila, afterCommit</td><td>Assíncrono; volume depende da utilização e dos workers.</td></tr>
+<tr><td>Scan de malware (ScanDocumentForMalware)</td><td>Upload ou pedido de análise em fluxos suportados</td><td>Por documento, via fila; job único</td><td>Depende de worker e scanner. Upload não prova análise concluída.</td></tr>
+<tr><td>Comparação de compatibilidade MNE</td><td>Alteração aplicável do negócio</td><td>Por alteração aplicável, em fila de sombra</td><td>Job identificado; frequência de alterações não medida.</td></tr>
+<tr><td>Notificação de interesse</td><td>Recepção de interesse</td><td>Disparo não confirmado</td><td>Job NotifyInterestReceived existe, mas não foi localizada chamada dispatch().</td></tr>
+<tr><td>Outbox/inbox e sincronização externa</td><td>Evento/mensagem externa</td><td>Sem calendário operacional confirmado</td><td>Estrutura preparada; documentação indica sincronização real pendente.</td></tr>
+<tr><td>Pesquisas, submissões, revisões e auditoria</td><td>Acção do visitante/utilizador/gestor</td><td>Sob procura ou acção; contagem indisponível</td><td>Sem logs/analytics não se calculam ocorrências por período.</td></tr></table>
+<p><b>Frequência configurada não é frequência observada.</b> Não foram disponibilizados logs, contagens de eventos da base activa, filas, analytics nem tráfego HTTP. Assim, eventos por hora/dia/mês, sazonalidade, falhas e utilizadores activos permanecem indeterminados. Não se extrapolam estes valores a partir de testes, seeders, screenshots ou schema.</p>
+
+<h2>9. Inventário dos 24 casos de uso</h2>
+<table><tr><th>Grupo</th><th>Casos</th></tr>
+<tr><td>Portal e catálogo</td><td>UC-01 Consultar página inicial e serviços; UC-02 Pesquisar sectores e oportunidades; UC-03 Consultar negócio existente.</td></tr>
+<tr><td>Conta e jornada</td><td>UC-04 Criar conta/autenticar/recuperar acesso; UC-05 Manifestar interesse numa oportunidade; UC-06 Manifestar interesse num negócio; UC-07 Guardar oportunidade; UC-08 Manter submissão; UC-09 Submeter candidatura.</td></tr>
+<tr><td>Negócios e CRM</td><td>UC-10 Gerir negócio existente; UC-11 Tratar interesses no CRM.</td></tr>
+<tr><td>Território e documentos</td><td>UC-12 Gerir catálogo territorial; UC-13 Gerir zonas; UC-14 Carregar, verificar e publicar documento.</td></tr>
+<tr><td>Simulação/fiscalidade</td><td>UC-15 Criar rascunho; UC-16 Executar simulação; UC-17 Gerir regra fiscal.</td></tr>
+<tr><td>Serviços especializados</td><td>UC-18 Gerir educação e competências; UC-19 Assistência de terra; UC-20 Gerir parceria; UC-21 Usar balcão virtual.</td></tr>
+<tr><td>Transversal</td><td>UC-22 Usar IA com evidência; UC-23 Sincronizar sistemas externos; UC-24 Auditar alterações.</td></tr></table>
+<p>Os pré-requisitos, fluxos alternativos e tabelas associadas por UC encontram-se no ficheiro <i>casos-de-uso-aplicacao-actual.md</i>.</p>
+
+<h2>10. Integridade, segurança e limitações</h2>
+<ul><li>Disponibilidade para consulta, situação jurídica/documental e uso em regra/cálculo são estados independentes.</li><li>Respeitar autorização de divulgação e âmbito; relações sem evidência ficam pendentes.</li><li>Preservar original, proveniência, ID exacto, edição/data, hash e histórico. Não confirmar autenticidade, vigência, direitos ou scan sem evidência.</li><li>Importação não é publicação; publicação documental não activa cálculo fiscal; rascunho não é candidatura aprovada.</li><li>Integração desenhada não significa sincronização activa. Cobertura e estado de cada domínio devem ser verificados nos respectivos relatórios de validação.</li><li>Antes de alterações a dados activos, confirmar backup/restauro e acção autenticada. Testes e migrações usam exclusivamente base QA isolada.</li></ul>
+
+<h2>11. Fontes de análise</h2>
+<ul><li>README.md do repositório;</li><li>docs/investmoz/casos-de-uso-aplicacao-actual.md;</li><li>docs/investmoz/erd.mmd, data-dictionary.csv e table-catalog.csv;</li><li>rotas, controladores, modelos, jobs, comando de escalada e migrations;</li><li>InvestMoz — Levantamento funcional, casos de uso e diagramas.docx, em Downloads.</li></ul>
+<p class="note">O inventário cobriu 981 caminhos listados por rg --files, excluindo vendor e node_modules. Isso descreve o repositório acessível, não anexos externos, conteúdo de armazenamento privado ou base de dados de produção.</p>
+</body></html>

docs/investmoz/casos-de-uso-aplicacao-actual.md

@@ -0,0 +1,526 @@
+# Casos de uso da aplicação actual
+
+Este documento descreve os processos actualmente implementados ou previstos
+pelas rotas, controladores, serviços e migrations existentes no projecto.
+Não substitui regras legais nem autoriza publicação de dados.
+
+## 1. Actores
+
+| Actor | Responsabilidade |
+|---|---|
+| Visitante | Consulta o portal, oportunidades, negócios, zonas e documentos públicos. |
+| Utilizador registado | Mantém perfil, rascunhos, submissões, favoritos e mensagens. |
+| Investidor | Pesquisa oportunidades, manifesta interesse e acompanha candidaturas. |
+| Gestor | Trata interesses, leads, tarefas, oportunidades e catálogo. |
+| Revisor documental | Verifica documentos, malware, versões e autorização de divulgação. |
+| Gestor territorial | Gere projectos, clusters, corredores, geografia e zonas. |
+| Gestor fiscal | Gere fontes legais, versões de regras e parâmetros do simulador. |
+| Gestor de educação | Gere competências, necessidades, cursos e propostas. |
+| Parceiro institucional | Participa em parcerias, salas, mensagens, documentos e marcos. |
+| Administrador | Gere utilizadores, permissões, configurações e instalação de módulos. |
+| Sistema externo | Recebe/envi­a eventos através de outbox, inbox e sincronizações. |
+
+## 2. Visão geral do ciclo da aplicação
+
+```text
+Portal público
+  -> consulta de catálogo
+  -> interesse, apoio ou simulação
+  -> autenticação/conta quando necessário
+  -> candidatura ou submissão
+  -> documentos e validação
+  -> CRM, tarefas e comunicação
+  -> decisão, parceria ou acompanhamento
+```
+
+Os principais agregados são `opportunities`, `existing_businesses`,
+`interest_requests`, `investment_submissions`, `documents`, `investment_zones`
+e `simulations`.
+
+## 3. UC-01 — Consultar a página inicial e serviços
+
+**Actor:** Visitante.
+
+**Pré-condições:** O portal está disponível.
+
+**Fluxo principal:**
+
+1. O visitante abre `/`.
+2. O sistema apresenta a página inicial e os serviços publicados.
+3. O visitante escolhe oportunidades, negócios, zonas, simulador, documentos,
+   apoio ou parcerias.
+4. O sistema aplica apenas dados que estejam disponíveis para o público.
+
+**Dados:** `portal_resources`, `documents`, `opportunities`, `sectors`,
+`existing_businesses`, `investment_zones`.
+
+**Resultado:** O visitante é encaminhado para o processo escolhido.
+
+## 4. UC-02 — Pesquisar sectores e oportunidades
+
+**Actor:** Visitante ou investidor.
+
+**Fluxo principal:**
+
+1. O actor consulta `/oportunidades` ou a API de oportunidades.
+2. O sistema filtra por sector, localização, slug, estado e outros critérios.
+3. O detalhe da oportunidade mostra perfil, território, relações, documentos
+   públicos e informação de investimento.
+4. O actor pode iniciar uma manifestação de interesse ou guardar a oportunidade.
+
+**Dados:** `sectors`, `opportunities`, `opportunity_profiles`,
+`opportunity_facets`, `opportunity_clusters`, `opportunity_corridors`,
+`opportunity_projects`, `opportunity_locations`, `opportunity_favourites`.
+
+**Resultado:** Consulta pública ou início de UC-05/UC-06.
+
+## 5. UC-03 — Consultar um negócio existente
+
+**Actor:** Visitante ou investidor.
+
+**Fluxo principal:**
+
+1. O actor consulta `/negocios`.
+2. O sistema lista negócios cujo estado e autorização permitem divulgação.
+3. O actor abre o detalhe pelo `slug`.
+4. O sistema apresenta apenas título, descrição, modalidade, localização,
+   objectos e documentos autorizados.
+5. O actor pode iniciar uma manifestação de interesse.
+
+**Dados:** `existing_businesses`, `existing_business_objects`,
+`existing_business_locations`, `existing_business_document_links`,
+`documents`, `interest_requests`.
+
+**Regra:** Dados privados, mandatos e documentos não autorizados não são
+expostos pelo portal público.
+
+## 6. UC-04 — Criar conta, autenticar e recuperar acesso
+
+**Actor:** Visitante/utilizador.
+
+**Fluxo principal:**
+
+1. O visitante cria uma conta com nome, email e palavra-passe.
+2. O sistema cria `users`.
+3. O utilizador confirma o email quando aplicável.
+4. O utilizador inicia sessão.
+5. O sistema aplica as políticas de autenticação, confirmação de palavra-passe
+   e, para operações protegidas, segundo factor.
+
+**Dados:** `users`, `passkeys`, `sessions`, `password_reset_tokens`.
+
+**Alternativas:** Registo rejeitado por email existente; palavra-passe
+incorrecta; recuperação por token; desafio de dois factores.
+
+## 7. UC-05 — Manifestar interesse numa oportunidade
+
+**Actor:** Visitante ou investidor.
+
+**Fluxo principal:**
+
+1. O actor abre o formulário de interesse.
+2. Informa contacto, oportunidade, modalidade, valor e mensagem.
+3. O sistema valida os dados, consentimentos e alvo.
+4. É criado `interest_requests`.
+5. O sistema regista recibo/idempotência quando aplicável.
+6. O sistema envia notificação ou evento de tratamento.
+
+**Dados:** `interest_requests`, `consents`, `interest_submission_receipts`,
+`notifications`, `outbox_events`.
+
+**Estado inicial:** `received`, `submitted` ou equivalente configurado.
+
+**Resultado:** O interesse fica disponível para tratamento no CRM.
+
+## 8. UC-06 — Manifestar interesse num negócio existente
+
+**Actor:** Investidor.
+
+**Fluxo principal:**
+
+1. O investidor escolhe um `existing_business` publicado.
+2. Selecciona a modalidade e, se aplicável, percentagem e intervalo de valor.
+3. O sistema verifica que o negócio pode receber interesse.
+4. Cria `interest_requests.existing_business_id`.
+5. Regista consentimento para contacto e partilha da informação.
+6. O caso passa para tratamento interno.
+
+**Dados:** `existing_businesses`, `interest_requests`, `investors`, `consents`.
+
+**Regra:** Um pedido não pode apontar simultaneamente para uma oportunidade e
+para um negócio existente.
+
+## 9. UC-07 — Guardar uma oportunidade e manter espaço do investidor
+
+**Actor:** Utilizador autenticado.
+
+**Fluxo principal:**
+
+1. O utilizador abre uma oportunidade.
+2. Escolhe guardar/iniciar no espaço do investidor.
+3. O sistema regista a relação em `opportunity_favourites` ou inicia uma
+   submissão/dossier.
+4. O utilizador consulta os seus itens em `/investidor` ou `/carteira`.
+
+**Dados:** `users`, `opportunity_favourites`, `investment_dossiers`,
+`investor_accounts`, `investment_accounts`.
+
+## 10. UC-08 — Criar e manter uma submissão de investimento
+
+**Actor:** Investidor.
+
+**Pré-condições:** Utilizador autenticado e verificado.
+
+**Fluxo principal:**
+
+1. O investidor cria uma submissão.
+2. O sistema cria `investment_submissions` com estado `draft`.
+3. O investidor grava o payload e as necessidades específicas.
+4. Pode adicionar anexos e mensagens.
+5. O sistema cria eventos e revisões para manter histórico.
+6. O investidor consulta ou actualiza a submissão.
+
+**Dados:** `investment_submissions`, `investment_specific_needs`,
+`investment_submission_attachments`, `investment_submission_events`,
+`investment_submission_revisions`, `investment_messages`, `documents`.
+
+## 11. UC-09 — Submeter candidatura
+
+**Actor:** Investidor.
+
+**Fluxo principal:**
+
+1. O investidor confirma os dados da submissão.
+2. O sistema verifica campos obrigatórios, alvo e anexos.
+3. A submissão muda de `draft` para `submitted`.
+4. É associado ou criado o pedido de interesse, quando exigido.
+5. O sistema cria evento de submissão e notifica a gestão.
+
+**Resultado:** A candidatura deixa de ser apenas rascunho e entra na fila de
+tratamento interno.
+
+## 12. UC-10 — Gerir um negócio existente
+
+**Actor:** Investidor, proprietário ou gestor.
+
+**Fluxo principal:**
+
+1. O actor cria ou actualiza o negócio.
+2. Regista modalidade, descrição, objectos, localização e documentos.
+3. O sistema cria revisões e mantém o snapshot anterior.
+4. Um gestor pode solicitar informação, rever ou rejeitar.
+5. O negócio percorre o workflow configurado.
+6. Apenas após validação e autorização poderá ser publicado.
+
+**Dados:** `existing_businesses`, `existing_business_objects`,
+`existing_business_revisions`, `existing_business_reviews`,
+`business_workflow_transitions`, `existing_business_mandates`, `documents`.
+
+**Estados possíveis:** `draft`, `submitted`, `in_review`,
+`needs_information`, `approved`, `published`, `suspended`, `rejected`,
+`withdrawn`, `archived`.
+
+## 13. UC-11 — Tratar interesses no CRM
+
+**Actor:** Gestor.
+
+**Fluxo principal:**
+
+1. O gestor abre a fila de interesses.
+2. Consulta o pedido, consentimentos e alvo.
+3. Atribui o caso a um responsável.
+4. Converte o interesse em `leads`, quando aplicável.
+5. Cria tarefas e actividades.
+6. Actualiza o estado e regista o resultado.
+7. Pode associar um `crm_opportunity` e continuar a negociação.
+
+**Dados:** `interest_requests`, `leads`, `investors`, `contacts`,
+`crm_opportunities`, `tasks`, `activities`, `consents`.
+
+**Estados de interesse:** recebimento, qualificação, contacto, diligência,
+negociação, conversão, recusa, cancelamento ou encerramento.
+
+## 14. UC-12 — Gerir catálogo territorial
+
+**Actor:** Gestor territorial.
+
+**Fluxo principal:**
+
+1. O gestor cria ou actualiza projectos, clusters e corredores.
+2. Liga projectos a locais.
+3. Liga projectos a clusters e corredores.
+4. Cria cadeias de valor e lacunas de investimento.
+5. Regista a fonte e o estado da relação.
+6. Outro gestor pode validar ou revogar a relação.
+
+**Dados:** `projects`, `economic_clusters`, `value_chains`,
+`value_chain_links`, `development_corridors`, `cluster_projects`,
+`corridor_projects`, `corridor_clusters`, `investment_gaps`, `geo_locations`.
+
+## 15. UC-13 — Gerir zonas de investimento
+
+**Actor:** Gestor territorial com permissão e MFA quando exigido.
+
+**Fluxo principal:**
+
+1. Regista a fonte legal em `investment_legal_sources`.
+2. Cria a zona em `investment_zones`.
+3. Associa operador, categoria e localização.
+4. Adiciona geometria, anexos e relações com projectos, clusters ou corredores.
+5. Um revisor valida a informação.
+6. A zona é publicada, suspensa ou revogada.
+7. O sistema mantém revisões imutáveis.
+
+**Estados:** `draft`, `published`, `suspended`; validação `pending`,
+`validated`, `historical`.
+
+**Dados:** `investment_zones`, `investment_legal_sources`,
+`investment_zone_geometries`, `investment_zone_relations`,
+`investment_zone_links`, `investment_zone_attachments`, `investment_zone_revisions`.
+
+## 16. UC-14 — Carregar, verificar e publicar documento
+
+**Actor:** Gestor documental.
+
+**Fluxo principal:**
+
+1. O gestor carrega o ficheiro.
+2. O sistema preserva o original e calcula o hash.
+3. Detecta duplicados e conflitos de versão.
+4. Regista `documents` e, quando necessário, `document_versions`.
+5. Executa análise antimalware.
+6. O gestor revê classificação, datas, fonte e autorização.
+7. O documento é associado ao negócio, candidatura, zona, projecto ou portal.
+8. Só então pode ser disponibilizado publicamente.
+
+**Dados:** `documents`, `document_versions`, `document_malware_scans`,
+`portal_resources`, `portal_resource_revisions` e tabelas `*_documents`.
+
+**Estados documentais:** pendente, limpo, infectado, rejeitado, privado,
+publicável, publicado ou revogado.
+
+## 17. UC-15 — Criar rascunho de simulação
+
+**Actor:** Visitante ou utilizador.
+
+**Fluxo principal:**
+
+1. O actor abre o simulador.
+2. O sistema cria ou recupera um cookie de recuperação.
+3. Guarda os dados em `simulation_form_drafts`.
+4. O actor pode continuar mais tarde.
+5. Um utilizador autenticado pode reclamar o rascunho.
+6. O rascunho pode ser ligado a um negócio existente, mediante autorização.
+
+**Resultado:** Dados incompletos permanecem como rascunho e não são tratados
+como cálculo fiscal executado.
+
+## 18. UC-16 — Executar simulação
+
+**Actor:** Visitante ou utilizador.
+
+**Fluxo principal:**
+
+1. O actor submete os dados do simulador.
+2. O sistema escolhe a versão do questionário.
+3. Resolve os parâmetros fiscais elegíveis.
+4. Cria `simulations` e `simulation_scenarios`.
+5. Executa o cálculo através de job.
+6. Guarda resultados, obrigações e fontes.
+7. Gera relatório quando solicitado.
+8. Regista auditoria e idempotência.
+
+**Dados:** `questionnaire_versions`, `simulations`, `simulation_scenarios`,
+`simulation_results`, `simulation_obligations`, `simulation_reports`,
+`simulation_jobs`, `simulation_result_sources`, `simulation_audit_events`.
+
+## 19. UC-17 — Gerir regra fiscal
+
+**Actor:** Autor, revisor, aprovador ou publicador fiscal.
+
+**Fluxo principal:**
+
+1. O autor cria uma versão da regra.
+2. Associa a regra a uma fonte legal.
+3. O revisor verifica expressão, datas e parâmetros.
+4. O aprovador decide.
+5. O publicador disponibiliza a versão.
+6. O sistema regista cada transição.
+
+**Dados:** `simulation_tax_rule_versions`, `simulation_tax_rule_events`,
+`investment_legal_sources`, `users`.
+
+**Regra:** Importar ou publicar um documento não activa automaticamente um
+cálculo fiscal.
+
+## 20. UC-18 — Gerir educação e competências
+
+**Actor:** Gestor de educação.
+
+**Fluxo principal:**
+
+1. Mantém catálogo de competências, profissões, instituições e cursos.
+2. Regista necessidades de formação de projectos.
+3. Associa ocupações e competências.
+4. Regista capacidades e oportunidades educativas.
+5. Analisa lacunas.
+6. Cria proposta de investimento educativo.
+
+**Dados:** `skills`, `occupations`, `training_needs`, `training_providers`,
+`courses`, `education_opportunities`, `investment_gaps`,
+`education_investment_proposals` e tabelas `skills_edu`.
+
+## 21. UC-19 — Abrir e tratar assistência de terra
+
+**Actor:** Investidor e gestor de assistência.
+
+**Fluxo principal:**
+
+1. O investidor cria um caso de assistência.
+2. Regista localização, necessidade e documentos.
+3. O gestor analisa o caso.
+4. São registadas revisões, eventos e pedidos adicionais.
+5. O caso é encaminhado ou encerrado.
+
+**Dados:** `land_assistance_cases`, `land_assistance_revisions`,
+`land_assistance_events`, `land_assistance_documents`, `documents`, `users`.
+
+## 22. UC-20 — Criar e gerir parceria
+
+**Actor:** Investidor, organização ou parceiro institucional.
+
+**Fluxo principal:**
+
+1. O actor cria um rascunho de parceria.
+2. Regista origem, sector, local e objectivo.
+3. Outro actor manifesta interesse.
+4. A candidatura é aceite ou recusada.
+5. É aberta uma sala de parceria.
+6. Os participantes trocam mensagens e documentos.
+7. São definidos marcos, pagamentos ou acordo.
+8. O sistema regista eventos e notificações.
+
+**Dados:** `portal_partnerships`, `partnership_origins`,
+`partnership_locations`, `partnership_interests`, `partnership_rooms`,
+`partnership_messages`, `partnership_documents`, `partnership_milestones`,
+`partnership_events`, `partnership_notifications`.
+
+## 23. UC-21 — Usar o balcão virtual
+
+**Actor:** Utilizador autenticado e agente de atendimento.
+
+**Fluxo principal:**
+
+1. O utilizador abre um pedido no balcão.
+2. O sistema cria um caso e associa o serviço.
+3. O agente recebe o pedido.
+4. São trocadas mensagens e solicitados documentos.
+5. O caso passa por estados e revisões.
+6. Eventos, notificações e pagamentos são registados.
+7. O caso é resolvido ou encerrado.
+
+**Dados:** `desk_service_versions`, `desk_cases`, `desk_requests`,
+`desk_documents`, `desk_events`, `desk_revisions`, `desk_messages`,
+`desk_notifications`, `desk_institutional_links`, `desk_payments`.
+
+## 24. UC-22 — Usar inteligência artificial com evidência
+
+**Actor:** Gestor autorizado.
+
+**Fluxo principal:**
+
+1. O gestor activa a capacidade em `ai_controls`.
+2. Regista uma fonte ou documento.
+3. O sistema cria chunks da fonte.
+4. O gestor inicia uma execução de IA.
+5. O sistema grava `ai_runs`.
+6. O resultado pode ser revisto ou receber feedback.
+7. A aplicação mantém a fonte que suporta a resposta.
+
+**Dados:** `ai_controls`, `ai_sources`, `ai_chunks`, `ai_runs`, `ai_feedback`,
+`documents`, `users`.
+
+## 25. UC-23 — Sincronizar com sistemas externos
+
+**Actor:** Sistema externo ou processo de integração.
+
+**Fluxo principal:**
+
+1. A aplicação gera um evento em `outbox_events`.
+2. Um worker publica o evento.
+3. O sistema externo responde ou envia evento para `inbox_events`.
+4. A aplicação cria `sync_runs`.
+5. Falhas ou divergências são registadas em `reconciliation_issues`.
+6. O processo pode ser repetido de forma idempotente.
+
+## 26. UC-24 — Auditoria e controlo de alterações
+
+**Actor:** Sistema, gestor ou auditor.
+
+**Fluxo principal:**
+
+1. Uma operação protegida é executada.
+2. O sistema identifica actor, entidade, acção e correlação.
+3. Regista evento de auditoria.
+4. Alterações de entidades versionadas geram revisão/snapshot.
+5. O auditor consulta o histórico sem alterar o registo original.
+
+**Dados:** `audit_events`, `simulation_audit_events`, `investment_zone_revisions`,
+`existing_business_revisions`, `investment_submission_revisions`,
+`desk_revisions`, `outbox_events`.
+
+## 27. Regras transversais da aplicação
+
+- Dados privados exigem autenticação e autorização.
+- Divulgação pública depende do estado de publicação e autorização registada.
+- Documentos originais devem ser preservados.
+- Hash, versão e proveniência devem permanecer associados ao documento.
+- Relações jurídicas ou territoriais não validadas ficam pendentes.
+- Rascunho não é submissão aprovada.
+- Importação não é publicação.
+- Publicação de documento não é activação de regra fiscal.
+- Cálculos fiscais devem usar fonte e parâmetro identificados.
+- Histórico e auditoria não devem ser apagados por rollback destrutivo.
+- Operações de migração e testes devem usar base QA isolada.
+
+## 28. Mapa resumido dos processos
+
+```text
+Visitante
+  -> consulta catálogo
+  -> interesse / apoio / simulação
+
+Investidor
+  -> conta
+  -> favoritos / dossier
+  -> submissão
+  -> documentos
+  -> mensagens
+
+Gestor
+  -> interesse
+  -> lead
+  -> tarefas
+  -> oportunidade CRM
+  -> decisão
+
+Gestor territorial
+  -> projecto / cluster / corredor
+  -> zona
+  -> geometria
+  -> fonte legal
+  -> validação / publicação
+
+Gestor fiscal
+  -> regra
+  -> revisão
+  -> aprovação
+  -> publicação
+  -> parâmetro usado pelo simulador
+
+Parceiros
+  -> parceria
+  -> candidatura
+  -> sala
+  -> mensagens / documentos / marcos
+```

docs/investmoz/consolidated-review-matrix-2026-10-03.md

@@ -4,6 +4,10 @@ Data: 2026-10-03. Âmbito: prompt master recebido em `Pasted text.txt`, document
 
 ## Estado inicial e ambiente
 
+**Orientação de publicação e percurso do lote, 23/10/2026:** as 34 oportunidades de Agronegócio ficam publicáveis sem relações obrigatórias com corredores/clusters/projectos. Lacuna encontrada: a comparação múltipla existente não era transportada ao dossier. Correcção aditiva no contexto cifrado existente, com escolhas identificadas e localização por ficha, confirmação de alternativa, requisitos/fontes/documentos/entidades por contexto, reutilização no simulador e conservação de resultados/histórico. Sete testes do contexto (132 asserções) e um do lote pela sessão HTTP (15) passaram. Publicação QA efectuada; instalação no destino separa código, cadastro privado e divulgação autenticada. Ver [orientação e guia no manual](unification/traceability-and-manual.md). Não altera Turismo de Inhambane nem concede benefícios por localização. Lacunas de modalidade/dimensão/acto concreto permanecem explícitas, sem nova revalidação de fontes oficiais aceites.
+
+**Correcção de âmbito, 23/10/2026 — agronegócio e percurso existente:** a lista informativa instalada não encerrava o cadastro. Preparadas e efectivamente cadastradas 34 oportunidades privadas em QA, com as seis designações documentais intactas, sector, fonte/hash e lacunas explícitas. Reutilizada a candidata de divulgação promocional `9d3bfa89` no fluxo necessário, sem alterações independentes de administração de contas nem novos papéis. Equipa edita/recupera e divulga/actualiza/retira pela interface; público acede à ficha individual, manifestação e roteiro com referência confirmada no mesmo dossier. Três testes específicos, 553 asserções; tipos/build concluídos; tabelas/linhas preexistentes comparadas e preservadas. As divulgações dos testes foram revertidas; as 34 fichas permanecem privadas. Sem alteração da homologação nesta correcção. Carregamento inicial técnico QA já executado; não é dependência das operações correntes. Guia, limites e recibo na [secção de correcção do manual](unification/traceability-and-manual.md#correcção-de-âmbito--34-oportunidades-cadastradas-e-roteiro-em-qa-23102026). Não encerra viabilidade, implantação, financiamento ou execução das oportunidades.
+
 | Item               | Evidência observada                                                                                                                                                                                                                                                                                                                       |
 | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | Branch / commit    | `main` / `4f35313d06ccd597a4ebf9ed043964d898c95813`                                                                                                                                                                                                                                                                                       |
@@ -315,3 +319,37 @@ Situação comum observada: `publication_status=draft`, `validation_status=valid
 - Verificação: `php artisan test tests/Feature/PortalServicesTest.php` — 17 testes/497 asserções aprovados em QA; cobrem publicação autorizada com pesquisa textual e filtros combinados, ficha, download, associação ao módulo e links de requisitos com estados confirmados/pendentes. `npm.cmd run build` concluído. O build alerta sobre pacote opcional `fontaine` e chunk `services` acima de 500 KB; sem erro de compilação. Não houve browser autenticado disponível, portanto não se declara publicação, pesquisa ou download públicos concluídos.
 - A autorização documental não foi aplicada a zonas, parques, negócios privados ou oportunidades de demonstração. A regra de publicação de parque não exige área confirmada; divergência de área, isoladamente, não é um gate técnico. Se a ficha avançar por decisão própria, deve omitir o total disputado ou mostrar os valores reportados com fonte/escopo, sem alegar disponibilidade. Beluluane, Munhava e Topuito requerem revisão por registo para fonte/localização pública e para retirar ou qualificar a área; Topuito só tem província associada no mestre geográfico, pelo que não se pode anunciar uma associação administrativa a Larde enquanto essa referência não existir. ZEE/ZFI continuam dependentes de acto oficial estruturado e validado, regime e relações territoriais apropriadas; uma área sem confirmação não substitui essas evidências.
 - Proposta para as seis oportunidades de demonstração já públicas: preservar os registos e IDs, adicionar origem/tipo `demo` e identificá-los visivelmente como **Exemplo de demonstração**, separar a pesquisa de exemplos da pesquisa de oportunidades reais e excluir os exemplos dos resultados reais por defeito. Não os converter nem retirar em massa; cada registo real exigirá origem e proponente documentados. Nenhuma alteração foi feita nesta execução.
+
+### Referência da entrada única de gestão — QA, 22/10/2026
+
+Nos requisitos existentes `MASTER-9f6dd1d9-0001`, `MASTER-9f6dd1d9-0003` e `MASTER-02f44baf-0002`, acrescentar como evidência delimitada a secção «Entrada única de gestão — preparação em QA, 22/10/2026» do manual de rastreabilidade e `tests/Feature/ContentManagementEntryTest.php`: quatro testes/99 asserções, ClamAV real e reversão transaccional em QA. Origem do objectivo e das regras operacionais: decisão expressa da Tempo; navegação, filtros e recuperação do upload são escolhas de implementação. Reutilizados biblioteca, armazenamento, perfis e histórico. Não altera os critérios de aceitação nem fecha os requisitos integrais: integração/contas reais e categorias não demonstradas conservam o seu estado. Geometrias permanecem separadas.
+
+
+AUD-GEO-02/03: Recuperação da demarcação territorial — QA, 22/10/2026. 408/581 limites recuperados em QA; cadeia territorial guardada/reaberta no portal. Homologacao ainda sem reposicao; consultar a nova secao no manual existente. Mantidas 173 correspondencias pendentes e ausencia de geometrias proprias das localidades. Origem: pedido expresso da Tempo de recuperar funcionalidade; enquadramento e mensagens sao escolhas tecnicas. Nao encerra o criterio de reposicao no destino.
+
+
+AUD-GEO-02/03 - 22/10/2026: Demarcação territorial reposta na homologação — 22/10/2026. 408 limites (11/133/264) importados pela conta real/MFA, com tres recibos auditados; backup/restauro de 171 tabelas conferido, 333 ficheiros verificados. Consulta do mapa demonstrada na oportunidade real #30, sem a alterar. Acessos previstos e originais privados preservados. Reposicao no destino concluida; 26+147 correspondencias e ausencia de poligonos proprios de localidades mantidas como lacunas reais. Ver fecho e guia no manual existente; sem repetir provas QA aceites.
+
+### Incremento Concursos e anúncios — QA, 22/10/2026
+
+Instalação autorizada e concluída na homologação em 22/10/2026: integração funcional `f4d09709`, schema selectivo/contrato/activação conferidos após backup e restauro isolado de 171 tabelas. Gestão real com MFA: cadastro, recuperação e prévia de rascunho privado auditado; catálogo público 200, zero anúncios publicados. Preservados dados/permissões/originais e geometrias. Evidência e links finais em «Instalação concluída na homologação» no manual e `unification/procurement-installation-receipt-20261022.json`. Provas QA aceites reutilizadas. Este fecho substitui o estado de proposta pendente de instalação abaixo, sem declarar aceite pela Tempo o guia não conferido nem expandir o âmbito para recepção de propostas.
+
+Proposta de entrega da candidata `1bcf34c0`: ver «Proposta de instalação compatível com deploy automático» no manual existente. Identificados três novos cadastros e o gate real de contrato de migrations do pipeline. Sequência proposta: revisão → coordenação do deploy → backup/restauro isolado → migration selectiva autenticada com flag desligada → contrato → integração/build/promoção → activação → conferência do delta no destino. Reversão conserva tabelas, actos, auditoria e originais posteriores; não restaura backup antigo sobre dados novos. Provas QA reutilizadas; nenhuma integração, migration remota, activação ou publicação real executada nesta passagem. A Tempo ainda não conferiu links locais/guia; não registar aceitação nem entrega no destino por essa razão.
+
+Nos requisitos existentes de gestão/publicação `MASTER-9f6dd1d9-0001`, `MASTER-9f6dd1d9-0003` e `MASTER-02f44baf-0002`, registar o recorte solicitado pela Tempo: procedimentos com regime/edição/fontes, lotes, rascunhos recuperáveis, prévia, actos versionados, catálogo/ficha/anexos anónimos, filtros, impressão e acompanhamento por conta simples. Evidência: secção «Concursos e anúncios — implementação em QA» do manual existente e `tests/Feature/ProcurementTest.php`, com passagem adicional no navegador dos três regimes, prorrogação, cancelamento, download e acompanhamento. Reutilizadas autorizações e biblioteca; não foram criados papéis ou aprovadores. Origem funcional: pedido expresso da Tempo; flag, prévia assinada e controlo de versão são escolhas técnicas. Entrega delimitada a QA: integração em main, migração/activação no destino e anúncios reais seguem o processo existente. Não fecha requisitos integrais de contratação/recepção de propostas, nem declara parametrizado todo o articulado legal. Geometrias permanecem no recorte separado já entregue.
+
+### Preservação do concluído e reposição — 23/10/2026
+
+Origem: pedido expresso da Tempo de inventariar o concluído e repor funcionalidades desaparecidas antes de outra ronda de testes/validações. Inventariados os mesmos 43 componentes do manual e os 17 percursos da matriz executável existente; os componentes de interface referenciados estão presentes. Estados históricos foram reconciliados com entregas posteriores, sem revogar aceitações por falta de nova prova. Não se criou nova matriz/backlog nem se promoveu uma funcionalidade parcial a concluída.
+
+Perda confirmada: carteira e projectos âncora. Os 29 dossiers existiam em homologação, todos em rascunho, apesar de os exemplares locais idênticos estarem publicados com aprovação documental do proprietário de 26/09. Conteúdo, fonte e título conferidos por identidade/código e hashes nos 29; o commit `e65cb269` de 06/10 retirou o caminho de publicação com essa aprovação do importador. Isso explica a diferença do processo de instalação; não prova quando a visibilidade desapareceu de um endereço específico. Reposta a visibilidade dos 15 projectos, 8 clusters e 6 corredores em QA e homologação, com versões e 29 eventos de reposição; sem importação, reescrita de conteúdos, alteração dos mestres ou novas aprovações/papéis.
+
+Backup/restauro fresco de 174 tabelas antes da escrita activa; depois da reposição, 171 tabelas inalteradas. Diferenças limitadas a dossiers, auditoria e sessões. Biblioteca, 20 artigos públicos, 28 privados, geometrias e permissões preservados. Conferência pública delimitada: carteira 29, projectos 15, clusters 8, corredores 6. Sem suite geral de testes nesta passagem. Evidência, limites e regra de preservação em `unification/preservation-inventory-20261023.json`, secção «Preservação do concluído — inventário e reposição» do manual e instrução permanente de 23/10 em `AGENTS.md`.
+
+### Acervo legado — correspondência e preparação QA, 22/10/2026
+
+Fecho do delta privado na homologação: candidata `fb4e7d89` integrada em `65eddf6b`; backup/restauro isolado, transporte privado e cadastro autenticado dos 28 concluídos, sem publicação. Pesquisa/editor/prévia/recuperação conferidos para os 28; gravação/recuperação visual da revisão 3 pela conta real no recurso 32. Originais, registos anteriores e permissões preservados. Recibo `unification/legacy-editorial-installation-receipt-20261022.json` e secção «Legado — cadastro privado concluído na homologação» do manual. Publicação e revisão editorial efectiva cabem à equipa pela interface; dois originais continuam incompletos. Não fecha nem diagnostica a falha separada da carteira/projectos âncora, nem constitui aceitação do commit/pacote pela Tempo.
+
+Actualização do mesmo requisito: os 28 rascunhos têm edição, leitura privada, prévia sem guardar, recuperação e publicação/retirada pela interface em QA, preservando originais, origem e revisões. Seis testes/1.000 asserções, TypeScript e build passaram; publicação positiva apenas em transacções revertidas. Pacote privado v2 preparado com 28 originais e proveniência; não transportado nem publicado na homologação. Guia, permissões existentes, lacunas de imagens, dependências da entrega e reversão na secção «Legado — edição e leitura dos 28 rascunhos em QA» do manual. Pedido funcional expresso da Tempo; hash de âmbito, prévia e controlo de versão são escolhas técnicas, sem novo papel/aprovador. Conserva o saldo de 20 públicos aceites e dois originais incompletos, sem repetir provas ou fechar a integração integral.
+
+Referência do acervo legado, 22/10/2026: a lista única `v2/auditoria-portal/legado-correspondencia-integral.md` e o CSV existente reconciliam 50 identidades (20 publicados, 28 por integrar no destino, um vazio, um sem título). 20/20 páginas conferidas por HTTP anónimo/identidade/origem; cartões de Turismo observados no destino. Os 28 restantes avançaram para rascunhos internos QA, com ClamAV real e repetição idempotente, sem publicação. Recibo e limites no manual, secção «Legado — correspondência integral e avanço privado QA». As duas lacunas editoriais foram confirmadas no original. Não fecha a integração integral nem substitui revisão editorial por prova HTTP; nenhuma alteração activa nesta passagem.

docs/investmoz/document-corpus-inventory-2026-10-06.csv

@@ -76,3 +76,5 @@
 "Cópia privada ou derivado";"C:\laragon\www\portal-investidor\storage\app\private\portal-documents\5c860c48-e8cb-4d8d-ab9b-2e3ea7036ce2";"5c860c48-e8cb-4d8d-ab9b-2e3ea7036ce2";"1834284";"EA1B0DC6F5CF6E595F6D9A19E7042F398999E0087CAEF1785F6E8FAC571B5F53";"5c860c48-e8cb-4d8d-ab9b-2e3ea7036ce2";"";"Private stored copy already represented by its document record";"Acessível em armazenamento privado";"Inventariado por caminho, tamanho e SHA-256; não publicado nem aberto nesta revisão."
 "Cópia privada ou derivado";"C:\laragon\www\portal-investidor\storage\app\private\portal-documents\64c46765-96b9-4f43-afc6-f5b730c010c4";"64c46765-96b9-4f43-afc6-f5b730c010c4";"440018";"CCF2A8DEECA820F2DD076B4B2141B1EFE3F6A806568C3A587CA59A8E92F4C251";"64c46765-96b9-4f43-afc6-f5b730c010c4";"";"Private stored copy already represented by its document record";"Acessível em armazenamento privado";"Inventariado por caminho, tamanho e SHA-256; não publicado nem aberto nesta revisão."
 "Cópia privada ou derivado";"C:\laragon\www\portal-investidor\storage\app\private\portal-documents\b0ea969a-30ec-477b-8b8b-b7af82a11bfe";"b0ea969a-30ec-477b-8b8b-b7af82a11bfe";"67067";"5C69B6F189A1D3F5307E0CF7DD8224554705158A682637D3105AFAD615DB26E2";"b0ea969a-30ec-477b-8b8b-b7af82a11bfe";"C:\laragon\www\portal-investidor\storage\app\private\geo-ine-review-20260928\original.pdf + C:\laragon\www\portal-investidor\storage\app\private\geo-ine-review-20260928-v2\original.pdf + C:\laragon\www\portal-investidor\storage\app\private\portal-documents\b0ea969a-30ec-477b-8b8b-b7af82a11bfe";"Private stored copy already represented by its document record";"Acessível em armazenamento privado";"Inventariado por caminho, tamanho e SHA-256; não publicado nem aberto nesta revisão."
+"Formulario fornecido Tempo";"\\Mac\Home\Documents\TEMPO\Portal Tempo\Servicos Tempo\portal do investidor\Notas\Novo Modelo A.docx";"Novo Modelo A.docx";"532008";"62C198E90D8C6792F7D5CCEFC6386DF2E4B6089573067D3A6E1EAE7FC2B9572B";"IVA Modelo A - exemplar Tempo";"";"Original privado na biblioteca QA; sem publicacao ou activacao";"Acessivel / importado QA / privado / scan limpo";"Imagem incorporada lida visualmente; edicao/vigencia nao certificada. Correspondencia na reconciliacao Modelo A, AUD-SIM-INT02. Variante de bytes preservada, nao duplicado por nome."
+"Formulario fornecido Tempo";"\\Mac\Home\Documents\TEMPO\Portal Tempo\Servicos Tempo\portal do investidor\Notas\Novo Modelo A v1.docx";"Novo Modelo A v1.docx";"532100";"63D45FA80DB17A60B43619D55A25813229D670D14C758273F86316285DB8E02B";"IVA Modelo A - exemplar Tempo";"";"Original privado na biblioteca QA; sem publicacao ou activacao";"Acessivel / importado QA / privado / scan limpo";"Imagem incorporada lida visualmente; edicao/vigencia nao certificada. Correspondencia na reconciliacao Modelo A, AUD-SIM-INT02. Variante de bytes preservada, nao duplicado por nome."

docs/investmoz/levantamento-funcional-e-eventos.md

@@ -0,0 +1,211 @@
+# Levantamento funcional, entidades e eventos — InvestMoz
+
+**Data do levantamento:** 9 de Outubro de 2026  
+**Âmbito:** aplicação Laravel/React presente neste repositório.  
+**Base de evidência:** README, rotas, controladores, modelos, migrations e documentação em `docs/investmoz/`. A existência de uma tabela, rota ou documento não prova que a função esteja activa em produção.
+
+## 1. Resumo executivo
+
+O projecto é uma plataforma de investimento com área pública e área autenticada. Abrange descoberta de oportunidades e negócios, manifestações de interesse, gestão de candidaturas e carteira, CRM local, geografia e zonas de investimento, simulador e governação fiscal, catálogo documental, educação, assistência de terra, parcerias, balcão virtual, IA com fontes e integrações preparadas.
+
+O README apresenta a base inicial do portal (sectores, oportunidades e manifestações). O código actual e os documentos de domínio registam a extensão funcional posterior. Para o inventário detalhado dos fluxos, consultar [casos-de-uso-aplicacao-actual.md](casos-de-uso-aplicacao-actual.md), que identifica 24 casos de uso. Este documento complementa-o com uma visão de domínio, um diagrama resumido de relações e a frequência observável dos eventos.
+
+## 2. Âmbito e método
+
+Foi feito inventário dos caminhos acessíveis no repositório: **981 ficheiros** por `rg --files`, excluindo dependências geradas `vendor` e `node_modules`. Dentro da aplicação foram consultados, em particular, `routes/`, `app/Models/`, `app/Http/Controllers/`, `database/migrations/`, `database/seeders/` e `docs/investmoz/`. O número é uma contagem do inventário local nessa data, não um inventário de anexos externos ou de dados de produção.
+
+Classificação usada:
+
+- **Implementado no código:** rota, controlador, job, comando ou schema identificável.
+- **Documentado/planeado:** descrito em documentação, sem prova suficiente de execução integrada.
+- **Frequência de negócio desconhecida:** não há amostra de eventos de produção nem telemetria para calcular volume por hora/dia/mês.
+- **Cadência técnica explícita:** periodicidade configurada no scheduler ou no mecanismo de fila.
+
+## 3. Actores e sistemas
+
+| Actor | Objectivo principal | Áreas usadas |
+|---|---|---|
+| Visitante | Consultar conteúdos públicos e iniciar pedidos | Portal, oportunidades, negócios, zonas, documentos, simulador |
+| Investidor/utilizador | Manter perfil, favoritos, rascunhos, submissões, documentos e mensagens | Espaço do investidor, carteira, assistência, parcerias |
+| Gestor de portal/CRM | Rever interesses, gerir leads, tarefas, catálogo e publicação | CRM local, gestão de portal |
+| Gestor territorial | Manter projectos, clusters, corredores, relações, geografia e zonas | Catálogo territorial, GIS, zonas |
+| Revisor documental | Conferir proveniência, versão, hash, autorização e análise antimalware | Biblioteca documental |
+| Gestor fiscal | Rever fontes, parâmetros e versões das regras fiscais | Governação fiscal, simulador |
+| Gestor de educação | Manter competências, necessidades, cursos, capacidades e propostas | Educação |
+| Gestor/agente de assistência | Tratar pedidos de terra e pedidos do balcão virtual | Assistência de terra, balcão |
+| Parceiro institucional | Participar em oportunidades/parcerias e colaborar em salas | Parcerias |
+| Administrador | Gerir autenticação, segurança, configurações e permissões | Administração |
+| Sistema externo/worker | Receber/enviar mensagens ou executar trabalho assíncrono | Outbox/inbox, filas, integrações |
+
+Papéis são uma leitura funcional dos fluxos. A autorização efectiva depende das policies, middleware e permissões implementadas, não apenas desta tabela.
+
+## 4. Catálogo de casos de uso
+
+O documento [Casos de uso da aplicação actual](casos-de-uso-aplicacao-actual.md) detalha pré-condições, fluxos e dados para cada caso. Índice consolidado:
+
+| ID | Caso de uso | Actor principal | Resultado |
+|---|---|---|---|
+| UC-01 | Consultar página inicial e serviços | Visitante | Entrada no serviço público autorizado |
+| UC-02 | Pesquisar sectores e oportunidades | Visitante/investidor | Lista/detalhe e possível favorito/interesse |
+| UC-03 | Consultar negócio existente | Visitante/investidor | Consulta da oferta divulgável |
+| UC-04 | Criar conta, autenticar e recuperar acesso | Utilizador | Sessão autenticada/verificada |
+| UC-05 | Manifestar interesse numa oportunidade | Visitante/investidor | Pedido recebido para tratamento |
+| UC-06 | Manifestar interesse num negócio existente | Investidor | Pedido ligado ao negócio e consentimento |
+| UC-07 | Guardar oportunidade e manter espaço do investidor | Utilizador | Favorito, dossier ou item na carteira |
+| UC-08 | Criar e manter submissão de investimento | Investidor | Submissão em rascunho com histórico |
+| UC-09 | Submeter candidatura | Investidor | Entrada em fila de tratamento |
+| UC-10 | Gerir negócio existente | Proprietário/gestor | Registo revisto e eventualmente publicável |
+| UC-11 | Tratar interesses no CRM | Gestor | Qualificação, lead, tarefa e seguimento |
+| UC-12 | Gerir catálogo territorial | Gestor territorial | Projectos, clusters, corredores e relações |
+| UC-13 | Gerir zonas de investimento | Gestor territorial/revisor | Zona validada, publicada ou suspensa |
+| UC-14 | Carregar, verificar e publicar documento | Revisor documental | Documento preservado com estados independentes |
+| UC-15 | Criar/retomar rascunho de simulação | Visitante/utilizador | Rascunho recuperável, sem cálculo implícito |
+| UC-16 | Executar simulação | Visitante/utilizador | Resultado, obrigações, fontes e relatório |
+| UC-17 | Gerir regra fiscal | Gestor fiscal | Versão de regra passa por revisão/aprovação |
+| UC-18 | Gerir educação e competências | Gestor de educação | Catálogo, análise de lacunas e proposta |
+| UC-19 | Abrir/tratar assistência de terra | Investidor/gestor | Caso acompanhado até encaminhamento/fecho |
+| UC-20 | Criar e gerir parceria | Investidor/parceiro | Interesse, sala, mensagens, documentos e marcos |
+| UC-21 | Usar balcão virtual | Utilizador/agente | Pedido de serviço acompanhado até resolução |
+| UC-22 | Usar IA com evidência | Gestor autorizado | Execução rastreável ligada a fontes e feedback |
+| UC-23 | Sincronizar sistemas externos | Worker/sistema externo | Eventos recebidos/enviados e divergências registadas |
+| UC-24 | Auditar alterações | Sistema/gestor/auditor | Histórico e correlação para operações relevantes |
+
+## 5. Diagrama de entidades e relações
+
+Diagrama lógico resumido por domínios. As cardinalidades representam a estrutura documentada; algumas relações polimórficas, opcionais ou em tabelas de junção estão simplificadas. Para o ERD de schema detalhado, consultar [erd.mmd](erd.mmd), [data-dictionary.csv](data-dictionary.csv) e [table-catalog.csv](table-catalog.csv).
+
+```mermaid
+erDiagram
+    USER ||--o{ INVESTOR : possui
+    USER ||--o{ SUBMISSION : cria
+    USER ||--o{ SIMULATION : executa
+    USER ||--o{ AUDIT_EVENT : origina
+    SECTOR ||--o{ OPPORTUNITY : classifica
+    OPPORTUNITY ||--o{ INTEREST_REQUEST : recebe
+    EXISTING_BUSINESS ||--o{ INTEREST_REQUEST : recebe
+    INVESTOR ||--o{ INTEREST_REQUEST : manifesta
+    INTEREST_REQUEST ||--o| LEAD : converte
+    LEAD ||--o{ CRM_TASK : acompanha
+    OPPORTUNITY ||--o{ SUBMISSION : referencia
+    SUBMISSION ||--o{ SUBMISSION_REVISION : versiona
+    SUBMISSION ||--o{ SUBMISSION_EVENT : regista
+    SUBMISSION ||--o{ DOCUMENT_LINK : anexa
+    PROJECT }o--o{ ECONOMIC_CLUSTER : associa
+    PROJECT }o--o{ DEVELOPMENT_CORRIDOR : associa
+    PROJECT ||--o{ INVESTMENT_GAP : identifica
+    INVESTMENT_ZONE ||--o{ ZONE_REVISION : versiona
+    INVESTMENT_ZONE ||--o{ ZONE_RELATION : liga
+    INVESTMENT_ZONE ||--o{ ZONE_ATTACHMENT : documenta
+    DOCUMENT ||--o{ DOCUMENT_VERSION : versiona
+    DOCUMENT ||--o{ MALWARE_SCAN : analisa
+    DOCUMENT }o--o{ PORTAL_RESOURCE : disponibiliza
+    SIMULATION ||--o{ SIMULATION_SCENARIO : contém
+    SIMULATION_SCENARIO ||--o{ SIMULATION_RESULT : produz
+    SIMULATION_RESULT ||--o{ SIMULATION_OBLIGATION : discrimina
+    SIMULATION_RESULT ||--o{ RESULT_SOURCE : fundamenta
+    TAX_RULE_VERSION }o--o{ LEGAL_SOURCE : fundamenta
+    PROJECT ||--o{ TRAINING_NEED : requer
+    SKILL }o--o{ OCCUPATION : relacionada
+    TRAINING_PROVIDER ||--o{ COURSE : oferece
+    USER ||--o{ LAND_ASSISTANCE_CASE : requer
+    PARTNERSHIP ||--o{ PARTNERSHIP_INTEREST : recebe
+    PARTNERSHIP ||--o| PARTNERSHIP_ROOM : abre
+    PARTNERSHIP_ROOM ||--o{ PARTNERSHIP_MESSAGE : contém
+    DESK_CASE ||--o{ DESK_EVENT : regista
+    AI_SOURCE ||--o{ AI_CHUNK : divide
+    AI_SOURCE ||--o{ AI_RUN : suporta
+    OUTBOX_EVENT }o..|| SYNC_RUN : processa
+    SYNC_RUN ||--o{ RECONCILIATION_ISSUE : detecta
+```
+
+### 5.1 Domínios e entidades nucleares
+
+| Domínio | Entidades nucleares | Relações principais |
+|---|---|---|
+| Identidade e acesso | `users`, `passkeys`, sessões, organizações, memberships | Utilizador possui perfil e inicia operações protegidas |
+| Catálogo público | `sectors`, `opportunities`, catálogos de referência, recursos do portal | Sector classifica oportunidades; publicação controla exposição |
+| Negócios existentes | `existing_businesses`, objectos, locais, revisões, mandatos | Negócio tem objectos/locais/documentos e workflow próprio |
+| Investidor e CRM | `investors`, `interest_requests`, `leads`, `contacts`, oportunidades CRM, tarefas | Interesse pode converter-se em lead e gerar tarefas/actividades |
+| Carteira e submissões | dossiers, `investment_submissions`, necessidades, revisões, eventos, mensagens, anexos | Submissão pertence a utilizador e liga-se a oportunidade/negócio |
+| Território e GIS | `projects`, `economic_clusters`, `development_corridors`, `geo_locations`, `value_chains`, `investment_gaps` | Relações muitos-para-muitos documentam associação territorial/económica |
+| Zonas de investimento | `investment_zones`, fontes legais, geometrias, relações, anexos, revisões | Zona tem localização, evidência, relações e estado de validação/publicação |
+| Documentos | `documents`, versões, scans, associações por domínio, recursos do portal | Documento pode ser associado a várias entidades; disponibilidade, estado documental e uso em cálculo são independentes |
+| Simulação e fiscalidade | rascunhos, `simulations`, cenários, resultados, obrigações, fontes, regras versionadas | Execução usa versões/parâmetros elegíveis e preserva as fontes do resultado |
+| Educação | skills, occupations, providers, courses, training needs/capacity, propostas | Projectos expressam necessidades relacionadas com competências e formação |
+| Serviços e colaboração | casos de terra, balcão virtual, parcerias, salas, mensagens, documentos, marcos | Casos e salas mantêm eventos e participantes próprios |
+| IA e governação | controlos, fontes/chunks, execuções, feedback, auditoria | Execução de IA deve poder ser rastreada às fontes e ao actor |
+| Integrações | `outbox_events`, `inbox_events`, `sync_runs`, reconciliações | Eventos são idempotentes/correlacionáveis; desenho de schema não prova integração activa |
+
+## 6. Eventos e frequência
+
+### 6.1 Frequência explicitamente configurada
+
+| Evento/processo | Gatilho | Frequência/cadência no código | Natureza e observação |
+|---|---|---|---|
+| Escalar tarefas vencidas (`investmoz:escalate-overdue-tasks`) | Scheduler Laravel | **A cada 15 minutos**, com `withoutOverlapping()` | Única periodicidade de scheduler encontrada em `routes/console.php`; execução real requer scheduler/cron activo |
+| Executar simulação (`RunSimulation`) | Pedido de cálculo aceite | Por submissão, via fila, `afterCommit` | Assíncrono; frequência depende da procura e de workers activos |
+| Analisar documento (`ScanDocumentForMalware`) | Upload/solicitação de scan em fluxos suportados | Por documento, via fila, `afterCommit`; job único por identidade configurada | Cadência sob procura; requer worker e scanner configurados. Upload/publicação não confirma scan limpo |
+| Comparar compatibilidade MNE (`CompareMneBusiness`) | Alteração de negócio que agenda comparação | Por alteração aplicável, em fila específica e `afterCommit` | Trabalho assíncrono/sombra; volume real desconhecido |
+| Notificar recepção de interesse (`NotifyInterestReceived`) | Disparo esperado após recepção de interesse | Job existe, mas não foi localizada chamada a `dispatch()` no código consultado; frequência de execução não confirmada | Tratar como capacidade prevista até localizar/activar o disparo; entrega efectiva também depende de configuração e worker |
+| Auditoria, revisões e eventos de domínio | Acção de utilizador/sistema | No momento da operação que os gera | Orientado a evento; não há taxa histórica neste levantamento |
+| Outbox/inbox e sincronização externa | Evento de domínio ou mensagem externa | Sem periodicidade operacional confirmada neste código/documentação consultada | Estrutura preparada; documentação aponta sincronização externa real como pendente/não activada |
+
+### 6.2 Frequência por categoria de actividade
+
+| Categoria | Frequência funcional esperada | O que é possível afirmar |
+|---|---|---|
+| Leituras públicas (home, catálogo, oportunidade, negócio, mapas/referências) | Sob procura do visitante | Há endpoints/páginas; sem logs ou analytics não se quantificam consultas |
+| Escritas de investidor (interesses, favoritos, submissões, mensagens, perfil) | Sob acção do utilizador | São iniciadas por pedido explícito; não há volume observado disponível |
+| Gestão (revisão, publicação, CRM, regras, zonas, catálogo) | Sob trabalho de gestores autorizados | Fluxos e protecções documentados; frequência por papel não medida |
+| Simulação e rascunhos | Sob utilização do simulador; rascunhos podem ser actualizados/retomados | Rota e jobs encontrados; não assumir execução periódica nem cálculo fiscal por guardar rascunho |
+| Uploads e análise documental | Sob envio/reanálise de documento | Job de scan é disparado por fluxos suportados; scan e publicação são estados distintos |
+| Auditoria | Sob operações auditadas | A frequência acompanha as operações instrumentadas; cobertura total precisa de confirmação por fluxo |
+| Regras fiscais e fontes | Sob processo de revisão/aprovação e alteração normativa | Não há calendário fixo; fonte publicada não activa automaticamente cálculo |
+| Integrações externas | Não determinável/activação pendente | Tabelas de integração e documentação não são prova de entrega ou sincronização real |
+
+### 6.3 Frequência observada versus frequência de execução
+
+Não foram disponibilizados logs, contagens de `audit_events`, filas, analytics, pedidos HTTP ou exportação da base activa. Por isso, **não é possível apresentar eventos por hora/dia/mês, sazonalidade, taxa de falhas ou utilizadores activos**. A cadência de 15 minutos é apenas o intervalo configurado para o comando agendado. Para apurar frequência real, recolher métricas autorizadas por tipo de evento, intervalo temporal e resultado, sem expor dados pessoais; documentar período da amostra, filtros, retenção e origem. Não inferir métricas a partir de seeders, testes, screenshots ou schema.
+
+## 7. Sequência de alto nível
+
+```text
+Visita pública
+  -> pesquisa catálogo/oportunidades/negócios/território
+  -> interesse, candidatura, assistência ou simulação
+  -> autenticação e consentimento quando exigidos
+  -> gravação do pedido/rascunho e histórico
+  -> trabalho assíncrono quando aplicável (scan, cálculo, notificação)
+  -> revisão por responsável autorizado
+  -> decisão, comunicação ou publicação com autorização
+  -> auditoria e eventual integração externa homologada
+```
+
+## 8. Regras transversais que afectam os fluxos
+
+- Disponibilidade para consulta, situação jurídica/documental e uso em regra/cálculo são estados independentes.
+- Importar ou publicar documento não activa regra nem cálculo fiscal.
+- Relações sem citação/evidência verificada devem ficar pendentes e identificadas.
+- Guardar um rascunho não equivale a submeter ou aprovar.
+- A divulgação obedece à autorização registada e ao seu âmbito.
+- Documento original, proveniência, identificador, edição/data, hash e histórico devem ser preservados; não marcar autenticidade, vigência, direitos ou scan como confirmados sem evidência.
+- Integração desenhada (outbox/inbox) não equivale a sincronização activa.
+- Alterações a dados activos exigem confirmação de backup/restauro e acção autenticada necessária; testes/migrações devem usar exclusivamente base QA isolada, conforme `AGENTS.md`.
+
+## 9. Limitações e pontos para validação
+
+1. A cobertura implementada de cada UC varia; alguns documentos descrevem trabalho parcial, proposto ou bloqueado. Consultar `docs/investmoz/validation.md`, `completion-audit-2026-10-04.md`, `delivery-gaps.md` e os README de cada domínio antes de declarar operação concluída.
+2. O ERD resumido não substitui constraints/FKs, cardinalidades exactas, escopos de acesso ou estados enumerados no schema e OpenAPI.
+3. A frequência real de utilização e dos eventos de negócio permanece **indeterminada** sem telemetria operacional.
+4. Execução do scheduler, workers, ClamAV, notificações, SuiteCRM e restantes conectores depende de configuração e operação externa verificável.
+5. O inventário desta tarefa é do repositório, não dos ficheiros/anexos em armazenamento externo nem da base de dados de produção.
+
+## 10. Fontes locais principais
+
+- [README do projecto](../../README.md)
+- [Casos de uso detalhados](casos-de-uso-aplicacao-actual.md)
+- [ERD do schema reconciliado](erd.mmd)
+- [Arquitectura e migrations](architecture-and-migrations.md)
+- [Validação](validation.md) e [auditoria de conclusão](completion-audit-2026-10-04.md)
+- Rotas: `routes/web.php`, `routes/api.php`, `routes/investment.php`, `routes/partnerships.php`, `routes/land-assistance.php`, `routes/investment-zones.php`, `routes/territorial-registry.php`
+- Cadência: `routes/console.php`; trabalhos assíncronos em `app/Jobs/`

docs/investmoz/public-portal-context-images.json

@@ -0,0 +1,710 @@
+{
+  "date": "2026-10-23",
+  "decision": "Pedido expresso da Tempo: aplicar o anexo de identidade visual aos cinco cartões de Encontre o contexto do seu investimento.",
+  "instructionSource": {
+    "path": "C:\\Users\\jorge\\.codex\\attachments\\637b878f-1f58-490d-bd07-d5cd10ae2377\\Pasted text.txt",
+    "sha256": "fcc24dcce4b5df3f10e29add48052808d48ddcf674d052287854e11910e01d69"
+  },
+  "source": {
+    "type": "AI-generated photorealistic illustrative images",
+    "tool": "image_gen, built-in mode",
+    "skill": "C:/Users/jorge/.codex/skills/.system/imagegen/SKILL.md",
+    "externalPhotographsUsed": false,
+    "namedRealLocationsDepicted": false,
+    "note": "Cenas ilustrativas plausíveis, sem atribuição a instalações, pessoas, instituições ou projectos reais."
+  },
+  "analysisAndPlan": "docs/investmoz/public-portal-sections.md#fotografias-nos-cartões-de-contexto-do-investimento--23102026",
+  "filesChanged": [
+    "resources/js/pages/PortalInvestidor.tsx",
+    "resources/js/components/investment-context-cards.tsx",
+    "tools/portal-context-cards-qa.mjs",
+    "docs/investmoz/public-portal-sections.md",
+    "docs/investmoz/v2/auditoria-portal/matriz-requisitos.csv",
+    "docs/investmoz/public-portal-context-images.json"
+  ],
+  "images": [
+    {
+      "key": "clusters-agroindustria",
+      "prompt": "Use case: photorealistic-natural. Asset type: an individual navigation card photograph for a professional investment portal. Generate ONE clean, realistic editorial photograph in horizontal 16:9 composition. Natural daylight, realistic restrained colours, excellent photographic detail, balanced uncluttered framing, one clear subject readable at a small thumbnail size. Contemporary setting plausible in Mozambique in southern Africa. This is a generic illustrative scene, NOT a depiction or claim about any named real facility, project, landmark or institution. No text, lettering, titles, captions, logos, brands, watermarks, flags, official emblems, maps, diagrams, graphical overlays, UI elements, collages, artificial colour filters, futuristic architecture or advertising poster treatment. Realistic people, hands, equipment and perspective; dignified candid activity instead of posed stock photography. Subject: a modest, well maintained agro-processing packing facility linking commercial agriculture to local industry. Wide three-quarter view into an airy open-sided processing shed with pale walls and a few orderly wooden or reusable produce crates, stainless processing/sorting benches and an unobtrusive commercial agricultural field visible beyond. Two Black southern African workers in clean practical workwear sorting harvested vegetables naturally, faces not prominent. Show production and transformation together in ONE genuine-looking continuous scene, no montage. Clear simple geometry, warm-neutral sunlight, subtle vegetation.",
+      "source": "C:\\Users\\jorge\\.codex\\generated_images\\01a167bd-3f26-71a0-8ec3-3f17519d2bfd\\exec-f72e66b0-d788-4476-8b20-c39b22d5d6dc.png",
+      "original": "outputs/investment-context-20261023/originals/clusters-agroindustria.png",
+      "originalSha256": "75e04a694081ab757831fc9b37323949d09806e622c83d07588fc47c423c9033",
+      "originalDimensions": {
+        "width": 1672,
+        "height": 941
+      },
+      "derivatives": [
+        {
+          "file": "public/images/investment-context/clusters-agroindustria.webp",
+          "width": 960,
+          "height": 540,
+          "bytes": 116796,
+          "sha256": "12494b31ab551cffb79f81c7d1519c0c4a2d4236e7f129bec1ce32251b39d847"
+        },
+        {
+          "file": "public/images/investment-context/clusters-agroindustria-480.webp",
+          "width": 480,
+          "height": 270,
+          "bytes": 42060,
+          "sha256": "76e3152c99ed188f748542dcf0464787307dbdc1c6299e7264dfd1bd86ad75e3"
+        },
+        {
+          "file": "public/images/investment-context/clusters-agroindustria-fallback.webp",
+          "width": 240,
+          "height": 135,
+          "bytes": 9596,
+          "sha256": "9f668da50f7d64955b31940d239b420ac18dbb76a8120c8bedab3f2c04710288"
+        }
+      ]
+    },
+    {
+      "key": "corredores-logisticos",
+      "prompt": "Use case: photorealistic-natural. Asset type: an individual navigation card photograph for a professional investment portal. Generate ONE clean, realistic editorial photograph in horizontal 16:9 composition. Natural daylight, realistic restrained colours, excellent photographic detail, balanced uncluttered framing, one clear subject readable at a small thumbnail size. Contemporary setting plausible in Mozambique in southern Africa. This is a generic illustrative scene, NOT a depiction or claim about any named real facility, project, landmark or institution. No text, lettering, titles, captions, logos, brands, watermarks, flags, official emblems, maps, diagrams, graphical overlays, UI elements, collages, artificial colour filters, futuristic architecture or advertising poster treatment. Realistic people, hands, equipment and perspective; dignified candid activity instead of posed stock photography. Subject: a commercial freight terminal serving a southern African logistics corridor. Elevated medium-wide viewpoint showing an orderly short line of unbranded freight containers, one realistic container-handling crane and a freight truck on a paved lane, with a calm strip of water and low coastal industrial vegetation in the distance. Infrastructure of credible modest contemporary scale, generic and unidentifiable; do not reproduce or name Maputo, Beira, Nacala or any real port. Spatially coherent containers, road and handling equipment; clean clear subject with no excessive machinery.",
+      "source": "C:\\Users\\jorge\\.codex\\generated_images\\01a167bd-3f26-71a0-8ec3-3f17519d2bfd\\exec-0363da23-f9cb-413b-bb64-024539085c4b.png",
+      "original": "outputs/investment-context-20261023/originals/corredores-logisticos-v2.png",
+      "originalSha256": "2151d1a59265c6f7151d18af6ef6ad78f9fc6e0cd58ac9cc5c64b50a25c5058e",
+      "originalDimensions": {
+        "width": 1672,
+        "height": 941
+      },
+      "derivatives": [
+        {
+          "file": "public/images/investment-context/corredores-logisticos-v2.webp",
+          "width": 960,
+          "height": 540,
+          "bytes": 85184,
+          "sha256": "1939c26df297588b6c3e5ea08b700d4cda5d1183cf3e5faed06a1ca060d2475e"
+        },
+        {
+          "file": "public/images/investment-context/corredores-logisticos-v2-480.webp",
+          "width": 480,
+          "height": 270,
+          "bytes": 26222,
+          "sha256": "06dc0e7126cb2c13eb3f9a98f6ee58f5d64f9d07c28620975f744f263744fe15"
+        },
+        {
+          "file": "public/images/investment-context/corredores-logisticos-v2-fallback.webp",
+          "width": 240,
+          "height": 135,
+          "bytes": 5334,
+          "sha256": "f9fd6e6c3a2d4654df1a8fdb287e122f1889b5d318c104c4816ee393c793e242"
+        }
+      ],
+      "selectedSource": "C:\\Users\\jorge\\.codex\\generated_images\\01a167bd-3f26-71a0-8ec3-3f17519d2bfd\\exec-c2cff7da-d602-4191-9aca-380918a09619.png",
+      "editPrompt": "Edit the provided photograph: REMOVE THE ENTIRE FOREGROUND TRUCK, including cab, wheels, long trailer and the red freight container on that trailer. The big truck at lower left/centre must be completely gone. Replace the removed truck's area with a continuous empty realistic paved road surface matching the surrounding pavement and road markings. Leave the stacked stationary freight containers along the quay, the water, the large port crane, the lifted container and workers. All remaining equipment and containers should have plain surfaces without readable lettering, logos, numbers or brands. No new truck, vehicle, symbol, text or overlay. Keep a single clean editorial photograph, natural lighting and horizontal 16:9 framing. Generic commercial port scene, not a named real facility."
+    },
+    {
+      "key": "projectos-ancora",
+      "prompt": "Use case: photorealistic-natural. Asset type: an individual navigation card photograph for a professional investment portal. Generate ONE clean, realistic editorial photograph in horizontal 16:9 composition. Natural daylight, realistic restrained colours, excellent photographic detail, balanced uncluttered framing, one clear subject readable at a small thumbnail size. Contemporary setting plausible in Mozambique in southern Africa. This is a generic illustrative scene, NOT a depiction or claim about any named real facility, project, landmark or institution. No text, lettering, titles, captions, logos, brands, watermarks, flags, official emblems, maps, diagrams, graphical overlays, UI elements, collages, artificial colour filters, futuristic architecture or advertising poster treatment. Realistic people, hands, equipment and perspective; dignified candid activity instead of posed stock photography. Subject: a small team of two Black southern African engineering professionals, one woman and one man, in realistic hard hats and restrained protective workwear, seen candidly from a three-quarter rear angle reviewing an unmarked folded technical plan at a utility-scale solar installation. Low rows of realistic blue solar panels and a simple low service building recede into a dry green southern African landscape. No readable drawing or numbers on the plan. Focus on credible engineering and investment project scale; clean composition, quiet professional atmosphere, no landmark or company identifiers.",
+      "source": "C:\\Users\\jorge\\.codex\\generated_images\\01a167bd-3f26-71a0-8ec3-3f17519d2bfd\\exec-19fcd882-542b-43c9-81e7-593fd75083f6.png",
+      "original": "outputs/investment-context-20261023/originals/projectos-ancora.png",
+      "originalSha256": "f23cf6e64307a280f3aa58741454a23480ac28fcae01a0810adf134b783a3a74",
+      "originalDimensions": {
+        "width": 1672,
+        "height": 941
+      },
+      "derivatives": [
+        {
+          "file": "public/images/investment-context/projectos-ancora.webp",
+          "width": 960,
+          "height": 540,
+          "bytes": 77114,
+          "sha256": "de0b59774246fee982761de59618b3e7707c3fe30f2b1bcbb6017d4dce53c4dc"
+        },
+        {
+          "file": "public/images/investment-context/projectos-ancora-480.webp",
+          "width": 480,
+          "height": 270,
+          "bytes": 29484,
+          "sha256": "268e405112ed341fce3c9792c3caa47053984100cd4a204453e31bbe5db6e890"
+        },
+        {
+          "file": "public/images/investment-context/projectos-ancora-fallback.webp",
+          "width": 240,
+          "height": 135,
+          "bytes": 6750,
+          "sha256": "db7e4b4382e09eb6b4f9f2a4603ccac4b4eacc53ba0f6776429e33dbf5131954"
+        }
+      ]
+    },
+    {
+      "key": "educacao-formacao",
+      "prompt": "Use case: photorealistic-natural. Asset type: an individual navigation card photograph for a professional investment portal. Generate ONE clean, realistic editorial photograph in horizontal 16:9 composition. Natural daylight, realistic restrained colours, excellent photographic detail, balanced uncluttered framing, one clear subject readable at a small thumbnail size. Contemporary setting plausible in Mozambique in southern Africa. This is a generic illustrative scene, NOT a depiction or claim about any named real facility, project, landmark or institution. No text, lettering, titles, captions, logos, brands, watermarks, flags, official emblems, maps, diagrams, graphical overlays, UI elements, collages, artificial colour filters, futuristic architecture or advertising poster treatment. Realistic people, hands, equipment and perspective; dignified candid activity instead of posed stock photography. Subject: a candid technical training classroom with three Black southern African young adult students of different genders and one instructor working together at a practical electronics and computing workbench. Bright modest well maintained vocational classroom, natural window light, simple laboratory equipment and unbranded closed or angled laptops whose screens have no visible interface or text. Focus on two students engaged in a realistic small hands-on electronics exercise with normal anatomy and correct equipment proportions. Dignified contemporary clothing, natural concentration, professional skills and human capital investment, no posed smiles or stereotypes.",
+      "source": "C:\\Users\\jorge\\.codex\\generated_images\\01a167bd-3f26-71a0-8ec3-3f17519d2bfd\\exec-d21314d7-c726-41ad-862c-3c8b64df6b53.png",
+      "original": "outputs/investment-context-20261023/originals/educacao-formacao.png",
+      "originalSha256": "e59ec599e8c64ab84195d0cb37871d3102df178a13275806ca3b7f98e6bfa895",
+      "originalDimensions": {
+        "width": 1672,
+        "height": 941
+      },
+      "derivatives": [
+        {
+          "file": "public/images/investment-context/educacao-formacao.webp",
+          "width": 960,
+          "height": 540,
+          "bytes": 68224,
+          "sha256": "e3e5dbd292cac555a45bcbd94a0fa6b60e6b710debc0c827c68603f40bfb8a28"
+        },
+        {
+          "file": "public/images/investment-context/educacao-formacao-480.webp",
+          "width": 480,
+          "height": 270,
+          "bytes": 27384,
+          "sha256": "d3b743fbba7a8cb40e45999ee8c345cbfc0332cf85f5c5c2d6a5cf1240a395e4"
+        },
+        {
+          "file": "public/images/investment-context/educacao-formacao-fallback.webp",
+          "width": 240,
+          "height": 135,
+          "bytes": 7156,
+          "sha256": "0b2a12898043c57cf4354b54ebcba8adec8d41b3886bc574584ccc12af7b1e4c"
+        }
+      ]
+    },
+    {
+      "key": "documentos-formularios",
+      "prompt": "Use case: photorealistic-natural. Asset type: an individual navigation card photograph for a professional investment portal. Generate ONE clean, realistic editorial photograph in horizontal 16:9 composition. Natural daylight, realistic restrained colours, excellent photographic detail, balanced uncluttered framing, one clear subject readable at a small thumbnail size. Contemporary setting plausible in Mozambique in southern Africa. This is a generic illustrative scene, NOT a depiction or claim about any named real facility, project, landmark or institution. No text, lettering, titles, captions, logos, brands, watermarks, flags, official emblems, maps, diagrams, graphical overlays, UI elements, collages, artificial colour filters, futuristic architecture or advertising poster treatment. Realistic people, hands, equipment and perspective; dignified candid activity instead of posed stock photography. Subject: a close-medium editorial photograph of a tidy modern administrative office desk where a Black southern African professional in a plain light blue shirt is naturally reviewing organised business documentation. Frame hands, desk and partial torso, no prominent portrait. Neat neutral folders, a few sheets with only faint out-of-focus non-readable printing, a pen and an unbranded laptop angled away with no visible UI. Soft window light, white and pale neutral surfaces with subtle blue accents. Absolutely no readable personal data, invented official seals or highlighted fake text; realistic fingers and documents, calm minimal composition.",
+      "source": "C:\\Users\\jorge\\.codex\\generated_images\\01a167bd-3f26-71a0-8ec3-3f17519d2bfd\\exec-f1c8e22e-6885-4578-ac7d-02692c5cc071.png",
+      "original": "outputs/investment-context-20261023/originals/documentos-formularios.png",
+      "originalSha256": "cfbd38a9cc9b9acf35f38220f5bd9c1ab1feafe411bc1d4bbdb3658de557e052",
+      "originalDimensions": {
+        "width": 1672,
+        "height": 941
+      },
+      "derivatives": [
+        {
+          "file": "public/images/investment-context/documentos-formularios.webp",
+          "width": 960,
+          "height": 540,
+          "bytes": 43002,
+          "sha256": "70ddea3256e6a8d981b1fae5ee7b4de6c910d757137b79a59306c268c278402f"
+        },
+        {
+          "file": "public/images/investment-context/documentos-formularios-480.webp",
+          "width": 480,
+          "height": 270,
+          "bytes": 17996,
+          "sha256": "436865c948acbb7b6e9e482bef8f5bd626c6960f2f155608e40dfcd0e76b84cb"
+        },
+        {
+          "file": "public/images/investment-context/documentos-formularios-fallback.webp",
+          "width": 240,
+          "height": 135,
+          "bytes": 4958,
+          "sha256": "fad6a6ab825a82ec2541d2e0c6de9d85486e4bbca159b912f87bec9cc0aeeba5"
+        }
+      ]
+    }
+  ],
+  "primaryImagesBytesTotal": 390320,
+  "responsive480ImagesBytesTotal": 143146,
+  "implementation": {
+    "gridColumns": [
+      1,
+      2,
+      4
+    ],
+    "aspectRatio": "16:9",
+    "responsiveImages": true,
+    "lazyLoading": true,
+    "altLanguage": "pt",
+    "fallback": "Derivado pequeno da própria imagem; se também falhar, estado acessível Imagem indisponível, com dimensão reservada e link mantido.",
+    "globalCSSChanged": false,
+    "businessLogicChanged": false,
+    "databaseChanged": false,
+    "heroChanged": false
+  },
+  "visualReview": "Cinco composições individuais distintas, cores naturais e luz editorial; sem títulos/colagens ou mapas. A composição de Corredores foi revista para remover o camião com marca. Capturas em computador e telemóvel inspeccionadas.",
+  "verification": {
+    "browser": {
+      "results": [
+        {
+          "width": 320,
+          "dpr": 1,
+          "columns": 1,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria-480.webp",
+              "width": 320,
+              "height": 180
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2-480.webp",
+              "width": 320,
+              "height": 180
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora-480.webp",
+              "width": 320,
+              "height": 180
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao-480.webp",
+              "width": 320,
+              "height": 180
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios-480.webp",
+              "width": 320,
+              "height": 180
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 390,
+          "dpr": 2,
+          "columns": 1,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria.webp",
+              "width": 389,
+              "height": 219
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2.webp",
+              "width": 389,
+              "height": 219
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora.webp",
+              "width": 389,
+              "height": 219
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao.webp",
+              "width": 389,
+              "height": 219
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios.webp",
+              "width": 389,
+              "height": 219
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 768,
+          "dpr": 1,
+          "columns": 2,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria-480.webp",
+              "width": 384,
+              "height": 216
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2-480.webp",
+              "width": 384,
+              "height": 216
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora-480.webp",
+              "width": 384,
+              "height": 216
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao-480.webp",
+              "width": 384,
+              "height": 216
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios-480.webp",
+              "width": 384,
+              "height": 216
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 1024,
+          "dpr": 1,
+          "columns": 4,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria-480.webp",
+              "width": 256,
+              "height": 144
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2-480.webp",
+              "width": 256,
+              "height": 144
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora-480.webp",
+              "width": 256,
+              "height": 144
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao-480.webp",
+              "width": 256,
+              "height": 144
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios-480.webp",
+              "width": 256,
+              "height": 144
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 1440,
+          "dpr": 2,
+          "columns": 4,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios.webp",
+              "width": 266,
+              "height": 149
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 1920,
+          "dpr": 1,
+          "columns": 4,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria-480.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2-480.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora-480.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao-480.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios-480.webp",
+              "width": 266,
+              "height": 149
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "fail": "primary",
+          "status": "passed"
+        },
+        {
+          "fail": "all",
+          "status": "passed"
+        }
+      ],
+      "errors": [],
+      "navigation": [
+        "/clusters",
+        "/corredores",
+        "/projectos-ancora",
+        "/educacao",
+        "/documentos"
+      ],
+      "databaseAccess": false
+    },
+    "script": "tools/portal-context-cards-qa.mjs",
+    "screenshots": [
+      "outputs/investment-context-20261023/cards-1024-dpr1.png",
+      "outputs/investment-context-20261023/cards-1440-dpr2.png",
+      "outputs/investment-context-20261023/cards-1920-dpr1.png",
+      "outputs/investment-context-20261023/cards-320-dpr1.png",
+      "outputs/investment-context-20261023/cards-390-dpr2.png",
+      "outputs/investment-context-20261023/cards-768-dpr1.png",
+      "outputs/investment-context-20261023/fallback-all.png",
+      "outputs/investment-context-20261023/fallback-primary.png"
+    ],
+    "types": {
+      "command": "npm run types:check",
+      "exitCode": 0
+    },
+    "lint": {
+      "files": [
+        "resources/js/components/investment-context-cards.tsx",
+        "resources/js/pages/PortalInvestidor.tsx",
+        "tools/portal-context-cards-qa.mjs"
+      ],
+      "exitCode": 0
+    },
+    "build": {
+      "command": "npm run build",
+      "exitCode": 0,
+      "pageAsset": "assets/PortalInvestidor-fh5VZanx.js",
+      "log": "outputs/investment-context-20261023/build-local.log"
+    }
+  },
+  "scope": "Aplicado no código e pacote locais. API e navegação simuladas na verificação visual; sem dados activos ou publicação externa.",
+  "matrixReferences": [
+    "MASTER-efd550fd-0104",
+    "MASTER-55050f60-0001"
+  ],
+  "acceptanceLimit": "Prova restrita à apresentação e navegação dos cinco cartões; não encerra critérios funcionais mais amplos da matriz.",
+  "layoutRevision": {
+    "date": "2026-10-23",
+    "decision": "Pedido expresso da Tempo: título a vermelho e menos espaço em branco dentro dos cartões.",
+    "changes": "Título no vermelho #ed1c24; removidas alturas mínimas de título e descrição; preenchimento 20→16 px, intervalo 8→6 px e entrelinhas 28/24→24/20 px. Mantidos imagens, conteúdos, links e alinhamento por linha da grelha.",
+    "browser": {
+      "results": [
+        {
+          "width": 320,
+          "dpr": 1,
+          "columns": 1,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria-480.webp",
+              "width": 320,
+              "height": 180
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2-480.webp",
+              "width": 320,
+              "height": 180
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora-480.webp",
+              "width": 320,
+              "height": 180
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao-480.webp",
+              "width": 320,
+              "height": 180
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios-480.webp",
+              "width": 320,
+              "height": 180
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 390,
+          "dpr": 2,
+          "columns": 1,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria.webp",
+              "width": 389,
+              "height": 219
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2.webp",
+              "width": 389,
+              "height": 219
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora.webp",
+              "width": 389,
+              "height": 219
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao.webp",
+              "width": 389,
+              "height": 219
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios.webp",
+              "width": 389,
+              "height": 219
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 768,
+          "dpr": 1,
+          "columns": 2,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria-480.webp",
+              "width": 384,
+              "height": 216
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2-480.webp",
+              "width": 384,
+              "height": 216
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora-480.webp",
+              "width": 384,
+              "height": 216
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao-480.webp",
+              "width": 384,
+              "height": 216
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios-480.webp",
+              "width": 384,
+              "height": 216
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 1024,
+          "dpr": 1,
+          "columns": 4,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria-480.webp",
+              "width": 256,
+              "height": 144
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2-480.webp",
+              "width": 256,
+              "height": 144
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora-480.webp",
+              "width": 256,
+              "height": 144
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao-480.webp",
+              "width": 256,
+              "height": 144
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios-480.webp",
+              "width": 256,
+              "height": 144
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 1440,
+          "dpr": 2,
+          "columns": 4,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios.webp",
+              "width": 266,
+              "height": 149
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "width": 1920,
+          "dpr": 1,
+          "columns": 4,
+          "photos": [
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/clusters-agroindustria-480.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/corredores-logisticos-v2-480.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/projectos-ancora-480.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/educacao-formacao-480.webp",
+              "width": 266,
+              "height": 149
+            },
+            {
+              "src": "http://127.0.0.1:5174/images/investment-context/documentos-formularios-480.webp",
+              "width": 266,
+              "height": 149
+            }
+          ],
+          "status": "passed"
+        },
+        {
+          "fail": "primary",
+          "status": "passed"
+        },
+        {
+          "fail": "all",
+          "status": "passed"
+        }
+      ],
+      "errors": [],
+      "navigation": [
+        "/clusters",
+        "/corredores",
+        "/projectos-ancora",
+        "/educacao",
+        "/documentos"
+      ],
+      "databaseAccess": false
+    },
+    "lintExitCode": 0,
+    "buildExitCode": 0,
+    "pageAsset": "assets/PortalInvestidor-CYCMhSzW.js",
+    "screenshots": [
+      "outputs/investment-context-compact-20261023/cards-1024-dpr1.png",
+      "outputs/investment-context-compact-20261023/cards-1440-dpr2.png",
+      "outputs/investment-context-compact-20261023/cards-1920-dpr1.png",
+      "outputs/investment-context-compact-20261023/cards-320-dpr1.png",
+      "outputs/investment-context-compact-20261023/cards-390-dpr2.png",
+      "outputs/investment-context-compact-20261023/cards-768-dpr1.png"
+    ],
+    "databaseChanged": false
+  }
+}

docs/investmoz/public-portal-hero-validation.json

@@ -0,0 +1,355 @@
+{
+  "date": "2026-10-23",
+  "decision": "Pedido expresso da Tempo: adaptar hero, imagens e pesquisa da referência, preservando a informação e os comportamentos equivalentes do V2.",
+  "sourceProject": "D:/Projects/Tempo_Investidor/investidor",
+  "targetProject": "D:/Projects/Tempo_Investidor/Investidor-V2",
+  "planAndAnalysis": "docs/investmoz/public-portal-sections.md#adequação-do-hero--23102026",
+  "implementation": [
+    "resources/js/components/portal-hero.tsx",
+    "resources/js/pages/PortalInvestidor.tsx"
+  ],
+  "assets": [
+    {
+      "source": "D:\\Projects\\Tempo_Investidor\\investidor\\public\\images\\hero\\hero-1.png",
+      "original": "public\\images\\hero\\hero-1.png",
+      "sha256": "3c9246169025b9b1b4d1d10fb51c1f644123984bde56c6c2d9bf869d851024fc",
+      "bytes": 2315768,
+      "webpBytes": 94012,
+      "mobileBytes": 38804
+    },
+    {
+      "source": "D:\\Projects\\Tempo_Investidor\\investidor\\public\\images\\hero\\hero-3.jpg",
+      "original": "public\\images\\hero\\hero-3.jpg",
+      "sha256": "91377213b6286aca7ee4af90860a7dc7a75fa08a165ef7b3192081db43f92dff",
+      "bytes": 9875137,
+      "webpBytes": 140342,
+      "mobileBytes": 32998
+    }
+  ],
+  "desktopBytesTotal": 234354,
+  "mobileBytesTotal": 71802,
+  "originalBytesTotal": 12190905,
+  "verification": {
+    "browser": {
+      "results": [
+        {
+          "width": 320,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 390,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 768,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 1440,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 1920,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 1440,
+          "reducedMotion": "no-preference",
+          "status": "passed"
+        }
+      ],
+      "errors": [],
+      "requests": [
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=",
+        "/oportunidades",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique"
+      ],
+      "databaseAccess": false
+    },
+    "browserScript": "tools/portal-hero-qa.mjs",
+    "screenshots": [
+      "outputs/portal-hero-20261023/after-1440-no-preference.png",
+      "outputs/portal-hero-20261023/after-1440-reduce.png",
+      "outputs/portal-hero-20261023/after-1440-second-image.png",
+      "outputs/portal-hero-20261023/after-1920-reduce.png",
+      "outputs/portal-hero-20261023/after-320-reduce.png",
+      "outputs/portal-hero-20261023/after-390-reduce.png",
+      "outputs/portal-hero-20261023/after-768-reduce.png",
+      "outputs/portal-hero-20261023/before-1440-reduce.png",
+      "outputs/portal-hero-20261023/before-390-reduce.png"
+    ],
+    "additionalCases": [
+      "pesquisa por Enter e botão",
+      "ordem do teclado: campo → botão",
+      "query acentuada e pontuação preservadas",
+      "remoção de espaços exteriores",
+      "pesquisa vazia abre catálogo",
+      "CTA abre oportunidades",
+      "API indisponível mantém indicadores indeterminados",
+      "contagens zero preservadas",
+      "duas imagens carregadas",
+      "selecção manual",
+      "pausa e retoma explícitas",
+      "foco pausa rotação",
+      "rotação automática após perda de foco",
+      "movimento reduzido",
+      "entrada documental e cabeçalho preservados"
+    ],
+    "existingFrontendTests": {
+      "command": "node --test tests/frontend/portal-api.test.mjs tests/frontend/portal-navigation.test.mjs",
+      "passed": 20
+    },
+    "typecheck": {
+      "command": "npm run types:check",
+      "exitCode": 0
+    },
+    "lint": {
+      "files": [
+        "resources/js/components/portal-hero.tsx",
+        "resources/js/pages/PortalInvestidor.tsx",
+        "tools/portal-hero-qa.mjs"
+      ],
+      "exitCode": 0
+    },
+    "qaBuild": {
+      "command": "INVESTMOZ_QA_BUILD=1 npm run build",
+      "exitCode": 0
+    },
+    "localBuild": {
+      "command": "npm run build",
+      "exitCode": 0,
+      "pageAsset": "assets/PortalInvestidor-MsUeKoJQ.js"
+    }
+  },
+  "matrix": {
+    "file": "docs/investmoz/v2/auditoria-portal/matriz-requisitos.csv",
+    "referencesAdded": [
+      "MASTER-9dee08d0-0016",
+      "MASTER-efd550fd-0104",
+      "MASTER-55050f60-0001"
+    ],
+    "rowCount": 3422,
+    "criteriaAndStatesPreserved": true
+  },
+  "scope": {
+    "appliedToLocalCodeAndBuild": true,
+    "activeDatabaseChanged": false,
+    "migrationsRun": false,
+    "externalDeploymentPerformed": false,
+    "backendSearchReimplemented": false
+  },
+  "limits": "Verificação visual com dados sintéticos; pesquisa continua limitada ao catálogo de oportunidades. Os critérios mais amplos da matriz permanecem no estado anterior.",
+  "latestRevision": {
+    "id": "hero-no-controls-20261023",
+    "date": "2026-10-23",
+    "decision": "Pedido expresso da Tempo: remover do hero as duas bolinhas e o botão de pausa das imagens.",
+    "implementation": "Removidos grupo de controlos, ícones Pause/Play e estado de pausa manual. Preservadas troca automática, escrita dinâmica, pesquisa e preferência de movimento reduzido.",
+    "browser": {
+      "results": [
+        {
+          "width": 320,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 390,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 768,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 1440,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 1920,
+          "reducedMotion": "reduce",
+          "status": "passed"
+        },
+        {
+          "width": 390,
+          "reducedMotion": "no-preference",
+          "status": "passed"
+        },
+        {
+          "width": 1440,
+          "reducedMotion": "no-preference",
+          "status": "passed"
+        }
+      ],
+      "errors": [],
+      "requests": [
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=",
+        "/oportunidades",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+        "/oportunidades?q=",
+        "/oportunidades",
+        "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique"
+      ],
+      "databaseAccess": false
+    },
+    "screenshots": [
+      "outputs/portal-hero-no-controls-20261023/after-1440-no-preference.png",
+      "outputs/portal-hero-no-controls-20261023/after-1440-reduce.png",
+      "outputs/portal-hero-no-controls-20261023/after-1920-reduce.png",
+      "outputs/portal-hero-no-controls-20261023/after-320-reduce.png",
+      "outputs/portal-hero-no-controls-20261023/after-390-no-preference.png",
+      "outputs/portal-hero-no-controls-20261023/after-390-reduce.png",
+      "outputs/portal-hero-no-controls-20261023/after-768-reduce.png",
+      "outputs/portal-hero-no-controls-20261023/second-image-1440.png",
+      "outputs/portal-hero-no-controls-20261023/second-image-390.png",
+      "outputs/portal-hero-no-controls-20261023/typed-1440.png",
+      "outputs/portal-hero-no-controls-20261023/typed-390.png"
+    ],
+    "checks": {
+      "lintExitCode": 0,
+      "buildExitCode": 0,
+      "pageAsset": "assets/PortalInvestidor-T0B6aoV_.js"
+    },
+    "scope": {
+      "appliedLocally": true,
+      "databaseAccess": false,
+      "externalDeployment": false
+    }
+  },
+  "revisionHistory": [
+    {
+      "id": "hero-typing-20261023",
+      "date": "2026-10-23",
+      "decision": "Pedido expresso da Tempo: título e frase dinâmicos como na referência; remover Termos de uso do hero.",
+      "plan": [
+        "Analisar a sequência de escrita da referência.",
+        "Animar o título e depois a frase, mantendo os textos do V2 e reservando a dimensão final.",
+        "Reiniciar a escrita na troca de imagem e integrar pausa/retoma e preferência de movimento reduzido.",
+        "Remover o link e o ícone jurídico do hero.",
+        "Demonstrar comportamento em computador e telemóvel e compilar o pacote local."
+      ],
+      "files": [
+        "resources/js/components/portal-hero.tsx",
+        "resources/css/app.css",
+        "tools/portal-hero-qa.mjs"
+      ],
+      "browser": {
+        "results": [
+          {
+            "width": 320,
+            "reducedMotion": "reduce",
+            "status": "passed"
+          },
+          {
+            "width": 390,
+            "reducedMotion": "reduce",
+            "status": "passed"
+          },
+          {
+            "width": 768,
+            "reducedMotion": "reduce",
+            "status": "passed"
+          },
+          {
+            "width": 1440,
+            "reducedMotion": "reduce",
+            "status": "passed"
+          },
+          {
+            "width": 1920,
+            "reducedMotion": "reduce",
+            "status": "passed"
+          },
+          {
+            "width": 390,
+            "reducedMotion": "no-preference",
+            "status": "passed"
+          },
+          {
+            "width": 1440,
+            "reducedMotion": "no-preference",
+            "status": "passed"
+          }
+        ],
+        "errors": [],
+        "requests": [
+          "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+          "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+          "/oportunidades?q=",
+          "/oportunidades",
+          "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+          "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+          "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+          "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique",
+          "/oportunidades?q=",
+          "/oportunidades",
+          "/oportunidades?q=energia%20%26%20Nampula%20%2F%20Mo%C3%A7ambique"
+        ],
+        "databaseAccess": false
+      },
+      "screenshots": [
+        "outputs/portal-hero-typing-20261023/after-1440-no-preference.png",
+        "outputs/portal-hero-typing-20261023/after-1440-reduce.png",
+        "outputs/portal-hero-typing-20261023/after-1440-second-image.png",
+        "outputs/portal-hero-typing-20261023/after-1920-reduce.png",
+        "outputs/portal-hero-typing-20261023/after-320-reduce.png",
+        "outputs/portal-hero-typing-20261023/after-390-no-preference.png",
+        "outputs/portal-hero-typing-20261023/after-390-reduce.png",
+        "outputs/portal-hero-typing-20261023/after-768-reduce.png",
+        "outputs/portal-hero-typing-20261023/typed-1440.png",
+        "outputs/portal-hero-typing-20261023/typed-390.png",
+        "outputs/portal-hero-typing-20261023/typing-1440.png",
+        "outputs/portal-hero-typing-20261023/typing-390.png"
+      ],
+      "demonstrated": [
+        "escrita progressiva",
+        "título antes da frase",
+        "texto completo no modo de movimento reduzido",
+        "nome acessível completo durante a escrita",
+        "pesquisa sem deslocamento durante a escrita",
+        "reinício na selecção manual e automática de imagem",
+        "pausa e retoma da escrita",
+        "cursor com pausa",
+        "Termos de uso ausente do hero",
+        "pesquisa, teclado, CTA, API indisponível e contagens zero preservados"
+      ],
+      "checks": {
+        "types": {
+          "command": "npm run types:check",
+          "exitCode": 0
+        },
+        "lint": {
+          "command": "vp lint resources/js/components/portal-hero.tsx tools/portal-hero-qa.mjs",
+          "exitCode": 0
+        },
+        "build": {
+          "command": "npm run build",
+          "exitCode": 0,
+          "pageAsset": "assets/PortalInvestidor-BbVHeTeI.js",
+          "log": "outputs/portal-hero-typing-20261023/build-local.log"
+        }
+      },
+      "scope": {
+        "appliedLocally": true,
+        "databaseAccess": false,
+        "externalDeployment": false
+      }
+    }
+  ]
+}

docs/investmoz/public-portal-sections.md

@@ -48,3 +48,91 @@ Edge headless: 11 páginas públicas/autenticação verificadas a 390×844, com
 Página inicial também verificada a 1440×1000. Cenário fiscal exercitado no navegador: base 1.000 × taxa 10% × (1 − redução 50%) = 50. Resultados em `public-portal-browser-validation.json`.
 
 Antes da migration local foi criado e restaurado o backup de 74 tabelas em `storage/app/private/portal-services-backup-20260927-090641/`. O backup completo anterior permanece em `C:/laragon/backups/portal-investidor-20260927-101224/` e representa o estado anterior a esta entrega.
+
+## Adequação do hero — 23/10/2026
+
+Origem: pedido expresso da Tempo nesta sessão para aproveitar o hero, as imagens e a barra de pesquisa de `D:/Projects/Tempo_Investidor/investidor`, usando a informação existente no V2. Aplicam-se as orientações permanentes do `AGENTS.md`, incluindo a distinção entre decisão da Tempo e escolha técnica, a preservação de dados e a separação de QA e activo.
+
+Análise prévia: a página de entrada real do V2 é `PortalInvestidor.tsx`, servida por `PortalServicesController::home`. A referência é `domains/investor-portal/components/homepage/homepage-hero.tsx`, montada em `InstitutionalHomepage`. A referência usa Inertia 2, Framer Motion, tradução e navegação diferentes; o V2 usa Inertia 3 e pesquisa de oportunidades. Copiar essas dependências e `/pesquisa` ou `/aviso-legal` directamente criaria incompatibilidades e destinos inexistentes.
+
+Plano executado:
+
+1. Registar a apresentação anterior em computador e telemóvel, com os componentes reais e dados sintéticos.
+2. Copiar os dois originais efectivamente usados pela referência (`hero-1.png` e `hero-3.jpg`), conferir SHA-256 e gerar derivados WebP para computador e telemóvel. `hero-2.png` não faz parte da rotação da referência.
+3. Extrair `components/portal-hero.tsx` e aplicar fotografias em rotação, texto centrado e pesquisa branca com botão vermelho. Preservar os textos do V2, contagens da API, sectores, documentos, apoio, cabeçalho e rodapé.
+4. Manter a pesquisa de oportunidades em `/oportunidades?q=`, incluindo pesquisa vazia e caracteres acentuados. Conservar “Consultar oportunidades” e “Planear finanças”. A primeira iteração acrescentou o acesso jurídico `/termos-de-uso` ao hero; foi removido na revisão expressamente pedida pela Tempo abaixo.
+5. Verificar apresentação, teclado, imagens, rotação, pausa, movimento reduzido, falha da API, contagens zero, TypeScript, lint e compilação. Compilar primeiro o pacote QA e depois os assets locais em `public/build`.
+
+Escolhas técnicas desta adaptação: React e transições CSS existentes, sem novas dependências; rotação de oito segundos, pausa por controlo explícito, foco, ponteiro ou separador oculto; apresentação estática quando o utilizador pede movimento reduzido. A primeira iteração apresentou o texto estático; a revisão abaixo introduz a escrita dinâmica pedida pela Tempo. O campo indica pesquisa de oportunidades e conserva exemplos que o catálogo suporta; esta alteração não implementa uma pesquisa global de legislação/licenciamento.
+
+Evidência reproduzível: `tools/portal-hero-qa.mjs`, com Vite local e Playwright configurável por `HERO_QA_PLAYWRIGHT`/`HERO_QA_CHROMIUM`. Fixtures e capturas em `outputs/portal-hero-20261023/`; síntese persistente em `public-portal-hero-validation.json`. Os testes de interface interceptam a API e a navegação Inertia, sem acesso a Laravel, base de dados ou serviços externos. A compilação local aplica os assets desta pasta; não representa publicação noutro servidor.
+
+Referências na matriz existente: `MASTER-efd550fd-0104` (composição da página), `MASTER-9dee08d0-0016` (contexto da pesquisa) e `MASTER-55050f60-0001` (entrada documental preservada). Esta prova cobre a adaptação visual e os percursos exercitados; não encerra os critérios funcionais mais amplos dessas linhas.
+
+### Revisão: escrita dinâmica e remoção do acesso jurídico no hero
+
+Decisão expressa da Tempo na continuação da sessão de 23/10/2026: animar “INVISTA EM MOÇAMBIQUE” e “Transforme informação em decisões e ideias em negócios reais.” como na página de referência, e remover “Termos de uso” do hero. A anterior apresentação estática e a inclusão desse link eram escolhas de implementação, agora substituídas pelo pedido do proprietário.
+
+Análise e plano executado: reproduzir a sequência da referência (espera inicial de 250 ms, título a 50 ms por carácter, intervalo de 150 ms e frase a 28 ms por carácter); reiniciar ao trocar de imagem; acrescentar o cursor intermitente; reservar a dimensão final de ambas as linhas para manter a pesquisa imóvel; remover o link e o ícone jurídico do hero; verificar em computador e telemóvel e compilar o pacote local.
+
+Implementação em `portal-hero.tsx`, com React existente e CSS do cursor em `app.css`, sem dependências novas. A pausa explícita suspende também a escrita, retomando do mesmo ponto. Quando o separador fica oculto a escrita pára; a preferência de movimento reduzido apresenta os dois textos completos. Leitores de ecrã recebem o texto completo uma única vez, independentemente do número de caracteres visíveis. Os temporizadores são limpos ao mudar de imagem ou desmontar o componente.
+
+O script `tools/portal-hero-qa.mjs` demonstra a escrita progressiva, a ordem título→frase, o reinício manual/automático, a pausa/retoma, a posição estável da pesquisa, o modo sem movimento e a ausência de “Termos de uso” no hero. As capturas e resultados desta revisão ficam em `outputs/portal-hero-typing-20261023/`, preservando a evidência anterior. Síntese e compilação final registadas na revisão de `public-portal-hero-validation.json`; referência acrescentada à linha existente `MASTER-efd550fd-0104`, sem encerrar o seu critério mais amplo.
+
+### Revisão: remoção dos controlos visíveis das imagens
+
+Pedido expresso da Tempo na continuação de 23/10/2026: remover do hero o grupo com o botão de pausa e as duas bolinhas de selecção de imagem. Removidos o grupo, os ícones e o estado de pausa manual. A troca automática de imagens e a escrita dinâmica permanecem; conservam-se a pausa da rotação por foco/ponteiro, a suspensão em separador oculto e a preferência de movimento reduzido. Esta decisão substitui os controlos visíveis introduzidos como escolha de implementação nas revisões anteriores.
+
+O script existente de interface foi adaptado para demonstrar a ausência dos controlos e a continuação da rotação automática, escrita e pesquisa, com capturas em `outputs/portal-hero-no-controls-20261023/`. Evidência e pacote local registados em `public-portal-hero-validation.json`, mantendo o histórico das revisões e os estados dos requisitos da matriz.
+
+## Fotografias nas etapas de Como Investir — 23/10/2026
+
+Origem: pedido expresso da Tempo para analisar e ilustrar exclusivamente os cartões “1. Explorar”, “2. Preparar” e “3. Acompanhar”. Aplicam-se as orientações permanentes de `AGENTS.md` de 12/10 e 22/10/2026; componentes e optimização de recursos são escolhas técnicas, sem novas regras operacionais.
+
+Análise e plano: os cartões existentes são âncoras estáticas na home React/Inertia, numa grelha de três colunas a partir de 768 px. Explorar liga a `/oportunidades` e representa a identificação de sector, território e oportunidade; Preparar liga a `/como-investir` e representa percurso/documentação; Acompanhar liga a `/balcao-virtual` e representa envio/consulta de pedido e protocolo. Os recursos locais existentes ilustram outras secções; preparar três fotografias distintas para evitar repetição. Gerar cenas editoriais plausíveis com `imagegen`, rever composição, guardar originais e versões WebP locais, integrar imagens 16:9 com dimensões reservadas e carregamento diferido, manter textos/destinos/título vermelho, verificar comportamento responsivo, navegação e falhas de imagem, compilar. Âmbito exclusivamente visual, sem alterações em dados, autenticação, apoio ou rodapé. Referência documental na linha existente `MASTER-efd550fd-0104`, sem criar outra matriz nem encerrar o critério mais amplo.
+
+Implementação: `components/investment-steps.tsx` reúne os três cartões, preservando títulos, descrições e âncoras. Fotografias individuais geradas com a ferramenta integrada `image_gen`, sem local ou projecto real atribuído: avaliação de oportunidade num parque empresarial genérico, preparação documental numa reunião e consulta de pedido no computador. Originais em `outputs/investment-steps-20261023/originals/`; recursos locais em `public/images/investment-steps/` com WebP 960×540, 480×270 e alternativa própria 240×135. Os cartões usam `srcset`, `sizes`, `loading="lazy"`, dimensões reservadas, corte 16:9, alt em português, foco visível e texto compacto com 16 px de preenchimento. Se também falhar a alternativa pequena, o cartão mantém a área reservada, descrição acessível e destino utilizável.
+
+Verificação desta secção: componentes reais com API sintética e sem base de dados, seis larguras de 320 a 1920 px, duas densidades de ecrã, três imagens distintas, texto/destinos conservados, navegação por teclado, ausência de transbordo e deslocamento no carregamento, falhas dos recursos principais e de todos os recursos. Oito cenários sem erros JavaScript. Fotografias, prompts, hashes, capturas, relatório de browser e compilação documentados em `public-portal-steps-images.json` e `outputs/investment-steps-20261023/`. Ajuste restrito a esta secção; apoio, acesso à gestão e rodapé mantidos.
+
+## Fotografias nos cartões de contexto do investimento — 23/10/2026
+
+Origem: pedido expresso da Tempo para aplicar o anexo “Melhorar as imagens e a identidade visual do Portal do Investidor de Moçambique” exclusivamente à secção “Encontre o contexto do seu investimento”. O anexo define estética fotográfica editorial, imagens individuais contextualizadas, recursos locais, acessibilidade, desempenho e preservação dos cinco destinos e conteúdos. Aplicam-se as orientações permanentes de `AGENTS.md` de 12/10 e 22/10/2026; os pormenores de implementação abaixo são escolhas técnicas.
+
+Análise prévia: Laravel/Inertia 3 e React, com Tailwind existente; os cinco cartões estavam embutidos em `pages/PortalInvestidor.tsx`. `EducationalArticleCard` destina-se a artigos com acções e metadados diferentes, pelo que não foi alterado. A secção foi extraída para `components/investment-context-cards.tsx`, mantendo o título, descrições, âncoras e grelha de uma/duas/quatro colunas. Não foram alteradas as páginas de destino, dados, APIs ou estilos globais.
+
+Foram geradas cinco imagens distintas com a ferramenta integrada `image_gen`, segundo a skill `imagegen`: agro-indústria, terminal logístico, acompanhamento de instalação solar, formação técnica e análise documental. São imagens fotográficas ilustrativas geradas, sem localização ou instituição real atribuída, e não fotografias documentais de projectos cadastrados. A imagem do terminal foi revista para remover o camião com marca visível. Não foram usadas fotografias externas nem URLs de serviços de imagens. Originais seleccionados, prompts e hashes estão registados no manifesto `public-portal-context-images.json`; os originais foram preservados dentro do workspace.
+
+Recursos finais em `public/images/investment-context/`: `clusters-agroindustria`, `corredores-logisticos-v2`, `projectos-ancora`, `educacao-formacao` e `documentos-formularios`, em WebP 960×540, com variantes 480×270 e alternativas 240×135. As imagens mantêm 16:9, `object-cover`, textos alternativos em português, dimensões reservadas, `srcset`, `sizes`, `loading="lazy"` e descodificação assíncrona. Cada cartão conserva o seu título e descrição; o foco usa o azul e os tons neutros pedidos no anexo.
+
+Se um recurso principal falhar, o cartão usa a sua própria variante pequena, evitando repetir a fotografia de outra secção. Se também essa falhar, apresenta “Imagem indisponível” no mesmo espaço reservado, com descrição acessível e link operacional. Este é apenas um estado de erro; os cinco cartões usam imagens fotográficas na apresentação normal.
+
+Verificação reproduzível: `tools/portal-context-cards-qa.mjs`, com o portal e cabeçalho reais, API sintética e acesso exclusivo aos recursos locais. Exercita seis larguras de ecrã, ecrãs de alta densidade, os cinco destinos por teclado, imagens carregadas e distintas, alinhamento, dimensões, ausência de deslocamento no carregamento e dois cenários de falha. Capturas e resultados em `outputs/investment-context-20261023/`; síntese, fontes/prompts e compilação em `public-portal-context-images.json`. Referências acrescentadas às linhas existentes `MASTER-efd550fd-0104` e `MASTER-55050f60-0001`, sem encerrar os respectivos critérios mais amplos.
+
+Revisão expressa da Tempo de 23/10/2026: título da secção no vermelho da identidade existente (`#ed1c24`) e cartões mais compactos. Removidas as alturas mínimas de 56 e 72 px do título/descrição; reduzidos o preenchimento de 20 para 16 px, o intervalo de 8 para 6 px e as entrelinhas. As alturas passam a acompanhar o conteúdo, com alinhamento por linha da grelha, conservando imagens, textos e destinos. A reserva das dimensões das imagens mantém-se. Evidência desta revisão em `outputs/investment-context-compact-20261023/` e no campo `layoutRevision` do manifesto existente.
+
+## Sectores da home e catálogo completo — 23/10/2026
+
+Origem: pedido expresso da Tempo para adaptar a estrutura de “Áreas de Investimento” do projecto `D:/Projects/Tempo_Investidor/tempo-dashboard`, incluindo cartões, botão para mais sectores e respectiva página, e uniformizar a vermelho os títulos das secções da home. Aplicadas as orientações permanentes `AGENTS.md` de 12/10 e 22/10/2026: as decisões de produto são da Tempo; as escolhas técnicas abaixo não criam requisitos organizacionais.
+
+Análise prévia: a referência usa `components/investor-portal/homepage/homepage-sectors.tsx` e `pages/investor-portal/sectors/index.tsx`. Mostra cinco cartões com fotografia e título sobreposto, resumo, “Saiba mais” e ligação central arredondada para o catálogo. O V2 já dispunha de `/sectores`, fichas `/sectores/{slug}`, especialização Fintech e dados de `SectorOrganization`. Foram reutilizados esses contratos e percursos, sem importar Framer Motion, traduções ou rotas exclusivas da referência.
+
+Implementação: `components/public-sector-cards.tsx` partilha os cartões entre a home e o catálogo. A home mostra os primeiros cinco sectores, na ordem recebida da API, com “Ler mais” para a ficha existente e “Ver mais sectores” para `/sectores`. A página existente apresenta todos os sectores publicados, na mesma estrutura visual, e “Voltar ao início”. Mantêm-se nomes, descrições, contagens, valores zero, especializações e URLs canónicos recebidos. Descrições ausentes não são preenchidas com dados da referência. Fintech permanece ligado à ficha própria, sem âncoras HTML aninhadas.
+
+Foram inventariados os onze JPG disponíveis em `storage/app/public/investor-portal/sectors` na referência, copiados os originais para evidência e preparados derivados locais WebP 960×540/480×270 em `public/images/sectors/`. O mapeamento visual por slug é de apresentação e não altera a taxonomia. Para Imobiliário e sectores sem imagem específica usa-se a vista empresarial genérica disponível na referência; para Bens de Consumo e Franquias usa-se a imagem de actividade industrial. A variante genérica também serve como alternativa em caso de erro; se ambas falharem, o título e as ligações continuam visíveis num fundo neutro. Não se atribui aos ficheiros uma origem oficial, licença externa ou localização documental não comprovada.
+
+Os seis títulos de secção da home — contexto do investimento, sectores, Como Investir, oportunidades em destaque, documentos essenciais e apoio — usam `HOME_SECTION_HEADING` em `lib/portal-presentation.ts`: vermelho `#ed1c24`, 24 px, entrelinha de 32 px e peso 700. O cartão de Apoio passou a superfície clara para manter contraste com o título vermelho. O título principal animado do hero mantém a sua hierarquia própria. `PORTAL_MORE_LINK` centraliza o botão arredondado, contorno vermelho e estado de foco, seguindo a referência.
+
+Verificação: `tools/portal-home-sectors-qa.mjs` carrega os componentes reais com dez sectores sintéticos, descrições nulas e especialização Fintech, sem base de dados. Exercita seis larguras, prévia de cinco/cartálogo de dez, estilos dos seis títulos, percurso por teclado, dez fichas, Fintech, regresso à home, catálogo vazio e dois cenários de indisponibilidade de imagens. Capturas, inventário, hashes e resultados em `outputs/home-sectors-20261023/`; resumo persistente em `public-portal-sectors-validation.json`. Referências na matriz existente: `MASTER-efd550fd-0104` e `MASTER-9f5719c8-0077`. Esta adaptação não encerra critérios mais amplos nem altera dados, permissões, regras operacionais ou publicação noutro servidor.
+
+Pedido expresso da Tempo, 23/10/2026 — botão “Contactar Apoio ao Investidor”: em `layouts/portal-navigation.tsx`, a faixa de largura total foi substituída por um botão centrado, com largura ajustada ao texto, altura mínima de 44 px, preenchimento reduzido, sombra discreta e vermelho `#ed1c24`, conservando `/apoio` e o foco visível. Verificado a 320, 390 e 1440 px: cerca de 223×44 px, sem transbordo ou erros JavaScript. Evidência em `outputs/support-button-20261023/qa-results.json` e capturas; compilação local no mesmo directório. Ajuste de apresentação por decisão do proprietário, sem nova regra operacional nem alteração de dados.
+
+Revisão anterior de 23/10/2026, superada pela correcção de âmbito abaixo: o Codex interpretou o pedido de abreviação como aplicável à zona inferior inteira e alterou indevidamente o botão de apoio e o rodapé partilhado. Essa interpretação não foi uma decisão da Tempo. A revisão removeu o bloco interno, abreviou o botão para “Apoio” e recolheu contactos/ligações em “Informações” num rodapé claro; estas alterações fora do bloco indicado foram revertidas após a clarificação expressa do proprietário. O registo desta revisão é histórico e não descreve a apresentação actual.
+
+Evidência histórica da revisão superada: `outputs/footer-compact-20261023/qa-results.json`, capturas e `check.mjs`. Não constitui aceitação do âmbito pelo proprietário.
+
+Correcção expressa da Tempo, 23/10/2026: o pedido abrange exclusivamente o bloco “INVESTE Moçambique / Portal do Investidor — conheça as oportunidades… / Acesso à gestão”. Em `pages/PortalInvestidor.tsx`, esse bloco fica abreviado num ícone de acesso à gestão, com nome acessível e descrição “Acesso à gestão”, destino `/acesso-gestao`, área de interacção de 44 px e fundo branco, sem o título e parágrafo anteriores. O botão de apoio foi restaurado exactamente à apresentação anterior à abreviação: “Contactar Apoio ao Investidor”, compacto, vermelho e sem ícone. `components/tempo-footer.tsx` e os estilos `.tempo-footer` foram integralmente restaurados ao estado anterior, incluindo contactos e ligações visíveis e o fundo original do rodapé geral. Não se altera autenticação nem dados. Esta correcção substitui a interpretação indevida acima e mantém as restantes alterações previamente pedidas.
+
+Evidência da correcção: `outputs/footer-scope-correction-20261023/check.mjs`, `qa-results.json`, capturas e `build-local.log`; componentes reais com API sintética a 320, 390 e 1440 px, ícone de gestão focável, bloco específico claro sem parágrafo, botão de apoio completo/vermelho, rodapé geral restaurado, contactos e ligações legais visíveis, sem transbordo ou erros JavaScript. Lint dos componentes alterados e compilação local. Referência na linha existente `MASTER-efd550fd-0104`, sem encerramento do critério amplo nem alteração dos seus estados.
+
+Continuação expressa da Tempo, 23/10/2026: acrescentado o título visível “Acesso à gestão” ao lado do ícone nesse mesmo bloco, para tornar o destino compreensível. O acesso mantém-se compacto, vermelho e com fundo claro, conservando `/acesso-gestao`. Ajuste restrito a essa ligação; apoio e rodapé geral conservam a apresentação restaurada. Referência: `MASTER-efd550fd-0104` e a evidência da revisão anterior acima. Verificado a 320, 390 e 1440 px, sem transbordo ou erros JavaScript; lint e compilação aprovados. Evidência em `outputs/management-label-20261023/qa-results.json`, capturas e `build-local.log`. No pedido seguinte, a Tempo determinou o alinhamento desse acesso à esquerda; aplicado `justify-start` apenas no seu contentor.