Acabamento: Contagem Manual
Release Notes — Contagem Manual de Vias, Exclusão com Aviso e Duplicar
Versão / Atividade: 031 (Cadastro de Contagem Manual de Vias) Público: usuário final da gráfica (operação/orçamentista) e responsável por homologar O que entra nesta entrega:
- Novo acabamento "Contagem Manual de Vias" — cadastra quanto tempo leva para contar uma quantidade de folhas.
- Exclusão que avisa o que está no caminho — ao tentar excluir um grupo de insumo ou uma atividade que está em uso, o sistema mostra o que está bloqueando em vez de dar um erro seco ou apagar coisas em cascata.
- Botão "Duplicar" em Atividades, Grupos de Insumo, Modelos de Produto e Acabamentos.
1. O que mudou, em uma frase
Agora dá para cadastrar a contagem manual de vias (o tempo para contar X folhas) como um acabamento; quando você tentar excluir um grupo de insumo ou uma atividade que ainda está sendo usado, o sistema lista quem está usando para você resolver antes; e você ganha o botão Duplicar em mais quatro cadastros.
2. Conceitos (para explicar ao usuário final)
🔢 Contagem Manual de Vias (novo acabamento)
Mais um tipo de acabamento, para quando alguém conta as folhas à mão. Você cadastra uma referência: quanto tempo leva para contar uma certa quantidade de folhas — por exemplo, 1 hora (60 minutos) para contar 100 folhas — e o valor por hora do serviço.
| Campo | O que é |
|---|---|
| Valor por hora (R$/h) | Quanto custa a hora de quem faz a contagem |
| Quantidade de folhas | Quantas folhas se conta na referência (ex.: 100) |
| Tempo (minutos) | Quanto tempo leva para contar essa quantidade (ex.: 60) |
🧮 Como o orçamento usa (etapa futura): a partir da referência, o sistema calcula proporcionalmente o tempo para a quantidade pedida. Ex.: com "60 min para 100 folhas" a R$ 53,00/h, contar 450 folhas leva 270 minutos (4,5 h) = R$ 238,50.
💡 O valor por hora é o mesmo campo de valor-hora que todo acabamento já tem — não é um campo novo. A parte específica da contagem são só a quantidade de folhas e o tempo.
🚫 Exclusão que mostra o que está bloqueando
Ao excluir um cadastro que ainda está em uso, o sistema não apaga nada em cascata. Em vez disso, mostra quem depende daquele item, para você decidir o que fazer:
- Excluir Grupo de Insumo: os insumos e papéis que estão no grupo deixam de bloquear — eles apenas saem do grupo (o insumo/papel continua existindo, só fica "sem grupo"). Mas se alguma atividade consome aquele grupo, a exclusão é bloqueada e o sistema lista as atividades que precisam ser ajustadas antes.
- Excluir Atividade: se a atividade faz parte de algum modelo de produto, a exclusão é bloqueada e o sistema lista os modelos que a utilizam.
Em ambos os casos aparece uma janela com a lista dos itens bloqueadores, que fica na tela até você fechar (não é um aviso que some sozinho).
📄 Duplicar (Atividades, Grupos, Modelos e Acabamentos)
Botão "Duplicar" na lista desses quatro cadastros. Ele abre o formulário de cadastro já preenchido com os dados do item escolhido e o nome sufixado com "(cópia)". Você ajusta o que quiser e salva — cria um novo registro, sem alterar o original. É o mesmo comportamento que o Insumo já tinha.
O que cada cópia traz:
| Cadastro | A cópia já vem com |
|---|---|
| Acabamento | A configuração do tipo (tempos/valores) e, na Intercalação de Vias, as posições cadastradas |
| Atividade | Tipo, máquina, acabamento e o consumo de insumo (quantidade + base) |
| Modelo de Produto | A lista de atividades do modelo (fixas e complementares) |
| Grupo de Insumo | Nome, unidade de medida e os papéis do grupo — sem os insumos (veja abaixo) |
⚠️ Por que a cópia do grupo não traz os insumos: cada insumo pode pertencer a um único grupo. Se a cópia levasse os insumos junto, eles sairiam do grupo original — deixando-o vazio. Então a cópia vem sem insumos (você escolhe os da cópia na hora) e com os papéis (um papel pode estar em vários grupos, sem prejuízo ao original).
3. Onde acessar (menu lateral)
| Função | Caminho no menu |
|---|---|
| Contagem Manual de Vias | Acabamentos → Contagem Manual de Vias |
| Duplicar acabamento | Acabamentos → (qualquer tipo) → botão Duplicar na lista |
| Duplicar atividade | Produção → Atividades → botão Duplicar na lista |
| Duplicar modelo | Produção → Modelos de Produto → botão Duplicar na lista |
| Duplicar grupo de insumo | Insumos → Grupos de Insumo → botão Duplicar na lista |
💡 Se não encontrar um item, clique no título do grupo ("Acabamentos", "Insumos", "Produção") para abrir o submenu.
4. Roteiro de testes (para homologação pelo cliente)
Use uma empresa (tenant) de teste.
Passo 1 — Cadastrar a Contagem Manual de Vias
- Vá em Acabamentos → Contagem Manual de Vias → Novo acabamento.
- Preencha: valor por hora (ex.: R$ 53,00), quantidade de folhas (ex.: 100) e tempo em minutos (ex.: 60). Salve.
- ✅ Esperado: o acabamento aparece na listagem. Ao reabrir para editar, os três campos voltam preenchidos.
Passo 2 — Duplicar (nos quatro cadastros)
- Em Acabamentos, Atividades, Modelos de Produto e Grupos de Insumo, clique em Duplicar em um item existente.
- ✅ Esperado: abre o cadastro já preenchido, com o nome terminando em "(cópia)". Ao salvar, cria um novo registro e o original permanece intacto.
- Grupo de insumo (atenção): a cópia deve vir com os papéis do grupo original, mas sem os insumos. Confira que o grupo original continua com os seus insumos normalmente.
Passo 3 — Exclusão bloqueada com lista (grupo em uso por atividade)
- Tenha um grupo de insumo que seja consumido por uma atividade (crie a atividade consumindo o grupo, se necessário).
- Tente excluir o grupo.
- ✅ Esperado: a exclusão é bloqueada e aparece uma janela listando a(s) atividade(s) que usam o grupo. Nada é excluído.
Passo 4 — Exclusão de grupo com insumos/papéis dentro (deve funcionar)
- Tenha um grupo com insumos e/ou papéis, mas sem nenhuma atividade usando-o.
- Confirme a exclusão (a mensagem avisa que os insumos e papéis não serão excluídos, apenas sairão do grupo).
- ✅ Esperado: o grupo é excluído; os insumos e papéis continuam existindo, apenas ficam sem grupo.
Passo 5 — Exclusão bloqueada com lista (atividade em modelo)
- Tenha uma atividade que faça parte de um ou mais modelos de produto.
- Tente excluir a atividade.
- ✅ Esperado: a exclusão é bloqueada e aparece uma janela listando os modelos que usam a atividade. Nada é excluído.
Passo 6 — Validações que devem barrar (testes negativos)
- Contagem Manual sem valor por hora, sem quantidade de folhas ou sem tempo → bloqueado.
- Contagem Manual com quantidade de folhas ou tempo iguais a zero → bloqueado.
- Salvar uma cópia com um nome já existente na empresa → bloqueado (nome único por empresa).
5. Resumo das regras de negócio
- Multiempresa: todo cadastro pertence à empresa (tenant) ativa; você só vê e edita os dados da sua empresa.
- Contagem Manual de Vias: referência quantidade de folhas + tempo (min) + valor-hora; o orçamento calcula proporcionalmente para a quantidade pedida (etapa futura). Quantidade e tempo devem ser maiores que zero.
- Excluir Grupo de Insumo: insumos e papéis não impedem a exclusão — são desvinculados (continuam no catálogo). Só atividades que consomem o grupo impedem, e o sistema mostra quais são.
- Excluir Atividade: impedida se a atividade estiver em algum modelo de produto; o sistema mostra quais modelos.
- Nada é apagado em cascata: o sistema sempre lista o que está bloqueando para você tomar a decisão.
- Duplicar: cria um novo registro pré-preenchido ("(cópia)"), respeitando a regra de nome único. O grupo copia os papéis, mas não os insumos (um insumo só pode estar em um grupo).
6. Observações
- O Orçamento (que efetivamente usa a contagem manual e os demais acabamentos para calcular preço) é etapa posterior — não faz parte desta entrega.
- Continuação natural das entregas 029/030 (Acabamentos, Duplicar Insumo e Papel no Grupo) — ver
RELEASE-NOTES-029-030.md. A Contagem Manual de Vias é o 8º tipo de acabamento.