> ## Documentation Index
> Fetch the complete documentation index at: https://docs.domsoftware.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Produtos (Histórias)

> Histórias de Produtos

# Histórias de Usuário: OmniDom Produtos (Catálogo)

### 📌 Épico Identificado

* **Nome do épico:** Gestão Dimensional de Catálogo e Componentes
* **Objetivo de negócio:** Modernizar e unificar o CRUD de produtos propiciando agilidade em estruturas que demandam ramificações complexas (Variações por cor/tamanho) ou associações logísticas criativas (Kits de fomento), tudo sob a vigilância das novas conformidades de Reforma Tributária no mesmo formulário.
* **Módulo/sistema identificado:** Catálogo Base & Pricing / OmniDom BackOffice

***

### 📖 Histórias de Usuário

**HU1: Base de Cadastro e Estruturação de Abas de Produto**

* **Como** Gestor de Catálogo Omni
* **Quero** visualizar o painel modular do Módulo de Produtos para entrar e criar itens através de um formulário longo dividido inteligentemente entre Abas (Gerais, Logística, Fiscal/Preços).
* **Para que** eu adicione inventário organizadamente sem cansaço visual, preenchendo todos os requisitos que garantem a aprovação da nota fiscal.
* **Prioridade sugerida:** Alta
* **Estimativa de complexidade:** GG

**✅ Critérios de Aceitação**

* **CA1:** Dado que eu seleciono "Novo Produto" / Quando abre a interface Base / Então eu percebo seções divididas exigindo inputs para NCM, Categoria, Marca e Preço. (Visível nas telas)
* **CA2:** Dado que deixei em branco algum campo compulsório (\*) tipo NCM da Aba Fiscal / Quando aplico Salvar Total / Então o sistema trava e me leva a aba problemática sublinhando a área do form. (Processo Inferido UI Responsável).

**📋 Regras de Negócio Relacionadas**

* **RN1:** Proteção de NCM e Reforma
  * Atributos não contornáveis para salvamento devido ao acoplamento estrito de faturamento da jornada Omni.

***

**HU2: Dinamismo de Grades de Variações de SKU**

* **Como** Analista de E-commerce
* **Quero** adicionar um tipo "Variação", escrever sub-tags de Cor e Tamanho e solicitar derivação combinatória
* **Para que** os SKUs-filhos sejam formatados todos de uma vez (ex: Camisa-Preta-P) poupando recadastramento compulsório infindável
* **Prioridade sugerida:** Alta
* **Estimativa de complexidade:** G

**✅ Critérios de Aceitação**

* **CA3:** Dado que estou na aba de propriedades e clico para agrupar 3 Cores e 2 Tamanhos / Quando confirmo / Então o grid de variações se popula com exatos 6 registros para adição paralela de códigos EAN e estoque isolados. (Visível nas telas).

***

**HU3: Amarração Logística Inteligente para Produtos KITs (Combos/Bundles)**

* **Como** Estrategista de Vendas e Marketing
* **Quero** marcar um dos meus novos produtos raiz como "Kit", puxando da base outros produtos avulsos preexistentes
* **Para que** eu possa criar um SKU virtual atraente somando os valores sem inflar saldos mentirosos na prateleira real do CD.
* **Prioridade sugerida:** Média
* **Estimativa de complexidade:** M

**✅ Critérios de Aceitação**

* **CA4:** Dado que terminei a alocação de itens de composição num Kit / Quando visito o painel / Então noto que o estoque livre da Cesta/Kit não permite inserções manuais, espelhando apenas a sobra matemática do item que menos tenha chance comercial em sua lista de base (Gargalo de inventário). (Comportamento UI Visível).
* **CA5:** Dado que clico num menu ou tabela sub-anexa / Quando busco os componentes / Então a busca reativa do banco facilita encontrar o "Shampoo" para emparelhar com o "Condicionador". (Visível).

**📋 Regras de Negócio Relacionadas**

* **RN2:** Abstração Financeira de Puxada
  * O sistema deve entender que o saldo do KIT espelha a função *LOWER* do vetor dos participantes do pacote, a fim de impedir que o e-commerce venda ar se um parafuso acabar para fechar 1 mesa, por exemplo.

***

### 🗂️ Backlog Sugerido

| ID  | História                                                                   | Prioridade | Tamanho |
| --- | -------------------------------------------------------------------------- | ---------- | ------- |
| HU1 | Base de Cadastro Simples e Estruturação de Abas de Produto e Regra Fiscal  | Alta       | GG      |
| HU2 | Dinamismo Estrutural de Grades de Variações Cruzadas                       | Alta       | G       |
| HU3 | Amarração Logística Inteligente e Cálculo de Limite para SKUs do tipo KITs | Média      | M       |

***

### 📝 Definition of Ready

* ✅ UX e fluxograma atestados pelo Flow de Gravação real enviado (OmniDom Produto.webm).
* ✅ Regras de negócio essenciais abstraídas e pontuadas (Kits Stock Algorithm).
* ✅ Critérios de aceitação tangibilizados aos comportamentos *Cartesianos*.
* ⬜ Schema oficial de integração ERP/Vtex avaliado p/ conversões de JSON de Atributos Variáveis.