Release Notes — Cadastro de Atividades, Modelos e Grupos de Insumo

Versão / Atividade: 028 — Cadastro de Atividades Público: usuário final da gráfica (operação/orçamentista) e responsável por homologar O que entra nesta entrega: Grupos de Insumo (com seleção de insumos), Cadastro de Atividades e Cadastro de Modelos de Produto — as peças que o Orçamento vai usar para montar os produtos.

1. O que mudou, em uma frase

Agora é possível descrever como um produto é feito: você cadastra as atividades de produção (grampear, colar, picotar, separar…), organiza os insumos em grupos (ex.: "Grampos", "Plásticos") e monta modelos de produto (ex.: "Bloco") que reúnem as atividades. Mais adiante, no Orçamento, basta escolher o modelo — ele já traz as atividades e os insumos certos.

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

🧩 Grupo de Insumo

Uma família de insumos do mesmo tipo, que só se diferenciam por tamanho/gramatura na hora do orçamento.

Exemplo: o grupo "Grampos" reúne Grampo 26/6, Grampo 26/8, Grampo 23/13.
Por que existe: no cadastro você ainda não sabe qual grampo (tamanho) será usado — isso é decidido no orçamento. O grupo permite dizer "esta atividade consome grampos" e deixar a escolha do grampo específico para depois. O mesmo vale para plástico de plastificação (a gramatura só é definida no orçamento).
Regra: um insumo pertence a no máximo um grupo. Tinta e papel não podem ser agrupados (são inerentes à produção e têm tratamento próprio).

⚙️ Atividade

Uma etapa de produção reutilizável.

Pode ser Manual (ex.: "Separação Manual") — você informa o custo por hora-homem (R$/h); o tempo é lançado no orçamento.
Pode ser Automatizada (ex.: "Grampear") — você escolhe a máquina; o custo vem do custo-hora da máquina.
Opcionalmente, a atividade consome um grupo de insumo (ex.: "Grampear" consome "Grampos"). O insumo específico e a quantidade são definidos no orçamento.

📦 Modelo de Produto

Um produto padrão (ex.: "Bloco") que reúne as atividades que o compõem. Cada atividade do modelo é marcada como:

Fixa (obrigatória): sempre entra no orçamento (ex.: "Separação Manual" num bloco).
Complementar (opcional): pode ser ligada/desligada no orçamento (ex.: "Grampear ou Colar", "Picotar").

Só as atividades incluídas no modelo aparecem no orçamento.

3. Onde acessar (menu lateral)

Os itens ficam dentro de grupos recolhíveis — clique no grupo para expandir:

Função	Caminho no menu
Grupos de Insumo	Insumos → Grupos de Insumo
Cadastro de Atividades	Produção → Atividades
Modelos de Produto	Produção → Modelos de Produto
Cadastro de Insumos	Insumos → Cadastro de Insumos

💡 Se não encontrar um item, clique no título "Insumos" ou "Produção" para abrir o submenu.

4. Roteiro de testes (para homologação pelo cliente)

Faça na ordem abaixo, pois um passo depende do anterior. Use uma empresa (tenant) de teste.

Passo 1 — Cadastrar insumos

Vá em Insumos → Cadastro de Insumos.
Cadastre alguns itens de exemplo, ex.: Grampo 26/6, Grampo 26/8, Cola Quente, Plástico 250mic.
✅ Esperado: os insumos aparecem na listagem.

Passo 2 — Criar um grupo e selecionar os insumos

Vá em Insumos → Grupos de Insumo → Novo grupo.
Nome: Grampos.
Na seção "Insumos do grupo", marque Grampo 26/6 e Grampo 26/8.
Salve.
✅ Esperado: grupo criado; ao editá-lo, os dois grampos aparecem já marcados.
Teste de substituição: edite o grupo, desmarque um grampo e salve. Reabra — apenas o grampo restante deve estar marcado (o desmarcado foi desvinculado).
Teste da regra de tinta: tente incluir um insumo do tipo Tinta no grupo — a lista não deve oferecer tintas para seleção.

Passo 3 — Cadastrar atividades

Vá em Produção → Atividades → Nova atividade.
Cadastre uma Manual: nome Separação Manual, tipo Manual, custo/hora 35,00.
Cadastre uma Automatizada: nome Grampear, tipo Automatizada, Máquina = uma grampeadeira, Grupo de insumo consumido = Grampos.
✅ Esperado: ambas salvas. Na automatizada, o campo de custo/hora some (o custo vem da máquina); na manual, não há máquina.

Passo 4 — Montar um modelo de produto

Vá em Produção → Modelos de Produto → Novo modelo.
Nome: Bloco.
Marque as atividades e defina cada uma:
- Separação Manual → Fixa
- Grampear → Complementar
Salve.
✅ Esperado: modelo criado com as atividades marcadas corretamente como Fixa/Complementar.

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

Tentar salvar um grupo/atividade/modelo sem nome → deve avisar que o nome é obrigatório.
Tentar criar dois grupos com o mesmo nome na mesma empresa → deve ser bloqueado.
Tentar excluir um grupo que está sendo usado por um insumo ou atividade → deve ser bloqueado (use "inativar" no lugar).
Tentar salvar um modelo sem nenhuma atividade marcada → deve avisar para selecionar ao menos uma.
Atividade Automatizada sem máquina ou Manual sem custo/hora → deve ser bloqueada.

5. Resumo das regras de negócio

Multiempresa: cada cadastro pertence à empresa (tenant) ativa; você só vê e edita os dados da sua empresa.
Nomes únicos por empresa (grupos, atividades, modelos) — sem diferenciar maiúsculas/minúsculas.
Grupo de insumo: 1 insumo = no máximo 1 grupo; tinta e papel não são agrupáveis.
Exclusão de grupo bloqueada quando há insumos/atividades vinculados (use inativar).
Atividade automatizada custa pela máquina; manual custa por hora-homem.
Modelo: atividades Fixas sempre entram no orçamento; Complementares são opcionais.

6. Observações

O Orçamento (juntar modelos, escolher o insumo específico do grupo e as quantidades) é a próxima etapa — não faz parte desta entrega.
O vínculo insumo → grupo pode ser gerenciado por dois lados: pela tela do Grupo (marcando os insumos) ou pela tela do Insumo (escolhendo o grupo). Ambos refletem o mesmo vínculo.

Cadastro de Modelos, Atividades de Grupo de Insumos