32 lines
3.9 KiB
Markdown
32 lines
3.9 KiB
Markdown
# 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.
|