https://github.com/digital-blueprint/checkin-app
A simple location based contact tracing system. With the possibilities to check in yourself or a guest manually or with an in-build QR-Code scanner. - 🌎 Development: https://dbp-dev.tugraz.at/apps/checkin, 🌎 Demo: https://dbp-demo.tugraz.at/apps/checkin, 🌎 Production: https://checkin.tugraz.at
https://github.com/digital-blueprint/checkin-app
checkin dbp digital-blueprint
Last synced: 11 months ago
JSON representation
A simple location based contact tracing system. With the possibilities to check in yourself or a guest manually or with an in-build QR-Code scanner. - 🌎 Development: https://dbp-dev.tugraz.at/apps/checkin, 🌎 Demo: https://dbp-demo.tugraz.at/apps/checkin, 🌎 Production: https://checkin.tugraz.at
- Host: GitHub
- URL: https://github.com/digital-blueprint/checkin-app
- Owner: digital-blueprint
- License: lgpl-2.1
- Created: 2023-02-02T08:21:39.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2025-07-09T14:46:11.000Z (11 months ago)
- Last Synced: 2025-07-09T15:49:40.943Z (11 months ago)
- Topics: checkin, dbp, digital-blueprint
- Language: JavaScript
- Homepage:
- Size: 3.66 MB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Check-in Application
[GitHub Repository](https://github.com/digital-blueprint/checkin-app) |
[npmjs package](https://www.npmjs.com/package/@digital-blueprint/checkin-app) |
[Unpkg CDN](https://unpkg.com/browse/@digital-blueprint/checkin-app/) |
[Checkin Bundle](https://github.com/digital-blueprint/relay-checkin-bundle) |
[Project documentation](https://dbp-demo.tugraz.at/site/software/check-in.html)
[](https://github.com/digital-blueprint/checkin-app/actions/workflows/build-test-publish.yml)
A simple location based contact tracing system.
With the possibilities to check in yourself or a guest manually or with an in-build QR-Code scanner.
## Prerequisites
- You need the [API server](https://gitlab.tugraz.at/dbp/relay/dbp-relay-server-template) running
- You need the [RelayCheckinBundle](https://github.com/digital-blueprint/relay-checkin-bundle) to handle
check-ins to places and contact tracing for warning about COVID-19 cases
- For more information please visit the [Check-in project documentation](https://dbp-demo.tugraz.at/site/software/check-in.html)
## Local development
```bash
# get the source
git clone git@github.com:digital-blueprint/checkin-app.git
cd checkin-app
git submodule update --init
# install dependencies
npm install
# constantly build dist/bundle.js and run a local web-server on port 8001
npm run watch
# constantly build dist/bundle.js and run a local web-server on port 8001 using a custom assets directory assets_custom/
npm run watch-custom
# run tests
npm test
```
Jump to, so you should get a Single Sign On login page.
To enable building with custom assets, you need to provide your custom assets in the directory `assets_custom/checkin-app/assets/`. If you want to, you can also change this path in the file `rollup.config.js`. For more information, please visit the [dbp handbook page on custom assets](https://handbook.digital-blueprint.org/frameworks/frontend/dev/assets/#custom-assets).
## Using this app as pre-built package
### Install app
If you want to install the dbp check-in app in a new folder `check-in-app` with a path prefix `/` you can call:
```bash
npx @digital-blueprint/cli install-app check-in check-in-app /
```
**Warning:** There may be issues when you run these commands as root user, best use a non-root user, like `www-data`.
To do this you can for example open a shell with `runuser -u www-data -- bash`.
Afterwards you can point your Apache web-server to `check-in-app/public`.
Make sure you are allowing `.htaccess` files in your Apache configuration.
Also make sure to add all of your resources you are using (like your API and Keycloak servers) to the
`Content-Security-Policy` in your `check-in-app/public/.htaccess`, so the browser allows access to those sites.
You can also use this app directly from the [Unpkg CDN](https://unpkg.com/browse/@digital-blueprint/checkin-app/)
for example like this: [dbp-check-in/index.html](https://github.com/digital-blueprint/checkin-app/tree/main/examples/dbp-check-in/index.html)
Note that you will need a Keycloak server along with a client id for the domain you are running this html on.
### Update app
If you want to update the dbp check-in app in the current folder you can call:
```bash
npx @digital-blueprint/cli update-app check-in
```
**Warning:** There may be issues when you run these commands as root user, best use a non-root user, like `www-data`.
To do this you can for example open a shell with `runuser -u www-data -- bash`.
## Activities
This app has the following activities:
- `dbp-check-in-request`
- `dbp-check-out-request`
- `dbp-guest-check-in`
- `dbp-report-risk`
You can find the documentation of these activities in the [check-in activities documentation](https://github.com/digital-blueprint/checkin-app/tree/main/src).
## Adapt app
### Functionality
You can add multiple attributes to the `` tag.
| attribute name | value | Link to description |
| ----------------------- | ------- | -------------------------------------------------------------------------------------------------------------------------- |
| `provider-root` | Boolean | [appshell](https://github.com/digital-blueprint/toolkit/tree/main/packages/app-shell#attributes) |
| `lang` | String | [language-select](https://github.com/digital-blueprint/toolkit/tree/main/packages/language-select#attributes) |
| `entry-point-url` | String | [appshell](https://github.com/digital-blueprint/toolkit/tree/main/packages/app-shell#attributes) |
| `keycloak-config` | Object | [appshell](https://github.com/digital-blueprint/toolkit/tree/main/packages/app-shell#attributes) |
| `base-path` | String | [appshell](https://github.com/digital-blueprint/toolkit/tree/main/packages/app-shell#attributes) |
| `src` | String | [appshell](https://github.com/digital-blueprint/toolkit/tree/main/packages/app-shell#attributes) |
| `no-welcome-page` | Boolean | [appshell](https://github.com/digital-blueprint/toolkit/tree/main/packages/app-shell#attributes) |
| `html-overrides` | String | [common](https://github.com/digital-blueprint/toolkit/tree/main/packages/common#overriding-slots-in-nested-web-components) |
| `themes` | Array | [theme-switcher](https://github.com/digital-blueprint/toolkit/tree/main/packages/theme-switcher#attributes) |
| `darkModeThemeOverride` | String | [theme-switcher](https://github.com/digital-blueprint/toolkit/tree/main/packages/theme-switcher#themes-attribute) |
| `search-hash-string` | String | [check-in activities](https://github.com/digital-blueprint/checkin-app/tree/main/src#check-in-activities) |
#### Mandatory attributes
If you are not using the `provider-root` attribute to "terminate" all provider attributes
you need to manually add these attributes so that the topic will work properly:
```html
```
So a working example would be:
```html
```
See [AppShell Attributes](https://github.com/digital-blueprint/toolkit/tree/main/packages/app-shell#attributes)
for a list of more attributes.
See [Overriding slots in nested web components](https://github.com/digital-blueprint/toolkit/tree/main/packages/common#overriding-slots-in-nested-web-components)
for information about how to override slots.
### Design
For frontend design customizations, such as logo, colors, font, favicon, and more, take a look at the [theming documentation](https://handbook.digital-blueprint.org/frontend/theming/).
## "dbp-check-in" slots
These are common slots for the app-shell. You can find the documentation of these slots in the [app-shell documentation](https://github.com/digital-blueprint/toolkit/tree/main/packages/app-shell).
For the app specific slots take a look at the [check-in activities](https://github.com/digital-blueprint/checkin-app/tree/main/src#check-in-activities).