Prepara proposta navegável de recomendação antes da adjudicação

docs/proposta-recomendacao.md

@@ -0,0 +1,136 @@
+# Proposta de âmbito para recomendação antes da adjudicação
+
+Estado: proposta para validação após a entrega de admissão/exclusão em
+`d020be5`. A demonstração `/proposta/recomendacao` não implementa uma nova
+decisão na base de negócio. Data: 28 de Outubro de 2026.
+
+## Resultado preparado para revisã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 proposto 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 exigidas para a futura 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 necessária antes de implementar o circuito real
+
+Validar **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 orientação de continuidade determina: «definir com a empresa o próximo
+âmbito pendente antes de o implementar», em
+`docs/orientacoes-continuidade.md`. A validação anterior autorizou admissão
+e exclusão; não definiu uma etapa de recomendação com estes efeitos. A
+implementação do circuito real aguarda a validação deste âmbito. As
+alterações locais dos três documentos de continuidade ficam preservadas.
+
+## Verificações desta preparaçã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.