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

12 KiB

InvesteMoz V2 — primeira entrega local

8 de outubro de 2026. Entrega de código local; sem implantação ou escrita na base ativa.

Estado inicial e preservação

O trabalho começou sobre bdd766c68a5e09437f5bf37f47021d49bd43211a, com 309 entradas locais já modificadas/não rastreadas. O Balcão e o acompanhamento tinham alterações em curso. Foram preservados esses ativos, incluindo ficheiros ZIP e documentação anteriores; não houve reset, limpeza, commit ou substituição global.

Foi guardado um snapshot privado em storage/app/private/investmoz-v2/before/inventory.json, com bytes originais, hashes e HEAD. Os ficheiros originalmente limpos afetados por correções de CI também foram preservados. ficheiros-primeira-entrega.csv identifica o delta desta entrega, distinguindo ficheiros com alterações anteriores. Não representa todo o git diff acumulado.

A leitura da base ativa usou PDO em transação READ ONLY, sem arrancar providers, com ROLLBACK final. Evidência privada: active-read-only.json. Identidade real: investemoz, porta 5432; 76 migrations instaladas. A Bolsa de Parcerias interna está instalada. O novo esquema desk_cases e a extensão de tarefas/eventos do acompanhamento não estavam instalados. Existem associações territoriais: 9 primárias, 15 secundárias e 4 de impacto; o audit mostra 6 gravações de território primário, 1 aceite do proprietário e 3 ativações de nomes de referência. Estes agregados não certificam todas as reconciliações territoriais por projeto.

Implementação e reutilização

O catálogo partilhado de navegação organiza Explorar, Preparar, Serviços, Parcerias, Minha área e Gestão autorizada. Mantém rotas existentes, submenus, indicação de grupo/página atuais, preparação em paralelo e acesso direto aos módulos. O layout público e o interno reutilizam o mesmo catálogo. O menu de gestão é condicionado pelas permissões; endpoints mantêm a autorização independente do menu.

Os menus permitem rato, toque e teclado; Escape fecha o submenu e devolve o foco. Os painéis respeitam os limites da janela e permitem scroll. Foram corrigidas sobreposição do cabeçalho, quebra móvel e sobreposição do contacto flutuante. O campo de pesquisa da página inicial ganhou fundo/contraste legível. A proporção áurea referida na fonte orienta a composição; não foi aplicada uma fórmula rígida a todas as páginas.

O portal apresenta a natureza privada/independente e reserva decisões oficiais às instituições competentes. PORTAL_OPERATOR_NAME permite reutilizar uma identidade confirmada. Não foi encontrada confirmação suficiente para preencher esse nome; não foi inventado um operador.

O acompanhamento reutiliza dossier, pedidos, documentos, eventos e tarefas existentes. Não cria um segundo balcão. Recomendações automáticas, submissões do investidor, conferência/parecer interno e resposta humana permanecem distintos nos fluxos demonstrados. Uma sugestão só origina tarefa após ação explícita do investidor; a tarefa aponta para o mesmo pedido no CRM interno. O contexto acompanha roteiro, simulador, Bolsa e outras páginas, com recuperação de rascunhos.

A avaliação de evidência distingue informação ausente, declaração, anexo por conferir, verificação interna, problema/contradição, expiração, substituição e indisponibilidade técnica. Uma conferência só sustenta os âmbitos selecionados pelo verificador real. Guarda autoria, data, o que foi verificado, evidência, versão e hash; uma alteração de bytes/versão ou uma conferência posterior pode invalidar o apoio anterior. A visibilidade respeita proprietário, gestor e analista atribuído ao pedido. O fingerprint do contexto inclui a evidência, evitando reutilizar uma recomendação aceite quando os seus pressupostos mudam.

Os alertas de mercado, localização, recursos e financiamento dependem da lacuna efetiva. Um campo preenchido ou um anexo não valida procura, infraestrutura, financiamento ou elegibilidade. Verificação interna não elimina limitações nem se transforma em aprovação oficial. Os cálculos continuam nas ferramentas determinísticas existentes; a IA não fornece taxas ou valores substitutos. As regras internas funcionam sem modelo externo.

Código, QA e instalação ativa

Capacidade Código local/QA Base ativa constatada
Navegação partilhada e aviso de natureza privada Implementado, build local e navegador Não é prova de publicação/implantação
Bolsa, CRM interno, dossier e calculadores preexistentes Reutilizados Bolsa/esquema interno existente instalado
Novo Balcão, conferência e acompanhamento Implementado e testado no esquema completo QA Novas tabelas/extensão ausentes; instalação autenticada pendente
Associações territoriais Rotas/detalhes/pesquisa testados Esquema e relações existentes constatados; completude documental por área não certificada
IA/CRM externos e comunicações/pagamentos automáticos Não necessários ao ciclo interno Integrações não ativadas nem verificadas nesta entrega

Não foi executada migration, seed, teste ou importação contra a base ativa. A ação autenticada de instalação já prevista no projeto continua necessária, depois de confirmar backup/restauro aplicável. O snapshot de ficheiros local não substitui esse backup da base.

Evidência de testes

Todos os testes de base de dados usaram investmoz_v2_20261008_test, loopback, porta 55441. As guardas rejeitam o nome da base ativa, outra porta e URLs de conexão alternativas. O servidor QA utiliza sessões separadas, contas sintéticas, autenticação normal e integrações externas desativadas. Os testes de navegador bloqueiam pedidos externos; falha de tiles do mapa não impediu os serviços internos.

Verificação Resultado
PHPUnit completo 344 testes: 341 passaram, 3 saltados; 4009 asserções
Ciclo PostGIS/migrations, separado 1 teste passou, 3106 asserções
Frontend node --test tests/frontend/*.test.mjs 151 passaram, 0 falhas
TypeScript Passou
Lint/frontend Sem erros ou avisos, 231 ficheiros
PHPStan e Pint Passaram, sem baseline/ignores novos para esconder erros
Build Concluído; avisos existentes de fontaine opcional e chunks acima de 500 kB

Os três testes saltados requerem integração ClamD real. A QA documental usa um scanner simulado explicitamente identificado; não constitui scan real ou homologação.

O ciclo do Balcão foi demonstrado no navegador: guardar/reabrir rascunho → submeter explicitamente → atribuir responsável → pedir esclarecimento → corrigir/re-submeter → parecer/conclusão interna → resposta humana → aceitar recomendação → tarefa no CRM interno → recuperar contexto na Bolsa. Evidência privada: desk-browser-evidence.json; dossier 414615fc-5fb5-4c1a-8cd8-5cde74c3e68a, pedido 87a162f4-f445-4651-95aa-9ecce30a0e2f, tarefa ec86398e-ae0c-46d3-9e93-b3aaede71d54. São exclusivamente fixtures QA.

A validação adicional de navegação passou em desktop 1440 px e móvel 390 px, áreas pública/investidor/gestão, submenus e foco, pesquisa/fichas de projeto, cluster e parque, recuperação de um rascunho anterior, contexto entre módulos, conferência pela interface com autoria e isolamento entre utilizadores. Zero erros JavaScript de página. Evidência: navigation-browser-evidence.json; capturas verificadas visualmente permanecem em storage/app/private/investmoz-v2.

Defeitos anteriores e regressões encontradas

O diagnóstico inicial encontrou 97 erros PHPStan e avisos de lint que impediam o CI global. Foram corrigidos tipos/contratos reais, leitura segura de ficheiros, valores escalares, tratamento de resultados indisponíveis e promessas dos testes frontend, sem desativar verificações. Quatro falhas de testes anteriores envolviam expectativa HTTP 500 já substituída pelo tratamento 503, redirecionamento do Balcão instalado e fixtures sem scanner determinístico. Mantiveram-se as asserções de rollback, idempotência e segurança.

Durante esta entrega, o navegador encontrou sobreposição do menu e ambiguidade no rótulo do seletor documental; ambas foram corrigidas. Um autofix de lint alterou o tipo da comparação ZIP; foi corrigido mantendo a comparação dos bytes e repetindo os 151 testes. Os avisos de dimensão dos bundles/fontes e os testes ClamD saltados permanecem identificados.

Acervo, dependências e pendências

O inventário integral dos dois diretórios de fontes acessíveis foi atualizado antes da seleção: 248 ficheiros e 63 anexos incorporados, incluindo o documento indicado posteriormente. Os originais, hashes, proveniência e o inventário anterior mantêm-se privados. Consulta, situação documental e uso em regra/cálculo são estados independentes; nenhum lote foi publicado. Os exemplares de formulários continuam no registo privado existente; não houve confirmação nova de homologação, taxas, prazos ou referências legais.

O backlog mestre relaciona a primeira entrega e os requisitos restantes com parágrafos/hash da fonte. Falta confirmar o operador, instalar o novo esquema na base ativa pelo fluxo autenticado após backup/restauro, reconciliar integralmente conteúdo/formulários e evidência jurídica/territorial, executar ClamD real e auditar a classificação histórica de mensagens de antigos membros. CRM externo, interoperabilidade, SMS/WhatsApp e confirmação automática de pagamentos ficam fora desta fase. Referências e comprovativos internos não são prova de confirmação por um serviço externo.

Ficheiros e reversão

As áreas principais são .github/workflows/tests.yml, catálogo/componente/layouts da navegação, serviço/regras de evidência, interface de conferência/acompanhamento e testes/routers QA. A lista exata e hashes estão em ficheiros-primeira-entrega.csv. O workflow executa todos os testes frontend e usa PostgreSQL QA na porta 55441, compatível com as guardas existentes.

Para reverter esta entrega, comparar primeiro o hash atual com o hash final do manifesto privado delivery-changes.json. Para cada ficheiro que existia antes, recuperar os bytes da sua cópia before/<caminho>; para ficheiros novos desta entrega, retirar apenas os identificados como novos após verificar alterações posteriores. Preservar os ficheiros e mudanças anteriores. Não utilizar git reset --hard ou git restore global, que apagariam trabalho preexistente. Regerar assets com o lockfile existente após restaurar o código. Não há rollback de dados ativos nesta entrega, porque não foram modificados. A base QA descartável pode ser mantida para revisão; uma limpeza posterior deve confirmar nome/porta e nunca abranger a base ativa.