# 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.