Conformance Assessment of Architectural Design Decisions on the Mapping of Domain Model Elements to APIs and API Endpoints: Dataset and Code

This is the dataset and related code artifact for the article "Conformance Assessment of Architectural Design Decisions on the Mapping of Domain Model Elements to APIs and API Endpoints". <strong>Abstract of the article:</strong> Microservice APIs are often identified and designed based on Domain-Driven Design (DDD). To help in the continuous analysis of mappings of domain model elements to APIs and API endpoints, we aim to automate the assessment of conformance to Architectural Design Decision (ADD) options. The ADDs, their decision options, and relevant decision drivers studied in this paper originate from an empirical study on the mapping of domain model elements to APIs and API endpoints in practice. We propose automated detectors to detect the decision options of the ADDs taken in a given microservice API model, and an assessment scoring scheme based on the empirical knowledge codified in the ADDs. We evaluate our work, by first manually creating a ground truth for 14 cases in a multi-case study, and then comparing the results of our automated detectors to the ground truth for each of the 14 cases. In the cases we were able to identify 86\% of the decision points correctly, and a statistical analysis of our data shows only a negligible effect size for differences to the ground truth.本数据集及相关代码工件配套于论文《领域模型元素到API及API端点映射的架构设计决策符合性评估》（Conformance Assessment of Architectural Design Decisions on the Mapping of Domain Model Elements to APIs and API Endpoints）。论文摘要：微服务API通常基于领域驱动设计（Domain-Driven Design，DDD）进行识别与设计。为支持对领域模型元素到API及API端点的映射关系开展持续性分析，本文旨在实现架构设计决策（Architectural Design Decision，ADD）选项符合性评估的自动化。本文所研究的架构设计决策、其决策选项及相关决策动因，均源自一项针对实际场景中领域模型元素到API及API端点映射的实证研究。本文提出了自动化检测器，用于识别给定微服务API模型中所采用的架构设计决策选项，并基于架构设计决策中编纂的实证知识构建了评估评分体系。为验证所提方法的有效性，本文首先在多案例研究中为14个案例手动构建了基准真值（ground truth），随后将自动化检测器的输出结果与这14个案例各自的基准真值进行对比。在本次研究的案例中，我们能够正确识别86%的决策节点；对数据的统计分析显示，其与基准真值之间的差异仅具有可忽略的效应量。