Files
Investidor-V2/docs/investmoz/education/skills-education-schema.md
T
nala 1106509116
tests / ci (push) Canceled after 0s
vrsao 2
2026-10-08 14:02:01 +02:00

7.4 KiB
Raw Blame History

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:

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.