Files
SGF/docs/SGF_STOCK_CATALOGUE_SCOPE.md
2026-11-11 09:00:17 +02:00

4.3 KiB

Decisão agrupada — cadastro de artigos no Stock

10/11/2026 · SGF-STOCK-CATALOGUE-QA-v1. Autorizado expressamente e entregue; ver relatório. 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.