SGF/docs/WORKSHOP_MANAGEMENT_SCOPE.md

# Oficinas e assistência técnica — âmbito para revisão

27/10/2026, Africa/Johannesburg. Versão 0.1. **Apenas especificação.** Não autoriza implementação, dados operacionais, acessos, migrações ou publicação.

## 1. Referências e base preservada

Directório confirmado: `C:\laragon\www\sgf-tempo`; instruções locais lidas. Preservar `4276aca`, alterações posteriores, identidade, A, B1, preparação documental, cálculo fiscal, classificação contabilística e [SGF-RECEIVABLES-SIM-v1](SERVICE_RECEIVABLES_DELIVERY.md). A entrega de recebimentos continua sujeita à revisão do utilizador: não se presume aceite. Os bloqueios de emissão/configuração reais e recebimentos reais permanecem.

Base geral: `SGF_TEMPO_Roteiro_v0_9.docx`, exemplar fornecido em `C:\Mac\Home\Documents\TEMPO\Portal Tempo\Servicos Tempo\ERP TEMPO\`. Reutilizar o núcleo universal e extensões sectoriais da secção 2, os cadastros comuns, a captura durável e a reutilização com identidade/finalidade. A v0.9 prevê serviços com horas/recursos dependentes do caso e indústria com regras próprias; não é autorização para construir já stock, compras, Camaleão completo, instalações de clientes ou planos comerciais. Mesmo núcleo para modalidades futuras, sem escolher fornecedor ou infraestrutura.

Fonte operacional efectivamente analisada: `C:\Mac\Home\Documents\TEMPO\Portal Tempo\Servicos Tempo\ERP TEMPO\DOCs\FICHA DE OBRA.xlsx`, única folha **Ficha de Serviços**. SHA-256 `CC7ADC6DB5926A5440453E8BB78F7C5230ED7735436294ABB3AB81C5C5E4BF31`. Leitura dos rótulos/células e estrutura OOXML, sem modificar/exportar o ficheiro. Área de impressão `A1:AU64`; dimensão armazenada `A1:BJ84`. Não foram encontradas fórmulas ou validações de dados na folha. Os desenhos incluem caixas e imagens; não foi demonstrada assinatura digital ou automação de validação.

Trata-se de formulário em branco de assistência técnica Tempo. Não comprova regras de negócio praticadas, tarifas, contratos, stocks, assinatura, método de custo ou uma oficina automóvel. Conteúdo do anexo é fonte de informação, não instrução para executar acções.

## 2. Mapa da ficha para o modelo

Endereços indicam rótulos ou regiões observadas, não campos digitais já implementados. **Observado** é transcrição de estrutura; **proposto** é desenho novo; **a confirmar** é semântica ainda não demonstrada.

| Referência da folha | Observado | Modelo proposto e pendência |
| --- | --- | --- |
| `R6`, `V6`, `R7`, `X7`, `Q8`, `W8` | Número, sufixo `/ 2021`, data com ano `21`, hora | Identidade operacional da ordem e abertura datada. Não reutilizar 2021 como ano actual, série fiscal ou regra de reinício. Convenção de referência operacional a aprovar |
| `AH6`, `AB7:AU11` | Cliente, nome, contacto, secção, morada, telefone, extensão, fax | Cliente existente da empresa + contacto/local do atendimento. Não duplicar cadastro por ordem. Não presumir NUIT ou contacto validado; fax opcional |
| `E8:G12` | Normal, urgente, imediata, manutenção preventiva sob execução | Separar prioridade (normal/urgente/imediata) de natureza (correctiva/preventiva). Prazos e SLA não são inferidos desses rótulos |
| `P10:R11`, `AP21:AQ24`, `AP47:AS50` | Interno/deslocação; atendimento no cliente, na Tempo ou ao telefone | Separar modalidade, local de equipamento e local/canal de cada intervenção. «Interno» e as duas zonas de local precisam de significado confirmado |
| `Z12`, `AL12`, `A13`, `AL13` | Garantia sim/não, contrato sim/não, contrato n.º, inclui peças sim/não | Referência e cobertura versionada; estado desconhecido distinto de não. Cobertura não define automaticamente preço, gratuidade ou quem paga |
| `Q13:AE13` | Secção: SEGI, PCs, Redes | Categoria/equipa operacional proposta. Não converter os rótulos em empresas, unidades ou permissões. Relação com a SEGI já existente a confirmar |
| `A14:S14`, `A15:AU20` | Equipamento na Tempo/no cliente; marca/modelo por unidade, número de série | Bem individual e custódia/localização. A expressão «por unidade» aqui identifica equipamento, não a unidade organizacional do SGF. Primeiro recorte: um bem por ordem |
| `AL14`, `A21:AO25` | Preenchida por; avaria ou serviço pretendido | Autor da abertura e pedido original preservado. Diagnóstico e proposta são registos posteriores distintos do relato do cliente |
| `A26:AU26` | Trabalho a executar por, recebi, data/hora | Responsáveis e passagem de responsabilidade/custódia. Confirmar quem «recebi» representa; não o tratar como recebimento de dinheiro |
| `A28:AU35` | Requisições/componentes/material aplicado; n.º requisição, datas, código, descrição, quantidade, n.º entrega, valor unitário/total, total | Referências de material e acontecimentos separados. «Quantidade» não prova consumo; «valor» não distingue custo/preço, nem mostra moeda/imposto. Não há prova de reserva, devolução ou valorização de stock |
| `A37:AU45` | Mão-de-obra, deslocações, técnicos; data, início/fim, S/N, tempo, tempo total, técnico, classe, valor total e rubricas | Intervalos/pausas, deslocações e classificação profissional a propor. `S/N` e «classe» precisam de definição; não presumir tarifa. Hora decorrida não é tempo efectivo ou facturável |
| `A46:AO56`, `AP52:AS55` | Relatório técnico; concluído não/sim/com sucesso | Relatório versionado, conclusão técnica e resultado do teste funcional separados. «Com sucesso» exige critério/evidência definidos; não implica aceite ou entrega |
| `A58:AU58` | Executado por, assinatura, data | Identificação/evidência de revisão/conclusão. Campo de assinatura em branco não comprova assinatura electrónica ou identidade verificada |
| `A61:AU62` | Cliente confirma boa execução, peças, horas e deslocações; nome/assinatura/data | Aceite com pessoa, qualidade em que intervém, data, versão e evidência; distinguir recusa/ressalvas. Não equivale a autorização prévia, pagamento ou recepção automática de factura |
| `A64:AU64` | Identificação e contactos Tempo no rodapé | Reutilizar dados aprovados do emitente. Não copiar contactos de um modelo antigo como configuração actual |

**Campos novos propostos, não observados na ficha:** ID do equipamento, proprietário/custódia, diagnóstico separado, autorização por versão/limite, pausas, tempo efectivo, decisões de facturabilidade, custo interno, moeda explícita, vínculos transaccionais ao rascunho e eventos. Matrícula, quilometragem, chassis, combustível e outros campos de automóvel são extensões opcionais, ausentes deste recorte.

## 3. Menor percurso útil e entidades

Primeiro recorte proposto: assistência técnica a um equipamento de um cliente, numa empresa/unidade, uma moeda comercial explícita, tarefas simples, apontamentos manuais verificados e um único rascunho de facturação. Sem gestão automóvel, múltiplos bens na ordem, stock real, compras, agenda optimizada, contratos recorrentes ou assinatura digital.

| Entidade | Campos e ligações essenciais |
| --- | --- |
| Ordem de trabalho | ID/ref. operacional, tenant/empresa/unidade, cliente, equipamento, pedido original, abertura, prioridade, natureza, local/canal, responsável, versão, origem da ficha e estado |
| Equipamento/bem | ID empresarial, proprietário/cliente, tipo, marca/modelo, série quando conhecida ou identificador interno quando ausente; local, custódia, acessórios/estado de entrada e evidências. Não confundir com activo contabilístico da empresa |
| Diagnóstico e proposta | Versão, tarefas/recurso esperado, limites, dependências, pressupostos e eventual orçamento com moeda, quantidades/preços propostos. Custo interno em vista protegida |
| Autorização do cliente | Versão exacta da proposta, pessoa/representação, canal, data, evidência, alcance/limite e ressalvas. Quando dispensada segundo política aprovada, guardar fundamento e responsável; ausência não é consentimento |
| Tarefa/intervenção | ID, ordem, serviço existente quando compatível, objectivo, técnico, resultado, intervalos/pausas, recursos, versão da autorização abrangente e evidências |
| Apontamento de tempo | Técnico/recurso estável, ordem/tarefa, início/fim com zona, pausas, tipo trabalho/deslocação, tempo efectivo verificado e estado; facturabilidade separada |
| Material na ordem | Identidade/designação/unidade, proprietário empresa/cliente, origem, quantidades por acontecimento, documento/referência e evidência. Consumo técnico observado não é saída de inventário |
| Decisão técnica/comercial | Linhas/versões revistas; quantidade executada/consumida versus facturável, preço, custo com estado conhecido/provisório/em falta/não aplicável, motivo e actor; contrato/garantia/retrabalho/cortesia identificados |
| Relatório, aceite e entrega | Relatório técnico versionado, testes/resultados, conclusão; aceite distinto com ressalvas/recusa; entrega física/remota e custódia, destinatário, data/evidência. Nada implica pagamento |
| Preparação de facturação | Versão revista da ordem e linhas, IDs de prestação/rascunho existentes ou gerados controladamente, ligações por linha/quantidade, estado da conversão e chave de comando |
| Histórico/eventos | Origem/versão, autor, instantes, motivo, âmbito, correlação e schema; aprovação e efeitos ligados ao conteúdo exacto, sem segredos ou dados pessoais desnecessários |

Cliente e serviços pertencem à empresa e são reutilizados entre unidades autorizadas. Equipamento identificado pela empresa e proprietário, consultável apenas para finalidades/âmbitos permitidos; localizar um equipamento não dá acesso às ordens de outra unidade. A ordem, seus recursos e operações pertencem à unidade e não podem ser transferidos por um campo do formulário. Evitar recolher credenciais de dispositivos, palavras-passe, PINs ou conteúdo pessoal em notas/anexos; descrever apenas evidência necessária.

## 4. Estados e transições

Percurso: abertura → diagnóstico/proposta → autorização quando aplicável → execução → revisão técnica/comercial → aceite/entrega → preparação de rascunho. Estados próprios evitam um único «concluído» que esconda trabalho pendente.

| Dimensão | Estados/transições propostos e condições |
| --- | --- |
| Ordem operacional | Aberta → em diagnóstico → proposta preparada → autorizada/em execução → execução terminada → em revisão → concluída tecnicamente. Pode aguardar informação/material/cliente com motivo; cancelamento preserva trabalho/custos/evidência já registados |
| Autorização | Não avaliada / necessária pendente / autorizada parcialmente ou integralmente / recusada / dispensa fundamentada. Só tarefas cobertas pela versão autorizada/dispensa validada podem iniciar execução |
| Tarefa | Planeada → autorizada → em execução/pausada → executada → verificada; não aplicável/cancelada com motivo. Nova tarefa fora do alcance aprovado exige alteração de proposta e decisão própria |
| Aceite do cliente | Pendente / aceite / aceite com ressalvas / recusado / não aplicável fundamentado. Conclusão técnica não altera automaticamente este estado |
| Entrega/custódia | Não entregue / pronta para entrega / entregue com evidência; atendimento remoto pode ter entrega do resultado ou não aplicabilidade fundamentada. Não deduzir entrega da assinatura de execução |
| Facturação | Não revista / pendente de decisão comercial / linhas aprovadas / preparada em rascunho / convertida por ligação. Não mostrar «facturada» por criar rascunho. Emissão continua bloqueada |

Proposta inicial: conversão só após revisão técnica e comercial concluídas e aceite/entrega resolvidos (incluindo não aplicabilidade fundamentada). Facturar antes de entrega ou sob disputa é extensão sujeita a regra própria, não efeito de urgência. Trabalho urgente não dispensa autorização automaticamente. Alteração material de tarefa, quantidade, limite ou preço gera nova versão e revalidação apenas do que afecta; autorizações antigas não abrangem automaticamente o acréscimo. Garantir possibilidade de guardar diagnóstico/pedido incompletos sem fingir aprovação.

Conclusão e reabertura técnica exigem actor autorizado, motivo e nova versão. Relatório/aceite históricos não se apagam; novas evidências referem a versão e eventuais ressalvas. Se uma ordem já originou rascunho, a reabertura marca-o desactualizado; nunca reescreve B1, fotografia ou documento emitido de teste.

## 5. Tempos e deslocações

- Registar instantes completos, data e zona, com fim posterior ao início, pausas dentro do intervalo e sem sobreposição entre pausas. Intervalo incompleto não é zero horas nem trabalho confirmado. Rejeitar duração negativa e fim anterior; passagem de dia é permitida com datas explícitas.
- Tempo efectivo de uma intervenção = união dos intervalos de trabalho verificados menos pausas verificadas; conservar componentes. Mostrar também duração decorrida. Registo manual precisa de origem/autor/validação, não de cronómetro fictício.
- Unidade canónica proposta: minuto inteiro; guardar instantes com precisão de segundo e rejeitar confirmação de durações não representáveis nessa unidade até definir política. Conversão para horas usa minutos/60 exactamente; se decimal não finito, conservar razão exacta e mostrar precisão/pendência de representação, sem truncar silenciosamente.
- Bloquear dois intervalos activos ou confirmados sobrepostos para o mesmo técnico/recurso entre ordens da mesma empresa, incluindo SQL/concorrência na futura implementação. Trabalho simultâneo real exige repartição documentada cuja soma não exceda o tempo disponível, como extensão. Dois técnicos podem trabalhar em paralelo, cada um com o seu apontamento; somar horas-pessoa, sem duplicar o intervalo individual.
- Deslocação tem ID, origem/destino minimizados, técnico/recurso, datas, duração e unidade comercial própria (viagem, tempo, distância apenas se acordada). Não somar o mesmo intervalo como trabalho e deslocação. «Deslocação S/N» não determina custo, tarifa, quilómetros ou quantidade facturável.
- Tempo facturável é decisão comercial distinta. Contrato, garantia e retrabalho conservam tempo/custo mesmo quando a quantidade comercial for zero com decisão explícita. Não derivar preço de «classe» sem tabela aprovada/versionada.

## 6. Materiais, custos e decisão comercial

| Conceito | Significado e controlo proposto |
| --- | --- |
| Requerido | Necessidade planeada; não prova disponibilidade, reserva ou custo |
| Reservado | Compromisso de disponibilidade por sistema de stock; **indisponível no primeiro recorte**, porque não há stock operacional implementado |
| Entregue | Passagem física/custódia documentada à equipa/cliente; não implica instalação ou consumo |
| Consumido/aplicado | Observação técnica verificada de utilização na ordem; quantidade positiva, unidade, origem e autor. Não é movimento de inventário confirmado pelo SGF |
| Devolvido | Retorno físico de quantidade entregue não utilizada, com destinatário/evidência; não reverte consumo que ocorreu. Rectificar consumo exige operação compensatória própria |

Para material em custódia verificada na ordem: entregue = consumido + devolvido + remanescente + outras saídas/perdas explicitamente justificadas, na mesma unidade e corte. Enquanto faltar uma parcela/evidência, mostrar divergência ou pendência, não criar reserva/entrada/saída para fechar a soma. Consumo acima do entregue confirmado requer origem suplementar documentada, não sobreposição ou saldo físico negativo oculto. Materiais adquiridos/levados directamente ao cliente requerem origem equivalente; não inventar n.º de requisição.

Primeiro recorte propõe registo operacional de material observado, com documentos externos ou evidência sintética; sem saldo de armazém, disponibilidade garantida, método de valorização ou encomenda. Futuro stock será dono do movimento físico/económico canónico, e a ordem ligará esse mesmo ID em vez de criar outro consumo. Uma linha de factura não é fonte de saída de material.

Material da empresa e material fornecido pelo cliente têm propriedade/custódia distintas. Material do cliente não se torna compra, activo ou custo de aquisição da empresa e não se vende por omissão; eventuais custos de manuseamento/intervenção ficam separados. Se precisar de valorização para seguro/custódia, é outra finalidade e regra, não custo de produção ou preço de venda.

Para cada recurso, guardar separadamente quantidade real verificada, quantidade comercial aprovada, unidade, custo interno unitário/total e fonte/versão/estado, preço proposto/versão e motivo de diferença. Custo ausente é `null` com pendência, não zero. Zero só com fundamento confirmado; preço não substitui custo. Se a soma de custos estiver incompleta, mostrar subtotal conhecido e componentes em falta, sem custo total ou margem completa.

Contrato, garantia, retrabalho e cortesia identificam um motivo a avaliar: responsável comercial decide cobertura, destinatário da cobrança, quantidades/preço e eventual exclusão. Primeiro recorte só um cliente pagador; cobrança a fabricante/seguradora é extensão. Proposta: quantidade facturável não excede quantidade verificada sem justificação comercial específica; mínimos, pacotes, tarifa fixa ou cobrança por resultado requerem regra própria e não são inventados. Uma quantidade comercial zero exige decisão explícita e conserva custo/consumo.

## 7. Conversão controlada para rascunho

1. Rever versão exacta da ordem, autorizações/dispensas, execução verificada, relatório, aceite/entrega, decisão comercial por linha, moeda/unidades e permissões. Fixar revisão com linhas elegíveis e linhas excluídas/motivos. Informação fiscal em falta permanece pendência do rascunho, não imposto zero.
2. Converter por comando explícito e idempotente: origem/versão de cada intervenção ou consumo, quantidade comercial aprovada, serviço/descrição/unidade, preço e preparação documental reutilizados. Criar/ligar uma prestação de A e um rascunho de facturação, **sem duplicar execução, apontamentos ou consumo**. A prestação é uma referência comercial derivada, não outro acontecimento técnico.
3. Primeiro recorte: uma ordem → uma prestação derivada → um rascunho, com unicidade na base por ordem e por linha de origem seleccionada. Sem agrupamento de ordens ou facturação parcial. Essas extensões exigem quantidades já convertidas/reservadas e concorrência por saldo, não apenas retirar a unicidade.
4. Linhas de mão-de-obra/prestações usam catálogo de serviços existente. Materiais exigem tipo de linha comercial compatível; A suporta actualmente linhas de serviço. **Não representar uma peça como serviço fictício só para converter.** Propor delta explícito de tipo de linha material, sem stock nem reconhecimento, antes de executar esse recorte; alternativa de facturação por pacote só se for a realidade comercial aprovada. Esta dependência não está já entregue.
5. Transacção única para prestação/rascunho, vínculos de origem, revisão, auditoria, evento e resultado do comando. Mesma chave/conteúdo recupera IDs; chave alterada não duplica a ordem/linha já convertida. Mesmo comando com conteúdo diferente é conflito. Falha antes do commit desfaz o conjunto; resposta perdida após commit recupera o mesmo rascunho.
6. Não sincronizar silenciosamente edições posteriores. Alteração da ordem invalida prontidão do rascunho e exige revisão explícita da ligação/versões. Um rascunho modificado comercialmente também torna a revisão anterior incompatível; não permitir contornar origem/quantidade por edição livre. B1 e documentos históricos continuam imutáveis; alteração após confirmação requer novo âmbito, sem duplicar ou renumerar.

Criar rascunho não emite factura, gera receita contabilística, obrigação exigível ou recebimento. Reutilizar [preparação documental](DOCUMENT_PREPARATION_DELIVERY.md), [pré-visualização](DRAFT_INVOICE_PREVIEW_DELIVERY.md) e suas pendências; não retirar bloqueios fiscais para demonstrar oficina.

## 8. Responsabilidades e acessos propostos por função

São funções a designar, sem atribuição automática a Osmane, Samira ou técnicos. A delegação pode ser parametrizada com alcance, vigência e auditoria; não impor número fixo de pessoas nem presumir delegação a partir do login.

| Função proposta | Acções delimitadas | Exclusões |
| --- | --- | --- |
| Atendimento | Abrir ordem, ligar cliente/equipamento, registar pedido/custódia e evidência de autorização/entrega | Não confirma cobertura comercial, custos, margem ou assinatura digital |
| Responsável técnico | Diagnóstico/proposta técnica, distribuição, validar apontamentos/consumo, concluir/reabrir e validar relatório | Não decide preços/garantia ou concede acesso a custos por ser técnico |
| Técnico executor | Consultar ordens atribuídas, registar intervenções/tempos/materiais observados e relatório preliminar | Sem consulta de margens/custos alheios, revisão comercial, conversão ou administração por omissão |
| Responsável comercial | Validar cobertura, preço e quantidade facturável, motivos de exclusão; autorizar conversão de linhas revistas | Não valida automaticamente tempo executado, custo ou fiscalidade |
| Validador de custos | Conferir custo/fonte/versão e acesso limitado aos dados necessários | Não altera preço, salário de origem ou stock por esta função |
| Preparação de facturação | Converter revisão aprovada e consultar vínculos/rascunho com direitos próprios de A/documentais | Sem emissão, recebimentos, acesso a custos ou administração implícitos |
| Consulta operacional / análise de custos | Direitos separados para ordem operacional e para custo/margem autorizados | Consulta de ordem não dá dados de remuneração, custo ou margem |

Catálogo proposto de direitos, cada qual explícito: `work_orders.view/create/assign/diagnose/execute/review_technical/record_authorization/record_acceptance/record_delivery/review_commercial/prepare_billing`; `work_order_costs.view/validate`; `work_order_margins.view`. Âmbito de empresa/unidade e, quando aplicável, atribuição ao técnico. Nomes são proposta técnica, não permissões instaladas. Registar autorização/aceite é conservar evidência, não representar o cliente sem suporte. Acesso aos cadastros empresariais não revela intervenções de outras unidades. Exportações/eventos/modelos de leitura também filtram custos e dados pessoais.

## 9. Cenário sintético

Empresa Exemplo, Unidade Técnica, Cliente Exemplo, ordem `OT-TEST-1`, equipamento PC de teste `EQ-1`/série `SER-TEST-1`. Moeda comercial e de custo **MZN explicitamente definida**. Valores inventados apenas para demonstrar o desenho; sem perfil fiscal, stock ou operação real. Pedido: diagnóstico e reparação simples. Proposta v1 autorizada, relatório v1 verificado, aceite e entrega registados separadamente com evidências artificiais.

| Recurso e unidade | Quantidade executada/consumida | Custo unitário conhecido | Custo conhecido | Quantidade facturável aprovada | Preço unitário proposto, antes de imposto por apurar | Valor comercial proposto |
| --- | ---: | ---: | ---: | ---: | ---: | ---: |
| Cabo de teste da empresa, UN | 2 | 120,00 | 240,00 | 2 | 180,00 | 360,00 |
| Reparação, H | 1,75 | 200,00/H | 350,00 | 1,75 | 600,00/H | 1 050,00 |
| Teste adicional, H, não facturável por cortesia expressamente aprovada | 0,25 | 200,00/H | 50,00 | 0 | Não aplicável à linha excluída | 0,00, por decisão comercial |
| Deslocação, VIAGEM | 1 | 150,00/VIAGEM | 150,00 | 1 | 200,00/VIAGEM | 200,00 |
| Totais deste conjunto de recursos | — | — | **790,00** | — | — | **1 610,00 MZN**, antes de imposto por apurar |

Reparação: 09:00–11:00, pausa 10:00–10:15 → 105 minutos = 1,75 H. Teste adicional: 11:00–11:15 → 15 minutos; deslocação 11:15–11:45 → 30 minutos, registada separadamente e comercializada por viagem, não como mais 0,5 H de reparação. Não há sobreposição do técnico. Material: 3 UN entregues segundo evidência sintética, 2 consumidas e 1 devolvida; 3 = 2 + 1. Não é movimento de armazém ou confirmação de disponibilidade.

O custo 790,00 cobre só os quatro recursos do exemplo, não custos indirectos completos. A diferença 1 610 − 790 = 820,00 é diferença sobre custos identificados, **não margem completa comprovada nem lucro**. IVA e total com imposto permanecem por apurar; não aplicar 16% por hábito.

Variante: custo unitário do cabo desconhecido → custo do cabo pendente, subtotal conhecido 350 + 50 + 150 = **550,00**; custo total e diferença/margem indisponíveis. O preço proposto de 360 não preenche o custo em falta. Material fornecido pelo cliente, se acrescentado, conserva propriedade e evidência, sem preço/custo de aquisição da empresa presumidos.

## 10. Reutilização concreta e dependências

| Base existente | Reutilização | O que falta construir |
| --- | --- | --- |
| Identidade/contexto/empresa/unidade e auditoria | Mesma sessão, pertenças, CSRF, revisão de contexto e direitos explícitos | Direitos sectoriais e atribuição operacional, sem herança automática |
| Clientes e serviços de A | IDs e versões empresariais existentes, mesma preparação documental | Bem individual, ordem, intervenções/recursos e ligações comerciais por origem |
| Tempos/material | Não foi identificado módulo operacional entregue destas matérias nas entregas consultadas | Registo verificado de tempo/custódia/consumo observado; não declarar stock ou folha salarial existentes |
| B1 e documentos/pré-visualização | Fotografias e pendências preservadas; consulta histórica separada | Conversão controlada e, se aprovado, linhas comerciais de material sem stock fictício |
| Classificação contabilística | Categorias/associações aprovadas podem ser referidas sob âmbito e vigência | Não resolvem custeio, reconhecimento, IVA ou propriedade do equipamento |
| Eventos/outbox/comandos | Reutilizar padrão transaccional, idempotência e histórico, com novos tipos/versões | Eventos de ordem/tempo/consumo/revisão/conversão; nenhum consumidor contabilístico activado |
| Recebimentos sintéticos | Preservar entrega e semânticas separadas | Nenhum vínculo automático da ordem/aceite a recebimento, dívida ou reconciliação |

Reservas/stock, compras, remunerações, contratos/garantias automatizados, assinatura electrónica, múltiplas localizações e tarifários são dependências/extensões, não capacidades presumidas. Referências manuais verificadas podem servir ao primeiro recorte, claramente sem garantia de integração. A base comum de recursos/quantidades/eventos deve ser coordenada com [custos industriais](INDUSTRIAL_COST_ACCOUNTING_SCOPE.md); uma ordem técnica não vira ordem de produção automaticamente.

## 11. Critérios de aceitação futuros

- Demonstrar ordem de um equipamento até rascunho sem recapturar cliente, tarefa, tempo, material e preço já aprovados. Linha de cortesia permanece na história e fora do montante facturável.
- Ausência de série/equipamento identificável, cobertura, autorização necessária ou decisão comercial produz pendência específica. Guardar pedido incompleto não o declara autorizado ou pronto a facturar.
- Conclusão técnica, teste funcional, aceite, entrega e rascunho mantêm estados independentes; recusa/ressalva do cliente não desaparece. Rubrica em formulário não se apresenta como assinatura digital validada.
- Intervalos/pausas inválidos, sobreposição individual e duplo cômputo trabalho/deslocação recusados, inclusive entre duas ordens concorrentes. Conversões de unidades exactas, sem arredondamento silencioso.
- Quantidades requerida/reservada/entregue/consumida/devolvida distintas; sem stock instalado não apresentar saldo de armazém ou reserva confirmada. Custo desconhecido não vira zero/preço de venda.
- Revisão/comando antigo, alteração de autorização, edição posterior da ordem/rascunho e resposta perdida não duplicam prestação, material, rascunho ou vínculo de origem. Converter duas vezes com chaves diferentes também não duplica.
- Falha injectada em auditoria/outbox desfaz conversão integral; retry recupera resultado. Histórico confirmado protegido também contra SQL em massa. Nova versão/correcção referencia originais.
- Negar URL/API/tarefa para empresa irmã do mesmo tenant, unidade ou ordem não atribuída. Revogação e troca de contexto têm efeito no pedido seguinte. Técnico/consulta operacional não vê custos/margens por respostas API, eventos ou exportação.
- Provas futuras só com fixtures sintéticas e `sgf_tempo_test`, login real na instância isolada, guardas preservadas. Não é necessário executar testes para esta especificação documental.

## 12. Decisões novas e menor incremento proposto

Proposta **WORKSHOP-ASSISTANCE-DRAFT-v1**: uma ordem/equipamento/cliente/unidade, diagnóstico/proposta versionada, autorização registada com evidência, intervenções/tempos e materiais observados, revisão técnica/comercial, aceite/entrega e conversão única para rascunho. Sem stock/compras/produção, assinatura digital, factura/recebimento ou lançamento. Para materiais na conversão, incluir explicitamente o delta mínimo de tipo de linha comercial ou restringir a conversão a serviços por decisão de âmbito, sem ocultar peças como serviços.

Decisões que efectivamente alteram o desenho:

1. **Recorte comercial de materiais:** converter peças discriminadas no rascunho (com delta de linha material) ou começar apenas pelos serviços mantendo materiais como recursos de custo? Recomendação: discriminadas se a ficha representar a prática comercial; não presumir.
2. **Autorizações e evidências:** em que casos se exige autorização antes de diagnóstico/execução, quem pode fundamentar dispensa e que evidências de aceite/entrega são admitidas? Proposta: referência documental/manual verificada, sem assinatura digital.
3. **Funções e confidencialidade:** designar responsáveis e alcance de ordens atribuídas, revisão técnica/comercial e custo/margem. Nenhuma conta recebe poderes nesta proposta.
4. **Semântica da ficha:** confirmar «S/N» de deslocação, «classe» do técnico, «interno», «recebi» e secção SEGI/PCs/Redes apenas quando forem activados; manter campos neutros/pendentes até lá. Não bloqueiam a especificação nem autorizam fórmulas presumidas.

Referência de numeração operacional, unidade canónica de tempo e regra de revisão da conversão serão fechadas no recorte de execução, sem configurar série fiscal. Não é necessário reabrir as decisões aceites de identidade, contabilidade ou cálculo para aprovar esta componente documental. Nada foi implementado ou alterado nas entregas existentes nesta etapa.

## 13. Primeiro recorte coordenado — ordem e recursos

Em 27/10/2026, o utilizador propôs começar pela ordem de oficina com materiais e tempos de origem identificada, para alimentar custos posteriormente sem duplicação. Esta orientação reduz a primeira entrega face a `WORKSHOP-ASSISTANCE-DRAFT-v1`: **não inclui ainda conversão para facturação**. O âmbito técnico abaixo é proposta concreta de delimitação, não ordem de implementação ou concessão de direitos. A aceitação de recebimentos permanece separada.

### Base partilhada confirmada no desenho

| Base comum | Registo único | Uso posterior sem recaptura |
| --- | --- | --- |
| Empresa/unidade, recurso e unidade de medida | Identidades e âmbito explícitos da ocorrência | Filtrar e validar destino da análise; nunca abrir outra unidade por herança |
| Material aplicado/devolvido | ID do acontecimento, quantidade, propriedade, ordem/tarefa, data, fonte e versão | Acrescentar valorização e destino de custo ligados ao mesmo ID; não inserir outro consumo |
| Tempo de técnico/recurso | Intervalos/pausas e tempo efectivo verificado, com ID e versão | Aplicar taxa/composição de custo futura com fonte própria; não copiar apontamento como outra hora trabalhada |
| Origem, histórico e eventos | Referência da evidência, autor, instante, correcções e correlação | Calcular sob versões explícitas; repetição do evento não duplica recurso ou custo |

Identidade/contexto, clientes/serviços e padrões de auditoria/eventos já existem. Apontamentos de tempo, acontecimentos de material, ordem de oficina e motor industrial continuam por construir. Uma base comum de desenho não significa capacidades já instaladas.

### Proposta `WORKSHOP-RESOURCE-RECORD-v1`

1. **Abrir uma ordem** de uma empresa/unidade, um cliente e um equipamento identificados, com pedido, localização, responsável e referência da autorização/evidência quando necessária. Reutilizar cliente e serviço existentes quando aplicáveis. Sem motor de orçamentos/contratos; ausência de autorização necessária mantém pendência e impede apresentar trabalho como autorizado.
2. **Registar tarefas/intervenções e tempos**, com técnico, início/fim, pausas, tipo trabalho/deslocação, tempo efectivo e evidência. Aplicar as validações da secção 5, incluindo sobreposição do mesmo recurso entre ordens. Não calcular automaticamente horas facturáveis.
3. **Registar materiais observados**, identificando recurso, unidade, proprietário empresa/cliente, fonte e ocorrências de entrega, aplicação e devolução quando efectivamente conhecidas. Informação incompleta fica pendente. Sem reserva, disponibilidade ou movimento de inventário simulado.
4. **Rever e verificar os apontamentos** por função autorizada; conservar divergências e versões. Estados mínimos da ordem: aberta, em registo, a aguardar informação, em revisão e registos verificados. Esta última expressão não significa conclusão técnica, aceite, entrega, facturação ou fecho contabilístico.
5. **Consultar a ficha e o histórico** com totais de quantidades por unidade e tempos por recurso, separando declarado de verificado. Custos, preços e margens não são calculados nesta entrega. O modelo reserva ligações futuras de valorização, sem preencher custo ausente com zero.

Cada acontecimento conserva ID estável, versão, empresa/unidade, ordem/tarefa, recurso, quantidade/unidade, data efectiva, data de registo, autor, fonte/evidência e estado de verificação. Correcções referem o original por nova versão/compensação, sem apagar a origem. Futuro custeio referencia `origem + versão + parcela`, não uma cópia física do consumo.

**Fora deste primeiro recorte:** orçamento completo, garantia/contrato automatizados, revisão comercial/preços, aceite/entrega completos, conversão para prestação/rascunho, linhas materiais de factura, stock/compras, custo industrial, imputação de indirectos, margem, produção, emissão e recebimentos. Essas partes permanecem na visão das secções anteriores; não são dependências ocultas da captura inicial.

Prova mínima futura: uma ordem/equipamento, um técnico, material com 3 UN entregues, 2 aplicadas e 1 devolvida; trabalho 09:00–11:00 com pausa de 15 minutos, resultando em 105 minutos efectivos. Repetição/falha não duplicam ocorrências; correcção preserva original; sobreposição e acesso cruzado são recusados. Quantidades verificadas ficam prontas para ligação a custos, **sem gerar um cálculo de custo ou produção**. Demonstração proposta exclusivamente sintética em `sgf_tempo_test`.

Decisões restantes para preparar execução: designar funções/âmbitos de abertura, apontamento e verificação; definir evidência mínima e política de autorização do trabalho; confirmar se a referência simples de material e apontamento manual bastam ao primeiro piloto. Não é necessário escolher agora método industrial, tarifas, margem, regra fiscal ou linha comercial de material. Nenhum acesso é atribuído por este registo; migração/concessões futuras serão apresentadas concretamente antes da aplicação conforme o âmbito que vier a ser autorizado.

### Responsabilidades e autorização — proposta posterior do utilizador

Em 27/10/2026, o utilizador propôs o seguinte desenho para este recorte. Esta especificação incorpora a proposta, sem a converter em concessões ou autorização de implementação:

| Função | Responsabilidade delimitada | Titular / estado |
| --- | --- | --- |
| Abertura e atribuição | Abrir a ordem, atribuir responsável e registar evidência da autorização do cliente | Osmane, conforme proposta do utilizador; não significa acesso já concedido |
| Técnico responsável | Registar tarefas, tempos e materiais das ordens atribuídas | Pessoa real ainda não indicada; identidade sintética própria nos futuros testes |
| Verificação técnica dos apontamentos | Verificar/recusar versão exacta dos registos, com motivo e histórico | Outra pessoa autorizada, ainda não indicada; identidade sintética distinta nos futuros testes |

Samira não recebe supervisão técnica pela sua função contabilística/fiscal ou pelos direitos de recebimentos. A verificação exige identidade diferente do autor do apontamento; atribuir uma ordem não concede automaticamente capacidade de verificar. Todas as funções continuam limitadas à empresa/unidade e às ordens autorizadas, sem custos/margens ou administração implícitos.

**Evidência mínima de autorização:** quem autorizou e a qualidade em que representa o cliente, data, canal, trabalho abrangido e referência ao comprovativo ou contrato. Ligar ao conteúdo/versão da proposta ou descrição de trabalho revista. O operador que regista a evidência e a pessoa do cliente que autorizou ficam identificados separadamente. A referência isolada a um contrato não prova que o trabalho concreto está coberto.

Abrir a ordem permite preparar/atribuir o pedido, mas **não autoriza execução**. Trabalho sem cobertura demonstrada mantém pendência; cada alteração ao alcance aprovado conserva autor, data, motivo e nova versão, com autorização complementar quando necessária. Não ampliar silenciosamente a autorização anterior nem apagar o âmbito que já foi executado.

É possível preparar o desenho e, após autorização de implementação, provar o percurso com funções de abertura, execução e verificação sintéticas distintas, sem escolher titulares reais ou lhes atribuir direitos. Nomes/contas reais do técnico e do verificador permanecem pendentes apenas para aplicação real; não se pede essa identificação como condição de concluir esta especificação. A aceitação de recebimentos permanece independente.

## 14. Execução técnica posterior e ocorrência já acontecida

Em 27/10/2026, o utilizador autorizou expressamente executar código e testes do primeiro recorte e acrescentou que bloquear início não pode impedir relatar ocorrência passada para auditoria. Essa ordem substitui as restrições anteriores de etapa apenas documental **somente no âmbito sintético delimitado**. Resultado e limites em [WORKSHOP_RESOURCE_DELIVERY.md](WORKSHOP_RESOURCE_DELIVERY.md).

O comando de início exige autorização compatível. O relato retrospectivo conserva autor, data, tarefa/versão, origem/evidência e marca de fora do âmbito quando não havia cobertura demonstrada. Nova autorização não reescreve esse relato. Verificador distinto pode reconhecer o facto para auditoria ou recusar; não o promove automaticamente a execução autorizada ou apontamento verificado. Correcção mantém história e exige nova decisão.

Migração `080000` em desenvolvimento, concessões reais e activação operacional continuam pendentes de autorizações específicas. Não criar técnicos/verificadores reais por suposição. Não altera a aceitação separada de recebimentos, os bloqueios fiscais ou as extensões documentais de custos industriais. Entrega técnica não constitui aceitação do utilizador.