{"id":21530685,"url":"https://github.com/migueldemacedo/BarberBoss","last_synced_at":"2025-10-05T12:31:07.562Z","repository":{"id":263645995,"uuid":"887163455","full_name":"miguelmilagres/BarberBoss","owner":"miguelmilagres","description":"API em .NET 8 para gerenciamento de serviços de barbearia com DDD, testes unitários, e relatórios em PDF/Excel. Armazena dados via MySQL.","archived":false,"fork":false,"pushed_at":"2024-11-19T20:38:09.000Z","size":479,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-11-19T21:30:28.552Z","etag":null,"topics":["csharp","ddd","dotnet","mysql","swagger"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/miguelmilagres.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-12T09:22:54.000Z","updated_at":"2024-11-19T20:38:13.000Z","dependencies_parsed_at":"2024-11-19T21:30:43.683Z","dependency_job_id":null,"html_url":"https://github.com/miguelmilagres/BarberBoss","commit_stats":null,"previous_names":["miguelmilagres/desafio-pratico-barber-boss","miguelmilagres/barberboss"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miguelmilagres%2FBarberBoss","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miguelmilagres%2FBarberBoss/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miguelmilagres%2FBarberBoss/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/miguelmilagres%2FBarberBoss/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/miguelmilagres","download_url":"https://codeload.github.com/miguelmilagres/BarberBoss/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235395143,"owners_count":18983096,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","ddd","dotnet","mysql","swagger"],"created_at":"2024-11-24T02:09:46.661Z","updated_at":"2025-10-05T12:31:02.148Z","avatar_url":"https://github.com/miguelmilagres.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Sobre o projeto ##\n\nEsta **API**, desenvolvida utilizando **.NET 8**, adota os princípios do **Domain-Driven Design (DDD)** para oferecer uma solução estruturada e eficaz no gerenciamento de serviços de barbearia. O principal objetivo é permitir que os profissionais registrem seus serviços, detalhando informações como título, data e hora, comentário, valor e tipo de pagamento, com os dados sendo armazenados de forma segura em um banco de dados **MySQL**.\n\nA arquitetura da **API** baseia-se em **REST**, utilizando métodos **HTTP** padrão para uma comunicação eficiente e simplificada. Além disso, é complementada por uma documentação **Swagger**, que proporciona uma interface gráfica interativa para que os desenvolvedores possam explorar e testar os endpoints de maneira fácil.\n\nDentre os pacotes NuGet utilizados, o **AutoMapper** é o responsável pelo mapeamento entre objetos de domínio e requisição/resposta, reduzindo a necessidade de código repetitivo e manual. O **FluentAssertions** é utilizado nos testes de unidade para tornar as verificações mais legíveis, ajudando a escrever testes claros e compreensíveis. Para as validações, o **FluentValidation** é usado para implementar regras de validação de forma simples e intuitiva nas classes de requisições, mantendo o código limpo e fácil de manter. Por fim, o **EntityFramework** atua como um **ORM (Object-Relational Mapper)** que simplifica as interações com o banco de dados, permitindo o uso de objetos **.NET** para manipular dados diretamente, sem a necessidade de lidar com consultas **SQL**.\n\n![hero-image]\n\n### Features\n\n- **Domain-Driven Design (DDD):** Estrutura modular que facilita o entendimento e a manutenção do domínio da aplicação.\n- **Testes de Unidade:** Testes abrangentes com **FluentAssertions** para garantir a funcionalidade e a qualidade.\n- **Geração de Relatórios:** Capacidade de exportar relatórios detalhados para **PDF** e **Excel**, oferecendo uma análise visual e eficaz dos lucros.\n- **RESTful API com Documentação Swagger:** Interface documentada que facilita a integração e o teste por parte dos desenvolvedores.\n\n### Construído com\n![windows-badge]\n![visual-studio-badge]\n![dot-net-badge]\n![mysql-badge]\n![swagger-badge]\n\n## Getting Started\nPara obter uma cópia local funcionando, siga estes passos simples.\n\n### Requisitos\n* [Visual Studio versão 2022+][visual-studio] ou [Visual Studio Code][visual-studio]\n* Windows 10+ ou Linux/MacOS com [.NET SDK][dot-net-sdk] instalado\n* [MySql Server][mysql]\n\n### Instalação\n1. Clone o repositório:\n```sh\n    git clone https://github.com/miguelmilagres/BarberBoss.git\n```\n2. Preencha as informações no arquivo `appsettings.Development.json`.\n\n3. Execute a API e aproveite o seu teste.\n\n\u003c!-- Links --\u003e\n[visual-studio]: https://visualstudio.microsoft.com/pt-br/downloads/\n[dot-net-sdk]: https://dotnet.microsoft.com/en-us/download/dotnet/8.0\n[mysql]: https://dev.mysql.com/downloads/installer/\n\n\u003c!-- Images --\u003e\n[hero-image]: images/hero-image.png\n\n\u003c!-- Badges --\u003e\n[windows-badge]: https://img.shields.io/badge/Windows-blue?style=for-the-badge\n[visual-studio-badge]: https://img.shields.io/badge/Visual%20Studio-purple?style=for-the-badge\n[dot-net-badge]: https://img.shields.io/badge/.NET-512BD4?logo=dotnet\u0026logoColor=fff\u0026style=for-the-badge\n[mysql-badge]: https://img.shields.io/badge/MySQL-4479A1?logo=mysql\u0026logoColor=fff\u0026style=for-the-badge\n[swagger-badge]: https://img.shields.io/badge/Swagger-85EA2D?logo=swagger\u0026logoColor=000\u0026style=for-the-badge\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmigueldemacedo%2FBarberBoss","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmigueldemacedo%2FBarberBoss","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmigueldemacedo%2FBarberBoss/lists"}