ÍndiceRascunho

Eu, como usuário do sistema AgroDigital, quero buscar índices, listar índices, adicionar índice, visualizar índice, editar índice, listar valor por índice, adicionar valor por índice, visualizar valor por índice e editar valor por índice para gerenciar índices.

Histórico da fonte

v1.1 - 06/08/2026: Conversão para o formato completo.
v1.0 - 09/07/2026: Primeira versão da história.

História de usuário

Eu, como usuário do sistema, quero gerenciar índices, para que eu possa permitir a gestão eficiente dessas informações.

1. Buscar índices

Dado que estou na tela inicial para usuários autenticados
Quando acesso o menu Índice (Ver RNC007 - Permissões de Acesso)
Então o sistema exibe a tela de busca, contendo os seguintes filtros:

Campo	Tipo	Obrigatório	Validações
Nome do Índice	Texto	Não	Tamanho = 255 caracteres
Situação	Seleção simples	Não	Valores = “Ativo”, “Inativo”

E exibe as seguintes ações: (Ver AC001 - Ações das telas de busca)

2. Listar índices

Dado que estou na tela de busca
E o campo de busca e/ou pelo menos um dos filtros disponíveis foi corretamente preenchido
Quando realizo a ação “Pesquisar”
E o sistema encontrou registros compatíveis com os valores informados
Então o sistema exibe os resultados retornados, contendo os seguintes campos:

Campo	Descrição
Índice	Exibe o índice
Situação	Exibe a situação do cadastro

E exibe as seguintes ações: (Ver AC002 - Ações das telas de listagem)

3. Adicionar índice

Dado que estou na tela de cadastro
Então o sistema exibe um formulário, contendo os seguintes campos:

Informações Básicas

Campo	Tipo	Obrigatório	Editável	Validações
Índice	Texto	Sim	Sim	Tamanho = 255 caracteres

E exibe as seguintes ações: (Ver AC003 - Ações das telas de cadastro e AC006 - Ações de interação com formulários)

4. Visualizar índice

Dado que estou na tela de visualização
Então o sistema exibe os campos do formulário descrito no critério de aceitação 3 como somente leitura, com seus valores já preenchidos
E, além desses, exibe os seguintes campos, também como somente leitura:

Situação

Campo	Tipo	Obrigatório	Editável	Validações
Situação	Seleção simples	Sim	Sim	Valores = “Ativo”, “Inativo”

E exibe as seguintes ações: (Ver AC004 - Ações das telas de visualização e AC006 - Ações de interação com formulários)

5. Editar índice

Dado que estou na tela de edição
Então o sistema exibe todos os campos descritos nos critérios de aceitação 3 e 4, com seus valores já preenchidos
E permite editar todos os campos passíveis de edição (EDT = Sim)
E exibe as seguintes ações: (Ver AC005 - Ações das telas de edição e AC006 - Ações de interação com formulários)

Aba: Valor por Índice

6. Listar valor por índice

Dado que estou na aba de listagem
Então o sistema exibe os valores por índice do índice em questão, contendo os seguintes campos:

Campo	Descrição
Índice	Exibe o nome do Índice
Ano	Exibe o ano
Valor	Exibe o valor
Situação	Exibe a situação do cadastro

E exibe as seguintes ações: (Ver AC002 - Ações das telas de listagem)

7. Adicionar valor por índice

Dado que estou na tela de cadastro
Então o sistema exibe um formulário, contendo os seguintes campos:

Informações Básicas

Campo	Tipo	Obrigatório	Editável	Validações
Valor	Numérico	Sim	Sim	Formato = Positivo com 4 casas decimais
Ano	Inteiro	Sim	Sim	Tamanho = 4

8. Visualizar valor por índice

Dado que estou na tela de visualização
Então o sistema exibe os campos do formulário descrito no critério de aceitação 7 como somente leitura, com seus valores já preenchidos
E, além desses, exibe os seguintes campos, também como somente leitura:

Situação

Campo	Tipo	Obrigatório	Editável	Validações
Situação	Seleção simples	Sim	Não	É permitido apenas um cadastro ativo por índice por ano. Ao cadastrar um novo valor para o índice, esse cadastro será ativado automaticamente em 01/01 do ano correspondente. Quando isso ocorrer, o cadastro que estiver ativo até então deverá ser automaticamente inativado. Valores = “Ativo”, “Agendado”, “Inativo”

E exibe as seguintes ações: (Ver AC004 - Ações das telas de visualização e AC006 - Ações de interação com formulários)

9. Editar valor por índice

Dado que estou na tela de edição
Então o sistema exibe todos os campos descritos nos critérios de aceitação 7 e 8, com seus valores já preenchidos
E permite editar todos os campos passíveis de edição (EDT = Sim)
E exibe as seguintes ações: (Ver AC005 - Ações das telas de edição e AC006 - Ações de interação com formulários)

Regras de negócio específicas

RNE001 – É permitido apenas um cadastro de valor ativo por índice em cada ano. Os cadastros podem assumir os seguintes status:
- Agendado: cadastro criado para um ano futuro, que ainda não atingiu sua data de vigência.
- Ativo: cadastro vigente para o índice.
- Inativo: cadastro que já perdeu a vigência em razão da ativação de um cadastro mais recente.
RNE002 - Ao cadastrar um novo valor para o índice, seu status inicial será Agendado. Em 01/01 do ano correspondente, seu status será alterado automaticamente para Ativo, e o cadastro que estiver com status Ativo será automaticamente alterado para Inativo.
RNE003 – O sistema deve disparar uma notificação para os administradores, alertando sobre a necessidade de cadastrar o valor do índice para o próximo ano, com a seguinte periodicidade: 30, 7 e 1 dia antes do término do ano vigente, ou até que o valor do índice para o próximo ano seja cadastrado.

Documentos vinculados

Convenções da conversão

As colunas Obrigatório e Editável correspondem a OBG e EDT da fonte. A edição posterior deve respeitar também as condições de somente leitura e situação do cadastro. As ações comuns foram mantidas nos pontos citados. Não foram criados exemplos, padrões ou regras ausentes da fonte.

Pendências da fonte

A fonte não informa código US; nenhum identificador foi criado.
A RNE002 define Agendado como estado inicial e ativação em 01/01. Confirmar o comportamento para valores cadastrados para o ano atual ou anos passados.
A regra permite apenas um valor ativo por índice por ano e manda inativar o valor vigente na ativação de outro. Confirmar o tratamento de múltiplos cadastros agendados para o mesmo ano.
A fonte não detalha fuso/horário de ativação nem canal das notificações aos administradores. Os prazos de 30, 7 e 1 dia foram preservados.