Commit inicial - upload de todos os arquivos da pasta

2026-07-24 23:55:21 -03:00
commit 9d4d395881
88 changed files with 9484 additions and 0 deletions
@@ -0,0 +1,19 @@
+## ADDED Requirements
+
+### Requirement: Seleção de categoria no cadastro de documento
+O formulário de novo documento, na rota `/documents/new`, SHALL exibir um campo select "Categoria" populado com todos os registros da tabela `categoria`, ordenados por nome (`categoria`) em ordem ascendente (ASC).
+
+#### Scenario: Formulário exibe categorias ordenadas por nome
+- **WHEN** o usuário acessa a rota `/documents/new`
+- **THEN** o select "Categoria" é exibido com as opções carregadas da tabela `categoria`, ordenadas alfabeticamente (ASC) pelo campo `categoria`
+
+#### Scenario: Campo categoria é opcional
+- **WHEN** o usuário envia o formulário de novo documento sem selecionar nenhuma categoria
+- **THEN** o documento é criado com sucesso e `categoria_id` fica nulo (sem categoria)
+
+### Requirement: Persistência da categoria selecionada
+Ao submeter o formulário de novo documento com uma categoria selecionada, o sistema SHALL salvar o `id` da categoria escolhida no campo `categoria_id` do documento fiscal criado.
+
+#### Scenario: Categoria selecionada é persistida
+- **WHEN** o usuário seleciona uma categoria no formulário e submete o novo documento
+- **THEN** o registro criado em `fiscal_documents` possui `categoria_id` igual ao id da categoria selecionada