Skip to content

Latest commit

 

History

History
67 lines (55 loc) · 3.13 KB

requirements-modeling.md

File metadata and controls

67 lines (55 loc) · 3.13 KB

Modeling guidelines for the requirements

Module entity

Field Type Description
Title String A short string capturing the module's context
ID GUPRI Globally unqiue and resolveable identifier of the module
Description String Medium length text to describe the purpose of the module
Creation Date Date First insertion of the module to the requirements list
Scope String Description what cases are covered by this module and which not
Responsible String Email Address or github id of the responsible user
Linked terms List of URIs Link terms of ontologies that are relevant
Requirements List of Requirements All requirements for the module

Think about stakeholders for the module.

Example

Title Time series
ID MODULE-TIMESERIES
Description A time series is a mapping of a point or range in time towards a value. The value at this point can be a scalar / primitive or multidimensional.
Creation date 2024-08-15
Scope This module is focusing explicitly on any type of data set that is a mapping as described above. It does specify the characteristics of the represented data. It can link to additional modules like sensor information or database information if applicable.
Responsible philipp.schmurr@kit.edu
Linked terms http://purl.obolibrary.org/obo/NCIT_C181915
Requirements see example below

Requirement entity

Field Type Description
Title String A short string capturing the requirement's context
ID GUPRI Globally unqiue and resolveable identifier of the requirement (e.g. concat module with name part)
Description String Medium length text to describe the specification of the requirement and why it is needed
Creation Date Date First insertion of the requirement to the list
Linked terms List of URIs Link terms of ontologies that are relevant
Solution idea Text Describe a potential solution that satisfies the requirement
Priority Integer A integer to describe priority - lower is higher (Range [1-5])

Example

Title Metadata serialization formats need to be standardized
ID REQ-METADATA-FORMATS
Description To guarantee widespread compatibility it is necessary to rely on data formats that are widely accepted in the real world and most languages / frameworks and tools can handle that kind of data, more precisely most tools and frameworks should natively support parsing and serializing it
Creation date 2024-08-15
Linked terms http://purl.obolibrary.org/obo/NCIT_C171252, http://edamontology.org/format_1915, https://schema.org/encodingFormat
Solution idea In general, metadata in an RDF format is preferred since it enables it to be stored in triple store databases. This means the preferred serialization formats are RDF/XML, JSON-LD, Turtle, N3 and Ntriples. Nevertheless, other standardized formats as XML, JSON, YAML and TOML are also valid and can be used.
Priority 3

Priority is an important field and should be added.

Template

Title
ID REQ-
Description
Creation date 2024-08-15
Linked terms
Solution idea
Priority 5