Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/qdraw/tabletop
Event tracking application using .NET Core 3.1, SignalR and Entity Framework Core
https://github.com/qdraw/tabletop
arduino c-sharp dotnet-standard entity-framework-core net-mvc signalr signalr-core sql-server
Last synced: 15 days ago
JSON representation
Event tracking application using .NET Core 3.1, SignalR and Entity Framework Core
- Host: GitHub
- URL: https://github.com/qdraw/tabletop
- Owner: qdraw
- Created: 2018-01-03T15:11:52.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2023-07-12T02:35:00.000Z (over 1 year ago)
- Last Synced: 2024-11-08T17:39:24.005Z (2 months ago)
- Topics: arduino, c-sharp, dotnet-standard, entity-framework-core, net-mvc, signalr, signalr-core, sql-server
- Language: C#
- Homepage:
- Size: 27.8 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Tabletop
Tabletop is a cloud-based, mobile-ready, event tracking system. We use it to see if the table footbal is free.
## Builds
[](https://travis-ci.org/qdraw/tabletop/) [](https://ci.appveyor.com/project/qdraw/tabletop/branch/master) [](https://codecov.io/gh/qdraw/tabletop) [](https://www.paypal.me/qdrawmedia)
### Features
- Display if room __is free__ or _in use_
- History views per day
- Display Latest Activity
- Realtime Magic
### Technical summary
- .NET Core 3.1
- ASP.NET MVC
- Runs on Windows, Linux and Mac OS X
- Send events from a Arduino with a PIR-Sensor
- [D3.v4](https://d3js.org/) Javascript Datavisualisation
And of course Tabletop itself is open source with a [public repository ](https://github.com/qdraw/tabletop) on GitHub.
### Installation
Tabletop requires [.NET Core](https://www.microsoft.com/net/core) v3.1 to run.
Install the dependencies
```sh
$ cd tabletop/tabletop
$ dotnet restore
```
- **Linux and Mac OS X**, Update SQL-Server connection string in `appsettings.Production.json`
- **Windows:** You can use the localdb for testing
```json
{
"ConnectionStrings": {
"DefaultConnection": "Data Source=data.db",
"DatabaseType": "sqlite"
}
}
```
Run Database migration
```sh
$ dotnet ef database update
```
Add a test user using the SQL command
```sql
INSERT INTO [dbo].[ChannelUser] (NameId,Name,NameUrlSafe,IsAccessible,IsVisible,Bearer)
VALUES ('cc9299c5-03a6-409a-be35-30981acfa7ac','Test Channel','test','true','true','secret')
```
**And finaly run the app**
```sh
$ dotnet run
```
Add some test data
```sh
curl -X POST -F 'status=1' -F 'name=test' -H 'Authorization: Bearer secret'
'http://localhost:5000/api/update'
```
#### Arduino client
I use a [Arduino Ethernet shield](https://www.arduino.cc/en/Reference/Ethernet) with the [Ethernet2](https://github.com/adafruit/Ethernet2) library and a PIR-sensor. To Setup additional libraries check: https://www.arduino.cc/en/Guide/Libraries.
The Arduino code is open source in the [tabletop_client](tabletop_client) folder
Adjust the bearer and server in `tabletop/tabletop_client/tabletop_client.ino`
```cpp
char clientName[] = "test";
char Bearer[] = "secret";
char server[] = "qdraw.nl"; // without http://
// the url will be: http://qdraw.nl/tabletop/api/update
```
To setup the PIR-sensor please check this scheme:
#### For production environments...
You can use the environment variable `TABLETOP_SQL`. If there is no variable the app will check `appsettings.json` or `appsettings.Production.json`.
Personaly I run this application on a linux-arm server and use PM2 to manage the process. [PM2](http://pm2.keymetrics.io/) is a production process manager for Node.js but you can be used to manage binary executables.
##### Building for linux-arm
Create a new build for linux-arm
```sh
$ cd tabletop/tabletop
$ ./publish-linux-arm.sh
```
##### Creating a new PM2 instance
This bash script ask for a SQL Server connectionstring
```sh
$ ./new-pm2.sh
Insert here the production SQL string
```