Optivem Framework

Build Status Build Status Build Status MIT License

Welcome to the Optivem Framework! The Optivem Framework was created to help you increase code quality, help you deliver products faster to customers and reduce your overall software development cost. This documentation page will show you how to get up-and-running with the Optivem Framework in your .NET Core 2.2 software projects.

Table of Contents

Introduction

Optivem Framework was created to accelerate the development of enterprise applications, so that you can quickly create new projects for your customers.

The Optivem Framework is founded upon Clean Architecture principles and supports:

The architecture consists of the following layers:

Getting started

We are using Visual Studio 2019 and .NET Core 2.2.

Installation

To install the Optivem Template:

  1. Run Visual Studio
  2. Open the Package Manager Console (Visual Studio main menu: Tools > NuGet Package Manager > Package Manager Console)
  3. Run the following command inside the Package Manager Console
PM> dotnet new -i Optivem.Template
  1. In the future, you can run this same command to get updated versions of the template

Create a new project

To create a new project:

  1. Run Visual Studio
  2. Open the Package Manager Console (Visual Studio main menu: Tools > NuGet Package Manager > Package Manager Console)
  3. Create the directory for your new project, for example:
PM> mkdir C:\Users\Valentina.Cupac\source\repos\MyWebShop
  1. Go inside the new directory:
PM> cd C:\Users\Valentina.Cupac\source\repos\MyWebShop
  1. Create the Visual Studio Solution based on the Optivem Template:
PM> dotnet new optivem
  1. Open the solution (Visual Studio main menu: File > Open Project/Solution, selecting the folder and inside it the solution MyWebShop.sln)

  2. Rebuild the solution

  3. Set MyWebShop.Web.RestApi as the StartUp project

  4. Inside MyWebShop.Web.RestApi, open up the file appsettings.Development.json, you can adjust the DefaultConnection to the location where the database should be created

  5. Inside the Package Manager Console, run the command to create the database:

PM> Update-Database
  1. Run the application

  2. Browser opens up https://localhost:44315/api/values

  3. Go to the Swagger page https://localhost:44315/swagger/index.html where you can execute any API calls

  4. Stop Debugging

  5. Open up the Test Explorer (Visual Studio main menu: Test > Windows > Test Explorer)

  6. Rebuild the solution to discover all the tests

  7. Click on “Run All” inside the Test Explorer (all tests should pass)

Technical Reference

Optivem Framework Core

Optivem Framework Infrastructure

Optivem Framework Dependency Injection

Optivem Framework Web

Optivem Framework Test

Optivem Template

Getting support

To report any issues and bugs, or if you have any suggestions for improvements and new features, please create a ticket using the Issue Tracker: github.com/optivem/framework-dotnetcore/issues.

License

Licensed under the MIT license. This means you’re free to use it for commercial and non-commercial purposes.

Copyright © 2019 Optivem All Rights Reserved.