Notas de Lançamento - Versão 0.4.0

Projeto: ERP Indústria Gráfica (Gráfica Soset) Data: 13 de Maio de 2026

🚀 O que há de novo?

1. Gestão Centralizada de Pessoas (Party Pattern)

Implementámos uma arquitetura de dados unificada onde Pessoas Físicas e Jurídicas são a base do sistema.

• Vínculo Inteligente: Um único registo de Pessoa pode assumir papéis de Utilizador (Funcionário) e Cliente simultaneamente, evitando duplicidade de dados.
• Segurança Avançada: Controlo de acesso baseado em Perfis (Admin, Vendedor, Operador) e Permissões granulares.

2. Catálogo Global de Papéis e Automação de Preços

O módulo de papéis foi redesenhado para garantir precisão financeira.

• Cálculo Automático de Preço/Folha: O sistema agora calcula o valor da folha automaticamente com base na gramagem, dimensões e preço por quilo ($kg$).
• Preçário por Empresa: Os preços agora são vinculados à sua empresa, permitindo que o catálogo de papéis seja global enquanto os valores permanecem privados e customizáveis.
• Funcionalidade "Duplicar": Novo recurso para agilizar o registo de papéis similares com apenas um clique.

3. Motor de Inventário e Estoque (SKU)

Introduzimos um sistema de stock genérico e rastreável.

• Controlo por Lotes: Rastreabilidade total de entradas de materiais, permitindo saber exatamente de qual lote saiu o papel para uma Ordem de Serviço.
• Histórico Imutável (Kardex): Registo de todas as entradas e saídas para auditoria e controlo de perdas.

4. Registo Detalhado de Máquinas

As máquinas de impressão e acabamento agora possuem uma "ficha técnica" completa.

• Limitações Físicas: Configuração de gramagens mínimas/máximas e dimensões de folha para validar automaticamente se um trabalho pode ser executado.
• Capacidades Técnicas: Definição de velocidades, tempos de setup, limpeza e quantidade de cores.

5. Workflow de Produção e Custeio (Motor de Orçamentos)

A estrutura mais complexa do sistema foi entregue: a definição de como o custo é gerado.

• Grupos e Atividades: Organização lógica da produção (Pré-Impressão, Impressão, Acabamento).
• Regras de Custo Flexíveis: Suporte para cobrança por hora-máquina, metro quadrado ($m^2$), altura do monte de papel, setup fixo ou consumo de materiais especiais (como facas e vernizes).

---

🧪 Guia de Testes para o Cliente

Para validar as implementações desta versão, sugerimos realizar os seguintes testes no ambiente de homologação:

Teste A: Registo e Duplicação de Papel

1. Aceda ao módulo de Papéis.
2. Crie um novo papel informando as dimensões (ex: 640x880mm), gramagem (ex: 150g) e o Preço por Kg.
3. Verifique se o campo Preço por Folha foi preenchido automaticamente após gravar.
4. Clique no botão Duplicar no papel recém-criado.
5. Altere apenas a gramagem no novo formulário e grave. Verifique se o preço por folha foi recalculado corretamente para a nova gramagem.

Teste B: Configuração de Máquina

1. Aceda ao módulo de Máquinas e crie uma nova máquina (ex: Offset 4 cores).
2. Preencha os separadores de Especificações Técnicas e Dimensões.
3. Tente gravar uma máquina com "Velocidade Máxima" menor que a "Velocidade Mínima" e observe a validação do sistema.

Teste C: Montagem de Fluxo de Produção

1. Vá a Configurações > Workflow de Produção.
2. Crie um Grupo chamado "Acabamento".
3. Adicione uma Atividade "Plastificação Brilho".
4. Adicione uma Regra de Custo do tipo "Máquina" com base de cálculo "Por Hora".
5. Adicione uma segunda regra na mesma atividade para "Consumo de Material" (BOPP) com base "Por $m^2$".
6. Grave e verifique se a hierarquia (Grupo > Atividade > Regras) está a ser exibida corretamente na listagem.

Teste D: Gestão de Utilizadores

1. Registe um novo Utilizador associado a uma pessoa já existente.
2. Tente aceder aos módulos administrativos com um utilizador que possua apenas o perfil de "Operador" (se houver restrições de rota implementadas).

---

🛠️ Notas Técnicas (Resumo)

• Migrações de Base de Dados: Executadas via Liquibase para garantir integridade.
• Observabilidade: Rastreio de performance e erros habilitado via OpenTelemetry.
• Unidades de Medida: O sistema está parametrizado para utilizar Centímetros como padrão global de entrada, conforme solicitado.