drawNET/manual/rich_card.md

# 리치 텍스트 카드(Rich Text Card) 활용 가이드 🃏

'리치 텍스트 카드'는 아키텍처 도면의 **설명(구축 내역)**이나 **범례(Legend)**를 전문적으로 표현하기 위해 설계된 스마트 객체입니다.

---

## 1. 기본 사용법
1.  **에셋 선택**: 왼쪽 '고정 오브젝트(Fixed Objects)' 목록 최하단의 **'리치 텍스트 카드'**를 캔버스로 드래그합니다.
2.  **속성 편집**: 오브젝트를 선택하면 오른쪽 사이드바에 편집 메뉴가 나타납니다.
3.  **내용 입력**: '내용' 칸에 텍스트를 입력하면 실시간으로 카드 본문에 반영됩니다. (줄바꿈 지원)

---

## 2. 카드 유형별 특징

### ❶ 번호 매기기 (Numbered List)
-   **용도**: 구축 내역, 작업 순서, 시스템 특징 나열 등.
-   **특징**: 각 줄마다 헤더 색상과 동일한 **파란색 번호 박스**가 자동으로 생성됩니다.
-   **팁**: 단순히 엔터(`\n`)로 줄을 나누기만 하면 번호가 순차적으로 부여됩니다.

### ❷ 불렛 기호 (Bullet Points)
-   **용도**: 일반적인 특징 설명, 비고 사항 등.
-   **특징**: 깔끔한 원형(`●`) 불렛 기호가 각 줄 앞에 붙습니다.

### ❸ 범례 모드 (Legend Mode) ⭐
-   **용도**: 도면 하단의 기호 설명(범례) 작성.
-   **특징**: 텍스트 기반의 특수 문법을 사용하여 **아이콘을 포함한 범례**를 자동으로 렌더링합니다.

#### 💡 범례 모드 문법 (Syntax):
본문에 아래와 같이 입력하세요:
-   `- (circle:#색상코드) 설명` : 지정된 색상의 **원형** 아이콘 생성
-   `- (rect:#색상코드) 설명` : 지정된 색상의 **사각형** 아이콘 생성
-   `- (line:#색상코드) 설명` : 지정된 색상의 **가로 선** 아이콘 생성

> **입력 예시:**
> `- (circle:#10b981) 가동 중인 시스템`
> `- (rect:#ef4444) 장애 발생 구역`
> `- (line:#f97316) 외부 연동 구간`

---

## 3. 스타일 커스터마이징
-   **헤더 제목**: 도면의 맥락에 맞게 '구축 내역', '범례' 등으로 수정하세요.
-   **테마 색상**: 헤더의 색상 피커를 사용하여 프로젝트 테마에 맞게 색상을 변경할 수 있습니다. (테두리 색상도 자동으로 동기화됩니다.)
-   **잠금 기능**: 배치가 완료된 후 'Locked'를 체크하면 의도치 않은 이동이나 삭제를 방지할 수 있습니다.

---

*최종 수정일: 2026-03-21*
*drawNET Design System*