Files
Investidor-V2/outputs/investmoz-parques-mapa-20261016/prepare-map.py
T
nala cef6e201c7
tests / ci (push) Canceled after 0s
versao nrgocios 2
2026-10-16 20:11:05 +02:00

132 lines
24 KiB
Python
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
from pathlib import Path
import json,hashlib,datetime,collections
out=Path(__file__).resolve().parent;root=out.parents[1];review=out/'para-revisao';review.mkdir(exist_ok=True)
sha=lambda p:hashlib.sha256(p.read_bytes()).hexdigest();load=lambda n:json.loads((out/n).read_text('utf-8'))
state=load('CADASTRO-RESTAURADO.json');sources=load('FONTES-LEVANTADAS.json');inv=load('INVENTARIO-ACERVO.json')
baseline={p.relative_to(root).as_posix():sha(p)for folder in ['app','config','routes','database','resources','public/build']for p in(root/folder).rglob('*')if p.is_file()}
(out/'BASELINE-APLICACAO.json').write_text(json.dumps({'at':datetime.datetime.now(datetime.timezone.utc).isoformat(),'files':baseline,'protected':{n:sha(root/n)for n in ['.env','composer.lock','package-lock.json']},'matrix_before_sha256':sha(root/'docs/investmoz/v2/auditoria-portal/matriz-requisitos.csv')},indent=2)+'\n','utf-8')
parks=[z for z in state['zones']if z['category']=='industrial_park'];known=[z for z in state['zones']if z['code'].startswith('MOZ-')]
summary={'at':state['at'],'method':'Read-only inspection of isolated restored destination snapshot, not a fresh read of active database','snapshot_at':state['snapshot_at'],'target':state['target'],'counts':state['counts'],'zone_publication_counts':dict(collections.Counter(z['publication_status']for z in state['zones'])),'park_count':len(parks),'parks_published':sum(z['publication_status']=='published'for z in parks),'park_resources_populated':sum(bool(z['resources'])for z in parks),'park_activities_populated':sum(bool(z['activities'])for z in parks),'registered_operator_count':sum(z['operator_id']is not None for z in state['zones']),'data_as_of_populated':sum(z['data_as_of']is not None for z in state['zones']),'source_consultation_dates_populated':sum(z['sources_consulted_at']is not None for z in state['zones']),'known_source_records':[{k:z[k]for k in ['id','code','name','category','version_no','publication_status','development_status','availability_status']}for z in known],'additional_private_record':'One additional draft outside this proposed lot; its identity/details are not included in review attachments','active_database_connections':0,'active_changes':0}
(review/'CADASTRO-RESUMO.json').write_text(json.dumps(summary,ensure_ascii=False,indent=2)+'\n','utf-8')
manifest={'date':'2026-10-16','inventory_reused':inv['corpus_inventory_reused'],'current_attachments_count':len(inv['current_instruction_attachments']),'selected_sources':[{'name':Path(s['path']).name,'bytes':s['bytes'],'sha256':s['sha256'],'paragraphs':len(s.get('paragraphs',[])),'embedded_resources':s.get('embedded',[]),'type':'secondary/project instruction, not official provenance by itself'if s['suffix']=='.docx' else 'existing application reconciliation/seed/history','available':s['available']}for s in sources['sources']],'full_originals_and_inventory_in_package':False,'official_sources':'Existing accepted official references reused; pending database review flags do not revoke acceptance','normative_applicability_or_benefits_determined':False}
(review/'MANIFESTO-FONTES.json').write_text(json.dumps(manifest,ensure_ascii=False,indent=2)+'\n','utf-8')
files=[
('app/Http/Controllers/InvestmentZoneController.php','Reuse save/show/index/export; validate additive optional fields and sanitize public projection.'),
('app/Services/InvestmentZones.php','Keep UUID/version/snapshots/workflow; preserve supplemental fields in compatible old edits; reuse search.'),
('resources/js/pages/investment/zone.tsx','Structured areas/sources/resources, known/unknown labels, publication-state save notice and private-idea action.'),
('resources/js/pages/investment/zones.tsx','Readable state/unknown summaries in existing cards; preserve existing filters.'),
('app/Http/Controllers/InvestorPathController.php','Authenticated zone start/attach integrated into existing create/continue transaction.'),
('app/Services/InvestorPath.php','Owner/authorized-reader view of private zone context, without implying an opportunity relation.'),
('routes/investor-path.php','Named authenticated zone start/attach adapters; no menu change.'),
('resources/js/pages/investor-path/index.tsx','Choose create or existing dossier, with explicit zone context.'),
('resources/js/pages/investor-path/show.tsx','Recover selected zone UUID/version and support hand-off in the same dossier.'),
('app/Services/InvestmentZoneOperationalProfile.php','Proposed new adapter for optional facts over existing arrays; no new master/table.'),
('app/Services/InvestmentZonePathContext.php','Proposed new adapter over existing private case payload; explicit selection, idempotent attach.')]
(review/'FICHEIROS-PREVISTOS.json').write_text(json.dumps({'planning_only':True,'expected_sources':11,'substitutions':9,'new_sources':2,'schema_migrations_expected':0,'data_import_expected':0,'build_required':True,'build_count_not_yet_determined':True,'files':[{'path':p,'current_sha256':sha(root/p)if(root/p).is_file()else None,'purpose':purpose}for p,purpose in files],'no_active_delivery_authorized_by_this_plan':True},ensure_ascii=False,indent=2)+'\n','utf-8')
parkrows='\n'.join('| '+z['code']+' | '+str(z['version_no'])+' | '+z['publication_status']+' | '+z['development_status']+' | '+z['availability_status']+' |'for z in parks)
doc=f'''# Parques industriais levantamento e recorte mínimo QA
**Recomendação: completar a ficha existente por um incremento delimitado, sem criar outro cadastro.** A preparação atual é documental e de leitura. Não implementa funcionalidades, não altera dados ativos e não repete aceitações encerradas. O lote económico mantém o fecho reportado, a divergência 600/579 aberta e a cadeia editorial; a conferência independente dos seus anexos pelo utilizador não é presumida.
## Base observada e reutilização
Leitura em transação READ ONLY de `{state['target']['database']}:55441`, clone restaurado do destino com fotografia registada em **16/10/2026 às 12:50 CAT**. A conferência final da entrega económica demonstrou que os dados anteriores de parques foram preservados. Este levantamento não abre nova ligação à base ativa nem equivale a observação visual atual.
Existem **17 zonas: sete parques, cinco ZEE e cinco ZFI; oito registos publicados e nove rascunhos**. Um rascunho adicional fora dos 16 códigos MOZ conhecidos fica fora do lote e da listagem de anexos. São 19 associações territoriais, 36 revisões, seis referências jurídicas, e **zero** anexos de zonas, relações a investimentos/âncoras, geometrias próprias ou manifestações com origem em zona. Estes zeros são contagens da base, não ausência real de instalações ou serviços.
| Parque existente | Versão | Editorial | Desenvolvimento guardado | Disponibilidade guardada |
|---|---|---|---|---|
{parkrows}
O mestre `investment_zones` já tem UUID/código, nome/aliases PT/EN, categoria física separada de regime jurídico, operador FK, fonte jurídica FK, território principal/versão e múltiplas localizações. Mantém ainda `operational_status`, `development_status`, `availability_status`, áreas por âmbito, atividades, recursos, fontes, datas, parent_zone_id, versão editorial e snapshots cifrados append-only. Não há necessidade de reinstalar as migrations existentes ou criar outro mestre.
Reutilizar `/zonas`, `/zonas/{{UUID}}`, `/management/investment/zones/{{UUID}}`, APIs v2 de zonas, anexos/GIS/relações e exportação; `organizations`, `geo_locations`, `documents`, oportunidades, clusters/corredores/projectos, percurso das cinco fases/19 etapas, dossier e apoio existentes. Parque, ZFI e ZEE permanecem registos distintos; estar perto ou dentro de uma zona não atribui regime ao investimento.
## Dados e campos em falta
| Informação | Já existe | Falta ou permanece desconhecido |
|---|---|---|
| Identidade, localização e estados | Sete parques com UUID/código e território existente | Não criar distrito/localidade/parcela por nome aproximado; Topuito conserva apenas Nampula neste cadastro. Regimes não confirmados continuam pendentes. |
| Governação | operator_id e organizações reutilizáveis | Nenhum operador está associado nos 17 registos. Proprietário, promotor e gestor em papéis distintos/modelo de gestão não têm campos próprios. Não equiparar MozParks automaticamente ao operador/proprietário. |
| Áreas | area_components já distingue total/legal/desenvolvida/piloto/disponível, fonte/data/estado | Topuito 215/200 ha e 30 ha desenvolvidos são alegações com âmbitos/versões; Beluluane 700/780/600/180/55 ha; Munhava 900/990/50 ha. Não escolher, somar ou converter em área livre. Formulário exige JSON e a ficha pública imprime JSON bruto. |
| Atividades e referências económicas | Arrays e seletor de estado; CAE já instalado, relações existentes | Nenhum dos sete parques tem atividades preenchidas. Foco promocional/instalado e correspondência CAE por evidência não estão distinguidos no contrato atual. O ramo 01120 não se aplica automaticamente a um parque ou às suas empresas. |
| Infraestruturas, serviços e acessos | resources aceita nome/estado/fonte | Vazio nos sete parques. Faltam data, dentro do parque versus proximidade regional, tipo de recurso/serviço, capacidades e unidades. Vazio hoje oculta a secção, em vez de dizer não informado. |
| Lotes, ocupação e fases detalhadas | Áreas/estado global e geometrias/relações existentes | Não há cadastro de lotes, contagens/ocupação/reservas comprovadas, fases versionadas ou capacidade livre verificada. Permanecem lacunas; não derivar da área total. |
| Tarifas, condições de acesso e contratos | Texto descritivo/anexos podem ser reutilizados | Não há modelo estruturado ou valores confirmados. Não inventar renda, venda, prazo, custo ou modalidade. |
| Geometria | Relações GIS/revisão/publicação existem | Nenhuma geometria própria gravada. Mostrar ausência de perímetro; não desenhar coordenadas por centroide/nome nem calcular elegibilidade ou área. |
| Fontes, datas e anexos | 16/17 registos têm source_evidence e data de consulta | data_as_of está vazio em todos; datas dos exemplares nas áreas dos parques não indicadas. Zero anexos ligados; direitos/scan/publicação de ficheiros não são presumidos. |
| Empresas, emprego, produção, riscos e revisões futuras | Entidades/CRM/histórico de versões reutilizáveis | Sem séries/valores operacionais documentados nesta leitura; sem modelo integral de ocupantes, indicadores, risco operacional ou próxima revisão. Sem pontuação, elegibilidade ou ranking neste recorte. |
| Âncoras, clusters e oportunidades | Relações tipadas e validação existentes | Zero relações de zonas gravadas; mostrar sem relações publicadas. Não associar por semelhança de nomes nem gerar anúncio a partir de potencial. |
| Continuidade privada e apoio | Manifestações por zona já preservam UUID/versão/intenção; percurso/dossier existentes | A ficha não oferece iniciar/continuar ideia pelo percurso integrado; “Solicitar dossier” é manifestação assistida e não equivale a criar/recuperar o dossier das 19 etapas. |
**Divergência concreta do cadastro:** Munhava está em rascunho v2 com `operational_status=operational` e `availability_status=confirmed`, mas a fonte registada sustenta existência/localização/desenvolvimento e a área piloto não comprova disponibilidade. É uma declaração guardada sem fundamento correspondente no acervo inspecionado, não uma nova falha funcional demonstrada. Preservar e sinalizar para revisão do responsável; não corrigir ou publicar silenciosamente.
## Acervo e alcance das fontes
Reutilizado o inventário integral existente de **10 717 ficheiros**, com data/hash, antes da seleção, e inventariados os 60 anexos de instruções atuais. Não se afirma novo varrimento integral do acervo. Dez exemplares foram localizados/lidos e identificados por bytes/hash, incluindo quatro DOCX de parques, o documento de evolução `d0c06a75…` (ficha nos parágrafos 3542–3654 e campos adicionais no 4456), a especificação v6 e quatro reconciliações/seeds locais. Todos os recursos embutidos desses DOCX foram inventariados. Os originais e o inventário integral ficam privados; MANIFESTO-FONTES.json entrega a rastreabilidade delimitada.
A instrução de integração `640cedda…` tem 108 parágrafos e já pede estado/fonte/data, âmbito físico/regime, desconhecidos, recursos versus proximidade, oportunidades distintas e continuidade. Os dois exemplares de integração têm hashes diferentes e são preservados separadamente. O DOCX de parques é compilação secundária; não herda natureza oficial por citar diplomas.
Reutilizar as referências APIEX, Imprensa Nacional, MozParks e SDUBeira já registadas e a reconciliação de 04/10, identificando o que cada uma sustenta. As fontes oficiais aceites **não exigem nova validação de proveniência**. As seis referências jurídicas guardadas estão tecnicamente pending; isso não as torna fontes inválidas. O âmbito/período/efeito jurídico e o texto integral aplicável são questões distintas, não determinadas por este levantamento.
Não foi localizada nesta seleção uma correspondência inequívoca para o exemplar integral do Decreto 12/2026 ou um ficheiro jurídico ligado a Topuito; há citações/URLs históricas. Não concluir indisponibilidade em todo o acervo. A leitura integral, efeitos transitórios/benefícios e eventuais lacunas documentais mantêm tratamento próprio. Nenhum benefício fiscal é inferido, calculado ou ativado. Este trabalho não fez nova consulta externa nem afirma atualidade das páginas desde 04/10.
## Âmbito mínimo recomendado
1. **Apresentação operacional legível no cadastro atual:** substituir JSON bruto por linhas de área/fonte/data/estado e traduzir códigos técnicos. Mostrar “não informado”, “por confirmar”, “divergente” ou “sem relação publicada” nos grupos vazios; nunca zero substituto. A ficha distingue preparação documental, operação e regime, sem acrescentar papéis obrigatórios.
2. **Completar o contrato dos arrays existentes:** em resources, acrescentar opcionalmente identificador do detalhe, natureza (infraestrutura/serviço/acesso), âmbito (no parque/proximidade regional/não informado), data da fonte e capacidade por tipo/valor/unidade. Em activities, qualificar foco/potencial/instalada separadamente da autorização legal e permitir referência CAE apenas fundamentada. Valores/datas desconhecidos são nulos; anotações novas não convertem potencial em instalado ou autorizado. Conservar todos os itens/estados antigos e referências. Sem migration prevista; arrays JSONB já existem. Documentos de suporte reutilizam anexos privados existentes e não são expostos na projeção pública.
3. **Iniciar ou continuar ideia privada a partir do mesmo UUID:** adaptar o percurso existente, não outro dossier. Após login quando necessário, escolher criar ou continuar um dossier acessível; anexar UUID, versão consultada e localização pública com confirmação. Recuperar o contexto depois de nova sessão, preservando restantes contextos. Associação repetida é idempotente e não cria relação comercial ou oportunidade. O apoio usa o serviço/código/versão existente no destino, sem transportar ID/versão QA; se indisponível, mostrar o motivo e conservar a preparação.
4. **Prova delimitada no clone:** usar o rascunho existente **MOZ-BELULUANE-PARK**, UUID `1b57649a-f522-4cd5-8e97-32e82b6e1b37`, v1 de partida. Suporte sintético QA já autorizado, claramente identificado, apenas para provar os novos campos; não afirmar como dado real de Beluluane. Topuito publicado/v3 e demais publicações são referências de preservação, não alvos de ressubmissão. A publicação de uma versão sintética ocorre somente no clone e separada da gravação.
Fora do mínimo: preencher/validar os sete parques reais em lote, novos operadores/organizações ou categorias, loteamento cadastral, redesenhar GIS, séries temporais, cálculo de capacidade/disponibilidade, ranking, benefícios ou motor fiscal, novo workflow, consolidação de duplicados, regulação Fintech e reorganização de menus. Os campos integrais de proprietário/promotor/gestor, lotes, tarifas, ocupantes/indicadores e risco permanecem lacunas explícitas no mesmo requisito, não “ficha integral concluída”.
## Dependências resolvidas no desenho
- **Publicação:** InvestmentZones::save devolve a ficha a draft/pending e limpa published_at; não existe projeção anterior congelada para esse fluxo. Reutilizar esse workflow, mostrar aviso antes de guardar uma ficha publicada e ensaiar primeiro o rascunho existente. Não prometer manter uma publicação antiga durante edição. Criar revisão privada com publicação anterior estável seria outro delta, não um requisito presumido deste mínimo.
- **Compatibilidade:** o controlador antigo só aceita chaves fixas nos arrays. A reversão após uso terá de conservar o adaptador de validação/preservação, não apenas o JSON na base. A UI anterior usa spread dos itens, mas isso não vence a allowlist do controlador. Provar uma edição pelo código anterior com o contrato compatível antes de selar a candidata.
- **Autorização:** conservar auth/email verificado/manage-portal e controlos MFA existentes; revisões de relações, GIS e anexos mantêm as suas regras. A publicação informativa atual não exige segundo publicador desde a alteração de 06/10; não reintroduzir a regra por copiar instruções históricas. Listas técnicas de revisores não criam novas competências da Tempo. Este mapa não atribui grants nem audita globalmente a autenticação.
- **Instalação/importação:** zero migrations/importações de parques previstas; os 16 códigos conhecidos já existem. Não executar novamente os importadores CLI antigos com actor numérico, nem criar rascunhos por omissão. Futuras alterações reais usarão a ficha/API autenticada existente, por UUID/versão e publicação separada. Se a implementação demonstrar necessidade de DDL, apresentar a dependência e o mecanismo autenticado antes de a aceitar no lote.
- **Referências:** o clone de execução deve incluir a revisão económica instalada e as suas 15 referências, com guarda 55441/_test antes de providers. A fotografia usada para este levantamento antecede essa instalação; não a apresentar como clone já atualizado. Só associar IDs/citações inequívocos; não exigir CAE/operador/capacidade inventados para preparar a ficha ou a ideia.
- **Menus:** preparação separada. Conservar acesso pelas rotas atuais; a futura organização deve distinguir setor, modalidade, oportunidade concreta e parque, mostrar ações públicas versus gestão por sessão e evitar entradas duplicadas. Estas observações não alteram menus agora nem bloqueiam a ficha.
## Ficheiros previstos e disponibilização futura
Previsão de **11 fontes: nove adaptações e dois adaptadores novos**, listadas em FICHEIROS-PREVISTOS.json, mais compilação correspondente. Não é um manifesto de entrega aprovado: hashes finais e contagem de build só após QA. Usar os mesmos controllers/services/páginas de zonas e percurso, sem novo mestre. Rotas novas são apenas adaptadores autenticados do percurso existente.
Futura disponibilização, se autorizada: conferir hashes anteriores/ausências, backup/restauro fresco, fontes/build em manutenção, limpeza apenas necessária de vistas/configuração/rotas, preservando cache de dados, saída de manutenção e conferência de GET/controles/contexto sem gravar dados reais. Sem migrations, importação/publicação em lote, flags ou reinstalação de B/COUNTRY02. Alterar uma ficha real e publicar dados/anexos exige ação própria expressa; instalar código não o faz.
## Critérios de aceitação novos
| Critério | Prova dirigida em QA |
|---|---|
| Recuperação e identidade | Abrir o rascunho existente pelo UUID, recuperar versão/campos/revisões/territórios; não criar outro parque. Publicações de referência intactas. |
| Desconhecidos e conflitos | Recursos e capacidades ausentes aparecem explicitamente; nulos preservados, sem zero; áreas divergentes com fonte/âmbito, sem soma ou área disponível inferida. |
| Gravação dos detalhes | Gravar/reabrir com novas anotações, unidade/data/âmbito e suporte sintético; 409 em versão stale, motivo visível; valores antigos/novos preservados. Foco/instalada não implica atividade autorizada. |
| Projeção e divulgação | Preparação fica privada, sem anexos/fontes privadas nos props/lista/API/export público. Publicação explícita no clone, respeitando o workflow de zonas e aviso de retorno a rascunho. |
| Pesquisa afetada | Filtros existentes combinados que toquem as novas anotações continuam no servidor antes da paginação; lista/contagem/export coincidem. Não repetir filtros ou GIS aceites sem alteração. |
| Continuidade e acesso | Ficha pública → login → escolher ideia nova/existente → recuperar mesmo contexto no dossier após nova sessão → preparar apoio pelo serviço real resolvido por código. Repetir attach não duplica; conta sem âmbito recusada. |
| Reversão depois de uso | Restaurar leitor/editor anteriores com contrato compatível retido, editar campo textual e recuperar detalhes novos, contexto, IDs, versões e decisões. Não basta verificar JSON imóvel na base. |
| Operação e acessibilidade | Somente novos controles/estados em móvel e teclado, erro de carregamento visível, tipos/lint/build e mapa operacional; nenhum teste global aceito repetido. |
## Reversão e preservação
Antes de uso, repor fontes/build frescos e remover novas fontes apenas por hash. Depois de gravar novas anotações/contextos, **reversão parcial compatível**: manter contrato de validação/preservação dos arrays no controlador/serviço/adaptador e leitura/preservação dos contextos privados; retirar as entradas novas se necessário e usar uma compilação coerente. A lista exata de componentes retidos é critério da candidata QA, não prova já executada. Não apagar arrays/contextos/revisões, repor versões antigas de dados, restaurar dump sobre utilização posterior ou retirar publicações anteriores automaticamente. A mudança atual é apenas este mapa, sem dados a reverter.
## Estimativa do trabalho restante
| Tarefa QA | Estimativa |
|---|---|
| Contrato opcional e correspondências inequívocas deste recorte | 3–4 h |
| API/projeção/guardas e preservação compatível | 4–6 h |
| Ficha/cartões/formulário legíveis e desconhecidos | 3–5 h |
| Adaptador ao percurso/dossier e apoio | 3–5 h |
| Provas dirigidas, reversão, tipos e build | 4–6 h |
| Manifesto/provas/procedimento/proposta única | 2–3 h |
| **Total QA restante** | **19–29 h** |
Disponibilização futura: **2–4 h separadas**, após candidata concreta e decisão da Tempo, com backup/restauro fresco. O levantamento atual está concluído e não é hora restante. Obtenção de capacidades, operadores, títulos, lotes e tarifas reais não está estimada: depende de informação ainda ausente e não bloqueia desenvolvimento/provas com estados desconhecidos. Qualquer DDL, expansão para ficha integral ou alteração do workflow exige explicitar o delta e rever esta previsão antes de implementar.
'''
(review/'MAPA-RECORTE-QA.md').write_text(doc,'utf-8')
(review/'ATUALIZACAO-MESMA-MATRIZ.json').write_text(json.dumps({'date':'2026-10-16','status':'planning_read_only_completed_no_implementation','minimum_QA_hours':[19,29],'future_activation_hours':[2,4],'candidate_implementation_authorized':False,'active_changes':0,'accepted_tests_repeated':False,'full_operational_sheet_closed':False,'menus':'preparation separate, not a dependency','prior_economic_delivery':'reported complete; 600/579 open and editorial chain; user attachments inspection not asserted'},ensure_ascii=False,indent=2)+'\n','utf-8')
print(json.dumps({'known_park_records':len(parks),'minimum_QA_hours':[19,29],'sources':len(sources['sources']),'application_baseline_files':len(baseline),'implementation_started':False}))