compras/docs/proposta-recomendacao.md

# Proposta de âmbito para recomendação antes da adjudicação

Estado: âmbito validado pelo utilizador e implementado em 28 de Outubro de
2026, após a entrega de admissão/exclusão em `d020be5`. O circuito real é
opcional por empresa e por processo. A demonstração `/proposta/recomendacao`
continua separada dos registos autenticados; nenhuma política real foi
publicada nesta entrega.

## Demonstração preparada antes da validação

Uma proposta navegável, com cabeçalho, rodapé e menus partilhados do Sistema
de Gestão de Compras (SGC), permite simular:

- Política própria com perfis e quantidade de pessoas distintas, inicialmente
  por definir, e adopção expressa de uma versão.
- Matriz pronta, empate na maior pontuação, avaliações insuficientes e
  admissão pendente, todos com concorrentes e pontuações fictícios.
- Escolha manual de Compras, fundamento, conferências independentes,
  devolução, novas tentativas e conservação do histórico durante a simulação.
- Mudança de base ou de política adoptada, invalidando o uso de uma tentativa
  anterior sem apagar as suas conferências.
- Impressão do relatório demonstrativo, identificado como simulação.

Os dados desaparecem ao recarregar. Os três conferentes fictícios disponíveis
não definem um limite nem um quórum para empresas. Trocar de conferente na
página não autentica outra pessoa e não demonstra segregação efectiva. As
pontuações ilustram decisões de interface; não constituem um novo algoritmo
de comparação. Não se reutilizam nomes ou valores dos exemplos históricos.

## Circuito inicial validado para o produto

1. Administração da empresa activa uma política de recomendação versionada,
   com fundamento, perfis autorizados e quantidade de pessoas distintas.
   A política é própria desta etapa, separada da política de admissão. Não se
   presume que a autorização de um conferente numa etapa valha noutra.
2. Compras adopta expressamente a versão activa antes de adjudicar. Sem essa
   adopção, mantém-se o circuito existente. Neste primeiro âmbito proposto,
   adoptar a recomendação exige que o processo já tenha adoptado o regime
   formal de admissão; não se adopta nenhum deles automaticamente. Uma nova
   política geral não reescreve a versão preservada no processo. Desactivar
   impede novas adopções e não elimina as existentes.
3. A recomendação exige matriz pronta e propostas elegíveis com admissão
   confirmada na base actual. Preservam-se o mínimo existente de três
   fornecedores distintos elegíveis, duas avaliações por proposta, cálculo
   ponderado, verificações de conflitos, validade e coerência dos dados.
   Não se introduz uma dispensa de propostas ou um novo método de avaliação.
4. Compras indica expressamente a proposta a recomendar e fundamenta a
   escolha. Não pode recomendar em pedido do qual seja o solicitante. A
   candidata deve pertencer ao conjunto de maior pontuação devolvido pelo
   método existente. Em empate, a escolha entre as empatadas exige fundamento;
   não há desempate automático nem escolha por ordem de registo. Escolher
   abaixo da maior pontuação continua impedido, sem política de excepção.
5. A tentativa preserva a versão adoptada da política, requisitos e análises,
   decisões de admissão e conferências relevantes, matriz, avaliações e
   proposta escolhida. Identidades, datas e fundamentos são auditados. Uma
   nova tentativa acrescenta uma revisão e substitui a anterior para uso
   futuro, sem reescrever ou copiar confirmações.
6. Conferem Finanças e/ou chefia do departamento, conforme os perfis e a
   quantidade definidos pela empresa. Cada pessoa conta uma vez; deve ser
   da mesma empresa, continuar elegível e não ter conflito, nem ser
   solicitante ou proponente. A chefia deve pertencer ao departamento do
   processo. Não se exige, neste âmbito, que um conferente seja diferente de
   todos os intervenientes de outras etapas, mas mantêm-se as segregações e
   impedimentos próprios de cada operação. Não se atribuem poderes a júris
   ou pessoas externas sem um circuito específico aprovado.
7. As confirmações exigidas concluem a recomendação. Uma devolução encerra
   aquela tentativa e exige outra proposta fundamentada; não exclui o
   concorrente, cancela o processo ou desfaz uma admissão. Repetir a mesma
   conferência é idempotente. Uma resposta diferente não reescreve a anterior.
   As confirmações anteriores são revalidadas até à conclusão do quórum;
   depois preserva-se a elegibilidade verificada na sua data. Alterações de
   base ou de adopção exigem reapreciação e novas conferências.
8. Num processo que adoptou o regime, a adjudicação só pode seleccionar a
   mesma proposta de uma recomendação confirmada e actual, preservando a
   referência e a base. A coerência volta a ser verificada antes de aprovar
   e emitir. Continuam a aplicar-se orçamento, investimento, elegibilidade,
   conflitos e aprovações do valor final. Recomendação não autoriza compra.
9. Após existir adjudicação ou ordem, não se alteram a adopção ou as decisões
   desta etapa. Uma base alterada antes da emissão exige o circuito de
   revisão/cancelamento de adjudicação sem ordem já suportado, quando
   autorizado pela política da empresa. Não há desbloqueio por omissão.
   Ordens emitidas e processos anteriores não são reescritos.
10. O relatório autenticado e a sua impressão mostram base, candidata,
    fundamento, conferências, devoluções e histórico, com permissões de
    empresa/departamento. A impressão não representa assinatura digital,
    certificação das evidências ou comunicação ao concorrente.

Estas escolhas são o âmbito proposto do produto e não regras legais ou
obrigações universais inferidas dos documentos locais. Os valores, perfis e
decisões empresariais continuam a pertencer a cada aderente.

## Fora do âmbito

- Novos métodos de pontuação, correcções de preços, ajustes, multimoeda,
  escolha abaixo da maior pontuação ou dispensa de requisitos/propostas.
- Júris externos, recursos, prazos legais presumidos, assinatura digital,
  publicação, envio de emails ou comunicação ao concorrente.
- Alterar reservas, compromissos, facturas ou pagamentos pela recomendação,
  cancelar ordens emitidas, estornar ou aplicar retroactivamente o circuito.
- Tornar a recomendação obrigatória em todos os processos ou activar
  políticas reais por conta das empresas durante o desenvolvimento.

## Verificações da implementação

Isolamento e privacidade, identidade relida no servidor, autoria, segregação,
perfil/departamento revogado, quórum sem duplicações, conflitos, matriz
incompleta, admissão pendente/desactualizada, empate, escolha fora da maior
pontuação, bases alteradas, devolução e correcções imutáveis, idempotência,
rollback de auditoria, vínculo à adjudicação/emissão e concorrência
PostgreSQL com processos independentes. Uma demonstração local não substitui
estas verificações do circuito autenticado.

## Validação recebida e activação

O utilizador validou **recomendação manual por Compras, conferências independentes em
quantidade/perfis definidos pela empresa, regime opcional por adopção
expressa após admissão e vínculo à adjudicação da proposta recomendada**.

A Administração pode configurar `/politica-recomendacao`; Compras adopta a
versão activa em `/requisicoes/{requisition}/recomendacao`, após adopção do
regime de admissão e antes da adjudicação. Perfis e quantidade são escolhas
expressas da empresa. O limite de 50 no formulário é técnico, sem quórum
empresarial predefinido. A empresa deve assegurar pessoas elegíveis em número
suficiente. Consultar `docs/validacao-tecnica.md` para resultados e limitações.

A validação é do âmbito do produto; não publica políticas por conta das
aderentes. As alterações locais dos três documentos de continuidade foram
preservadas.

## Histórico: verificações da preparação da demonstração

Passaram os 18 testes de entrada e consulta pública, com 290 asserções,
PHPStan, Pint, TypeScript, build e lint/formatação do âmbito. O acesso HTTP
devolveu 200 com componente `preview/recommendation`, identidade pública nula
e sem propriedades de negócio. O título inicial usa Sistema de Gestão de
Compras (SGC). Não houve migração, importação ou publicação de política real.
A bateria completa dos módulos de negócio não foi repetida nesta preparação.

O navegador devolveu `The browser access host is unavailable`. As interacções
e a impressão estão preparadas para revisão, sem revisão visual concluída.
A formatação global de `docs/compatibilidade.md`, alteração local alheia,
permanece pendente e não foi alterada.