docs: record sequential competitiveness installation and preservation

feat(clusters): prepare evidence-based five forces analysis
feat: expose guided manual IVA and IRPC form preparation
2026-10-29 13:11:31 +02:00 · 2026-10-29 13:03:02 +02:00 · 2026-10-28 21:54:25 +02:00 · 2026-10-28 21:43:46 +02:00 · 2026-10-28 21:35:21 +02:00 · 2026-10-28 21:26:59 +02:00
66 changed files with 4005 additions and 279 deletions
@@ -29,7 +29,7 @@ class InvestmentDiscoveryController extends Controller
            'corridorGroups' => ($filters['view'] ?? '') === 'corridors' ? app(\App\Services\OpportunityCorridorExplorer::class)->groups($filters) : [],
            'territorySelection' => app(InvestmentGeography::class)->selection($filters),
            'guides' => app(\App\Services\SectorInvestment::class)->guides(\App\Models\Sector::where('slug', $filters['sector'] ?? '')->where('is_active', true)->whereNotNull('published_at')->first()),
-            'results' => $catalogue->query($filters)->paginate(12)->withQueryString(),
+            'results' => $catalogue->query($filters)->paginate(12)->withQueryString()->through(fn ($record) => $catalogue->presentLocation($record)),
            'favourites' => $request->user() ? DB::table('opportunity_favourites')->where('user_id', $request->user()->id)->pluck('opportunity_id') : [],
            'territorial' => $this->territorial($filters)]);
    }
@@ -74,7 +74,7 @@ class InvestmentDiscoveryController extends Controller

    public function search(Request $request, InvestmentCatalogue $catalogue): JsonResponse
    {
-        return response()->json($catalogue->query($catalogue->filters($request))->paginate($request->integer('per_page', 12))->withQueryString());
+        return response()->json($catalogue->query($catalogue->filters($request))->paginate($request->integer('per_page', 12))->withQueryString()->through(fn ($record) => $catalogue->presentLocation($record)));
    }

    public function references(Request $request, InvestmentCatalogue $catalogue): JsonResponse
@@ -48,13 +48,15 @@ class HandleInertiaRequests extends Middleware
     */
    public function share(Request $request): array
    {
+        $contentManagementAccess=app(\App\Services\ContentManagement::class)->access($request->user());
        return [
            ...parent::share($request),
            'name' => config('app.name'),
            'procurementEnabled' => app(\App\Services\Procurement::class)->available(),
            'homologationReserved' => (bool) config('portal.homologation_only', false),
            'profileAccess' => app(PortalProfileAccess::class)->navigation($request->user()),
-            'contentManagementHref' => app(\App\Services\ContentManagement::class)->access($request->user()) !== [] ? '/gestao-conteudos' : null,
+            'contentManagementHref' => $contentManagementAccess !== [] ? '/gestao-conteudos' : null,
+            'contentManagementAccess'=>$contentManagementAccess,
            'portalOperator' => config('portal.operator_name'),
            'portalInstitutionalContactEmail' => filter_var(config('portal.institutional_contact_email'), FILTER_VALIDATE_EMAIL) ?: null,
            'legacyContentEnabled' => app(LegacyContent::class)->available(),
@@ -83,6 +85,7 @@ class HandleInertiaRequests extends Middleware
            'auth' => [
                'user' => $request->user(),
                'canManagePortal' => $request->user()?->can('manage-portal') ?? false,
+                'legacyManagementAccess' => $request->user()?->hasVerifiedEmail() && app(PortalProfileAccess::class)->legacyWriteAllowed($request->user()),
            ],
            'sidebarOpen' => ! $request->hasCookie('sidebar_state') || $request->cookie('sidebar_state') === 'true',
        ];
@@ -71,7 +71,9 @@ class InvestmentCatalogue
        } elseif (($filters['territory_basis'] ?? 'all') === 'context') {
            $query->whereNull('opportunities.primary_territory_id')->whereNotExists(fn ($l) => $l->selectRaw('1')->from('opportunity_locations')->whereColumn('opportunity_id', 'opportunities.id'));
            $query->where(fn ($q) => $q->whereExists(fn ($l) => $l->selectRaw('1')->from('opportunity_projects')->whereColumn('opportunity_id', 'opportunities.id')->whereIn('project_id', app(InvestmentRelations::class)->projectIds()))
-                ->orWhereExists(fn ($l) => $l->selectRaw('1')->from('opportunity_clusters')->whereColumn('opportunity_id', 'opportunities.id')->whereIn('cluster_id', $this->publicStructureIds('clusters', 'cluster_id'))));
+                ->orWhereExists(fn ($l) => $l->selectRaw('1')->from('opportunity_clusters')->whereColumn('opportunity_id', 'opportunities.id')->whereIn('cluster_id', $this->publicStructureIds('clusters', 'cluster_id')))
+                ->orWhere(fn ($source) => $source->where('workflow_context->corridor_agribusiness->source_sha256', CorridorAgribusinessOpportunities::SOURCE_HASH)
+                    ->whereIn('workflow_context->corridor_agribusiness->corridor', array_column(config('investment_corridors', []), 'name'))));
        }
        if (! empty($filters['opportunity_id'])) {
            $query->whereKey($filters['opportunity_id']);
@@ -80,12 +82,13 @@ class InvestmentCatalogue
        $includeNational = filter_var($filters['include_national'] ?? false, FILTER_VALIDATE_BOOLEAN);
        if ($path !== []) {
            $ids = app(InvestmentGeography::class)->descendants($path[array_key_last($path)]->id);
-            $query->where(function ($territory) use ($ids, $includeNational, $filters): void {
+            $query->where(function ($territory) use ($ids, $includeNational, $filters, $path): void {
                $territory->whereIn('opportunities.primary_territory_id', $ids)
                    ->orWhereExists(fn ($locations) => $locations->selectRaw('1')->from('opportunity_locations as territory_link')
                        ->whereColumn('territory_link.opportunity_id', 'opportunities.id')->whereIn('territory_link.geo_location_id', $ids));
                if (($filters['territory_basis'] ?? 'all') !== 'direct') {
                    app(InvestmentRelations::class)->opportunityTerritories($territory, $ids);
+                    if (count($path) === 1) $this->approvedCorridorProvince($territory, $path[0]->id);
                }
                if ($includeNational) {
                    $territory->orWhere('opportunities.geography_scope', 'national');
@@ -162,6 +165,9 @@ class InvestmentCatalogue
                                ->whereNull('target.deleted_at')->where('target.data_classification', 'public'));
                        if (($filters['territory_basis'] ?? 'all') !== 'direct') {
                            app(InvestmentRelations::class)->opportunityTerritories($matches, $locationIds ?? []);
+                            if (app(InvestmentGeography::class)->publicReferences()->where('id', $filters['geo_location_id'])->where('location_type', 'province')->exists()) {
+                                $this->approvedCorridorProvince($matches, $filters['geo_location_id']);
+                            }
                        }
                    });

@@ -212,6 +218,38 @@ class InvestmentCatalogue
        };
    }

+    private function approvedCorridorProvince($query, string $provinceId): void
+    {
+        $code = app(InvestmentGeography::class)->publicReferences()->where('id', $provinceId)->value('source_code');
+        $names = [];
+        foreach (config('investment_corridors', []) as $entry) {
+            if (in_array($code, $entry['provinces'], true)) $names[] = $entry['name'];
+        }
+        if (!$names) return;
+        $query->orWhere(fn ($context) => $context->whereNull('opportunities.primary_territory_id')
+            ->whereNotExists(fn ($link) => $link->selectRaw('1')->from('opportunity_locations')->whereColumn('opportunity_id', 'opportunities.id'))
+            ->where('workflow_context->corridor_agribusiness->source_sha256', CorridorAgribusinessOpportunities::SOURCE_HASH)
+            ->whereIn('workflow_context->corridor_agribusiness->corridor', $names));
+    }
+
+    /** Public result presentation only; no editorial or territorial data is saved. */
+    public function presentLocation(Opportunity $record): Opportunity
+    {
+        $geo = app(InvestmentGeography::class);
+        $paths = [];
+        $ids = array_filter([$record->primary_territory_id, ...$record->additionalTerritories()->pluck('geo_locations.id')->all()]);
+        foreach (array_unique($ids) as $id) {
+            $path = $geo->path($id);
+            if ($path) $paths[] = implode(' / ', array_column($path, 'name'));
+        }
+        if ($paths) $label = implode('; ', array_unique($paths));
+        elseif ($provinces = app(InvestmentCorridorContext::class)->catalogueProvinces($record)) {
+            $label = implode(' / ', array_column($provinces, 'name')).' — contexto provincial do corredor; distrito e posto administrativo não indicados';
+        } else $label = implode(' / ', array_filter([$record->province, $record->district])) ?: 'Localização não indicada';
+        $record->setAttribute('territorial_summary', $label);
+        return $record;
+    }
+
    /** @param array<string,mixed> $territoryFilters
     * @return array<string,mixed> */
    public function references(bool $management = false, array $territoryFilters = []): array
@@ -429,7 +467,7 @@ class InvestmentCatalogue
        $located = 0;
        foreach ($records as $record) {
            $properties = ['id' => $record->id, 'title' => $record->title, 'category' => $record->sector?->name,
-                'location' => trim($record->province.' '.$record->district), 'url' => '/oportunidades/'.$record->slug.($filters === [] ? '' : '?'.http_build_query($filters))];
+                'location' => $this->presentLocation($record)->getAttribute('territorial_summary'), 'url' => '/oportunidades/'.$record->slug.($filters === [] ? '' : '?'.http_build_query($filters))];
            foreach ($relations as $relation => $groups) {
                $properties[$relation] = ($groups->get($record->id) ?? collect())->pluck('name')->unique()->values()->all();
            }
@@ -14,6 +14,15 @@ final class InvestmentCorridorContext
        return null;
    }

+    /** Reuse Tempo's approved provincial context; never infer a district or master link. */
+    public function catalogueProvinces(Opportunity $record): array
+    {
+        if (data_get($record->workflow_context, 'corridor_agribusiness.source_sha256') !== CorridorAgribusinessOpportunities::SOURCE_HASH) return [];
+        if ($record->primary_territory_id || $record->additionalTerritories()->exists()) return [];
+        $key = $this->key($record);
+        return $key ? $this->provinces($key) : [];
+    }
+
    public function provinces(string $key): array
    {
        $entry = config('investment_corridors.'.$key);
@@ -63,10 +63,13 @@ class InvestmentZones
        $path = app(InvestmentGeography::class)->selection($filters);
        if ($path !== []) {
            $territoryIds = app(InvestmentGeography::class)->descendants($path[array_key_last($path)]->id);
-            $query->where(function ($matches) use ($territoryIds, $management): void {
+            $ancestorIds = array_column($path, 'id');
+            $query->where(function ($matches) use ($territoryIds, $ancestorIds, $management): void {
                $matches->whereIn('primary_territory_id', $territoryIds)
                    ->orWhereExists(fn ($link) => $link->selectRaw('1')->from('investment_zone_locations as zl')
-                        ->whereColumn('zl.zone_id', 'investment_zones.id')->whereIn('zl.geo_location_id', $territoryIds)
+                        ->whereColumn('zl.zone_id', 'investment_zones.id')->whereIn('zl.scope_type', ['site', 'administrative', 'legal_scope'])
+                        ->where(fn ($area) => $area->whereIn('zl.geo_location_id', $territoryIds)
+                            ->orWhere(fn ($coverage) => $coverage->where('zl.scope_type', 'legal_scope')->whereIn('zl.geo_location_id', $ancestorIds)))
                        ->where('zl.validation_status', 'validated')->where(fn ($valid) => $valid->whereNull('zl.valid_from')->orWhereDate('zl.valid_from', '<=', today()))
                        ->where(fn ($valid) => $valid->whereNull('zl.valid_until')->orWhereDate('zl.valid_until', '>=', today())));
                if (! $management) {
@@ -35,8 +35,11 @@ final class OpportunityCorridorExplorer
            $path = collect($context['primary_territory_path'] ?? []);
            $province = $path->firstWhere('location_type', 'province')->name ?? $record->province;
            $district = $path->firstWhere('location_type', 'district')->name ?? $record->district;
+            $contextProvinces = app(InvestmentCorridorContext::class)->catalogueProvinces($record);
+            $provinceOptions = $province ? [$province] : array_column($contextProvinces, 'name');
            $item = ['id' => $record->id, 'title' => $record->title, 'slug' => $record->slug, 'summary' => $record->summary,
-                'province' => $province, 'district' => $district, 'chains' => array_values(array_unique($chains)),
+                'province' => $province, 'district' => $district, 'provinces' => $provinceOptions,
+                'territorial_summary' => $catalogue->presentLocation($record)->getAttribute('territorial_summary'), 'chains' => array_values(array_unique($chains)),
                'stages' => $stages, 'maturity_label' => $record->maturity_label];
            foreach ($corridors ?: ['other' => 'Outras localizações'] as $key => $name) {
                $groups[$key] ??= ['id' => $key, 'name' => $name, 'opportunities' => []];
@@ -47,6 +47,7 @@ final class SectorInvestment

    public function publicView(Sector $sector): array
    {
+        $creation = app(ContentManagement::class)->access(request()->user())['opportunities']['create'] ?? null;
        $query = SectorOrganization::opportunities($sector);
        $articles = $this->guides($sector);
        $relations = [];
@@ -67,7 +68,8 @@ final class SectorInvestment
        return ['articles' => $articles, 'relations' => collect($relations)->unique('id')->values()->all(), 'locations' => $locations,
            'start_href' => app(InvestorPath::class)->available() ? '/investimentos/a-partir-do-setor/'.$sector->slug : null,
            'start_notice' => app(InvestorPath::class)->available() ? null : 'O percurso para guardar a ideia está temporariamente indisponível. A consulta e o apoio continuam disponíveis.',
-            'register_href' => app(PortalProfileAccess::class)->available() ? '/minhas-oportunidades/create?sector_id='.$sector->id : null,
+            'register_href' => app(PortalProfileAccess::class)->available() ? ($creation ? $creation.'?sector_id='.$sector->id : '/perfil/promotor') : null,
+            'register_label' => $creation ? 'Cadastrar oportunidade — escolher modalidade' : 'Pedir acesso para cadastrar oportunidades',
            'register_notice' => app(PortalProfileAccess::class)->available() ? null : 'O cadastro por perfis está temporariamente indisponível; pode preparar a ideia e contactar o apoio.',
            'specialization_href' => in_array($sector->slug, ['tecnologias-de-informacao', 'mercado-financeiro'], true) ? SectorOrganization::href('fintech') : null,
            'content_notice' => $sector->slug === 'mercado-financeiro' ? 'O artigo geral de Mercado Financeiro permanece vazio e não foi publicado. A preparação de negócios neste setor está disponível.' : null];
@@ -1702,3 +1702,144 @@ CI habitual do instalador: PostgreSQL1/3106asserções, Unit59/317, frontend1146
 `6d147693` está instalado, incluindo a base interna. A única pendência da conferência desta entrega é a validação visual autenticada: **Gurué → consultar oferta → comparar ideia → guardar → recuperar no mesmo dossier**, conservando fonte, data e incertezas. As435 observações de Gurué não são435 empresas únicas. Listas internas, cobertura nacional parcial e hipótese de investimento mantêm-se.

 O erro actual, novamente observado, é **“The browser access host is unavailable”**: indisponibilidade do host do conector, distinta de deixar uma aba aberta. A orientação anterior para apenas manter a aba aberta era insuficiente. Restabelecer o conector por mecanismo suportado ou realizar a conferência pela equipa. Não reinstalar nem repetir as provas técnicas aceites; não declarar conferência visual concluída sem o seu resultado. O recibo remoto original e o historial do diagnóstico anterior ficam preservados; esta correcção é documental.
+
+
+## 28/10/2026 — revisão de menus: inventário antes da verificação do delta
+
+Origem: recomendação expressa da Tempo após constatar que as entradas indicadas não aparecem ou ficam escondidas. Página relatada:https://teste-investidor.tempo.co.mz/. Preservados6d147693 e a base privada instalada,as provas QA do percurso e da navegação sectorial,os originais,dados,perfis,permissões e históricos. Não se declara uma funcionalidade anterior desaparecida apenas pela ausência de um novo teste.
+
+Confirmado no código: barra lateral substitui cada grupo pelo seu primeiro destino,omitindo os restantes;menu principal esconde gestão/perfis dentro do menu do nome do utilizador;entrada de gestão de conteúdos existente não é incorporada nessa navegação principal. A conta e os props efectivos da sessão real permanecem por conferir,porque o conector está indisponível;não se presume falta de autorização.
+
+Incremento em QA: área de trabalho explícita no menu principal,inclusive entrada neutra de acesso;destinos privados apenas segundo capacidades anteriores;mesmo catálogo completo na barra lateral,sem perda dos subdestinos;entrada directa na análise proactiva existente,sem substituir rascunhos editados;preservação de Descoberta/Realização/Suporte e todos os destinos anteriores aplicáveis. Sem alteração activa,schema,regras de negócio ou papéis. Escolhas de apresentação não são exigências organizacionais. Verificação dirigida do delta pendente nesta fotografia;nenhuma nova matriz ou backlog.
+
+
+## 28/10/2026 — reorganização dos menus implementada em QA, sem instalação
+
+Recomendação expressa da Tempo após a página principal não apresentar as entradas sugeridas. Causa delimitada no código: a barra lateral omitia subdestinos ao seleccionar apenas o primeiro link de cada grupo; a navegação principal colocava gestão/perfis dentro do menu do nome do utilizador e não incorporava a entrada de gestão já calculada pelo servidor. Não se presume falta de permissões da sessão real, cujos props não foram observados. A entrega6d147693/base interna continua instalada e preservada; esta revisão não reinstala essa base nem repete as provas técnicas aceites.
+
+**Proposta executável QA:** Área de trabalho visível ao lado de Descoberta,Realização,Suporte; entrada neutra Acesso à gestão explica o estado, mesmo sem acções privadas atribuídas. As acções autorizadas e Preparar análise e ideia vêm das capacidades existentes, sem criar papéis. A análise abre directamente no formulário existente; rascunhos guardados não são substituídos. A barra lateral põe trabalho primeiro e conserva todos os destinos e os filtros territoriais entre catálogos, em vez de reduzir grupos ao primeiro destino. O cabeçalho permite quebra de linha em largura intermédia; os controlos móveis e do teclado existentes são reutilizados.
+
+**Verificação delimitada:**16 testes de navegação/renderização estrutural,0falhas;tipos,compilação QA e sintaxe PHP passaram. Quatro cenários de capacidades conservaram todos os destinos anteriores; não surgem operações privadas em cenário anónimo ou sem atribuições. SSR usa o componente real da barra lateral com wrappers semânticos de teste; não equivale a captura do navegador. A prévia HTML é um inventário interactivo de destinos, sem pedidos ao portal, identificado como proposta QA, não como sessão real.
+
+**Pendente:** conferência visual desktop/móvel/teclado/toque e das capacidades efectivas da sessão relatada; o host do conector permanece indisponível no último diagnóstico. Não substituir essa conferência por alegação de acesso demonstrado. A instalação futura deve transportar só o delta de menus pelo processo Git/backup/restauro existente, preservando originais, dados, permissões, contexto,dossier e simulador.435 observações de Gurué não são435empresas únicas; listas internas/cobertura parcial/hipótese preservadas. L8 continua parcial.
+
+Inventário anterior registado antes dos testes nesta matriz/manual. Actualização apenas nos requisitos existentesV2-01,V2-07,V2-10,MASTER-9dee08d0-0011,MASTER-9f6dd1d9-0001,MASTER-9f6dd1d9-0003,MASTER-02f44baf-0002;não há matriz ou backlog novos. Relatório:`navigation-reconciliation-qa-20261028.json`;prévia:`outputs/navigation-reconciliation-20261028/menu-proposta-qa.html`.
+
+A apresentação da gestão antiga usa agora a decisão efectiva já existente (`legacyWriteAllowed`, com o requisito de email verificado das rotas), em vez de presumir que o indicador genérico de gestor basta. Não se alteraram regras, atribuições ou permissões. Preservada também a entrada de instalação de perfis anteriormente presente apenas na barra lateral autorizada. Os nomes longos quebram linha na barra lateral, sem reticências que escondam a função.
+
+
+## 28/10/2026 — menus 6e8de43a instalados pelo Git; conferência visual pendente
+
+A Tempo aprovou a proposta QA e autenticou o transporte SSH existente. `main` avançou normalmente de `6d147693` para `6e8de43a`, sem force. A entrega usou o pipeline existente, sem alterar o seu contrato de schema, sem migrações, importações, atribuições de papéis ou permissões. Os 16 testes dirigidos e as provas QA aceites foram reutilizados; as verificações automáticas obrigatórias do pipeline não representam nova aceitação funcional.
+
+Capacidade conferida antes da entrega: cerca de 78,5 GiB livres. Backup novo em `/var/backups/investmoz-navigation-delivery-20261028/backup`; restauro em base isolada, sem rede, confirmou as 176 tabelas por contagens/checksums. Os 369 ficheiros persistentes/configuração mantêm-se idênticos. As tabelas de domínio, incluindo base interna, relações e permissões, foram comparadas com o snapshot do backup; apenas alterações operacionais de cache/sessão são registadas separadamente. A versão anterior está preservada para retorno pelo mecanismo existente.
+
+O delta instalado contém Área de trabalho no nível principal, destinos subordinados completos na barra lateral e continuidade para os destinos existentes de investimento, conteúdos e acompanhamento. A exposição das acções respeita a decisão efectiva do servidor; não se infere nova autorização pelo nome genérico de gestor. A presença dos assets e props instalados foi conferida tecnicamente, sem a apresentar como prova da sessão real.
+
+Pendente: conferência visual autenticada desktop/móvel/teclado/toque e percurso Gurué → consultar oferta → comparar ideia → guardar → recuperar no mesmo dossier. Último bloqueio conhecido: `The browser access host is unavailable`; uma aba aberta não restabelece o host. Não repetir as provas QA aceites nem reinstalar a base interna para resolver essa pendência. As 435 observações de Gurué não equivalem a 435 empresas únicas; listas internas, cobertura parcial e hipótese de investimento mantêm-se explícitas. L8 permanece parcial.
+
+Evidência: `docs/investmoz/unification/navigation-git-delivery-20261028.json`. O relatório QA anterior permanece como histórico do candidato antes da instalação. Actualizados os mesmos sete requisitos existentes, preservando o seu histórico; não foi criada outra matriz.
+# Inventário antes da verificação — catálogo territorial, 28/10/2026
+
+Preservar menus `6e8de43a`, dados, base interna, aprovações, configuração de corredores e históricos já aceites. Caso Maputo Província / Agronegócio reproduzido por leitura QA: zero resultados apesar de cinco oportunidades públicas do Corredor de Maputo, cujo âmbito provincial está aprovado desde 23/10 em `corridor-adaptive-context-20261023.json`. A consulta não inclui esse contexto; os cartões também não mostram todos os níveis territoriais disponíveis. Correcção delimitada nos requisitos existentes V2-07/V2-10, sem inferir distrito/posto administrativo onde a fonte não os indica. Conferência visual autenticada continua pendente; não há nova matriz nem reabertura de provas aceites.
+
+
+## 28/10/2026 — correcção provincial do catálogo em QA, ainda sem instalação
+
+Caso da Tempo: Agronegócio / Maputo Província. A leitura QA reproduziu zero resultados para cinco oportunidades públicas do Corredor de Maputo. Reutilizada a decisão expressa de 23/10 que abrange Maputo Província e Maputo Cidade, antes disponível no percurso mas omitida na consulta. O filtro provincial passa a incluir esse contexto aprovado, mantendo sector e estado público, sem duplicar oportunidades nem atribuir distrito/posto administrativo ou coordenadas inexistentes. Uma localização explícita posterior prevalece sobre o contexto antigo.
+
+Os resultados apresentam a hierarquia territorial disponível; o contexto de corredor é identificado e os níveis não indicados continuam explícitos. Pesquisa/API, vista por corredores e lista sem coordenadas do mapa concordam. O atalho «Ver toda a província» elimina a necessidade de limpar vários níveis manualmente. Não foram criadas publicações, relações a mestres ou permissões. Provas QA: 4 testes/70 verificações, zero falhas, transacções revertidas; tipos, compilação QA e sintaxe PHP passaram. O inventário anterior foi registado antes dos testes. Menus 6e8de43a, base interna, históricos e aceitação anterior preservados; L8 permanece parcial.
+
+Relatório: `catalogue-province-coverage-qa-20261028.json`. Instalação pelo processo Git e conferência visual autenticada continuam pendentes. Não declarar auditados todos os outros menus por este delta. Cobertura actualizada nos requisitos existentes V2-07/V2-10; sem nova matriz.
+
+
+28/10 — Âmbito nacional confirmado pela Tempo: antes da extensão dos testes, preservar a correcção QA 1b2ede41 e verificar os seis corredores aprovados nas onze unidades provinciais, hierarquia descendente e reutilização entre sectores/entradas de localização. Não presumir cobertura de corredor onde não está documentada. Nenhuma prova anterior é revogada.
+
+
+
+28/10 - National coverage: 6 tests / 617 assertions passed across all 11 provincial units, 6 configured corridors and 2 sectors, including descendant hierarchy, sector separation and both province/location entry points. The runtime correction already used the common national hierarchy; Maputo was the reported reproduction, not a geographic limit. Existing publication decisions and unknown district/post/site information remain preserved. This is not a claim that every unrelated portal menu has been audited. No additional runtime change since 1b2ede41; types/build accepted evidence reused. Installation remains pending.
+
+
+28/10 - Before selector delta checks: accepted national catalogue QA 47dae1b7, 6 tests/617 assertions, remains uninstalled. Existing TerritoryLevel and ProvinceSelect required two separate fields (search then select). Tempo requests one dropdown on the search field. Consolidate the shared controls while retaining saved values, hierarchy, endpoints, paging and permission decisions;browser visual proof remains separate.
+
+
+
+## 28/10/2026 — selecção territorial num único campo de pesquisa, QA
+
+Pedido expresso da Tempo: o dropdown deve abrir em «Pesquisar província», sem um segundo controlo «Seleccione». `ProvinceSelect` e `TerritoryLevel` passam a usar o mesmo combobox, aplicado a província, distrito, posto administrativo e localidade. Pesquisar e escolher fica num único campo; a paginação permanece na lista. Escrever ou sair com Escape não substitui a selecção guardada; escolher e limpar são acções expressas. Mantêm-se a hierarquia, os endpoints existentes e os controlos de acesso, sem novos dados ou publicações.
+
+Quatro testes do contrato de eventos/estado passaram: abertura/escolha, preservação ao escrever/Escape, teclado e bloqueio de resultado antigo durante carregamento, limpeza e dependência do nível anterior. Tipos e compilação QA passaram. As 6 provas nacionais/617 verificações são reutilizadas porque o PHP territorial não mudou. Este delta continua em QA e não comprova apresentação ou sessão real no navegador. Será agrupado com a correcção provincial; falta autenticação SSH antes da entrega, sem nova aprovação organizacional.
+
+
+28/10 - Before catalogue presentation checks: accepted province QA6/617 and unified selector QA4 remain preserved and uninstalled. Tempo reports Tourism/Cabo Delgado shows educational text and broad sector links. Read-only public API confirmed zero filtered records;unfiltered tourism returns16 records,all declared in Inhambane. This does not establish absence of tourism supply in Cabo Delgado. Correct presentation to retain filters and expose guides only as optional links;do not republish or reassign opportunities to manufacture results.
+
+## 28/10/2026 — resultados do catálogo separados do apoio educativo, QA
+
+A Tempo esclareceu que a combinação província/sector deve apresentar as oportunidades correspondentes, sem texto educativo ou atalhos que troquem a consulta por todas as oportunidades do sector. A consulta pública anónima conferiu Turismo/Cabo Delgado = zero oportunidades cadastradas; Turismo sem localização = 16, todas declaradas em Inhambane. Este snapshot não prova ausência de oferta turística em Cabo Delgado e não substitui inventário de fontes ou consulta autenticada.
+
+Correcção de apresentação em QA: título dos resultados explicita sector e hierarquia escolhidos; removidos os cartões educativos e o botão sectorial sem localização da área de resultados. Os guias mantêm-se como títulos ligados em apoio opcional fechado por defeito. A remoção da localização é uma acção expressamente identificada como pesquisa noutras províncias. O estado vazio refere o cadastro consultado e a cobertura incompleta, sem fabricar oportunidades nem alargar automaticamente filtros.
+
+Dois testes SSR do novo apoio opcional passaram, bem como tipos e compilação. As provas territoriais nacionais 6/617 e os quatro testes do selector são reutilizados; não mudou a consulta PHP ou o controlo territorial neste delta. Mantêm-se histórico, publicações, permissões, fontes e base interna. Este candidato continua sem instalação, dependente de autenticação SSH; a sessão real permanece sem prova visual. Relatório existente: `catalogue-province-coverage-qa-20261028.json`, campo `catalogue_result_presentation`. Requisitos V2-07/V2-10 actualizados na mesma matriz; L8 permanece parcial.
+
+
+28/10 - Before investor usability checks: accepted catalogue candidate54d1b2a5 remains in QA,not installed;active menus6e8de43a and earlier supply proofs preserved. Two Tempo attachments identify duplicate profile navigation,an exposed long canonical form and ZEE/ZFI/park searches that keep prior results until manual submit. Prepare presentation-only adaptive field groups and safe save-before-resource navigation;verify territorial search/count/paging and documented scope without republishing records or changing permissions. Reuse prior proofs;existing V2-07/V2-10 scope retained.
+
+## 28/10/2026 — usabilidade do investidor e consulta territorial, QA
+
+Pedidos da Tempo e exemplos recebidos: menu/ficha de oportunidade, zonas/parques, pedido de Promotor, Os meus investimentos, documentos/formulários e recusa autenticada em Turismo. Inventário anterior registado antes dos testes: menus 6e8de43a e base interna instalados; candidato territorial 54d1b2a5 ainda em QA; originais, dados, relações, histórico, aprovações e provas anteriores preservados.
+
+Delta QA: acções do investidor em primeiro plano, administração em detalhe consultável; campos do contrato existente agrupados por tarefa e modalidade, com navegação livre e todos os campos montados para conservar edições. Os grupos mostram as pendências da última gravação e os erros existentes; não criam seis ou oito formulários obrigatórios. Guardar usa os mesmos endpoints/ETags; abrir recursos pela preparação guarda primeiro e regressa à mesma oportunidade/grupo. Contactos e detalhes de disponibilidade ficam opcionais; códigos técnicos de categorias e campos conhecidos têm nomes em português. Só um contexto único de promotor é escolhido automaticamente.
+
+Zonas: selecção territorial aplica pesquisa sem esperar por outro clique; a lista anterior deixa de aparecer durante carregamento/erro. Totais, intervalo visível e páginas identificados, sem apresentar a primeira página como o conjunto completo. «Todo o território» remove expressamente a localização, preservando os restantes critérios visíveis. Abrangência jurídica documentada e validada inclui os níveis descendentes; influência não se torna implantação. Não são criadas localizações, direitos, publicações ou certificados.
+
+Pedido de Promotor: representação/modalidades com nomes claros; pesquisa de ficheiros e selecção expressa dos comprovativos, preservando os escolhidos ao pesquisar. Mantidos propriedade, análise antimalware e verificações existentes; legislação/imagem/teste não se torna comprovativo por estar disponível. Os meus investimentos destaca a próxima acção e permite abrir fases/etapas; fontes, códigos e acompanhamento interno ficam preservados em detalhes.
+
+Formulários: entradas directas para os campos já existentes da preparação do pedido de investimento e Terra/DUAT; pedido de apoio identificado separadamente. Originais oficiais e guias continuam consultáveis, sem os confundir com um formulário preenchível ou converter leis em campos/cálculos. Não se declara executada a totalidade dos formulários oficiais do acervo.
+
+Provas delimitadas: 8 testes frontend de contrato/SSR e 3 testes isolados/12 verificações, zero falhas; tipos, compilação e sintaxe PHP passaram. Dados sintéticos revertidos em QA. Provas nacionais/selector/catálogo anteriores reutilizadas. Turismo: leitura anónima activa HTTP200 e QA visitante/conta sem Promotor HTTP200; a recusa da sessão real relatada não foi reproduzida, nem atribuída a uma permissão sem prova. A conferência autenticada e visual continua pendente. Este registo não instala o candidato nem encerra a implementação transversal. L8 permanece parcial.
+
+Evidência: `investor-usability-qa-20261028.json`. Actualizados V2-01,V2-07,V2-10 na matriz existente; sem nova matriz ou backlog.
+
+
+### 28/10 — botão de cadastro e compatibilidade do pipeline
+
+A Tempo esclareceu que a recusa em Turismo ocorreu depois de clicar num botão; não foi possível recuperar o nome. A rota pública continuou HTTP200. Conferência de forma pública/origem não identificou anexos privados nos documentos públicos de Turismo; não se atribui a recusa à perda de publicação. Encontrada uma falha delimitada no consumidor: o botão de cadastro dependia da disponibilidade do módulo, sem a capacidade efectiva da conta. Corrigido para reutilizar o destino autorizado de criação de ContentManagement; sem essa capacidade, mostra expressamente o pedido de acesso já existente. Não cria papéis nem restringe a consulta pública ou a preparação de ideias. A confirmação visual da acção real permanece pendente.
+
+O candidato 502e3ec4 falhou na Unit de agrupamento de corredores antes da troca de release; 6e8de43a ficou servido. Causa: a simulação do catálogo não representava a nova apresentação de localização e uma consulta era feita antes de conferir se a fonte era aplicável. Correcção: conferir primeiro a fonte e simular a nova dependência no teste, conservando as verificações anteriores de identidade, grupos e contagens. Regressão Unit1/13 passou; não foi alterado o pipeline, o contrato de schema ou a exigência dos testes. Frontend9, Feature3/14, tipos e compilação passaram. Rótulos conhecidos de temas, categorias e idiomas do acervo traduzidos para apresentação; valores dos filtros preservados.
+
+
+## 28/10/2026 — entrega agrupada de usabilidade e filtros instalada, 789fffd0
+
+Entrega autorizada pela Tempo e autenticada pelo mecanismo SSH existente. `main` avançou normalmente e o pipeline existente instalou `789fffd0`, preservando a release anterior `6e8de43a`. O candidato inicial `502e3ec4` foi recusado antes da troca por uma dependência não representada no teste Unit do agrupamento de corredores; o activo ficou preservado. A consulta desnecessária foi corrigida e a nova dependência simulada, conservando as provas anteriores. O pipeline e o seu contrato de schema não foram enfraquecidos.
+
+Backup/restauro de 176 tabelas confirmado numa instância isolada, sem rede. Os 369 ficheiros persistentes/configuração mantêm-se idênticos. A comparação do snapshot com o instalado preserva as tabelas de domínio, incluindo papéis, publicações, originais e base interna; diferenças de cache/sessões são registadas separadamente. Sem migrações, importações ou activação fiscal. A versão anterior permanece disponível para o mecanismo de retorno.
+
+Incluídos: consulta provincial nacional/corredores e detalhe territorial; pesquisa/selecção num único controlo; resultados do catálogo separados do apoio educativo; grupos adaptáveis de preenchimento, navegação livre e gravação antes de abrir recursos; pedido de Promotor legível com comprovativos escolhidos expressamente; zonas filtradas ao seleccionar, contagens/paginação visíveis; fases/etapas do dossier e fontes em detalhes; entradas para formulários de preparação já existentes; CTA sectorial conforme capacidade efectiva; rótulos do acervo legíveis. Não são novas permissões, publicações ou formulários fiscais oficiais inventados.
+
+Conferidos o commit servido, APIs filtradas e assets instalados. Reutilizadas as provas QA aceites; a bateria obrigatória do pipeline não reabre a sua aceitação. Mantém-se pendente a conferência visual autenticada, incluindo navegação, ida/volta a recursos e Gurué no mesmo dossier. A recusa relatada em Turismo ocorreu após um botão; a falha concreta do CTA de cadastro foi corrigida, mas não se declara reproduzida e resolvida a acção original sem a sessão real. A escolha do formulário fiscal concreto ainda precisa de ser esclarecida; os diplomas IVA mostrados não são formulários preenchíveis.
+
+Estado actual: `investor-usability-git-delivery-20261028.json`. Os relatórios QA anteriores conservam o estado histórico antes da instalação. As 435 observações de Gurué não são 435 empresas; as listas são internas, a cobertura nacional é parcial e a comparação sustenta hipóteses. L8 permanece parcial. Actualizados V2-01/V2-07/V2-10 na matriz e manual existentes.
+
+
+## 28/10/2026 — preparação de formulários fiscais, inventário antes das provas
+
+Pedido expresso da Tempo: preencher formulário de IVA ou IRPC, em vez de abrir legislação. Base preservada: entrega instalada 789fffd0, Modelo A e aquisições/apuramento já aceites, L6 M20/M22 instalado em 5aaf1a56 e incrementos de L8. Nenhuma perda confirmada neste recorte; não se apagam as aceitações nem se repetem provas fiscais anteriores. Fontes reutilizadas do inventário de 20 exemplares acessíveis em outputs/irpc-l6-values-forms/accessible-source-inventory.json da QA anterior, incluindo temporários identificados; inventário do corpus e originais preservados. M22: três páginas conferidas visualmente nesta revisão, SHA256 4b61bd83d1fbcfd3b7b5c5523cea5923f7d0f65dc4c004eff58e5db38f763c88. Modelo A: correspondência e divergências aceites em modelo-a-reconciliacao-20261021.md; sem nova validação de proveniência.
+
+Incremento em preparação QA: entrada directa em Documentos e Formulários, preenchimento manual dos campos correspondidos de IVA e subconjunto M22, identificação/período, revisão, impressão e ficheiro privado para recuperação mediante confirmação. Escolha técnica: sem persistência no servidor nem ligação automática ao dossier neste incremento; não altera schema, dados, permissões ou cálculos. Ficheiro não publicado. IRPC ajustamentos completos, outros regimes, anexos, assinatura e submissão à AT fora da cobertura; L8 permanece parcial. Ainda sem instalação deste incremento. Próximas provas apenas do delta: fidelidade da recuperação, rejeição de ficheiros incompatíveis sem perda, formatos/valores desconhecidos, acesso público e compilação.
+
+
+## 29/10/2026 — ACT-20261029-01, inventário antes da verificação do incremento
+
+Continuação sequencial solicitada pela Tempo. Correspondência: ACT-20261029-01 reutiliza D-02 §8, clusters/cadeias e a orientação metodológica documentada em 23/10. Concluído previamente e preservado: gestão de clusters, etapas, ligações, lacunas e relações auditadas; disponibilidade instalada de carteira/âncoras e formulários fiscais conforme recibos de 28/10. Nenhuma perda nova confirmada nesta inspecção de código; não foi feita nova comparação de dados ou alegada prova do servidor. A pasta principal está em fde644af, enquanto o último recibo identifica 332c16eb instalado; reconciliar o delta sobre essa origem antes de instalar, sem substituir o destino pela pasta principal.
+
+Incremento em preparação: diagnóstico qualitativo das cinco forças na edição do cluster, sector/região editáveis, fonte/período/evidência/justificação/limites/oportunidade por força; indeterminação explícita, ficheiro privado transferível e recuperação com confirmação. Sem alteração de schema, dados, permissões, publicações ou motores fiscais. Persistência no servidor, ligação territorial canónica, dados sectoriais fundamentados e consulta pública permanecem por implementar; ACT-01 não está concluída. Verificação dirigida e instalação ainda pendentes neste registo inicial. Restantes ACT-02 a 16 mantêm o estado anterior e a sequência, sem trabalho SGF nesta passagem.
+### ACT-20261029-01 — candidato sequencial preparado, 29/10/2026
+
+Primeiro incremento implementado, **parcial e ainda não instalado**: gestão → clusters → editar → Competitividade. As cinco forças conservam fonte, período, evidência, apreciação, limites e oportunidade; sector e região explícitos, sem inferências automáticas. Transferência de rascunhos JSON e recuperação restrita ao mesmo cluster, com confirmação antes de substituir. Quatro testes frontend dirigidos, TypeScript e compilação QA passaram tanto na pasta de trabalho como no candidato baseado em 332c16eb. Guarda C132 local passou; não foram efectuados testes nem escritas na base activa. A edição existente recebe apenas a inclusão do componente; contratos e permissões existentes preservados.
+
+Origem reconciliada: main remoto e revisão pública conferidos em 332c16eb em 29/10. Candidato em C:/laragon/www/portal-investidor-competitiveness-qa-20261029, ramo codex/competitiveness-sequential-20261029. Consulta do estado remoto não equivale a inventário novo da base. Sessão SSH anterior encerrada; autenticação por chave recusada. Instalação requer autenticação SSH, backup fresco, restauro isolado, guarda de versão, pipeline existente e conferência posterior. Não instalar a pasta principal sobre o destino. A sequência solicitada mantém ACT-02 a 16 por iniciar após a instalação e o saldo de ACT-01; persistência no servidor, cobertura factual e consulta pública continuam pendentes. Sem declaração de conferência visual autenticada.
+### 29/10/2026 — ACT-20261029-01, primeiro incremento instalado: 23ecccfa
+
+Estado corrente de ACT-01: **parcial — primeiro incremento instalado**, substituindo apenas o estado planeado/preparado deste recorte; ACT-02 a 16 não foram implementadas nesta entrega. Instalado por avanço normal de main e pipeline existente em https://teste-investidor.tempo.co.mz/. Entrada: Gestão → Clusters → Editar → Competitividade — cinco forças de Porter. Preparação qualitativa por sector/região, evidências/fontes/períodos/limites e oportunidades, transferência JSON e recuperação confirmada do mesmo cluster. Sem gravação no servidor nem publicação da análise. Persistência, cobertura factual, território canónico e consulta pública continuam pendentes; esta instalação não encerra o critério amplo ACT-01.
+
+Provas: backup fresco, restauro isolado sem rede das 176 tabelas; pipeline com lifecycle de schema (3.106 asserções), 59 testes Unit/320 asserções e 1.180 testes frontend sem falhas, tipos e compilação; quatro ficheiros do incremento conferidos por SHA-256 no instalado; C132 no destino passou. Comparação após instalação: todas as 176 tabelas de domínio preservadas, diferenças operacionais apenas em cache/sessões; 369 ficheiros/configuração idênticos. Acesso anónimo ao catálogo privado recusado HTTP401. Zero migrações/importações, nenhuma nova divulgação nem mudança de permissões; versão anterior 332c16eb preservada. Conferência visual autenticada permanece pendente. Recibo: `docs/investmoz/unification/competitiveness-sequential-qa-20261029.json`, em docs/investmoz/unification. As provas aceites anteriores foram reutilizadas; não foram reabertas por esta entrega.
@@ -0,0 +1,131 @@
+{
+  "date": "2026-10-28",
+  "status": "QA_corrected_and_verified_not_installed",
+  "installed_baseline": "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c",
+  "user_case": "Agronegócio / Maputo Província",
+  "reproduction": {
+    "QA_public_agribusiness": 37,
+    "Maputo_corridor_public_opportunities": 5,
+    "province_results_before": 0,
+    "province_results_after": 5
+  },
+  "cause": "The provincial catalogue ignored the corridor context already approved by Tempo; no records were deleted.",
+  "reused_decision": [
+    "config/investment_corridors.php",
+    "docs/investmoz/unification/corridor-adaptive-context-20261023.json"
+  ],
+  "correction": [
+    "Reuse approved corridor province context only at province level, with the accepted source hash and existing public publication decisions",
+    "Do not override an explicit primary/additional territory or infer district/post/coordinates",
+    "Display available province,district,administrative post,locality directly in results",
+    "Show both approved Maputo units as contextual coverage, not as two separate opportunities",
+    "Keep catalogue,API,corridor view and unlocated map list consistent",
+    "One action returns from district to whole province; no requirement to select every level"
+  ],
+  "QA": {
+    "tests": 6,
+    "assertions": 617,
+    "failures": 0,
+    "database": "proactive_investment_20261027_test",
+    "port": 55441,
+    "transactions_rolled_back": true,
+    "types": "passed",
+    "build": "passed",
+    "PHP_syntax": "passed"
+  },
+  "preserved": [
+    "Installed menus and accepted supply proofs",
+    "Originals,source data,territory IDs,publication states,permissions,private lists and histories",
+    "L8 unchanged,partial"
+  ],
+  "limitations": [
+    "No active installation in this report",
+    "Real authenticated visual conference remains pending;last connector error The browser access host is unavailable",
+    "This fixes the shared investment catalogue and corridor view;it is not proof that every menu in the portal has been audited",
+    "Provincial corridor coverage is not a documented district site;unknown levels stay unknown"
+  ],
+  "existing_requirements": [
+    "V2-07",
+    "V2-10"
+  ],
+  "restriction_origins": {
+    "territorial_behaviour": "Tempo current request",
+    "corridor_coverage": "Tempo express decision,23/10/2026",
+    "no_new_publication_or_roles": "existing approved scope",
+    "UI_summary_and_province_shortcut": "implementation choice"
+  },
+  "scope": "national;shared investment catalogue and similar location entry points",
+  "national_verification": {
+    "provincial_units": 11,
+    "approved_corridors": 6,
+    "sectors_for_descendant_fixtures": 2,
+    "province_and_legacy_location_entry_points": true,
+    "district_containment": true,
+    "unrelated_provinces_excluded": true,
+    "test_data": "synthetic fixtures rolled back;accepted published source reused"
+  },
+  "selector_delta": {
+    "Tempo_request": "Dropdown belongs to Pesquisar província;remove separate Seleccione control",
+    "scope": [
+      "ProvinceSelect",
+      "TerritoryLevel:province,district,administrative post,locality"
+    ],
+    "behaviour": [
+      "One combobox input opens the list and searches the existing endpoint",
+      "Explicit choice commits the existing option;typing or Escape does not clear saved values",
+      "Arrow keys and Enter select;clear is explicit;dependent levels remain disabled without parent",
+      "Paging retained inside dropdown;loading cannot commit a stale option"
+    ],
+    "QA": {
+      "event_state_contract_tests": 4,
+      "failures": 0,
+      "types": "passed",
+      "build": "passed",
+      "limit": "Controlled React component contract;not browser visual/session evidence"
+    },
+    "publication_data_permissions_and_territory_rules": "unchanged",
+    "national_province_evidence": "6 tests/617 assertions reused;unchanged PHP runtime",
+    "status": "QA_not_installed"
+  },
+  "catalogue_result_presentation": {
+    "Tempo_request": "Province+sector must show matching opportunities,not educational text and unfiltered national sector shortcuts",
+    "public_read_snapshot": {
+      "filtered": {
+        "total": 0,
+        "province": "Cabo Delgado",
+        "sector": "turismo",
+        "province_id": "059b02ca-7095-577a-8705-4d4c46896747"
+      },
+      "active_writes": 0,
+      "sector_only": {
+        "total": 16,
+        "declared_provinces": [
+          "Inhambane"
+        ],
+        "sector": "turismo"
+      },
+      "method": "anonymous public API read; no authenticated session claimed",
+      "meaning": "public catalogue snapshot;not evidence of absence of market supply",
+      "checked_at": "2026-10-28T19:03:36.8285860Z",
+      "target": "https://teste-investidor.tempo.co.mz/"
+    },
+    "UI_changes": [
+      "Heading identifies applied sector and territorial path",
+      "Educational cards and their broad sector opportunity button removed from catalogue results",
+      "Guide titles remain available only inside closed optional support details",
+      "Removing location is explicitly labelled as searching other provinces",
+      "Empty state is limited to published records in the consulted catalogue;not absence of market supply"
+    ],
+    "QA": {
+      "new_component_SSR_tests": 2,
+      "failures": 0,
+      "types": "passed",
+      "build": "passed",
+      "accepted_national_and_selector_proofs": "reused;backend and selector unchanged"
+    },
+    "status": "QA_not_installed",
+    "authenticated_visual_validation": "pending;public API read does not prove real session behaviour",
+    "active_writes": 0,
+    "new_publications": 0
+  }
+}
@@ -0,0 +1,147 @@
+{
+    "activity":  "ACT-20261029-01",
+    "status":  "partial_increment_installed_preservation_verified_visual_pending",
+    "baseline":  "332c16ebb555e8d6b244fa519bc777d89c1a8b8f",
+    "branch":  "codex/competitiveness-sequential-20261029",
+    "target":  "https://teste-investidor.tempo.co.mz/",
+    "checks":  {
+                   "diff":  "passed",
+                   "types":  "passed",
+                   "diagnostics_C132":  "passed_in_original_workspace",
+                   "frontend_tests":  4,
+                   "isolated_qa_build":  "passed"
+               },
+    "active_database_writes":  0,
+    "schema_changes":  false,
+    "permission_changes":  false,
+    "coverage":  [
+                     "five qualitative forces in existing cluster management",
+                     "sector and regional scope",
+                     "evidence, source, period, rationale, limitations and investment opportunity",
+                     "explicit uncertainty",
+                     "JSON download and confirmed same-cluster recovery"
+                 ],
+    "remaining":  [
+                      "authenticated visual verification",
+                      "server persistence and canonical territorial scope",
+                      "factual sector and regional data",
+                      "public consultation"
+                  ],
+    "source_sha256":  {
+                          "resources/js/lib/cluster-competitiveness.ts":  "1ed496f51f020da9f0c02ab0aa324b58a9dd17fa34a10d8c1a90d9915800fecb",
+                          "resources/js/pages/structures/competitiveness.tsx":  "55338c144cefae4f91cef765b8e5e8b28ceb6c76375d46943c3c3430aeddc68e",
+                          "resources/js/pages/structures/editor.tsx":  "080a90ab8607f05ec493e560ed8280a6f7eec743ed1954f0057a0ce6caa09208",
+                          "tests/frontend/cluster-competitiveness.test.mjs":  "f48a9ed872f49ad900424daab4689cb0eeeb31cc93ebf1c608408c0a8c2b435b"
+                      },
+    "candidate":  "23ecccfaad1053f55bf0591fd242cb5fa3406c38",
+    "backup":  {
+                   "stage":  "/var/backups/investmoz-competitiveness-delivery-20261029/backup",
+                   "created_at":  "2026-10-29T11:04:46Z",
+                   "target":  {
+                                  "database":  "teste_investidor",
+                                  "port":  5432
+                              },
+                   "tables":  176,
+                   "files_verified":  369,
+                   "dump_sha256":  "7979fa2b3fe1f69e62aad9fadf60a60d7b068e198cdc291a8fc79d409d67c7ca",
+                   "files_sha256":  "8e0022b73cd0074e36f8efef0b7c803a386e24e6e4cf85f567757ff67e311369",
+                   "restore_verified":  false
+               },
+    "restore":  {
+                    "restore_verified":  true,
+                    "tables_verified":  176,
+                    "container_network":  "none",
+                    "database":  "competitiveness_delivery_20261029_test",
+                    "port":  55441,
+                    "source_dump_sha256":  "7979fa2b3fe1f69e62aad9fadf60a60d7b068e198cdc291a8fc79d409d67c7ca",
+                    "active_database_writes":  0
+                },
+    "preservation":  {
+                         "navigation_asset_and_shared_props_verified":  true,
+                         "at":  "2026-10-29T11:10:44.303271+00:00",
+                         "served_commit":  "23ecccfaad1053f55bf0591fd242cb5fa3406c38",
+                         "backup_dump_sha256":  "7979fa2b3fe1f69e62aad9fadf60a60d7b068e198cdc291a8fc79d409d67c7ca",
+                         "prior_public_tables_checked":  176,
+                         "prior_domain_rows_preserved":  true,
+                         "new_migration_registry_rows":  0,
+                         "operational_delta":  {
+                                                   "cache":  {
+                                                                 "before":  {
+                                                                                "rows":  119,
+                                                                                "checksum":  "5f3c36637fbf1e9dc4700066d4c45530"
+                                                                            },
+                                                                 "after":  {
+                                                                               "rows":  119,
+                                                                               "checksum":  "b1c9949cfacc34906c406e27e95cbd9b"
+                                                                           }
+                                                             },
+                                                   "sessions":  {
+                                                                    "before":  {
+                                                                                   "rows":  37,
+                                                                                   "checksum":  "b0e409c4c77c58b48252d9847c3c61ef"
+                                                                               },
+                                                                    "after":  {
+                                                                                  "rows":  38,
+                                                                                  "checksum":  "f4d94db55488bc0bcf6f727f222473c1"
+                                                                              }
+                                                                }
+                                               },
+                         "persistent_files_and_configuration_identical":  369,
+                         "private_catalogue":  {
+                                                   "observations":  361464,
+                                                   "distinct_administrative_observations":  214299,
+                                                   "preserved_repetitions":  147165,
+                                                   "unmapped_territory":  205608
+                                               },
+                         "preservation_identity":  "postgres, matching backup reader; no actor impersonation",
+                         "anonymous_query_status":  401,
+                         "public_revision_confirmed":  true,
+                         "actual_team_UI_journey":  "pending authenticated browser conference;accepted QA is not repeated",
+                         "unique_company_count":  null,
+                         "publication":  false,
+                         "national_coverage":  "partial",
+                         "investment_conclusion":  "hypothesis,not proved demand or viability",
+                         "L8":  "unchanged,partial"
+                     },
+    "installed_code":  {
+                           "candidate":  "23ecccfaad1053f55bf0591fd242cb5fa3406c38",
+                           "source_files_verified":  4,
+                           "diagnostics_C132":  {
+                                                    "result":  "passed",
+                                                    "case":  "C132",
+                                                    "source_explicit_constant_OFF":  true,
+                                                    "effective_configuration_OFF":  true,
+                                                    "configuration_cached":  false,
+                                                    "database_connections_used":  0,
+                                                    "active_writes":  0
+                                                },
+                           "active_writes":  0
+                       },
+    "pipeline":  {
+                     "unit_tests":  59,
+                     "frontend_failures":  0,
+                     "schema_assertions":  3106,
+                     "checks":  [
+                                    "\u001b[30;42mOK (1 test, 3106 assertions)\u001b[0m",
+                                    "✓ built in 34.50s",
+                                    "\u001b[30;42mOK (59 tests, 320 assertions)\u001b[0m",
+                                    "# tests 1180",
+                                    "# pass 1180",
+                                    "# fail 0"
+                                ],
+                     "frontend_tests":  1180,
+                     "result":  {
+                                    "status":  "installed",
+                                    "commit":  "23ecccfaad1053f55bf0591fd242cb5fa3406c38",
+                                    "release":  "/var/www/investmoz-homologacao/releases/23ecccfaad1053f55bf0591fd242cb5fa3406c38-0e0b8a65",
+                                    "previous_release":  "/var/www/investmoz-homologacao/releases/332c16ebb555e8d6b244fa519bc777d89c1a8b8f-f0dfc218",
+                                    "database_migrations":  0,
+                                    "content_imports":  0,
+                                    "requested_commits":  [
+                                                              "23ecccfaad1053f55bf0591fd242cb5fa3406c38"
+                                                          ],
+                                    "finished_at":  "2026-10-29T11:10:02.884033+00:00"
+                                },
+                     "unit_assertions":  320
+                 }
+}
@@ -0,0 +1,213 @@
+{
+  "date": "2026-10-28",
+  "status": "installed_delta_verified_authenticated_visual_conference_pending",
+  "served_commit": "789fffd098fa222c85e1283de07f23ee6f42bd04",
+  "previous_runtime": "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c",
+  "target": "https://teste-investidor.tempo.co.mz/",
+  "normal_Git_fast_forward": true,
+  "force_used": false,
+  "existing_pipeline_unchanged": true,
+  "scope": [
+    "National provincial catalogue/corridor coverage and territorial summaries",
+    "One searchable territory control at all four levels",
+    "Filtered catalogue results separate from optional educational support",
+    "Adaptive opportunity preparation groups and save-before-resource navigation",
+    "Readable promoter request with explicit searchable proof selection",
+    "Immediate scoped zone search,total counts and complete pagination",
+    "My investments next action and expandable stages/source details",
+    "Direct entries to existing fillable investment/Terra-DUAT preparation;support form separately labelled",
+    "Sector registration CTA uses effective account creation capability;no new permissions",
+    "Readable known document topic/category/language labels"
+  ],
+  "backup": {
+    "stage": "/var/backups/investmoz-catalogue-territory-delivery-20261028/backup",
+    "created_at": "2026-10-28T19:25:43Z",
+    "target": {
+      "database": "teste_investidor",
+      "port": 5432
+    },
+    "tables": 176,
+    "files_verified": 369,
+    "dump_sha256": "597f73cda14dd47be440136f2e2242d8d7a4e4f3d5d69cabcd44f8fde58c136d",
+    "files_sha256": "7fb639d8351e34ce220c5424c722c223512d139c82b7ff0a1a447136c62041ef",
+    "restore_verified": false
+  },
+  "restore": {
+    "restore_verified": true,
+    "tables_verified": 176,
+    "container_network": "none",
+    "database": "catalogue_territory_delivery_20261028_test",
+    "port": 55441,
+    "source_dump_sha256": "597f73cda14dd47be440136f2e2242d8d7a4e4f3d5d69cabcd44f8fde58c136d",
+    "active_database_writes": 0
+  },
+  "failed_candidate_preserved": {
+    "commit": "502e3ec4",
+    "reason": "Corridor explorer Unit mock missing the new public location presentation;unnecessary non-source relation read",
+    "active_runtime_preserved": true,
+    "resolution": "Short-circuit irrelevant source before relation access;represent new dependency and retain old assertions;Unit1/13 passed"
+  },
+  "pipeline": {
+    "reports": [
+      {
+        "status": "already_installed",
+        "commit": "789fffd098fa222c85e1283de07f23ee6f42bd04",
+        "requested_commits": [
+          "789fffd098fa222c85e1283de07f23ee6f42bd04"
+        ],
+        "finished_at": "2026-10-28T19:39:46.948539+00:00"
+      },
+      {
+        "status": "installed",
+        "commit": "789fffd098fa222c85e1283de07f23ee6f42bd04",
+        "release": "/var/www/investmoz-homologacao/releases/789fffd098fa222c85e1283de07f23ee6f42bd04-29ab1f0d",
+        "previous_release": "/var/www/investmoz-homologacao/releases/6e8de43ae7fec29b0766d95e209a8cb8baf0d88c-877dabd3",
+        "database_migrations": 0,
+        "content_imports": 0,
+        "requested_commits": [
+          "789fffd098fa222c85e1283de07f23ee6f42bd04"
+        ],
+        "finished_at": "2026-10-28T19:39:45.796038+00:00"
+      }
+    ],
+    "build_logs": [
+      {
+        "file": "/var/lib/investmoz-deploy/logs/1793216167091522421.log",
+        "sha256": "af1c3db072b2b354cfef13538a8cb69d07a37ec4b1ddef63d8d68e77ab5d7196",
+        "summaries": [
+          "\u001b[30;42mOK (1 test, 3106 assertions)\u001b[0m",
+          "✓ built in 32.16s",
+          "\u001b[30;42mOK (59 tests, 320 assertions)\u001b[0m",
+          "# tests 1171",
+          "# pass 1171",
+          "# fail 0"
+        ]
+      }
+    ]
+  },
+  "installed_preservation_delta": {
+    "navigation_asset_and_shared_props_verified": true,
+    "at": "2026-10-28T19:40:32.494557+00:00",
+    "served_commit": "789fffd098fa222c85e1283de07f23ee6f42bd04",
+    "backup_dump_sha256": "597f73cda14dd47be440136f2e2242d8d7a4e4f3d5d69cabcd44f8fde58c136d",
+    "prior_public_tables_checked": 176,
+    "prior_domain_rows_preserved": true,
+    "new_migration_registry_rows": 0,
+    "operational_delta": {
+      "cache": {
+        "before": {
+          "rows": 111,
+          "checksum": "1912b955cff09094395336c2137d5ce5"
+        },
+        "after": {
+          "rows": 111,
+          "checksum": "c158d3e941f896ca3997dfe02850d427"
+        }
+      },
+      "sessions": {
+        "before": {
+          "rows": 9,
+          "checksum": "870b1c20d207a9db376633fc5514a3ed"
+        },
+        "after": {
+          "rows": 8,
+          "checksum": "f7737eac7d85ed501fb339d7faabbd8e"
+        }
+      }
+    },
+    "persistent_files_and_configuration_identical": 369,
+    "private_catalogue": {
+      "observations": 361464,
+      "distinct_administrative_observations": 214299,
+      "preserved_repetitions": 147165,
+      "unmapped_territory": 205608
+    },
+    "RLS_without_actor_rows": 0,
+    "anonymous_query_status": 401,
+    "public_revision_confirmed": true,
+    "actual_team_UI_journey": "pending authenticated browser conference;accepted QA is not repeated",
+    "unique_company_count": null,
+    "publication": false,
+    "national_coverage": "partial",
+    "investment_conclusion": "hypothesis,not proved demand or viability",
+    "L8": "unchanged,partial"
+  },
+  "public_installed_delta": {
+    "served_commit": "789fffd098fa222c85e1283de07f23ee6f42bd04",
+    "public_Maputo_agribusiness_total": 5,
+    "public_Tourism_Cabo_Delgado_total": 0,
+    "Cabo_Delgado_zones_total": 2,
+    "all_zones_total": 8,
+    "all_zones_pages": 1,
+    "filtered_scope_and_sector_confirmed": true,
+    "installed_UI_assets_verified": [
+      "Preencher formulários e preparar documentos",
+      "Pesquisar nos meus ficheiros",
+      "O meu acesso e administração",
+      "Consultar situação, documentos e fundamentos"
+    ],
+    "public_Tourism_HTTP": 200,
+    "guest_Tourism_registration_action": "/perfil/promotor",
+    "guest_Tourism_registration_label": "Pedir acesso para cadastrar oportunidades",
+    "real_authenticated_Tourism_case": "pending;anonymous200 is not the real session",
+    "pipeline_reports": [
+      {
+        "status": "already_installed",
+        "commit": "789fffd098fa222c85e1283de07f23ee6f42bd04",
+        "requested_commits": [
+          "789fffd098fa222c85e1283de07f23ee6f42bd04"
+        ],
+        "finished_at": "2026-10-28T19:39:46.948539+00:00"
+      },
+      {
+        "status": "installed",
+        "commit": "789fffd098fa222c85e1283de07f23ee6f42bd04",
+        "release": "/var/www/investmoz-homologacao/releases/789fffd098fa222c85e1283de07f23ee6f42bd04-29ab1f0d",
+        "previous_release": "/var/www/investmoz-homologacao/releases/6e8de43ae7fec29b0766d95e209a8cb8baf0d88c-877dabd3",
+        "database_migrations": 0,
+        "content_imports": 0,
+        "requested_commits": [
+          "789fffd098fa222c85e1283de07f23ee6f42bd04"
+        ],
+        "finished_at": "2026-10-28T19:39:45.796038+00:00"
+      }
+    ],
+    "no_schema_or_publication_changes": true,
+    "source_files_preserved": true
+  },
+  "accepted_QA_reused": {
+    "national_tests": 6,
+    "national_assertions": 617,
+    "selector_tests": 4,
+    "guide_tests": 2,
+    "usability_frontend_tests": 9,
+    "usability_feature_tests": 3,
+    "usability_feature_assertions": 14,
+    "unit_regression_tests": 1,
+    "unit_regression_assertions": 13,
+    "types_build_PHP": "passed"
+  },
+  "remaining": [
+    "Actual authenticated visual conference of responsive menus,free filling navigation,saved resource round-trip and Gurué same-dossier journey",
+    "Tempo clarified Tourism denial followed a button;exact original button unavailable. Concrete creation CTA mismatch corrected and tested;real session still needs confirmation",
+    "Clarify the particular official fiscal form sought;investment preparation adaptations are not a complete implementation of all IVA/IRPC official forms"
+  ],
+  "preserved": {
+    "old_release": "retained for existing rollback mechanism",
+    "domain_data_permissions_publications": "unchanged",
+    "persistent_files_and_configuration": 369,
+    "private_supply_observations": 361464,
+    "Gurue_observations": 435,
+    "counts_are_not_unique_companies": true,
+    "lists": "internal",
+    "national_coverage": "partial",
+    "investment_comparison": "hypothesis,not demand or viability proof",
+    "L8": "partial,unchanged"
+  },
+  "proof_limits": "HTTP/API/asset checks do not prove the authenticated UI;prior QA/manual reports remain historical candidate evidence,not installation state",
+  "source_QA_reports": [
+    "catalogue-province-coverage-qa-20261028.json",
+    "investor-usability-qa-20261028.json"
+  ],
+  "authorisation": "Tempo requested corrections,authorised normal delivery,and authenticated the existing SSH mechanism;no repeated organisational approval required"
+}
@@ -0,0 +1,73 @@
+{
+  "date": "2026-10-28",
+  "status": "QA_implemented_and_delta_verified_not_installed",
+  "runtime_baseline": "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c",
+  "prepared_catalogue_parent": "54d1b2a5",
+  "Tempo_requests": [
+    "Readable investor work menu and adaptive filling flow",
+    "ZEE/ZFI/park results must match explicit territory selection;all means the available set",
+    "Promoter request must use readable representation/modality labels and usable evidence selection",
+    "Investigate authenticated denial of public Tourism sector",
+    "Simplify My investments and present useful next actions",
+    "Expose fillable forms rather than a guide or legislative catalogue"
+  ],
+  "implemented": {
+    "work_menu": "Investor actions remain primary;existing access/audit/profile setup destinations move into optional administration details;no permission change",
+    "filling": "Schema fields grouped adaptively by task;free navigation,all fields stay mounted,unknown future keys retained;server missing paths and errors point to groups;not mandatory sequential forms",
+    "preservation": "Deliberate values retained between groups;save uses existing endpoints and ETags;resource navigation saves first and returns to the same opportunity/group;only unique promoter context is auto-selected",
+    "profile_request": "Portuguese visible representation/modality labels;owned clean-file criteria unchanged;file search and explicit selected proofs replace the unbounded list;availability does not prove evidentiary suitability",
+    "zones": "Territory and other filter changes apply search;old records hidden while loading/error;all and filtered totals plus pagination explicit;existing public visibility preserved;validated legal coverage includes its child area,while influence is not treated as a site",
+    "my_investments": "Next action remains prominent;other phases/stages expandable;source/code history and internal follow-up remain consultable rather than filling the main page",
+    "forms": "Direct entries to existing private investment preparation fields and Terra/DUAT;support request separately labelled;originals/guides optional;no law is converted into a form or executable calculation",
+    "document_taxonomy": "Known topic/category/language codes have Portuguese display labels;original query values preserved"
+  },
+  "QA": {
+    "frontend_contract_and_SSR_tests": 9,
+    "frontend_failures": 0,
+    "isolated_feature_tests": 3,
+    "feature_assertions": 14,
+    "feature_failures": 0,
+    "database": "proactive_investment_20261027_test",
+    "port": 55441,
+    "transactions_rolled_back": true,
+    "types": "passed",
+    "build": "passed",
+    "PHP_syntax": "passed",
+    "accepted_national_selector_and_catalogue_proofs": "reused",
+    "unit_regression_tests": 1,
+    "unit_regression_assertions": 13
+  },
+  "Tourism_incident": {
+    "reported_by_Tempo": "authenticated session saw access denial at /sectores/turismo",
+    "anonymous_live_HTTP": 200,
+    "isolated_guest_and_no_promoter_account_HTTP": 200,
+    "exact_real_session_cause": "not demonstrated;do not infer missing role or claim correction",
+    "private_permissions_changed": false,
+    "next": "Confer the actual authenticated session and related logs;public read is not real-session proof",
+    "reported_action": "Tempo clarified denial followed a button click;exact label could not be recalled",
+    "bounded_code_finding": "Sector registration action depended on module availability rather than effective account creation capability",
+    "QA_correction": "Reuse ContentManagement effective create destination;otherwise explicitly link to existing promoter request with a readable label;public consultation and idea preparation remain separate",
+    "real_session_reconference": "pending;the exact original button is not demonstrated"
+  },
+  "limits": [
+    "Not installed in this QA report",
+    "SSR and controlled event tests are not browser keyboard/touch/layout evidence",
+    "Existing form adaptations are exposed;this does not implement every official form in the document collection",
+    "No new roles,publications,source edits,schema changes or fiscal activation",
+    "L8 remains partial"
+  ],
+  "restriction_origins": {
+    "UX_and_selected_scope": "Tempo current express instructions",
+    "data_and_permissions_preservation": "permanent project instructions",
+    "grouping_and_collapsed_details": "implementation choice,not new organisational requirement",
+    "document_ownership_scan_and_existing_workflows": "prior contracts preserved"
+  },
+  "delivery_gate": {
+    "candidate": "502e3ec4",
+    "result": "failed before runtime switch;6e8de43a preserved",
+    "reason": "Unit mock did not represent new public location presentation;unnecessary relation query on non-source records",
+    "correction": "Short-circuit source applicability before reading relations;mock the new presentation dependency and retain prior identity/count assertions",
+    "unit_regression": "1 test/13 assertions passed",
+    "pipeline_guardrails": "unchanged;no schema migration or test-gate weakening"
+  }
+}
@@ -0,0 +1,161 @@
+{
+  "date": "2026-10-28",
+  "status": "installed_technical_navigation_delta_verified_authenticated_visual_conference_pending",
+  "served_commit": "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c",
+  "previous_runtime": "6d1476936920dc5715d4493b1f8b22a3d51935f4",
+  "target": "https://teste-investidor.tempo.co.mz/",
+  "authorisation": "Tempo approved the QA menu proposal and authenticated the existing SSH delivery mechanism",
+  "normal_git_fast_forward": true,
+  "force_used": false,
+  "backup": {
+    "stage": "/var/backups/investmoz-navigation-delivery-20261028/backup",
+    "created_at": "2026-10-28T18:18:14Z",
+    "target": {
+      "database": "teste_investidor",
+      "port": 5432
+    },
+    "tables": 176,
+    "files_verified": 369,
+    "dump_sha256": "748539aa92cf4a0e22698a3b7651faa7a4452db2517ddb811a924b761ea9dce5",
+    "files_sha256": "946dd8d33903332557639103b8f5ad5bca955fd3ec79f112e3649128fea8c499",
+    "restore_verified": false
+  },
+  "restore": {
+    "restore_verified": true,
+    "tables_verified": 176,
+    "container_network": "none",
+    "database": "navigation_delivery_20261028_test",
+    "port": 55441,
+    "source_dump_sha256": "748539aa92cf4a0e22698a3b7651faa7a4452db2517ddb811a924b761ea9dce5",
+    "active_database_writes": 0
+  },
+  "guard": {
+    "ready_for_normal_git_delivery": true,
+    "restore_verified": true,
+    "tables_verified": 176,
+    "pipeline_and_schema_contract_unchanged": true,
+    "candidate": "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c"
+  },
+  "installed_delta": {
+    "navigation_asset_and_shared_props_verified": true,
+    "at": "2026-10-28T18:23:39.508498+00:00",
+    "served_commit": "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c",
+    "backup_dump_sha256": "748539aa92cf4a0e22698a3b7651faa7a4452db2517ddb811a924b761ea9dce5",
+    "prior_public_tables_checked": 176,
+    "prior_domain_rows_preserved": true,
+    "new_migration_registry_rows": 0,
+    "operational_delta": {
+      "cache": {
+        "before": {
+          "rows": 111,
+          "checksum": "650ce50f1aa1af7e7025bcbaa7bcd6ba"
+        },
+        "after": {
+          "rows": 111,
+          "checksum": "ea8070b2c9a513485bfb27462e379703"
+        }
+      },
+      "sessions": {
+        "before": {
+          "rows": 4,
+          "checksum": "f0d8b267cdf55c86ba8223d9e1ff3c6a"
+        },
+        "after": {
+          "rows": 5,
+          "checksum": "99071034149a154c7e17acc47e058dae"
+        }
+      }
+    },
+    "persistent_files_and_configuration_identical": 369,
+    "private_catalogue": {
+      "observations": 361464,
+      "distinct_administrative_observations": 214299,
+      "preserved_repetitions": 147165,
+      "unmapped_territory": 205608
+    },
+    "RLS_without_actor_rows": 0,
+    "anonymous_query_status": 401,
+    "public_revision_confirmed": true,
+    "actual_team_UI_journey": "pending authenticated browser conference;accepted QA is not repeated",
+    "unique_company_count": null,
+    "publication": false,
+    "national_coverage": "partial",
+    "investment_conclusion": "hypothesis,not proved demand or viability",
+    "L8": "unchanged,partial"
+  },
+  "existing_pipeline_receipt": {
+    "reports": [
+      {
+        "status": "already_installed",
+        "commit": "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c",
+        "requested_commits": [
+          "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c"
+        ],
+        "finished_at": "2026-10-28T18:23:07.685587+00:00"
+      },
+      {
+        "status": "installed",
+        "commit": "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c",
+        "release": "/var/www/investmoz-homologacao/releases/6e8de43ae7fec29b0766d95e209a8cb8baf0d88c-877dabd3",
+        "previous_release": "/var/www/investmoz-homologacao/releases/6d1476936920dc5715d4493b1f8b22a3d51935f4-c9ebfad4",
+        "database_migrations": 0,
+        "content_imports": 0,
+        "requested_commits": [
+          "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c"
+        ],
+        "finished_at": "2026-10-28T18:23:06.355940+00:00"
+      }
+    ],
+    "build_log": "/var/lib/investmoz-deploy/logs/1793211570315386207.log",
+    "build_log_sha256": "7b1d78a066ed829cbdabc67549baf4835ab8f911b8c4b178be09539ed434ddde",
+    "summaries": [
+      "\u001b[30;42mOK (1 test, 3106 assertions)\u001b[0m",
+      "✓ built in 31.30s",
+      "\u001b[30;42mOK (59 tests, 317 assertions)\u001b[0m",
+      "# tests 1156",
+      "# pass 1156",
+      "# fail 0"
+    ],
+    "last_lines": [
+      "ext-pcre             8.4.27     success                                       ",
+      "ext-session          8.4.27     success                                       ",
+      "ext-tokenizer        8.4.27     success                                       ",
+      "php                  8.4.27     success                                       ",
+      "6e8de43ae7fec29b0766d95e209a8cb8baf0d88c",
+      "",
+      "   INFO  Broadcasting queue restart signal.  ",
+      ""
+    ]
+  },
+  "accepted_QA_reused": {
+    "directed_tests": 16,
+    "types": "passed",
+    "build": "passed",
+    "PHP_syntax": "passed"
+  },
+  "UI_delta": [
+    "Área de trabalho visible in principal navigation; operational entries follow existing effective capabilities",
+    "Sidebar preserves every nested destination and territorial context instead of exposing only the first link",
+    "Existing opportunity analysis form can be opened directly without replacing saved analysis",
+    "Existing account, content, investment and follow-up destinations retained; no new roles or grants"
+  ],
+  "remaining": [
+    "Authenticated visual conference on the actual account, including responsive layout and keyboard/touch",
+    "Confirm Gurué → offer consultation → idea comparison → save → recover in the same dossier; technical/QA proofs remain accepted"
+  ],
+  "connector_last_known_error": "The browser access host is unavailable",
+  "limitations": {
+    "technical_delivery_is_not_visual_session_evidence": true,
+    "435_Gurue_observations_are_not_435_unique_companies": true,
+    "lists_remain_internal": true,
+    "national_coverage": "partial",
+    "absence_of_records": "insufficient information",
+    "comparison": "investment hypothesis; does not establish demand or viability",
+    "L8": "unchanged,partial"
+  },
+  "restriction_origins": {
+    "delivery": "explicit Tempo authorisation",
+    "preservation_and_restore": "permanent project instructions",
+    "grouping_and_presentation": "implementation choice within the approved QA proposal; no new business authority"
+  }
+}
@@ -7260,3 +7260,144 @@ CI habitual do instalador: PostgreSQL1/3106asserções, Unit59/317, frontend1146
 `6d147693` está instalado, incluindo a base interna. A única pendência da conferência desta entrega é a validação visual autenticada: **Gurué → consultar oferta → comparar ideia → guardar → recuperar no mesmo dossier**, conservando fonte, data e incertezas. As435 observações de Gurué não são435 empresas únicas. Listas internas, cobertura nacional parcial e hipótese de investimento mantêm-se.

 O erro actual, novamente observado, é **“The browser access host is unavailable”**: indisponibilidade do host do conector, distinta de deixar uma aba aberta. A orientação anterior para apenas manter a aba aberta era insuficiente. Restabelecer o conector por mecanismo suportado ou realizar a conferência pela equipa. Não reinstalar nem repetir as provas técnicas aceites; não declarar conferência visual concluída sem o seu resultado. O recibo remoto original e o historial do diagnóstico anterior ficam preservados; esta correcção é documental.
+
+
+## 28/10/2026 — revisão de menus: inventário antes da verificação do delta
+
+Origem: recomendação expressa da Tempo após constatar que as entradas indicadas não aparecem ou ficam escondidas. Página relatada:https://teste-investidor.tempo.co.mz/. Preservados6d147693 e a base privada instalada,as provas QA do percurso e da navegação sectorial,os originais,dados,perfis,permissões e históricos. Não se declara uma funcionalidade anterior desaparecida apenas pela ausência de um novo teste.
+
+Confirmado no código: barra lateral substitui cada grupo pelo seu primeiro destino,omitindo os restantes;menu principal esconde gestão/perfis dentro do menu do nome do utilizador;entrada de gestão de conteúdos existente não é incorporada nessa navegação principal. A conta e os props efectivos da sessão real permanecem por conferir,porque o conector está indisponível;não se presume falta de autorização.
+
+Incremento em QA: área de trabalho explícita no menu principal,inclusive entrada neutra de acesso;destinos privados apenas segundo capacidades anteriores;mesmo catálogo completo na barra lateral,sem perda dos subdestinos;entrada directa na análise proactiva existente,sem substituir rascunhos editados;preservação de Descoberta/Realização/Suporte e todos os destinos anteriores aplicáveis. Sem alteração activa,schema,regras de negócio ou papéis. Escolhas de apresentação não são exigências organizacionais. Verificação dirigida do delta pendente nesta fotografia;nenhuma nova matriz ou backlog.
+
+
+## 28/10/2026 — reorganização dos menus implementada em QA, sem instalação
+
+Recomendação expressa da Tempo após a página principal não apresentar as entradas sugeridas. Causa delimitada no código: a barra lateral omitia subdestinos ao seleccionar apenas o primeiro link de cada grupo; a navegação principal colocava gestão/perfis dentro do menu do nome do utilizador e não incorporava a entrada de gestão já calculada pelo servidor. Não se presume falta de permissões da sessão real, cujos props não foram observados. A entrega6d147693/base interna continua instalada e preservada; esta revisão não reinstala essa base nem repete as provas técnicas aceites.
+
+**Proposta executável QA:** Área de trabalho visível ao lado de Descoberta,Realização,Suporte; entrada neutra Acesso à gestão explica o estado, mesmo sem acções privadas atribuídas. As acções autorizadas e Preparar análise e ideia vêm das capacidades existentes, sem criar papéis. A análise abre directamente no formulário existente; rascunhos guardados não são substituídos. A barra lateral põe trabalho primeiro e conserva todos os destinos e os filtros territoriais entre catálogos, em vez de reduzir grupos ao primeiro destino. O cabeçalho permite quebra de linha em largura intermédia; os controlos móveis e do teclado existentes são reutilizados.
+
+**Verificação delimitada:**16 testes de navegação/renderização estrutural,0falhas;tipos,compilação QA e sintaxe PHP passaram. Quatro cenários de capacidades conservaram todos os destinos anteriores; não surgem operações privadas em cenário anónimo ou sem atribuições. SSR usa o componente real da barra lateral com wrappers semânticos de teste; não equivale a captura do navegador. A prévia HTML é um inventário interactivo de destinos, sem pedidos ao portal, identificado como proposta QA, não como sessão real.
+
+**Pendente:** conferência visual desktop/móvel/teclado/toque e das capacidades efectivas da sessão relatada; o host do conector permanece indisponível no último diagnóstico. Não substituir essa conferência por alegação de acesso demonstrado. A instalação futura deve transportar só o delta de menus pelo processo Git/backup/restauro existente, preservando originais, dados, permissões, contexto,dossier e simulador.435 observações de Gurué não são435empresas únicas; listas internas/cobertura parcial/hipótese preservadas. L8 continua parcial.
+
+Inventário anterior registado antes dos testes nesta matriz/manual. Actualização apenas nos requisitos existentesV2-01,V2-07,V2-10,MASTER-9dee08d0-0011,MASTER-9f6dd1d9-0001,MASTER-9f6dd1d9-0003,MASTER-02f44baf-0002;não há matriz ou backlog novos. Relatório:`navigation-reconciliation-qa-20261028.json`;prévia:`outputs/navigation-reconciliation-20261028/menu-proposta-qa.html`.
+
+A apresentação da gestão antiga usa agora a decisão efectiva já existente (`legacyWriteAllowed`, com o requisito de email verificado das rotas), em vez de presumir que o indicador genérico de gestor basta. Não se alteraram regras, atribuições ou permissões. Preservada também a entrada de instalação de perfis anteriormente presente apenas na barra lateral autorizada. Os nomes longos quebram linha na barra lateral, sem reticências que escondam a função.
+
+
+## 28/10/2026 — menus 6e8de43a instalados pelo Git; conferência visual pendente
+
+A Tempo aprovou a proposta QA e autenticou o transporte SSH existente. `main` avançou normalmente de `6d147693` para `6e8de43a`, sem force. A entrega usou o pipeline existente, sem alterar o seu contrato de schema, sem migrações, importações, atribuições de papéis ou permissões. Os 16 testes dirigidos e as provas QA aceites foram reutilizados; as verificações automáticas obrigatórias do pipeline não representam nova aceitação funcional.
+
+Capacidade conferida antes da entrega: cerca de 78,5 GiB livres. Backup novo em `/var/backups/investmoz-navigation-delivery-20261028/backup`; restauro em base isolada, sem rede, confirmou as 176 tabelas por contagens/checksums. Os 369 ficheiros persistentes/configuração mantêm-se idênticos. As tabelas de domínio, incluindo base interna, relações e permissões, foram comparadas com o snapshot do backup; apenas alterações operacionais de cache/sessão são registadas separadamente. A versão anterior está preservada para retorno pelo mecanismo existente.
+
+O delta instalado contém Área de trabalho no nível principal, destinos subordinados completos na barra lateral e continuidade para os destinos existentes de investimento, conteúdos e acompanhamento. A exposição das acções respeita a decisão efectiva do servidor; não se infere nova autorização pelo nome genérico de gestor. A presença dos assets e props instalados foi conferida tecnicamente, sem a apresentar como prova da sessão real.
+
+Pendente: conferência visual autenticada desktop/móvel/teclado/toque e percurso Gurué → consultar oferta → comparar ideia → guardar → recuperar no mesmo dossier. Último bloqueio conhecido: `The browser access host is unavailable`; uma aba aberta não restabelece o host. Não repetir as provas QA aceites nem reinstalar a base interna para resolver essa pendência. As 435 observações de Gurué não equivalem a 435 empresas únicas; listas internas, cobertura parcial e hipótese de investimento mantêm-se explícitas. L8 permanece parcial.
+
+Evidência: `docs/investmoz/unification/navigation-git-delivery-20261028.json`. O relatório QA anterior permanece como histórico do candidato antes da instalação. Actualizados os mesmos sete requisitos existentes, preservando o seu histórico; não foi criada outra matriz.
+# Inventário de preservação — consulta territorial, 28/10/2026
+
+Antes das novas verificações: menus `6e8de43a` instalados, base interna e percurso proactivo preservados; conferência visual autenticada continua pendente. Reutilizam-se as provas anteriores. O caso relatado é Agronegócio / Maputo Província. Em leitura da QA isolada, as 37 oportunidades públicas incluem cinco do Corredor de Maputo; o filtro provincial devolve zero. A correspondência aprovada do corredor para Maputo Província e Maputo Cidade já existe em `config/investment_corridors.php` e `corridor-adaptive-context-20261023.json`, mas a pesquisa não a utiliza. Não se trata de eliminação dos registos. Os cartões mostram apenas província e omitem o detalhe territorial disponível. A correcção é de consulta/apresentação, sem criar localizações distritais não documentadas, relações a mestres, permissões ou novas publicações. Referência aos requisitos existentes V2-07/V2-10; a implementação transversal e a sessão real não ficam declaradas concluídas por este inventário.
+
+
+## 28/10/2026 — correcção provincial do catálogo em QA, ainda sem instalação
+
+Caso da Tempo: Agronegócio / Maputo Província. A leitura QA reproduziu zero resultados para cinco oportunidades públicas do Corredor de Maputo. Reutilizada a decisão expressa de 23/10 que abrange Maputo Província e Maputo Cidade, antes disponível no percurso mas omitida na consulta. O filtro provincial passa a incluir esse contexto aprovado, mantendo sector e estado público, sem duplicar oportunidades nem atribuir distrito/posto administrativo ou coordenadas inexistentes. Uma localização explícita posterior prevalece sobre o contexto antigo.
+
+Os resultados apresentam a hierarquia territorial disponível; o contexto de corredor é identificado e os níveis não indicados continuam explícitos. Pesquisa/API, vista por corredores e lista sem coordenadas do mapa concordam. O atalho «Ver toda a província» elimina a necessidade de limpar vários níveis manualmente. Não foram criadas publicações, relações a mestres ou permissões. Provas QA: 4 testes/70 verificações, zero falhas, transacções revertidas; tipos, compilação QA e sintaxe PHP passaram. O inventário anterior foi registado antes dos testes. Menus 6e8de43a, base interna, históricos e aceitação anterior preservados; L8 permanece parcial.
+
+Relatório: `catalogue-province-coverage-qa-20261028.json`. Instalação pelo processo Git e conferência visual autenticada continuam pendentes. Não declarar auditados todos os outros menus por este delta. Cobertura actualizada nos requisitos existentes V2-07/V2-10; sem nova matriz.
+
+
+28/10 — Âmbito nacional confirmado pela Tempo: antes da extensão dos testes, preservar a correcção QA 1b2ede41 e verificar os seis corredores aprovados nas onze unidades provinciais, hierarquia descendente e reutilização entre sectores/entradas de localização. Não presumir cobertura de corredor onde não está documentada. Nenhuma prova anterior é revogada.
+
+
+
+28/10 - National coverage: 6 tests / 617 assertions passed across all 11 provincial units, 6 configured corridors and 2 sectors, including descendant hierarchy, sector separation and both province/location entry points. The runtime correction already used the common national hierarchy; Maputo was the reported reproduction, not a geographic limit. Existing publication decisions and unknown district/post/site information remain preserved. This is not a claim that every unrelated portal menu has been audited. No additional runtime change since 1b2ede41; types/build accepted evidence reused. Installation remains pending.
+
+
+28/10 - Before selector delta checks: accepted national catalogue QA 47dae1b7, 6 tests/617 assertions, remains uninstalled. Existing TerritoryLevel and ProvinceSelect required two separate fields (search then select). Tempo requests one dropdown on the search field. Consolidate the shared controls while retaining saved values, hierarchy, endpoints, paging and permission decisions;browser visual proof remains separate.
+
+
+
+## 28/10/2026 — selecção territorial num único campo de pesquisa, QA
+
+Pedido expresso da Tempo: o dropdown deve abrir em «Pesquisar província», sem um segundo controlo «Seleccione». `ProvinceSelect` e `TerritoryLevel` passam a usar o mesmo combobox, aplicado a província, distrito, posto administrativo e localidade. Pesquisar e escolher fica num único campo; a paginação permanece na lista. Escrever ou sair com Escape não substitui a selecção guardada; escolher e limpar são acções expressas. Mantêm-se a hierarquia, os endpoints existentes e os controlos de acesso, sem novos dados ou publicações.
+
+Quatro testes do contrato de eventos/estado passaram: abertura/escolha, preservação ao escrever/Escape, teclado e bloqueio de resultado antigo durante carregamento, limpeza e dependência do nível anterior. Tipos e compilação QA passaram. As 6 provas nacionais/617 verificações são reutilizadas porque o PHP territorial não mudou. Este delta continua em QA e não comprova apresentação ou sessão real no navegador. Será agrupado com a correcção provincial; falta autenticação SSH antes da entrega, sem nova aprovação organizacional.
+
+
+28/10 - Before catalogue presentation checks: accepted province QA6/617 and unified selector QA4 remain preserved and uninstalled. Tempo reports Tourism/Cabo Delgado shows educational text and broad sector links. Read-only public API confirmed zero filtered records;unfiltered tourism returns16 records,all declared in Inhambane. This does not establish absence of tourism supply in Cabo Delgado. Correct presentation to retain filters and expose guides only as optional links;do not republish or reassign opportunities to manufacture results.
+
+## 28/10/2026 — resultados do catálogo separados do apoio educativo, QA
+
+A Tempo esclareceu que a combinação província/sector deve apresentar as oportunidades correspondentes, sem texto educativo ou atalhos que troquem a consulta por todas as oportunidades do sector. A consulta pública anónima conferiu Turismo/Cabo Delgado = zero oportunidades cadastradas; Turismo sem localização = 16, todas declaradas em Inhambane. Este snapshot não prova ausência de oferta turística em Cabo Delgado e não substitui inventário de fontes ou consulta autenticada.
+
+Correcção de apresentação em QA: título dos resultados explicita sector e hierarquia escolhidos; removidos os cartões educativos e o botão sectorial sem localização da área de resultados. Os guias mantêm-se como títulos ligados em apoio opcional fechado por defeito. A remoção da localização é uma acção expressamente identificada como pesquisa noutras províncias. O estado vazio refere o cadastro consultado e a cobertura incompleta, sem fabricar oportunidades nem alargar automaticamente filtros.
+
+Dois testes SSR do novo apoio opcional passaram, bem como tipos e compilação. As provas territoriais nacionais 6/617 e os quatro testes do selector são reutilizados; não mudou a consulta PHP ou o controlo territorial neste delta. Mantêm-se histórico, publicações, permissões, fontes e base interna. Este candidato continua sem instalação, dependente de autenticação SSH; a sessão real permanece sem prova visual. Relatório existente: `catalogue-province-coverage-qa-20261028.json`, campo `catalogue_result_presentation`. Requisitos V2-07/V2-10 actualizados na mesma matriz; L8 permanece parcial.
+
+
+28/10 - Before investor usability checks: accepted catalogue candidate54d1b2a5 remains in QA,not installed;active menus6e8de43a and earlier supply proofs preserved. Two Tempo attachments identify duplicate profile navigation,an exposed long canonical form and ZEE/ZFI/park searches that keep prior results until manual submit. Prepare presentation-only adaptive field groups and safe save-before-resource navigation;verify territorial search/count/paging and documented scope without republishing records or changing permissions. Reuse prior proofs;existing V2-07/V2-10 scope retained.
+
+## 28/10/2026 — usabilidade do investidor e consulta territorial, QA
+
+Pedidos da Tempo e exemplos recebidos: menu/ficha de oportunidade, zonas/parques, pedido de Promotor, Os meus investimentos, documentos/formulários e recusa autenticada em Turismo. Inventário anterior registado antes dos testes: menus 6e8de43a e base interna instalados; candidato territorial 54d1b2a5 ainda em QA; originais, dados, relações, histórico, aprovações e provas anteriores preservados.
+
+Delta QA: acções do investidor em primeiro plano, administração em detalhe consultável; campos do contrato existente agrupados por tarefa e modalidade, com navegação livre e todos os campos montados para conservar edições. Os grupos mostram as pendências da última gravação e os erros existentes; não criam seis ou oito formulários obrigatórios. Guardar usa os mesmos endpoints/ETags; abrir recursos pela preparação guarda primeiro e regressa à mesma oportunidade/grupo. Contactos e detalhes de disponibilidade ficam opcionais; códigos técnicos de categorias e campos conhecidos têm nomes em português. Só um contexto único de promotor é escolhido automaticamente.
+
+Zonas: selecção territorial aplica pesquisa sem esperar por outro clique; a lista anterior deixa de aparecer durante carregamento/erro. Totais, intervalo visível e páginas identificados, sem apresentar a primeira página como o conjunto completo. «Todo o território» remove expressamente a localização, preservando os restantes critérios visíveis. Abrangência jurídica documentada e validada inclui os níveis descendentes; influência não se torna implantação. Não são criadas localizações, direitos, publicações ou certificados.
+
+Pedido de Promotor: representação/modalidades com nomes claros; pesquisa de ficheiros e selecção expressa dos comprovativos, preservando os escolhidos ao pesquisar. Mantidos propriedade, análise antimalware e verificações existentes; legislação/imagem/teste não se torna comprovativo por estar disponível. Os meus investimentos destaca a próxima acção e permite abrir fases/etapas; fontes, códigos e acompanhamento interno ficam preservados em detalhes.
+
+Formulários: entradas directas para os campos já existentes da preparação do pedido de investimento e Terra/DUAT; pedido de apoio identificado separadamente. Originais oficiais e guias continuam consultáveis, sem os confundir com um formulário preenchível ou converter leis em campos/cálculos. Não se declara executada a totalidade dos formulários oficiais do acervo.
+
+Provas delimitadas: 8 testes frontend de contrato/SSR e 3 testes isolados/12 verificações, zero falhas; tipos, compilação e sintaxe PHP passaram. Dados sintéticos revertidos em QA. Provas nacionais/selector/catálogo anteriores reutilizadas. Turismo: leitura anónima activa HTTP200 e QA visitante/conta sem Promotor HTTP200; a recusa da sessão real relatada não foi reproduzida, nem atribuída a uma permissão sem prova. A conferência autenticada e visual continua pendente. Este registo não instala o candidato nem encerra a implementação transversal. L8 permanece parcial.
+
+Evidência: `investor-usability-qa-20261028.json`. Actualizados V2-01,V2-07,V2-10 na matriz existente; sem nova matriz ou backlog.
+
+
+### 28/10 — botão de cadastro e compatibilidade do pipeline
+
+A Tempo esclareceu que a recusa em Turismo ocorreu depois de clicar num botão; não foi possível recuperar o nome. A rota pública continuou HTTP200. Conferência de forma pública/origem não identificou anexos privados nos documentos públicos de Turismo; não se atribui a recusa à perda de publicação. Encontrada uma falha delimitada no consumidor: o botão de cadastro dependia da disponibilidade do módulo, sem a capacidade efectiva da conta. Corrigido para reutilizar o destino autorizado de criação de ContentManagement; sem essa capacidade, mostra expressamente o pedido de acesso já existente. Não cria papéis nem restringe a consulta pública ou a preparação de ideias. A confirmação visual da acção real permanece pendente.
+
+O candidato 502e3ec4 falhou na Unit de agrupamento de corredores antes da troca de release; 6e8de43a ficou servido. Causa: a simulação do catálogo não representava a nova apresentação de localização e uma consulta era feita antes de conferir se a fonte era aplicável. Correcção: conferir primeiro a fonte e simular a nova dependência no teste, conservando as verificações anteriores de identidade, grupos e contagens. Regressão Unit1/13 passou; não foi alterado o pipeline, o contrato de schema ou a exigência dos testes. Frontend9, Feature3/14, tipos e compilação passaram. Rótulos conhecidos de temas, categorias e idiomas do acervo traduzidos para apresentação; valores dos filtros preservados.
+
+
+## 28/10/2026 — entrega agrupada de usabilidade e filtros instalada, 789fffd0
+
+Entrega autorizada pela Tempo e autenticada pelo mecanismo SSH existente. `main` avançou normalmente e o pipeline existente instalou `789fffd0`, preservando a release anterior `6e8de43a`. O candidato inicial `502e3ec4` foi recusado antes da troca por uma dependência não representada no teste Unit do agrupamento de corredores; o activo ficou preservado. A consulta desnecessária foi corrigida e a nova dependência simulada, conservando as provas anteriores. O pipeline e o seu contrato de schema não foram enfraquecidos.
+
+Backup/restauro de 176 tabelas confirmado numa instância isolada, sem rede. Os 369 ficheiros persistentes/configuração mantêm-se idênticos. A comparação do snapshot com o instalado preserva as tabelas de domínio, incluindo papéis, publicações, originais e base interna; diferenças de cache/sessões são registadas separadamente. Sem migrações, importações ou activação fiscal. A versão anterior permanece disponível para o mecanismo de retorno.
+
+Incluídos: consulta provincial nacional/corredores e detalhe territorial; pesquisa/selecção num único controlo; resultados do catálogo separados do apoio educativo; grupos adaptáveis de preenchimento, navegação livre e gravação antes de abrir recursos; pedido de Promotor legível com comprovativos escolhidos expressamente; zonas filtradas ao seleccionar, contagens/paginação visíveis; fases/etapas do dossier e fontes em detalhes; entradas para formulários de preparação já existentes; CTA sectorial conforme capacidade efectiva; rótulos do acervo legíveis. Não são novas permissões, publicações ou formulários fiscais oficiais inventados.
+
+Conferidos o commit servido, APIs filtradas e assets instalados. Reutilizadas as provas QA aceites; a bateria obrigatória do pipeline não reabre a sua aceitação. Mantém-se pendente a conferência visual autenticada, incluindo navegação, ida/volta a recursos e Gurué no mesmo dossier. A recusa relatada em Turismo ocorreu após um botão; a falha concreta do CTA de cadastro foi corrigida, mas não se declara reproduzida e resolvida a acção original sem a sessão real. A escolha do formulário fiscal concreto ainda precisa de ser esclarecida; os diplomas IVA mostrados não são formulários preenchíveis.
+
+Estado actual: `investor-usability-git-delivery-20261028.json`. Os relatórios QA anteriores conservam o estado histórico antes da instalação. As 435 observações de Gurué não são 435 empresas; as listas são internas, a cobertura nacional é parcial e a comparação sustenta hipóteses. L8 permanece parcial. Actualizados V2-01/V2-07/V2-10 na matriz e manual existentes.
+
+
+## 28/10/2026 — preparação de formulários fiscais, inventário antes das provas
+
+Pedido expresso da Tempo: preencher formulário de IVA ou IRPC, em vez de abrir legislação. Base preservada: entrega instalada 789fffd0, Modelo A e aquisições/apuramento já aceites, L6 M20/M22 instalado em 5aaf1a56 e incrementos de L8. Nenhuma perda confirmada neste recorte; não se apagam as aceitações nem se repetem provas fiscais anteriores. Fontes reutilizadas do inventário de 20 exemplares acessíveis em outputs/irpc-l6-values-forms/accessible-source-inventory.json da QA anterior, incluindo temporários identificados; inventário do corpus e originais preservados. M22: três páginas conferidas visualmente nesta revisão, SHA256 4b61bd83d1fbcfd3b7b5c5523cea5923f7d0f65dc4c004eff58e5db38f763c88. Modelo A: correspondência e divergências aceites em modelo-a-reconciliacao-20261021.md; sem nova validação de proveniência.
+
+Incremento em preparação QA: entrada directa em Documentos e Formulários, preenchimento manual dos campos correspondidos de IVA e subconjunto M22, identificação/período, revisão, impressão e ficheiro privado para recuperação mediante confirmação. Escolha técnica: sem persistência no servidor nem ligação automática ao dossier neste incremento; não altera schema, dados, permissões ou cálculos. Ficheiro não publicado. IRPC ajustamentos completos, outros regimes, anexos, assinatura e submissão à AT fora da cobertura; L8 permanece parcial. Ainda sem instalação deste incremento. Próximas provas apenas do delta: fidelidade da recuperação, rejeição de ficheiros incompatíveis sem perda, formatos/valores desconhecidos, acesso público e compilação.
+
+
+## 29/10/2026 — ACT-20261029-01, inventário antes da verificação do incremento
+
+Continuação sequencial solicitada pela Tempo. Correspondência: ACT-20261029-01 reutiliza D-02 §8, clusters/cadeias e a orientação metodológica documentada em 23/10. Concluído previamente e preservado: gestão de clusters, etapas, ligações, lacunas e relações auditadas; disponibilidade instalada de carteira/âncoras e formulários fiscais conforme recibos de 28/10. Nenhuma perda nova confirmada nesta inspecção de código; não foi feita nova comparação de dados ou alegada prova do servidor. A pasta principal está em fde644af, enquanto o último recibo identifica 332c16eb instalado; reconciliar o delta sobre essa origem antes de instalar, sem substituir o destino pela pasta principal.
+
+Incremento em preparação: diagnóstico qualitativo das cinco forças na edição do cluster, sector/região editáveis, fonte/período/evidência/justificação/limites/oportunidade por força; indeterminação explícita, ficheiro privado transferível e recuperação com confirmação. Sem alteração de schema, dados, permissões, publicações ou motores fiscais. Persistência no servidor, ligação territorial canónica, dados sectoriais fundamentados e consulta pública permanecem por implementar; ACT-01 não está concluída. Verificação dirigida e instalação ainda pendentes neste registo inicial. Restantes ACT-02 a 16 mantêm o estado anterior e a sequência, sem trabalho SGF nesta passagem.
+### ACT-20261029-01 — candidato sequencial preparado, 29/10/2026
+
+Primeiro incremento implementado, **parcial e ainda não instalado**: gestão → clusters → editar → Competitividade. As cinco forças conservam fonte, período, evidência, apreciação, limites e oportunidade; sector e região explícitos, sem inferências automáticas. Transferência de rascunhos JSON e recuperação restrita ao mesmo cluster, com confirmação antes de substituir. Quatro testes frontend dirigidos, TypeScript e compilação QA passaram tanto na pasta de trabalho como no candidato baseado em 332c16eb. Guarda C132 local passou; não foram efectuados testes nem escritas na base activa. A edição existente recebe apenas a inclusão do componente; contratos e permissões existentes preservados.
+
+Origem reconciliada: main remoto e revisão pública conferidos em 332c16eb em 29/10. Candidato em C:/laragon/www/portal-investidor-competitiveness-qa-20261029, ramo codex/competitiveness-sequential-20261029. Consulta do estado remoto não equivale a inventário novo da base. Sessão SSH anterior encerrada; autenticação por chave recusada. Instalação requer autenticação SSH, backup fresco, restauro isolado, guarda de versão, pipeline existente e conferência posterior. Não instalar a pasta principal sobre o destino. A sequência solicitada mantém ACT-02 a 16 por iniciar após a instalação e o saldo de ACT-01; persistência no servidor, cobertura factual e consulta pública continuam pendentes. Sem declaração de conferência visual autenticada.
+### 29/10/2026 — ACT-20261029-01, primeiro incremento instalado: 23ecccfa
+
+Estado corrente de ACT-01: **parcial — primeiro incremento instalado**, substituindo apenas o estado planeado/preparado deste recorte; ACT-02 a 16 não foram implementadas nesta entrega. Instalado por avanço normal de main e pipeline existente em https://teste-investidor.tempo.co.mz/. Entrada: Gestão → Clusters → Editar → Competitividade — cinco forças de Porter. Preparação qualitativa por sector/região, evidências/fontes/períodos/limites e oportunidades, transferência JSON e recuperação confirmada do mesmo cluster. Sem gravação no servidor nem publicação da análise. Persistência, cobertura factual, território canónico e consulta pública continuam pendentes; esta instalação não encerra o critério amplo ACT-01.
+
+Provas: backup fresco, restauro isolado sem rede das 176 tabelas; pipeline com lifecycle de schema (3.106 asserções), 59 testes Unit/320 asserções e 1.180 testes frontend sem falhas, tipos e compilação; quatro ficheiros do incremento conferidos por SHA-256 no instalado; C132 no destino passou. Comparação após instalação: todas as 176 tabelas de domínio preservadas, diferenças operacionais apenas em cache/sessões; 369 ficheiros/configuração idênticos. Acesso anónimo ao catálogo privado recusado HTTP401. Zero migrações/importações, nenhuma nova divulgação nem mudança de permissões; versão anterior 332c16eb preservada. Conferência visual autenticada permanece pendente. Recibo: `docs/investmoz/unification/competitiveness-sequential-qa-20261029.json`, em docs/investmoz/unification. As provas aceites anteriores foram reutilizadas; não foram reabertas por esta entrega.
@@ -3006,3 +3006,20 @@ AUD-SIM-INT01 through AUD-SIM-INT08 are recorded in the same matrix and manual.
 Actualização QA de 20/10/2026: os mesmos oito itens foram reconciliados no manual e nas duas tabelas existentes. Data com mensagem junto ao campo; inventário dos parâmetros efectivos (zero regras fiscais QA); controlos matemáticos independentes; aviso de recálculo; quatro relatórios reais do exportador com 6/6/6/5 páginas; consulta fiscal com erro/nova tentativa e traduções comuns verificados. O formulário personalizado já não exige contexto fiscal que não envia ao cálculo. Restam continuidade autenticada entre dois dossiers/nova sessão e histórico, mudança de parâmetros, controlos delimitados de cash-flow/plano, impressão nativa Edge/comparação pela interface e mensagens dinâmicas/falhas dirigidas de gravação/exportação. Estimativa restante **6–10 h**, distinta das 18–30 h iniciais. Sem main, servidor remoto, importação ou activação fiscal. Exemplos PDF são renderizações do DOCX; não certificam impressão do Edge. Ver o saldo detalhado AUD-SIM-INT01–08 no mesmo manual.

 Continuação delimitada: dois dossiers e nova entrada conferidos no navegador; histórico agora visível no percurso de pequeno negócio, hashes preservados; Abrir cálculo encaminha para a etapa financeira; repetição de gravação após 503 corrigida e conferida; controlos independentes de tesouraria/plano passaram. CSV e Word descarregados pela interface coincidem nos valores comuns e apresentam a receita completa do crédito. Seis páginas do DOCX conferidas; PDF nativo ainda aguarda gravação pelo utilizador. QA tem zero regras com visibilidade completa, mas existem três originais fiscais versionados e análises/referências reutilizáveis; não se concluiu ausência na homologação sem autenticação SSH. Versões sintéticas testadas apenas em memória, sem cadastro/activação. Encontrada e corrigida perda dos pressupostos da tesouraria: snapshot no JSON existente, recuperação por dossier e relatório, sem migration; testes HTTP/frontend passaram, falta conferência visual deste novo delta. Saldo **2–4 h** após acessos/ficheiro, detalhado no mesmo manual; integração do motor fiscal permanece separada e não foi implementada. Sem main ou intervenção remota.
+
+
+## 29/10/2026 — ACT-20261029-01, inventário antes da verificação do incremento
+
+Continuação sequencial solicitada pela Tempo. Correspondência: ACT-20261029-01 reutiliza D-02 §8, clusters/cadeias e a orientação metodológica documentada em 23/10. Concluído previamente e preservado: gestão de clusters, etapas, ligações, lacunas e relações auditadas; disponibilidade instalada de carteira/âncoras e formulários fiscais conforme recibos de 28/10. Nenhuma perda nova confirmada nesta inspecção de código; não foi feita nova comparação de dados ou alegada prova do servidor. A pasta principal está em fde644af, enquanto o último recibo identifica 332c16eb instalado; reconciliar o delta sobre essa origem antes de instalar, sem substituir o destino pela pasta principal.
+
+Incremento em preparação: diagnóstico qualitativo das cinco forças na edição do cluster, sector/região editáveis, fonte/período/evidência/justificação/limites/oportunidade por força; indeterminação explícita, ficheiro privado transferível e recuperação com confirmação. Sem alteração de schema, dados, permissões, publicações ou motores fiscais. Persistência no servidor, ligação territorial canónica, dados sectoriais fundamentados e consulta pública permanecem por implementar; ACT-01 não está concluída. Verificação dirigida e instalação ainda pendentes neste registo inicial. Restantes ACT-02 a 16 mantêm o estado anterior e a sequência, sem trabalho SGF nesta passagem.
+### ACT-20261029-01 — candidato sequencial preparado, 29/10/2026
+
+Primeiro incremento implementado, **parcial e ainda não instalado**: gestão → clusters → editar → Competitividade. As cinco forças conservam fonte, período, evidência, apreciação, limites e oportunidade; sector e região explícitos, sem inferências automáticas. Transferência de rascunhos JSON e recuperação restrita ao mesmo cluster, com confirmação antes de substituir. Quatro testes frontend dirigidos, TypeScript e compilação QA passaram tanto na pasta de trabalho como no candidato baseado em 332c16eb. Guarda C132 local passou; não foram efectuados testes nem escritas na base activa. A edição existente recebe apenas a inclusão do componente; contratos e permissões existentes preservados.
+
+Origem reconciliada: main remoto e revisão pública conferidos em 332c16eb em 29/10. Candidato em C:/laragon/www/portal-investidor-competitiveness-qa-20261029, ramo codex/competitiveness-sequential-20261029. Consulta do estado remoto não equivale a inventário novo da base. Sessão SSH anterior encerrada; autenticação por chave recusada. Instalação requer autenticação SSH, backup fresco, restauro isolado, guarda de versão, pipeline existente e conferência posterior. Não instalar a pasta principal sobre o destino. A sequência solicitada mantém ACT-02 a 16 por iniciar após a instalação e o saldo de ACT-01; persistência no servidor, cobertura factual e consulta pública continuam pendentes. Sem declaração de conferência visual autenticada.
+### 29/10/2026 — ACT-20261029-01, primeiro incremento instalado: 23ecccfa
+
+Estado corrente de ACT-01: **parcial — primeiro incremento instalado**, substituindo apenas o estado planeado/preparado deste recorte; ACT-02 a 16 não foram implementadas nesta entrega. Instalado por avanço normal de main e pipeline existente em https://teste-investidor.tempo.co.mz/. Entrada: Gestão → Clusters → Editar → Competitividade — cinco forças de Porter. Preparação qualitativa por sector/região, evidências/fontes/períodos/limites e oportunidades, transferência JSON e recuperação confirmada do mesmo cluster. Sem gravação no servidor nem publicação da análise. Persistência, cobertura factual, território canónico e consulta pública continuam pendentes; esta instalação não encerra o critério amplo ACT-01.
+
+Provas: backup fresco, restauro isolado sem rede das 176 tabelas; pipeline com lifecycle de schema (3.106 asserções), 59 testes Unit/320 asserções e 1.180 testes frontend sem falhas, tipos e compilação; quatro ficheiros do incremento conferidos por SHA-256 no instalado; C132 no destino passou. Comparação após instalação: todas as 176 tabelas de domínio preservadas, diferenças operacionais apenas em cache/sessões; 369 ficheiros/configuração idênticos. Acesso anónimo ao catálogo privado recusado HTTP401. Zero migrações/importações, nenhuma nova divulgação nem mudança de permissões; versão anterior 332c16eb preservada. Conferência visual autenticada permanece pendente. Recibo: `docs/investmoz/unification/competitiveness-sequential-qa-20261029.json`, em docs/investmoz/unification. As provas aceites anteriores foram reutilizadas; não foram reabertas por esta entrega.
@@ -236,6 +236,7 @@
 }
@media (min-width: 1280px) {
    .tempo-header-inner {
+        grid-template-rows: minmax(71px, auto);
        grid-template-columns: auto minmax(0, 1fr) auto auto auto;
        column-gap: 0.25rem;
        padding-inline: 1.25rem;
@@ -256,6 +257,7 @@
    }
    .tempo-primary-navigation > ul {
        display: flex;
+        flex-wrap: wrap;
        align-items: center;
        gap: 0;
    }
@@ -1,10 +1,8 @@
-import { profileLinks } from '@/components/profile-navigation';
+import {PortalSidebarNavigation} from '@/components/portal-sidebar-navigation';
 import type { ProfileAccess } from '@/types/profile-access';
 import { Link, usePage } from '@inertiajs/react';
-import { LayoutGrid } from 'lucide-react';
-import { portalNavigation } from '@/lib/portal-navigation';
+import { portalNavigation,canShowLegacyManagement } from '@/lib/portal-navigation';
 import AppLogo from '@/components/app-logo';
-import { NavMain } from '@/components/nav-main';
 import { NavUser } from '@/components/nav-user';
 import {
    Sidebar,
@@ -20,6 +18,7 @@ import type { Auth } from '@/types';
 import type { OpportunityManagementAccess } from '@/types/opportunity-management';

 export function AppSidebar() {
+    const currentPage=usePage();
    const {
        auth,
        existingBusinessEnabled,
@@ -27,7 +26,9 @@ export function AppSidebar() {
        aiEnabled,
        opportunityManagement,
        contentManagementHref,
+        contentManagementAccess,
        profileAccess,
+        scopedAdministration,
    } = usePage<{
        auth: Auth;
        existingBusinessEnabled?: boolean;
@@ -36,45 +37,26 @@ export function AppSidebar() {
        profileAccess?: ProfileAccess | null;
        opportunityManagement?: OpportunityManagementAccess | null;
        contentManagementHref?: string | null;
+        scopedAdministration?: {label:string;href:string}[];
+        contentManagementAccess?: {opportunities?:{index:string;create?:string|null}};
    }>().props;
    const groups = portalNavigation({
        authenticated: !!auth.user,
-        manager: auth.canManagePortal,
+        manager: canShowLegacyManagement(auth),
        businesses: existingBusinessEnabled,
        education: educationEnabled,
        ai: aiEnabled,
        opportunityManagement,
+        profileAccess,
+        contentManagementHref,
+        contentManagementAccess,
+        scopedAdministration,
+        legacyContent: currentPage.props.legacyContentEnabled as boolean|undefined,
+        procurement: currentPage.props.procurementEnabled as boolean|undefined,
+        businessReviewUrl: currentPage.props.businessReviewUrl as string|null|undefined,
    });
-    const items = groups.map((group) => ({
-        title: group.label,
-        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,
-            href: opportunityManagement.manage.href,
-            icon: LayoutGrid,
-        });
-        if (opportunityManagement.installed) {
-            items.push({
-                title: opportunityManagement.create.label,
-                href: opportunityManagement.create.href,
-                icon: LayoutGrid,
-            });
-        }
-    }
-    items.push(
-        ...profileLinks(profileAccess).map((link) => ({
-            ...link,
-            icon: LayoutGrid,
-        })),
-    );
    return (
-        <Sidebar collapsible="icon" variant="inset">
+        <Sidebar collapsible="offcanvas" variant="inset">
            <SidebarHeader>
                <SidebarMenu>
                    <SidebarMenuItem>
@@ -88,7 +70,7 @@ export function AppSidebar() {
            </SidebarHeader>

            <SidebarContent>
-                <NavMain items={items} />
+                <PortalSidebarNavigation groups={groups} url={currentPage.url}/>
            </SidebarContent>

            <SidebarFooter>
@@ -0,0 +1,15 @@
+import { Link } from '@inertiajs/react';
+import type { EducationalArticle } from './educational-article-card';
+
+/** Guides remain available on request; they are not matching investment results. */
+export default function CatalogueGuideLinks({ articles }: { articles: EducationalArticle[] }) {
+    if (!articles.length) return null;
+    return <details className="rounded border p-3">
+        <summary className="cursor-pointer font-medium">Guias do sector — apoio opcional</summary>
+        <ul className="mt-3 space-y-2">
+            {articles.map((article) => <li key={article.href}>
+                <Link className="underline" href={article.href}>Ler guia: {article.title}</Link>
+            </li>)}
+        </ul>
+    </details>;
+}
@@ -2,5 +2,5 @@ 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;
+    return contentManagementHref ? <Link className="inline-block rounded-lg border px-4 py-3 font-semibold underline" href={contentManagementHref}>Área de trabalho</Link> : null;
 }
@@ -3,6 +3,7 @@ import { useEffect, useId, useState } from 'react';
 import { api } from '@/pages/investment/shared';
 import { replaceTerritoryPath } from '@/lib/territory-path.js';
 import TerritoryGeometryPreview from './territory-geometry-preview';
+import TerritorySearchSelect from './territory-search-select';

 export type TerritoryOption = {
    id: string;
@@ -135,37 +136,11 @@ export function ProvinceSelect({
                total={options.length}
                retry={() => setRetry((value) => value + 1)}
            />
-            <input
-                className={className}
-                aria-label={`Pesquisar ${label}`}
-                maxLength={100}
-                placeholder="Pesquisar nome ou código"
-                value={search}
-                onChange={(event) => setSearch(event.target.value)}
-            />
-            <select
-                id={id}
-                aria-label={label}
-                className={className}
-                required={required}
-                value={value}
-                disabled={loading || Boolean(error)}
-                onChange={(event) => onChange(event.target.value)}
-            >
-                <option value="">
-                    {loading ? 'A carregar províncias…' : placeholder}
-                </option>
-                {value && !options.some((option) => option.name === value) && (
-                    <option value={value}>
-                        {value} (seleção guardada; conferir cadastro)
-                    </option>
-                )}
-                {options.map((option) => (
-                    <option key={option.id} value={option.name}>
-                        {option.name}
-                    </option>
-                ))}
-            </select>
+            <TerritorySearchSelect id={id} label={label} className={className} required={required}
+                placeholder={placeholder === 'Seleccione uma província' ? 'Pesquisar província' : placeholder}
+                search={search} onSearch={setSearch} options={options} loading={loading} error={error}
+                selected={value ? options.find((option) => option.name === value) ?? { id: value, name: value } : undefined}
+                onChange={(option) => onChange(option?.name ?? '')} />
            {geometryFeedback && <p role="status">{geometryFeedback}</p>}
            <TerritoryGeometryPreview
                territoryId={
@@ -334,65 +309,15 @@ export function TerritoryLevel({
            <label htmlFor={id} className="font-medium">
                {labels[index]}
            </label>
-            <input
-                className={control}
-                aria-label={`Pesquisar ${labels[index]}`}
-                disabled={!enabled}
-                maxLength={100}
-                value={search}
-                onChange={(event) => {
-                    setSearch(event.target.value);
-                    setPage(1);
-                }}
-                placeholder={`Pesquisar ${labels[index].toLowerCase()}`}
-            />
-            <select
-                id={id}
-                aria-invalid={Boolean(fieldError)}
-                aria-describedby={fieldError ? `${id}-error` : undefined}
-                className={control}
-                disabled={!enabled || loading || !!error}
-                value={selected?.id ?? ''}
-                onChange={(e) =>
-                    onChange(options.find((o) => o.id === e.target.value))
-                }
-            >
-                <option value="">
-                    {enabled ? 'Seleccione' : 'Seleccione o nível anterior'}
-                </option>
-                {selected && !options.some((o) => o.id === selected.id) && (
-                    <option value={selected.id}>
-                        {selected.name}
-                        {selected.deleted_at
-                            ? ' (arquivada)'
-                            : ' (selecção actual)'}
-                    </option>
-                )}
-                {options.map((o) => (
-                    <option key={o.id} value={o.id}>
-                        {o.name}
-                        {o.source_code ? ` (${o.source_code})` : ''}
-                    </option>
-                ))}
-            </select>
+            <TerritorySearchSelect id={id} label={labels[index]} className={control}
+                disabled={!enabled} search={search} onSearch={(query) => { setSearch(query); setPage(1); }}
+                options={options} selected={selected} onChange={onChange} loading={loading} error={fieldError || error}>
+                <div className="flex gap-3 p-2 text-sm">
+                    {page > 1 && <button type="button" onClick={() => setPage(page - 1)}>Anterior</button>}
+                    {more && <button type="button" onClick={() => setPage(page + 1)}>Mais opções</button>}
+                </div>
+            </TerritorySearchSelect>
            {loading && <p role="status">A carregar…</p>}
-            {fieldError && (
-                <p id={`${id}-error`} role="alert">
-                    {fieldError}
-                </p>
-            )}
-            <div className="flex gap-3 text-sm">
-                {page > 1 && (
-                    <button type="button" onClick={() => setPage(page - 1)}>
-                        Anterior
-                    </button>
-                )}
-                {more && (
-                    <button type="button" onClick={() => setPage(page + 1)}>
-                        Mais opções
-                    </button>
-                )}
-            </div>
        </div>
    );
 }
@@ -1,4 +1,4 @@
-import { Link } from '@inertiajs/react';
+import { Link, usePage } from '@inertiajs/react';
 import { useState } from 'react';
 import { fiscalPreparationGuide } from '@/lib/fiscal-preparation-guide';

@@ -8,6 +8,8 @@ export function JourneyDocumentResources({
    stages?: string[];
 }) {
    const [stage, setStage] = useState('');
+    const context=new URL(usePage().url,'https://portal.invalid').searchParams.get('context');
+    const preparationHref=context&&/^[a-f0-9-]{36}$/i.test(context)?`/investimentos/${context}/contexto/editar#preparation-questions`:'/investimentos';
    function destination(path: string, type?: string) {
        const query = new URLSearchParams();
        if (stage) query.set('stage[0]', stage);
@@ -20,8 +22,24 @@ export function JourneyDocumentResources({
            className="space-y-3 rounded-xl border border-emerald-200 bg-emerald-50 p-4"
        >
            <h2 className="font-semibold text-emerald-950">
-                Fontes e guias para a jornada
+                Preencher formulários e preparar documentos
            </h2>
+            <div className="grid gap-3 sm:grid-cols-3">
+                <div className="rounded border bg-white p-3"><h3 className="font-semibold">Pedido de investimento</h3>
+                    <p>Preencha a preparação digital no dossier existente, reutilizando os dados já guardados.</p>
+                    <Link className="underline" href={preparationHref}>Abrir o formulário no meu dossier</Link>
+                </div>
+                <div className="rounded border bg-white p-3"><h3 className="font-semibold">Terra e DUAT</h3>
+                    <p>Prepare os dados do pedido com os campos do formulário existente.</p>
+                    <Link className="underline" href="/terra-duat">Preencher ou continuar pedido de terra</Link>
+                </div>
+                <div className="rounded border bg-white p-3"><h3 className="font-semibold">Pedido de apoio do investidor</h3>
+                    <p>Identifique-se e preencha o pedido de apoio. Este formulário não é um pedido de autorização de investimento.</p>
+                    <Link className="underline" href="/formularios/investidor">Preencher pedido de apoio</Link>
+                </div>
+            </div>
+            <p>Preparação digital e exemplar oficial são apresentados separadamente. Um guia ou diploma não é um formulário preenchível.</p>
+            <details><summary className="cursor-pointer font-medium">Consultar exemplares, fontes e guias</summary>
            <p>
                Prepare as etapas em paralelo. A disponibilidade para consulta,
                a situação jurídica e a utilização numa regra ou cálculo são
@@ -143,6 +161,7 @@ export function JourneyDocumentResources({
            <Link className="underline" href="/documentos">
                Explorar todo o acervo autorizado
            </Link>
+            </details>
        </section>
    );
 }
@@ -7,6 +7,9 @@ import { valueText } from '@/lib/value-text';
 import OpportunityParcelGeometry from './opportunity-parcel-geometry';
 import TerritoryGeometryPreview from './territory-geometry-preview';
 import { control } from '@/pages/management/shared';
+import OpportunityFillFlow from './opportunity-fill-flow';
+import { opportunityFillGroups } from '@/lib/opportunity-fill-flow';
+import { modalityLabels } from './opportunity-search-filters';

 type Data = Record<string, unknown>;
 type Schema = {
@@ -241,6 +244,11 @@ const labels: Record<string, string> = {
    assessment_status: 'Estado da avaliação',
    environmental_category: 'Categoria ambiental',
    direct_jobs: 'Empregos diretos',
+    indirect_jobs: 'Empregos indirectos',
+    female_percentage: 'Participação de mulheres (%)',
+    youth_percentage: 'Participação de jovens (%)',
+    social_risks: 'Riscos sociais',
+    mitigation_plan: 'Plano de mitigação',
    employment_type: 'Tipo de emprego',
    geometry: 'Geometria da parcela',
    start_date: 'Data de início',
@@ -621,6 +629,8 @@ export default function OpportunityCanonicalFields({
    sectors,
    disabled = false,
    errors = {},
+    onOpenResources,
+    missingPaths,
 }: {
    value: Data;
    onChange: (v: Data) => void;
@@ -631,6 +641,8 @@ export default function OpportunityCanonicalFields({
    sectors: { id: number; name: string }[];
    disabled?: boolean;
    errors?: Record<string, string>;
+    onOpenResources?: (group: string) => void;
+    missingPaths?: string[];
 }) {
    const initiative = (value.initiative ?? {}) as Data;
    const isInitiative = category === 'investment_project' && ['program', 'portfolio'].includes(valueText(initiative.kind ?? ''));
@@ -815,7 +827,7 @@ export default function OpportunityCanonicalFields({
                : ['classified_other'];
    return (
        <fieldset disabled={disabled} className="space-y-4 rounded border p-4">
-            <legend>Contrato da oportunidade — {category}</legend>
+            <legend>Preparar oportunidade — {modalityLabels[category] ?? 'Modalidade por escolher'}</legend>
            <p>
                O rascunho pode ficar incompleto. A submissão verifica os campos
                aplicáveis e os recursos guardados. Validação interna não
@@ -870,7 +882,7 @@ export default function OpportunityCanonicalFields({
                    </>}
                </section>
            )}
-            {[...new Set([...common, ...specialized])].map((key) => {
+            <OpportunityFillFlow groups={opportunityFillGroups([...new Set([...common, ...specialized])].filter((key) => !ignoredFields.includes(key)))} errors={errors} missingPaths={missingPaths} onOpenResources={onOpenResources} renderField={(key) => {
                if (ignoredFields.includes(key)) return null;

                if (key === 'relations' && options.classification) {
@@ -1167,7 +1179,7 @@ export default function OpportunityCanonicalFields({
                        onChange={(v) => set(key, v)}
                    />
                ) : null;
-            })}
+            }} />
        </fieldset>
    );
 }
@@ -2,7 +2,7 @@ import { Link } from '@inertiajs/react';
 import { useState } from 'react';
 import { button, card, input } from '@/pages/investment/shared';

-type Item = {id:number;title:string;slug:string;summary:string|null;province:string|null;district:string|null;chains:string[];stages:string[];maturity_label:string|null};
+type Item = {id:number;title:string;slug:string;summary:string|null;province:string|null;district:string|null;provinces?:string[];territorial_summary?:string;chains:string[];stages:string[];maturity_label:string|null};
 export type CorridorGroup = {id:string;name:string;count:number;locations:string[];opportunities:Item[]};
 type Props = {groups:CorridorGroup[];selected:number[];onSelect:(id:number,checked:boolean)=>void;onCompare:(ids:number[])=>void;onClear:()=>void};

@@ -10,10 +10,11 @@ function Group({group,selected,onSelect}: {group:CorridorGroup} & Pick<Props,'se
    const [province,setProvince]=useState('');
    const [district,setDistrict]=useState('');
    const [chain,setChain]=useState('');
-    const provinces=[...new Set(group.opportunities.map(r=>r.province).filter((s):s is string=>!!s))].sort();
-    const districts=[...new Set(group.opportunities.filter(r=>!province||r.province===province).map(r=>r.district).filter((s):s is string=>!!s))].sort();
+    const provinceNames=(r:Item)=>r.provinces??(r.province?[r.province]:[]);
+    const provinces=[...new Set(group.opportunities.flatMap(provinceNames))].sort();
+    const districts=[...new Set(group.opportunities.filter(r=>!province||provinceNames(r).includes(province)).map(r=>r.district).filter((s):s is string=>!!s))].sort();
    const chains=[...new Set(group.opportunities.flatMap(r=>r.chains))].sort();
-    const rows=group.opportunities.filter(r=>(!province||r.province===province)&&(!district||r.district===district)&&(!chain||r.chains.includes(chain)));
+    const rows=group.opportunities.filter(r=>(!province||provinceNames(r).includes(province))&&(!district||r.district===district)&&(!chain||r.chains.includes(chain)));
    return <section className={card+' space-y-4'} aria-label={group.name}>
        <header><h2 className="text-2xl font-bold">{group.name}</h2><p>{group.count} oportunidades publicadas</p>
            <p>{group.locations.length ? 'Localizações identificadas: '+group.locations.join(' · ') : 'Abrangência territorial por indicar.'}</p></header>
@@ -25,7 +26,7 @@ function Group({group,selected,onSelect}: {group:CorridorGroup} & Pick<Props,'se
        <p role="status">{rows.length} oportunidades com estes filtros</p>
        <div className="grid gap-4 md:grid-cols-2 xl:grid-cols-3">{rows.map(r=><article key={r.id} className="space-y-3 rounded-lg border p-4">
            <h3 className="text-lg font-semibold"><Link href={'/oportunidades/'+r.slug}>{r.title}</Link></h3>
-            <p>{[r.province,r.district].filter(Boolean).join(' / ')||'Localização por escolher'}</p>
+            <p>{r.territorial_summary||[r.province,r.district].filter(Boolean).join(' / ')||'Localização por escolher'}</p>
            <p>Cadeia de valor: {r.chains.join(' · ')||'Por indicar'}</p>
            {r.summary && !r.stages.includes(r.summary) && <p>{r.summary}</p>}
            <p>Etapas e actividades: {r.stages.join(' · ')||'Por indicar'}</p><p>{r.maturity_label}</p>
@@ -0,0 +1,51 @@
+import { useEffect, useRef, useState, type ReactNode } from 'react';
+import { opportunityErrorGroup, opportunityMissingGroups, type FillGroup } from '@/lib/opportunity-fill-flow';
+
+export default function OpportunityFillFlow({groups,errors,renderField,onOpenResources,missingPaths=[]}:{
+    groups:FillGroup[];errors:Record<string,string>;renderField:(field:string)=>ReactNode;onOpenResources?:(group:string)=>void;
+    missingPaths?:string[];
+}) {
+    const [active,setActive]=useState(groups[0]?.id??'');
+    const groupIds=groups.map(group=>group.id).join(',');
+    useEffect(()=>{
+        const saved=window.location.hash.replace('#fill-','');
+        if(groupIds.split(',').includes(saved))setActive(saved);
+    },[groupIds]);
+    const heading=useRef<HTMLHeadingElement|null>(null);
+    const errorGroup=opportunityErrorGroup(groups,errors);
+    const missing=opportunityMissingGroups(groups,missingPaths);
+    const errorKey=JSON.stringify(errors);
+    useEffect(()=>{if(errorGroup)setActive(errorGroup);},[errorGroup,errorKey]);
+    const index=Math.max(0,groups.findIndex(group=>group.id===active));
+    const current=groups[index];
+    if(!current)return null;
+    const go=(id:string)=>{
+        setActive(id);
+        window.history.replaceState(window.history.state,'',`#fill-${id}`);
+        requestAnimationFrame(()=>heading.current?.focus());
+    };
+    return <div className="space-y-4">
+        <p>Pode escolher qualquer grupo, guardar incompleto e retomar. As informações já preenchidas mantêm-se ao avançar e regressar.</p>
+        <nav aria-label="Preencher a oportunidade" className="flex flex-wrap gap-2">
+            {groups.map(group=><a key={group.id} href={`#fill-${group.id}`} aria-current={current.id===group.id?'step':undefined}
+                className={`rounded border px-3 py-2 text-left ${current.id===group.id?'bg-primary text-primary-foreground':'bg-background'}`}
+                onClick={event=>{event.preventDefault();go(group.id);}}>{group.title}{opportunityErrorGroup([group],errors)?' — verificar':missing.some(item=>item.id===group.id)?' — dados em falta':''}</a>)}
+        </nav>
+        {missing.length>0&&<p>Pendências da última gravação: {missing.map(group=>group.title).join(' · ')}. Guarde para actualizar esta indicação.</p>}
+        <h2 ref={heading} tabIndex={-1} className="text-xl font-semibold">{current.title}</h2>
+        <p>{current.hint}</p>
+        {groups.map(group=><section key={group.id} id={`fill-${group.id}`} hidden={current.id!==group.id}
+            aria-label={group.title} className="space-y-4">
+            {group.fields.map(field=><div key={field}>{renderField(field)}</div>)}
+            {onOpenResources&&group.fields.some(field=>['locations','documents','images'].includes(field))&&
+                <button type="button" className="rounded border px-4 py-2 font-medium" onClick={()=>onOpenResources(group.id)}>Guardar e abrir documentos, imagens e localizações</button>}
+        </section>)}
+        <div className="flex flex-wrap items-center justify-between gap-3 border-t pt-3">
+            <span className="text-sm">Grupo {index+1} de {groups.length} · navegação livre</span>
+            <div className="flex gap-3">
+                {index>0&&<a href={`#fill-${groups[index-1].id}`} className="rounded border px-4 py-2" onClick={event=>{event.preventDefault();go(groups[index-1].id);}}>Anterior</a>}
+                {index<groups.length-1&&<a href={`#fill-${groups[index+1].id}`} className="rounded border px-4 py-2" onClick={event=>{event.preventDefault();go(groups[index+1].id);}}>Continuar: {groups[index+1].title}</a>}
+            </div>
+        </div>
+    </div>;
+}
@@ -222,6 +222,11 @@ export default function OpportunitySearchFilters({
            </div>
            <fieldset className="grid gap-3 sm:grid-cols-2 lg:grid-cols-4">
                <legend className="mb-2 font-semibold">Localização</legend>
+                <p className="text-sm sm:col-span-2 lg:col-span-4">
+                    A província inclui as oportunidades dos seus distritos, postos administrativos e localidades.
+                    Não é necessário escolher todos os níveis. O contexto provincial de um corredor é identificado nos resultados; não confirma uma implantação distrital.
+                    {path.length > 1 && <button type="button" className="ml-2 underline" onClick={() => territory(path.slice(0, 1))}>Ver toda a província de {path[0].name}</button>}
+                </p>
                {(
                    [
                        'province_id',
@@ -31,6 +31,7 @@ import {
 } from '@/components/ui/dropdown-menu';
 import {
    portalNavigation,
+    canShowLegacyManagement,
    currentNavigationGroup,
    currentNavigationItem,
 } from '@/lib/portal-navigation';
@@ -44,6 +45,7 @@ export function PortalGroupedMenu() {
        auth: {
            user: { name?: string; email?: string } | null;
            canManagePortal: boolean;
+            legacyManagementAccess?:boolean;
        };
        existingBusinessEnabled?: boolean;
        businessReviewUrl?: string | null;
@@ -54,6 +56,8 @@ export function PortalGroupedMenu() {
        profileAccess?: ProfileAccess | null;
        opportunityManagement?: OpportunityManagementAccess | null;
        scopedAdministration?: { label: string; href: string }[];
+        contentManagementHref?: string | null;
+        contentManagementAccess?: {opportunities?:{index:string;create?:string|null}};
    }>();
    const { t, language, requestCount } = useTempoUi();
    const mobile = useIsMobile();
@@ -63,7 +67,7 @@ export function PortalGroupedMenu() {
            ? { id: navigation.active, ...navigation.view.tools }
            : undefined,
        authenticated: !!props.auth?.user,
-        manager: !!props.auth?.canManagePortal,
+        manager: canShowLegacyManagement(props.auth),
        businesses: props.existingBusinessEnabled,
        businessReviewUrl: props.businessReviewUrl,
        education: props.educationEnabled,
@@ -72,17 +76,10 @@ export function PortalGroupedMenu() {
        legacyContent: props.legacyContentEnabled,
        opportunityManagement: props.opportunityManagement,
        profileAccess: props.profileAccess,
+        contentManagementHref: props.contentManagementHref,
+        contentManagementAccess: props.contentManagementAccess,
+        scopedAdministration: props.scopedAdministration,
    });
-    if (props.scopedAdministration?.length)
-        groups.push({
-            id: 'scoped-administration',
-            label: 'Administração',
-            children: props.scopedAdministration.map((item, index) => ({
-                id: `scoped-${index}`,
-                label: item.label,
-                href: item.href,
-            })),
-        });
    const current = currentNavigationGroup(groups, url);
    const currentItem = currentNavigationItem(groups, url);
    const [loggingOut, setLoggingOut] = useState(false);
@@ -134,7 +131,7 @@ export function PortalGroupedMenu() {
        );
    const accountGroups = groups.filter(
        (group) =>
-            !['home', 'discovery', 'realization', 'support'].includes(group.id),
+            !['home', 'discovery', 'realization', 'support','work'].includes(group.id),
    );
    const panelLabel = `${t('O meu painel')} — ${requestCount} ${t(requestCount === 1 ? 'pedido recebido' : 'pedidos recebidos')}`;
    const institutionalCurrent = url.split('?')[0] === '/contacto';
@@ -200,6 +197,7 @@ export function PortalGroupedMenu() {
                                    'discovery',
                                    'realization',
                                    'support',
+                                    'work',
                                ].includes(group.id),
                            )
                            .map((group) => (
@@ -0,0 +1,17 @@
+import {Link} from '@inertiajs/react';
+import {LayoutGrid} from 'lucide-react';
+import type {ReactNode} from 'react';
+import type {PortalNavItem} from '@/lib/portal-navigation';
+import {currentNavigationItem} from '@/lib/portal-navigation';
+import {searchTerritoryHref} from '@/lib/search-territory';
+import {SidebarGroup,SidebarGroupLabel,SidebarMenu,SidebarMenuButton,SidebarMenuItem} from '@/components/ui/sidebar';
+
+/** Render every authorised destination; a group is never reduced to its first link. */
+export function PortalSidebarNavigation({groups,url}:{groups:PortalNavItem[];url:string}){
+    const active=currentNavigationItem(groups,url);
+    const ordered=[...groups.filter(group=>group.id==='work'),...groups.filter(group=>group.id!=='work')];
+    const links=(items:PortalNavItem[],depth=0):ReactNode=>items.map(item=>item.children?
+        <li key={item.id} className="list-none"><p className="px-2 pt-3 pb-1 text-xs font-medium text-muted-foreground">{item.label}</p><ul className="ml-2 border-l pl-2">{links(item.children,depth+1)}</ul></li>:
+        item.href?<SidebarMenuItem key={item.id}><SidebarMenuButton asChild isActive={item.id===active} className="h-auto min-h-8 whitespace-normal py-2"><Link href={searchTerritoryHref(item.href,url)} aria-current={item.id===active?'page':undefined}>{depth===0&&<LayoutGrid aria-hidden="true"/>}<span className="min-w-0 flex-1" style={{whiteSpace:'normal',overflow:'visible',textOverflow:'clip',overflowWrap:'anywhere'}}>{item.label}</span></Link></SidebarMenuButton></SidebarMenuItem>:null);
+    return <nav aria-label="Navegação completa do portal">{ordered.map(group=><SidebarGroup key={group.id}><SidebarGroupLabel>{group.label}</SidebarGroupLabel><SidebarMenu>{links(group.children??[])}</SidebarMenu></SidebarGroup>)}</nav>;
+}
@@ -73,6 +73,8 @@ export function PreparationSummary({
            <h2 className="text-xl font-bold">
                Preparar o pedido de investimento privado
            </h2>
+            {caseId&&<p><Link className="inline-block rounded border px-4 py-2 font-semibold" href={`/investimentos/${caseId}/contexto/editar#preparation-questions`}>Preencher ou continuar o formulário</Link></p>}
+            <details><summary className="cursor-pointer font-medium">Consultar situação, documentos e fundamentos</summary>
            {!data.enabled ? (
                <p>
                    Use os dados deste dossier para identificar o pedido e os
@@ -219,10 +221,11 @@ export function PreparationSummary({
                        className="underline"
                        href={`/investimentos/${caseId}/contexto/editar#preparation-questions`}
                    >
-                        Completar apenas os dados em falta ou editar declarações
+                        Editar os dados do formulário
                    </Link>
                </p>
            )}
+            </details>
        </section>
    );
 }
@@ -28,7 +28,7 @@ export function profileLinks(access: ProfileAccess | null | undefined) {
        ...(access.administration
            ? [
                  {
-                      title: 'Instalação dos perfis 040000',
+                      title: 'Configuração dos perfis',
                      href: '/management/profile-install',
                  },
              ]
@@ -41,16 +41,26 @@ export default function ProfileNavigation() {
        profileAccess?: ProfileAccess | null;
    }>().props;
    if (!profileAccess) return null;
+    const links = profileLinks(profileAccess);
+    const workHrefs = [profileAccess.mine, profileAccess.create, profileAccess.review].filter(Boolean);
+    const work = links.filter((link) => workHrefs.includes(link.href));
+    const access = links.filter((link) => !workHrefs.includes(link.href));
    return (
        <nav
            aria-label="Perfil e oportunidades"
            className="flex flex-wrap gap-4 rounded border p-4"
        >
-            {profileLinks(profileAccess).map((link) => (
+            {work.map((link) => (
                <Link key={link.href} href={link.href} className="underline">
                    {link.title}
                </Link>
            ))}
+            {access.length > 0 && <details className="basis-full">
+                <summary className="cursor-pointer font-medium">O meu acesso e administração</summary>
+                <div className="mt-3 flex flex-wrap gap-4">{access.map((link) =>
+                    <Link key={link.href} href={link.href} className="underline">{link.title}</Link>
+                )}</div>
+            </details>}
        </nav>
    );
 }
@@ -0,0 +1,33 @@
+import { useState } from 'react';
+
+export default function ProfileProofPicker({documents,value,onChange,disabled=false}:{
+    documents:{id:string;file_name:string}[];value:string[];onChange:(ids:string[])=>void;disabled?:boolean;
+}) {
+    const [query,setQuery]=useState('');
+    const [showAll,setShowAll]=useState(false);
+    const [limit,setLimit]=useState(10);
+    const normalize=(text:string)=>text.normalize('NFD').replace(/\p{Diacritic}/gu,'').toLocaleLowerCase();
+    const matches=documents.filter(document=>normalize(document.file_name).includes(normalize(query)));
+    const toggle=(id:string)=>onChange(value.includes(id)?value.filter(item=>item!==id):[...value,id]);
+    return <fieldset disabled={disabled} className="space-y-3 rounded border p-4">
+        <legend>Escolher comprovativos</legend>
+        <p className="text-sm">Escolha os seus documentos que sustentam este pedido. A lista contém ficheiros próprios com análise antimalware concluída; não confirma a sua adequação como comprovativo.</p>
+        <p role="status">{value.length} comprovativos escolhidos</p>
+        {value.map(id=><div key={id} className="flex items-start justify-between gap-3 rounded border p-2">
+            <span className="min-w-0 break-words">{documents.find(document=>document.id===id)?.file_name??'Ficheiro seleccionado indisponível nesta consulta'}</span>
+            <button type="button" className="underline" onClick={()=>toggle(id)}>Retirar</button>
+        </div>)}
+        <label className="block">Pesquisar nos meus ficheiros
+            <input type="search" className="mt-1 w-full rounded border p-2" value={query} onChange={event=>{setQuery(event.target.value);setLimit(10);}} />
+        </label>
+        <button type="button" className="underline" onClick={()=>setShowAll(!showAll)}>{showAll?'Fechar lista':'Ver ficheiros disponíveis'}</button>
+        {(query||showAll)&&<div className="space-y-2">
+            <p role="status">{matches.length} ficheiros encontrados · a mostrar até {Math.min(limit,matches.length)}</p>
+            {matches.slice(0,limit).map(document=><label key={document.id} className="flex gap-2 rounded border p-2">
+                <input type="checkbox" checked={value.includes(document.id)} onChange={()=>toggle(document.id)} />
+                <span className="min-w-0 break-words">{document.file_name}</span>
+            </label>)}
+            {matches.length>limit&&<button type="button" className="underline" onClick={()=>setLimit(limit+10)}>Mostrar mais ficheiros</button>}
+        </div>}
+    </fieldset>;
+}
@@ -50,7 +50,7 @@ function count(props: Record<string, unknown>): number | null {
 }
 export default function SearchFeedback() {
    const page = usePage();
-    const handledLocally = page.component === 'investment/catalogue';
+    const handledLocally = ['investment/catalogue', 'investment/zones'].includes(page.component);
    const [state, setState] = useState<'idle' | 'loading' | 'error'>('idle');
    const latest = useRef<{
        url: string;
@@ -19,6 +19,7 @@ export type SectorEntryData = {
    }[];
    start_href: string | null;
    register_href: string | null;
+    register_label?: string;
    start_notice: string | null;
    register_notice: string | null;
    specialization_href: string | null;
@@ -58,7 +59,7 @@ export default function SectorEntry({
                        className="rounded border px-4 py-3"
                        href={data.register_href}
                    >
-                        Cadastrar oportunidade — escolher modalidade
+                        {data.register_label ?? 'Cadastrar oportunidade — escolher modalidade'}
                    </Link>
                ) : (
                    <p role="status">{data.register_notice}</p>
@@ -0,0 +1,66 @@
+import { useEffect, useRef, useState, type ReactNode } from 'react';
+
+type Choice = { id: string; name: string; source_code?: string | null };
+
+/** One search field owns the list and commits only an explicitly chosen option. */
+export default function TerritorySearchSelect<T extends Choice>({
+    id, label, search, onSearch, options, selected, onChange, disabled = false,
+    loading = false, error, required = false, className, placeholder, children,
+}: {
+    id: string; label: string; search: string; onSearch: (query: string) => void;
+    options: T[]; selected?: T; onChange: (option?: T) => void;
+    disabled?: boolean; loading?: boolean; error?: string; required?: boolean;
+    className?: string; placeholder?: string; children?: ReactNode;
+}) {
+    const [open, setOpen] = useState(false);
+    const [active, setActive] = useState(-1);
+    const activeRef = useRef<HTMLButtonElement | null>(null);
+    const expanded = open && !disabled;
+    const listId = `${id}-options`;
+    useEffect(() => { if (expanded) activeRef.current?.scrollIntoView({ block: 'nearest' }); }, [active, expanded]);
+    const close = () => { setOpen(false); setActive(-1); onSearch(''); };
+    const choose = (option?: T) => { onChange(option); close(); };
+    return <div className="relative" onBlur={(event) => {
+        if (!event.currentTarget.contains(event.relatedTarget as Node | null)) close();
+    }}>
+        <input id={id} className={className} role="combobox" aria-label={`Pesquisar ${label}`}
+            aria-autocomplete="list" aria-expanded={expanded} aria-controls={expanded ? listId : undefined}
+            aria-activedescendant={expanded && !loading && options[active] ? `${listId}-${active}` : undefined}
+            aria-invalid={Boolean(error)} aria-describedby={error ? `${id}-error` : undefined}
+            aria-required={required || undefined} required={required} autoComplete="off" maxLength={100}
+            disabled={disabled} value={expanded ? search : selected?.name ?? ''}
+            placeholder={disabled ? 'Seleccione o nível anterior' : placeholder ?? `Pesquisar ${label.toLowerCase()}`}
+            onFocus={() => { setOpen(true); setActive(-1); onSearch(''); }}
+            onClick={() => setOpen(true)}
+            onChange={(event) => { setOpen(true); setActive(-1); onSearch(event.target.value); }}
+            onKeyDown={(event) => {
+                if (event.key === 'Escape') { event.preventDefault(); close(); }
+                if (event.key === 'ArrowDown' || event.key === 'ArrowUp') {
+                    event.preventDefault(); setOpen(true);
+                    setActive((current) => !options.length ? -1 : event.key === 'ArrowDown'
+                        ? Math.min(current + 1, options.length - 1) : current < 0 ? options.length - 1 : Math.max(0, current - 1));
+                }
+                if (event.key === 'Enter' && expanded) {
+                    event.preventDefault();
+                    if (!loading && options[active < 0 ? 0 : active]) choose(options[active < 0 ? 0 : active]);
+                }
+            }} />
+        {selected && !disabled && <button type="button" className="mt-1 text-sm underline"
+            aria-label={`Limpar ${label}`} onClick={() => choose()}>Limpar</button>}
+        {error && <p id={`${id}-error`} role="alert">{error}</p>}
+        {expanded && <div className="absolute z-50 mt-1 max-h-72 w-full overflow-y-auto rounded border bg-background p-1 text-foreground shadow-lg">
+            <div id={listId} role="listbox" aria-label={label} aria-busy={loading}>
+                {loading && <p role="status" className="p-2">A carregar…</p>}
+                {!loading && options.length === 0 && <p className="p-2">{error ? 'Não foi possível carregar as opções.' : 'Sem resultados para esta pesquisa.'}</p>}
+                {options.map((option, index) => <button key={option.id} id={`${listId}-${index}`} type="button"
+                    ref={index === active ? activeRef : undefined} role="option" tabIndex={-1}
+                    aria-selected={option.id === selected?.id} disabled={loading}
+                    className={`block w-full rounded p-2 text-left hover:bg-accent ${index === active ? 'bg-accent' : ''}`}
+                    onMouseDown={(event) => event.preventDefault()} onClick={() => choose(option)}>
+                    {option.name}{option.source_code ? ` (${option.source_code})` : ''}
+                </button>)}
+            </div>
+            {children}
+        </div>}
+    </div>;
+}
@@ -0,0 +1,107 @@
+export const forceLabels = {
+    rivalry: 'Rivalidade entre concorrentes',
+    entrants: 'Ameaça de novos entrantes',
+    substitutes: 'Ameaça de produtos ou serviços substitutos',
+    suppliers: 'Poder negocial dos fornecedores',
+    buyers: 'Poder negocial dos clientes',
+} as const;
+
+export type Force = keyof typeof forceLabels;
+export type Assessment = {
+    pressure: '' | 'low' | 'medium' | 'high';
+    evidence: string;
+    source: string;
+    period: string;
+    rationale: string;
+    limitations: string;
+    opportunity: string;
+};
+export type CompetitivenessDraft = {
+    version: 1;
+    clusterId: string;
+    sector: string;
+    region: string;
+    forces: Record<Force, Assessment>;
+};
+
+export const forces = Object.keys(forceLabels) as Force[];
+const fields = [
+    'evidence',
+    'source',
+    'period',
+    'rationale',
+    'limitations',
+    'opportunity',
+] as const;
+
+export function newCompetitivenessDraft(
+    clusterId: string,
+    sector: string,
+): CompetitivenessDraft {
+    return {
+        version: 1,
+        clusterId,
+        sector,
+        region: '',
+        forces: Object.fromEntries(
+            forces.map((force) => [
+                force,
+                {
+                    pressure: '',
+                    evidence: '',
+                    source: '',
+                    period: '',
+                    rationale: '',
+                    limitations: '',
+                    opportunity: '',
+                },
+            ]),
+        ) as Record<Force, Assessment>,
+    };
+}
+
+// A pressure is an author's qualitative assessment, never inferred from missing data.
+export function assessmentReady(row: Assessment): boolean {
+    return (
+        ['low', 'medium', 'high'].includes(row.pressure) &&
+        fields.every((field) => row[field].trim().length > 0)
+    );
+}
+
+export function diagnosticReady(draft: CompetitivenessDraft): boolean {
+    return (
+        Boolean(draft.sector.trim() && draft.region.trim()) &&
+        forces.every((force) => assessmentReady(draft.forces[force]))
+    );
+}
+
+export function readCompetitivenessDraft(
+    raw: string,
+    clusterId: string,
+): CompetitivenessDraft {
+    if (raw.length > 250_000)
+        throw Error('O ficheiro excede o limite de 250 KB.');
+    const input = JSON.parse(raw);
+    if (!input || input.version !== 1 || input.clusterId !== clusterId) {
+        throw Error(
+            'O ficheiro não corresponde a este cluster ou tem uma versão incompatível.',
+        );
+    }
+    const text = (value: unknown, max: number): string => {
+        if (typeof value !== 'string' || value.length > max)
+            throw Error('O ficheiro contém campos inválidos.');
+        return value;
+    };
+    const draft = newCompetitivenessDraft(clusterId, text(input.sector, 200));
+    draft.region = text(input.region, 1000);
+    for (const force of forces) {
+        const row = input.forces?.[force];
+        if (!row || !['', 'low', 'medium', 'high'].includes(row.pressure)) {
+            throw Error('O ficheiro não contém as cinco forças válidas.');
+        }
+        draft.forces[force].pressure = row.pressure;
+        for (const field of fields)
+            draft.forces[force][field] = text(row[field], 5000);
+    }
+    return draft;
+}
@@ -0,0 +1,8 @@
+/** Presentation only. Original taxonomy identifiers remain the form/query values. */
+const names:Record<string,string>={
+    agronegocio:'Agronegócio','bens-de-consumo-e-franquias':'Bens de consumo e franquias',energia:'Energia e mineração (catálogo histórico)',
+    'energia-especifica':'Energia',fintech:'Fintech',fiscalidade:'Fiscalidade',imobiliario:'Imobiliário',infraestruturas:'Infraestruturas',
+    iva:'IVA',mineracao:'Mineração','território':'Território',territorio:'Território',turismo:'Turismo','mercado-financeiro':'Mercado financeiro',
+    education:'Formação e competências',media:'Imagens e conteúdos de apoio',pt:'Português',en:'Inglês',
+};
+export function documentFacetLabel(value:string):string{return names[value]??value;}
@@ -0,0 +1,66 @@
+import { modeloAFields, modeloAReference } from './iva-modelo-a.ts';
+
+export type FiscalFormKind = 'iva' | 'irpc';
+export const fiscalFormVersion = 'investmoz-fiscal-preparation/1';
+export const fiscalForms = {
+    iva: { title: 'IVA — Modelo A', source: modeloAReference.file, hash: modeloAReference.sha256, coverage: 'Campos 01–27 do exemplar, para preenchimento manual. A edição e as divergências já documentadas continuam identificadas.' },
+    irpc: { title: 'IRPC — Modelo 22', source: 'IRPC M-22- DECLARACAO DE RENDIMENTOS.pdf', hash: '4b61bd83d1fbcfd3b7b5c5523cea5923f7d0f65dc4c004eff58e5db38f763c88', coverage: 'Preparação parcial: resultado, lucro, matéria colectável e liquidação nos campos abaixo. Os restantes ajustamentos e anexos do exemplar não são preenchidos aqui. L8 permanece parcial.' },
+} as const;
+const irpcFields = [
+    ['200', 'Resultado do exercício'], ['259', 'Prejuízo fiscal'], ['260', 'Lucro tributável'],
+    ['269', 'Prejuízo fiscal — regime geral'], ['270', 'Lucro tributável — regime geral'],
+    ['276', 'Prejuízos fiscais deduzidos'], ['277', 'Benefícios fiscais a deduzir'], ['278', 'Matéria colectável — regime geral'],
+    ['300', 'Imposto à taxa normal'], ['301', 'Imposto à taxa reduzida'], ['302', 'Colecta total'],
+    ['303', 'Dupla tributação económica'], ['304', 'Dupla tributação internacional'], ['305', 'Benefícios fiscais'],
+    ['306', 'Pagamento especial por conta'], ['308', 'Total das deduções'], ['309', 'IRPC liquidado'],
+    ['310', 'Retenções na fonte'], ['311', 'Pagamentos por conta'], ['312', 'IRPC a pagar antes de juros'],
+    ['313', 'IRPC a recuperar antes de juros'], ['314', 'Juros compensatórios'], ['315', 'IRPC a pagar'], ['316', 'IRPC a recuperar'],
+] as const;
+export function fiscalFormFields(kind: FiscalFormKind) {
+    return kind === 'iva'
+        ? modeloAFields.map(f => ({ code: f.field, label: f.purpose, guidance: f.basis }))
+        : irpcFields.map(([code, label]) => ({ code, label, guidance: Number(code) < 269 ? 'Quadro 10 do exemplar.' : Number(code) < 300 ? 'Quadro 11, regime geral. Outros regimes não incluídos nesta preparação.' : 'Quadro 12 do exemplar. Preenchimento manual, sem cálculo ou validação automática da liquidação.' }));
+}
+export type FiscalPreparation = {
+    version: typeof fiscalFormVersion;
+    kind: FiscalFormKind;
+    sourceHash: string;
+    name: string;
+    nuit: string;
+    period: string;
+    notes: string;
+    values: Record<string, string>;
+};
+export function newFiscalPreparation(kind: FiscalFormKind): FiscalPreparation {
+    return { version: fiscalFormVersion, kind, sourceHash: fiscalForms[kind].hash, name: '', nuit: '', period: '', notes: '', values: {} };
+}
+export function readFiscalPreparation(raw: string): FiscalPreparation {
+    if (raw.length > 100_000) throw new Error('O ficheiro excede o tamanho de uma preparação.');
+    let p: unknown;
+    try { p = JSON.parse(raw); } catch { throw new Error('Não foi possível ler este ficheiro de preparação. Os campos actuais foram preservados.'); }
+    if (!p || typeof p !== 'object' || Array.isArray(p)) throw new Error('Ficheiro de preparação inválido.');
+    const v = p as Record<string, unknown>;
+    if (v.version !== fiscalFormVersion || (v.kind !== 'iva' && v.kind !== 'irpc') || v.sourceHash !== fiscalForms[v.kind].hash) throw new Error('Versão ou exemplar diferente. A preparação actual foi preservada.');
+    for (const key of ['name', 'nuit', 'period', 'notes']) {
+        if (typeof v[key] !== 'string' || v[key].length > 5000) throw new Error('Identificação ou notas inválidas.');
+    }
+    if (!v.values || typeof v.values !== 'object' || Array.isArray(v.values)) throw new Error('Campos inválidos.');
+    const allowed = new Set(fiscalFormFields(v.kind).map(f => f.code));
+    const values: Record<string, string> = {};
+    for (const [code, value] of Object.entries(v.values)) {
+        if (!allowed.has(code) || typeof value !== 'string' || value.length > 100) throw new Error('Campo não reconhecido. A preparação actual foi preservada.');
+        values[code] = value;
+    }
+    return { ...newFiscalPreparation(v.kind), name: v.name as string, nuit: v.nuit as string, period: v.period as string, notes: v.notes as string, values };
+}
+export function fiscalPreparationIssues(p: FiscalPreparation): string[] {
+    const issues: string[] = [];
+    if (!p.name.trim()) issues.push('Indique o nome ou designação social.');
+    if (!/^\d{9}$/.test(p.nuit)) issues.push('Indique o NUIT com 9 algarismos.');
+    if (!(p.kind === 'iva' ? /^\d{4}-(0[1-9]|1[0-2])$/ : /^\d{4}$/).test(p.period)) issues.push(p.kind === 'iva' ? 'Indique ano e mês do período.' : 'Indique o ano do exercício.');
+    for (const f of fiscalFormFields(p.kind)) {
+        const value = p.values[f.code] ?? '';
+        if (value !== '' && !/^-?\d{1,24}(?:[.,]\d{1,2})?$/.test(value)) issues.push(`Campo ${f.code}: use um montante sem separador de milhares, com até duas casas decimais.`);
+    }
+    return issues;
+}
@@ -0,0 +1,40 @@
+export type FillGroup = { id: string; title: string; hint: string; fields: string[] };
+const definitions: Omit<FillGroup, 'fields'>[] = [
+    {id:'idea',title:'Ideia e actividade',hint:'Identifique o investimento e descreva a necessidade que pretende responder.'},
+    {id:'people',title:'Promotor e contactos',hint:'Reutilize os contactos guardados e escolha o que pode ser divulgado.'},
+    {id:'territory',title:'Localização e enquadramento',hint:'Indique o território conhecido e as associações documentadas que se aplicam.'},
+    {id:'operation',title:'Actividade e impacto',hint:'Complete os produtos, recursos, mercados e impactos relevantes para esta oportunidade.'},
+    {id:'finance',title:'Investimento e financiamento',hint:'Preencha os valores conhecidos. O rascunho pode continuar incompleto.'},
+    {id:'evidence',title:'Documentos e imagens',hint:'Reutilize os recursos guardados na mesma oportunidade.'},
+    {id:'specific',title:'Dados específicos',hint:'Preencha os detalhes aplicáveis à modalidade escolhida.'},
+    {id:'review',title:'Revisão e divulgação',hint:'Reveja riscos, condições e visibilidade antes das acções autorizadas de submissão.'},
+];
+const fields: Record<string,string[]> = {
+    idea:['official_title','sector_id','subsector_id','economic_activity_id','executive_summary','demand_statement','opportunity_type','maturity_stage','enterprise_size'],
+    people:['promoter_type','internal_contact_id','publish_contact','public_contact_id'],
+    territory:['location_mode','geographic_scope','multi_district_rationale','locations','relations'],
+    operation:['investment_modalities','investor_profiles','products','assets','inputs','markets','competitive_advantage','employment','impact_indicators'],
+    finance:['total_investment','currency','investment_breakdown','secured_financing','funding_sought','financial_indicators'],
+    evidence:['documents','evidences','images'],
+    review:['publication_languages','visibility','review_due_date','truth_declaration','milestones','licenses','environmental_social','risks'],
+};
+
+/** Presentation groups only: retain every applicable field exactly once, including future schema keys. */
+export function opportunityFillGroups(available: string[]): FillGroup[] {
+    const unique=[...new Set(available)];
+    return definitions.map(group=>({...group,fields:unique.filter(field=>{
+        const owner=Object.keys(fields).find(key=>fields[key].includes(field))??'specific';
+        return owner===group.id;
+    })})).filter(group=>group.fields.length>0);
+}
+
+export function opportunityErrorGroup(groups: FillGroup[], errors: Record<string,string>): string | undefined {
+    return groups.find(group=>group.fields.some(field=>Object.keys(errors).some(path=>path===`canonical.${field}`||path.startsWith(`canonical.${field}.`))))?.id;
+}
+
+export function opportunityMissingGroups(groups:FillGroup[], paths:string[]):FillGroup[] {
+    return groups.filter(group=>group.fields.some(field=>paths.some(path=>{
+        const normalized=path.replace(/^canonical\./,'');
+        return normalized===field||normalized.startsWith(`${field}.`);
+    })));
+}
@@ -8,6 +8,9 @@ export type PortalNavItem = {
    children?: PortalNavItem[];
 };
 export type PortalNavAccess = {
+    contentManagementHref?: string | null;
+    contentManagementAccess?: {opportunities?:{index:string;create?:string|null}};
+    scopedAdministration?: { label: string; href: string }[];
    procurement?: boolean;
    authenticated: boolean;
    manager: boolean;
@@ -31,6 +34,10 @@ const link = (id: string, label: string, href: string): PortalNavItem => ({
    label,
    href,
 });
+/** Display the existing server decision; a generic manager flag cannot override a scoped denial. */
+export function canShowLegacyManagement(auth?:{user?:unknown;canManagePortal?:boolean;legacyManagementAccess?:boolean}):boolean {
+    return !!auth?.user && (auth.legacyManagementAccess??auth.canManagePortal??false);
+}

 /** One route catalogue for the public shell and authenticated pages. */
 export function legacyPortalNavigation(
@@ -371,6 +378,7 @@ export function legacyPortalNavigation(
                              'Gestão de perfis',
                              profile.administration,
                          ),
+                          link('profile-installation','Instalação dos perfis 040000','/management/profile-install'),
                      ]
                    : []),
            ],
@@ -439,7 +447,10 @@ export function currentNavigationItem(

 /** Investor organization; existing capability filters still determine private destinations. */
 export function portalNavigation(access: PortalNavAccess): PortalNavItem[] {
-    const previous = legacyPortalNavigation(access);
+    const previous = legacyPortalNavigation({...access,manager:access.authenticated&&access.manager,profileAccess:access.authenticated?access.profileAccess:null});
+    const workHub=access.authenticated?access.contentManagementHref:null;
+    const workOpportunities=access.authenticated?access.contentManagementAccess?.opportunities:undefined;
+    const workCreate=access.authenticated?(access.profileAccess?.create||workOpportunities?.create||(access.manager&&access.opportunityManagement?.installed?access.opportunityManagement.create.href:null)):null;
    return uniqueNavigationDestinations([
        {
            id: 'discovery',
@@ -544,11 +555,20 @@ export function portalNavigation(access: PortalNavAccess): PortalNavItem[] {
                ),
            ],
        },
-        ...previous.filter((group) =>
-            ['account', 'management', 'profile-opportunities'].includes(
-                group.id,
-            ),
-        ),
+        ...[{
+            id: 'work',
+            label: 'Área de trabalho',
+            children: [
+                link('work-entry', workHub ? 'Gestão de conteúdos e oportunidades':'Acesso à gestão', workHub || '/acesso-gestao'),
+                ...(workCreate ? [
+                    link('prepare-analysis', 'Preparar análise e ideia', workCreate+'?analysis=proactive'),
+                ] : []),
+                ...(workOpportunities ? [link('work-opportunities','Oportunidades em preparação',workOpportunities.index)] : []),
+                ...previous.filter(group=>['management','profile-opportunities'].includes(group.id)).flatMap(group=>group.children??[]),
+                ...(access.authenticated&&access.scopedAdministration?.length ? [{id:'work-administration',label:'Administração',children:access.scopedAdministration.map((item,index)=>link('scoped-'+index,item.label,item.href))}] : []),
+            ],
+        }],
+        ...previous.filter((group) => group.id === 'account'),
        ...(access.authenticated &&
        access.businesses &&
        access.businessReviewUrl
@@ -0,0 +1,11 @@
+const territoryKeys=['province_id','district_id','admin_post_id','locality_id'];
+/** No fallback scope: an explicit empty path means all; a selected path replaces its old descendants. */
+export function territorialSearchParams(entries: Iterable<[string,FormDataEntryValue]>, path?: {id:string;location_type:string}[]): URLSearchParams {
+    const params=new URLSearchParams();
+    for(const [key,value] of entries)if(typeof value==='string'&&value!==''&&key!=='page')params.set(key,value);
+    if(path){
+        territoryKeys.forEach(key=>params.delete(key));
+        for(const node of path){const key=`${node.location_type}_id`;if(territoryKeys.includes(key))params.set(key,node.id);}
+    }
+    return params;
+}
@@ -1,4 +1,4 @@
-import EducationalGuides from '@/components/educational-guides';
+import CatalogueGuideLinks from '@/components/catalogue-guide-links';
 import OpportunityCorridorGroups, { type CorridorGroup } from '@/components/opportunity-corridor-groups';
 import { searchTerritoryHref } from '@/lib/search-territory';
 import type { EducationalArticle } from '@/components/educational-article-card';
@@ -381,6 +381,11 @@ export default function Catalogue({
                    );
                }}
            />
+            <h2 className="text-xl font-semibold">
+                Oportunidades publicadas
+                {filters.sector && ` · ${references.sectors.find((sector) => sector.slug === filters.sector)?.name ?? filters.sector}`}
+                {territorySelection.length > 0 && ` · ${territorySelection.map((territory) => territory.name).join(' / ')}`}
+            </h2>
            <SearchState
                loading={searchLoading}
                error={searchError}
@@ -423,7 +428,7 @@ export default function Catalogue({
                                }));
                            }}
                        >
-                            Alargar pesquisa (remover localização)
+                            Pesquisar noutras províncias (remover localização)
                        </button>
                    )}
                {['grid', 'list', 'map', 'combined', 'corridors'].map((value, i) => (
@@ -591,7 +596,7 @@ export default function Catalogue({
                            <article key={r.id} className={card + ' space-y-3'}>
                                <p className="text-sm">
                                    {r.sector?.name} ·{' '}
-                                    {r.province || 'Localização não indicada'}
+                                    {r.territorial_summary || [r.province, r.district].filter(Boolean).join(' / ') || 'Localização não indicada'}
                                </p>
                                <h2 className="text-xl font-bold">
                                    <Link
@@ -646,10 +651,10 @@ export default function Catalogue({
                        ))}
                    </div>
                )}
-            {!results.total && (
+            {!searchLoading && !searchError && !results.total && (
                <p className={card}>
-                    Sem oportunidades com estes filtros. Explore as fichas
-                    territoriais ou{' '}
+                    Não há oportunidades publicadas com estes filtros no cadastro consultado.
+                    A informação disponível pode ser incompleta. Pode{' '}
                    <Link href="/apoio" className="underline">
                        peça apoio
                    </Link>
@@ -757,7 +762,7 @@ export default function Catalogue({
                    </div>
                </section>
            )}
-            <EducationalGuides articles={guides} />
+            <CatalogueGuideLinks articles={guides} />
        </Frame>
    );
 }
@@ -53,6 +53,7 @@ export type Opportunity = {
    description: string | null;
    province: string | null;
    district: string | null;
+    territorial_summary?: string;
    sector?: { name: string; slug: string };
    estimated_investment_amount: string | null;
    estimated_investment_currency: string;
@@ -3,7 +3,9 @@ import InvestmentZoneInstallation, {
 } from '@/components/investment-zone-installation';
 import { Link, router, usePage } from '@inertiajs/react';
 import { searchTerritoryHref } from '@/lib/search-territory';
-import { useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
+import { territorialSearchParams } from '@/lib/territorial-search-params';
+import CatalogueFilterContext from '@/components/catalogue-filter-context';
 import { catalogueDetailHref } from '@/lib/catalogue-context';
 import {
    TerritoryFields,
@@ -77,6 +79,10 @@ export default function Zones({
        total: number;
        next_page_url: string | null;
        prev_page_url: string | null;
+        from?: number | null;
+        to?: number | null;
+        current_page?: number;
+        last_page?: number;
    };
    filters: {
        q?: string;
@@ -94,6 +100,30 @@ export default function Zones({
    const pageUrl = usePage().url;
    const [error, setError] = useState('');
    const [busy, setBusy] = useState(false);
+    const searchForm=useRef<HTMLFormElement|null>(null);
+    const searchTimer=useRef<ReturnType<typeof setTimeout>|undefined>(undefined);
+    const cancelSearch=useRef<(()=>void)|undefined>(undefined);
+    const searchSequence=useRef(0);
+    const [searching,setSearching]=useState(false);
+    const [searchError,setSearchError]=useState('');
+    const appliedKey=JSON.stringify([filters,territorySelection]);
+    useEffect(()=>{searchForm.current?.reset();},[appliedKey]);
+    useEffect(()=>()=>{clearTimeout(searchTimer.current);cancelSearch.current?.();},[]);
+    const runSearch=(path?:TerritoryOption[])=>{
+        clearTimeout(searchTimer.current);cancelSearch.current?.();
+        if(!searchForm.current)return;
+        const sequence=++searchSequence.current;
+        const params=territorialSearchParams(new FormData(searchForm.current),path);
+        setSearching(true);setSearchError('');
+        router.get(`${management?'/management/investment/zones':'/zonas'}?${params}`,{}, {
+            preserveState:true,preserveScroll:true,replace:true,
+            onCancelToken:token=>{cancelSearch.current=()=>token.cancel();},
+            onError:()=>{if(sequence===searchSequence.current)setSearchError('A pesquisa não foi concluída. Confira os filtros e tente novamente.');},
+            onNetworkError:()=>{if(sequence===searchSequence.current)setSearchError('Ligação indisponível. Os filtros escolhidos foram preservados.');return false;},
+            onHttpException:()=>{if(sequence===searchSequence.current)setSearchError('Não foi possível consultar esta selecção.');return false;},
+            onFinish:()=>{if(sequence===searchSequence.current)setSearching(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);
@@ -160,22 +190,18 @@ export default function Zones({
                    </Link>
                </nav>
            </details>
+            <CatalogueFilterContext />
            <form
+                ref={searchForm}
                method="get"
+                onChange={(event)=>{
+                    if(!event.target.getAttribute('name'))return;
+                    clearTimeout(searchTimer.current);cancelSearch.current?.();searchSequence.current++;
+                    setSearching(true);setSearchError('');searchTimer.current=setTimeout(()=>runSearch(),350);
+                }}
                onSubmit={(event) => {
                    event.preventDefault();
-                    const form = event.currentTarget;
-                    const url = new URL(form.action);
-                    const params = new URLSearchParams();
-                    for (const [name, value] of new FormData(form))
-                        if (typeof value === 'string')
-                            params.append(name, value);
-                    url.search = params.toString();
-                    router.get(
-                        url.toString(),
-                        {},
-                        { preserveState: true, preserveScroll: true },
-                    );
+                    runSearch();
                }}
                className={card + ' grid gap-4 md:grid-cols-3'}
            >
@@ -307,10 +333,14 @@ export default function Zones({
                        )}
                    </div>
                </details>
-                <TerritoryFields initial={territorySelection} />
+                <TerritoryFields initial={territorySelection} onChange={path=>runSearch(path)} />
+                <button type="button" className="underline" onClick={()=>runSearch([])}>Todo o território (remover localização)</button>
                <button className={button}>Pesquisar</button>
            </form>
-            {!management && (
+            <h2 className="text-xl font-semibold">{searching?'A pesquisar a selecção…':searchError?'Pesquisa por concluir':`${records.total} registos disponíveis · ${territorySelection.length?territorySelection.map(node=>node.name).join(' / '):'Todo o território'}`}</h2>
+            {!searching&&!searchError&&records.total>0&&<p>A mostrar {records.from??1} a {records.to??records.data.length} de {records.total}. Página {records.current_page??1} de {records.last_page??1}.</p>}
+            {searchError&&<p role="alert">{searchError}</p>}
+            {!management && !searching && !searchError && (
                <a
                    className="underline"
                    href={`/api/v2/investment/zones/export.csv?${exportParams.toString()}`}
@@ -318,12 +348,12 @@ export default function Zones({
                    Exportar resultados filtrados (CSV)
                </a>
            )}
-            {!records.total && (
+            {!searching && !searchError && !records.total && (
                <p className={card}>
                    Não foram encontrados resultados para esta pesquisa.
                </p>
            )}
-            {records.data.map((zone) => (
+            {!searching && !searchError && records.data.map((zone) => (
                <article className={card} key={zone.id}>
                    <h2 className="text-xl font-bold">
                        <Link
@@ -451,10 +481,10 @@ export default function Zones({
                </article>
            ))}
            <nav aria-label="Paginação" className="flex gap-4 underline">
-                {records.prev_page_url && (
+                {!searching && !searchError && records.prev_page_url && (
                    <Link href={records.prev_page_url}>Anterior</Link>
                )}
-                {records.next_page_url && (
+                {!searching && !searchError && records.next_page_url && (
                    <Link href={records.next_page_url}>Seguinte</Link>
                )}
            </nav>
@@ -171,10 +171,8 @@ function Stage({ step, path }: { step: Step; path: Path }) {
    ];
    const states = path.canWrite ? ownerStates : reviewStates;
    return (
-        <article id={step.code} className="space-y-3 rounded-xl border p-4">
-            <h3 className="font-semibold">
-                {step.code} · {step.title}
-            </h3>
+        <details id={step.code} open={path.next?.code===step.code} className="space-y-3 rounded-xl border p-4">
+            <summary className="cursor-pointer font-semibold">{step.title} · {pathStates[step.state]}</summary>
            <p>{pathStates[step.state]}</p>
            {step.context_review_required && (
                <label className="block rounded border border-amber-600 bg-amber-50 p-3">
@@ -235,17 +233,18 @@ function Stage({ step, path }: { step: Step; path: Path }) {
                            : action === 'operate'
                              ? 'Operação'
                              : 'Execução'}{' '}
-                        aguarda {gaps.join(', ')}. Pode continuar a preparar.
+                        aguarda {gaps.map(code=>path.steps.find(item=>item.code===code)?.title??code).join(', ')}. Pode continuar a preparar.
                    </p>
                ))}
-            <p className="text-xs">
+            <details className="text-xs"><summary className="cursor-pointer underline">Fonte e referência desta etapa</summary><p>
+                Referência interna {step.code}.{' '}
                Documento original, parágrafo {step.source_paragraph}.{' '}
                {step.detail.scope === 'internal_validation'
                    ? 'Conferência interna; não equivale a decisão externa.'
                    : step.detail.scope === 'external_document_recorded'
                      ? 'Acto externo registado a partir de documento.'
                      : 'Preparação declarada pelo promotor.'}
-            </p>
+            </p></details>
            {step.preparation_allowed && (path.canWrite || path.canReview) && (
                <details>
                    <summary className="cursor-pointer underline">
@@ -405,7 +404,7 @@ function Stage({ step, path }: { step: Step; path: Path }) {
                    </form>
                </details>
            )}
-        </article>
+        </details>
    );
 }

@@ -718,10 +717,10 @@ export default function InvestmentPath(path: Path) {
                </section>
            )}
            {Object.entries(path.phases).filter(([number]) => path.steps.some((step) => step.phase === Number(number) && step.preparation_allowed)).map(([number, label]) => (
-                <section className="space-y-3" key={number}>
-                    <h2 className="text-lg font-semibold">
+                <details open={path.steps.some(step=>step.phase===Number(number)&&step.code===path.next?.code)} className="space-y-3 rounded border p-4" key={number}>
+                    <summary className="cursor-pointer text-lg font-semibold">
                        Fase {number} · {label}
-                    </h2>
+                    </summary>
                    <div className="grid items-start gap-3 md:grid-cols-2">
                        {path.steps
                            .filter((step) => step.phase === Number(number) && step.preparation_allowed)
@@ -733,7 +732,7 @@ export default function InvestmentPath(path: Path) {
                                />
                            ))}
                    </div>
-                </section>
+                </details>
            ))}
            <section className="space-y-3">
                <h2 className="text-lg font-semibold">
@@ -819,10 +818,10 @@ export default function InvestmentPath(path: Path) {
                    Anexar ou conferir no Balcão
                </Link>
            </section>
-            <section className="space-y-3 rounded-xl border p-4">
-                <h2 className="text-lg font-semibold">
+            <details className="space-y-3 rounded-xl border p-4">
+                <summary className="cursor-pointer text-lg font-semibold">
                    Acompanhamento interno
-                </h2>
+                </summary>
                {path.canWrite && (
                    <form
                        className="grid min-w-0 gap-3 [&_input]:max-w-full [&_input]:min-w-0 [&_label]:min-w-0 [&_select]:max-w-full [&_select]:min-w-0"
@@ -983,7 +982,7 @@ export default function InvestmentPath(path: Path) {
                        </li>
                    ))}
                </ul>
-            </section>
+            </details>
        </main>
    );
 }
@@ -1,4 +1,4 @@
-import {ProactiveInvestmentEditor,type ProactiveAnalysis,type ProactiveOptions} from '@/components/proactive-investment';
+import {ProactiveInvestmentEditor,newProactive,type ProactiveAnalysis,type ProactiveOptions} from '@/components/proactive-investment';
 import { ClassificationReview } from '@/components/opportunity-classification';
 import { createOperationKey } from '@/lib/operation-key';
 import { valueText } from '@/lib/value-text';
@@ -140,18 +140,21 @@ export default function OpportunityDraft({
        auth: { user: { id: number } };
        canEditDraft?: boolean;
    }>().props;
+    const proactiveEntryUrl=usePage().url;
+    const uniquePromoterContext=profileAccess?.contexts.length===1?profileAccess.contexts[0]:undefined;
    const [data, setData] = useState<Values>({
        ...values,
+        ...(!record && !values.proactive && new URLSearchParams(proactiveEntryUrl.split('?')[1]??'').get('analysis')==='proactive' ? {proactive:newProactive()} : {}),
        ...(profileMode
            ? {
                  organization_id: record
                      ? (profileOrganization ?? null)
                      : profileAccess?.internalPromoter
                        ? null
-                        : (profileAccess?.contexts[0]?.organization_id ?? null),
+                        : (uniquePromoterContext?.organization_id ?? null),
                  opportunity_category:
                      values.opportunity_category ??
-                      profileAccess?.contexts[0]?.type ??
+                      uniquePromoterContext?.type ??
                      '',
              }
            : {}),
@@ -171,10 +174,11 @@ export default function OpportunityDraft({
    const unavailable = Boolean(
        record?.deleted_at || record?.status === 'archived',
    );
+    const hasCanonicalPreparation = profileMode && canonicalOptions && Boolean(data.opportunity_category) && !data.proactive;
    const archiveAvailable = Boolean(usePage().props.opportunityManagement);
    const set = (key: string, value: string) =>
        setData((d) => ({ ...d, [key]: value }));
-    async function send(action: 'save' | 'delete' | 'archive' | 'restore') {
+    async function send(action: 'save' | 'delete' | 'archive' | 'restore', resourcesGroup?: string) {
        if (busy) return;
        setBusy(true);
        setErrors({});
@@ -222,8 +226,10 @@ export default function OpportunityDraft({
            }
            setMessage(result.message);
            if (result.etag) setToken(result.etag);
-            if (!record) router.visit(`${basePath}/${result.id}/edit`);
+            if (resourcesGroup) router.visit(`${basePath}/${record?.id ?? result.id}/resources?return_group=${encodeURIComponent(resourcesGroup)}`);
+            else if (!record) router.visit(`${basePath}/${result.id}/edit${window.location.hash.startsWith('#fill-') ? window.location.hash : ''}`);
            else if (action !== 'save') router.reload();
+            else if (profileMode) router.reload({only:['canonicalResponse','etag','history','workflowState','profileContext']});
        } catch {
            setMessage(
                'Resposta indisponível. Os dados foram preservados; confira o registo no servidor antes de repetir.',
@@ -235,10 +241,8 @@ export default function OpportunityDraft({
                    document.querySelector<HTMLSelectElement>(
                        '[data-association-index][aria-invalid="true"]',
                    );
-                (
-                    invalidAssociation ??
-                    document.getElementById('opportunity-result')
-                )?.focus();
+                if (invalidAssociation) invalidAssociation.focus();
+                else document.getElementById('opportunity-result')?.focus({preventScroll:true});
            });
        }
    }
@@ -250,9 +254,7 @@ export default function OpportunityDraft({
                    : 'Nova oportunidade'
            }
        >
-            <Link href={basePath}>
-                {profileMode ? 'Minhas oportunidades' : 'Voltar à gestão'}
-            </Link>
+            {!profileMode && <Link href={basePath}>Voltar à gestão</Link>}
            {promotionHref && <Link className="ml-3 underline" href={promotionHref}>Divulgação promocional — Em preparação</Link>}
            {!!profileContext?.corridor_agribusiness && (
                <section className="my-4 space-y-2 rounded border p-4">
@@ -271,11 +273,11 @@ export default function OpportunityDraft({
                </Link>
            )}
            {profileMode && (
-                <section
-                    aria-label="Âmbito desta entrega"
+                <details
+                    aria-label="Disponibilidade por modalidade"
                    className="rounded border p-3"
                >
-                    <h2>Âmbito desta entrega</h2>
+                    <summary className="cursor-pointer font-medium">Modalidades disponíveis e condições de submissão</summary>
                    <p>
                        Seis categorias base: projeto de investimento,
                        imobiliário, fundiário, venda de negócio, parceria e
@@ -304,7 +306,7 @@ export default function OpportunityDraft({
                        certifica a viabilidade, a titularidade ou a decisão
                        externa de cada caso.
                    </p>
-                </section>
+                </details>
            )}
            {profileMode && record && (
                <ClassificationReview id={record.id} refreshToken={token} />
@@ -334,8 +336,8 @@ export default function OpportunityDraft({
                            }));
                        }}
                    >
-                        {profileAccess?.internalPromoter && (
-                            <option value="">
+                        {(profileAccess?.internalPromoter || !uniquePromoterContext) && (
+                            <option value="|">
                                Selecionar o promotor real da oportunidade
                            </option>
                        )}
@@ -821,7 +823,7 @@ export default function OpportunityDraft({
                )}
                {!readOnly && (
                    <>
-                        <Field
+                        {!hasCanonicalPreparation && <Field
                            label="Motivo da alteração"
                            error={errors.reason}
                        >
@@ -832,8 +834,8 @@ export default function OpportunityDraft({
                                minLength={20}
                                maxLength={1000}
                            />
-                        </Field>
-                        {!unavailable && (
+                        </Field>}
+                        {!unavailable && !hasCanonicalPreparation && (
                            <button className={button} disabled={busy}>
                                Guardar rascunho
                            </button>
@@ -891,7 +893,7 @@ export default function OpportunityDraft({
                    </>
                )}
            </form>
-            {record && (
+            {record && (!profileMode || readOnly || unavailable || !canonicalOptions || !data.opportunity_category) && (
                <Link
                    href={
                        resourcesInstalled
@@ -909,10 +911,10 @@ export default function OpportunityDraft({
                    Associações territoriais e produtivas existentes
                </Link>
            )}
-            {profileMode && canonicalOptions && (
+            {profileMode && canonicalOptions && Boolean(data.opportunity_category) && (
                <section>
                    {record && !readOnly && !unavailable && (
-                        <OpportunityContactForm
+                        <details><summary className="cursor-pointer font-medium">Acrescentar um contacto à oportunidade</summary><OpportunityContactForm
                            id={record.id}
                            etag={token ?? ''}
                            organization={
@@ -938,7 +940,7 @@ export default function OpportunityDraft({
                                    },
                                }));
                            }}
-                        />
+                        /></details>
                    )}
                    <OpportunityCanonicalFields
                        value={
@@ -960,6 +962,7 @@ export default function OpportunityDraft({
                            ],
                        }}
                        errors={errors}
+                        missingPaths={canonicalResponse?.completion.missing_paths}
                        category={valueText(data.opportunity_category ?? '')}
                        organization={
                            (data.organization_id ?? null) as string | null
@@ -967,16 +970,23 @@ export default function OpportunityDraft({
                        actorId={auth.user.id}
                        sectors={sectors}
                        disabled={busy || readOnly || unavailable}
+                        onOpenResources={!readOnly && !unavailable && resourcesInstalled ? (group) => void send('save',group) : undefined}
                    />
-                    {!readOnly && !unavailable && (
+                    {!readOnly && !unavailable && hasCanonicalPreparation && (
+                        <div className="sticky bottom-0 space-y-3 rounded border bg-background p-4 shadow-sm">
+                        <Field label="O que alterou nesta preparação" error={errors.reason}>
+                            <textarea className={control} value={reason} onChange={(event) => setReason(event.target.value)} minLength={20} maxLength={1000} />
+                        </Field>
                        <button
                            type="button"
                            className={button}
                            disabled={busy}
                            onClick={() => void send('save')}
                        >
-                            Guardar contrato no rascunho
+                            Guardar preparação
                        </button>
+                        <p className="text-sm">Pode guardar incompleto e continuar mais tarde em Minhas oportunidades.</p>
+                        </div>
                    )}
                    {Object.entries(errors)
                        .filter(([key]) => key.startsWith('canonical'))
@@ -179,6 +179,8 @@ export default function OpportunityResources({
        readOnly?: boolean;
        countries?: { code: string; name: string }[];
    }>().props;
+    const returnGroup = new URLSearchParams(usePage().url.split('?')[1] ?? '').get('return_group');
+    const returnHash = ['territory', 'evidence'].includes(returnGroup ?? '') ? `#fill-${returnGroup}` : '#fill-evidence';
    const [kind, setKind] = useState<Kind>('locations');
    const [editing, setEditing] = useState<Resource | null>(null);
    const [payload, setPayload] = useState<Payload>({ country_code: 'MZ' });
@@ -307,7 +309,7 @@ export default function OpportunityResources({
        !!opportunity.deleted_at || opportunity.status === 'archived';
    return (
        <Management title="Imagens, documentos e localizações">
-            <Link href={`${basePath}/${opportunity.id}/edit`}>
+            <Link href={`${basePath}/${opportunity.id}/edit${returnHash}`}>
                Regressar ao rascunho #{opportunity.id}
            </Link>
            <p>
@@ -0,0 +1,100 @@
+import { Head, Link, router } from '@inertiajs/react';
+import { useEffect, useState } from 'react';
+import { PortalMenu } from '@/layouts/portal-navigation';
+import { fiscalForms, fiscalFormFields, fiscalPreparationIssues, newFiscalPreparation, readFiscalPreparation, type FiscalFormKind, type FiscalPreparation } from '@/lib/fiscal-form-preparation';
+
+const input = 'mt-1 block w-full rounded border border-slate-400 bg-white p-3 text-slate-900';
+const button = 'rounded border border-emerald-800 px-4 py-3 font-semibold text-emerald-900 disabled:opacity-50';
+export default function FiscalForms({ initialTax = 'iva' }: { initialTax?: FiscalFormKind }) {
+    const [kind, setKind] = useState<FiscalFormKind>(initialTax);
+    const [drafts, setDrafts] = useState({ iva: newFiscalPreparation('iva'), irpc: newFiscalPreparation('irpc') });
+    const [step, setStep] = useState(0);
+    const [notice, setNotice] = useState('');
+    const [pending, setPending] = useState<FiscalPreparation | null>(null);
+    const [dirty, setDirty] = useState(false);
+    const p = drafts[kind], source = fiscalForms[kind], fields = fiscalFormFields(kind);
+    const issues = fiscalPreparationIssues(p);
+    useEffect(() => {
+        setKind(initialTax);
+    }, [initialTax]);
+    useEffect(() => {
+        const warn = (e: BeforeUnloadEvent) => { if (dirty) { e.preventDefault(); e.returnValue = ''; } };
+        window.addEventListener('beforeunload', warn);
+        const unsubscribe = router.on('before', e => {
+            if (dirty && !window.confirm('Os campos estão apenas nesta página. Guarde o ficheiro para continuar depois. Pretende sair?')) e.preventDefault();
+        });
+        return () => { window.removeEventListener('beforeunload', warn); unsubscribe(); };
+    }, [dirty]);
+    function patch(update: Partial<FiscalPreparation>) {
+        setDrafts(d => ({ ...d, [kind]: { ...d[kind], ...update } }));
+        setDirty(true); setNotice('');
+    }
+    function download() {
+        const url = URL.createObjectURL(new Blob([JSON.stringify(p)], { type: 'application/json' }));
+        const a = document.createElement('a'); a.href = url; a.download = `investmoz-preparacao-${kind}.json`; a.click();
+        setTimeout(() => URL.revokeObjectURL(url), 1000);
+        setNotice('Ficheiro de preparação gerado. Guarde-o para recuperar os campos. Não foi enviado ao portal nem à AT.');
+        // Other tax preparation may still contain unsaved edits.
+    }
+    return <div className="min-h-screen bg-slate-50 text-slate-900">
+        <Head title="Preencher formulário fiscal" />
+        <div className="print:hidden"><PortalMenu /></div>
+        <main className="mx-auto max-w-5xl space-y-6 px-5 py-8">
+            <div className="print:hidden"><Link href="/documentos" className="underline">Documentos e Formulários</Link></div>
+            <h1 className="text-3xl font-bold">Preencher formulário fiscal</h1>
+            <p>Prepare os valores de IVA ou IRPC, confira e guarde um ficheiro para continuar depois. Os campos vazios significam informação em falta.</p>
+            <p className="rounded border border-amber-600 bg-amber-50 p-3">Preparação para conferência, sem submissão à Autoridade Tributária. Os valores são introduzidos por si; não há apuramento automático nem confirmação de elegibilidade de deduções.</p>
+            <label className="block max-w-lg print:hidden">Formulário
+                <select className={input} value={kind} onChange={e => { setKind(e.target.value as FiscalFormKind); setStep(0); setNotice(''); setPending(null); }}>
+                    <option value="iva">IVA — Modelo A</option><option value="irpc">IRPC — Modelo 22</option>
+                </select>
+            </label>
+            <h2 className="text-xl font-bold">{source.title}</h2>
+            <p>{source.coverage}</p>
+            <nav aria-label="Etapas de preenchimento" className="flex flex-wrap gap-2 print:hidden">
+                {['Identificação e período', 'Preencher valores', 'Conferir e guardar'].map((label, n) => <button type="button" key={label} className={button} aria-current={step === n ? 'step' : undefined} onClick={() => setStep(n)}>{n + 1}. {label}</button>)}
+            </nav>
+            <form onSubmit={e => e.preventDefault()} className="space-y-5">
+                <fieldset className={`${step !== 0 ? 'hidden print:block' : ''} space-y-4 rounded border bg-white p-5`}>
+                    <legend className="font-bold">Identificação e período</legend>
+                    <label className="block">Nome ou designação social<input className={input} autoComplete="organization" maxLength={5000} value={p.name} onChange={e => patch({ name: e.target.value })} /></label>
+                    <div className="grid gap-4 sm:grid-cols-2">
+                        <label>NUIT<input className={input} inputMode="numeric" maxLength={9} value={p.nuit} onChange={e => patch({ nuit: e.target.value })} /></label>
+                        <label>{kind === 'iva' ? 'Período — ano e mês' : 'Exercício — ano'}<input className={input} type={kind === 'iva' ? 'month' : 'text'} inputMode={kind === 'irpc' ? 'numeric' : undefined} placeholder={kind === 'iva' ? 'AAAA-MM' : 'AAAA'} maxLength={7} value={p.period} onChange={e => patch({ period: e.target.value })} /></label>
+                    </div>
+                    <p className="text-sm">Dados mantidos apenas nesta página até descarregar o ficheiro. Não há gravação automática. Guarde antes de sair ou actualizar.</p>
+                </fieldset>
+                <fieldset className={`${step !== 1 ? 'hidden print:block' : ''} space-y-4 rounded border bg-white p-5`}>
+                    <legend className="font-bold">Valores em meticais (MZN)</legend>
+                    <p>Sem separador de milhares; vírgula ou ponto para os cêntimos. Não preencha zero quando desconhece o valor.</p>
+                    {kind === 'irpc' && <p>Crédito económico (303) e internacional (304) são distintos. Não utilize a mesma parcela nos dois campos. Esta preparação manual não verifica as parcelas; conserve o suporte para conferência.</p>}
+                    <div className="grid gap-5 sm:grid-cols-2">{fields.map(f => <div key={f.code} className="break-inside-avoid">
+                        <label className="block">{f.code} — {f.label}<input className={input} inputMode="decimal" maxLength={100} value={p.values[f.code] ?? ''} onChange={e => patch({ values: { ...p.values, [f.code]: e.target.value } })} /></label>
+                        <details className="mt-1 text-sm print:hidden"><summary className="cursor-pointer underline">Orientação do campo</summary><p>{f.guidance}</p></details>
+                    </div>)}</div>
+                </fieldset>
+                <section className={`${step !== 2 ? 'hidden print:block' : ''} space-y-4 rounded border bg-white p-5`} aria-label="Conferir e guardar">
+                    <h3 className="font-bold">Conferência da preparação</h3>
+                    <p>{fields.filter(f => (p.values[f.code] ?? '') !== '').length} de {fields.length} campos com valor. Campos vazios não foram convertidos em zero.</p>
+                    {issues.length > 0 ? <div><p>Por conferir — pode guardar a preparação incompleta:</p><ul className="list-disc pl-6">{issues.map(i => <li key={i}>{i}</li>)}</ul></div> : <p>Formato dos campos conferido. Os montantes e a aplicação fiscal ainda devem ser conferidos.</p>}
+                    <dl className="grid gap-3 sm:grid-cols-2 print:hidden">{fields.filter(f => (p.values[f.code] ?? '') !== '').map(f => <div key={f.code}><dt>{f.code} — {f.label}</dt><dd className="font-semibold">{p.values[f.code]} MZN</dd></div>)}</dl>
+                    <label className="block">Notas e referências dos valores<textarea className={input} rows={4} maxLength={5000} value={p.notes} onChange={e => patch({ notes: e.target.value })} /></label>
+                    <div className="flex flex-wrap gap-3 print:hidden"><button type="button" className={button} onClick={download}>Guardar ficheiro para continuar</button><button type="button" className={button} onClick={() => window.print()}>Imprimir preparação</button></div>
+                    <p className="text-sm">O ficheiro contém os dados introduzidos. Guarde-o num local privado. Não fica associado automaticamente ao dossier.</p>
+                </section>
+                <div className="flex justify-between gap-3 print:hidden"><button type="button" className={button} disabled={step === 0} onClick={() => setStep(step - 1)}>Anterior</button><button type="button" className={button} disabled={step === 2} onClick={() => setStep(step + 1)}>Continuar</button></div>
+            </form>
+            <section className="space-y-3 rounded border p-4 print:hidden" aria-label="Recuperar preparação">
+                <label className="block">Recuperar ficheiro guardado<input className={input} type="file" accept=".json,application/json" onChange={async e => {
+                    const file = e.target.files?.[0]; e.target.value = ''; if (!file) return;
+                    try { if (file.size > 100_000) throw new Error('O ficheiro é demasiado grande.'); setPending(readFiscalPreparation(await file.text())); setNotice('Ficheiro lido. Confirme a recuperação abaixo.'); }
+                    catch (error) { setPending(null); setNotice(error instanceof Error ? error.message : 'Não foi possível ler o ficheiro. Os campos actuais foram preservados.'); }
+                }} /></label>
+                {pending && <div className="space-y-2"><p>Recuperar {fiscalForms[pending.kind].title}, período {pending.period || 'por indicar'}? Substitui apenas os campos desse formulário nesta página.</p><button type="button" className={button} onClick={() => { setDrafts(d => ({ ...d, [pending.kind]: pending })); setKind(pending.kind); setStep(2); setPending(null); setDirty(true); setNotice('Preparação recuperada.'); }}>Confirmar recuperação</button> <button type="button" className={button} onClick={() => setPending(null)}>Cancelar</button></div>}
+            </section>
+            {notice && <p role="status" className="rounded border p-3">{notice}</p>}
+            <details className="rounded border p-4"><summary className="cursor-pointer font-semibold">Exemplar e cobertura</summary><p>{source.source}</p><p className="break-all text-sm">SHA256: {source.hash}</p><p>{source.coverage}</p><p>Os cálculos e correspondências já disponíveis no simulador permanecem separados desta introdução manual. Não se executam fórmulas nem se transportam valores entre edições automaticamente.</p></details>
+            <div className="flex flex-wrap gap-4 print:hidden"><Link href="/simulador-fiscal" className="underline">Consultar cálculos e preparação M20/M22 no simulador</Link><Link href="/legislacao" className="underline">Consultar legislação</Link></div>
+        </main>
+    </div>;
+}
@@ -1,4 +1,5 @@
 import { PublicSectorCards } from '@/components/public-sector-cards';
+import { documentFacetLabel } from '@/lib/document-facet-label';
 import { PORTAL_MORE_LINK } from '@/lib/portal-presentation';
 import {
    PublicDocumentContent,
@@ -537,6 +538,15 @@ export default function Services(p: Props) {
                        opportunities={p.opportunities}
                    />
                )}
+                {p.section === 'documents' && <section aria-label="Preencher formulários fiscais" className="space-y-3 rounded-xl border bg-white p-5">
+                    <h2 className="text-xl font-bold">Que formulário pretende preencher?</h2>
+                    <p>Abra os campos do formulário fiscal. A legislação e os guias de consulta ficam abaixo.</p>
+                    <div className="flex flex-wrap gap-3">
+                        <Link className={button} href="/formularios/fiscais?imposto=iva">Preencher IVA — Modelo A</Link>
+                        <Link className={button} href="/formularios/fiscais?imposto=irpc">Preparar IRPC — Modelo 22</Link>
+                    </div>
+                    <p className="text-sm">Preparação manual, com gravação em ficheiro. Cobertura parcial de IRPC; sem submissão à AT.</p>
+                </section>}
                {['procedures', 'documents', 'legislation'].includes(
                    p.section,
                ) && <JourneyDocumentResources stages={p.stages} />}
@@ -579,7 +589,7 @@ export default function Services(p: Props) {
                                    >
                                        <option value="">Todos</option>
                                        {p.topics?.map((topic) => (
-                                            <option key={topic}>{topic}</option>
+                                            <option key={topic} value={topic}>{documentFacetLabel(topic)}</option>
                                        ))}
                                    </select>
                                </label>
@@ -606,7 +616,7 @@ export default function Services(p: Props) {
                                                value={category}
                                            >
                                                {documentTypeLabels[category] ??
-                                                    category}
+                                                    documentFacetLabel(category)}
                                            </option>
                                        ))}
                                    </select>
@@ -809,8 +819,8 @@ export default function Services(p: Props) {
                                    >
                                        <option value="">Todos</option>
                                        {p.languages?.map((language) => (
-                                            <option key={language}>
-                                                {language}
+                                            <option key={language} value={language}>
+                                                {documentFacetLabel(language)}
                                            </option>
                                        ))}
                                    </select>
@@ -917,7 +927,7 @@ export default function Services(p: Props) {
                                        className="rounded-full border bg-white px-3 py-1 underline"
                                        href={`${p.section === 'documents' ? '/documentos' : '/legislacao'}?${new URLSearchParams({ topic }).toString()}`}
                                    >
-                                        {topic}
+                                        {documentFacetLabel(topic)}
                                    </Link>
                                ))}
                            </nav>
@@ -4,6 +4,11 @@ import { useState } from 'react';
 import ProfileNavigation from '@/components/profile-navigation';
 import { profileJson } from '@/lib/profile-json';
 import { button, control } from '@/pages/management/shared';
+import { modalityLabels } from '@/components/opportunity-search-filters';
+import ProfileProofPicker from '@/components/profile-proof-picker';
+
+const representations: Record<string,string> = {individual:'Em nome próprio',company:'Empresa',public_entity:'Entidade pública',association:'Associação',partner:'Parceiro ou representante'};
+const requestStates: Record<string,string> = {pending:'Em análise',approved:'Aprovado',rejected:'Devolvido ou recusado',cancelled:'Cancelado'};

 type RequestEntry = {
    id: string;
@@ -67,9 +72,8 @@ export default function RequestProfile({
                Solicitar perfil de Promotor
            </h1>
            <p>
-                A aprovação confirma identidade, representação e comprovativos.
-                Só os tipos aprovados ficam disponíveis; o pedido não ativa o
-                perfil.
+                Indique em nome de quem vai actuar, as modalidades que pretende preparar e os comprovativos do pedido.
+                Pode acompanhar a decisão nesta página. A submissão do pedido não activa o perfil.
            </p>
            <form
                className="max-w-2xl space-y-4"
@@ -79,7 +83,7 @@ export default function RequestProfile({
                }}
            >
                <label className="block">
-                    Representação
+                    Em nome de quem vai actuar?
                    <select
                        className={control}
                        value={representation}
@@ -92,7 +96,7 @@ export default function RequestProfile({
                            'association',
                            'partner',
                        ].map((v) => (
-                            <option key={v}>{v}</option>
+                            <option key={v} value={v}>{representations[v]}</option>
                        ))}
                    </select>
                </label>
@@ -115,9 +119,10 @@ export default function RequestProfile({
                    </label>
                )}
                <fieldset>
-                    <legend>Tipos pretendidos</legend>
+                    <legend>Que oportunidades pretende preparar?</legend>
+                    <div className="grid gap-2 sm:grid-cols-2">
                    {types.map((type) => (
-                        <label key={type} className="block">
+                        <label key={type} className="flex gap-2 rounded border p-3">
                            <input
                                type="checkbox"
                                checked={selected.includes(type)}
@@ -125,23 +130,12 @@ export default function RequestProfile({
                                    setSelected(toggle(selected, type))
                                }
                            />{' '}
-                            {type}
-                        </label>
-                    ))}
-                </fieldset>
-                <fieldset>
-                    <legend>Comprovativos próprios analisados</legend>
-                    {documents.map((d) => (
-                        <label key={d.id} className="block">
-                            <input
-                                type="checkbox"
-                                checked={proofs.includes(d.id)}
-                                onChange={() => setProofs(toggle(proofs, d.id))}
-                            />{' '}
-                            {d.file_name}
+                            {modalityLabels[type] ?? 'Outra modalidade'}
                        </label>
                    ))}
+                    </div>
                </fieldset>
+                <ProfileProofPicker documents={documents} value={proofs} onChange={setProofs} disabled={busy} />
                {!documents.length && (
                    <p>
                        Sem comprovativos próprios disponíveis. Pode anexar ao
@@ -156,7 +150,7 @@ export default function RequestProfile({
                    </p>
                )}
                <label className="block">
-                    Fundamentação
+                    Explique o seu pedido
                    <textarea
                        required
                        minLength={20}
@@ -180,7 +174,7 @@ export default function RequestProfile({
                {requests.map((r) => (
                    <article key={r.id} className="border-b py-3">
                        <p>
-                            {r.id} — {r.status}
+                            Pedido de {new Date(r.created_at).toLocaleDateString('pt-MZ')} — {requestStates[r.status] ?? 'Estado por consultar'}
                        </p>
                        <p>
                            {r.decision_reason ??
@@ -0,0 +1,237 @@
+import { useState } from 'react';
+import {
+    assessmentReady,
+    diagnosticReady,
+    forceLabels,
+    forces,
+    newCompetitivenessDraft,
+    readCompetitivenessDraft,
+} from '@/lib/cluster-competitiveness';
+import type {
+    Assessment,
+    CompetitivenessDraft,
+    Force,
+} from '@/lib/cluster-competitiveness';
+import { button, control } from '../management/shared';
+
+const labels = {
+    evidence: 'Observações e evidências locais',
+    source: 'Fonte e referência recuperável (documento, página ou endereço)',
+    period: 'Período dos dados e data da consulta',
+    rationale: 'Justificação da pressão atribuída',
+    limitations: 'Limitações, cobertura e pressupostos',
+    opportunity: 'Oportunidade de investimento e fundamento',
+} as const;
+
+export default function Competitiveness({
+    clusterId,
+    sector,
+}: {
+    clusterId: string;
+    sector: string;
+}) {
+    const [draft, setDraft] = useState(() =>
+        newCompetitivenessDraft(clusterId, sector),
+    );
+    const [pending, setPending] = useState<CompetitivenessDraft | null>(null);
+    const [message, setMessage] = useState('');
+    function change(force: Force, field: keyof Assessment, value: string) {
+        setDraft((previous) => ({
+            ...previous,
+            forces: {
+                ...previous.forces,
+                [force]: { ...previous.forces[force], [field]: value },
+            },
+        }));
+    }
+    function download() {
+        const url = URL.createObjectURL(
+            new Blob([JSON.stringify(draft, null, 2)], {
+                type: 'application/json',
+            }),
+        );
+        const link = document.createElement('a');
+        link.href = url;
+        link.download = `competitividade-${clusterId}.json`;
+        link.click();
+        setTimeout(() => URL.revokeObjectURL(url), 1000);
+        setMessage(
+            'Ficheiro preparado para transferência. Conserve-o para recuperar a análise.',
+        );
+    }
+    return (
+        <section
+            className="max-w-3xl space-y-4 rounded border p-4"
+            aria-label="Diagnóstico de competitividade"
+        >
+            <h2 className="text-xl font-semibold">
+                Competitividade — cinco forças de Porter
+            </h2>
+            <p>
+                Análise qualitativa por sector e região ligada a este cluster.
+                Descreva as evidências e justifique cada pressão; não existe
+                pontuação automática nem média entre forças.
+            </p>
+            <p>
+                Rascunho nesta página: transfira o ficheiro antes de sair. Não é
+                gravado no servidor nem publicado. A classificação representa a
+                apreciação do autor.
+            </p>
+            <label className="block">
+                Sector analisado
+                <input
+                    className={control}
+                    maxLength={200}
+                    value={draft.sector}
+                    onChange={(e) =>
+                        setDraft({ ...draft, sector: e.target.value })
+                    }
+                />
+            </label>
+            {draft.sector !== sector && (
+                <p>
+                    O sector da análise difere do sector actual do cluster (
+                    {sector}). Confira o âmbito antes de reutilizar conclusões.
+                </p>
+            )}
+            <label className="block">
+                Região / província / distrito e abrangência
+                <input
+                    className={control}
+                    maxLength={1000}
+                    value={draft.region}
+                    onChange={(e) =>
+                        setDraft({ ...draft, region: e.target.value })
+                    }
+                />
+            </label>
+            <p role="status">
+                {diagnosticReady(draft)
+                    ? 'Cinco forças preenchidas para revisão; fontes e conclusões requerem leitura do autor.'
+                    : 'Diagnóstico incompleto: indique o âmbito e complete as evidências das cinco forças.'}
+            </p>
+            {forces.map((force) => (
+                <details key={force} className="rounded border p-3">
+                    <summary className="cursor-pointer font-semibold">
+                        {forceLabels[force]} ·{' '}
+                        {assessmentReady(draft.forces[force])
+                            ? 'Preenchida para revisão'
+                            : 'Indeterminada / incompleta'}
+                    </summary>
+                    <div className="space-y-3 pt-3">
+                        <label className="block">
+                            Pressão competitiva
+                            <select
+                                className={control}
+                                value={draft.forces[force].pressure}
+                                onChange={(e) =>
+                                    change(force, 'pressure', e.target.value)
+                                }
+                            >
+                                <option value="">Indeterminada</option>
+                                <option value="low">Baixa</option>
+                                <option value="medium">Média</option>
+                                <option value="high">Alta</option>
+                            </select>
+                        </label>
+                        {Object.entries(labels).map(([field, label]) => (
+                            <label key={field} className="block">
+                                {label}
+                                <textarea
+                                    className={control}
+                                    rows={3}
+                                    maxLength={5000}
+                                    value={
+                                        draft.forces[force][
+                                            field as keyof typeof labels
+                                        ]
+                                    }
+                                    onChange={(e) =>
+                                        change(
+                                            force,
+                                            field as keyof typeof labels,
+                                            e.target.value,
+                                        )
+                                    }
+                                />
+                            </label>
+                        ))}
+                    </div>
+                </details>
+            ))}
+            <button type="button" className={button} onClick={download}>
+                Transferir análise / rascunho
+            </button>
+            <label className="block">
+                Recuperar ficheiro deste cluster
+                <input
+                    className={control}
+                    type="file"
+                    accept=".json,application/json"
+                    onChange={async (e) => {
+                        const file = e.target.files?.[0];
+                        e.target.value = '';
+                        if (!file) return;
+                        setPending(null);
+                        try {
+                            if (file.size > 250_000)
+                                throw Error(
+                                    'O ficheiro excede o limite de 250 KB.',
+                                );
+                            setPending(
+                                readCompetitivenessDraft(
+                                    await file.text(),
+                                    clusterId,
+                                ),
+                            );
+                            setMessage(
+                                'Ficheiro lido. Confira o âmbito e confirme a substituição dos campos actuais.',
+                            );
+                        } catch (error) {
+                            setMessage(
+                                error instanceof Error
+                                    ? error.message
+                                    : 'Não foi possível ler o ficheiro.',
+                            );
+                        }
+                    }}
+                />
+            </label>
+            {pending && (
+                <div className="space-y-2 rounded border p-3">
+                    <p>
+                        Recuperar análise de{' '}
+                        {pending.sector || 'sector não indicado'} em{' '}
+                        {pending.region || 'região não indicada'}? Os campos
+                        actuais serão substituídos. Transfira primeiro o
+                        rascunho actual se o quiser conservar.
+                    </p>
+                    <button
+                        type="button"
+                        className={button}
+                        onClick={() => {
+                            setDraft(pending);
+                            setPending(null);
+                            setMessage('Análise recuperada para edição.');
+                        }}
+                    >
+                        Confirmar recuperação
+                    </button>{' '}
+                    <button
+                        type="button"
+                        className={button}
+                        onClick={() => {
+                            setPending(null);
+                            setMessage(
+                                'Recuperação cancelada; campos actuais preservados.',
+                            );
+                        }}
+                    >
+                        Cancelar
+                    </button>
+                </div>
+            )}
+            {message && <p role="status">{message}</p>}
+        </section>
+    );
+}
@@ -6,6 +6,7 @@ import { Management, Field, button, control } from '../management/shared';
 import { titles, statuses, stages, roles } from './types';
 import type { Structure, StructureRecord, Chain } from './types';
 import ValueNetwork from './value-network';
+import Competitiveness from './competitiveness';
 import type { ChainLink, Gap } from './value-network';

 function ChainForm({ clusterId, chain }: { clusterId: string; chain?: Chain }) {
@@ -298,6 +299,7 @@ export default function Editor({
            </form>
            {isCluster && record && (
                <>
+                    <Competitiveness key={record.id} clusterId={record.id} sector={record.sector ?? ''} />
                    <section className="max-w-3xl space-y-4">
                        <h2 className="text-xl font-semibold">
                            Projectos associados
@@ -50,6 +50,11 @@ use Laravel\Fortify\Features;
 // Route::inertia('/', 'welcome')->name('home');
 Route::get('/', [PortalServicesController::class, 'home'])->name('home');
 Route::inertia('/contextos-de-investimento', 'portal/investment-contexts')->name('portal.investment-contexts');
+Route::get('/formularios/fiscais', function (\Illuminate\Http\Request $request) {
+    $input = $request->validate(['imposto' => ['nullable', 'in:iva,irpc']]);
+
+    return Inertia::render('portal/fiscal-forms', ['initialTax' => $input['imposto'] ?? 'iva']);
+})->name('portal.fiscal-forms');
 Route::inertia('/politica-de-privacidade', 'portal/privacy-policy')->name('legal.privacy');
 Route::inertia('/termos-de-uso', 'portal/terms-of-use')->name('legal.terms');
 foreach (['sectores' => 'sectors', 'como-investir' => 'procedures', 'legislacao' => 'legislation', 'documentos' => 'documents',
@@ -0,0 +1,126 @@
+<?php
+namespace Tests\Feature;
+
+use App\Models\Opportunity;
+use App\Services\InvestmentCatalogue;
+use App\Services\InvestmentGeography;
+use App\Services\CorridorAgribusinessOpportunities;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+use Tests\TestCase;
+
+final class CatalogueProvinceCoverageTest extends TestCase
+{
+    use DatabaseTransactions;
+    private const PROVINCE = 'bfde2651-2b46-5d9c-a500-733fa55a8c5c';
+    protected function setUp(): void
+    {
+        parent::setUp();\Tests\Support\ProactiveInvestmentFixture::guard();$this->withoutVite();
+    }
+
+    public function test_accepted_maputo_source_is_found_in_both_approved_provinces_without_becoming_a_district_site(): void
+    {
+        $c=app(InvestmentCatalogue::class);
+        $expected=Opportunity::published()->where('workflow_context->corridor_agribusiness->source_sha256',CorridorAgribusinessOpportunities::SOURCE_HASH)
+            ->where('workflow_context->corridor_agribusiness->corridor','Corredor de Maputo')->pluck('id')->all();
+        $this->assertCount(5,$expected);
+        foreach([self::PROVINCE,'4aa31470-997e-5c63-8fe0-ff2f62586f56']as$province){
+            foreach(['all','context']as$basis){
+                $ids=$c->query(['sector'=>'agronegocio','province_id'=>$province,'territory_basis'=>$basis])->pluck('id')->all();
+                foreach($expected as$id)$this->assertContains($id,$ids);
+            }
+        }
+        foreach($expected as$id)$this->assertNotContains($id,$c->query(['province_id'=>self::PROVINCE,'territory_basis'=>'direct'])->pluck('id')->all());
+        $district=app(InvestmentGeography::class)->publicReferences()->where('parent_id',self::PROVINCE)->where('location_type','district')->first();
+        $this->assertNotNull($district);
+        foreach($expected as$id)$this->assertNotContains($id,$c->query(['province_id'=>self::PROVINCE,'district_id'=>$district->id])->pluck('id')->all());
+        $label=$c->presentLocation(Opportunity::findOrFail($expected[0]))->territorial_summary;
+        $this->assertStringContainsString('contexto provincial do corredor',$label);
+        $this->assertStringContainsString('distrito e posto administrativo não indicados',$label);
+        foreach($expected as$id)$this->assertContains($id,$c->query(['geo_location_id'=>self::PROVINCE])->pluck('id')->all());
+        $this->assertSame([],array_intersect($expected,$c->query(['province_id'=>'059b02ca-7095-577a-8705-4d4c46896747'])->pluck('id')->all()));
+    }
+
+    public function test_province_includes_its_descendants_with_full_location_and_excludes_private_and_other_provinces(): void
+    {
+        $geo=app(InvestmentGeography::class);$c=app(InvestmentCatalogue::class);
+        $district=$geo->publicReferences()->where('parent_id',self::PROVINCE)->where('location_type','district')->first();
+        $post=$geo->publicReferences()->where('parent_id',$district->id)->where('location_type','admin_post')->first();
+        $this->assertNotNull($post);
+        $make=fn($territory,$status='published')=>Opportunity::create(['sector_id'=>1,'reference'=>'SYNTHETIC-QA-'.Str::uuid(),'slug'=>'synthetic-'.Str::uuid(),'title'=>'SYNTHETIC QA province coverage','status'=>$status,'published_at'=>now()->subMinute(),'primary_territory_id'=>$territory,'geography_scope'=>'specific']);
+        $record=$make($post->id);$private=$make($post->id,'draft');$other=$make('059b02ca-7095-577a-8705-4d4c46896747');
+        $ids=$c->query(['province_id'=>self::PROVINCE,'sector'=>'agronegocio'])->pluck('id')->all();
+        $this->assertContains($record->id,$ids);$this->assertNotContains($private->id,$ids);$this->assertNotContains($other->id,$ids);
+        $label=$c->presentLocation($record)->territorial_summary;
+        foreach(['Maputo Província',$district->name,$post->name]as$name)$this->assertStringContainsString($name,$label);
+    }
+
+    public function test_actual_territory_and_publication_decisions_override_old_corridor_context(): void
+    {
+        $c=app(InvestmentCatalogue::class);
+        $record=Opportunity::published()->where('workflow_context->corridor_agribusiness->corridor','Corredor de Maputo')->firstOrFail();
+        $record->primary_territory_id='059b02ca-7095-577a-8705-4d4c46896747';$record->save();
+        $this->assertNotContains($record->id,$c->query(['province_id'=>self::PROVINCE])->pluck('id')->all());
+        $record->primary_territory_id=null;$record->status='draft';$record->save();
+        $this->assertNotContains($record->id,$c->query(['province_id'=>self::PROVINCE])->pluck('id')->all());
+    }
+
+    public function test_public_search_and_corridor_view_agree_without_inventing_map_coordinates(): void
+    {
+        $filters=['province_id'=>self::PROVINCE,'sector'=>'agronegocio'];
+        $response=$this->getJson('/api/v1/investment/search?'.http_build_query($filters))->assertOk()->assertJsonPath('total',5);
+        foreach($response->json('data')as$row)$this->assertStringContainsString('contexto provincial do corredor',$row['territorial_summary']);
+        $groups=app(\App\Services\OpportunityCorridorExplorer::class)->groups($filters);
+        $this->assertCount(1,$groups);$this->assertSame(5,$groups[0]['count']);
+        foreach($groups[0]['opportunities']as$row){$this->assertContains('Maputo Província',$row['provinces']);$this->assertNull($row['district']);}
+        $map=app(InvestmentCatalogue::class)->map($filters);
+        $this->assertCount(5,$map['unlocated']);$this->assertSame([],$map['features']);
+    }
+
+    public function test_all_approved_corridors_are_found_in_their_provinces_and_not_in_unrelated_provinces(): void
+    {
+        $catalogue=app(InvestmentCatalogue::class);
+        $provinces=app(InvestmentGeography::class)->publicReferences()->where('location_type','province')->get();
+        $this->assertCount(11,$provinces);
+        foreach(config('investment_corridors')as$entry){
+            $records=Opportunity::published()->whereNull('primary_territory_id')
+                ->where('workflow_context->corridor_agribusiness->source_sha256',CorridorAgribusinessOpportunities::SOURCE_HASH)
+                ->where('workflow_context->corridor_agribusiness->corridor',$entry['name'])->pluck('id')->all();
+            $this->assertNotEmpty($records,$entry['name']);
+            foreach($provinces as$province){
+                $ids=$catalogue->query(['province_id'=>$province->id,'sector'=>'agronegocio'])->pluck('id')->all();
+                foreach($records as$id){
+                    if(in_array($province->source_code,$entry['provinces'],true))$this->assertContains($id,$ids);
+                    else $this->assertNotContains($id,$ids);
+                }
+            }
+        }
+    }
+
+    public function test_descendant_coverage_is_national_and_shared_by_sectors_and_location_entry_points(): void
+    {
+        $geo=app(InvestmentGeography::class);$catalogue=app(InvestmentCatalogue::class);
+        $provinces=$geo->publicReferences()->where('location_type','province')->get();
+        $sectors=DB::table('sectors')->where('is_active',true)->whereNotNull('published_at')->whereNull('deleted_at')->orderBy('id')->limit(2)->get();
+        $this->assertCount(2,$sectors);
+        foreach($provinces as$province){
+            $district=$geo->publicReferences()->where('parent_id',$province->id)->where('location_type','district')->first();
+            $this->assertNotNull($district,$province->name);
+            $post=$geo->publicReferences()->where('parent_id',$district->id)->where('location_type','admin_post')->first();
+            $leaf=$post?:$district;
+            foreach($sectors as$sector){
+                $record=Opportunity::create(['sector_id'=>$sector->id,'reference'=>'SYNTHETIC-QA-'.Str::uuid(),'slug'=>'synthetic-'.Str::uuid(),
+                    'title'=>'SYNTHETIC QA national coverage','status'=>'published','published_at'=>now()->subMinute(),'primary_territory_id'=>$leaf->id,'geography_scope'=>'specific']);
+                foreach([['province_id'=>$province->id],['geo_location_id'=>$province->id],['province_id'=>$province->id,'district_id'=>$district->id]]as$entry){
+                    $this->assertContains($record->id,$catalogue->query([...$entry,'sector'=>$sector->slug])->pluck('id')->all());
+                }
+                $other=$sectors->firstWhere('id','!=',$sector->id);
+                $this->assertNotContains($record->id,$catalogue->query(['province_id'=>$province->id,'sector'=>$other->slug])->pluck('id')->all());
+                $label=$catalogue->presentLocation($record)->territorial_summary;
+                $this->assertStringContainsString($province->name,$label);$this->assertStringContainsString($district->name,$label);
+                if($post)$this->assertStringContainsString($post->name,$label);
+            }
+        }
+    }
+}
@@ -0,0 +1,29 @@
+<?php
+
+namespace Tests\Feature;
+
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Inertia\Testing\AssertableInertia as Assert;
+use Tests\TestCase;
+
+final class FiscalFormEntryTest extends TestCase
+{
+    use DatabaseTransactions;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        \Tests\Support\ProactiveInvestmentFixture::guard();
+        $this->withoutVite();
+    }
+
+    public function test_both_fiscal_forms_are_public_and_do_not_redirect_to_legal_documents(): void
+    {
+        config(['portal.homologation_only' => false]);
+        foreach (['iva', 'irpc'] as $tax) {
+            $this->get('/formularios/fiscais?imposto='.$tax)
+                ->assertOk()
+                ->assertInertia(fn (Assert $page) => $page->component('portal/fiscal-forms')->where('initialTax', $tax));
+        }
+    }
+}
@@ -0,0 +1,57 @@
+<?php
+namespace Tests\Feature;
+use App\Models\User;
+use App\Services\InvestmentGeography;
+use App\Services\InvestmentZones;
+use Illuminate\Foundation\Testing\DatabaseTransactions;
+use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Str;
+use Tests\TestCase;
+
+final class InvestorUsabilityScopeTest extends TestCase
+{
+    use DatabaseTransactions;
+    protected function setUp():void{parent::setUp();\Tests\Support\ProactiveInvestmentFixture::guard();$this->withoutVite();}
+
+    public function test_public_sector_is_consultable_by_guest_and_accounts_without_promoter_grants():void
+    {
+        config(['portal.homologation_only'=>false,'portal.legacy_content_enabled'=>false,'portal.legacy_content_qa_enabled'=>false]);
+        $this->get('/sectores/turismo')->assertOk();
+        $actor=User::factory()->create();
+        $this->actingAs($actor)->get('/sectores/turismo')->assertOk();
+        $this->assertSame(0,DB::table('portal_role_assignments')->where('user_id',$actor->id)->count());
+        config(['portal.profile_access_enabled'=>true]);
+        $entry=app(\App\Services\SectorInvestment::class)->publicView(\App\Models\Sector::where('slug','turismo')->firstOrFail());
+        $this->assertSame('/perfil/promotor',$entry['register_href']);
+        $this->assertSame('Pedir acesso para cadastrar oportunidades',$entry['register_label']);
+    }
+
+    public function test_zones_all_equals_visible_set_and_province_and_district_never_fall_back_to_all():void
+    {
+        $zones=app(InvestmentZones::class);$geo=app(InvestmentGeography::class);
+        $province='059b02ca-7095-577a-8705-4d4c46896747';
+        $district=$geo->publicReferences()->where('parent_id',$province)->where('location_type','district')->first();
+        $template=$zones->visible()->firstOrFail();
+        $make=function($territory,$published=true)use($template){$zone=$template->replicate();$zone->id=(string)Str::uuid();$zone->code='SYNTHETIC-'.Str::random(12);$zone->name='SYNTHETIC QA zone scope';$zone->primary_territory_id=$territory;$zone->publication_status=$published?'published':'draft';$zone->save();return$zone;};
+        $inside=$make($district->id);$outside=$make('9e42dac8-fd9b-523f-bf59-71a7d3aa0fb8');$private=$make($district->id,false);
+        $all=$zones->search([])->orderBy('id')->pluck('id')->all();
+        $this->assertSame($zones->visible()->orderBy('id')->pluck('id')->all(),$all);
+        foreach([['province_id'=>$province],['province_id'=>$province,'district_id'=>$district->id]]as$selection){
+            $ids=$zones->search($selection)->pluck('id')->all();
+            $this->assertContains($inside->id,$ids);$this->assertNotContains($outside->id,$ids);$this->assertNotContains($private->id,$ids);
+        }
+    }
+
+    public function test_documented_legal_scope_covers_child_area_but_influence_does_not_become_an_installation():void
+    {
+        $zones=app(InvestmentZones::class);$geo=app(InvestmentGeography::class);$province='059b02ca-7095-577a-8705-4d4c46896747';
+        $district=$geo->publicReferences()->where('parent_id',$province)->where('location_type','district')->first();
+        $editor=User::factory()->create();$reviewer=User::factory()->create();$template=$zones->visible()->firstOrFail();$ids=[];
+        foreach(['legal_scope','influence']as$scope){
+            $zone=$template->replicate();$zone->id=(string)Str::uuid();$zone->code='SYNTHETIC-'.Str::random(12);$zone->name='SYNTHETIC QA legal coverage';$zone->primary_territory_id='9e42dac8-fd9b-523f-bf59-71a7d3aa0fb8';$zone->save();$ids[$scope]=$zone->id;
+            DB::table('investment_zone_locations')->insert(['id'=>(string)Str::uuid(),'zone_id'=>$zone->id,'geo_location_id'=>$scope==='legal_scope'?$province:$district->id,'scope_type'=>$scope,'source_reference'=>'SYNTHETIC isolated QA scope fixture','validation_status'=>'validated','editor_id'=>$editor->id,'reviewer_id'=>$reviewer->id,'valid_from'=>now()->subDay(),'version_no'=>1,'created_at'=>now(),'updated_at'=>now()]);
+        }
+        $matches=$zones->search(['province_id'=>$province,'district_id'=>$district->id])->pluck('id')->all();
+        $this->assertContains($ids['legal_scope'],$matches);$this->assertNotContains($ids['influence'],$matches);
+    }
+}
@@ -24,6 +24,10 @@ class OpportunityCorridorExplorerTest extends TestCase
        $catalogue->shouldReceive('query')->with($filters)->once()->andReturn($query);
        $catalogue->shouldReceive('context')->with(101)->once()->andReturn(['corridors' => collect([(object)['id'=>'a','name'=>'Corredor A'],(object)['id'=>'b','name'=>'Corredor B']])]);
        $catalogue->shouldReceive('context')->with(102)->once()->andReturn(['corridors'=>collect()]);
+        $first->setAttribute('territorial_summary','Sofala / Dondo');
+        $other->setAttribute('territorial_summary','Localização não indicada');
+        $catalogue->shouldReceive('presentLocation')->with($first)->once()->andReturn($first);
+        $catalogue->shouldReceive('presentLocation')->with($other)->once()->andReturn($other);
        $this->app->instance(InvestmentCatalogue::class, $catalogue);
        $groups = app(OpportunityCorridorExplorer::class)->groups($filters);
        $this->assertSame(['Corredor A','Corredor B','Outras localizações'], array_column($groups,'name'));
@@ -32,5 +36,6 @@ class OpportunityCorridorExplorerTest extends TestCase
        $this->assertSame(['Sofala / Dondo'], $groups[0]['locations']);
        $this->assertSame([], $groups[2]['locations']);
        $this->assertSame([], $groups[0]['opportunities'][0]['stages']);
+        $this->assertSame('Sofala / Dondo',$groups[0]['opportunities'][0]['territorial_summary']);
    }
 }
@@ -0,0 +1,22 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import fs from 'node:fs';
+import {createRequire} from 'node:module';
+import React from 'react';
+import {renderToStaticMarkup} from 'react-dom/server';
+import ts from 'typescript';
+const require=createRequire(import.meta.url);
+const source=fs.readFileSync(new URL('../../resources/js/components/catalogue-guide-links.tsx',import.meta.url),'utf8');
+const compiled=ts.transpileModule(source,{compilerOptions:{module:ts.ModuleKind.CommonJS,target:ts.ScriptTarget.ES2022,jsx:ts.JsxEmit.ReactJSX}}).outputText;
+const module={exports:{}};
+new Function('require','module','exports',compiled)(name=>name==='@inertiajs/react'?{Link:({href,children,...props})=>React.createElement('a',{href,...props},children)}:require(name),module,module.exports);
+const render=articles=>renderToStaticMarkup(React.createElement(module.exports.default,{articles}));
+test('catalogue guides are closed optional links, not educational bodies or nationwide opportunity shortcuts',()=>{
+    const html=render([{title:'Turismo',href:'/artigos/turismo',summary:'EDUCATIONAL-BODY-NOT-A-RESULT',image:{href:'/photo.jpg',alt:'ILLUSTRATION'},opportunities_href:'/oportunidades?sector=turismo',opportunities_label:'ALL-NATIONAL-OPPORTUNITIES',has_opportunities:true}]);
+    assert.match(html,/<details\b/);assert.doesNotMatch(html,/<details[^>]*\bopen\b/);
+    assert.match(html,/apoio opcional/);assert.match(html,/href="\/artigos\/turismo"/);
+    for(const forbidden of ['EDUCATIONAL-BODY-NOT-A-RESULT','ALL-NATIONAL-OPPORTUNITIES','/oportunidades?sector=turismo','photo.jpg','<img'])assert.ok(!html.includes(forbidden),forbidden);
+});
+test('no educational substitute is rendered when no guides are available',()=>{
+    assert.equal(render([]),'');
+});
@@ -0,0 +1,101 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import {
+    assessmentReady,
+    diagnosticReady,
+    forces,
+    newCompetitivenessDraft,
+    readCompetitivenessDraft,
+} from '../../resources/js/lib/cluster-competitiveness.ts';
+
+function complete() {
+    const draft = newCompetitivenessDraft('cluster-a', 'Energia');
+    draft.region = 'Distrito de demonstração';
+    for (const force of forces)
+        Object.assign(draft.forces[force], {
+            pressure: 'medium',
+            evidence: 'Observação de demonstração',
+            source: 'Fonte de demonstração, p. 2',
+            period: '2025',
+            rationale: 'Pressão fundamentada na observação',
+            limitations: 'Amostra parcial',
+            opportunity: 'Investigar capacidade de armazenamento',
+        });
+    return draft;
+}
+
+test('ausência de dados permanece indeterminada nas cinco forças independentes', () => {
+    const draft = newCompetitivenessDraft('cluster-a', 'Energia');
+    assert.equal(forces.length, 5);
+    assert.equal(diagnosticReady(draft), false);
+    draft.forces.buyers.evidence = 'Observação';
+    assert.equal(draft.forces.suppliers.evidence, '');
+    assert.ok(forces.every((force) => draft.forces[force].pressure === ''));
+});
+
+test('classificação exige todos os fundamentos; âmbito é necessário para o diagnóstico', () => {
+    const draft = complete();
+    assert.equal(diagnosticReady(draft), true);
+    for (const field of [
+        'evidence',
+        'source',
+        'period',
+        'rationale',
+        'limitations',
+        'opportunity',
+    ]) {
+        const row = { ...draft.forces.buyers, [field]: '  ' };
+        assert.equal(assessmentReady(row), false, field);
+    }
+    draft.region = '';
+    assert.equal(diagnosticReady(draft), false);
+});
+
+test('ficheiro conserva rascunhos, dados e incertezas sem modificar o original', () => {
+    const draft = complete();
+    draft.forces.entrants.pressure = '';
+    const restored = readCompetitivenessDraft(
+        JSON.stringify(draft),
+        'cluster-a',
+    );
+    assert.deepEqual(restored, draft);
+    restored.forces.buyers.source = 'Outra fonte';
+    assert.notEqual(restored.forces.buyers.source, draft.forces.buyers.source);
+    assert.equal(diagnosticReady(restored), false);
+});
+
+test('recuperação rejeita outro cluster, versões, forças ausentes e campos inválidos', () => {
+    assert.throws(() =>
+        readCompetitivenessDraft(JSON.stringify(complete()), 'cluster-b'),
+    );
+    for (const mutate of [
+        (d) => {
+            d.version = 2;
+        },
+        (d) => {
+            delete d.forces.buyers;
+        },
+        (d) => {
+            d.forces.buyers.pressure = 'zero';
+        },
+        (d) => {
+            d.forces.buyers.source = 42;
+        },
+        (d) => {
+            d.forces.buyers.source = 'x'.repeat(5001);
+        },
+        (d) => {
+            d.region = null;
+        },
+    ]) {
+        const draft = complete();
+        mutate(draft);
+        assert.throws(() =>
+            readCompetitivenessDraft(JSON.stringify(draft), 'cluster-a'),
+        );
+    }
+    assert.throws(() => readCompetitivenessDraft('null', 'cluster-a'));
+    assert.throws(() =>
+        readCompetitivenessDraft('x'.repeat(250001), 'cluster-a'),
+    );
+});
@@ -0,0 +1,34 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'node:fs';
+import {createRequire} from 'node:module';
+import React from 'react';
+import {renderToStaticMarkup} from 'react-dom/server';
+import ts from 'typescript';
+import * as forms from '../../resources/js/lib/fiscal-form-preparation.ts';
+const require=createRequire(import.meta.url);
+const source=fs.readFileSync(new URL('../../resources/js/pages/portal/fiscal-forms.tsx',import.meta.url),'utf8');
+const compiled=ts.transpileModule(source,{compilerOptions:{module:ts.ModuleKind.CommonJS,target:ts.ScriptTarget.ES2022,jsx:ts.JsxEmit.ReactJSX}}).outputText;
+const module={exports:{}};
+new Function('require','module','exports',compiled)(name=>name==='@inertiajs/react'?{Head:()=>null,Link:({href,children,...props})=>React.createElement('a',{href,...props},children),router:{on:()=>()=>{}}}:name==='@/layouts/portal-navigation'?{PortalMenu:()=>null}:name==='@/lib/fiscal-form-preparation'?forms:require(name),module,module.exports);
+test('fiscal entry renders labelled editable fields and a guided preparation rather than legislation',()=>{
+    const html=renderToStaticMarkup(React.createElement(module.exports.default));
+    for(const label of ['Identificação e período','Nome ou designação social','NUIT','Período — ano e mês','Conferir e guardar','Guardar ficheiro para continuar','Recuperar ficheiro guardado','Confirmar recuperação']) {
+        // Confirmation appears only after a compatible file is selected.
+        if(label !== 'Confirmar recuperação') assert.ok(html.includes(label),label);
+    }
+    assert.equal((html.match(/inputMode="decimal"/g)??[]).length,27);
+    assert.match(html,/sem submissão à Autoridade Tributária/);
+    assert.match(html,/Não há gravação automática/);
+    assert.doesNotMatch(html,/value="0"/);
+});
+test('IRPC entry opens the requested form directly and keeps its partial coverage explicit',()=>{
+    const html=renderToStaticMarkup(React.createElement(module.exports.default,{initialTax:'irpc'}));
+    assert.match(html,/IRPC — Modelo 22/);
+    assert.match(html,/L8 permanece parcial/);
+    assert.match(html,/303 — Dupla tributação económica/);
+    assert.match(html,/304 — Dupla tributação internacional/);
+    assert.match(html,/Não utilize a mesma parcela/);
+    assert.equal((html.match(/inputMode="decimal"/g)??[]).length,24);
+    assert.doesNotMatch(html,/01 — Base das operações/);
+});
@@ -0,0 +1,34 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import {newFiscalPreparation, readFiscalPreparation, fiscalPreparationIssues, fiscalFormFields} from '../../resources/js/lib/fiscal-form-preparation.ts';
+
+test('IVA and IRPC preparations round trip deliberate entries and unknown amounts without zero defaults', () => {
+    for (const kind of ['iva', 'irpc']) {
+        const p = newFiscalPreparation(kind);
+        p.name = 'Investidor de teste'; p.nuit = '123456789'; p.period = kind === 'iva' ? '2026-10' : '2026';
+        const [first, second] = fiscalFormFields(kind);
+        p.values[first.code] = '123456789012345678901234,01';
+        p.values[second.code] = '';
+        const restored = readFiscalPreparation(JSON.stringify(p));
+        assert.deepEqual(restored, p);
+        assert.deepEqual(fiscalPreparationIssues(restored), []);
+        assert.equal(restored.values[second.code], '');
+        assert.equal(Object.values(restored.values).includes('0'), false);
+    }
+});
+test('foreign editions, unknown fields and malformed or oversized files cannot replace preparation', () => {
+    const p = newFiscalPreparation('iva');
+    for (const v of [{...p, sourceHash: 'different'}, {...p, values: {'999': '1'}}, {...p, values: []}, {...p, nuit: 123}, {...p, version: 'later'}]) assert.throws(() => readFiscalPreparation(JSON.stringify(v)));
+    assert.throws(() => readFiscalPreparation('{broken'));
+    assert.throws(() => readFiscalPreparation('x'.repeat(100001)));
+    assert.equal(p.kind, 'iva'); assert.deepEqual(p.values, {});
+});
+test('invalid format is identified without rounding or discarding an incomplete preparation', () => {
+    const p = newFiscalPreparation('irpc');
+    p.values['303'] = '1.234'; p.values['304'] = '25,00';
+    const restored = readFiscalPreparation(JSON.stringify(p));
+    assert.equal(restored.values['303'], '1.234');
+    assert.ok(fiscalPreparationIssues(restored).some(i => i.startsWith('Campo 303:')));
+    assert.equal(fiscalFormFields('irpc').find(f => f.code === '303').label, 'Dupla tributação económica');
+    assert.equal(fiscalFormFields('irpc').find(f => f.code === '304').label, 'Dupla tributação internacional');
+});
@@ -0,0 +1,80 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import fs from 'node:fs';
+import {createRequire} from 'node:module';
+import React from 'react';
+import {renderToStaticMarkup} from 'react-dom/server';
+import ts from 'typescript';
+import * as flow from '../../resources/js/lib/opportunity-fill-flow.ts';
+import { fiscalPreparationGuide } from '../../resources/js/lib/fiscal-preparation-guide.ts';
+const require=createRequire(import.meta.url);
+function load(path,mocks={},exportName='default',extra=''){
+    const source=fs.readFileSync(new URL(path,import.meta.url),'utf8');
+    const output=ts.transpileModule(source,{compilerOptions:{module:ts.ModuleKind.CommonJS,target:ts.ScriptTarget.ES2022,jsx:ts.JsxEmit.ReactJSX}}).outputText;
+    const module={exports:{}};new Function('require','module','exports',output+extra)(name=>mocks[name]??(name.startsWith('@/')?{default:()=>null}:require(name)),module,module.exports);return module.exports[exportName];
+}
+function stateHooks(){const memory=[];let cursor=0;return{hooks:{...React,useState(initial){const i=cursor++;if(!(i in memory))memory[i]=typeof initial==='function'?initial():initial;return[memory[i],next=>memory[i]=typeof next==='function'?next(memory[i]):next];},useRef:()=>({current:null}),useEffect:()=>{}},reset:()=>cursor=0};}
+const flat=node=>!node||typeof node!=='object'?[]:[node,...React.Children.toArray(node.props?.children).flatMap(flat)];
+test('free navigation keeps every field mounted and reports resource work in the current group',()=>{
+    const state=stateHooks();const Component=load('../../resources/js/components/opportunity-fill-flow.tsx',{'react':state.hooks,'@/lib/opportunity-fill-flow':flow});
+    const groups=flow.opportunityFillGroups(['official_title','locations','documents']);const saved={official_title:'Deliberate user title',locations:['saved-site']};
+    const opened=[];let tree;
+    const render=()=>{state.reset();tree=Component({groups,errors:{},renderField:field=>React.createElement('input',{name:field,value:JSON.stringify(saved[field]??''),readOnly:true}),onOpenResources:group=>opened.push(group)});};
+    const priorWindow=globalThis.window,priorFrame=globalThis.requestAnimationFrame;
+    globalThis.window={history:{state:{existing:'inertia-state'},replaceState(state,_title,url){assert.deepEqual(state,{existing:'inertia-state'});this.url=url;}}};globalThis.requestAnimationFrame=callback=>callback();
+    try{
+        render();assert.equal(flat(tree).filter(node=>node.type==='input').length,3);
+        flat(tree).find(node=>node.type==='a'&&node.props.href==='#fill-territory').props.onClick({preventDefault(){}});render();
+        const sections=flat(tree).filter(node=>node.type==='section');
+        assert.equal(sections.find(node=>node.props.id==='fill-territory').props.hidden,false);
+        assert.equal(sections.find(node=>node.props.id==='fill-idea').props.hidden,true);
+        assert.equal(flat(tree).filter(node=>node.type==='input').length,3);
+        flat(tree).find(node=>node.type==='button').props.onClick();assert.deepEqual(opened,['territory']);
+        assert.equal(saved.official_title,'Deliberate user title');assert.deepEqual(saved.locations,['saved-site']);
+        assert.equal(globalThis.window.history.url,'#fill-territory');
+    }finally{globalThis.window=priorWindow;globalThis.requestAnimationFrame=priorFrame;}
+});
+test('profile request renders readable labels without dumping every available document into the form',()=>{
+    const Picker=load('../../resources/js/components/profile-proof-picker.tsx');
+    const Page=load('../../resources/js/pages/profiles/request.tsx',{
+        '@/lib/operation-key':{createOperationKey:()=> 'synthetic-key'},
+        '@inertiajs/react':{Head:()=>null,Link:({href,children})=>React.createElement('a',{href},children),router:{}},
+        '@/components/profile-navigation':{default:()=>null},'@/lib/profile-json':{},
+        '@/pages/management/shared':{button:'button',control:'control'},
+        '@/components/opportunity-search-filters':{modalityLabels:{investment_project:'Projecto de investimento',land_rights:'Direitos fundiários'}},
+        '@/components/profile-proof-picker':{default:Picker},
+    });
+    const html=renderToStaticMarkup(React.createElement(Page,{requests:[],types:['investment_project','land_rights'],organizations:[],documents:Array.from({length:80},(_,i)=>({id:`doc-${i}`,file_name:`UNSELECTED-DOCUMENT-${i}.txt`}))}));
+    assert.match(html,/Em nome próprio/);assert.match(html,/Entidade pública/);assert.match(html,/Projecto de investimento/);assert.match(html,/Direitos fundiários/);
+    assert.doesNotMatch(html,/UNSELECTED-DOCUMENT/);assert.match(html,/Pesquisar nos meus ficheiros/);
+    const visible=html.replace(/<[^>]+>/g,'');assert.doesNotMatch(visible,/investment_project|land_rights|public_entity/);
+});
+test('proof selection is explicit and retained when the filename search changes',()=>{
+    const state=stateHooks();const Component=load('../../resources/js/components/profile-proof-picker.tsx',{'react':state.hooks});
+    const documents=[{id:'identity',file_name:'Documento próprio'},{id:'law',file_name:'Lei.pdf'}];const values=[];let tree;
+    const render=()=>{state.reset();tree=Component({documents,value:values,onChange:ids=>{values.splice(0,values.length,...ids);}});};
+    render();assert.equal(flat(tree).filter(node=>node.type==='input'&&node.props.type==='checkbox').length,0);
+    flat(tree).find(node=>node.type==='input').props.onChange({target:{value:'próprio'}});render();
+    flat(tree).find(node=>node.type==='input'&&node.props.type==='checkbox').props.onChange();render();assert.deepEqual(values,['identity']);
+    flat(tree).find(node=>node.type==='input'&&node.props.type==='search').props.onChange({target:{value:'Lei'}});render();
+    assert.deepEqual(values,['identity']);assert.equal(flat(tree).filter(node=>node.type==='input'&&node.props.type==='checkbox')[0].props.checked,false);
+});
+test('document entry leads to existing fillable preparation and keeps sources optional',()=>{
+    const context='10000000-0000-4000-8000-000000000001';
+    const inertia={Link:({href,children})=>React.createElement('a',{href},children),usePage:()=>({url:`/documentos?context=${context}`})};
+    const Hub=load('../../resources/js/components/journey-document-resources.tsx',{'@inertiajs/react':inertia,'@/lib/fiscal-preparation-guide':{fiscalPreparationGuide}},'JourneyDocumentResources');
+    const hub=renderToStaticMarkup(React.createElement(Hub,{}));
+    assert.match(hub,new RegExp(`/investimentos/${context}/contexto/editar#preparation-questions`));assert.match(hub,/href="\/terra-duat"/);
+    assert.match(hub,/Preparação digital e exemplar oficial/);assert.doesNotMatch(hub,/<details[^>]*\bopen\b/);
+    const Editor=load('../../resources/js/components/private-investment-preparation.tsx',{'@inertiajs/react':inertia,'@/pages/investment/shared':{card:'card',input:'input'}},'PreparationEditor');
+    const html=renderToStaticMarkup(React.createElement(Editor,{data:{questions:[{key:'investment_preparation',label:'Preparar pedido?',options:{yes:'Sim',no:'Não'},source:'SYNTHETIC QA'},{key:'declared_amount',label:'Valor do investimento',type:'number',source:'SYNTHETIC QA'}],requirements:[],enabled:true,mode:'authorization',missing_fields:['declared_amount']},fields:{investment_preparation:'yes'},changes:{},documents:[],links:{},onChange(){},onLink(){},disabled:false}));
+    assert.match(html,/<input/);assert.match(html,/Valor do investimento/);assert.match(html,/id="preparation-questions"/);
+});
+test('investment stages expose readable next actions while internal codes and sources remain consultable',()=>{
+    const useForm=data=>({data,errors:{},processing:false,setData(){},transform(){return this;},post(){}});
+    const Stage=load('../../resources/js/pages/investor-path/show.tsx',{'@inertiajs/react':{useForm,Link:({href,children})=>React.createElement('a',{href},children)},'@/lib/investor-path':{pathStates:{not_started:'Por iniciar'}}},'Stage','\nmodule.exports.Stage=Stage;');
+    const step={code:'S01',title:'Sistematizar a ideia',state:'not_started',detail:{scope:'promoter_preparation'},preparation_allowed:true,action_gaps:{},source_paragraph:22,applicability:'applicable'};
+    const html=renderToStaticMarkup(React.createElement(Stage,{step,path:{case:{id:'synthetic',version:1},next:{code:'S01'},canWrite:true,canReview:false,steps:[step],documents:[]}}));
+    assert.match(html,/<details[^>]*id="S01"[^>]*open/);assert.match(html,/<summary[^>]*>Sistematizar a ideia/);
+    assert.doesNotMatch(html,/<summary[^>]*>S01/);assert.match(html,/Fonte e referência desta etapa/);
+});
@@ -0,0 +1,54 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import fs from 'node:fs';
+import {createRequire} from 'node:module';
+import React from 'react';
+import {renderToStaticMarkup} from 'react-dom/server';
+import ts from 'typescript';
+import {portalNavigation,currentNavigationItem} from '../../resources/js/lib/portal-navigation.ts';
+import {searchTerritoryHref} from '../../resources/js/lib/search-territory.ts';
+
+// Shallow SSR of the actual navigation component. Inertia and visual primitives
+// are replaced by semantic wrappers; this is not a browser/viewport proof.
+const require=createRequire(import.meta.url);
+const source=fs.readFileSync(new URL('../../resources/js/components/portal-sidebar-navigation.tsx',import.meta.url),'utf8');
+const output=ts.transpileModule(source,{compilerOptions:{module:ts.ModuleKind.CommonJS,target:ts.ScriptTarget.ES2022,jsx:ts.JsxEmit.ReactJSX}}).outputText;
+const primitive=(tag)=>({children,asChild,...props})=>asChild?React.cloneElement(children,{}):React.createElement(tag,props,children);
+const module={exports:{}};
+new Function('require','module','exports',output)((name)=>{
+    if(name==='@inertiajs/react')return {Link:({href,children,...props})=>React.createElement('a',{href,...props},children)};
+    if(name==='@/lib/portal-navigation')return {currentNavigationItem};
+    if(name==='@/lib/search-territory')return {searchTerritoryHref};
+    if(name==='lucide-react')return {LayoutGrid:()=>null};
+    if(name==='@/components/ui/sidebar')return {SidebarGroup:primitive('section'),SidebarGroupLabel:primitive('h2'),SidebarMenu:primitive('ul'),SidebarMenuButton:primitive('div'),SidebarMenuItem:primitive('li')};
+    return require(name);
+},module,module.exports);
+const Component=module.exports.PortalSidebarNavigation;
+const flatten=(rows)=>rows.flatMap(r=>[...(r.href?[r.href]:[]),...flatten(r.children??[])]);
+const render=(access,url='/')=>{const groups=portalNavigation(access);return {groups,html:renderToStaticMarkup(React.createElement(Component,{groups,url}))};};
+void test('sidebar renders every nested authorised destination instead of a first-child shortcut',()=>{
+    const {groups,html}=render({authenticated:true,manager:true,businesses:true,education:true,ai:true,contentManagementHref:'/gestao-conteudos',contentManagementAccess:{opportunities:{index:'/management/opportunities',create:'/management/opportunities/create'}},scopedAdministration:[{label:'Referências económicas',href:'/management/economic-references/lot-01'}]});
+    const hrefs=[...html.matchAll(/<a\b[^>]*href="([^"]+)"/g)].map(m=>m[1].replaceAll('&amp;','&'));
+    assert.deepEqual([...hrefs].sort(),flatten(groups).sort());
+    assert.equal(hrefs[0],'/gestao-conteudos');
+    for(const href of ['/carteira','/zonas','/documentos','/legislacao','/management/opportunities','/management/economic-references/lot-01'])assert.ok(hrefs.includes(href),href);
+    assert.match(html,/Área de trabalho/);
+});
+void test('nested current destination is selected without changing its URL or replacing it with a group root',()=>{
+    const {html}=render({authenticated:true,manager:false},'/zonas?category=zee');
+    const current=[...html.matchAll(/<a\b([^>]*aria-current="page"[^>]*)>/g)];
+    assert.equal(current.length,1);
+    assert.match(current[0][1],/href="\/zonas"/);
+});
+void test('rendered visitor sidebar explains access without private operation links',()=>{
+    const {html}=render({authenticated:false,manager:false});
+    assert.match(html,/href="\/acesso-gestao"/);
+    assert.doesNotMatch(html,/href="\/management\//);
+    assert.doesNotMatch(html,/analysis=proactive/);
+});
+void test('sidebar carries the existing search territory when moving between catalogues',()=>{
+    const {html}=render({authenticated:false,manager:false},'/oportunidades?province_id=QA-province&district_id=QA-district');
+    assert.match(html,/href="\/carteira\?province_id=QA-province&amp;district_id=QA-district"/);
+    assert.match(html,/href="\/zonas\?province_id=QA-province&amp;district_id=QA-district"/);
+    assert.match(html,/href="\/acesso-gestao"/);
+});
@@ -0,0 +1,35 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import {opportunityFillGroups,opportunityErrorGroup,opportunityMissingGroups} from '../../resources/js/lib/opportunity-fill-flow.ts';
+import {territorialSearchParams} from '../../resources/js/lib/territorial-search-params.ts';
+import {documentFacetLabel} from '../../resources/js/lib/document-facet-label.ts';
+
+test('adaptive groups keep every applicable schema field once, including new specialized fields',()=>{
+    const keys=['official_title','locations','sector_id','documents','currency','real_estate','future_schema_field','currency'];
+    const groups=opportunityFillGroups(keys);
+    assert.deepEqual(groups.flatMap(group=>group.fields).sort(),[...new Set(keys)].sort());
+    assert.ok(groups.find(group=>group.id==='specific').fields.includes('future_schema_field'));
+    assert.deepEqual(opportunityFillGroups(['official_title']).map(group=>group.id),['idea']);
+    assert.deepEqual(opportunityFillGroups([]),[]);
+});
+test('saved pending fields and validation errors point to the correct existing group without inventing applicability',()=>{
+    const groups=opportunityFillGroups(['official_title','locations','total_investment']);
+    assert.equal(opportunityErrorGroup(groups,{'canonical.total_investment':'Valor em falta'}),'finance');
+    assert.equal(opportunityErrorGroup(groups,{'canonical.locations.0':'Local em falta'}),'territory');
+    assert.deepEqual(opportunityMissingGroups(groups,['locations.0','canonical.total_investment']).map(group=>group.id),['territory','finance']);
+    assert.equal(opportunityErrorGroup(groups,{reason:'Motivo em falta'}),undefined);
+});
+test('territorial search replaces old descendants while retaining all selected non-territorial filters',()=>{
+    const entries=[['province_id','old'],['district_id','old-child'],['locality_id','old-leaf'],['category','zee'],['q','Nacala'],['page','5']];
+    const scoped=territorialSearchParams(entries,[{id:'new',location_type:'province'}]);
+    assert.equal(scoped.get('province_id'),'new');assert.equal(scoped.has('district_id'),false);assert.equal(scoped.has('locality_id'),false);
+    assert.equal(scoped.get('category'),'zee');assert.equal(scoped.get('q'),'Nacala');assert.equal(scoped.has('page'),false);
+    const all=territorialSearchParams(entries,[]);assert.equal(all.has('province_id'),false);assert.equal(all.get('category'),'zee');
+    const unchanged=territorialSearchParams(entries);assert.equal(unchanged.get('district_id'),'old-child');
+});
+test('document facets have readable labels while original query identifiers remain unchanged',()=>{
+    const original=['agronegocio','education','media','pt','turismo'];
+    assert.deepEqual(original.map(documentFacetLabel),['Agronegócio','Formação e competências','Imagens e conteúdos de apoio','Português','Turismo']);
+    assert.deepEqual(original,['agronegocio','education','media','pt','turismo']);
+    assert.equal(documentFacetLabel('Tema definido pela Tempo'),'Tema definido pela Tempo');
+});
@@ -9,6 +9,7 @@ import {
    legacyPortalNavigation,
    currentNavigationGroup,
    currentNavigationItem,
+    canShowLegacyManagement,
 } from '../../resources/js/lib/portal-navigation.ts';

 void test('public and authenticated navigation share groups without revealing management', () => {
@@ -20,7 +21,7 @@ void test('public and authenticated navigation share groups without revealing ma
    assert.deepEqual(publicGroups.slice(0, 3), investor.slice(0, 3));
    assert.deepEqual(
        publicGroups.map((g) => g.id),
-        ['discovery', 'realization', 'support', 'account'],
+        ['discovery', 'realization', 'support', 'work', 'account'],
    );
    const hrefs = JSON.stringify(investor);
    assert.equal(hrefs.includes('/management/'), false);
@@ -37,7 +38,7 @@ void test('management and optional modules follow permissions and feature flags'
        education: true,
        ai: true,
    });
-    assert.ok(groups.some((group) => group.id === 'management'));
+    assert.ok(groups.some((group) => group.id === 'work'));
    assert.equal(JSON.stringify(groups).includes('/investidor/negocios'), true);
    assert.equal(JSON.stringify(groups).includes('/management/ai'), true);
    assert.equal(
@@ -151,3 +152,47 @@ void test('catalogue detail and return preserve the search inside the local cata
        '/zonas?https%3A%2F%2Foutside.invalid=',
    );
 });
+
+const destinations=(items)=>items.flatMap(item=>[...(item.href?[item.href]:[]),...destinations(item.children??[])]);
+void test('both menu consumers respect the existing scoped server decision rather than generic manager status',()=>{
+    assert.equal(canShowLegacyManagement({user:{id:1},canManagePortal:true,legacyManagementAccess:false}),false);
+    assert.equal(canShowLegacyManagement({user:{id:1},canManagePortal:true,legacyManagementAccess:true}),true);
+    assert.equal(canShowLegacyManagement({user:null,canManagePortal:true,legacyManagementAccess:true}),false);
+    assert.equal(canShowLegacyManagement({user:{id:1},canManagePortal:true}),true);
+});
+void test('work entry is discoverable without exposing private capabilities to an anonymous visitor',()=>{
+    const groups=portalNavigation({authenticated:false,manager:true,contentManagementHref:'/gestao-conteudos',contentManagementAccess:{opportunities:{index:'/management/opportunities',create:'/management/opportunities/create'}},scopedAdministration:[{label:'Private QA administration',href:'/management/secret'}]});
+    assert.deepEqual(destinations(groups.find(g=>g.id==='work').children),['/acesso-gestao']);
+    assert.equal(JSON.stringify(groups).includes('/management/'),false);
+    assert.equal(JSON.stringify(groups).includes('/gestao-conteudos'),false);
+});
+void test('work area exposes existing content capability even when the old dashboard flag has no menu object',()=>{
+    const groups=portalNavigation({authenticated:true,manager:true,opportunityManagement:null,contentManagementHref:'/gestao-conteudos',contentManagementAccess:{opportunities:{index:'/management/opportunities',create:'/management/opportunities/create'}}});
+    const work=groups.find(g=>g.id==='work');
+    assert.equal(work.label,'Área de trabalho');
+    assert.ok(work.children.some(i=>i.label==='Preparar análise e ideia'&&i.href==='/management/opportunities/create?analysis=proactive'));
+    assert.ok(work.children.some(i=>i.href==='/gestao-conteudos'));
+    assert.ok(work.children.some(i=>i.href==='/management/opportunities'));
+});
+void test('every previously authorised management/profile destination survives the regrouping exactly once',()=>{
+    const access={authenticated:true,manager:true,businesses:true,education:true,ai:true,contentManagementHref:'/gestao-conteudos',profileAccess:{contexts:[],mine:'/minhas-oportunidades',create:'/minhas-oportunidades/create',request:'/perfil/promotor',review:null,audit:'/perfis/auditoria',administration:'/perfis/gestao'},scopedAdministration:[{label:'Referências económicas',href:'/management/economic-references/lot-01'}]};
+    const old=destinations(legacyPortalNavigation(access).filter(g=>['management','profile-opportunities'].includes(g.id)));
+    const groups=portalNavigation(access);const after=destinations(groups);
+    for(const href of old)assert.equal(after.filter(x=>x===href).length,1,href);
+    assert.equal(after.length,new Set(after).size);
+    assert.ok(destinations(groups.find(g=>g.id==='work').children).includes('/management/economic-references/lot-01'));
+    assert.equal(after.filter(href=>href==='/management/profile-install').length,1,'profile installation already present in the old authorised sidebar must survive');
+});
+void test('ordinary authenticated account has an explanation entry and does not acquire creation or management links',()=>{
+    const groups=portalNavigation({authenticated:true,manager:false});
+    assert.deepEqual(destinations(groups.find(g=>g.id==='work').children),['/acesso-gestao']);
+    assert.equal(JSON.stringify(groups).includes('analysis=proactive'),false);
+    assert.equal(JSON.stringify(groups).includes('/management/'),false);
+});
+void test('direct analysis and ordinary creation preserve distinct selection state in the same work group',()=>{
+    const access={authenticated:true,manager:false,profileAccess:{contexts:[],mine:'/minhas-oportunidades',create:'/minhas-oportunidades/create',request:'/perfil/promotor',review:null,administration:null}};
+    const groups=portalNavigation(access);
+    assert.equal(currentNavigationGroup(groups,'/minhas-oportunidades/create?analysis=proactive'),'work');
+    assert.equal(currentNavigationItem(groups,'/minhas-oportunidades/create?analysis=proactive'),'prepare-analysis');
+    assert.equal(currentNavigationItem(groups,'/minhas-oportunidades/create'),'new-my-opportunity');
+});
@@ -0,0 +1,56 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import fs from 'node:fs';
+import {createRequire} from 'node:module';
+import React from 'react';
+import ts from 'typescript';
+
+// Exercise the real component's event/state contract; this is not browser visual QA.
+const require=createRequire(import.meta.url);
+const source=fs.readFileSync(new URL('../../resources/js/components/territory-search-select.tsx',import.meta.url),'utf8');
+const compiled=ts.transpileModule(source,{compilerOptions:{module:ts.ModuleKind.CommonJS,target:ts.ScriptTarget.ES2022,jsx:ts.JsxEmit.ReactJSX}}).outputText;
+function harness(overrides={}){
+    const memory=[];let cursor=0;const chosen=[];
+    const hooks={...React,useState(initial){const i=cursor++;if(!(i in memory))memory[i]=initial;return[memory[i],value=>{memory[i]=typeof value==='function'?value(memory[i]):value;}];},useRef:()=>({current:null}),useEffect:()=>{}};
+    const module={exports:{}};
+    new Function('require','module','exports',compiled)(name=>name==='react'?hooks:require(name),module,module.exports);
+    const options=[{id:'province-a',name:'Nampula'},{id:'province-b',name:'Maputo Província'}];
+    const props={id:'territory',label:'Província',search:'',options,onSearch(query){props.search=query;},onChange(option){chosen.push(option);props.selected=option;},...overrides};
+    let tree;
+    const flat=node=>!node||typeof node!=='object'?[]:[node,...React.Children.toArray(node.props?.children).flatMap(flat)];
+    const render=()=>{cursor=0;tree=module.exports.default(props);return tree;};
+    const find=predicate=>flat(tree).find(predicate);
+    const input=()=>find(node=>node.type==='input');
+    const key=value=>input().props.onKeyDown({key:value,preventDefault(){}});
+    render();return{props,chosen,render,find,input,key,options};
+}
+test('one search input owns the dropdown; the separate select is absent',()=>{
+    const h=harness();assert.equal(h.find(node=>node.type==='select'),undefined);
+    assert.equal(h.input().props.role,'combobox');assert.equal(h.input().props['aria-expanded'],false);
+    h.input().props.onFocus();h.render();
+    assert.equal(h.input().props['aria-expanded'],true);
+    assert.ok(h.find(node=>node.props?.role==='listbox'));
+    h.find(node=>node.props?.role==='option'&&node.props.id==='territory-options-1').props.onClick();h.render();
+    assert.deepEqual(h.chosen,[h.options[1]]);assert.equal(h.input().props.value,'Maputo Província');
+    assert.equal(h.input().props['aria-expanded'],false);
+});
+test('typing and Escape preserve the existing selection until an option is explicitly chosen',()=>{
+    const selected={id:'saved',name:'Selecção guardada fora desta página'};const h=harness({selected});
+    h.input().props.onFocus();h.render();h.input().props.onChange({target:{value:'Map'}});h.render();
+    assert.equal(h.props.search,'Map');assert.deepEqual(h.chosen,[]);
+    h.key('Escape');h.render();assert.equal(h.input().props.value,selected.name);assert.deepEqual(h.chosen,[]);
+});
+test('arrow keys and Enter choose from the list; loading cannot commit an old result',()=>{
+    const h=harness();h.input().props.onFocus();h.render();h.key('ArrowDown');h.render();h.key('ArrowDown');h.render();
+    assert.equal(h.input().props['aria-activedescendant'],'territory-options-1');
+    h.key('Enter');h.render();assert.deepEqual(h.chosen,[h.options[1]]);
+    const busy=harness({loading:true});busy.input().props.onFocus();busy.render();busy.key('Enter');
+    assert.deepEqual(busy.chosen,[]);
+});
+test('clear is explicit; disabled dependent levels cannot expose the dropdown',()=>{
+    const h=harness({selected:{id:'saved',name:'Nampula'}});
+    h.find(node=>node.props?.['aria-label']==='Limpar Província').props.onClick();h.render();
+    assert.deepEqual(h.chosen,[undefined]);assert.equal(h.input().props.value,'');
+    const disabled=harness({disabled:true});assert.equal(disabled.input().props.disabled,true);
+    assert.equal(disabled.find(node=>node.props?.role==='listbox'),undefined);
+});
Author	SHA1	Message	Date
nala	3f7082a3e6	docs: record sequential competitiveness installation and preservation	2026-10-29 13:11:31 +02:00
nala	23ecccfaad	feat(clusters): prepare evidence-based five forces analysis tests / ci (push) Canceled after 0s Details	2026-10-29 13:03:02 +02:00
nala	332c16ebb5	feat: expose guided manual IVA and IRPC form preparation tests / ci (push) Canceled after 0s Details	2026-10-28 21:54:25 +02:00
nala	17444aaaa5	docs(investor): record served release and grouped preservation receipts	2026-10-28 21:43:46 +02:00
nala	789fffd098	fix(sector): use effective creation access and preserve corridor presentation contract tests / ci (push) Canceled after 0s Details	2026-10-28 21:35:21 +02:00
nala	502e3ec4d5	fix(investor): simplify preparation flow, profile requests and scoped zone search tests / ci (push) Canceled after 0s Details	2026-10-28 21:26:59 +02:00
nala	54d1b2a543	fix(catalogue): keep filtered investment results separate from educational guides	2026-10-28 21:04:10 +02:00
nala	6520d303f7	fix(territory): combine search and selection in one dropdown field	2026-10-28 21:00:30 +02:00
nala	47dae1b77e	docs(catalogue): register national verification in existing requirements	2026-10-28 20:54:48 +02:00
nala	2c8eb95e10	test(catalogue): verify provincial coverage nationally and across sectors	2026-10-28 20:54:30 +02:00
nala	1b2ede41e2	fix(catalogue): include approved provincial corridor coverage and show territorial detail	2026-10-28 20:49:30 +02:00
nala	d7a9284d5f	docs(navigation): record installed Git delivery and pending visual conference	2026-10-28 20:24:28 +02:00
nala	6e8de43ae7	fix(navigation): expose work area and preserve authorised menu destinations in QA tests / ci (push) Canceled after 0s Details	2026-10-28 20:08:54 +02:00