ADR-0041: 그림의 고정 문구는 문서의 언어를 따른다

배경

그림 안에는 사용자가 적지 않은 글이 있습니다. If 갈래의 처음 이름 “참” · “거짓”, 접힌 분기의 ”⋯ 블록 n개”, Case의 default, 이름 없는 호출 블록의 “(이름 없음)“입니다. 지금은 이 고정 문구를 저장할 때의 화면 언어로 그립니다(Q24, 01-file-format의 “같은 모델이면 같은 파일”의 예외).

그래서 같은 모델이라도 한국어 화면에서 저장한 파일과 영어 화면에서 저장한 파일은 그림 부분의 바이트가 다릅니다. 화면 언어가 다른 두 사람이 git으로 같은 파일을 고치면, 저장할 때마다 손대지 않은 If의 갈래 글자까지 diff에 나옵니다. 배포 대상에는 팀이 함께 쓰는 곳(IDE 플러그인, Confluence)이 있고, R-FMT-03은 같은 모델이면 같은 파일을 요구합니다.

파일 형식은 웹 1.0 전이라 지금은 바꿀 수 있습니다 → DR-0018

결정 기준

  • 같은 모델이면 누가 어느 화면 언어로 저장해도 같은 바이트(R-FMT-03)
  • 읽는 사람에게 고정 문구가 바로 읽힐 것(기호가 아니라 말)
  • 화면의 메뉴 · 알림은 각자의 화면 언어 그대로(R-NFR-04)

검토한 대안

대안 A: 저장할 때의 화면 언어 (지금)

  • 장점: 각자 늘 자기 언어로 봅니다. 파일에 필드가 늘지 않습니다.
  • 단점: 화면 언어가 다르면 바이트가 달라집니다. R-FMT-03에 예외가 생깁니다.

대안 B: 문서에 그림의 언어를 둔다

  • 장점: 바이트가 늘 같습니다. 화면과 저장 파일 · 인쇄 · PNG가 같은 글입니다.
  • 단점: 영어 화면의 사람이 한국어로 만든 문서를 열면 갈래에 “참” · “거짓”이 보입니다. 파일 형식에 필드가 하나 늡니다.

대안 C: 언어에 매이지 않는 기호(✓ · ✗)

  • 장점: 바이트가 늘 같고 설정도 없습니다.
  • 단점: “참” · “거짓”처럼 바로 읽히지 않고, 도안 작품의 관례와 다릅니다.

결정

대안 B. 메인테이너가 2026-11-03에 골랐습니다(고르는 창의 세 안 가운데 추천안).

  • 문서 설정에 그림의 언어 locale("en" | "ko", 화면 언어의 목록과 같음)을 둡니다.
  • 새 문서는 만든 사람의 화면 언어로 시작합니다. 문서 설정에서 바꿀 수 있습니다.
  • 고정 문구는 화면에서도, 저장 파일 · PNG에서도 이 언어로 그립니다. 메뉴 · 알림 · 상태 표시줄은 각자의 화면 언어 그대로입니다.
  • locale이 없는 파일(지금까지 저장한 파일)은 연 사람의 화면 언어로 열고, 다음에 저장할 때 그 값을 적습니다.
  • 편집한 갈래 이름은 지금처럼 적은 그대로입니다. 비우면 문서의 언어로 된 처음 이름으로 돌아갑니다.

결과

  • 좋아지는 점: 01-file-format의 “같은 모델이면 같은 파일”에서 예외가 사라집니다. git diff에 손대지 않은 그림이 섞이지 않습니다.
  • 감수하는 점: 다른 언어의 문서를 열면 그림의 고정 문구가 내 화면 언어와 다를 수 있습니다.
  • 후속 작업: 모델 · 파일 형식(01-file-format 3장의 settings)과 Q24의 문구, 문서 설정 화면, 렌더러가 화면 언어 대신 문서 설정을 읽게 하기, 골든 파일. → backlog