C4 model introduce

Last updated 1 year ago

Was this helpful?

C4 model introduce

how to use

install java

install graphviz

brew install graphviz

install vscode plugin PlantUML

create diagram

@startuml C4_Elements
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml

Person(personAlias, "Label", "Optional Description")
Container(containerAlias, "Label", "Technology", "Optional Description")
System(systemAlias, "Label", "Optional Description")

Rel(personAlias, containerAlias, "Label", "Optional Technology")
@enduml

이런 그림이 나온다.

@startuml Basic Sample
!include https://raw.githubusercontent.com/plantuml-stdlib/C4-PlantUML/master/C4_Container.puml

Person(admin, "Administrator")
System_Boundary(c1, "Sample System") {
    Container(web_app, "Web Application", "C#, ASP.NET Core 2.1 MVC", "Allows users to compare multiple Twitter timelines")
}
System(twitter, "Twitter")

Rel(admin, web_app, "Uses", "HTTPS")
Rel(web_app, twitter, "Gets tweets from", "HTTPS")
@enduml

code snippet

이걸 다운받아서 vscode에 연결해준다.

나는 현재 프로젝트에만 사용하려고 .vscode/C4.code-snippets에 넣어주었다.

개념

4가지 관점의 그림이 있다.

System Context
Container
Component
Code

Level

서로 다른 관심을 가진 다이어그램 및 문서에 대한 다양한 청중이 있습니다.
소프트웨어 아키텍처 다이어그램을 그릴 때 소프트웨어 개발자처럼 생각하십시오.
공통된 추상화 집합이 공통 표기법보다 더 중요합니다.
소프트웨어 시스템은 하나 이상의 코드 요소에 의해 차례로 구현되는 하나 이상의 구성 요소를 각각 포함하는 하나 이상의 컨테이너로 구성됩니다.

Level 1: System Context Diagram

A System Context diagram provides a starting point, showing how the software system in scope fits into the world around it.

System Context diagram은 범위의 소프트웨어 시스템이 주변 세계에 어떻게 맞는지 보여주는 시작점을 제공합니다.

Level 2: Container Diagram

A Container diagram zooms into the software system in scope, showing the high-level technical building blocks.

Container diagram은 범위 내에서 소프트웨어 시스템을 확대하여 높은 수준의 기술 구성 요소를 보여줍니다.

Level 3: Component Diagram

A Component diagram zooms into an individual container, showing the components inside it.

Component diagram은 개별 컨테이너를 확대하여 그 안의 구성 요소를 표시합니다.

Level 4: Code Diagram

A code (e.g. UML class) diagram can be used to zoom into an individual component, showing how that component is implemented.

code diagram을 사용하여 개별 구성 요소를 확대하여 해당 구성 요소가 구현되는 방법을 표시할 수 있습니다.

그리기를 추천하지 않으며 자동으로 코드에서 생성하는걸 추천합니다.

misc

titles

short and meaningful, include the diagram type, numbered if diaram order is important; for example:

짧고 의미 있는 다이어그램 유형을 포함 예를 들어:

system context diagram for finalcial risk system
[system Context] Financial Risk System

다이어그램 순서가 중요한 경우 번호가 매겨집니다.

layout

sticky notes and indexs card( e.g crc cards) make a great substitute for hand-drawn boxes, especially if you dont have a whiteboard

스티커 메모 및 색인 카드(예: crc 카드)가 손으로 그린 상자를 대신할 수 있습니다.

visual consistency

try to be consistent with notation and element positioning across diagrams

다이어그램 전체에서 표기법 및 요소 위치와 일관성을 유지하십시오.

acronyms(줄임말)

매우 주의하자.

be ware of using acronyms, especially those related to the business/domain that you work in

특히 당신이 일하는 비즈니스/도메인과 관련된 줄임말을 사용하십시요. 새로 조인하는 사람은 바로 이해할수 있습니다.

element

start with simple boxes containing the element name, type, technology (if appropriate) and a description/responsibilities

요소 이름, 유형, 기술(해당되는 경우) 및 설명/책임이 포함된 간단한 상자로 시작합니다.

박스들 표시

왼쪽처럼하지말고 오른쪽처럼 자세한 내용을 다이어그램에 쓰자.

lines

favour uni-directional lines showing the most important dependencies or data flow with an annotation to be explicit about the purpose of the lines and direction

가장 중요한 종속성 또는 데이터 흐름을 보여주는 단방향 라인을 선호하며 라인과 방향의 목적을 명시하는 주석을 사용합니다.

summarise the intent of the relationship

관계의 의도 요약

summarise, yet be specific

요약하되 구체적으로

show both directions when the intents are differnt

의도가 다른 경우 양방향 표시