"Architecture as Code or How to Survive in the Legislature and Not Go Crazy", Yozhef Hisem.pdf

Imagine one day your team inherits a system that was built over 4 years by six different teams — just to test hypotheses. No documentation. Just a massive monorepo and Jenkins for deployment. That’s exactly what we were handed, and that’s when we decided to take full inventory — starting with Architecture as Code.

In this talk, I’ll share how we approached architectural documentation systematically: from building C4 diagrams to creating Service Documentation, ERDs, and Sequence Diagrams. You’ll learn how we practically restored our understanding of the system, brought architectural clarity, and which tools (PlantUML, Mermaid) and methods worked best.

1. Hello
there!
Йожеф Гісем
Solution Architect at MacPaw

2. Architecture as Code

6. Давайте поговоримо про документацію

7. Документація Confluence

8. Документація Confluence
Notion

9. Документація Confluence
Notion
Wiki / Pages

10. Де часто ми зберігаємо Архітектурну
документацію ?

11. Діаграми
diagrams.io

12. Діаграми
diagrams.io
Lucid chart

13. Діаграми
diagrams.io
Lucid chart
Confluence

14. Як часто виглядає цей документ?

16. Наша історія

17. Приданий проєкт 10 років про

18. Приданий проєкт 10 років про
150 + інженерів

19. Приданий проєкт 10 років про
150 + інженерів
Repository

20. Приданий проєкт 10 років про
150 + інженерів
Repository
3-Party Service

21. Мої думки коли побачив це

23. Як ми прийшли до AaC:

24. Як ми прийшли до
AaC:
Запити від PM

25. Як ми прийшли до
AaC:
Запити від PM
Ознайомлення з системою

26. Як ми прийшли до
AaC:
Запити від PM
Ознайомлення з системою
Bus Factor

27. Інструменти

28. Інструмент:
PlantUML

29. Інструмент:
PlantUML
Mermaid

30. Інструмент:
PlantUML
Mermaid
Structurizr DSL

31. Інструмент:
PlantUML
Mermaid
Structurizr DSL

33. Чому обрали PlantUML

34. 1

37. 2

40. З чого ми почали

41. С4 Diagrams

42. С4 Diagrams C1

44. С4 Diagrams C1
C2

46. С4 Diagrams C1
C2
C3

48. С4 Diagrams C1
C2
C3
C4

49. Service Diagrams

50. Service Diagrams Яка мова?

51. Service Diagrams Яка мова?
Чи є база?

52. Service Diagrams Яка мова?
Чи є база?
Чи є залежності?

53. Service Diagrams Яка мова?
Чи є база?
Чи є залежності?
Які 3-party використовує?

55. Як знати які в тебе є данні ?

58. Sequence diagrams

59. Sequence Diagram Api docs = хаос

60. Sequence Diagram Api docs = хаос
Повільний Loading

61. Sequence Diagram Api docs = хаос
Повільний Loading
Описати підкапотну магію

65. ADR

66. ADR:
Title

67. ADR:
Title
Status

68. ADR:
Title
Status
Context

69. ADR:
Title
Status
Context
Decision

70. ADR:
Title
Status
Context
Decision
Consequences

72. В нас вийшов класний Repository з
великими знаннями

73. Проблематики Доступність

74. Проблематики Доступність
Перегляд

75. Проблематики Доступність
Перегляд
Презентація

76. Проблематики Доступність
Перегляд
Презентація
Онбордінг

78. Demo

79. Але це не кінець Геренувати SDK

80. Але це не кінець Геренувати SDK
CI Check

81. Але це не кінець Геренувати SDK
CI Check
Api Doc

82. Але це не кінець Геренувати SDK
CI Check
Api Doc
.…

83. QA