Skip to content

Latest commit

 

History

History
98 lines (73 loc) · 5.2 KB

README.md

File metadata and controls

98 lines (73 loc) · 5.2 KB

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

Documentation

What is a "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

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).

Contributing

We use this emoji code for reviewing:

  • 👍 or :+1: This is great! It always feels good when somebody likes your work. Show them!
  • ❓ or :question: I have a question / can you clarify?
  • ❌ or :x: This has to change. It’s possibly an error or strongly violates existing conventions.
  • 🔧 or :wrench: This is a well-meant suggestion. Take it or leave it.
  • 🙃 or :upside_down_face: This is a nitpick. Normally related to a small formatting or stylizing detail that shouldn’t block moving forward.
  • 💭 or :thought_balloon: I’m just thinking out loud here. Something doesn’t necessarily have to change, but I want to make sure to share my thoughts.
  • 🤡 or :clown_face: This is a complaint about something with no obvious answer, not necessarily a problem originating from changes.

2023 the project became part of Tür an Tür Digital Factory.

Resources about the Ehrenamtskarte (legacy)

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