132 lines
24 KiB
Python
132 lines
24 KiB
Python
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}))
|