header:navbar e footer
tests / ci (push) Canceled after 0s

This commit is contained in:
2026-10-19 13:07:16 +02:00
parent 3ca67a53c1
commit 14ad2f60c5
34 changed files with 1631 additions and 410 deletions
+86
View File
@@ -0,0 +1,86 @@
# Execução local no Windows
Ambiente de demonstração novo autorizado em 19/10/2026. PostgreSQL/PostGIS
isolado em `127.0.0.1:55441`, base `investmoz_local_test`, volume Docker
`investmoz-local-qa_postgres-qa`. Não contém os dados do portal activo.
O MySQL existente não serve este esquema PostgreSQL e é preservado.
## Arrancar
Inicie Docker Desktop. Na raiz do projecto:
```powershell
./deploy/local/start.ps1
```
Com a base já iniciada e preparada, basta:
```powershell
composer run dev
```
Abra http://127.0.0.1:8000. O comando inicia Laravel, o worker da fila e Vite.
Use Ctrl+C para terminar. A base conserva os dados entre arranques.
O script de arranque executa estes passos, parando no primeiro erro:
```powershell
docker compose --env-file .env -f deploy/local/compose.yaml up -d --wait
php tools/local-qa-bootstrap.php
composer run dev
```
O preparador verifica configuração e identidade real da base antes de migrar.
Só admite `investmoz_local_test`, TCP local e porta real 55441, sem DB_URL nem
configuração em cache. Executa migrations em `testing`, como exigem as guardas
existentes. Só cria os dados iniciais quando sectores e utilizadores estão vazios;
um novo arranque não redefine contas. Nunca usa `migrate:fresh`.
As quatro migrations mais recentes também admitem QA com identidade verificada
por `IsolatedQaDatabase`. A alternativa de instalação autenticada no activo é
preservada. A excepção QA é uma escolha técnica consistente com as migrations
anteriores, sem activar funcionalidades ou publicar dados.
Conta do seeder existente, exclusivamente para esta demonstração:
`test@example.com` / `password`. Não é um administrador do portal.
As regras existentes de autenticação, MFA e instalação autenticada mantêm-se.
## Dependências e configuração
- PHP >= 8.4.1, com `pdo_pgsql` e `pgsql` activos no PHP do terminal.
- Node 24, Composer, dependências de `composer.lock` e `package-lock.json`.
- Docker Desktop com contentores Linux.
- `.env` local com PostgreSQL, porta 55441, base e utilizador do Compose e
`DB_PASSWORD` privado. A chave da aplicação existente deve ser preservada.
- O primeiro build obtém as fontes configuradas de fonts.bunny.net; precisa de rede.
O bootstrap cria as pastas de cache, vistas, sessões e logs antes da configuração
Laravel. `php artisan portal:dev-check` verifica os requisitos essenciais sem
alterar registos nem mostrar credenciais. Falhas interrompem `composer run dev`
antes de iniciar os três processos.
```powershell
php artisan portal:dev-check
php artisan wayfinder:generate --with-form
npm run types:check
npm run build
```
Os testes que usam RefreshDatabase devem usar outra base `investmoz_test` no
mesmo servidor QA; nunca a base de demonstração nem o activo. `tests/TestCase.php`
mantém as guardas e o bloqueio contra testes concorrentes.
## Origem e limites
Origem: pedido expresso de correcção e configuração local e escolha do responsável
por uma base nova de demonstração em 19/10/2026. Portas, Compose, pastas automáticas
e verificação de arranque são escolhas técnicas, sem novas regras organizacionais.
Aplicam-se as decisões Tempo de 12/10/2026 e a separação QA/activo de AGENTS.md.
Não constitui implantação em produção nem aceitação funcional global da matriz
existente em `docs/investmoz/v2/auditoria-portal/matriz-requisitos.csv`.
Não remover o volume Docker para actualizar. O `.env` anterior e o `php.ini`
anterior à activação PostgreSQL foram conservados em `storage/app/private/`.
O correio local usa o canal log. Integrações externas e serviços opcionais precisam
das configurações próprias já previstas no projecto; este arranque não lhes
atribui autorização, publicação ou credenciais.
+62
View File
@@ -0,0 +1,62 @@
# Verificação local — 19/10/2026
Pedido: identificar e corrigir o arranque, configurar a plataforma e testar.
O responsável escolheu uma base nova de demonstração local.
## Plano executado e causas corrigidas
1. Reproduzido `Please provide a valid cache path`: faltavam as pastas
`storage/framework`. O bootstrap agora cria as pastas antes da configuração.
2. Substituída a configuração local MySQL incompatível por PostgreSQL/PostGIS
QA em `investmoz_local_test:55441`; activados `pdo_pgsql` e `pgsql` no PHP
usado pelo terminal. Configurações anteriores preservadas privadamente.
3. Preparado Docker Desktop e um contentor/volume próprios, ligado só a
`127.0.0.1`. O MySQL existente não foi removido nem alterado.
4. Aplicadas as 88 migrations e os seeders existentes. Quatro migrations
recentes não admitiam QA: passaram a reconhecer exclusivamente o alvo real
isolado, mantendo a alternativa autenticada para o activo. Guardas testadas
contra ambiente de produção, host/porta/base/URL indevidos e identidade real
diferente da configuração. Nenhuma flag foi apresentada como autenticação.
5. Completadas as dependências JavaScript em falta (`docx`, `jszip`) e separado
o destino GET da confirmação MFA editorial, evitando uma propriedade
duplicada no TypeScript gerado. O fluxo MFA existente foi preservado.
6. Corrigida a distribuição do manifesto económico: o hash existente corresponde
a CRLF, enquanto o checkout convertia o ficheiro para LF. Repostos os bytes
que correspondem ao SHA-256 já fixado, sem alterar conteúdo ou hash esperado;
`.gitattributes` preserva CRLF para esse ficheiro específico.
7. Criada a ligação `public/storage`, acrescentada a verificação prévia de
`composer run dev` e documentado o arranque repetível.
## Resultado observado
- `composer check-platform-reqs`: passou.
- `composer validate --no-check-publish`: válido; aviso preexistente sobre
versão exacta de `opis/json-schema`.
- Wayfinder com `--with-form`: passou.
- `npm run types:check`: passou.
- `npm run build`: passou, 2481 módulos; avisos de tamanho de chunks e
optimização opcional de fontes não interrompem o build.
- PHPUnit seleccionado: **13 testes, 39 asserções, todos passaram**, na base
separada `investmoz_test:55441`. Inclui login, página inicial, guardas QA,
criação idempotente das pastas e integridade do manifesto.
- Pint dos novos componentes PHP: passou. `git diff --check`: passou.
- Segundo `local-qa-bootstrap.php`: nada por migrar, dados e contas preservados,
seed omitido. `migrate:status`: 88 migrations aplicadas.
- `composer run dev`: Laravel em 8000, Vite em 5173 e fila a funcionar.
- HTTP 200: saúde, início, login, registo, catálogo, página de sector e APIs
públicas de início, sectores e pesquisa. Vite client: 200.
- Chrome: início, catálogo, sector, login, registo e painel após autenticação
renderizados; **zero erros JavaScript e zero respostas 5xx observadas**.
Provas: `outputs/local-startup-20261019/browser.json`, `home.png`, `dashboard.png`.
Origem das alterações: pedido expresso e opção do responsável por demonstração;
pastas, Compose, portos e excepção de migração em QA são escolhas técnicas.
Aplicam-se as decisões Tempo de 12/10/2026 e a separação QA/activo em AGENTS.md.
Referência na matriz existente: `MASTER-e1169a77-0376`, apenas como prova do
ambiente local. Não encerra os critérios globais da cláusula.
O catálogo novo pode apresentar colecções vazias: os dados do portal activo não
foram importados. A conta local é `test@example.com` / `password`; não recebe
privilégios administrativos. As integrações externas, o envio real de correio,
o scan de uploads e a aceitação funcional integral não foram demonstrados por
este ensaio de arranque. Mantêm-se as configurações e autorizações próprias.
+21
View File
@@ -0,0 +1,21 @@
name: investmoz-local-qa
services:
postgres:
image: postgis/postgis:17-3.5
command: ['postgres', '-p', '55441']
restart: unless-stopped
environment:
POSTGRES_DB: investmoz_local_test
POSTGRES_USER: investmoz_test
POSTGRES_PASSWORD: '${DB_PASSWORD:?Configure DB_PASSWORD in the local .env first}'
ports:
- '127.0.0.1:55441:55441'
volumes:
- postgres-qa:/var/lib/postgresql/data
healthcheck:
test: ['CMD-SHELL', 'pg_isready -p 55441 -U investmoz_test -d investmoz_local_test']
interval: 5s
timeout: 5s
retries: 20
volumes:
postgres-qa:
+13
View File
@@ -0,0 +1,13 @@
$ErrorActionPreference = 'Stop'
$projectRoot = (Resolve-Path (Join-Path $PSScriptRoot '../..')).Path
Push-Location $projectRoot
try {
docker compose --progress plain --env-file .env -f deploy/local/compose.yaml up -d --wait --wait-timeout 120
if ($LASTEXITCODE -ne 0) { throw 'Inicie Docker Desktop e verifique o serviço PostgreSQL QA.' }
php tools/local-qa-bootstrap.php
if ($LASTEXITCODE -ne 0) { throw 'Preparação QA interrompida; veja a mensagem acima.' }
composer run dev
if ($LASTEXITCODE -ne 0) { throw 'Arranque interrompido; veja a mensagem acima.' }
} finally {
Pop-Location
}