DbranOS — referência de regras
Para consultar, não para ler de ponta a ponta. O DbranOS é o módulo de manutenção: um problema no chão de fábrica vira chamado, o chamado vira Ordem de Serviço, a OS vai para um ou mais mantenedores, e o tempo de cada um é cronometrado.
Quem pode o quê
| Ação | Operador | Operacional | Mantenedor | Gerente |
|---|---|---|---|---|
| Abrir solicitação | Sim | Sim | — | Sim |
| Ver as próprias solicitações | Sim | Sim | — | Sim |
| Ver todas as solicitações da empresa | Não | Sim | — | Sim |
| Aprovar solicitação | Não | Sim | — | Sim |
| Rejeitar solicitação | Não | Sim | — | Sim |
| Atribuir mantenedor à OS | — | Sim | — | Sim |
| Iniciar, pausar e finalizar o próprio trabalho | — | — | Sim | — |
| Devolver a OS ao Operacional | — | — | Sim | — |
| Cadastrar equipamento, área, localização | — | Sim | Só leitura | Sim |
| Configurar status, prioridades e tipos de manutenção | — | Sim | — | Sim |
O Operador solicita, não cria OS. A separação existe para que a fila de manutenção não seja alimentada direto pelo chão de fábrica sem ninguém triar.
O mantenedor enxerga equipamento, localização e documentos, mas não cria nem edita nenhum deles.
O caminho de um chamado
Operador Operacional Mantenedor
-------- ----------- ----------
abre solicitação → vê como PENDENTE
├── aprova → OS criada → atribui → executa
└── rejeita (com motivo)
Cada seta é irreversível: uma solicitação já revisada não volta a ser pendente.
Regras da solicitação
A solicitação nasce PENDENTE e caminha para um de dois destinos.
| Situação | O que significa | O que fica registrado |
|---|---|---|
PENDENTE | Esperando o Operacional | Quem abriu, quando, o que descreveu |
APROVADA | Virou Ordem de Serviço | Quem aprovou, quando, e o número da OS |
REJEITADA | Não vira OS | Quem rejeitou, quando, e o motivo |
- Descrever o problema é obrigatório. Equipamento e localização são opcionais — mas são eles que dizem ao Operacional onde ir.
- Rejeitar exige motivo. Aprovar não exige nada.
- Revisar é definitivo. Tentar aprovar ou rejeitar de novo devolve "Solicitação já foi revisada" com a situação atual junto.
- O Operador vê apenas as solicitações que ele abriu; o Operacional vê as da empresa inteira e pode filtrar por situação.
Como a OS é criada
Aprovar não abre um formulário: a OS é montada pelo sistema, na hora, a partir da solicitação.
| Campo da OS | De onde vem |
|---|---|
| Código | Sequência própria da empresa, no formato OS-000001 |
| Título | Solicitação: seguido dos primeiros 100 caracteres da descrição |
| Descrição, solicitante, equipamento, localização | Copiados da solicitação |
| Situação inicial | O primeiro status cadastrado pela empresa |
Duas consequências que valem saber:
- A numeração é por empresa. Duas empresas na plataforma têm, cada uma, a sua
OS-000001. - A situação inicial depende do seu cadastro. O sistema não tem um "Em aberto" embutido: ele pega o primeiro status da sua lista. Se a ordem da lista muda, muda o ponto de partida das próximas OS.
Regras da atribuição
Uma OS pode ter vários mantenedores — o mecânico e o eletricista na mesma parada. Cada um recebe a sua atribuição, com cronômetro e situação próprios.
| Situação | Significa |
|---|---|
ATRIBUIDO | Recebeu, ainda não começou |
EM_EXECUCAO | Cronômetro correndo |
PAUSADO | Cronômetro parado, com motivo registrado |
AGUARDANDO_OPERACIONAL | Devolvida: o mantenedor não consegue resolver |
FINALIZADO | Parte dele concluída |
Ninguém mexe na atribuição de outro. Toda ação confere se a atribuição é do mantenedor que está pedindo, e responde "Esta atribuição não pertence ao seu usuário" quando não é.
Para o painel abrir, o usuário precisa estar vinculado a um cadastro de mantenedor. Sem o vínculo, o sistema responde que nenhum mantenedor está ligado àquele usuário — quem resolve é o Operacional, editando o cadastro do mantenedor e apontando o usuário.
A fila de trabalho
Ordenada por nível de prioridade, do menor para o maior — nível 1 é o mais urgente. Quem não tem prioridade definida vai para o fim da fila, e empates são desempatados pela ordem de chegada. Atribuições finalizadas saem da fila e vão para o histórico, ordenado da mais recente para a mais antiga.
Regras do cronômetro
O tempo trabalhado é a soma dos intervalos entre começar e parar. Cada ação vira um evento com data, hora e autor — é o que sustenta o apontamento de horas.
| Ação | Só é aceita quando a atribuição está | Passa a |
|---|---|---|
| Iniciar | ATRIBUIDO | EM_EXECUCAO |
| Retomar | PAUSADO | EM_EXECUCAO |
| Pausar | EM_EXECUCAO | PAUSADO |
| Finalizar | EM_EXECUCAO ou PAUSADO | FINALIZADO |
| Devolver ao Operacional | EM_EXECUCAO ou PAUSADO | AGUARDANDO_OPERACIONAL |
- Pausar exige motivo. O motivo fica no histórico de eventos, não em um campo que a próxima pausa sobrescreve.
- Há um intervalo mínimo de 10 segundos entre ações do cronômetro. Tocar duas vezes no botão devolve "Aguarde pelo menos 10 segundos entre ações do cronômetro". É o que impede o toque duplo de virar um registro de trabalho.
- Pausar e finalizar fecham o intervalo aberto e somam ao total; o tempo acumulado nunca é recalculado do zero.
- O tempo é gravado em segundos.
Quando o mantenedor devolve
AGUARDANDO_OPERACIONAL é a saída para "não é comigo": o mantenedor descreve por
que não consegue resolver e a decisão volta para o Operacional.
A tela de redirecionamento automático por especialidade permite cadastrar regras do tipo "mecânica → elétrica". Hoje essas regras não reatribuem a OS sozinhas — a devolução continua exigindo que o Operacional escolha o próximo mantenedor. Cadastre as regras se quiser deixá-las prontas, mas não conte com elas para mover trabalho.
Cadastros que a empresa configura
O DbranOS não traz listas fechadas. Cada empresa monta as suas, e elas alimentam os campos das OS:
| Cadastro | Para que serve |
|---|---|
| Status da OS | As situações pelas quais a OS passa — a primeira da lista é o ponto de partida |
| Prioridades | Nome e nível; o nível é o que ordena a fila do mantenedor |
| Tipos de manutenção | Corretiva, preventiva, preditiva — como a sua planta chama |
| Áreas de manutenção | Onde o trabalho acontece |
| Localizações | O endereço físico do equipamento |
| Famílias de equipamento | Agrupa equipamentos parecidos |
| Especialidades | A competência de cada mantenedor |
| Materiais | O que é consumido na execução |
O que o sistema recusa
| Mensagem | Por quê |
|---|---|
| Solicitação já foi revisada | Aprovar ou rejeitar duas vezes |
| Só é possível iniciar uma atribuição com status ATRIBUIDO ou PAUSADO | O cronômetro já estava correndo |
| Só é possível pausar uma atribuição EM_EXECUCAO | Pausar o que não começou |
| Só é possível retomar uma atribuição PAUSADO | Retomar o que não estava pausado |
| Aguarde pelo menos 10 segundos entre ações do cronômetro | Duas ações seguidas rápido demais |
| Esta atribuição não pertence ao seu usuário | Mexer no trabalho de outro mantenedor |
| Nenhum mantenedor vinculado ao usuário | O usuário entrou como mantenedor, mas não há cadastro ligado a ele |