72 lines
7.4 KiB
Markdown
72 lines
7.4 KiB
Markdown
# Script skills_edu — execução local de 30/09/2026
|
||
|
||
Executado o anexo de tabelas recebido em 30/09/2026, adaptado aos mestres existentes como exigido no próprio documento. O prompt funcional anterior foi cancelado e não foi retomado. Esta entrega é de estrutura relacional; não activa formulários, matching, publicação, acesso a documentos ou integrações.
|
||
|
||
## Resultado
|
||
|
||
- PostgreSQL **17.11**, pgcrypto/PostGIS já geridos pelas migrations existentes; nenhuma extensão reinstalada.
|
||
- Seis migrations Laravel registadas: `2026_09_30_100100_skills_education_1` até `2026_09_30_100600_skills_education_6`.
|
||
- **24 tabelas, 83 FK e 111 índices** no schema `skills_edu`. Todas as FK têm cobertura B-tree completa; índices parciais adicionais mantidos.
|
||
- Novas tabelas vazias. Nenhuma pessoa, competência, curso, procura ou oportunidade inventada/importada.
|
||
- Backup com restauro de **210 tabelas**: `storage/app/private/skills-education-backup-20260930-034646/`. A reconciliação posterior não encontrou diferenças, descontando os seis registos novos na tabela Laravel `migrations`.
|
||
- Evidência e checksums SQL: `applied-verification.json` no mesmo directório privado.
|
||
|
||
## Adaptação aos mestres
|
||
|
||
As seguintes tabelas são extensões com **PK também FK obrigatória** para o mestre. Não geram um segundo identificador da entidade. Nomes/códigos e outros campos indicados continuam a ser lidos no mestre; não foram copiados.
|
||
|
||
| Extensão em skills_edu | Mestre em public | Informação mantida no mestre |
|
||
| ------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------ |
|
||
| skill_details | skills | UUID, código e nome PT |
|
||
| occupation_details | occupations | UUID, código e nome PT |
|
||
| program_details | courses | UUID, código, título PT, instituição/provider e estado |
|
||
| human_resource_need_details | labour_demands | UUID, projecto, localização, ocupação, quantidade, qualificação, período, fonte e estado |
|
||
| educational_opportunity_details | education_investment_proposals | UUID da proposta; título, descrição, valor e moeda continuam na oportunidade ligada por opportunity_id |
|
||
| qualification_document_details | documents | UUID, nome do ficheiro, MIME, storage_key e SHA-256 |
|
||
| consent_details | consents | UUID, finalidade, estado, concessão e retirada |
|
||
|
||
Os estados destas entidades seguem o mestre existente: por exemplo, consentimento retirado usa `withdrawn`, não uma segunda coluna `revoked`. A unicidade de códigos de competências/ocupações/cursos conserva as regras actuais dos mestres, incluindo soft delete. A versão do grupo documental na extensão refere-se ao comprovativo; `documents.version_no` continua a ser a versão do registo mestre.
|
||
|
||
O consentimento deve ter `public.consents.subject_ref` igual ao UUID do perfil. O trigger da extensão valida esta ligação e que a expiração é posterior à concessão. Não converte consentimento de outra finalidade nem muda o mestre.
|
||
|
||
| Referência do anexo | Mestre e tipo confirmados |
|
||
| -------------------------------------------------- | -------------------------------------- |
|
||
| user_master_id e campos de actores _\_by/__user_id | public.users.id — bigint |
|
||
| sector_master_id | public.sectors.id — bigint |
|
||
| company_master_id / organisation_master_id | public.organizations.id — UUID |
|
||
| institution_master_id | public.training_providers.id — UUID |
|
||
| program_master_id | public.courses.id — UUID |
|
||
| project_master_id | public.projects.id — UUID |
|
||
| cluster_master_id | public.economic_clusters.id — UUID |
|
||
| corridor_master_id | public.development_corridors.id — UUID |
|
||
| zee_master_id / zfi_master_id | public.investment_zones.id — UUID |
|
||
| location_master_id | public.geo_locations.id — UUID |
|
||
|
||
As FK novas para mestres usam DELETE RESTRICT. Relações internas mantêm CASCADE/SET NULL/RESTRICT definidos no anexo. Não há conversão bigint–UUID. A escolha ZEE versus ZFI exige ainda validação de categoria na futura aplicação: a FK confirma a existência da zona, não a sua categoria.
|
||
|
||
## Migrations e segurança
|
||
|
||
SQL adaptado em `database/sql/skills-education/01.sql` a `06.sql`; execução por `App\Support\SkillsEducationMigration`. Cada migration é transaccional no PostgreSQL, adquire bloqueio consultivo, valida versão/extensões/tipos dos mestres e exige o bloco anterior. A primeira recusa um schema preexistente não registado. A repetição via Artisan terminou em `Nothing to migrate`; não se deve repetir o SQL bruto por fora do ledger.
|
||
|
||
O DOWN verifica tabelas vazias e remove somente as tabelas/funções/schema novos em ordem inversa, com RESTRICT. Recusa perda de dados e não apaga mestres nem extensões PostgreSQL. O rollback integral e a reaplicação foram executados na base isolada. Em produção/local com dados, preparar arquivo e reconciliação antes de qualquer reversão.
|
||
|
||
O anexo não define novas colunas geométricas; a localização aponta para o mestre geográfico existente. Não foram criadas coordenadas nem alterada a sua visibilidade. Perfis e necessidades conservam os valores privados por defeito.
|
||
|
||
A auditoria recusa UPDATE, DELETE e TRUNCATE, incluindo comandos sem linhas afectadas. Isto complementa o REVOKE do anexo; um administrador da BD continua capaz de alterar DDL. Cifragem de contactos, scanner, autorização de downloads e verificação humana são obrigações da futura aplicação, não capacidades fornecidas pelo DDL.
|
||
|
||
## Verificação
|
||
|
||
- Suite completa: **183 testes, 1871 verificações aprovadas**.
|
||
- PHPStan e Pint aprovados.
|
||
- Testes específicos: tipos/FK, extensão sem mestre recusada, utilizador inexistente, valores privados, intervalo inválido, auditoria imutável, cobertura de índices, rollback vazio, reaplicação e recusa de rollback com dados.
|
||
- O teste de rollback das zonas passou a reverter primeiro as extensões dependentes. O reset PHPUnit do schema fica restrito às bases conhecidas de teste em localhost:55441; não ocorre no ambiente local operacional.
|
||
- Não houve alterações de API ou frontend, nem commit Git.
|
||
|
||
Para inspeccionar o resultado sem modificar dados:
|
||
|
||
```powershell
|
||
php tools/verify-skills-education.php
|
||
```
|
||
|
||
Para novos ambientes, executar a cadeia Laravel normal após as migrations dos mestres: `php artisan migrate`. `tools/prepare-skills-education.py` documenta a transformação inicial do anexo; não deve ser usado para reescrever migrations já aplicadas. Correcções futuras exigem novas migrations.
|