digitalfabrik/entitlementcard

Digitale Berechtigungskarte

CircleCI build status frontend style: effective dart

App for 'Digitale Berechtigungskarten', generally benefit card for volunteers or socially vulnerable groups in Germany.

App for Android & iOS + Backend + Administration Web Portal – 100% Open Source.

Getting Started

• Development Setup
• Conventions
• Working with the GraphQL API

Documentation

• Manual Releases
• CI/CD
• Troubleshooting
• API Documentation
• GraphQL Code Generation
• Protobuf Code Generation
• Migrations
• Deep Linking
• Domains & Projects
• Upgrade flutter
• Preparing PDF templates

What is an "entitlementcard"

Short answer, it is a whitelabel for benefit cards in Germany, mainly targeted at volunteers and socially vulnerable groups.

To name some examples, this project has a whitelabel for

• the digital volunteer card and
• the Nuremberg Social Pass

What is a Ehrenamtskarte?

A Ehrenamtskarte is a benefit card for volunteers in Bavaria, Germany.

Translated from Wikipedia:

The Ehrenamtskarte (also Ehrenamtspass) is a personal document in Germany that serves as proof of special voluntary commitment. Such a document can be issued, for example, by the state, federal states, municipalities or volunteer agencies.

Depending on how it is implemented, it may be linked to documentation of the type and scope of the activity, the skills required for it and any qualification measures. An Ehrenamtskarte or Freiwilligenausweis can also bring certain benefits, such as discounts on tickets or access to museums or other public institutions, or benefits with cooperation partners, such as companies, institutions and other supporters.

Features

This project consists of the following components:

• A mobile app for Android and iOS in the folder frontend. Flutter was used to implement the app. The app offers the following functions:
  • Display of accepting stores from different categories with different symbols on a map.
  • Display details of an accepting store with descriptive text, address, phone number, email address and website.
  • A page to browse accepting stores with optional sorting by distance from the current location.
  • An ID function for an entitlementcard
  • A reliable way to verify another entitlementcard.
  • An application form for a new volunteer card.
• A backend implemented in Kotlin (JVM) that is responsible for the management of all accruing data.
  • Interfaces for the app: retrieving accepting stores, verifying digital volunteer cards and receiving applications.
  • Interface for the administration web portal: Entering new digital volunteer cards and querying applications.
• A web portal for the administration of digital volunteer cards, implemented with React in the folder administration.
• A Postgres or PostGIS database to store the accepting stores, as well as the digital volunteer cards and applications.
• Martin, for queries to display accepting stores on the map.

About the project

This project was created by 6 students of the Software Engineering Master's programme of Universität Augsburg, TU München und LMU München.

We were supported by Tür an Tür – Digitalfabrik gGmbH in our cooperation with the Bayerisches Staatsministerium für Familie, Arbeit und Soziales (Bavarian State Ministry for Family, Labour and Social Affairs).

2023 the project became part of Tür an Tür - Digitalfabrik.

Contributing

First, make sure you have a look at our conventions.

You can contribute by reporting bugs or creating and reviewing pull requests.

If you want to know more about the entitlementcard project or if you want to join us, contact [Andy](mailto:andreas.fischer@tuerantuer.org), [Tory](mailto:viktoria.seluianova@tuerantuer.org) or [our info mail](mailto:info@tuerantuer.org) and visit our website.

Resources about the Ehrenamtskarte (legacy)

See https://github.com/digitalfabrik/ehrenamtskarte-artefacts Demo Video