About • Assumptions • Organisation • Testing & Status • Licensing
The Digital COVID Certificate (DCC) allows to determine whether a person is deemed fit-for-travel into a country-of-arrival (CoA) based on their vaccination, test, and recovery status. To make such determinations, business (or validation, or verification) rules have to be implemented in verifier apps.
This repository contains a framework to implement (sets of) rules in verifier apps (and backends) using a rules engine. It explains how to do that in a way that makes these rules interchangeable across implementors. The advantage of this approach is that it ultimately allows citizens to check their fit-for-travel status into an intended CoA ahead of travel, against the actual rules. This can be achieved by adhering to a common, and testable and verifiable way of defining, and executing rules. The interchangeable rules are uploaded to, and can be downloaded from the EU Digital COVID Certificate Gateway (DGCG) - more info can be found here.
An example of a rule can be found here.
This work is a result of work done by the EU Taskforce Business Rules, and described in this document. The (JSON Schema) technical specification for the EU DCC can be found here. More relevant documents and links can be found here.
- implementation 'com.github.section42:dgc-business-rules:{{release-tag}}'
Various code in this repo assumes that you've cloned the following two repos right next to where this repo's cloned:
This repository contains the following:
- Documentation.
- CertLogic: a specification, reference implementations for various platforms, a test suite, and a validation tool. CertLogic is generic, and not tied to the DCC, to make it easier to understand, test, expand, etc. independently.
- RulesRunner: implementations of components for running rule(set)s against a DCC payload, for various platforms, including testing.
- Rule sets: implementations of rule sets with unit tests - for now that of the EU-template, but later of possibly various member states as well.
TODO The contents of the javascript directory still have to be moved to their proper places, and are currently provided as-is only, without guarantee of them being useful.
- If you found any problems, please create an Issue.
- Current status: Work-In-Progress.
Copyright (c) 2021 Dutch Ministry of Health, Science, and Sports, and all other contributors
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License.
You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0.
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the LICENSE for the specific language governing permissions and limitations under the License.