## ASP.NET Core MVC Template

### Creating a new project

Go to [the template creation page](https://abp.io/Templates), enter a project name and create your project as shown below:

![bookstore-create--template](images/bookstore-create-template.png)

When you click the *create* button, a new Visual Studio solution is created and downloaded with the name you have provided.

#### Pre Requirements

The downloaded project requires;

* [Visual Studio 2017 (v15.7.0+)](https://visualstudio.microsoft.com/tr/downloads/)
* [.NET Core 2.1.1+](https://www.microsoft.com/net/download/dotnet-core/)

### The Solution Structure

Extract the zip file downloaded and open in **Visual Studio 2017 (15.7.0+)**:

![bookstore-visual-studio-solution](images/bookstore-visual-studio-solution.png)

The solution has a layered structure (based on Domain Driven Design) where;

* ``.Domain`` is the domain layer.
* ``.Application`` is the application layer.
* ``.Web`` is the presentation layer.
* ``.EntityFrameworkCore`` is the EF Core integration package.

The solution also contains unit & integration test projects properly configured to work with **EF Core** & **SQLite in-memory** database.

### Creating the Database

Check the **connection string** in the `appsettings.json` file under the `.Web` project:

````json
{
  "ConnectionStrings": {
    "Default": "Server=localhost;Database=BookStore;Trusted_Connection=True"
  }
}
````

The solution is configured to use **Entity Framework Core** with **MS SQL Server**. EF Core supports [various](https://docs.microsoft.com/en-us/ef/core/providers/) database providers, so you can use another DBMS if you want.

Right click to the `.Web` project and select **Set as StartUp Project**:

![set-as-startup-project](images/set-as-startup-project.png)

Open the **Package Manager Console**, select `.EntityFrameworkCore` project as the **Default Project** and run the `Update-Database` command:

![pcm-update-database](images/pcm-update-database.png)

This will create a new database based on the configured connection string.

### Running the Application

You can now run the application which will open the **home** page:

![bookstore-homepage](images/bookstore-homepage.png)

Click the **Login** button, enter `admin` as the username and `1q2w3E*` as the password to login to the application.

The startup template includes the **identity management** module. Once you login, the Identity management menu will be available where you can manage **roles**, **users** and their **permissions**.

![bookstore-user-management](images/bookstore-user-management.png)

### What's Next?

* [Application development tutorial](Tutorials/AspNetCore-Mvc/Part-I.md)