7.4 KiB
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_1até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 Laravelmigrations. - Evidência e checksums SQL:
applied-verification.jsonno 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:
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.