Essa é uma revisão anterior do documento!
ER_005 - Configurações
Descrição
As Configurações é uma funcionalidade que permite personalizar o comportamento do IAGO…
Atores
Analista
- Pode executar os fluxos.
Gestor do Setor
- Pode executar os fluxos.
Administrador
- Pode executar todos os fluxos.
Tela
Tela 01
| Elemento | Tipo | Obrigatório | Valores Possíveis | Valor Padrão | Observação |
|---|---|---|---|---|---|
| Scroll automático | Comutador (toggle) | Ativo, Inativo. | Ativo | Ativa ou desativa o scroll automático da tela durante as respostas do IAGO, permitindo que a visualização acompanhe automaticamente as novas mensagens. | |
| Deletar Tudo | Botão | Ao clicar, inicia o processo de exclusão de todas as conversas armazenadas no histórico do usuário. | |||
| Remover Bases Selecionadas | Botão | Ação que possibilita remover bases quando forem selecionadas via checkboxes. | |||
| Configurar Bases | Botão | Ao clicar, abre a interface de configuração avançada das bases de dados selecionadas. | |||
| Cadastrar Categorias | Botão | Ao clicar, permite criar novas categorias para organizar as bases de dados. | |||
| Pesquisar | Alfanumérico | Permite pesquisar bases de dados específicas pelo nome ou versão, filtrando a listagem exibida. | |||
| Tabela de Bases de Dados | Tabela | Lista as bases de dados cadastradas com colunas de ID, Nome da Base, Categoria, Versão, Habilitar e Ações para cada registro. | |||
| Habilitar | Comutador (toggle) | Ativo, Inativo. | Permite ativar ou desativar a disponibilidade da base de dados para uso no Interpretador de Dados. | ||
| Editar | Ícone de ação | Ao clicar, permite editar as configurações da base de dados selecionada. | |||
| Excluir | Ícone de ação | Ao clicar, remove a base de dados da listagem após confirmação. | |||
| Habilitar/Desabilitar Todos | Comutador (toggle) | Ativo, Inativo. | Inativo | Ao clicar, ativa ou desativa simultaneamente todas as bases de dados listadas na página atual. | |
| Fechar | Botão | Fecha a tela de Configurações retornando à tela anterior ou ao Home do IAGO. |
Tela 02
| Elemento | Tipo | Obrigatório | Valores Possíveis | Valor Padrão | Observação |
|---|---|---|---|---|---|
| Mensagem de Confirmação | Texto | Exibe a pergunta “Tem certeza que deseja ativar o Scroll Automático nas conversas?”, solicitando confirmação explícita da alteração. | |||
| Fechar (X) | Ícone | Ícone de fechar localizado no canto superior direito do modal que fecha a janela sem aplicar a alteração. | |||
| Fechar | Botão | Ao clicar, fecha o modal de confirmação sem ativar o Scroll Automático, mantendo a configuração anterior inalterada. | |||
| Confirmar | Botão | Ao clicar, confirma a ativação do Scroll Automático e aplica a configuração a todas as conversas, fechando o modal e retornando à tela de Configurações. |
Tela 03
| Elemento | Tipo | Obrigatório | Valores Possíveis | Valor Padrão | Observação |
|---|---|---|---|---|---|
| Mensagem de Confirmação | Texto | Exibe a pergunta “Tem certeza que deseja desativar o Scroll Automático nas conversas?”, solicitando confirmação explícita da alteração. | |||
| Fechar (X) | Ícone | Ícone de fechar localizado no canto superior direito do modal que fecha a janela sem aplicar a alteração. | |||
| Fechar | Botão | Ao clicar, fecha o modal de confirmação sem desativar o Scroll Automático, mantendo a configuração anterior inalterada. | |||
| Confirmar | Botão | Ao clicar, confirma a desativação do Scroll Automático e aplica a configuração a todas as conversas, fechando o modal e retornando à tela de Configurações. |
Tela 04
| Elemento | Tipo | Obrigatório | Valores Possíveis | Valor Padrão | Observação |
|---|---|---|---|---|---|
| Nome | Alfanumérico | Sim | Campo obrigatório para informar o nome da nova categoria a ser criada para organização das bases de dados. | ||
| Fechar (X) | Ícone | Ícone de fechar localizado no canto superior direito do modal que fecha a janela sem criar a categoria. | |||
| Cancelar | Botão | Ao clicar, fecha o modal de cadastro sem salvar a nova categoria, retornando à tela de Configurações. | |||
| Enviar | Botão | Sim | Ao clicar, valida o campo obrigatório e cria a nova categoria, disponibilizando-a para atribuição às bases de dados, fechando o modal e retornando à tela de Configurações. |
Tela 05
| Elemento | Tipo | Obrigatório | Valores Possíveis | Valor Padrão | Observação |
|---|---|---|---|---|---|
| Código Identificador | Alfanumérico | Sim | Identificador único da base de dados a ser configurada. | ||
| Versão | Alfanumérico | Sim | Versão da base de dados (ex.: 2023.2). | ||
| Categorias | Lista (select) | Sim | Lista de categorias disponíveis. | Categoria à qual a base de dados será atribuída, organizando-a dentro do Interpretador. | |
| Nome | Alfanumérico | Sim | Nome descritivo da base de dados. | ||
| Situação | Lista | Sim | Ativo, Inativo | Ativo | Status/situação da base de dados, controlando sua disponibilidade para uso. |
| Fechar (X) | Ícone | Ícone de fechar localizado no canto superior direito do modal que fecha a janela sem salvar alterações. | |||
| Cancelar | Botão | Ao clicar, fecha o modal de configuração sem salvar as alterações realizadas, retornando à tela de Configurações. | |||
| Enviar | Botão | Sim | Ao clicar, valida todos os campos obrigatórios e salva as configurações da base de dados, fechando o modal e retornando à tela de Configurações. |
Tela 06
| Elemento | Tipo | Obrigatório | Valores Possíveis | Valor Padrão | Observação |
|---|---|---|---|---|---|
| Mensagem de Confirmação | Texto | Exibe a pergunta “Deseja realmente remover a base selecionada?”, solicitando confirmação explícita da remoção. | |||
| Fechar (X) | Ícone | Ícone de fechar localizado no canto superior direito do modal que fecha a janela sem remover a base. | |||
| Fechar | Botão | Ao clicar, fecha o modal de confirmação sem remover a base de dados, mantendo o registro inalterado. | |||
| Confirmar | Botão | Sim | Ao clicar, confirma a remoção e exclui a base de dados selecionada do sistema, fechando o modal e retornando à tela de Configurações. |
Tela 07
| Elemento | Tipo | Obrigatório | Valores Possíveis | Valor Padrão | Observação |
|---|---|---|---|---|---|
| Mensagem de Confirmação | Texto | Exibe a pergunta “Confirma a exclusão de todas as conversas do seu histórico?” seguida do aviso “Esta ação é irreversível e não poderá ser desfeita”, reforçando a natureza permanente da operação. | |||
| Estou ciente | Checkbox | Sim | Marcado, Desmarcado. | Desmarcado | Campo obrigatório que o usuário deve marcar para confirmar que está ciente de que deseja excluir permanentemente todo o histórico de conversas e que a ação não pode ser desfeita. |
| Estou ciente que desejo excluir o histórico | Texto | Exibe o texto “Estou ciente que desejo excluir o histórico”, reforçando a confirmação consciente da ação. | |||
| Fechar (X) | Ícone | Ícone de fechar localizado no canto superior direito do modal que fecha a janela sem executar a exclusão. | |||
| Cancelar | Botão | Ao clicar, fecha o modal de confirmação sem proceder com a exclusão, mantendo todo o histórico de conversas intacto. | |||
| Confirmar | Botão | Sim | Ao clicar, após o checkbox estar marcado, exclui permanentemente todas as conversas do usuário logado dos servidores do sistema, fechando o modal e retornando à tela de Configurações. O botão fica desabilitado até que o checkbox seja marcado. |
Fluxos
Fluxo 01 - Ativar/Desativar Scroll Automático
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | O usuário acessa a aba “Configurações” na funcionalidade de configuração do IAGO. | Tela 01 | |
| 02 | O sistema exibe a seção “Scroll automático” com as descrições das opções e o toggle de ativação/desativação. | RN01 | Tela 01 |
| 03 | O usuário clica no toggle de Scroll automático para alterar seu estado (ativar se desativado ou desativar se ativado). | RN02 | Tela 01 |
| 04 | O sistema exibe um modal “Confirmação” perguntando se o usuário tem certeza que deseja ativar/desativar o Scroll Automático nas conversas. | RN03 | Tela 02 ou Tela 03 |
| 05 | O usuário clica no botão “Confirmar” no modal para confirmar a alteração. | RN04 | Tela 02 ou Tela 03 |
| 06 | O sistema aplica a configuração de Scroll Automático a todas as conversas do usuário, fecha o modal e retorna à tela de Configurações, exibindo mensagem de sucesso. | RN05, RN06. |
Fluxo 02 - Deletar todos os chats
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | O usuário acessa a aba “Configurações” na funcionalidade de configuração do IAGO. | Tela 01 | |
| 02 | O sistema exibe a seção “Deletar todos os chats” com a descrição “Essa opção deleta todos os chats de uma vez só” e o aviso crítico “ATENÇÃO: Esta ação não poderá ser desfeita”. | RN07 | Tela 01 |
| 03 | O usuário clica no botão “Deletar Tudo” para iniciar o processo de exclusão em massa de todas as conversas. | RN08 | Tela 01 |
| 04 | O sistema exibe um modal “Confirmação” perguntando “Confirma a exclusão de todas as conversas do seu histórico?” com aviso de que a ação é irreversível e solicitando marcação do checkbox “Estou ciente que desejo excluir o histórico”. | RN09 | Tela 07 |
| 05 | O usuário marca o checkbox “Estou ciente que desejo excluir o histórico” para confirmar que compreende a natureza permanente da ação. | RN010 | Tela 07 |
| 06 | O usuário clica no botão “Confirmar” para proceder com a exclusão permanente de todas as conversas. | RN011 | Tela 07 |
| 07 | O sistema exclui permanentemente todas as conversas e o histórico do usuário logado dos servidores, fecha o modal, retorna à tela de Configurações e exibe mensagem de sucesso. | RN12, RN13. |
Fluxo 03 - Configurar bases
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | O usuário acessa a aba “Configurações” na funcionalidade de configuração do IAGO. | Tela 01 | |
| 02 | O sistema exibe a seção “Configurar bases de dados do Interpretador” com a tabela de bases existentes, campo de pesquisa e botões “Configurar Bases” e “Cadastrar Categorias”. | Tela 01 | |
| 03 | O usuário clica no botão “Configurar Bases” para acessar a interface de configuração avançada de bases de dados. | RN14 | Tela 01 |
| 04 | O sistema exibe o modal “Configurar Bases” com os campos obrigatórios: Código Identificador, Versão, Categorias, Nome e Situação. | Tela 05 | |
| 05 | O usuário preenche o campo “Código Identificador” com um identificador único para a base de dados. | RN15 | Tela 05 |
| 06 | O usuário preenche o campo “Versão” com o número ou identificador da versão da base de dados (ex.: 2023.2). | RN16 | Tela 05 |
| 07 | O usuário seleciona uma Categoria na lista dropdown para classificar a base de dados (ou cria uma nova categoria clicando em “Cadastrar Categorias”). | RN17, RN18 | Tela 05 |
| 08 | O usuário preenche o campo “Nome” com o nome descritivo da base de dados (ex.: SIOFI - Execução Orçamentária e Financeira Estadual). | RN19 | Tela 05 |
| 09 | O usuário seleciona a Situação da base de dados na lista dropdown (Ativa, Inativa). | RN20 | Tela 05 |
| 10 | O usuário clica no botão “Enviar” para salvar a configuração da nova base de dados. | RN21 | Tela 05 |
| 11 | O sistema valida todos os campos obrigatórios, cria a base de dados com as configurações informadas, fecha o modal, exibe uma mensagem de sucesso e retorna à tela de Configurações, exibindo a nova base listada na tabela. | RN22, RN23 |
Fluxo 04 - Cadastrar categorias
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | O usuário acessa a aba “Configurações” na funcionalidade de configuração do IAGO. | Tela 01 | |
| 02 | O sistema exibe a seção “Configurar bases de dados do Interpretador” com a tabela de bases existentes e botões “Configurar Bases” e “Cadastrar Categorias”. | Tela 01 | |
| 03 | O usuário clica no botão “Cadastrar Categorias” para criar uma nova categoria de classificação para as bases de dados. | RN24 | Tela 01 |
| 04 | O sistema exibe o modal “Cadastrar Categoria” com um campo obrigatório “Nome” para informar o identificador da categoria. | RN25 | Tela 04 |
| 05 | O usuário preenche o campo “Nome” com a denominação da nova categoria (ex.: Jurídica, Financeira, Operacional). | RN26 | Tela 04 |
| 06 | O usuário clica no botão “Enviar” para salvar a nova categoria no sistema. | RN27 | Tela 04 |
| 07 | O sistema valida o campo obrigatório, verifica se a categoria já não existe, cria a nova categoria, fecha o modal e retorna à tela de Configurações, exibindo mensagem de sucesso. | RN28, RN29, RN30. | Tela 01 |
| 08 | A nova categoria fica imediatamente disponível para seleção no campo “Categorias” do modal “Configurar Bases” e em futuras configurações de bases de dados. | RN31. |
Fluxo 05 - Pesquisar bases
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | O usuário acessa a aba “Configurações” na funcionalidade de configuração do IAGO. | Tela 01 | |
| 02 | O sistema exibe a seção “Configurar bases de dados do Interpretador” com a tabela de bases existentes e um campo de pesquisa no topo da listagem. | RN32. | Tela 01 |
| 03 | O usuário clica no campo “Pesquisar” e digita um termo de busca (nome da base ou versão). | RN33. | Tela 01 |
| 04 | O sistema filtra a tabela de bases em tempo real, exibindo apenas as bases que correspondem ao termo digitado no campo de pesquisa. | RN34, RN35. | Tela 01 |
| 05 | O usuário visualiza os resultados filtrados na tabela, mostrando apenas as bases que contêm o termo de pesquisa em seus campos (Nome da Base, ID, Versão ou Categoria). | RN36. | Tela 01 |
| 06 | O usuário pode limpar o campo de pesquisa para retornar à visualização completa da tabela de todas as bases cadastradas. | RN37. | Tela 01 |
Fluxo 06 - Habilitar/Desabilitar bases específicas
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | O usuário acessa a aba “Configurações” na funcionalidade de configuração do IAGO. | Tela 01 | |
| 02 | O sistema exibe a seção “Configurar bases de dados do Interpretador” com a tabela de bases existentes, incluindo a coluna “Habilitar” com toggles de ativação/desativação. | RN38 | Tela 01 |
| 03 | O usuário localiza uma base de dados específica na tabela e clica no toggle “Habilitar” na coluna correspondente para alternar seu estado. | RN39 | Tela 01 |
| 04 | O sistema altera imediatamente o estado do toggle, refletindo se a base está habilitada (ativa) ou desabilitada (inativa). | RN40 | Tela 01 |
| 05 | Caso a base seja habilitada, ela fica disponível para uso no módulo Interpretador de Dados, permitindo que seja selecionada e utilizada nas análises. | RN41 | Tela 01 |
| 06 | Caso a base seja desabilitada, ela não fica disponível para uso no módulo Interpretador de Dados, sendo ocultada das opções de seleção para os usuários. | RN42 | Tela 01 |
| 07 | O sistema salva a alteração de estado da base automaticamente, sem necessidade de confirmação adicional. Uma mensagem de sucesso deve ser exibida para o usuário. | RN43 | Tela 01 |
Fluxo 07 - Habilitar/Desabilitar todas as bases
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | O usuário acessa a aba “Configurações” na funcionalidade de configuração do IAGO. | Tela 01 | |
| 02 | O sistema exibe a seção “Configurar bases de dados do Interpretador” com a tabela de bases existentes e um toggle “Habilitar/Desabilitar Todos” no rodapé da tabela. | Tela 01 | |
| 03 | O usuário clica no toggle “Habilitar/Desabilitar Todos” localizado no rodapé da tabela para alterar o estado de todas as bases simultaneamente. | RN44 | Tela 01 |
| 04 | O sistema altera imediatamente o estado de todas as bases listadas na página atual, ativando ou desativando todos os toggles individuais de forma sincronizada. | RN45, RN46 | Tela 01 |
| 05 | Caso o toggle seja ativado, todas as bases ficam habilitadas (ativas) e disponíveis para uso no módulo Interpretador de Dados. | RN47 | Tela 01 |
| 06 | Caso o toggle seja desativado, todas as bases ficam desabilitadas (inativas) e não ficam disponíveis para uso no módulo Interpretador de Dados. | RN48 | Tela 01 |
| 07 | O sistema salva automaticamente as alterações de estado de todas as bases, após a confirmação adicional da ação. Uma mensagem de sucesso deve ser exibida para o usuário. | Tela 01 |
Fluxo 08 - Editar base específica
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | |||
| 02 | |||
| 03 | |||
| 04 |
Fluxo 09 - Excluir base específica
| Passo | Ação | Regra | Tela |
|---|---|---|---|
| 01 | |||
| 02 | |||
| 03 | |||
| 04 |
Regras de Negócio
| Regra | Descrição |
|---|---|
| RN01 | A seção de Scroll automático exibe duas descrições: “Ao deixar desativado, sua tela fica parada enquanto o chat responde” e “Ao deixar ativado, sua tela rola junto com a resposta”. |
| RN02 | O toggle permite alternar entre os estados ativo e inativo, refletindo o estado atual da configuração. |
| RN03 | Uma modal de confirmação é exibida obrigatoriamente ao tentar alterar o Scroll Automático, perguntando se o usuário tem certeza da ação. |
| RN04 | A confirmação é obrigatória; o usuário deve clicar no botão “Confirmar” para aplicar a alteração. |
| RN05 | Ao confirmar, a configuração é aplicada imediatamente a todas as conversas ativas, futuras e retomadas do usuário. |
| RN06 | A alteração permanece ativa até que o usuário mude novamente a configuração, servindo como preferência pessoal do usuário logado. |
| RN07 | A seção exibe claramente um aviso crítico informando que a ação “não poderá ser desfeita”, reforçando o caráter irreversível da operação. |
| RN08 | O botão “Deletar Tudo” inicia o fluxo de confirmação em duas etapas (modal com checkbox). |
| RN09 | Uma modal de confirmação é exibida obrigatoriamente, apresentando a pergunta e o checkbox de confirmação de ciência. |
| RN10 | O checkbox “Estou ciente que desejo excluir o histórico” é obrigatório e deve ser marcado para habilitar o botão “Confirmar”. |
| RN11 | O botão “Confirmar” permanece desabilitado até que o checkbox seja marcado, garantindo confirmação explícita do usuário. |
| RN12 | Ao confirmar, o sistema exclui permanentemente todas as conversas e mensagens do histórico do usuário logado, incluindo conversas iniciadas, retomadas ou em andamento. |
| RN13 | A exclusão é imediata e não pode ser desfeita ou restaurada; não há opção de recuperação ou undo após a confirmação. |
| RN14 | O botão “Configurar Bases” abre o modal de configuração para criar ou editar bases de dados. |
| RN15 | O campo “Código Identificador” é obrigatório e deve conter um identificador único que não seja duplicado no sistema. |
| RN16 | O campo “Versão” é obrigatório e deve indicar a versão da base de dados para fins de controle de atualização. |
| RN17 | O campo “Categorias” é obrigatório e permite selecionar de uma lista de categorias previamente criadas. |
| RN18 | Caso a categoria desejada não exista, o usuário pode clicar em “Cadastrar Categorias” para criar uma nova categoria antes de concluir a configuração da base. |
| RN19 | O campo “Nome” é obrigatório e deve conter a denominação descritiva da base de dados para fácil identificação. |
| RN20 | O campo “Situação” é obrigatório e define o status da base: Ativa (disponível para uso), Inativa (não disponível temporariamente). |
| RN21 | O botão “Enviar” permanece habilitado apenas quando todos os campos obrigatórios estão preenchidos. |
| RN22 | Ao enviar, o sistema valida a unicidade do Código Identificador e a existência da categoria selecionada. |
| RN23 | A base de dados criada é imediatamente listada na tabela da seção “Configurar bases de dados do Interpretador” e fica disponível para uso no módulo Interpretador de Dados conforme sua situação (Ativa, Inativa). |
| RN24 | O botão “Cadastrar Categorias” abre o modal de cadastro de categoria, permitindo a criação de novos classificadores. |
| RN25 | O modal “Cadastrar Categoria” apresenta um formulário simples com um único campo obrigatório “Nome”. |
| RN26 | O campo “Nome” é obrigatório e deve conter a denominação descritiva da categoria para identificação clara do seu propósito de classificação. |
| RN27 | O botão “Enviar” permite salvar a nova categoria após preenchimento do campo obrigatório. |
| RN28 | O sistema valida se o campo “Nome” foi preenchido; caso contrário, exibe mensagem de erro solicitando o preenchimento. |
| RN29 | O sistema verifica a unicidade do nome da categoria, impedindo a criação de categorias duplicadas e exibindo mensagem de alerta caso o nome já exista. |
| RN30 | Ao confirmar, a nova categoria é criada e armazenada no sistema, tornando-se imediatamente disponível para associação a bases de dados. |
| RN31 | A categoria criada aparece automaticamente na lista de opções do campo “Categorias” no modal “Configurar Bases” e em todas as operações futuras de configuração de bases de dados. |
| RN32 | A seção de configuração de bases exibe um campo de pesquisa “Pesquisar” acima da tabela de bases de dados, permitindo busca por nome ou versão. |
| RN33 | O campo de pesquisa aceita entrada de texto alfanumérico e permite que o usuário digite um ou mais termos de busca simultaneamente. |
| RN34 | A pesquisa é realizada em tempo real conforme o usuário digita, sem necessidade de clicar em um botão de busca. |
| RN35 | O sistema busca por correspondências em múltiplos campos da base: Nome da Base ou Versão, permitindo flexibilidade na pesquisa. |
| RN36 | Os resultados filtrados são exibidos imediatamente na tabela, mostrando apenas as bases que contenham o termo de pesquisa em qualquer um dos campos pesquisáveis, mantendo a estrutura da tabela (ID, Nome da Base, Categoria, Versão, Habilitar, Ações). Caso não encontre, a tabela deve exibir uma notificação para o usuário. (Ex.: Sem registros encontrados). |
| RN37 | Ao limpar o campo de pesquisa (deixá-lo vazio), o sistema retorna à visualização completa de todas as bases cadastradas, sem filtros aplicados, respeitando a paginação configurada. |
| RN38 | A coluna “Habilitar” na tabela de bases de dados contém toggles individuais que permitem ativar ou desativar cada base específica. |
| RN39 | O toggle pode ser clicado a qualquer momento para alternar entre os estados ativo (habilitado) e inativo (desabilitado). |
| RN40 | A alteração do estado é aplicada imediatamente; o toggle reflete o novo estado sem necessidade de recarregar a página. |
| RN41 | Quando uma base está habilitada (toggle ativado), ela fica disponível na lista de seleção do módulo Interpretador de Dados, podendo ser escolhida pelos usuários para análise de dados. |
| RN42 | Quando uma base está desabilitada (toggle desativado), ela é removida da lista de bases disponíveis no módulo Interpretador de Dados, ficando inacessível aos usuários sem prejudicar seu armazenamento no sistema. |
| RN43 | As alterações de estado são salvas automaticamente no banco de dados do sistema, sem exigir clique em botão de confirmação, e o histórico de habilitações/desabilitações é mantido para auditoria. |
| RN44 | |
| RN45 | |
| RN46 | |
| RN47 | |
| RN48 | |
| RN49 | |
| RN50 |