This commit is contained in:
@@ -0,0 +1,96 @@
|
||||
# Execução do plano de remediação — 30/09/2026
|
||||
|
||||
## 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.
|
||||
@@ -98,11 +98,14 @@ O próprio DOCX contém uma frase auto-contraditória na precedência de A.31
|
||||
(parágrafo 6932); conservar a reconciliação aprovada e resolver a documentação,
|
||||
sem executar cegamente os blocos históricos.
|
||||
|
||||
**Falha concreta de CI:** `.github/workflows/tests.yml` configura PHP 8.3, enquanto
|
||||
vendor/composer/platform_check.php exige >=8.4.1. Também não provisiona serviço
|
||||
PostgreSQL/PostGIS, embora os testes e migrations precisem dele. Existe workflow,
|
||||
mas a sua execução bem sucedida com o projecto actual não está comprovada. Não foi
|
||||
executada nem alterada nesta auditoria.
|
||||
**Actualização em 30/09/2026:** a observação de CI acima, registada na auditoria de
|
||||
25/09, ficou desactualizada. O workflow actual configura PHP 8.5 e provisiona um
|
||||
serviço `postgis/postgis:17-3.5` para o job. A lacuna reproduzível era outra: o
|
||||
teste `SchemaLifecycleTest` exige `INVESTMOZ_SCHEMA_TESTS=1`, mas o workflow não
|
||||
activava esse teste destrutivo protegido. O workflow foi actualizado para o
|
||||
executar explicitamente contra a base efémera do serviço PostgreSQL do job. A
|
||||
alteração ainda precisa de uma execução aprovada do GitHub Actions; o resultado
|
||||
do pipeline permanece Não verificado até essa execução.
|
||||
|
||||
`decisions.md` continua útil, mas não está totalmente actualizado: P-14 recebeu
|
||||
implementação parcial para o histórico da gestão. Isso não conclui a auditoria
|
||||
@@ -126,3 +129,12 @@ transversal nem resolve automaticamente as restantes decisões.
|
||||
staging e validação operacional antes da publicação integral.
|
||||
|
||||
Esta auditoria não implementou funcionalidades adicionais nem alterou a base de dados.
|
||||
|
||||
## Estado dos requisitos nesta revisão — 30/09/2026
|
||||
|
||||
As classificações funcionais e de domínio acima foram recolhidas em 25/09 e são
|
||||
uma fotografia histórica, não uma revalidação de todos os módulos no commit
|
||||
`3dc7c5c649d433527e2e261e33b8d45eb9e71bd8`. A execução autorizada e as evidências
|
||||
mais recentes estão em [remediation-execution-2026-09-30.md](remediation-execution-2026-09-30.md).
|
||||
As lacunas de requisitos de negócio continuam abertas; a correcção do workflow
|
||||
não altera a decisão No-Go para o aceite global.
|
||||
|
||||
Reference in New Issue
Block a user