Grupo de Insumo sem unidade de medida
Release Notes — Grupo de Insumo sem unidade de medida
Versão / Atividade: 033 (Alteração 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:
- O grupo de insumo não pede mais a unidade de medida — o campo sai da tela de cadastro.
- Quem diz como o item é consumido passa a ser só o item de estoque, pela unidade cadastrada nele.
1. O que mudou, em uma frase
O cadastro de Insumos > Grupos perdeu o campo Unidade de medida do consumo: a unidade é uma característica do insumo, não da família de insumos.
2. Por que isso é necessário
A unidade foi parar no grupo na entrega 029, num tempo em que a atividade informava só o número do consumo ("consome 2") e precisava buscar a unidade em algum lugar — o grupo era esse lugar.
Na entrega 032 — ajuste 0006 (RELEASE-NOTES-032-0006.md), a atividade deixou de informar quantidade: o consumo passou a sair inteiramente do cadastro do item. Com isso, a unidade do grupo ficou sem ninguém para ler — e virou um problema:
Duas respostas para a mesma pergunta. O grupo "Colas" dizia GRAMA e a "Cola Branca 1kg" dentro dele dizia UNIDADE. Qual das duas vale? Quem cadastra não tinha como saber, e nada na tela impedia a contradição.
Um campo que não faz nada. Preencher a unidade do grupo dava a impressão de estar configurando o consumo — mas o cálculo já não olhava para ela. Campo que parece importante e não é atrapalha mais do que ajuda.
O grupo volta a ser exatamente o que ele é: a etiqueta que junta insumos da mesma família, para o orçamento escolher qual deles entra.
3. Como fica o cadastro de grupos
Em Insumos > Grupos → Novo grupo (ou editando um existente):
┌─ Novo grupo ─────────────────────────────────────────┐
│ Nome do grupo * │
│ [ Grampos ] │
│ │
│ ┌─ Insumos do grupo (2 selecionados) ─────────────┐ │
│ │ Marque os insumos que fazem parte desta família. │ │
│ │ No orçamento, escolhe-se o insumo específico do │ │
│ │ grupo (tamanho/gramatura) — e o consumo sai da │ │
│ │ unidade de medida cadastrada nesse insumo. │ │
│ │ ☑ Grampo 26/6 ☑ Grampo 23/13 ☐ ... │ │
│ └───────────────────────────────────────────────────┘ │
│ │
│ ┌─ Papéis do grupo ────────────────────────────────┐ │
│ │ ☐ AP90 — Apergaminhado 90g ☐ ... │ │
│ └───────────────────────────────────────────────────┘ │
│ [Cancelar] [Cadastrar] │
└───────────────────────────────────────────────────────┘
O que sumiu
| Campo | Onde estava | Por quê |
|---|---|---|
| Unidade de medida do consumo | Cadastro do grupo de insumo | A unidade é do insumo; ninguém lia a do grupo desde o ajuste 0006 |
Nada mais mudou: nome, insumos do grupo, papéis do grupo, ativo/inativo, duplicar e as regras de exclusão continuam iguais.
4. Onde a unidade continua aparecendo
No cadastro do insumo (Insumos) — que é de onde ela sempre deveria ter vindo. Nada mudou lá.
No cadastro da atividade, agora só na linha de item do estoque:
| Onde | Antes | Agora |
|---|---|---|
| Modal Adicionar item de consumo, linha de grupo | Grampos — consumo em un |
Grampos |
| Modal Adicionar item de consumo, linha de insumo | Cola Branca 1kg — consumo em g |
(igual) |
| Lista da atividade, item de grupo | Grupo de insumos — consumo em un |
Grupo de insumos |
| Lista da atividade, item de insumo | Item do estoque — consumo em g |
(igual) |
💡 Por que o grupo não mostra unidade. Um grupo pode reunir insumos com unidades diferentes, e qual deles entra só se decide no orçamento. Mostrar uma unidade ali seria mostrar um palpite.
5. O que acontece com o que já estava cadastrado
| Cadastro | Comportamento |
|---|---|
| Grupos de insumo existentes | Continuam como estão — nome, insumos e papéis intactos. Só a unidade deixa de existir. |
| Unidade já cadastrada nos grupos | É descartada. Não havia o que preservar: ela não era usada no cálculo. |
| Insumos do estoque | Nada muda. A unidade de cada insumo continua onde sempre esteve. |
| Atividades | Nada muda. Continuam consumindo os mesmos grupos e insumos. |
⚠️ Vale conferir a unidade dos seus insumos. Como agora ela é a única fonte de "como se consome", um insumo cadastrado com a unidade errada afeta o consumo sem ter mais o grupo para "corrigir" a impressão. Uma passada em Insumos conferindo a unidade de cada item é o que garante orçamento certo.
6. Roteiro de testes (para homologação pelo cliente)
Passo 1 — O campo saiu do cadastro de grupo
- Insumos > Grupos → Novo grupo.
- ✅ Esperado: o formulário tem Nome do grupo, Insumos do grupo e Papéis do grupo. Não existe o campo Unidade de medida do consumo.
Passo 2 — Cadastrar um grupo continua funcionando
- Preencha o nome (ex.: "Grampos de teste"), marque dois insumos e salve.
- ✅ Esperado: o grupo aparece na listagem, com os insumos marcados.
Passo 3 — Editar um grupo antigo
- Abra para edição um grupo criado antes desta entrega (um que tinha unidade cadastrada).
- ✅ Esperado: abre normalmente, sem o campo de unidade, com nome, insumos e papéis preservados.
- Altere o nome e salve. ✅ Esperado: salva sem erro.
Passo 4 — Duplicar
- Na listagem, use Duplicar em um grupo com insumos e papéis.
- ✅ Esperado: a cópia vem com os mesmos insumos e papéis, e sem pedir unidade.
Passo 5 — Exclusão continua protegida
- Tente excluir um grupo consumido por alguma atividade.
- ✅ Esperado: bloqueado, listando as atividades que o usam. Nada é excluído em cascata.
Passo 6 — Modal de consumo da atividade
- Produção > Atividades → Nova atividade, tipo Acabamento → Adicionar item → Grupo de insumos.
- ✅ Esperado: cada grupo aparece só com o nome; os já adicionados continuam desabilitados com "já adicionado".
- Volte com ← Trocar tipo de item e escolha Item do estoque.
- ✅ Esperado: aqui a unidade continua aparecendo ("consumo em g").
Passo 7 — Lista de consumo da atividade
- Adicione um grupo e um item do estoque, salve e reabra a atividade.
- ✅ Esperado: a linha do grupo mostra "Grupo de insumos" (sem unidade); a do insumo mostra "Item do estoque — consumo em g".
Passo 8 — Cadastro do insumo intacto
- Insumos → edite qualquer insumo.
- ✅ Esperado: o campo Unidade de medida continua lá, com o valor de sempre.
7. Resumo das regras de negócio
- O grupo de insumo não tem unidade de medida.
- A unidade que define como o item é consumido é a do insumo do estoque.
- Quando a atividade consome um grupo, a unidade é a do insumo que o orçamento escolher dentro dele.
- O grupo continua sendo: nome único por empresa + insumos membros + papéis membros + ativo/inativo.
- Exclusão de grupo continua bloqueada por atividades que o consomem, sem cascata.
8. Observações
- Continuação direta da 032 — ajuste 0006 (
RELEASE-NOTES-032-0006.md), que tirou quantidade e base de cobrança do cadastro da atividade. Aquela entrega dizia que "como se consome" vinha da unidade do grupo ou do insumo; esta fecha a ponta solta, deixando uma única fonte. - Reverte, na prática, a parte da 029 que colocou a unidade no grupo.
- PRs:
management-api#41efront-management#35.
9. Pendência conhecida
A mudança foi validada por compilação, tipagem e pelas suítes automatizadas (354 testes no backend e 83 no frontend, todos passando), e a migração foi aplicada sobre uma cópia real do banco de homologação (39 tabelas, 8 grupos de insumo). As telas não foram percorridas clicando — o roteiro da seção 6 é o que fecha essa lacuna na homologação.