architecture-as-code
architecture-as-code copied to clipboard
Enhancement: Improve Flow Sequence Diagram Generation Using Full CALM Model
Summary
Currently, flow sequence diagram generation in CALM relies only on relationship names, limiting the depth and accuracy of the diagrams. With the recent support for dereferencing the full CALM model (#1026), it is now possible to extract richer details for sequence diagrams.
Proposed Changes
-
Leverage the Fully Dereferenced Model:
- Extract
source,target,interaction details, andmetadatafrom the fully dereferenced model instead of relying on relationship names. - Ensure that all necessary properties (e.g.,
actionType,protocol,messageFormat) are available for generating diagrams.
- Extract
-
Enhance Diagram Labeling & Formatting:
- Improve labeling by including interaction types, protocols, and message details.
- Ensure generated diagrams provide better clarity and meaningful representations.
-
Maintain Backward Compatibility:
- Ensure that existing diagrams using relationship names continue to function as expected.
- Provide a fallback mode if full dereferencing is not available.
Benefits
- More Accurate Representations: Sequence diagrams will fully reflect how interactions occur within the system.
- Better Maintainability: Aligns sequence diagrams with the improved CALM model structure.
- Richer Visualizations: By incorporating additional metadata, diagrams provide a clearer understanding of system flows.