一句话:发布 ARDoCo 工具全景,以 REST API、TraceView 和 TraceViz 降低架构追踪链接恢复的使用门槛。
软件开发产生架构文档(SAD)、架构模型(SAM)与源代码等关联制品,其关系对维护和一致性检查至关重要,但自动追踪链接恢复(TLR)难以落地。本文提出 ARDoCo 工具全景:REST API 以 HTTP 端点暴露 SAD-SAM、SAM-Code、SAD-Code、SAD-SAM-Code 四条 TLR 流水线,支持异步执行与缓存;TraceView 是浏览器前端,用向导和多面板交互探索恢复的链接与不一致;TraceViz 是 VS Code 扩展,将追踪链接直接叠加到 IDE 文档中。三个组件均已公开部署可用。初步研究显示 TraceViz 的 IDE 内可视化提升了开发者在软件理解任务中的理解,使先进 TLR 可被架构师、开发者和工具集成者使用。
Context and Problem. Software development produces interrelated artifacts like software architecture documentation (SAD), software architecture models (SAMs), and source code, whose relationships are essential for maintenance and consistency checking. However, automatically recovering links between these artifacts (traceability link recovery (TLR)) remains difficult to deploy in practice. Method and Aim. We present an accessible tool landscape for ARDoCo’s TLR approaches: the ARDoCo REST API exposes four TLR pipelines (SAD-SAM, SAM-Code, SAD-Code, and SAD-SAM-Code) via HTTP endpoints with asynchronous execution and caching; TraceView is a browser-based frontend with a guided wizard and interactive multi-panel exploration of recovered links and inconsistencies; and TraceViz, which is a VS Code extension that overlays trace links directly onto documentation in the IDE. Results and Conclusion. All three components are publicly deployed and usable. A preliminary study for TraceViz’s in-IDE visualization confirmed that it improves developer comprehension during software understanding tasks. The tool landscape makes state-of-the-art TLR accessible to architects, developers, and tool integrators. Video. We provide a screencast of our ARDoCo Tool Landscape and how it is used here: https://youtu.be/IOTEPZQ3tVs
@inproceedings{abs-2606-28064,
title = {The ARDoCo Tool Landscape: REST API, TraceView, and TraceViz for Architecture Traceability},
author = {Jan Keim and Dominik Fuchß and Sophie Corallo and Tobias Hey and Julian Winter and Kevin Feichtinger},
booktitle = {ASE},
year = {2026},
doi = {10.1145/3832783.3834621}
}