From e1175237ce2e4572a3560f90b889602591f0d06a Mon Sep 17 00:00:00 2001
From: Romain Vasseur <57908971+RVR06@users.noreply.github.com>
Date: Thu, 13 Jun 2024 12:02:55 +0200
Subject: [PATCH] Initial commit
---
.editorconfig | 7 +
.github/CODEOWNERS | 1 +
.github/workflows/gh-pages.yaml | 86 ++
.gitignore | 15 +
CONTRIBUTING.md | 10 +
LICENSE | 21 +
README.md | 199 ++++
bonus stage 01/README.md | 78 ++
.../structurizr-1-HexagonalArchitecture.svg | 1 +
bonus stage 01/workspace.dsl | 28 +
bonus stage 02/.dockerignore | 28 +
bonus stage 02/Dockerfile | 31 +
bonus stage 02/README.md | 210 ++++
bonus stage 02/dockerfile.png | Bin 0 -> 72391 bytes
bonus stage 02/sbom.png | Bin 0 -> 111235 bytes
bonus stage 02/sbom/sbom.txt | 5 +
bonus stage 02/sbom/sbom_cyclonedx.json | 6 +
bonus stage 02/sbom/sbom_spdx.json | 9 +
bonus stage 02/sbom/sbom_syft.json | 20 +
bonus stage 02/source.dsl | 221 ++++
.../structurizr-1-DevDeployment-iconic.png | Bin 0 -> 327419 bytes
.../structurizr-1-DevDeployment-mixed.png | Bin 0 -> 257740 bytes
.../structurizr-1-DevDeployment-semantic.svg | 1 +
.../structurizr-1-ProdDeployment-iconic.png | Bin 0 -> 584430 bytes
.../structurizr-1-ProdDeployment-mixed.png | Bin 0 -> 473796 bytes
.../structurizr-1-ProdDeployment-semantic.svg | 1 +
bonus stage 02/tooltip.png | Bin 0 -> 137751 bytes
bonus stage 02/workspace.dsl | 238 ++++
bonus stage 03/README.md | 94 ++
.../structurizr-1-HubDeployment.svg | 1 +
bonus stage 03/structurizr-1-Landscape.svg | 1 +
.../structurizr-1-WebAppDeployment.svg | 1 +
.../structurizr-1-WebAssemblyDeployment.svg | 1 +
.../structurizr-1-WebAssemblyDeployment2.svg | 1 +
.../structurizr-1-WebServerDeployment.svg | 1 +
bonus stage 03/workspace.dsl | 139 +++
bonus stage 04/README.md | 158 +++
bonus stage 04/source.dsl | 30 +
.../structurizr-1-SystemContext-denoised.svg | 1 +
.../structurizr-1-SystemContext.svg | 1 +
...structurizr-1-SystemLandscape-denoised.svg | 1 +
.../structurizr-1-SystemLandscape.svg | 1 +
.../structurizr-1-TechStack-raw.svg | 1 +
bonus stage 04/structurizr-1-TechStack.svg | 1 +
bonus stage 04/workspace.dsl | 61 +
docs/.gitattributes | 1 +
docs/assets/icons/logo.svg | 12 +
docs/compose.yaml | 11 +
docs/config.toml | 86 ++
docs/content/_index.html | 52 +
docs/content/docs/_index.md | 18 +
docs/content/docs/adr.md | 143 +++
docs/content/docs/c4-model.md | 119 ++
docs/content/docs/code.md | 135 +++
docs/content/docs/convention.md | 106 ++
docs/content/docs/mila.md | 56 +
docs/content/docs/project-lifecycle.md | 104 ++
docs/content/docs/sketch.md | 102 ++
docs/content/docs/toolchain.md | 16 +
docs/content/docs/usage.md | 64 ++
docs/go.mod | 8 +
docs/go.sum | 8 +
docs/package-lock.json | 1003 +++++++++++++++++
docs/package.json | 15 +
docs/static/assets/adaptive.svg | 1 +
docs/static/assets/adr/001.jpg | Bin 0 -> 138837 bytes
docs/static/assets/adr/005.jpg | Bin 0 -> 456377 bytes
docs/static/assets/adr/018.jpg | Bin 0 -> 175429 bytes
docs/static/assets/adr/consequence.jpg | Bin 0 -> 173133 bytes
docs/static/assets/adr/context.jpg | Bin 0 -> 144363 bytes
docs/static/assets/adr/correlation.png | Bin 0 -> 24333 bytes
docs/static/assets/adr/date.jpg | Bin 0 -> 1357145 bytes
docs/static/assets/adr/decision.jpg | Bin 0 -> 129027 bytes
docs/static/assets/adr/graph.png | Bin 0 -> 21391 bytes
docs/static/assets/adr/identity.jpg | Bin 0 -> 288317 bytes
docs/static/assets/adr/plan.jpg | Bin 0 -> 58391 bytes
docs/static/assets/adr/status.jpg | Bin 0 -> 273950 bytes
docs/static/assets/adr/timeline.png | Bin 0 -> 32776 bytes
docs/static/assets/adr/travel.jpg | Bin 0 -> 577611 bytes
docs/static/assets/brand.png | Bin 0 -> 29630 bytes
docs/static/assets/c4-lwd.svg | 1 +
docs/static/assets/c4-real.svg | 1 +
docs/static/assets/c4.svg | 1 +
docs/static/assets/compare-best.svg | 1 +
docs/static/assets/compare-good.svg | 1 +
docs/static/assets/compare-wrong.svg | 1 +
docs/static/assets/consistency.svg | 1 +
docs/static/assets/convention.svg | 1 +
docs/static/assets/cornifer-C4L.svg | 1 +
docs/static/assets/deploy.svg | 1 +
docs/static/assets/develop.svg | 1 +
docs/static/assets/document.svg | 1 +
docs/static/assets/dsl.svg | 1 +
docs/static/assets/highlighting.gif | Bin 0 -> 4846961 bytes
docs/static/assets/hover.png | Bin 0 -> 209954 bytes
docs/static/assets/intellisense.png | Bin 0 -> 20025 bytes
docs/static/assets/map.png | Bin 0 -> 952553 bytes
docs/static/assets/map_00.jpg | Bin 0 -> 104071 bytes
docs/static/assets/map_01.jpg | Bin 0 -> 15305 bytes
docs/static/assets/map_02.jpg | Bin 0 -> 15690 bytes
docs/static/assets/map_03.jpg | Bin 0 -> 39089 bytes
docs/static/assets/market.svg | 1 +
docs/static/assets/mila_4.1.svg | 1 +
docs/static/assets/mila_4.2.svg | 1 +
docs/static/assets/mila_4.3.svg | 1 +
docs/static/assets/mila_4.4.svg | 1 +
docs/static/assets/mvvm_01.svg | 1 +
docs/static/assets/mvvm_02.svg | 1 +
docs/static/assets/outline.png | Bin 0 -> 133517 bytes
docs/static/assets/pattern.svg | 1 +
docs/static/assets/plan.jpg | Bin 0 -> 63483 bytes
docs/static/assets/pov_01.svg | 1 +
docs/static/assets/pov_02.svg | 1 +
docs/static/assets/pov_03.svg | 1 +
docs/static/assets/reality.jpg | Bin 0 -> 117956 bytes
docs/static/assets/scope.svg | 1 +
docs/static/assets/semantic.gif | Bin 0 -> 154444 bytes
docs/static/assets/shape.svg | 1 +
docs/static/assets/shapes.svg | 1 +
docs/static/assets/size.svg | 1 +
docs/static/assets/spot.svg | 1 +
docs/static/assets/structurizr_01.svg | 1 +
docs/static/assets/structurizr_02.svg | 1 +
docs/static/assets/structurizr_03.svg | 1 +
docs/static/assets/structurizr_04.svg | 1 +
docs/static/assets/structurizr_05.png | Bin 0 -> 9380 bytes
docs/static/assets/structurizr_06.svg | 1 +
docs/static/assets/structurizr_07.png | Bin 0 -> 67254 bytes
docs/static/assets/structurizr_08.png | Bin 0 -> 53405 bytes
docs/static/assets/structurizr_09.svg | 1 +
docs/static/assets/structurizr_10.svg | 1 +
docs/static/assets/structurizr_11.png | Bin 0 -> 348526 bytes
docs/static/assets/structurizr_12.svg | 1 +
docs/static/assets/structurizr_13.png | Bin 0 -> 40768 bytes
docs/static/assets/structurizr_14.jpg | Bin 0 -> 9407 bytes
docs/static/assets/structurizr_15.png | Bin 0 -> 95963 bytes
docs/static/assets/sustainability.jpg | Bin 0 -> 22547 bytes
docs/static/assets/tailor.svg | 1 +
docs/static/assets/theme_01.svg | 1 +
docs/static/assets/theme_02.svg | 1 +
docs/static/assets/theme_03.svg | 1 +
stage 00/prereq.md | 133 +++
stage 00/specs.md | 31 +
stage 01/README.md | 160 +++
stage 01/structurizr-1-SystemContext.svg | 1 +
stage 01/structurizr-1-SystemLandscape.svg | 1 +
stage 01/workspace.dsl | 11 +
stage 02/README.md | 95 ++
stage 02/structurizr-1-SystemContext.svg | 1 +
stage 02/structurizr-1-SystemLandscape.svg | 1 +
stage 02/theme.dslf | 7 +
stage 02/workspace.dsl | 24 +
stage 03/README.md | 198 ++++
stage 03/structurizr-1-SystemContext-01.svg | 1 +
stage 03/structurizr-1-SystemContext-02.svg | 1 +
stage 03/structurizr-1-SystemContext-03.svg | 1 +
stage 03/structurizr-1-SystemContext.svg | 1 +
stage 03/structurizr-1-SystemLandscape-01.svg | 1 +
stage 03/structurizr-1-SystemLandscape-02.svg | 1 +
stage 03/structurizr-1-SystemLandscape-03.svg | 1 +
stage 03/structurizr-1-SystemLandscape.svg | 1 +
stage 03/theme.dslf | 18 +
stage 03/workspace.dsl | 35 +
stage 04/README.md | 161 +++
stage 04/structurizr-1-SystemContext.svg | 1 +
stage 04/structurizr-1-SystemLandscape.svg | 1 +
stage 04/theme.dslf | 24 +
stage 04/workspace.dsl | 37 +
stage 05/README.md | 144 +++
stage 05/structurizr-1-Container.svg | 1 +
stage 05/theme.dslf | 40 +
stage 05/workspace.dsl | 60 +
stage 06/README.md | 109 ++
stage 06/structurizr-1-mila_mobile-4_3.svg | 1 +
stage 06/theme.dslf | 46 +
stage 06/workspace.dsl | 75 ++
stage 07/README.md | 154 +++
.../structurizr-1-mila-workflow-hybrid.svg | 1 +
...cturizr-1-mila-workflow-mobile-refined.svg | 1 +
.../structurizr-1-mila-workflow-mobile.svg | 1 +
stage 07/theme.dslf | 48 +
stage 07/workspace.dsl | 103 ++
stage 08/README.md | 264 +++++
stage 08/instances.svg | 1 +
stage 08/structurizr-1-DevDeployment-01.svg | 1 +
stage 08/structurizr-1-DevDeployment-02.svg | 1 +
stage 08/structurizr-1-DevDeployment-03.svg | 1 +
.../structurizr-1-DevDeployment-instances.svg | 1 +
stage 08/structurizr-1-DevDeployment.svg | 1 +
stage 08/theme.dslf | 50 +
stage 08/workspace.dsl | 141 +++
stage 09/README.md | 520 +++++++++
...cturizr-1-ProdDeployment-colored-style.svg | 1 +
.../structurizr-1-ProdDeployment-draft.svg | 1 +
...Deployment-group-missing-relationships.svg | 1 +
...rodDeployment-group-relationships-back.svg | 1 +
...ucturizr-1-ProdDeployment-health-check.svg | 1 +
.../structurizr-1-ProdDeployment-nogroup.svg | 1 +
.../structurizr-1-ProdDeployment-nostyle.svg | 1 +
stage 09/structurizr-1-ProdDeployment.svg | 1 +
stage 09/theme-health-check.dslf | 14 +
stage 09/theme.dslf | 60 +
stage 09/workspace.dsl | 210 ++++
stage 10/README.md | 174 +++
stage 10/structurizr-1-DevDeployment.png | Bin 0 -> 232639 bytes
stage 10/structurizr-1-DevDeployment.svg | 1 +
stage 10/structurizr-1-ProdDeployment.png | Bin 0 -> 464570 bytes
stage 10/structurizr-1-ProdDeployment.svg | 1 +
stage 10/structurizr-1-mila_mobile-4_3.png | Bin 0 -> 127424 bytes
stage 10/structurizr-1-mila_mobile-4_3.svg | 1 +
stage 10/theme-deploy.dslf | 23 +
stage 10/theme.dslf | 60 +
stage 10/workspace.dsl | 211 ++++
stage 11/README.md | 98 ++
...tructurizr-1-Container-frontend-filter.svg | 1 +
stage 11/structurizr-1-Container-full.svg | 1 +
.../structurizr-1-Container-mobile-filter.svg | 1 +
stage 11/workspace.dsl | 213 ++++
stage 12/README.md | 101 ++
stage 12/structurizr-1-Container-full.svg | 1 +
stage 12/workspace.dsl | 228 ++++
stage 13/README.md | 92 ++
stage 14/README.md | 81 ++
stage 14/doc-activation.png | Bin 0 -> 95963 bytes
stage 14/doc-menu.png | Bin 0 -> 16176 bytes
stage 14/docs/c4.md | 41 +
stage 14/embed.png | Bin 0 -> 53826 bytes
stage 14/export.png | Bin 0 -> 16316 bytes
stage 14/workspace.dsl | 230 ++++
stage 15/README.md | 59 +
stage 15/docs/c4.md | 41 +
stage 15/structurizr-1-Container-full.svg | 1 +
stage 15/workspace.dsl | 234 ++++
stage 16/README.md | 135 +++
stage 16/fragments/observability.model.dslf | 26 +
stage 16/fragments/observability.views.dslf | 4 +
stage 16/structurizr-1-Container-full.svg | 1 +
stage 16/structurizr-1-Observability-C4-2.svg | 1 +
.../structurizr-1-SystemLandscape-raw.svg | 1 +
stage 16/structurizr-1-SystemLandscape.svg | 1 +
stage 16/workspace.dsl | 239 ++++
stage 17/README.md | 215 ++++
.../core/fragments/observability.model.dslf | 26 +
.../core/fragments/observability.views.dslf | 4 +
stage 17/core/workspace.dsl | 230 ++++
stage 17/structurizr-1-Container-full.svg | 1 +
stage 17/structurizr-1-mila_mobile-4_3.svg | 1 +
stage 17/structurizr-1-what_s_next-raw.svg | 1 +
stage 17/structurizr-1-what_s_next.svg | 1 +
stage 17/workspace.dsl | 48 +
250 files changed, 9645 insertions(+)
create mode 100644 .editorconfig
create mode 100644 .github/CODEOWNERS
create mode 100644 .github/workflows/gh-pages.yaml
create mode 100644 .gitignore
create mode 100644 CONTRIBUTING.md
create mode 100644 LICENSE
create mode 100644 README.md
create mode 100644 bonus stage 01/README.md
create mode 100644 bonus stage 01/structurizr-1-HexagonalArchitecture.svg
create mode 100644 bonus stage 01/workspace.dsl
create mode 100644 bonus stage 02/.dockerignore
create mode 100644 bonus stage 02/Dockerfile
create mode 100644 bonus stage 02/README.md
create mode 100644 bonus stage 02/dockerfile.png
create mode 100644 bonus stage 02/sbom.png
create mode 100644 bonus stage 02/sbom/sbom.txt
create mode 100644 bonus stage 02/sbom/sbom_cyclonedx.json
create mode 100644 bonus stage 02/sbom/sbom_spdx.json
create mode 100644 bonus stage 02/sbom/sbom_syft.json
create mode 100644 bonus stage 02/source.dsl
create mode 100644 bonus stage 02/structurizr-1-DevDeployment-iconic.png
create mode 100644 bonus stage 02/structurizr-1-DevDeployment-mixed.png
create mode 100644 bonus stage 02/structurizr-1-DevDeployment-semantic.svg
create mode 100644 bonus stage 02/structurizr-1-ProdDeployment-iconic.png
create mode 100644 bonus stage 02/structurizr-1-ProdDeployment-mixed.png
create mode 100644 bonus stage 02/structurizr-1-ProdDeployment-semantic.svg
create mode 100644 bonus stage 02/tooltip.png
create mode 100644 bonus stage 02/workspace.dsl
create mode 100644 bonus stage 03/README.md
create mode 100644 bonus stage 03/structurizr-1-HubDeployment.svg
create mode 100644 bonus stage 03/structurizr-1-Landscape.svg
create mode 100644 bonus stage 03/structurizr-1-WebAppDeployment.svg
create mode 100644 bonus stage 03/structurizr-1-WebAssemblyDeployment.svg
create mode 100644 bonus stage 03/structurizr-1-WebAssemblyDeployment2.svg
create mode 100644 bonus stage 03/structurizr-1-WebServerDeployment.svg
create mode 100644 bonus stage 03/workspace.dsl
create mode 100644 bonus stage 04/README.md
create mode 100644 bonus stage 04/source.dsl
create mode 100644 bonus stage 04/structurizr-1-SystemContext-denoised.svg
create mode 100644 bonus stage 04/structurizr-1-SystemContext.svg
create mode 100644 bonus stage 04/structurizr-1-SystemLandscape-denoised.svg
create mode 100644 bonus stage 04/structurizr-1-SystemLandscape.svg
create mode 100644 bonus stage 04/structurizr-1-TechStack-raw.svg
create mode 100644 bonus stage 04/structurizr-1-TechStack.svg
create mode 100644 bonus stage 04/workspace.dsl
create mode 100644 docs/.gitattributes
create mode 100644 docs/assets/icons/logo.svg
create mode 100644 docs/compose.yaml
create mode 100644 docs/config.toml
create mode 100644 docs/content/_index.html
create mode 100644 docs/content/docs/_index.md
create mode 100644 docs/content/docs/adr.md
create mode 100644 docs/content/docs/c4-model.md
create mode 100644 docs/content/docs/code.md
create mode 100644 docs/content/docs/convention.md
create mode 100644 docs/content/docs/mila.md
create mode 100644 docs/content/docs/project-lifecycle.md
create mode 100644 docs/content/docs/sketch.md
create mode 100644 docs/content/docs/toolchain.md
create mode 100644 docs/content/docs/usage.md
create mode 100644 docs/go.mod
create mode 100644 docs/go.sum
create mode 100644 docs/package-lock.json
create mode 100644 docs/package.json
create mode 100644 docs/static/assets/adaptive.svg
create mode 100644 docs/static/assets/adr/001.jpg
create mode 100644 docs/static/assets/adr/005.jpg
create mode 100644 docs/static/assets/adr/018.jpg
create mode 100644 docs/static/assets/adr/consequence.jpg
create mode 100644 docs/static/assets/adr/context.jpg
create mode 100644 docs/static/assets/adr/correlation.png
create mode 100644 docs/static/assets/adr/date.jpg
create mode 100644 docs/static/assets/adr/decision.jpg
create mode 100644 docs/static/assets/adr/graph.png
create mode 100644 docs/static/assets/adr/identity.jpg
create mode 100644 docs/static/assets/adr/plan.jpg
create mode 100644 docs/static/assets/adr/status.jpg
create mode 100644 docs/static/assets/adr/timeline.png
create mode 100644 docs/static/assets/adr/travel.jpg
create mode 100644 docs/static/assets/brand.png
create mode 100644 docs/static/assets/c4-lwd.svg
create mode 100644 docs/static/assets/c4-real.svg
create mode 100644 docs/static/assets/c4.svg
create mode 100644 docs/static/assets/compare-best.svg
create mode 100644 docs/static/assets/compare-good.svg
create mode 100644 docs/static/assets/compare-wrong.svg
create mode 100644 docs/static/assets/consistency.svg
create mode 100644 docs/static/assets/convention.svg
create mode 100644 docs/static/assets/cornifer-C4L.svg
create mode 100644 docs/static/assets/deploy.svg
create mode 100644 docs/static/assets/develop.svg
create mode 100644 docs/static/assets/document.svg
create mode 100644 docs/static/assets/dsl.svg
create mode 100644 docs/static/assets/highlighting.gif
create mode 100644 docs/static/assets/hover.png
create mode 100644 docs/static/assets/intellisense.png
create mode 100644 docs/static/assets/map.png
create mode 100644 docs/static/assets/map_00.jpg
create mode 100644 docs/static/assets/map_01.jpg
create mode 100644 docs/static/assets/map_02.jpg
create mode 100644 docs/static/assets/map_03.jpg
create mode 100644 docs/static/assets/market.svg
create mode 100644 docs/static/assets/mila_4.1.svg
create mode 100644 docs/static/assets/mila_4.2.svg
create mode 100644 docs/static/assets/mila_4.3.svg
create mode 100644 docs/static/assets/mila_4.4.svg
create mode 100644 docs/static/assets/mvvm_01.svg
create mode 100644 docs/static/assets/mvvm_02.svg
create mode 100644 docs/static/assets/outline.png
create mode 100644 docs/static/assets/pattern.svg
create mode 100644 docs/static/assets/plan.jpg
create mode 100644 docs/static/assets/pov_01.svg
create mode 100644 docs/static/assets/pov_02.svg
create mode 100644 docs/static/assets/pov_03.svg
create mode 100644 docs/static/assets/reality.jpg
create mode 100644 docs/static/assets/scope.svg
create mode 100644 docs/static/assets/semantic.gif
create mode 100644 docs/static/assets/shape.svg
create mode 100644 docs/static/assets/shapes.svg
create mode 100644 docs/static/assets/size.svg
create mode 100644 docs/static/assets/spot.svg
create mode 100644 docs/static/assets/structurizr_01.svg
create mode 100644 docs/static/assets/structurizr_02.svg
create mode 100644 docs/static/assets/structurizr_03.svg
create mode 100644 docs/static/assets/structurizr_04.svg
create mode 100644 docs/static/assets/structurizr_05.png
create mode 100644 docs/static/assets/structurizr_06.svg
create mode 100644 docs/static/assets/structurizr_07.png
create mode 100644 docs/static/assets/structurizr_08.png
create mode 100644 docs/static/assets/structurizr_09.svg
create mode 100644 docs/static/assets/structurizr_10.svg
create mode 100644 docs/static/assets/structurizr_11.png
create mode 100644 docs/static/assets/structurizr_12.svg
create mode 100644 docs/static/assets/structurizr_13.png
create mode 100644 docs/static/assets/structurizr_14.jpg
create mode 100644 docs/static/assets/structurizr_15.png
create mode 100644 docs/static/assets/sustainability.jpg
create mode 100644 docs/static/assets/tailor.svg
create mode 100644 docs/static/assets/theme_01.svg
create mode 100644 docs/static/assets/theme_02.svg
create mode 100644 docs/static/assets/theme_03.svg
create mode 100644 stage 00/prereq.md
create mode 100644 stage 00/specs.md
create mode 100644 stage 01/README.md
create mode 100644 stage 01/structurizr-1-SystemContext.svg
create mode 100644 stage 01/structurizr-1-SystemLandscape.svg
create mode 100644 stage 01/workspace.dsl
create mode 100644 stage 02/README.md
create mode 100644 stage 02/structurizr-1-SystemContext.svg
create mode 100644 stage 02/structurizr-1-SystemLandscape.svg
create mode 100644 stage 02/theme.dslf
create mode 100644 stage 02/workspace.dsl
create mode 100644 stage 03/README.md
create mode 100644 stage 03/structurizr-1-SystemContext-01.svg
create mode 100644 stage 03/structurizr-1-SystemContext-02.svg
create mode 100644 stage 03/structurizr-1-SystemContext-03.svg
create mode 100644 stage 03/structurizr-1-SystemContext.svg
create mode 100644 stage 03/structurizr-1-SystemLandscape-01.svg
create mode 100644 stage 03/structurizr-1-SystemLandscape-02.svg
create mode 100644 stage 03/structurizr-1-SystemLandscape-03.svg
create mode 100644 stage 03/structurizr-1-SystemLandscape.svg
create mode 100644 stage 03/theme.dslf
create mode 100644 stage 03/workspace.dsl
create mode 100644 stage 04/README.md
create mode 100644 stage 04/structurizr-1-SystemContext.svg
create mode 100644 stage 04/structurizr-1-SystemLandscape.svg
create mode 100644 stage 04/theme.dslf
create mode 100644 stage 04/workspace.dsl
create mode 100644 stage 05/README.md
create mode 100644 stage 05/structurizr-1-Container.svg
create mode 100644 stage 05/theme.dslf
create mode 100644 stage 05/workspace.dsl
create mode 100644 stage 06/README.md
create mode 100644 stage 06/structurizr-1-mila_mobile-4_3.svg
create mode 100644 stage 06/theme.dslf
create mode 100644 stage 06/workspace.dsl
create mode 100644 stage 07/README.md
create mode 100644 stage 07/structurizr-1-mila-workflow-hybrid.svg
create mode 100644 stage 07/structurizr-1-mila-workflow-mobile-refined.svg
create mode 100644 stage 07/structurizr-1-mila-workflow-mobile.svg
create mode 100644 stage 07/theme.dslf
create mode 100644 stage 07/workspace.dsl
create mode 100644 stage 08/README.md
create mode 100644 stage 08/instances.svg
create mode 100644 stage 08/structurizr-1-DevDeployment-01.svg
create mode 100644 stage 08/structurizr-1-DevDeployment-02.svg
create mode 100644 stage 08/structurizr-1-DevDeployment-03.svg
create mode 100644 stage 08/structurizr-1-DevDeployment-instances.svg
create mode 100644 stage 08/structurizr-1-DevDeployment.svg
create mode 100644 stage 08/theme.dslf
create mode 100644 stage 08/workspace.dsl
create mode 100644 stage 09/README.md
create mode 100644 stage 09/structurizr-1-ProdDeployment-colored-style.svg
create mode 100644 stage 09/structurizr-1-ProdDeployment-draft.svg
create mode 100644 stage 09/structurizr-1-ProdDeployment-group-missing-relationships.svg
create mode 100644 stage 09/structurizr-1-ProdDeployment-group-relationships-back.svg
create mode 100644 stage 09/structurizr-1-ProdDeployment-health-check.svg
create mode 100644 stage 09/structurizr-1-ProdDeployment-nogroup.svg
create mode 100644 stage 09/structurizr-1-ProdDeployment-nostyle.svg
create mode 100644 stage 09/structurizr-1-ProdDeployment.svg
create mode 100644 stage 09/theme-health-check.dslf
create mode 100644 stage 09/theme.dslf
create mode 100644 stage 09/workspace.dsl
create mode 100644 stage 10/README.md
create mode 100644 stage 10/structurizr-1-DevDeployment.png
create mode 100644 stage 10/structurizr-1-DevDeployment.svg
create mode 100644 stage 10/structurizr-1-ProdDeployment.png
create mode 100644 stage 10/structurizr-1-ProdDeployment.svg
create mode 100644 stage 10/structurizr-1-mila_mobile-4_3.png
create mode 100644 stage 10/structurizr-1-mila_mobile-4_3.svg
create mode 100644 stage 10/theme-deploy.dslf
create mode 100644 stage 10/theme.dslf
create mode 100644 stage 10/workspace.dsl
create mode 100644 stage 11/README.md
create mode 100644 stage 11/structurizr-1-Container-frontend-filter.svg
create mode 100644 stage 11/structurizr-1-Container-full.svg
create mode 100644 stage 11/structurizr-1-Container-mobile-filter.svg
create mode 100644 stage 11/workspace.dsl
create mode 100644 stage 12/README.md
create mode 100644 stage 12/structurizr-1-Container-full.svg
create mode 100644 stage 12/workspace.dsl
create mode 100644 stage 13/README.md
create mode 100644 stage 14/README.md
create mode 100644 stage 14/doc-activation.png
create mode 100644 stage 14/doc-menu.png
create mode 100644 stage 14/docs/c4.md
create mode 100644 stage 14/embed.png
create mode 100644 stage 14/export.png
create mode 100644 stage 14/workspace.dsl
create mode 100644 stage 15/README.md
create mode 100644 stage 15/docs/c4.md
create mode 100644 stage 15/structurizr-1-Container-full.svg
create mode 100644 stage 15/workspace.dsl
create mode 100644 stage 16/README.md
create mode 100644 stage 16/fragments/observability.model.dslf
create mode 100644 stage 16/fragments/observability.views.dslf
create mode 100644 stage 16/structurizr-1-Container-full.svg
create mode 100644 stage 16/structurizr-1-Observability-C4-2.svg
create mode 100644 stage 16/structurizr-1-SystemLandscape-raw.svg
create mode 100644 stage 16/structurizr-1-SystemLandscape.svg
create mode 100644 stage 16/workspace.dsl
create mode 100644 stage 17/README.md
create mode 100644 stage 17/core/fragments/observability.model.dslf
create mode 100644 stage 17/core/fragments/observability.views.dslf
create mode 100644 stage 17/core/workspace.dsl
create mode 100644 stage 17/structurizr-1-Container-full.svg
create mode 100644 stage 17/structurizr-1-mila_mobile-4_3.svg
create mode 100644 stage 17/structurizr-1-what_s_next-raw.svg
create mode 100644 stage 17/structurizr-1-what_s_next.svg
create mode 100644 stage 17/workspace.dsl
diff --git a/.editorconfig b/.editorconfig
new file mode 100644
index 0000000..8426c2e
--- /dev/null
+++ b/.editorconfig
@@ -0,0 +1,7 @@
+root = true
+
+[*.{dsl, dslf}]
+charset = utf-8
+indent_style = space
+indent_size = 4
+trim_trailing_whitespace = true
\ No newline at end of file
diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS
new file mode 100644
index 0000000..8f9714f
--- /dev/null
+++ b/.github/CODEOWNERS
@@ -0,0 +1 @@
+* @rvr06
\ No newline at end of file
diff --git a/.github/workflows/gh-pages.yaml b/.github/workflows/gh-pages.yaml
new file mode 100644
index 0000000..751293c
--- /dev/null
+++ b/.github/workflows/gh-pages.yaml
@@ -0,0 +1,86 @@
+# https://gohugo.io/hosting-and-deployment/hosting-on-github/
+
+name: Build and deploy GitHub pages
+
+on:
+ push:
+ paths:
+ - 'docs/**'
+ - '.github/workflows/gh-pages.yml'
+ branches:
+ - main # Set a branch to deploy
+ pull_request:
+
+ # Enable manual workflow triggering from the Actions tab
+ workflow_dispatch:
+
+concurrency:
+ group: ${{ github.workflow }}-${{ github.ref }}
+
+env:
+ # Set the documentation root
+ documentation_root: './docs'
+
+jobs:
+ build:
+ permissions:
+ contents: read
+ runs-on: ubuntu-22.04
+ defaults:
+ run:
+ working-directory: ${{ env.documentation_root }}
+ steps:
+ - uses: actions/checkout@v3
+ with:
+ fetch-depth: 0
+ submodules: recursive
+ lfs: 'true'
+
+ - name: Setup Node
+ uses: actions/setup-node@v3
+ with:
+ node-version: 16
+ cache: 'npm'
+ cache-dependency-path: '${{ env.documentation_root }}/package-lock.json'
+
+ - name: Install dependencies
+ run: npm ci
+
+ - name: Setup Hugo
+ uses: peaceiris/actions-hugo@v2.6.0
+ with:
+ hugo-version: 0.123.8
+ extended: true
+
+ - name: Build
+ run: hugo --minify
+
+ - name: Upload artifact
+ uses: actions/upload-pages-artifact@v1
+ with:
+ path: ${{ env.documentation_root }}/public
+
+ deploy:
+ defaults:
+ run:
+ working-directory: ${{ env.documentation_root }}
+
+ if: github.ref == 'refs/heads/main'
+
+ # Add a dependency to the build job
+ needs: build
+
+ # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+ permissions:
+ pages: write # to deploy to Pages
+ id-token: write # to verify the deployment originates from an appropriate source
+
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+
+ runs-on: ubuntu-latest
+ steps:
+ - name: Deploy to GitHub Pages
+ id: deployment
+ uses: actions/deploy-pages@v1
diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..1a84629
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,15 @@
+# IDE
+.vscode/
+.vs/
+
+# Structurizr
+**/.structurizr/
+**/workspace.json
+
+# HUGO
+**/.hugo_build.lock
+**/resources
+**/public
+
+# NPM
+**/node_modules
\ No newline at end of file
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..13884c5
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,10 @@
+# Contributing
+
+Contributions from the community are welcome.
+To better understand the code repository, see the [README](https://github.com/rvr06/c4-bootcamp/blob/main/README.md).
+When contributing to this repository, please first discuss the change you wish to make by opening a [new issue](https://github.com/rvr06/c4-bootcamp/issues/new) or contributing to an [existing one](https://github.com/rvr06/c4-bootcamp/issues).
+
+## Pull Request Process
+
+* Branch must be prefixed e.g. `features/xxx`, `fixes/yyy` or `spikes/zzz`.
+* Create a Pull Request and ensure to attach an existing issue for tracking.
diff --git a/LICENSE b/LICENSE
new file mode 100644
index 0000000..ce7dbe2
--- /dev/null
+++ b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Structurizr Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
\ No newline at end of file
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ee7a13a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,199 @@
+# BOOTCAMP
+
+We introduced the concept of [architecture as code or code-first approach](https://rvr06.github.io/c4-bootcamp/docs/code). We took the opportunity to leverage [Structurizr tool suite](https://rvr06.github.io/c4-bootcamp/docs/code/#structurizr) to support the end-user journey. However, most of the journey focused on what one could expect to gain from a single model defined as code, without dwelling on how authoring this model for too long. It is now time to address this point.
+
+## What will you learn from this course
+
+Leveraging an hypothetical [requirement](./stage%2000/specs.md), this bootcamp will guide you over tiny stages to gradually define and refine a compelling `software model`. Alongside his journey, one will be exposed to multiple dimensions a `software model` should cover. Unfolding each stage will fuel the reader with insights regarding both the matching `structurizr` syntax and the underlying `C4` philosophy.
+
+> The course is self-directed learning. You can do it at whatever pace you wish.
+
+## How to get started
+
+Here’s how the `C4 bootcamp` works.
+
+### Use GitHub to Make Life Easy
+
+This GitHub repository contains `workspaces` and other assets you will need to complete the bootcamp.
+
+Thus, if you want to follow the bootcamp we recommend doing the following:
+
+- Sign up for [GitHub](https://github.com), if you haven’t already.
+- [Clone this repository](https://github.com/rvr06/c4-bootcamp.git) to your local machine.
+- As you go through the project, keep a web browser tab open to the [c4 bootcamp](https://github.com/rvr06/c4-bootcamp/blob/main/README.md) so you can read all of the instructions clearly and easily.
+
+### Bootcamp structure
+
+`C4 bootcamp` consists of `17 stages`:
+
+## [Stage 01](./stage%2001/README.md)
+
+
+
+
+
+
+
+
+## [Stage 02](./stage%2002/README.md)
+
+
+
+
+
+## [Stage 03](./stage%2003/README.md)
+
+
+
+
+## [Stage 04](./stage%2004/README.md)
+
+
+
+
+
+
+## [Stage 05](./stage%2005/README.md)
+
+
+
+
+
+## [Stage 06](./stage%2006/README.md)
+
+
+
+
+## [Stage 07](./stage%2007/README.md)
+
+
+
+
+## [Stage 08](./stage%2008/README.md)
+
+
+
+
+
+
+
+## [Stage 09](./stage%2009/README.md)
+
+
+
+
+
+## [Stage 10](./stage%2010/README.md)
+
+
+
+
+## [Stage 11](./stage%2011/README.md)
+
+
+
+## [Stage 12](./stage%2012/README.md)
+
+
+
+
+## [Stage 13](./stage%2013/README.md)
+
+
+
+
+## [Stage 14](./stage%2014/README.md)
+
+
+
+
+## [Stage 15](./stage%2015/README.md)
+
+
+
+## [Stage 16](./stage%2016/README.md)
+
+
+
+
+
+## [Stage 17](./stage%2017/README.md)
+
+
+
+
+And a bunch of `bonus stages`:
+
+## [Bonus Stage 01](./bonus%20stage%2001/README.md)
+
+
+
+## [Bonus Stage 02](./bonus%20stage%2002/README.md)
+
+
+
+
+
+## [Bonus Stage 03](./bonus%20stage%2003/README.md)
+
+
+
+
+
+
+
+
+
+## [Bonus Stage 04](./bonus%20stage%2004/README.md)
+
+
+
+
+
+
+
+
+
+### Stage Layout
+
+Each stage contains the following structure:
+
+```cs
+╠══ Stage xx
+║ ╠══ README.md // step-by-step recipe
+║ ╠══ theme*.dslf // extra theme(s) definition (optional)
+║ ╚══ workspace.dsl // completed lesson workspace
+```
+
+Each `C4 bootcamp` stage contains a `README` which explains the following:
+1. The `Structurizr` concepts (eg ) and tools you will be applying in the lesson, along with links to any relevant documentation or examples.
+1. Step-by-step instructions (✏️) on how to modify the `workspace` to match the expected one at the end of each lesson. Feel free to jump from ✏️ to ✏️, if you want to quickly unfold the stage.
+1. If you get stuck following the step-by-step instructions, each lesson contains check points (📙) and a completed `workspace.dsl` (📘) file that shows the expected output. You can compare this against your own code and see what you need to do differently.
+
+Each stage enrichs the previous one, allowing one to tailor `software model` from scratch up to completion. If you are interested on an intermediate stage and don't want to unfold the whole journey prior to it, just take the previous state (`*.dsl` files) as your starting point. Eg, if you would like to exercise `stage 07`, just copy & paste `*.dsl` from `stage 06`, and engage.
+
+### When you're doing the lessons...
+
+A few things to bear in mind when you are following the step-by-step instructions:
+
+1. **Don't just copy and paste** the code shown in the lesson's `README`. You'll retain and learn all of the built-in `Structurizr` functions if you type out the code as it's shown.
+1. You might be required to fill in some blanks during individual lessons. Part of helping you learn `Structurizr` involves leaving some parts of the exercise up to you - if you ever feel lost, always check the contents of the `workspace.dsl` for that lesson.
+1. Don't be afraid to ask questions.
+
+### Docs
+
+We will provide explanations of all key concepts throughout each lesson, but of course, you should bookmark (and feel free to use!) the [C4 documentation](https://supreme-happiness-8f0f8e3c.pages.github.io/)
+
+### Tools / prerequisites
+
+This course expects the following:
+- A Github account and basic knowledge of Git
+- An up to date installation of VS Code editor
+- An up to date `Cornifer` extension
+- An up & running docker daemon
+
+See [here](./stage%2000/prereq.md) for details.
+
+## Time to engage
+
+[Here we go](./stage%2001/README.md)
diff --git a/bonus stage 01/README.md b/bonus stage 01/README.md
new file mode 100644
index 0000000..5da21e0
--- /dev/null
+++ b/bonus stage 01/README.md
@@ -0,0 +1,78 @@
+# BONUS STAGE 01
+
+
+
+⌛ Estimated time to complete: 15 min
+
+You may have noticed that `Structurizr DSL` does not handle the 4th level, the `code` one. As stressed before, this one is complex to streamline and thus to craft tooling around. Moreover, many modern `IDE` already provide meaningful toolkit to surface information such as `project dependency diagram` or `class diagram`. Obviously, if you think you are lacking something, it is up to you to craft the missing link by either enriching existing tooling, crafting your own, ...
+
+Let's see how one could do so by wringing the `Structurizr` pipeline.
+
+One last time, coming from `component` diagram, imagine you dapped in the `Uploading` green box. At this low-level stage, we need to refine the way we will craft the bounding context we are focusing at. A good way to shape modern application is to stick to **hexagonal** (`onion`, `port & adapter`, & Co siblings) architecture. It is then very easy to highlight the different projects involved, including the layer they belong to. It is now time to really detail the technical stack. Pay attention to the way you name your project, and of course provide more than ever meaningful description to sum up responsibility of each projects.
+
+> Following stuff is a trick, so you need to accommodate some mismatches regarding taxonomy, and some mind shifting. Goal is to stress that one could achieve this leveraging existing stack.
+
+1. ✏️ Create a `workspace`
+ ```diff
+ +workspace "Hexagonal Architecture Experimentation" "Wringing Structurizr pipeline to tackle C4.4." {
+ + !identifiers hierarchical
+ + !impliedRelationships false
+ +
+ + model {
+ + }
+ + views {
+ + }
+ }
+
+ ```
+2. ✏️ Shift your mind, considering `uploading` `component` will temporarily act as local `software system`:
+ ```diff
+ model {
+ + uploading = softwareSystem "Uploading component internals" "" "" {}
+ ```
+3. ✏️ Refine `uploading` internals, once again shifting your mind, considering them as `container`:
+ ```diff
+ uploading = softwareSystem "Uploading component internals" "" "" {
+ + app = container "App.Services" "Provides services eg communication & notification." +"net6.0" "#app" {
+ + }
+ + dom = container "Dom.Uploading" "Defines DDD staples such as endpoint value object." +"technology" "#dom" {
+ + }
+ + inf = container "Inf.Android" "Surfaces device facilities such as tile notification." +"Xamarin" "#inf" {
+ + }
+ + pre = container "Pre.Uploading" "Allows user to specify backend settings. Provides +upload monitoring feedback." "XAML" "#pre" {
+ + }
+ }
+ ```
+4. ✏️ Add `relationships` to tie everything
+ ```diff
+ model {
+ + uploading.app -> uploading.dom "operates" "" ""
+ + uploading.app -> uploading.inf "lererages" "" ""
+ + uploading.pre -> uploading.app "exercises" "" ""
+ }
+ ```
+5. ✏️ Ask for a `view`
+ ```diff
+ views {
+ + container uploading "HexagonalArchitecture" "" {
+ + include *
+ + autolayout
+ + }
+ }
+ ```
+6. ✏️ Make sure that you reference a proper theme:
+ ```diff
+ views {
+ + theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/hexagonal/theme.json
+ }
+ ```
+
+✏️ Save your workspace, and refresh your browser.
+
+
+
+## Wrapup
+
+📘 Completing this stage should lead to this [final workspace](./workspace.dsl).
+
+You see how one could leverage existing tooling to experiment and open new horizons. Hands on stack outside off the box is one of the most effective way to sustain evolution.
diff --git a/bonus stage 01/structurizr-1-HexagonalArchitecture.svg b/bonus stage 01/structurizr-1-HexagonalArchitecture.svg
new file mode 100644
index 0000000..399a9b7
--- /dev/null
+++ b/bonus stage 01/structurizr-1-HexagonalArchitecture.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/bonus stage 01/workspace.dsl b/bonus stage 01/workspace.dsl
new file mode 100644
index 0000000..40a5e0c
--- /dev/null
+++ b/bonus stage 01/workspace.dsl
@@ -0,0 +1,28 @@
+workspace "Hexagonal Architecture Experimentation" "Wringing Structurizr pipeline to tackle C4.4." {
+ !identifiers hierarchical
+ !impliedRelationships false
+
+ model {
+ uploading = softwareSystem "Uploading component internals" "" "" {
+ app = container "App.Services" "Provides services eg communication & notification." "net6.0" "#app" {
+ }
+ dom = container "Dom.Uploading" "Defines DDD staples such as endpoint value object." "net6.0" "#dom" {
+ }
+ inf = container "Inf.Android" "Surfaces device facilities such as tile notification." "Xamarin" "#inf" {
+ }
+ pre = container "Pre.Uploading" "Allows user to specify backend settings. Provides upload monitoring feedback." "XAML" "#pre" {
+ }
+ }
+
+ uploading.app -> uploading.dom "operates" "" ""
+ uploading.app -> uploading.inf "lererages" "" ""
+ uploading.pre -> uploading.app "exercises" "" ""
+ }
+ views {
+ theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/hexagonal/theme.json
+
+ container uploading "HexagonalArchitecture" "" {
+ include *
+ }
+ }
+}
diff --git a/bonus stage 02/.dockerignore b/bonus stage 02/.dockerignore
new file mode 100644
index 0000000..703a024
--- /dev/null
+++ b/bonus stage 02/.dockerignore
@@ -0,0 +1,28 @@
+**/.structurizr
+**/.classpath
+**/.dockerignore
+**/.env
+**/.git
+**/.gitignore
+**/.project
+**/.settings
+**/.toolstarget
+**/.vs
+**/.vscode
+**/*.*proj.user
+**/*.dbmdl
+**/*.jfm
+**/azds.yaml
+**/bin
+**/charts
+**/docker-compose*
+**/Dockerfile*
+**/node_modules
+**/npm-debug.log
+**/obj
+**/secrets.dev.yaml
+**/values.dev.yaml
+LICENSE
+README.md
+
+**/sbom
\ No newline at end of file
diff --git a/bonus stage 02/Dockerfile b/bonus stage 02/Dockerfile
new file mode 100644
index 0000000..d651873
--- /dev/null
+++ b/bonus stage 02/Dockerfile
@@ -0,0 +1,31 @@
+FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
+WORKDIR /app
+EXPOSE 80
+EXPOSE 443
+
+FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
+WORKDIR /src
+
+# Run ./_tools/docker/net-restore.h if project|package updates
+ADD net-restore.tar .
+RUN dotnet restore "Mila/Api.csproj"
+
+COPY . .
+WORKDIR "/src/Api"
+RUN dotnet build "Api.csproj" \
+ --no-restore \
+ -c Release \
+ -o /app/build
+
+FROM build AS publish
+RUN dotnet publish "Api.csproj" \
+ --no-restore \
+ -c Release \
+ -o /app/publish
+
+FROM base AS final
+WORKDIR /app
+COPY --from=publish /app/publish .
+
+ENTRYPOINT ["./Api"]
+CMD ["--endpoint", "http://api:80"]
\ No newline at end of file
diff --git a/bonus stage 02/README.md b/bonus stage 02/README.md
new file mode 100644
index 0000000..25ea922
--- /dev/null
+++ b/bonus stage 02/README.md
@@ -0,0 +1,210 @@
+# BONUS STAGE 02
+
+
+
+
+
+In this module, you will learn how to:
+- Leverage `theme` to adapt to audience
+- Enrich `software model` with technical insights, such as `Dockerfile` or `SBOM`, via `description` or `url`.
+
+⌛ Estimated time to complete: 15 min
+
+Assume we start from a meaningful [workspace](./source.dsl).
+
+## Semantic view
+
+Thanks to [stage 10](../stage%2010/README.md), we know how one can easily reference existing theme to support diagramming.
+
+```diff
+views {
++ theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/semantic-alt/theme.json
+```
+
+Underlying `software model` semantic is complemented by style to reduce mental load:
+
+
+
+
+## Iconic view
+
+We also saw that we can combine themes to surface other dimensions. We did it [by the past](../stage%2010/README.md) as well to enrich our `software model` with branding, combining existing themes such as `heraldry` or `microsoft-azure-2021.01.26`, or adding brand-new inlined styles like `#android`:
+
+```diff
+views {
+ theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/semantic-alt/theme.json
++
++ theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/heraldry/theme.json
++ theme https://static.structurizr.com/themes/microsoft-azure-2021.01.26/theme.json
++
++ styles {
++ element "#android" {
++ stroke #3DDC84
++ color #3DDC84
++ icon "https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/assets/android.png"
++ }
++
++ element "#opera" {
++ stroke #FF1B2D
++ color #FF1B2D
++ icon "https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/assets/opera.png"
++ }
++
++ element "Container Instance" {
++ metadata true
++ description true
++ height 300
++ }
++
++ element "Software System Instance" {
++ metadata true
++ description true
++ height 300
++ }
++ }
+```
+
+Enriching `software model` comes with a cost, as many dimensions are now visually interleaved, which may result in blurry sketches and overload outcome diagramming:
+
+
+
+
+Visualizing a complex model through tailored views is not new to software development. We do it for years now with pattern like `MVVM` (Model-View-ViewModel). We are used to apply such a pattern to geographical maps as well, asking for either satellite or elevation map of a dedicated area. Even if it may be useful to superimpose those dimensions for correlation, we are used to look at dimension in isolation.
+
+Sadly, at the time of writing, `Structurizr` does not provide a built-in way of achieving such flexibility. We need some manual steps, namely amending `workspace.dsl` each time we want to look at a given dimension. For example, to stress deployment dimension, we should be tempted to comment `semantic` theme to only keep `branding` ones:
+
+```diff
+views {
+- theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/semantic-alt/theme.json
++ # theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/semantic-alt/theme.json
+ theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/heraldry/theme.json
+ theme https://static.structurizr.com/themes/microsoft-azure-2021.01.26/theme.json
++ theme https://raw.githubusercontent.com/rvr06/cornifer-contrib/main/themes/shape/theme.json
+
+```
+
+Resulting diagrams now focus on deployment dimension, without noising visual space with `semantic` one.
+
+
+
+
+There are many remaining dimensions which could be helpful to visualize, such as:
+* gathering elements by teams in charge
+* spreading elements over releases
+* identifying elements governance (enterprise vs customer)
+* ...
+
+Of course, we could leverage `perspective` to do so, but having their own `theme` (and resulting tailored views) will be very helpful for those extra dimensions. `Structurizr` would definitively benefit scaling its approach on that matter...
+
+## Prerequisites view
+
+ Some element that can benefit from extra - and often verbose - information are `deploymentEnvironment` children, such as `deploymentNode`, `infrastructureNode`, `containerInstance` and `softwareSystemInstance`. What to attach, and how, will be covered in the current section.
+
+### Description
+
+`Description` field is available for most elements and we previously stressed the importance to feed it properly and contextually. Feel free to use `description` field to highlight key prerequisites or provide meaningful insights. Eg, we may enrich `w01_.k8s_.docker_` `deploymentNode` to explain why we pick this particular `Linux` ditribution:
+
+```diff
+w01_ = deploymentNode "Worker 01" "" "Azure" "Microsoft Azure - All Resources" 1 {
+ k8s_ = deploymentNode "Orchestration" "" "Kubernetes" "Microsoft Azure - Kubernetes Services" 1 {
+- docker_ = deploymentNode "mcr.microsoft.com/dotnet/aspnet:6.0" "" "Docker" "Microsoft Azure - Container Instances" 1 {
++ docker_ = deploymentNode "mcr.microsoft.com/dotnet/aspnet:6.0" "Enforce Debian OS to lighten footprint. Benefit from legacy test campaign. Other distribution may work but won't be heavily tested against." "Docker" "Microsoft Azure - Container Instances" 1 {
+ api_ = containerInstance mila.api worker1_ "" {
+ }
+ }
+
+ deploymentNode "mongo:latest" "" "Docker" "Microsoft Azure - Container Instances" 1 {
+ store_ = containerInstance mila.store worker1_ "" {
+ }
+ }
+ }
+}
+```
+
+Enabling `diagram tooltip` in the `Structurizr` toolbar (in red) will activate pop-up when hovering element, which in-turn surfaces `description` field (in green).
+
+
+
+### Dockerfile
+
+Application containerization is based on self-contained blueprint files, such as `Dockerfile` for `docker` or `definition file` (`.def`) for `singularity`, that can be easily referenced from `software model` leveraging `url` field. Then, you can decide to:
+* provide base image `url`, e.g. `https://hub.docker.com/_/mongo` to speed up access or point to a dedicated version
+* provide blueprint `url`, e.g. `https://github.com/rvr06/c4-bootcamp/blob/main/bonus%20stage%2002/Dockerfile` to link to matching blueprint
+
+```diff
+w01_ = deploymentNode "Worker 01" "" "Azure" "Microsoft Azure - All Resources" 1 {
+ k8s_ = deploymentNode "Orchestration" "" "Kubernetes" "Microsoft Azure - Kubernetes Services" 1 {
+ docker_ = deploymentNode "mcr.microsoft.com/dotnet/aspnet:6.0" "Enforce Debian OS to lighten footprint." "Docker" "Microsoft Azure - Container Instances" 1 {
++ url https://github.com/rvr06/c4-bootcamp/blob/main/bonus%20stage%2002/Dockerfile
+ api_ = containerInstance mila.api worker1_ "" {
+ }
+ }
+
+ deploymentNode "mongo:latest" "" "Docker" "Microsoft Azure - Container Instances" 1 {
++ url https://hub.docker.com/_/mongo
+ store_ = containerInstance mila.store worker1_ "" {
+ }
+ }
+ }
+}
+```
+
+`Url` is available through pop-up (in blue) and navigable by double-clicking the matching item:
+
+
+
+It is really helpful to provide the ability to navigate from the `software model` to its underlying insights, and is very efficient to support heterogeneous discussion, as we can zoom in and out from a single model.
+
+### SBOM
+
+`SBOM`, standing for `Software Bill Of Material`, recently gained some traction and has been standardized [here](https://spdx.dev/). There is multiple ways of generating the `SBOM` of a dedicated software. For example, `docker` recently decided to enrich its built-in tooling to integrate `SBOM` generation, during build pipeline or from an existing image.
+
+```sh
+# Generate SBOM as part of the build pipeline
+$ docker buildx build `
+ --build-arg BUILDKIT_SYNTAX=crazymax/dockerfile:sbom `
+ -o sbom `
+ .
+```
+
+Above command generates a bunch of files:
+* [sbom.txt](./sbom/sbom.txt)
+* [sbom_cyclonedx.json](./sbom/sbom_cyclonedx.json)
+* [sbom_spdx.json](./sbom/sbom_spdx.json)
+* [sbom_syft.json](./sbom/sbom_syft.json)
+
+that you can in-turn reference through `url` field to enrich the `software model`:
+
+```diff
+w01_ = deploymentNode "Worker 01" "" "Azure" "Microsoft Azure - All Resources" 1 {
+ k8s_ = deploymentNode "Orchestration" "" "Kubernetes" "Microsoft Azure - Kubernetes Services" 1 {
+ docker_ = deploymentNode "mcr.microsoft.com/dotnet/aspnet:6.0" "Enforce Debian OS to lighten footprint." "Docker" "Microsoft Azure - Container Instances" 1 {
+ url https://github.com/rvr06/c4-bootcamp/blob/main/bonus%20stage%2002/Dockerfile
+ api_ = containerInstance mila.api worker1_ "" {
++ url https://github.com/rvr06/c4-bootcamp/blob/main/bonus%20stage%2002/sbom/sbom.txt
+ }
+ }
+
+ deploymentNode "mongo:latest" "" "Docker" "Microsoft Azure - Container Instances" 1 {
+ url https://hub.docker.com/_/mongo
+ store_ = containerInstance mila.store worker1_ "" {
+ }
+ }
+ }
+}
+```
+
+As expected, `url` is available through pop-up (in magenta) and navigable by double-clicking the matching item:
+
+
+
+## Wrapup
+
+📘 Completing this stage should lead to this [final workspace](./workspace.dsl).
+
+You see how one could leverage fields like `description` or `url`, or play with `themes` to tailor outcome. UX through `Structurizr` is not as smooth as expected, but those ideas could lead to interesting evolution.
+
+## Further reading
+
+- [theme](https://github.com/structurizr/dsl/blob/master/docs/language-reference.md#theme)
+- [url](https://github.com/structurizr/dsl/blob/master/docs/language-reference.md#url)
\ No newline at end of file
diff --git a/bonus stage 02/dockerfile.png b/bonus stage 02/dockerfile.png
new file mode 100644
index 0000000000000000000000000000000000000000..bab4ef90443671978f738d7a4b765f7c21579cb4
GIT binary patch
literal 72391
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