https://github.com/yusufoglu218/mancalagame
Mancala Game Application with SpringBoot and Thymeleaf
https://github.com/yusufoglu218/mancalagame
html java javascript jquery mongodb spring-boot swagger tymeleaf
Last synced: 3 months ago
JSON representation
Mancala Game Application with SpringBoot and Thymeleaf
- Host: GitHub
- URL: https://github.com/yusufoglu218/mancalagame
- Owner: yusufoglu218
- Created: 2022-03-10T10:28:05.000Z (over 4 years ago)
- Default Branch: develop
- Last Pushed: 2022-03-10T10:45:26.000Z (over 4 years ago)
- Last Synced: 2025-06-15T15:55:20.777Z (about 1 year ago)
- Topics: html, java, javascript, jquery, mongodb, spring-boot, swagger, tymeleaf
- Language: Java
- Homepage:
- Size: 90.8 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Mancala Game Application
This project contains traditional mancala game that is played by two player with stones.The application also includes
rest api for game operations which can be used by any other client.
## Technologies
The project includes both frontend and backend.
- `Java 11`
- `Spring Boot` For rest api of the game operations
- `MongoDB`, NoSQL database for persisting the game information
- `Swagger`, Swagger-UI, for API documentation
- `Thymeleaf` Thymeleaf for user interface
- `HTML`,
- `JQuery`
## Installation
Use the maven to build the project for development.
```
mvn clean install
```
## Usage
The application jar can be run standalone with the following command.
```
java -jar mancalagame-0.0.1-SNAPSHOT.jar
```
### Game application
Game is played by selecting one of the (yellow) pits to move.
```
http://localhost:8080
```
### Rest api
There are three rest operations.
* Create a game on start
```
GET http://localhost:8080/mancala/create
```
* Get the existing game with game id
```
GET http://localhost:8080/mancala/get?gameId:{gameId}
```
* Make move with game id and pit id
```
GET http://localhost:8080/mancala/move?gameId:{gameid}&pitId={pidId}
```
### Swagger documentation
Swagger api documentation for detail of the operations.
```
http://localhost:8080/swagger-ui/index.html#
```
## Test
Unit tests can be run by the following maven command.
```
mvn test
```
To check test coverage report, the jacoco report can be generated with the following command.
```
mvn jacoco:report
```