Single Source Of Truth

This document covers information about the wunderbon SSOT and how to deal with it

πŸ‘

TL;DR

This is what Wikipedia} says about SSOT (SPOT):

"In information systems design and theory, single source of truth (SSOT) is the practice of structuring information models and associated data schema such that every data element is mastered (or edited) in only one place. Any possible linkages to this data element (possibly in other areas of the relational schema or even in distant federated databases) are by reference only. Because all other locations of the data just refer back to the primary "source of truth" location, updates to the data element in the primary location propagate to the entire system without the possibility of a duplicate value somewhere being forgotten ..."

At wunderbon we do handle data with care and with trust in our Single Source Of Truth. From data models over data transfer objects (DTO) and validation rules to our persistence layer.

64

Data Models For Everyone

One of our promises to you is that we provide you with always up to date JSON Schemas (more about those schemas here) as blueprints (SSOT) e.g. for generating data models/classes. The schemas can be used to easily compose data structures when working with the wunderbon API. We have started to do this for the following languages:

βœ”βœ–βœ–
TypeScriptJavaGo
JavaScriptC++Kotlin
Objective-CDart
SwiftFlow
Ruby
Rust
Elm
Python
C#

The bold ones in the first column are our inhouse first class citizens. The models for languages used in app development (second column) will follow soon and then we start providing data models for the last column to enable others (e.g. POS-Software Providers) to easy develop wunderbon API integrations. Until we reach this milestone we will assist our partners in generating data models for every single language listed above. Connecting with wunderbon and exchanging data as it should be.

Strict Versioning

We use the same versioning scheme (Semantic Versioning 2.0.0) as we do for all other parts of the wunderbon ecosystem (e.g. API, App, ...). So you can always rely on up to date schemas and matching data models for each step of the wunderbon API evolution.

JSON-Schemas as Blueprints

wunderbon provides JSON-Schemas as blueprints to easily compose data structures or validate data structures even before sending them to wunderbon. For more information on the schemas and links to code repositories or npmjs have a look at Libraries & Open Source.


What’s Next

Continue with our guided tour. Now, we go over to General information about the wunderbon API endpoints ...