https://github.com/levihassel/.net-flicks
.NET Core sample app for renting digital movies
https://github.com/levihassel/.net-flicks
dotnet dotnet-core example-project layered-architecture sample sample-app starter-template
Last synced: 6 months ago
JSON representation
.NET Core sample app for renting digital movies
- Host: GitHub
- URL: https://github.com/levihassel/.net-flicks
- Owner: LeviHassel
- License: mit
- Created: 2018-03-20T06:35:05.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-11-17T01:18:39.000Z (over 6 years ago)
- Last Synced: 2023-12-06T01:32:45.728Z (over 2 years ago)
- Topics: dotnet, dotnet-core, example-project, layered-architecture, sample, sample-app, starter-template
- Language: C#
- Homepage:
- Size: 11 MB
- Stars: 16
- Watchers: 3
- Forks: 12
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# .NetFlicks (.NET Core 2.2 Sample App)
.NetFlicks is a .NET Core sample app for renting digital movies and viewing details such as cast and crew. It contains custom-built data tables for efficient paging, searching, sorting and editing of thousands of items. Its main focus is to showcase best practices for multitier system architecture, database design and intuitive, mobile-friendly UI. This project has been a great learning experience for me and I hope it can help other developers looking for a solid template to build on.
## Demo
[](https://www.youtube.com/watch?v=uZh9yOw44Cs)
## Stack
* Server
* [ASP.NET Core 2.2](https://docs.microsoft.com/en-us/aspnet/core/?view=aspnetcore-2.2 "ASP.NET Core 2.2")
* [Entity Framework Core](https://docs.microsoft.com/en-us/ef/core/ "Entity Framework Core")
* [AutoMapper](https://automapper.org/ "AutoMapper")
* Client
* [Bootstrap 4.1](https://getbootstrap.com/ "Bootstrap 4.1")
* [Bootstrap Select](https://silviomoreto.github.io/bootstrap-select/ "Bootstrap Select")
* [Font Awesome](https://fontawesome.com/ "Font Awesome")
## Database Design
The database for this solution uses Entity Framework and ASP.NET Identity. I chose not to use Identity Roles, instead allowing all users to see both the Client and Administrator UI at once for simplicity. The database, called DotNetFlicksDb, is automatically seeded with data for 40 movies, provided by [TMDB](https://www.themoviedb.org "TMDB").
## System Architecture
This solution is divided into four layers based on [IDesign](http://www.idesign.net/ "IDesign") methodology:
| Layer | Description | Able to Call | Model |
| --- | --- | --- | --- |
| Clients | An entry-point to the system, such as an MVC site or REST API | Managers | ViewModel |
| Managers | Manages the workflow of a call chain, handles business logic | Engines, Accessors | DTO |
| Engines | Encapsulates algorithms and business logic (optional layer) | Accessors | DTO |
| Accessors | Accesses data from resources like databases and APIs | None | Entity |
IDesign is a closed architecture that focuses on encapsulating volatility, minimizing coupling and separation of concerns. The official IDesign documentation is sparse, so I'd recommend reading [Software architecture and project design, a mechanized approach](http://codewithspoon.com/2017/07/software-architecture/ "Software architecture and project design, a mechanized approach") for a quick intro to the method.
Here's my implementation of IDesign for this solution:
## Setup
### Getting Started
1. Install the following:
* [.NET Core 2.2 SDK](https://www.microsoft.com/net/download/windows ".NET Core 2.2 SDK")
* [Visual Studio Community 2017](https://www.visualstudio.com/downloads/ "Visual Studio Community 2017") (15.7+ is required for Core 2.2, select `ASP.NET and web development` workload during installation)
2. Download this repository
3. Open the solution in Visual Studio and run the Web project (this may take some time, as it will create and seed the database)
4. Log into the default administrator account (email: `admin@dotnetflicks.com`, password: `p@ssWORD471`) or create your own account to start using the site
### Tips
* **Access/manage database**
* Inside Visual Studio, open the SQL Server Object Explorer window by going to View->SQL Server Object Explorer
* Expand `(localdb)\MSSQLLocalDB` and the `Databases` folder to find `DotNetFlicksDb` (exists only after you first run the project)
* **Catch emails in development**
* Install [Papercut](https://github.com/ChangemakerStudios/Papercut "Papercut"), a fake SMTP server that you can use to catch outgoing emails in development
* **View logs and exceptions**
* In order to view a list of all logs and exceptions from your current IIS session, add `/elm` to the base URL
* This is made possible by the [ELM (Error Logging Middleware)](https://www.nuget.org/packages/Microsoft.AspNetCore.Diagnostics.Elm/ "ELM (Error Logging Middleware)") package, which you can read more about [here](http://www.talkingdotnet.com/aspnet-core-diagnostics-middleware-error-handling/#UseElmPage "app.UseElmPage() and app.UseElmCapture()")
* For more information on logging, check out Microsoft's [Introduction to Logging in ASP.NET Core](https://docs.microsoft.com/en-us/aspnet/core/fundamentals/logging?tabs=aspnetcore2x "Introduction to Logging in ASP.NET Core")
### Troubleshooting
* **Can't find a LocalDB instance in SQL Server Object Explorer**
* Open Visual Studio Installer
* Modify your Visual Studio Installation
* Go to the `Individual Components` tab
* Scroll down to the `Cloud, database and server` section
* Ensure that `SQL Server 2016 Express LocalDB` is checked and click `Modify`
* **Admin Settings pages are slow or unresponsive**
* LocalDB requires a certain amount of free memory to efficiently run large database queries
* Try closing processes until your memory usage drops and then reload the page