====== ER_004 - Contexto ======

===== Descrição =====

**O Contexto** é uma funcionalidade que permite personalizar o comportamento e as respostas do IAGO por meio de **instruções e definições específicas**. Ao ativar um contexto, você incorpora automaticamente um conjunto de orientações à conversa, alterando a forma como o assistente responde às suas solicitações.

Essa funcionalidade é útil quando você precisa que o IAGO adote um **perfil específico**, **linguagem particular** ou **direcionamento especial** nas respostas. Por exemplo, você pode criar um contexto para "Servidor do Tribunal de Contas" que instrua o IAGO a considerar normas, regulamentações internas e protocolos institucionais em suas respostas.
===== Atores =====

**Analista**

   * Pode executar todos os fluxos.

**Gestor do Setor**

  * Pode executar todos os fluxos.

**Administrador**

  * Pode executar todos os fluxos.

===== Tela =====

==== Tela 01 ====

{{  :pres:gerti:gestao_de_ativos:iago:iago_contextos.png?1236x919  }}

^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação|
|Contextos|Aba de navegação| | | |Define a visualização para exibir a lista de **contextos cadastrados**, permitindo pesquisa, ativação e gerenciamento dos mesmos.|
|Pesquisar|Alfanumérico| | | |Permite localizar contextos específicos pela busca de palavras-chave presentes no título ou descrição.|
|Cartão de Contexto|Cartão| | | |Apresenta um contexto com título (ex.: Servidor do Tribunal de Contas, Analista de Sistemas SR), descrição resumida e ações associadas ao contexto.|
|Ver Mais|Botão| | | |Ao clicar, expande a visualização do cartão para exibir a **descrição completa** do contexto selecionado.|
|Utilizar Contexto|Ativador (toggle)| |Ativo, Inativo.|Inativo|Quando ativado, **incorpora o contexto na conversa atual**, aplicando automaticamente as instruções e definições do contexto às respostas do IAGO.|
|Editar|Ícone de ação| | | |Permite **editar** o título e a descrição do contexto selecionado.|
|Excluir|Ícone de ação| | | |Remove permanentemente o contexto após confirmação do usuário.|

==== Tela 02 ====

{{  :pres:gerti:gestao_de_ativos:iago:iago_contextos_editar.png?1222x910  }}

^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação|
|Editar Contexto|Modal| | | |Edição exibida ao acionar a ação de **editar** um contexto, permitindo alterar título e descrição do mesmo.|
|Título|Alfanumérico|Sim| | |O **título** do contexto a ser editado.|
|Editor de Descrição|Área de texto|Sim| | |Campo para redigir ou alterar a **descrição completa do contexto**, com suporte a formatação (negrito, itálico, tachado, sublinhado, listas ordenadas e não ordenadas).|
|Fechar|Botão| | | |Fecha o modal de edição sem salvar as alterações realizadas.|
|Salvar|Botão|Sim| | |Valida os campos obrigatórios e salva as alterações realizadas no contexto, fechando o modal e retornando à tela de Contextos.|

==== Tela 03 ====

{{  :pres:gerti:gestao_de_ativos:iago:iago_contextos_confirma_exclusao.png?1227x905  }}

^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação|
|Confirmação da Remoção|Modal| | | |Confirmação exibida ao acionar a ação de **remover** um contexto, apresentando a mensagem de alerta sobre a exclusão permanente do contexto.|
|Fechar|Botão| | | |Fecha o modal de confirmação sem remover o contexto, mantendo o registro inalterado.|
|Confirmar|Botão|Sim| | |Confirma a remoção e **exclui permanentemente o contexto** dos servidores do sistema, retornando à tela de Contextos.|

==== Tela 04 ====

{{  :pres:gerti:gestao_de_ativos:iago:iago_contextos_criar.png?1230x910  }}

^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação|
|Aba Criar Contextos|Aba de navegação| | | |Exibe a interface para criação de um novo contexto com instruções e definições para o IAGO.|
|Título|Alfanumérico|Sim| | |**T****ítulo** do novo contexto a ser criado.|
|Editor de Descrição|Área de texto|Sim| | |**D**e**scrição completa do contexto**, com instruções e orientações que serão aplicadas às respostas do IAGO, com suporte a formatação (negrito, itálico, tachado, sublinhado, listas ordenadas e não ordenadas).|
|Cancelar|Botão| | | |Fecha o modal de criação sem salvar o novo contexto, retornando à tela anterior.|
|Criar|Botão|Sim| | |Valida os campos obrigatórios, cria o novo contexto e o disponibiliza na aba **Contextos** para uso nas conversas, exibindo mensagem de sucesso.|

==== Tela 05 ====

{{  :pres:gerti:gestao_de_ativos:iago:iago_contextos_chat.png?1800x861  }}

^Elemento^Tipo^Obrigatório^Valores Possíveis^Valor Padrão^Observação|
|Contexto Ativo|Badge/Tag| | | |Exibe visualmente o **contexto ativado** na conversa atual (ex.: "Servidor do Tribunal de Contas"), com ícone indicador de status ativo (ponto verde) e botão **X** para **remover/desativar** o contexto da conversa em andamento.|

===== Fluxos =====

==== Fluxo 01 - Criar Contextos ====

^Passo^Ação^Regra^Tela|
|01|O usuário acessa a aba "Criar Contextos" na funcionalidade Contexto.|RN01|Tela 04|
|02|O sistema exibe o formulário de criação de contexto com os campos "Título" e editor de conteúdo com barra de formatação.| |Tela 04|
|03|O usuário preenche o título, descreve o contexto no editor (com instruções e orientações para o IAGO) e clica no botão "Criar".| |Tela 04|
|04|O sistema valida os campos obrigatórios, cria o novo contexto e o disponibiliza na aba "Contextos" para uso nas conversas, exibindo mensagem de sucesso.| |Tela 04|

==== Fluxo 02 - Utilizar Contexto ====

^Passo^Ação^Regra^Tela|
|01|O usuário, na aba "Contextos", visualiza um contexto e clica em "Utilizar Contexto" para ativá-lo.|RN01, RN02|Tela 01|
|02|O sistema incorpora o contexto à conversa ativa, aplicando automaticamente as instruções e definições do contexto às futuras respostas do IAGO.| | |
|03|O sistema exibe um marcador visual indicando que o contexto está ativo na conversa atual, permitindo sua que o usuário possa removê-lo.|RN03, RN04|Tela 05|

==== Fluxo 03 - Editar Contexto ====

^Passo^Ação^Regra^Tela|
|01|O usuário, na aba "Contextos", clica no ícone de edição de um contexto desejado.|RN01|Tela 01|
|02|O sistema exibe o modal "Editar Contexto", carregando o título e a descrição completa do contexto para edição.| |Tela 02|
|03|O usuário altera o título e/ou a descrição do contexto no editor e clica no botão "Salvar".| |Tela 02|
|04|O sistema valida os campos obrigatórios, atualiza o contexto e o mantém disponível na aba "Contextos", exibindo mensagem de confirmação da edição.| |Tela 01|

==== Fluxo 04 - Remover Contexto da conversa ====

^Passo^Ação^Regra^Tela|
|01|O usuário, na tela de Conversa com um contexto ativo, clica no botão "X" do marcador (badge) de contexto ativo para removê-lo da conversa.|RN02|Tela 05|
|02|O sistema desativa o contexto da conversa atual, removendo o marcador visual e cessando a aplicação das instruções do contexto às respostas do IAGO, nas próximas interações.| | |

==== Fluxo 05 - Excluir Contexto ====

^Passo^Ação^Regra^Tela|
|01|O usuário, na aba "Contextos", clica no ícone de exclusão (lixeira) de um contexto desejado.|RN01|Tela 01|
|02|O sistema exibe o modal "Atenção" perguntando se o usuário deseja realmente remover o contexto, informando que a ação é permanente e irreversível.| |Tela 03|
|03|O usuário clica no botão "Confirmar" para remover o contexto.| |Tela 03|
|04|O sistema remove permanentemente o contexto dos servidores, atualiza a listagem de contextos e exibe mensagem de confirmação da exclusão.| | |

===== Regras de Negócio =====

^Regra^Descrição|
|RN01|Contextos são pessoais e privados; cada usuário pode criar, visualizar, editar e excluir apenas os contextos por ele criados. Usuários não possuem acesso a contextos criados por outros usuários, garantindo a privacidade e personalização das definições de contexto por usuário logado no sistema.|
|RN02|O contexto pode ser adicionado ou removido de uma conversa a qualquer momento, independentemente do estágio ou duração da conversa. O usuário pode ativar ou desativar um contexto durante o curso da interação, sem necessidade de reiniciar ou encerrar a conversa.|
|RN03|O Contexto aplicado, permanecerá habilitado para uma nova conversa (iniciada a partir do botão "Novo"), em conversas atuais (em andamento) ou em conversas retomadas (histórico). O contexto permanecerá ativo para todas as conversas.|
|RN04|Uma conversa pode possuir apenas um contexto ativo por vez. Caso o usuário ative um novo contexto enquanto outro já está ativo, o contexto anterior será automaticamente desativado e substituído pelo novo contexto. O marcador (badge) de contexto ativo refletirá sempre apenas o contexto correntemente em uso na conversa.|