Minesweeper API

Fully functional Minesweeper Web API

Minesweeper API is a cloud-enabled, mobile-ready, C# & Angular.io-powered application.

Features

• This minesweeper implementation can be fully played using only it's web api endpoints.
• Web app client presented is just an example of it's implementation.
• Secured using simple bearer tokens.
• Backend designed using DDD architecture.

Dependencies

Minesweeper-API uses a number of open-source projects to work properly:

• ASP.NET CORE - v5.0
• Angular.io - v11.0.5
• Automapper - v10.1.1
• MongoDb - v2.11.5
• Fluent Validator - v9.3.0
• Moq - v4.15.1

And of course Minesweeper-API itself is open source with a public repository on GitHub.

Technical decisions

• MongoDb was selected for this project due to its simple and efficient way to store complex objects like th eones used in the project
• There are 4 main folders for this solution
  1. CC.Minesweeper.Core: Contains all the game and security logic
  2. CC.Minesweeper.Infrastructure: Contains the infrastructure needed by the core project and specific implementations
  3. CC.Minesweeper.Api: Contains the web api layer to expose the app available methods
  4. CC.Minesweeper.Tests: Contains all unit tests for this solution
• There is one folder named CC.Minesweeper.Web, that contains the angular.io web application
• There is one folder named SolutionItems that contains the postman tests for integration test of the web API

Documentation

You can visit the swagger endpoint containing the methods and resources required to call the endpoints here

1. Register a user using /api/users/register

• Email and password are required.

2. Get a security token using /api/token

• Token format is "bearer {{token}}" and must be included in the "Authorization" header.

3. Create a new game /api/games/new

• 3.1 It must contain rows, columns, and number of mines, the bigger the grid the longer it will take to process later.

4. You can reveal a cell by requesting /api/games/{id}/reveal

• 4.1 x and y values are required.

6. You can flag and un-flag a cell by calling /api/games/{id}/switch-flag
7. Finally, you can delete a game by calling /api/games/{id}

You can test the web api client here

Requirements for this app

• Be sure to complete all the features
• Use C# as the main language
• The time for solving the challenge ideally is one week BUT we need your best on the solution so you are allowed to take extra time if you need so.
• Add tests
• Add good documentation
• UI is not mandatory but adds extra value to the solution.
• The repository should be PUBLIC and you should send a URL with the solution on this thread.
• Design and implement a documented RESTful API for the game (think of a mobile app for your API)
• Implement an API client library for the API designed above. Ideally, in a different language, of your preference, to the one used for the API
• When a cell with no adjacent mines is revealed, all adjacent squares will be revealed (and repeat)
• Ability to 'flag' a cell with a question mark or red flag
• Detect when game is over
• Persistence
• Time tracking
• Ability to start a new game and preserve/resume the old ones
• Ability to select the game parameters: number of rows, columns, and mines
• Ability to support multiple users/accounts
• URL where the game can be accessed and played (use any platform of your preference: heroku.com, aws.amazon.com, etc)
• Code in a public Github repo
• README file with the decisions taken and important notes

And that's it, have fun!!