Files
compras/docs/territorio-candidaturas-recebidas-sgc.md
nala 63d20b10fc
tests / ci (push) Canceled after 0s
commit de armazens
2026-11-04 09:40:26 +02:00

3.9 KiB

G6 — Consulta territorial das candidaturas recebidas

Integra a cartografia de G4/G5 na caixa interna de candidaturas electrónicas, sem migração, atribuição de acessos ou alteração de dados recebidos. O filtro é opcional; a caixa sem filtro conserva o percurso anterior.

Origem e sentido do filtro

O território é comparado com as referências da disponibilidade principal e dos locais adicionais guardadas no snapshot da candidatura. A consulta não usa o perfil actual: uma edição posterior do candidato não desloca uma candidatura antiga para outro território. Designações iguais escritas manualmente não recebem códigos por inferência.

É possível escolher província, distrito, posto administrativo ou localidade. São abrangidas as referências confirmadas desse território e dos seus descendentes, da mesma edição do catálogo. Candidaturas com texto manual ou referências de outra edição continuam na caixa sem filtro. A interface explica como retirar o filtro para as consultar.

As listas adicionais em falta, vazias, com referências nulas ou com estrutura antiga não causam falhas de consulta. Apenas listas de referências objecto são consideradas. Os dois ramos (principal/adicionais) ficam agrupados dentro do âmbito já imposto pela empresa e pelo processo. Não há uma consulta geral de candidatos entre empresas.

Responsabilidades e contexto

Mantém-se CandidateTriage.canRead: preparador com acesso ao processo, ou revisor com os âmbitos adicionais já exigidos para consultar as fontes electrónicas. Administrar uma empresa não atribui automaticamente leitura destas candidaturas. O utilizador actual, as competências, o âmbito e a vigência são revalidados pelos controlos nativos. Sessões de candidato não dão acesso à caixa interna.

O selector consulta /pessoas/{process}/divisao-administrativa, com a mesma autorização por empresa/processo e contexto Pessoas. Não é necessário entrar em Compras para consultar o catálogo; o endpoint genérico de Compras continua sujeito ao seu contexto. O catálogo devolve apenas localidades, nunca nomes ou dados de candidatos. Respostas privadas sem cache.

Paginação e decisões

Resultados ordenados por ordem de recepção, vinte por página, com filtros conservados nas ligações de paginação. O foco nativo submission combina-se com o território, em vez de substituir a consulta. Um filtro sem resultados não elimina candidaturas.

O filtro não decide triagem, elegibilidade, pontuação, selecção, contratação ou aprovação. As pendências usadas pelas transições do processo continuam a incluir todas as candidaturas, não apenas as visíveis. Mantêm-se os comandos de publicação/triagem, a auditoria nativa da consulta, os documentos e os dados recebidos. Não se acrescenta uma exportação de dados pessoais por este bloco.

Validação e limites

Consulta JSON implementada e testada em SQLite e PostgreSQL. Noutros motores, a caixa continua disponível sem filtro territorial; a nova consulta não é anunciada como suportada. Sem certificação de capacidade ou revisão visual completa.

Provas em docs/proofs/candidate-territory.json e candidate-territory-pg.json. Cobrem principal/adicionais, coincidência manual sem referência, fotografia antiga face ao perfil editado, ordem/paginação, foco, isolamento empresarial/processual, acesso revogado, identidade de candidato, contexto Pessoas, entrada inválida, suspensão, outras edições e formatos antigos. As fixtures respeitam as chaves estrangeiras e não alteram submissões imutáveis existentes.

O piloto foi inspeccionado em leitura, sem criar processos, abrir portais ou submeter candidatos. Percursos positivos com candidaturas apenas em bases descartáveis. Geografia da sede/fornecedores permanece activa; G3 continua pendente da autorização própria. MFA desligado e aprovações, contas e perfis existentes preservados. O bloco não altera SGF.