Testes

This is an old version of this page. You can view the most recent version or browse the history.

Documentação de Testes: Mapeamento de Casos de Uso

Esta documentação lista os testes automatizados e os casos de uso de negócio correspondentes que cada um valida. Isso facilita a compreensão da cobertura dos testes e a rastreabilidade entre o código e os requisitos funcionais.

Módulo: Account

Teste	Caso de Uso Validado	Descrição Detalhada do Caso de Uso
`test_create_account_success`	Criar Conta (Cenário de Sucesso)	Garante que o sistema consegue criar uma nova conta quando todos os dados fornecidos são válidos e completos. Verifica se a conta é persistida e acessível após a criação.
`test_create_account_already_exists`	Criar Conta (Cenário de Duplicidade)	Confirma que o sistema impede a criação de uma conta se um identificador único (como slug ou ID) já estiver em uso. Espera-se que uma mensagem de erro apropriada seja retornada.
`test_create_account_without_identifying_code`	Criar Conta (Cenário de Dados Incompletos)	Assegura que o sistema não permite a criação de uma conta caso o campo de código identificador obrigatório (seja ele um slug, um código específico, etc.) esteja ausente ou seja inválido.
`test_get_accounts_success`	Listar Contas (Cenário de Sucesso)	Verifica se o sistema retorna corretamente uma lista de todas as contas cadastradas. Este teste valida a funcionalidade de consulta geral.
`test_get_account_by_id_success`	Consultar Conta por ID (Cenário de Sucesso)	Confirma que o sistema consegue recuperar os detalhes de uma conta específica quando um ID válido é fornecido, garantindo que os dados retornados estão corretos.
`test_get_account_by_id_not_found`	Consultar Conta por ID (Cenário de Não Encontrado)	Garante que o sistema lida adequadamente com requisições para IDs de contas inexistentes, retornando uma resposta que indica que a conta não foi encontrada, sem expor dados sensíveis ou causar falhas.
`test_update_account_success`	Atualizar Conta (Cenário de Sucesso)	Valida que os dados de uma conta 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_account_not_found`	Atualizar Conta (Cenário de Não Encontrado)	Assegura que o sistema não permite a atualização de uma conta que não existe, e que uma resposta de "não encontrado" ou erro apropriado é retornada.
`test_update_account_slug_already_exists`	Atualizar Conta (Cenário de Slug Duplicado)	Testa se o sistema impede que o slug (ou outro identificador único) de uma conta seja atualizado para um valor que já pertence a outra conta, mantendo a integridade dos identificadores.
`test_delete_account_not_found`	Excluir Conta (Cenário de Não Encontrado)	Verifica se o sistema lida corretamente com tentativas de exclusão de contas que não existem, retornando uma indicação clara de que a conta não pôde ser encontrada para exclusão.
`test_delete_account_success`	Excluir Conta (Cenário de Sucesso)	Confirma que uma conta pode ser removida com sucesso do sistema e que ela não é mais acessível após a exclusão.

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.