{"id":21842944,"url":"https://github.com/hazeliscoding/clean-todo-api","last_synced_at":"2025-10-08T08:31:36.090Z","repository":{"id":193528893,"uuid":"688943342","full_name":"hazeliscoding/clean-todo-api","owner":"hazeliscoding","description":"An example of a Clean Architecture approach in an ASP.NET Core Web API project, leveraging Dapper as the ORM and MySQL as the database.","archived":false,"fork":false,"pushed_at":"2023-09-11T20:04:23.000Z","size":43,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-20T21:09:10.771Z","etag":null,"topics":["cqrs","domain-driven-design","mediatr","mysql"],"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/hazeliscoding.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,"governance":null}},"created_at":"2023-09-08T12:39:05.000Z","updated_at":"2024-10-07T03:34:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"fce527d9-6aa5-4d82-b9c8-b7578ff0a8a7","html_url":"https://github.com/hazeliscoding/clean-todo-api","commit_stats":null,"previous_names":["nekomata97/clean-architecture-demo","nekomatadev/clean-architecture-demo","spherehunteryrp/clean-architecture-demo","ducksoop/clean-architecture-demo","hazeliscoding/clean-architecture-demo","hazeliscoding/clean-todo-api"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hazeliscoding%2Fclean-todo-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hazeliscoding%2Fclean-todo-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hazeliscoding%2Fclean-todo-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hazeliscoding%2Fclean-todo-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hazeliscoding","download_url":"https://codeload.github.com/hazeliscoding/clean-todo-api/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235697157,"owners_count":19031307,"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":["cqrs","domain-driven-design","mediatr","mysql"],"created_at":"2024-11-27T22:13:48.999Z","updated_at":"2025-10-08T08:31:35.752Z","avatar_url":"https://github.com/hazeliscoding.png","language":"C#","readme":"# Clean Architecture with ASP.NET Core, Dapper, and MySQL\nA simple Todo App API used as an example of a Clean Architecture approach in an ASP.NET Core, leveraging Dapper as the ORM and MySQL as the database.\n\n## 🚀 Features\n* **Clean Architecture**: Clear separation of concerns with four main layers: API, Application, Domain, and Infrastructure.\n* **Dapper ORM**: Flexible and fast micro ORM.\n* **MySQL**: Robust open-source relational database.\n* **CQRS with MediatR**: Command Query Responsibility Segregation to clearly differentiate read and write actions.\n* **Docker-Compose**: Easily containerize the application for consistent development and deployment experiences.\n\n## 📚 Project Structure\n* **API Layer**: Entry point of the application. Contains the ASP.NET Core Web API setup, controllers, and DI configuration.\n* **Application Layer**: Houses the application's business logic, DTOs, interfaces, and application-specific services. Contains MediatR commands and queries.\n* **Domain Layer**: Core layer of the project. Contains all the domain entities, value objects, domain events, and domain services.\n* **Infrastructure Layer**: Deals with the external concerns, data access, and other integrations. Contains the Dapper ORM configurations and repository implementations.\n\n## 🐋 Docker-Compose\nThis project includes a `docker-compose.yml file` to help you containerize your application. This simplifies setup, especially for contributors who want to run the project without manually configuring external dependencies like MySQL.\n\n### Running with Docker\nEnsure you have Docker and Docker-Compose installed. Then:\n\n```\ndocker-compose up --build\n```\n\nThis will build the required images and start the containers. Once running, you can access the API typically at `http://localhost:\u003cport\u003e`.\n\n## 🌱 Getting Started\n1. Clone this repository:\n```\ngit clone https://github.com/nekomatadev/clean-architecture-demo.git\n```  \n2. Navigate to the project directory:\n```\ncd path-to-project-directory\n```\n3. Use Docker-Compose to run the application:\n```\ndocker-compose up --build\n```\n\n## 📜 License\n[MIT](https://choosealicense.com/licenses/mit/)\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhazeliscoding%2Fclean-todo-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhazeliscoding%2Fclean-todo-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhazeliscoding%2Fclean-todo-api/lists"}