Files
SGF/docs/WORKSHOP_MANAGEMENT_SCOPE.md
T
nala 21a91f2aff Accept isolated WORKSHOP-RESOURCE-RECORD-v1 delivery
Record explicit workshop acceptance and preserve subsequent synthetic work without accepting receivables. Keep 080000/070000 unapplied, real workshop grants pending and operational issuance blocks intact. Exclude local credentials and real-data preservation reports.
2026-10-27 11:28:34 +02:00

40 KiB
Raw Blame History

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. 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, pré-visualização 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; 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.

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.