Releases

# 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.