Skip to main content

PROC005.1 Reformulação Tela Principal O.S. - Detalhes

 

image-1763387199531.png

 

Projeto/Sistema:
O.S. - GerencieAqui
Versão do Template:
1.2
Processo:
PROC005.1 Reformulação Tela Principal O.S. - Detalhes
Versão do Documento:
1.0
Responsável(eis): 
Luís Leite

Data: 

03/11/2025

1. Introdução

Este processo visa exemplificar a reformulação da tela principal da Ordem de Serviço

Processo

Envolvidos

Dados de Entrada

Dados de Saída

PROC005 Reformulação Tela Principal O.S.

-

Nova ordem de serviço ou edição dos dados da ordem de serviço

Ordem de Serviço salva ou alterada

PROC005.1 Reformulação Tela Principal O.S. - Detalhes

-

Nova ordem de serviço ou edição dos dados da ordem de serviço

Ordem de Serviço salva ou alterada

PROC006 Reformulação Tela de Listagens da O.S.

 

-

Filtros de período e etapas das O.Ss

Listagem filtrada de ordens de serviço

PROC007 OS Modo Visualização

-

-

-

Processos Relacionados


PROC005 Reformulação Tela Principal O.S.

PROC006 Reformulação Tela de Listagens da O.S.

PROC007 OS Modo Visualização

Especificação Funcional


PROC005.1 Reformulação Tela Principal O.S. - Detalhes

Protótipo de Tela:

image-1762796689898.png

Imagem I - Tela focada na Aba Detalhes

Regras de Interface Principais:

3. Botão Voltar:
Ao clicar sobre o botão deve retornar a tela de listagem de Ordens de Serviço.

4. Botão Próximo:
Caso esteja na primeira aba "Cliente e Equipamento" a ação do botão deve direcionar para o preenchimento da próxima aba "Detalhes da OS". Estando na Aba "Detalhes da OS" o botão "Próximo" não deve ter efeito.

5. Botão Salvar:
A ação do botão deve fazer todas as validações de campos obrigatórios, caso algum campo não seja validado deve ser retornado em tela a mensagem de aviso. Deve ser retornado para cada campo não validado:

O campo X é de preenchimento obrigatório!

5.1 Caso passe por toda a validação para salvar, deve ser retornado para a tela de listagem de O.S. e retornar o aviso positivo em tela

Ordem de Serviço salva com sucesso.

Regras de Negócio Principais:

1. Botão Salvar:
A ação do botão deve fazer todas as validações de campos obrigatórios, caso seja uma nova Ordem de Serviço realiza o novo cadastro no banco de dados; caso se trate de uma edição, realiza a alteração do registro selecionado.

Accordion Detalhes da OS:

image-1761229608856.png

Imagem II - Detalhes da OS

Descrição dos Campos:

Campo

Tipo

Tamanho

Obrig. ?

Máscara

Observações

Cód. Interno

Texto

60

Não

-

-

Vendedor

Caixa de Seleção

-

Não

-

-

Técnico Responsável

Caixa de Seleção

-

-

-

-

Prioridade

Caixa de Seleção

-

-

-

Valores Possíveis:
Alta
Normal
Baixa

 

Valor Padrão = Normal

Etapa

Caixa de Seleção

-

-

-

-

Garantia

Caixa de Seleção

 

 Não

-

 

Data da Garantia

Data

 

 Sim

-

 

Data da Retirada

Data

 

 Sim

-

 

Quem Retirou?

Texto

200

Não

-

placeholder: "Insira quem retirou"

Observações Internas

Texto

500

Não

-

placeholder: "Adicione observações relevantes"

Observações

Texto

500

Não

-

placeholder: "O que for escrito nesses campos será impresso no PDF da OS"

 

 

 

 

 

 

Regras de Interface:

1. Código Interno:
Código opcional para controle de código interno do cliente. Deve permitir alfanumérico. Por padrão vem em branco.

2. Vendedor:
Select para seleção do vendedor que será vinculado na O.S. 
Caso exista vendedor padrão vinculado no usuário, este deve ser o padrão a aparecer na listagem como padrão. 

3. Técnico Responsável:
Deve listar os Técnicos cadastrados vinculados na conta da empresa. Devem ser listados apenas técnicos ativos, de acordo com a documentação
PROC001 Tela de Cadastro de Profissional

4. Prioridade:
Por padrão deve vir como "Normal". Contém as opções Alta, Normal e Baixa.

5. Etapa:
Por padrão deve iniciar com a etapa ordenada como a primeira Etapa na empresa. Mais informações aqui.

6. Garantia:
Campo para calculo em dias da data de limite de garantia. 
Existe um campo configuração em "Configurações Adicionais>Ordem de Serviço>Dias de Garantia ao Finalizar a OS".
Caso esteja preenchido, considerar como padrão esse valor.
Deve conter o placeholder "Selecione a data"

7. Data da Garantia:
A data de garantia deve ser calculada com base no valor de dias do campo "Garantia". Caso não seja preenchido os dias de garantia, o valor deve ser a data atual.
Placeholder "Selecione a data"

8. Data de Retirada:
A data de retirada deve puxar o dia atual em seu preenchimento. Manter o comportamento atual, caso nao seja preenchida a data completa, limpar os valores.
Deve conter o Placeholder "Selecione a data".

9. Quem Retirou:
Manter o comportamento atual, caso nao seja preenchida a data completa, limpar os valores. Deve conter o Placeholder "Insira quem retirou"

10. Observações Internas:
Deve haver um label no rodapé do campo contabilizando a quantidade de caracteres restantes.
Deve conter o Placeholder "Adicione observações relevantes"

11. Observações:
Deve haver um label no rodapé do campo contabilizando a quantidade de caracteres restantes
.
Deve conter o Placeholder "O que for impresso nesse campo será impresso no PDF da OS"

Regras de Negócio:

1. Vendedor:
Caso exista vendedor padrão vinculado no usuário, este deve vir como padrão preenchido.

Accordion Informações de Pagamento:

Protótipo de Tela:

image-1762796714788.png

Imagem III - Pagamentos da OS

Descrição dos Campos:

Campo

Tipo

Tamanho

Obrig. ?

Máscara

Observações

Receber

RadioButton

-

-

-

Deve conter o card para seleção:
Serviço

Produtos

Total

Forma de Pagamento

Caixa de Seleção

 

 

 

 

Valor

Decimal

 

 

 

 

Data de Vencimento

Data

 

 

 

 

Descrição

Texto

 

 

 

 

Período

SelectBox

 

 

 

Deve conter as opções:
Diário,

Semanal,

Mensal,

 Anual

Listagem

Forma de Pagamento

Column Header 

 

 

 

 

Valor

Column Header 

 

 

 

 

Data de Vencimento

Column Header 

 

 

 

 

Pagamento

Column Header 

 

 

 

 

Ações

Column Header 

 

 

 

 

Regras de Interface:

1. Receber:
Deve permitir apenas a seleção de um dos cards: Serviço, Produto ou Totais.

2. Forma de Pagamento.
Deve listar as formas de pagamento criadas e vinculadas na empresa.
O botãoimage-1762175416447.png deve abrir a Dialog existente de cadastro de nova forma de pagamento.

3. Data de Vencimento.
Renderizar com a data atual. Não permitir manter sem valor, voltar rejeição em tela "não foi possível reconhecer '__/__/____' como uma data."

4. Repetir por:
Por padrão deve vir como 1.

5. Período:
A caixa de seleção deve conter os seguintes valores padrões:

      • Dia
      • Semana
      • Dezena
      • Quinzena
      • Mês
      • Bimestre
      • Trimestre
      • Semestre
      • Ano

6. Listagem: 

6.1 Forma de pgto
Por padrão deve ficar na ordem de inserção, mas deve permitir a reordenação ASC ou DESC.

6.2 Valor:
Por padrão deve ficar na ordem de inserção, mas deve permitir a reordenação ASC ou DESC.

6.3 Data de vencimento:
Por padrão deve ficar na ordem de inserção, mas deve permitir a reordenação ASC ou DESC.

6.4 Pagamento:
Por padrão deve vir como "Não Pago"

6.5 Ações:

        • Editarimage-1760730534944.png: Deve liberar os campos "forma pgto, valor e data vencimento" para edição.
        • Excluir image-1760730563577.png: Deve abri a dialog de confirmação de exclusão "Tem certeza que deseja excluir esta parcela?". Caso o usuário confirme, deve ser limpo apenas da listagem do pagamento. 
Regras de Negocio:

1. Repetir por:
O valor inteiro adicionado aqui será usado para repetir o lançamento com base no Período selecionado.

2.Editarimage-1760730534944.png: Os valores editados são primeiramente salvos em memoria, só serão confirmadas as alterações caso o usuário salve a Ordem de Serviço, do contrario nada deve ser alterado em banco

3.Excluir image-1760730563577.png: Os lançamentos só são removidos em memoria, só serão confirmadas as alterações caso o usuário salve a Ordem de Serviço, do contrario nada deve ser alterado em banco.

Questões Técnicas Gerais:

1. Geral:
As tabelas relacionadas a Ordem de Serviço na base de dados são:

    • ordermservico
    • ordemservicoitem

2. Adicionar os seguintes campos:

ALTER TABLE ordemservicoADD COLUMN prioridade BIT(1), vendedorId BIGINT, garantia INT

GerencieAqui
Títulos dos Accordions: #626262
Label dos campos: #044572
Botões principais: #044572
Tooltip: #242424
Botão editar da listagem: #1974FC
Botão exclusão da listagem: #DB102B
Título da dialog: #242424
Placeholders: #50505080 (50%)
Label das abas: #626262
Label aba selecionada: #009997
Inputs e textos nos grids: #000000

AplicativoEmpresarial
Títulos dos Accordions: #626262
Label dos campos: #621FA4
Botões principais: #621FA4
Tooltip: #242424
Botão editar da listagem: #1974FC
Botão exclusão da listagem: #DB102B
Título da dialog: #242424
Placeholders: #50505080 (50%)
Label das abas: #626262
Label aba selecionada: #009997
Inputs e textos nos grids: #000000

©SOFTEN SISTEMAS 2025