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
@@ -0,0 +1,23 @@
+## ADDED Requirements
+
+### Requirement: Coluna Categoria na Dashboard
+A tabela "Últimos documentos" da Dashboard SHALL exibir uma coluna "Categoria" posicionada imediatamente após a coluna "Fornecedor", mostrando o nome da categoria do documento (ou vazio/"Não Encontrado" quando não houver categoria associada).
+
+#### Scenario: Coluna Categoria aparece após Fornecedor na Dashboard
+- **WHEN** o usuário acessa a Dashboard
+- **THEN** a tabela "Últimos documentos" exibe as colunas na ordem: Data, Fornecedor, Categoria, Valor (demais colunas mantidas), com "Categoria" logo após "Fornecedor"
+
+#### Scenario: Documento sem categoria exibido corretamente
+- **WHEN** um documento listado na Dashboard possui `categoria_id` nulo
+- **THEN** a célula da coluna "Categoria" é exibida vazia ou com um indicador de "sem categoria", sem gerar erro
+
+### Requirement: Coluna Categoria na listagem de documentos
+A tabela de listagem da rota `/documents` SHALL exibir uma coluna "Categoria" posicionada imediatamente após a coluna "Fornecedor", mostrando o nome da categoria do documento.
+
+#### Scenario: Coluna Categoria aparece após Fornecedor em /documents
+- **WHEN** o usuário acessa a rota `/documents`
+- **THEN** a tabela de documentos exibe as colunas na ordem: Data, Fornecedor, Categoria, Valor, Origem, Ações (demais colunas mantidas), com "Categoria" logo após "Fornecedor"
+
+#### Scenario: Documento sem categoria exibido corretamente em /documents
+- **WHEN** um documento listado em `/documents` possui `categoria_id` nulo
+- **THEN** a célula da coluna "Categoria" é exibida vazia ou com um indicador de "sem categoria", sem gerar erro