Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jioo/dotnet-core-attendance-system
Attendance Web Application using .NET Core (CQRS pattern) & Vue.js
https://github.com/jioo/dotnet-core-attendance-system
axios-vue circle-ci continuous-integration cqrs-pattern dotnet-core2 integration-tests mssql-database signalr-core vuecli vuejs vuetify
Last synced: 2 months ago
JSON representation
Attendance Web Application using .NET Core (CQRS pattern) & Vue.js
- Host: GitHub
- URL: https://github.com/jioo/dotnet-core-attendance-system
- Owner: jioo
- License: mit
- Created: 2018-06-29T11:04:26.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2022-12-09T12:04:15.000Z (about 2 years ago)
- Last Synced: 2024-10-12T07:21:27.941Z (2 months ago)
- Topics: axios-vue, circle-ci, continuous-integration, cqrs-pattern, dotnet-core2, integration-tests, mssql-database, signalr-core, vuecli, vuejs, vuetify
- Language: C#
- Homepage:
- Size: 3.57 MB
- Stars: 35
- Watchers: 4
- Forks: 16
- Open Issues: 25
-
Metadata Files:
- Readme: readme.md
- License: LICENSE
Awesome Lists containing this project
README
## Dotnet-Core-Attendance-System ##
Attendance Web Application using .NET Core (CQRS pattern) & Vue.js
[](https://circleci.com/gh/jioo/Dotnet-Core-Attendance-System) [](http://paypal.me/jjquiazon)
### Prerequisite ###
1. Install .Net Core 2.2 SDK [https://dotnet.microsoft.com/download](https://dotnet.microsoft.com/download)
2. Install Node.js [https://nodejs.org/en/download/](https://nodejs.org/en/download/)
3. Any relational database provider. [https://docs.microsoft.com/en-us/ef/core/providers/](https://docs.microsoft.com/en-us/ef/core/providers/)
- Create your database and configure the connection string in [appsettings.json](https://github.com/jioo/Dotnet-Core-Attendance-System/blob/master/src/Api/appsettings.json#L9)
- Update DbContext option in [Startup.cs](https://github.com/jioo/Dotnet-Core-Attendance-System/blob/master/src/Api/Startup.cs#L55) _(Skip these if you're using MSSQL)_
### Build ###
```bash
# Restore packages
dotnet restore
# Install Cake global
dotnet tool install -g Cake.Tool
# Run build.cake
# - this task will build Api & Test .net core project
# and install packages in Vue client
dotnet-cake build.cake
```
### Run ###
- Api project
```bash
cd .\src\Api\
# Run
dotnet run
# or Run with file watcher
dotnet watch run
```
- Vue client
- Use login: `admin` and password: `123456`
```bash
cd .\src\Client\
# Start dev w/ hot module replacement
npm run serve
```
- Integration Tests
```bash
cd .\tests\Api\
# Run tests
dotnet test
# or Run with file watcher
dotnet watch test
```
### Local Publish ###
```bash
# Publish .net core api and vue in `/dist` folder
dotnet-cake build.cake --task="Publish"
```
### Features ###
* Fully separated Backend and Frontend
* Swagger for api documentation (URL: http://localhost:5000/swagger/index.html)
* CQRS Pattern (Command Query Responsibility Segregation)
* Authentication based on Identity Framework & JWT Bearer
* Integration Tests with XUnit
* Material design
* Realtime update on employee logs
* 
### Includes ###
* [.NET Core](https://docs.microsoft.com/en-us/dotnet/core/) open-source general-purpose development platform maintained by Microsoft.
* [MediatR](https://github.com/jbogard/MediatR) Simple, unambitious mediator implementation in .NET
* [Vue.js](https://vuejs.org/) The Progressive JavaScript Framework.
* [Vuetify](https://vuetifyjs.com/en/) Material design component framework for Vue.js.
### Online Resources ###
* [https://docs.microsoft.com/en-us/aspnet/core](https://docs.microsoft.com/en-us/aspnet/core)
* [https://vuejs.org/](https://vuejs.org/)
* [https://vuetifyjs.com](https://vuetifyjs.com)
* [https://github.com/gothinkster/aspnetcore-realworld-example-app](https://github.com/gothinkster/aspnetcore-realworld-example-app)
* [https://medium.com/@ozgurgul/asp-net-core-2-0-webapi-jwt-authentication-with-identity-mysql-3698eeba6ff8](https://medium.com/@ozgurgul/asp-net-core-2-0-webapi-jwt-authentication-with-identity-mysql-3698eeba6ff8)