# PROC001 Cadastro de Departamentos Ordenados

<table border="1" id="bkmrk-%C2%A0-projeto%2Fsistema%3Age" style="border-collapse: collapse; width: 100.123%; height: 68px;"><tbody><tr style="border-style: solid;"><td rowspan="3" style="width: 26.6667%; height: 68px; border-color: black; border-top-style: hidden; border-left-style: hidden; border-bottom-style: hidden;">  
[![image-1762776253666.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/scaled-1680-/image-1762776253666.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-11/image-1762776253666.png)

</td><td style="width: 49.9999%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Projeto/Sistema:**</span>  
<span style="color: #000000;">Loja Virtual - GerencieAqui</span></td><td class="align-center" style="width: 23.3333%; height: 10px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do *Template:***</span>  
<span style="color: #000000;">1.2</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Processo:**</span>  
PROC001 - Cadastro de Departamentos Ordenados</td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Versão do Documento:**</span>  
<span style="color: #000000;">1.0</span></td></tr><tr style="border-style: solid;"><td style="width: 49.9999%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Responsável(eis):** </span>  
<span style="color: #000000;">Luís Leite</span></td><td class="align-center" style="width: 23.3333%; height: 29px; border-color: black; border-style: solid;"><span style="color: #000000;">**Data:** </span>

<span style="color: #000000;">03/12/2025</span>

</td></tr></tbody></table>

##### <span style="color: #000000;">**1. Introdução**</span>

<span style="color: #000000;">**Este processo visa exemplificar a documentação para a adição da função de ordenação no cadastro de cliente**</span>

<table cellpadding="9" cellspacing="0" id="bkmrk-processo-envolvidos-" style="width: 100%;" width="100%"><tbody><tr valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Processo**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 19%;" width="19%"><span style="font-size: small; color: #000000;">**Envolvidos**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Entrada**</span>

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">**Dados de Saída**</span>

</td></tr><tr valign="top"><td style="border-style: solid; border-color: black; width: 27%;" width="27%">PROC001 Adição de Ordenação nos Departamentos

</td><td style="border-style: solid; border-color: black; width: 19%;" width="19%"><span style="font-size: small; color: #000000;">N/A</span>

</td><td style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">N/A</span>

</td><td style="border-style: solid; border-color: black; width: 27%;" width="27%"><span style="font-size: small; color: #000000;">N/A</span>

</td></tr><tr><td style="width: 27%; border-style: solid; border-color: black;">PROC002 Reformulação da Listagem de Departamentos da Loja</td><td style="width: 19%; border-style: solid; border-color: black;"></td><td style="width: 27%; border-style: solid; border-color: black;"></td><td style="width: 27%; border-style: solid; border-color: black;">Listagem de departamentos cadastrados

</td></tr></tbody></table>

#### **Processos Relacionados** 

[PROC002 Reformulação da Listagem de Departamentos da Loja](https://docs.softensistemas.com.br/books/loja-virtual/page/proc002-reformulacao-da-listagem-de-departamentos-da-loja)

#### **Especificação Funcional**

- - - - - -

#### **PROC001 Cadastro de Departamentos Ordenados:**

##### ***Protótipo de Tela:***

[![image-1765299511621.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-12/scaled-1680-/image-1765299511621.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-12/image-1765299511621.png)

Imagem I - Nova tela de departamento

[![image-1764765572876.png](https://docs.softensistemas.com.br/uploads/images/gallery/2025-12/scaled-1680-/image-1764765572876.png)](https://docs.softensistemas.com.br/uploads/images/gallery/2025-12/image-1764765572876.png)

Imagem II - Nova tela de departamento com ícone

##### ***Descrição dos Campos:***

<table border="1" cellpadding="7" cellspacing="0" id="bkmrk-campo-tipo-tamanho-o" style="width: 843px; height: 298px;"><tbody><tr style="height: 35px;" valign="top"><td bgcolor="#acb9ca" style="width: 167.986px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Campo**</span>

</td><td bgcolor="#acb9ca" style="width: 101.997px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Tipo**</span>

</td><td bgcolor="#acb9ca" style="width: 87.9861px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Tamanho**</span>

</td><td bgcolor="#acb9ca" style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Obrig. ?**</span>

</td><td bgcolor="#acb9ca" style="width: 118.993px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Máscara**</span>

</td><td bgcolor="#acb9ca" style="width: 200.99px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">**Observações**</span>

</td></tr><tr style="height: 57px;"><td style="width: 167.986px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Nome do Departamento</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Texto</span>

</td><td style="width: 87.9861px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">255</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Sim</span>

</td><td style="width: 118.993px; border-style: solid; border-color: black; height: 57px;">-

</td><td style="width: 200.99px; border-style: solid; border-color: black; height: 57px;">-

</td></tr><tr style="height: 57px;"><td style="width: 167.986px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Ícone</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 57px;">*<span style="color: #000000;">Toggle Switch</span>*

</td><td style="width: 87.9861px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">-</span>

</td><td style="width: 118.993px; border-style: solid; border-color: black; height: 57px;"></td><td style="width: 200.99px; border-style: solid; border-color: black; height: 57px;"></td></tr><tr style="height: 57px;"><td style="width: 167.986px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Exibir no E-Commerce</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 57px;">*<span style="color: #000000;">Toggle Switch</span>*

</td><td style="width: 87.9861px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">-</span>

</td><td style="width: 118.993px; border-style: solid; border-color: black; height: 57px;"></td><td style="width: 200.99px; border-style: solid; border-color: black; height: 57px;"></td></tr><tr style="height: 57px;"><td style="width: 167.986px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">Departamento em destaque?</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 57px;">*<span style="color: #000000;">Inteiro</span>*

</td><td style="width: 87.9861px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 57px;"><span style="color: #000000;">-</span>

</td><td style="width: 118.993px; border-style: solid; border-color: black; height: 57px;"></td><td style="width: 200.99px; border-style: solid; border-color: black; height: 57px;"></td></tr><tr style="height: 35px;"><td style="width: 167.986px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Ordenação</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">Inteiro</span>

</td><td style="width: 87.9861px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black; height: 35px;"><span style="color: #000000;">-</span>

</td><td style="width: 118.993px; border-style: solid; border-color: black; height: 35px;"></td><td style="width: 200.99px; border-style: solid; border-color: black; height: 35px;"></td></tr><tr><td style="width: 167.986px; border-style: solid; border-color: black;"><span style="color: #000000;">Fechar</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black;"><span style="color: #000000;">Botão</span>

</td><td style="width: 87.9861px; border-style: solid; border-color: black;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;">-</span>

</td><td style="width: 118.993px; border-style: solid; border-color: black;"></td><td style="width: 200.99px; border-style: solid; border-color: black;"></td></tr><tr><td style="width: 167.986px; border-style: solid; border-color: black;"><span style="color: #000000;">Salvar</span>

</td><td style="width: 101.997px; border-style: solid; border-color: black;"><span style="color: #000000;">Botão</span>

</td><td style="width: 87.9861px; border-style: solid; border-color: black;"><span style="color: #000000;">-</span>

</td><td style="width: 165px; border-style: solid; border-color: black;"><span style="color: #000000;">-</span>

</td><td style="width: 118.993px; border-style: solid; border-color: black;"></td><td style="width: 200.99px; border-style: solid; border-color: black;"></td></tr></tbody></table>

##### ***Regras de Interface:***

<span style="color: #000000;">**1. Nome do Departamento:**  
Deve conter o *placeholder* "Informe o nome do departamento"</span>

<span style="color: #000000;">**2. Ícone:** *Toggle* por padrão fica inativo.</span>  
<span style="color: #000000;">Abaixo deve conter o texto informativo "Deseja Exibir um ícone ao lado de cada sessão de departamento na loja?"</span>

<span style="color: #000000;">**3. Exibir no E-commerce:** *Toggle* por padrão fica inativo.</span>  
<span style="color: #000000;">Abaixo deve conter o texto informativo "Deseja exibir esta sessão de departamento na loja?"</span>

<span style="color: #000000;">**3.1** Ao ser ativado deve renderizar o componente para anexar o arquivo que servirá de ícone. (Imagem II)</span>

<span style="color: #000000;">**4. Departamento em destaque?** *Toggle* por padrão fica inativo.</span>  
<span style="color: #000000;">Abaixo deve conter o texto informativo "Deseja dar ênfase a este departamento no menu?"</span>

<span style="color: #000000;">**5. Ordenação:** </span>Campo livre para preenchimento da sequencia do departamento. Permitir apenas inteiro.

<span style="color: #000000;">**6. Botão Fechar:**</span>  
<span style="color: #000000;">Deve encerrar a *dialog* descartando toda alteração.</span>

<span style="color: #000000;">**7. Botão Salvar:**</span>  
<span style="color: #000000;">Se possível salvar o registro, deve ser retornado em tela o seguinte aviso:</span>

<p class="callout success"><span style="color: #000000;">Salvo com sucesso!</span></p>

Caso seja uma edição de registro:

<p class="callout success">Alterado com sucesso!</p>

Caso não seja possível salvar o registro:

<p class="callout danger">Informe o nome do Departamento!</p>

Ou por problemas em ordem de departamento já utilizada.

<p class="callout danger"><span style="background-color: #fcdbdb; color: #4d0706;">Ordenação de departamento já registrada!</span></p>

##### ***Regras de Negócio:***

***1. <span style="color: #000000;">Ordenação:  
</span>***Deve ser validado caso o numero de sequencia do departamento adicionado já esteja vinculado a outro departamento. Não permitir salvar caso já esteja sendo utilizado em outro registro.

***<span style="color: #000000;">2. Salvar:</span>*** Deve validar se o nome do departamento esta preenchido. Caso esteja, se for um novo registro deve ser criado uma nova linha na base de dados, caso seja uma edição, deve ser atualizado o registro respectivo no banco.

**3.** Na loja virtual devem ser renderizados os departamentos de acordo com a ordenação configurada, o menor número sempre renderizando nas posições iniciais, assim por diante.

##### ***Questões Técnicas:***

***1. Deve ser criado um novo campo na base de dados, onde será armazenada a ordenação***

```SQL
ALTER TABLE departamento ADD COLUMN ordenacao INT
```

**2. Deve seguir o esquema de cores:**

<table border="1" cellpadding="7" cellspacing="0" class="align-center" id="bkmrk-gerencieaqui-campo-c"><tbody><tr><td colspan="2" style="border-style: solid; border-color: black; width: 269px;">**GerencieAqui**

</td></tr><tr valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 134px;">**Campo**

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 135px;">**Cód. Hexadecimal**

</td></tr><tr><td style="border-style: solid; border-color: black; width: 134px;">Títulos dos cards:

</td><td style="border-style: solid; border-color: black; width: 135px;">\#242424

</td></tr><tr><td style="border-style: solid; border-color: black; width: 134px;">Label dos campos

</td><td style="border-style: solid; border-color: black; width: 135px;">\#044572

</td></tr><tr><td style="border-style: solid; border-color: black; width: 134px;">Placeholder

</td><td style="border-style: solid; border-color: black; width: 135px;">\#505050 50%

</td></tr><tr><td style="border-style: solid; border-color: black; width: 134px;">Toggle Ativo

</td><td style="border-style: solid; border-color: black; width: 135px;">\#044572

</td></tr><tr><td style="border-style: solid; border-color: black; width: 134px;">Toggle Inativo

</td><td style="border-style: solid; border-color: black; width: 135px;">\#7D7D7D</td></tr><tr><td style="border-style: solid; border-color: black; width: 134px;">Botão Salvar

</td><td style="border-style: solid; border-color: black; width: 135px;">\#044572

</td></tr><tr><td style="border-style: solid; border-color: black; width: 134px;">Texto Botão Fechar

</td><td style="border-style: solid; border-color: black; width: 135px;">\#044572

</td></tr></tbody></table>

<table border="1" cellpadding="7" cellspacing="0" class="align-center" id="bkmrk-aplicativo-empresari" style="width: 269px; height: 337px;"><tbody><tr style="height: 35px;"><td colspan="2" style="border-style: solid; border-color: black; width: 269px; height: 35px;">**Aplicativo Empresarial**

</td></tr><tr style="height: 57px;" valign="top"><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 134.5px; height: 57px;">**Campo**

</td><td bgcolor="#acb9ca" style="border-style: solid; border-color: black; width: 134.5px; height: 57px;">**Cód. Hexadecimal**

</td></tr><tr style="height: 35px;"><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">Títulos dos cards:

</td><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">\#242424

</td></tr><tr style="height: 35px;"><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">Label dos campos

</td><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">\#621FA4

</td></tr><tr style="height: 35px;"><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">Placeholder

</td><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">\#505050 50%

</td></tr><tr style="height: 35px;"><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">Toggle Ativo

</td><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">\#621FA4

</td></tr><tr style="height: 35px;"><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">Toggle Intivo

</td><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">\#7D7D7D

</td></tr><tr style="height: 35px;"><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">Botão Salvar

</td><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">\#621FA4

</td></tr><tr style="height: 35px;"><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">Texto Botão Fechar

</td><td style="border-style: solid; border-color: black; width: 134.5px; height: 35px;">\#621FA4

</td></tr></tbody></table>

©SOFTEN SISTEMAS 2025