28 lines
4.1 KiB
Markdown
28 lines
4.1 KiB
Markdown
# G5 — Cartografia nos locais adicionais de disponibilidade
|
|
|
|
Estende G4 sem migrações ou novos acessos. Cada um dos até 20 locais adicionais pode ser escolhido explicitamente no mesmo catálogo, ou continuar preenchido manualmente. A disponibilidade principal mantém o percurso existente.
|
|
|
|
## Dados e reutilização
|
|
|
|
`additional_availability` conserva a lista original de objectos com apenas província, distrito e localidade. O JSON da versão guarda, separadamente, `additional_availability_references`: uma referência por posição, ou `null` para um local manual. As listas têm sempre o mesmo tamanho quando são submetidas em conjunto. Valores sem correspondência, formatos que não são listas e mais de 20 entradas são recusados antes de criar a versão.
|
|
|
|
Para cada referência escolhida, o servidor valida edição, ID, hierarquia e nível de localidade e obtém as designações da fonte. Os nomes enviados pelo navegador não determinam os nomes oficiais. Não se criam localidades, distritos ou níveis superiores para completar o percurso. As referências de locais pendentes de revisão não são aceites.
|
|
|
|
O selector só aplica os dados quando o candidato confirma a localidade. Os três campos ficam de leitura até retirar a associação para preencher manualmente ou escolher outra referência. A remoção de uma linha remove também a sua referência; identificadores locais de interface mantêm o estado de cada selector associado à linha correcta. Esses identificadores não são enviados ou guardados como dados de negócio.
|
|
|
|
## Pedidos antigos e versões
|
|
|
|
Pedidos que omitem locais adicionais conservam os dados anteriores. Pedidos que enviam os locais mas omitem a nova lista só conservam referências já conhecidas para os mesmos textos exactos da versão anterior, independentemente da ordem das chaves. Isso permite reordenar/remover locais sem associar a referência da posição antiga a outra linha. Texto alterado passa a manual. Não se procuram códigos novos no catálogo por semelhança de nomes.
|
|
|
|
Uma lista explícita de referências com `null` retira as associações correspondentes, mantendo os textos fornecidos; listas vazias em conjunto retiram todos os locais adicionais da nova versão. As versões anteriores não são alteradas. A suspensão do catálogo preserva pedidos antigos e referências históricas inalteradas. O formulário mantém a recarga após gravação confirmada e o controlo de versão nativos, sem actualizar a versão de uma edição local apenas porque outra consulta trouxe dados mais recentes.
|
|
|
|
O limite e a recusa de locais duplicados, entre principal e adicionais e entre os próprios adicionais, continuam a pertencer ao comando nativo do perfil. A validação acontece depois de resolver as designações, evitando que nomes falsos enviados pelo cliente contornem a recusa de duplicados. Motivo, versão de perfil e sessão continuam obrigatórios.
|
|
|
|
## Integração com candidaturas
|
|
|
|
O formulário da oportunidade já oferece os locais registados no perfil e continua a receber o objecto de três campos, compatível com a definição publicada. A submissão conserva a fotografia do perfil com as referências e as respostas da oportunidade. Remover locais do perfil não altera uma candidatura recebida; a repetição da mesma submissão reutiliza o recibo. Não há triagem, classificação, aprovação ou selecção automática por território.
|
|
|
|
Validação em `docs/proofs/candidate-additional-geography.json` e prova PostgreSQL própria, sem substituir a evidência histórica de G4. Inclui localidades canónicas, mistura manual/catálogo, correspondência das listas, limites, ordenação/remoção, compatibilidade, duplicados, edição obsoleta, suspensão e fotografia/repetição da candidatura.
|
|
|
|
No piloto, as verificações são apenas de leitura: não foram configurados portais, criados candidatos ou gravados perfis. Os percursos positivos foram exercitados em bases descartáveis. MFA desligado, aprovações e acessos existentes preservados. G3 conserva a instalação/activação pendentes de autorização. Sem revisão visual completa ou aceitação por utilizadores reais.
|