Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gematik/e-rezept-app-ios
The official iOS App of the german e-prescription
https://github.com/gematik/e-rezept-app-ios
combine composable-architecture e-rezept ios swift swiftui tca
Last synced: 1 day ago
JSON representation
The official iOS App of the german e-prescription
- Host: GitHub
- URL: https://github.com/gematik/e-rezept-app-ios
- Owner: gematik
- License: eupl-1.2
- Created: 2021-07-15T14:30:26.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-10-09T12:58:38.000Z (3 months ago)
- Last Synced: 2024-12-16T10:27:50.080Z (8 days ago)
- Topics: combine, composable-architecture, e-rezept, ios, swift, swiftui, tca
- Language: Swift
- Homepage: https://gematik.github.io/E-Rezept-App-iOS/
- Size: 1.31 GB
- Stars: 112
- Watchers: 12
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# eRezept App
## Introduction
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)
and login with the health card of the public health insurance. In July 2021, the e-prescription will start with a test phase, initially in the focus region Berlin-Brandenburg. The nationwide rollout will follow three month later in the fourth quarter.
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/fragen-antworten) for more information about the e-prescription.
### Support & Feedback
For endusers and insurant:
[](https://www.das-e-rezept-fuer-deutschland.de/)
[](mailto:[email protected])
[](tel:+498002773777)
Members of the health-industrie with functional questions
[](https://www.gematik.de/hilfe-kontakt/hersteller/)
IT specialists
[](https://fachportal.gematik.de/anwendungen/elektronisches-rezept)
[](mailto:[email protected])
### Data Privacy
You can find the privacy policy for the app at: [https://www.das-e-rezept-fuer-deutschland.de/app/datenschutz](https://www.das-e-rezept-fuer-deutschland.de/app/datenschutz)
### Contributors
We plan to enable contribution to the E-Rezept App in the near future.
### Licensing
The E-Rezept App is licensed under the European Union Public Licence (EUPL); every use of the E-Rezept App Sourcecode must be in compliance with the EUPL.
You will find more details about the EUPL here: [https://joinup.ec.europa.eu/collection/eupl](https://joinup.ec.europa.eu/collection/eupl)
Unless required by applicable law or agreed to in writing, software distributed under the EUPL is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the EUPL for the specific language governing permissions and limitations under the License.
## Development
### Getting started
run `$ make setup` to start developing locally. This will make sure all the dependencies are put in place and the Xcode-project will be generated and/or overwritten.
You'll need a running implementation of `IDP` and `FD`. A reference implementation for [`IDP`](https://github.com/gematik/ref-idp-server) and [`FD`](https://github.com/gematik/ref-eRp-FD-Server) is available.
Documentation for setting up the entire system will be available at a later date.
### Project setup
The Xcode-project is generated using `xcodegen`.
The more complex build configuration(s) is done with the help of Fastlane. See the `./fastlane` directory for full setup.
The App uses Apple's `Combine.framework` for operation scheduling. The UI-Layer is built with [The Composable Architecture](https://github.com/pointfreeco/swift-composable-architecture) ♥️ and `SwiftUI` ♥️.
Minimum platform requirements are: MacOS 11 and iOS 14.0
#### Modularization
The app is composed of several modules:
- `eRpApp` is the iOS front-end (consumer facing) eRezept App.
- `eRpKit` bundles all non platform specific business logic.
- `eRpLocalStorage` and `eRpRemoteStorage` serve as the FHIR communication module to send and request all the eRezept resources and store them locally.
- `Pharmacy` handles communication with the Pharmacy API.
- `FHIRClient` powers `eRpRemoteStorage` and `Pharmacy` by providing a generic FHIR interface (see [FHIR](http://hl7.org/fhir/) for more information about the FHIR standard).
- `HTTPClient` provides the interface for HTTP communication within the project.
- `IDP` is used for authentication against the eHealth network.
- `VAU` provides an encrypted communication channel with the eHealth network.
- `TrustStore` validates trust with a given trust anchor and handles ocsp responses.
You can find more documentation about each module [here](https://gematik.github.io/E-Rezept-App-iOS).
#### Generated Source
We use `sourcery` to generate some data structures. Run `$ sourcery` to update generated code. The compiler will tell you, if you need to update the generated code by running sourcery in most cases. As sourcery is used as a weak (generated code is checked in, CI is not executing sourcery) dependency, you have to install sourcery manually by running `$ brew install sourcery`.
### Build iOS app for release
Run `$ make build`
Note: make sure you've ran `$ make setup` before and have code-signing setup for your local (or ci-build) build.
### Functional Requirements
The underlying requirements can be found within the Gematik [Fachportal](https://fachportal.gematik.de). Search for "E-Rezept Frontend des Versicherten".
A mapping of these requirements can be found within the [documentation](https://gematik.github.io/E-Rezept-App-iOS). To generate the mapping from requirements to implementation run `bundle exec fastlane list_requirements`.
### Links Sourcecode
- [Android and Huawei implementation ](https://github.com/gematik/E-Rezept-App-Android)
- 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)