HKR

Project Human Key: Reborn

---

Summary

Project human Key: Reborn is a web-based game currently in development.

Google Drive Folder for documents

So far, the team is composed of 4 developers working on their spare time.

• BAL-FONTAINE Fabien
• CAILLOT Tim
• DUPONT Florent
• ROS Quentin

Back-End

The back-end is a REST API developed with ASP.NET Core 2.0.

Documentation on RESTful urls and verbs

Technologies used

• C# as the language used.
• Database access is done through Entity Framework Core.
• The back-end uses Dependency Injection with StructureMap coupled to the basic .NET Core one.
• Automapper for entity to dto conversion

Web Front-End

Front-end will send calls to the REST API via ajax to process the game informations.

Technologies used

• TypeScript as the language because basic Javascript sucks.
• React (Or angular?) for navigation on the website.
• BabylonJS for WebGL views of the game.

Installation

• Install the latest VS2017

• You need the packages for Web Development and Development in .NET Core

• Optional : Install Productivity Power Tools and Web Essentials 2017

• Clone the project in a folder with

HTTPS: git git clone https://github.com/Marsonge/HKR.git

Or SSH: git git clone git@github.com:Marsonge/HKR.git

• Import the solution file HKR.sln in Visual Studio 2017

CTRL+F5 to launch the application without debug.

F5 to launch the application in debug mode.

Architecture

The project is divided in multiple projects to keep it clean.

A really cool PDF guide explaining the basic concepts that we will try to respect

HKRCore

The Domain/Core of the application.

• Model
• Services interfaces and implementation
• Domain Exceptions
• DTOs and Automapper configuration
• Database context EF Core

Services call entities methods, call HKRContext and transform the result into DTOs

We want to have as much business methods in the entities as possible, we don't want an anemic model.

HKRWebServices

The entry point of the back-end.

Here we have Rest Controllers which will make calls to Services.

This is also in this project that starts the application.

We make use of the Dependency Injection to inject services into the controllers.

We use StructureMap to have a better IoC/DI container

HKRWebProject

Doesn't exist at the moment.

Uuuuh... No se, porque no hablo javascripto por el momento. But Typescript is normally well integrated in Visual Studio as long as Node and npm.