feat: prepare audited promotional disclosure interface in QA

.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

AGENTS.md

@@ -39,3 +39,10 @@ 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.

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

@@ -40,7 +40,7 @@ class SimulationController extends Controller
         $organizationId = $validated['organization_id'] ?? null;
         $execution->authorizeOrganization($actorId, $organizationId);
         if (($validated['scenario_kind'] ?? null) === 'fiscal_rule_published') {
-            $input = array_intersect_key($validated, array_flip(['base', 'currency', 'reference_date', 'operation', 'scope_declared']));
+            $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 {

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/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,12 @@ 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_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_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'],

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/PortalProfileController.php

@@ -3,6 +3,7 @@
 namespace App\Http\Controllers;
 
 use App\Models\Opportunity;
+use App\Models\User;
 use App\Services\OpportunityCanonicalContract;
 use App\Services\OpportunityContacts;
 use App\Services\OpportunityManagement;
@@ -52,6 +53,9 @@ class PortalProfileController extends Controller
             'assignments' => DB::table('portal_role_assignments')->get(), 'pair' => DB::table('portal_superuser_pair')->first(),
             'operatorOrganizations' => app(PortalInternalDesignation::class)->organizations(),
             'internalTypes' => OpportunityCanonicalContract::BASE_CATEGORIES,
+            'staffAccounts' => User::orderBy('name')->get(['id', 'name', 'email', 'email_verified_at', 'two_factor_confirmed_at'])
+                ->map(fn ($user) => ['id' => $user->id, 'name' => $user->name, 'email' => $user->email,
+                    'verified' => $user->hasVerifiedEmail(), 'mfa' => $user->two_factor_confirmed_at !== null]),
             'actorId' => $request->user()->id, 'types' => OpportunityManagement::CATEGORIES,
             'organizations' => DB::table('organizations')->whereNull('deleted_at')->get(['id', 'name']),
             'securityRequests' => DB::table('portal_security_approvals')->latest()->limit(30)->get(),

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;
@@ -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'],

app/Http/Middleware/HandleInertiaRequests.php

@@ -53,6 +53,7 @@ class HandleInertiaRequests extends Middleware
             'name' => config('app.name'),
             '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 +69,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

@@ -33,7 +33,8 @@ 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_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_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', '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',
+            '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',
@@ -72,6 +72,16 @@ class StoreSimulationFormDraftRequest extends FormRequest
             '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:20000'],
+            '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'],
@@ -279,7 +289,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

@@ -22,6 +22,12 @@ class StoreSimulationRequest extends FormRequest
             '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.',
         ];
     }
 
@@ -29,13 +35,31 @@ class StoreSimulationRequest extends FormRequest
     {
         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'];
+            '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+)?$/'],

app/Models/Opportunity.php

@@ -68,7 +68,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/ContentManagement.php

@@ -0,0 +1,49 @@
+<?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 ($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/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);

app/Services/InvestmentCatalogue.php

@@ -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;
     }
@@ -308,6 +308,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/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,7 +23,7 @@ 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) {}
 
@@ -34,8 +36,26 @@ 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];
+                    }
+                }
+            }
+        }
+        $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
@@ -53,17 +73,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;
@@ -122,19 +145,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 +202,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 +215,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 +268,21 @@ 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), ['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, 'version' => 'required|integer|min:1', 'selection' => 'present|array: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,6 +294,15 @@ 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);
+        $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]);
+            }
+        }
         $selection = $old['selection'];
         foreach ($data['selection'] as $slot => $key) {
             if ($key === null || $key === '') {
@@ -299,7 +355,7 @@ 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]);
             }
         }
@@ -314,14 +370,32 @@ final class InvestorContext
                 $changed[] = $slot;
             }
         }
-        $dependencyChanged = $this->dependencyHash($old['selection']) !== $this->dependencyHash($selection);
+        $changedFields = array_column($replaced, 'field');
+        $conditionsChanged = (bool) array_intersect($changedFields, array_diff(self::FIELDS, ['project_title', 'project_summary']));
+        $dependencyChanged = $this->dependencyHash($old['selection']) !== $this->dependencyHash($selection) || $conditionsChanged;
+        $privateConditionsChanged = (bool) array_intersect($changedFields, PrivateInvestmentPreparation::FIELDS);
+        $calculationInputsChanged = $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'] : [])])) : [];
+        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']));
+        }
+        $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 = ['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(),
+            '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.'];
         $hash = hash_hmac('sha256', json_encode(Arr::sortRecursive([$actor->id, $data, $plan]), JSON_THROW_ON_ERROR), config('app.key'));
 
@@ -349,7 +423,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,9 +435,9 @@ 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 = ['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(['selection' => $plan['selection'], 'fields' => Arr::except($plan['fields'], ['project_title', 'project_summary'])]), 'updated_at' => now()->toIso8601String(), 'updated_by' => $actor->id];
+            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()];
                 }
@@ -384,6 +458,8 @@ final class InvestorContext
         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['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 +472,36 @@ 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($ctx, $this->preparationDocuments($id)) : null;
+        $ctx['preparation_assessment'] = $preparation;
+
+        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.'];
     }
 
+    public function preparationDocuments(string $id): array
+    {
+        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 prefill(array $ctx): array
     {
         $f = $ctx['fields'];
-        $sim = Arr::only($f, ['project_title', 'project_summary', 'sector_id', 'province_id', 'district_id', 'admin_post_id', 'locality_id']);
+        $sim = Arr::except(Arr::only($f, self::FIELDS), ['sector', 'province', 'district', 'location', ...array_diff(PrivateInvestmentPreparation::FIELDS, ['total_investment', 'area_required', 'area_unit'])]);
+        $zone = $ctx['selection']['park'] ?? null;
+        $sim['context_applicability_snapshot'] = json_encode([
+            'version' => 1, 'context_revision' => $ctx['revision'],
+            'zone' => $zone ? Arr::only($zone, ['id', 'title', 'href', 'version', 'sha256', 'fields', 'analysis']) : null,
+            'provenance' => $ctx['provenance'],
+            'path' => $ctx['path_applicability'] ?? null,
+            '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);
 
         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

@@ -136,7 +136,7 @@ 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));
@@ -145,12 +145,17 @@ final class InvestorPath
             ? LandAssistanceCase::where('user_id', $actor->id)->latest('updated_at')->get()
                 ->first(fn ($land) => ($land->payload['investor_path_case_id'] ?? null) === $id) : 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'] ?? [],
             '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,
+            'next' => $next ? ['code' => $next['code'], 'title' => $next['title'], 'action' => 'Preparar', 'href' => $next['href'] ?? '#'.$next['code']] : null,
             'investment_context' => ($owner || $manager) ? $context : null,
             'results' => $results, 'requests' => $requests, 'documents' => $documents,
             'zone_contexts' => ($owner || $manager) ? ($path['zone_contexts'] ?? []) : [],

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,167 @@
+<?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.')]));
+        $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/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/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

@@ -6,6 +6,7 @@ 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;
@@ -35,8 +36,11 @@ final class SimulationPublishedFiscal
             ->where('scope_key', 'mz.internal-general-net.mzn');
     }
 
-    public function admit(array $input): array
+    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,
@@ -63,6 +67,9 @@ final class SimulationPublishedFiscal
             $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';
@@ -79,4 +86,51 @@ final class SimulationPublishedFiscal
 
         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/SimulationTaxParameterResolver.php

@@ -53,9 +53,9 @@ 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);
@@ -67,14 +67,14 @@ final class SimulationTaxParameterResolver
             ->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))
+            ->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',
@@ -121,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;
     }
 
     /**

app/Services/VirtualDesk.php

@@ -250,7 +250,8 @@ 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'])],
+            '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) {
@@ -388,7 +389,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 +413,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.');

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/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'),

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

@@ -315,3 +315,11 @@ 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.
+Conferência de integração de 22/10/2026 (requisitos documentais MASTER-9f6dd1d9-0001/0003 e reutilização MASTER-02f44baf-0002): 8286d750 servido, acesso real de Nala restituído removendo dependência indevida da reserva técnica do host; lista nominal, MFA e âmbito preservados. Ver secção «Entrada única — integração e conferência real» do manual. Não encerrar o fluxo integral das oportunidades: ausência de Publicador activo e publicação promocional ainda por executor privado são saldos explícitos; não condicionam os acessos já aprovados. Não foram criadas contas, matrizes ou papéis adicionais.
+### Divulgação promocional corrente — QA, 22/10/2026
+
+Evidência complementar aos requisitos existentes MASTER-9f6dd1d9-0001/0003 (gestão documental), MASTER-02f44baf-0002 (reutilização) e MASTER-6e51cfcd-0001 (oportunidades): secção «Divulgação promocional pela equipa — implementação QA» do manual e `OpportunityPromotionTest`. Por decisão expressa da Tempo, a divulgação de resumos Em preparação tem prévia, confirmação, actualização, retirada e auditoria na interface, independente da aprovação de execução e do workflow de oportunidade completa. Reutilizados os perfis operacionais e o âmbito existentes; zero novos papéis/aprovadores. Removida a dependência do executor privado para esta operação corrente em QA. Origem dos controlos de versão/token: escolha técnica de integridade. Não alterar os critérios originais nem dar por concluídas a instalação no activo, a disponibilidade das contas ou as variantes não demonstradas. Mario conserva a designação aprovada e pode ser seleccionado por nome quando a conta/requisitos estiverem disponíveis. Geometrias excluídas.

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/simulations/integrated-review-continuation-20261020-receipt.json

@@ -1179,5 +1179,827 @@
       "calculations_exporters_repeated": false
     },
     "remaining": []
+  },
+  "iva_query_diagnostic_qa_20261021": {
+    "recorded_utc": "2026-10-21T11:35:00.737064+00:00",
+    "scope": "QA only, parameter-query diagnosis; no calculation/export retest, no destination writes",
+    "reported_surface": "Componentes fiscais e contributivas, IVA_GENERAL_RATE, annual 2026-01-01 to2026-12-31, indeterminate_context",
+    "confirmed_origin": "Implementation integration gap: query sent fiscal_operation and no currency/operation, whereas the published IVA parameter requires operation=internal_general_net and currency=MZN. Resolver collapsed every mismatch to indeterminate_context and UI blamed responses without individual evidence.",
+    "original_answers_known": "Only the period/component/message were provided. No original currency or operation is asserted; USD/domestic are explicit directed QA cases, not inferred original answers.",
+    "diagnostic_categories": [
+      "missing_field",
+      "invalid_value",
+      "out_of_scope",
+      "period_unavailable",
+      "system_configuration"
+    ],
+    "changes": [
+      "Server projects each failed criterion, field, received value, expected criterion, source and exact rule version; no expression projection",
+      "Explicit fiscal_currency answer for IVA query, persisted and recovered; no copy/conversion from budget or IVA-base currency",
+      "Generic domestic is never silently equated to internal_general_net; integration limitation is explained and links to explicit IVA form",
+      "Inline notes plus summary links, human IVA — taxa geral label and Ver fundamento disclosure",
+      "Period diagnostic can inspect published candidates outside queried period under existing visibility policy; selection/calculation eligibility unchanged",
+      "No eligible visible candidate remains explicitly uncertain; no invented input fault"
+    ],
+    "verification": {
+      "new_unit_tests": 5,
+      "new_unit_assertions": 24,
+      "targeted_api_tests": 1,
+      "targeted_api_assertions": 16,
+      "existing_resolver_regression_tests": 7,
+      "existing_resolver_regression_assertions": 25,
+      "typescript": "passed",
+      "build": "passed, exit0",
+      "pint": "passed",
+      "edge": "Normal simulator query, annual2026; missing currency then explicitly chosen USD; inline/summary linked fields focused; source/version disclosure; USD and generic operation preserved after save/recovery; internal code and expression absent from query text",
+      "no_simulation_created_by_api_diagnostic": true
+    },
+    "qa_fixture": {
+      "rule_version": 3,
+      "state_after_proof": "suspended",
+      "consumer_enabled": false,
+      "database": "simulator_fiscal_delta_20261021_test",
+      "imported_into_homologation": false
+    },
+    "test_database": "simulator_fiscal_checks_20261021_test, existing QA schema correction applied before targeted API test; isolated guard preserved",
+    "proofs": [
+      "outputs/simulator-continuation-20261020/iva-diagnostic-api-test.txt",
+      "outputs/simulator-continuation-20261020/iva-diagnostic-summary.txt",
+      "outputs/simulator-continuation-20261020/iva-diagnostic-summary.png",
+      "outputs/simulator-continuation-20261020/iva-diagnostic-build-final.txt"
+    ],
+    "main_integrated": false,
+    "homologation_rule_changed": false,
+    "legal_coverage_expanded": false
+  },
+  "monthly_iva_projection_qa_20261021": {
+    "branch": "codex/iva-monthly-projection-QA",
+    "status": "candidate_verified_in_isolated_QA_only",
+    "source": "existing monthly product sales; saved constant cashflow revenue only when no business plan exists",
+    "basis": "explicit net/included/unknown; only net calculated; no silent conversion",
+    "selection": "published version selected by server; frozen at admission; same resolver/evaluator",
+    "cash_treatment": "separate IVA memorandum; declared receipts/payments unchanged; not cost, no inferred collection or final settlement",
+    "manual_tax": "custom planning only; never input into monthly IVA",
+    "unknown_vs_zero": "missing month indeterminate; explicit zero calculated as zero; aggregate indeterminate if any month unknown",
+    "tests": {
+      "api_tests": 3,
+      "api_assertions": 46,
+      "frontend_tests": 4,
+      "types": "passed",
+      "build": "passed",
+      "pint": "passed",
+      "accepted_calculation_and_exporter_proofs": "reused, not repeated"
+    },
+    "qa_fixture": {
+      "database": "simulator_fiscal_delta_20261021_test",
+      "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+      "rule_version": 4,
+      "consumer_enabled": true,
+      "synthetic": true,
+      "left_available_for_review": true,
+      "draft_id": "e0201d19-286e-4d5c-9585-2c1e3bd1ad1e"
+    },
+    "live_history": [
+      {
+        "id": "06566910-9672-4176-804d-aad8350417cb",
+        "status": "completed",
+        "created_at": "2026-10-21T11:57:11.000000Z",
+        "basis": "net",
+        "rows": [
+          {
+            "vat": "160.0048",
+            "date": "2026-01-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "1000.03",
+            "gross_sales": "1160.0348",
+            "rule_version": 4,
+            "sales_declared": "1000.03"
+          },
+          {
+            "vat": "320.0096",
+            "date": "2026-02-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "2000.06",
+            "gross_sales": "2320.0696",
+            "rule_version": 4,
+            "sales_declared": "2000.06"
+          },
+          {
+            "vat": "0",
+            "date": "2026-03-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "0.00",
+            "gross_sales": "0",
+            "rule_version": 4,
+            "sales_declared": "0.00"
+          },
+          {
+            "vat": null,
+            "date": "2026-04-01",
+            "rate": null,
+            "status": "missing_sales",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": null,
+            "gross_sales": null,
+            "rule_version": 4,
+            "sales_declared": null
+          }
+        ],
+        "total": null,
+        "reports": [
+          {
+            "id": "42b95158-6c4c-43c6-801d-28e973a087a6",
+            "same_snapshot": true,
+            "sha256": "b6d10565f82f7e83952fbdbb15a357ca3a7fee550e53c80a0ef5b9e314ccfa68"
+          }
+        ]
+      },
+      {
+        "id": "098900ed-2f5f-4141-98c8-08f892912a5b",
+        "status": "completed",
+        "created_at": "2026-10-21T11:57:34.000000Z",
+        "basis": "net",
+        "rows": [
+          {
+            "vat": "480.0144",
+            "date": "2026-01-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "3000.09",
+            "gross_sales": "3480.1044",
+            "rule_version": 4,
+            "sales_declared": "3000.09"
+          },
+          {
+            "vat": "320.0096",
+            "date": "2026-02-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "2000.06",
+            "gross_sales": "2320.0696",
+            "rule_version": 4,
+            "sales_declared": "2000.06"
+          },
+          {
+            "vat": "0",
+            "date": "2026-03-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "0.00",
+            "gross_sales": "0",
+            "rule_version": 4,
+            "sales_declared": "0.00"
+          },
+          {
+            "vat": null,
+            "date": "2026-04-01",
+            "rate": null,
+            "status": "missing_sales",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": null,
+            "gross_sales": null,
+            "rule_version": 4,
+            "sales_declared": null
+          }
+        ],
+        "total": null,
+        "reports": [
+          {
+            "id": "44211195-0a53-4f4c-93ef-6ff0e439082b",
+            "same_snapshot": true,
+            "sha256": "5de00868029b7a688585e180bcd8fbef1e46e289b19ab766c58f7406fb2af972"
+          }
+        ]
+      },
+      {
+        "id": "96eec0d8-effa-4286-b465-6af50f756db4",
+        "status": "completed",
+        "created_at": "2026-10-21T11:58:35.000000Z",
+        "basis": "included",
+        "rows": [
+          {
+            "vat": null,
+            "date": "2026-01-01",
+            "rate": null,
+            "status": "unsupported_basis",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": null,
+            "gross_sales": null,
+            "rule_version": 4,
+            "sales_declared": "3000.09"
+          },
+          {
+            "vat": null,
+            "date": "2026-02-01",
+            "rate": null,
+            "status": "unsupported_basis",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": null,
+            "gross_sales": null,
+            "rule_version": 4,
+            "sales_declared": "2000.06"
+          },
+          {
+            "vat": null,
+            "date": "2026-03-01",
+            "rate": null,
+            "status": "unsupported_basis",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": null,
+            "gross_sales": null,
+            "rule_version": 4,
+            "sales_declared": "0.00"
+          },
+          {
+            "vat": null,
+            "date": "2026-04-01",
+            "rate": null,
+            "status": "missing_sales",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": null,
+            "gross_sales": null,
+            "rule_version": 4,
+            "sales_declared": null
+          }
+        ],
+        "total": null,
+        "reports": [
+          {
+            "id": "821e6347-680c-4029-9756-c3169d79f85e",
+            "same_snapshot": true,
+            "sha256": "06abadc593e65cfff64d208fac6cac3a8f98db4bef92795a27ce637fe7958cec"
+          }
+        ]
+      },
+      {
+        "id": "e88aaaea-4482-4b7d-869f-f0648a430651",
+        "status": "completed",
+        "created_at": "2026-10-21T12:00:32.000000Z",
+        "basis": "net",
+        "rows": [
+          {
+            "vat": "480.0144",
+            "date": "2026-01-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "3000.09",
+            "gross_sales": "3480.1044",
+            "rule_version": 4,
+            "sales_declared": "3000.09"
+          },
+          {
+            "vat": "320.0096",
+            "date": "2026-02-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "2000.06",
+            "gross_sales": "2320.0696",
+            "rule_version": 4,
+            "sales_declared": "2000.06"
+          },
+          {
+            "vat": "0",
+            "date": "2026-03-01",
+            "rate": "16",
+            "status": "calculated",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": "0.00",
+            "gross_sales": "0",
+            "rule_version": 4,
+            "sales_declared": "0.00"
+          },
+          {
+            "vat": null,
+            "date": "2026-04-01",
+            "rate": null,
+            "status": "missing_sales",
+            "rule_id": "01a15e50-7972-72e0-8991-82ca28df9b49",
+            "net_sales": null,
+            "gross_sales": null,
+            "rule_version": 4,
+            "sales_declared": null
+          }
+        ],
+        "total": null,
+        "reports": [
+          {
+            "id": "bc204cc7-1f0c-4468-80fa-e093642a5eac",
+            "same_snapshot": true,
+            "sha256": "4ed224f7de50b533f144f7f411d240eb1ccca6f3e5bff7a64b1eca6f6d7971dc"
+          }
+        ]
+      }
+    ],
+    "main_integrated": false,
+    "homologation_changed": false,
+    "rule_publication_on_destination": false,
+    "coverage_expanded": false,
+    "limitations": [
+      "IVA included prices unsupported in current net lot",
+      "2026 only, max 12 consecutive months",
+      "no final payable, deductions, refunds, special/reduced/exempt regimes",
+      "examples prove arithmetic/integration, not legal eligibility of every transaction"
+    ],
+    "remaining": "Tempo review/decision for code integration; no further generic preparation identified; keep real rule/publication/activation separate",
+    "proof_directory": "outputs/simulator-continuation-20261020"
+  },
+  "modelo_a_reconciliation_qa_20261021": {
+    "branch": "codex/iva-modelo-a-reconciliation-QA",
+    "parent_candidate": "3f5430c3",
+    "status": "documentary_and_first_interface_increment_verified; full IVA settlement remains incomplete",
+    "reference": "docs/investmoz/simulations/modelo-a-reconciliacao-20261021.md",
+    "originals": [
+      {
+        "id": "fbfa820d-29d5-4bf8-9f81-534931d80cef",
+        "file_name": "Novo Modelo A.docx",
+        "sha256": "62c198e90d8c6792f7d5ccefc6386df2e4b6089573067d3a6e1eae7fc2b9572b",
+        "status": "active",
+        "malware_scan_status": "clean",
+        "malware_scanned_sha256": "62c198e90d8c6792f7d5ccefc6386df2e4b6089573067d3a6e1eae7fc2b9572b"
+      },
+      {
+        "id": "cf8b799e-44de-4497-b2e3-a5c468f2fe0e",
+        "file_name": "Novo Modelo A v1.docx",
+        "sha256": "63d45fa80db17a60b43619d55a25813229d670d14c758273f86316285db8e02b",
+        "status": "active",
+        "malware_scan_status": "clean",
+        "malware_scanned_sha256": "63d45fa80db17a60b43619d55a25813229d670d14c758273f86316285db8e02b"
+      }
+    ],
+    "library_qa_only": true,
+    "resources": [
+      33,
+      34
+    ],
+    "published": false,
+    "inventory": "Existing document corpus inventory extended; private inventory of all seven accessible Notes files preserved",
+    "read": "OOXML text plus embedded image2.png visually inspected; image identical in both originals; source unchanged; all three LibreOffice reading pages inspected, field25 confirmed visually; conversion layout drift is not a replacement original",
+    "coverage": {
+      "fields_mapped": "01–27",
+      "frames_mapped": "1–13 plus ambiguously numbered prior-credit block",
+      "calculated": "Existing net general-rate component01/02 only",
+      "totals14_to18": "indeterminate, not inferred from VAT on sales"
+    },
+    "implemented": [
+      "Consultable field/purpose/data/calculation/basis/status table in normal QA simulator",
+      "Existing purchase schedules reused independently of sales completeness",
+      "Net/supported VAT/gross/deductible VAT kept separate and unknown without classification",
+      "Partial simulation marker in report; historical server snapshots not rewritten"
+    ],
+    "documentary_discrepancies": [
+      "Regularization prose11/12 versus boxes12/13",
+      "Credit note18/19 versus block19/20",
+      "Refund noteart20 versus art21 amended in2025",
+      "Ambiguous frame8 remissions; repeated25 was extraction artifact, one box25 confirmed visually"
+    ],
+    "official_sources_read": [
+      "Existing Lei22/2022 PDF4 art17-A and entry into force",
+      "Existing Lei10/2025 BR248 PDF12–15; visualPDF13/14"
+    ],
+    "unresolved": [
+      "Exact approved edition of form for period",
+      "Consolidation of relevant base provisions, Lei3/2025 and regulations for each extension",
+      "Operation-level scopes, eligibility, documents and effective dates for reduced rate/deduction"
+    ],
+    "tool_limits": [
+      "Direct AT form page timed out; indexed page has different frame numbering, not used as replacement",
+      "Current chat attachment was not exposed as a local attachment; exact-named local Tempo Notes exemplar used with hash disclosed"
+    ],
+    "tests": {
+      "new_frontend_tests": 3,
+      "types": "passed",
+      "build": "passed",
+      "browser": "new correspondence/purchases/report annotations only, no new calculation",
+      "import": "preview/private import/clean hash-matched scan/idempotent replay with zero duplicates"
+    },
+    "reused_proofs": [
+      "published rate selection",
+      "decimal calculation",
+      "monthly recovery",
+      "idempotency/suspension/history",
+      "CSV/DOCX/PDF exporters"
+    ],
+    "next_lot_estimate": {
+      "cadastre_and_consolidation_hours": [
+        8,
+        16
+      ],
+      "code_and_acceptance_hours": [
+        20,
+        36
+      ],
+      "total_hours": [
+        28,
+        52
+      ],
+      "excludes": "prior credits/substitutions/payment/refund and full fiscal coverage"
+    },
+    "main_integrated": false,
+    "homologation_changed": false,
+    "new_rules_registered": false,
+    "new_rules_published": false,
+    "consumer_activation_changed": false,
+    "proof_directory": "outputs/modelo-a-20261021"
+  },
+  "contextual_continuity_qa_20261022": {
+    "branch": "codex/project-context-continuity-QA",
+    "base": "57fc914821d0cefa02caa80a74b3d42e663f2742",
+    "scope": "Primeiro incremento de continuidade e explicação contextual; adaptação jurídica integral não encerrada",
+    "status": "QA, revisão; sem integração main ou alteração fiscal activa",
+    "http_tests": {
+      "tests": 4,
+      "assertions": 74,
+      "transaction_rollback": true
+    },
+    "frontend_tests": 8,
+    "typescript": "passed",
+    "build": "passed",
+    "visual_evidence_directory": "outputs/context-continuity-20261022",
+    "same_project_new_session": true,
+    "deliberate_edit_preserved": true,
+    "second_project_isolated": true,
+    "fiscal_execution_id": "ae401465-834f-4761-9406-5af060c499fb",
+    "new_executions_today": 1,
+    "reused_proofs": [
+      "13f68f1b: recuperação/exportadores/PDF",
+      "83d2f97d e 226fd308: precisão/versões/históricos",
+      "3f5430c3: cálculo mensal",
+      "0b0cf761: correspondência parcial Modelo A"
+    ],
+    "limitations": [
+      "Catálogo visual QA sintético; ZEE/ZFI apenas controlos HTTP sintéticos revertidos, sem elegibilidade real demonstrada",
+      "Condições jurídicas por sector/actividade/regime e benefícios executáveis não concluídos",
+      "Outros três consumidores usam origem/reconciliador comum; não houve demonstração visual integral de cada processo",
+      "Sem regra fiscal nova, publicação, activação ou integração em main",
+      "Edge interrompeu a inspecção após navegação de regresso; endereço e gravação confirmados por inventário/serviço, visual final não observada. Limitação da ferramenta."
+    ],
+    "return_evidence_id": "43317c22-50c8-40cf-98e4-e5d4d108c372",
+    "B_recovered_context_revision": 2
+  },
+  "context_review_and_adaptive_path_preparation_20261022": {
+    "reviewed_commit": "a76369eb",
+    "review_status": "complete within accepted increment scope; no integration executed",
+    "last_return_equivalent_evidence": "43317c22-50c8-40cf-98e4-e5d4d108c372",
+    "accepted_AB_repeated": false,
+    "next_lot": "Preparação de pedido de investimento privado: condição, fonte/período, formulário, percurso, cálculo e lacuna",
+    "next_lot_status": "documented, not implemented or demonstrated end-to-end",
+    "source_url": "https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf",
+    "source_sha256": "ba1e9eaabfec5d0c4cb2d9f2444a6860f7a90f222034764197829be402d408ed",
+    "new_fiscal_rule_activation": false,
+    "next_acceptance": "Only synthetic C condition transitions and dossier/report links; reuse accepted context and IVA evidence"
+  },
+  "private_investment_executable_20261022": {
+    "base": "52fbb146",
+    "branch": "codex/private-investment-path-executable-QA",
+    "status": "implemented and verified in isolated QA; not integrated",
+    "source_version": "private-investment-preparation-2026-v1",
+    "orientation": "Tempo 22/10: official sources execute without generic additional legal approval; permanent AGENTS updated",
+    "qa_url": "http://127.0.0.1:18580/investimentos/4133311b-5426-4cec-900d-1f1484484083",
+    "persistence": {
+      "case_id": "4133311b-5426-4cec-900d-1f1484484083",
+      "case_version": 8,
+      "context_revision": 4,
+      "mode": "registration",
+      "association": {
+        "lease": "e5ce142a-1178-46a2-b039-f187139c62cd"
+      },
+      "documents": 1,
+      "context_events": 4,
+      "draft_id": "beba1dec-fc05-4820-b099-24952c5ab36c",
+      "draft_version": 4,
+      "draft_sha256": "4136e82a3b9420ab8f980ec0d7bda6dc2a67b568c18535b5ba0ecc80efd37e37",
+      "saved_context_revision": 3,
+      "saved_preparation_mode": "authorization",
+      "currency": "MZN",
+      "date": "2026-01-01",
+      "preparation_version": "private-investment-preparation-2026-v1"
+    },
+    "new_checks": {
+      "feature_tests": 3,
+      "assertions": 96,
+      "frontend_delta_tests": 1,
+      "typescript": "passed",
+      "build": "passed"
+    },
+    "evidence_sha256": {
+      "C-authorization-preview.png": "311c9f14ac601429666ded55c5906aa8ab018b5d31a1f101b4fb32697adf0817",
+      "C-final-directness-preview.png": "2037958e2879fb184cac1c4aa07ddc367417dbd1541d979c4e653a63918cdaca",
+      "C-final-path.png": "0c3c0900d861724b6def3f5850bd6c6c0f65dfee7cb01d6bb7c72c8bf645645a",
+      "C-persistence-v3.json": "b8faad9a5d4d9174a489a7b1096104f3a91645201b221b1ad7ece4a217180e00",
+      "C-persistence.json": "6b6120c88f41cff43b185905fdfec992ca76b359d0eab6bc1df02dee064c780d",
+      "C-recovered-path.png": "c734d119b0f766d8600892713be473d1c1875cb6ff4474b6fceabef702a3490b",
+      "C-report-check.json": "217b56b89041e6c8c05907af48c48dadf4f8316a2cce0f9195daf828258cb503",
+      "C-report.docx": "28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce"
+    },
+    "report": {
+      "path": "C:\\Mac\\Home\\Downloads\\relatorio-investmoz-sintetico-qa-c-pedido-de-investimento-privado.docx",
+      "size": 16674,
+      "sha256": "28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce"
+    },
+    "tool_limitation": "Download observation timed out and browser debugger detached; completed DOCX found in Downloads, verified before any retry; no repeated export",
+    "reused": "Accepted A/B, decimal calculation, CSV, exporters and native PDF pagination",
+    "main_integrated": false,
+    "homologation_changed": false,
+    "fiscal_rule_published_or_activated": false,
+    "limitations": [
+      "Only 2026 private investment preparation, documented registration/authorization conditions",
+      "No administrative submission or entitlement decision",
+      "No full sector licensing, foreign-currency equivalence or fiscal benefits engine",
+      "ZEE/ZFI routing predicate uses QA references; no real zone visual recognition proof",
+      "Dossier attachment association does not approve content; synthetic C fixture pending scan not delivered as seed",
+      "Final C context v4 registration differs from frozen draft/report context v3 authorization; no silent rewrite or repeated export."
+    ],
+    "historical_report_persistence": {
+      "case_id": "4133311b-5426-4cec-900d-1f1484484083",
+      "case_version": 7,
+      "context_revision": 3,
+      "mode": "authorization",
+      "association": {
+        "lease": "e5ce142a-1178-46a2-b039-f187139c62cd"
+      },
+      "documents": 1,
+      "context_events": 3,
+      "draft_id": "beba1dec-fc05-4820-b099-24952c5ab36c",
+      "draft_version": 4,
+      "draft_sha256": "4136e82a3b9420ab8f980ec0d7bda6dc2a67b568c18535b5ba0ecc80efd37e37",
+      "saved_context_revision": 3,
+      "saved_preparation_mode": "authorization",
+      "currency": "MZN",
+      "date": "2026-01-01",
+      "preparation_version": "private-investment-preparation-2026-v1"
+    },
+    "directness_control": "Lei 8/2023 art14(b), R13: direct declared before using direct-investment monetary threshold; indirect/unknown unresolved only for dependent results; PPP independent condition remains executable"
+  },
+  "private_investment_report_alignment_20261022": {
+    "functional_revision": "a1fbda06",
+    "status": "targeted missing evidence completed; no functional code changes",
+    "current_persistence": {
+      "case_id": "4133311b-5426-4cec-900d-1f1484484083",
+      "case_version": 8,
+      "context_revision": 4,
+      "mode": "registration",
+      "association": {
+        "lease": "e5ce142a-1178-46a2-b039-f187139c62cd"
+      },
+      "documents": 1,
+      "context_events": 4,
+      "draft_id": "beba1dec-fc05-4820-b099-24952c5ab36c",
+      "draft_version": 5,
+      "draft_sha256": "ba824fe0362ca87b301da55298122796f44fdfb11507830b3fe8f54cf88d132d",
+      "saved_context_revision": 4,
+      "saved_preparation_mode": "registration",
+      "currency": "MZN",
+      "date": "2026-01-01",
+      "preparation_version": "private-investment-preparation-2026-v1"
+    },
+    "reports": {
+      "historic_v3": {
+        "path": "C:\\Mac\\Home\\Downloads\\relatorio-investmoz-sintetico-qa-c-pedido-de-investimento-privado.docx",
+        "sha256": "28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce",
+        "bytes": 16674,
+        "rows": [
+          [
+            "Contexto do investimento",
+            "Revisão 3; sem ZEE, ZFI ou parque seleccionado",
+            "Contexto versionado; não é reconhecimento jurídico. Referência do mesmo dossier no momento da gravação"
+          ],
+          [
+            "Preparação do investimento privado",
+            "Pedido de autorização",
+            "Declarações e requisitos de preparação; sem aprovação jurídica. Contexto congelado v3; private-investment-preparation-2026-v1"
+          ],
+          [
+            "Estudo de viabilidade técnica e económico-financeira",
+            "Documento por associar",
+            "Preparação informativa — simulação, sem submissão à Administração. Integra a preparação do pedido de autorização. R14(1)–(2); https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf#page=45"
+          ],
+          [
+            "Comprovação da capacidade financeira",
+            "Documento por associar",
+            "Preparação informativa — simulação, sem submissão à Administração. Integra a preparação do pedido de autorização. R14(1)–(2); https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf#page=45"
+          ]
+        ]
+      },
+      "current_v4": {
+        "path": "C:\\Mac\\Home\\Downloads\\relatorio-investmoz-sintetico-qa-c-pedido-de-investimento-privado (1).docx",
+        "sha256": "a2849427f4a91fa6ab78e433be8b919baca80a0f4f452a4546a5b169b921d753",
+        "bytes": 16678,
+        "rows": [
+          [
+            "Contexto do investimento",
+            "Revisão 4; sem ZEE, ZFI ou parque seleccionado",
+            "Contexto versionado; não é reconhecimento jurídico. Referência do mesmo dossier no momento da gravação"
+          ],
+          [
+            "Preparação do investimento privado",
+            "Pedido de mero registo",
+            "Declarações e requisitos de preparação; sem aprovação jurídica. Contexto congelado v4; private-investment-preparation-2026-v1"
+          ],
+          [
+            "Estudo de viabilidade técnica e económico-financeira",
+            "Não aplicável; histórico preservado",
+            "Preparação informativa — simulação, sem submissão à Administração. Integra a preparação do pedido de autorização. R14(1)–(2); https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf#page=45"
+          ],
+          [
+            "Comprovação da capacidade financeira",
+            "Não aplicável; histórico preservado",
+            "Preparação informativa — simulação, sem submissão à Administração. Integra a preparação do pedido de autorização. R14(1)–(2); https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf#page=45"
+          ]
+        ]
+      }
+    },
+    "proof_sha256": {
+      "C-report-HISTORICO-contexto-v3.docx": "28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce",
+      "C-report-contexto-v4.docx": "a2849427f4a91fa6ab78e433be8b919baca80a0f4f452a4546a5b169b921d753",
+      "C-report-v3-v4-comparison.json": "722154fd38b2915ec087f804abe66bc4c98c6eff2c4403d8e670d65d257e3446",
+      "C-persistence-v4-draft5.json": "a10505a52c553b4c0e03ece59d20d5a0a20204ae694bcf7174ee0574272ec1c4",
+      "C-new-report-context-v4.png": "b0cf159e6be5a457efdc46eb5e273895c43010caa9727e3b75668f916aa11f8d"
+    },
+    "historic_label": "C-report-HISTORICO-contexto-v3.docx; original bytes unchanged, embedded Contexto congelado v3",
+    "current_label": "C-report-contexto-v4.docx; embedded Contexto congelado v4; registration; study/capacity not applicable",
+    "accepted_tests_repeated": false,
+    "integration_dependencies": [
+      "a76369eb common continuity, required ancestor of a1fbda06",
+      "52fbb146 documentary intermediate, no executable delta",
+      "a1fbda06 adaptive private-investment functionality",
+      "Current branch includes ancestors; do not cherry-pick a1fbda06 alone without a76369eb/equivalent changes"
+    ],
+    "integration_procedure": "After Tempo evaluation/decision, fetch current main, merge preserving concurrent changes and review actual conflicts. a76369eb can integrate independently first; shared ancestry avoids duplicate application. No reset or force-push main. Confirm deployed revision and only changed destination behavior. PRIVATE_INVESTMENT_PREPARATION_ENABLED is separate from tax publication/activation.",
+    "remote_main_read": "57fc914821d0cefa02caa80a74b3d42e663f2742",
+    "main_integrated": false,
+    "fiscal_rules_changed": false
+  },
+  "adaptive_private_path_homologation_20261022": {
+    "authorized_by": "Tempo, user authorization 22/10/2026",
+    "previous_main": "57fc914821d0cefa02caa80a74b3d42e663f2742",
+    "authorized_ancestry": [
+      "a76369eb",
+      "52fbb146",
+      "a1fbda06",
+      "064296e1"
+    ],
+    "integration": "fast-forward, no conflicts or concurrent commits observed at push; no forced update",
+    "first_attempt": {
+      "status": "failed",
+      "commit": "064296e1fbf7b17f932df23c7b3ee5508719dec5",
+      "error": "Verification command failed: node (see protected build log)",
+      "active_release_preserved": true,
+      "requested_commits": [
+        "064296e1fbf7b17f932df23c7b3ee5508719dec5"
+      ],
+      "finished_at": "2026-10-22T08:11:54.420414+00:00"
+    },
+    "compatibility_fix": {
+      "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+      "cause": "Empty inheritance metadata appended when restoring a legacy draft with no compatible source",
+      "change": "Return original draft when both compatible source and prior inheritance metadata are absent",
+      "targeted_tests": "9 inheritance controls + exact failing legacy partition/recovery test, all passed"
+    },
+    "installed": {
+      "status": "installed",
+      "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+      "release": "/var/www/investmoz-homologacao/releases/042ffbde44cac27704d6f8b7ec25b525a42e3575-6dfae60c",
+      "previous_release": "/var/www/investmoz-homologacao/releases/57fc914821d0cefa02caa80a74b3d42e663f2742-f563f9a7",
+      "database_migrations": 0,
+      "content_imports": 0,
+      "requested_commits": [
+        "042ffbde44cac27704d6f8b7ec25b525a42e3575"
+      ],
+      "finished_at": "2026-10-22T08:16:16.903501+00:00"
+    },
+    "http": {
+      "/build/revision.json": {
+        "status": 200,
+        "body": {
+          "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+          "branch": "main",
+          "built_at": "2026-10-22T08:16:14.331119+00:00",
+          "manifest_sha256": "655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79"
+        }
+      },
+      "/api/v1/fiscal-consumer": {
+        "status": 200,
+        "body": {
+          "data": {
+            "enabled": true,
+            "coverage_start": "2026-01-01",
+            "coverage_end": "2026-12-31",
+            "message": "IVA geral sobre base líquida disponível; enquadramento declarado."
+          }
+        }
+      },
+      "/investimentos": {
+        "status": 302,
+        "location": "https://teste-investidor.tempo.co.mz/login"
+      },
+      "/simulador-fiscal": {
+        "status": 200,
+        "body": "HTML available"
+      },
+      "checked_utc": "2026-10-22T08:17:20.250804+00:00"
+    },
+    "configuration_before": {
+      "read_only": true,
+      "utc": "2026-10-22T08:16:34.265947+00:00",
+      "revision": {
+        "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+        "branch": "main",
+        "built_at": "2026-10-22T08:16:14.331119+00:00",
+        "manifest_sha256": "655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79"
+      },
+      "live": "/var/www/investmoz-homologacao/releases/042ffbde44cac27704d6f8b7ec25b525a42e3575-6dfae60c",
+      "env_path": "/var/www/html/teste-investidor.tempo.co.mz/.env",
+      "env_sha256": "7cdaba591bb5787485a349c24db2fd7c8279436da0eb31502e44db2fffa21d03",
+      "env_mode": "0o640",
+      "uid": 1001,
+      "gid": 33,
+      "private_preparation_env": "unset",
+      "config": {
+        "private_preparation": false,
+        "investor_path": true,
+        "fiscal_consumer": {
+          "enabled": true,
+          "coverage_start": "2026-01-01",
+          "coverage_end": "2026-12-31",
+          "message": "IVA geral sobre base líquida disponível; enquadramento declarado."
+        },
+        "preparation_version": "private-investment-preparation-2026-v1"
+      }
+    },
+    "configuration_enable": {
+      "utc": "2026-10-22T08:16:49.343216+00:00",
+      "revision": {
+        "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+        "branch": "main",
+        "built_at": "2026-10-22T08:16:14.331119+00:00",
+        "manifest_sha256": "655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79"
+      },
+      "changed": true,
+      "env_before_sha256": "7cdaba591bb5787485a349c24db2fd7c8279436da0eb31502e44db2fffa21d03",
+      "env_after_sha256": "a6b4e9064cf6dbb2d945b53418a6c9252f9c736ff3fde4016b95b74885a9ee0f",
+      "backup": "/var/lib/investmoz-deploy/backups/private-preparation-20261022/env-7cdaba591bb5787485a349c24db2fd7c8279436da0eb31502e44db2fffa21d03.private",
+      "backup_bytes_verified": true,
+      "only_key_changed": "PRIVATE_INVESTMENT_PREPARATION_ENABLED",
+      "mode_preserved": true,
+      "owner_preserved": true,
+      "config": {
+        "private_preparation": true,
+        "investor_path": true,
+        "fiscal_consumer": {
+          "enabled": true,
+          "coverage_start": "2026-01-01",
+          "coverage_end": "2026-12-31",
+          "message": "IVA geral sobre base líquida disponível; enquadramento declarado."
+        },
+        "preparation_version": "private-investment-preparation-2026-v1"
+      },
+      "fiscal_configuration_changed": false,
+      "database_operations": false,
+      "recovery": "Restore previous key value only against recorded post-change hash, rebuild config cache; preserve subsequent changes and all data"
+    },
+    "configuration_after": {
+      "read_only": true,
+      "utc": "2026-10-22T08:17:21.883131+00:00",
+      "revision": {
+        "commit": "042ffbde44cac27704d6f8b7ec25b525a42e3575",
+        "branch": "main",
+        "built_at": "2026-10-22T08:16:14.331119+00:00",
+        "manifest_sha256": "655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79"
+      },
+      "live": "/var/www/investmoz-homologacao/releases/042ffbde44cac27704d6f8b7ec25b525a42e3575-6dfae60c",
+      "env_path": "/var/www/html/teste-investidor.tempo.co.mz/.env",
+      "env_sha256": "a6b4e9064cf6dbb2d945b53418a6c9252f9c736ff3fde4016b95b74885a9ee0f",
+      "env_mode": "0o640",
+      "uid": 1001,
+      "gid": 33,
+      "private_preparation_env": "true",
+      "config": {
+        "private_preparation": true,
+        "investor_path": true,
+        "fiscal_consumer": {
+          "enabled": true,
+          "coverage_start": "2026-01-01",
+          "coverage_end": "2026-12-31",
+          "message": "IVA geral sobre base líquida disponível; enquadramento declarado."
+        },
+        "preparation_version": "private-investment-preparation-2026-v1"
+      }
+    },
+    "effective_procedural_version": "private-investment-preparation-2026-v1",
+    "new_fiscal_rules_published_or_activated": false,
+    "qa_fixtures_copied": false,
+    "accepted_scenarios_repeated_manually": false,
+    "limitations": "No new scenario executed in homologation and no real dossier or personal data created. QA functional evidence reused; destination verification limited to revision, configuration and entry routes. Sector/fiscal exclusions remain explicit."
   }
 }

docs/investmoz/simulations/modelo-a-reconciliacao-20261021.md

@@ -0,0 +1,93 @@
+# Reconciliação do IVA com o Novo Modelo A
+
+21/10/2026. Referência AUD-SIM-INT02, sem nova matriz/backlog. Preparação progressiva em QA; não é apuramento completo, submissão ou aceitação pela AT. A componente16% existente continua independente das restantes componentes por cadastrar/desenvolver. A leitura e aceitação documental da Tempo não é apresentada como validação jurídica independente.
+
+## Exemplar e preservação
+
+Exemplar exacto: **Novo Modelo A.docx**, 532008bytes, SHA256 **62c198e90d8c6792f7d5ccefc6386df2e4b6089573067d3a6e1eae7fc2b9572b**. Localizado na pasta de notas do portal indicada no inventário privado desta execução, não substituído por formulário genérico ou pela página da AT. O quadro1–8 é imagem incorporada: word/media/image2.png, SHA2567ae7f02efca96323087d0dfa5f3078b4ae724318edd5b6c4802c863d840bdf66, conferida visualmente sobre fundo branco para tornar legível a transparência. Os blocos seguintes e respectivas instruções foram extraídos do OOXML. Também se conferiram visualmente as três páginas da conversão de leitura em LibreOffice: quadros1–8 na primeira, créditos/quadros9–13 na segunda e apenas o rodapé de distribuição na terceira. A conversão apresenta deslocações de texto; serve para leitura, não é versão corrigida ou reprodução fiel para entrega. Nenhum DOCX original foi alterado, nem se afirmou edição oficial vigente pela simples leitura.
+
+Também inventariado e conservado **Novo Modelo A v1.docx**, 532100bytes, SHA25663d45fa80db17a60b43619d55a25813229d670d14c758273f86316285db8e02b. A mesma imagem é byte a byte igual; a extracção textual difere na segmentação de palavras. São originais distintos, não duplicados por bytes, conservados sem renomear uma revisão como diploma novo. A criação OOXML em21/10/2026 não é data de aprovação ou vigência do formulário.
+
+Biblioteca QA existente, clone simulator_fiscal_delta_20261021_test: recurso33/documento fbfa820d-29d5-4bf8-9f81-534931d80cef (original) e recurso34/documento cf8b799e-44de-4497-b2e3-a5c468f2fe0e (v1). Pré-visualização, hash, conflitos de identidade/bytes, importação privada idempotente, revisão/auditoria e scan reais reutilizados; ambos limpos com o hash analisado igual ao original. **Não publicados**; consulta privada e estado documental não activam cálculo. Actor166 é fixture QA já existente, configurada apenas neste processo de ensaio da administração da biblioteca, sem atribuir função real da Tempo ou alterar permissões persistentes. Nenhuma importação no destino activo. A aceitação oficial da Tempo08/10 é preservada; os estados genéricos do importador não a revogam nem certificam vigência.
+
+## Correspondência dos quadros
+
+| Quadro/bloco no exemplar | Finalidade e dados existentes | Delta/limite |
+|---|---|---|
+|1 — Tipo de declaração|Inicial/substituição; não corresponde a criar versão de uma projecção|Não simular uma declaração efectiva; futura ligação a declaração anterior separada de versões de planeamento|
+|2 — Período/prazo|Meses da projecção disponíveis; não prova de entrega dentro/fora do prazo|Calendário fiscal e entrega efectiva por integrar; nunca marcar submissão pela data da simulação|
+|3 — NUIT/sucursal/Área Fiscal|Identificação guardada no dossier quando disponível|Reutilização com confirmação específica; não exigir NUIT para planear nem inferir enquadramento fiscal|
+|4 — Nome/designação|Identificação privada existente|Não copiar para documento público; tratar como dado efectivo só se confirmado|
+|5 — Actividade/CAE|Actividade/sector existentes; não garantem CAE ou taxa|Correspondência CAE e classificação por operação, sem converter sector em incidência|
+|6 — Domicílio fiscal|Localização e contactos do dossier|Domicílio do projecto não prova domicílio fiscal; recolher apenas diferença/confirmar contexto|
+|7 — Inexistência de operações|Zero de vendas é conhecido, mas aquisições podem existir|Não assinalar inexistência por vendas zero ou campos vazios; precisa de todas as operações activas/passivas|
+|8 — Apuramento|Campos01–18; componente01/02 disponível no âmbito actual|Demais bases, imposto suportado/dedutível e regularizações continuam indeterminados|
+|Utilização de créditos anteriores|Campos19/20; o texto remete novamente para quadro8|Registar remissão ambígua; créditos efectivos e comunicados distintos de estimativas/pedidos|
+|9 — Substituições|Campo21 e referências17/18 da actual/substituída|Guardar a relação entre declarações efectivas; uma nova simulação não substitui declaração|
+|10 — Entrega ao Estado|Campos22–24, meios de pagamento|Sem pagamento ou guia gerada; caixa prevista não prova liquidação|
+|11 — Recuperação|Campos25–27, reporte e pedido|Separar crédito, pedido, reconhecimento e recebimento; não gerar reembolso automático|
+|12 — Autenticação|Data/nome/assinatura do sujeito passivo|Autenticação do portal não assina nem submete Modelo A|
+|13 — Serviços|Entrada/inserção/receita/funcionário/recebedor|Reservado à AT; não preencher ou imitar aceitação administrativa|
+
+## Correspondência campo a campo
+
+Os rótulos de finalidade são explicativos; não corrigem a imagem nem substituem o original. Fórmulas impressas estão mapeadas, não activadas por este registo. Ausência de componente não equivale a zero.
+
+|Campo do Modelo A|Finalidade|Origem dos dados|Cálculo|Fundamento|Já implementado/em falta|
+|---|---|---|---|---|---|
+|01|Base das operações à taxa geral|Vendas mensais já projectadas, declaradas sem IVA e no âmbito geral|Base líquida do mês|CIVA arts.15 e 17; Lei22/2022; regra publicada existente|Implementado no âmbito declarado|
+|02|IVA à taxa geral|Resultado mensal congelado no servidor|Campo01 × taxa da versão publicada /100|CIVA art.17(1); mesma regra/versionamento do consumidor|Implementado; componente do apuramento|
+|03|Base de operações específicas à taxa reduzida|Operações separadas e enquadradas; ainda não recolhidas|Base das operações elegíveis|Exemplar e CIVA art.17-A, aditado pela Lei22/2022; enquadramento a cadastrar|Em falta; não assumir zero|
+|04|IVA à taxa reduzida|Campo03 e futura versão fundamentada|Campo03 × taxa reduzida aplicável; não activa pelo exemplar|CIVA art.17-A; âmbito/versão temporal a integrar|Em falta; não assumir zero|
+|05|Vendas isentas com direito à dedução|Vendas classificadas por operação e fundamento|Soma das bases classificadas; sem taxa presumida|Exemplar; CIVA arts.9–14 e 18–20 a consolidar por operação|Em falta; não assumir zero|
+|06|Operações da alínea b), n.º1, art.18, conforme exemplar|Operações classificadas com referência verificada|Soma separada; não inferir do nome do sector|Remissão do exemplar ao art.18(1)(b); cotejo do âmbito necessário|Em falta; não assumir zero|
+|07|Isentas sem direito à dedução|Vendas classificadas e uso das aquisições|Soma das bases elegíveis|Exemplar; incidência/isenções e exclusões de dedução a fundamentar|Em falta; não assumir zero|
+|08|IVA dedutível — imobilizado|Aquisições/facturas de activos, não o valor global do investimento|Apenas imposto elegível documentado|CIVA arts.18–21; art.18(2), Lei10/2025: documentos legais e fornecedor inscrito|Em falta; não assumir zero|
+|09|IVA dedutível — existências|Compras projectadas reutilizáveis; falta IVA, documento e elegibilidade|IVA elegível das existências, não compras × taxa geral|CIVA arts.18–21; condições/exclusões, afectação e período|Em falta; não assumir zero|
+|10|IVA dedutível — outros bens/serviços|Aquisições discriminadas; despesas agregadas não provam IVA|IVA elegível; excluir operações sem direito|CIVA arts.18–21; art.19(2), Lei10/2025, inclui exclusão das operações art.17-A|Em falta; não assumir zero|
+|11|IVA dedutível — importações|Documento aduaneiro legal e afectação; ainda não recolhidos|Imposto aduaneiro elegível, não taxa sobre orçamento|CIVA art.18(2), Lei10/2025; demais condições/exclusões a cadastrar|Em falta; não assumir zero|
+|12|Regularizações a favor do sujeito passivo|Ajustamentos individualizados, documento e motivo|Soma de regularizações elegíveis|Exemplar tem remissão interna 11/12 divergente das caixas12/13; fundamento por motivo por conferir|Em falta; não assumir zero|
+|13|Regularizações a favor do Estado|Ajustamentos individualizados, documento e motivo|Soma separada das regularizações elegíveis|Mesma divergência; não corrigir o original nem inventar incidência|Em falta; não assumir zero|
+|14|Soma das bases do quadro de apuramento|Campos01,03,05,06,07 completos|01+03+05+06+07|Fórmula impressa no exemplar; não é apenas vendas tributáveis|Estrutura mapeada; total indeterminado|
+|15|Total a favor do sujeito passivo|Campos08–12 completos|08+09+10+11+12|Fórmula do exemplar; depende de deduções/regularizações fundamentadas|Estrutura mapeada; total indeterminado|
+|16|Total a favor do Estado|Campos02,04,13 completos|02+04+13|Fórmula impressa no exemplar; 02 sozinho não equivale a16|Estrutura mapeada; total indeterminado|
+|17|Diferença devedora antes de créditos anteriores|Totais15/16 completos|16−15 quando16>15|Instrução do exemplar; não é automaticamente pagamento|Indeterminado; sem consolidação completa|
+|18|Diferença credora antes de créditos anteriores|Totais15/16 completos|15−16 quando15>16|Instrução do exemplar; não constitui reembolso reconhecido|Indeterminado; sem consolidação completa|
+|19|Excesso a reportar do período anterior|Histórico fiscal anterior confirmado, separado de estimativas|Crédito anterior utilizável; sem copiar crédito estimado|Quadro de utilização de créditos do exemplar; condições/prazo por conferir|Em falta; não assumir zero|
+|20|Créditos comunicados pelos serviços|Comunicação efectiva da Administração Fiscal|Crédito efectivamente comunicado e utilizável|Exemplar; não converter pedido ou crédito estimado em comunicação|Em falta; não assumir zero|
+|21|Diferencial de declaração de substituição|Valores17/18 da declaração actual e da substituída|Casos impressos no quadro9, com sinal devedor/credor|Exemplar; ligação às declarações efectivas e regras de substituição em falta|Em falta; não assumir zero|
+|22|IVA a entregar no contexto da declaração|Apuramento e créditos/substituição completos|Não derivar apenas do campo02|Quadro10 do exemplar; procedimento aplicável por fundamentar|Em falta; não assumir zero|
+|23|Juros compensatórios|Factos e períodos que legalmente os determinem|Sem taxa, mora ou obrigação presumidas|Quadro10; fundamento específico não analisado neste lote|Em falta; não assumir zero|
+|24|Importância a pagar|Campos22/23 completos|22+23|Fórmula do exemplar; não é ordem nem execução de pagamento|Em falta; não assumir zero|
+|25|Crédito de imposto do quadro11|Apuramento completo e tratamento dos créditos anteriores|Montante recuperável no contexto próprio, por fundamentar|Caixa25 confirmada visualmente no bloco de recuperação; condições por consolidar|Em falta; não assumir zero|
+|26|Reporte para período seguinte|Crédito utilizável e opção no quadro11|Separado de pedido e recebimento|Quadro11; cotejo de condições/prazos e articulação19/20 necessário|Em falta; não assumir zero|
+|27|Pedido de reembolso|Crédito elegível e pedido, sem presumir reconhecimento/caixa|Pedido distinto de aprovação e recebimento|Exemplar cita art.20; Lei10/2025 altera reembolsos no art.21. Divergência registada.|Em falta; não assumir zero|
+
+## Cotejo documental para o período2026
+
+Reutilizados os exemplares oficiais aceites e arquivados em source-archive, a fichaIVA existente e a análise primária; não se pede nova autenticação genérica das fontes. Leitura dirigida agora: Lei22/2022, art.2/aditamento17-A, PDF4/BR2252-(28), e art.6, eficácia01/01/2023; Lei10/2025 no BR248/suplemento1, PDF12–15, especialmente arts.18,19,21 na PDF13/BR2180-(13), arts.32/34 na PDF14. Páginas13 e14 de2025 e página4 de2022 renderizadas para confronto. Não se afirma revisão integral de todo o CIVA ou de todas as alterações/regulamentos.
+
+- Campo01/02: taxa geral e base líquida já fundamentadas pela ficha existente; não reabrir a prova do motor.
+- Campo03/04: o art.17-A aditado pela Lei22/2022 identifica serviços médicos/sanitários de estabelecimentos privados indicados; ensino por estabelecimentos privados integrados e reconhecidos; formação profissional por entidades privadas; lições pessoais escolares/superiores. Esta enumeração não classifica automaticamente uma empresa ou toda a sua facturação. Falta cadastro/integração do âmbito temporal e classificação por linha; não se publica uma regra5% com base apenas no formulário.
+- Aquisições: Lei10/2025, art.18(2), exige os documentos legais indicados e inscrição do fornecedor; art.18(6) trata proporcionalidade em certas bases reduzidas. Art.19(2) exclui o direito relativo às operações do art.17-A e às indicadas no art.15(6)(c). Portanto, o valor das compras ou o IVA suportado não podem ser automaticamente dedutíveis. Arts.18(1),19(1),20,21 e22, exclusões, afectação, pro rata e momento de dedução precisam de consolidação para cada futuro lote; os trechos[...] da lei alteradora não substituem o texto-base.
+- Reembolso: a nota do exemplar cita art.20. A Lei10/2025 altera no art.21 condições e prazos de reembolso/crédito, incluindo números7/8/10/13/15. Registar a divergência; não transplantar prazos ou limites isolados para regras de elegibilidade. Crédito não é recebimento garantido.
+- Preços com IVA incluído: art.34 na redacção de2025 prevê método específico para apurar a base e referência a arredondamento nesse contexto. Não é regra universal para o cálculo líquido, nem autorização para aplicar16% ao bruto. O consumidor actual continua a preservar o bruto e a não o calcular. A extensão requer implementação própria e casos dirigidos; não reabre como bloqueio o arredondamento já resolvido para base líquida.
+- Declaração/período: art.32 alterado em2025 distingue situações/prazos. Não se decide entrega fora/dentro do prazo por ser uma projecção futura. O exemplar instrui terminar no quadro8 em certos casos; essa instrução não está activa como regra de software.
+
+**Divergências preservadas:** linha de regularizações diz campo11/12 mas caixas12/13; utilização de créditos cita campos18/19, enquanto as caixas desse bloco são19/20; nota de reembolso cita art.20 e as alterações de2025 tratam a matéria no art.21; remissões de quadro8 são ambíguas; a repetição25 foi um artefacto da extracção textual, não uma duplicação de campo no formulário, cuja caixa25 foi confirmada visualmente. Não se fez correcção silenciosa nem se apresentou uma transcrição com ambiguidades como fórmula legal inequívoca.
+
+Pesquisa oficial21/10/2026: [página AT Modelo A](https://edeclaracao.at.gov.mz/formularios/iva/view/formulario_iva_ma.aspx) tem resultado indexado com apuramento no quadro5, diferente do quadro8 deste exemplar. A abertura directa expirou; não se descarregou formulário substituto nem se certificou qual é a edição vigente. [INM BR248/2025](https://inm.gov.mz/pt-br/content/sum%C3%A1rio-suplemento-n%C2%BA-1-de-291225-pag-2180-1-20-br-n%C2%BA-248-boletim-da-rep%C3%BAblica-i-serie-p%C3%A1g-1) identifica a Lei10/2025. O [comunicado governamental de30/09/2026](https://portaldogoverno.gov.mz/governo-introduz-alteracoes-nos-regulamentos-fiscais-para-reforcar-eficiencia-tributaria/) anuncia alterações regulamentares; não fornece por si o articulado para cadastrar novos critérios. A edição exacta aplicável do formulário, correspondência da Lei3/2025 referida na Lei10/2025 e regulamentos pertinentes permanecem por localizar/consolidar no lote respectivo. Nenhuma destas pendências é convertida em bloqueio genérico do cálculo líquido16% já aceite.
+
+Inventário complementar sem utilização automática: Downloads/IVA-2025.pdf(83páginas, consolidação com leis listadas na capa, origem oficial do exemplar ainda não identificada), iva.pdf(8páginas sem texto extraível nas duas primeiras) e alteracao CIVA2023(18páginas, BR250/2022, já corresponde ao acervo arquivado) foram localizados. Não se usa a consolidação de programação ou uma cópia sem identificação como substituto do BR. O inventário global anterior e as fontes não analisadas permanecem conservados.
+
+## Delta entregue e execução progressiva restante
+
+**Entregue nesta candidataQA:** correspondência consultável dos27campos, quadros documentados, resumo mensal rotulado como simulação parcial01/02, notas no relatório sem reescrever os snapshots aceites, reutilização das compras/encomendas activas (por produto, calendário ou constante) mantendo zero distinto de falta e base/IVA/dedução separados e indeterminados. Não transforma custo das vendas, depreciação, pagamento de fornecedor, investimento global ou compra no imposto dedutível. Sem taxa nova no formulário, novo motor, migration, regra publicada ou activação.
+
+**Próximo lote implementável delimitado:** classificação fiscal por operação de venda e aquisição, com pressuposto ou dado efectivo identificados; tipos de documento, datas, fornecedor/inscrição quando aplicável, utilização e exclusões; separar net/IVA/gross sem repetir quantidade/preço. Reutilizar planos como fontes, pedir apenas a classificação e o que falta; registar ligações/versionamento do dado de origem, não copiar e divergir. Dados efectivos não substituem previsões históricas nem herdam automaticamente as declarações de âmbito da projecção. No cadastro, configurar versões/âmbitos/condições da taxa5% e das deduções apenas após consolidar os dispositivos pertinentes; testes de operações excluídas e entradas insuficientes antes de publicar. Depois ligar totais14–18 através do avaliador existente, propagando indeterminação até todas as parcelas estarem conhecidas ou explicitamente sem operações. Num lote posterior, créditos anteriores/substituições/pedido e liquidação, preservando comunicação/reconhecimento/caixa separados. A publicação/activação são operações expressas distintas da integração do código.
+
+Estimativa de saldo, não horas medidas nem compromisso de cobertura integral: **cadastro/consolidação8–16h** (classificação5%, deduções do primeiro âmbito, exemplos e correspondências) e **código/aceitação20–36h** (dados por operação8–14h; ligação a versões/dedução e totais8–14h; histórico/relatório/coerência4–8h), **28–52h** para o próximo lote delimitado. Créditos anteriores, substituições, pagamento/reembolso e cobertura integral ficam fora desta estimativa e exigem delimitação própria; não reutilizar as antigas15–26h como estimativa desta ampliação. Perguntas concretas ainda abertas: edição/norma de aprovação do formulário para o período e dispositivos consolidados pertinentes; não pedir à Tempo nova validação da credibilidade dos BR aceites.
+
+Critérios do lote seguinte: divisão de uma mesma venda entre enquadramentos sem duplicação; aquisições elegíveis/não elegíveis/mistas, documento ausente e fornecedor não inscrito; zero diferente de falta; não deduzir17-A; data relevante por componente; totais nulos com parcelas indeterminadas; alteração de origem cria versão e invalida dependentes, sem reescrever efectivos/previstos anteriores; relatório mostra período/fonte/regra e não gera declaração aceita, guia ou promessa de reembolso. Suspensão e históricos reutilizam o mecanismo existente.
+
+Provas deste delta:3testes frontend novos (prioridade dos calendários de compras, zero/falta e ausência de dedução presumida, adenda sem mutar resultados antigos); TypeScript/build; importação privada/hash/scan e repetição idempotente. Conferência Edge apenas da nova correspondência, compras e relatório recuperado, sem calcular novamente nem repetir CSV/PDF aceites. Provas privadas em outputs/modelo-a-20261021. MatrizAUD-SIM-INT02, inventário documental e recibo existentes actualizados; main e homologação intactos.

docs/investmoz/unification/traceability-and-manual.md

@@ -1,5 +1,20 @@
 # Rastreabilidade, utilização e formação
 
+## Guia curto — entrada única de gestão
+
+**Link da equipa:** https://teste-investidor.tempo.co.mz/gestao-conteudos. Entre com a conta habitual e o seu MFA. As funções e âmbitos aprovados determinam os botões apresentados; não é necessário acesso à linha de comandos.
+
+| Trabalho | Percurso pela interface |
+| --- | --- |
+| Oportunidades | **Nova oportunidade** → escolher promotor real e modalidade → preencher → **Guardar rascunho**. Recuperar em **Gerir oportunidades e histórico**; abrir a ficha, completar **Imagens, documentos e localizações** e **Submeter para validação**. O Validador usa a fila de revisão e as acções **Iniciar validação**, **Guardar revisão especializada**, pedir correcções ou **Aprovar versão**, conforme a tarefa atribuída. O Publicador usa a fila de publicação e **Publicar no catálogo público** na versão aprovada com visibilidade pública. A equipa conclui as funções que já lhe foram atribuídas; a criação não concede revisão nem publicação. |
+| Documentos | **Novo documento** → escolher ficheiro e origem conhecida → **Guardar em quarentena** → conferir a análise indicada no ecrã → completar **Registar documento na biblioteca** → **Guardar como rascunho**. Recuperar pela pesquisa em **Gerir conteúdos, versões e histórico**; usar **Editar metadados** para rever; guardar as alterações e usar **Publicar**. Se o scanner comunicar falha, usar **Tentar novamente**; avaria persistente é manutenção técnica, não uma nova aprovação documental. |
+| Legislação | **Nova legislação** → mesmo percurso documental, com tipo Legislação pré-seleccionado → registar entidade, número, edição, fonte, datas e situação conhecida → guardar → pesquisar/reabrir → rever metadados/associações → **Publicar**. Fonte oficial identificada mantém a aceitação da Tempo; não exige segunda certificação. A publicação permite consulta e não activa regras fiscais. |
+| Divulgação promocional — candidata QA | **Gerir oportunidades e histórico → Divulgação promocional** (também na ficha) → preencher apenas título/resumo/texto, fonte/edição/data-base e abrangência a divulgar → **Preparar prévia de divulgação** → rever o conteúdo público → motivo e confirmação → **Confirmar divulgação do resumo**. Para actualizar: reabrir → alterar o resumo → **Rever actualização do resumo** → confirmar. Para retirar: **Preparar retirada do resumo → Confirmar retirada do resumo**. O estado público é **Em preparação**; não conclui o workflow nem autoriza execução. Não inclui contactos ou anexos privados. Esta acção está preparada em QA e não foi instalada na homologação nesta passagem. |
+
+Para retirar um documento, abrir o registo e usar **Retirar da publicação**; original e histórico ficam preservados. Para oportunidades, usar as acções de suspensão/arquivo apresentadas à função responsável. Não se apagam registos para os retirar do público.
+
+Este guia descreve os percursos existentes; a instalação de código é manutenção pelo processo Git automático. Contas ainda não criadas conservam as designações aprovadas e não suspendem os acessos das contas existentes. Conferência real desta instalação registada na secção de entrega, abaixo; o guia não substitui essa evidência.
+
 ## Parques — disponibilizados em18/10/2026
 
 Revisão `parques-integral-reconciliado-639ed9624a48` disponibilizada em `https://portal-investidor.test`, com autorização expressa da Tempo. Sete fontes (cinco funcionais e dois auxiliares gerados) e170 ficheiros de build; nenhuma migration executada. L1/140000, navegação/150000 e editorial160000 preservados. Backup/restauro fresco e preservação de dados conferidos. Os dados reais desconhecidos mantêm-se desconhecidos; não se encerram todos os requisitos da ficha pelo nome integral.
@@ -1961,3 +1976,313 @@ Para suspender, desligar `INVESTMOZ_IVA_CONSUMER_ENABLED` e reiniciar graciosame
 Activação separada aplicada em21/10/2026 às10:55:58UTC, alterando apenas as três chaves do consumidor. Ligação exacta aoID acima, rule_version1 eenabled=true; restante configuração preservada. `/api/v1/fiscal-consumer` confirmouenabled=true porHTTP200; a leitura do resolvedor, sem executar cálculo, confirmouIVA_GENERAL_RATE=16percent, mesmoID/versão/fonte no contextoMZN/internal_general_net de2026. Cinco eventos de governação; contagens de resultados/relatórios preservadas, sem simulações sintéticas no destino. O restauro de segurança e a configuração anterior estão conservados no arquivo privado identificado no recibo.
 
 Suspensão concreta: configurar `INVESTMOZ_IVA_CONSUMER_ENABLED=false` e executar o reinício gracioso existente `php8.4 artisan queue:restart` na releaseactual como operador autorizado; ou `POST /api/v2/investment/admin/tax-rules/01a15e1a-5338-700f-8a45-f87707d696a7/suspend`, com `version_no:5` enquanto corrente e evidência verdadeira de pelo menos20caracteres, pela administração autenticada/MFA. Não repetir a suspensão se o estado/versão já tiver mudado. Conservar a ligação e todos os registos; futuras retomas respeitam o estado da regra e o procedimento de versão aplicável, sem escolher automaticamente outra regra.
+
+
+### Diagnóstico da consulta IVA — correcção em QA,21/10/2026
+
+O caso reportado identifica «Componentes fiscais e contributivas», IVA_GENERAL_RATE, período01/01/2026–31/12/2026 e «As condições publicadas não correspondem às respostas indicadas». É consulta de parâmetros, não execução do consumidor IVA. O utilizador não forneceu a moeda ou a operação originais; não se afirma que tenha seleccionadoUSD, omitido um campo ou indicado uma operação excluída.
+
+**Causa confirmada no contrato:** o formulário envia `fiscal_operation`, sem `operation` ou `currency`; a versão publicada exige `operation=internal_general_net` e `currency=MZN`. A validação da consulta nem aceitava esses nomes canónicos. O resolvedor reduzia qualquer condição falhada a `indeterminate_context`; a interface mostrava apenas a frase genérica e o código interno. Esta restrição de ligação é escolha de implementação, não condição organizacional ou jurídica adicional da Tempo. O mesmo contrato reproduziu o estado no período anual reportado, independentemente de se presumir uma moeda no caso original.
+
+**Correcção delimitada:** cada condição não satisfeita tem categoria, campo, valor recebido e critério esperado, ligados à versão e fonte. Distinguem-se campo em falta, formato inválido, operação/moeda fora do âmbito, versão que não cobre o período e configuração do sistema. Quando não existe versão elegível visível e a evidência não permite separar ausência de cobertura de indisponibilidade de fonte/configuração, a interface mantém essa incerteza; não inventa uma causa nem atribui culpa às respostas.
+
+A consulta IVA passa a ter moeda explícita (`fiscal_currency`), guardada no rascunho, sem presumirMZN ou copiar moeda do orçamento ou do cálculo IVA. A API recebe esse valor em `context.currency`. A operação genérica não se converte automaticamente no âmbito «operação interna à taxa geral sobre base líquida»: a limitação de integração é explicada com a resposta recebida e o critério esperado, e existe ligação para o formulário IVA com declaração explícita do âmbito. Uma importação/exportação/não residente/reembolso expressamente seleccionado é identificado como exclusão deste lote; não se altera a resposta para a fazer passar.
+
+As notas aparecem junto dos campos e num resumo com ligações que focam o campo correspondente, mantendo o rascunho. O nome apresentado é «IVA — taxa geral»; «Ver fundamento» contém versão, vigência e fonte, sem expressãoDSL. As falhas de consulta/configuração são identificadas como sistema. O percurso de cálculo e as suas regras de admissão não foram ampliados. A consulta diagnóstica pode observar versões publicadas fora do período seleccionado, sob a mesma política de visibilidade, apenas para explicar a falta de cobertura; não as torna elegíveis.
+
+**Prova dirigida:**5testes unitários novos/24asserções;1testeAPI/16asserções no clone isolado simulator_fiscal_checks_20261021_test;7testes existentes do resolvedor/25asserções; TypeScript, build(exit0), Pint e diff-check. A primeira execuçãoAPI detectou que esse clone ainda não tinha a coluna fiscal_acceptance; aplicou-se nele a correcção de esquema já aceite, com a guardaQA intacta, e repetiu-se apenas o testeAPI afectado. Não é diagnóstico da base de homologação. A comparação por índice do ensaio foi ajustada à ordem das chavesJSONB; não se alterou o critério fiscal.
+
+No Edge, simulador normal QA em127.0.0.1:18580: consulta anual2026, operação genérica explicitamente escolhida para o ensaio; moeda inicialmente vazia, depoisUSD escolhido expressamente como caso dirigido. Confirmaram-se notas, resumo, foco em «Rever moeda»/«Rever operação», fundamento da versão sintética3, eUSD/ano/periodicidade/operação conservados após gravação e recuperação do mesmo rascunho. A captura de prova é um ensaioUSD, não evidência deUSD no caso original. Não se executou cálculo nem se exportou relatório. A fixture publicada apenas emQA para observar o diagnóstico foi depois suspensa; o consumidorQA permaneceu desligado. Nenhuma fixture foi importada, regra alterada ou consumidor activado na homologação nesta correcção.
+
+Provas privadas na pasta `outputs/simulator-continuation-20261020`: iva-diagnostic-api-test.txt, iva-diagnostic-summary.txt, iva-diagnostic-summary.png e iva-diagnostic-build-final.txt. O reciboJSON existente tem o estado detalhado. A candidata permanece na branch `codex/iva-diagnostics-QA`, separada de main; não é uma nova publicação fiscal nem altera a entrega autorizada anteriormente.
+
+
+### IVA mensal ligado às vendas — candidata QA, 21/10/2026
+
+Pedido da Tempo: o formulário recolhe pressupostos do negócio e calcula o IVA correspondente, sem repetir vendas nem tomar o imposto manual como entrada fiscal. A falta de ligação entre a projecção empresarial e o consumidor publicado era uma escolha de implementação; não uma nova obrigação do utilizador. Alteração na branch `codex/iva-monthly-projection-QA`, separada de main. Não altera a instalação, regra ou activação da homologação.
+
+**Ligação:** o simulador normal reutiliza quantidades e preços por produto/mês do plano empresarial, com a mesma representação monetária das vendas já usada nesse plano. Se não existir plano, admite a receita mensal constante já guardada na projecção personalizada, identificando essa origem e exigindo declaração do enquadramento. Não usa os valores demonstrativos de um widget ainda não guardado. A indicação sem IVA/com IVA incluído fica explícita, sem a presumir. Neste lote só a base líquida declarada permite calcular: preços com IVA incluído, base desconhecida e meses sem vendas informadas permanecem indeterminados. Zero explícito calcula IVA zero; não se preenche um mês vazio com zero.
+
+O cliente envia meses, vendas, moeda e declaração; não envia taxa, versão ou imposto manual. O servidor selecciona a versão publicada ligada ao consumidor e reutiliza o resolvedor temporal e avaliador decimal existentes em cada mês, dentro da mesma admissão transaccional. Nenhuma taxa foi fixada no formulário, nem introduzido arredondamento fiscal. A versão é congelada antes da fila; mantém-se a autorização/idempotência/histórico/relatório existentes. Sem migration ou reconstrução dos mecanismos. Cobertura permanece 2026, no máximo 12 meses consecutivos; um horizonte que atravessa o limite é explicado, sem truncar a projecção.
+
+**Ecrã e dependências:** cada mês apresenta vendas declaradas, vendas tributáveis sem IVA, taxa efectivamente aplicada, IVA calculado e total com IVA. Após a primeira execução, a actualização automática fica ligada e pode ser pausada. Alterar vendas, moeda, período ou tratamento do IVA assinala imediatamente o resultado anterior como histórico desactualizado. A nova execução guarda outra versão sem modificar a anterior. Repetir sem alterações recupera a execução concluída; uma execução pendente é consultada pelo mesmo ID. Falhas conservam os pressupostos e permitem tentar novamente. O rascunho conserva configurações e resultado; o relatório distingue resultado actual e histórico desactualizado e não recalcula o IVA na exportação. Se algum mês estiver indeterminado, o total fiscal fica indeterminado, conservando os meses conhecidos.
+
+**Tesouraria adoptada:** o IVA é um memorando fiscal separado; não se soma novamente aos recebimentos introduzidos, não se deduz como custo e não se apresenta como imposto final a pagar. Conserva-se o calendário de recebimentos/pagamentos declarado, sem inferir cobrança integral no mesmo mês nem liquidação fiscal. O imposto manual permanece exclusivamente no painel recolhido «Cenário personalizado de tesouraria — imposto manual, separado do IVA calculado», com rótulos de cenário personalizado. Não alimenta a base nem o resultado do consumidor IVA. Não foram acrescentados deduções, créditos, reembolsos, importações, isenções, taxas reduzidas ou regimes especiais ao cálculo fiscal; as hipóteses antigas de tesouraria continuam personalizadas e separadas.
+
+**Provas apenas do delta:** 3 testes API novos/46 asserções, transacções no clone `simulator_fiscal_checks_20261021_test` com guarda QA; 4 testes frontend novos para reutilização das vendas, zero/informação em falta, invalidação e recuperação/relatório. Incluem taxa proibida no cliente, âmbito não declarado, preços brutos, período excluído, repetição sem duplicações, versão congelada antes da suspensão e conclusão depois dela. TypeScript/build/Pint/diff-check verificados. Reutilizadas as provas aceites do avaliador decimal, exportadores e PDF; não se voltou a testar paginação nem a ampliar cobertura legal.
+
+**Percurso Edge no simulador normal:** dossier sintético privado «QA IVA mensal - vendas projectadas», ID `e0201d19-286e-4d5c-9585-2c1e3bd1ad1e`, QA127.0.0.1:18580. Vendas Janeiro1000.03/ Fevereiro2000.06/ Março0/ Abril vazio produziram IVA160.0048/320.0096/0/indeterminado. Alterar apenas a quantidade de Janeiro de1 para3 actualizou vendas3000.09, IVA480.0144 e total3480.1044. Assinalou-se resultado desactualizado durante a mudança. Seleccionar preços com IVA incluído conservou vendas e tornou base/IVA/total indeterminados; voltar manualmente à base líquida gerou nova execução. Após recarregar e recuperar o mesmo dossier, os valores permaneceram iguais e o fundamento mostrou a versão congelada. Quatro execuções mensais intencionais (inicial, venda alterada, base incluída, regresso à líquida), quatro relatórios com snapshots iguais às respectivas execuções; recuperação não criou a quinta. Não se atribui aplicabilidade fiscal universal a estes exemplos aritméticos.
+
+A fixture sintética **v4**, ID `01a15e50-7972-72e0-8991-82ca28df9b49`, está publicada e o consumidor ligado **apenas no clone QA** `simulator_fiscal_delta_20261021_test`, deixados disponíveis para esta revisão. Isto substitui o estado local suspenso/off da prova diagnóstica anterior; não é indisponibilidade na homologação. Não importar esta fixture, os seus actores ou os scripts privados. A regra real de homologação v1 mantém-se fora desta execução.
+
+**Revisão e disponibilização:** rever esta candidata QA e integrar somente o código autorizado, mantendo a ligação ao ID/versão reais do destino. Este delta não precisa de publicar outra regra nem de mudar a taxa/âmbito ou de reactivar um consumidor já activo. Conferir apenas revisão servida e ligação mensal no destino após autorização própria; conservar o procedimento separado de publicação e activação se alguma dessas operações vier a ser expressamente pedida. Suspender novas admissões pelo interruptor existente ou estado da regra preserva as já admitidas e os históricos. Não apagar snapshots para suspender ou reverter código. Sem integração em main, escrita activa, validação jurídica atribuída à Tempo ou nova ronda de preparação identificada nesta entrega QA.
+
+Provas privadas em `outputs/simulator-continuation-20261020`: monthly-iva-api-test.txt, monthly-iva-build-final.txt, monthly-iva-initial.txt, monthly-iva-updated.txt, monthly-iva-stale.txt, monthly-iva-included.txt, monthly-iva-recovered.txt, monthly-iva-live-history.json e monthly-iva-proof.png. O recibo existente conserva o saldo e os IDs; AUD-SIM-INT02 da matriz existente recebe esta referência, sem outra matriz/backlog.
+
+
+### Reconciliação Modelo A — primeiro incremento QA,21/10/2026
+
+Por instrução expressa da Tempo, o **Novo Modelo A.docx** é a referência estrutural, incluindo o quadro incorporado como imagem; não foi substituído por um modelo genérico. A [reconciliação campo a campo](../simulations/modelo-a-reconciliacao-20261021.md) contém todos os quadros, campos01–27, finalidade, origem, cálculo, fundamento e estado; inventário/versões/exemplares e divergências preservados. A componente16% existente representa apenas01/02. O apuramento14–18 não se presume igual ao IVA das vendas; não é saldo final a pagar.
+
+Original532008bytes/SHA25662c198e90d8c6792f7d5ccefc6386df2e4b6089573067d3a6e1eae7fc2b9572b e variantev1 de532100bytes/63d45fa80db17a60b43619d55a25813229d670d14c758273f86316285db8e02b preservados na biblioteca **privada QA**, recursos33/34, documentos e revisões/auditoria existentes. Importador existente, pré-visualização, conflitos/duplicados, scans reais limpos com mesmohash e nova tentativa sem criar documentos ou scans. Actor166 é a fixture administrativa do ensaio isolado, sem papel real ou alteração persistente de permissões atribuída à Tempo. Nenhuma publicação ou importação na homologação. Aceitação das fontes oficiais da Tempo08/10 mantida; edição vigente do formulário não afirmada pela data OOXML nem pela leitura do anexo.
+
+No simulador normal, resumo de simulação parcial e correspondência consultável ligados ao resultado mensal recuperado. Compras/encomendas projectadas reutilizadas conforme agenda activa por produto, calendário ou valor constante; não são custo das vendas ou pagamentos de fornecedor. Zero difere de falta. A indicação semIVA/IVA/comIVA/dedutível fica separada e por determinar quando faltam classificação e documentos; não se considera toda compra dedutível. Relatório acrescenta correspondência/limites e referências dos pressupostos actuais de compras, sem os apresentar como resultado fiscal histórico nem reescrever snapshots. Nenhuma nova fórmula fiscal activada ou taxa fixada no formulário; sem migration ou motor novo.
+
+Cotejo dirigido: Lei22/2022 art.17-A/aditamento e eficácia; Lei10/2025 arts.18/19/21/32/34 nas páginas12–15 do BR248, com leitura visual13/14. Registadas remissões divergentes do exemplar (regularizações11/12 versus caixas12/13; crédito18/19 versus caixas19/20; reembolsoart20 versus matéria noart21; quadro8 ambíguo). Não corrigir original nem aplicar instrução ambígua como regra. AT directa expirou; resultado indexado com numeração distinta é limitação de consulta, não substituto nem prova de edição vigente. Lei3/2025/dispositivos/regulamentos pertinentes por consolidar na extensão concreta, sem reabrir genericamente a base líquida16% aceite.
+
+Provas novas apenas do incremento:3testes frontend (agendas, zero/falta, sem IVA/dedução fabricados e relatório sem mutar resultado), TypeScript/build, Edge de consulta após recuperação e biblioteca idempotente/scan. Avaliador, selecção publicada, precisão, históricos e exportadores aceites reutilizados. DossierQA e fixtureIVA v4 continuam disponíveis para revisão; este incremento não calcula novamente. Provas privadas outputs/modelo-a-20261021; recibo e inventário existentes actualizados. Branch codex/iva-modelo-a-reconciliation-QA, parent3f5430c3, separada de main; homologação/regra real/interruptor inalterados.
+
+Saldo explícito: **reconciliação e primeiro incremento de interface concluídos, apuramento completo não implementado**. Próximo lote: classificação por operação e origem prevista/efectiva, cadastro fundamentado de âmbito/dedução e ligação a totais14–18 propagando indeterminação; 8–16h cadastro/consolidação e20–36h código/aceitação, total28–52h condicionado ao âmbito/consolidação, sem créditos anteriores/substituições/pagamento/reembolso ou simulador integral. O documento contém o delta e critérios concretos. Integração do código, publicação e activação continuam operações distintas; esta preparação não executa nenhuma no destino.
+
+
+### Continuidade e adaptação contextual — primeiro incremento QA, 22/10/2026
+
+Instrução expressa da Tempo de 22/10: o contexto do investimento é transversal ao percurso, formulários, documentos e simulações, mesmo sem IA. Base Git e revisão servida confirmadas em leitura: `57fc914821d0cefa02caa80a74b3d42e663f2742`. Trabalho isolado em `codex/project-context-continuity-QA`, sem integração ou publicação/activação fiscal no destino.
+
+Causas identificadas no código e reprodução dirigida: `InvestorContext` só distribuía título, descrição, sector e geografia; o preenchimento comum copiava apenas campos vazios sem distinguir herança de edição deliberada; o IVA pontual mantinha moeda/data/base em estado local que desaparecia ao desmontar o ecrã. A projecção empresarial sobrepunha a moeda do projecto à moeda de origem do plano ao apresentar/calcular/exportar. No ensaio anterior, projecto guardado em MZN e selector IVA vazio. A primeira tentativa de abertura encontrou uma sessão expirada, confirmada pela leitura sem autenticação e resolvida pelo início de sessão normal; não foi classificada como perda do dossier.
+
+Correcção comum: consolidar exclusivamente o rascunho explicitamente ligado ao mesmo dossier e proprietário; conservar origem, versão e hash. Não procurar o último projecto da conta. Herança persistida com assinaturas de alteração por campo e âmbito dossier/consumidor; não são tokens de autorização nem prova jurídica. Actualizar valores ainda herdados, preservar alterações deliberadas e campos apagados; manter a hierarquia geográfica e os restantes dados das parcelas. O armazenamento do navegador passa a incluir conta e projecto. Consumidores do padrão: simulador, apoio à terra, Balcão e manifestação de investimento; esta última recebe também a moeda compatível. Campos sem correspondência semântica não são copiados. Nacionalidade, residência e país de constituição não são equiparados.
+
+O IVA pontual guarda as entradas com o rascunho. A exploração fiscal, oportunidade e componente pontual reutilizam a moeda compatível; a projecção mensal reutiliza o plano e o início previsto. Não se infere exigibilidade fiscal a partir da data prevista de início, nem residência jurídica a partir do país. USD é conservado e explicado como não suportado pela versão MZN. Uma divergência entre moeda guardada no plano e moeda do projecto é apresentada, sem conversão ou reclassificação. O plano conserva a moeda de origem também na apresentação e nos exportadores existentes. Vendas, zero/falta e snapshots de IVA continuam a usar o motor publicado e os históricos aceites; nenhum imposto mensal fixo é introduzido.
+
+Adaptação deste incremento: o editor existente passa a permitir moeda, início previsto, origem do investidor, tipo/situação da entidade e residência fiscal declarada, sempre pela prévia/confirmar existente. A prévia continua a identificar dados/documentos conservados, resultados e etapas afectados; alterações apenas ao título/descrição não invalidam a aplicabilidade. O selector territorial reutiliza o catálogo público `InvestmentZones` para parques, ZEE e ZFI, preservando versão/hash, fontes e condições públicas já divulgadas no complemento existente. A mesma síntese aparece no contexto e simulador e segue para o relatório do dossier. Os ramos de terra/financiamento reutilizam a definição publicada, factos, estados e razões de `InvestorPath`; não foi criado outro avaliador nem activado benefício.
+
+Escolher uma zona abre a análise específica: referência consultada, condições documentadas ou em falta, período/fonte cadastrados quando disponíveis e reconhecimento por determinar. O benefício e o cenário condicionado permanecem indeterminados quando não existe ligação executável às condições/reconhecimento. O IVA disponível é identificado como cenário geral sem benefício; não representa automaticamente o regime escolhido nem apuramento final. Reutilizam-se `InvestorContext`, `InvestmentZones`, `InvestmentZoneOperationalDetails`, `InvestorPath`/definição publicada, resolvedor/avaliador fiscal e snapshots existentes. A escolha técnica de exigir uma nova confirmação genérica dos mesmos dados em cada formulário foi retirada por instrução da Tempo; permissões, declarações, submissões formais, revisões independentes aprovadas e campos autorizados de pedidos devolvidos mantêm os controlos existentes.
+
+Provas novas: 4 testes HTTP/74 asserções, em transacções revertidas na base isolada `simulator_fiscal_delta_20261021_test`/loopback55441; 8 testes frontend de herança, edição/apagamento, isolamento, parcelas, moeda divergente e contexto no relatório; TypeScript/build. Percurso Edge: A nacional/MZN e residência fiscal ZA, vendas guardadas de quatro meses → cálculo mensal → gravação → edição deliberada do título → recarregamento → terminar sessão/iniciar sessão → recuperação e relatório pelos dados efectivamente guardados. Resultado `ae401465-834f-4761-9406-5af060c499fb`, uma única execução nova no dia; Janeiro1000.03/IVA160.0048, Fevereiro2000.06/320.0096, Marçozero e Abrilsem informação. O modelo de relatório recuperado conserva os valores exactos e não altera o snapshot. B estrangeiro/USD, primeiro divergência explícita planoMZN/projectoUSD, depois declaração manual USD no plano, IVA recusado sem conversão; selecção de parque pela prévia e análise específica. Os testes de ZEE/ZFI usam apenas metadados sintéticos revertidos: não demonstram elegibilidade real. Provas privadas em `outputs/context-continuity-20261022`; não entregar fixtures ou credenciais.
+
+Limites concretos: este é o primeiro incremento utilizável de continuidade e explicação contextual, não a conclusão da adaptação de todos os sectores/regimes. O catálogo QA consultado contém parques sintéticos; a ligação jurídica completa de requisitos/documentos/licenças e benefícios às condições de cada actividade/regime não está demonstrada. Condições sem estrutura/relação executável continuam explicitamente em falta; nenhuma alegação nova de direito ou benefício é feita. Não houve nova validação jurídica nem revalidação genérica de credibilidade das fontes oficiais aceites em08/10. Não repetir cálculo decimal/exportadores/paginação já aceites. A demonstração visual foi feita no percurso e simulador; os outros três consumidores receberam o reconciliador comum, sem se afirmar um ensaio visual integral de cada processo.
+
+Revisão: abrir o simulador QA com o dossier A `92d0836c-0ffb-4e07-a7f5-0e8ca3f594b9` ou B `1872412f-251a-4f6d-bf18-70388e71a16a`; usar a conta sintética QA existente, nunca actores sintéticos na homologação. O router privado de QA usa a instalação já existente do percurso, activada apenas neste ensaio isolado; não há migration ou nova exigência de funções. Entregar a candidata para revisão pelo processo Git existente, preservando alterações concorrentes. Uma integração futura exige rever o delta relativamente a main e o estado de instalação/configuração do percurso no destino; não publicar regras ou alterar interruptores fiscais como consequência desta correcção. Preservar todos os históricos na suspensão ou reversão de código.
+
+Fecho da observação deste incremento: o regresso A ao dossier gravou a evidência financeira `43317c22-50c8-40cf-98e4-e5d4d108c372`, rascunho `cf4dec46-c96c-4aa6-aa9c-1a8d6ecb1bea` v8, contexto v1, com hash preservado. A ligação de inspecção do Edge interrompeu-se depois da navegação; o inventário mostrou o endereço do mesmo dossier e a leitura autenticada do serviço confirmou a gravação. A parte visual final do regresso não foi observada e fica como limitação da ferramenta, não falha do simulador. B recuperou contexto v2 e gravou rascunho v6, mantendo USD e sem execução fiscal. O relatório gerado destes dados recuperados conserva a versão do parque e benefício indeterminado. O enriquecimento automático do rascunho privado é exclusivo do proprietário autenticado; o acesso de gestão ao dossier não concede por esta alteração acesso ao rascunho privado da conta.
+
+
+### Revisão de a76369eb e primeiro percurso adaptativo fundamentado — v1, 22/10/2026
+
+**Revisão encerrada no âmbito de a76369eb, sem integração.** O último regresso tem prova equivalente: destino do mesmo dossier observado pelo inventário do navegador e evidência `43317c22-50c8-40cf-98e4-e5d4d108c372` confirmada no serviço, ligada ao rascunho v8/contexto v1 e ao hash `a21fa5779bf8b8df366f16683c8a9bb9817a6d2921c7384f85df02135307fa13`. A observação visual final continuou limitada pela ferramenta. Não se repetiram A/B, cálculos, exportações ou nova sessão; reutilizam-se as provas aceites. Leitura dirigida do delta: isolamento por proprietário/dossier, edições/apagamentos, origem monetária, controlo de escrita e ausência de publicação fiscal. Não foi identificada nova preparação técnica que condicione a decisão de integração deste âmbito. A adaptação jurídica seguinte é independente.
+
+**Percurso delimitado preparado:** preparação de um pedido de investimento privado para empreendimento económico em Moçambique, com actividade concreta declarada, instalação identificada e operações mensais enquadráveis no consumidor IVA geral existente. Trata a preparação do pedido de investimento; não se apresenta como licenciamento sectorial completo, certificado emitido, direito a incentivo ou submissão à Administração. Investidor nacional/estrangeiro, actividade, modalidade e localização são condições distintas. A saída é formulário orientado, etapas/documentos aplicáveis e simulação identificada pelo seu âmbito. Não se escolhe “Turismo” ou uma ZEE para presumir requisitos ou benefícios.
+
+**Fonte primária aplicada:** compilação oficial APIEX “Legislação de Investimentos em Moçambique”, exemplar obtido de https://pt.apiex.gov.mz/wp-content/uploads/2025/02/LEGISLACAO-DE-INVESTIMENTOS-EM-MOCAMBIQUE.pdf — 6467655 bytes, SHA256 `ba1e9eaabfec5d0c4cb2d9f2444a6860f7a90f222034764197829be402d408ed`. Contém Lei8/2023 (pp.8–32), Decreto8/2024/Regulamento (pp.36–59), CBF (pp.64–92). Aceitação oficial de08/10 mantida; não há exigência de segunda autenticação ou aprovação jurídica da Tempo. Inventários existentes de604 registos/exemplares/anexos e9901 caminhos do acervo reutilizados antes da selecção; cópia privada, texto extraído e citações em `outputs/adaptive-path-20261022`. Não importar/publicar automaticamente. As pendências históricas genéricas de nova certificação nos levantamentos de28/09 e03/10 não são gates deste lote.
+
+**Período:** Decreto8/2024, artigo5 do diploma preambular, indica aplicação desde a publicação de7/03/2024; Lei8/2023, artigo32, indica90dias após publicação. O lote proposto cobre datas de projecto em2026 e preserva estes inícios, exemplar e versão. Não foi encontrada alteração nas consultas oficiais dirigidas desta execução; isso não certifica inexistência de actos posteriores. A compilação de2025 não constitui consolidação universal de2026. Na ligação executável, uma fonte/versão sem cobertura temporal não autoriza fallback para a versão mais recente. Os artigos citados são do **Regulamento anexo** quando identificado “R”; “L” designa a Lei8/2023. Rastrear esta distinção evita confundir os dois artigos9 ou o artigo5 preambular com o do Regulamento.
+
+| Condição | Fonte e período | Efeito no formulário | Efeito no percurso | Efeito no cálculo | Informação em falta / estado da ligação |
+| --- | --- | --- | --- | --- | --- |
+| Projecto económico em Moçambique que procura garantias/incentivos; actividade efectiva conhecida | L2(1)–(3), pp.8–9; período2026 deste lote | Reutilizar localização e actividade; perguntar a finalidade jurídica apenas se ausente | S02 identifica cobertura do procedimento; actividades excluídas recebem encaminhamento próprio | Não inferir benefício ou exclusão de IVA a partir deste âmbito | Falta ligação executável da cobertura ao perfil; legislação sectorial especial fica fora deste lote |
+| Capital/recursos do exterior ou nacionais; pessoa, residência e constituição separadas | L3/anexo, pp.28–29; R4–6, pp.38–40; período2026 | Reutilizar os dados declarados; pedir origem/forma do aporte quando faltar, sem transformar nacionalidade em classificação do capital | Acrescentar preparação da prova/registo do aporte externo quando aplicável | Nenhuma mudança automática de taxa IVA ou conversão; transferências cambiais não calculadas | Falta dado estruturado de aporte e ligação à documentação; requisitos cambiais concretos não abrangidos |
+| Implementadora em constituição ou já registada | R9(1)(b), p.41; R14(1)(b), p.45; desde7/03/2024, recorte2026 | Mostrar a alternativa documental correspondente, sem exigir novo preenchimento da entidade | S05/S06: reserva de denominação ou certidão comercial, com estado declarado/associado por conferir | Não altera IVA | Falta associar categorias documentais existentes à alternativa e ao estado do cadastro |
+| Implantação em instalações arrendadas ou com DUAT | R9(1)(c)–(d), pp.41–42; R14(1)(c)–(d), p.46; recorte2026 | Reutilizar local; perguntar apenas a modalidade/evidência ainda ausente | S06 identifica esboço/planta e alternativa contrato/DUAT; sem converter ausência de título em ausência de direito | Não atribui taxa, custo fundiário ou benefício | Falta modalidade estruturada e associação ao documento; sem decidir titularidade/disponibilidade |
+| Pedido por representação comercial estrangeira, distinto de qualquer investidor estrangeiro | R9(2)–(3), p.42; recorte2026 | Pergunta de representação apenas quando a implantação declarada o permita; depois referência da licença e documento | S06 acrescenta licença de representação e identifica formalidades documentais pertinentes | Sem alteração da taxa geral | Falta modalidade e origem documental estruturadas; não exigir licença a todo investidor estrangeiro |
+| Nenhuma condição de autorização; ou dimensão/actividade/terra que a exija | L22(1)(b)–(2), pp.20–21; R13(2), R14 e R21, pp.45–50; recorte2026 | Reutilizar montante/moeda/actividade/área; perguntar apenas PPP/concessão, implicações ou dados ainda desconhecidos | Seleccionar preparação de mero registo ou autorização; na segunda, S02/S06 acrescentam estudo de viabilidade e capacidade financeira | Comparação do montante exige MZN ou equivalência documentada; não converter nem inventar taxa; IVA permanece componente separada | Falta ligar os predicados e evidências ao perfil. “Não sei” não equivale a “não”. Limite de32mil milhões MZN só resolve a condição de montante, não todas as restantes |
+| Localização geral versus ZEE/ZFI com referência e âmbito documentados | R13(1)(a)–(b), p.45; R10(4), p.43; recorte2026 | Reutilizar zona/versionamento; pedir reconhecimento/condições pertinentes em falta | Diferenciar entidade de encaminhamento e articulação aplicável; S08/S17 conservam evidências e pendências | Sem regra executável do benefício, mostrar resultado especial indeterminado e cenário geral separado | a76369eb já apresenta referência/limite; faltam ligações jurídicas de encaminhamento e condições. Parque industrial não equivale automaticamente a ZEE/ZFI |
+| Operação mensal interna geral, base líquida, MZN e período coberto pela versão publicada | Regra IVA já fundamentada/autorizada; Lei22/2022 art.17(1), fontes/limites no recibo existente; recorte fiscal2026 | Reutilizar vendas/mês/moeda; perguntar apenas pressupostos fiscais ainda ausentes | Ligar cálculo e relatório à mesma versão de contexto/regra | Consumidor existente calcula por versão servida; zero difere de falta; preço com IVA incluído não vira base líquida | Ligação mensal já demonstrada. Dedução, reembolso, saldo final e benefício especial continuam fora |
+| Mudança de título/contacto ou outra condição irrelevante para a regra aplicada | Decisão Tempo22/10 e contratos existentes; escolha técnica de dependências identificada | Preservar a edição e preencher o que continuar compatível | Não reiniciar revisões/etapas sem dependência relevante | Não criar outra execução nem mudar taxa/base | Prova de título e testes de dependências já aceites; estender por dependência, não por “qualquer alteração” |
+
+**Diferença útil que a implementação deste lote deve demonstrar, sem repetir A/B:** um caso C exclusivamente sintético, empresa em constituição, actividade económica não extractiva declarada, instalações arrendadas, capital emMZN, período2026. Primeiro completar as condições de enquadramento; depois a preparação de mero registo mostra a alternativa reserva de denominação/arrendamento. Alterar a condição de autorização para verdadeira troca o resultado procedimental, os campos necessários e os documentos para estudo/capacidade financeira. Com condição desconhecida, a selecção fica indeterminada e pede apenas essa informação. Alterar para representação comercial estrangeira acrescenta a licença pertinente; mudar apenas nacionalidade não produz esse efeito. Alterar de localização geral para ZEE/ZFI documentada altera o encaminhamento e as verificações, sem conceder benefício. O IVA geral continua matematicamente igual quando a mudança não afecta a sua regra; mudar vendas/base/moeda/período altera ou impede o cálculo conforme a cobertura existente. Não forçar um resultado numérico diferente quando a lei não o determina.
+
+**Cadastro e código separados:** o conteúdo jurídico acima está preparado, com artigos, exemplar e início temporal. Falta cadastrar as correspondências versionadas campo/condição/etapa/documento e ligar a sua execução ao perfil existente. Usar o mesmo dossier, prévia/confirmar, definições/questionários versionados e suporte condicional `when` já utilizado nos formulários; reutilizar resolvedor temporal, avaliação e aritmética exacta nas interfaces em que sejam compatíveis, com adaptador explícito para os predicados procedimentais, sem criar outro motor nem armazenar procedimentos como imposto. O contexto já tem sector/actividade/localização/moeda/período/entidade; as respostas de modalidade e evidências ainda não ligadas devem ser acrescentadas ao mesmo contexto cifrado, com origem e alterações deliberadas. Reutilizar vínculos documentais/históricos e permissões existentes. Não alterar a definição publicada dos19passos nem activar outra regra fiscal para executar este cadastro.
+
+**Estado desta entrega:** revisão de a76369eb concluída no âmbito aceite; **percurso seguinte fundamentado e delimitado, ainda não implementado/demonstrado de ponta a ponta**. A tabela não é prova de funcionalidade nem declara licenciamento sectorial completo. Não integrar este documento como se instalasse o percurso. Próxima execução técnica concreta: ligar as condições acima, persistir decisões/documentos e verificar apenas as transições de C, recuperação e relatório; conservar as provas aceites de contexto e IVA. Código, publicação de parâmetros/regras e activação continuam operações separadas. Não há nova autorização organizacional ou validação jurídica da Tempo presumida.
+
+
+### Percurso de investimento privado executável em QA — 22/10/2026
+
+Implementação do delta de `52fbb146`, na branch `codex/private-investment-path-executable-QA`. A integração independente de `a76369eb` não foi repetida nem condicionada por este lote. Não houve escrita na homologação, integração em main, publicação ou activação de regras fiscais.
+
+**Orientação permanente aplicada:** decisão expressa da Tempo de 22/10, registada também em AGENTS.md: legislação, modelos e procedimentos oficiais disponibilizados são a base aceite para implementar; decisões da Tempo orientam a implementação. Não existe nova aprovação jurídica genérica, aprovador adicional ou validação de credibilidade como condição para executar este percurso. Dados concretamente em falta são identificados por campo e não anulam os restantes requisitos. Associação documental não equivale a reconhecimento administrativo; esta distinção é informativa, sem bloquear a gravação ou a preparação.
+
+**Ligação executável:** `PrivateInvestmentPreparation` é o adaptador delimitado das condições procedimentais já documentadas para o contexto cifrado do dossier. Correspondência `private-investment-preparation-2026-v1`, exemplar APIEX/hash anteriormente registados, recorte de início previsto em 2026. Reutiliza campos conhecidos do mesmo projecto/rascunho, permissões, vínculos documentais, prévia assinada, controlo de concorrência, chave idempotente, eventos antes/depois e os 19 passos existentes. Não é outro motor fiscal, catálogo paralelo de benefícios ou novo processo de aprovação. O resolvedor fiscal publicado e a aritmética decimal existentes continuam responsáveis pelos seus cálculos; não se armazenaram predicados procedimentais como impostos.
+
+No dossier normal, «Preparar o pedido de investimento privado» abre o editor de contexto. Valores já declarados ficam recuperados e editáveis, sem nova confirmação por ecrã. Dados condicionais de área só aparecem para extensão de terra/concessão florestal. A prévia mostra ramo antes/depois, documentos novos/inactivos, passos afectados e resultados que precisam de revisão. Apenas a confirmação grava uma revisão; cancelamento conserva o estado anterior. Os requisitos correspondentes aparecem nas etapas S02/S05/S06 e o próximo passo acompanha mero registo/autorização. As dependências formais da definição publicada não foram substituídas por novos bloqueios.
+
+**Fundamento executado:** Lei 8/2023 artigos 2 e 22; Regulamento aprovado pelo Decreto 8/2024 artigos 5, 9, 13, 14 e 21, conforme a tabela de 52fbb146 acima. Na interface, R designa este Regulamento. As exigências têm razão, artigo, período e ligação ao exemplar oficial. As alternativas certidão/reserva e DUAT/arrendamento não são cumulativas. Representação estrangeira determina a licença correspondente; nacionalidade ou residência, isoladamente, não a determinam. Aporte externo tem origem declarada separadamente da nacionalidade. Montante >32 mil milhões MZN, terra >=10 mil ha e concessão florestal >100 mil ha usam comparação decimal exacta, sem conversão cambial presumida. R21 distingue Finanças/Conselho de Ministros conforme as condições efectivamente conhecidas; uma condição positiva suficiente não espera pelas restantes para identificar o pedido de autorização.
+
+| Comparação nova, exclusivamente QA | Campos e documentos | Próximo passo / efeito no cálculo | Prova |
+| --- | --- | --- | --- |
+| C: empresa em constituição, actividade geral, 1.000.000 MZN, 01/01/2026, modalidade doméstica, capital nacional, instalações arrendadas; condições de autorização negativas | Reserva de denominação, identificação, planta e arrendamento; não exige certidão, DUAT, licença de representação ou estudo/capacidade de autorização | Mero registo; encaminhamento Governador. Nenhuma taxa IVA alterada | UI → prévia → confirmar; contexto v1 |
+| C: associar suporte sintético já existente ao arrendamento | Mesmo documento associado por ID; não cria cópia nem o aprova | Conserva o pedido; contexto v2 | UI; um vínculo em desk_documents |
+| C: PPP/concessão empresarial passa a sim, modalidade passa a representação estrangeira e instalações a DUAT | Entram estudo/capacidade, licença de representação e DUAT; arrendamento deixa de ser exigido, conservando o documento anterior | Autorização, Conselho de Ministros; S02/S05/S06/S07 para revisão. Esta mudança meramente procedimental não invalida os inputs do IVA | Prévia visual antes de confirmar; contexto v3 recuperado; PNG C-authorization-preview |
+| C: recuperação e simulador | MZN, data, título, contexto v3 e preparação por autorização recuperados sem reintrodução; arrendamento inactivo visível no histórico | Mesmo âmbito fiscal geral; nenhuma execução fiscal nova pedida neste ensaio | Dossier normal, simulador e rascunho ligado; leitura persistida e relatório Word |
+| Regresso autorização → mero registo; entidade em constituição → existente | Estudo/capacidade/licença deixam de ser exigidos; arrendamento anterior volta associado; certidão substitui reserva, sem apagar histórico | Ramo e requisitos recalculados | Controlo HTTP transaccional dirigido, não repetição visual A/B |
+| ZEE/ZFI versus parque industrial | Encaminhamento APIEX condicionado ao enquadramento reconhecido; parque não é convertido em ZEE/ZFI | Nenhum benefício ou taxa especial concedidos | Predicados com referências sintéticas de QA; não prova de elegibilidade de uma zona real |
+
+**Provas novas:** três testes feature, 96 asserções, exclusivamente na base `simulator_fiscal_delta_20261021_test`, loopback 55441, com transacções revertidas e guarda do alvo. Cobrem limiares exactos, desconhecidos, exclusões/período, não inferência por nacionalidade, alternativas e preservação de vínculo, recuperação, idempotência, prévia sem escrita, adulteração, documento de outro dossier recusado e consumidor desligado, incluindo edição independente do título sem perder snapshot ou vínculos. Um teste frontend confere somente o novo conteúdo congelado do relatório. TypeScript e build passaram. Não foram repetidos cálculos decimais, exportadores completos, paginação PDF, CSV ou ensaios A/B aceites.
+
+**Recibo C da fase por autorização (histórico v3):** dossier `4133311b-5426-4cec-900d-1f1484484083`; contexto v3; rascunho `beba1dec-fc05-4820-b099-24952c5ab36c`, v4, SHA256 `4136e82a3b9420ab8f980ec0d7bda6dc2a67b568c18535b5ba0ecc80efd37e37`. Um documento sintético `e5ce142a-1178-46a2-b039-f187139c62cd`, sem pretensão de autenticidade oficial ou reconhecimento; mantém quarentena/scan pendente, sem contornar o carregamento/antimalware. A fixture apenas disponibiliza metadados privados para observar associação, não ensaia novamente uploads e não faz parte de dados/migrações de entrega. Três eventos de mudança do contexto; uma associação documental. C não contém projecção de vendas nem novo resultado fiscal; as provas anteriores dessa componente são reutilizadas.
+
+**Relatório efectivamente transferido:** `relatorio-investmoz-sintetico-qa-c-pedido-de-investimento-privado.docx`, 16.674 bytes, SHA256 `28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce`. Conferido o novo conteúdo: pedido de autorização, versão, fundamentos R14 e exigências não aplicáveis com histórico preservado. Não se repetiu a verificação de paginação/exportadores. Os anexos do dossier não são inseridos silenciosamente no pacote; mantém-se a selecção explícita existente. O relatório identifica a preparação/simulação e não alega submissão ou aceitação administrativa.
+
+**Limitação da ferramenta:** a observação do evento de download excedeu o tempo e a extensão perdeu a ligação. O ficheiro terminou e foi encontrado em Transferências antes de qualquer repetição; conteúdo/hash conferidos localmente. Não se repetiu a exportação nem se classificou o incidente como falha do simulador. A prévia de impacto e recuperação já tinham prova visual; a recepção do ficheiro é prova distinta.
+
+**Limites concretos:** este lote prepara o pedido de garantias/incentivos de investimento privado, não executa submissão administrativa, licenciamento completo por sector ou decisão de elegibilidade. Prospecção/pesquisa/produção extractiva, investimento público/exclusivamente social sem fins lucrativos e períodos fora de 2026 não são cobertos por este adaptador; processamento industrial tem o ramo de autorização documentado. A equivalência de montante noutra moeda não é determinada sem dados/fundamento cambial aplicáveis; condições positivas independentes continuam executáveis. O catálogo visual deste QA contém apenas parques sintéticos, não uma ZEE/ZFI real elegível: encaminhamento especial conferido no predicado, sem declarar prova visual de reconhecimento real. Benefícios territoriais, deduções, reembolsos e apuramento final do IVA continuam indisponíveis; o cálculo geral já autorizado conserva o seu âmbito.
+
+**Utilização e integração:** abrir `http://127.0.0.1:18580/investimentos/4133311b-5426-4cec-900d-1f1484484083` na conta QA habitual. Usar «Comparar e alterar contexto», editar apenas a condição relevante, comparar e confirmar; para documentos, usar o Balcão do mesmo dossier e associar os existentes. QA habilita `investor-path.private_preparation=true` no router privado. A configuração de entrega `PRIVATE_INVESTMENT_PREPARATION_ENABLED` fica desligada por defeito; a homologação não foi alterada. Integração eventual pelo processo Git existente: rever branch/código e limites, incorporar sobre main actualizado preservando alterações concorrentes, build e conferir apenas o delta no destino; habilitação deste percurso é uma configuração separada, não publicação/activação fiscal. Suspender a configuração oculta o novo consumidor e recusa novas escritas específicas, sem eliminar contexto, documentos, eventos, rascunhos ou relatórios congelados. Sem migração ou seed de fixtures no destino. Nenhuma nova ronda de preparação técnica foi identificada para este recorte; revisão/decisão de integração continuam separadas.
+
+
+**Distinção final conferida, sem nova validação genérica:** Lei 8/2023 artigo 14(b) distingue investimento directo/indirecto; R13 refere expressamente investimento directo nos limiares monetários. Acrescentado o dado «Tipo deste investimento», separado da origem/nacionalidade. Sem esse dado, a via dependente da dimensão permanece indeterminada; para forma indirecta este lote não determina dimensão/encaminhamento monetário, mas continua a avaliar as condições independentes documentadas. PPP/concessão positiva continua a determinar autorização e Conselho de Ministros, sem esperar por esse campo irrelevante à decisão já suficiente. A interface foi conferida: retirar a condição PPP pede exactamente o tipo em falta; declarar directo resolve mero registo e retira estudo/capacidade financeira. Comparação antes de confirmar em `C-final-directness-preview.png` e percurso recuperado em `C-final-path.png`.
+
+Estado final C: dossier v8, contexto **v4**, investimento directo declarado, PPP não, pedido de **mero registo**; quatro eventos de contexto e um documento/vínculo conservados. A modalidade estrangeira/DUAT conservou a edição deliberada. O rascunho v4 e o Word já transferido mantêm o contexto **v3 por autorização**, com hash acima: são prova histórica congelada e não o relatório da revisão v4. Não houve reescrita silenciosa nem reexportação. Ao abrir o simulador, o mecanismo comum de continuidade disponibiliza a revisão actual para o próximo rascunho/relatório; as provas anteriores deste mecanismo continuam reutilizadas.
+
+
+### Correspondência do novo relatório com o contexto v4 e dependências Git — 22/10/2026
+
+Verificação dirigida solicitada pela Tempo após a avaliação do resumo de `a1fbda06`; nenhuma alteração funcional necessária. A prova anterior só demonstrava o Word congelado v3. Nesta continuação abriu-se o simulador pelo link normal do mesmo dossier C (incluindo o rascunho ligado), recuperou-se automaticamente o contexto v4 e gerou-se **uma** saída Word nova. Não se repetiram cálculos, CSV, paginação, anexos ou ensaios A/B aceites; não houve nova validação jurídica, integração ou alteração fiscal.
+
+| Elemento | Word histórico v3 | Novo Word do contexto v4 |
+| --- | --- | --- |
+| Identificação dentro do documento | «Revisão 3» e «Contexto congelado v3» | «Revisão 4» e «Contexto congelado v4» |
+| Pedido | Autorização | Mero registo |
+| Estudo de viabilidade | Documento por associar | Não aplicável; histórico preservado |
+| Capacidade financeira | Documento por associar | Não aplicável; histórico preservado |
+| Bytes / SHA256 | 16.674 / `28cfe4b75116c892d3e29fde389de7d067b456761756bab732af625178ee69ce` | 16.678 / `a2849427f4a91fa6ab78e433be8b919baca80a0f4f452a4546a5b169b921d753` |
+| Cópia identificada para revisão | `outputs/private-path-executable-20261022/C-report-HISTORICO-contexto-v3.docx` | `outputs/private-path-executable-20261022/C-report-contexto-v4.docx` |
+
+O original v3 conserva exactamente os bytes/hash anteriores; a cópia está explicitamente designada **HISTÓRICO**. A revisão congelada no próprio Word identifica o contexto a que pertence, sem o transformar no estado actual. O novo ficheiro foi encontrado em Transferências após o clique de exportação e conferido por leitura das células efectivamente geradas; recibo em `C-report-v3-v4-comparison.json`. O rascunho passou a v5, SHA256 `ba824fe0362ca87b301da55298122796f44fdfb11507830b3fe8f54cf88d132d`, com contexto v4 e preparação por mero registo; dossier v8/contexto v4 e um documento mantidos. Prova visual de recuperação em `C-new-report-context-v4.png`. Não se altera a validade histórica da prova v3.
+
+**Dependências para integração após a avaliação da Tempo:** ancestralidade confirmada `57fc9148 → a76369eb → 52fbb146 → a1fbda06`. `a76369eb` fornece a continuidade comum do contexto/edições e é dependência funcional de `a1fbda06`; pode ser integrado independentemente. `52fbb146` é a preparação documental intermédia, sem código executável. A branch `codex/private-investment-path-executable-QA` inclui essa ancestralidade e a presente prova documental; não aplicar apenas o diff de `a1fbda06` num destino sem a continuidade ou alteração equivalente. Se a76369eb já tiver sido integrado, o merge normal reconhece a ancestralidade e não o reaplica como um segundo desenvolvimento.
+
+Procedimento: após a decisão, recuperar o main actual, rever a comparação e fazer integração Git que preserve as alterações concorrentes; resolver apenas conflitos efectivos, sem reset/force-push de main. A leitura desta continuação encontrou main em `57fc914821d0cefa02caa80a74b3d42e663f2742`; é fotografia do estado, não autorização para ignorar commits posteriores. Conferir a revisão servida e só o delta no destino. A habilitação `PRIVATE_INVESTMENT_PREPARATION_ENABLED` é configuração distinta; não publica nem activa regras fiscais. Nesta execução a branch permanece separada, sem integração/habilitação na homologação. Limitações sectoriais/fiscais explícitas mantêm âmbito próprio e não bloqueiam este recorte concluído.
+
+
+### Integração autorizada do percurso adaptativo — 22/10/2026
+
+A Tempo autorizou a implementação após o fecho do recorte. Main remoto foi actualizado por avanço directo de `57fc9148` para `064296e1`, preservando a sequência `a76369eb → 52fbb146 → a1fbda06 → 064296e1`; não havia alteração concorrente ou conflito no momento do envio. A cadeia automática recusou a primeira tentativa no teste frontend «server draft snapshots split private identity from economic values»: 188/189 passaram. A versão servida anterior `57fc9148` foi conservada, conforme o mecanismo de recuperação; não se contornou a verificação.
+
+Causa concreta: o adaptador de continuidade acrescentava `compatible_fields_snapshot` vazio na recuperação de um rascunho legado sem nenhuma origem compatível. Correcção delimitada na branch `codex/adaptive-delivery-compatibility-QA`: devolver o rascunho original quando não há origem compatível nem metadados de herança anteriores. A herança com origem/metadados continua executada, preservando edições e limites por dossier. Nove controlos dirigidos da herança e o teste exacto da partição/recuperação passaram; não se reabriram os cálculos, relatórios ou cenários aceites. A correcção deve seguir o mesmo processo automático; não altera regras fiscais, esquema ou dados activos. Recibos da tentativa e da disponibilização final em `outputs/investmoz-adaptive-path-delivery-20261022`.
+
+
+### Percurso adaptativo disponibilizado na homologação — 22/10/2026, 10:17 Maputo
+
+Autorização expressa da Tempo executada. Main passou de `57fc9148` por avanço directo para `064296e1`, conservando a ancestralidade `a76369eb → 52fbb146 → a1fbda06 → 064296e1`. O remoto não tinha alterações concorrentes adicionais no momento da integração; não houve conflito, reset ou envio forçado. A primeira verificação automática recusou o novo metadado vazio na recuperação legada e conservou a release anterior; a causa e a correcção dirigida constam da secção anterior. A correcção `042ffbde44cac27704d6f8b7ec25b525a42e3575` foi ensaiada em branch e integrada por avanço directo, sem suprimir o teste que detectou a incompatibilidade.
+
+**Revisão efectivamente servida:** `042ffbde44cac27704d6f8b7ec25b525a42e3575`, branch main, build de 22/10/2026 às 10:16:14 Maputo; instalação automática concluída às 10:16:16. Manifesto SHA256 `655eef6e6a5e71c5138c68465a5b2ffc36d2cadeff96e6b35682dbfd19d42e79`. Conferida em `https://teste-investidor.tempo.co.mz/build/revision.json` e no recibo protegido da cadeia. A cadeia correu as verificações próprias; manualmente só foram repetidos os dez controlos afectados pela incompatibilidade. Zero migrations e zero importações no destino, sem copiar fixtures QA.
+
+**Funcionalidade utilizável:** `https://teste-investidor.tempo.co.mz/investimentos` (login normal); abrir ou criar o dossier legítimo do investimento e usar «Preparar o pedido de investimento privado» / «Comparar e alterar contexto». Estão disponíveis as perguntas condicionais, fundamentos, comparação antes de confirmação, requisitos/documentos e próximos passos do lote `private-investment-preparation-2026-v1`, com os limites de 2026 já documentados. A conferência do destino limitou-se à revisão, configuração efectiva e entradas: investimentos redirecciona ao login (302), simulador responde 200. Não se criaram dossiers/contas reais ou sintéticas no destino nem se repetiram os cenários funcionais QA aceites.
+
+**Habilitação concreta, distinta de fiscalidade:** a configuração do percurso `PRIVATE_INVESTMENT_PREPARATION_ENABLED` estava ausente/false; passou a true mediante a sessão SSH habitual autenticada pelo utilizador. Antes da escrita foram conferidos revisão servida e hash da configuração; cópia protegida dos bytes anteriores verificada, alteração limitada a essa chave, proprietário e modo0640 preservados, cache de configuração reconstruída e workers notificados de reinício gracioso. Hash .env anterior `7cdaba591bb5787485a349c24db2fd7c8279436da0eb31502e44db2fffa21d03`; posterior `a6b4e9064cf6dbb2d945b53418a6c9252f9c736ff3fde4016b95b74885a9ee0f`. A leitura posterior confirmou `investor-path.enabled=true` e `private_preparation=true`. A cópia de recuperação permanece privada em `/var/lib/investmoz-deploy/backups/private-preparation-20261022/`; não contém uma publicação de parâmetros e não segue para Git.
+
+**Estado fiscal preservado:** nenhuma publicação/activação de nova regra e nenhuma operação na base activa. O consumidor IVA geral previamente autorizado manteve a mesma disponibilidade, cobertura2026 e mensagem antes/depois. As exclusões sectoriais, forma indirecta/dimensão monetária não determinada, benefícios territoriais e apuramento fiscal completo continuam explícitos e não bloqueiam o lote procedimental concluído.
+
+**Suspensão/recuperação:** desligar somente a chave do novo percurso e reconstruir cache/reiniciar graciosamente os workers mantém dossiers, documentos, respostas, versões, relatórios e históricos. Para reverter configuração, usar o valor anterior apenas depois de conferir o hash actual e preservar alterações posteriores; não substituir todo o .env sem conferir concorrência. A reversão de código/build segue o procedimento de releases já existente, sem restaurar dados antigos. A release anterior foi efectivamente conservada na primeira tentativa recusada. Recibo completo local em `outputs/investmoz-adaptive-path-delivery-20261022/delivery-receipt.json`; a presente actualização documental fica na branch de registo, sem novo push main ou nova disponibilização desnecessária.
+
+
+## Revis?o das 30 fichas de Inhambane e cat?logo vazio ? 22/10/2026
+
+Leitura remota autenticada, transac??o READ ONLY, base teste_investidor: 30 oportunidades em draft; zero publicadas em toda a base. As consultas independentes de Cabo Delgado e Inhambane e a consulta exacta Inhambane/Vilankulo devolveram zero sem falha de consulta. A alega??o de oportunidades publicadas de Cabo Delgado n?o se confirma neste destino; n?o inventar associa??es para preencher a lista.
+
+As 30 localiza??es permanecem nos recursos privados opportunity_location_drafts, referidos no cadastro can?nico; os campos e v?nculos p?blicos ainda n?o s?o a projec??o dessas fichas. A inexist?ncia desses v?nculos p?blicos em rascunhos n?o prova perda da localiza??o. Na publica??o, projectar somente a abrang?ncia documentada e conferir a pesquisa territorial.
+
+Decis?o Tempo nesta conversa: incompletude e autoriza??es necess?rias ? execu??o n?o s?o impedimentos autom?ticos ? divulga??o como oportunidade em prepara??o. Proposta: divulgar resumos das 30 fichas em prepara??o com fonte, edi??o, data-base e lacunas vis?veis; n?o declarar financiamento, terreno, licen?as, promotor autorizado ou execu??o confirmados. Valores hist?ricos, agregados e divergentes devem ser identificados sem somas indevidas. Nenhum impedimento concreto de divulga??o do resumo foi demonstrado nesta leitura. Isto n?o declara o conte?do privado integral public?vel: originais, contactos e evid?ncias continuam separados. N?o houve publica??o, altera??o de pap?is ou escrita remota.
+
+Prepara??o por ficha: outputs/investmoz-territory-recovery-20261022/publication-review.json (30 identidades reais, localiza??o privada, lacunas e valores). Evid?ncia: read-catalogue-remote.py e remote-read.log no mesmo direct?rio. A tabela hist?rica de lacunas de prepara??o ? reutilizada, sem a converter em bloqueios legais. A prepara??o t?cnica do fluxo de publica??o ainda deve reconciliar essas condi??es com o contrato existente; n?o marcar publica??o como pronta ou executada.
+
+O URL recebido ? do cat?logo/iniciar por territ?rio, n?o do dossier afectado. N?o permite ler o contexto inicial, a altera??o e a ?ltima ac??o desse processo. A falha da pr?via territorial e do t?rmino sem resposta continua aberta e ainda n?o foi reproduzida no dossier real; n?o encerrar pela disponibiliza??o anterior ou por esta leitura de cat?logo.
+<!-- search-territory-recovery-20261022 -->
+## Continuidade territorial da pesquisa — correcção em QA, 22/10/2026
+
+Esclarecimento da Tempo: o percurso reportado foi navegação pública entre carteira e catálogo, sem clicar em iniciar/continuar ideia. Não existe evidência de alteração de um dossier pessoal neste caso. Retira-se a exigência de URL do dossier e de confirmação de impacto; a alteração é de filtros de pesquisa.
+
+Causa verificada: ligações da carteira para oportunidades e zonas e ligações dos menus públicos usavam destinos sem província/distrito. O contexto transportado para detalhes por `catalogue_query` também não acompanhava as ligações cruzadas. No ecrã de zonas, os parâmetros de exportação/detalhe omitiam a hierarquia territorial.
+
+Correcção: `searchTerritoryHref` transporta exclusivamente os quatro níveis territoriais na URL entre carteira, oportunidades, zonas e educação, incluindo os respectivos detalhes. Reutiliza o `catalogue_query` existente e preserva os filtros próprios do destino. Uma selecção explícita de outro ascendente não herda descendentes incompatíveis. Sem armazenamento global, mistura de contas ou alteração de dossiers. Menus, navegação relacionada, breadcrumbs e ligações cruzadas usam a mesma função. O selector partilhado mantém a limpeza dos descendentes; não há confirmação adicional para pesquisar.
+
+Verificação dirigida: seis testes Node (incluindo o selector partilhado), TypeScript e build isolado. No navegador QA: carteira Cabo Delgado → selecção Inhambane/Vilankulo → pesquisar → catálogo com ambos os campos preenchidos; recarregamento e regresso preservam a selecção; zonas herdam os dois níveis; mudar para Cabo Delgado limpa Vilankulo. Contagem zero, filtros activos e mensagem de ausência coerentes na base QA consultada. Não foram repetidos cálculos ou exportadores fiscais nem publicados registos para produzir resultados artificiais.
+
+Provas: `outputs/investmoz-territory-recovery-20261022/before-carteira.png` e `after-catalogue.png` no workspace de entrega; testes em `tests/frontend/search-territory.test.mjs` e `territory-path.test.mjs`; logs QA `outputs/territory-types.log` e `territory-build.log`. O router privado QA selecciona o build isolado; não integra a candidata.
+
+Entrega limitada a branch/QA. A homologação não foi alterada por esta correcção. Publicação das 30 fichas de Inhambane permanece separada: revisão por ficha preparada, nenhuma publicação executada; ainda por reconciliar a preparação técnica da divulgação em preparação com o fluxo existente. A correcção da pesquisa não depende dessa publicação.
+## Inhambane — divulgação dos 30 resumos executada, 22/10/2026
+
+Decisão expressa da Tempo na conversa: «publicar» os 30 resumos como oportunidades em preparação; responsável confirmado `nala@tempo.co.mz`. A conta concluiu autenticação normal com MFA. A primeira ligação abriu indevidamente `/management/opportunities`, que exige administração geral; `/minhas-oportunidades` estava acessível e foi confirmado no navegador. A ligação SSH estava pronta; não foi necessário pedir outra autenticação.
+
+Executada uma operação privada de dados, limitada às 30 identidades e aos hashes das versões autorizadas, sob a decisão de divulgação da Tempo e a sessão real de Nala. Não se atribuiu papel geral de Publicador, administração, revisões técnicas, aprovação jurídica ou autorização de execução. O fluxo genérico de aprovação de projectos completos permaneceu intacto. A publicação promocional tem finalidade própria registada em `workflow_context.publication.purpose=promotional_preparation`; não equivale à conclusão desse fluxo. Cada operação registou responsável, conteúdo anterior, hash do lote e finalidade no histórico restrito.
+
+O executor preserva o cadastro canónico privado, proprietário e organização, originais e contactos. A projecção pública contém título, resumo, limitações, fonte/edição e indicação «Em preparação». Montantes não confirmados não são apresentados como investimento disponível; os dados técnicos/financeiros históricos são assinalados como tal. A conferência editorial retirou instruções internas dos resumos, usando as limitações da tabela aprovada na conversa.
+
+Detectado e resolvido o vínculo territorial em falta: as localizações privadas mencionavam Vilankulos, mas só tinham província estruturada. O cadastro público confirma MUNICÍPIO DE VILANKULO → posto VILANKULO → distrito VILANKULO → Inhambane. Foram associados ao distrito apenas 15 registos cuja localização documental menciona expressamente Vilankulos, incluindo programas de abrangência múltipla. Não se inferiu implantação, coordenadas ou relação por proximidade. As restantes fichas conservam a abrangência documentada; não foram associadas indiscriminadamente ao distrito.
+
+Verificação pública sem sessão da aplicação: **30 resultados em Inhambane, 15 em Vilankulo**, todos com indicação «Em preparação», limitações e sem `management_draft`/`workflow_context` na resposta pública. No navegador foram conferidos catálogo, contagem e a ficha do Hotel Boutique no Terreno INATUR, incluindo a ausência de confirmação da disponibilidade do terreno/concessão. Foram reutilizadas as provas anteriores; o ensaio novo em base QA isolada conferiu publicação, alteração editorial, repetição sem duplicados, preservação do cadastro privado, recusa de alteração concorrente e associação exacta das 15 referências. Todos os dados sintéticos foram revertidos por rollback em QA; nenhum actor QA foi transportado.
+
+Backup fresco em formato PostgreSQL custom antes de cada revisão de dados, protegido fora da raiz pública; catálogo de restauro verificado e provas anteriores de restauro reutilizadas. A leitura final confirmou as mesmas 30 identidades, cadastro privado/proprietários preservados, zero novos papéis Publicador e administração geral de Nala mantida desligada. A reversão deve partir do backup e do `before_data` restrito, comparar a versão actual e restaurar apenas as projecções/vínculos afectados, preservando edições posteriores; não restaurar toda a base sobre alterações concorrentes. Uma suspensão deve retirar os resumos do público, mantendo cadastro, relações e histórico, como operação expressamente registada; não apagar as fichas.
+
+Recibos no workspace de entrega: `outputs/investmoz-territory-recovery-20261022/public-verification.json`, `integrity-receipt.log`, `publication-final-result.log`, `published-vilankulo-results.png`; executores privados e manifestos no mesmo directório, arquivados fora da raiz pública no destino. Hash final do lote: `d0a1146a7113aabafc3c2d08c0bdc17d12fc8a51606ba9ff7e79b154556d6e08`.
+
+Revisão efectivamente servida: `042ffbde44cac27704d6f8b7ec25b525a42e3575`. Nenhuma instalação Git, migration ou activação fiscal foi executada nesta publicação. A candidata `9ac623a4` de continuidade dos filtros permanece separada de `main` e pronta para revisão de integração. A divulgação das 30 fichas deixa de estar pendente; os estudos, financiamento e autorizações de execução continuam como limitações explícitas das oportunidades.
+## Integração territorial e contacto comercial — 22/10/2026
+
+Tempo autorizou integrar `9ac623a4` e pediu conferir a revisão servida. `57fc9148` é antepassado de `042ffbde`, e não uma revisão posterior: os hashes não têm ordem cronológica. A conferência remota comparou 685 ficheiros de aplicação/configuração com `042ffbde`, sem diferenças; o manifesto de build também coincide com o identificador publicado. O histórico de instalação confirma a passagem de `57fc9148` para `042ffbde`. Não se identificou reposição de código/build ou desaparecimento da entrega do simulador.
+
+Integração Git por avanço directo até `1ec31856`, incluindo `9ac623a4` e recibos documentais. A primeira tentativa automática preservou a revisão anterior por falha Node: importação sem extensão em `catalogue-context.ts`. Corrigida a referência explícita `.ts`; passaram os dez testes dirigidos do módulo afectado e da continuidade territorial. Não se repetiram os percursos aceites nem a publicação de oportunidades.
+
+Decisão expressa da Tempo: o rodapé deve apresentar **comercial@tempo.co.mz**, porque o contacto comercial com a instituição é feito por esse endereço. Actualizado o valor por omissão de `portal.institutional_contact_email`. Na homologação existia uma sobreposição explícita `PORTAL_INSTITUTIONAL_CONTACT_EMAIL=info@tempo.co.mz`: alterada exclusivamente essa chave para `comercial@tempo.co.mz`, com backup privado íntegro, propriedade/permissões preservadas e reconstrução da cache de configuração. A apresentação e o `mailto:` utilizam a mesma configuração existente; não houve envio de email.
+
+Recibos de destino e integração: `outputs/investmoz-territory-recovery-20261022/revision-before-integration.log`, `footer-email-receipt.log` e recibo final de instalação no mesmo directório do workspace de entrega. A confirmação final deve identificar a revisão efectivamente instalada pelo processo automático, mantendo os 30 resumos e as regras fiscais existentes.
+## Selectores especializados do catálogo — QA, 22/10/2026
+
+Pedido da Tempo: explorar estruturas públicas independentemente da existência de oportunidades, sem inventar associações nem divulgar registos privados. A homologação em `7b1c3579` já devolve e apresenta **Parque Industrial de Balama** e **Parque Industrial de Montepuez** no selector de Cabo Delgado; “Todos” é o valor inicial, não uma prova de ausência das opções. A API devolve duas zonas nessa província e oito no âmbito nacional. A base QA local tem outro conjunto de dados: não continha parques públicos ligados a essa província. Esta diferença de dados não é uma regressão demonstrada do selector da homologação.
+
+Falhas verificadas no código: actividades e cadeias eram reduzidas às oportunidades publicadas encontradas no território/sector; estruturas públicas podiam depender da existência adicional de uma ficha publicada da carteira; os selectores vazios só apresentavam “Todos”; a consulta da ficha de um parque sem oportunidades não era apresentada no resultado vazio da grelha.
+
+Correcção na branch `codex/catalogue-specialised-selectors-QA`: opções provenientes dos cadastros públicos existentes, preservando os critérios de consulta e os vínculos territoriais. Estruturas com território principal documentado não dependem de uma oportunidade nem de uma ficha adicional da carteira. Mantêm-se os vínculos territoriais já resolvidos pelas fichas publicadas. Cadeias acompanham os clusters públicos do âmbito seleccionado. Actividades são o catálogo público de classificação, explicitamente separado da disponibilidade local de investimentos; não se inventa uma associação territorial ou sectorial. Os oito selectores apresentam contagem ou explicação de ausência. Uma selecção indisponível permanece identificada, com possibilidade de remoção, em vez de parecer “Todos”.
+
+Quando a estrutura seleccionada não tem correspondências, o resultado informa “Sem oportunidades publicadas associadas com estes filtros” e mantém ligação à ficha pública existente, em qualquer vista. Um registo mestre sem ficha pública detalhada é identificado como tal; não se cria uma ficha ou publicação automaticamente. A pesquisa continua a combinar todos os filtros, sem alargamento automático ou atribuição de benefícios. A alteração territorial mantém a limpeza dos níveis e selecções incompatíveis já implementada.
+
+Provas novas, sem repetir os percursos anteriormente aceites: Cabo Delgado com dois parques sintéticos identificados; selecção de Balama, zero oportunidades, abertura da ficha, regresso e recarregamento com selecção conservada; limpeza; Nampula com parque sintético Topuito; ausência de restrição territorial com ambos os conjuntos disponíveis e selecção anterior limpa. Fixtures limitadas à base `simulator_fiscal_delta_20261021_test`, porta 55441, excluídas do Git e da disponibilização. Testes `CatalogueSelectorReferencesTest`: três testes, 27 verificações, transacções revertidas, incluindo exclusão de privados/outro território, catálogo de actividades independente dos resultados, estruturas/cadeia sem oportunidades ou fichas adicionais. `npm run types:check` e build QA passaram. Provas locais: `outputs/catalogue-selectors-20261022/audit.json`, `qa-balama.png`, `qa-nampula.png`, `qa-national.png` e logs de build/tipos no mesmo directório.
+
+Diagnóstico separado do mapa: API pública de Cabo Delgado devolve território cadastrado, zero limites e nenhuma geometria acessível. Leitura SSH em transacção **READ ONLY** confirmou zero linhas em `geo_geometries` para essa província; neste caso não é uma camada existente ocultada pelo perfil. Não foram criadas coordenadas, geometrias, vínculos ou permissões. Este diagnóstico não equivale à implementação dos limites administrativos.
+
+Integração pendente da revisão prevista: comparar com `origin/main`, preservar alterações concorrentes e integrar pelo processo Git automático existente. Não há migrations, publicação de oportunidades, activação fiscal ou transporte das fixtures. Conferir apenas o delta e a revisão servida depois de autorizada a integração; não repetir as provas já aceites.
+### Revisão dirigida da interacção do selector — 22/10/2026
+
+Na candidata `1d921c9d`, ensaio pelo navegador Edge em QA, sem usar `selectOption` como prova desta interacção: clique no campo/seta deu foco; teclado `Alt+Down`, seta para cima e Enter mudou a selecção de Montepuez para Balama, actualizando o filtro e a ligação à ficha. Prova local `outputs/catalogue-selectors-20261022/qa-keyboard-balama.png`. Dados sintéticos explicitamente identificados como QA.
+
+A ferramenta não observou o menu nativo aberto pelo rato; a tentativa de clicar na opção nativa devolveu opção não visível. Assim, a escolha completa **apenas pelo rato permanece não demonstrada** nesta revisão. Trata-se de limitação de observação/interacção da ferramenta, sem evidência suficiente para atribuir falha ao portal. A presença das opções na API/DOM e o uso anterior de `selectOption` não encerram esse ponto. Sem alteração funcional, repetição dos restantes testes ou integração em `main`; geometrias continuam como pendência distinta.
+### Decisão de integração — 22/10/2026
+
+A Tempo encerrou a revisão de `1d921c9d` com as provas existentes e autorizou integrar a candidata e o registo documental `916819eb`. A interacção exclusivamente pelo rato permanece não observada pela ferramenta, **sem carácter bloqueante**; não constitui falha comprovada do portal, não exige substituir o selector nem repetir ensaios. A ausência de geometrias administrativas de Cabo Delgado permanece independente. Executar o processo Git automático existente, preservando alterações concorrentes; não transportar fixtures QA, publicar dados ou activar regras fiscais.
+
+## Entrada única de gestão — preparação em QA, 22/10/2026
+
+Origem: prioridade expressa da Tempo para a equipa cadastrar oportunidades e carregar, editar e publicar documentos e legislação pela interface, sem depender do Codex. A decisão de 22/10 sobre fontes e execução mantém-se. Geometrias administrativas ficam no saldo separado.
+
+Implementada `/gestao-conteudos`, acessível pelo painel, menu lateral, Balcão e editores. Reutiliza os cadastros, biblioteca, armazenamento, perfis e histórico existentes. Nova oportunidade abre o editor operacional para quem tem contexto de criação; acesso legado é identificado como tal, sem o apresentar como publicação operacional completa. A entrada não atribui papéis. Escolhas técnicas deste delta: navegação agregada, contagens no âmbito do utilizador, pesquisa documental e pré-selecção do ficheiro acabado de carregar. Não são novas regras organizacionais.
+
+Percurso diário: **Gestão de conteúdos e oportunidades → Nova oportunidade**, escolher promotor/modalidade, preencher e guardar; recuperar em **Gerir oportunidades e histórico**. Para documentos: **Novo documento** ou **Nova legislação → Receber documento em privado → Guardar em quarentena → Registar documento na biblioteca**. O original recém-carregado fica seleccionado; título e emitente conhecidos são recuperados. Completar os metadados, guardar, pesquisar o registo e usar **Editar metadados**, **Publicar** ou **Retirar da publicação**. Associações apresentam nomes dos registos existentes. Campos ainda não conhecidos não são inventados. Publicação para consulta não activa cálculos.
+
+Verificação nova: quatro testes, 99 asserções, com transacções revertidas exclusivamente em `simulator_fiscal_delta_20261021_test`, loopback 55441, guarda explícita. Demonstrados acesso de equipa sem administração geral, recusa a utilizador sem autorização e ciclo documental completo (upload, ClamAV real, recuperação por pesquisa, edição, publicação/download, retirada, preservação do hash e quatro revisões). Exemplo documental exclusivamente sintético, sem origem oficial ou valor jurídico. Corrigida a classificação de retirados: o histórico existente usa `unpublished`; o filtro e o rótulo reconhecem também `withdrawn` histórico. TypeScript e build QA passaram.
+
+No navegador, login e MFA normais da conta sintética de equipa; entrada → legislação; entrada → nova oportunidade → guardar preparação incompleta → recarregar, com título recuperado e ficha QA 241. Não foi repetido o workflow integral de revisão/publicação de oportunidades já existente; a prova nova cobre a entrada e a gravação/recuperação. O ensaio documental completo foi HTTP transaccional, não uma prova visual de cada clique. A conta QA tem autorizações explicitamente sintéticas; não comprova as designações das contas reais. Não transportar fixtures, configurações QA ou concessões de acesso.
+
+Provas locais: `outputs/content-management-20261022/entrada-final.png`, `build-final.log`, e `tests/Feature/ContentManagementEntryTest.php`. Estado: candidata em branch `codex/content-management-entry-QA`, ainda sem integração ou instalação na homologação. Não declarar encerrada a autonomia operacional de todas as contas/categorias apenas por esta entrada. Não houve migration, publicação remota, alteração de papéis activos ou activação fiscal.
+## Entrada única — integração e conferência real, 22/10/2026
+
+A pedido expresso da Tempo, revista e integrada por avanço directo a candidata 97d51db6, seguida de aa2b3d05 (ligação da antiga página de acesso para a entrada autorizada) e 8286d750 (restituição do acesso editorial nominal). Push em main e instalação pelo processo Git automático existente; revisão efectivamente servida 8286d7504d9d368de81b4e8d095398764278bb95, build 22/10/2026 19:04:38 UTC. Nenhuma migration, publicação de conteúdo ou alteração de atribuições activas nesta entrega.
+
+A leitura da sessão real de Osmane Nala após login/MFA confirmou a dupla 15/16, Promotor e Validador activos da conta 15, uma atribuição anterior revogada preservada e nenhuma atribuição Publicador na lista actual. Criação abre as seis categorias atribuídas e os promotores reais; a lista recupera os 30 resumos já publicados e a fila Validação e pareceres abre sem casos. Isto não afirma revisão de um caso inexistente nem publica para ensaio. Atribuições futuras de Aurora/Palmira/Mario conservam a decisão da Tempo e não são pré-condição dos acessos de Nala/onala. Não foi repetido login da outra titular; reutiliza-se a prova nominal anterior e a mesma regra editorial delimitada.
+
+Falha concreta encontrada no destino: `portal.homologation_only=false` fazia `DocumentManagementAccess::editorial` recusar a designação já aprovada. A reserva do host era escolha técnica, não condição organizacional da edição. 8286d750 remove apenas essa dependência; preserva lista nominal Nala/onala, dupla existente, MFA recente, exclusão de Auditor e âmbito documental. Um teste novo, 24 asserções, exclusivamente em QA isolada com rollback, demonstrou independência da reserva e recusa sem designação/MFA. Não foram repetidos os quatro testes/99 asserções anteriores. TypeScript foi conferido para o delta da antiga página de acesso; build/testes obrigatórios pertencem ao processo automático.
+
+Na mesma sessão real, após instalação, a entrada passou a mostrar Novo documento e Nova legislação e 29 publicados/2 não publicados. A biblioteca abriu com Receber documento em privado, Guardar em quarentena, Registar documento na biblioteca, pesquisa, Editar metadados, Publicar/Retirar e históricos. ClamAV real 1.4.3 disponível, 32 ficheiros limpos no âmbito. Nenhum conteúdo foi alterado ou publicado para repetir prova já aceite em QA.
+
+**Dependências que permanecem explícitas:** (1) o fluxo normal de oportunidades tem interface, mas a lista actual não tem Publicador activo; falta a disponibilidade da conta/função já designada, não um comando do Codex. Nala não recebe outro papel por inferência. (2) A divulgação promocional de resumos em preparação, usada no lote Inhambane, foi operação por executor privado; ainda não existe acção genérica equivalente na interface. A candidata não encerra essa autonomia específica, nem as variantes de submissão que o editor já identifica como não implementadas. (3) manutenção de indisponibilidade persistente do scanner/worker continua técnica; as operações documentais normais não exigem comandos. Geometrias administrativas permanecem em saldo separado.
+
+Link único e guia curto encontram-se no início deste manual: https://teste-investidor.tempo.co.mz/gestao-conteudos. Recibo e imagem da conferência: outputs/content-management-delivery-20261022/. Registo documental mantido na branch QA, sem novo push main/desencadeamento de instalação apenas para o recibo.
+## Divulgação promocional pela equipa — implementação QA, 22/10/2026
+
+Origem: instrução expressa da Tempo nesta conversa para eliminar a dependência do executor privado na divulgação corrente de resumos em preparação. A autorização promocional é distinta de aprovação interna/publicação de uma oportunidade completa e de autorização externa de execução. Não se criaram papéis nem aprovadores. Reutiliza-se o Promotor **interno**, no âmbito operacional e cadastro que lhe foram atribuídos, e o Publicador no seu âmbito existente. O Promotor externo não ganha publicação por esta alteração. Auditor, âmbito alheio, MFA ausente/expirado e publicação normal já disponibilizada continuam a ser recusados pelas regras existentes. Esta passagem limita-se a QA; nenhuma atribuição ou conteúdo activo foi alterado.
+
+A lista e a ficha da oportunidade oferecem **Divulgação promocional**. O editor recupera o último resumo deliberadamente divulgado; não copia automaticamente texto, contactos ou documentos privados. A prévia apresenta título, resumo, descrição com aviso, fonte/edição/data-base e abrangência escolhida. Ausências são explicitadas, não preenchidas por presunção; a incompletude do projecto não exige a submissão completa para divulgar o resumo. Confirmar vincula o utilizador, operação, conteúdo exacto e versão da ficha à prévia cifrada, válida 15 minutos. Prazo, chave idempotente, serialização e comparação de versão são escolhas técnicas de integridade, não novas aprovações organizacionais. Cancelar não escreve. Alteração concorrente ou referência territorial modificada exige outra prévia, sem substituir o cadastro.
+
+Os mesmos registos de oportunidade, contexto privado e auditoria são reutilizados. O rascunho original mantém os bytes; as colunas privadas anteriores à projecção pública ficam preservadas no contexto oculto e no histórico restrito. A projecção não transporta anexos, contactos, montantes privados, validação documental ou perfis privados. A consulta pública promocional recupera apenas a abrangência explicitamente divulgada; não publica automaticamente evidências ou relações do dossier. Retirar deixa o resumo indisponível em público, preservando a ficha, documentos, relações privadas e histórico. Não equivale a arquivar ou rejeitar o investimento.
+
+Ensaios novos em base isolada `simulator_fiscal_delta_20261021_test`, loopback 55441, com guarda e transacções revertidas: ciclo de prévia/divulgação/actualização/retirada/nova divulgação, repetição sem duplicar auditoria, preservação do original privado e metadados/vínculo de documento em quarentena, projecção pública sem conteúdo privado, ausência de concessão de papéis/aprovação, recusa de sessão/âmbito não autorizados, prévia adulterada/expirada/desactualizada e recuperação. A integração com o middleware foi ajustada para delegar a autorização destas duas operações ao serviço promocional; um Publicador não recebe por isso edição do rascunho.
+
+No navegador, conta sintética de Promotor interno autenticada normalmente com MFA; ficha sintética 255, `SINTETICO-QA-PROMO-20261022`: prévia revista → confirmação → ficha pública com Em preparação, fonte, lacunas e abrangência Cabo Delgado → recarregar e recuperar → actualizar o resumo → rever e confirmar → retirar com prévia → consulta pública 404 e histórico com três operações. Não foram usados comandos para executar essas operações. A fixture preparou apenas o cadastro/identidade de teste e ficou retirada do público QA; não é dado de entrega. A primeira tentativa MFA da fixture tinha formato de cifra incompatível com Fortify e foi corrigida apenas na fixture; não se alterou a autenticação nem se utilizou essa tentativa como prova. Provas em `outputs/promotional-interface-20261022/01-previa.png`, `02-historico-retirada.png`, `tests-final.log`, `types.log` e `build-final.log`.
+
+Para Mario, mantém-se a designação de Publicador já aprovada, sem pedir outra decisão da Tempo. A gestão de perfis passou a permitir seleccionar a conta existente por nome/email e mostrar a verificação de email/MFA, em vez de exigir descoberta de IDs por comandos. Quando a conta estiver disponível e cumprir os requisitos existentes, a dupla autorizada aplica a atribuição interna no mesmo ecrã de perfis e no âmbito aprovado, com auditoria. Não foram criadas contas nem aplicados papéis no activo. A indisponibilidade de outras contas não bloqueia as operações já autorizadas.
+
+Fecho deste recorte: as operações correntes incluídas têm percurso de interface em QA; a divulgação promocional já não exige o executor privado. Provas documentais, criação/gravação normal de oportunidades e revisão/publicação normal já aceites foram reutilizadas. Não se declara nova demonstração integral desses fluxos nem instalação no activo. Permanecem separados: disponibilização da candidata pelo processo Git após revisão, atribuições reais quando as contas estiverem disponíveis, variantes de oportunidades ainda não implementadas e geometrias administrativas. Publicação documental continua a disponibilizar consulta, sem activar cálculos fiscais.
+
+Validação final deste delta QA: cinco testes/81 asserções passaram em 116,299 s, com transacções revertidas; TypeScript e build QA passaram. As provas visuais cobrem as três operações promocionais novas; as provas documentais e do workflow normal continuam reutilizadas, sem repetição. Nenhuma fixture, segredo, build QA ou atribuição sintética integra os ficheiros versionados.

resources/css/app.css

@@ -7,66 +7,34 @@
 
 @custom-variant dark (&:is(.dark *));
 
+@import './tempo-header.css';
+
 /* Institutional shell adapted from Tempo; page content keeps its own theme. */
 .tempo-header {
-    position: relative;
+    position: sticky;
+    top: 0;
     z-index: 40;
     background: #090909;
     color: #fff;
 }
 .tempo-header-inner {
-    position: relative;
-    display: grid;
-    grid-template-columns: minmax(0, 1fr) auto auto;
-    grid-template-rows: 72px;
-    column-gap: 0.5rem;
-    align-items: center;
-    max-width: 1440px;
-    margin-inline: auto;
-    padding-inline: 0.75rem;
+    grid-template-rows: 84px;
 }
 .tempo-logo-link {
-    grid-area: 1 / 1;
     display: inline-flex;
-    width: fit-content;
     align-items: center;
-    flex-shrink: 0;
+    width: 140px;
     border-radius: 0.25rem;
 }
-.tempo-header-logo {
-    width: auto;
-    height: 36px;
-    object-fit: contain;
-}
-.tempo-primary-navigation {
-    display: none;
-    grid-area: 2 / 1 / auto / -1;
-    min-width: 0;
-    border-top: 1px solid #ffffff1a;
-}
-.tempo-primary-navigation > ul {
-    display: grid;
-    grid-template-columns: repeat(2, minmax(0, 1fr));
-    gap: 0.25rem 0.5rem;
-    padding-block: 0.75rem;
-}
-.tempo-primary-navigation .tempo-nav-trigger {
-    font-size: 0.9375rem;
-    padding-inline: 0.5rem;
-}
 .tempo-nav-trigger {
     display: flex;
-    width: 100%;
-    min-height: 44px;
+    min-height: 48px;
     align-items: center;
-    justify-content: space-between;
-    gap: 0.4rem;
-    padding: 0.5rem 0.75rem;
-    border-radius: 0.4rem;
-    font-size: 1rem;
-    line-height: 1.5;
+    gap: 0.5rem;
+    padding: 0.6rem 0.75rem;
+    border-radius: 0.5rem;
+    font-size: 0.9375rem;
     font-weight: 600;
-    white-space: nowrap;
     color: #eee;
     transition:
         color 0.2s,
@@ -84,85 +52,16 @@
 .tempo-nav-trigger[data-state='open'] > svg {
     transform: rotate(180deg);
 }
-.tempo-primary-navigation .tempo-nav-trigger > svg {
-    transform: none;
-    flex-shrink: 0;
-}
-.tempo-section-bar {
-    border-top: 1px solid #ffffff14;
-    background: inherit;
-}
-.tempo-section-inner {
-    display: grid;
-    grid-template-columns: minmax(0, 1fr) auto;
-    align-items: center;
-    gap: 0.25rem 0.75rem;
-    max-width: 1440px;
-    margin-inline: auto;
-    padding: 0 0.75rem 0.5rem;
-}
-.tempo-section-navigation {
-    grid-area: 1 / 1 / auto / -1;
-    min-width: 0;
-}
-.tempo-section-navigation > ul {
-    display: flex;
-    justify-content: center;
-    gap: 0.25rem;
-}
-.tempo-section-navigation .tempo-nav-trigger {
-    justify-content: center;
-    min-height: 44px;
-    gap: 0.25rem;
-    padding: 0.5rem 0.375rem;
-    border-radius: 0;
-    font-size: 0.8125rem;
-    letter-spacing: normal;
-}
-@media (min-width: 640px) {
-    .tempo-section-navigation .tempo-nav-trigger {
-        min-height: 48px;
-        gap: 0.5rem;
-        padding-inline: 0.75rem;
-        font-size: 1rem;
+@media (max-width: 640px) {
+    .tempo-nav-trigger {
+        gap: 0.25rem;
+        padding-inline: 0.25rem;
+        font-size: 0.8125rem;
     }
-}
-@media (min-width: 768px) {
-    .tempo-section-inner {
-        grid-template-columns: minmax(0, 1fr) auto minmax(0, 1fr);
-        padding: 0.25rem 1.25rem;
+    .tempo-nav-trigger > svg {
+        width: 12px;
+        height: 12px;
     }
-    .tempo-section-navigation {
-        grid-area: 1 / 2;
-    }
-    .tempo-section-inner .tempo-panel-summary {
-        grid-area: 1 / 1;
-    }
-    .tempo-section-inner .tempo-interest-button {
-        grid-area: 1 / 3;
-    }
-}
-.tempo-header-extras {
-    display: none;
-    grid-area: 3 / 1 / auto / -1;
-    flex-direction: column;
-    gap: 0.75rem;
-    min-width: 0;
-    padding-block: 0.75rem;
-    border-top: 1px solid #ffffff1a;
-}
-.tempo-header[data-expanded] .tempo-primary-navigation {
-    display: block;
-}
-.tempo-header[data-expanded] .tempo-header-extras {
-    display: flex;
-}
-.tempo-header-utilities {
-    display: flex;
-    flex-wrap: wrap;
-    align-items: center;
-    justify-content: space-between;
-    gap: 0.5rem;
 }
 .tempo-utility-button {
     display: flex;
@@ -171,7 +70,7 @@
     gap: 0.4rem;
     padding: 0.4rem;
     border-radius: 0.5rem;
-    font-size: 0.8125rem;
+    font-size: 0.75rem;
     color: #e2e8f0;
 }
 .tempo-utility-button:hover {
@@ -193,6 +92,11 @@
     transform: translateY(-2px);
     opacity: 0.8;
 }
+@media (max-width: 360px) {
+    .tempo-header-social {
+        width: 26px;
+    }
+}
 .tempo-login-button {
     display: inline-flex;
     min-height: 40px;
@@ -200,10 +104,9 @@
     gap: 0.5rem;
     border: 1px solid #ffffff50;
     border-radius: 0.4rem;
-    padding: 0.5rem 0.75rem;
-    font-size: 0.875rem;
+    padding: 0.5rem 0.85rem;
+    font-size: 0.8rem;
     font-weight: 600;
-    white-space: nowrap;
     color: #fff;
     transition:
         background 0.2s,
@@ -213,23 +116,19 @@
     background: #ed1c24;
     border-color: #ed1c24;
 }
-.tempo-login-button > span {
-    max-width: clamp(2rem, calc(100vw - 18rem), 6rem);
-}
 .tempo-header-actions {
-    grid-area: 1 / 2;
+    order: 2;
     display: flex;
-    min-width: 0;
     align-items: center;
+    gap: 0.5rem;
+    margin-left: auto;
 }
 .tempo-interest-button {
     display: inline-flex;
-    grid-area: 2 / 2;
-    justify-self: end;
     align-items: center;
     justify-content: center;
     min-height: 40px;
-    padding: 0.5rem 0.65rem;
+    padding: 0.5rem 0.75rem;
     border: 1px solid #ed1c24;
     border-radius: 0.4rem;
     background: #ed1c24;
@@ -243,171 +142,81 @@
     background: #c9151c;
 }
 .tempo-panel-summary {
-    grid-area: 2 / 1;
+    order: 4;
     display: flex;
-    flex-direction: column;
-    align-items: flex-start;
-    justify-content: center;
-    gap: 0.1rem;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.5rem;
+    width: 100%;
     min-height: 44px;
-    font-size: 0.8125rem;
-    line-height: 1.4;
+    padding-block: 0.5rem;
+    border-top: 1px solid #ffffff1a;
+    font-size: 0.75rem;
+}
+.tempo-panel-summary a {
     color: #fff;
     text-underline-offset: 3px;
 }
-.tempo-panel-summary:hover {
+.tempo-panel-summary a:hover {
     text-decoration: underline;
 }
-.tempo-panel-count {
+.tempo-panel-summary span {
     color: #cbd5e1;
     font-size: 0.6875rem;
+    white-space: nowrap;
 }
-.tempo-header-toggle {
-    grid-area: 1 / 3;
-    display: inline-flex;
-    width: 44px;
-    height: 44px;
-    flex-shrink: 0;
-    align-items: center;
-    justify-content: center;
-    border: 1px solid #ffffff33;
-    border-radius: 0.4rem;
-    color: #fff;
-    cursor: pointer;
-}
-.tempo-header-toggle:hover,
-.tempo-header-toggle[aria-expanded='true'] {
-    background: #ffffff10;
+@media (max-width: 480px) {
+    .tempo-header-actions {
+        flex-direction: column;
+        align-items: flex-end;
+        padding-block: 0.65rem;
+    }
 }
 @media (min-width: 640px) {
     .tempo-header-inner {
-        padding-inline: 1.25rem;
+        grid-template-rows: 90px;
     }
-    .tempo-header-logo {
-        height: 44px;
-    }
-    .tempo-primary-navigation > ul {
-        display: flex;
-        justify-content: space-between;
-    }
-}
-@media (min-width: 1024px) {
-    .tempo-header-inner {
-        grid-template-rows: 88px;
-        padding-inline: 1.5rem;
-    }
-    .tempo-header-logo {
-        height: 56px;
+    .tempo-logo-link {
+        width: 160px;
     }
 }
 @media (min-width: 1280px) {
-    /* Shared columns keep each portal area below its institutional link. */
-    .tempo-header-layout {
-        display: grid;
-        grid-template-columns: auto repeat(4, max-content) minmax(0, 1fr) auto;
-        column-gap: 0.25rem;
-        max-width: 1440px;
-        margin-inline: auto;
-        padding-inline: 2rem;
-    }
     .tempo-header-inner {
-        grid-column: 1 / -1;
-        grid-template-columns: subgrid;
-        min-height: 88px;
-        column-gap: normal;
-        max-width: none;
-        margin: 0;
-        padding: 0;
+        grid-template-rows: 96px;
     }
     .tempo-logo-link {
-        margin-right: 0.75rem;
-    }
-    .tempo-header-logo {
-        height: 64px;
-    }
-    .tempo-header[data-expanded] .tempo-primary-navigation,
-    .tempo-primary-navigation {
-        display: grid;
-        grid-area: 1 / 2 / 2 / 6;
-        grid-template-columns: subgrid;
-        border: 0;
-    }
-    .tempo-primary-navigation > ul {
-        display: grid;
-        grid-column: 1 / -1;
-        grid-template-columns: subgrid;
-        gap: normal;
-        padding: 0;
-    }
-    .tempo-nav-trigger {
-        justify-content: center;
-        padding-inline: 0.875rem;
-        font-size: 1.125rem;
-        letter-spacing: 0.025em;
-    }
-    .tempo-primary-navigation .tempo-nav-trigger {
-        padding-inline: 0.625rem;
-        font-size: 1.125rem;
-    }
-    .tempo-header-extras {
-        display: flex;
-        grid-area: 1 / 6;
-        justify-self: end;
-        flex-shrink: 0;
-        padding: 0 0.75rem;
-        border-top: 0;
-        border-inline: 1px solid #ffffff1a;
-    }
-    .tempo-header-utilities {
-        flex-wrap: nowrap;
-        gap: 0.5rem;
-    }
-    .tempo-header-social {
-        width: 26px;
-    }
-    .tempo-header-toggle {
-        display: none;
+        width: 152px;
     }
     .tempo-header-actions {
-        grid-area: 1 / 7;
+        order: 6;
+        margin-left: 0;
     }
-    .tempo-section-bar {
-        display: grid;
-        grid-column: 1 / -1;
-        grid-template-columns: subgrid;
+    .tempo-header-inner .tempo-nav-trigger {
+        padding-inline: 0.5rem;
+        font-size: 0.9375rem;
     }
-    .tempo-section-inner {
-        grid-column: 1 / -1;
-        grid-template-columns: subgrid;
-        gap: normal;
-        max-width: none;
-        margin: 0;
-        padding-inline: 0;
+    .tempo-panel-summary {
+        order: 0;
+        flex-direction: column;
+        align-items: flex-start;
+        justify-content: center;
+        gap: 0.1rem;
+        width: auto;
+        min-width: 102px;
+        border-top: 0;
+        border-left: 1px solid #ffffff1a;
+        padding-left: 0.75rem;
     }
-    .tempo-section-navigation {
-        display: grid;
-        grid-area: 1 / 2 / 2 / 5;
-        grid-template-columns: subgrid;
+}
+@media (min-width: 1440px) {
+    .tempo-header-inner {
+        grid-template-rows: 102px;
     }
-    .tempo-section-navigation > ul {
-        display: grid;
-        grid-column: 1 / -1;
-        grid-template-columns: subgrid;
-        gap: normal;
+    .tempo-logo-link {
+        width: 168px;
     }
-    .tempo-section-navigation .tempo-nav-trigger {
-        padding-inline: 0.625rem;
-    }
-    .tempo-primary-navigation .tempo-nav-trigger,
-    .tempo-section-navigation .tempo-nav-trigger {
-        justify-content: flex-start;
-    }
-    .tempo-interest-button {
-        padding-inline: 0.85rem;
-        font-size: 0.8125rem;
-    }
-    .tempo-section-inner .tempo-interest-button {
-        grid-area: 1 / 6 / 2 / -1;
+    .tempo-header-inner .tempo-nav-trigger {
+        font-size: 1rem;
     }
 }
 .tempo-header :is(a, button):focus-visible {
@@ -441,7 +250,7 @@
     outline: none;
 }
 .tempo-footer {
-    margin-top: 2rem;
+    margin-top: 1.5rem;
     background: #050505;
     color: #fff;
 }
@@ -475,7 +284,8 @@
 .tempo-contact-link {
     display: flex;
     align-items: center;
-    gap: 1rem;
+    gap: 0.75rem;
+    min-height: 40px;
     transition: color 0.2s;
 }
 .tempo-contact-link:hover {

resources/css/tempo-header.css

@@ -0,0 +1,321 @@
+/* Presentation choice for Tempo's 21/10/2026 request: one shared navigation. */
+.tempo-header {
+    position: relative;
+    z-index: 40;
+    background: #090909;
+    color: #fff;
+    border-bottom: 1px solid #ffffff14;
+}
+.tempo-header-inner {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) auto auto;
+    grid-template-rows: 71px;
+    align-items: center;
+    column-gap: 0.5rem;
+    max-width: 1600px;
+    margin-inline: auto;
+    padding-inline: 0.75rem;
+}
+.tempo-logo-link {
+    grid-area: 1 / 1;
+    display: inline-flex;
+    align-items: center;
+    width: 112px;
+    max-width: 100%;
+    border-radius: 0.25rem;
+}
+.tempo-header-logo {
+    width: 100%;
+    height: auto;
+    object-fit: contain;
+}
+.tempo-primary-navigation {
+    display: none;
+    grid-area: 2 / 1 / auto / -1;
+    min-width: 0;
+    border-top: 1px solid #ffffff1a;
+    padding-block: 0.75rem;
+}
+.tempo-primary-navigation > ul {
+    display: grid;
+    gap: 0.25rem;
+}
+.tempo-nav-trigger {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 0.4rem;
+    width: 100%;
+    min-height: 44px;
+    padding: 0.5rem 0.75rem;
+    border-radius: 0.5rem;
+    color: #e2e8f0;
+    font-size: 1rem;
+    line-height: 1.5;
+    font-weight: 600;
+    white-space: nowrap;
+    transition:
+        color 0.2s,
+        background 0.2s;
+}
+.tempo-nav-trigger:hover,
+.tempo-nav-trigger[data-state='open'] {
+    background: #ffffff0d;
+    color: #fff;
+}
+.tempo-nav-trigger[data-current-group] {
+    color: #fff;
+    background: #ffffff08;
+    box-shadow: inset 0 -2px #ed1c24;
+}
+.tempo-nav-trigger > svg {
+    flex-shrink: 0;
+    transition: transform 0.2s;
+}
+.tempo-nav-trigger[data-state='open'] > svg {
+    transform: rotate(180deg);
+}
+.tempo-header-extras {
+    display: none;
+    grid-area: 3 / 1 / auto / -1;
+    min-width: 0;
+    padding-block: 0.75rem;
+    border-top: 1px solid #ffffff1a;
+}
+.tempo-header-utilities {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: 0.5rem;
+}
+.tempo-utility-button {
+    display: flex;
+    align-items: center;
+    gap: 0.4rem;
+    min-height: 44px;
+    padding: 0.4rem;
+    border-radius: 0.5rem;
+    color: #e2e8f0;
+    font-size: 0.8125rem;
+}
+.tempo-utility-button:hover {
+    background: #ffffff10;
+}
+.tempo-header-actions {
+    grid-area: 1 / 2;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    min-width: 0;
+}
+.tempo-login-button {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.5rem;
+    min-height: 44px;
+    padding: 0.5rem 0.625rem;
+    border: 1px solid #ffffff40;
+    border-radius: 0.5rem;
+    color: #fff;
+    font-size: 0.875rem;
+    font-weight: 600;
+    white-space: nowrap;
+    transition:
+        background 0.2s,
+        border-color 0.2s;
+}
+.tempo-login-button:hover {
+    background: #ffffff10;
+    border-color: #ffffff80;
+}
+.tempo-login-button > span {
+    max-width: clamp(2rem, calc(100vw - 18rem), 6rem);
+}
+.tempo-panel-summary {
+    position: relative;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 44px;
+    height: 44px;
+    flex-shrink: 0;
+    border-radius: 0.5rem;
+    color: #e2e8f0;
+}
+.tempo-panel-summary:hover {
+    background: #ffffff10;
+    color: #fff;
+}
+.tempo-panel-count {
+    position: absolute;
+    top: 0;
+    right: -0.125rem;
+    min-width: 17px;
+    padding-inline: 0.2rem;
+    border: 2px solid #090909;
+    border-radius: 999px;
+    background: #ed1c24;
+    color: #fff;
+    font-size: 0.5625rem;
+    line-height: 1.4;
+    text-align: center;
+}
+.tempo-interest-button {
+    display: none;
+    grid-area: 4 / 1 / auto / -1;
+    align-items: center;
+    justify-content: center;
+    gap: 0.5rem;
+    min-height: 44px;
+    margin-bottom: 1rem;
+    padding: 0.5rem 0.875rem;
+    border: 1px solid #ed1c24;
+    border-radius: 0.5rem;
+    background: #ed1c24;
+    color: #fff;
+    font-size: 0.8125rem;
+    font-weight: 600;
+    white-space: nowrap;
+    transition: background 0.2s;
+}
+.tempo-interest-button:hover {
+    background: #c9151c;
+}
+.tempo-header-toggle {
+    grid-area: 1 / 3;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 44px;
+    height: 44px;
+    border: 1px solid #ffffff33;
+    border-radius: 0.5rem;
+    color: #fff;
+    cursor: pointer;
+}
+.tempo-header-toggle:hover,
+.tempo-header-toggle[aria-expanded='true'] {
+    background: #ffffff10;
+}
+.tempo-header[data-expanded] .tempo-primary-navigation {
+    display: block;
+}
+.tempo-header[data-expanded] .tempo-header-extras {
+    display: flex;
+}
+.tempo-header[data-expanded] .tempo-interest-button {
+    display: inline-flex;
+}
+.tempo-header :is(a, button):focus-visible {
+    outline: 2px solid #fff;
+    outline-offset: 3px;
+}
+.tempo-submenu {
+    max-width: min(
+        calc(100vw - 1.5rem),
+        var(--radix-dropdown-menu-content-available-width)
+    );
+}
+@media (min-width: 640px) {
+    .tempo-header-inner {
+        grid-template-columns: minmax(0, 1fr) auto auto auto;
+        column-gap: 0.75rem;
+        padding-inline: 1.5rem;
+    }
+    .tempo-logo-link {
+        width: 132px;
+    }
+    .tempo-interest-button {
+        display: inline-flex;
+        grid-area: 1 / 3;
+        margin-bottom: 0;
+    }
+    .tempo-header-toggle {
+        grid-area: 1 / 4;
+    }
+}
+@media (min-width: 1280px) {
+    .tempo-header-inner {
+        grid-template-columns: auto minmax(0, 1fr) auto auto auto;
+        column-gap: 0.25rem;
+        padding-inline: 1.25rem;
+    }
+    .tempo-logo-link {
+        width: 100px;
+    }
+    .tempo-login-button > span {
+        max-width: 3rem;
+    }
+    .tempo-primary-navigation,
+    .tempo-header[data-expanded] .tempo-primary-navigation {
+        display: block;
+        grid-area: 1 / 2;
+        border: 0;
+        padding: 0;
+        justify-self: center;
+    }
+    .tempo-primary-navigation > ul {
+        display: flex;
+        align-items: center;
+        gap: 0;
+    }
+    .tempo-nav-trigger {
+        justify-content: center;
+        padding-inline: 0.25rem;
+        font-size: 1.125rem;
+        letter-spacing: 0.025em;
+    }
+    .tempo-header-extras,
+    .tempo-header[data-expanded] .tempo-header-extras {
+        display: flex;
+        grid-area: 1 / 3;
+        padding: 0 0.5rem 0 0;
+        border: 0;
+        border-right: 1px solid #ffffff1a;
+    }
+    .tempo-header-utilities {
+        flex-wrap: nowrap;
+    }
+    .tempo-header-actions {
+        grid-area: 1 / 4;
+    }
+    .tempo-interest-button {
+        grid-area: 1 / 5;
+    }
+    .tempo-header-toggle {
+        display: none;
+    }
+}
+@media (min-width: 1440px) {
+    .tempo-header-inner {
+        column-gap: 0.75rem;
+        padding-inline: 2rem;
+    }
+    .tempo-nav-trigger {
+        padding-inline: 0.375rem;
+        font-size: 1.125rem;
+    }
+    .tempo-logo-link {
+        width: 132px;
+    }
+    .tempo-login-button > span {
+        max-width: 5rem;
+    }
+    .tempo-header-extras {
+        padding-right: 0.75rem;
+    }
+    .tempo-primary-navigation > ul {
+        gap: 0.125rem;
+    }
+}
+@media (min-width: 1536px) {
+    .tempo-header-inner {
+        column-gap: 1rem;
+    }
+    .tempo-nav-trigger {
+        padding-inline: 0.75rem;
+    }
+    .tempo-login-button > span {
+        max-width: 6rem;
+    }
+}

resources/js/components/app-sidebar.tsx

@@ -26,6 +26,7 @@ export function AppSidebar() {
         educationEnabled,
         aiEnabled,
         opportunityManagement,
+        contentManagementHref,
         profileAccess,
     } = usePage<{
         auth: Auth;
@@ -34,6 +35,7 @@ export function AppSidebar() {
         aiEnabled?: boolean;
         profileAccess?: ProfileAccess | null;
         opportunityManagement?: OpportunityManagementAccess | null;
+        contentManagementHref?: string | null;
     }>().props;
     const groups = portalNavigation({
         authenticated: !!auth.user,
@@ -48,6 +50,9 @@ export function AppSidebar() {
         href: group.children?.find((item) => item.href)?.href ?? '/',
         icon: LayoutGrid,
     }));
+    if (contentManagementHref) {
+        items.unshift({ title: 'Gestão de conteúdos e oportunidades', href: contentManagementHref, icon: LayoutGrid });
+    }
     if (auth.canManagePortal && opportunityManagement) {
         items.push({
             title: opportunityManagement.manage.label,

resources/js/components/catalogue-navigation.tsx

@@ -1,4 +1,5 @@
 import { Link, usePage } from '@inertiajs/react';
+import { searchTerritoryHref } from '@/lib/search-territory';
 export default function CatalogueNavigation({
     dimensionUrl,
 }: {
@@ -21,7 +22,7 @@ export default function CatalogueNavigation({
         )
             return dimensionUrl(u.searchParams.get('dimension')!);
         if (context) u.searchParams.set('context', context);
-        return u.pathname + u.search;
+        return searchTerritoryHref(u.pathname + u.search, url);
     };
     const sections = {
         'Enquadramento e filtros': [

resources/js/components/content-management-entry.tsx

@@ -0,0 +1,6 @@
+import { Link, usePage } from '@inertiajs/react';
+
+export default function ContentManagementEntry() {
+    const { contentManagementHref } = usePage<{ contentManagementHref?: string | null }>().props;
+    return contentManagementHref ? <Link className="inline-block rounded-lg border px-4 py-3 font-semibold underline" href={contentManagementHref}>Gestão de conteúdos e oportunidades</Link> : null;
+}

resources/js/components/dossier-prefill.tsx

@@ -1,10 +1,12 @@
 import { useEffect, useRef, useState } from 'react';
+import { InvestmentContextAssessment } from './investment-context-assessment';
 import { Link } from '@inertiajs/react';
 import {
     contextApi,
     contextFieldNames,
     type ContextView,
 } from '@/lib/investor-context';
+import { inheritCompatibleFields } from '@/lib/context-inheritance';
 type Props = {
     contextId?: string | null;
     consumer: 'simulator' | 'land' | 'desk' | 'submission';
@@ -12,6 +14,7 @@ type Props = {
     enabled?: boolean;
     readOnly?: boolean;
     allowedFields?: string[];
+    persistInheritance?: boolean;
     boundRevision?: number;
     onApply: (patch: Record<string, unknown>, replace: boolean) => void;
     onReview?: (revision: number, reviewed: boolean) => void;
@@ -40,17 +43,16 @@ export function DossierPrefill(props: Props) {
     const [selected, setSelected] = useState<string[]>([]);
     const [reviewed, setReviewed] = useState(false);
     const [message, setMessage] = useState('');
-    const filled = useRef('');
     useEffect(() => {
         if (!contextId) return;
         let stopped = false;
+        setView(null);
         setError('');
         void contextApi<ContextView>(`/investimentos/${contextId}/contexto`)
             .then((v) => {
                 if (!stopped) {
                     setView(v);
                     setReviewed(false);
-                    latest.current.onReview?.(v.context.revision, false);
                 }
             })
             .catch((e) => {
@@ -61,44 +63,20 @@ export function DossierPrefill(props: Props) {
         };
     }, [contextId, retry]);
     useEffect(() => {
-        if (!view || !enabled || readOnly || !view.can_write) return;
-        const generation = `${contextId}:${view.context.revision}:${consumer}`;
-        if (filled.current === generation) return;
+        if (!view || view.case.id !== contextId || !enabled || readOnly || !view.can_write) return;
         const source = view.prefill[consumer] ?? {};
         const now = latest.current;
-        const patch: Record<string, unknown> = {};
-        const conflict = geo.some(
-            (k) =>
-                !empty(now.values[k]) &&
-                String(now.values[k]) !== text(source[k]),
-        );
-        for (const [k, v] of Object.entries(source)) {
-            if (
-                (now.allowedFields && !now.allowedFields.includes(k)) ||
-                (geo.includes(k) && conflict)
-            )
-                continue;
-            if (k === 'parcels') {
-                const old = now.values.parcels as
-                    | Record<string, unknown>[]
-                    | undefined;
-                if (
-                    (!old?.length || geo.every((g) => empty(old[0]?.[g]))) &&
-                    Array.isArray(v) &&
-                    v[0] &&
-                    Object.keys(v[0]).length
-                )
-                    patch[k] = v;
-            } else if (empty(now.values[k]) && !empty(v)) patch[k] = v;
-        }
-        filled.current = generation;
-        if (Object.keys(patch).length) {
-            now.onApply(patch, false);
+        const inherited = inheritCompatibleFields(`dossier:${contextId}:${consumer}`, now.values, source, now.values.context_reuse, now.allowedFields);
+        if (Object.keys(inherited.patch).length || (now.persistInheritance !== false && now.values.context_reuse !== inherited.metadata)) {
+            // The shared reconciliation has already selected safe fields; metadata travels with the same saved form.
+            now.onApply({...inherited.patch, ...(now.persistInheritance === false ? {} : {context_reuse:inherited.metadata})}, true);
             setMessage(
-                'Campos vazios preenchidos a partir do dossier. Reveja-os; os campos já preenchidos foram preservados.',
+                'Dados compatíveis reutilizados do mesmo dossier. Os valores herdados acompanham o contexto; as suas alterações locais foram preservadas.',
             );
         }
-    }, [view, enabled, readOnly, contextId, consumer]);
+        setReviewed(true);
+        now.onReview?.(view.context.revision, true);
+    }, [view, enabled, readOnly, contextId, consumer, props.values]);
     if (!contextId) return null;
     if (error)
         return (
@@ -126,7 +104,7 @@ export function DossierPrefill(props: Props) {
         ),
     );
     const differences = Object.keys(source).filter(
-        (k) => text(props.values[k]) !== text(source[k]),
+        (k) => k !== 'context_applicability_snapshot' && text(props.values[k]) !== text(source[k]),
     );
     const linkedRevision =
         consumer === 'simulator'
@@ -152,6 +130,7 @@ export function DossierPrefill(props: Props) {
                 . Mestres, declarações deste formulário e conteúdo já submetido
                 mantêm-se separados.
             </p>
+            <InvestmentContextAssessment contextId={contextId} raw={view.prefill.simulator?.context_applicability_snapshot} />
             {stale && (
                 <p className="font-semibold" role="status">
                     {linkedRevision > 0
@@ -254,7 +233,17 @@ export function DossierPrefill(props: Props) {
                             const patch: Record<string, unknown> = {};
                             for (const k of selected)
                                 patch[k] = source[k] ?? '';
-                            props.onApply(patch, true);
+                            const scope = `dossier:${contextId}:${consumer}`;
+                            let raw = String(props.values.context_reuse ?? '');
+                            try {
+                                const metadata = JSON.parse(raw);
+                                if(metadata.scope === scope) {
+                                    for(const key of selected) delete metadata.inherited?.[key];
+                                    raw=JSON.stringify(metadata);
+                                }
+                            } catch { /* Legacy metadata does not grant ownership of other fields. */ }
+                            const adopted=inheritCompatibleFields(scope,{...props.values,...Object.fromEntries(selected.map(key=>[key,undefined]))},patch,raw,props.allowedFields);
+                            props.onApply({...patch,...(props.persistInheritance === false ? {} : {context_reuse:adopted.metadata})}, true);
                             setSelected([]);
                             setReviewed(false);
                             props.onReview?.(view.context.revision, false);
@@ -267,27 +256,7 @@ export function DossierPrefill(props: Props) {
                     </button>
                 </details>
             )}
-            {!readOnly &&
-                view.can_write &&
-                props.onReview &&
-                view.context.revision > 0 && (
-                    <label className="block">
-                        <input
-                            type="checkbox"
-                            checked={reviewed}
-                            onChange={(e) => {
-                                setReviewed(e.target.checked);
-                                props.onReview?.(
-                                    view.context.revision,
-                                    e.target.checked,
-                                );
-                            }}
-                        />{' '}
-                        Conferi os dados e pressupostos deste formulário para o
-                        contexto v{view.context.revision}; os valores diferentes
-                        que conservei são declarações deste processo.
-                    </label>
-                )}
+            {!readOnly && reviewed && <p>Contexto v{view.context.revision} recuperado neste formulário, sem nova confirmação dos dados compatíveis. As edições locais conservam-se; as declarações e submissões formais mantêm os seus controlos próprios.</p>}
             <p className="text-xs">
                 Associar uma referência não confirma incentivos, licenças, terra
                 disponível, reserva ou autorização.

resources/js/components/investment-context-assessment.tsx

@@ -0,0 +1,232 @@
+import {
+    PreparationSummary,
+    type Preparation,
+} from '@/components/private-investment-preparation';
+import { Link } from '@inertiajs/react';
+
+type Snapshot = {
+    preparation?: Preparation | null;
+    context_revision: number;
+    path?: {
+        definition_version: number;
+        steps: Array<{
+            code: string;
+            title: string;
+            applicability: string;
+            reason: string;
+            state: string;
+            context_review_required?: boolean;
+        }>;
+    };
+    zone?: {
+        title: string;
+        href: string;
+        version: number | string;
+        fields?: Record<string, string>;
+        analysis?: {
+            conditions?: Array<{
+                id: string;
+                label: string;
+                knowledge: string;
+                source_reference?: string;
+                valid_from?: string;
+                valid_until?: string;
+            }>;
+            source?: {
+                title: string;
+                url: string;
+                diploma?: string;
+                article?: string;
+                valid_from?: string;
+                valid_until?: string;
+            } | null;
+        };
+    } | null;
+    fields?: Record<string, string>;
+};
+export function InvestmentContextAssessment({
+    raw,
+    contextId,
+}: {
+    raw: unknown;
+    contextId?: string | null;
+}) {
+    let snapshot: Snapshot | null = null;
+    try {
+        const value = JSON.parse(String(raw ?? ''));
+        if (value.version === 1) snapshot = value;
+    } catch {
+        /* Missing context remains explicit. */
+    }
+    if (!snapshot) return null;
+    const fields = snapshot.fields ?? {};
+    const zone = snapshot.zone;
+    const regime = zone?.fields?.investment_regime ?? fields.investment_regime;
+    const names: Record<string, string> = {
+        zee: 'ZEE',
+        zfi: 'ZFI',
+        industrial_park: 'Parque industrial',
+    };
+    return (
+        <section
+            className="space-y-2 rounded border border-amber-400 p-3"
+            aria-label="Aplicabilidade ao investimento"
+        >
+            <h3 className="font-semibold">
+                Aplicabilidade ao investimento · contexto v
+                {snapshot.context_revision}
+            </h3>
+            <p>
+                Origem do investidor:{' '}
+                {{
+                    national: 'nacional',
+                    foreign: 'estrangeiro',
+                    mixed: 'misto',
+                }[fields.investor_origin] ?? 'informação em falta'}
+                . Residência fiscal declarada:{' '}
+                {fields.tax_residency_country || 'informação em falta'}. Estas
+                condições são distintas; uma não determina a outra.
+            </p>
+            {zone ? (
+                <>
+                    <p>
+                        <strong>
+                            Potencialmente aplicável — análise específica de{' '}
+                            {names[regime ?? ''] ?? 'zona seleccionada'}.
+                        </strong>{' '}
+                        <Link className="underline" href={zone.href}>
+                            {zone.title} · versão {zone.version} · consultar
+                            ficha e fundamentos
+                        </Link>
+                        .
+                    </p>
+                    <p>
+                        A selecção identifica a referência consultada; não
+                        confirma o reconhecimento da entidade, actividade
+                        autorizada, licença ou acesso a benefícios. Consulte as
+                        condições documentadas na ficha e reúna a autorização ou
+                        evidência correspondente no dossier.
+                    </p>
+                    {zone.analysis?.source && (
+                        <p>
+                            Fundamento cadastrado:{' '}
+                            <a
+                                className="underline"
+                                href={zone.analysis.source.url}
+                            >
+                                {zone.analysis.source.diploma ||
+                                    zone.analysis.source.title}{' '}
+                                {zone.analysis.source.article}
+                            </a>
+                            . Período cadastrado:{' '}
+                            {zone.analysis.source.valid_from ||
+                                'início por indicar'}{' '}
+                            a{' '}
+                            {zone.analysis.source.valid_until ||
+                                'sem termo indicado'}
+                            . A cobertura do investimento exige correspondência
+                            com estas condições.
+                        </p>
+                    )}
+                    {zone.analysis?.conditions?.length ? (
+                        <ul className="list-disc pl-5">
+                            {zone.analysis.conditions.map((condition) => (
+                                <li key={condition.id}>
+                                    <strong>{condition.label}</strong>:{' '}
+                                    {condition.knowledge === 'documented'
+                                        ? 'condição documentada; cumprimento pelo investimento por confirmar'
+                                        : condition.knowledge === 'disputed'
+                                          ? 'condição com informação divergente'
+                                          : 'informação em falta'}
+                                    .{' '}
+                                    {condition.source_reference && (
+                                        <>
+                                            Fundamento:{' '}
+                                            {condition.source_reference}.
+                                        </>
+                                    )}{' '}
+                                    {condition.valid_from && (
+                                        <>Desde {condition.valid_from}.</>
+                                    )}{' '}
+                                    {condition.valid_until && (
+                                        <>Até {condition.valid_until}.</>
+                                    )}
+                                </li>
+                            ))}
+                        </ul>
+                    ) : (
+                        <p>
+                            Condições específicas: informação estruturada em
+                            falta nesta referência. A ficha e os documentos
+                            continuam consultáveis; não se presume cumprimento.
+                        </p>
+                    )}
+                    <p role="status">
+                        Benefício fiscal deste enquadramento: indeterminado. Não
+                        existe neste consumidor uma regra executável ligada ao
+                        reconhecimento e condições da zona. No simulador, o IVA
+                        disponível corresponde apenas ao cenário geral sem
+                        benefício, sobre vendas declaradas compatíveis; não
+                        simula o regime especial. O cenário com benefício e o
+                        apuramento final estão indisponíveis.
+                    </p>
+                </>
+            ) : (
+                <p>
+                    Enquadramento geral de preparação: sem ZEE, ZFI ou parque
+                    seleccionado. Isso não confirma a elegibilidade para uma
+                    operação fiscal. O cálculo mantém o âmbito e as exclusões da
+                    versão publicada.
+                </p>
+            )}
+            <p>
+                Confirmado neste quadro significa apenas dado recuperado do
+                dossier; declarações e referências não são decisões jurídicas.
+                Requisitos específicos não documentados permanecem
+                indeterminados.
+            </p>
+            {snapshot.path && (
+                <details>
+                    <summary>
+                        Passos adaptados pelo percurso existente · versão{' '}
+                        {snapshot.path.definition_version}
+                    </summary>
+                    <ul className="list-disc pl-5">
+                        {snapshot.path.steps.map((step) => (
+                            <li key={step.code}>
+                                {step.code} — {step.title}:{' '}
+                                {step.context_review_required
+                                    ? 'informação alterada; rever fundamento'
+                                    : step.applicability ===
+                                        'not_needed_for_preparation'
+                                      ? 'não aplicável à preparação declarada'
+                                      : step.applicability === 'undetermined'
+                                        ? 'informação em falta'
+                                        : ['completed', 'approved'].includes(
+                                                step.state,
+                                            )
+                                          ? 'preparação confirmada no percurso; não é decisão fiscal'
+                                          : 'potencialmente aplicável'}
+                                . {step.reason}
+                            </li>
+                        ))}
+                    </ul>
+                </details>
+            )}
+            {snapshot.preparation?.enabled && (
+                <PreparationSummary
+                    data={snapshot.preparation}
+                    caseId={contextId ?? undefined}
+                />
+            )}
+            {contextId && (
+                <Link
+                    className="underline"
+                    href={`/investimentos/${contextId}/contexto/editar`}
+                >
+                    Alterar contexto e comparar impacto antes de guardar
+                </Link>
+            )}
+        </section>
+    );
+}

resources/js/components/opportunity-search-filters.tsx

@@ -48,6 +48,16 @@ const labels: Record<string, string> = {
     authority_id: 'Entidade',
     publication_state: 'Critério herdado',
 };
+const specialisedEmpty: Record<string, string> = {
+    corridor_id: 'Não existem corredores públicos cadastrados para esta localização.',
+    cluster_id: 'Não existem clusters públicos cadastrados para esta localização.',
+    zee_id: 'Não existem ZEE públicas cadastradas para esta localização.',
+    zfi_id: 'Não existem ZFI públicas cadastradas para esta localização.',
+    park_id: 'Não existem parques industriais públicos cadastrados para esta localização.',
+    project_id: 'Não existem projectos âncora públicos cadastrados para esta localização.',
+    subsector_id: 'Não existem actividades disponíveis no catálogo público.',
+    chain_id: 'Não existem cadeias de valor públicas cadastradas para esta localização.',
+};
 export default function OpportunitySearchFilters({
     data,
     references,
@@ -75,6 +85,9 @@ export default function OpportunitySearchFilters({
         <Field key={key} label={labels[key]}>
             <select
                 className={input}
+                aria-label={labels[key]}
+                aria-describedby={specialisedEmpty[key] ? `filter-help-${key}` : undefined}
+                disabled={Boolean(specialisedEmpty[key]) && choices.length === 0 && !data[key]}
                 value={String(data[key] ?? '')}
                 onChange={(e) =>
                     change({
@@ -86,12 +99,23 @@ export default function OpportunitySearchFilters({
                 }
             >
                 <option value="">Todos</option>
+                {data[key] && !choices.some((o) => o.value === String(data[key])) && (
+                    <option value={String(data[key])}>Selecção indisponível neste contexto — remova o filtro</option>
+                )}
                 {choices.map((o) => (
                     <option key={o.value} value={o.value}>
                         {o.label}
                     </option>
                 ))}
             </select>
+            {specialisedEmpty[key] && (
+                <p id={`filter-help-${key}`} className="text-sm text-slate-600">
+                    {choices.length === 0
+                        ? specialisedEmpty[key]
+                        : `${choices.length} opções públicas disponíveis, mesmo sem oportunidades associadas.`}
+                    {key === 'subsector_id' && choices.length > 0 && ' Classificação de actividades; não confirma a existência de investimentos nesta localização.'}
+                </p>
+            )}
             {hint && <p className="text-sm text-slate-600">{hint}</p>}
         </Field>
     );

resources/js/components/portal-grouped-menu.tsx

@@ -1,16 +1,19 @@
 import PortalProductIdentity from '@/components/portal-product-identity';
+import { searchTerritoryHref } from '@/lib/search-territory';
 import { Link, router, usePage } from '@inertiajs/react';
 import {
     ChevronDown,
     ArrowUpRight,
+    LayoutDashboard,
     LogOut,
     Menu,
     UserRound,
     X,
 } from 'lucide-react';
-import { useEffect, useId, useRef, useState } from 'react';
+import { Fragment, useEffect, useId, useRef, useState } from 'react';
+import { useIsMobile } from '@/hooks/use-mobile';
 import { useNavigationContext } from '@/components/navigation-context';
-import { TempoSocialLinks, useTempoUi } from '@/components/tempo-brand';
+import { tempoSocialLinks, useTempoUi } from '@/components/tempo-brand';
 import {
     TempoLanguageSelector,
     TempoWeather,
@@ -52,6 +55,7 @@ export function PortalGroupedMenu() {
         scopedAdministration?: {label:string;href:string}[];
     }>();
     const { t, language, requestCount } = useTempoUi();
+    const mobile = useIsMobile();
     const navigation = useNavigationContext();
     const groups = portalNavigation({
         context: navigation.view
@@ -72,24 +76,34 @@ export function PortalGroupedMenu() {
     const currentItem = currentNavigationItem(groups, url);
     const [loggingOut, setLoggingOut] = useState(false);
     const [expanded, setExpanded] = useState(false);
-    const institutionalId = useId();
+    const navigationId = useId();
     const toolsId = useId();
+    const interestId = useId();
     const toggle = useRef<HTMLButtonElement>(null);
     useEffect(() => router.on('navigate', () => setExpanded(false)), []);
     const items = (children: PortalNavItem[]) =>
         children.map((item) =>
             item.children ? (
-                <DropdownMenuSub key={item.id}>
-                    <DropdownMenuSubTrigger className="tempo-menu-item font-semibold">
-                        {t(item.label)}
-                    </DropdownMenuSubTrigger>
-                    <DropdownMenuSubContent
-                        collisionPadding={12}
-                        className="tempo-dropdown max-h-[min(70vh,34rem)] w-72 max-w-[calc(100vw-1.5rem)] overflow-y-auto p-2"
-                    >
+                mobile ? (
+                    <Fragment key={item.id}>
+                        <DropdownMenuLabel className="mt-2 border-t px-3 pt-3 text-xs text-slate-500">
+                            {t(item.label)}
+                        </DropdownMenuLabel>
                         {items(item.children)}
-                    </DropdownMenuSubContent>
-                </DropdownMenuSub>
+                    </Fragment>
+                ) : (
+                    <DropdownMenuSub key={item.id}>
+                        <DropdownMenuSubTrigger className="tempo-menu-item font-semibold">
+                            {t(item.label)}
+                        </DropdownMenuSubTrigger>
+                        <DropdownMenuSubContent
+                            collisionPadding={12}
+                            className="tempo-dropdown tempo-submenu max-h-[min(70vh,34rem)] w-72 overflow-y-auto p-2"
+                        >
+                            {items(item.children)}
+                        </DropdownMenuSubContent>
+                    </DropdownMenuSub>
+                )
             ) : (
                 <DropdownMenuItem
                     key={item.id}
@@ -97,7 +111,7 @@ export function PortalGroupedMenu() {
                     className="tempo-menu-item"
                 >
                     <Link
-                        href={item.href!}
+                        href={searchTerritoryHref(item.href!, url)}
                         aria-current={
                             currentItem === item.id ? 'page' : undefined
                         }
@@ -111,6 +125,8 @@ export function PortalGroupedMenu() {
         (group) =>
             !['home', 'discovery', 'realization', 'support'].includes(group.id),
     );
+    const panelLabel = `${t('O meu painel')} — ${requestCount} ${t(requestCount === 1 ? 'pedido recebido' : 'pedidos recebidos')}`;
+    const institutionalCurrent = url.split('?')[0] === '/contacto';
     return (
         <header
             className="tempo-header"
@@ -120,245 +136,303 @@ export function PortalGroupedMenu() {
                 if (
                     event.key === 'Escape' &&
                     expanded &&
-                    !event.defaultPrevented
+                    !event.defaultPrevented &&
+                    !(
+                        event.target instanceof Element &&
+                        event.target.closest('[role="menu"]')
+                    )
                 ) {
                     setExpanded(false);
                     toggle.current?.focus();
                 }
             }}
         >
-            <div className="tempo-header-layout">
-                <div className="tempo-header-inner">
-                    <Link
-                        href="/"
-                        aria-label="InvesteMoz — início"
-                        className="tempo-logo-link"
-                    >
-                        <PortalProductIdentity />
-                    </Link>
-                    <nav
-                        id={institutionalId}
-                        aria-label="Navegação institucional"
-                        className="tempo-primary-navigation"
-                    >
-                        <ul>
-                            <li>
-                                <Link
-                                    href="/"
-                                    className="tempo-nav-trigger"
-                                    aria-current={
-                                        url.split('?')[0] === '/'
-                                            ? 'page'
-                                            : undefined
-                                    }
-                                    data-current-group={
-                                        url.split('?')[0] === '/' || undefined
-                                    }
-                                >
-                                    {t('Início')}
-                                </Link>
-                            </li>
-                            <li>
-                                <a
-                                    href="https://revista.tempo.co.mz/"
-                                    target="_blank"
-                                    rel="noopener noreferrer"
-                                    className="tempo-nav-trigger"
-                                    aria-label={`${t('Revista Tempo')} — ${t('Abre num novo separador')}`}
-                                >
-                                    {t('Revista Tempo')}
-                                    <ArrowUpRight
-                                        size={14}
-                                        aria-hidden="true"
-                                    />
-                                </a>
-                            </li>
-                            {[
-                                ['/sobre', 'Sobre nós'],
-                                ['/contacto', 'Contacto'],
-                            ].map(([href, label]) => (
-                                <li key={href}>
-                                    <Link
-                                        href={href}
-                                        className="tempo-nav-trigger"
-                                        aria-current={
-                                            url.split('?')[0] === href
-                                                ? 'page'
-                                                : undefined
-                                        }
-                                        data-current-group={
-                                            url.split('?')[0] === href ||
-                                            undefined
-                                        }
-                                    >
-                                        {t(label)}
-                                    </Link>
-                                </li>
-                            ))}
-                        </ul>
-                    </nav>
-                    <div id={toolsId} className="tempo-header-extras">
-                        <div className="tempo-header-utilities">
-                            <div className="flex items-center gap-1">
-                                <TempoWeather />
-                                <TempoLanguageSelector />
-                            </div>
-                            <TempoSocialLinks />
-                        </div>
-                    </div>
-                    <div className="tempo-header-actions">
-                        {props.auth?.user ? (
-                            <DropdownMenu modal={false}>
-                                <DropdownMenuTrigger className="tempo-login-button">
-                                    <UserRound size={16} aria-hidden="true" />
-                                    <span className="max-w-24 truncate">
-                                        {props.auth.user.name ||
-                                            t('A minha área')}
-                                    </span>
-                                    <ChevronDown size={12} aria-hidden="true" />
-                                </DropdownMenuTrigger>
-                                <DropdownMenuContent
-                                    align="end"
-                                    sideOffset={12}
-                                    collisionPadding={12}
-                                    className="tempo-dropdown max-h-[75vh] w-72 max-w-[calc(100vw-1.5rem)] overflow-y-auto p-2"
-                                >
-                                    <DropdownMenuLabel className="truncate text-xs text-slate-500">
-                                        {props.auth.user.email}
-                                    </DropdownMenuLabel>
-                                    {items(accountGroups)}
-                                    <DropdownMenuSeparator />
-                                    <DropdownMenuItem
-                                        asChild
-                                        className="tempo-menu-item text-red-700"
-                                    >
-                                        <Link
-                                            href={logout()}
-                                            as="button"
-                                            type="button"
-                                            disabled={loggingOut}
-                                            data-test="portal-logout-button"
-                                            onClick={() => router.flushAll()}
-                                            onStart={() => setLoggingOut(true)}
-                                            onFinish={() =>
-                                                setLoggingOut(false)
+            <div className="tempo-header-inner">
+                <Link
+                    href="/"
+                    aria-label="Tempo — início"
+                    className="tempo-logo-link"
+                >
+                    <img
+                        src="/images/logo/logo-vermelho.png"
+                        alt="Tempo"
+                        width="1787"
+                        height="564"
+                        className="tempo-header-logo"
+                    />
+                </Link>
+                <nav
+                    id={navigationId}
+                    aria-label="Áreas do portal"
+                    className="tempo-primary-navigation"
+                >
+                    <ul>
+                        <li>
+                            <Link
+                                href="/"
+                                className="tempo-nav-trigger"
+                                aria-current={
+                                    url.split('?')[0] === '/'
+                                        ? 'page'
+                                        : undefined
+                                }
+                                data-current-group={
+                                    url.split('?')[0] === '/' || undefined
+                                }
+                            >
+                                {t('Início')}
+                            </Link>
+                        </li>
+                        {groups
+                            .filter((group) =>
+                                [
+                                    'discovery',
+                                    'realization',
+                                    'support',
+                                ].includes(group.id),
+                            )
+                            .map((group) => (
+                                <li key={group.id}>
+                                    <DropdownMenu modal={false}>
+                                        <DropdownMenuTrigger
+                                            className="tempo-nav-trigger"
+                                            data-current-group={
+                                                current === group.id ||
+                                                undefined
                                             }
                                         >
-                                            <LogOut
-                                                size={16}
+                                            {t(group.label)}
+                                            <ChevronDown
+                                                size={14}
                                                 aria-hidden="true"
                                             />
-                                            {loggingOut
-                                                ? 'A terminar sessão…'
-                                                : t('Terminar sessão')}
-                                        </Link>
-                                    </DropdownMenuItem>
-                                </DropdownMenuContent>
-                            </DropdownMenu>
-                        ) : (
-                            <Link href="/login" className="tempo-login-button">
-                                <UserRound size={15} aria-hidden="true" />
-                                {t('Entrar')}
-                            </Link>
-                        )}
-                    </div>
-                    <button
-                        ref={toggle}
-                        type="button"
-                        className="tempo-header-toggle"
-                        aria-label={
-                            expanded
-                                ? 'Fechar menu e ferramentas'
-                                : 'Abrir menu e ferramentas'
-                        }
-                        aria-expanded={expanded}
-                        aria-controls={`${institutionalId} ${toolsId}`}
-                        onClick={() => setExpanded(!expanded)}
-                    >
-                        {expanded ? (
-                            <X size={22} aria-hidden="true" />
-                        ) : (
-                            <Menu size={22} aria-hidden="true" />
-                        )}
-                    </button>
-                </div>
-                <div className="tempo-section-bar">
-                    <div className="tempo-section-inner">
-                        <Link
-                            href="/investidor/manifestacoes"
-                            className="tempo-panel-summary"
-                        >
-                            <span>{t('O meu painel')}</span>
-                            <span
-                                className="tempo-panel-count"
-                                aria-live="polite"
-                                aria-atomic="true"
+                                            {current === group.id && (
+                                                <span className="sr-only">
+                                                    Grupo actual
+                                                </span>
+                                            )}
+                                        </DropdownMenuTrigger>
+                                        <DropdownMenuContent
+                                            align="start"
+                                            sideOffset={12}
+                                            collisionPadding={12}
+                                            className="tempo-dropdown max-h-[min(75vh,36rem)] w-72 max-w-[calc(100vw-1.5rem)] overflow-y-auto p-2"
+                                        >
+                                            {items(group.children ?? [])}
+                                        </DropdownMenuContent>
+                                    </DropdownMenu>
+                                </li>
+                            ))}
+                        <li>
+                            <Link
+                                href="/sobre"
+                                className="tempo-nav-trigger"
+                                aria-current={
+                                    url.split('?')[0] === '/sobre'
+                                        ? 'page'
+                                        : undefined
+                                }
+                                data-current-group={
+                                    url.split('?')[0] === '/sobre' || undefined
+                                }
                             >
-                                {requestCount}{' '}
-                                {t(
-                                    requestCount === 1
-                                        ? 'pedido recebido'
-                                        : 'pedidos recebidos',
-                                )}
-                            </span>
-                        </Link>
-                        <nav
-                            aria-label="Áreas do portal"
-                            className="tempo-section-navigation"
-                        >
-                            <ul>
-                                {groups
-                                    .filter((group) =>
-                                        [
-                                            'discovery',
-                                            'realization',
-                                            'support',
-                                        ].includes(group.id),
-                                    )
-                                    .map((group) => (
-                                        <li key={group.id}>
-                                            <DropdownMenu modal={false}>
-                                                <DropdownMenuTrigger
-                                                    className="tempo-nav-trigger"
-                                                    data-current-group={
-                                                        current === group.id ||
-                                                        undefined
+                                {t('Sobre nós')}
+                            </Link>
+                        </li>
+                        <li>
+                            <DropdownMenu modal={false}>
+                                <DropdownMenuTrigger
+                                    className="tempo-nav-trigger"
+                                    data-current-group={
+                                        institutionalCurrent || undefined
+                                    }
+                                >
+                                    Tempo
+                                    <ChevronDown size={14} aria-hidden="true" />
+                                </DropdownMenuTrigger>
+                                <DropdownMenuContent
+                                    align="start"
+                                    sideOffset={12}
+                                    collisionPadding={12}
+                                    className="tempo-dropdown max-h-[75vh] w-64 max-w-[calc(100vw-1.5rem)] overflow-y-auto p-2"
+                                >
+                                    <DropdownMenuItem
+                                        asChild
+                                        className="tempo-menu-item"
+                                    >
+                                        <a
+                                            href="https://revista.tempo.co.mz/"
+                                            target="_blank"
+                                            rel="noopener noreferrer"
+                                            aria-label={`${t('Revista Tempo')} — ${t('Abre num novo separador')}`}
+                                        >
+                                            {t('Revista Tempo')}
+                                            <ArrowUpRight
+                                                size={14}
+                                                aria-hidden="true"
+                                            />
+                                        </a>
+                                    </DropdownMenuItem>
+                                    {[['/contacto', 'Contacto']].map(
+                                        ([href, label]) => (
+                                            <DropdownMenuItem
+                                                key={href}
+                                                asChild
+                                                className="tempo-menu-item"
+                                            >
+                                                <Link
+                                                    href={href}
+                                                    aria-current={
+                                                        url.split('?')[0] ===
+                                                        href
+                                                            ? 'page'
+                                                            : undefined
                                                     }
                                                 >
-                                                    {t(group.label)}
-                                                    <ChevronDown
-                                                        size={14}
+                                                    {t(label)}
+                                                </Link>
+                                            </DropdownMenuItem>
+                                        ),
+                                    )}
+                                    <DropdownMenuSeparator />
+                                    <DropdownMenuLabel className="text-xs text-slate-500">
+                                        Revista Tempo
+                                    </DropdownMenuLabel>
+                                    {tempoSocialLinks.map(
+                                        ({ name, href, icon: Icon }) => (
+                                            <DropdownMenuItem
+                                                key={name}
+                                                asChild
+                                                className="tempo-menu-item"
+                                            >
+                                                <a
+                                                    href={href}
+                                                    target="_blank"
+                                                    rel="noopener noreferrer"
+                                                    aria-label={`Revista Tempo — ${name}`}
+                                                >
+                                                    <Icon
+                                                        size={16}
                                                         aria-hidden="true"
                                                     />
-                                                    {current === group.id && (
-                                                        <span className="sr-only">
-                                                            Grupo actual
-                                                        </span>
-                                                    )}
-                                                </DropdownMenuTrigger>
-                                                <DropdownMenuContent
-                                                    align="start"
-                                                    sideOffset={8}
-                                                    collisionPadding={12}
-                                                    className="tempo-dropdown max-h-[min(75vh,36rem)] w-72 max-w-[calc(100vw-1.5rem)] overflow-y-auto p-2"
-                                                >
-                                                    {items(
-                                                        group.children ?? [],
-                                                    )}
-                                                </DropdownMenuContent>
-                                            </DropdownMenu>
-                                        </li>
-                                    ))}
-                            </ul>
-                        </nav>
-                        <Link
-                            href="/manifestar-interesse"
-                            className="tempo-interest-button"
-                        >
-                            {t('Manifestar interesse')}
-                        </Link>
+                                                    {name}
+                                                    <ArrowUpRight
+                                                        size={12}
+                                                        aria-hidden="true"
+                                                    />
+                                                </a>
+                                            </DropdownMenuItem>
+                                        ),
+                                    )}
+                                </DropdownMenuContent>
+                            </DropdownMenu>
+                        </li>
+                    </ul>
+                </nav>
+                <div id={toolsId} className="tempo-header-extras">
+                    <div className="tempo-header-utilities">
+                        <div className="flex items-center gap-1">
+                            <TempoWeather />
+                            <TempoLanguageSelector />
+                        </div>
                     </div>
                 </div>
+                <div className="tempo-header-actions">
+                    <Link
+                        href="/investidor/manifestacoes"
+                        className="tempo-panel-summary"
+                        aria-label={panelLabel}
+                        title={panelLabel}
+                    >
+                        <LayoutDashboard size={19} aria-hidden="true" />
+                        <span className="tempo-panel-count" aria-hidden="true">
+                            {requestCount}
+                        </span>
+                    </Link>
+                    <span
+                        className="sr-only"
+                        role="status"
+                        aria-live="polite"
+                        aria-atomic="true"
+                    >
+                        {panelLabel}
+                    </span>
+                    {props.auth?.user ? (
+                        <DropdownMenu modal={false}>
+                            <DropdownMenuTrigger className="tempo-login-button">
+                                <UserRound size={16} aria-hidden="true" />
+                                <span className="max-w-24 truncate">
+                                    {props.auth.user.name || t('A minha área')}
+                                </span>
+                                <ChevronDown size={12} aria-hidden="true" />
+                            </DropdownMenuTrigger>
+                            <DropdownMenuContent
+                                align="end"
+                                sideOffset={12}
+                                collisionPadding={12}
+                                className="tempo-dropdown max-h-[75vh] w-72 max-w-[calc(100vw-1.5rem)] overflow-y-auto p-2"
+                            >
+                                <DropdownMenuLabel className="truncate text-xs text-slate-500">
+                                    {props.auth.user.email}
+                                </DropdownMenuLabel>
+                                {items(accountGroups)}
+                                <DropdownMenuSeparator />
+                                <DropdownMenuItem
+                                    asChild
+                                    className="tempo-menu-item text-red-700"
+                                >
+                                    <Link
+                                        href={logout()}
+                                        as="button"
+                                        type="button"
+                                        disabled={loggingOut}
+                                        data-test="portal-logout-button"
+                                        onClick={() => router.flushAll()}
+                                        onStart={() => setLoggingOut(true)}
+                                        onFinish={() => setLoggingOut(false)}
+                                    >
+                                        <LogOut size={16} aria-hidden="true" />
+                                        {loggingOut
+                                            ? 'A terminar sessão…'
+                                            : t('Terminar sessão')}
+                                    </Link>
+                                </DropdownMenuItem>
+                            </DropdownMenuContent>
+                        </DropdownMenu>
+                    ) : (
+                        <Link href="/login" className="tempo-login-button">
+                            <UserRound size={15} aria-hidden="true" />
+                            {t('Entrar')}
+                        </Link>
+                    )}
+                </div>
+                <Link
+                    id={interestId}
+                    href="/manifestar-interesse"
+                    className="tempo-interest-button"
+                >
+                    {t('Manifestar interesse')}
+                    <ArrowUpRight size={15} aria-hidden="true" />
+                </Link>
+                <button
+                    ref={toggle}
+                    type="button"
+                    className="tempo-header-toggle"
+                    aria-label={
+                        expanded
+                            ? 'Fechar menu e ferramentas'
+                            : 'Abrir menu e ferramentas'
+                    }
+                    aria-expanded={expanded}
+                    aria-controls={`${navigationId} ${toolsId} ${interestId}`}
+                    onClick={() => setExpanded(!expanded)}
+                >
+                    {expanded ? (
+                        <X size={22} aria-hidden="true" />
+                    ) : (
+                        <Menu size={22} aria-hidden="true" />
+                    )}
+                </button>
             </div>
         </header>
     );

resources/js/components/private-investment-preparation.tsx

@@ -0,0 +1,457 @@
+import { Link } from '@inertiajs/react';
+import { card, input } from '@/pages/investment/shared';
+
+export type PreparationDocument = {
+    document_id: string;
+    file_name: string;
+    status: string;
+    malware_scan_status: string;
+};
+export type Preparation = {
+    version: string;
+    enabled: boolean;
+    mode: string;
+    period_covered: boolean;
+    scope_covered: boolean;
+    reason: string[];
+    missing_fields: string[];
+    missing_labels?: string[];
+    authority: string;
+    next: string;
+    calculation_notice: string;
+    notice: string;
+    source: { url: string; sha256: string };
+    authority_source: { reference: string; url: string };
+    questions: Array<{
+        key: string;
+        label: string;
+        type?: string;
+        options?: Record<string, string>;
+        when?: { field: string; equals: string };
+        source: string;
+        help?: string;
+    }>;
+    requirements: Array<{
+        key: string;
+        label: string;
+        state: string;
+        required: boolean;
+        document_id: string | null;
+        document: PreparationDocument | null;
+        stage: string;
+        reason: string;
+        source: { reference: string; url: string; period: string };
+    }>;
+};
+const states: Record<string, string> = {
+    not_applicable: 'Não aplicável neste contexto',
+    indeterminate: 'Informação em falta para decidir',
+    missing: 'Documento por associar',
+    associated: 'Documento associado — conteúdo por conferir',
+};
+export const preparationMode = (mode: string) =>
+    ({
+        authorization: 'Pedido de autorização',
+        registration: 'Pedido de mero registo',
+        indeterminate: 'Enquadramento por determinar',
+    })[mode] ?? mode;
+
+export function PreparationSummary({
+    data,
+    caseId,
+}: {
+    data: Preparation | null | undefined;
+    caseId?: string;
+}) {
+    if (!data) return null;
+    return (
+        <section
+            id="private-investment-preparation"
+            className={card + ' space-y-3'}
+            aria-label="Preparação adaptada do investimento privado"
+        >
+            <h2 className="text-xl font-bold">
+                Preparar o pedido de investimento privado
+            </h2>
+            {!data.enabled ? (
+                <p>
+                    Use os dados deste dossier para identificar o pedido e os
+                    documentos aplicáveis. A preparação é opcional e não atribui
+                    benefícios.
+                </p>
+            ) : (
+                <>
+                    <p>
+                        <strong>{preparationMode(data.mode)}</strong> · recorte
+                        de 2026 ·{' '}
+                        {data.version.replace(
+                            'private-investment-preparation-',
+                            '',
+                        )}
+                    </p>
+                    <p>{data.next}</p>
+                    {data.missing_fields.length > 0 && (
+                        <p>
+                            Informação em falta:{' '}
+                            {(
+                                data.missing_labels ??
+                                data.missing_fields.map(
+                                    (key) =>
+                                        data.questions?.find(
+                                            (q) => q.key === key,
+                                        )?.label ??
+                                        (
+                                            {
+                                                currency: 'Moeda do projecto',
+                                                expected_start_date:
+                                                    'Data prevista de início',
+                                                entity_stage:
+                                                    'Situação da entidade',
+                                            } as Record<string, string>
+                                        )[key] ??
+                                        key,
+                                )
+                            ).join('; ')}
+                            .
+                        </p>
+                    )}
+                    {!data.period_covered && (
+                        <p>
+                            Este incremento cobre pedidos com início previsto em
+                            2026. Uma data em falta ou fora desse recorte não
+                            permite determinar o pedido por este lote; os
+                            restantes trabalhos do dossier continuam
+                            disponíveis.
+                        </p>
+                    )}
+                    {!data.scope_covered && (
+                        <p>
+                            Declare a actividade efectiva. Prospecção,
+                            pesquisa/produção extractiva e investimento público
+                            ou exclusivamente social/sem fins lucrativos seguem
+                            enquadramentos próprios, fora deste lote.
+                        </p>
+                    )}
+                    {data.reason.map((reason) => (
+                        <p key={reason}>{reason}</p>
+                    ))}
+                    <p>
+                        Encaminhamento indicativo: {data.authority}.{' '}
+                        <a
+                            className="underline"
+                            href={data.authority_source.url}
+                        >
+                            {data.authority_source.reference}
+                        </a>
+                    </p>
+                    <ul className="space-y-3">
+                        {data.requirements
+                            .filter((r) => r.state !== 'not_applicable')
+                            .map((r) => (
+                                <li key={r.key} className="rounded border p-3">
+                                    <strong>{r.label}</strong> —{' '}
+                                    {states[r.state]}.{' '}
+                                    {r.document?.file_name && (
+                                        <span>
+                                            Ficheiro: {r.document.file_name}
+                                            .{' '}
+                                        </span>
+                                    )}
+                                    <p>
+                                        {r.reason}{' '}
+                                        <a
+                                            className="underline"
+                                            href={r.source.url}
+                                        >
+                                            Ver fundamento: {r.source.reference}
+                                        </a>{' '}
+                                        · {r.source.period}.
+                                    </p>
+                                    {caseId && (
+                                        <Link
+                                            className="underline"
+                                            href={`/investimentos/${caseId}/contexto/editar#preparation-documents`}
+                                        >
+                                            Rever dados ou associar documento do
+                                            dossier
+                                        </Link>
+                                    )}
+                                </li>
+                            ))}
+                    </ul>
+                    <details>
+                        <summary>
+                            Exigências que não se aplicam — histórico preservado
+                        </summary>
+                        {data.requirements
+                            .filter((r) => r.state === 'not_applicable')
+                            .map((r) => (
+                                <p key={r.key}>
+                                    {r.label}: {r.reason}{' '}
+                                    {r.document_id && (
+                                        <>
+                                            Associação anterior mantida
+                                            {r.document?.file_name
+                                                ? `: ${r.document.file_name}`
+                                                : ''}
+                                            .
+                                        </>
+                                    )}{' '}
+                                    <a
+                                        className="underline"
+                                        href={r.source.url}
+                                    >
+                                        {r.source.reference}
+                                    </a>
+                                </p>
+                            ))}
+                    </details>
+                    <p>{data.calculation_notice}</p>
+                    <p>{data.notice}</p>
+                </>
+            )}
+            <a className="underline" href={data.source.url}>
+                Consultar o exemplar oficial e os fundamentos
+            </a>
+            {caseId && (
+                <p>
+                    <Link
+                        className="underline"
+                        href={`/investimentos/${caseId}/contexto/editar#preparation-questions`}
+                    >
+                        Completar apenas os dados em falta ou editar declarações
+                    </Link>
+                </p>
+            )}
+        </section>
+    );
+}
+
+export function PreparationEditor({
+    data,
+    fields,
+    changes,
+    documents,
+    links,
+    onChange,
+    onLink,
+    disabled,
+}: {
+    data: Preparation;
+    fields: Record<string, string>;
+    changes: Record<string, string>;
+    documents: PreparationDocument[];
+    links: Record<string, string | null>;
+    onChange: (key: string, value: string) => void;
+    onLink: (key: string, value: string | null) => void;
+    disabled: boolean;
+}) {
+    const values = { ...fields, ...changes };
+    const active = values.investment_preparation === 'yes';
+    const excluded = ['extractive', 'public_nonprofit'].includes(
+        values.investment_activity_scope,
+    );
+    const applicable = (q: Preparation['questions'][number]) =>
+        !q.when || values[q.when.field] === q.when.equals;
+    // Keep a field in place while the user edits it; collapse only recovered answers.
+    const known = (q: Preparation['questions'][number]) =>
+        !!fields[q.key] && fields[q.key] !== 'unknown';
+    const render = (q: Preparation['questions'][number]) => (
+        <label className="grid gap-1" key={q.key} htmlFor={'prep-' + q.key}>
+            {q.label}
+            {q.options ? (
+                <select
+                    id={'prep-' + q.key}
+                    className={input}
+                    disabled={disabled}
+                    value={values[q.key] ?? ''}
+                    onChange={(e) => onChange(q.key, e.target.value)}
+                >
+                    <option value="">Por indicar</option>
+                    {Object.entries(q.options).map(([value, text]) => (
+                        <option key={value} value={value}>
+                            {text}
+                        </option>
+                    ))}
+                </select>
+            ) : (
+                <input
+                    id={'prep-' + q.key}
+                    className={input}
+                    disabled={disabled}
+                    type="text"
+                    inputMode="decimal"
+                    value={values[q.key] ?? ''}
+                    onChange={(e) => onChange(q.key, e.target.value)}
+                />
+            )}
+            <span className="text-sm">
+                {q.help} Fundamento: {q.source}.
+            </span>
+        </label>
+    );
+    const questions = data.questions.filter(
+        (q) =>
+            q.key !== 'investment_preparation' &&
+            applicable(q) &&
+            (!excluded || q.key === 'investment_activity_scope'),
+    );
+    const needed = questions.filter(
+        (q) =>
+            !known(q) &&
+            (!data.enabled ||
+                data.mode !== 'authorization' ||
+                data.missing_fields.includes(q.key)),
+    );
+    return (
+        <section
+            id="preparation-questions"
+            className={card + ' space-y-4'}
+            aria-label="Dados do pedido de investimento privado"
+        >
+            <h2 className="text-xl font-bold">
+                Dados em falta para preparar o pedido
+            </h2>
+            <p>
+                Valores conhecidos são reutilizados. As alterações só são
+                gravadas depois da comparação de impacto. Nacionalidade e
+                residência não determinam a origem do capital nem a modalidade
+                da empresa.
+            </p>
+            {render(data.questions[0])}
+            {active && (
+                <>
+                    {needed.map(render)}
+                    <details>
+                        <summary>
+                            Dados já declarados — consultar ou alterar
+                        </summary>
+                        <div className="space-y-3">
+                            {questions.filter(known).map(render)}
+                        </div>
+                    </details>
+                    <p>
+                        Data, moeda e situação da entidade usam as declarações
+                        acima.{' '}
+                        {data.missing_fields.filter((k) =>
+                            [
+                                'currency',
+                                'expected_start_date',
+                                'entity_stage',
+                            ].includes(k),
+                        ).length > 0 &&
+                            'Complete esses campos em falta antes de comparar.'}
+                    </p>
+                    <div id="preparation-documents" className="space-y-3">
+                        <h3 className="font-bold">
+                            Associar documentos já existentes no dossier
+                        </h3>
+                        <p>
+                            Carregue documentos pelo Balcão Virtual do mesmo
+                            dossier. A associação não aprova o conteúdo nem
+                            substitui a análise do pedido.
+                        </p>
+                        {data.requirements
+                            .filter((r) => r.required)
+                            .map((r) => (
+                                <label className="grid gap-1" key={r.key}>
+                                    {r.label}
+                                    <select
+                                        className={input}
+                                        disabled={disabled}
+                                        value={
+                                            Object.hasOwn(links, r.key)
+                                                ? (links[r.key] ?? '')
+                                                : (r.document_id ?? '')
+                                        }
+                                        onChange={(e) =>
+                                            onLink(
+                                                r.key,
+                                                e.target.value || null,
+                                            )
+                                        }
+                                    >
+                                        <option value="">Por associar</option>
+                                        {documents.map((doc) => (
+                                            <option
+                                                key={doc.document_id}
+                                                value={doc.document_id}
+                                            >
+                                                {doc.file_name} ·{' '}
+                                                {{
+                                                    quarantined:
+                                                        'Em quarentena',
+                                                    active: 'Disponível',
+                                                    deleted: 'Removido',
+                                                }[doc.status] ??
+                                                    'Estado por conferir'}
+                                            </option>
+                                        ))}
+                                    </select>
+                                    <span>
+                                        {r.reason}{' '}
+                                        <a
+                                            className="underline"
+                                            href={r.source.url}
+                                        >
+                                            {r.source.reference}
+                                        </a>
+                                    </span>
+                                </label>
+                            ))}
+                    </div>
+                </>
+            )}
+            <p>
+                Compare o impacto para actualizar o enquadramento, as perguntas
+                e as exigências. Uma exigência que deixe de ser aplicável
+                conserva o documento anterior no histórico.
+            </p>
+        </section>
+    );
+}
+
+export function PreparationImpact({
+    before,
+    after,
+}: {
+    before: Preparation;
+    after: Preparation;
+}) {
+    return (
+        <div
+            className="space-y-2 rounded border border-amber-400 p-3"
+            aria-label="Impacto no pedido de investimento"
+        >
+            <h3 className="font-bold">Impacto no pedido e nos documentos</h3>
+            <p>
+                {preparationMode(before.mode)} → {preparationMode(after.mode)}.
+            </p>
+            <p>Próximo passo: {after.next}.</p>
+            <ul className="list-disc pl-5">
+                {after.requirements
+                    .filter(
+                        (r) =>
+                            before.requirements.find((b) => b.key === r.key)
+                                ?.state !== r.state,
+                    )
+                    .map((r) => (
+                        <li key={r.key}>
+                            {r.label}:{' '}
+                            {
+                                states[
+                                    before.requirements.find(
+                                        (b) => b.key === r.key,
+                                    )?.state ?? 'indeterminate'
+                                ]
+                            }{' '}
+                            → {states[r.state]}.{' '}
+                            {r.document_id && 'Vínculo documental preservado.'}
+                        </li>
+                    ))}
+            </ul>
+            <p>{after.calculation_notice}</p>
+            <PreparationSummary data={after} />
+        </div>
+    );
+}

resources/js/components/simulation-business-plan.tsx

@@ -95,7 +95,7 @@ function MoneyInput({
 }
 
 export function SimulationBusinessPlan({
-    currency,
+    currency: projectCurrency,
     snapshot,
     onCurrencyChange,
     onSnapshotChange,
@@ -253,8 +253,10 @@ export function SimulationBusinessPlan({
     const plan = workingPlan ??
         restoreBusinessPlanSnapshot(snapshot) ?? {
             ...emptyPlan,
-            currency,
+            currency: projectCurrency,
         };
+    // A project edit is not a conversion or permission to relabel stored sales.
+    const currency = plan.currency || projectCurrency;
     const update = (
         key: keyof BusinessFinancialPlanInput,
         value:
@@ -858,6 +860,7 @@ export function SimulationBusinessPlan({
             <summary className="cursor-pointer text-lg font-semibold">
                 Plano financeiro empresarial (pressupostos editáveis)
             </summary>
+            {plan.currency && projectCurrency && plan.currency !== projectCurrency && <p role="alert">A projecção guardada está em {plan.currency}; o projecto está em {projectCurrency}. Os valores e a moeda de origem foram preservados. Reveja o enquadramento monetário antes de os reutilizar; não foi feita conversão.</p>}
             {snapshotError && (
                 <p
                     role="alert"

resources/js/components/simulation-cashflow-planner.tsx

@@ -156,7 +156,7 @@ export function SimulationCashflowPlanner({
                 </label>
                 {taxMode === 'fixed' ? (
                     <label className="block max-w-xs text-sm font-medium">
-                        Imposto assumido por mês
+                        Imposto manual do cenário personalizado por mês
                         <input
                             type="number"
                             min="0"
@@ -175,7 +175,7 @@ export function SimulationCashflowPlanner({
                     <div className="grid gap-3 sm:grid-cols-2 lg:grid-cols-4">
                         {inputs.monthlyTaxSchedule.map((value, index) => (
                             <label key={index} className="text-sm font-medium">
-                                Imposto assumido — mês {index + 1}
+                                Imposto manual do cenário personalizado — mês {index + 1}
                                 <input
                                     type="number"
                                     min="0"

resources/js/components/simulation-fiscal-status.tsx

@@ -1,5 +1,6 @@
 import { useEffect, useState } from 'react';
 import { fiscalComponentCodes } from '@/lib/simulation-contract';
+import { ivaIssueText, type IvaDiagnostic, type IvaIssue } from '@/lib/iva-diagnostics';
 
 type Parameter = {
     parameter_code: string;
@@ -56,6 +57,8 @@ export function SimulationFiscalStatus({
     periodStart,
     periodEnd,
     context,
+    onDiagnostics,
+    onCorrect,
 }: {
     salaryView?: string;
     scenarioMode?: string;
@@ -63,8 +66,11 @@ export function SimulationFiscalStatus({
     periodStart?: string;
     periodEnd?: string;
     context?: Record<string, string>;
+    onDiagnostics?: (issues: IvaIssue[]) => void;
+    onCorrect?: (field: string) => void;
 }) {
     const [parameters, setParameters] = useState<Parameter[]>([]);
+    const [diagnostics, setDiagnostics] = useState<IvaDiagnostic[]>([]);
     const [requestState, setRequestState] = useState('idle');
     const [retry, setRetry] = useState(0);
 
@@ -79,10 +85,14 @@ export function SimulationFiscalStatus({
             !periodEnd
         ) {
             setParameters([]);
+            setDiagnostics([]);
+            onDiagnostics?.([]);
             setRequestState('idle');
             return;
         }
         const abort = new AbortController();
+        setDiagnostics([]);
+        onDiagnostics?.([]);
         setRequestState('loading');
         void fetch('/api/v1/tax-parameters/resolve', {
             method: 'POST',
@@ -104,11 +114,15 @@ export function SimulationFiscalStatus({
                 if (!response.ok) throw new Error('lookup_failed');
                 const payload = (await response.json()) as {
                     parameters?: Parameter[];
+                    diagnostics?: IvaDiagnostic[];
                 };
                 if (abort.signal.aborted) return;
                 setParameters(
                     Array.isArray(payload.parameters) ? payload.parameters : [],
                 );
+                const details = Array.isArray(payload.diagnostics) ? payload.diagnostics : [];
+                setDiagnostics(details);
+                onDiagnostics?.(details.flatMap((detail) => detail.issues));
                 setRequestState('done');
             })
             .catch((error: unknown) => {
@@ -158,7 +172,7 @@ export function SimulationFiscalStatus({
                     {requestState === 'loading'
                         ? 'A consultar parâmetros aprovados para o período e âmbito indicados…'
                         : requestState === 'error'
-                          ? 'Não foi possível consultar os parâmetros; o resultado permanece indeterminado.'
+                          ? 'Falha na consulta do sistema: não foi possível obter os parâmetros. O problema não é atribuído às respostas; estas foram preservadas. Tente novamente.'
                           : !periodStart || !periodEnd
                             ? 'Indique um período exacto. Para periodicidade mensal ou trimestral, seleccione o mês ou trimestre.'
                             : `Período consultado: ${periodStart} a ${periodEnd}.`}
@@ -186,6 +200,22 @@ export function SimulationFiscalStatus({
                     {salaryViewMessages[salaryView]}
                 </p>
             )}
+            {diagnostics.length > 0 && <div role="alert" className="space-y-3 rounded border border-amber-700 p-3">
+                <h4 className="font-semibold">IVA — taxa geral: condições não satisfeitas</h4>
+                <p>Não foi possível resolver este parâmetro. As respostas foram preservadas; esta consulta não executa o cálculo do imposto.</p>
+                {diagnostics.map((detail, index) => <div key={index}>
+                    <ul className="list-disc pl-5">{detail.issues.map((issue, issueIndex) => <li key={issueIndex}>
+                        {ivaIssueText(issue)}{' '}
+                        {issue.field && <a className="underline" href={`#field-${issue.field}`} onClick={(event) => { if (onCorrect) { event.preventDefault(); onCorrect(issue.field!); } }}>Rever {issue.label.toLowerCase()}</a>}
+                        {issue.category === 'system_configuration' && issue.field === 'fiscal_operation' && <a className="ml-2 underline" href="#published-iva">Abrir IVA — taxa geral</a>}
+                    </li>)}</ul>
+                    <details className="mt-2"><summary className="cursor-pointer underline">Ver fundamento</summary>
+                        <p>IVA — taxa geral · versão {detail.rule_version}. Vigência: {detail.validity.start} a {detail.validity.end ?? 'sem data final indicada'}.</p>
+                        <p>{detail.source.title} — {detail.source.diploma}, {detail.source.article}</p>
+                        {detail.source.url?.startsWith('https://') && <a className="underline" href={detail.source.url} target="_blank" rel="noreferrer">Consultar fonte</a>}
+                    </details>
+                </div>)}
+            </div>}
             <ul className="grid gap-2 sm:grid-cols-2 lg:grid-cols-3">
                 {fiscalComponentCodes.map((code) => {
                     const selected =
@@ -211,13 +241,13 @@ export function SimulationFiscalStatus({
                                 </p>
                             ) : parameters.length === 0 ? (
                                 <p className="text-sm">
-                                    Indeterminado — nenhum parâmetro publicado
+                                    {code === 'IVA' ? 'Indeterminado — não existe uma versão elegível visível nesta consulta. Consulte o diagnóstico do período acima, quando disponível. Sem esse diagnóstico, não é possível distinguir ausência de cobertura de indisponibilidade da regra ou da fonte; não se atribui o problema às suas respostas.' : <>Indeterminado — nenhum parâmetro publicado
                                     aplicável. Faltam parâmetros aprovados para{' '}
                                     {code}, no período {periodStart} a{' '}
                                     {periodEnd} e no âmbito indicado. A consulta
                                     não identifica um conjunto obrigatório de
                                     parâmetros; não é possível determinar o
-                                    imposto nem substituir as lacunas por zero.
+                                    imposto nem substituir as lacunas por zero.</>}
                                 </p>
                             ) : (
                                 <div className="space-y-2 text-sm">
@@ -227,7 +257,7 @@ export function SimulationFiscalStatus({
                                             className="border-t pt-2"
                                         >
                                             <strong>
-                                                {parameter.parameter_code}
+                                                {parameter.parameter_code === 'IVA_GENERAL_RATE' ? 'IVA — taxa geral' : parameter.parameter_code}
                                             </strong>
                                             {parameter.status === 'resolved' ? (
                                                 <>
@@ -238,10 +268,10 @@ export function SimulationFiscalStatus({
                                                     </p>
                                                     <p>
                                                         Regra{' '}
-                                                        {parameter.rule_code} v
+                                                        {parameter.parameter_code === 'IVA_GENERAL_RATE' ? 'IVA — taxa geral' : parameter.rule_code} v
                                                         {parameter.rule_version}
                                                         ; âmbito{' '}
-                                                        {parameter.scope_key}
+                                                        {parameter.parameter_code === 'IVA_GENERAL_RATE' ? 'operação interna geral sobre base líquida em MZN' : parameter.scope_key}
                                                     </p>
                                                     <p>
                                                         Vigência:{' '}
@@ -279,13 +309,13 @@ export function SimulationFiscalStatus({
                                                             target="_blank"
                                                             rel="noreferrer"
                                                         >
-                                                            Consultar fundamento
+                                                            Ver fundamento
                                                         </a>
                                                     )}
                                                 </>
                                             ) : (
                                                 <p>
-                                                    {labels[parameter.status] ??
+                                                    {(parameter.parameter_code === 'IVA_GENERAL_RATE' && diagnostics.length ? 'Consulte acima cada condição e o fundamento da versão.' : labels[parameter.status]) ??
                                                         'Indeterminado — não foi possível validar o parâmetro.'}
                                                 </p>
                                             )}

resources/js/components/simulation-form.tsx

@@ -1,4 +1,6 @@
 import { SimulationPublishedIva, type PublishedIvaInput } from './simulation-published-iva';
+import { SimulationMonthlyIva } from './simulation-monthly-iva';
+import { inheritSimulatorFields } from '@/lib/context-inheritance';
 import {
     PublicDocumentContent,
     type PublicDocument,
@@ -56,6 +58,7 @@ import { SimulationFinancialTools } from '@/components/simulation-financial-tool
 import { SimulationCashflowPlanner } from '@/components/simulation-cashflow-planner';
 import { SimulationBusinessPlan } from '@/components/simulation-business-plan';
 import { SimulationFiscalStatus } from '@/components/simulation-fiscal-status';
+import { ivaIssueText, type IvaIssue } from '@/lib/iva-diagnostics';
 import {
     ProjectMilestonePlanner,
     ProjectTeamPlanner,
@@ -776,7 +779,7 @@ function SearchChoice({
 
 export function SimulationForm() {
     const { auth } = usePage<{
-        auth: { user: { email_verified_at?: string | null } | null };
+        auth: { user: { id: number; email_verified_at?: string | null } | null };
     }>().props;
     const pageUrl = usePage().url;
     const draftContext = useMemo(() => {
@@ -788,11 +791,12 @@ export function SimulationForm() {
         };
     }, [pageUrl]);
     const contextId = draftContext.context;
-    const storageScope = contextId
+    const projectScope = contextId
         ? `:case:${contextId}`
         : draftContext.requestedDraft
           ? `:draft:${draftContext.requestedDraft}`
           : '';
+    const storageScope = `${auth?.user ? `:account:${auth.user.id}` : ':anonymous'}${projectScope}`;
     const draftKey = legacyDraftKey + storageScope;
     const draftCreateKey = legacyDraftCreateKey + storageScope;
     const draftIdKey = legacyDraftIdKey + storageScope;
@@ -804,12 +808,14 @@ export function SimulationForm() {
     const canAssociateDraft = Boolean(auth?.user?.email_verified_at);
     const [draft, setDraft] = useState<SimulationDraft>({});
     const [ready, setReady] = useState(false);
+    useEffect(() => { if (ready) setDraft(current => inheritSimulatorFields(current)); }, [draft, ready]);
     const [contextReview, setContextReview] = useState({
         revision: 0,
         reviewed: false,
     });
     const [step, setStep] = useState(0);
     const [errors, setErrors] = useState<Record<string, string>>({});
+    const [ivaIssues, setIvaIssues] = useState<IvaIssue[]>([]);
     const [serverFieldErrors, setServerFieldErrors] = useState<
         Record<string, string>
     >({});
@@ -1936,6 +1942,7 @@ export function SimulationForm() {
     ) {
         if (!ready) return;
         setContinueLaterSaved(false);
+        setIvaIssues((previous) => previous.filter((issue) => issue.field !== key));
         setServerFieldErrors((previous) => {
             const next = { ...previous };
             delete next[key];
@@ -2308,12 +2315,14 @@ export function SimulationForm() {
                 );
             }
             if (!publishedInput) sessionStorage.removeItem(idempotencyStorageKey);
+            return simulation ?? null;
         } catch (cause) {
             setServerError(
                 cause instanceof Error
                     ? cause.message
                     : 'Erro de ligação. Tente novamente.',
             );
+            return null;
         } finally {
             calculationInFlightRef.current = false;
             setIsCalculating(false);
@@ -3285,6 +3294,7 @@ export function SimulationForm() {
                                   : Boolean(field.required);
                         const fieldError =
                             serverFieldErrors[field.key] ?? errors[field.key];
+                        const ivaNotes = ivaIssues.filter((issue) => issue.field === field.key).map((issue, index) => <p key={index} role="note" className="mt-1 text-sm text-amber-950">{ivaIssueText(issue)}</p>);
                         if (field.options) {
                             const parentKey =
                                 field.key === 'district_id'
@@ -3331,6 +3341,7 @@ export function SimulationForm() {
                                         }
                                     />
                                     <FieldGuidance fieldKey={field.key} />
+                                    {ivaNotes}
                                 </div>
                             );
                         }
@@ -3405,6 +3416,7 @@ export function SimulationForm() {
                                         {fieldError}
                                     </p>
                                 )}
+                                {ivaNotes}
                                 {field.key === 'reduction' && (
                                     <p className="mt-1 text-sm text-slate-600">
                                         Hipótese sua, não representa um
@@ -3457,15 +3469,16 @@ export function SimulationForm() {
                 {(current.id === 'financial' ||
                     (draft.purpose === 'simulate_only' &&
                         current.id === 'tax')) && (
-                    <SimulationCashflowPlanner
+                    <details className="rounded border p-3"><summary>Cenário personalizado de tesouraria — imposto manual, separado do IVA calculado</summary><SimulationCashflowPlanner
                         snapshot={String(draft.cashflow_snapshot ?? '')}
                         onSnapshotChange={(value) =>
                             change('cashflow_snapshot', value)
                         }
                         currency={String(draft.currency ?? '')}
                         onCurrencyChange={(value) => change('currency', value)}
-                    />
+                    /></details>
                 )}
+                {(current.id === 'financial' || current.id === 'tax') && <SimulationMonthlyIva draft={draft} busy={isCalculating} onCalculate={runSimulation} onChange={change} />}
                 {current.id === 'financial' &&
                     (draft.detail_level === 'advanced' ||
                         draft.journey_type === 'small_business') &&
@@ -3601,7 +3614,7 @@ export function SimulationForm() {
                             }
                         />
                     )}
-                {current.id === 'tax' && <SimulationPublishedIva busy={isCalculating} onCalculate={runSimulation} />}
+                {current.id === 'tax' && <SimulationPublishedIva draft={draft} onChange={change} busy={isCalculating} onCalculate={runSimulation} />}
                 {current.id === 'tax' && (
                     <div
                         id="draft-tool-fiscal"
@@ -3609,6 +3622,12 @@ export function SimulationForm() {
                         aria-label="Consulta de parâmetros fiscais"
                     >
                         <SimulationFiscalStatus
+                            onDiagnostics={setIvaIssues}
+                            onCorrect={(key) => {
+                                const target = journeySections.findIndex((section) => (simulationFieldGroups[section.id] ?? []).some((field) => field.key === key));
+                                if (target >= 0) setStep(target);
+                                window.requestAnimationFrame(() => document.getElementById(`field-${key}`)?.focus());
+                            }}
                             salaryView={String(draft.irps_salary_view ?? '')}
                             scenarioMode={
                                 openedTool === 'fiscal'
@@ -3618,7 +3637,7 @@ export function SimulationForm() {
                             component={String(draft.fiscal_component ?? '')}
                             periodStart={getFiscalPeriodRange(draft)?.start}
                             periodEnd={getFiscalPeriodRange(draft)?.end}
-                            context={Object.fromEntries(
+                            context={{ ...Object.fromEntries(
                                 [
                                     'fiscal_periodicity',
                                     'fiscal_operation',
@@ -3635,7 +3654,7 @@ export function SimulationForm() {
                                         ? [[key, draft[key] as string]]
                                         : [],
                                 ),
-                            )}
+                            ), ...(typeof draft.fiscal_currency === 'string' && draft.fiscal_currency !== '' ? {currency: draft.fiscal_currency} : {}) }}
                         />
                     </div>
                 )}

resources/js/components/simulation-modelo-a.tsx

@@ -0,0 +1,24 @@
+import { modeloAFields, modeloAPurchaseReferences, modeloAReference } from '@/lib/iva-modelo-a';
+
+export function SimulationModeloA({draft}: {draft:Record<string,unknown>}) {
+    let purchases: ReturnType<typeof modeloAPurchaseReferences> = [];
+    let error = '';
+    try { purchases = modeloAPurchaseReferences(draft); }
+    catch (cause) { error = cause instanceof Error ? cause.message : 'Não foi possível consultar as aquisições projectadas.'; }
+    return <section aria-label="Correspondência com o Modelo A" className="space-y-3 rounded border p-3">
+        <h4 className="font-semibold">Modelo A — correspondência da simulação</h4>
+        <p>{modeloAReference.status}</p>
+        <p>Os campos 14–18 do apuramento permanecem indeterminados. O IVA das vendas não é imposto final a pagar. Os dados deste percurso são projecções, separados de facturas e declarações efectivas.</p>
+        <details><summary>Aquisições já projectadas — sem dedução presumida</summary>
+            <p>Reutilizam-se os valores das compras/encomendas para existências do plano. O mês da encomenda não prova a data da factura, recepção ou pagamento. Valores declarados ainda sem indicação de base líquida/IVA incluído não são tratados como base tributável. IVA suportado e IVA dedutível continuam por determinar; zero de compras não prova inexistência de outras aquisições.</p>
+            {error && <p role="alert">{error}</p>}
+            {!purchases.length && !error && <p>Sem agenda de compras recuperável do plano empresarial.</p>}
+            {!!purchases.length && <div className="overflow-x-auto"><table className="min-w-full text-sm"><caption>Pressupostos actuais de compras; sem resultado fiscal guardado</caption><thead><tr>{['Mês do plano','Compras declaradas','Sem IVA','IVA suportado','Com IVA','IVA dedutível'].map((name)=><th className="p-2 text-left" key={name}>{name}</th>)}</tr></thead><tbody>{purchases.map((row)=><tr key={row.month}><th className="p-2" scope="row">{row.month}</th><td>{row.declared ?? 'Sem informação'}</td><td>Por classificar</td><td>Indeterminado</td><td>Por classificar</td><td>Indeterminado</td></tr>)}</tbody></table></div>}
+        </details>
+        <details><summary>Ver campos, cálculos, fundamentos e cobertura do Modelo A</summary>
+            <p>{modeloAReference.file}. {modeloAReference.edition} SHA256: {modeloAReference.sha256}.</p>
+            <p>O exemplar contém divergências de numeração/remissões, registadas no confronto documental. Não foram corrigidas no original. A existência de um campo não activa uma regra fiscal.</p>
+            <div className="overflow-x-auto"><table className="min-w-full text-sm"><caption>Campo do Modelo A → finalidade → origem → cálculo → fundamento → cobertura</caption><thead><tr>{['Campo','Finalidade','Origem dos dados','Cálculo','Fundamento','Estado'].map((name)=><th className="p-2 text-left" key={name}>{name}</th>)}</tr></thead><tbody>{modeloAFields.map((field)=><tr key={field.field}>{[field.field,field.purpose,field.origin,field.calculation,field.basis,field.status].map((value,index)=><td className="border-t p-2 align-top" key={index}>{value}</td>)}</tr>)}</tbody></table></div>
+        </details>
+    </section>;
+}

resources/js/components/simulation-monthly-iva.tsx

@@ -0,0 +1,83 @@
+import { InvestmentContextAssessment } from './investment-context-assessment';
+import { useEffect, useRef, useState } from 'react';
+import { monthlyIvaInput, monthlyIvaKey, monthlySalesFromDraft, readMonthlyIvaRecord, readMonthlyIvaSettings, monthlyIvaCashTreatment, type MonthlyIvaInput, type MonthlyIvaSettings } from '@/lib/monthly-iva';
+import { fiscalQaRows } from '@/lib/fiscal-qa-preview';
+import { isApiSimulationReadResponseV1, type ApiSimulationExecutionV1 } from '@/lib/simulation-contract';
+import { SimulationModeloA } from './simulation-modelo-a';
+
+export function SimulationMonthlyIva({draft, busy, onCalculate, onChange}: {
+    draft: Record<string, unknown>; busy: boolean;
+    onCalculate: (input: MonthlyIvaInput) => Promise<ApiSimulationExecutionV1 | null | undefined>;
+    onChange: (field: string, value: string) => void;
+}) {
+    const settings = readMonthlyIvaSettings(String(draft.monthly_iva_settings ?? ''));
+    const record = readMonthlyIvaRecord(String(draft.monthly_iva_snapshot ?? ''));
+    const [retry, setRetry] = useState(0);
+    const [error, setError] = useState('');
+    const [available, setAvailable] = useState<boolean | null>(null);
+    const attempt = useRef('');
+    const callbacks = useRef({onCalculate, onChange}); callbacks.current = {onCalculate, onChange};
+    let input: MonthlyIvaInput | null = null; let inputError = ''; let source = '';
+    try { source = monthlySalesFromDraft(draft).source; input = monthlyIvaInput(draft, settings); }
+    catch (cause) { inputError = cause instanceof Error ? cause.message : 'Reveja a projecção de vendas.'; }
+    const key = input ? monthlyIvaKey(input) : '';
+    const current = !!(input && record && monthlyIvaKey(record.input) === key);
+    const completed = current && record?.execution.status === 'completed';
+    const saveSettings = (patch: Partial<MonthlyIvaSettings>) => onChange('monthly_iva_settings', JSON.stringify({...settings, ...patch}));
+    useEffect(() => {
+        let active = true;
+        fetch('/api/v1/fiscal-consumer', {credentials: 'same-origin', headers: {Accept:'application/json'}}).then(async (response) => {
+            if (!response.ok) throw new Error(); const payload = await response.json(); if (active) setAvailable(payload?.data?.enabled === true);
+        }).catch(() => {if (active) setError('Não foi possível consultar a disponibilidade da regra. As vendas foram preservadas.');});
+        return () => { active = false; };
+    }, [retry]);
+    useEffect(() => {
+        if (!settings.auto || !input || input.currency !== 'MZN' || busy || !available || completed || attempt.current === key) return;
+        const request = input;
+        const pending = current && record && ['queued','running'].includes(record.execution.status) ? record.execution.id : null;
+        const timer = window.setTimeout(() => {
+            attempt.current = key; setError('');
+            void (async () => {
+                try {
+                    let execution;
+                    if (pending) {
+                        const response = await fetch(`/api/v1/simulations/${pending}`, {credentials:'same-origin', headers:{Accept:'application/json'}});
+                        const value: unknown = await response.json();
+                        if (!response.ok || !isApiSimulationReadResponseV1(value)) throw new Error('Não foi possível recuperar a execução mensal guardada. Não foi criada uma execução alternativa.');
+                        execution = value.data;
+                    } else execution = await callbacks.current.onCalculate(request);
+                    if (!execution) throw new Error('O cálculo mensal não foi concluído. As vendas e a versão anterior foram preservadas; tente novamente.');
+                    callbacks.current.onChange('monthly_iva_snapshot', JSON.stringify({input:request, execution}));
+                } catch (cause) {setError(cause instanceof Error ? cause.message : 'Não foi possível calcular o IVA mensal.');}
+            })();
+        }, 700);
+        return () => window.clearTimeout(timer);
+    }, [key, settings.auto, busy, available, completed, retry]);
+
+    const snapshot = record?.execution.result_snapshot;
+    const projection = snapshot?.monthly_projection as {rows?: Array<{date:string; sales_declared:string|null; net_sales:string|null; rate:string|null; vat:string|null; gross_sales:string|null; status:string}>} | undefined;
+    return <section className="space-y-3 rounded border border-emerald-700 p-4" aria-label="IVA mensal das vendas projectadas">
+        <InvestmentContextAssessment raw={draft.context_applicability_snapshot} />
+        <h3 className="font-semibold">IVA mensal das vendas projectadas</h3>
+        <p>{source}</p><p>Declare se os preços projectados são sem IVA ou com IVA incluído. Nenhuma taxa é fixada neste formulário; o servidor selecciona a versão publicada.</p>
+        <label className="block">Primeiro mês da projecção<input type="month" value={settings.start} min="2026-01" max="2026-12" onChange={(event) => saveSettings({start:event.target.value})} className="block rounded border p-2" /></label>
+        <label className="block">Tratamento do IVA nos preços projectados<select value={settings.basis} onChange={(event) => saveSettings({basis:event.target.value as MonthlyIvaSettings['basis']})} className="block rounded border p-2"><option value="unknown">Por indicar</option><option value="net">Vendas sem IVA (base líquida)</option><option value="included">Vendas com IVA incluído</option></select></label>
+        <label className="block"><input type="checkbox" checked={settings.declared} onChange={(event) => saveSettings({declared:event.target.checked})} /> Declaro que as vendas projectadas são tributáveis à taxa geral interna e não incluem as operações excluídas deste lote.</label>
+        <p className="text-sm">Sem importações, taxas reduzidas, isenções, regimes especiais, deduções, reembolsos ou apuramento final. Valores com IVA incluído permanecem indeterminados neste lote; não se aplica a taxa ao preço bruto.</p>
+        <p className="text-sm">{monthlyIvaCashTreatment}</p>
+        {!!draft.currency && draft.currency !== "MZN" && <p role="alert">Moeda do projecto: {String(draft.currency)}. A regra disponível aceita apenas MZN. As vendas e a moeda são preservadas, sem conversão; o IVA mensal não pode ser determinado por esta versão.</p>}
+        {inputError && <p role="alert">{inputError}</p>}
+        {available === null && !error && <p role="status">A consultar a disponibilidade da versão publicada…</p>}
+        {available === false && <p role="status">A versão publicada de IVA está indisponível neste ambiente para novas execuções. Os pressupostos e históricos mantêm-se.</p>}
+        {record && !current && <p role="alert">As vendas ou os pressupostos mudaram. Os resultados abaixo são históricos e estão desactualizados; não são usados como resultados da projecção actual.</p>}
+        {settings.auto && !completed && current && <p role="status">Execução mensal guardada: {record?.execution.status === 'queued' ? 'em fila' : record?.execution.status === 'running' ? 'em processamento' : 'não concluída'}. Pode voltar a consultar sem duplicar.</p>}
+        {busy && <p role="status">A actualizar os resultados dependentes das vendas…</p>}
+        {error && <p role="alert">{error}</p>}
+        <button type="button" disabled={busy || !available || !input || input.currency !== 'MZN'} onClick={() => {attempt.current=''; setRetry((value) => value+1); saveSettings({auto:true});}} className="rounded bg-emerald-800 p-2 text-white disabled:opacity-50">Calcular / actualizar IVA mensal e guardar versão</button>
+        {settings.auto && <button type="button" className="ml-3 underline" onClick={() => saveSettings({auto:false})}>Pausar actualização automática</button>}
+        {input && <p className="text-sm">{input.monthly_sales.length} meses; moeda {input.currency || 'por indicar'}. Campo vazio significa informação em falta; zero declarado permanece zero. Depois da primeira execução, alterações das vendas actualizam o cálculo enquanto a actualização automática estiver ligada.</p>}
+        {projection?.rows && <div className="overflow-x-auto" tabIndex={0}><table className="min-w-full text-sm"><caption>IVA mensal — {current ? 'versão correspondente às entradas' : 'versão histórica'}</caption><thead><tr>{['Mês','Vendas declaradas','Vendas tributáveis sem IVA','Taxa aplicada (%)','IVA calculado','Total com IVA','Estado'].map((label) => <th key={label} className="p-2 text-left">{label}</th>)}</tr></thead><tbody>{projection.rows.map((row) => <tr key={row.date}><th scope="row" className="p-2">{row.date.slice(0,7)}</th><td>{row.sales_declared ?? 'Sem informação'}</td><td>{row.net_sales ?? 'Indeterminado'}</td><td>{row.rate ?? 'Indeterminada'}</td><td>{row.vat ?? 'Indeterminado'}</td><td>{row.gross_sales ?? 'Indeterminado'}</td><td>{{calculated:'Calculado',missing_sales:'Sem informação de vendas',unsupported_basis:'Base líquida não determinada',indeterminate:'Enquadramento ou regra indeterminados'}[row.status] ?? 'Indeterminado'}</td></tr>)}</tbody></table></div>}
+        {snapshot && <details><summary>Ver fundamento e relatório da versão guardada</summary><dl>{fiscalQaRows(snapshot).map(([label,value], index) => <div key={index}><dt className="font-semibold">{label}</dt><dd>{value}</dd></div>)}</dl></details>}
+        <SimulationModeloA draft={draft} />
+    </section>;
+}

resources/js/components/simulation-published-iva.tsx

@@ -1,6 +1,7 @@
 import { useEffect, useState } from 'react';
+import type { MonthlyIvaInput } from '@/lib/monthly-iva';
 
-export type PublishedIvaInput = {
+export type PublishedIvaInput = MonthlyIvaInput | {
     scenario_kind: 'fiscal_rule_published';
     base: string;
     currency: 'MZN';
@@ -9,16 +10,22 @@ export type PublishedIvaInput = {
     scope_declared: boolean;
 };
 
-export function SimulationPublishedIva({ busy, onCalculate }: {
+export function SimulationPublishedIva({ busy, onCalculate, draft, onChange }: {
+    draft: Record<string, unknown>;
+    onChange: (field: string, value: string) => void;
     busy: boolean;
-    onCalculate: (input: PublishedIvaInput) => Promise<void>;
+    onCalculate: (input: PublishedIvaInput) => Promise<unknown>;
 }) {
     const [available, setAvailable] = useState(false);
     const [message, setMessage] = useState('A consultar disponibilidade do cálculo de IVA…');
-    const [base, setBase] = useState('');
-    const [date, setDate] = useState('');
-    const [currency, setCurrency] = useState('');
-    const [declared, setDeclared] = useState(false);
+    const base = String(draft.published_iva_base ?? '');
+    const date = String(draft.published_iva_date ?? '');
+    const currency = String(draft.published_iva_currency ?? '');
+    const declared = draft.published_iva_scope === 'yes';
+    const setBase = (value: string) => onChange('published_iva_base', value);
+    const setDate = (value: string) => onChange('published_iva_date', value);
+    const setCurrency = (value: string) => onChange('published_iva_currency', value);
+    const setDeclared = (value: boolean) => onChange('published_iva_scope', value ? 'yes' : 'no');
     const [error, setError] = useState('');
     useEffect(() => {
         let active = true;
@@ -51,18 +58,19 @@ export function SimulationPublishedIva({ busy, onCalculate }: {
         } catch { /* The execution flow already preserves and reports connection errors. */ }
     }
 
-    return <section aria-label="IVA geral sobre base líquida" className="space-y-3 rounded border border-emerald-700 p-4">
-        <h4 className="font-semibold">IVA geral sobre base líquida</h4>
+    return <section id="published-iva" tabIndex={-1} aria-label="IVA — taxa geral" className="space-y-3 rounded border border-emerald-700 p-4">
+        <h4 className="font-semibold">IVA — taxa geral</h4>
         <p role="status">{message}</p>
         <p className="text-sm">Cobertura: exigibilidade em 2026, operação interna à taxa geral. A base tributável é indicada por si; não é copiada do orçamento. Sem isenções, taxas reduzidas, bases especiais, importações, deduções, declaração ou pagamento. O cálculo não valida o enquadramento jurídico.</p>
         <fieldset disabled={busy} className="space-y-3">
             <label className="block">Base tributável líquida (decimal, com ponto)<input aria-label="Base tributável líquida" inputMode="decimal" value={base} onChange={(e) => setBase(e.target.value)} className="block rounded border p-2" /></label>
-            <label className="block">Moeda da base<select aria-label="Moeda da base IVA" value={currency} onChange={(e) => setCurrency(e.target.value)} className="block rounded border p-2"><option value="">Seleccione</option><option value="MZN">MZN</option></select></label>
+            <label className="block">Moeda da base<select aria-label="Moeda da base IVA" value={currency} onChange={(e) => setCurrency(e.target.value)} className="block rounded border p-2"><option value="">Seleccione</option><option value="MZN">MZN</option>{currency && currency !== "MZN" && <option value={currency}>{currency} — moeda declarada</option>}</select></label>
             <label className="block">Data de exigibilidade declarada<input aria-label="Data de exigibilidade IVA" type="date" min="2026-01-01" max="2026-12-31" value={date} onChange={(e) => setDate(e.target.value)} className="block rounded border p-2" /></label>
             <label className="block"><input type="checkbox" checked={declared} onChange={(e) => setDeclared(e.target.checked)} /> Declaro operação interna à taxa geral, base líquida já apurada e ausência das excepções acima.</label>
             <p className="text-sm">Sem esta declaração, o resultado fica indeterminado. O valor calculado conserva a precisão decimal; não é saldo a pagar.</p>
             <button type="button" disabled={!available || busy} onClick={() => void calculate()} className="rounded bg-emerald-800 px-4 py-2 text-white disabled:opacity-50">{busy ? 'A calcular…' : 'Calcular IVA e gravar'}</button>
         </fieldset>
+        {currency && currency !== "MZN" && <p role="alert">Moeda: {currency}. A versão disponível aceita apenas MZN. O valor declarado foi preservado; não foi feita conversão. Este cálculo permanece indisponível para esta moeda.</p>}
         {error && <p role="alert">{error}</p>}
     </section>;
 }

resources/js/components/tempo-footer.tsx

@@ -10,14 +10,16 @@ const navigation = [
 
 export function TempoFooter() {
     const { t, language } = useTempoUi();
-    const { portalInstitutionalContactEmail } = usePage<{ portalInstitutionalContactEmail?: string | null }>().props;
+    const { portalInstitutionalContactEmail } = usePage<{
+        portalInstitutionalContactEmail?: string | null;
+    }>().props;
     return (
         <footer
             className="tempo-footer border-t border-white/5"
             lang={language}
         >
-            <div className="mx-auto grid max-w-7xl grid-cols-1 gap-12 px-6 py-10 md:grid-cols-2 lg:grid-cols-5 lg:gap-16 lg:px-12">
-                <div className="space-y-8">
+            <div className="mx-auto grid max-w-7xl grid-cols-1 gap-6 px-6 py-6 md:grid-cols-2 lg:grid-cols-5 lg:gap-8 lg:px-12">
+                <div className="space-y-4">
                     <Link
                         href="/"
                         aria-label="InvesteMoz — início"
@@ -37,9 +39,9 @@ export function TempoFooter() {
                         </address>
                     </div>
                 </div>
-                <div className="space-y-8">
+                <div className="space-y-4">
                     <h2 className="tempo-footer-heading">{t('Contactos')}</h2>
-                    <div className="space-y-5">
+                    <div className="space-y-2">
                         {[
                             ['+258868010880', '+258 86 801 0880'],
                             ['+258833219644', '+258 83 321 9644'],
@@ -58,21 +60,26 @@ export function TempoFooter() {
                             </a>
                         ))}
                         <a
-                            href={portalInstitutionalContactEmail ? `mailto:${portalInstitutionalContactEmail}` : '/apoio'}
+                            href={
+                                portalInstitutionalContactEmail
+                                    ? `mailto:${portalInstitutionalContactEmail}`
+                                    : '/apoio'
+                            }
                             className="tempo-contact-link"
                         >
                             <span className="tempo-contact-icon">
                                 <Mail size={16} aria-hidden="true" />
                             </span>
-<strong className="min-w-0 text-sm font-medium [overflow-wrap:anywhere]">
-                                {portalInstitutionalContactEmail ?? t('Apoio ao investidor')}
+                            <strong className="min-w-0 text-[13px] leading-5 font-medium [overflow-wrap:anywhere]">
+                                {portalInstitutionalContactEmail ??
+                                    t('Apoio ao investidor')}
                             </strong>
                         </a>
                     </div>
                 </div>
-                <nav aria-label="Navegação do rodapé" className="space-y-8">
+                <nav aria-label="Navegação do rodapé" className="space-y-4">
                     <h2 className="tempo-footer-heading">{t('Navegação')}</h2>
-                    <ul className="space-y-4">
+                    <ul className="space-y-2">
                         {navigation.map(([href, label]) => (
                             <li key={href}>
                                 <Link href={href} className="tempo-footer-link">
@@ -86,9 +93,9 @@ export function TempoFooter() {
                         ))}
                     </ul>
                 </nav>
-                <nav aria-label="Informação legal" className="space-y-8">
+                <nav aria-label="Informação legal" className="space-y-4">
                     <h2 className="tempo-footer-heading">Legal</h2>
-                    <ul className="space-y-4">
+                    <ul className="space-y-2">
                         {[
                             [
                                 'politica-de-privacidade',
@@ -111,7 +118,7 @@ export function TempoFooter() {
                         ))}
                     </ul>
                 </nav>
-                <div className="space-y-8">
+                <div className="space-y-4">
                     <h2 className="tempo-footer-heading">Social</h2>
                     <p className="text-xs leading-relaxed font-medium text-slate-300">
                         {t(
@@ -121,8 +128,8 @@ export function TempoFooter() {
                     <TempoSocialLinks footer />
                 </div>
             </div>
-            <div className="border-t border-white/10 py-2">
-                <div className="mx-auto flex max-w-7xl flex-col items-center justify-between gap-6 px-6 text-center text-[10px] tracking-[0.2em] text-slate-400 md:flex-row md:text-left md:text-xs">
+            <div className="border-t border-white/10 py-1.5">
+                <div className="mx-auto flex max-w-7xl flex-col items-center justify-between gap-1 px-6 text-center text-[10px] tracking-[0.1em] text-slate-400 md:flex-row md:text-left md:text-[11px]">
                     <p>
                         © {new Date().getFullYear()}{' '}
                         <span className="text-[#ed1c24]">Tempo</span>.{' '}

resources/js/layouts/portal-navigation.tsx

@@ -1,4 +1,5 @@
 import SearchFeedback from '@/components/search-feedback';
+import { searchTerritoryHref } from '@/lib/search-territory';
 import { Link, usePage } from '@inertiajs/react';
 import { createContext, useContext } from 'react';
 import { PortalGroupedMenu } from '@/components/portal-grouped-menu';
@@ -148,7 +149,7 @@ export default function PortalNavigation({
                                     {parent && (
                                         <>
                                             <Link
-                                                href={parent}
+                                                href={searchTerritoryHref(parent, url)}
                                                 className="underline"
                                             >
                                                 {names[parent]}

resources/js/lib/business-financial-plan.ts

@@ -776,6 +776,37 @@ function multiplyQuantity(
     return (quantityMilli * unitPriceCents + 500n) / 1000n;
 }
 
+/** Reuses the sales model, without requiring unrelated cost/cash assumptions. Blank is never zero. */
+export function monthlyProjectedSales(input: BusinessFinancialPlanInput): Array<string | null> {
+    const periods = input.periods ?? 12;
+    if (!Number.isInteger(periods) || periods < 1 || periods > 60) throw new Error('Horizonte de vendas inválido.');
+    return Array.from({ length: periods }, (_, month) => {
+        if (!input.products.length) return null;
+        let total = 0n;
+        for (const product of input.products) {
+            const units = product.monthlyUnitsByPeriod === undefined ? product.monthlyUnits : product.monthlyUnitsByPeriod[month];
+            const price = product.unitPriceByPeriod === undefined ? product.unitPrice : product.unitPriceByPeriod[month];
+            if (typeof units !== 'string' || typeof price !== 'string' || units.trim() === '' || price.trim() === '') return null;
+            total += multiplyQuantity(quantity(units), cents(price, `Preço de ${product.label}`));
+        }
+        return format(total);
+    });
+}
+
+/** Existing purchase orders are planning references, never a proxy for deductible VAT or invoice dates. */
+export function monthlyProjectedPurchaseOrders(input: BusinessFinancialPlanInput): Array<string | null> {
+    const periods = input.periods ?? 12;
+    if (!Number.isInteger(periods) || periods < 1 || periods > 60) throw new Error('Horizonte de compras inválido.');
+    return Array.from({length: periods}, (_, month) => {
+        const amounts = input.useProductInventorySchedule
+            ? input.products.map((product) => product.productInventoryPurchasesByPeriod?.[month]?.amount)
+            : [input.useInventoryPurchaseSchedule
+                ? input.inventoryPurchaseSchedule?.[month]?.amount : input.monthlyInventoryPurchases];
+        if (!amounts.length || amounts.some((amount) => typeof amount !== 'string' || amount.trim() === '')) return null;
+        return format(amounts.reduce((total, amount) => total + cents(amount!, 'Compras projectadas'), 0n));
+    });
+}
+
 function format(centsValue: bigint): string {
     const absolute = centsValue < 0n ? -centsValue : centsValue;
     return `${centsValue < 0n ? '-' : ''}${absolute / 100n}.${String(absolute % 100n).padStart(2, '0')}`;

resources/js/lib/catalogue-context.ts

@@ -1,3 +1,4 @@
+import { searchTerritoryHref } from './search-territory.ts';
 /** Only a query string is carried; the return destination is always local. */
 export function catalogueDetailHref(path: string, query: string): string {
     return query
@@ -8,5 +9,5 @@ export function catalogueReturnHref(base: string, pageUrl: string): string {
     const query = new URL(pageUrl, 'https://portal.invalid').searchParams.get(
         'catalogue_query',
     );
-    return base + (query ? `?${new URLSearchParams(query).toString()}` : '');
+    return searchTerritoryHref(base + (query ? `?${new URLSearchParams(query).toString()}` : ''), pageUrl);
 }

resources/js/lib/context-inheritance.ts

@@ -0,0 +1,68 @@
+import { restoreBusinessPlanSnapshot } from './business-financial-plan.ts';
+const empty = (value: unknown) => value == null || value === '' || (Array.isArray(value) && value.length === 0);
+function canonical(value: unknown): unknown {
+    if (Array.isArray(value)) return value.map(canonical);
+    if (value && typeof value === 'object') return Object.fromEntries(Object.entries(value).sort(([a],[b])=>a.localeCompare(b)).map(([key,item])=>[key,canonical(item)]));
+    return value;
+}
+// Change tracking only, never an authorization, integrity or legal-acceptance token. No personal values in metadata.
+function signature(value: unknown): string {
+    const text=JSON.stringify(canonical(value)) ?? 'undefined';let hash=14695981039346656037n;
+    for(let index=0;index<text.length;index++) hash=BigInt.asUintN(64,(hash^BigInt(text.charCodeAt(index)))*1099511628211n);
+    return `${text.length}:${hash.toString(16)}`;
+}
+export function inheritCompatibleFields(scope:string, values:Record<string,unknown>, source:Record<string,unknown>, raw:unknown, allowed?:string[]): {patch:Record<string,unknown>; metadata:string; inherited:string[]; conflicts:string[]} {
+    let previous:Record<string,string>={};
+    try { const saved=JSON.parse(String(raw ?? ''));if(saved.version===1 && saved.scope===scope && saved.inherited && typeof saved.inherited==='object') previous=saved.inherited; } catch { /* Legacy inputs are retained, not overwritten. */ }
+    const next={...previous};const patch:Record<string,unknown>={};const inherited:string[]=[];const conflicts:string[]=[];
+    const geo=['province_id','district_id','admin_post_id','locality_id'];
+    const geoConflict=geo.some(key=>(!empty(values[key]) || key in previous) && signature(values[key])!==signature(source[key]) && previous[key]!==signature(values[key]));
+    for(const [key,value] of Object.entries(source)) {
+        if ((allowed && !allowed.includes(key)) || (empty(value) && !(key in previous))) continue;
+        const current=values[key];
+        const track = (item:unknown) => key==='parcels' ? Object.fromEntries(geo.map(field=>[field,(item as Array<Record<string,unknown>>)?.[0]?.[field] ?? ''])) : item;
+        const owned=previous[key]===signature(track(current));
+        const vacant=key==='parcels' ? geo.every(field=>empty((current as Array<Record<string,unknown>>)?.[0]?.[field])) : empty(current);
+        if ((geo.includes(key) && geoConflict) || (!owned && (!vacant || key in previous))) {
+            if(signature(current)!==signature(value)) conflicts.push(key);
+            continue;
+        }
+        if(key==='parcels') {
+            const parcels=current as Array<Record<string,unknown>>|undefined;
+            if(!owned && parcels?.length && geo.some(field=>!empty(parcels[0]?.[field]))) {conflicts.push(key);continue;}
+        }
+        if(signature(track(current))!==signature(track(value))) {
+            if(key==='parcels') {
+                const parcels=(current as Array<Record<string,unknown>>) ?? [];
+                patch[key]=[{...parcels[0],...Object.fromEntries(geo.map(field=>[field,(value as Array<Record<string,unknown>>)[0]?.[field] ?? '']))},...parcels.slice(1)];
+            } else patch[key]=value;
+        }
+        next[key]=signature(track(value));inherited.push(key);
+    }
+    return {patch,metadata:JSON.stringify({version:1,scope,inherited:next}),inherited,conflicts};
+}
+
+export function inheritSimulatorFields<T extends Record<string,unknown>>(draft:T): T {
+    const source:Record<string,unknown>={};
+    const plan=draft.business_plan_snapshot ? restoreBusinessPlanSnapshot(String(draft.business_plan_snapshot)) : null;
+    if(plan?.currency) source.currency=plan.currency;
+    const currency=draft.currency || source.currency;
+    if(currency) {source.fiscal_currency=currency;source.opportunity_currency=currency;source.published_iva_currency=currency;}
+    if(draft.tax_residency_country) source.fiscal_residency_country=draft.tax_residency_country;
+    if(draft.fiscal_reference_date) source.published_iva_date=draft.fiscal_reference_date;
+    let settings:Record<string,unknown>={start:'',basis:'unknown',declared:false,auto:false};
+    let settingsValid=!draft.monthly_iva_settings;
+    try {const saved=JSON.parse(String(draft.monthly_iva_settings ?? ''));if(saved && !Array.isArray(saved) && typeof saved.start==='string' && ['net','included','unknown'].includes(saved.basis) && typeof saved.declared==='boolean' && typeof saved.auto==='boolean') {settings=saved;settingsValid=true;}} catch { /* Invalid stored inputs remain intact. */ }
+    const start=String(draft.expected_start_date ?? '');
+    if(/^\d{4}-\d{2}-\d{2}$/.test(start)) source.monthly_iva_start=start.slice(0,7);
+    else if(/^\d{4}$/.test(String(draft.fiscal_period)) && draft.fiscal_periodicity==='monthly' && /^(0?[1-9]|1[0-2])$/.test(String(draft.fiscal_month))) source.monthly_iva_start=`${draft.fiscal_period}-${String(draft.fiscal_month).padStart(2,'0')}`;
+    if(!settingsValid) delete source.monthly_iva_start;
+    // Legacy drafts without a compatible source need no inheritance marker or autosave churn.
+    if (!Object.keys(source).length && !draft.compatible_fields_snapshot) return draft;
+    const values={...draft,monthly_iva_start:settings.start ?? ''};
+    const patch=inheritCompatibleFields('simulator-compatible-fields',values,source,draft.compatible_fields_snapshot);
+    const next:Record<string,unknown>={...draft,...patch.patch,compatible_fields_snapshot:patch.metadata};
+    if('monthly_iva_start' in patch.patch) next.monthly_iva_settings=JSON.stringify({...settings,start:patch.patch.monthly_iva_start});
+    delete next.monthly_iva_start;
+    return JSON.stringify(next)===JSON.stringify(draft) ? draft : next as T;
+}

resources/js/lib/fiscal-qa-preview.ts

@@ -1,4 +1,5 @@
 import { isApiSimulationResultSnapshotV1 } from "./simulation-contract.ts";
+import { modeloAComponentRows } from './iva-modelo-a.ts';
 
 export function fiscalQaRows(value: unknown): Array<[string, string]> {
     if (!isApiSimulationResultSnapshotV1(value)) return [];
@@ -19,7 +20,14 @@ export function fiscalQaRows(value: unknown): Array<[string, string]> {
         typeof item === "string" || typeof item === "number"
             ? String(item)
             : "não disponível";
+    const monthly = snapshot.monthly_projection as {rows?: Array<Record<string,unknown>>; cash_treatment?: string} | undefined;
     return [
+        ...modeloAComponentRows(snapshot),
+        ...(monthly?.rows ? [
+            ["Projecção mensal", "Vendas tributáveis sem IVA → taxa aplicada → IVA calculado → total com IVA; não é apuramento final"],
+            ...monthly.rows.map((row) => [`Mês ${text(row.date)}`, `Vendas declaradas: ${text(row.sales_declared)}; base líquida: ${text(row.net_sales)}; taxa: ${row.rate == null ? 'não aplicada' : `${text(row.rate)}%`}; IVA: ${text(row.vat)}; total com IVA: ${text(row.gross_sales)}; ${row.status === 'calculated' ? 'calculado' : row.status === 'missing_sales' ? 'sem informação de vendas' : row.status === 'unsupported_basis' ? 'base líquida não determinada' : 'enquadramento ou regra indeterminados'}`]),
+            ["Tratamento na tesouraria", monthly.cash_treatment ?? "IVA separado; não é custo nem imposto a pagar"],
+        ] as Array<[string,string]> : []),
         ["Relatório", published ? "IVA pela versão publicada; ver enquadramento abaixo" : "Pré-visualização fiscal QA de rascunho — sem activação"],
         [
             "IVA calculado (exacto; não é saldo a pagar)",
@@ -29,7 +37,7 @@ export function fiscalQaRows(value: unknown): Array<[string, string]> {
         ["Base tributável declarada", text(snapshot.base)],
         ["Taxa cadastrada (%)", text(parameters?.IVA_GENERAL_RATE?.value)],
         ["Moeda explícita", text(value.context.currency)],
-        ["Data de exigibilidade declarada", value.context.reference_date],
+        [monthly ? "Início da projecção mensal" : "Data de exigibilidade declarada", value.context.reference_date],
         [
             "Enquadramento",
             provenance?.scope_status === "undetermined" ? "Indeterminado: falta declaração do enquadramento" : "Declarado pelo utilizador; não validado juridicamente",

resources/js/lib/investor-context.ts

@@ -1,3 +1,7 @@
+import type {
+    Preparation,
+    PreparationDocument,
+} from '@/components/private-investment-preparation';
 function csrfToken(): string {
     return decodeURIComponent(
         document.cookie
@@ -56,6 +60,8 @@ export type DossierContext = {
     dependency_hash?: string;
 };
 export type ContextView = {
+    private_investment?: Preparation | null;
+    preparation_documents?: PreparationDocument[];
     simulator_context_revision?: number | null;
     case: { id: string; title: string; version: number };
     context: DossierContext;
@@ -73,6 +79,7 @@ export type ContextView = {
     notice: string;
 };
 export type ContextPlan = {
+    private_investment?: { before: Preparation; after: Preparation } | null;
     preview_hash: string;
     version: number;
     revision: number;
@@ -119,6 +126,20 @@ export async function contextApi<T>(
     return data as T;
 }
 export const contextFieldNames: Record<string, string> = {
+    investment_form: 'Tipo do investimento',
+    investment_preparation: 'Preparação do pedido',
+    investment_activity_scope: 'Natureza da actividade',
+    implementation_mode: 'Modalidade da empresa',
+    capital_origin: 'Origem dos capitais',
+    site_tenure: 'Utilização das instalações',
+    project_concession: 'PPP ou concessão empresarial',
+    significant_implications: 'Implicações significativas',
+    land_extension: 'Extensão de terra',
+    forest_concession: 'Concessão florestal',
+    forest_concession_hectares: 'Área florestal em hectares',
+    total_investment: 'Valor total do investimento',
+    area_required: 'Área de terra requerida',
+    area_unit: 'Unidade da área',
     title: 'Título do investimento',
     territory_id: 'Localização documentada',
     location_source: 'Origem da localização',
@@ -134,4 +155,19 @@ export const contextFieldNames: Record<string, string> = {
     province: 'Província',
     district: 'Distrito',
     location: 'Localização',
+    currency: 'Moeda do projecto',
+    person_type: 'Tipo de pessoa',
+    fiscal_period: 'Ano fiscal',
+    fiscal_periodicity: 'Periodicidade',
+    fiscal_month: 'Mês fiscal',
+    fiscal_residency_country: 'País de residência fiscal declarado',
+    activity_id: 'Actividade',
+    project_type: 'Modalidade do investimento',
+    maturity_stage: 'Fase do investimento',
+    expected_start_date: 'Início previsto',
+    investor_origin: 'Origem do investidor',
+    entity_stage: 'Situação da entidade',
+    tax_residency_country: 'Residência fiscal declarada',
+    investment_regime: 'Enquadramento territorial consultado',
+    special_zone_id: 'ZEE, ZFI ou parque',
 };

resources/js/lib/iva-diagnostics.ts

@@ -0,0 +1,26 @@
+export type IvaIssue = {
+    category: 'missing_field' | 'invalid_value' | 'out_of_scope' | 'period_unavailable' | 'system_configuration';
+    field: string | null;
+    label: string;
+    received: unknown;
+    expected: string;
+    message: string;
+};
+export type IvaDiagnostic = {
+    label: string;
+    rule_version: number;
+    validity: { start: string; end: string | null };
+    source: { title?: string; diploma?: string; article?: string; url?: string };
+    issues: IvaIssue[];
+};
+export const ivaIssueCategories = {
+    missing_field: 'Campo em falta', invalid_value: 'Valor inválido', out_of_scope: 'Fora do âmbito',
+    period_unavailable: 'Regra indisponível para o período', system_configuration: 'Configuração do sistema',
+};
+export function ivaReceived(value: unknown): string {
+    const labels: Record<string, string> = { domestic: 'Operação interna', internal_general_net: 'Operação interna à taxa geral, sobre base líquida', import: 'Importação', export: 'Exportação', refund: 'Reembolso', unknown: 'Não sei', non_resident: 'Operação com não residente', other: 'Outra operação' };
+    return typeof value === 'string' && value !== '' ? (labels[value] ?? value) : 'Não recebido';
+}
+export function ivaIssueText(issue: IvaIssue): string {
+    return `${issue.label}: ${ivaIssueCategories[issue.category]}. Recebido: ${ivaReceived(issue.received)}. Esperado: ${issue.expected}. ${issue.message}`;
+}

resources/js/lib/iva-modelo-a.ts

@@ -0,0 +1,59 @@
+import { monthlyProjectedPurchaseOrders, restoreBusinessPlanSnapshot } from './business-financial-plan.ts';
+
+/** Correspondence to the Tempo exemplar, not an electronic AT declaration or a new tax ruleset. */
+export const modeloAReference = {
+    file: 'Novo Modelo A.docx',
+    sha256: '62c198e90d8c6792f7d5ccefc6386df2e4b6089573067d3a6e1eae7fc2b9572b',
+    edition: 'Edição/vigência do formulário não estabelecida; original preservado na biblioteca QA.',
+    status: 'Simulação parcial: campos 01/02. Não é declaração submetida ou aceite pela Autoridade Tributária.',
+};
+
+export type ModeloAField = { field: string; purpose: string; origin: string; calculation: string; basis: string; status: string };
+const pending = 'Em falta; não assumir zero';
+export const modeloAFields: ModeloAField[] = [
+    {field:'01',purpose:'Base das operações à taxa geral',origin:'Vendas mensais já projectadas, declaradas sem IVA e no âmbito geral',calculation:'Base líquida do mês',basis:'CIVA arts.15 e 17; Lei22/2022; regra publicada existente',status:'Implementado no âmbito declarado'},
+    {field:'02',purpose:'IVA à taxa geral',origin:'Resultado mensal congelado no servidor',calculation:'Campo01 × taxa da versão publicada /100',basis:'CIVA art.17(1); mesma regra/versionamento do consumidor',status:'Implementado; componente do apuramento'},
+    {field:'03',purpose:'Base de operações específicas à taxa reduzida',origin:'Operações separadas e enquadradas; ainda não recolhidas',calculation:'Base das operações elegíveis',basis:'Exemplar e CIVA art.17-A, aditado pela Lei22/2022; enquadramento a cadastrar',status:pending},
+    {field:'04',purpose:'IVA à taxa reduzida',origin:'Campo03 e futura versão fundamentada',calculation:'Campo03 × taxa reduzida aplicável; não activa pelo exemplar',basis:'CIVA art.17-A; âmbito/versão temporal a integrar',status:pending},
+    {field:'05',purpose:'Vendas isentas com direito à dedução',origin:'Vendas classificadas por operação e fundamento',calculation:'Soma das bases classificadas; sem taxa presumida',basis:'Exemplar; CIVA arts.9–14 e 18–20 a consolidar por operação',status:pending},
+    {field:'06',purpose:'Operações da alínea b), n.º1, art.18, conforme exemplar',origin:'Operações classificadas com referência verificada',calculation:'Soma separada; não inferir do nome do sector',basis:'Remissão do exemplar ao art.18(1)(b); cotejo do âmbito necessário',status:pending},
+    {field:'07',purpose:'Isentas sem direito à dedução',origin:'Vendas classificadas e uso das aquisições',calculation:'Soma das bases elegíveis',basis:'Exemplar; incidência/isenções e exclusões de dedução a fundamentar',status:pending},
+    {field:'08',purpose:'IVA dedutível — imobilizado',origin:'Aquisições/facturas de activos, não o valor global do investimento',calculation:'Apenas imposto elegível documentado',basis:'CIVA arts.18–21; art.18(2), Lei10/2025: documentos legais e fornecedor inscrito',status:pending},
+    {field:'09',purpose:'IVA dedutível — existências',origin:'Compras projectadas reutilizáveis; falta IVA, documento e elegibilidade',calculation:'IVA elegível das existências, não compras × taxa geral',basis:'CIVA arts.18–21; condições/exclusões, afectação e período',status:pending},
+    {field:'10',purpose:'IVA dedutível — outros bens/serviços',origin:'Aquisições discriminadas; despesas agregadas não provam IVA',calculation:'IVA elegível; excluir operações sem direito',basis:'CIVA arts.18–21; art.19(2), Lei10/2025, inclui exclusão das operações art.17-A',status:pending},
+    {field:'11',purpose:'IVA dedutível — importações',origin:'Documento aduaneiro legal e afectação; ainda não recolhidos',calculation:'Imposto aduaneiro elegível, não taxa sobre orçamento',basis:'CIVA art.18(2), Lei10/2025; demais condições/exclusões a cadastrar',status:pending},
+    {field:'12',purpose:'Regularizações a favor do sujeito passivo',origin:'Ajustamentos individualizados, documento e motivo',calculation:'Soma de regularizações elegíveis',basis:'Exemplar tem remissão interna 11/12 divergente das caixas12/13; fundamento por motivo por conferir',status:pending},
+    {field:'13',purpose:'Regularizações a favor do Estado',origin:'Ajustamentos individualizados, documento e motivo',calculation:'Soma separada das regularizações elegíveis',basis:'Mesma divergência; não corrigir o original nem inventar incidência',status:pending},
+    {field:'14',purpose:'Soma das bases do quadro de apuramento',origin:'Campos01,03,05,06,07 completos',calculation:'01+03+05+06+07',basis:'Fórmula impressa no exemplar; não é apenas vendas tributáveis',status:'Estrutura mapeada; total indeterminado'},
+    {field:'15',purpose:'Total a favor do sujeito passivo',origin:'Campos08–12 completos',calculation:'08+09+10+11+12',basis:'Fórmula do exemplar; depende de deduções/regularizações fundamentadas',status:'Estrutura mapeada; total indeterminado'},
+    {field:'16',purpose:'Total a favor do Estado',origin:'Campos02,04,13 completos',calculation:'02+04+13',basis:'Fórmula impressa no exemplar; 02 sozinho não equivale a16',status:'Estrutura mapeada; total indeterminado'},
+    {field:'17',purpose:'Diferença devedora antes de créditos anteriores',origin:'Totais15/16 completos',calculation:'16−15 quando16>15',basis:'Instrução do exemplar; não é automaticamente pagamento',status:'Indeterminado; sem consolidação completa'},
+    {field:'18',purpose:'Diferença credora antes de créditos anteriores',origin:'Totais15/16 completos',calculation:'15−16 quando15>16',basis:'Instrução do exemplar; não constitui reembolso reconhecido',status:'Indeterminado; sem consolidação completa'},
+    {field:'19',purpose:'Excesso a reportar do período anterior',origin:'Histórico fiscal anterior confirmado, separado de estimativas',calculation:'Crédito anterior utilizável; sem copiar crédito estimado',basis:'Quadro de utilização de créditos do exemplar; condições/prazo por conferir',status:pending},
+    {field:'20',purpose:'Créditos comunicados pelos serviços',origin:'Comunicação efectiva da Administração Fiscal',calculation:'Crédito efectivamente comunicado e utilizável',basis:'Exemplar; não converter pedido ou crédito estimado em comunicação',status:pending},
+    {field:'21',purpose:'Diferencial de declaração de substituição',origin:'Valores17/18 da declaração actual e da substituída',calculation:'Casos impressos no quadro9, com sinal devedor/credor',basis:'Exemplar; ligação às declarações efectivas e regras de substituição em falta',status:pending},
+    {field:'22',purpose:'IVA a entregar no contexto da declaração',origin:'Apuramento e créditos/substituição completos',calculation:'Não derivar apenas do campo02',basis:'Quadro10 do exemplar; procedimento aplicável por fundamentar',status:pending},
+    {field:'23',purpose:'Juros compensatórios',origin:'Factos e períodos que legalmente os determinem',calculation:'Sem taxa, mora ou obrigação presumidas',basis:'Quadro10; fundamento específico não analisado neste lote',status:pending},
+    {field:'24',purpose:'Importância a pagar',origin:'Campos22/23 completos',calculation:'22+23',basis:'Fórmula do exemplar; não é ordem nem execução de pagamento',status:pending},
+    {field:'25',purpose:'Crédito de imposto do quadro11',origin:'Apuramento completo e tratamento dos créditos anteriores',calculation:'Montante recuperável no contexto próprio, por fundamentar',basis:'Caixa25 confirmada visualmente no bloco de recuperação; condições por consolidar',status:pending},
+    {field:'26',purpose:'Reporte para período seguinte',origin:'Crédito utilizável e opção no quadro11',calculation:'Separado de pedido e recebimento',basis:'Quadro11; cotejo de condições/prazos e articulação19/20 necessário',status:pending},
+    {field:'27',purpose:'Pedido de reembolso',origin:'Crédito elegível e pedido, sem presumir reconhecimento/caixa',calculation:'Pedido distinto de aprovação e recebimento',basis:'Exemplar cita art.20; Lei10/2025 altera reembolsos no art.21. Divergência registada.',status:pending},
+];
+
+export function modeloAComponentRows(snapshot: Record<string, unknown>): Array<[string,string]> {
+    if (!snapshot.monthly_projection) return [];
+    return [
+        ['Correspondência Modelo A',modeloAReference.status],
+        ['Campos01/02', 'Base líquida e IVA mensal da versão publicada. Os restantes campos não foram presumidos iguais a zero.'],
+        ['Apuramento do período — campos14–18', 'Indeterminado: faltam componentes e enquadramentos do Modelo A. IVA das vendas não é imposto final a pagar.'],
+        ['Origem dos dados','Projecção do negócio; não são operações efectivas nem declaração fiscal.'],
+        ['Exemplar de referência',`${modeloAReference.file}; SHA256 ${modeloAReference.sha256}. ${modeloAReference.edition}`],
+    ];
+}
+
+export function modeloAPurchaseReferences(draft: Record<string, unknown>): Array<{month:number; declared:string|null; net:null; vat:null; gross:null; deductible:null}> {
+    if (!draft.business_plan_snapshot) return [];
+    const plan = restoreBusinessPlanSnapshot(String(draft.business_plan_snapshot));
+    if (!plan) throw new Error('Não foi possível recuperar as aquisições projectadas. O original guardado foi preservado.');
+    return monthlyProjectedPurchaseOrders(plan).map((amount, index) => ({month:index+1, declared:amount, net:null, vat:null, gross:null, deductible:null}));
+}

resources/js/lib/monthly-iva.ts

@@ -0,0 +1,51 @@
+import { monthlyProjectedSales, restoreBusinessPlanSnapshot } from './business-financial-plan.ts';
+import { restoreCashflowDraftSnapshot } from './monthly-cashflow.ts';
+import { isApiSimulationReadResponseV1, type ApiSimulationExecutionV1 } from './simulation-contract.ts';
+
+export type MonthlyIvaInput = {
+    scenario_kind: 'fiscal_rule_published';
+    monthly_sales: Array<{ date: string; amount: string | null }>;
+    sales_vat_basis: 'net' | 'included' | 'unknown';
+    currency: string;
+    scope_declared: boolean;
+};
+export type MonthlyIvaSettings = { start: string; basis: MonthlyIvaInput['sales_vat_basis']; declared: boolean; auto: boolean };
+export type MonthlyIvaRecord = { input: MonthlyIvaInput; execution: ApiSimulationExecutionV1 };
+export function readMonthlyIvaSettings(raw?: string): MonthlyIvaSettings {
+    try { const value = JSON.parse(raw ?? '');
+        if (typeof value.start === 'string' && ['net', 'included', 'unknown'].includes(value.basis) && typeof value.declared === 'boolean' && typeof value.auto === 'boolean') return value;
+    } catch { /* An invalid setting is not an invented business assumption. */ }
+    return {start: '', basis: 'unknown', declared: false, auto: false};
+}
+export function monthlySalesFromDraft(draft: Record<string, unknown>): { amounts: Array<string | null>; source: string } {
+    if (draft.business_plan_snapshot) {
+        const plan = restoreBusinessPlanSnapshot(String(draft.business_plan_snapshot));
+        if (!plan) throw new Error('Não foi possível recuperar a projecção de vendas. Os dados guardados não foram substituídos.');
+        if (draft.currency && plan.currency && draft.currency !== plan.currency) throw new Error(`A projecção de vendas está em ${plan.currency}, mas o projecto está em ${String(draft.currency)}. Reveja a moeda da projecção; os valores não foram convertidos nem reclassificados.`);
+        return {amounts: monthlyProjectedSales(plan), source: 'Vendas por produto e mês do plano empresarial; mesmos pressupostos e representação monetária da projecção de vendas.'};
+    }
+    if (draft.cashflow_snapshot) {
+        const saved = restoreCashflowDraftSnapshot(String(draft.cashflow_snapshot));
+        if (!saved) throw new Error('Não foi possível recuperar a receita projectada.');
+        return {amounts: Array.from({length: 12}, () => saved.inputs.monthlyRevenue.trim() === '' ? null : saved.inputs.monthlyRevenue), source: 'Receita mensal constante já declarada na projecção de tesouraria; confirme que corresponde a vendas tributáveis.'};
+    }
+    return {amounts: Array.from({length: 12}, () => null), source: 'Sem projecção de vendas guardada. Prepare as vendas no plano empresarial; não é necessário voltar a introduzi-las aqui.'};
+}
+export function monthlyIvaInput(draft: Record<string, unknown>, settings: MonthlyIvaSettings): MonthlyIvaInput {
+    const sales = monthlySalesFromDraft(draft);
+    if (!/^2026-(0[1-9]|1[0-2])$/.test(settings.start)) throw new Error('Indique o primeiro mês real da projecção. Este lote abrange apenas 2026.');
+    const start = Number(settings.start.slice(5));
+    if (sales.amounts.length > 12 || start + sales.amounts.length > 13) throw new Error('O horizonte ultrapassa a cobertura de 2026. Esta versão não calcula os meses fora desse período.');
+    return {scenario_kind: 'fiscal_rule_published', monthly_sales: sales.amounts.map((amount, index) => ({date: `2026-${String(start + index).padStart(2, '0')}-01`, amount})),
+        sales_vat_basis: settings.basis, currency: String(draft.currency ?? ''), scope_declared: settings.declared};
+}
+export function monthlyIvaKey(input: Omit<MonthlyIvaInput, 'scenario_kind'>): string {
+    return JSON.stringify([input.currency, input.sales_vat_basis, input.scope_declared, input.monthly_sales.map((row) => [row.date, row.amount])]);
+}
+export function readMonthlyIvaRecord(raw?: string): MonthlyIvaRecord | null {
+    try { const value = JSON.parse(raw ?? '');
+        if (value?.input?.scenario_kind === 'fiscal_rule_published' && Array.isArray(value.input.monthly_sales) && isApiSimulationReadResponseV1({data: value.execution})) return value;
+    } catch { /* Keep the stored value intact; no fallback fiscal result. */ }
+    return null;
+}
+export const monthlyIvaCashTreatment = 'IVA apresentado separadamente: não é somado novamente aos recebimentos declarados nem deduzido como custo ou imposto final a pagar. A tesouraria conserva os recebimentos e pagamentos introduzidos, antes de uma liquidação fiscal não apurada; não se presume cobrança integral das vendas no mesmo mês.';

resources/js/lib/portal-navigation.ts

@@ -444,7 +444,6 @@ export function portalNavigation(access: PortalNavAccess): PortalNavItem[] {
             id: 'discovery',
             label: 'Descoberta',
             children: [
-                link('home', 'Início', '/'),
                 link(
                     'idea-entry',
                     'Partir de uma ideia',

resources/js/lib/project-dossier-report.ts

@@ -173,6 +173,7 @@ const rowSection: Record<string, DossierReportSectionId> = {
     'Ponto de equilíbrio': 'finance',
     Orçamento: 'finance',
     Tesouraria: 'finance',
+    'IVA mensal': 'finance',
     Equipa: 'team',
     'Necessidade de negócio': 'resources',
     Financiamento: 'resources',
@@ -276,6 +277,79 @@ function makeSections(
         }
     }
 
+    if (draft.context_applicability_snapshot) {
+        try {
+            const context = JSON.parse(
+                String(draft.context_applicability_snapshot),
+            );
+            if (context.version === 1) {
+                const section = sections.get('sources');
+                const zone = context.zone;
+                section?.rows.push({
+                    field: 'Contexto do investimento',
+                    value: `Revisão ${context.context_revision}; ${zone ? `${zone.title}, versão ${zone.version}` : 'sem ZEE, ZFI ou parque seleccionado'}`,
+                    origin: 'Referência do mesmo dossier no momento da gravação',
+                    classification:
+                        'Contexto versionado; não é reconhecimento jurídico',
+                });
+                section?.paragraphs.push(
+                    zone
+                        ? 'Benefício fiscal da zona indeterminado: falta regra executável ligada às condições e reconhecimento. O IVA apresentado é apenas cenário geral sem benefício; não representa o regime especial nem o apuramento final.'
+                        : 'Cenário geral de preparação; sem confirmação automática de elegibilidade fiscal.',
+                );
+                const preparation = context.preparation;
+                if (preparation?.enabled) {
+                    const modes: Record<string, string> = {
+                        authorization: 'Pedido de autorização',
+                        registration: 'Pedido de mero registo',
+                        indeterminate: 'Enquadramento por determinar',
+                    };
+                    section?.rows.push({
+                        field: 'Preparação do investimento privado',
+                        value: modes[preparation.mode] ?? 'Por determinar',
+                        origin: `Contexto congelado v${context.context_revision}; ${preparation.version}`,
+                        classification:
+                            'Declarações e requisitos de preparação; sem aprovação jurídica',
+                    });
+                    section?.paragraphs.push(
+                        preparation.next,
+                        preparation.calculation_notice,
+                        preparation.notice,
+                    );
+                    for (const requirement of preparation.requirements ?? [])
+                        section?.rows.push({
+                            field: requirement.label,
+                            value:
+                                requirement.state === 'not_applicable'
+                                    ? 'Não aplicável; histórico preservado'
+                                    : requirement.state === 'associated'
+                                      ? `Associado: ${requirement.document?.file_name ?? 'documento do dossier'}; conteúdo por conferir`
+                                      : requirement.state === 'missing'
+                                        ? 'Documento por associar'
+                                        : 'Informação em falta para decidir',
+                            origin: `${requirement.reason} ${requirement.source?.reference ?? ''}; ${requirement.source?.url ?? ''}`,
+                            classification:
+                                'Preparação informativa — simulação, sem submissão à Administração',
+                        });
+                }
+                if (zone?.href)
+                    section?.rows.push({
+                        field: 'Ficha e fundamentos da zona',
+                        value: zone.href,
+                        origin: `Versão consultada ${zone.version}`,
+                        classification:
+                            'Referência consultável; condições por verificar',
+                    });
+            }
+        } catch {
+            sections
+                .get('sources')
+                ?.paragraphs.push(
+                    'Não foi possível recuperar o contexto guardado; o enquadramento territorial permanece indeterminado.',
+                );
+        }
+    }
+
     for (const [sectionName, field, value, origin] of rows.slice(1)) {
         // Questionnaire schema identifiers remain stored; they do not help the
         // reader assess the project and are not a business report field.
@@ -345,9 +419,23 @@ function makeSections(
     }
 
     const finance = sections.get('finance');
-    if (finance && ['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(String(currentCalculation?.snapshot?.scenario_kind)) && currentCalculation?.snapshot) {
-        for (const [field, value] of fiscalQaRows(currentCalculation.snapshot)) {
-            finance.rows.push({ field, value, origin: 'Snapshot fiscal preservado; sem recálculo', classification: 'Cálculo exacto; ver estado da regra no snapshot; não é saldo a pagar' });
+    if (
+        finance &&
+        ['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(
+            String(currentCalculation?.snapshot?.scenario_kind),
+        ) &&
+        currentCalculation?.snapshot
+    ) {
+        for (const [field, value] of fiscalQaRows(
+            currentCalculation.snapshot,
+        )) {
+            finance.rows.push({
+                field,
+                value,
+                origin: 'Snapshot fiscal preservado; sem recálculo',
+                classification:
+                    'Cálculo exacto; ver estado da regra no snapshot; não é saldo a pagar',
+            });
         }
     }
     if (finance && currentCalculation) {
@@ -422,13 +510,22 @@ function makeSections(
             },
             {
                 field: 'Fórmula e valores usados',
-                value:
-                    ['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(String(snapshot?.scenario_kind))
-                        ? `Base tributável declarada × taxa cadastrada ÷ 100; cálculo decimal exacto, sem arredondamento. Ver regra e proveniência acima.`
-                        : snapshot && typeof snapshot.formula_version === 'string'
-                        ? `Fórmula ${snapshot.formula_version}; base ${displayValue(snapshot.base, 'não disponível')}; taxa ${displayValue(snapshot.rate_percent, 'não disponível')}%; redução ${displayValue(snapshot.reduction_percent, 'não disponível')}%; moeda ${displayValue(snapshot.currency, 'não indicada')}`
-                        : 'A fórmula não foi identificada no snapshot; ver explicação da execução',
-                origin: ['fiscal_rule_qa_preview', 'fiscal_rule_published'].includes(String(snapshot?.scenario_kind)) ? (snapshot?.scenario_kind === 'fiscal_rule_published' ? 'Versão publicada na admissão; sem validação jurídica da operação' : 'Snapshot QA de regra em rascunho; sem activação ou validação jurídica da operação') : 'Snapshot guardado; sem aplicação de regra legal',
+                value: [
+                    'fiscal_rule_qa_preview',
+                    'fiscal_rule_published',
+                ].includes(String(snapshot?.scenario_kind))
+                    ? `Base tributável declarada × taxa cadastrada ÷ 100; cálculo decimal exacto, sem arredondamento. Ver regra e proveniência acima.`
+                    : snapshot && typeof snapshot.formula_version === 'string'
+                      ? `Fórmula ${snapshot.formula_version}; base ${displayValue(snapshot.base, 'não disponível')}; taxa ${displayValue(snapshot.rate_percent, 'não disponível')}%; redução ${displayValue(snapshot.reduction_percent, 'não disponível')}%; moeda ${displayValue(snapshot.currency, 'não indicada')}`
+                      : 'A fórmula não foi identificada no snapshot; ver explicação da execução',
+                origin: [
+                    'fiscal_rule_qa_preview',
+                    'fiscal_rule_published',
+                ].includes(String(snapshot?.scenario_kind))
+                    ? snapshot?.scenario_kind === 'fiscal_rule_published'
+                        ? 'Versão publicada na admissão; sem validação jurídica da operação'
+                        : 'Snapshot QA de regra em rascunho; sem activação ou validação jurídica da operação'
+                    : 'Snapshot guardado; sem aplicação de regra legal',
                 classification: 'Reutilização do resultado existente',
             },
             {

resources/js/lib/project-dossier.ts

@@ -1,4 +1,7 @@
 import { displayValue } from './display-value.ts';
+import { monthlyIvaInput, monthlyIvaKey, readMonthlyIvaRecord, readMonthlyIvaSettings } from './monthly-iva.ts';
+import { modeloAPurchaseReferences } from './iva-modelo-a.ts';
+import { fiscalQaRows } from './fiscal-qa-preview.ts';
 import { csvCellWithDelimiter } from './csv.js';
 import {
     restoreCashflowDraftSnapshot,
@@ -608,6 +611,19 @@ export function buildProjectDossierRows(
             'Planeado/realizado declarado pelo utilizador',
         ]);
     }
+    if (draft.monthly_iva_snapshot) {
+        const saved = readMonthlyIvaRecord(String(draft.monthly_iva_snapshot));
+        let current = false;
+        try { current = !!saved && monthlyIvaKey(monthlyIvaInput(draft, readMonthlyIvaSettings(String(draft.monthly_iva_settings ?? '')))) === monthlyIvaKey(saved.input); } catch { /* An old fiscal version is never silently made current. */ }
+        rows.push(['IVA mensal', 'Estado da versão', current ? 'Entradas correspondentes à projecção guardada' : 'Histórico desactualizado face às vendas ou pressupostos actuais; não aplicar como resultado actual', 'Execução versionada no servidor; sem apuramento final']);
+        if (saved?.execution.result_snapshot) for (const [label,value] of fiscalQaRows(saved.execution.result_snapshot)) rows.push(['IVA mensal', label, value, 'Snapshot fiscal preservado; sem recálculo na exportação']);
+        else rows.push(['IVA mensal', 'Resultado', 'Indeterminado ou execução ainda não concluída', 'Sem substituição por zero']);
+        try {
+            for (const purchase of modeloAPurchaseReferences(draft)) rows.push(['IVA mensal', `Compras/encomendas — mês ${purchase.month}`, purchase.declared ?? 'Sem informação', 'Pressuposto actual do plano, não resultado fiscal histórico; base/IVA incluído por classificar; IVA suportado e dedutível indeterminados; não é data de factura ou pagamento']);
+        } catch {
+            rows.push(['IVA mensal','Aquisições projectadas','Não foi possível recuperar; sem substituição por zero','Pressupostos guardados preservados; não calcula deduções']);
+        }
+    }
     if (draft.cashflow_snapshot) {
         const saved = restoreCashflowDraftSnapshot(
             String(draft.cashflow_snapshot),

resources/js/lib/search-territory.ts

@@ -0,0 +1,24 @@
+const levels = ['province_id', 'district_id', 'admin_post_id', 'locality_id'];
+const searchRoutes = ['/carteira', '/oportunidades', '/zonas', '/educacao'];
+
+/** URL-scoped search context, never a saved investment or another browser tab. */
+export function searchTerritoryHref(href: string, pageUrl: string): string {
+    const base = 'https://portal.invalid';
+    const source = new URL(pageUrl, base);
+    const target = new URL(href, base);
+    const supported = (path: string) => searchRoutes.some((route) => path === route || path.startsWith(`${route}/`));
+    if (target.origin !== base || !supported(source.pathname) || !supported(target.pathname)) return href;
+    const inherited = source.searchParams.has('catalogue_query')
+        ? new URLSearchParams(source.searchParams.get('catalogue_query')!)
+        : source.searchParams;
+    // An explicit ancestor, including an explicit empty value, overrides its descendants.
+    let changed = false;
+    for (const field of levels) {
+        if (target.searchParams.has(field)) {
+            changed ||= target.searchParams.get(field) !== inherited.get(field);
+        } else if (!changed && inherited.get(field)) {
+            target.searchParams.set(field, inherited.get(field)!);
+        }
+    }
+    return target.pathname + target.search + target.hash;
+}

resources/js/lib/simulation-form.ts

@@ -1,3 +1,4 @@
+import { inheritSimulatorFields } from './context-inheritance.ts';
 import { csvCell } from './csv.js';
 import { fiscalQaRows } from './fiscal-qa-preview.ts';
 import { isApiSimulationResultSnapshotV1 } from './simulation-contract.ts';
@@ -965,6 +966,12 @@ export const simulationFieldGroups: Record<
         },
     ],
     tax: [
+        {
+            key: 'fiscal_currency',
+            label: 'Moeda da operação fiscal (sem conversão automática)',
+            options: 'currency',
+            showWhen: (d) => d.fiscal_component === 'iva' && d.fiscal_scenario_mode !== 'custom_planning',
+        },
         {
             key: 'fiscal_period',
             label: 'Ano do período fiscal a simular',
@@ -1524,7 +1531,7 @@ export function restoreSimulationDraft(
             }
         }
     }
-    return draft as SimulationDraft;
+    return inheritSimulatorFields(draft as SimulationDraft);
 }
 
 export function simulationDraftFingerprint(draft: SimulationDraft): string {

resources/js/pages/dashboard.tsx

@@ -1,4 +1,5 @@
 import ProfileNavigation from '@/components/profile-navigation';
+import ContentManagementEntry from '@/components/content-management-entry';
 import { Head, Link } from '@inertiajs/react';
 import { dashboard } from '@/routes';
 import type { InvestmentContext } from '@/pages/investor-path/index';
@@ -51,6 +52,7 @@ export default function Dashboard({
             <Head title="Painel" />
             <h1 className="text-2xl font-semibold">Painel do portal</h1>
             <ProfileNavigation />
+            <ContentManagementEntry />
             {summary ? (
                 <>
                     {opportunityManagement && (

resources/js/pages/desk/panel.tsx

@@ -1,4 +1,5 @@
 import { createOperationKey } from '@/lib/operation-key';
+import ContentManagementEntry from '@/components/content-management-entry';
 import { Link, useForm, usePage } from '@inertiajs/react';
 import { useEffect, useRef, useState } from 'react';
 import { Frame, input, button, card } from '@/pages/investment/shared';
@@ -84,6 +85,7 @@ export default function Panel({
     }, [contextTitle, form.data.title]);
     return (
         <Frame title="Balcão Virtual — acompanhamento">
+            <ContentManagementEntry />
             <nav className="flex flex-wrap gap-4">
                 <Link href="/balcao-virtual/servicos" className="underline">
                     Serviços

resources/js/pages/desk/request.tsx

@@ -135,6 +135,7 @@ export default function RequestPage({
                 <DossierPrefill
                     contextId={dossier.id}
                     consumer="desk"
+                    persistInheritance={request.status !== 'returned'}
                     values={form.data.payload}
                     boundRevision={boundContextRevision}
                     readOnly={!canEdit}

resources/js/pages/investment/catalogue.tsx

@@ -1,4 +1,5 @@
 import EducationalGuides from '@/components/educational-guides';
+import { searchTerritoryHref } from '@/lib/search-territory';
 import type { EducationalArticle } from '@/components/educational-article-card';
 import OpportunitySearchFilters from '@/components/opportunity-search-filters';
 import SearchState from '@/components/search-state';
@@ -46,7 +47,8 @@ export default function Catalogue({
         corridor_id: string | null;
     }[];
 }) {
-    const { auth } = usePage<{ auth: { user: unknown } }>().props;
+    const page = usePage<{ auth: { user: unknown } }>();
+    const { auth } = page.props;
     const form = useForm({
         association_type: String(filters.association_type ?? ''),
         association_target: String(filters.association_target ?? ''),
@@ -100,6 +102,16 @@ export default function Catalogue({
         ),
     });
     const view = String(filters.view ?? 'grid');
+    const selectedStructures = [
+        ...(references.zones ?? []).filter((zone) =>
+            ['park_id', 'zee_id', 'zfi_id'].some((key) => filters[key] === zone.id),
+        ).map((zone) => ({ ...zone, url: `/zonas/${zone.id}` })),
+        ...(['clusters', 'corridors', 'projects'] as const).flatMap((group) =>
+            references[group].filter((record) => filters[
+                { clusters: 'cluster_id', corridors: 'corridor_id', projects: 'project_id' }[group]
+            ] === record.id),
+        ),
+    ];
     const [territoryPath, setTerritoryPath] = useState(territorySelection);
     const [saved, setSaved] = useState(favourites);
     const [selected, setSelected] = useState<number[]>([]);
@@ -360,6 +372,17 @@ export default function Catalogue({
                 total={results.total}
                 retry={() => runSearch()}
             />
+            {!searchLoading && !searchError && results.total === 0 && selectedStructures.length > 0 && (
+                    <section className={card} aria-label="Estrutura seleccionada">
+                        <p className="font-semibold">Sem oportunidades publicadas associadas com estes filtros.</p>
+                        <p>A estrutura continua disponível para consulta. A sua selecção não confirma benefícios nem disponibilidade para investimento.</p>
+                        {selectedStructures.map((record) => (
+                            record.url ? <Link key={record.id} className="block underline" href={searchTerritoryHref(record.url, page.url)}>
+                                Consultar ficha: {record.name}
+                            </Link> : <p key={record.id}>{record.name} — sem ficha pública detalhada disponível.</p>
+                        ))}
+                    </section>
+                )}
             <div className="flex flex-wrap items-center gap-4">
                 {!searchLoading &&
                     !searchError &&
@@ -696,7 +719,7 @@ export default function Catalogue({
                     <div className="grid gap-4 md:grid-cols-3">
                         {territorial.map((d) => (
                             <Link
-                                href={`/carteira/${d.id}`}
+                                href={searchTerritoryHref(`/carteira/${d.id}`, page.url)}
                                 key={d.id}
                                 className={card}
                             >

resources/js/pages/investment/detail.tsx

@@ -1,4 +1,5 @@
 import EducationalGuides from '@/components/educational-guides';
+import { searchTerritoryHref } from '@/lib/search-territory';
 import type { EducationalArticle } from '@/components/educational-article-card';
 import { ClassificationSummary } from '@/components/opportunity-classification';
 import { Link, router, usePage } from '@inertiajs/react';
@@ -31,6 +32,7 @@ export default function Detail({
     const [sharing, setSharing] = useState('');
     return (
         <Frame title={r.title}>
+            {r.maturity_label === 'Em preparação' && <p className="rounded border border-amber-700 bg-amber-50 p-4"><strong>Em preparação — divulgação promocional.</strong> A divulgação não autoriza a execução do investimento.</p>}
             <Link
                 className={button}
                 href={'/investimentos/iniciar?source=opportunity:' + r.id}
@@ -45,7 +47,7 @@ export default function Detail({
                 <p>
                     <Link
                         className="underline"
-                        href={`/carteira/${dossierOrigin.id}`}
+                        href={searchTerritoryHref(`/carteira/${dossierOrigin.id}`, page.url)}
                     >
                         Voltar ao dossier: {dossierOrigin.title}
                     </Link>
@@ -253,7 +255,7 @@ export default function Detail({
                                     <span key={dossier.id}>
                                         <Link
                                             className="underline"
-                                            href={`/carteira/${dossier.id}`}
+                                            href={searchTerritoryHref(`/carteira/${dossier.id}`, page.url)}
                                         >
                                             Consultar dossier: {dossier.title}
                                         </Link>

resources/js/pages/investment/shared.tsx

@@ -19,6 +19,7 @@ export type Option = {
 export type Entity = {
     id: string;
     name: string;
+    url?: string | null;
     dossiers?: { id: string; title: string; source: string }[];
     geography?: StructureGeography | null;
 };

resources/js/pages/investment/zone.tsx

@@ -5,6 +5,7 @@ import ParkDetailsEditor, {
 } from '@/components/investment-zone-operational-details';
 import { Link, router, useForm, usePage } from '@inertiajs/react';
 import { catalogueReturnHref } from '@/lib/catalogue-context';
+import { searchTerritoryHref } from '@/lib/search-territory';
 import InvestmentTerritory from '@/components/investment-territory';
 import InvestmentMapPanel from '@/components/investment-map-panel';
 import {
@@ -1772,7 +1773,7 @@ function Editor({
                             <p key={o.id}>
                                 <Link
                                     className="underline"
-                                    href={`/oportunidades/${o.slug}?zone_id=${z.id}`}
+                                    href={searchTerritoryHref(`/oportunidades/${o.slug}?zone_id=${z.id}`, pageUrl)}
                                 >
                                     {o.title}
                                 </Link>
@@ -1829,7 +1830,7 @@ function Editor({
                             <p key={r.id}>
                                 <Link
                                     className="underline"
-                                    href={`/carteira/${r.id}`}
+                                    href={searchTerritoryHref(`/carteira/${r.id}`, pageUrl)}
                                 >
                                     {r.title}
                                 </Link>

resources/js/pages/investment/zones.tsx

@@ -1,7 +1,8 @@
 import InvestmentZoneInstallation, {
     type ParkInstallationPlan,
 } from '@/components/investment-zone-installation';
-import { Link, router } from '@inertiajs/react';
+import { Link, router, usePage } from '@inertiajs/react';
+import { searchTerritoryHref } from '@/lib/search-territory';
 import { useState } from 'react';
 import { catalogueDetailHref } from '@/lib/catalogue-context';
 import {
@@ -90,9 +91,13 @@ export default function Zones({
     zoneExtensionsAvailable?: boolean;
     territorySelection?: TerritoryOption[];
 }) {
+    const pageUrl = usePage().url;
     const [error, setError] = useState('');
     const [busy, setBusy] = useState(false);
     const exportParams = new URLSearchParams();
+    ['province_id', 'district_id', 'admin_post_id', 'locality_id'].forEach((field, index) => {
+        if (territorySelection[index]) exportParams.set(field, territorySelection[index].id);
+    });
     for (const key of [
         'q',
         'category',
@@ -148,9 +153,9 @@ export default function Zones({
                 >
                     <Link href="/clusters">Por Cluster</Link>
                     <Link href="/corredores">Por Corredor</Link>
-                    <Link href="/zonas?category=zee">Por ZEE</Link>
-                    <Link href="/zonas?category=zfi">Por ZFI</Link>
-                    <Link href="/zonas?category=industrial_park">
+                    <Link href={searchTerritoryHref('/zonas?category=zee', pageUrl)}>Por ZEE</Link>
+                    <Link href={searchTerritoryHref('/zonas?category=zfi', pageUrl)}>Por ZFI</Link>
+                    <Link href={searchTerritoryHref('/zonas?category=industrial_park', pageUrl)}>
                         Parques industriais
                     </Link>
                 </nav>
@@ -343,7 +348,7 @@ export default function Zones({
                     {!management && (
                         <Link
                             className="ml-4 underline"
-                            href={`/oportunidades?${new URLSearchParams({ [zone.category === 'zee' ? 'zee_id' : zone.category === 'zfi' ? 'zfi_id' : 'park_id']: zone.id })}`}
+                            href={searchTerritoryHref(`/oportunidades?${new URLSearchParams({ [zone.category === 'zee' ? 'zee_id' : zone.category === 'zfi' ? 'zfi_id' : 'park_id']: zone.id })}`, pageUrl)}
                         >
                             Ver oportunidades associadas
                         </Link>

resources/js/pages/investor-path/context.tsx

@@ -1,3 +1,8 @@
+import {
+    PreparationEditor,
+    PreparationImpact,
+} from '@/components/private-investment-preparation';
+import { InvestmentContextAssessment } from '@/components/investment-context-assessment';
 import ContextDocuments from '@/components/context-documents';
 import { Link } from '@inertiajs/react';
 import { useState } from 'react';
@@ -35,6 +40,7 @@ export default function ContextEditor({
 }) {
     const navigation = useNavigationContext();
     const [view, setView] = useState(initial);
+    const [preparation, setPreparation] = useState(initial.private_investment);
     const [options, setOptions] = useState(initialOptions);
     const [query, setQuery] = useState('');
     const [changes, setChanges] = useState<Partial<Record<Slot, string>>>(() =>
@@ -48,6 +54,9 @@ export default function ContextEditor({
     const [declarations, setDeclarations] = useState<Record<string, string>>(
         {},
     );
+    const [documentLinks, setDocumentLinks] = useState<
+        Record<string, string | null>
+    >({});
     const [replace, setReplace] = useState<string[]>([]);
     const [plan, setPlan] = useState<ContextPlan | null>(null);
     const [busy, setBusy] = useState(false);
@@ -58,6 +67,32 @@ export default function ContextEditor({
         string,
         unknown
     > | null>(null);
+    const displayValue = (
+        field: string,
+        value: string | null | undefined,
+    ): string => {
+        if (value === null || value === undefined || value === '')
+            return 'não informado';
+        const question = view.private_investment?.questions.find(
+            (q) => q.key === field,
+        );
+        return (
+            question?.options?.[value] ??
+            (
+                {
+                    being_formed: 'Em constituição',
+                    existing: 'Existente',
+                    national: 'Nacional',
+                    foreign: 'Estrangeiro',
+                    mixed: 'Misto',
+                    yes: 'Sim',
+                    no: 'Não',
+                    unknown: 'Por determinar',
+                } as Record<string, string>
+            )[value] ??
+            value
+        );
+    };
     const selected = (slot: Slot) =>
         Object.hasOwn(changes, slot)
             ? (changes[slot] ?? '')
@@ -76,6 +111,7 @@ export default function ContextEditor({
             selection: changes,
             declarations,
             replace_fields: replace,
+            document_links: documentLinks,
         };
         try {
             const result = await contextApi<ContextPlan>(
@@ -84,6 +120,9 @@ export default function ContextEditor({
             );
             setRequestBody(body);
             setPlan(result);
+            setPreparation(
+                result.private_investment?.after ?? view.private_investment,
+            );
         } catch (e) {
             setError(
                 e instanceof Error ? e.message : 'Não foi possível comparar.',
@@ -110,9 +149,11 @@ export default function ContextEditor({
                 `/investimentos/${view.case.id}/contexto`,
             );
             setView(next);
+            setPreparation(next.private_investment);
             navigation.refresh();
             setChanges({});
             setDeclarations({});
+            setDocumentLinks({});
             setReplace([]);
             setPlan(null);
             setOperation(createOperationKey());
@@ -131,6 +172,10 @@ export default function ContextEditor({
     }
     return (
         <Frame title="Contexto do investimento">
+            <InvestmentContextAssessment
+                contextId={view.case.id}
+                raw={view.prefill.simulator?.context_applicability_snapshot}
+            />
             <ContextDocuments source={view.context.selection.opportunity} />
             <div className="space-y-5 [overflow-wrap:anywhere]">
                 <Link
@@ -286,7 +331,7 @@ export default function ContextEditor({
                         </select>
                     </label>
                     <label className="grid min-w-0 gap-1">
-                        Parque consultado
+                        ZEE, ZFI ou parque consultado
                         <select
                             className={input + ' max-w-full min-w-0'}
                             disabled={busy}
@@ -294,7 +339,7 @@ export default function ContextEditor({
                             onChange={(e) => change('park', e.target.value)}
                         >
                             <option value="">
-                                Sem parque no contexto atual
+                                Sem ZEE, ZFI ou parque seleccionado
                             </option>
                             {options.parks.map((p) => (
                                 <option key={p.id} value={'park:' + p.id}>
@@ -335,6 +380,107 @@ export default function ContextEditor({
                         Estes campos pertencem ao processo. Alterá-los não muda
                         o cadastro da oportunidade nem o perfil da organização.
                     </p>
+                    <p>
+                        Origem do investidor, residência fiscal e constituição
+                        da entidade são declarações distintas. A localização não
+                        confirma benefícios. A prévia identifica o impacto antes
+                        de guardar.
+                    </p>
+                    {[
+                        ['currency', 'Moeda do projecto', null],
+                        [
+                            'expected_start_date',
+                            'Data prevista de início',
+                            null,
+                        ],
+                        [
+                            'investor_origin',
+                            'Origem do investidor',
+                            [
+                                ['national', 'Nacional'],
+                                ['foreign', 'Estrangeiro'],
+                                ['mixed', 'Misto'],
+                            ],
+                        ],
+                        [
+                            'person_type',
+                            'Tipo de entidade',
+                            [
+                                ['singular', 'Pessoa singular'],
+                                ['collective', 'Pessoa colectiva'],
+                                ['consortium', 'Consórcio'],
+                            ],
+                        ],
+                        [
+                            'entity_stage',
+                            'Situação da entidade',
+                            [
+                                ['existing', 'Existente'],
+                                ['being_formed', 'Em constituição'],
+                            ],
+                        ],
+                        [
+                            'tax_residency_country',
+                            'País de residência fiscal declarado (ISO de duas letras)',
+                            null,
+                        ],
+                    ].map(([key, label, choices]) => (
+                        <label className="grid gap-1" key={String(key)}>
+                            {String(label)}
+                            {Array.isArray(choices) ? (
+                                <select
+                                    className={input}
+                                    value={
+                                        declarations[String(key)] ??
+                                        view.context.fields[String(key)] ??
+                                        ''
+                                    }
+                                    onChange={(e) => {
+                                        setDeclarations({
+                                            ...declarations,
+                                            [String(key)]: e.target.value,
+                                        });
+                                        setPlan(null);
+                                    }}
+                                >
+                                    <option value="">Por indicar</option>
+                                    {choices.map(([value, text]) => (
+                                        <option key={value} value={value}>
+                                            {text}
+                                        </option>
+                                    ))}
+                                </select>
+                            ) : (
+                                <input
+                                    className={input}
+                                    type={
+                                        key === 'expected_start_date'
+                                            ? 'date'
+                                            : 'text'
+                                    }
+                                    maxLength={
+                                        key === 'currency'
+                                            ? 3
+                                            : key === 'tax_residency_country'
+                                              ? 2
+                                              : 10
+                                    }
+                                    value={
+                                        declarations[String(key)] ??
+                                        view.context.fields[String(key)] ??
+                                        ''
+                                    }
+                                    onChange={(e) => {
+                                        setDeclarations({
+                                            ...declarations,
+                                            [String(key)]: e.target.value,
+                                        });
+                                        setPlan(null);
+                                    }}
+                                />
+                            )}
+                        </label>
+                    ))}
                     {['project_title', 'project_summary'].map((k) => (
                         <label className="grid gap-1" key={k}>
                             {contextFieldNames[k]}
@@ -387,6 +533,30 @@ export default function ContextEditor({
                             </label>
                         ))}
                     </details>
+                    {view.private_investment && (
+                        <PreparationEditor
+                            data={preparation ?? view.private_investment}
+                            fields={view.context.fields}
+                            changes={declarations}
+                            documents={view.preparation_documents ?? []}
+                            links={documentLinks}
+                            disabled={busy || !view.can_write}
+                            onChange={(key, value) => {
+                                setDeclarations({
+                                    ...declarations,
+                                    [key]: value,
+                                });
+                                setPlan(null);
+                            }}
+                            onLink={(key, value) => {
+                                setDocumentLinks({
+                                    ...documentLinks,
+                                    [key]: value,
+                                });
+                                setPlan(null);
+                            }}
+                        />
+                    )}
                     <button
                         className={button}
                         type="button"
@@ -443,10 +613,15 @@ export default function ContextEditor({
                                                         x.field
                                                     ] ?? x.field}
                                                     :{' '}
-                                                    {x.before ??
-                                                        'não informado'}{' '}
+                                                    {displayValue(
+                                                        x.field,
+                                                        x.before,
+                                                    )}{' '}
                                                     →{' '}
-                                                    {x.after ?? 'não informado'}
+                                                    {displayValue(
+                                                        x.field,
+                                                        x.after,
+                                                    )}
                                                 </p>
                                             ))}
                                             {Object.values(plan.selection).map(
@@ -506,6 +681,9 @@ export default function ContextEditor({
                                 </tbody>
                             </table>
                         </div>
+                        {plan.private_investment && (
+                            <PreparationImpact {...plan.private_investment} />
+                        )}
                         <p>{plan.notice}</p>
                         <div className="flex flex-wrap gap-3">
                             <button

resources/js/pages/investor-path/show.tsx

@@ -1,3 +1,7 @@
+import {
+    PreparationSummary,
+    type Preparation,
+} from '@/components/private-investment-preparation';
 import ContextDocuments from '@/components/context-documents';
 import type { DossierContext } from '@/lib/investor-context';
 import FintechInvestment, {
@@ -27,6 +31,7 @@ type Step = {
     source_paragraph: number;
 };
 type Path = {
+    private_investment?: Preparation | null;
     fintech: FintechView | null;
     investment_context: DossierContext | null;
     zone_contexts?: {
@@ -180,6 +185,28 @@ function Stage({ step, path }: { step: Step; path: Path }) {
                     independente.
                 </label>
             )}
+            {path.private_investment?.enabled && (
+                <div className="space-y-2">
+                    {path.private_investment.requirements
+                        .filter((r) => r.stage === step.code)
+                        .map((r) => (
+                            <p className="text-sm" key={r.key}>
+                                <strong>{r.label}:</strong>{' '}
+                                {r.state === 'not_applicable'
+                                    ? 'não exigido neste contexto; histórico preservado'
+                                    : r.state === 'associated'
+                                      ? 'documento associado; conteúdo por conferir'
+                                      : r.state === 'missing'
+                                        ? 'documento por associar'
+                                        : 'aplicabilidade por determinar'}
+                                . {r.reason}{' '}
+                                <a className="underline" href={r.source.url}>
+                                    {r.source.reference}
+                                </a>
+                            </p>
+                        ))}
+                </div>
+            )}
             {step.reason && (
                 <p className="text-sm">Fundamento: {step.reason}</p>
             )}
@@ -415,6 +442,10 @@ export default function InvestmentPath(path: Path) {
             <ContextDocuments
                 source={path.investment_context?.selection.opportunity}
             />
+            <PreparationSummary
+                data={path.private_investment}
+                caseId={path.case.id}
+            />
             {path.investment_context && (
                 <section className="space-y-2 rounded border border-emerald-300 bg-emerald-50 p-4">
                     <h2 className="font-semibold">

resources/js/pages/management-access.tsx

@@ -6,7 +6,7 @@ export default function ManagementAccess({
 }: {
     registrationEnabled: boolean;
 }) {
-    const { auth } = usePage<{ auth: Auth }>().props;
+    const { auth, contentManagementHref } = usePage<{ auth: Auth; contentManagementHref?: string | null }>().props;
     const user = auth.user;
     const action =
         'inline-flex rounded-lg bg-slate-900 px-5 py-3 font-medium text-white';
@@ -29,7 +29,7 @@ export default function ManagementAccess({
                     <h2 className="text-xl font-semibold">
                         {!user
                             ? 'Preparar a sua conta'
-                            : auth.canManagePortal
+                            : contentManagementHref || auth.canManagePortal
                               ? 'Acesso disponível'
                               : !user.email_verified_at
                                 ? 'Verificar o seu email'
@@ -53,6 +53,11 @@ export default function ManagementAccess({
                                 )}
                             </div>
                         </>
+                    ) : contentManagementHref ? (
+                        <>
+                            <p>Abra a entrada de gestão para cadastrar oportunidades e gerir documentos e legislação, conforme as funções já atribuídas à sua conta.</p>
+                            <Link className={action} href={contentManagementHref}>Abrir gestão de conteúdos e oportunidades</Link>
+                        </>
                     ) : auth.canManagePortal ? (
                         <>
                             <p>

resources/js/pages/management/content-hub.tsx

@@ -0,0 +1,39 @@
+import { Link } from '@inertiajs/react';
+import { Frame, card, button } from '@/pages/investment/shared';
+import { states } from './shared';
+
+type Access = {
+    opportunities?: {index: string; create: string | null; profileWorkflow: boolean};
+    documents?: {index: string; edit: boolean};
+};
+export default function ContentHub({access, counts}: {access: Access; counts: Record<string, Record<string, number>>}) {
+    return <Frame title="Gestão de conteúdos e oportunidades">
+        <p>Use os cadastros e a biblioteca existentes. Guardar um rascunho, analisar um ficheiro e publicar são operações distintas. Cada acção respeita a sua autorização actual.</p>
+        <div className="grid gap-4 md:grid-cols-2">
+            {access.opportunities && <section className={card}>
+                <h2 className="text-xl font-semibold">Oportunidades</h2>
+                <p>Escolha a modalidade, o sector e a localização; preencha, guarde o rascunho e siga as acções de submissão, revisão e publicação disponíveis no seu perfil.</p>
+                <p>Sector económico e modalidade são escolhas distintas. Pode guardar preparação incompleta; o editor identifica os campos e variantes ainda sem suporte de submissão.</p>
+                {access.opportunities.create && <Link className={button} href={access.opportunities.create}>Nova oportunidade</Link>}
+                <Link className="block underline" href={access.opportunities.index}>Gerir oportunidades e histórico</Link>
+                <p>Para divulgar um resumo ainda em preparação, abra a ficha e escolha <strong>Divulgação promocional</strong>: prepare o texto público, reveja a prévia e confirme divulgar, actualizar ou retirar. Esta operação não conclui a validação do investimento.</p>
+                <ul>{Object.entries(counts.opportunities ?? {}).map(([state, total]) => <li key={state}><Link className="underline" href={`${access.opportunities!.index}?status=${state}`}>{states[state] ?? state}: {total}</Link></li>)}</ul>
+                <p className="text-sm">As etapas e a independência já definidas para oportunidades mantêm-se. Esta entrada não atribui autorização para rever ou publicar.</p>
+                {!access.opportunities.profileWorkflow && <p>O seu acesso actual abre o cadastro legado de rascunhos. A submissão, revisão e publicação de novas oportunidades utilizam os perfis operacionais já existentes; a administração de conteúdos não substitui essa designação. Esta entrada não apresenta o rascunho legado como percurso completo de publicação.</p>}
+            </section>}
+            {access.documents && <section className={card}>
+                <h2 className="text-xl font-semibold">Documentos e legislação</h2>
+                <p>Carregue o original ou reutilize um ficheiro existente; acompanhe a análise, complete os metadados e associações e defina o acesso. Depois publique explicitamente, se autorizado.</p>
+                <div className="flex flex-wrap gap-3"><Link className={button} href={`${access.documents.index}?intent=document#receber`}>Novo documento</Link>
+                {access.documents.edit && <Link className={button} href={`${access.documents.index}?intent=legislation#receber`}>Nova legislação</Link>}</div>
+                <Link className="block underline" href={`${access.documents.index}#conteudos`}>Gerir conteúdos, versões e histórico</Link>
+                {!access.documents.edit && <p>O seu acesso permite carregar e analisar ficheiros próprios; não inclui cadastro editorial nem publicação.</p>}
+                <p>Publicados: {counts.documents?.published ?? 0} · Não publicados: {counts.documents?.unpublished ?? 0}. A lista distingue rascunhos de conteúdos retirados através do histórico.</p>
+                <p className="text-sm">Publicar legislação permite consultá-la. Não a activa como regra executável no simulador.</p>
+            </section>}
+        </div>
+        <section className={card}><h2 className="font-semibold">Como concluir sem apoio técnico</h2>
+            <ol className="list-decimal space-y-2 pl-5"><li>Abra a acção pretendida e use os campos do editor existente.</li><li>Guarde a preparação. As mensagens indicam o estado e o que precisa de corrigir.</li><li>Reabra pela gestão, pesquise o título e consulte o histórico.</li><li>Use as acções autorizadas de publicação ou retirada. Os originais e as revisões são preservados.</li></ol>
+        </section>
+    </Frame>;
+}

resources/js/pages/management/opportunities.tsx

@@ -17,6 +17,7 @@ type Entry = {
     updated_at: string;
     deleted_at: string | null;
     can_edit?: boolean;
+    can_promote?: boolean;
     working_status?: string;
     draft_title?: string;
     publication?: { scope: string; label: string; public_catalog: boolean };
@@ -232,6 +233,7 @@ export default function Opportunities({
                         <p>Atualizado: {r.updated_at}</p>
                         <div className="flex flex-wrap gap-4">
                             <Link href={`${basePath}/${r.id}/view`}>Ver</Link>
+                            {r.can_promote && <Link href={`/minhas-oportunidades/${r.id}/divulgacao`}>Divulgação promocional</Link>}
                             {r.can_edit !== false && (
                                 <Link href={`${basePath}/${r.id}/edit`}>
                                     {r.deleted_at || r.status === 'archived'

resources/js/pages/management/opportunity-draft.tsx

@@ -1,6 +1,7 @@
 import { ClassificationReview } from '@/components/opportunity-classification';
 import { createOperationKey } from '@/lib/operation-key';
 import { valueText } from '@/lib/value-text';
+import { modalityLabels } from '@/components/opportunity-search-filters';
 import OpportunityProfileActions from '@/components/opportunity-profile-actions';
 import OpportunityContactForm from '@/components/opportunity-contact-form';
 import OpportunityCanonicalFields, {
@@ -74,9 +75,11 @@ export default function OpportunityDraft({
         workflowParticipants,
         publicationPreview,
         publicationState,
+        promotionHref,
         auth,
         canEditDraft = false,
     } = usePage<{
+        promotionHref?: string | null;
         basePath?: string;
         profileMode?: boolean;
         profileOrganization?: string | null;
@@ -245,6 +248,7 @@ export default function OpportunityDraft({
             <Link href={basePath}>
                 {profileMode ? 'Minhas oportunidades' : 'Voltar à gestão'}
             </Link>
+            {promotionHref && <Link className="ml-3 underline" href={promotionHref}>Divulgação promocional — Em preparação</Link>}
             {record && (
                 <Link
                     href={`/investimentos/iniciar?source=opportunity:${record.id}`}
@@ -330,7 +334,7 @@ export default function OpportunityDraft({
                                 {c.organization_name ??
                                     c.organization_id ??
                                     'Âmbito individual'}{' '}
-                                — {c.type}
+                                — {modalityLabels[c.type] ?? c.type}
                             </option>
                         ))}
                     </select>

resources/js/pages/management/opportunity-promotion.tsx

@@ -0,0 +1,77 @@
+import { Link, router } from '@inertiajs/react';
+import { useState } from 'react';
+import { createOperationKey } from '@/lib/operation-key';
+import { profileJson, ProfileValidationError } from '@/lib/profile-json';
+import { Management, Field, control, button } from './shared';
+
+type Draft = {title: string; summary: string; description: string; limitations: string; source_reference: string; edition: string; source_date: string; sector_id: number | null; territory_ids: string[]};
+type Projection = {title: string; summary: string; description: string; sector_id: number | null; maturity_label: string; territories: {id: string; label: string}[]};
+type Preview = {token: string; action: 'disclose' | 'withdraw'; projection: Projection; current: {title: string; summary: string; description: string; status: string}};
+
+export default function OpportunityPromotion({record, initial, etag, publicNow, reauthenticationRequired, sectors, territories, history}: {
+    record: {id: number; reference: string}; initial: Draft; etag: string; publicNow: boolean; reauthenticationRequired: boolean;
+    sectors: {id: number; name: string}[]; territories: {id: string; name: string; location_type: string}[];
+    history: {id: string; action: string; actor_user_id: number; occurred_at: string}[];
+}) {
+    const [draft, setDraft] = useState<Draft>({...initial, source_date: initial.source_date ?? ''});
+    const [preview, setPreview] = useState<Preview | null>(null);
+    const [operationKey, setOperationKey] = useState(createOperationKey);
+    const [reason, setReason] = useState('');
+    const [confirmed, setConfirmed] = useState(false);
+    const [busy, setBusy] = useState(false);
+    const [message, setMessage] = useState('');
+    const [errors, setErrors] = useState<Record<string,string>>({});
+    const [needsMfa, setNeedsMfa] = useState(reauthenticationRequired);
+    function change<K extends keyof Draft>(key: K, value: Draft[K]) { setDraft(current => ({...current, [key]:value})); setPreview(null); setConfirmed(false); }
+    function report(error: unknown) {setMessage(error instanceof Error ? error.message : 'Não foi possível concluir. A ficha anterior foi preservada.'); setErrors(error instanceof ProfileValidationError ? error.fields : {}); if(error instanceof ProfileValidationError && error.reauthenticate)setNeedsMfa(true);}
+    function renewAuthentication() { router.post('/logout', {}, {onSuccess:()=>router.visit(`/minhas-oportunidades/${record.id}/divulgacao`)}); }
+    async function prepare(action: 'disclose' | 'withdraw') {
+        setBusy(true); setMessage(''); setErrors({}); setPreview(null); setConfirmed(false);
+        try { const result = await profileJson(`/minhas-oportunidades/${record.id}/divulgacao/previa`, {...draft, etag, action}); setPreview(result); setOperationKey(createOperationKey()); }
+        catch (error) { report(error); } finally { setBusy(false); }
+    }
+    async function publish() {
+        if (!preview || !confirmed) return;
+        setBusy(true); setErrors({});
+        try {const result = await profileJson(`/minhas-oportunidades/${record.id}/divulgacao/confirmar`, {token:preview.token, operation_key:operationKey, reason, confirm:confirmed});
+            setMessage(result.message); setPreview(null); setConfirmed(false); router.reload();
+        } catch (error) { report(error); } finally {setBusy(false);}
+    }
+    const labels: Record<string,string> = {promotional_summary_published:'Resumo divulgado', promotional_summary_updated:'Resumo actualizado', promotional_summary_withdrawn:'Resumo retirado'};
+    return <Management title={`Divulgação promocional — ${record.reference}`}>
+        <Link className="underline" href={`/minhas-oportunidades/${record.id}/view`}>Voltar à oportunidade</Link>
+        <p>Prepare o resumo público e reveja a prévia antes de confirmar. A divulgação fica identificada como <strong>Em preparação</strong> e não autoriza a execução do investimento. Documentos e contactos do cadastro continuam privados.</p>
+        <p role="status">{publicNow ? 'Resumo actualmente divulgado.' : 'Resumo não divulgado.'} {message}</p>
+        {needsMfa && <p role="alert">Entre novamente com a sua conta e MFA para confirmar esta operação. O cadastro guardado permanece disponível; a prévia ainda não confirmada terá de ser preparada novamente. <button className="underline" onClick={renewAuthentication}>Renovar entrada com MFA</button></p>}
+        {Object.entries(errors).map(([key,value]) => <p role="alert" key={key}>{key}: {value}</p>)}
+        <form className="space-y-4 rounded border p-5" onSubmit={e=>{e.preventDefault(); void prepare('disclose');}}>
+            <Field label="Título público"><input required className={control} maxLength={255} value={draft.title} onChange={e=>change('title',e.target.value)}/></Field>
+            <Field label="Resumo público"><textarea required className={control} maxLength={499} value={draft.summary} onChange={e=>change('summary',e.target.value)}/></Field>
+            <Field label="Descrição pública"><textarea className={control} maxLength={6000} value={draft.description} onChange={e=>change('description',e.target.value)}/></Field>
+            <Field label="Limitações e lacunas conhecidas"><textarea className={control} value={draft.limitations} onChange={e=>change('limitations',e.target.value)}/></Field>
+            <Field label="Fonte do resumo"><textarea className={control} value={draft.source_reference} onChange={e=>change('source_reference',e.target.value)}/></Field>
+            <Field label="Edição"><input className={control} value={draft.edition} onChange={e=>change('edition',e.target.value)}/></Field>
+            <Field label="Data-base"><input className={control} type="date" value={draft.source_date} onChange={e=>change('source_date',e.target.value)}/></Field>
+            <Field label="Sector divulgado"><select className={control} value={draft.sector_id ?? ''} onChange={e=>change('sector_id',e.target.value ? Number(e.target.value):null)}><option value="">Por indicar</option>{sectors.map(s=><option key={s.id} value={s.id}>{s.name}</option>)}</select></Field>
+            <Field label="Acrescentar abrangência territorial documentada"><select className={control} value="" onChange={e=>{if(e.target.value && !draft.territory_ids.includes(e.target.value))change('territory_ids',[...draft.territory_ids,e.target.value]);}}><option value="">Seleccionar território existente</option>{territories.map(t=><option key={t.id} value={t.id}>{t.name} · {t.location_type}</option>)}</select></Field>
+            <p>Seleccione apenas a abrangência que pretende divulgar e cuja origem está identificada. Abrangência não comprova implantação ou disponibilidade de terreno. Sem selecção, a localização fica por indicar.</p>
+            <ul>{draft.territory_ids.map(id=><li key={id}>{territories.find(t=>t.id===id)?.name ?? 'Referência anterior indisponível'} <button type="button" className="underline" onClick={()=>change('territory_ids',draft.territory_ids.filter(t=>t!==id))}>Remover abrangência</button></li>)}</ul>
+            <button className={button} disabled={busy || needsMfa}>{publicNow ? 'Rever actualização do resumo' : 'Preparar prévia de divulgação'}</button>
+            {publicNow && <button type="button" className={`${button} ml-3`} disabled={busy || needsMfa} onClick={()=>void prepare('withdraw')}>Preparar retirada do resumo</button>}
+        </form>
+        {preview && <section className="space-y-4 rounded border p-5" aria-label="Prévia da divulgação">
+            <h2 className="text-xl font-semibold">{preview.action === 'withdraw' ? 'Rever retirada do catálogo' : 'Prévia do conteúdo público'}</h2>
+            <p><strong>{preview.projection.maturity_label}</strong></p>
+            <h3>{preview.projection.title}</h3><p>{preview.projection.summary}</p><p className="whitespace-pre-wrap">{preview.projection.description}</p>
+            <p>Sector: {sectors.find(s=>s.id===preview.projection.sector_id)?.name ?? 'Por indicar'}</p>
+            <ul>{preview.projection.territories.map(t=><li key={t.id}>{t.label}</li>)}</ul>
+            {!preview.projection.territories.length && <p>Abrangência territorial por indicar.</p>}
+            <p>Esta prévia ainda não alterou o portal público. {preview.action === 'withdraw' ? 'A confirmação retira o resumo da consulta pública e preserva o cadastro.' : 'Só este texto e o enquadramento apresentado serão divulgados; os anexos e contactos não são incluídos.'}</p>
+            <Field label="Motivo da divulgação, alteração ou retirada"><textarea required className={control} minLength={10} maxLength={1000} value={reason} onChange={e=>setReason(e.target.value)}/></Field>
+            <label className="block"><input type="checkbox" checked={confirmed} onChange={e=>setConfirmed(e.target.checked)}/> Confirmo o conteúdo público desta prévia e a operação indicada.</label>
+            <button className={button} disabled={busy || !confirmed || reason.trim().length<10} onClick={()=>void publish()}>{preview.action === 'withdraw' ? 'Confirmar retirada do resumo' : 'Confirmar divulgação do resumo'}</button>
+            <button className="ml-3 underline" disabled={busy} onClick={()=>{setPreview(null);setConfirmed(false);}}>Cancelar prévia</button>
+        </section>}
+        <section aria-label="Histórico da divulgação"><h2 className="text-xl font-semibold">Histórico da divulgação</h2><ul>{history.map(h=><li key={h.id}>{labels[h.action] ?? h.action} · {h.occurred_at} · responsável {h.actor_user_id}</li>)}</ul></section>
+    </Management>;
+}

resources/js/pages/management/shared.tsx

@@ -1,4 +1,5 @@
 import ProfileNavigation from '@/components/profile-navigation';
+import ContentManagementEntry from '@/components/content-management-entry';
 import { Head, Link, usePage } from '@inertiajs/react';
 import type { ReactNode } from 'react';
 import { cloneElement, isValidElement, useId } from 'react';
@@ -60,6 +61,7 @@ export function Management({
     return (
         <div className="space-y-6 p-4 md:p-8">
             <Head title={title} />
+            <ContentManagementEntry />
             {auth?.canManagePortal && basePath !== '/minhas-oportunidades' ? (
                 <nav
                     className="flex flex-wrap gap-4 text-sm underline"

resources/js/pages/portal/manage.tsx

@@ -1,5 +1,5 @@
-import { router, useForm } from '@inertiajs/react';
-import { useState } from 'react';
+import { router, useForm, usePage } from '@inertiajs/react';
+import { useEffect, useState } from 'react';
 import { Management, Field, control, button } from '../management/shared';
 
 type DocumentFile = {
@@ -164,7 +164,11 @@ export default function Manage({
     legacyContentEnabled = false,
     documentAccessOnly = false,
     editorialScopeOnly = false,
+    managementFilters = {},
+    associationOptions = {},
 }: {
+    managementFilters?: {q?: string; state?: string; intent?: string};
+    associationOptions?: Record<string, {value: string | number; label: string}[]>;
     legacyContentEnabled?: boolean;
     documentAccessOnly?: boolean;
     editorialScopeOnly?: boolean;
@@ -206,12 +210,26 @@ export default function Manage({
 }) {
     const [editingId, setEditingId] = useState<number | null>(null);
     const [actionError, setActionError] = useState('');
+    const [query, setQuery] = useState(managementFilters.q ?? '');
+    const [stateFilter, setStateFilter] = useState(managementFilters.state ?? '');
+    const { flash } = usePage<{flash?: {uploaded_document_id?: string}}>().props;
     const upload = useForm<{
         file: File | null;
         original_source: string;
         issuer: string;
-    }>({ file: null, original_source: '', issuer: '' });
-    const form = useForm<ResourceForm>(emptyResource());
+        intent: string;
+    }>({ file: null, original_source: '', issuer: '', intent: managementFilters.intent ?? 'document' });
+    const form = useForm<ResourceForm>({...emptyResource(), ...(managementFilters.intent === 'legislation' ? {document_type: 'legislation', legislation: true} : {})});
+    const chooseDocument = (id: string) => {
+        const document = documents.find((item) => item.id === id);
+        form.setData((current) => ({...current, document_id: id,
+            issuer: current.issuer || document?.issuer || '',
+            title: current.title || document?.file_name || '',
+        }));
+    };
+    useEffect(() => {
+        if (flash?.uploaded_document_id && !editingId && !form.data.document_id) chooseDocument(flash.uploaded_document_id);
+    }, [flash?.uploaded_document_id]);
     const setAssociation = (
         index: number,
         key: keyof Association,
@@ -361,6 +379,7 @@ export default function Manage({
                     ))}
             </section>
             <form
+                id="receber"
                 className="space-y-4 rounded border p-5"
                 onSubmit={(e) => {
                     e.preventDefault();
@@ -420,6 +439,7 @@ export default function Manage({
             </form>
 
             {!documentAccessOnly && <>
+            {managementFilters.intent === 'legislation' && <p className="rounded border p-4">Nova legislação: reutilize o original, complete diploma/tipo, entidade emitente, número, datas e âmbito. Registe alterações e revogações nas associações. Publicar para consulta não activa cálculos no simulador.</p>}
             <form
                 className="space-y-4 rounded border p-5"
                 onSubmit={(e) => {
@@ -458,9 +478,7 @@ export default function Manage({
                         required
                         className={control}
                         value={form.data.document_id}
-                        onChange={(e) =>
-                            form.setData('document_id', e.target.value)
-                        }
+                        onChange={(e) => chooseDocument(e.target.value)}
                     >
                         <option value="">
                             Seleccionar ficheiro ou registo existente
@@ -925,6 +943,8 @@ export default function Manage({
                                                     'document',
                                                     'investment_type',
                                                     'legal_source',
+                                                    'sector',
+                                                    'opportunity',
                                                     'requirement',
                                                 ]
                                                     .filter(
@@ -934,8 +954,8 @@ export default function Manage({
                                                             requirementAssociationsEnabled,
                                                     )
                                                     .map((v) => (
-                                                        <option key={v}>
-                                                            {v}
+                                                        <option key={v} value={v}>
+                                                            {({theme:'Tema', module:'Módulo',activity:'Actividade',stage:'Etapa',procedure:'Procedimento',entity:'Entidade',territory:'Território',document:'Documento / diploma',investment_type:'Modalidade de investimento',legal_source:'Fonte legal',requirement:'Requisito',sector:'Sector',opportunity:'Oportunidade'} as Record<string,string>)[v] ?? v}
                                                         </option>
                                                     ))}
                                             </select>
@@ -974,6 +994,12 @@ export default function Manage({
                                                         ),
                                                     )}
                                                 </select>
+                                            ) : associationOptions[association.target_type] ? (
+                                                <select className={control} required value={association.target_key} onChange={(e) => setAssociation(index, 'target_key', e.target.value)}>
+                                                    <option value="">Seleccione um registo existente</option>
+                                                    {association.target_key && !associationOptions[association.target_type].some((o) => String(o.value) === association.target_key) && <option value={association.target_key}>Referência histórica guardada</option>}
+                                                    {associationOptions[association.target_type].map((o) => <option key={o.value} value={o.value}>{o.label}</option>)}
+                                                </select>
                                             ) : (
                                                 <input
                                                     required
@@ -1221,13 +1247,20 @@ export default function Manage({
                 </section>
             )}
 
-            <h2 className="text-xl font-bold">
+            <h2 id="conteudos" className="text-xl font-bold">
                 Registos, pendências e duplicados por rever
             </h2>
+            <form className="flex flex-wrap gap-3 rounded border p-4" aria-label="Pesquisar conteúdos" onSubmit={(e) => {e.preventDefault(); router.get('/management/portal-services', {q:query,state:stateFilter}, {preserveState:true,preserveScroll:true});}}>
+                <Field label="Pesquisar título, ficheiro, número ou entidade"><input className={control} value={query} onChange={(e) => setQuery(e.target.value)} /></Field>
+                <Field label="Estado do conteúdo"><select className={control} value={stateFilter} onChange={(e) => setStateFilter(e.target.value)}><option value="">Todos</option><option value="draft">Rascunhos</option><option value="published">Publicados</option><option value="withdrawn">Retirados</option></select></Field>
+                <button className={button}>Pesquisar conteúdos</button>
+            </form>
+            <p>Mostram-se até 200 registos por pesquisa. Refine o título ou o estado para localizar conteúdos anteriores.</p>
+            {!resources.length && <p role="status">Sem conteúdos correspondentes no seu âmbito de acesso.</p>}
             {resources.map((r) => (
                 <article key={r.id} className="space-y-3 rounded border p-4">
                     <h3 className="font-bold">
-                        {r.title} · {r.published ? 'Publicado' : 'Rascunho'}
+                        {r.title} · {r.published ? 'Publicado' : r.revisions.some((v) => ['unpublished', 'withdrawn'].includes(v.change_type)) ? 'Retirado' : 'Rascunho'}
                     </h3>
                     <p>
                         Ficheiro: {r.file_name} · {r.file_status} ·{' '}

resources/js/pages/portfolio/index.tsx

@@ -1,4 +1,5 @@
-import { Link, useForm } from '@inertiajs/react';
+import { Link, useForm, usePage } from '@inertiajs/react';
+import { searchTerritoryHref } from '@/lib/search-territory';
 import { catalogueDetailHref } from '@/lib/catalogue-context';
 import { Management } from '../management/shared';
 import type { Paginated } from '../management/shared';
@@ -35,6 +36,7 @@ export default function Index({
         locality_id: filters.locality_id ?? '',
     });
     const base = management ? '/management/portfolio' : '/carteira';
+    const { url } = usePage();
     const Frame = management ? Management : Layout;
     return (
         <Frame title="Corredores, clusters e projectos âncora">
@@ -151,7 +153,7 @@ export default function Index({
                             (r.corridor_id || r.cluster_id || r.project_id) && (
                                 <Link
                                     className="ml-4 underline"
-                                    href={`/oportunidades?${new URLSearchParams(r.corridor_id ? { corridor_id: r.corridor_id } : r.cluster_id ? { cluster_id: r.cluster_id } : { project_id: r.project_id! })}`}
+                                    href={searchTerritoryHref(`/oportunidades?${new URLSearchParams(r.corridor_id ? { corridor_id: r.corridor_id } : r.cluster_id ? { cluster_id: r.cluster_id } : { project_id: r.project_id! })}`, url)}
                                 >
                                     Ver oportunidades associadas
                                 </Link>
@@ -174,10 +176,10 @@ export default function Index({
                         aria-label="Alternativas de exploração"
                         className="flex flex-wrap gap-4"
                     >
-                        <Link className="underline" href="/oportunidades">
+                        <Link className="underline" href={searchTerritoryHref('/oportunidades', url)}>
                             Ver oportunidades publicadas
                         </Link>
-                        <Link className="underline" href="/zonas">
+                        <Link className="underline" href={searchTerritoryHref('/zonas', url)}>
                             Consultar ZEE, ZFI e parques
                         </Link>
                         <Link className="underline" href="/Simulador">

resources/js/pages/portfolio/show.tsx

@@ -1,6 +1,7 @@
 import { Link, useForm, router, usePage } from '@inertiajs/react';
 import { useState } from 'react';
 import { catalogueReturnHref } from '@/lib/catalogue-context';
+import { searchTerritoryHref } from '@/lib/search-territory';
 import InvestmentMapPanel from '@/components/investment-map-panel';
 import StructureGeographyPanel, {
     type StructureGeography,
@@ -190,7 +191,7 @@ function Editor({
                     </h2>
                     {zones.map((z) => (
                         <p key={z.id}>
-                            <Link className="underline" href={`/zonas/${z.id}`}>
+                            <Link className="underline" href={searchTerritoryHref(`/zonas/${z.id}`, pageUrl)}>
                                 {z.name}
                             </Link>{' '}
                             · {z.association_type} · Fonte: {z.source_reference}
@@ -297,7 +298,7 @@ function Editor({
                     <article key={opportunity.id}>
                         <Link
                             className="font-semibold underline"
-                            href={`/oportunidades/${opportunity.slug}?from_dossier=${record.id}`}
+                            href={searchTerritoryHref(`/oportunidades/${opportunity.slug}?from_dossier=${record.id}`, pageUrl)}
                         >
                             {opportunity.title}
                         </Link>
@@ -485,7 +486,7 @@ function Editor({
                         {kind(r)}:{' '}
                         <Link
                             className="underline"
-                            href={`${base}/${r.id}${management ? '' : `?from=${record.id}`}`}
+                            href={searchTerritoryHref(`${base}/${r.id}${management ? '' : `?from=${record.id}`}`, pageUrl)}
                         >
                             {r.title}
                         </Link>

resources/js/pages/profiles/administration.tsx

@@ -27,6 +27,10 @@ type SecurityEntry = {
 };
 type Pair = { first_user_id: number; second_user_id: number; version: number };
 type OperatorOrganization = { id: string; name: string; nuit: string; contact: string; director: string };
+type StaffAccount = {id: number; name: string; email: string; verified: boolean; mfa: boolean};
+function AccountPicker({accounts, value, onChange}: {accounts: StaffAccount[]; value: string; onChange: (value: string)=>void}) {
+    return <select required className={control} value={value} onChange={e=>onChange(e.target.value)}><option value="">Seleccionar conta existente</option>{accounts.map(a=><option key={a.id} value={a.id}>{a.name} — {a.email}{!a.verified ? ' — email por verificar' : !a.mfa ? ' — MFA por concluir' : ''}</option>)}</select>;
+}
 
 function OperatorOrganizationForm() {
     const [operationKey] = useState(createOperationKey);
@@ -60,7 +64,7 @@ function OperatorOrganizationForm() {
     </section>;
 }
 
-function InternalStaffGrant({ types, organizations, operators }: { types: string[]; organizations: { id: string; name: string }[]; operators: OperatorOrganization[] }) {
+function InternalStaffGrant({ types, organizations, operators, accounts }: { types: string[]; organizations: { id: string; name: string }[]; operators: OperatorOrganization[]; accounts: StaffAccount[] }) {
     const [operationKey, setOperationKey] = useState(createOperationKey);
     const [subject, setSubject] = useState('');
     const [role, setRole] = useState('promoter');
@@ -86,7 +90,7 @@ function InternalStaffGrant({ types, organizations, operators }: { types: string
         <h2 className="text-xl font-semibold">Atribuir função interna do portal</h2>
         <p>A proprietária define as funções da sua equipa. Esta atribuição não exige comprovativos de Promotor externo nem concede gestão empresarial. Cada oportunidade conserva o promotor real e a autorização de divulgação.</p>
         <form className="max-w-2xl space-y-3" onSubmit={e => { e.preventDefault(); void save(); }}>
-            <label className="block">Conta da pessoa designada<input required type="number" min={1} className={control} value={subject} onChange={e => setSubject(e.target.value)} /></label>
+            <label className="block">Conta da pessoa designada<AccountPicker accounts={accounts} value={subject} onChange={setSubject}/></label>
             <label className="block">Função interna<select aria-label="Função interna" required className={control} value={role} onChange={e => setRole(e.target.value)}>{['promoter', 'validator', 'publisher'].map(v => <option key={v} value={v}>{v === 'promoter' ? 'Promotor' : v === 'validator' ? 'Validador' : 'Publicador'}</option>)}</select></label>
             <label className="block">Vínculo à organização operadora<select aria-label="Vínculo à organização operadora" required className={control} value={operator} onChange={e => setOperator(e.target.value)}><option value="">Selecionar organização</option>{operators.map(o => <option key={o.id} value={o.id}>{o.name} — NUIT {o.nuit}</option>)}</select></label>
             {role !== 'promoter' && <label className="block">Âmbito da função interna<select aria-label="Âmbito da função interna" className={control} value={scope} onChange={e => setScope(e.target.value)}><option value="">Todas as organizações para as categorias selecionadas</option>{organizations.map(o => <option key={o.id} value={o.id}>{o.name}</option>)}</select></label>}
@@ -103,9 +107,11 @@ function InternalStaffGrant({ types, organizations, operators }: { types: string
 function Grant({
     types,
     organizations,
+    accounts,
 }: {
     types: string[];
     organizations: { id: string; name: string }[];
+    accounts: StaffAccount[];
 }) {
     const [user, setUser] = useState('');
     const [role, setRole] = useState('validator');
@@ -172,15 +178,8 @@ function Grant({
                 }}
             >
                 <label className="block">
-                    ID da conta existente
-                    <input
-                        className={control}
-                        type="number"
-                        min={1}
-                        required
-                        value={user}
-                        onChange={(e) => setUser(e.target.value)}
-                    />
+                    Conta existente
+                    <AccountPicker accounts={accounts} value={user} onChange={setUser}/>
                 </label>
                 <label className="block">
                     Papel
@@ -590,7 +589,9 @@ export default function Administration({
     securityRequests,
     operatorOrganizations,
     internalTypes,
+    staffAccounts,
 }: {
+    staffAccounts: StaffAccount[];
     operatorOrganizations: OperatorOrganization[];
     internalTypes: string[];
     actorId: number;
@@ -652,8 +653,8 @@ export default function Administration({
                 ))}
             </section>
             <OperatorOrganizationForm />
-            <InternalStaffGrant types={internalTypes} organizations={organizations} operators={operatorOrganizations} />
-            <Grant types={types} organizations={organizations} />
+            <InternalStaffGrant types={internalTypes} organizations={organizations} operators={operatorOrganizations} accounts={staffAccounts} />
+            <Grant types={types} organizations={organizations} accounts={staffAccounts} />
             <Security
                 pair={pair}
                 entries={securityRequests}

routes/web.php

@@ -62,6 +62,7 @@ Route::get('/explorar/{sectorSlug}', [LegacyContentController::class, 'landing']
 Route::get('/{legacySlug}', [LegacyContentController::class, 'article'])->whereIn('legacySlug', array_keys(config('legacy_content.articles', [])));
 Route::post('/apoio', [PortalServicesController::class, 'submit'])->middleware('throttle:10,1')->name('services.submit');
 Route::middleware(['auth', 'verified'])->group(function () {
+    Route::get('/gestao-conteudos', fn (\Illuminate\Http\Request $request) => Inertia::render('management/content-hub', app(\App\Services\ContentManagement::class)->view($request->user())))->name('content-management');
     Route::get('/balcao-virtual', [PortalServicesController::class, 'page'])->defaults('page', 'desk')->name('services.desk');
     Route::post('/parcerias', [PortalServicesController::class, 'partnership'])->middleware('throttle:10,1')->name('services.partnership');
 });
@@ -172,6 +173,9 @@ Route::middleware(['auth', 'verified', EnsurePortalProfiles::class])->group(func
     Route::get('/minhas-oportunidades/{id}/classification', [OpportunityClassificationController::class, 'index'])->whereNumber('id');
     Route::post('/minhas-oportunidades/{id}/classification/review', [OpportunityClassificationController::class, 'review'])->whereNumber('id');
     Route::post('/minhas-oportunidades/{id}/workflow', [$profiles, 'workflow'])->whereNumber('id');
+    Route::get('/minhas-oportunidades/{id}/divulgacao', [\App\Http\Controllers\OpportunityPromotionController::class, 'show'])->whereNumber('id');
+    Route::post('/minhas-oportunidades/{id}/divulgacao/previa', [\App\Http\Controllers\OpportunityPromotionController::class, 'preview'])->whereNumber('id');
+    Route::post('/minhas-oportunidades/{id}/divulgacao/confirmar', [\App\Http\Controllers\OpportunityPromotionController::class, 'confirm'])->whereNumber('id');
     Route::post('/minhas-oportunidades/{id}/contacts', [$profiles, 'contact'])->whereNumber('id');
     Route::get('/minhas-oportunidades/{id}/resources', [OpportunityResourceController::class, 'index'])->whereNumber('id');
     Route::post('/minhas-oportunidades/{id}/library-support', [OpportunityResourceController::class, 'reuseLibrary'])->whereNumber('id');

tests/Feature/CatalogueSelectorReferencesTest.php

@@ -0,0 +1,93 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Services\InvestmentCatalogue;
+use App\Services\InvestmentZones;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+use Tests\TestCase;
+
+class CatalogueSelectorReferencesTest extends TestCase
+{
+    use DatabaseTransactions;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $db = DB::selectOne('select current_database() as name, inet_server_port() as port');
+        $this->assertSame('simulator_fiscal_delta_20261021_test', $db->name);
+        $this->assertSame(55441, (int) $db->port);
+        $this->withoutVite();
+    }
+
+    public function test_public_parks_remain_selectable_with_zero_results_without_exposing_private_or_other_territories(): void
+    {
+        $province = '059b02ca-7095-577a-8705-4d4c46896747';
+        $template = app(InvestmentZones::class)->visible()->firstOrFail();
+        $ids = [];
+        foreach (['public', 'private', 'other'] as $case) {
+            $zone = $template->replicate();
+            $zone->id = (string) Str::uuid();
+            $zone->code = 'SINT-SELECTOR-'.Str::random(12);
+            $zone->name = 'SINTÉTICO QA '.$case;
+            $zone->category = 'industrial_park';
+            $zone->primary_territory_id = $case === 'other' ? '9e42dac8-fd9b-523f-bf59-71a7d3aa0fb8' : $province;
+            $zone->publication_status = $case === 'private' ? 'draft' : 'published';
+            $zone->source_evidence = [['source_type' => 'government', 'url' => 'https://example.test/qa-only', 'supports' => 'Synthetic QA fixture, not a legal source']];
+            $zone->save();
+            $ids[$case] = $zone->id;
+        }
+        $scope = ['province_id' => $province, 'park_id' => $ids['public'], 'q' => 'no-matching-opportunity-'.Str::uuid()];
+        $this->assertSame(0, app(InvestmentCatalogue::class)->query($scope)->count());
+        $response = $this->getJson('/api/v1/investment/references?'.http_build_query($scope))->assertOk();
+        $available = array_column($response->json('zones'), 'id');
+        $this->assertContains($ids['public'], $available);
+        $this->assertNotContains($ids['private'], $available);
+        $this->assertNotContains($ids['other'], $available);
+        $this->assertContains($ids['other'], array_column($this->getJson('/api/v1/investment/references')->assertOk()->json('zones'), 'id'));
+        $this->get('/zonas/'.$ids['public'])->assertOk();
+        $this->get('/zonas/'.$ids['private'])->assertNotFound();
+    }
+
+    public function test_activity_catalogue_does_not_disappear_when_opportunity_search_has_no_matches(): void
+    {
+        $catalogue = app(InvestmentCatalogue::class);
+        $global = collect($catalogue->references()['classification']['targets']['activity'])->pluck('id')->all();
+        $this->assertNotEmpty($global);
+        foreach (['059b02ca-7095-577a-8705-4d4c46896747', '9e42dac8-fd9b-523f-bf59-71a7d3aa0fb8'] as $province) {
+            $scope = ['province_id' => $province, 'q' => 'no-matching-opportunity-'.Str::uuid(), 'sector' => 'tourism'];
+            $this->assertSame(0, $catalogue->query($scope)->count());
+            $this->assertSame($global, collect($catalogue->references(false, $scope)['classification']['targets']['activity'])->pluck('id')->all());
+        }
+    }
+
+    public function test_public_master_structures_and_chain_are_available_without_opportunities_or_published_dossiers(): void
+    {
+        $province = '059b02ca-7095-577a-8705-4d4c46896747';
+        $clusters = [];
+        foreach (['public', 'internal'] as $visibility) {
+            $id = (string) Str::uuid();
+            DB::table('economic_clusters')->insert(['id' => $id, 'code' => 'SINT-'.Str::random(12), 'name' => 'SINTÉTICO QA cluster',
+                'sector' => 'QA', 'status' => 'active', 'data_classification' => $visibility, 'primary_territory_id' => $province]);
+            $clusters[$visibility] = $id;
+        }
+        $corridor = (string) Str::uuid();
+        DB::table('development_corridors')->insert(['id' => $corridor, 'code' => 'SINT-'.Str::random(12), 'name' => 'SINTÉTICO QA corredor',
+            'status' => 'active', 'data_classification' => 'public', 'primary_territory_id' => $province]);
+        $project = \App\Models\Project::factory()->create(['data_classification' => 'public', 'primary_territory_id' => $province]);
+        $chain = (string) Str::uuid();
+        DB::table('value_chains')->insert(['id' => $chain, 'cluster_id' => $clusters['public'], 'code' => 'SINT-'.Str::random(12),
+            'name' => 'SINTÉTICO QA cadeia', 'stage' => 'production', 'data_classification' => 'public']);
+        $refs = app(InvestmentCatalogue::class)->references(false, ['province_id' => $province, 'q' => 'no-matching-opportunity']);
+        $this->assertContains($clusters['public'], $refs['clusters']->pluck('id')->all());
+        $this->assertNotContains($clusters['internal'], $refs['clusters']->pluck('id')->all());
+        $this->assertContains($corridor, $refs['corridors']->pluck('id')->all());
+        $this->assertContains($project->id, $refs['projects']->pluck('id')->all());
+        $this->assertContains($chain, collect($refs['classification']['targets']['chain'])->pluck('id')->all());
+        $other = app(InvestmentCatalogue::class)->references(false, ['province_id' => '9e42dac8-fd9b-523f-bf59-71a7d3aa0fb8']);
+        $this->assertNotContains($clusters['public'], $other['clusters']->pluck('id')->all());
+        $this->assertNotContains($chain, collect($other['classification']['targets']['chain'])->pluck('id')->all());
+    }
+}