# Decisão agrupada — cadastro de artigos no Stock

10/11/2026 · `SGF-STOCK-CATALOGUE-QA-v1`. **Autorizado expressamente e entregue; ver [relatório](SGF_STOCK_CATALOGUE_DELIVERY.md).** Conferência apenas de leitura em `scripts/sgf-stock-catalogue-access-readonly.php`: o SGF apresenta/pesquisa artigos existentes, mas não tem o percurso administrativo de preparação e revisão de novos artigos. Os direitos abaixo foram aprovados e aplicados apenas nos dois livros QA existentes. O texto conserva o âmbito da decisão. A capacidade SQL da ligação nativa não constitui autorização de negócio e não será usada para contornar essa ausência.

## Resultado funcional proposto

Na mesma8085, Stock → Artigos: pesquisar, consultar ficha/origem/histórico e preparar um novo artigo com código, designação, unidade e fundamento explícitos. Outra pessoa confere a versão e o impacto, aprova ou recusa. Só a aprovação cria o artigo no catálogo físico existente. Guardar proposta não o disponibiliza para recepção/consumo.

O artigo aprovado poderá ser escolhido explicitamente pelos selectores já existentes; não cria movimento, saldo inicial, lote, preço, custo, compra, dívida ou lançamento. Permitir uma correcção revista de designação **apenas dos artigos criados por este percurso**, mantendo código/unidade imutáveis e histórico anterior. Não alterar os artigos dos exemplos aceites nem atribuir empresas/unidades automaticamente a artigos antigos. Armazéns, conversões de unidade, importação em massa, fusão de duplicados e suspensão geral de artigos não fazem parte desta decisão.

Reutilizar contexto, revisão distinta, prévia/confirmar, recibo/chave e auditoria administrativos existentes. Novo adaptador de catálogo fará a escrita delimitada e a proveniência na mesma transacção nativa; não ampliar o writer de movimentos ou os SELECTs da ligação física de leitura. Versão, actor activo, vínculo físico, autoridade, código único e descrição escolhida são novamente conferidos na confirmação. Nunca apagar artigos ou histórico.

## Dois direitos e duas concessões por livro QA

Tenant1/empresa2/unidade2, apenas nos livros QA **8085 e regressão já existentes**:

|Direito SGF novo|Única função a receber|Poder delimitado|
|---|---|---|
|`stock.items.prepare`|Armazém — Compras, utilizador QA2|Preparar novo artigo ou sucessora da designação de artigo criado neste percurso; não aprovar.|
|`stock.items.review`|Conferência técnica QA, utilizador12|Rever favoravelmente/recusar preparação alheia e aplicar a decisão actual; sem preparar ou alterar artigos anteriores.|

Consulta reutiliza `stock.view`, já existente nestas funções. **Duas concessões por base, quatro no total**, sem nova pessoa, perfil, role PostgreSQL, direito PUBLIC, acesso real ou função nativa genérica `warehouse`. A ligação nativa existente já dispõe de escrita SQL e sequência; nenhuma concessão SQL adicional é proposta. A nova autoridade de negócio será exigida mesmo assim, antes de invocar o adaptador.

Novas estruturas de propostas, versões, proveniência e recibos somente nesses dois livros QA; nenhuma migration ou instalação numa empresa/destino real. Não se presume que os poderes de confirmar movimentos ou rever lotes autorizam administrar o catálogo.

## Provas e exemplo de utilização

Na regressão: direitos/contexto/empresa/unidade, preparação versus revisão, recusa de revisão própria, versão antiga, código duplicado, código/unidade imutáveis, concorrência, repetição e recuperação após falha, atomicidade artigo+proveniência e ausência de movimentos. Na8085: um artigo explicitamente novo `QA-CATALOGO-INTEGRADO`, designação fictícia, unidadeUN, **sem saldo inicial**, preparado2/revisto12, ficha e histórico. Não repetir os antigos percursos de compra/recepção/valorização.

Preservar27 lançamentos, Caixa950, documentos e posições, artigos e movimentos anteriores, cinco cálculos, seis registos/cache e trabalho alheio. Sem nova demonstração/base/porta, SGC, valorização, acessos/operações reais, publicação, candidata de Compras, aceitação/checkpoint ou declaração de capacidade de implantação. Revisão visual/carga separadas. O âmbito inclui o percurso completo descrito, não requer aprovação por campo ou teste.