Política de Marca D'Água

Uma política é um conjunto de regras que definem como a marca d’água aparece nas máquinas dos seus usuários. Este guia explica o conceito, ciclo de vida e gerenciamento de políticas.

O Que É Uma Política?

Uma política especifica:

Exemplo: Fluxo de Uma Política

1. Admin cria política "Confidencial - Amarelo"
   ↓
2. Admin associa a 10 máquinas do departamento de vendas
   ↓
3. Agentes fazem polling a cada ~30 segundos
   ↓
4. Recebem a nova política e a aplicam (~5 segundos)
   ↓
5. Marca d'água aparece em todas as 10 máquinas
   ↓
6. Admin muda a cor para vermelho (versão 2)
   ↓
7. Apenas máquinas que recebem v2 veem vermelho
   ↓
8. Máquinas com v1 ainda veem amarelo (até sincronizar)

Estados de Uma Política

1. Rascunho (Draft)

A política foi criada, mas não está associada a nenhuma máquina.

• ✅ Pode ser editada livremente
• ✅ Pode ser deletada sem risco
• ❌ Não afeta nenhum usuário

Quando usar: Enquanto você testa e customiza.

2. Ativa (Active)

A política está associada a máquinas e em uso.

• ✅ Máquinas recebem essa política
• ❌ Edição é mais delicada (afeta usuários em tempo real)
• ❌ Deletar afeta as máquinas (cuidado!)

Quando mudar: Incremente versão, altere valores, máquinas sincronizam automaticamente.

3. Obsoleta (Deprecated)

A política foi substituída por outra versão.

• ✅ Máquinas antigas ainda as usam
• ❌ Novas máquinas não recebem essa versão
• 🔄 Usar apenas para rollback em emergências

Quando usar: Versão anterior de uma política.

4. Desativada (Disabled)

A política existe mas está propositalmente desligada.

• ✅ Histórico preservado
• ✅ Pode ser reativada depois
• ❌ Máquinas não a recebem (mesmo se associadas)

Quando usar: Política temporária ou para testes que não devem afetar produção.

Versionamento de Políticas

Cada política tem uma versão numérica. Agentes aplicam updates apenas se:

versão_nova > versão_atual

Exemplo: Evoluindo Uma Política

Versão 1: Amarelo, 0.15 opacidade, 20px
└─ 50 máquinas usando

Versão 2: Mudei para Vermelho (urgente)
└─ Novas máquinas recebem v2
└─ Máquinas antigas: ainda veem amarelo até sincronizar

Versão 3: Ajustei opacidade para 0.25
└─ Todas com v1 ou v2 recebem v3
└─ Apenas máquinas offline não recebem ainda

Versão 4: Design final (amarelo + vermelho alternado)
└─ Aplicado a todas

Importante: Não Há Rollback Automático

Se você remover uma versão ou tentar voltar, precisa incrementar a versão:

❌ ERRADO:
  v2 → v1  (desce versão, agentes ignoram)

✅ CORRETO:
  v2 → v3  (sobe versão, agentes aplicam v3 mesmo que v3="old config")

Ciclo de Vida Típico

Fase 1: Criação (5 min)

Admin → Painel → Política → + Nova
       ↓
       Preenche: Nome, Cor, Tamanho, Texto
       ↓
       Salva (ainda em rascunho)

Status: Rascunho
Máquinas afetadas: 0

Fase 2: Customização (10 min)

Admin visualiza a marca no preview
    ↓
Ajusta cores/tamanho/ângulo
    ↓
Clica "Salvar" a cada mudança (mesma versão 1)

Status: Rascunho
Máquinas afetadas: 0

Fase 3: Associação (5 min)

Admin seleciona máquinas (ex: departamento de vendas)
    ↓
Clica "Aplicar"
    ↓
Política agora está ATIVA

Status: Ativa
Máquinas afetadas: 20

Fase 4: Sincronização Automática (30 seg)

Máquinas fazem polling regular
    ↓
Recebem política v1
    ↓
Aplicam a marca (~5 segundos depois)

Status: Ativa
Máquinas afetadas: 20 (todas sincronizadas)

Fase 5: Atualização (opcional)

Admin quer mudar a cor (de amarelo para vermelho)
    ↓
Cria VERSÃO 2 da mesma política
    ↓
Salva com versão=2
    ↓
Máquinas sincronizam automaticamente
    ↓
Marca muda para vermelho em ~30-35 segundos

Status: Ativa (v2)
Máquinas afetadas: 20 (agora com cor nova)

Gerenciando Múltiplas Políticas

Organizar por Contexto

Você pode ter múltiplas políticas simultâneas:

Políticas Ativas:
├─ "Confidencial - Amarelo"     → Gerencial (50 máquinas)
├─ "Público - Azul"             → Recepção (5 máquinas)  
├─ "Restrito - Vermelho"        → P&D (15 máquinas)
├─ "Desativada - Teste"         → Desativada (0 máquinas)
└─ "Rascunho - Nova"            → Rascunho (0 máquinas)

Melhores Práticas

✅ Uma política por departamento/contexto

✅ "Vendas - Amarelo Padrão"
✅ "TI - Verde Técnico"
✅ "RH - Azul Confidencial"

✅ Versionamento claro

✅ Versão 1: v1 (mudei cor) → Versão 2: v2
✅ Não reutilize versões

✅ Nomes descritivos

✅ "Confidencial - Vendas - v1"
❌ "Politica1"

Associações: Máquina ↔ Política

Associação 1:1

Uma máquina pode ter apenas 1 política ativa por vez.

Máquina A ←→ Política "Vendas"
Máquina B ←→ Política "TI"
Máquina C ←→ Política "RH"

Mudar de Política

Para uma máquina:

1. Vá a “Máquinas”
2. Selecione a máquina
3. Mude a política em “Política Associada”
4. Clique [Salvar]
5. Aguarde ~30-35 segundos

Ou em lote:

1. Vá a “Máquinas”
2. Busque/filtre máquinas
3. Selecione múltiplas (checkbox)
4. Clique “Mudar Política em Lote”
5. Escolha nova política
6. Clique [Aplicar]

Histórico e Auditoria

Ver Histórico de Uma Política

1. Clique na política na lista
2. Abra a aba “Histórico”
3. Veja:
   • Todas as versões criadas
   • Data/hora de cada mudança
   • Quem editou (admin que fez)
   • Quantas máquinas usam cada versão

Ver Qual Versão Uma Máquina Usa

1. Vá a “Máquinas”
2. Clique na máquina
3. Em “Detalhes”, veja:
   • Política associada
   • Versão atual
   • Última sincronização
   • Histórico de políticas antigas

Deletar Uma Política

⚠️ Cuidado: Deletar uma política ativa afeta máquinas.

Se Está em Rascunho

Seguro deletar — ninguém usa.

1. Clique na política
2. Botão [Deletar]
3. Confirme
4. Pronto!

Se Está Ativa

Primeiro desassocie de todas as máquinas:

1. Vá a "Máquinas"
2. Filtre por essa política
3. Mude todas para outra política
4. Agora a política não tem máquinas
5. Volte e clique [Deletar]

Troubleshooting

Resumo Rápido

POLÍTICA = Visual + Conteúdo + Versão + Máquinas

Fluxo:
1. Admin cria política (rascunho)
2. Customiza até gostar
3. Associa a máquinas (ativa)
4. Máquinas sincronizam (30 seg)
5. Marca aparece (5 seg)
6. Admin muda? Cria v2
7. Máquinas recebem v2 se versão maior

Versão:
  v1 < v2 < v3 → Agentes aplicam se MAIOR

Gerenciamento:
  - Uma política por contexto
  - Nomes claros e versionamento
  - Histórico para auditoria
  - Desassocie antes de deletar