Funcionário (DwEmployee)

O Funcionário representa um colaborador ativo ou inativo dentro da organização.
Ele é utilizado para vínculos operacionais, apontamentos produtivos, responsabilidades de execução e rastreabilidade de ações no sistema.

Todo funcionário pertence a uma empresa e pode ser associado a cargos e unidades de produção.

---

Identidade do Modelo

Configurações estruturais que definem o comportamento do objeto.

Recurso	Identificador	Finalidade
Módulo	Colaboradores	Contexto funcional
Grupo	DwEmployee	Identificação técnica do schema
Principal	Sim	Disponível como ponto de entrada no menu

---

Contrato do Modelo

Este schema opera sob as seguintes garantias:

• Todo DwEmployee pertence a uma empresa
• O campo re é auto-gerado e único por empresa
• O campo name é o identificador humano principal
• O status do funcionário é controlado por enumeração
• Funcionários não podem ser removidos se estiverem vinculados
• O isolamento por empresa é aplicado automaticamente

---

Interface & Comportamento (UI)

Como o sistema expõe este objeto ao usuário final.

Inteligência de Busca

Campos indexados para navegação rápida:

• Campos indexados: re, name
• Descriptor: name

Em qualquer listagem ou vínculo, o funcionário será identificado pelo nome.

---

Regras do Formulário

Fluxo de Preenchimento

A ordem, validações e bloqueios são aplicados automaticamente pelo sistema.

Registro (re)

• Auto-gerado
• Obrigatório
• Único por empresa
• Não editável após criação

Nome (name)

• Texto
• Obrigatório

Ativo (active)

• Valores permitidos: SIM, NÃO
• Define disponibilidade operacional do funcionário
• Obrigatório

Filial / Empresa (companySiteId)

• Relacionamento com CompanySite
• Somente leitura
• Preenchido automaticamente pelo contexto

Data de Admissão (admissionDate)

• Tipo: Data e hora
• Campo informativo

Cargo (employeePosition)

• Relacionamento com DwEmployeePosition
• Obrigatório

Unidade de Produção (productionUnitId)

• Relacionamento com DwProductionUnit
• Obrigatório

---

Conectividade e Regras Especiais

Campo	Relation Schema	Valor Default	Valor Fixo
companySiteId	CompanySite	Contexto atual	-
employeePosition	DwEmployeePosition	-	-
productionUnitId	DwProductionUnit	-	-
sync	-	-	false

Os relacionamentos garantem integridade entre funcionários, cargos, unidades produtivas e empresa.

---

Segurança e Integridade

Multitenancy (Múltiplas Empresas)

Com multi_company: true, o sistema aplica:

• Isolamento completo por empresa
• Filtro automático em todas as consultas
• Bloqueio de acesso cruzado, inclusive via API

---

Proteção de Integridade

• Exclusão bloqueada por relacionamento
• Regra aplicada: preventDeleteDueToRelations

Um funcionário não pode ser removido caso esteja vinculado a qualquer entidade operacional.

---

Sincronização de Dados

• dataSync: registro da última sincronização
• sync: flag de controle interno
• Valor inicial fixo: false

---

Exemplo de Registro

{
  "re": 1024,
  "name": "Carlos Silva",
  "active": "SIM",
  "admissionDate": "2024-03-01T08:00",
  "employeePosition": "Operador de Máquina",
  "productionUnitId": "Linha 2",
  "companySiteId": "64fa9c2e8b1c2a001f3e9a77"
}