@things-factory/figure-service 10.1.4 → 10.1.7

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

@@ -22,6 +22,9 @@ export class NewFigure {
   @Field({ nullable: true, description: 'Classification code used to group figures in the palette.' })
   category?: string
 
+  @Field(type => [String], { nullable: true, description: 'Free-form tags. A figure may carry several.' })
+  tags?: string[]
+
   @Field({ description: 'The canonical FigureSource JSON.' })
   source: string
 
@@ -52,6 +55,13 @@ export class FigurePatch {
   @Field({ nullable: true, description: 'The new classification code.' })
   category?: string
 
+  /*
+    빈 배열과 안 준 것을 가른다. `undefined` 는 「건드리지 않는다」, `[]` 는 「전부 지운다」다.
+    둘을 뭉개면 태그를 다 지우려는 저작자가 지울 방법을 잃는다.
+  */
+  @Field(type => [String], { nullable: true, description: 'The new tags. An empty list clears them; omitting the field leaves them.' })
+  tags?: string[]
+
   @Field({ nullable: true, description: 'The new FigureSource JSON.' })
   source?: string
 
@@ -110,3 +120,46 @@ export class FigureSaveResult {
   @Field(type => [FigureFinding], { description: 'Non-blocking findings. The save succeeded despite these.' })
   violations: FigureFinding[]
 }
+
+/**
+ * 발행 판정 한 줄.
+ *
+ * `FigureFinding` 과 칸이 겹치지만 **`blocking` 이 하나 더 있다.** 저장 쪽 발견은 정의상 막지 않는
+ * 것들이라 그 칸이 필요 없었다. 발행 판정은 막는 것과 알리는 것을 함께 내므로, 어느 쪽인지를 값이
+ * 스스로 말해야 한다 — 코드를 보고 화면이 다시 분류하면 규칙이 두 벌이 된다.
+ */
+@ObjectType({ description: 'One finding from the release gate.' })
+export class FigureGateFinding {
+  @Field({ description: 'Stable code — figure-model validation codes, or sizing-splits / sizing-loose.' })
+  code: string
+
+  @Field({ description: 'Human-readable message.' })
+  message: string
+
+  @Field({ nullable: true, description: 'Why this is a problem — what a person sees when it happens.' })
+  why?: string
+
+  @Field({ nullable: true, description: 'What to change, naming the part and the value.' })
+  how?: string
+
+  @Field({ nullable: true, description: 'Where it points: part names that came apart, or a path in the source.' })
+  at?: string
+
+  @Field({ description: 'True when this finding blocks the release.' })
+  blocking: boolean
+}
+
+/**
+ * 발행 판정.
+ *
+ * 화면이 **발행을 누르기 전에** 물어보는 자리다. 눌러 보고 거절당하는 것으로 알게 되면, 무엇을
+ * 고쳐야 하는지 모른 채 단추만 두드리게 된다.
+ */
+@ObjectType({ description: 'Whether a figure may be released, and why not.' })
+export class FigureInspection {
+  @Field({ description: 'True when at least one finding blocks the release.' })
+  blocked: boolean
+
+  @Field(type => [FigureGateFinding], { description: 'Findings, blocking and advisory together.' })
+  findings: FigureGateFinding[]
+}

package/server/service/figure/figure.ts

@@ -89,11 +89,31 @@ export class Figure {
   @Field({ nullable: true, description: 'A detailed description for the figure.' })
   description?: string
 
-  /** 분류 코드. 팔레트에서 묶어 보이는 기준. */
+  /**
+   * 분류 하나. **팔레트에서 묶어 보이는 기준이다.**
+   *
+   * 도형 하나에 하나뿐이다 — 팔레트는 목록을 한 벌로 나눠 보여 주므로, 한 도형이 두 묶음에
+   * 동시에 있으면 저작자가 같은 것을 두 번 만난다.
+   */
   @Column({ nullable: true })
-  @Field({ nullable: true, description: 'Classification code used to group figures in the palette.' })
+  @Field({ nullable: true, description: 'Classification code used to group figures in the palette. One per figure.' })
   category?: string
 
+  /**
+   * 태그. **여럿 붙는다.**
+   *
+   * 분류와 다른 일을 한다. 분류는 「이것이 무엇인가」를 한 번 정하는 것이고, 태그는 「어디에
+   * 걸리는가」를 여러 갈래로 적는 것이다 — 컨베이어이면서 반출 구역의 것일 수 있다. 그래서
+   * 분류로는 못 하는 찾기가 된다.
+   *
+   * `simple-json` 으로 담는다. 사내 선례가 그것이고(`ops-master` · `organization` ·
+   * `personalization`), 드라이버마다 배열 타입이 다른 것을 피한다.
+   */
+  /* `simple-json` 과 `default: null` 은 사내 선례 그대로다 — board-template · attachment 가 같은 모양이다. */
+  @Column('simple-json', { nullable: true, default: null })
+  @Field(type => [String], { nullable: true, description: 'Free-form tags. A figure may carry several.' })
+  tags?: string[]
+
   @Column({ nullable: true, default: 'draft' })
   @Field({ nullable: true, description: "Lifecycle state — 'draft' figures do not appear in the board palette." })
   state?: 'draft' | 'released'