EPICO - E (Sistema de Estoque)

gistfile1.txt

# [PRD-EPICO-E.md](http://prd-epico-e.md/)

## Épico E — Lista de Compras

---

## 1. Visão Geral

O Épico E introduz uma funcionalidade de **Lista de Compras**, cujo objetivo é orientar os usuários sobre **quais itens precisam ser comprados**, com base na comparação entre o **estoque atual físico** e o **estoque mínimo configurado** para cada item.

Essa funcionalidade é **estritamente informativa** e não realiza qualquer tipo de registro de compra, atualização de estoque ou cálculo financeiro. A lista existe apenas como apoio operacional, podendo ser consultada ou impressa antes da realização das compras.

---

## 2. Objetivos

- Exibir de forma clara os itens que necessitam reposição.
- Reduzir erro humano na interpretação do estoque.
- Eliminar a necessidade de listas externas (papel, mensagens, anotações).
- Facilitar a preparação e execução de compras físicas.

---

## 3. Escopo

### 3.1 Incluído

- Tela dedicada de **Lista de Compras**.
- Exibição apenas de itens cujo estoque atual esteja **abaixo do estoque mínimo**.
- Cálculo automático da **quantidade sugerida para compra**, baseado apenas em quantidades físicas.
- Agrupamento opcional dos itens por categoria.
- Opção de visualização adequada para impressão ou exportação.

### 3.2 Não Incluído

- Registro de compras realizadas.
- Registro ou cálculo de valores monetários.
- Controle de despesas, custos ou orçamentos.
- Atualização automática do estoque.
- Histórico de listas de compras anteriores.
- Informações de fornecedores, notas fiscais ou formas de pagamento.

---

## 4. Premissas

- O estoque atual é calculado corretamente pelo sistema de movimentações (Épico C) **exclusivamente em termos de quantidade física** (ex.: kg, unidade, litro).
- O sistema **não possui** e **não utiliza** qualquer conceito financeiro no MVP.
- Cada item possui um estoque mínimo previamente configurado.
- O dashboard já identifica corretamente itens abaixo do estoque mínimo.
- A lista de compras não altera dados do sistema, servindo apenas como orientação visual.

---

## 5. Requisitos Funcionais

- **RF-E-01** — O sistema deve exibir apenas itens cujo estoque atual esteja inferior ao estoque mínimo.
- **RF-E-02** — O sistema deve calcular automaticamente a quantidade sugerida para compra com base na diferença entre estoque mínimo e estoque atual.
- **RF-E-03** — O sistema deve permitir o agrupamento dos itens por categoria.
- **RF-E-04** — O sistema deve permitir a impressão ou exportação da lista de compras.
- **RF-E-05** — A tela de lista de compras não deve permitir qualquer ação que altere o estoque ou os dados dos itens.

---

## 6. Requisitos Não Funcionais

- Interface simples, focada em leitura rápida.
- Idioma: português.
- Performance adequada para carregamento imediato da lista.
- Layout otimizado para visualização em tela e impressão.

---

## 7. Critérios de Aceite

- [ ]  A lista exibe somente itens abaixo do estoque mínimo.
- [ ]  A quantidade sugerida para compra é calculada corretamente.
- [ ]  Itens com estoque igual ou acima do mínimo não aparecem na lista.
- [ ]  Não existe qualquer ação de edição ou movimentação de estoque nessa tela.
- [ ]  A lista pode ser visualizada de forma adequada para impressão ou exportação.
- [ ]  Usuários conseguem utilizar a funcionalidade sem treinamento adicional.

---

## 8. Perguntas Abertas

- A exportação deve ser apenas para impressão (ex.: PDF) ou também para CSV? Em PDF
- A lista de compras deve ser acessível a todos os usuários ou apenas a administradores? Por todos os usuários, sejam admins e usuários comuns
- A ordenação padrão deve ser por categoria ou por criticidade do estoque? Acho que por criticidade do estoque