{"id":24731294,"url":"https://github.com/diegomaiasantos/api-catalogo-produto","last_synced_at":"2026-04-20T10:02:39.347Z","repository":{"id":61047711,"uuid":"539969061","full_name":"DiegoMaiaSantos/api-catalogo-produto","owner":"DiegoMaiaSantos","description":"Nesse projeto, estou desenvolvendo uma API que tem como principal função realizar um CRUD nas categorias e produtos de um estabelecimento.","archived":false,"fork":false,"pushed_at":"2022-11-01T20:00:48.000Z","size":86,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-22T15:49:12.469Z","etag":null,"topics":["csharp","dotnet","entity-framework","git","sql-server","swagger","visual-studio"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DiegoMaiaSantos.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-09-22T12:25:23.000Z","updated_at":"2023-06-15T17:10:03.000Z","dependencies_parsed_at":"2022-10-09T05:18:58.667Z","dependency_job_id":null,"html_url":"https://github.com/DiegoMaiaSantos/api-catalogo-produto","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/DiegoMaiaSantos/api-catalogo-produto","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DiegoMaiaSantos%2Fapi-catalogo-produto","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DiegoMaiaSantos%2Fapi-catalogo-produto/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DiegoMaiaSantos%2Fapi-catalogo-produto/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DiegoMaiaSantos%2Fapi-catalogo-produto/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DiegoMaiaSantos","download_url":"https://codeload.github.com/DiegoMaiaSantos/api-catalogo-produto/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DiegoMaiaSantos%2Fapi-catalogo-produto/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32042293,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-20T00:18:06.643Z","status":"online","status_checked_at":"2026-04-20T02:00:06.527Z","response_time":94,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["csharp","dotnet","entity-framework","git","sql-server","swagger","visual-studio"],"created_at":"2025-01-27T16:12:38.790Z","updated_at":"2026-04-20T10:02:39.327Z","avatar_url":"https://github.com/DiegoMaiaSantos.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003ch1 align=\"center\"\u003eAPI Catalogo Produto\u003c/h1\u003e\n\n[![GitHub license](https://img.shields.io/github/license/DiegoMaiaSantos/api-catalogo-produto)](https://github.com/DiegoMaiaSantos/api-catalogo-produto/blob/main/LICENSE)\n\n\u003cp\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp; \nEsse projeto tem como principal objetivo, desenvolver meus conhecimentos adquiridos diariamente no estágio, então peguei uma ideia simples e utilizei grande parte da experiência que tenho tido, para fixar melhor os estudos e as rotinas diárias de um programador.\n \u003c/p\u003e\n\u003cp\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\nInicialmente planejava utilizar a abordagem code first, usando migrations do Entity framework para criar o banco de dados e suas tabelas, de maneira quase que automática, mas como queria ampliar o conhecimento na abordagem de mapeamentos com o banco sendo criado manualmente no SQL Server, fiz o banco CatalogoDB e suas tabelas, sendo CATEGORIA E PRODUTO, fiz o desenho do relacionamento das entidades \u003cstrong\u003e(desenho está logo abaixo)\u003c/strong\u003e e passo detalhes sobre informações de cada coluna, também criei a FOREIGN KEY (PK_PRODUTO_CATEGORIA) para trabalhar as trocas de informações entre as tabelas. \u003cstrong\u003eCaso tenha interesse em clonar a API, é necessário criar o mesmo banco na sua máquina, lembrando que a configuração é toda realizada para SQL Server.\u003c/strong\u003e\n \u003c/p\u003e\n\u003cp\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\nEssa API \u003cstrong\u003e(Application Programming Interface)\u003c/strong\u003e serve como um intermediário de um software que vai permitir que dois aplicativos possam se comunicar. Eu fiz apenas o backend, mas se o caso fosse outro, onde tivesse desenvolvido a aplicação e a interface, front e back, essa API iria receber as requisições de uma interface e dentro de toda a aplicação, ela iria percorrer os controllers que iria buscar na services, as regras do negócio, praticamente é onde fica a maior parte da lógica e depois iria nos repository, que é onde acontece a troca de informações da aplicação com o banco de dados, e assim ela retorna fazendo o inverso do que foi caminhado até chegar novamente nas controllers e repassar a informação requisitada pela interface. No caso da minha API, é possível buscar uma lista, buscar pelo id, criar, atualizar ou deletar, seja uma categoria ou um produto, mais conhecido como um CRUD.\n \u003c/p\u003e\n\u003cp\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\nUsei o modelo de arquitetura DDD \u003cstrong\u003e(Domain Driven Design)\u003c/strong\u003e para manter a organização e manutenção dos processos da API. Esse modelo tem como característica facilitar a implementação de regras e processos complexos, onde trás a divisão das responsabilidades por camadas, e pode ser usado por qualquer tecnologia. \u003cstrong\u003e(desenho está logo abaixo)\u003c/strong\u003e\n \u003c/p\u003e\n\u003cp\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\nFoi implementado Health Checks para acompanhar a saúde da API, ele é um middleware que fornece um endpoint que vai nos trazer a situação da aplicação, é uma forma de dizer que a aplicação está saudável ou não para uma solicitação web. Em conjunto implementei o serilog, pois tinha planos de realizar acompanhamento de loggin da aplicação.\n \u003c/p\u003e\n\u003cp\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\nRealizei uma mesclagem entre as versões 5 e 6 do .Net para configurar as classes program.cs e startup.cs, assim me dando a oportunidade de trabalhar com mais camadas de segurança nas conexões do banco de dados. \n \u003c/p\u003e\n\u003cp\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\nPara documentar a aplicação usei o framework Swagger, que oferece muitas ferramentas, ajuda na descrição, no consumo e na visualização dos serviços. Também pode ser usado com qualquer linguagem de programação.\n \u003c/p\u003e\n\u003cp\u003e\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\nOs commits e as Branchs foram feitos seguindo regras para manter uma boa organização e utilizando o Git Bash.\n \u003c/p\u003e \n\n\u003cbr\u003e\n\n \u003cp align=\"center\"\u003e\n\u003cimg src=\"http://img.shields.io/static/v1?label=STATUS\u0026message=%20FINALIZADO\u0026color=YELLOW\u0026style=for-the-badge\"/\u003e\n\u003c/p\u003e\n\n***\n## 🖨️ Como clonar o projeto: \n```\n  # Clone o repositório\n  git clone https://github.com/DiegoMaiaSantos/api-catalogo-produto.git\n  \n  ```\n***\n## 📷 Arquitetura do projeto: \n\u003cp align =\"center\"\u003e\n \u003cimg src =\"https://github.com/DiegoMaiaSantos/imagens-projetos-variados/blob/main/api-catalogo-produto-readme/arquitetura-ddd.jpg\" width =\"\"/\u003e\n \u003c/p\u003e\n\n***\n## 📷 Relacionamento de entidades: \n\u003cp align =\"center\"\u003e\n \u003cimg src =\"https://github.com/DiegoMaiaSantos/imagens-projetos-variados/blob/main/api-catalogo-produto-readme/ApiCatalogo_Diagrama.png?raw=true\" width =\"\"/\u003e\n \u003c/p\u003e\n\n***\n## 📷 Imagens do projeto: \n\u003cp align =\"center\"\u003e\n \u003cimg src =\"https://github.com/DiegoMaiaSantos/imagens-projetos-variados/blob/main/api-catalogo-produto-readme/swagger-apicatalogo-01.png\" width =\"\"/\u003e\n \u003c/p\u003e\n \n \u003cp align =\"center\"\u003e\n \u003cimg src =\"https://github.com/DiegoMaiaSantos/imagens-projetos-variados/blob/main/api-catalogo-produto-readme/swagger-apicatalogo-02.png\" width =\"\"/\u003e\n \u003c/p\u003e   \n\n***\n## ☑️ Tecnologias e Ferramentas: \n* [.Net 6.0](https://learn.microsoft.com/pt-br/dotnet/core/whats-new/dotnet-6)\n* [Swagger](https://swagger.io/)\n* [Entity Framework](https://learn.microsoft.com/pt-br/ef/)\n* [SQL Server Managent](https://learn.microsoft.com/pt-br/sql/ssms/sql-server-management-studio-ssms?view=sql-server-ver16)\n* [Visual Studio Community](https://visualstudio.microsoft.com/vs/community/)\n* [Git Bash](https://git-scm.com/doc)\n***\n## 💻 Autor:\n_Diego Maia Santos_ \n\u003cdiv\u003e \n  \u003ca href = \"mailto:diegom.santos03@gmail.com\"\u003e\u003cimg src=\"https://img.shields.io/badge/-Gmail-%23333?style=for-the-badge\u0026logo=gmail\u0026logoColor=white\" target=\"_blank\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://br.linkedin.com/in/diego-maia-santos-21615b208\" target=\"_blank\"\u003e\u003cimg src=\"https://img.shields.io/badge/-LinkedIn-%230077B5?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white\" target=\"_blank\"\u003e\u003c/a\u003e \n\u003c/div\u003e\n\n***\n## ⚠️ Licença:\nEsse projeto está sob a [licença MIT](https://github.com/DiegoMaiaSantos/api-catalogo-produto/blob/main/LICENSE).\n\n***\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiegomaiasantos%2Fapi-catalogo-produto","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdiegomaiasantos%2Fapi-catalogo-produto","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdiegomaiasantos%2Fapi-catalogo-produto/lists"}