@things-factory/figure-service 10.1.224 → 10.1.227

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@things-factory/figure-service",
-  "version": "10.1.224",
+  "version": "10.1.227",
   "publishConfig": {
     "access": "public",
     "@things-factory:registry": "https://registry.npmjs.org"
@@ -25,18 +25,18 @@
     "test:templates": "node --test scripts/templates.test.mts"
   },
   "dependencies": {
-    "@hatiolab/figure-model": "^0.12.0",
+    "@hatiolab/figure-model": "^0.12.1",
     "@operato/typeorm-history": "^10.0.0",
-    "@things-factory/ai-client-base": "^10.1.223",
-    "@things-factory/attachment-base": "^10.1.223",
-    "@things-factory/auth-base": "^10.1.223",
+    "@things-factory/ai-client-base": "^10.1.227",
+    "@things-factory/attachment-base": "^10.1.227",
+    "@things-factory/auth-base": "^10.1.227",
     "@things-factory/env": "^10.1.149",
-    "@things-factory/setting-base": "^10.1.223",
-    "@things-factory/shell": "^10.1.208",
+    "@things-factory/setting-base": "^10.1.227",
+    "@things-factory/shell": "^10.1.227",
     "graphql-scalars": "^1.22.4",
     "graphql-upload": "^15.0.2",
     "jszip": "^3.10.1",
     "koa-router": "^7.4.0"
   },
-  "gitHead": "7edcdca6fc9862973e99048812e22f2aa9b2f9c9"
+  "gitHead": "f66591e3864aab08a6fb93fb1fcf1c9de6b546ac"
 }

package/server/routers/figure-thumbnail-router.ts

@@ -101,7 +101,7 @@ export async function sendFigureThumbnail(
   /*
     **개인 캐시만 허락한다.** 이 그림은 권한을 본 뒤에 내주는 것이므로 공용 캐시(프록시)에 남으면 안 된다 —
     attachment 의 공개 경로가 쓰는 `public` 을 따라 쓰지 않는다(판정 조건 1). 같은 내용은 같은 해시이므로 ETag 가
-    곧 내용이다. 부르는 쪽이 `?v=` 로 판을 가리므로 오래 두어도 낡은 그림이 남지 않는다.
+    곧 내용이다. 부르는 쪽이 `?v=` 로 버전을 가리므로 오래 두어도 낡은 그림이 남지 않는다.
   */
   const ours = () => {
     context.type = picture.mimetype

package/server/service/figure/event-subscriber.ts

@@ -6,17 +6,17 @@ import { Figure } from './figure.js'
 import { FigureHistory } from './figure-history.js'
 
 /**
- * 판본을 남긴다 — **발행된 저장에만.**
+ * 버전을 남긴다 — **발행된 저장에만.**
  *
  * `@operato/typeorm-history` 는 원래 모든 저장을 베낀다. 그런데 피규어는 저작 중에 수십 번 저장되고,
- * 그 전부를 남기면 판본 목록이 「내가 오늘 몇 번 눌렀나」가 된다. 사람이 판이라고 부르는 것은
+ * 그 전부를 남기면 버전 목록이 「내가 오늘 몇 번 눌렀나」가 된다. 사람이 버전이라고 부르는 것은
  * **발행한 것**이므로 그때만 베낀다. board 가 같은 규칙으로 돈다(`board-service` 의 같은 이름 파일).
  *
- * 발행판의 정본(`__releaseSource`)은 크기 범위를 적은 발행판 사본이다 — Figure 행에는 작성자가 좁힌 끝만 남는다.
+ * 발행 버전의 정본(`__releaseSource`)은 크기 범위를 적은 발행 버전 사본이다 — Figure 행에는 작성자가 좁힌 끝만 남는다.
  *
  * 발행 메모는 Figure 의 칸이 아니다. `releaseFigure` 가 저장할 엔티티에 `__releaseComment` 로 얹어
- * 두면 여기서 판본의 `comment` 로 옮긴다 — 메모는 그 판의 것이지 피규어의 것이 아니다. 정본 형식
- * (`__releaseFormat`), 잰 커널의 판(`__releaseKernel`, ADR-0109 C1), 직전 판에 견준 변경(`__releaseChanges`), 발행 때 잰 값(`__releaseMetrics`)과
+ * 두면 여기서 버전의 `comment` 로 옮긴다 — 메모는 그 버전의 것이지 피규어의 것이 아니다. 정본 형식
+ * (`__releaseFormat`), 잰 커널의 버전(`__releaseKernel`, ADR-0109 C1), 직전 버전에 견준 변경(`__releaseChanges`), 발행 때 잰 값(`__releaseMetrics`)과
  * 윗모습(`__releaseTopView`)도 같은 길로 옮긴다(ADR-0104).
  */
 /** What `releaseFigure` laid on the entity for this release, moved onto the history row. */

package/server/service/figure/figure-blueprint-query.test.ts

@@ -131,7 +131,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)에 발
     expect(partsOf(result)).toEqual(['box-1'])
   })
 
-  it('현재 저작 중(draft)이더라도 과거 발행판(FigureHistory)이 있으면 최신 발행판을 반환한다', async () => {
+  it('현재 저작 중(draft)이더라도 과거 발행 버전(FigureHistory)이 있으면 최신 발행 버전을 반환한다', async () => {
     const repo = dataSource!.getRepository(Figure)
     const historyRepo = dataSource!.getRepository(FigureHistory)
 
@@ -152,7 +152,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)에 발
       domain: testDomain,
       originalId: figure.id,
       type: 'UPDATING_FIGURE',
-      name: 'v1 발행판',
+      name: 'v1 발행 버전',
       state: 'released',
       version: 1,
       source: v1Source
@@ -162,7 +162,7 @@ describe('figureBlueprint 질의 — 소비처(board, twin, things-scene)에 발
     const result = await query.figureBlueprint('UPDATING_FIGURE', makeContext())
 
     expect(result).not.toBeNull()
-    // 소비처는 수정 중인 초안(box-modified, size 200)이 아니라 기발행된 판(box-1, size 100)을 본다!
+    // 소비처는 수정 중인 초안(box-modified, size 200)이 아니라 기발행된 버전(box-1, size 100)을 본다!
     expect(partsOf(result)).toEqual(['box-1'])
     expect(widthOf(result, 'box-1')).toBe(100)
   })

package/server/service/figure/figure-format.test.ts

@@ -20,9 +20,9 @@ function figureAsset(): FigureAsset {
 }
 const figureSource = () => serializeFigureAsset(figureAsset())
 
-describe('figure-format — 판을 알아보는 문', () => {
-  describe('판은 자산이 적는다', () => {
-    it('판을 안 적은 정본은 거절한다 — 생김새로 짐작하지 않는다', () => {
+describe('figure-format — 버전을 알아보는 문', () => {
+  describe('버전은 자산이 적는다', () => {
+    it('버전을 안 적은 정본은 거절한다 — 생김새로 짐작하지 않는다', () => {
       for (const text of [JSON.stringify({ type: 'MIXER', parts: [] }), JSON.stringify({ version: 2, type: 'MIXER', parts: [] })]) {
         expect(() => parseSource(text)).toThrow(FigureSourceError)
         try {
@@ -280,7 +280,7 @@ describe('figure-format — 판을 알아보는 문', () => {
   })
 
   /* ADR-0104 decision 5: a release records its format and what changed against the last one, once, as it was then. */
-  describe('발행이 스스로 남기는 것 — 형식과 직전 판에 견준 변경', () => {
+  describe('발행이 스스로 남기는 것 — 형식과 직전 버전에 견준 변경', () => {
     const wider = () => {
       let asset = createFigureAsset('Mixer')
       asset = addFigureBox(asset, { id: 'body', size: { x: 300, y: 100, z: 100 }, position: { x: 0, y: 50, z: 0 } })

package/server/service/figure/figure-format.ts

@@ -107,7 +107,7 @@ function assertFormat(sourceJson: string): void {
   }
   if ((parsed as { version?: unknown } | null)?.version !== FIGURE_ASSET_VERSION)
     throw new FigureSourceError([
-      { code: 'source-format-unknown', message: `정본의 판을 알 수 없다 — 피규어 자산은 version '${FIGURE_ASSET_VERSION}' 을 적는다`, at: 'version' }
+      { code: 'source-format-unknown', message: `정본의 버전을 알 수 없다 — 피규어 자산은 version '${FIGURE_ASSET_VERSION}' 을 적는다`, at: 'version' }
     ])
 }
 
@@ -195,7 +195,7 @@ function figureWording(violation: FigureViolation, say: Say): Pick<GateFinding,
       return {
         message: say(key('message'), { parts, axes, factor }, `At ${factor}x on ${axes}, ${parts} come away from the rest of the figure.`),
         why: say(key('why'), {}, 'A figure placed at another size shows those parts hanging in the air — to a person, it looks broken.'),
-        how: say(key('how'), { parts }, `Fasten ${parts} to a face of the part they rest on, or press "fix here" under position in the responsive tab, so they stay put when the figure is resized.`)
+        how: say(key('how'), { parts }, `Fasten ${parts} to a face of the part they rest on, or press "fix here" under position in the size tab, so they stay put when the figure is resized.`)
       }
     }
     case 'SIZING_NOT_UNIFORM': {
@@ -207,7 +207,7 @@ function figureWording(violation: FigureViolation, say: Say): Pick<GateFinding,
       return {
         message: say(key('message'), { parts, axes, factor }, `The figure grows by one ratio, but at ${factor}x on ${axes} ${parts} do not grow with it.`),
         why: say(key('why'), {}, 'A figure that grows by one ratio keeps its proportions at any size. A part with a size or place of its own comes apart from the rest.'),
-        how: say(key('how'), { parts }, `Let ${parts} follow the figure's size ("in proportion" under position in the responsive tab), or remove their own fixed numbers.`)
+        how: say(key('how'), { parts }, `Let ${parts} follow the figure's size ("in proportion" under position in the size tab), or remove their own fixed numbers.`)
       }
     }
   }

package/server/service/figure/figure-history.ts

@@ -14,16 +14,16 @@ import { Domain, longTextColumn } from '@things-factory/shell'
 import { Figure } from './figure.js'
 
 /**
- * 발행된 판 하나 — **발행할 때만 남는다.**
+ * 발행된 버전 하나 — **발행할 때만 남는다.**
  *
  * 저작 중 저장은 여기 오지 않는다. 스냅샷을 뜨는 subscriber 가 `state === 'released'` 인 저장에만
  * 움직인다(`event-subscriber.ts`) — board 가 같은 규칙으로 돈다.
  *
  * ## 왜 통째로 베끼나
  *
- * 판을 되세우려면 그때의 정본만으로는 모자란다. 이름·분류·그림·비용까지 함께 있어야 「그 판이
+ * 버전을 되세우려면 그때의 정본만으로는 모자란다. 이름·분류·그림·비용까지 함께 있어야 「그 버전이
  * 무엇이었나」를 보여 주고 되돌릴 수 있다. 파생값(점수·삼각형·묶음)도 같이 둔다 — 다시 계산하면
- * 형식이 바뀐 오늘의 값이 나오고, 그것은 그 판의 값이 아니다.
+ * 형식이 바뀐 오늘의 값이 나오고, 그것은 그 버전의 값이 아니다.
  */
 @Entity()
 @Index('ix_figure_history_0', (history: FigureHistory) => [history.originalId, history.version], { unique: true })
@@ -94,7 +94,7 @@ export class FigureHistory implements HistoryEntityInterface<Figure> {
   thumbnailHash?: string
 
   /*
-   * 그때의 비용이다. 오늘 다시 계산하면 오늘의 형식으로 나온다 — 그 판을 설명하지 못한다.
+   * 그때의 비용이다. 오늘 다시 계산하면 오늘의 형식으로 나온다 — 그 버전을 설명하지 못한다.
    */
   @Column({ type: 'float', nullable: true })
   @Field(type => Float, { nullable: true, description: 'Reuse score as computed at this version.' })
@@ -113,8 +113,8 @@ export class FigureHistory implements HistoryEntityInterface<Figure> {
   comment?: string
 
   /*
-   * 이 판의 정본 형식(`figure-asset-1`)과, 직전 판에 견준 변경(ADR-0104 결정 5). 발행할 때 한 번 정하고 다시
-   * 계산하지 않는다 — 판을 고정해 쓰는 쪽은 다음 판으로 옮기기 전에 이것을 읽는다.
+   * 이 버전의 정본 형식(`figure-asset-1`)과, 직전 버전에 견준 변경(ADR-0104 결정 5). 발행할 때 한 번 정하고 다시
+   * 계산하지 않는다 — 버전을 고정해 쓰는 쪽은 다음 버전으로 옮기기 전에 이것을 읽는다.
    */
   @Column({ nullable: true })
   @Field({ nullable: true, description: 'The asset format this version was written in (figure-asset-1).' })
@@ -129,9 +129,9 @@ export class FigureHistory implements HistoryEntityInterface<Figure> {
   changes?: string
 
   /*
-   * 이 판을 잰 커널의 판(figure-model `FIGURE_KERNEL_VERSION`). 점수 · 묶음 · metrics 는 그 커널의 규칙으로 센 값이다 —
+   * 이 버전을 잰 커널의 버전(figure-model `FIGURE_KERNEL_VERSION`). 점수 · 묶음 · metrics 는 그 커널의 규칙으로 센 값이다 —
    * 규칙이 바뀌어도 발행된 값을 다시 세서 덮지 않고(ADR-0109 C1), 읽는 쪽은 이 칸으로 「남긴 값」과 「지금 규칙의 값」을
-   * 가른다. 이 칸이 생기기 전에 발행된 판은 비어 있다.
+   * 가른다. 이 칸이 생기기 전에 발행된 버전은 비어 있다.
    */
   @Column({ nullable: true })
   @Field({

package/server/service/figure/figure-mutation.ts

@@ -245,7 +245,7 @@ export class FigureMutation {
     /*
       **그림만 바꾸면 발행이 풀리지 않는다.** 미리보기에서 사람이 돌려 놓은 각도로 찍은 그림이 그렇게 온다.
       그림은 발행이 약속하는 것이 아니다 — 발행본은 제 그림을 따로 갖고, 다음 발행이 이 그림을 가져간다.
-      판본 구독자를 거치지 않는다: 발행된 행의 저장을 판으로 베끼는데, 이것은 판이 아니다.
+      버전 구독자를 거치지 않는다: 발행된 행의 저장을 버전으로 베끼는데, 이것은 버전이 아니다.
     */
     if (patch.thumbnail !== undefined && Object.keys(patch).every(key => key === 'thumbnail' || (patch as any)[key] === undefined)) {
       const picture = await pictureOf(tx, domain, user, patch.thumbnail, figure)
@@ -274,7 +274,7 @@ export class FigureMutation {
 
       발행된 뒤에는 이미 배치된 도면이 이 이름을 가리키고, 바꾸면 그 도면이 아무 오류 없이
       빈 자리가 된다. 발행된 적 없는 피규어는 가리키는 도면이 있을 수 없다 — 도면은 최신
-      발행판을 그리므로 그려질 자리가 없다.
+      발행 버전을 그리므로 그려질 자리가 없다.
 
       행과 정본 둘 다 고친다. 정본 안에도 `type` 이 있어서 한쪽만 고치면 저장된 JSON 과
       행이 다른 이름을 말하고, 발행할 때 어느 쪽이 도면에 적히는지가 갈린다.
@@ -294,14 +294,14 @@ export class FigureMutation {
     }
 
     /*
-      **판 번호는 여기서 손대지 않는다.** 저장은 저작이고, 판은 발행에서 생긴다(`releaseFigure`).
+      **버전 번호는 여기서 손대지 않는다.** 저장은 저작이고, 버전은 발행에서 생긴다(`releaseFigure`).
       board 의 `updateBoard` 도 같다 — 저장 경로에는 version 이 없다.
     */
     const saved = await repository.save({
       /*
         `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.
 
-        판본 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 판본의 도메인이 비고 그 판은
+        버전 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 버전의 도메인이 비고 그 버전은
         도메인으로 거르는 조회에 **한 줄도 안 걸린다**(실제로 그랬다). board 의 저장들도 같은
         자리에서 domain 을 함께 넣는다.
       */
@@ -314,9 +314,9 @@ export class FigureMutation {
       /*
         **고치면 발행이 풀린다.**
 
-        발행은 「이 판을 써도 된다」는 약속이고, 그 뒤에 정본이 바뀌면 약속한 것과 배포된 것이
+        발행은 「이 버전을 써도 된다」는 약속이고, 그 뒤에 정본이 바뀌면 약속한 것과 배포된 것이
         달라진다. 그래서 저장은 언제나 초안으로 되돌리고, 다시 내보내려면 발행을 한 번 더 한다
-        (판 번호가 하나 오르고 판본이 하나 더 남는다). board 의 `updateBoard` 가 같은 한 줄을 쓴다.
+        (버전 번호가 하나 오르고 버전이 하나 더 남는다). board 의 `updateBoard` 가 같은 한 줄을 쓴다.
       */
       state: 'draft',
       ...(derived ?? {}),
@@ -354,21 +354,21 @@ export class FigureMutation {
   }
 
   /**
-   * 발행한다 — **판이 생기는 유일한 자리.**
+   * 발행한다 — **버전이 생기는 유일한 자리.**
    *
    * ## 무엇이 일어나나
    *
-   * `state` 가 `released` 가 되고, 판 번호가 하나 오르고, 그 순간의 피규어가 판본으로 남는다
+   * `state` 가 `released` 가 되고, 버전 번호가 하나 오르고, 그 순간의 피규어가 버전으로 남는다
    * (`FigureHistory` — 스냅샷은 구독자가 뜬다). 저작 중 저장은 이 셋 중 아무것도 하지 않는다.
    *
    * ## 왜 이미 발행된 것을 거절하나
    *
-   * 발행은 소비처에게 하는 약속이다. 같은 판을 두 번 발행하면 무엇이 약속인지 흐려진다. 고쳐서
+   * 발행은 소비처에게 하는 약속이다. 같은 버전을 두 번 발행하면 무엇이 약속인지 흐려진다. 고쳐서
    * 다시 내려면 초안으로 되돌린 뒤 발행한다 — board 가 같은 규칙이다.
    *
-   * ## 번호는 판본에서 센다
+   * ## 번호는 버전에서 센다
    *
-   * 피규어의 현재 번호가 아니라 **판본의 최대 번호 + 1** 이다. 되돌리기로 옛 판이 현재가 되어도
+   * 피규어의 현재 번호가 아니라 **버전의 최대 번호 + 1** 이다. 되돌리기로 옛 버전이 현재가 되어도
    * 다음 발행이 이미 쓴 번호를 다시 쓰지 않는다.
    *
    * ## 게이트를 통과해야 한다
@@ -409,8 +409,8 @@ export class FigureMutation {
       막는 이유는 사유와 함께 낸다. 「발행할 수 없습니다」로 뭉치면 무엇을 고쳐야 하는지 모른다.
     */
     /*
-      직전 발행판을 먼저 꺼낸다. 판 번호를 세는 데도 쓰고, **약속을 깨는 발행인가**를 견주는 데도
-      쓴다(ADR-0063 결정 3) — 도면은 type 만 적고 늘 최신 발행판을 그리므로, 다시 발행하는 것은
+      직전 발행 버전을 먼저 꺼낸다. 버전 번호를 세는 데도 쓰고, **약속을 깨는 발행인가**를 견주는 데도
+      쓴다(ADR-0063 결정 3) — 도면은 type 만 적고 늘 최신 발행 버전을 그리므로, 다시 발행하는 것은
       그 type 을 놓아 둔 모든 도면에게 같은 약속을 다시 하는 일이다.
     */
     const released = await historyRepository
@@ -437,7 +437,7 @@ export class FigureMutation {
       /*
         `domain` 을 명시로 넣는다 — 읽어 온 엔티티에는 관계가 안 실려 있다.
 
-        판본 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 판본의 도메인이 비고 그 판은
+        버전 스냅샷은 넘겨받은 엔티티를 베끼므로, 여기서 빠지면 버전의 도메인이 비고 그 버전은
         도메인으로 거르는 조회에 **한 줄도 안 걸린다**(실제로 그랬다). board 의 저장들도 같은
         자리에서 domain 을 함께 넣는다.
       */
@@ -446,7 +446,7 @@ export class FigureMutation {
       version: nextVersion,
       state: 'released',
       updater: user,
-      /* 판본 구독자가 이것들을 판본의 comment · assetFormat · kernelVersion · changes 로 옮긴다. Figure 의 칸이 아니다. */
+      /* 버전 구독자가 이것들을 버전의 comment · assetFormat · kernelVersion · changes 로 옮긴다. Figure 의 칸이 아니다. */
       /* The release's own copy, its size range written down; the figure keeps the author's (ADR-0087 decision 6). */
       __releaseSource: record.source,
       __releaseComment: comment ?? null,
@@ -459,22 +459,22 @@ export class FigureMutation {
   }
 
   /**
-   * 옛 판으로 되돌린다.
+   * 옛 버전으로 되돌린다.
    *
    * ## 무엇이 돌아오나
    *
-   * 그 판의 **정본과 속성 정의, 그리고 그림**이다. 이름·설명·분류는 그대로 둔다 — 그것들은 언제든
+   * 그 버전의 **정본과 속성 정의, 그리고 그림**이다. 이름·설명·분류는 그대로 둔다 — 그것들은 언제든
    * 바꿔도 안전한 카탈로그의 말이고, 되돌리기가 개명까지 되돌리면 사람이 시키지 않은 일을 한다.
    *
    * ## 되돌려도 발행은 아니다
    *
-   * 초안으로 돌아온다. 다시 내보내려면 발행을 한 번 더 하고, 그때 판 번호는 **이미 쓴 번호 다음**을
-   * 받는다 — 3판을 되살렸다고 다시 3판이 되지 않는다. board 도 같다.
+   * 초안으로 돌아온다. 다시 내보내려면 발행을 한 번 더 하고, 그때 버전 번호는 **이미 쓴 번호 다음**을
+   * 받는다 — 버전 3을 되살렸다고 다시 버전 3이 되지 않는다. board 도 같다.
    *
    * ## 비용은 다시 잰다
    *
-   * 판본이 든 점수·삼각형은 **그때의 형식**으로 잰 값이다. 지금 이 피규어가 그 내용이 되었으므로
-   * 오늘 기준으로 다시 계산한다. 옛 값은 판본에 그대로 남아 있다.
+   * 버전이 든 점수·삼각형은 **그때의 형식**으로 잰 값이다. 지금 이 피규어가 그 내용이 되었으므로
+   * 오늘 기준으로 다시 계산한다. 옛 값은 버전에 그대로 남아 있다.
    */
   @Directive('@transaction')
   @Directive('@privilege(category: "figure", privilege: "mutation", domainOwnerGranted: true)')
@@ -539,8 +539,8 @@ export class FigureMutation {
   /**
    * 퇴역시키거나 되살린다(ADR-0104 결정 6).
    *
-   * 표시일 뿐이다. 발행판은 그대로 남고 받는 쪽은 그대로 받는다 — 발행판은 지우지 않는다. 그래서 **발행을 풀지 않는다**:
-   * 행을 엔티티로 저장하지 않고 질의로 고친다. 엔티티로 저장하면 발행된 행이라 판본 구독자가 같은 번호로 판본을 또
+   * 표시일 뿐이다. 발행 버전은 그대로 남고 받는 쪽은 그대로 받는다 — 발행 버전은 지우지 않는다. 그래서 **발행을 풀지 않는다**:
+   * 행을 엔티티로 저장하지 않고 질의로 고친다. 엔티티로 저장하면 발행된 행이라 버전 구독자가 같은 번호로 버전을 또
    * 뜬다. 대신 쓸 것(`supersededBy`)은 같은 도메인(또는 상위)에 있는 다른 type 이어야 한다. 퇴역은 소유 도메인의 figure 만 한다.
    */
   @Directive('@transaction')

package/server/service/figure/figure-query.ts

@@ -94,9 +94,9 @@ export class FigureQuery {
    * `state` 로 걸러지지 않는다 — `draft` 인 Figure 의 이름도 이미 점유된 것이다.
    */
   /**
-   * 발행된 판들 — 최근 것부터.
+   * 발행된 버전들 — 최근 것부터.
    *
-   * 저작 중 저장은 여기 없다. 판본은 발행에서만 생기므로(`releaseFigure`), 이 목록이 곧
+   * 저작 중 저장은 여기 없다. 버전은 발행에서만 생기므로(`releaseFigure`), 이 목록이 곧
    * 「이 피규어가 몇 번 약속되었나」다.
    */
   @Directive('@privilege(category: "figure", privilege: "query", domainOwnerGranted: true)')
@@ -115,9 +115,9 @@ export class FigureQuery {
   }
 
   /**
-   * 지금 소비처가 쓰는 판.
+   * 지금 소비처가 쓰는 버전.
    *
-   * 피규어의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 판**이고,
+   * 피규어의 현재 정본은 저작 중일 수 있다(초안). 배치된 것이 보는 것은 **마지막으로 발행된 버전**이고,
    * 그것을 이 자리가 답한다.
    */
   /** What a kept GLB holds, read again from its bytes (ADR-0129): the modeller asks when it reopens a figure. */
@@ -185,7 +185,7 @@ export class FigureQuery {
     }
 
     /*
-      **화면이 발행 문과 같은 것을 본다.** 직전 발행판을 여기서도 함께 넘기지 않으면, 저작 화면은
+      **화면이 발행 문과 같은 것을 본다.** 직전 발행 버전을 여기서도 함께 넘기지 않으면, 저작 화면은
       조용한데 발행을 누른 순간 계약 위반으로 막힌다 — 그때는 이미 열 군데를 고친 뒤다.
     */
     const released = await getRepository(FigureHistory)
@@ -260,10 +260,10 @@ export class FigureQuery {
    * `{ type, asset }`. 그리는 쪽(`registerFigure`)이 커널로 컴파일한다.
    *
    * ## 규칙
-   * 1. 소비처는 초안(draft)을 볼 수 없다 — **반드시 발행된(released) 판만 전달**한다.
+   * 1. 소비처는 초안(draft)을 볼 수 없다 — **반드시 발행된(released) 버전만 전달**한다.
    * 2. 현재 Figure가 released 상태이면 현재 source를 넘긴다.
    * 3. 현재 Figure가 저작 중(draft)이더라도 이전에 발행된 이력(FigureHistory)이 있으면
-   *    가장 최근의 released 판본을 넘긴다.
+   *    가장 최근의 released 버전을 넘긴다.
    * 4. 한 번도 발행된 적 없는 초안 자산이거나 존재하지 않는 타입인 경우 null을 반환하여
    *    미완성 자산이 씬 화면에 유출되는 것을 엄격히 차단한다.
    * 5. 도메인 상속 시 자식 도메인의 타입이 부모 도메인의 동일 타입을 항상 오버라이드한다.

package/server/service/figure/figure-rename-db.test.ts

@@ -2,7 +2,7 @@
  * 이름을 바꾸기 전에 읽는 사실 셋 — **sqlite 를 실제로 들고** 확인한다.
  *
  * 규칙(`renameDraftType`)은 사실을 받아 판단하므로 DB 없이 시험한다. 그런데 그 사실을 읽는
- * 질의가 틀리면 저작자에게는 저장 실패로만 보인다. 실제로 그랬다 — 판본을 `figure: { id }` 로
+ * 질의가 틀리면 저작자에게는 저장 실패로만 보인다. 실제로 그랬다 — 버전을 `figure: { id }` 로
  * 물었고 `FigureHistory` 는 관계 칸이 아니라 `originalId` 로 가리킨다. TypeORM 이 「그런 속성이
  * 없다」로 던졌고, 순수 시험은 전부 초록이었다.
  *
@@ -107,13 +107,13 @@ const facts = async (figure: any, wanted: string) =>
   )
 
 describe('이름을 바꾸기 전에 읽는 사실', () => {
-  it('★ 판본 질의가 실제로 돈다 — 칸 이름이 틀리면 여기서 던진다', async () => {
+  it('★ 버전 질의가 실제로 돈다 — 칸 이름이 틀리면 여기서 던진다', async () => {
     const figure = await seedFigure()
 
     expect(await facts(figure, 'robot-arm')).toEqual({ version: 0, hasHistory: false, takenByAnother: false, releasedBefore: false })
   })
 
-  it('★ 판본이 있으면 그것을 읽어 온다', async () => {
+  it('★ 버전이 있으면 그것을 읽어 온다', async () => {
     const figure = await seedFigure()
     await dataSource!.getRepository(FigureHistory).save({
       originalId: figure.id,

package/server/service/figure/figure-rename.test.ts

@@ -39,11 +39,11 @@ describe('초안의 type 고치기', () => {
     expect(() => renameDraftType(draft(), 'Robot_Arm', never)).toThrow(expect.objectContaining({ code: 'malformed-type' }))
   })
 
-  it('★ 한 번이라도 발행됐으면 거절한다 — 판 번호로', () => {
+  it('★ 한 번이라도 발행됐으면 거절한다 — 버전 번호로', () => {
     expect(() => renameDraftType(draft(), 'robot-arm', { ...never, version: 1 })).toThrow(FigureRenameRefused)
   })
 
-  it('★ 판 번호가 도로 0 이어도 이력이 있으면 거절한다 — 되돌리기가 그 자리를 만든다', () => {
+  it('★ 버전 번호가 도로 0 이어도 이력이 있으면 거절한다 — 되돌리기가 그 자리를 만든다', () => {
     try {
       renameDraftType(draft(), 'robot-arm', { ...never, hasHistory: true })
       throw new Error('거절하지 않았다')

package/server/service/figure/figure-rename.ts

@@ -6,7 +6,7 @@ import { TYPE_LENGTH, TYPE_PATTERN } from '@hatiolab/figure-model'
  * ## 왜 발행 전에만인가
  *
  * `type` 은 도면에 적히는 이름이다. 도면은 `{ type, left, top, width, height }` 만 갖고 늘 최신
- * 발행판을 그리므로, 발행된 피규어의 이름을 바꾸면 이미 배치된 도면이 아무 오류 없이 빈 자리가
+ * 발행 버전을 그리므로, 발행된 피규어의 이름을 바꾸면 이미 배치된 도면이 아무 오류 없이 빈 자리가
  * 된다. 한 번도 발행되지 않은 피규어는 그려질 자리가 없으니 가리키는 도면도 있을 수 없다.
  *
  * ## 왜 열어야 했나
@@ -17,22 +17,22 @@ import { TYPE_LENGTH, TYPE_PATTERN } from '@hatiolab/figure-model'
  *
  * ## 셈은 여기, 질의는 부르는 쪽
  *
- * 이 파일은 저장소를 모른다 — 판 번호 · 이력 유무 · 같은 이름의 주인을 **사실로 받는다.**
+ * 이 파일은 저장소를 모른다 — 버전 번호 · 이력 유무 · 같은 이름의 주인을 **사실로 받는다.**
  * 그래야 규칙을 DB 없이 시험한다. 문(`figure-mutation.ts`)이 그 셋을 읽어 넘긴다.
  */
 
 
 /** 이름을 바꿀 때 알아야 하는 사실. 부르는 쪽이 저장소에서 읽어 온다. */
 export interface RenameFacts {
-  /** 발행 판 번호. 0 이면 한 번도 발행되지 않았다. */
+  /** 발행 버전 번호. 0 이면 한 번도 발행되지 않았다. */
   version?: number
-  /** 판본이 하나라도 있나. 되돌리기로 판 번호가 도로 낮아져도 이력은 남는다. */
+  /** 버전이 하나라도 있나. 되돌리기로 버전 번호가 도로 낮아져도 이력은 남는다. */
   hasHistory: boolean
   /** 같은 도메인에서 그 이름을 이미 쓰는 **다른** 피규어가 있나. */
   takenByAnother: boolean
   /**
    * 같은 도메인에서 그 이름으로 발행한 뒤 지워진 피규어가 있나. 발행한 피규어를 지울 수 없게 되기(G4) 전에 지워진 것이다.
-   * 그 이름을 다시 쓰면 판 번호가 1부터 다시 매겨져 같은 `ns/type@n` 이 다른 내용을 가리킨다.
+   * 그 이름을 다시 쓰면 버전 번호가 1부터 다시 매겨져 같은 `ns/type@n` 이 다른 내용을 가리킨다.
    */
   releasedBefore?: boolean
 }
@@ -57,7 +57,7 @@ export async function typeReleasedBefore(
 
 /** Said when a type was released and deleted before: a new figure may not take it. */
 export const releasedBeforeMessage = (type: string) =>
-  `type 「${type}」 는 이 도메인에서 발행한 뒤 지운 피규어의 이름이다 — 다시 쓰면 같은 판 번호가 다른 내용을 가리키므로 다른 이름을 고른다`
+  `type 「${type}」 는 이 도메인에서 발행한 뒤 지운 피규어의 이름이다 — 다시 쓰면 같은 버전 번호가 다른 내용을 가리키므로 다른 이름을 고른다`
 
 export class FigureRenameRefused extends Error {
   constructor(
@@ -120,7 +120,7 @@ export function renameDraftType(
  * 사실 셋을 저장소에서 읽는다.
  *
  * 규칙에서 떼어 둔 자리이지만 **질의의 모양이 틀리면 저작자에게는 저장 실패로만 보인다.**
- * 실제로 그랬다 — 판본을 `figure: { id }` 로 물었고, `FigureHistory` 는 관계 칸이 아니라
+ * 실제로 그랬다 — 버전을 `figure: { id }` 로 물었고, `FigureHistory` 는 관계 칸이 아니라
  * `originalId` 로 가리킨다. TypeORM 이 「그런 속성이 없다」로 던졌고 화면에는 영문 오류 한 줄이
  * 떴다. 그래서 이 함수를 내보내 sqlite 를 들고 왕복까지 본다.
  */

package/server/service/figure/figure-revert.ts

@@ -75,7 +75,7 @@ export async function revertKeepingDraft(
   const history = await tx.getRepository(FigureHistory).findOne({
     where: { domain: { id: In([domain.id, domain.parentId].filter(Boolean) as string[]) }, originalId: request.id, version: request.version }
   })
-  if (!history) throw refused('FIGURE_VERSION_NOT_FOUND', `Figure '${figure.type}' 에 ${request.version} 판이 없습니다.`)
+  if (!history) throw refused('FIGURE_VERSION_NOT_FOUND', `Figure '${figure.type}' 에 ${request.version} 버전이 없습니다.`)
   /* The format is checked again: an old version may break today's rules, and is not let in quietly. */
   const { source, derived, violations } = parseSource(draftSourceOfRelease(history.source!))
 

package/server/service/figure/figure-tools.test.ts

@@ -8,7 +8,7 @@
  *   · guidance → 도구 호출          끊기면 → 「후보를 만들었습니다」라고만 쓰고 화면에는 아무것도 없다
  *   · hostContext.figureId → 대상    끊기면 → 화면에 피규어가 떠 있는데 「어느 피규어입니까」를 되묻는다
  *   · 도메인 확인 → 대상            끊기면 → 모델이 넘긴 id 로 남의 테넌트를 읽는다
- *   · hostContext.context·revision → 제안   끊기면 → 모델러가 모델이 본 판이 아닌 판에 명령을 적용한다
+ *   · hostContext.context·revision → 제안   끊기면 → 모델러가 모델이 본 버전이 아닌 버전에 명령을 적용한다
  *
  * 실제 모델은 부르지 않는다. 여기서 볼 것은 모델의 솜씨가 아니라 **우리 배선**이다.
  */
@@ -410,8 +410,8 @@ describe('목록이 잘릴 때', () => {
 })
 
 /*
-  제안은 모델러의 명령 목록이다(ADR-0094). 고치는 제안은 모델러가 모델이 본 판 위에 한 단계로 적용하므로, 고칠 수
-  있는 것은 모델러에 열린 피규어뿐이고 그 판(context · revision)을 문맥이 싣고 와야 한다.
+  제안은 모델러의 명령 목록이다(ADR-0094). 고치는 제안은 모델러가 모델이 본 버전 위에 한 단계로 적용하므로, 고칠 수
+  있는 것은 모델러에 열린 피규어뿐이고 그 버전(context · revision)을 문맥이 싣고 와야 한다.
 */
 const figureDraft = () => {
   const model = require('@hatiolab/figure-model')
@@ -422,7 +422,7 @@ const figureDraft = () => {
 const modeller = (over: any = {}) => ({ figureId: 'fig-1', draftSource: figureDraft(), context: 'ctx-7', revision: 4, ...over })
 
 describe('제안을 요청할 때', () => {
-  it('열린 피규어를 고치면 그 초안이 제안기에 가고, 모델러가 적용할 판이 함께 돌아온다', async () => {
+  it('열린 피규어를 고치면 그 초안이 제안기에 가고, 모델러가 적용할 버전이 함께 돌아온다', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '다리를 길게' }, ctx(modeller()))
     expect(proposed[0].base.name).toBe('Probe')
     expect(proposed[0].base.version).toBe('figure-asset-1')
@@ -432,7 +432,7 @@ describe('제안을 요청할 때', () => {
     expect(out.create).toBe(false)
   })
 
-  it('판을 모르는 문맥에서는 고치는 제안을 내지 않는다 — 다른 판에 적용되지 않게', async () => {
+  it('버전을 모르는 문맥에서는 고치는 제안을 내지 않는다 — 다른 버전에 적용되지 않게', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '다리를 길게' }, ctx(modeller({ revision: undefined })))
     expect(out.error).toBe('FIGURE_NOT_OPEN')
     expect(proposed).toHaveLength(0)
@@ -614,7 +614,7 @@ describe('피규어가 모델러에 열려 있을 때', () => {
     seen on (ADR-0097 §5.6 item 5). The model hears it only through a read tool (ADR-0061 decision 3), so a tool that
     drops it leaves the model guessing which part was meant.
   */
-  it('선택한 부품과 시험 중인 값을 같은 판에서 본 것일 때 함께 읽는다', async () => {
+  it('선택한 부품과 시험 중인 값을 같은 버전에서 본 것일 때 함께 읽는다', async () => {
     const host = modeller({
       selection: { part: 'body', context: 'ctx-7', revision: 4 },
       trying: { clips: { lift: 0.5 }, controls: { height: 300 }, context: 'ctx-7', revision: 4 }
@@ -624,7 +624,7 @@ describe('피규어가 모델러에 열려 있을 때', () => {
     expect(got.trying).toEqual({ clips: { lift: 0.5 }, controls: { height: 300 } })
   })
 
-  it('다른 판에서 본 선택이나 초안에 없는 부품은 말하지 않는다 — 없는 부품을 가리키지 않게', async () => {
+  it('다른 버전에서 본 선택이나 초안에 없는 부품은 말하지 않는다 — 없는 부품을 가리키지 않게', async () => {
     const stale = await toolNamed('getFigureSource').builder({}, ctx(modeller({ selection: { part: 'body', context: 'ctx-7', revision: 3 } })))
     const missing = await toolNamed('getFigureSource').builder({}, ctx(modeller({ selection: { part: 'arm', context: 'ctx-7', revision: 4 } })))
     expect(stale.selection).toBeUndefined()
@@ -753,7 +753,7 @@ describe('피규어가 한 번에 보일 만큼보다 클 때', () => {
     expect(got.findings[0]).toEqual(findings[0])
   })
 
-  it('고치는 제안에 고른 부품이 제안기까지 가고, 판은 그대로 돌아온다', async () => {
+  it('고치는 제안에 고른 부품이 제안기까지 가고, 버전은 그대로 돌아온다', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder(
       { prompt: '3단을 빨갛게', parts: ['shelf-3'], sections: ['/palette', 7] },
       ctx(modeller({ draftSource: over }))
@@ -791,7 +791,7 @@ describe('저장 전 피규어', () => {
     expect(got).toMatchObject({ blocked: false, draft: true })
   })
 
-  it('★ 고치는 제안은 그 초안 위에, 모델러가 적용할 판과 함께 낸다', async () => {
+  it('★ 고치는 제안은 그 초안 위에, 모델러가 적용할 버전과 함께 낸다', async () => {
     const out = await toolNamed('proposeFigureCandidate').builder({ prompt: '이 부품을 더 크게' }, ctx(unsaved({ selection: { part: 'body', context: 'ctx-7', revision: 4 } })))
     expect(proposed[0].base.name).toBe('Probe')
     expect(proposed[0].focus).toEqual({ selection: { part: 'body' } })

package/server/service/figure/figure-tools.ts

@@ -471,8 +471,8 @@ function figureToolSpecs(): ToolSpec[] {
           모델이 `create` 를 켜면 만드는 것이다. 이것을 모델의 짐작에 맡기면 열려 있는 피규어를 덮어쓰는
           후보가 온다.
 
-          고치는 제안은 모델러가 **요청 당시의 판(context · revision)** 위에 한 단계로 적용한다(ADR-0094).
-          그래서 고칠 수 있는 것은 모델러에 열린 피규어뿐이고, 그 판을 문맥이 함께 실어 와야 한다.
+          고치는 제안은 모델러가 **요청 당시의 버전(context · revision)** 위에 한 단계로 적용한다(ADR-0094).
+          그래서 고칠 수 있는 것은 모델러에 열린 피규어뿐이고, 그 버전을 문맥이 함께 실어 와야 한다.
         */
         const host = ctx?.host
         const create = args?.create === true || args?.figureId === null

package/server/service/figure/figure-type.ts

@@ -48,7 +48,7 @@ export class NewFigure {
  *
  * `type` 은 **한 번도 발행되지 않은 초안에서만** 바뀐다(ADR-0063 결정 4). 저장되는 식별자라
  * 발행된 뒤에 바꾸면 이미 배치된 보드가 타입을 못 찾아 오류 없이 빈 화면이 된다. 발행 전에는
- * 그 피규어를 가리키는 도면이 있을 수 없다 — 도면은 최신 발행판을 그리므로 발행된 적 없는
+ * 그 피규어를 가리키는 도면이 있을 수 없다 — 도면은 최신 발행 버전을 그리므로 발행된 적 없는
  * 피규어는 그려질 자리가 없다.
  *
  * 닫아 두었더니 저작자가 이름을 한 번도 정하지 못했다. 새 Figure 에는 기계가 지은 이름이
@@ -88,8 +88,8 @@ export class FigurePatch {
   /*
     `state` 는 여기 없다 — **상태는 저장이 정하지 않는다.**
 
-    발행은 `releaseFigure` 가 한다. 저장으로 상태를 바꿀 수 있게 두면 발행된 판을 덮어쓰면서 같은
-    판 번호로 판본을 또 뜨게 되고(유니크 충돌), 무엇이 약속된 판인지도 흐려진다. board 도 같다.
+    발행은 `releaseFigure` 가 한다. 저장으로 상태를 바꿀 수 있게 두면 발행된 버전을 덮어쓰면서 같은
+    버전 번호로 버전을 또 뜨게 되고(유니크 충돌), 무엇이 약속된 버전인지도 흐려진다. board 도 같다.
   */
 
   @Field({ nullable: true, description: 'A base64 encoded thumbnail image.' })