Platform for state registries

1. About the Platform

The Platform for state registries is an information system designed to deliver government services in a digital format efficiently. It enables the rapid creation, modeling, deployment, and maintenance of electronic state registries, striking an optimal balance between data security requirements, deployment speed, registry ownership costs, and data exchange with other registries.

Figure 1. Context diagram of the Platform

2. Problem statement

2.1. Current condition of registries

Across the globe, many countries are grappling with a need for uniformity in how their public state registers are created and managed. This inconsistency stymies the practical application of crucial principles of digital development policy, such as reusability, technology neutrality, data portability, interoperability, security, and confidentiality. Consequently, this results in increased complexity in delivering administrative services while also acting as a roadblock to their transition to online platforms.

In the case of Ukraine, there exist over 350 state registries, each with distinct ownership. Individual teams are responsible for creating and maintaining each registry, and they each operate on their dedicated infrastructure, whether physical hardware or a cloud-based solution.

The current situation can be characterized as both decentralized and unregulated:: Decentralized refers to separate infrastructures for data storage maintained by different owners. This distinction is crucial regarding data collection, storage, and usage accountability.

Unregulated signifies the absence of guarantees that the registries interact correctly. This interaction should occur over secure connections, comply with data retention policies, and align with software reuse and resource optimization principles.

2.2. The concept of a platform for deploying registries and solving the problem

Given the current situation and potential risks associated with defining responsibility for data protection, the Platform advocates a shift towards a decentralized but regulated approach.

This approach guarantees the preservation of data owner identification, establishing clear data responsibility. Simultaneously, it lays the groundwork for further Platform enhancements, positioning registries as a complex of hardware and software tools. These tools are designed to implement the requirements the Ministry of Digital Transformation of Ukraine set forth.

3. Getting started

This knowledge base contains the following main sections:

To learn about new features and enhancements, see What’s new.
If you are a Platform infrastructure administrator, security administrator, or access administrator, see Platform administrators.
If you are a development and maintenance team member that deploys registries using the Platform, see Registry development and maintenance.
If you are a registry administrator, see Registry administrators.
If you are a data modeler who works with operational data structures and declarative model descriptions and creates analytical reports, see Data modelers.
If you are a modeler of business processes and UI forms for business processes, who works with BPMN, DMN, Groovy scripting, and JSON structures, see Business process modelers.
For a deep dive into the regulations structures, take a special Study course for registry regulations developers. This training provides a number of educational tasks and quizzes that will help you gain practical skills in regulations modeling.
If you are a government officer or a citizen working with the user portal as part of business processes, see User documentation.
If you are a developer, architect, or just a tech guru, see Architectural documentation.

4. Code of Conduct Diia.Engine Open Source

Notice! This software is provided as is, and we are not responsible for how you will use it in your solutions.

4.1. Section 1. User agreement

4.1.1. The Diia.Engine platform

The Diia.Engine platform is an innovative solution that will help ministries and government agencies to conveniently create and manage registers. This will allow for the orderly and secure storage of data in registers, automation and digitization of public services, thus boosting the launch of online services and digitalization in general. Diia.Engine is an export-ready platform that meets international standards for interoperability and data security.

Instances. The Diia.Engine platform available as instances that can be deployed on your own infrastructure or used in the cloud.
The platform works with open source software, so there are no license fees.

4.1.2. Users

Ministry of Digital Transformation of Ukraine: supported development of Diia Engine that using to build digital services for citizens.
Government agencies: use Diia Engine to create and manage their own digital registers and services.
Developers: the product is an open-source solution, so developers can use the platform’s open code for development purposes.

4.1.3. Code of Conduct outlines the expected behavior for a specific community or platform:

Promote a positive and productive environment.
Ensure ethical development.
Protect users from harmful behavior.

4.1.4. The Diia Engine open-source product community consists of:

Ministry of Digital Transformation of Ukraine (MDT), Ukrainian State Services and Authorities (Developing services on Diia.Engine).
GIZ (Deutsche Gesellschaft für Internationale Zusammenarbeit) (a German development agency that provides technical and financial support to Diia Engine).
East Europe Foundation (collaborates with GIZ to support the development of registers on Diia Engine).
Public and government organizations (could use Diia Engine to create digital services).

4.2. Section 2. Expected Behavior

Respectful communication. We expect all participants to treat each other with respect, regardless of background, experience level, or opinion. This includes avoiding discriminatory or offensive language, harassment, and personal attacks.

Diversity and inclusion. We value diversity of thought and experience. We strive to create a welcoming and inclusive environment for all contributors.

Professionalism. We encourage professional and constructive communication in discussions and disagreements.

4.3. Section 3. Contribution Guidelines

Agreeing to the Code of Conduct. By participating in the project, you agree to abide by this Code of Conduct.

Contribution methods. Use GitHub’s standard features to propose improvements (pull requests), report bugs (issues), and report violations of this Code of Conduct.

Decision-making on contributions. The project team will review and evaluate all contributions based on technical merit, alignment with project goals, and adherence to coding standards. We reserve the right to accept or reject contributions without providing specific reasons.

4.4. Section 4. Review Process

Evaluation criteria. Contributions are evaluated based on:

Functionality and technical merit.
Alignment with the project’s vision and roadmap.
Coding style and adherence to best practices.
Potential impact on the project and its users.

Collaborative decision-making. The product development team will review contributions collaboratively using standard GitHub tools.

4.5. Section 5. Consequences of Violations

Addressing violations. If a participant violates this Code of Conduct, the project team may take appropriate action, including:

Warning or reprimand.
Removal of comments or contributions.
Temporary or permanent ban from the project.

Have a question? See FAQ.