40 lines
2.0 KiB
Markdown
40 lines
2.0 KiB
Markdown
# Diagram-only style contract
|
||
|
||
이 예제 세트는 **문서 안에 삽입되는 다이어그램 자체**만 평가합니다. 본문의 제목·설명·결론은 문서가 담당하고, SVG 캔버스는 관계를 읽는 데 필요한 요소만 포함합니다.
|
||
|
||
## 캔버스에 허용되는 것
|
||
|
||
- 노드와 노드 내부의 기술 식별자
|
||
- 시스템·도메인·프로세스 경계와 경계 이름
|
||
- 연결선, 방향, 프로토콜·이벤트·명령·상태 레이블
|
||
- 시퀀스 번호, 타임라인 기준점, 실패·현재 상태처럼 의미가 있는 표시
|
||
- 다이어그램을 해독하는 데 반드시 필요한 짧은 주석
|
||
|
||
## 캔버스에서 금지되는 것
|
||
|
||
- 문서 제목을 반복하는 큰 헤드라인과 부제
|
||
- 하단 결론 띠, 슬로건, 핵심 메시지 카드
|
||
- 패턴 번호, 생성기 이름, 워터마크, decorative footer
|
||
- 그라디언트, glow, drop shadow, glass effect
|
||
- 의미 없이 배치된 metric card, badge, sparkline
|
||
- 모든 노드를 서로 다른 색으로 칠하는 장식성 컬러 코딩
|
||
- 관계보다 디자인을 먼저 보이게 만드는 과도한 둥근 모서리와 아이콘
|
||
|
||
## 기본 시각 예산
|
||
|
||
- 기본은 회색조 + 주 강조색 1개
|
||
- 오류·성공처럼 도메인 의미가 있을 때만 상태색 추가
|
||
- 선 굵기 1.2–2.3px, 강조 선도 4px 이하
|
||
- 박스 radius 0–10px; pill은 상태 토큰이나 작은 edge label에만 제한
|
||
- 그림자와 그라디언트 0개
|
||
- 본문 설명은 SVG 밖의 Markdown 문단에 둔다
|
||
|
||
## 레이아웃 원칙
|
||
|
||
1. 독자의 질문에 맞는 관습적인 다이어그램 유형을 먼저 선택한다.
|
||
2. 연결선이 교차하지 않도록 읽기 방향을 한 축으로 고정한다.
|
||
3. 경계와 그룹은 배경 장식이 아니라 소유권·실행·배포 범위를 나타낼 때만 쓴다.
|
||
4. 같은 역할은 같은 도형으로 표현한다.
|
||
5. 화살표 레이블은 동사·이벤트·프로토콜·상태 변화로 작성한다.
|
||
6. 문서의 설명을 그림 안에서 다시 서술하지 않는다.
|