Chroma Experience

Smartarchivo — digital documentation in nuclear medicine and radiochemistry

For rapp-iso from Kappeln, we designed and implemented a system solution for the digitalization of documentation and administration processes. By analyzing and evaluating the collected measured values, users are enabled to comply with applicable radiation protection guidelines, industry standards and legal requirements.

In order to comply with applicable information regulations, reports are regularly made available to supervisory authorities and medical bodies.

Laboratory technician at an electronic testing facility

Client

rapp-iso GmbH

Business fields

Consulting, planning, purchasing, installation and maintenance of technical equipment in the fields of radiology, radiotherapy and nuclear medicine

Challenge

Replacing classic documentation while taking into account the guideline Radiation Protection in Medicine in accordance with DIN 6855-11

Solution

Digitization of the classic paper and office documentation of operational incidents, device tests and clearance measurements; conception and realization of a web-based platform and mobile applications taking into account applicable laws and guidelines

Activities

Consulting, architecture, UX design, UI design, backend development, web application development, mobile application development, operations

Technologies

Propeller web application framework, PostgreSQL, Native Android (Java), Newman, GitLab CI/CD, Web Components, Chart.js, Markdom

Project summary

Challenge

In nuclear medicine, it is necessary to regularly check whether the instruments used are functioning correctly, which is determined by measurements of a radioactive test source. The testing and documentation of these measurement results is to be carried out with the aid of a digital application, thus replacing time-consuming and error-prone analog processes.

Procedure, activities and solution

In order to be able to develop a product vision, technical and economic perspectives were first examined, the results of which were subsequently incorporated into the UX concept. The resulting wireframes helped us to develop a concrete vision of the solution to be implemented together with the client. The biggest hurdle was to understand the physical interrelationships of the different device types and measurement methods and to transfer them into a homogeneous modeling and implementation.

Result

The resulting product "Smartarchivo" offers facilities with nuclear medical and radiochemical instruments the possibility to record various test procedures of diverse medical devices using a tablet application. Measurement points are stored and validated – even offline. In the connected web application, the data is persisted securely and with high availability, versioned and made available in the form of reports.

Time to market

14 weeks

Cooperation

4 years

Major Releases

32

Commits

1.971

Laboratory assistant at an experimental setup
Laboratory assistant at an experimental setup
Laboratory assistant at an experimental setup
Laboratory assistant at an experimental setup
Torben Rapp
Torben Rapp General Manager and Medical Physics Expert

The implementation of a software for quality assurance in nuclear medicine was professionally realized together with the Chroma Experience team. Something we especially appreciate is the personal and individual contact.

Complex matter

Problem

Our client asked us to assist them in designing and implementing an application to meet radiation protection requirements and ensure quality management in the field of nuclear medical and radiochemical equipment and facilities.

In this way, we jointly designed a product that meets the complex requirements. Within the framework of the "Landesprogramm Wirtschaft" this project was supported by the European Union.

Testing of medical devices

In dealing with various nuclear medical and radiochemical applications, as well as in the operation of a corresponding facility, various measuring instruments are used whose main task is the detection of radioactive radiation. To ensure that the measuring instruments provide correct values, they must be checked regularly. This is usually done by measuring the radiation of a so-called test radiator. This emits radiation that is known in advance, so that there is a known tolerance range for the expected measurement result. In this way, it can be determined whether the instrument is functioning correctly.

Documentation and requirements

The measurements obtained in this way, which qualify the measuring instruments for further use, must be documented, evaluated, made accessible and stored in accordance with the Guideline Radiation Protection in Medicine in accordance with DIN 6855-11 (constancy testing of nuclear medicine measuring systems). In the past, this was done with the help of office documents, paper, e-mail and fax.

Different methods must be used, values recorded, and different data points persisted and provided in the form of electronic reports, depending on the type of device, manufacturer, and measurement method.

Other requirements for compliance with radiation protection regulations

In order to map the complete operation of a nuclear medicine facility, other issues not directly related to the testing of measuring equipment must be addressed. For example, work instructions must be made available to the departments, regulations must be made accessible, approvals must be issued, and incidents during operation must be documented.

Mann prüft Daten auf PC und Tablet

Goal identification

Based on the requirements and the corresponding legal situation, an application was to be developed that would enable all legal requirements to be met, from the testing and documentation of measuring instruments to the provision of information and the documentation of incidents in facility operations.

The application required the implementation of two key components: a server-side application for managing clients, users, measurement series, documents, reports, and operations logs, and a mobile tablet application for recording measurement values and viewing instructions, requirements, and notices.

Challenging conditions

The legal requirements as well as the expected conditions in the practices and hospitals resulted in additional requirements for the solution to be designed. For example, automating reporting while taking into account strict authentication of report recipients was a relevant challenge. The fact that the majority of users document measurement results in areas without access to the Internet required the integration of an offline functionality with time-delayed data synchronization.

Technical challenge

The biggest technical hurdle was to understand the physical relationships of the different device types and measurement methods and to transfer them into a homogeneous modeling and implementation. In the process, more than 20 similar but not identical data structures were identified. In order to express the series types and limit value calculations, which are based on radioactive decay on the one hand and on continuity on the other, in a generally valid model, a generic schema was designed whose expressions were enabled to map the required polymorphisms with the aid of single-table inheritance.

Preview eines Messungsdiagramms für Smartarchivo, ein Projekt von Chroma Experience (Chroma X)
Diagram
Screenshot in Smartarchivo, ein Projekt von Chroma Experience (Chroma X)
Chart

Product design

Based on the various requirements, we designed a product that aims at intuitive and understandable usability in order to keep the complexity of the underlying processes as far away from the user as possible. The basic idea was to offer the user only those options that are needed to perform a single task in the respective context. The resulting clarity of the user interface allows the user to accomplish the task at hand in a short time without context switching and with minimal cognitive challenge.

To ensure that the concept can be applied in general, all relevant processes were transferred into user flows from the user's perspective and validated. In this way, we were able to ensure that the basic concept can be derived for all application scenarios.

Artboard für Smartarchivo, ein Projekt von Chroma Experience (Chroma X)

In order to be able to reduce the interfaces for operating the application as much as possible, we have planned an extremely fine-grained role and rights management. With the help of this, the range of functions - and thus also the options of the interfaces - can be minimally configured for each individual user according to requirements.

In order to define the individual views required on the basis of the planned product features, wireframes were created for the majority of the complex use cases, anticipating future implementation. Based on the wireframes, we created a foundation at an early stage of the product development that allowed us and our client to ensure functional correctness, technical feasibility and optimal usability.

Wireframes für Smartarchivo, ein Projekt von Chroma Experience (Chroma X)

User interface design

Following the design concept, we elaborated the user interfaces of the mobile application and the web application as modular libraries. From design to implementation, we placed great emphasis on creating reusable components that follow an atomic approach. This means that we can fall back on these components when integrating further product features, which leads to the user finding a uniform operating concept and stringent functional principles. In addition, the use of already known, established and tested components is extremely efficient and significantly reduces the error rate.

User Interface für Smartarchivo, ein Projekt von Chroma Experience (Chroma X)

To accommodate the different device-immanent operating concepts of the tablet and web application, the two component libraries differ significantly. Operation with the help of a pointing device - such as a mouse - has different requirements than operation by touch input. Thus, there is a great deal of agreement in the general product-specific style, but significant differences in the individual UI elements relevant to operation, such as buttons, input or navigation elements.

Tablet application

The tablet application was implemented as a native Android application. The range of functions is tailored so that a user can easily and conveniently document measured values, read process instructions and notes, and write logbook entries with the help of the tablet.

The most relevant use case is the recording of measured values, which is why we paid the greatest attention to this. In order to provide the user with feedback on the plausibility of the measurements, we have integrated the complex calculation logic for determining the reaction thresholds and tolerance limits for individual types of measurement series into both the server-side application and the tablet application. In this way, the user is directly shown whether the values he or she has recorded fall within the expected range.

Screenshot in Smartarchivo, ein Projekt von Chroma Experience (Chroma X)
Screenshot in Smartarchivo, ein Projekt von Chroma Experience (Chroma X)

Server-side application

The server-side application was implemented using our Propeller web application framework. In doing so, we implemented a project-specific UI kit in order to be able to work with a component library here as well, which simplifies the future integration of further product features.

Account Gruppen in Smartarchivo, ein Projekt von Chroma Experience (Chroma X)
Web application - basic interface

At the API level, RESTful JSON is used as the protocol. We chose JSON web tokens as the authentication method. Statelessness at the protocol level makes it easy to solve some of the issues that arise from offline requests.

API endpoints are routed directly to controller implementations, which perform authorization checks and data plausibility at instantiation. This ensures that unauthorized or invalid accesses are rejected even before controller methods are executed.

A PostgreSQL database is used as persistence system.

The API documentation is provided directly by the framework, including sample requests, which greatly simplifies the development of API clients.

Reporting

The reporting of the measurement series documentation can be configured using the web application in such a way that the relevant measurement series for selected devices and a specific time period are summarized in a report. The report is supplemented by an extract from the logbook for the selected period.

For each report, a non-guessable URL is generated based on UUIDs and assigned an access key. This information can then be passed on to the relevant supervisory authority. The content and preparation of the report data has been fine-tuned to ensure that it is accepted by the authorities.

Stefan Boy
Stefan Boy Smartarchivo Product Owner

The initially small software became a really big project thanks to competent consulting and pointing out possibilities, thanks to which we can offer our customers a professional software solution today.
We can recommend the development team to anyone who is looking for an individual solution adapted to their needs.

Testing and distribution

In order to be able to continuously maintain and develop the product without jeopardizing the stability and performance of the existing functionality, test scenarios were designed for all API endpoints and the required tests were defined. In this way, both function and performance can be tested automatically as part of black-box tests. This involves running the test scenarios for an appropriately prepared client and validating the results at the protocol and response level, as well as checking them against performance budgets.

The tests are performed when each new version is transferred to the version control system. Only after passing all test scenarios can the respective version be released to the staging or production environment. Thus, different versions are available at different stages.

All commissioning actions, such as build, testing and stage-based distribution, are configured, versioned and executed within the CI/CD functionality of the version control system.

Tablet-Preview von Smartarchivo, ein Projekt von Chroma Experience (Chroma X)
Project management
Paul Lewandowski
Requirements Engineering
Martin Brecht-Precht
Design-Lead
Martin Brecht-Precht
Technology-Lead, Architecture
Torsten Krause
UX-Research, UX-Design
Florian Köppe
Backend-Development
Andrius Baliutis
Interface-Design
Ilona Maslioukovskagia
Frontend-Development
Michael Seelisch

Next Project

inotec Barcode Security GmbH Consulting ⟶ Architecture ⟶ UX-Design ⟶ UI-Design ⟶ Full-Stack-Development

inoVerify — Guarantee authenticity and gain customer data

Show project