용어 · 검수·금지 목록

화면 숫자는 코드가 계산

Computed Numbers (Single Source of Truth)

차트의 각도, 비율, 합계, 라벨을 손으로 적지 않고 원본 데이터 한 곳에서 코드가 계산해 쓰면, 데이터가 바뀌어도 화면 숫자끼리 어긋나지 않는다. 반올림 때문에 퍼센트 합이 99%가 되는 사고도 여기서 걸러진다.

중급데이터 표현변화와 비교

01직접 돌려 보기

‘연출 전’은 대충 시켰을 때를 가정해 만든 화면이고 실제 AI 결과와 다를 수 있다.

연출 전흔한 첫 결과
연출 후완성본
0.00초 / 4.0초

02이름으로 시키는 지시문

대충 시킴차트에 퍼센트도 적어줘→ 대개 퍼센트를 글자로 적어 넣어서, 데이터가 바뀌면 라벨이 옛 값으로 남거나 합이 99%로 나온다
이름으로 시킴각도·비율·합계·라벨은 모두 데이터에서 계산하고, 정수 라벨은 합이 100이 되게 보정→ 데이터를 [196, 84, 63, 31]로 바꿔도 라벨이 따라 바뀌어 합 100을 지키는 도넛 차트
Claude Code · Codex에 그대로 붙여 넣기

도넛 차트의 모든 숫자를 데이터에서 코드가 계산하는 HTML 한 파일(canvas) 화면. 외부 라이브러리는 쓰지 않는다.

데이터: 항목 4개 쇼츠, 블로그, SNS, 기타. 처음 값은 [120, 90, 60, 30](합 300)이고, 1.0초에서 2.1초 사이에 새 값은 [196, 84, 63, 31](합 374)로 부드럽게(inOutCubic) 바뀐다.

도넛: 중심 (160, 182), 바깥 반지름 100, 도넛 구멍 반지름 비율 0.58(안쪽 반지름 = 바깥 × 0.58). 첫 조각은 12시 방향(−90°)에서 시계 방향으로 시작한다. 조각 각도는 값 ÷ 합 × 360°로 계산하고 canvas arc 에는 라디안(도 × π ÷ 180)으로 넣는다. 조각마다 대각선 그라디언트, 사이에는 경계선, 위에는 옅은 빛 번짐.

라벨: 각 조각의 중간 각도에서 바깥과 안쪽 반지름의 평균 거리에 퍼센트를 쓴다(구멍 크기를 바꾸면 라벨도 따라 움직여야 한다). 도넛 가운데에는 합계.

연출 전: 라벨 “40% 30% 20% 10%”와 가운데 합계 300을 손으로 적은 글자로 두어, 데이터가 바뀌어도 그대로 남게 한다. 아래에 “데이터는 바뀌었는데 라벨·합계는 처음 값 그대로 → 어긋남”을 표시한다.

2단계: 라벨 = 값 ÷ 합 × 100 의 반올림 정수, 가운데 합계 = 데이터의 합(코드가 계산). 오른쪽 표에 값, 비율(소수 첫째 자리), 각도(소수 첫째 자리), 라벨, 그리고 합 줄(비율 합 100.0%, 각도 합 360.0°, 라벨 합)을 적는다. 반올림만 하면 라벨 합이 99%가 되므로 경고를 보여 준다.

3단계: 라벨 합이 100%가 되도록 내림한 정수를 먼저 두고, 남는 몫은 소수 나머지가 큰 항목부터 1%씩 더한다(최대 잉여법).

화면 위: 지금 단계 이름표와 현재 데이터 값 줄. 체크와 가위표는 선으로 그린다.

금지: 화면의 숫자를 손으로 적어 넣기(연출 전 제외), 데이터를 바꿨는데 라벨, 합계, 각도 중 하나라도 처음 값으로 남기기, 라벨 합이 100이 아닌 채로 끝내기.

구현에 쓰이는 기술: Canvas arc(중심, 반지름, 시작각, 끝각), 각도는 라디안값 ÷ 합 = 비율, 비율 × 360° = 각도정수 라벨 합을 100으로 맞추기(최대 잉여법: 내림하고 나머지가 큰 순서로 +1)라벨 위치 = 중심 + 평균 반지름 × (cos, sin), 각도는 중간 각도이징으로 데이터 값을 바꾸고 모든 화면 숫자를 같은 계산에서 얻기

03응용 팁

팁은 데모에서 값만 바꿔 같은 장면과 비교한 것이다. AI가 같은 결과를 내는지는 직접 해 봐야 안다.

1

값을 바꿔도 화면 숫자가 같이 바뀌나?

값을 바꿔 넣고 라벨, 각도, 합계가 한꺼번에 따라 바뀌는지 확인하고 싶을 때

지시문에서
새 값은 [196, 84, 63, 31](합 374)
이렇게 바꾸세요
새 값은 [100, 100, 100, 100](합 400)
그러면
네 조각이 모두 90°의 같은 크기가 되고, 라벨은 전부 25%, 표의 비율은 25.0%, 각도는 90.0°가 된다. 가운데 합계는 400으로 코드가 새 합을 따라간다. 어느 줄도 손으로 고치지 않았다는 점이 핵심이다.
확인
2

도넛 고리를 더 두껍게 하고 싶을 때

구멍을 줄여 고리를 굵게 하면 라벨 위치도 따로 고쳐야 하는지 궁금할 때

지시문에서
도넛 구멍 반지름 비율 0.58
이렇게 바꾸세요
도넛 구멍 반지름 비율 0.3
그러면
구멍이 작아져 고리가 두꺼워지는데도, 라벨은 평균 반지름 거리로 저절로 옮겨 가 고리 한가운데에 그대로 놓인다.
확인

04만드는 순서

각 단계의 버튼을 누르면 위의 데모가 그 단계까지의 모습으로 바뀝니다.

  1. 라벨과 합계를 손으로 적어 둔 상태

    라벨 40, 30, 20, 10%와 가운데 합계 300을 글자로 직접 적었다. 처음 데이터와는 맞지만 1.0~2.1초에 데이터가 바뀌어도 이 글자는 그대로라서, 조각 크기와 라벨이 어긋난다.

    const HAND = ['40%', '30%', '20%', '10%'];   // 손으로 적은 값
    label.textContent = HAND[i];
  2. 라벨, 합계, 각도를 데이터에서 계산

    합계는 데이터의 합, 비율은 값 ÷ 합, 각도는 비율 × 360°, 라벨은 비율 × 100 의 반올림이다. 데이터가 바뀌면 조각, 라벨, 가운데 합계, 표의 숫자가 한꺼번에 따라 바뀐다. 다만 반올림한 라벨 합이 99%가 되어 경고가 뜬다.

    const sum = vals.reduce((p, q) => p + q, 0);
    const deg = v / sum * 360;
    const label = Math.round(v / sum * 100) + '%';
  3. 라벨 합을 100%로 보정

    내림한 정수를 먼저 두고, 남는 1%를 소수 나머지가 큰 항목부터 하나씩 더한다. 두 번째 라벨만 22%에서 23%로 올라 라벨 합이 99에서 100이 된다. 나머지 52, 17, 8%는 그대로이고 비율 합 100.0%와 각도 합 360.0°도 맞아 확인 줄이 초록이 된다.

    const fl = raw.map(Math.floor);
    let left = 100 - sum(fl);
    byRemainder.slice(0, left).forEach((i) => fl[i]++);

05전문용어 풀이

하드코딩Hard-coding

계산해서 얻어야 할 숫자를 코드나 문장에 손으로 박아 넣는 것. 원본이 바뀌어도 따라 바뀌지 않아 어긋남의 뿌리가 된다.

AI에게“화면의 숫자는 하드코딩하지 말고 데이터에서 계산해줘”
단일 원천Single source of truth

같은 정보를 한 곳에만 두고 나머지는 거기서 가져다 쓰는 구조이다.

AI에게데이터는 한 군데에만 두고, 차트와 표와 라벨은 거기서 계산
비율과 각도Share and Angle

원그래프 조각의 크기를 정하는 두 숫자. 비율은 값 ÷ 합계, 각도는 비율 × 360°.

AI에게“각 조각의 각도는 값 ÷ 합계 × 360으로 계산해줘”
라디안Radian

각도를 π(3.14159…) 기준으로 재는 단위이다. 도 × π ÷ 180 으로 바꾸며, canvas 의 arc 가 이 단위를 쓴다.

AI에게각도는 라디안으로 바꿔서 arc 에 넣기
반올림 오차Rounding error

항목마다 반올림했더니 합이 100이 안 되는 어긋남. 정수 퍼센트에서 흔하게 생긴다.

AI에게“퍼센트 라벨의 합이 항상 100이 되게 보정해줘”
최대 잉여법Largest remainder method

내림한 정수를 먼저 나누고, 남은 몫을 소수 나머지가 큰 쪽부터 하나씩 더 주는 방식. 라벨 합 맞추기에 쓴다.

AI에게“최대 잉여법으로 라벨 합을 100에 맞춰줘”
중간 각도Mid-angle

조각이 시작하는 각도와 끝나는 각도의 가운데 값이다. 라벨을 이 방향에 두면 조각이 바뀌어도 라벨이 조각 안에 남는다.

AI에게라벨은 각 조각의 중간 각도, 고리 두께의 한가운데에 배치

06결과를 받으면 이것부터 확인

  • 1.0~2.1초 사이에 데이터 줄의 숫자가 바뀌고 도넛 조각 크기도 같이 바뀐다
  • 1단계에서는 조각이 바뀌어도 라벨이 그대로다. 라벨은 40, 30, 20, 10%이고 가운데 합계도 300이며 아래에 ‘어긋남’ 표시가 뜬다
  • 2단계에서 라벨이 52, 22, 17, 8%로 바뀐다. 표의 라벨 합이 빨간 99%가 되고 노란 경고가 뜬다
  • 3단계 라벨은 52, 23, 17, 8%이다. 라벨 합은 100%이고 비율 합 100.0%와 각도 합 360.0°도 함께 적히며 초록 표시가 뜬다
  • 표의 쇼츠 줄이 52.4%, 188.7°이고 도넛의 쇼츠 조각 크기와 맞는다

07이럴 때 쓰세요

  • 라벨 숫자와 조각 크기가 서로 안 맞아 보이는 AI 차트
  • 퍼센트를 반올림해 적었더니 합이 99%나 101%가 되는 경우
  • 데이터를 바꿀 때마다 화면 숫자를 하나하나 고쳐야 하는 문서나 대시보드를 만들 때

08같이 쓰는 용어

09근거와 확인 범위

‘확인’은 출처 문서에서 사실로 확인한 내용, ‘추정’은 결과물을 보고 추론한 내용, ‘원본 없음’은 흔히 쓰이지만 대표 원본 사례를 확인하지 못해 성공 사례로 제시하지 않은 기법이다.

  • 확인Canvas 의 arc() 는 시작각과 끝각을 라디안으로 받고, 0은 3시 방향(오른쪽), 기본 방향은 시계 방향이라고 한다. 도를 라디안으로 바꾸는 식은 도 × π ÷ 180. 이 데모가 -90°(12시)를 라디안으로 바꿔 쓰고 조각 각도를 값 ÷ 합 × 360°에서 얻는 근거다. MDN — CanvasRenderingContext2D: arc()
  • 확인원그래프에서 조각의 호 길이, 중심각, 넓이는 그 조각이 나타내는 양에 비례하며, 전체의 비율 Q 에 해당하는 중심각은 360×Q 도. 퍼센트 합 100과 각도 합 360이 반올림으로 어긋날 수 있다는 언급도 있고, 도넛 차트는 가운데가 빈 변형으로 소개된다. Wikipedia — Pie chart
  • 확인최대 잉여법(largest remainder method)이란 몫의 정수 부분을 먼저 나눠 주고 남은 자리를 소수 나머지가 큰 쪽부터 하나씩 더 주는 배분 방식을 말한다(선거 의석 배분에 쓰임). 이 데모는 같은 방식을 퍼센트 라벨 합 100 맞추기에 빌려 썼을 뿐, 이 용도의 표준이라는 뜻은 아니다. Wikipedia — Largest remainder method
  • 확인단일 진실 원천(single source of truth)은 모든 데이터 요소를 한 곳에서만 만들고 고치게 하고 다른 곳은 그것을 참조하게 해서, 어긋나는 중복 값을 줄이는 구조. 이 페이지는 같은 생각을 차트에 옮겨 ‘원본 데이터 한 곳, 화면 숫자는 전부 계산’으로 풀었다. Wikipedia — Single source of truth