Skip to content

Sistema de cadastro de anúncios com calculadora interna, proposto pelo desafio de programação da Academia Capgemini.

Notifications You must be signed in to change notification settings

vinisnasc/Anuncios

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Gerenciador de Anúncios

Este projeto se origina de um desafio de programação realizado pela Academia Capgemini.
Autor: Vinicius de Souza Nascimento

O objetivo é criar um sistema de cadastro de anúncios com uma calculadora interna onde são realizados os cálculos de valor investido e o alcance de seu objetivo de acordo o investimento, além de retornar relatórios dos anúncios cadastrados com os dados acima mencionados, sendo possível filtrá-los por data e por cliente.

Para isso, criei uma Web API utilizando ASP.NET Core 5 (C#), com as seguintes características:

  • Estrutura do código que visa à separação de responsabilidades e busca evitar repetição.
  • Persistência de Dados fazendo uso do Entity Framework Core (ORM) para realizar o mapeamento para o banco de dados por meio do code-first.
  • Separação em camadas baseada no modelo DDD (domain-driven design), consistindo em Domain (classes e interfaces), Data (camada de infraestrutura responsável pela persistência) e API (camada de aplicação onde ficam os controllers).
  • Documentação dos endpoints da API utilizando o Swagger e comentários XML.

Instruções de Utilização:

Caso tenha o git instalado, é possível clonar este repositório com os seguintes comandos:

$ git clone https://github.com/viniciusnasc/Anuncios.git

Também é possível baixar o conteúdo em formato .zip clicando no botão "Clone" na homepage do repositório.

Certifique-se de ter o .NET Core instalado, caso não tenha, é possível fazer download do .NET Core 5 na página oficial da Microsoft.
Também é preciso estar com o banco de dados instalado, recomendável a versão EXPRESS do SQL Server, disponível gratuitamente na página de download da Microsoft.

A string de conexão com o banco deve ser definida. Vá até o arquivo appsettings.json, que se encontra em Anuncios.API e edite o nome do servidor, incluindo o nome do seu servidor local, segundo o modelo: Server=NomeDoServidorAqui;DataBase=AnunciosCRUD;Trusted_Connection=True

Compilar e executar com CLI do .NET:

A seguir, abra o prompt de comando no diretório do projeto Anuncios.API e digite:

$ dotnet run

Abra o navegador e acesse https://localhost:5001/swagger/index.html

Compilar e executar com Visual Studio:

Abra o diretório do projeto contendo o arquivo Anuncios.sln e clique duas vezes. Isso abrirá a IDE Visual Studio com todos os arquivos pertencentes ao projeto. Aperte a tecla F5 ou então clique no botão com ícone verde contendo o nome Anuncio.API ou IIS Express, na barra de ferramentas. O navegador será automaticamente aberto com o URL https://localhost:5001/swagger/index.html

Utilizando a API:

Com o Swagger aberto, basta interagir com a API. Para cadastrar um novo anúncio (POST), siga o exemplo de request, informando o nome do anúncio, o nome do cliente, data de início e término de pagamento e o valor de investimento diário.
Para exibir os relatórios de todos os anúncios cadastrados, o método GET trará informações completas sobre os anúncios, incluindo os valores aproximados de alcance de visualização, compartilhamento e acesso que os potenciais clientes terão, os quais foram gerados automaticamente pelo algoritmo aritmético no momento de sua inclusão.
Também é possível retornar anúncios pelo identificador (GET por id) e deletar anúncios (DELETE).
Para manter a consistência das projeções, não é possível editar dados de anúncios, por isso, o método PUT não foi incluído.

About

Sistema de cadastro de anúncios com calculadora interna, proposto pelo desafio de programação da Academia Capgemini.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages