Entidades e relacionamentos · Gestão organizacional

Diagrama

Fundação da gestão organizacional

Carregando diagrama…

Ver código Mermaid

erDiagram
  TENANTS ||--|{ TENANT_ADMINS : "tenantId"
  TENANTS ||--o{ CATALOG_ITEMS : "tenantId"
  TENANTS ||--o{ RULE_VERSIONS : "tenantId"
  TENANTS ||--o{ ACTS : "tenantId"
  TENANTS ||--o{ PERMISSION_RULES : "tenantId"
  TENANTS ||--o{ WORKFLOW_DEFINITIONS : "tenantId"
  TENANTS ||--o{ TENANT_TEMPLATE_BASELINES : "tenantId"
  TEMPLATE_VERSIONS ||--o{ TENANT_TEMPLATE_BASELINES : "templateVersionId"
  ACTS ||--o{ FACTS : "actId"
  ACTS }o--o| RULE_VERSIONS : "ruleVersionId"
  WORKFLOW_DEFINITIONS ||--o{ PROPOSALS : "workflowDefinitionId"
  PROPOSALS ||--o{ PROPOSAL_DECISIONS : "proposalId"
  PROPOSALS }o--o| ACTS : "actId"

Descrição das entidades

Os nomes das entidades seguem o desenho do sistema. Toda entidade, exceto os modelos, pertence a um cliente e é sempre lida e gravada filtrando por ele (RN-ORG-001).

Entidade	O que representa	Relacionamentos
`tenants`	O cliente: a organização que usa o sistema. Guarda o nome, a situação e o projeto do Appwrite que cuida do login, e a opção de publicar grupos no Appwrite.	Dona de todas as demais entidades.
`tenant_admins`	A pessoa que administra o cliente, identificada pela conta no login do cliente.	Pertence a um cliente; um cliente tem um ou mais administradores.
`catalog_items`	Um item de catálogo do cliente, por exemplo um tipo de vínculo ou de documento. Tem código estável, versão, data de início e, quando aposentado, data de aposentadoria.	Pertence a um cliente; as versões de um mesmo código formam o histórico do item.
`rule_versions`	Uma versão de regra configurável: parâmetros, data de início e modo, "barrar" ou "avisar".	Pertence a um cliente; é citada pelos atos que ela explica.
`acts`	Uma linha do livro de atos: o comando, quem o enviou, a chave de repetição, o resultado (aceito ou recusado), os avisos e, quando é estorno, o motivo e o ato estornado. Nunca é alterada nem excluída.	Pertence a um cliente; aponta a versão da regra vigente na época; gera zero ou mais fatos.
`facts`	O aviso publicado depois que um ato é gravado, com número em sequência para que o consumidor retome pelo último número lido.	Nasce de um ato; é publicado para Hub, servidor do Hub e módulos vizinhos.
`permission_rules`	Regra de permissão do cliente: o conjunto de condições sobre a posição da pessoa na estrutura que autoriza uma ação.	Pertence a um cliente.
`workflow_definitions`	O fluxo de aprovação configurado para uma ação: as etapas e a condição de quem decide cada uma.	Pertence a um cliente; orienta as propostas da ação.
`proposals`	O pedido de uma ação sujeita a fluxo, enquanto aguarda as etapas.	Segue uma definição de fluxo; vira um ato quando todas as etapas aprovam.
`proposal_decisions`	A decisão de uma etapa de uma proposta: quem decidiu, quando, se aprovou ou recusou e o motivo.	Pertence a uma proposta, com uma linha por etapa decidida.
`template_versions`	Uma versão de modelo por tipo de serviço, com o pacote de configuração e as cláusulas da ISO 9001 que atende.	Não pertence a um cliente; é copiada para os clientes que nascem dela.
`tenant_template_baselines`	A cópia independente da versão do modelo com que o cliente nasceu, e o que já foi aplicado das novidades.	Liga um cliente a uma versão de modelo; permite mostrar as novidades de versões posteriores.

Relações importantes

A separação por cliente vale para todas as entidades dos clientes: nenhuma consulta cruza clientes (RN-ORG-001).
O livro de atos aponta a versão da regra vigente na data do ato, não a mais recente (RN-ORG-006).
Um item de catálogo referenciado por um ato ou por outra entidade só é aposentado, não removido (RN-ORG-004).
Proposta e decisões só existem quando o cliente configurou fluxo para a ação (RN-ORG-015 e RN-ORG-017).
A cópia do modelo no cliente é independente: mudar o modelo não muda o cliente até o administrador aplicar as novidades (RN-ORG-018 e RN-ORG-019).

Entidades da base de cadastro

Complementam as entidades da fundação. Toda entidade pertence a um cliente (RN-ORG-001). Datas de vigência têm fim inclusivo; nada se apaga (RN-ORG-028).

Base de cadastro

Carregando diagrama…

Ver código Mermaid

erDiagram
  ORGANIZATIONS ||--o{ ORGANIZATION_VERSIONS : "organizationId"
  ORGANIZATIONS ||--o{ UNITS : "organizationId"
  UNITS ||--o{ UNIT_VERSIONS : "unitId"
  ORGANIZATIONS ||--o{ OFFICES : "organizationId"
  OFFICES ||--o{ OFFICE_VERSIONS : "officeId"
  PERSONS ||--o{ PERSON_CORRECTIONS : "personId"
  PERSONS ||--o{ EXTERNAL_ACCOUNTS : "personId"
  PERSONS ||--o{ DEPENDENTS : "personId"
  PERSONS ||--o{ BONDS : "personId"
  ORGANIZATIONS ||--o{ BONDS : "organizationId"
  BONDS ||--o{ ASSIGNMENTS : "bondId"
  UNITS ||--o{ ASSIGNMENTS : "unitId"
  POSITIONS ||--o{ POSITION_VERSIONS : "positionId"
  BONDS ||--o{ BOND_LEVELS : "bondId"
  POSITIONS ||--o{ BOND_LEVELS : "positionId"
  LEVELS ||--o{ BOND_LEVELS : "levelId"
  PERSONS ||--o{ DOCUMENTS : "personId"
  PERSONS ||--o{ ADMISSIONS : "personId"
  ADMISSIONS |o--o{ DOCUMENTS : "admissionId"
  ADMISSIONS }o--o| BONDS : "bondId"
  PERSONS ||--o{ DESIGNATIONS : "personId"
  BODIES ||--o{ BODY_VERSIONS : "bodyId"
  BODIES ||--o{ BODY_USAGES : "bodyId"
  BODIES ||--o{ SEATS : "bodyId"
  PERSONS ||--o{ SEATS : "personId"

Organização (`organizations`)

A organização do cliente (empresa, filial, núcleo). Guarda só o que não muda; nome, tipo e organização-mãe ficam nas versões (RN-ORG-028).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`code`	Código estável, letras minúsculas, números e hífen, único no cliente.
`created_on`	Data de criação.
`closed_on`	Data de encerramento; vazio enquanto ativa (RN-ORG-022).

Versões da organização (`organization_versions`)

Cada mudança de nome, tipo ou organização-mãe cria uma versão; só uma está aberta por organização.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`organization_id`	Organização.
`name`	Nome.
`kind_code`	Tipo de organização, do catálogo `organization-kinds` (RN-ORG-021).
`parent_id`	Organização-mãe; nunca ela mesma nem uma abaixo dela (RN-ORG-021).
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Unidade (`units`)

A unidade dentro de uma organização. Nome, sigla, nível e unidade-mãe ficam nas versões.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`organization_id`	Organização da unidade.
`created_on`	Data de criação.
`closed_on`	Data de encerramento; vazio enquanto ativa (RN-ORG-027).

Versões da unidade (`unit_versions`)

Cada renomeação, troca de sigla, mudança de nível ou de unidade-mãe cria uma versão (RN-ORG-028).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`unit_id`	Unidade.
`organization_id`	Organização.
`acronym`	Sigla, sem espaço, única entre as unidades da organização (RN-ORG-024).
`name`	Nome.
`level_code`	Nível, do catálogo `unit-levels` (RN-ORG-023).
`parent_id`	Unidade-mãe, da mesma organização, nunca ela mesma nem uma abaixo dela (RN-ORG-026).
`description`	Descrição opcional.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Escritório físico (`offices`)

O endereço físico de uma organização; os dados ficam nas versões.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`organization_id`	Organização ativa dona do escritório (RN-ORG-029).
`code`	Código estável, único no cliente.
`opened_on`	Data de abertura.
`closed_on`	Data de fechamento; vazio enquanto aberto.

Versões do escritório (`office_versions`)

Cada alteração de nome ou endereço cria uma versão numerada.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`office_id`	Escritório.
`version`	Número da versão, em sequência.
`name`	Nome.
`address_line`	Logradouro e número.
`city`	Cidade.
`region`	Estado.
`postal_code`	Código postal.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Pessoa (`persons`)

O cadastro da pessoa. É o único dado corrigido diretamente (RN-ORG-031).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`name`	Nome, obrigatório (RN-ORG-030).
`civil_name`	Nome civil.
`tax_id`	Documento fiscal, 11 dígitos, único entre os cadastros não unidos do cliente (RN-ORG-030); dado sensível (RN-ORG-034).
`birth_date`	Data de nascimento; dado sensível.
`email`	E-mail.
`phone`	Telefone.
`nationality`	Nacionalidade.
`birthplace`	Naturalidade.
`address_line, city, region, postal_code`	Endereço.
`merged_into_id`	Cadastro que ficou no lugar, quando este foi unido (RN-ORG-032).
`created_at`	Momento do cadastro.

Correção de cadastro (`person_corrections`)

Uma linha por correção do cadastro da pessoa. Nunca é alterada nem excluída (RN-ORG-031).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa corrigida.
`before`	Campos mudados, antes.
`after`	Campos mudados, depois.
`reason`	Motivo, obrigatório.
`corrected_by`	Quem corrigiu.
`corrected_at`	Momento da correção.

Conta em outro sistema (`external_accounts`)

O código da pessoa em outro sistema (RN-ORG-033).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa.
`system_code`	Sistema, do catálogo `external-systems`; o login é fixo.
`code`	Código da pessoa no sistema, único por sistema no cliente.
`login`	Nome de acesso, quando houver.
`registered_on`	Data do registro.

Dependente (`dependents`)

Dependente da pessoa, com vigência.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa.
`name`	Nome.
`kind_code`	Tipo, do catálogo `dependent-kinds`.
`birth_date`	Data de nascimento.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Leitura sensível (`sensitive_reads`)

O registro de cada consulta a dado sensível (RN-ORG-034). Nunca é alterado nem excluído.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`actor_ref`	Quem consultou.
`subject_kind`	O que foi consultado (cadastro, documentos).
`subject_id`	Pessoa ou registro consultado.
`read_at`	Momento da consulta.

Vínculo (`bonds`)

A relação da pessoa com uma organização, de um tipo (RN-ORG-035).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa.
`organization_id`	Organização.
`bond_type_code`	Tipo de vínculo, do catálogo `bond-types`.
`probation_ends_on`	Fim do período de experiência, quando o tipo prevê (RN-ORG-042).
`end_reason`	Motivo do encerramento (RN-ORG-043).
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Lotação (`assignments`)

A unidade onde o vínculo está lotado; uma vigente por vínculo (RN-ORG-036, RN-ORG-037).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo.
`unit_id`	Unidade ativa da organização do vínculo.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Cargo (`positions`)

O cargo do cliente. Nome, trilha, responsabilidades e requisitos ficam nas versões (RN-ORG-045).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`code`	Código estável, único no cliente.
`created_on`	Data de criação.
`closed_on`	Data de encerramento (RN-ORG-046).
`close_reason`	Motivo do encerramento, obrigatório com a data.

Versões do cargo (`position_versions`)

Cada mudança de nome, trilha, responsabilidades ou requisitos cria uma versão.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`position_id`	Cargo.
`name`	Nome.
`track_code`	Trilha, do catálogo `career-tracks`.
`responsibilities`	Responsabilidades.
`requirements`	Requisitos de competência: educação, treinamento ou experiência, cada um com descrição.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Nível (`levels`)

Um nível de uma trilha de carreira (RN-ORG-045, RN-ORG-046).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`track_code`	Trilha do nível.
`code`	Código estável, único no cliente.
`name`	Nome.
`rank_order`	Ordem na trilha, maior que zero; não se repete entre níveis abertos da trilha.
`created_on`	Data de criação.
`closed_on`	Data de encerramento.

Enquadramento (`bond_levels`)

O cargo e o nível em que o vínculo está enquadrado; um vigente por vínculo (RN-ORG-047 a RN-ORG-049).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo.
`position_id`	Cargo.
`level_id`	Nível da mesma trilha do cargo.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Documento (`documents`)

O documento entregue por uma pessoa (RN-ORG-040, RN-ORG-041). O arquivo fica fora do módulo; aqui fica a referência.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa.
`admission_id`	Admissão a que foi entregue, quando houver.
`type_code`	Tipo, do catálogo `document-types`.
`file_ref`	Referência do arquivo.
`issued_on`	Data de emissão.
`expires_on`	Data de vencimento; obrigatória em tipo com validade.
`status`	`delivered`, `verified` ou `rejected`.
`delivered_by, delivered_at`	Quem entregou e quando.
`decided_by, decided_at`	Quem conferiu ou recusou e quando.
`rejection_reason`	Motivo da recusa.

Admissão (`admissions`)

O processo que leva uma pessoa a um vínculo (RN-ORG-038 a RN-ORG-040, RN-ORG-042).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa.
`organization_id`	Organização.
`bond_type_code`	Tipo de vínculo.
`position_id, level_id`	Cargo e nível previstos.
`unit_id`	Unidade prevista.
`expected_start`	Data prevista de início.
`status`	`open`, `submitted` ou `active`.
`bond_id`	Vínculo criado na conclusão.
`opened_by, opened_at`	Quem abriu e quando.
`submitted_at`	Quando o funcionário completou o cadastro.
`activated_on`	Data de conclusão.

Designação (`designations`)

A pessoa num degrau da escada de liderança do cliente, com âmbito (RN-ORG-050 a RN-ORG-053).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa.
`rank_code`	Degrau, do catálogo `leadership-ranks`.
`unit_id`	Unidade do âmbito; obrigatória, opcional ou vedada conforme o degrau.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Colegiado (`bodies`)

O colegiado do cliente. Nome, tipo, alçada e quórum ficam nas versões (RN-ORG-054).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`code`	Código estável, único no cliente.
`organization_id`	Organização do colegiado, quando houver.
`created_on`	Data de criação.
`reversed_at, reverse_reason`	Estorno e motivo.

Versões do colegiado (`body_versions`)

Cada reclassificação cria uma versão.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`body_id`	Colegiado.
`name`	Nome.
`kind_code`	Tipo, do catálogo `body-kinds`.
`authority`	Alçada.
`quorum`	Quórum, maior que zero quando informado.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Uso de colegiado (`body_usages`)

A reunião ou resolução que o servidor do Hub informa; impede o estorno do colegiado (RN-ORG-054). Nunca é alterada nem excluída.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`body_id`	Colegiado.
`kind`	`meeting` ou `resolution`.
`external_ref`	Referência no servidor do Hub, única por colegiado e tipo.
`reported_at`	Momento do aviso.

Assento (`seats`)

O lugar da pessoa num colegiado; um vigente por pessoa e colegiado (RN-ORG-055).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`body_id`	Colegiado.
`person_id`	Pessoa.
`role`	Papel no colegiado.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Relações da base de cadastro

Organização, unidade, escritório, cargo e colegiado mudam por versão; o estado numa data passada continua consultável (RN-ORG-028).
A unidade e sua unidade-mãe pertencem à mesma organização (RN-ORG-026); a lotação é numa unidade da organização do vínculo (RN-ORG-036).
Pessoa unida a outra fica marcada e aponta o cadastro que ficou; vínculos, contas, dependentes, documentos e assentos passam a ele (RN-ORG-032).
Cargo e nível de um enquadramento são da mesma trilha (RN-ORG-047).
Documento entregue na admissão fica ligado a ela; a conclusão cria o vínculo e a lotação (RN-ORG-040).
Um assento vigente por pessoa e colegiado; colegiado com uso registrado não se estorna (RN-ORG-054, RN-ORG-055).

Complementam as entidades da base de cadastro. Toda entidade pertence a um cliente (RN-ORG-001). Dinheiro é texto decimal com 2 casas; a remuneração-base nunca é gravada, é calculada na consulta (RN-ORG-104). Nenhum valor de cliente faz parte da documentação.

Remuneração

Carregando diagrama…

Ver código Mermaid

erDiagram
  LEVELS ||--o{ LEVEL_COEFFICIENTS : "levelId"
  BONDS ||--o{ GRATIFICATION_ENTRIES : "bondId"
  GRATIFICATION_ENTRIES ||--o| GRATIFICATION_ENTRIES : "reversesEntryId"
  PERSONS ||--o{ REMUNERATION_READS : "subjectPersonId"
  BONDS ||--o{ REMUNERATION_READS : "subjectBondId"

Valor de índice (`index_values`)

O valor de um índice do catálogo remuneration-indexes numa vigência, com a fonte que o fixou (RN-ORG-100, RN-ORG-101).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`index_code`	Código do índice, do catálogo `remuneration-indexes`.
`amount`	Valor, positivo, com até 2 casas.
`source`	Fonte: norma, tabela ou documento que fixou o valor; obrigatória.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente. Só uma vigência aberta por índice.

Coeficiente do nível (`level_coefficients`)

O coeficiente que, multiplicado pelo índice vigente, dá a remuneração-base do nível (RN-ORG-102, RN-ORG-103, RN-ORG-104).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`level_id`	Nível.
`index_code`	Índice a que o coeficiente se liga.
`coefficient`	Coeficiente, positivo, com até 4 casas.
`valid_from`	Primeiro dia de vigência.
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente. Só um coeficiente aberto por nível.

Lançamento de gratificação e estorno (`gratification_entries`)

Uma linha por lançamento ou por estorno. O estorno é uma linha nova de valor negativo que aponta o lançamento anulado; nada se apaga (RN-ORG-108 a RN-ORG-111).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo.
`kind_code`	Espécie, do catálogo `gratification-kinds` (RN-ORG-107).
`basis_key`	Fundamento normalizado, sem diferença de maiúsculas e espaços, usado para impedir sobreposição (RN-ORG-109).
`entry_type`	`launch` (lançamento) ou `reversal` (estorno).
`amount`	Valor: positivo no lançamento, negativo no estorno.
`valid_from`	Primeiro dia do período.
`valid_to`	Último dia do período (inclusivo); vazio enquanto aberto (RN-ORG-110).
`note`	Observação, opcional.
`reverses_entry_id`	No estorno, o lançamento anulado; um estorno por lançamento (RN-ORG-111).
`reason`	Motivo do estorno; obrigatório no estorno.
`created_at`	Momento do registro.

Registro de consulta de remuneração (`remuneration_reads`)

Quem consultou, quando e de quem; gravado antes de devolver o dado. Nunca é alterado nem excluído (RN-ORG-113).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`actor_ref`	Quem consultou.
`scope`	O que foi consultado: `statement` (extrato), `gratifications` (lançamentos), `indexes` (valores de índice) ou `levels` (tabela de níveis).
`subject_person_id`	Pessoa consultada; preenchida só em extrato e lançamentos.
`subject_bond_id`	Vínculo consultado; preenchido só em extrato e lançamentos.
`on_date`	Data consultada.
`read_at`	Momento da consulta.

Relações da remuneração

O coeficiente é do nível e liga-se a um índice do catálogo; o valor do índice tem fonte e vigência própria (RN-ORG-100 a RN-ORG-102).
Coeficiente só se define ou muda em nível sem ninguém enquadrado (RN-ORG-103); a remuneração-base é calculada pelo enquadramento do vínculo na data (RN-ORG-104).
O lançamento pertence a um vínculo; o estorno aponta o lançamento anulado e o tira das somas (RN-ORG-111).
Duas gratificações da mesma pessoa com mesmo fundamento não se sobrepõem, em nenhum de seus vínculos (RN-ORG-109).
Os avisos de fatos levam só identificadores, códigos e datas (RN-ORG-114).

Entidades da rotina

Complementam as entidades da remuneração. Toda entidade pertence a um cliente (RN-ORG-001) e a rotina pertence ao vínculo, nunca à pessoa. Fuso horário: todo instante (registro de ponto, gravação, decisão) é guardado em UTC; o dia, a hora local e a jornada são contados no fuso configurado pelo cliente (RN-ORG-151). Datas de calendário (início de férias, período de atestado, data de pedido) não têm fuso. O intervalo de jornada não atravessa a meia-noite local. Irregularidades, ausências e saldos diários não são gravados: são calculados na consulta (RN-ORG-160). Nenhum valor de cliente nem da legislação trabalhista faz parte da documentação (RN-ORG-208).

Rotina do dia a dia

Carregando diagrama…

Ver código Mermaid

erDiagram
  BONDS ||--o{ WORK_ARRANGEMENTS : "bondId"
  BONDS ||--o{ PUNCHES : "bondId"
  PUNCHES ||--o| PUNCH_VOIDS : "punchId"
  ATTENDANCE_REQUESTS ||--o{ PUNCHES : "requestId"
  ATTENDANCE_REQUESTS ||--o{ PUNCH_VOIDS : "requestId"
  BONDS ||--o{ ATTENDANCE_REQUESTS : "bondId"
  HOUR_BANKS ||--o{ HOUR_BANK_MEMBERS : "bankId"
  BONDS ||--o{ HOUR_BANK_MEMBERS : "bondId"
  HOUR_BANKS ||--o{ HOUR_BANK_ADJUSTMENTS : "bankId"
  HOUR_BANK_ADJUSTMENTS ||--o| HOUR_BANK_ADJUSTMENTS : "reversesId"
  HOUR_BANKS ||--o{ HOUR_BANK_PROCESSINGS : "bankId"
  HOUR_BANK_PROCESSINGS ||--o{ HOUR_BANK_BALANCES : "processingId"
  BONDS ||--o{ MEDICAL_CERTIFICATES : "bondId"
  ORGANIZATIONS ||--o{ VACATION_CALENDARS : "organizationId"
  BONDS ||--o{ VACATIONS : "bondId"
  VACATIONS ||--o{ VACATION_DECISIONS : "vacationId"

Arranjo de trabalho (`work_arrangements`)

A jornada e, se houver, o calendário de feriados de um vínculo, por vigência. Só um arranjo fica aberto por vínculo; mudar cria versão nova (RN-ORG-153).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo.
`schedule_code`	Jornada, do catálogo `work-schedules` do cliente (RN-ORG-152).
`holiday_calendar_code`	Calendário de feriados, do catálogo `holiday-calendars`; vazio quando o vínculo não usa (RN-ORG-172).
`valid_from`	Primeiro dia de vigência; não anterior ao início do vínculo (RN-ORG-153).
`valid_to`	Último dia de vigência (inclusivo); vazio enquanto vigente.

Registro de ponto (`punches`)

Uma entrada ou saída. Nunca é alterado nem excluído (RN-ORG-157).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo.
`kind`	`in` (entrada) ou `out` (saída).
`occurred_at`	Instante do registro, em UTC. Vem sempre do relógio do servidor, exceto quando criado por pedido atendido (RN-ORG-154, RN-ORG-185).
`recorded_at`	Momento da gravação.
`source`	`clock` (ponto) ou `request` (pedido atendido).
`photo_ref`	Referência da foto entregue pelo Hub; exigida conforme a configuração (RN-ORG-155).
`qr_code`	Código QR lido, que precisa existir no catálogo do cliente; exigido conforme a configuração (RN-ORG-155).
`request_id`	Pedido que criou o registro; preenchido só quando a origem é `request`.
`recorded_by`	Quem registrou.

Anulação de registro (`punch_voids`)

A marca que tira um registro de ponto do cálculo sem apagá-lo. Nunca é alterada nem excluída (RN-ORG-157).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`punch_id`	Registro anulado; um registro só se anula uma vez (RN-ORG-186).
`request_id`	Pedido atendido que determinou a anulação (RN-ORG-185).
`reason`	Motivo, obrigatório.
`voided_by`	Quem anulou.
`voided_at`	Momento da anulação.

Banco de horas (`hour_banks`)

O banco com período definido (RN-ORG-170).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`code`	Código estável, letras minúsculas, números e hífen, único no cliente.
`name`	Nome.
`period_start`	Primeiro dia do período.
`period_end`	Último dia do período.
`closed_on`	Data do encerramento; vazio enquanto aberto (RN-ORG-175).

Participante do banco (`hour_bank_members`)

Vínculo incluído num banco, por vigência. Só uma participação fica aberta por vínculo (RN-ORG-170).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bank_id`	Banco.
`bond_id`	Vínculo.
`valid_from`	Primeiro dia de participação.
`valid_to`	Último dia de participação (inclusivo); vazio enquanto participa.

Ajuste do banco (`hour_bank_adjustments`)

Ajuste manual de saldo ou o estorno dele. Nunca é alterado nem excluído (RN-ORG-174).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bank_id`	Banco.
`bond_id`	Vínculo.
`on_date`	Data do período em que o vínculo participa.
`minutes`	Minutos a somar ou subtrair; nunca zero.
`reason`	Motivo, obrigatório.
`reverses_id`	Ajuste estornado; preenchido só no estorno, que ocorre uma única vez por ajuste.
`recorded_by`	Quem lançou.
`recorded_at`	Momento do lançamento.

Apuração do banco (`hour_bank_processings`)

Cada vez que o banco é apurado; as anteriores são mantidas (RN-ORG-173). Nunca é alterada nem excluída.

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bank_id`	Banco.
`through`	Data até a qual o saldo foi apurado; não pode ser hoje nem futura nem fora do período.
`processed_by`	Quem apurou.
`processed_at`	Momento da apuração.

Saldo apurado (`hour_bank_balances`)

O retrato do saldo de um participante numa apuração. Nunca é alterado nem excluído (RN-ORG-173).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`processing_id`	Apuração.
`bond_id`	Vínculo.
`expected_minutes`	Minutos esperados no período apurado.
`worked_minutes`	Minutos trabalhados.
`day_balance_minutes`	Soma dos saldos diários (RN-ORG-171).
`adjustment_minutes`	Soma dos ajustes manuais.
`total_minutes`	Saldo total: saldos diários mais ajustes.

Pedido de frequência ou geral (`attendance_requests`)

O pedido de um funcionário, do tipo configurado no catálogo request-types (RN-ORG-180).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo.
`type_code`	Tipo de pedido, do catálogo do cliente.
`scope`	`frequency` (data única) ou `general` (período) (RN-ORG-181).
`effect`	Efeito ao ser atendido: `none`, `justify-absence`, `add-punch` ou `void-punch` (RN-ORG-185).
`starts_on`	Data do pedido ou início do período.
`ends_on`	Fim do período; igual ao início no pedido de frequência (RN-ORG-181).
`description`	Descrição do pedido.
`attachment_ref`	Referência do anexo entregue pelo Hub; obrigatória conforme o tipo.
`punch_kind`	Entrada ou saída a incluir; só no efeito `add-punch`.
`punch_time`	Horário local a incluir, no formato HH:MM, convertido no fuso do cliente; só no efeito `add-punch` (RN-ORG-185).
`punch_id`	Registro a anular; só no efeito `void-punch` (RN-ORG-186).
`status`	`pending`, `attended`, `denied` ou `cancelled` (RN-ORG-182).
`requested_by`	Quem pediu.
`requested_at`	Momento do pedido.
`decided_by`	Quem atendeu, negou ou cancelou.
`decided_at`	Momento da decisão.
`justification`	Justificativa; obrigatória ao negar ou cancelar (RN-ORG-183, RN-ORG-184).

Atestado (`medical_certificates`)

Dado sensível: aparece só para o próprio funcionário ou com permissão própria, e cada consulta é registrada (RN-ORG-193).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo.
`type_code`	Tipo de atestado, do catálogo `certificate-types`.
`justifies_absence`	Se o tipo justifica ausência, tal como na data do registro (RN-ORG-165).
`starts_on`	Primeiro dia.
`ends_on`	Último dia.
`days`	Número de dias, contado inclusive o último (RN-ORG-190).
`file_ref`	Referência do arquivo entregue pelo Hub.
`registered_by`	Quem apresentou.
`registered_at`	Momento do registro.
`reversed_by`	Quem estornou; vazio enquanto ativo.
`reversed_at`	Momento do estorno.
`reverse_reason`	Motivo do estorno (RN-ORG-192).

Calendário de férias (`vacation_calendars`)

Janela em que o cliente aceita pedidos de férias (RN-ORG-201).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`name`	Nome.
`organization_id`	Organização a que vale; vazio quando vale para todas.
`request_from`	Primeiro dia da janela de pedidos.
`request_to`	Último dia da janela de pedidos.
`closed_on`	Data em que foi fechado; vazio enquanto aberto.

Férias (`vacations`)

Um pedido de férias de um vínculo. O período aquisitivo não é gravado: é calculado (RN-ORG-200).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo.
`period_starts_on`	Início do período aquisitivo consumido; amarra as férias ao período mesmo que a configuração mude depois (RN-ORG-202).
`starts_on`	Primeiro dia das férias.
`ends_on`	Último dia das férias.
`days`	Dias de férias, contados inclusive o último.
`sold_days`	Dias vendidos; zero quando não há venda (RN-ORG-204).
`thirteenth_advance`	Se há adiantamento do 13º (RN-ORG-204).
`status`	`requested`, `analyzed`, `approved`, `taken`, `denied` ou `cancelled` (RN-ORG-206, RN-ORG-207).
`requested_by`	Quem pediu.
`requested_at`	Momento do pedido.

Decisão de férias (`vacation_decisions`)

Cada etapa decidida no fluxo das férias. Nunca é alterada nem excluída (RN-ORG-206).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`vacation_id`	Férias.
`step`	`analysis`, `approval`, `denial`, `cancellation` ou `taken`.
`decided_by`	Quem decidiu.
`note`	Justificativa; obrigatória em negação e cancelamento.
`decided_at`	Momento da decisão.

Relações da rotina

Tudo pertence ao vínculo: quem tem dois vínculos tem dois pontos, dois bancos e dois saldos de férias (RN-ORG-153, RN-ORG-156).
Registro de ponto não se altera nem se apaga; só se anula por pedido atendido, e a anulação fica registrada (RN-ORG-157, RN-ORG-185).
Irregularidades, ausências e saldos diários nascem da jornada, dos feriados, dos registros válidos e das justificativas; pedidos atendidos, atestados ativos e férias aprovadas ou gozadas fornecem as justificativas (RN-ORG-160, RN-ORG-165).
A apuração guarda o saldo de cada participante e mantém as anteriores; o ajuste manual só se corrige por estorno (RN-ORG-173, RN-ORG-174).
As férias consomem o período aquisitivo mais antigo com saldo, e todos os valores da legislação vêm da configuração do cliente (RN-ORG-202, RN-ORG-208).

Patamar esperado por cargo (`position_skill_levels`)

Nota esperada de uma habilidade num cargo, com vigência. Mudança cria linha nova e retirada fecha a vigente; no máximo uma vigente por cargo e habilidade (RN-ORG-220, RN-ORG-221).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`position_id`	Cargo.
`skill_code`	Código da habilidade no catálogo `skills`.
`expected_level`	Nota esperada, inteira e dentro da escala da habilidade.
`valid_from`	Início da vigência.
`valid_to`	Fim da vigência; vazio enquanto vigente.

Prova de competência (`competence_evidences`)

Prova de que a pessoa atende a um requisito do cargo (cláusula 7.2 da ISO 9001). Nunca se altera: corrige-se por estorno (RN-ORG-222, RN-ORG-223).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa que atende ao requisito.
`position_id`	Cargo do requisito.
`requirement_kind`	`education`, `training` ou `experience`.
`requirement_description`	Texto do requisito vigente do cargo ao qual a prova se refere.
`evidence_kind`	`document`, `enrollment` ou `statement`.
`ref`	Referência da prova: documento conferido da pessoa, matrícula ou declaração.
`notes`	Observação.
`recorded_on`	Data do registro.
`recorded_by`	Quem registrou.
`reversed_at`	Momento do estorno; vazio enquanto vale.
`reversed_by`	Quem estornou.
`reverse_reason`	Motivo do estorno; obrigatório quando há estorno.

Ciclo de avaliação (`evaluation_cycles`)

Ciclo de avaliação 360. A configuração vigente na abertura é copiada para o ciclo e não muda depois (RN-ORG-224, RN-ORG-225).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`code`	Código único do ciclo no cliente.
`name`	Nome.
`period_start`	Início do período avaliado.
`period_end`	Fim do período avaliado.
`opens_on`	Data de abertura.
`appraised_on`	Data da apuração; vazio enquanto aberto.
`closed_on`	Data do encerramento; vazio até encerrar.
`status`	`open`, `appraised` ou `closed`.
`config`	Cópia da configuração na abertura: habilidades, fontes, tipos de vínculo, pesos e nove quadros.

Participante do ciclo (`cycle_participants`)

Pessoa elegível fixada na apuração, com o contexto daquela data (RN-ORG-226).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`cycle_id`	Ciclo.
`person_id`	Pessoa avaliada.
`bond_id`	Vínculo que a tornou elegível.
`position_id`	Cargo na data da apuração.
`track_code`	Trilha na data da apuração.
`expected`	Patamares esperados por habilidade, fixados na apuração (RN-ORG-234).

Avaliação (`evaluations`)

Notas de um avaliador a um avaliado num ciclo. Nunca se altera: corrige-se por estorno (RN-ORG-227 a RN-ORG-231). O resultado não é gravado: é calculado a cada leitura (RN-ORG-232 a RN-ORG-236).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`cycle_id`	Ciclo.
`person_id`	Pessoa avaliada.
`evaluator_person_id`	Pessoa que avaliou.
`source_code`	Fonte de avaliação, do catálogo `evaluation-sources`.
`scores`	Nota inteira por habilidade do ciclo.
`comment`	Comentário.
`submitted_at`	Momento do envio.
`reversed_at`	Momento do estorno; vazio enquanto vale.
`reversed_by`	Quem estornou.
`reversal_reason`	Motivo do estorno; obrigatório quando há estorno.

Avaliação de experiência (`probation_reviews`)

Avaliação do período de experiência de um vínculo. Nunca se altera: corrige-se por estorno (RN-ORG-238, RN-ORG-239).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`bond_id`	Vínculo avaliado.
`outcome`	`approved` ou `not-approved`.
`comments`	Comentário do avaliador; obrigatório.
`reviewed_on`	Data da avaliação.
`reviewer_ref`	Quem avaliou.
`created_at`	Momento do registro.
`reversed_at`	Momento do estorno; vazio enquanto vale.
`reversed_by`	Quem estornou.
`reversal_reason`	Motivo do estorno; obrigatório quando há estorno.

Pedido de feedback (`feedback_requests`)

Pedido de feedback com prazo (RN-ORG-241).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa que pede.
`requested_of_person_id`	Pessoa pedida; diferente de quem pede.
`message`	Texto do pedido.
`requested_on`	Data do pedido.
`due_on`	Prazo; posterior à data do pedido.
`status`	`pending`, `answered` ou `declined`.
`feedback_id`	Feedback que respondeu ao pedido.
`decline_reason`	Motivo da recusa; obrigatório quando recusado.
`closed_on`	Data da resposta ou recusa; vazio enquanto pendente.

Feedback (`feedbacks`)

Feedback dado por uma pessoa a outra, nunca a si mesma (RN-ORG-240).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa que recebeu.
`giver_person_id`	Pessoa que deu.
`request_id`	Pedido atendido, quando houver.
`content`	Texto do feedback.
`given_on`	Data.
`recorded_at`	Momento do registro.

Elogio (`recognitions`)

Elogio com tipo do catálogo, exibido no mural. Nunca se altera: o estorno o tira do mural (RN-ORG-242).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Autor do elogio; nunca está entre os elogiados.
`kind_code`	Tipo, do catálogo `recognition-kinds`.
`message`	Texto.
`attachment_ref`	Anexo opcional.
`given_on`	Data.
`reversed_at`	Momento do estorno; vazio enquanto vale.
`reversed_by`	Quem estornou.
`reversal_reason`	Motivo do estorno; obrigatório quando há estorno.

Elogiado (`recognition_recipients`)

Pessoa elogiada; um elogio tem um ou mais, distintos (RN-ORG-242).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`recognition_id`	Elogio.
`person_id`	Pessoa elogiada.

Plano de desenvolvimento (`development_plans`)

Plano de uma pessoa, com vigência. Plano novo fecha o anterior na véspera (RN-ORG-243, RN-ORG-244).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa.
`cycle_id`	Ciclo de origem, quando o plano parte de um resultado.
`valid_from`	Início da vigência.
`valid_to`	Fim da vigência; vazio enquanto vigente.
`defined_by`	Quem definiu.

Item do plano (`development_plan_items`)

Ação do plano, com prazo (RN-ORG-243, RN-ORG-245).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`plan_id`	Plano.
`skill_code`	Habilidade trabalhada, quando houver.
`action`	Ação.
`due_on`	Prazo; não anterior ao início do plano.
`status`	`open`, `done` ou `dropped`.
`closed_on`	Data da conclusão ou abandono; vazio enquanto aberto.
`note`	Observação.

Curso por cargo (`position_courses`)

Curso esperado de um cargo, com vigência (RN-ORG-246).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`position_id`	Cargo.
`course_code`	Curso, do catálogo `courses`.
`valid_from`	Início da vigência.
`valid_to`	Fim da vigência; vazio enquanto vigente.

Matrícula (`enrollments`)

Matrícula de uma pessoa em um curso (cláusula 7.2 da ISO 9001). Uma em aberto por pessoa e curso (RN-ORG-247).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`person_id`	Pessoa.
`course_code`	Curso.
`enrolled_on`	Data da matrícula.
`status`	`enrolled`, `completed` ou `cancelled`.
`completed_on`	Data da conclusão; não anterior à matrícula.
`certificate_ref`	Comprovante de conclusão.
`cancelled_on`	Data do cancelamento.
`cancel_reason`	Motivo do cancelamento; obrigatório quando cancelada.

Eficácia do treinamento (`training_effectiveness`)

Avaliação da eficácia de um curso concluído, uma por matrícula (cláusula 7.2 da ISO 9001; RN-ORG-248, RN-ORG-249).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`enrollment_id`	Matrícula concluída.
`effective`	Se o treinamento foi eficaz.
`method`	Método usado na avaliação.
`notes`	Observação.
`evaluated_on`	Data; não anterior à conclusão.
`evaluator_ref`	Quem avaliou.

Comunicado (`announcements`)

Comunicado interno (cláusulas 7.3 e 7.4 da ISO 9001). Nada se apaga: a retirada o tira do feed, com motivo (RN-ORG-250, RN-ORG-252).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`kind_code`	Tipo, do catálogo `announcement-kinds`.
`title`	Título.
`body`	Texto.
`audience`	Público: todos ou unidades, com ou sem as de baixo.
`publish_on`	Data de publicação.
`requires_acknowledgement`	Se pede ciência, copiado do tipo na publicação.
`author_ref`	Autor.
`recorded_at`	Momento do registro.
`withdrawn_at`	Momento da retirada; vazio enquanto no feed.
`withdrawn_by`	Quem retirou.
`withdraw_reason`	Motivo da retirada; obrigatório quando retirado.

Ciência (`announcement_acknowledgements`)

Ciência de uma pessoa em um comunicado, uma por pessoa (RN-ORG-251, RN-ORG-253).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`announcement_id`	Comunicado.
`person_id`	Pessoa que deu ciência.
`acknowledged_on`	Data da ciência.
`recorded_at`	Momento do registro.

Questionário (`surveys`)

Questionário interno, anônimo ou não (RN-ORG-254).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`title`	Título.
`questions`	Perguntas tipadas: texto, escolha única, múltipla ou escala.
`audience`	Público: todos ou unidades, com ou sem as de baixo.
`opens_on`	Início da janela de resposta.
`closes_on`	Fim da janela de resposta.
`anonymous`	Se as respostas não guardam ligação com a pessoa.
`author_ref`	Autor.

Participação no questionário (`survey_participations`)

Registro de que a pessoa respondeu, uma vez. É o único vestígio da pessoa num questionário anônimo (RN-ORG-255, RN-ORG-256).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`survey_id`	Questionário.
`person_id`	Pessoa que respondeu.
`responded_on`	Data da resposta.

Resposta do questionário (`survey_answers`)

Respostas de uma participação. No questionário anônimo não há ligação com a participação (RN-ORG-256, RN-ORG-257).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`survey_id`	Questionário.
`participation_id`	Participação; vazio quando o questionário é anônimo.
`answers`	Respostas, uma por pergunta.

Relações do desenvolvimento e da comunicação

Habilidades, grupos, fontes, pesos por trilha, tipos de elogio, cursos e tipos de comunicado são catálogos do cliente; a habilidade tem escala própria (RN-ORG-220, RN-ORG-227).
O ciclo copia a configuração na abertura e fixa os participantes, com cargo, trilha e patamares, na apuração (RN-ORG-224, RN-ORG-226).
Notas, provas, avaliações de experiência e elogios nunca se alteram: corrigem-se por estorno com motivo (RN-ORG-222, RN-ORG-231, RN-ORG-238, RN-ORG-242).
O resultado da avaliação e os nove quadros não são gravados: são calculados a cada leitura a partir das notas, da configuração copiada e do contexto fixado na apuração (RN-ORG-232 a RN-ORG-236).
Feedback, plano, matrícula e ciência pertencem à pessoa; avaliação de experiência pertence ao vínculo (RN-ORG-238, RN-ORG-240, RN-ORG-243, RN-ORG-247, RN-ORG-251).
No questionário anônimo, a resposta não guarda ligação com a pessoa (RN-ORG-256).
Os módulos leem o cadastro pelas funções públicas de pessoas, vínculos, lotações, cargos e lideranças (RN-ORG-259).

Entidades das metas

Complementam as entidades da base de cadastro. Toda entidade pertence a um cliente (RN-ORG-001). Nada se apaga: a correção é revisão, encerramento ou estorno (RN-ORG-306 a RN-ORG-308). O realizado não é guardado aqui (RN-ORG-311).

Meta (`goals`)

Meta de uma unidade ou de uma pessoa para um indicador, num período (RN-ORG-300 a RN-ORG-305).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`unit_id`	Unidade alvo; vazio quando o alvo é uma pessoa. O tipo do alvo (unidade ou pessoa) não é coluna: deriva de `unit_id` e `person_id` e aparece como `targetKind` na leitura (RN-ORG-300).
`person_id`	Pessoa alvo; vazio quando o alvo é uma unidade.
`indicator_code`	Código do indicador, do catálogo `goal-indicators`.
`indicator_name`	Retrato do nome do indicador na data de início. A meta não guarda a versão do indicador, só este retrato (RN-ORG-301).
`measure_unit`	Retrato da unidade de medida.
`direction`	Retrato do sentido: `higher-is-better` ou `lower-is-better`.
`scale`	Retrato das casas decimais, de 0 a 4.
`period_start`	Primeiro dia do período (RN-ORG-302).
`period_end`	Último dia do período, incluído.
`closed_on`	Último dia efetivo, quando a meta foi encerrada antes do fim; vazio enquanto não encerrada (RN-ORG-307).
`close_reason`	Motivo do encerramento; obrigatório quando encerrada.
`reversed_at`	Momento do estorno; vazio enquanto não estornada (RN-ORG-308).
`reverse_reason`	Motivo do estorno; obrigatório quando estornada.
`created_at`	Momento do registro.

Versão do valor-alvo (`goal_versions`)

Cada valor-alvo que a meta já teve, com o intervalo em que valeu (RN-ORG-304, RN-ORG-306, RN-ORG-309).

Campo	O que guarda
`id`	Identificador.
`tenant_id`	Cliente dono do registro (RN-ORG-001).
`goal_id`	Meta.
`version`	Número da versão, a partir de 1.
`target`	Valor-alvo, decimal exato escrito com ponto.
`reason`	Motivo da revisão; na versão 1, a observação opcional `note` da criação, vazia quando não informada.
`valid_from`	Primeiro dia de vigência da versão.
`valid_to`	Último dia de vigência; vazio na versão aberta.

Relações das metas

Uma meta pertence a uma unidade ou a uma pessoa da base de cadastro, nunca às duas (RN-ORG-300).
Uma meta tem uma ou mais versões do valor-alvo; as versões não se sobrepõem e a anterior fecha na véspera da seguinte (RN-ORG-306).
A meta guarda o retrato do indicador; mudar ou aposentar o indicador no catálogo não altera metas existentes (RN-ORG-301).
Na união de cadastros, as metas do cadastro que sai passam para o que fica (RN-ORG-312).

Entidades e relacionamentos · Gestão organizacional

Organização (organizations)

Versões da organização (organization_versions)

Unidade (units)

Versões da unidade (unit_versions)

Escritório físico (offices)

Versões do escritório (office_versions)

Pessoa (persons)

Correção de cadastro (person_corrections)

Conta em outro sistema (external_accounts)

Dependente (dependents)

Leitura sensível (sensitive_reads)

Vínculo (bonds)

Lotação (assignments)

Cargo (positions)

Versões do cargo (position_versions)

Nível (levels)

Enquadramento (bond_levels)

Documento (documents)

Admissão (admissions)

Designação (designations)

Colegiado (bodies)

Versões do colegiado (body_versions)

Uso de colegiado (body_usages)

Assento (seats)

Valor de índice (index_values)

Coeficiente do nível (level_coefficients)

Lançamento de gratificação e estorno (gratification_entries)

Registro de consulta de remuneração (remuneration_reads)

Arranjo de trabalho (work_arrangements)

Registro de ponto (punches)

Anulação de registro (punch_voids)

Banco de horas (hour_banks)

Participante do banco (hour_bank_members)

Ajuste do banco (hour_bank_adjustments)

Apuração do banco (hour_bank_processings)

Saldo apurado (hour_bank_balances)

Pedido de frequência ou geral (attendance_requests)

Atestado (medical_certificates)

Calendário de férias (vacation_calendars)

Férias (vacations)

Decisão de férias (vacation_decisions)

Patamar esperado por cargo (position_skill_levels)

Prova de competência (competence_evidences)

Ciclo de avaliação (evaluation_cycles)

Participante do ciclo (cycle_participants)

Avaliação (evaluations)

Avaliação de experiência (probation_reviews)

Pedido de feedback (feedback_requests)

Feedback (feedbacks)

Elogio (recognitions)

Elogiado (recognition_recipients)

Plano de desenvolvimento (development_plans)

Item do plano (development_plan_items)

Curso por cargo (position_courses)

Matrícula (enrollments)

Eficácia do treinamento (training_effectiveness)

Comunicado (announcements)

Ciência (announcement_acknowledgements)

Questionário (surveys)

Participação no questionário (survey_participations)

Resposta do questionário (survey_answers)

Meta (goals)

Versão do valor-alvo (goal_versions)

Organização (`organizations`)

Versões da organização (`organization_versions`)

Unidade (`units`)

Versões da unidade (`unit_versions`)

Escritório físico (`offices`)

Versões do escritório (`office_versions`)

Pessoa (`persons`)

Correção de cadastro (`person_corrections`)

Conta em outro sistema (`external_accounts`)

Dependente (`dependents`)

Leitura sensível (`sensitive_reads`)

Vínculo (`bonds`)

Lotação (`assignments`)

Cargo (`positions`)

Versões do cargo (`position_versions`)

Nível (`levels`)

Enquadramento (`bond_levels`)

Documento (`documents`)

Admissão (`admissions`)

Designação (`designations`)

Colegiado (`bodies`)

Versões do colegiado (`body_versions`)

Uso de colegiado (`body_usages`)

Assento (`seats`)

Valor de índice (`index_values`)

Coeficiente do nível (`level_coefficients`)

Lançamento de gratificação e estorno (`gratification_entries`)

Registro de consulta de remuneração (`remuneration_reads`)

Arranjo de trabalho (`work_arrangements`)

Registro de ponto (`punches`)

Anulação de registro (`punch_voids`)

Banco de horas (`hour_banks`)

Participante do banco (`hour_bank_members`)

Ajuste do banco (`hour_bank_adjustments`)

Apuração do banco (`hour_bank_processings`)

Saldo apurado (`hour_bank_balances`)

Pedido de frequência ou geral (`attendance_requests`)

Atestado (`medical_certificates`)

Calendário de férias (`vacation_calendars`)

Férias (`vacations`)

Decisão de férias (`vacation_decisions`)

Patamar esperado por cargo (`position_skill_levels`)

Prova de competência (`competence_evidences`)

Ciclo de avaliação (`evaluation_cycles`)

Participante do ciclo (`cycle_participants`)

Avaliação (`evaluations`)

Avaliação de experiência (`probation_reviews`)

Pedido de feedback (`feedback_requests`)

Feedback (`feedbacks`)

Elogio (`recognitions`)

Elogiado (`recognition_recipients`)

Plano de desenvolvimento (`development_plans`)

Item do plano (`development_plan_items`)

Curso por cargo (`position_courses`)

Matrícula (`enrollments`)

Eficácia do treinamento (`training_effectiveness`)

Comunicado (`announcements`)

Ciência (`announcement_acknowledgements`)

Questionário (`surveys`)

Participação no questionário (`survey_participations`)

Resposta do questionário (`survey_answers`)

Meta (`goals`)

Versão do valor-alvo (`goal_versions`)