Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gematik/e-rezept-app-android
The official Android App of the german e-prescription
https://github.com/gematik/e-rezept-app-android
android app crypto e-rezept jetpack-compose kmm kmp kotlin nfc realm smartcard
Last synced: 6 days ago
JSON representation
The official Android App of the german e-prescription
- Host: GitHub
- URL: https://github.com/gematik/e-rezept-app-android
- Owner: gematik
- License: other
- Created: 2021-07-05T13:14:43.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-20T09:40:42.000Z (about 2 months ago)
- Last Synced: 2025-01-15T21:15:19.055Z (20 days ago)
- Topics: android, app, crypto, e-rezept, jetpack-compose, kmm, kmp, kotlin, nfc, realm, smartcard
- Language: Kotlin
- Homepage:
- Size: 40.6 MB
- Stars: 76
- Watchers: 21
- Forks: 14
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# E-Rezept App
## Table Of Contents
- [About The Project](#about-the-project)
- [Release Notes](#release-notes)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Structure](#structure)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [Security And Privacy](#security-and-privacy)
- [License](#license)
- [Contact](#contact)
- [Additional Links And Sourcecode](#additional-links-and-sourcecode)
## About The Project
Prescriptions for medicines that are only available in pharmacies can be issued as electronic prescriptions (e-prescriptions resp. E-Rezepte) for people with public health insurance from 1 July 2021.
The official gematik E-Rezept App (electronic prescription app) is available to receive and redeem prescriptions digitally. Anyone can download the app for free:
[](https://apps.apple.com/de/app/das-e-rezept/id1511792179)[](https://play.google.com/store/apps/details?id=de.gematik.ti.erp.app)[](https://appgallery.huawei.com/#/app/C104463531)
or as an apk here in GitHub: [Releases](https://github.com/gematik/E-Rezept-App-Android/releases)
Login is possible with the health card or the app of the users public health insurance company. In July 2021, the e-prescription started with a test phase, initially in the focus region Berlin-Brandenburg. The nationwide rollout started three month later in September 2022.
The e-prescriptions are stored in the telematics infrastructure, for which gematik is responsible.
Visit our [FAQ page](https://www.das-e-rezept-fuer-deutschland.de/faq) for more information about the e-prescription.
### Release Notes
See [ReleaseNotes.md](./ReleaseNotes.md) for all information regarding the (newest) releases.
## Getting Started
This section provides instructions on how to get started with the project,
including setting up the development environment and building the application.
### Prerequisites
Before you can build and run the application, ensure you have the following prerequisites installed on your system:
- **Android Studio:** The official IDE for Android app development.
- **Kotlin:** The primary programming language used in this project. Android Studio comes bundled with Kotlin support.
- **Git:** A distributed version control system used to manage the project's source code.
**Getting the Project Code**
To begin, clone the project's repository from GitHub using the following command in your terminal:
"git clone https://github.com/gematik/E-Rezept-App-Android.git" or by using the version control tool of Android Studio.
### Structure
The following graphic provides an overview over the more important parts of the kotlin multiplatform project:
```text
|-- app
| `-- android
| `-- src
| |-- androidTest
| |-- main
| `-- test
| `-- android-mock
| `-- src
| |-- androidTest
| |-- main
| `-- test
| `-- demo-mode
| `-- src
| |-- main
| `-- features
| `-- src
| |-- debug
| |-- release
| |-- androidTest
| |-- main
| `-- test
| `-- test-actions
| `-- src
| |-- main
|-- common
| `-- src
| |-- androidMain
| |-- commonMain
| |-- commonTest
`-- ui-components
`-- src
```
- **app/android/src/main:** includes build parameters for the android app.
- **app/android-mock/src/main:** includes build parameters for the android app-mock (mostly used for testing).
- **app/features/src/main:** includes the core logic of the android app. Including Screens, UseCases and Navigation.
- **app/demo-mode/src/main:** includes the core logic of the demo-mode of the android app. Including all overwritten Datasources and UseCases
- **common/src/commonMain:** includes the general logic of app. Most important the localDatasource and it's entities.
### Installation
To create and install an unsigned debug.apk on your connected android device, run:
- "./gradlew :app:android:assembleGoogleTuInternalDebug" in your terminal.
- This will create an apk in the following path "app/android/build/outputs/apk/googleTuInternal/debug", which you can then install on your device
- run "adb install app/android/build/outputs/apk/googleTuInternal/debug/android-googleTuInternal-debug.apk"
- or click on the green "run"-Button in the top right of android studio.
## Usage
The installed debug.apk can't communicate to connected servers. It's purpose is for local testing only. To show some data, you can enter the demo-mode via the settings.
If you want or need an active app, please download a live version from the sources mentioned in the [About The Project](#about-the-project) section.
## Contributing
See [Contributing.md](./CONTRIBUTING.md) for all information regarding the the contributing process in this project.
## Security And Privacy
See [Security.md](./SECURITY.md) for all information regarding the used security and privacy guidelines in this project.
## License
See [License.md](./LICENSE.md) for all information regarding the used license.
## Contact
For endusers and insurant:
[](https://www.das-e-rezept-fuer-deutschland.de/)
[](mailto:[email protected])
[](tel:+498002773777)
Members of the health-industry with functional questions
[](https://www.gematik.de/hilfe-kontakt/hersteller/)
IT specialists
[](https://fachportal.gematik.de/anwendungen/elektronisches-rezept)
[](mailto:[email protected])
### Additional Links And Sourcecode
- [E-Rezept iOS implementation](https://github.com/gematik/E-Rezept-App-iOS)
- Reference implementation of the [IDP (**ID**entity **P**rovider)](https://github.com/gematik/ref-idp-server)
- Reference implementation of the [FD (**F**ach**D**ienst)](https://github.com/gematik/ref-eRp-FD-Server)