draw_use_case_diagram
Draws UML use case diagrams with actors, use cases, and system boundaries as PNG files, then validates the layout for overlaps, crossed lines, and label collisions so you can revise and redraw until it passes.
Instructions
유즈케이스도를 그려 PNG와 입력 파일로 저장하고, 검사 결과와 그림을 함께 돌려준다. 액터·유즈케이스·시스템 경계를 그리고, 그 사이를 연관·의존(«include»·«extend»)·일반화로 잇는다. 요소는 준 왼쪽 위(left·top) 그대로, 관계선은 준 꺾는 점(via)을 따라 그리고, 요소 크기·선 끝·선 글자 자리만 도구가 정한다. 좌표는 px이고 y는 아래로 커진다.
입력 필드는 인자마다 붙은 설명에 있다.
결과
글: 검사 결과, 요소마다 그린 자리(열쇠와 왼, 위, 폭×높이), 저장한 그림·입력 파일 경로와 그림 픽셀 크기. 자리를 그대로 다음 입력에 넣으면 요소가 움직이지 않는다. 모양 밖 이름이 있는 요소의 자리는 모양과 이름을 함께 덮고, 그 뒤에 모양 자리를 "모양 왼, 위, 폭×높이"로 덧붙인다(꺾는 점을 모양 둘레에 줄 때 쓴다).
그림: 저장한 PNG. 긴 변이 1568px를 넘으면 그 길이로 줄여 돌려준다(저장한 그림은 줄이지 않는다).
입력 파일: 그림 옆 <file_name>.cysuml.json에 그린 도구 이름(tool)과 이 입력(out_dir만 빼고)을 저장한다. 있던 그림을 고칠 때는 이 파일을 읽어 고친 뒤 out_dir에 그 폴더를 주어 tool의 도구로 다시 그린다 — 그대로 넣으면 같은 그림이 나온다(tool은 도구가 무시한다).
elements·relations·file_name이 틀리면 그리지 않고 틀린 곳을 elements[0].left 꼴 자리와 함께 모두 모아 오류로 돌려준다. 그림이 너무 커서 PNG로 그릴 수 없거나 저장할 폴더에 쓸 수 없을 때도 오류로 돌려준다.
AI가 배치하는 그림(클래스도·패키지도 등)을 그리는 흐름 — 검사에 합격할 때까지 되풀이한다:
요소(클래스도에서는 상자)의 자리(left·top)와, 필요하면 관계선의 꺾는 점(via)을 정해 그린다.
돌려받은 검사 결과와 그림을 본다. 불합격 항목마다 걸린 요소, 자리(논리 좌표 왼, 위, 폭×높이), 고치는 법이 붙는다. 고치는 법은 종류마다 다르니(요소를 옮긴다, 꺾는 점을 고친다, 두 요소를 떼어 놓는다 등) 항목에 적힌 대로 고친다.
고친 입력을 같은 file_name으로 다시 그린다(파일을 덮어쓴다). 관계 이름은 도구가 그 관계의 선 위에 얹는다(이름 앞뒤로 선이 끊긴다). 얹을 빈 자리가 없는 이름(선이 짧아 이름 앞이나 뒤에 선이 거의 보이지 않을 때도)과 같은 요소로 돌아오는 선의 이름은 선 옆에 두고, 얹으면 그림 전체에서 걸리는 곳이 더 많아질 때는 모든 이름을 선 옆에 둔다. 다중도는 선 끝 옆에 둔다. 선끼리 엇갈린 곳, 표기 규칙 알림(관계 규칙이 있는 도구에서 뜻을 확인해 볼 관계), 그림 크기는 알림이라 불합격이 아니다. 다만 엇갈림은 적을수록 읽기 좋다.
불합격(선이 요소나 글자를 지나는 등 문서에 넣을 수 없는 그림) 14가지: 요소끼리 겹치거나 붙음, 안의 요소가 바깥 요소의 칸 밖으로 나가거나 테두리·이름 칸에 붙음, 선이 그 선과 상관없는 요소를 지나감, 선이 끝 요소의 몸통 밖 자리(이름 칸 등)나 끝을 품은 요소의 이름 칸을 지나감, 선이 끝을 품은 요소의 테두리를 따라감, 선이 끝 요소 테두리에 붙어 감, 선 끝 모양이 그 선의 다른 끝 요소 테두리에 붙음, 선 끝 모양이 그 끝의 요소 안으로 들어감, 선끼리 포개지거나 선이 왔던 길을 되짚음, 선이 선 끝 모양에 닿음, 선 끝 모양끼리 겹침, 선이 선 글자(관계 이름·다중도 등)를 지나감(이름이 얹힌 그 관계의 선 구간은 빼고), 선 글자가 요소에 겹침, 선 글자끼리 겹침.
유즈케이스도 배치 요령:
시스템 경계 안에 유즈케이스를 세로로 늘어놓는다. 포함(«include»)·확장(«extend»)으로 이어지는 유즈케이스는 그 옆에 둔다.
액터는 시스템 경계의 왼쪽과 오른쪽 밖에 두고, 이름은 왼쪽 액터면 왼쪽("left"), 오른쪽 액터면 오른쪽("right")에 쓴다(name_side). 이름을 아래(기본)에 두면 아래쪽 유즈케이스로 가는 연관선과, 아래 자식 액터에서 올라오는 일반화 선이 이름을 지나 불합격하기 쉽다.
액터끼리 일반화는 부모 액터를 위에, 자식 액터를 그 아래에 둔다. 유즈케이스끼리 일반화도 부모를 위에 둔다.
«include»는 기본 유즈케이스에서 포함되는 유즈케이스로, «extend»는 확장하는 유즈케이스에서 기본 유즈케이스로 긋는다 — 둘 다 kind "dependency"에 stereotype을 단다.
요소 사이는 관계 이름·스테레오타입 글자가 들어갈 만큼 띄운다. 가로 80px·세로 60px쯤에서 시작하고, 글자가 길면 더 띄운다.
요소 크기는 도구가 글자와 안의 요소에 맞춰 늘린다. 그린 크기는 결과의 "요소 자리"에서 보고 다음 입력에 쓴다.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_name": "<file_name>",
"elements": "<elements>"
},
"name": "draw_use_case_diagram"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scale | No | 출력 배율(기본 1.6, 0.25 이상). 보통은 주지 않는다. | |
| out_dir | No | 저장할 폴더. 주지 않으면 서버 작업 폴더 아래 diagrams/이고, 상대 경로도 서버 작업 폴더 기준이다. | |
| elements | Yes | - elements: 요소 목록(하나 이상). - kind(필수): "actor"(사람 모양 — 이름은 모양 밖에 쓴다), "use_case"(이름을 안 가운데에 쓴 타원 — 이름에 맞춰 커진다), "system"(시스템 경계 — 이름을 위쪽 가운데에 쓴 사각형, 안에 유즈케이스를 둔다). - name(필수)·id: "공용 입력(열쇠·이름)" 절. - left·top(필수): 자리의 왼쪽 위(액터는 사람 모양과 이름을 함께 덮는 자리). - in: 이 요소를 품은 시스템 경계의 열쇠. "요소 안에 요소 두기(중첩)" 절. 규칙: 액터는 시스템 밖의 사람이나 외부 시스템이라 시스템 경계 안에 두면(in) 입력 오류다. - width·height: 유즈케이스·시스템 경계 자리의 최소 크기. 글자와 안의 요소에 맞춰 더 늘어난다. 액터는 받지 않는다. - name_side: 이름을 모양 밖에 쓰는 요소의 이름 쪽 "bottom"·"top"·"left"·"right"(첫째가 기본). 요소 자리는 모양과 이름을 함께 덮고, left·top은 그 자리의 왼쪽 위다. 선 끝은 모양 테두리에 닿고, 어떤 선이든 이름을 지나가면 불합격이다. 액터만 쓴다. - 선은 모양 가운데를 향하고, 선 끝은 액터면 사람 모양(폭 18px·높이 37px — 이름 빼고)을 덮는 사각형, 유즈케이스면 타원, 시스템 경계면 사각형 테두리에 닿는다. 시스템 경계의 이름 칸은 위쪽 가운데의 이름 글자 자리이고, 안의 요소를 두는 칸은 그 아래다 — 칸 윗변은 top에서 이름 한 줄이면 25px, 줄이 하나 늘 때마다 15px씩 더 아래다(그래서 안의 유즈케이스는 이름 한 줄이면 top + 45부터 둔다). 공용 입력(열쇠·이름): - id: 요소의 열쇠. 관계의 from·to와 in이 이 열쇠로 요소를 가리킨다. 주지 않으면 한 줄 이름이 곧 열쇠다. 이름이 여러 줄이거나 이름이 없는 요소, 이름이 같은 요소는 id를 준다. 열쇠는 서로 달라야 한다. - name: 한 줄이면 문자열, 여러 줄이면 줄마다 문자열인 목록(["주문", "관리"]). 도구는 줄을 나누지 않으니 긴 이름은 목록으로 나눈다. 한 줄 안에 줄바꿈 글자는 넣지 못한다. 관계 name도 여러 줄 목록을 받는다. - 관계의 stereotype: «» 없이 이름만(include·extend·deploy·manifest·use 등). 관계 종류를 새로 만들지 않고 어느 관계에든 단다 («deploy»는 의존에). 관계 이름 위 줄에 쓴다. 요소 안에 요소 두기(중첩): - 안의 요소에 in으로 품은 요소의 열쇠를 준다. 여러 겹도 된다. 좌표는 늘 그림 전체 기준이다. - 바깥 요소는 준 왼쪽 위에서 시작해, 안의 요소를 여백 20px를 두고 덮도록 오른쪽·아래로 늘어난다(바깥 요소의 이름 칸이 들어갈 크기보다 작아지지 않는다). 그래서 안의 요소는 바깥 요소의 칸(안의 요소를 두는 곳) 왼쪽·위 테두리에서 20px 이상 들여 놓는다. - 선의 끝 요소를 품은 바깥 요소는 그 선이 안을 지나거나 테두리를 건너도 된다. 다만 테두리를 따라가거나 이름 칸을 지나면 불합격이다. 그 선의 글자도 바깥 요소 안에 놓일 수 있다. 그 밖의 요소는 선이 지나가면 불합격이다. - 품은 요소와 그 안의 요소는 선으로 잇지 않는다. | |
| file_name | Yes | 저장할 파일 이름(확장자 없이). 그림(.png)과 입력 파일(.cysuml.json)에 쓰고, 같은 이름이면 둘 다 덮어쓴다. | |
| relations | No | - relations: 관계 목록(없어도 된다). - kind(필수): "association"·"dependency"·"generalization". - from·to(필수): 요소 열쇠. 의존·일반화는 from이 의존하는 쪽·자식이고 화살촉·삼각형이 to 쪽에 붙는다. - name: 관계 이름. stereotype: elements 인자 설명의 "공용 입력(열쇠·이름)" 절. - from_multiplicity·to_multiplicity·navigable: 연관만 쓴다. navigable은 화살촉을 둘 쪽 "to"·"from"·"both"·"none"(기본)이다. - via: 꺾는 점 [[x, y], …]. 선은 요소 가운데(요소 종류에 따로 적은 모양은 그 점)에서 첫 꺾는 점(없으면 상대 요소의 그 점)으로 가는 선이 요소 테두리와 만나는 곳에서 시작한다. 자기 자신으로 가는 관계는 꺾는 점이 둘 이상 있어야 한다(연관·일반화는 꺾는 점이 있어도 자기 자신으로 갈 수 없다). 화살촉 쪽 끝 구간을 꺾을 때는 그 꺾는 점을 요소 테두리에서 20px 이상 뗀다(앞 구간이 화살촉 쪽으로 비스듬히 되돌아오면 더 뗀다) — 화살촉 길이(10px)만큼만 떼면 꺾은 앞 구간이 화살촉 갈래 끝에 붙어 불합격이다. - 공유 줄기: 같은 부모(to)로 가는 일반화끼리는 여러 선을 한 줄기로 모아 삼각형 하나를 함께 쓰게 그려도 된다. 삼각형이 정확히 같은 자리에 그려지면 그 선들이 포개져도 불합격이 아니다(종류가 다른 선을 섞거나 삼각형이 조금이라도 어긋나면 불합격이다). 부모를 위에, 자식들을 그 아래 한 줄에 두고(모양 밖 이름은 name_side "left"·"right"로 옆에 쓴다 — 위·아래면 줄기가 이름을 지난다) 이렇게 준다: - 가운데 x·y: 결과의 요소 자리에서 왼 + 폭/2, 위 + 높이/2 — 모양 자리가 덧붙어 있으면 모양 자리로 셈한다(반 픽셀이면 정수로 내린다). - 줄기 높이 y는 부모 요소의 아래 테두리와 자식 요소들의 위 테두리(모양 자리가 덧붙어 있으면 모양 자리의 변) 사이 가운데쯤에 정한다. 부모 아래 테두리에서 삼각형 길이 18px보다 가까우면 입력 오류다. - 자식(from)마다 via에 [자식 가운데 x, y]와 [부모 가운데 x, y] 두 점을 준다. 마지막 점이 모두 같아 삼각형이 한 자리에 그려진다. 자식 가운데 x가 부모 가운데 x와 같으면 두 점이 같아지니 [부모 가운데 x, y] 하나만 준다. - 규칙: 시스템 경계에는 관계를 잇지 않는다 — 경계는 시스템의 범위를 그린 것이라, 시스템 경계가 끝인 관계는 종류와 상관없이 입력 오류다. - 규칙: 연관은 액터와 유즈케이스 사이에 긋는다. 액터끼리 잇는 연관, 같은 시스템 경계 안이거나 둘 다 경계 밖인 유즈케이스끼리 잇는 연관은 입력 오류다(서로 다른 시스템 경계이거나 한쪽만 경계 안인 유즈케이스끼리는 받는다). - 규칙: 일반화는 액터끼리, 유즈케이스끼리 긋는다. 종류가 다른 일반화, 고리를 이루는 일반화(A의 부모가 B이고 B의 부모가 다시 A인 것 — 여러 단계도)는 입력 오류다. - 규칙: stereotype이 "include"·"extend"인 관계(«include»·«extend»)는 유즈케이스 사이의 dependency여야 한다 — elements 인자 설명의 "공용 입력(열쇠·이름)" 절에 적은 "어느 관계에든 단다"와 달리 다른 관계에 달면 입력 오류다. 다른 스테레오타입은 어느 관계에든 단다. 자기 자신을 포함하거나 확장하는 관계와 고리를 이루는 «include»끼리·«extend»끼리(A가 B를, B가 다시 A를 포함하거나 확장하는 것 — 여러 단계도)도 입력 오류다(«include»와 «extend»가 섞인 고리는 받는다). |