Release Notes — Acabamentos, Duplicar Insumo e Papel no Grupo

Versão / Atividades: 029 (Cadastro de Acabamentos) + 030 (Duplicar Insumo + Papel no Grupo de Insumo) Público: usuário final da gráfica (operação/orçamentista) e responsável por homologar O que entra nesta entrega:

029 — novo módulo de Acabamentos (7 tipos), reestruturação das Atividades (atividade pode ser um acabamento e/ou consumir um grupo de insumo) e unidade de medida no grupo de insumo.

030 — duplicar insumo com um clique e possibilidade de incluir papéis como membros de um grupo de insumo (para grupos de embrulho).

1. O que mudou, em uma frase

Agora dá para cadastrar os acabamentos que a gráfica faz (viragem de dobra, empacotar, espiral, colagem de blocos, bolsa, envelope, intercalação de vias) com o tempo/custo de cada um; ligar esses acabamentos e o consumo de insumos às atividades; e ganhar agilidade no cadastro de insumos com o botão Duplicar e com o papel de embrulho dentro dos grupos.

2. Conceitos (para explicar ao usuário final)

✂️ Acabamento (029)

Uma etapa de acabamento feita depois da produção, cadastrada por empresa. Todo acabamento tem um valor-hora (R$/h) de execução, mais uma configuração própria do tipo:

Tipo	O que é	Configuração
Viragem de Dobras	Vira as dobras após a dobradeira	tempo (s) por unidade
Empacotar	Agrupa em pacotes por peso	tempo (min) por pacote + peso do pacote (kg)
Aplicação de Espiral	Passa o espiral pelos furos, medido pelo comprimento	tamanho mínimo/máximo + tempo (s) em cada extremo — o orçamento interpola pelo comprimento
Colagem de Blocos/Talões	Empilha e passa cola	tempo de empilhamento + tempo de aplicação
Aplicação de Bolsa	Viragem da dobra + cola + fechamento	por unidade
Fechamento de Envelope	Viragem da dobra + cola + fechamento	por unidade
Intercalação de Vias	Organiza as vias (jogos) na ordem	tabela qtd de vias → tempo por jogo; se a quantidade pedida não tiver posição, usa a maior cadastrada

📏 Espiral: o tamanho é guardado internamente em milímetros (padrão do sistema), mas a tela mostra e recebe na unidade da sua empresa (mm/cm/m). Você digita na unidade que já usa.

⚙️ Atividade (reestruturada em 029)

A atividade de produção ganhou dois reforços:

Pode representar um acabamento (aponta para um acabamento cadastrado acima).
Quando consome um grupo de insumo, agora você informa a quantidade consumida e a base do consumo: por unidade, por área (m²) ou por metro linear. Assim o orçamento sabe quanto do insumo gastar.

📐 Unidade de medida do Grupo de Insumo (029)

Cada grupo de insumo passa a ter uma unidade de medida (unidade, quilo, grama, litro, mililitro, linear, área, volume, folha). É a unidade em que o consumo daquele grupo é medido no orçamento.

📄 Duplicar Insumo (030)

Botão "Duplicar" na lista de insumos: abre o formulário de cadastro já preenchido com os dados do insumo escolhido e o nome sufixado com "(cópia)". Você ajusta o que mudar (ex.: gramatura) e salva — ótimo para cadastrar variações parecidas sem redigitar tudo.

📄➕ Papel como membro de Grupo de Insumo (030)

Além de insumos, um grupo passa a poder conter papéis (da sua empresa) como membros. Serve para grupos de embrulho — por exemplo, o acabamento Empacotar busca o papel de embrulho a partir de um grupo. No formulário do grupo há a seção "Papéis do grupo", com os papéis da empresa em caixas de seleção.

3. Onde acessar (menu lateral)

Função	Caminho no menu
Acabamentos (por tipo)	Acabamentos → Viragem de Dobras / Empacotar / Aplicação de Espiral / Colagem de Blocos/Talões / Aplicação de Bolsa / Fechamento de Envelope / Intercalação de Vias
Atividades	Produção → Atividades
Modelos de Produto	Produção → Modelos de Produto
Cadastro de Insumos (com Duplicar)	Insumos → Cadastro de Insumos
Grupos de Insumo (com Papéis do grupo)	Insumos → Grupos de Insumo

💡 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. Os passos 3–4 dependem dos anteriores.

Passo 1 — Cadastrar acabamentos (029)

Vá em Acabamentos e cadastre um de cada, pelo menos:
- Viragem de Dobras: valor-hora + tempo por unidade.
- Empacotar: valor-hora + tempo por pacote + peso do pacote.
- Aplicação de Espiral: valor-hora + tamanho mínimo/máximo e o tempo em cada extremo.
- Intercalação de Vias: valor-hora + algumas posições (ex.: 2 vias → X s, 4 vias → Y s).
✅ Esperado: cada acabamento salvo aparece na listagem do seu tipo. Ao reabrir, os campos específicos voltam preenchidos.
Espiral (unidade): troque a unidade da empresa (mm/cm/m) nas configurações e reabra o espiral — os valores devem aparecer convertidos para a unidade escolhida, sem perder o valor real.
Intercalação (regra da maior posição): deixe cadastrado até "4 vias". No conceito, um pedido de 6 vias deve usar a posição de 4 vias (a maior cadastrada).

Passo 2 — Grupo de insumo com unidade e com papel (029 + 030)

Vá em Insumos → Grupos de Insumo → Novo grupo.
Nome: Embrulho; defina a unidade de medida do grupo.
Na seção "Papéis do grupo", marque um ou mais papéis da empresa (ex.: um papel kraft de embrulho). Salve.
✅ Esperado: grupo criado; ao editar, a unidade e os papéis marcados voltam corretamente. Desmarcar um papel e salvar deve desvincular só aquele papel (o papel continua no catálogo).

Passo 3 — Duplicar insumo (030)

Vá em Insumos → Cadastro de Insumos.
Em um insumo existente, clique em Duplicar.
✅ Esperado: abre o cadastro já preenchido, com o nome terminando em "(cópia)". Ajuste algo e salve — deve criar um novo insumo, sem alterar o original.
Regra de nome: tentar salvar a cópia com um nome já existente deve ser bloqueado (nome único por empresa).

Passo 4 — Atividade de acabamento e consumo de insumo (029)

Vá em Produção → Atividades → Nova atividade.
Crie uma atividade que representa um acabamento (aponta para um dos acabamentos do Passo 1).
Crie/edite uma atividade que consome um grupo de insumo: informe a quantidade e a base do consumo (unidade / área m² / metro linear).
✅ Esperado: ambas salvas; ao reabrir, o acabamento e os campos de quantidade/base voltam preenchidos.

Passo 5 — Validações que devem barrar (testes negativos)

Acabamento sem nome ou sem valor-hora → bloqueado.
Dois acabamentos com o mesmo nome na mesma empresa → bloqueado.
Espiral com tamanho máximo menor que o mínimo → bloqueado.
Intercalação com quantidade de vias menor que 2 → bloqueado.
Atividade que consome grupo sem informar quantidade ou base → bloqueado.
Incluir no grupo um papel inexistente no catálogo da empresa → bloqueado.

5. Resumo das regras de negócio

Multiempresa: todo cadastro pertence à empresa (tenant) ativa; você só vê e edita os dados da sua empresa.
Nomes únicos por empresa (acabamentos, grupos, atividades) — sem diferenciar maiúsculas/minúsculas.
Acabamento: sempre tem valor-hora; cada tipo tem sua configuração própria.
Espiral é guardado em mm (canônico) e exibido na unidade da empresa; o custo interpola pelo comprimento entre mínimo e máximo.
Intercalação de Vias: quantidade mínima de 2 vias; quantidade sem posição exata usa a maior cadastrada.
Atividade: pode ser um acabamento e/ou consumir um grupo de insumo (com quantidade + base: unidade/área/linear).
Grupo de insumo: tem unidade de medida; pode conter insumos e papéis; excluir o grupo desvincula os papéis (o papel continua no catálogo).
Duplicar insumo: cria um novo insumo pré-preenchido ("(cópia)"), respeitando a regra de nome único.

6. Observações

O Orçamento (que efetivamente usa os acabamentos, o consumo de insumos e o papel de embrulho para calcular preço) é etapa posterior — não faz parte desta entrega.
O vínculo insumo → grupo continua podendo ser gerenciado pelos dois lados (tela do Grupo ou tela do Insumo). O vínculo papel → grupo é gerenciado pela tela do Grupo.
Continuação natural da entrega 028 (Atividades, Modelos e Grupos de Insumo) — ver RELEASE-NOTES-028.md.