Testes.md

@@ -21,3 +21,120 @@ Esta documentação lista os testes automatizados e os **casos de uso** de negó
 
 ---
 
+### Módulo: DataClient
+
+| Teste | Caso de Uso Validado | Descrição Detalhada do Caso de Uso |
+| :------------------------------------------------------ | :----------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test_create_data_client_success` | **Criar Dados do Cliente** (Cenário de Sucesso) | Garante que o sistema consegue **criar um novo conjunto de dados de cliente** com informações válidas e completas. Verifica se os dados são persistidos e acessíveis após a criação. |
+| `test_create_data_client_conflict` | **Criar Dados do Cliente** (Cenário de Conflito) | Confirma que o sistema **impede a criação de dados de cliente** se já existir um registro com um identificador único em conflito (por exemplo, um cliente já associado a uma conta específica, ou um código identificador duplicado). |
+| `test_get_data_clients_empty` | **Listar Dados do Cliente** (Cenário de Lista Vazia) | Verifica se o sistema **retorna uma lista vazia** quando não há dados de cliente cadastrados, garantindo o comportamento correto para consultas sem resultados. |
+| `test_get_data_client_by_id_not_found` | **Consultar Dados do Cliente por ID** (Cenário de Não Encontrado) | Garante que o sistema **lida adequadamente com requisições para IDs de dados de cliente inexistentes**, retornando uma resposta que indica que o registro não foi encontrado. |
+| `test_get_data_client_by_id_success` | **Consultar Dados do Cliente por ID** (Cenário de Sucesso) | Confirma que o sistema **consegue recuperar os detalhes de um conjunto específico de dados do cliente** quando um ID válido é fornecido, verificando a exatidão das informações retornadas. |
+| `test_get_data_client_by_account_id_not_found` | **Consultar Dados do Cliente por ID da Conta** (Cenário de Não Encontrado) | Assegura que o sistema **lida corretamente com tentativas de buscar dados de cliente por um ID de conta que não existe** ou não possui dados de cliente associados. |
+| `test_get_data_client_by_account_id_success` | **Consultar Dados do Cliente por ID da Conta** (Cenário de Sucesso) | Valida que o sistema **retorna os dados do cliente corretamente associados a um ID de conta específico** quando este existe, garantindo a recuperação por relação com a conta. |
+| `test_update_data_client_success` | **Atualizar Dados do Cliente** (Cenário de Sucesso) | Valida que os **dados de um cliente existente podem ser modificados** e que essas alterações são salvas e refletidas no sistema. Teste os campos passíveis de atualização. |
+| `test_update_data_client_not_found` | **Atualizar Dados do Cliente** (Cenário de Não Encontrado) | Assegura que o sistema **não permite a atualização de dados de cliente que não existem**, e que uma resposta de "não encontrado" ou erro apropriado é retornada. |
+| `test_delete_data_client_success` | **Excluir Dados do Cliente** (Cenário de Sucesso) | Confirma que um **conjunto de dados de cliente pode ser removido com sucesso** do sistema e que ele não é mais acessível após a exclusão. |
+| `test_delete_data_client_not_found` | **Excluir Dados do Cliente** (Cenário de Não Encontrado) | Verifica se o sistema **lida corretamente com tentativas de exclusão de dados de cliente que não existem**, retornando uma indicação clara de que o registro não pôde ser encontrado para exclusão. |
+| `test_update_data_client_account_id` | **Atualizar Dados do Cliente** (Cenário de Atualização do ID da Conta) | Testa a funcionalidade de **alterar a associação de dados de cliente para uma conta diferente**, verificando se a mudança é persistida corretamente. |
+| `test_update_data_client_identifying_code` | **Atualizar Dados do Cliente** (Cenário de Atualização do Código Identificador) | Valida se o **código identificador de um cliente pode ser atualizado** com sucesso, mantendo a unicidade e a integridade do registro. |
+
+---
+
+### Módulo: DataProduct
+
+| Teste | Caso de Uso Validado | Descrição Detalhada do Caso de Uso |
+| :------------------------------------------------ | :------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test_create_data_product_success` | **Criar Produto de Dados** (Cenário de Sucesso) | Garante que o sistema consegue **criar um novo produto de dados** com informações válidas e completas. Verifica se o produto é persistido e acessível após a criação. |
+| `test_get_data_products_paginated_empty` | **Listar Produtos de Dados** (Cenário Paginado Vazio) | Confirma que o sistema **retorna uma lista paginada vazia** quando não há produtos de dados cadastrados ou quando a página solicitada não contém resultados, garantindo o comportamento correto da paginação. |
+| `test_get_data_product_by_id_not_found` | **Consultar Produto de Dados por ID** (Cenário de Não Encontrado) | Garante que o sistema **lida adequadamente com requisições para IDs de produtos de dados inexistentes**, retornando uma resposta que indica que o produto não foi encontrado. |
+| `test_get_data_products_empty_list` | **Listar Produtos de Dados** (Cenário de Lista Vazia) | Verifica se o sistema **retorna uma lista vazia** quando não há produtos de dados cadastrados, validando o comportamento para consultas gerais sem resultados. |
+| `test_get_data_products_by_name` | **Consultar Produtos de Dados por Nome** (Cenário de Sucesso) | Assegura que o sistema **consegue pesquisar e retornar produtos de dados com base em seu nome** ou parte dele, validando a funcionalidade de busca textual. |
+| `test_update_and_delete_data_product` | **Atualizar e Excluir Produto de Dados** (Fluxo Completo) | Este teste valida um **fluxo completo de ciclo de vida**, onde um produto de dados é criado, depois **atualizado com sucesso** e, por fim, **excluído com sucesso**, garantindo a integridade e operabilidade das três operações em sequência. |
+| `test_create_data_product_dataset_service_failure` | **Criar Produto de Dados** (Cenário de Falha de Serviço de Dataset) | Verifica como o sistema **reage quando o serviço de dataset falha** durante a criação de um produto de dados, garantindo que a operação seja abortada corretamente e um erro apropriado seja retornado. |
+| `test_create_data_product_repo_failure` | **Criar Produto de Dados** (Cenário de Falha de Repositório) | Testa o comportamento do sistema quando ocorre uma **falha no repositório (banco de dados/persistência)** durante a tentativa de criar um produto de dados, garantindo que a transação seja revertida e um erro seja propagado. |
+| `test_create_data_product_name_conflict` | **Criar Produto de Dados** (Cenário de Conflito de Nome) | Confirma que o sistema **impede a criação de um produto de dados se o nome já estiver em uso**, garantindo a unicidade do nome (ou outro identificador principal) e retornando um erro de conflito. |
+| `test_update_data_product_not_found` | **Atualizar Produto de Dados** (Cenário de Não Encontrado) | Assegura que o sistema **não permite a atualização de um produto de dados que não existe**, e que uma resposta de "não encontrado" ou erro apropriado é retornada. |
+
+---
+
+### Módulo: Dataset
+
+| Teste | Caso de Uso Validado | Descrição Detalhada do Caso de Uso |
+| :----------------------------------- | :------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test_create_dataset` | **Criar Dataset** (Cenário de Sucesso) | Garante que o sistema consegue **criar um novo dataset** com informações válidas e que ele é devidamente persistido e se torna acessível. |
+| `test_list_all_datasets` | **Listar Todos os Datasets** (Cenário de Sucesso) | Verifica se o sistema **retorna corretamente uma lista completa de todos os datasets** cadastrados, independentemente do seu status. |
+| `test_list_active_datasets` | **Listar Datasets Ativos** (Cenário de Sucesso) | Confirma que o sistema **retorna apenas os datasets que estão marcados como ativos**, filtrando corretamente por status. |
+| `test_list_by_data_provider` | **Listar Datasets por Provedor de Dados** (Cenário de Sucesso) | Assegura que o sistema **consegue filtrar e retornar datasets associados a um provedor de dados específico**, validando a busca por relacionamento. |
+| `test_get_dataset_found` | **Consultar Dataset por ID** (Cenário de Sucesso) | Verifica se o sistema **recupera corretamente os detalhes de um dataset específico** quando um ID válido é fornecido, confirmando que os dados retornados são os esperados. |
+| `test_get_dataset_not_found` | **Consultar Dataset por ID** (Cenário de Não Encontrado) | Garante que o sistema **lida adequadamente com requisições para IDs de datasets inexistentes**, retornando uma resposta que indica que o dataset não foi encontrado. |
+| `test_update_dataset` | **Atualizar Dataset** (Cenário de Sucesso) | Valida que os **dados de um dataset existente podem ser modificados** e que essas alterações são salvas e refletidas no sistema. |
+| `test_update_dataset_not_found` | **Atualizar Dataset** (Cenário de Não Encontrado) | Assegura que o sistema **não permite a atualização de um dataset que não existe**, e que uma resposta de "não encontrado" ou erro apropriado é retornada. |
+| `test_delete_dataset` | **Excluir Dataset** (Cenário de Sucesso) | Confirma que um **dataset pode ser removido com sucesso** do sistema e que ele não é mais acessível após a exclusão. |
+| `test_delete_dataset_not_found` | **Excluir Dataset** (Cenário de Não Encontrado) | Verifica se o sistema **lida corretamente com tentativas de exclusão de datasets que não existem**, retornando uma indicação clara de que o registro não pôde ser encontrado para exclusão. |
+
+---
+
+### Módulo: Invoice
+
+| Teste | Caso de Uso Validado | Descrição Detalhada do Caso de Uso |
+| :----------------------------------------- | :------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test_create_invoice_success` | **Criar Fatura** (Cenário de Sucesso) | Garante que o sistema consegue **criar uma nova fatura** com todos os dados válidos e que ela seja persistida corretamente. |
+| `test_create_invoice_transaction_not_found` | **Criar Fatura** (Cenário de Transação Não Encontrada) | Confirma que o sistema **impede a criação de uma fatura** se a transação à qual ela deveria ser vinculada não for encontrada, retornando um erro apropriado. |
+| `test_list_all_invoices` | **Listar Todas as Faturas** (Cenário de Sucesso) | Verifica se o sistema **retorna corretamente uma lista completa de todas as faturas** cadastradas. |
+| `test_list_by_account` | **Listar Faturas por Conta** (Cenário de Sucesso) | Assegura que o sistema **consegue filtrar e retornar as faturas vinculadas a uma conta específica**, validando a busca por relacionamento. |
+
+---
+
+### Módulo: Subscription
+
+| Teste | Caso de Uso Validado | Descrição Detalhada do Caso de Uso |
+| :----------------------------------------- | :------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test_create_subscription_success` | **Criar Assinatura** (Cenário de Sucesso) | Garante que o sistema consegue **criar uma nova assinatura** com todos os dados válidos e que ela seja persistida corretamente. |
+| `test_create_subscription_account_not_found` | **Criar Assinatura** (Cenário de Conta Não Encontrada) | Confirma que o sistema **impede a criação de uma assinatura** se a conta à qual ela deveria ser vinculada não for encontrada, retornando um erro apropriado. |
+| `test_get_all_subscriptions` | **Listar Todas as Assinaturas** (Cenário de Sucesso) | Verifica se o sistema **retorna corretamente uma lista completa de todas as assinaturas** cadastradas. |
+| `test_get_subscriptions_by_account` | **Listar Assinaturas por Conta** (Cenário de Sucesso) | Assegura que o sistema **consegue filtrar e retornar as assinaturas vinculadas a uma conta específica**, validando a busca por relacionamento. |
+| `test_get_subscription_by_id_success` | **Consultar Assinatura por ID** (Cenário de Sucesso) | Confirma que o sistema **recupera os detalhes de uma assinatura específica** quando um ID válido é fornecido, verificando a exatidão das informações retornadas. |
+| `test_get_subscription_by_id_not_found` | **Consultar Assinatura por ID** (Cenário de Não Encontrada) | Garante que o sistema **lida adequadamente com requisições para IDs de assinaturas inexistentes**, retornando uma resposta que indica que a assinatura não foi encontrada. |
+| `test_delete_subscription_success` | **Excluir Assinatura** (Cenário de Sucesso) | Confirma que uma **assinatura pode ser removida com sucesso** do sistema e que ela não é mais acessível após a exclusão. |
+| `test_delete_subscription_not_found` | **Excluir Assinatura** (Cenário de Não Encontrada) | Verifica se o sistema **lida corretamente com tentativas de exclusão de assinaturas que não existem**, retornando uma indicação clara de que o registro não pôde ser encontrado para exclusão. |
+
+---
+
+### Módulo: Transaction
+
+| Teste | Caso de Uso Validado | Descrição Detalhada do Caso de Uso |
+| :------------------------------------------------ | :------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test_create_transaction_success` | **Criar Transação** (Cenário de Sucesso) | Garante que o sistema consegue **criar uma nova transação** com todos os dados válidos, e que ela é devidamente persistida e associada. |
+| `test_create_transaction_account_not_found` | **Criar Transação** (Cenário de Conta Não Encontrada) | Confirma que o sistema **impede a criação de uma transação** se a conta associada não for encontrada, retornando um erro apropriado. |
+| `test_create_transaction_data_product_not_found` | **Criar Transação** (Cenário de Produto de Dados Não Encontrado) | Verifica que o sistema **não permite a criação de uma transação** se o produto de dados referenciado não existir, garantindo a integridade dos dados. |
+| `test_create_transaction_user_not_found` | **Criar Transação** (Cenário de Usuário Não Encontrado) | Assegura que o sistema **impede a criação de uma transação** caso o usuário que a está realizando não seja encontrado, protegendo contra operações inválidas. |
+| `test_get_transactions` | **Listar Todas as Transações** (Cenário de Sucesso) | Confirma que o sistema **retorna uma lista completa de todas as transações** registradas, validando a funcionalidade de consulta geral. |
+| `test_get_transaction_by_account` | **Listar Transações por Conta** (Cenário de Sucesso) | Garante que o sistema **consegue filtrar e retornar todas as transações associadas a uma conta específica**, verificando a recuperação por relacionamento. |
+| `test_get_transaction_by_id_success` | **Consultar Transação por ID** (Cenário de Sucesso) | Valida que o sistema **recupera os detalhes de uma transação específica** quando um ID válido é fornecido, confirmando a exatidão das informações. |
+| `test_get_transaction_by_id_not_found` | **Consultar Transação por ID** (Cenário de Não Encontrada) | Verifica que o sistema **lida adequadamente com requisições para IDs de transações inexistentes**, retornando uma resposta que indica que a transação não foi encontrada. |
+| `test_get_invoice_by_account_id_empty` | **Gerar Fatura por Conta** (Cenário de Nenhuma Transação) | Testa se o sistema **retorna uma fatura vazia ou sem itens** quando uma conta válida é fornecida, mas não há transações associadas para faturar. |
+| `test_get_invoice_by_account_id_with_transactions` | **Gerar Fatura por Conta** (Cenário com Transações) | Confirma que o sistema **gera corretamente uma fatura contendo as transações associadas a uma conta específica**, agregando os dados de forma esperada. |
+| `test_cancel_transaction_subscription_success` | **Cancelar Assinatura de Transação** (Cenário de Sucesso) | Garante que o sistema **consegue cancelar uma transação de assinatura com sucesso**, alterando seu status e/ou desativando-a conforme o esperado. |
+| `test_cancel_transaction_subscription_no_detail` | **Cancelar Assinatura de Transação** (Cenário Sem Detalhe) | Testa o comportamento do sistema ao **tentar cancelar uma assinatura de transação sem detalhes específicos** (por exemplo, ID da assinatura ausente ou inválido), esperando que um erro apropriado seja retornado. |
+
+---
+
+### Módulo: UserRole
+
+| Teste | Caso de Uso Validado | Descrição Detalhada do Caso de Uso |
+| :------------------------------------------------ | :------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `test_create_user_success` | **Criar Usuário** (Cenário de Sucesso) | Garante que o sistema consegue **criar um novo usuário** com informações válidas e completas, e que o usuário é devidamente persistido e se torna acessível. |
+| `test_create_user_with_existent_indentifying_code` | **Criar Usuário** (Cenário de Código Identificador Existente) | Confirma que o sistema **impede a criação de um usuário** se o código identificador (CPF, e-mail, etc.) já estiver em uso, garantindo a unicidade e retornando um erro apropriado. |
+| `test_get_users_success` | **Listar Usuários** (Cenário de Sucesso) | Verifica se o sistema **retorna corretamente uma lista completa de todos os usuários** cadastrados. |
+| `test_get_users_by_account_success` | **Listar Usuários por Conta** (Cenário de Sucesso) | Assegura que o sistema **consegue filtrar e retornar os usuários vinculados a uma conta específica**, validando a busca por relacionamento com a conta. |
+| `test_get_user_by_email_success` | **Consultar Usuário por E-mail** (Cenário de Sucesso) | Confirma que o sistema **recupera os detalhes de um usuário específico** quando um e-mail válido é fornecido, verificando a exatidão das informações. |
+| `test_get_user_by_email_not_found` | **Consultar Usuário por E-mail** (Cenário de Não Encontrado) | Garante que o sistema **lida adequadamente com requisições para e-mails de usuários inexistentes**, retornando uma resposta que indica que o usuário não foi encontrado. |
+| `test_update_user_success` | **Atualizar Usuário** (Cenário de Sucesso) | Valida que os **dados de um usuário existente podem ser modificados** e que essas alterações são salvas e refletidas no sistema. |
+| `test_update_user_user_not_found` | **Atualizar Usuário** (Cenário de Não Encontrado) | Assegura que o sistema **não permite a atualização de um usuário que não existe**, e que uma resposta de "não encontrado" ou erro apropriado é retornada. |
+| `test_delete_user_success` | **Excluir Usuário** (Cenário de Sucesso) | Confirma que um **usuário pode ser removido com sucesso** do sistema e que ele não é mais acessível após a exclusão. |
+| `test_delete_user_not_found` | **Excluir Usuário** (Cenário de Não Encontrado) | Verifica se o sistema **lida corretamente com tentativas de exclusão de usuários que não existem**, retornando uma indicação clara de que o registro não pôde ser encontrado para exclusão. |
+| `test_delete_user_auth0_error` | **Excluir Usuário** (Cenário de Erro no Auth0) | Testa o comportamento do sistema quando ocorre uma **falha na integração com o serviço de autenticação (Auth0)** durante a exclusão de um usuário, garantindo que o erro seja tratado e propagado adequadamente. |
+| `test_create_external_user_auth0_error` | **Criar Usuário Externo** (Cenário de Erro no Auth0) | Verifica como o sistema **reage quando a criação de um usuário externo (no Auth0)** falha, garantindo que a operação seja abortada corretamente e um erro apropriado seja retornado, sem criar um usuário inconsistente. |
+
+---