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) |