7.8 KiB
Diagnóstico e ADR-001 proposto
Inventário confirmado
| Área | Implementação e convenções | Lacuna para o pedido |
|---|---|---|
| Backend | Laravel 13.30.1; PHP de validação 8.5.11; Inertia Laravel 3.3.3; Fortify 1.39.0 | PHP do PATH não é o executável validado com PostgreSQL |
| Frontend | React 19.2.8; Inertia React 3.7.0; TypeScript 5.9.3; Vite 8.2.2; Node 24.20.0 | PT/EN integral, mapa territorial, lista–mapa, testes assistivos e estados de falha incompletos |
| Dados | PostgreSQL 17.11/PostGIS 3.6.2; 93 tabelas; 35 migrations | Sem mestre ZEE/ZFI/parques ou regras jurídicas versionadas |
| Catálogo | Opportunity bigint, slug/reference, filtros em InvestmentCatalogue, contexto M:N em InvestmentContextController |
Não representa ainda todos os tipos canónicos; pivots precisam fonte, vigência, papel e validação |
| Território | UUID em projects, economic_clusters, development_corridors; dossiers públicos separados |
Não confundir dossier editorial com investimento; correspondência projecto–oportunidade por reconciliar |
| GIS | geo_locations, geo_geometries, SRID 4326, checks de tipo/validade/vazio/coordenadas |
Zero geometrias locais; falta proveniência oficial, perímetro versionado e pesquisa espacial completa |
| CRM | CrmIntake, conversão para lead, outbox/inbox; app/Integrations/SuiteCrm/SuiteCrmClient.php e testes com simulação |
Integração real não homologada; não executar chamadas externas nesta fase |
| Autenticação | Sessão, email verificado, gate manage-portal, suporte Fortify/passkeys |
Gate por lista de gestores não substitui RBAC por função/atributo nem MFA obrigatório |
| Privacidade | Payloads e revisões de manifestações encriptados; ficheiros privados; middleware no-store | Retenção, segregação de funções e revisão editorial territorial integral pendentes |
| IA | Pesquisa lexical/rules interna com fontes e suspensão | Sem geração/RAG; achados R2–R5 da revisão continuam abertos |
Árvore funcional: app/Models, app/Services, app/Http/Controllers, app/Integrations, database/migrations, database/seeders, resources/js/pages/{investment,portfolio,management}, routes/{web,investment}.php, tests/{Feature,Unit}, deploy/{linux,suitecrm}, docs/investmoz.
Testes relevantes: InvestmentStructureTest, InvestmentPortfolioTest, InvestmentUnificationTest, InvestmentWorkspaceTest, ClusterValueChainTest, ManagementAccessTest, CrmIntakeTest, SuiteCrm/*, PublicPortalNavigationTest e PortalServicesTest.
Inventário local: seis oportunidades; 16 projectos (não confundir com as 15 âncoras documentais); oito clusters; seis corredores; 29 dossiers; 114 opções; zero geometrias, documentos e relações opportunity–cluster/corridor/project. Sem referências de oportunidade duplicadas; seis oportunidades sem opportunity_profiles.source_reference; um projecto sem descrição. Não se conclui que todo o restante conteúdo esteja correcto: deduplicação semântica, promotores de projectos e proveniência jurídica exigem reconciliação própria.
Conservar–Melhorar–Substituir–Descontinuar
| Decisão | Objecto | Tratamento |
|---|---|---|
| Conservar | IDs, slugs, dossiers, pedidos, consentimentos, anexos, favoritos e API v1 | Adaptadores e testes de contrato; sem apagar ou reclassificar em massa |
| Melhorar | Relações, cadastro GIS, fontes, auditoria, procura e páginas | FKs explícitas, temporalidade, validação, índices e permissões |
| Substituir gradualmente | Gate único de gestor para actos críticos | Políticas separadas e revisão independente; sem conceder privilégios por registo público |
| Substituir gradualmente | Mapa de pontos como única vista geográfica | Camadas autorizadas e lista sempre utilizável quando mapa falhar |
| Descontinuar após migração | Escritas paralelas da mesma identidade | Só após correspondência aprovada e reconciliação; nenhuma removida agora |
| Não importar | Estatutos, perímetros e benefícios apenas citados no prompt | Manter pendência documental, sem inferir regime jurídico |
Decisão arquitectural proposta
Adoptar um registo canónico UUID investment_items, com tabelas de correspondência tipadas para opportunities e projects, conservando os IDs legados. Um investimento pode ter representação em ambos sem duplicação. Não equiparar automaticamente registos por título nem criar uma nova oportunidade para cada dossier. Itens sem correspondência comprovada ficam em fila de reconciliação; rotas existentes usam adaptadores. A escolha final e o ER detalhado pertencem à Fase 1.
Zonas partilham cadastro físico com categoria explícita ZEE/ZFI/parque, mas estatuto jurídico, operador, empresa, título, certificado e benefício são entidades distintas. Um parque não herda regime por localização. FKs tipadas nas relações; nunca arrays de IDs em JSON para associações pesquisáveis. JSON limita-se a atributos não relacionais e snapshots de revisão.
Relações têm papel, principal/secundária, tipo de associação, fonte, justificação, prioridade, período, estado, validador e revisão imutável. Ligações jurídicas validadas ficam distintas de influência, proximidade calculada e potencial. Unicidade por par/tipo/período; prevenção de ciclos para hierarquia e dependências, sem impor exclusividade entre dimensões.
Preservar SRID 4326 do modelo existente. GIS calcula distância/intersecção/inclusão sem alterar estatuto. Publicação de perímetro exige fonte autorizada, validador, vigência, versão e permissão de divulgação. Simplificação para apresentação não substitui a geometria de referência.
Lei 8/2023 e Decreto 8/2024 são diplomas indicados pelo requerente, ainda não conferidos juridicamente nesta fase. Matriz futura deve guardar diploma/artigo/sujeito/condição/competência/vigência/versão/fonte/validação/histórico. Não se afirma conformidade legal integral com base no inventário técnico.
Alternativas rejeitadas: catálogo independente por zona (duplica investimentos); converter geometrias em estatuto (infere direito); substituir IDs existentes (quebra contratos); publicar nomes indicados como cadastro oficial sem prova.