Files
Investidor-V2/docs/investmoz/zones/diagnosis-and-adr.md
T
nala 1106509116
tests / ci (push) Canceled after 0s
vrsao 2
2026-10-08 14:02:01 +02:00

48 lines
7.8 KiB
Markdown
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.
# 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.