Skip to content

Conversation

@slawr
Copy link
Collaborator

@slawr slawr commented Nov 18, 2024

WIP do not merge without first talking to the originator

After discussion in the Data Architecture team meetings (see Sept-Nov) the C4 Model was adopted for discussing and communicating the Playground s/w architecture.

As a starting point introduce the diagram files to the source base for reference.

@slawr slawr added documentation Improvements or additions to documentation task Task not fitting other labels, e.g. project ops labels Nov 18, 2024
@slawr slawr linked an issue Nov 18, 2024 that may be closed by this pull request
3 tasks
After discussion in the Data Architecture team meetings (see Sept-Nov
minutes) the C4 Model (www.c4model.com) was adopted for visualising the
Playground s/w architecture.

This commit introduces the top two levels of abstraction:
1. The level 1 System context diagram which shows how the Playground is
related to the surrounding software systems with which it communicates.
2. The level 2 Container diagram which shows the containers (C4 model
term) which make up the Playground.

Integration note:
Source for these diagrams was the working file used in the team discussions
currently hosted in the group google drive as CDSP-C4-Model.drawio.svg.
That file has multiple tabs, each holding a diagram. The tabs were
exported to separate files to make referencing diagrams easier.

Signed-off-by: Stephen Lawrence <[email protected]>
To help people navigating the sources reference the assets folder in
the online documentation tree as another source of diagrams.

Signed-off-by: Stephen Lawrence <[email protected]>
@slawr slawr force-pushed the introduce-c4-model branch from ec9e5eb to a8164ad Compare November 26, 2024 16:36
@slawr slawr changed the title [WIP] Introduce C4 Model diagrams to CDSP Introduce C4 Model diagrams to CDSP Nov 26, 2024
@slawr
Copy link
Collaborator Author

slawr commented Nov 26, 2024

Removed WIP from title. PR is ready for review for possible merging.

@chrizmc would you like to take this on as your first review and merge?

@chrizmc chrizmc merged commit d9418e5 into COVESA:main Nov 29, 2024
1 check passed
@slawr slawr deleted the introduce-c4-model branch November 29, 2024 15:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation task Task not fitting other labels, e.g. project ops

Projects

Development

Successfully merging this pull request may close these issues.

Add C4 Model diagrams to the github

2 participants