C4 기반 표기법으로 코드 기반 소프트웨어 아키텍처 다이어그램을 생성하는 모델링 언어와 도구 체인
plantuml-stdlib/C4-PlantUML
PlantUML에서 일반 텍스트 코드로 소프트웨어 아키텍처 다이어그램을 그릴 수 있는 C4 모델 매크로 라이브러리입니다.
대체할 수 있는 제품:Lucidchart
Visio
- 스타
- 7,441
- 포크
- 1,168
- 열린 이슈
- 0
- 마지막 커밋
- 9일 전
어떤 프로젝트인가요?
C4-PlantUML은 소프트웨어 아키텍처용 C4 모델을 구현하는 PlantUML 매크로와 스테레오타입 모음입니다. 상자를 직접 그리는 대신 짧은 텍스트 파일에 사람, 시스템, 컨테이너, 컴포넌트, 배포 노드를 기술하면 PlantUML이 다이어그램을 렌더링합니다. 덕분에 아키텍처 다이어그램을 코드와 함께 버전 관리하고 검토하기 쉽습니다.
이 라이브러리는 System Context, Container, Component, Dynamic, Deployment 및 C4 스타일 Sequence 다이어그램용 include를 각각 제공합니다. 각 include에는 일반 요소와 외부 요소 변형, 데이터베이스와 큐, 경계, 방향을 선택할 수 있는 관계를 위한 매크로가 포함되어 있습니다. 스프라이트와 아이콘, 요소 링크, 범례를 자동 생성하는 사용자 지정 태그, 레이아웃 옵션도 지원합니다.
이 프로젝트는 플랫폼에 독립적인 오픈 소스이며, VS Code 스니펫과 IntelliJ 라이브 템플릿을 제공합니다. 로컬 PlantUML jar 또는 PlantUML 웹 서버로 다이어그램을 렌더링할 수 있으며, 저장소 URL이나 PlantUML에 기본 포함된 표준 라이브러리를 통해 라이브러리를 가져올 수 있습니다.
핵심 기능
- 01System, Container, Component, Dynamic, Deployment 및 C4 스타일 Sequence 다이어그램용 매크로.
- 02사람, 시스템, 컨테이너, 데이터베이스, 큐 및 외부 요소 타입.
- 03방향 지정이 가능한 관계 매크로와 경계 그룹화.
- 04아이콘 스프라이트, 요소 링크, 범례를 자동 생성하는 사용자 지정 태그.
- 05VS Code 스니펫과 IntelliJ 라이브 템플릿을 통한 에디터 지원.
활용 사례
- 초기 설계 단계에서 소프트웨어 아키텍처 문서화.
- 설명 대상 코드와 같은 저장소에서 아키텍처 다이어그램 관리.
- 비전문가 이해관계자에게 시스템 컨텍스트와 컨테이너 구조 전달.
빠른 시작
- 1
.puml 파일에 C4_Container 라이브러리를 포함합니다
!include <C4/C4_Container> - 2
@startuml/@enduml 사이에 C4 요소와 관계를 일반 텍스트로 작성합니다
- 3
PlantUML로 다이어그램을 렌더링합니다. 예를 들어 jar 파일을 사용할 수 있습니다
java -jar plantuml.jar -DRELATIVE_INCLUDE="." ...
사용 전 알아둘 점
- 다이어그램을 렌더링하려면 PlantUML이 필요하므로, 다이어그램을 보려면 Java 또는 PlantUML 서버가 필요합니다.
토픽
자주 묻는 질문
- C4-PlantUML은(는) 무엇인가요?
- PlantUML에서 일반 텍스트 코드로 소프트웨어 아키텍처 다이어그램을 그릴 수 있는 C4 모델 매크로 라이브러리입니다. C4-PlantUML은 소프트웨어 아키텍처용 C4 모델을 구현하는 PlantUML 매크로와 스테레오타입 모음입니다. 상자를 직접 그리는 대신 짧은 텍스트 파일에 사람, 시스템, 컨테이너, 컴포넌트, 배포 노드를 기술하면 PlantUML이 다이어그램을 렌더링합니다. 덕분에 아키텍처 다이어그램을 코드와 함께 버전 관리하고 검토하기 쉽습니다.
- C4-PlantUML은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
- C4-PlantUML은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
- C4-PlantUML은(는) 아직 유지보수되고 있나요?
- 활발히 유지보수 중. C4-PlantUML의 마지막 커밋은 2026년 10월 13일입니다.
- C4-PlantUML은(는) 어디에 사용할 수 있나요?
- 초기 설계 단계에서 소프트웨어 아키텍처 문서화. 설명 대상 코드와 같은 저장소에서 아키텍처 다이어그램 관리. 비전문가 이해관계자에게 시스템 컨텍스트와 컨테이너 구조 전달.
- C4-PlantUML는 어떻게 설치하나요?
- .puml 파일에 C4_Container 라이브러리를 포함합니다: !include <C4/C4_Container> @startuml/@enduml 사이에 C4 요소와 관계를 일반 텍스트로 작성합니다 PlantUML로 다이어그램을 렌더링합니다. 예를 들어 jar 파일을 사용할 수 있습니다: java -jar plantuml.jar -DRELATIVE_INCLUDE="." ...
- C4-PlantUML은(는) 어디서 받을 수 있나요?
- 소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/plantuml-stdlib/C4-PlantUML
요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.
관련 프로젝트
일반 텍스트 설명으로 시퀀스, 클래스, 액티비티, 상태, Gantt 등 UML 및 다양한 다이어그램을 생성합니다.
코드로 그리는 다이어그램: Python으로 클라우드 및 시스템 아키텍처 다이어그램을 만들고 AWS, Azure, GCP, Kubernetes 등의 아이콘을 사용하세요.
자연어와 Terraform, Kubernetes, SQL, OpenAPI 같은 실제 시스템 소스를 편집 가능한 draw.io 아키텍처 다이어그램으로 변환하는 에이전트 스킬입니다.
AI 코딩 도구가 프로젝트 구조와 제약, 변경 범위를 HTML 맵으로 그린 뒤 확인을 기다리게 하는 에이전트 스킬입니다.