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

127 lines
15 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.
# 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.