Com este artigo buscamos apresentar os principais relacionamentos entre nossas tabelas e mostrar como os dados delas se conversam, encorajando nossos clientes no desenvolvimento de painéis gerenciais customizados em suas ferramentas de dados e BI (Business Intelligence) preferidas.

Mapa Mental de Tabelas

O mapa abaixo tem por objetivo facilitar o entendimento sobre os relacionamentos entre as tabelas, para ajudar ao usuário a criar seus painéis gerenciais com os dados das tabelas exportadas, via opção "download dos dados da conta", disponível em gerenciamento de filiais para usuários administradores.

Clique com o botão direito do mouse sobre a imagem e selecione "Abrir imagem em uma nova guia" para ter uma visão ampliada.

Note que algumas tabelas tem sua representação repetida no mapa, justamente para representar a dependência da mesma, os campos que fazem esse relacionamento serão apresentados na seção tabelas e relacionamentos. Também há um item no mapa denominado "Cadastros Gerais", este apenas representa uma organização das tabelas cujo os registros são realizados no item de menu do mesmo nome no Keepfy.

Tabelas e relacionamentos

Antes da apresentação dos campos, é necessário saber que todas as tabelas, possuem um campo identificador denominado "id". É com este "id" que um registro pode ser facilmente identificado e também relacionado a outras tabelas. Sendo assim, cada filial, equipamento, ordem de serviço, solicitação de serviço, e as demais tabelas possuem um campo com um código identificador único (ID).

Também é importante entender que o identificador único é representado pelo campo "id" somente na tabela de origem do registro. Na tabela destino geralmente este identificador é representando por um campo com o mesmo nome da tabela origem. Por exemplo, o código "id" de uma filial é encontrado no campo branch na tabela de equipamentos (equipment). Conforme figura abaixo, onde PK é a sigla em inglês para chave primária (primary key) e FK é a sigla em inglês para chave estrangeira (foreign key):

Na listagem abaixo, apenas os campos que fazem referência a outra tabela serão apresentados. Em algumas tabelas, será apresentado referência a tabela de Organização (organization), porém esta não é exportada por ser de controle interno do sistema, no entanto, a falta desta tabela na exportação não deve limitar o desenvolvimento de suas consultas.

Área (area)

Áreas de manutenções que serão relacionadas nas ordens de serviço via recursos, planos de manutenções e planos mestres.

id

Identificador da área.

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Filial (branch)

As filiais são as ramificações de sua organização entre regiões diversas.

id

Identificador da filial.

organization

Identificador da organização que se relaciona com o campo id da tabela Organização (organization)

Calendário (calendar)

Determina intervalos de horários que podem ser associados a tempos de serviço, sejam de equipamentos ou de funcionários.

id

Identificador do calendário

organization

Identificador da organização que se relaciona com o campo id da tabela Organização (organization)

Centro de Custo (cost_center)

Espaços agregadores de custos que podem estar relacionados a localização ou setor em que um equipamento se encontra. Estes registros pode estar relacionado a um equipamento, ordem de serviço ou solicitação de serviço.

id

Identificador do centro de custo.

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Histórico de Contador (counter_entry)

Tabela de registro dos lançamentos de contadores realizados para equipamentos com este controle.

id

Identificador do lançamento

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

equipment

Identificador do equipamento que se relaciona com o campo id da tabela Equipamento (equipment)

service_order

Identificador da OS que se relaciona com o campo id da tabela Ordem de Serviço (service_order) - quando o informe de contador for efetuado por meio da finalização da OS.

Funcionário / Mão de Obra (employee)

Tabela de cadastro de funcionários da empresa e relacionado com usuários.

id

Identificador do funcionário

calendar

Identificador do calendário que se relaciona com o campo id da tabela Calendário (calendar)

organization

Identificador da organização que se relaciona com o campo id da tabela Organização (organization)

user

Identificador do usuário do sistema que se relaciona com o campo id da tabela Usuário (user)

Especialidade de Funcionário / Mão de Obra (employee_specialty)

Tabela responsável por gravar o relacionamento de funcionários com especialidades definidas.

id

Identificador do relacionamento

specialty

Identificador da especialidade que se relaciona com o campo id da tabela Especialidade (specialty)

employee

Identificador do funcionário que se relaciona com o campo id da tabela Funcionário (employee)

organization

Identificador da organização que se relaciona com o campo id da tabela Organização (organization)

Equipamento (equipment)

Tabela responsável por guardar as dados dos equipamentos cadastrados.

id

Identificador do equipamento

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

calendar

Identificador do calendário que se relaciona com o campo id da tabela Calendário (calendar)

cost_center

Identificador do centro de custo que se relaciona com o campo id da tabela Centro de Custo (cost_center)

model

Identificador do modelo que se relaciona com o campo id da tabela Modelo (model)

group

Identificador do grupo que se relaciona com o campo id da tabela Grupo (group)

release_reason

Identificador do motivo de inativação do equipamento que se relaciona com o campo id da tabela Motivo (reason)

Ficha Técnica (equipment_property)

Registros de ficha técnica do equipamento - relacionando as característica aos equipamentos.

id

Identificador do relacionamento

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

equipment

Identificador do equipamento que se relaciona com o campo id da tabela Equipamento (equipment)

feature

Identificador da característica que se relaciona com o campo id da tabela Característica (feature)

measurement_unit

Identificador da unidade de medida que se relaciona com o campo id da tabela Unidades de Medida.

Características (feature)

Itens utilizados para especificar um equipamento em ficha técnica, o mesmo pode ser uma propriedade de altura, largura, potência, etc.

id

Identificador da característica

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Grupo (group)

Grupos de equipamentos cadastrados.

id

Identificador do grupo

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Resultado de Indicadores (indicator_result)

Nesta tabela se encontram os registros de indicadores calculados no último dia de cada mês para os equipamentos cadastrados, conforme seu histórico de manutenção naquele momento.

id

Identificador do indicador registrado

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

equipment

Identificador do equipamento que se relaciona com o campo id da tabela Equipamento (equipment)

Convite (invite)

Representa um ou mais e-mails enviados aos futuros usuários do sistema. Esses convites estão relacionados aos clientes, aos perfis e aos usuários. Um convite, obrigatoriamente, deve ser enviado a um e-mail e o perfil do futuro usuário deve ser indicado.

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

user

Identificador do usuário do sistema que se relaciona com o campo id da tabela Usuário (user)

Plano de Manutenção (maintenance)

Planos de manutenção criados para os equipamentos

id

Identificador do plano de manutenção

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

equipment

Identificador do equipamento que se relaciona com o campo id da tabela Equipamento (equipment)

master_plan

Identificador do plano mestre que se relaciona com o campo id da tabela Plano Mestre (master_plan)

Recursos do Plano de Manutenção (maintenance_resource)

Relacionamento de recursos vinculados a um plano de manutenção criado para um equipamento.

id

Identificador do relacionamento

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

maintenance

Identificador do plano de manutenção que se relaciona com o campo id da tabela Plano de Manutenção (maintenance)

area

Identificador da área que se relaciona com o campo id da tabela Área (area)

employee

Identificador da funcionário/mão de obra que se relaciona com o campo id da tabela Funcionários (employee)

specialty

Identificador da especialidade que se relaciona com o campo id da tabela Especialidade (specialty)

step

Identificador da etapa que se relaciona com o campo id da tabela Etapa (step)

material

Identificador do material que se relaciona com o campo id da tabela Material (material)

tool

Identificador da ferramenta que se relaciona com o campo id da tabela Ferramenta (tool)

parent

Identificador do registro acima (pai) do recurso vinculado logo acima na estrutura da árvore de recursos.

Fabricante (manufacturer)

Registro de fabricantes que podem ser relacionados a modelos de equipamentos.

id

Identificador do fabricante

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Plano Mestre (master_plan)

Conjuntos de atividades que serve como facilitador para geração dos planos de manutenção preventivas dos equipamentos.

id

Identificador do plano mestre

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

model

Identificador do modelo que se relaciona com o campo id da tabela Modelo (model)

group

Identificador do grupo que se relaciona com o campo id da tabela Grupo (group)

Recursos do Plano Mestre (master_plan_resource)

Todos os recursos criados em estrutura de árvore para os planos mestre de manutenção.

id

Identificador do plano mestre

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

master_plan

Identificador do plano mestre que se relaciona com o campo id da tabela Plano Mestre (master_plan)

area

Identificador da área que se relaciona com o campo id da tabela Área (area)

employee

Identificador da funcionário/mão de obra que se relaciona com o campo id da tabela Funcionários (employee)

specialty

Identificador da especialidade que se relaciona com o campo id da tabela Especialidade (specialty)

step

Identificador da etapa que se relaciona com o campo id da tabela Etapa (step)

material

Identificador do material que se relaciona com o campo id da tabela Material (material)

tool

Identificador da ferramenta que se relaciona com o campo id da tabela Ferramenta (tool)

parent

Identificador do registro acima (pai) do recurso vinculado logo acima na estrutura da árvore de recursos.

Material (material)

Registros de materiais de consumo em ordens de serviço.

id

Identificador do material

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

measurement_unit

Identificador da unidade de medida que se relaciona com o campo id da tabela Unidades de Medida.

Modelo (model)

Registros de modelos que podem ser relacionados aos equipamentos.

id

Identificador do modelo

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

manufacturer

Identificador do fabricante que se relaciona com o campo id da tabela Filial (manufacturer)

Motivo (reason)

Relação de motivos que podem ser usados em processos de cancelamento de OS, SS ou ainda em inativação de equipamentos.

id

Identificador do motivo

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Recurso (resource)

Registros de recursos previstos ou realizados em ordem de serviço.

id

Identificador do relacionamento recurso

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

service_order

Identificador da ordem de serviço que se relaciona com o campo id da tabela Ordem de Serviço (service_order)

area

Identificador da área que se relaciona com o campo id da tabela Área (area)

employee

Identificador da funcionário/mão de obra que se relaciona com o campo id da tabela Funcionários (employee)

specialty

Identificador da especialidade que se relaciona com o campo id da tabela Especialidade (specialty)

step

Identificador da etapa que se relaciona com o campo id da tabela Etapa (step)

material

Identificador do material que se relaciona com o campo id da tabela Material (material)

tool

Identificador da ferramenta que se relaciona com o campo id da tabela Ferramenta (tool)

parent

Identificador do registro acima (pai) do recurso vinculado logo acima na estrutura da árvore de recursos.

area_done

Identificador da área realizada que se relaciona com o campo id da tabela Área (area)

employee_done

Identificador da funcionário/mão de obra realizado que se relaciona com o campo id da tabela Funcionários (employee)

step_done

Identificador da etapa realizada que se relaciona com o campo id da tabela Etapa (step)

material_done

Identificador do material realizado que se relaciona com o campo id da tabela Material (material)

tool_done

Identificador da ferramenta realizada que se relaciona com o campo id da tabela Ferramenta (tool)

parent_done

Identificador do registro acima (pai) realizado do recurso vinculado logo acima na estrutura da árvore de recursos.

Pesquisa de Satisfação (satisfaction_survey)

Registro das pesquisas de satisfação respondidas após a finalização de uma ordem de serviço por um executor.

id

Identificador da pesquisa de satisfação

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Ordem de Serviço (service_order)

Registro das ordens de serviço criadas.

id

Identificador da ordem de serviço

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

initial_user

Identificador do usuário que abriu a ordem de serviço e que se relaciona com o campo id da tabela Usuário (user)

cost_center

Identificador do centro de custo que se relaciona com o campo id da tabela Centro de Custo (cost_center)

equipment

Identificador do equipamento que se relaciona com o campo id da tabela Equipamento (equipment)

cancellation_reason

Identificador do motivo de cancelamento da OS que se relaciona com o campo id da tabela Motivo (reason)

maintenance

Identificador do plano de manutenção relacionado a ordem de serviço, que se relaciona com o campo id da tabela Plano de Manutenção (maintenance)

Acompanhamento de OS (service_order_follow_up)

Registros de alterações e processos realizados em ordens de serviço.

id

Identificador do acompanhamento

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

service_order

Identificador da ordem de serviço que se relaciona com o campo id da tabela Ordem de Serviço (service_order)

user

Identificador do usuário que realizou alguma interação com a OS, que se relacionado com o campo id da tabela Usuário (user)

Solicitação de Serviço (service_request)

Registros de solicitações de serviço criadas no sistemas

id

Identificador da solicitação de serviço

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

equipment

Identificador do equipamento que se relaciona com o campo id da tabela Equipamento (equipment)

cost_center

Identificador do centro de custo que se relaciona com o campo id da tabela Centro de Custo (cost_center)

requester

Identificador do usuário que abriu a solicitação de serviço, que se relaciona com o campo id da tabela Usuário (user)

employee

Identificador do funcionário que se relaciona com o campo id da tabela Funcionário (employee)

cancellation_reason

Identificador do motivo de cancelamento da SS que se relaciona com o campo id da tabela Motivo (reason)

service_order

Identificador da OS que se relaciona com o campo id da tabela Ordem de Serviço (service_order)

satisfaction_survey

Data em que alguma das informações foi alterada

Acompanhamento de SS (service_request_follow_up)

Registros de alterações e processos realizados em solicitações de serviço.

id

Identificador do acompanhamento

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

service_request

Identificador da solicitação de serviço que se relaciona com o campo id da tabela Solicitação de Serviço (service_request)

user

Identificador do usuário que realizou alguma interação com a SS, que se relacionado com o campo id da tabela Usuário (user)

Especialidade (specialty)

Atividade, profissão ou campo do conhecimento que um funcionário da empresa particularmente domina. Esta tabela é responsável por guardar todas as especialidades utilizadas, porém posteriormente será relacionada ao funcionário através da tabela especialidade de funcionário (employee_specialty).

id

Identificador da especialidade

organization

Identificador da organização que se relaciona com o campo id da tabela Organização (organization)

Etapa (step)

Atividades realizadas no checklist da ordem de serviço, como por exemplo, "medição de temperatura" ou "instalar componente".

id

Identificador da etapa

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

measurement_unit

Identificador da unidade de medida que se relaciona com o campo id da tabela Unidades de Medida.

Ferramenta (tool)

Utensílios utilizados durante a execução de ordens de serviço, como multímetro ou chave de fenda.

id

Identificador da ferramenta

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Usuário (user)

São os usuários que acessam o sistema por meio de login.

id

Identificador do usuário

restricted_by

Identificador da organização que se relaciona com o campo id da tabela Organização (organization)

Perfil de Usuário (user_role)

O perfil do usuário (executor, solicitante, planejador ou administrador) está associado ao usuário para que possa definir quais são suas ações permitidas no sistema.

id

Identificador do relacionamento

user

Identificador do usuário do sistema que se relaciona com o campo id da tabela Usuário (user)

branch

Identificador da filial que se relaciona com o campo id da tabela Filial (branch)

Calendário de Operação (work_shift)

São intervalos definidos de horários entre os dias da semana e compõem os calendários

id

Identificador do calendário de operação

calendar

Identificador do calendário que se relaciona com o campo id da tabela Calendário (calendar)

organization

Identificador da organização que se relaciona com o campo id da tabela Organização (organization)

Encontrou a sua resposta?