SGF/docs/WORKSHOP_BILLING_DRAFT_SCOPE.md

Oficina → rascunho de facturação — especificação para decisão

Autorização técnica posterior de 28/10/2026: o utilizador autorizou implementar e demonstrar WORKSHOP-BILLING-DRAFT-SIM-v1 exclusivamente em sgf_tempo_test, sem aplicar migrações/concessões em desenvolvimento, activar uso real ou publicar. A autorização substitui apenas as restrições anteriores de etapa documental; decisões comerciais e limites permanecem. Ver entrega e estado das provas. Não presume aceitação ou checkpoint.

28/10/2026. Próximo recorte proposto: WORKSHOP-BILLING-DRAFT-SIM-v1. Nesta etapa apenas documentação: sem implementação, migrações, concessões, alteração de operações reais ou publicação. Preservar 04870f0 (orçamento aceite com limitação de capturas), 090b7da (página inicial/menu com revisão visual pendente) e anteriores. Sem reabrir as respectivas aprovações ou transformar provas pendentes em realizadas.

1. Objectivo e menor incremento proposto

Numa futura prova exclusivamente sintética em sgf_tempo_test, seleccionar numa ordem os recursos elegíveis já verificados, preparar a sua conversão comercial, rever preços e gerar um novo rascunho de facturação rastreável na mesma empresa/unidade. Não voltar a digitar consumos/tempos, não transformar ordem em produção industrial e não criar um segundo acontecimento técnico para conseguir facturar.

Primeiro recorte recomendado: uma ordem, um cliente explicitamente confirmado, uma unidade, moeda de venda explícita, selecção integral de cada origem elegível, sem repartição parcial entre rascunhos. Prestações e facturação permanecem rascunhos; não confirmar internamente B1 automaticamente, emitir documentos, calcular/aprovar fiscalidade por consequência, receber ou contabilizar. Equipamentos e contratos reais não são criados como preparação deste ensaio.

2. Origem técnica e decisão de facturabilidade

Seleccionar IDs/versões actuais da ordem, tarefa e apontamento, autor, decisão de verificação e verificador distintos, quantidades/unidades e período de execução. Não seleccionar por descrição, último registo ou nome de técnico. Consulta da ordem exige direitos técnicos próprios; converter para rascunho exige direitos comerciais separados. Verificação técnica reconhece execução elegível; não aprova cobrança ou preço.

Origem	Proposta para o primeiro recorte
Trabalho efectivo verificado ligado à tarefa	Elegível apenas após decisão comercial explícita: ligação a serviço de catálogo e forma de cobrança aprovada
Material consumido verificado, propriedade da empresa	Elegível se comercialmente facturável, com descrição e unidade de venda compatíveis
Material do cliente	Excluído da cobrança de material por omissão; não facturar propriedade do cliente. Serviço de aplicação, se acordado, é origem comercial distinta, sem inventar consumo
Material requerido/entregue/devolvido	Não equivale a consumo facturável. Não somar entrega e consumo; não descontar novamente devolução de um consumo já líquido
Origem pendente, recusada, obsoleta ou ocorrência fora de autorização apenas reconhecida	Não elegível. Não promover reconhecimento de auditoria a verificação válida
Custo directo, orçamento, resultado industrial ou residual CIF	Não são preço, quantidade facturável ou nova origem técnica

Proposta: tarefa a preço fixo ou tempo facturável derivado dos apontamentos seleccionados, nunca ambos para a mesma parcela. Para não misturar bases, começar por tempo efectivo verificado × tarifa comercial e material consumido verificado × preço comercial por unidade; preço fixo por tarefa fica como alternativa a confirmar antes da execução. Horas humanas não se confundem com HM de máquina. Não acrescentar deslocação, mínimos, descontos, margens, IVA ou despesas sem âmbito e dados próprios.

Excluir uma origem exige motivo visível, não apagamento. A revisão mostra a lista seleccionada, as exclusões e a diferença entre recurso executado e parcela comercial. Sem cobrança automática de todos os recursos só por estarem verificados.

3. Preços de venda e compatibilidade

Proposta: preços de venda introduzidos/seleccionados explicitamente pelo preparador a partir de uma referência comercial identificada e versionada; revisor confirma preço, unidade, moeda, data de referência e condições. Não usar taxa interna de material/trabalho, custo industrial ou preço de outra versão/cliente por omissão. Não adoptar tabela de preços, moeda ou imposto por suposição.

Manter cadeias decimais exactas do contrato A (até 16 inteiros/8 decimais), sem float ou truncagem fiscal. MIN/H conserva conversão exacta. Se quantidade comercial ou preço necessário não for exactamente representável pelo contrato do rascunho, bloquear a conversão e pedir decisão explícita; não arredondar silenciosamente. Preço zero explícito e revisto é distinto de preço desconhecido. Enquanto preço, cliente ou ligação comercial estiverem pendentes, a proposta pode ser revista, mas não gerar um rascunho com zero fictício ou omissão silenciosa de linhas.

Conferir empresa/unidade, cliente, serviço seleccionado, moeda, unidade física/de venda, quantidade, período e regra de cobrança. A ordem não prova por si a identidade fiscal do cliente. A ligação de cliente/serviço é explícita; criação ou correcção de cadastro permanece no circuito existente, sem concessão implícita. Compatibilidade fiscal/aplicabilidade mantém pendências próprias; gerar rascunho não resolve exigibilidade, apuramento ou emissão.

4. Revisão e responsabilidades propostas — por confirmar

Proposta funcional: Osmane selecciona recursos, prepara ligações comerciais e preços; Samira revê/valida ou recusa a versão exacta da proposta comercial por identidade distinta. Não atribui a Samira verificação técnica, gestão de acessos ou edição dos apontamentos. A geração é feita pelo preparador a partir da proposta revista, sem alterar as parcelas aprovadas; se mudar selecção, quantidade, preço, cliente, serviço ou moeda, criar sucessora e exigir nova revisão. Provas futuras com equivalentes sintéticos, sem contas ou concessões reais novas.

Estados propostos: proposta preparada/submetida → revista ou recusada → geração do rascunho. Submissão e decisões imutáveis, com sucessora e motivo explícitos. Geração não executa uma segunda aprovação fiscal nem confirmação B1. A validação comercial desta proposta é uma decisão nova e necessita confirmação do utilizador; não decorre dos papéis aprovados para custos/orçamento.

5. Rastreabilidade e não duplicação

Cada linha gerada conserva ordem/tarefa/apontamento por ID/versão, decisão de verificação, quantidade/unidade seleccionada, conversão comercial, serviço/cadastro exacto, preço/fonte/versão, proposta/revisão e autor. Pode apresentar descrição legível da ficha, sem perder as referências. Uma linha pode agregar origens só se a composição exacta permanecer recuperável e não misturar unidades/preços/regras incompatíveis; para o primeiro recorte, recomendar uma linha por parcela comercial.

Registar a utilização comercial da identidade canónica da origem, não só do ID da sua versão. Uma correcção técnica não permite voltar a facturar a mesma parcela com novo ID. A utilização comercial não é consumo de stock ou nova imputação de custos. Não duplicar a mesma parcela em prestação e factura como se fossem duas utilizações; o vínculo acompanha a origem até ao rascunho destino único.

Proposta, revisão, vínculo à origem, linhas do rascunho, auditoria e evento/outbox são atómicos. Chave de idempotência inclui contexto, autor, acção e conteúdo; repetição recupera o mesmo rascunho, conteúdo diferente é conflito. Duas selecções concorrentes da mesma origem só permitem um destino activo; falha ou perda de resposta não deixa reserva órfã nem cria duplicados.

Primeiro recorte sem facturação parcial, repartição entre clientes ou vários destinos. Correcção após geração conserva rascunho e referências originais; assinala proposta/rascunho desactualizados e bloqueia nova geração/uso da proposta antiga. Não libertar a origem automaticamente por editar/apagar um rascunho. Substituição/cancelamento comercial requer operação explícita, auditada e compatível com o estado do destino; se essa operação não integrar o recorte, a origem permanece bloqueada e o caso é remetido a revisão. Fotografia B1 já confirmada nunca é reescrita; geração não contorna correcções ou bloqueios de emissão.

6. Critérios para futura entrega

• Demonstrar uma ordem com trabalho e material verificados, ligações comerciais explícitas e rascunho com composição recuperável, sem reintroduzir quantidades técnicas.
• Demonstrar que preço comercial pode diferir do custo interno, sem conversão automática, e que preço desconhecido impede gerar, sem virar zero. Caso zero explícito exige decisão própria.
• Recusar material do cliente, apontamento não verificado/recusado/obsoleto e ocorrência apenas reconhecida; preservar motivos e histórico.
• Recusar cobrança simultânea da tarefa fixa e dos mesmos tempos, dupla selecção, versão corrigida como nova cobrança ou dois destinos concorrentes. Entregas/devoluções não viram consumo comercial por inferência.
• Refazer proposta materialmente alterada com nova versão/revisão, sem herdar aprovação; preservar origem e rascunho anteriores. Cliente/moeda/unidade/contexto incompatíveis recusados.
• Verificar separação de identidades e permissões no servidor, contexto revisto, revogação no pedido seguinte e isolamento entre empresas/unidades; menus não são prova de autorização.
• Demonstrar idempotência, concorrência, rollback de evento/outbox e recuperação de resposta, sem vínculos/reservas órfãos.
• Regressões relevantes de oficinas, rascunhos/B1, custos e guardas; compilação e demonstração isolada com evidência e limitações explícitas. Sem emissão real, stock, recebimentos, lançamentos ou aceitação presumida.

7. Acessos e decisões novas antes de implementar

Propor direitos próprios de unidade para consulta/preparação/revisão/geração da conversão, além dos direitos de consulta às origens e de criação do rascunho destino. Não derivar de workshop.verify, direct_costs.*, industrial_budgets.* ou nomes. Nomes técnicos, contas e número de concessões só serão propostos concretamente depois de fechar o fluxo; nenhuma concessão autorizada aqui. Migração futura também separada, com destino e guardas explícitos antes de aplicação.

Decisões novas para o utilizador:

1. Confirmar facturabilidade: tempo verificado e material consumido da empresa, com material do cliente excluído, ou escolher tarefa a preço fixo em vez do tempo para a mesma parcela.
2. Confirmar fonte/forma de aprovação dos preços comerciais e moeda do ensaio; custo interno nunca determina preço automaticamente.
3. Confirmar Osmane como preparador/gerador e Samira como revisora comercial distinta, sem supervisão técnica implícita.
4. Confirmar primeiro recorte com selecção integral por origem, um rascunho por proposta e sem repartição parcial, mantendo casos posteriores bloqueados até correcção/cancelamento próprios.

Estas propostas não são decisões já acordadas nem autorização de implementação. A primeira geração no sistema e a activação operacional continuam fora desta etapa documental.

8. Confirmação posterior e proposta concreta de preços do ensaio

Em 28/10/2026, o utilizador respondeu «sim prossiga» às quatro opções apresentadas: tempo verificado e material consumido da empresa, excluindo material do cliente e dupla cobrança de tarefa/tempo; preços comerciais explícitos com fonte identificada e revisão distinta, sem derivação do custo; Osmane prepara/gera e Samira revê a versão comercial; origens integrais, uma ordem e um rascunho por proposta, sem repartição parcial. Estas decisões substituem as respectivas pendências da secção 7. Não constituem concessões reais nem autorização de utilização operacional.

A fonte concreta dos preços, os valores e a moeda não tinham sido fornecidos. Para fechar esse ponto sem usar preços reais ou inferir valores a partir do custo, fica proposta para validação a referência WORKSHOP-SALES-SYNTHETIC-v1, tabela exclusivamente sintética, moeda MZN, preços sem imposto:

Parcela comercial	Quantidade de referência técnica	Preço de venda sintético proposto	Montante sem imposto
Trabalho efectivo verificado	105 MIN = 1,75 H	200 MZN/H	350 MZN
Material da empresa consumido e verificado	2 UN	75 MZN/UN	150 MZN
Soma comercial do exemplo	Mesma ordem sintética	Sem cálculo fiscal	500 MZN

Valores ainda não aprovados. Não são tarifas do utilizador, preços de catálogo real, margens ou substitutos das taxas internas de custo. As origens técnicas do exemplo são as do percurso de oficina, reutilizadas por ID/versão, sem copiar consumos nem usar o resultado agregado de custo como origem comercial. Em futura prova, a referência e os preços exactos entram na proposta de conversão e só podem gerar rascunho depois da revisão comercial distinta. O cliente, serviços de catálogo e descrições devem ser sintéticos e explicitamente ligados, sem criar contas ou dados reais. IVA/aplicabilidade permanecem pendências separadas; 500 MZN é apenas soma de linhas sem imposto, não total fiscal ou montante exigível.

Próxima validação necessária: confirmar ou substituir a referência sintética, MZN, 200 MZN/H e 75 MZN/UN. Nenhum código, migração ou concessão implementado por esta actualização documental.

8.1 Aprovação dos valores pelo utilizador

Em 28/10/2026, o utilizador confirmou «sim» à proposta concreta acima. Ficam aprovados, exclusivamente como pressupostos sintéticos do ensaio, a referência WORKSHOP-SALES-SYNTHETIC-v1, moeda MZN e preços de venda sem imposto de 200 MZN/H e 75 MZN/UN: 105 MIN = 1,75 H → 350 MZN; 2 UN → 150 MZN; soma comercial 500 MZN. A indicação de valores por aprovar na secção anterior passa a histórica. Não se adopta política comercial real, preço derivado de custo ou tratamento fiscal.

Fechadas as decisões de facturabilidade, responsabilidades, selecção integral e base comercial deste recorte. Cada futura proposta continua a exigir revisão distinta da versão exacta antes da geração; a confirmação do desenho não constitui aprovação automática de registos no sistema. Preservar todos os checkpoints e bloqueios. Nesta etapa continua apenas a especificação: sem código, migrações, concessões, emissão, stock, lançamentos, publicação ou utilização real. Uma autorização técnica de implementação deverá delimitar provas sintéticas, direitos próprios e proposta separada de qualquer instalação em desenvolvimento.