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

15 KiB
Raw Blame History

Execução do plano de remediação — 30/09/2026

Continuação — 08/10/2026

Retomada em main, commit bdd766c, com árvore inicialmente limpa. Foram executados os formatadores existentes (php vendor/bin/pint e node_modules/.bin/vp.cmd fmt) para tratar os bloqueios técnicos de formatação registados abaixo. O diff abrange 268 ficheiros antes deste apontamento; inclui código, contratos, dados JSON e documentação. Não foram executados importadores, migrations, seeders nem operações de publicação.

Resultados desta continuação:

  • Pint: aprovado depois da correcção.
  • Formatação frontend: os 400 ficheiros verificados passaram.
  • TypeScript (npm.cmd run types:check): aprovado.
  • Testes frontend (node --test tests/frontend/*.test.mjs): 144 aprovados, zero falhas e zero testes ignorados.
  • git diff --check: aprovado antes deste apontamento.
  • npm.cmd run check: continua a terminar com código 1; depois de ultrapassar a formatação, revela 173 avisos de lint e zero erros em 213 ficheiros. Os avisos não foram suprimidos nem foi alterada a política do verificador.
  • PHPStan: iniciado com --debug --memory-limit=512M, mas interrompido após permanecer sem resultado; não declarar aprovação nesta continuação.
  • Suite PHP e ciclo PostgreSQL/PostGIS: não executados nesta continuação. Exigem alvo QA isolado com guarda contra a base activa.

REM-CI-01 permanece aberto: ainda falta corrigir/rever os avisos de lint, concluir PHPStan e executar o workflow no commit que contenha as alterações, com o teste dedicado efectivamente aprovado. Mantém-se o No-Go global; os resultados históricos seguintes conservam as respectivas datas.

Resumo

Linha de base: branch main, commit 3dc7c5c649d433527e2e261e33b8d45eb9e71bd8, árvore limpa antes desta remediação. A auditoria de 25/09 tinha uma conclusão de CI desactualizada: o workflow actual já usa PHP 8.5 e disponibiliza PostgreSQL / PostGIS 17-3.5. A lacuna reproduzível era o teste protegido de ciclo de esquema não ser invocado pelo workflow.

Foi adicionado ao CI um passo dedicado para executar tests/InvestMoz/SchemaLifecycleTest.php contra o serviço PostgreSQL efémero do job. O teste exige explicitamente INVESTMOZ_SCHEMA_TESTS=1, valida que o nome da base termina em _test e recusa configuração em cache antes de executar migrate:fresh. Não houve ligação a produção nem alteração de bases de dados nesta sessão.

Decisão global: No-Go. O reforço do CI não fecha as lacunas funcionais e operacionais da matriz de requisitos.

Salvaguardas e ambiente

  • Git confirmou main e a árvore limpa no início. Não criei commit.
  • Versões locais observadas: PHP 8.5.0, Laravel 13.30.1, Node 24.20.0 e npm 11.19.0.
  • O workflow executa num job Ubuntu e num serviço PostgreSQL/PostGIS efémero, com base investmoz_test e credenciais exclusivas do job.
  • Não há Docker, psql ou pg_isready instalados localmente. Não foi possível confirmar ou criar uma instância local descartável.
  • Nenhum segredo foi lido ou incluído neste documento. Nenhuma base de dados, credencial ou serviço externo foi alterado.

Matriz de remediação

ID Domínio Severidade / causa-raiz Acção correctiva Responsável sugerido / dependências Esforço inicial* Evidência e critério de aceitação Estado
REM-CI-01 CI / esquema Alta: o teste de ciclo do esquema era ignorado sem INVESTMOZ_SCHEMA_TESTS=1. Adicionado passo explícito ao workflow, dirigido ao serviço efémero PostGIS. DevOps; depende de execução GitHub Actions. Pequeno, 1–2 horas Job GitHub Actions verde; teste dedicado sem skip e com resultado aprovado. Implementado; execução remota Não verificada.
REM-DOC-01 Rastreabilidade Baixa: auditoria de 25/09 afirmava PHP 8.3 e ausência de PostgreSQL no workflow actual. Corrigida a conclusão e identificada a data histórica das outras classificações. Manutenção técnica; sem dependência externa. Pequeno, menos de 1 hora Documento corresponde ao YAML actual; diferenças funcionais continuam explicitamente abertas. Corrigido por inspecção estática.
REM-GEO-01 GIS / dados oficiais Crítica: testes de esquema não provam importação oficial, desempenho representativo ou permissões no ambiente-alvo. Validar por domínio sem tocar dados até existir fonte e ambiente aprovados. Responsáveis GIS/dados + backend; depende de dados licenciados e staging descartável. Grande, 1–2 semanas (estimativa) Origem/licença, SRID, reconciliação, testes espaciais, perfis e tempos reproduzíveis. Pendente; Não verificado.
REM-SEC-01 Segurança / privacidade Crítica: sem evidência nesta sessão de pentest, revisão completa de perfis, retenção e base legal. Revisão de segurança e validação jurídica com responsáveis competentes. AppSec, privacidade e assessoria jurídica; depende de requisitos e perfis aprovados. Grande, 1–2 semanas (estimativa) Matriz de permissões aprovada, achados tratados e requisitos legais referenciados. Pendente; Não verificado.
REM-OPS-01 Operação / recuperação Alta: deploy descrito, mas backup/restauro, monitorização e resposta não demonstrados no alvo. Ensaio de restauro isolado e validação operacional. SRE/infraestrutura; depende do ambiente-alvo e política de backup. Médio/grande, 3–5 dias (estimativa) Restore reproduzível, health checks, alertas e runbook exercitado. Pendente; Não verificado.
REM-BIZ-01 Âmbito funcional Crítica: matriz de 25/09 identifica requisitos de CRM, negócios, jornadas, integrações e outros domínios incompletos. Priorizar com proprietário funcional; implementar por domínio com critérios aprovados. Proprietário do produto + líderes de domínio; depende de MVP aprovado. Extra grande, por fases (estimativa não aprovada) Fluxos críticos aprovados ponta a ponta e rastreados a requisitos e testes. Pendente; Não conforme para aceite integral.

* Estimativas de planeamento preliminares, não aprovadas; devem ser revistas pelos responsáveis após decomposição do trabalho.

Alterações realizadas

  • .github/workflows/tests.yml: acrescentado o passo “Validate PostgreSQL/PostGIS schema lifecycle”, com INVESTMOZ_SCHEMA_TESTS=1 e a configuração PHPUnit dedicada. O serviço já existente no workflow é efémero e tem nome de base terminado em _test.
  • docs/investmoz/requirements-audit.md: corrigida a afirmação obsoleta sobre versão PHP e ausência de serviço PostGIS; registado que o resultado remoto continua por verificar e que a decisão funcional global não muda.
  • docs/investmoz/remediation-execution-2026-09-30.md: criado este registo, incluindo matriz, salvaguardas e evidência pendente.

Não foram removidos ficheiros, requisitos, testes ou controlos. Não foram alteradas migrations, dados, dependências, contratos de API ou credenciais.

Verificações desta sessão

Verificação Comando / método Resultado
Branch, commit e estado inicial git status --short --branch; git rev-parse HEAD main, commit 3dc7c5c…, limpo antes das alterações.
Versões locais php -v; php artisan --version; node.exe --version; npm.cmd --version PHP 8.5.0, Laravel 13.30.1, Node 24.20.0, npm 11.19.0.
Workflow actual Inspecção de .github/workflows/tests.yml PHP 8.5, serviço postgis/postgis:17-3.5, credenciais limitadas ao job.
Protecção do teste Inspecção de SchemaLifecycleTest.php e phpunit.investmoz.xml Teste exige opt-in, ambiente testing, driver pgsql, nome _test e ausência de config cache antes de migrate:fresh.
Testes API frontend node.exe --test tests/frontend/portal-api.test.mjs Aprovado: 13 testes, 0 falhas.
TypeScript npm.cmd run types:check Aprovado (tsc --noEmit).
PHPStan php vendor/bin/phpstan analyse --no-progress --debug --memory-limit=512M Aprovado: 0 erros. A primeira execução falhou no limite local de 128 MB; repetida sem workers paralelos com 512 MB.
Composer composer validate --no-check-publish Aprovado.
Formatação dos ficheiros alterados vp check --no-lint .github/workflows/tests.yml docs/investmoz/remediation-execution-2026-09-30.md Aprovada para o documento; o verificador não reporta YAML como ficheiro formatável.
Formatação PHP global php vendor/bin/pint --test Falhou em 2 ficheiros PHP preexistentes não alterados: migration 2026_09_28_160000_investment_primary_territory.php e tools/test-mne-integrity.php.
Check frontend global npm.cmd run check Falhou por 103 ficheiros fora do padrão no primeiro scan; não apliquei autofix em massa. TypeScript passou separadamente.
Integridade do diff git diff --check Aprovado; sem whitespace errors.
Protecção local do teste de esquema php vendor/bin/phpunit --configuration=phpunit.investmoz.xml --do-not-cache-result sem opt-in PHPUnit terminou com 1 teste ignorado pela guarda, 0 asserções; não ligou à base de dados.
Ciclo de esquema PostgreSQL/PostGIS Não executado localmente Sem servidor/cliente PostgreSQL local; ligação do PHPUnit não pôde ser comprovada como descartável. A execução real foi delegada ao serviço efémero no CI.
Sintaxe YAML do workflow Não verificada por parser dedicado Python, Ruby, Docker e actionlint não estão disponíveis; a inspecção estática não substitui validação pelo GitHub Actions.
Resultado GitHub Actions Não disponível nesta sessão Não afirmar aprovação do pipeline até execução do workflow alterado.

Pendências, reversão e aceitação

Para reverter apenas esta remediação, remover o passo dedicado do workflow e restaurar o texto histórico em requirements-audit.md; manter o registo desta execução como evidência histórica, assinalando a reversão. A alteração do CI só afecta o job efémero e não requer reversão de dados.

O critério de encerramento de REM-CI-01 é um run verde do workflow no commit que contém a alteração, com o teste dedicado efectivamente executado. O critério de Go global continua a exigir os gates funcionais, geográficos, de segurança, integridade, desempenho, operação, legalidade e recuperação; esses gates não foram satisfeitos nem reavaliados nesta sessão.

Nenhuma evidência foi fabricada. Os resultados históricos permanecem atribuídos às respectivas datas e ambientes; tudo o que não foi reproduzido está marcado como Não verificado ou pendente.