Skip to content

Commit 7bebf5c

Browse files
committed
Updated readme.md
- Added build - Refactor Installation guide - Minimal Includes section - Added realtime-demo.gif
1 parent a762afb commit 7bebf5c

File tree

2 files changed

+46
-31
lines changed

2 files changed

+46
-31
lines changed

readme.md

Lines changed: 46 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,59 @@
11
## Dotnet-Core-Attendance-System ##
22

3-
Attendance Web Application using .NET Core 2.1 (CQRS pattern) & Vue.js
3+
Attendance Web Application using .NET Core (CQRS pattern) & Vue.js
44

5-
Use login: `admin` and password: `123456`
5+
### Circle CI ###
66

7-
### Installation ###
8-
```
9-
git clone https://github.com/jioo/Dotnet-Core-Attendance-System.git
7+
[![CircleCI](https://circleci.com/gh/jioo/Dotnet-Core-Attendance-System.svg?style=svg)](https://circleci.com/gh/jioo/Dotnet-Core-Attendance-System)
8+
9+
### Prerequisite ###
10+
1. Install .Net Core 2.2 SDK [https://dotnet.microsoft.com/download](https://dotnet.microsoft.com/download)
11+
2. Install Node.js [https://nodejs.org/en/download/](https://nodejs.org/en/download/)
12+
3. Any relational database provider. See list at: [https://docs.microsoft.com/en-us/ef/core/providers/](https://docs.microsoft.com/en-us/ef/core/providers/)
13+
- Note: MSSQL is the default provider in the source code.
1014

11-
# Navigate to Web Api folder
12-
cd WebApi
15+
### Build ###
16+
```bash
17+
# Install Cake global tool first
18+
dotnet tool install -g Cake.Tool
1319

14-
# Restore NuGet packages
15-
dotnet restore
20+
# Run build.cake
21+
# - this task build Api & Test .net core project
22+
# and install packages in Vue client
23+
dotnet-cake build.cake
24+
```
1625

17-
# Prepare user secret
18-
dotnet user-secrets set "AppSecret" "__YOUR_SECRET_KEY__"
26+
### Run ###
27+
- Api project
28+
```bash
29+
cd .\src\Api\
1930

20-
# Migrate database
21-
dotnet ef database update
31+
# Run
32+
dotnet run
2233

23-
# Start server w/ file watcher
34+
# or Run with file watcher
2435
dotnet watch run
36+
```
37+
- Vue client
38+
- Use login: `admin` and password: `123456`
39+
```bash
40+
cd .\src\Api\
2541

26-
# Navigate to Web Client folder
27-
cd WebClient
42+
# Start dev w/ hot module replacement
43+
npm run serve
44+
```
45+
- Integration Tests
46+
```bash
47+
cd .\tests\Api\
2848

29-
# Install dependecies
30-
npm i
49+
# Run tests
50+
dotnet test
51+
```
3152

32-
# Start client dev w/ hot module replacement
33-
npm run serve
53+
### Local Publish ###
54+
```bash
55+
# Publish .net core api and vue in `/dist` folder
56+
dotnet-cake build.cake --task="Publish"
3457
```
3558

3659
### Features ###
@@ -41,19 +64,11 @@ npm run serve
4164
* Authentication based on Identity Framework & JWT Bearer
4265
* Material design
4366
* Realtime update on employee logs
67+
![Realtime Demo](realtime-demo.gif)
4468

4569
### Includes ###
4670

47-
* [.NET Core 2.1](https://docs.microsoft.com/en-us/dotnet/core/) open-source general-purpose development platform maintained by Microsoft.
48-
* [Entity Framework Core](https://www.nuget.org/packages/Microsoft.EntityFrameworkCore/) lightweight and extensible version of the popular Entity Framework data access technology.
49-
* [AspNetCore.Identity](https://www.nuget.org/packages/Microsoft.AspNetCore.Identity/) ASP.NET Core Identity is the membership system including membership, login, and user data.
71+
* [.NET Core](https://docs.microsoft.com/en-us/dotnet/core/) open-source general-purpose development platform maintained by Microsoft.
5072
* [MediatR](https://github.com/jbogard/MediatR) Simple, unambitious mediator implementation in .NET
51-
* [AutoMapper]() A convention-based object-object mapper.
52-
* [Microsoft.AspNetCore.SignalR](https://www.nuget.org/packages/Microsoft.AspNetCore.SignalR/) Components for providing real-time bi-directional communication across the Web.
5373
* [Vue.js](https://vuejs.org/) The Progressive JavaScript Framework.
54-
* [Vue CLI 3](https://cli.vuejs.org/) Standard Tooling for Vue.js Development.
55-
* [Vuetify](https://vuetifyjs.com/en/) Material design component framework for Vue.js.
56-
* [Vuex](https://vuex.vuejs.org/en/intro.html) State management pattern + library for Vue.js.
57-
* [Vue-Router](https://router.vuejs.org/en/) Vue Router is the official router for Vue.js.
58-
* [Axios](https://github.com/axios/axios) Promise based HTTP client for the browser and node.js.
59-
* [@aspnet/signalr](https://github.com/aspnet/SignalR) JavaScript and TypeScript clients for SignalR for ASP.NET Core
74+
* [Vuetify](https://vuetifyjs.com/en/) Material design component framework for Vue.js.

realtime-demo.gif

466 KB
Loading

0 commit comments

Comments
 (0)