![Logo](https://raw.githubusercontent.com/mrlldd/DayzMapsLoader/master/images/repository-logo.png)
Select your map, and create good stuff!
Explore the docs »
View Demo
·
Report Bug
·
Request Feature
Table of Contents
This Github pet project is an application built with Domain-Driven Design (DDD) architecture and modern development patterns. It has a server component built using ASP.NET Core and a client component built using React.
The main purpose of this project is to allow users to download maps for the game DayZ from two different map providers: Ginfo and Xam. The downloaded maps are of high quality and can be used to create posters, cups, or other stuff.
This repository is also a small personal library of knowledge.
The concept of a Clean Architecture pattern has been around for over a decade and was initially conceived by Robert Martin. The keyword from Uncle Bob is Interchangeable. In the image below, everything on the blue circle is interchangeable, e.g., the UI can be swapped out from React to Angular, or the database can be migrated from MSSQL to Oracle, and nothing in the underlying layers needs to change.
The concept of having all your interfaces (Infrastructure and Application) in one project, will make it easier to Unit Test and mock.
Domain layer
I used Anemic Domain Model. Is used in DDD when the main focus is on data persistence and because in this project there's not much need for complex business logic.A Rich Domain Model is preferred when complex business logic needs to be encapsulated within the entities.
Application layer
Public components
Internal components
Infrastructure layer
Public components
Presentation layer
Public components
Internal components
This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.
This is an example of how to list things you need to use the software and how to install them.
- npm
npm install npm@latest -g
- Dotnet ef
dotnet tool install --global dotnet-ef
- Clone the repo
git clone https://github.com/SaintZet/DayzMapsLoader.git
- Install NPM packages
npm install
- Add a appsettings.json with connection string to DayzMapsLoader.Presentation.WebApi
"ConnectionStrings": { "DefaultConnection": "Server = YourServer; DataBase=DayzMapLoader; User id= YourUserID; password= YourPassword; Integrated Security=True; TrustServerCertificate=True;" }
- At this point you can have EF create database and create schema from the migration .NET CLI:
dotnet ef database update
At the moment you can install the latest version of the product to start the server and get all the necessary maps. You know what to do with them.
You can create a fork and expand the repository, for example
- create a desktop client
- change image processing algorithms
- add functionality that is useful to you
- other
Take some techniques and approaches to your projects.
And of course - to contribute to the development of the project, help with existing issues or create a new one, improve the algorithm, or change something else!
- Provide archive(web) and byte array(desktop) with
- selected map
- selected map in parts
- all maps by specific provider
- Options for select a map
- provider (GInfo e.g.)
- name (Chernarus e.g)
- type
- satellite
- topographic
- tourist
- zoom level
- version
- image quality
- image extension
- Client application (in the process)
- Hosting server and client
- Improve performance - store images on the server and just download them when changed something (e.g version map).
See the open issues for a full list of proposed features (and known issues).
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!
- Fork the Project
- Create your Feature Branch (
git checkout -b feature/AmazingFeature
) - Commit your Changes (
git commit -m 'Add some AmazingFeature'
) - Push to the Branch (
git push origin feature/AmazingFeature
) - Open a Pull Request
Distributed under the MIT License. See LICENSE.txt
for more information.
Chepets Serhii - @LinkedIn - chepets9685@gmail.com
Yaroslav Tymchenko -@LinkedIn - ytimchenko57@gmail.com
Domain Driven Design
- https://www.codeproject.com/Articles/5351235/Clean-Architecture-Incorporating-Repository-Patter
- https://dev.to/stevescruz/domain-driven-design-ddd-file-structure-4pja
- https://thedomaindrivendesign.io/anemic-model-x-rich-model/
- https://medium.com/software-alchemy/a-brief-intro-to-clean-architecture-clean-ddd-and-cqrs-23243c3f31b3
- https://medium.com/software-alchemy/a-template-for-clean-domain-driven-design-architecture-e386ad235f32
Unit Of Work and Repository patterns
- https://www.programmingwithwolfgang.com/repository-pattern-net-core/
- https://dotnettutorials.net/lesson/repository-design-pattern-csharp/
- https://exceptionnotfound.net/the-repository-service-pattern-with-dependency-injection-and-asp-net-core/
- https://mentormate.com/blog/service-and-repository-layer-interaction-in-c/
- https://gunnarpeipman.com/ef-core-repository-unit-of-work/
Cqrs and MediatR patterns
- https://codeopinion.com/should-you-use-the-repository-pattern-with-cqrs-yes-and-no/
- https://abdelmajid-baco.medium.com/cqrs-pattern-with-c-a9aff05aae3f
- https://code-maze.com/cqrs-mediatr-in-aspnet-core/
- https://www.puresourcecode.com/dotnet/introducing-cqrs-in-the-architecture/
- https://medium.com/@dbottiau/a-naive-introduction-to-cqrs-in-c-9d0d99cd2d54
- https://learn.microsoft.com/en-us/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/microservice-application-layer-implementation-web-api
- https://learn.microsoft.com/en-us/dotnet/architecture/microservices/microservice-ddd-cqrs-patterns/cqrs-microservice-reads