https://github.com/fsmaiorano/dotnet-pokemon
:notebook: This is a full stack project to show how to use clean architecture and CQRS pattern.
https://github.com/fsmaiorano/dotnet-pokemon
angular automapper clean-architecture csharp docker-compose entity-framework in-memory-database postgresql unittest
Last synced: about 2 months ago
JSON representation
:notebook: This is a full stack project to show how to use clean architecture and CQRS pattern.
- Host: GitHub
- URL: https://github.com/fsmaiorano/dotnet-pokemon
- Owner: fsmaiorano
- Created: 2023-10-16T15:22:54.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-01-13T14:21:45.000Z (over 2 years ago)
- Last Synced: 2025-11-09T07:15:19.584Z (8 months ago)
- Topics: angular, automapper, clean-architecture, csharp, docker-compose, entity-framework, in-memory-database, postgresql, unittest
- Language: C#
- Homepage:
- Size: 588 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Motivation
This project is a minimal api application using clean architecture and CQRS pattern, that allows get pokemons from [PokeApi](https://pokeapi.co/) and save in a database.
The WebUI renders a grid with the pokemons using infinite scroll. The user can click on a pokemon to see more details.
## Architecture
Clean architecture is used to separate the application into layers. The layers are as follows: application, domain, and infrastructure. The application layer contains use-cases and all core implementations. The domain layer contains the business logic and
models. The infrastructure layer contains the database context and migrations.
The implementation between the Api and the rest of the application is built with CQRS (Command and Query Responsibility Segregation), a pattern that separates read and update operations for a data store.
## Technologies Used
- C#
- NET 8
- Entity Framework Core with InMemory Database
- MediatR
- AutoMapper
- Docker Compose
- Swagger
- Firestore
- Angular 17
## How to run
### Requirements
- NET 8
- Docker
- EF CLI - dotnet tool install --global dotnet-ef
### Steps
1. Clone this repository
2. Run the command `docker-compose up` in the root folder
3. Go to Infrastructure folder and run the command `dotnet ef database update` to create the database
4. Open the browser and go to `http://localhost:port/swagger/index.html` to see the swagger documentation
5. Use the endpoints to get pokemons from [PokeApi](https://pokeapi.co/) and save in a database
### Seed
1. Execute Seed endpoint to get pokemons from [PokeApi](https://pokeapi.co/) and save in a database
## Endpoints
- See client.http file in the root folder
## Tests
- Run the command `dotnet test` in the root folder
### To-do
- [ ] Implement cache to improve performance - get all pokemons
- [x] Implement pagination
- [ ] Implement unit tests
- [x] Implement integration tests
- [x] Implement docker
- [x] Implement swagger
- [ ] Implement logging with serilog
- [x] Implement error handling