@things-factory/headless-twin 10.0.6 → 10.0.7

package/dist-server/service/twin-structure/twin-structure.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwinStructure = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+/*
+ * TwinStructure — **한 트윈이 거쳐 온 공장 구조들.** 리비전 하나가 그 시절의 공장이다.
+ *
+ * ── 왜 필요한가: 역사를 잃거나 거짓말을 하거나 ──────────────────────────────
+ * 공장은 바뀐다. 도장 부스를 넷 더 놓고, 라인을 하나 접는다. 그런데 지금까지는 구조 서명이 바뀌면
+ * **그 트윈의 저널을 통째로 지우는 것**이 유일한 길이었다. 안 지우면 옛 이벤트를 새 공장에 대고
+ * 접게 되어 이력이 거짓말을 하기 때문이다 — 부스가 둘이던 시절의 사실을 여섯 개짜리 공장에 접으면
+ * 그때 없던 부스에서 일이 있었던 것처럼 보인다.
+ *
+ * 그래서 선택지가 둘뿐이었다: **역사를 잃거나, 거짓말을 하거나.**
+ *
+ * 셋째 길이 이 표다. 이벤트가 `structureRev` 로 자기 구조를 달고 다니고, 재생은 구조가 바뀌는
+ * 지점에서 갈아탄 뒤 이어 접는다(`replaySegments`). 이력은 "그때 그 공장의 사실" 로 계속 읽힌다.
+ *
+ * ── 왜 board 를 통째로 담나 ─────────────────────────────────────────────────
+ * 재생하려면 **그때의 토폴로지 전체**가 필요하다. 차이(diff)만 담으면 리비전 1부터 되짚어 쌓아야
+ * 하고, 그 되짚기 자체가 또 하나의 규칙이 되어 갈라진다. 구조는 이벤트에 비해 드물게 바뀌므로
+ * 스냅샷을 통째로 두는 편이 싸고 정직하다(보드 이력 `BoardHistory` 와 같은 선택).
+ *
+ * ── audit 컬럼을 다 두지 않는 이유 ──────────────────────────────────────────
+ * 리비전은 **한 번 쓰이면 바뀌지 않는다** — 그 시절의 사실이라 고칠 수가 없다. 그래서 updater·
+ * deletedAt 이 없다(TwinEvent 와 같은 규율). 대신 **누가 구조를 바꿨는지**는 남긴다.
+ *
+ * (CLAUDE.md: 모든 @ObjectType/@Field 는 영문 description 필수.)
+ */
+let TwinStructure = class TwinStructure {
+};
+exports.TwinStructure = TwinStructure;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Unique identifier of the structure revision record.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinStructure.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true, description: 'Owning tenant domain.' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], TwinStructure.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((e) => e.domain),
+    tslib_1.__metadata("design:type", String)
+], TwinStructure.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'Twin runtime instance this structure belongs to.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinStructure.prototype, "instanceId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'int' }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Int, { description: 'Revision number, starting at 1. Events reference it via structureRev; absent on rows written before structure revisions existed, which belong to the oldest revision.' }),
+    tslib_1.__metadata("design:type", Number)
+], TwinStructure.prototype, "rev", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ length: 64 }),
+    (0, type_graphql_1.Field)({ description: 'Short hash of the structural signature (locations + equipment). A re-provision with the same signature does not create a new revision — otherwise every reboot would slice the history into meaningless segments.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinStructure.prototype, "signature", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'simple-json' }),
+    (0, type_graphql_1.Field)(type => shell_1.ScalarObject, { description: 'The full BoardDef as it stood for this revision. Stored whole rather than as a diff: replay needs the entire topology, and rebuilding it from diffs would be a second rule that can drift.' }),
+    tslib_1.__metadata("design:type", Object)
+], TwinStructure.prototype, "board", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Why the structure changed — a human note, absent for automatic provisioning.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinStructure.prototype, "comment", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'Who changed the structure, when known.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], TwinStructure.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((e) => e.creator),
+    tslib_1.__metadata("design:type", String)
+], TwinStructure.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'When this revision took effect.' }),
+    tslib_1.__metadata("design:type", Date)
+], TwinStructure.prototype, "createdAt", void 0);
+exports.TwinStructure = TwinStructure = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_twin_structure_0', (e) => [e.domain, e.instanceId, e.rev], { unique: true }),
+    (0, type_graphql_1.ObjectType)({
+        description: 'One structural revision of a twin — the plant as it stood for a stretch of its journal. Events carry the revision they were produced under, so history can be replayed against the structure that was actually in force instead of being deleted when the plant changes.'
+    })
+], TwinStructure);
+//# sourceMappingURL=twin-structure.js.map

package/dist-server/service/twin-structure/twin-structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twin-structure.js","sourceRoot":"","sources":["../../../server/service/twin-structure/twin-structure.ts"],"names":[],"mappings":";;;;AAAA,qCAAgH;AAChH,+CAAyD;AAEzD,iDAA4D;AAC5D,yDAAgD;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAOI,IAAM,aAAa,GAAnB,MAAM,aAAa;CAuDzB,CAAA;AAvDY,sCAAa;AAGf;IAFR,IAAA,gCAAsB,EAAC,MAAM,CAAC;IAC9B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,iBAAE,EAAE,EAAE,WAAW,EAAE,qDAAqD,EAAE,CAAC;;yCACvE;AAInB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,CAAC;IACzB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,cAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE,CAAC;sCACvE,cAAM;6CAAA;AAGf;IADC,IAAA,oBAAU,EAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;;+CAC1B;AAIjB;IAFC,IAAA,gBAAM,GAAE;IACR,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,kDAAkD,EAAE,CAAC;;iDACzD;AAUlB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IACvB,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,kBAAG,EAAE,EAAE,WAAW,EAAE,uKAAuK,EAAE,CAAC;;0CAClM;AAUX;IAFC,IAAA,gBAAM,EAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACtB,IAAA,oBAAK,EAAC,EAAE,WAAW,EAAE,mNAAmN,EAAE,CAAC;;gDAC3N;AAIjB;IAFC,IAAA,gBAAM,EAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IAC/B,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,oBAAY,EAAE,EAAE,WAAW,EAAE,4LAA4L,EAAE,CAAC;;4CACjO;AAKV;IAFC,IAAA,gBAAM,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1B,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,8EAA8E,EAAE,CAAC;;8CACvG;AAIhB;IAFC,IAAA,mBAAS,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAA,oBAAK,EAAC,IAAI,CAAC,EAAE,CAAC,gBAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,wCAAwC,EAAE,CAAC;sCACrF,gBAAI;8CAAA;AAGd;IADC,IAAA,oBAAU,EAAC,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;;gDAC1B;AAIlB;IAFC,IAAA,0BAAgB,GAAE;IAClB,IAAA,oBAAK,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iCAAiC,EAAE,CAAC;sCAC9D,IAAI;gDAAA;wBAtDL,aAAa;IANzB,IAAA,gBAAM,GAAE;IACR,IAAA,eAAK,EAAC,qBAAqB,EAAE,CAAC,CAAgB,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACrG,IAAA,yBAAU,EAAC;QACV,WAAW,EACT,0QAA0Q;KAC7Q,CAAC;GACW,aAAa,CAuDzB","sourcesContent":["import { CreateDateColumn, Entity, Index, Column, RelationId, ManyToOne, PrimaryGeneratedColumn } from 'typeorm'\nimport { ObjectType, Field, ID, Int } from 'type-graphql'\n\nimport { Domain, ScalarObject } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/*\n * TwinStructure — **한 트윈이 거쳐 온 공장 구조들.** 리비전 하나가 그 시절의 공장이다.\n *\n * ── 왜 필요한가: 역사를 잃거나 거짓말을 하거나 ──────────────────────────────\n * 공장은 바뀐다. 도장 부스를 넷 더 놓고, 라인을 하나 접는다. 그런데 지금까지는 구조 서명이 바뀌면\n * **그 트윈의 저널을 통째로 지우는 것**이 유일한 길이었다. 안 지우면 옛 이벤트를 새 공장에 대고\n * 접게 되어 이력이 거짓말을 하기 때문이다 — 부스가 둘이던 시절의 사실을 여섯 개짜리 공장에 접으면\n * 그때 없던 부스에서 일이 있었던 것처럼 보인다.\n *\n * 그래서 선택지가 둘뿐이었다: **역사를 잃거나, 거짓말을 하거나.**\n *\n * 셋째 길이 이 표다. 이벤트가 `structureRev` 로 자기 구조를 달고 다니고, 재생은 구조가 바뀌는\n * 지점에서 갈아탄 뒤 이어 접는다(`replaySegments`). 이력은 \"그때 그 공장의 사실\" 로 계속 읽힌다.\n *\n * ── 왜 board 를 통째로 담나 ─────────────────────────────────────────────────\n * 재생하려면 **그때의 토폴로지 전체**가 필요하다. 차이(diff)만 담으면 리비전 1부터 되짚어 쌓아야\n * 하고, 그 되짚기 자체가 또 하나의 규칙이 되어 갈라진다. 구조는 이벤트에 비해 드물게 바뀌므로\n * 스냅샷을 통째로 두는 편이 싸고 정직하다(보드 이력 `BoardHistory` 와 같은 선택).\n *\n * ── audit 컬럼을 다 두지 않는 이유 ──────────────────────────────────────────\n * 리비전은 **한 번 쓰이면 바뀌지 않는다** — 그 시절의 사실이라 고칠 수가 없다. 그래서 updater·\n * deletedAt 이 없다(TwinEvent 와 같은 규율). 대신 **누가 구조를 바꿨는지**는 남긴다.\n *\n * (CLAUDE.md: 모든 @ObjectType/@Field 는 영문 description 필수.)\n */\n@Entity()\n@Index('ix_twin_structure_0', (e: TwinStructure) => [e.domain, e.instanceId, e.rev], { unique: true })\n@ObjectType({\n  description:\n    'One structural revision of a twin — the plant as it stood for a stretch of its journal. Events carry the revision they were produced under, so history can be replayed against the structure that was actually in force instead of being deleted when the plant changes.'\n})\nexport class TwinStructure {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Unique identifier of the structure revision record.' })\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'Owning tenant domain.' })\n  domain?: Domain\n\n  @RelationId((e: TwinStructure) => e.domain)\n  domainId?: string\n\n  @Column()\n  @Field({ description: 'Twin runtime instance this structure belongs to.' })\n  instanceId: string\n\n  /**\n   * 리비전 번호 — 1부터. 이벤트의 `structureRev` 가 이것을 가리킨다.\n   *\n   * 0 을 안 쓰는 이유: 컬럼이 없던 시절의 행은 `structureRev` 가 비어 있고, 그 행들은 **가장 오래된\n   * 리비전**에 속한다. 0 을 유효 번호로 쓰면 \"모름\" 과 \"1번 구조\" 가 같은 값이 된다.\n   */\n  @Column({ type: 'int' })\n  @Field(type => Int, { description: 'Revision number, starting at 1. Events reference it via structureRev; absent on rows written before structure revisions existed, which belong to the oldest revision.' })\n  rev: number\n\n  /**\n   * 구조 서명 — 이 리비전이 앞 리비전과 **정말 다른지** 판정한 근거.\n   *\n   * 서명이 같으면 새 리비전을 만들지 않는다. 프로비저닝은 자주 다시 도는데(부팅마다) 그때마다\n   * 리비전이 하나씩 늘면 이력이 뜻 없는 마디로 잘게 쪼개진다.\n   */\n  @Column({ length: 64 })\n  @Field({ description: 'Short hash of the structural signature (locations + equipment). A re-provision with the same signature does not create a new revision — otherwise every reboot would slice the history into meaningless segments.' })\n  signature: string\n\n  @Column({ type: 'simple-json' })\n  @Field(type => ScalarObject, { description: 'The full BoardDef as it stood for this revision. Stored whole rather than as a diff: replay needs the entire topology, and rebuilding it from diffs would be a second rule that can drift.' })\n  board: any\n\n  /** 왜 바뀌었나 — 사람이 남기는 한 줄. 없을 수 있다(자동 프로비저닝은 이유를 모른다). */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Why the structure changed — a human note, absent for automatic provisioning.' })\n  comment?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'Who changed the structure, when known.' })\n  creator?: User\n\n  @RelationId((e: TwinStructure) => e.creator)\n  creatorId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'When this revision took effect.' })\n  createdAt?: Date\n}\n"]}

package/dist-server/service/twin-target/index.d.ts

@@ -0,0 +1,4 @@
+import { TwinTarget } from './twin-target.js';
+import { TwinTargetResolver } from './twin-target-resolver.js';
+export declare const entities: (typeof TwinTarget)[];
+export declare const resolvers: (typeof TwinTargetResolver)[];

package/dist-server/service/twin-target/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvers = exports.entities = void 0;
+const twin_target_js_1 = require("./twin-target.js");
+const twin_target_resolver_js_1 = require("./twin-target-resolver.js");
+exports.entities = [twin_target_js_1.TwinTarget];
+exports.resolvers = [twin_target_resolver_js_1.TwinTargetResolver];
+//# sourceMappingURL=index.js.map

package/dist-server/service/twin-target/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/twin-target/index.ts"],"names":[],"mappings":";;;AAAA,qDAA6C;AAC7C,uEAA8D;AAEjD,QAAA,QAAQ,GAAG,CAAC,2BAAU,CAAC,CAAA;AACvB,QAAA,SAAS,GAAG,CAAC,4CAAkB,CAAC,CAAA","sourcesContent":["import { TwinTarget } from './twin-target.js'\nimport { TwinTargetResolver } from './twin-target-resolver.js'\n\nexport const entities = [TwinTarget]\nexport const resolvers = [TwinTargetResolver]\n"]}

package/dist-server/service/twin-target/twin-target-resolver.d.ts

@@ -0,0 +1,7 @@
+import { TwinTarget } from './twin-target.js';
+export declare class TwinTargetResolver {
+    twinTargetMetrics(): Promise<string[]>;
+    twinTargets(context: ResolverContext, spaceId?: string, instanceId?: string): Promise<TwinTarget[]>;
+    saveTwinTarget(metric: string, target: number, context: ResolverContext, spaceId?: string, instanceId?: string, axis?: string, axisKey?: string): Promise<boolean>;
+    deleteTwinTarget(metric: string, context: ResolverContext, spaceId?: string, instanceId?: string, axis?: string, axisKey?: string): Promise<boolean>;
+}

package/dist-server/service/twin-target/twin-target-resolver.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwinTargetResolver = void 0;
+const tslib_1 = require("tslib");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const twin_target_js_1 = require("./twin-target.js");
+const kpi_target_js_1 = require("../../engine/kpi-target.js");
+/*
+ * 운영 목표 조회·편집 — **현장 관리자가 트윈 화면에서** 고친다(사용자 결정 2026-08-02).
+ *
+ * 경영 KPI 관리메뉴가 아니라 여기인 이유: 목표가 숫자 옆에 있어야 맥락이 살고, 운영 임계는 자주
+ * 조정된다. 조직 단위 기간 평가는 `@things-factory/kpi` 의 일이고 이쪽으로 베껴 오지 않는다.
+ */
+let TwinTargetResolver = class TwinTargetResolver {
+    async twinTargetMetrics() {
+        return Object.keys(kpi_target_js_1.TWIN_METRIC);
+    }
+    async twinTargets(context, spaceId, instanceId) {
+        const domainId = context.state.domain.id;
+        const rows = await (0, shell_1.getRepository)(twin_target_js_1.TwinTarget).find({ where: { domain: { id: domainId } } });
+        return rows.filter(r => (spaceId && r.spaceId === spaceId) || (instanceId && r.instanceId === instanceId));
+    }
+    async saveTwinTarget(metric, target, context, spaceId, instanceId, axis, axisKey) {
+        if (!(0, kpi_target_js_1.isTwinMetric)(metric))
+            throw new Error(`unknown twin metric "${metric}" — see twinTargetMetrics`);
+        if (!Number.isFinite(target))
+            throw new Error('target must be a finite number');
+        if (!spaceId && !instanceId)
+            throw new Error('a target must be scoped to a space or an instance');
+        /* 축만 있고 값이 없으면 **어디에 거는 목표인지 알 수 없다** — 조용히 전체 목표로 만들지 않는다
+           (그러면 사용자는 구역 목표를 걸었다고 믿는데 전체가 바뀐다). */
+        if (axis && !axisKey)
+            throw new Error('axisKey is required when axis is given');
+        if (!axis && axisKey)
+            throw new Error('axis is required when axisKey is given');
+        const domainId = context.state.domain.id;
+        const repo = (0, shell_1.getRepository)(twin_target_js_1.TwinTarget);
+        const existing = await repo.findOne({
+            where: { domain: { id: domainId }, spaceId: spaceId ?? null, instanceId: instanceId ?? null, metric, axis: axis ?? null, axisKey: axisKey ?? null }
+        });
+        await repo.save(repo.create({
+            ...(existing ?? {}),
+            domain: { id: domainId },
+            spaceId: spaceId ?? null,
+            instanceId: instanceId ?? null,
+            axis: axis ?? null,
+            axisKey: axisKey ?? null,
+            metric,
+            target,
+            ...(existing ? { updater: context.state.user } : { creator: context.state.user, updater: context.state.user })
+        }));
+        return true;
+    }
+    async deleteTwinTarget(metric, context, spaceId, instanceId, axis, axisKey) {
+        const domainId = context.state.domain.id;
+        const repo = (0, shell_1.getRepository)(twin_target_js_1.TwinTarget);
+        /*
+         * **찾아서 그 행만 지운다.** 예전에는 조건 객체를 `delete()` 에 그대로 넘겼는데 **아무 행도
+         * 안 지워지면서 `true` 를 돌려줬다.** 사용자는 목표를 지웠다고 믿고 화면을 떠나는데 판정은 그대로
+         * 남는다(실화면에서 그렇게 당했다).
+         *
+         * 무엇이 조건을 깨뜨렸는지는 단정하지 않는다 — 이 조건에는 `domain` 관계 객체와 `null` 값들이
+         * 함께 들어 있었고(`instanceId`·`axis`·`axisKey`), 둘 다 `delete()` 의 조건 해석에서 흔한 함정이다.
+         * 같은 관계-객체 패턴을 쓰는 `resetJournal` 은 실제로 잘 지우므로 관계 객체 하나만으로 설명되지
+         * 않는다. `null` 조건이 `IS NULL` 이 아니라 `= NULL` 로 나갔을 가능성이 크다.
+         *
+         * 그래서 조건을 고쳐 맞추는 대신 **행을 찾아 id 로 지운다**: 저장 경로와 **같은 조회 규칙**을
+         * 쓰므로 규칙이 갈라지지 않고(`findOne` 은 `null` 을 제대로 다룬다), 지우는 대상이 정확히 한
+         * 행이라 넓게 지울 위험도 없다.
+         */
+        const row = await repo.findOne({
+            where: {
+                domain: { id: domainId },
+                spaceId: spaceId ?? null,
+                instanceId: instanceId ?? null,
+                axis: axis ?? null,
+                axisKey: axisKey ?? null,
+                metric
+            }
+        });
+        /* 지울 것이 없으면 **없었다고 답한다.** 지우지 않고 true 를 주면 위와 같은 거짓말이 된다. */
+        if (!row)
+            return false;
+        await repo.delete(row.id);
+        return true;
+    }
+};
+exports.TwinTargetResolver = TwinTargetResolver;
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "query")'),
+    (0, type_graphql_1.Query)(returns => [String], {
+        description: 'The metric ids a twin target may refer to. Fixed in one place so a target and the fact it judges can never drift into two names.'
+    }),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinTargetResolver.prototype, "twinTargetMetrics", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "query")'),
+    (0, type_graphql_1.Query)(returns => [twin_target_js_1.TwinTarget], {
+        description: 'Operational targets in scope — site-wide targets for the space plus targets bound to the given instance. Callers judge with the narrower one when both exist.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('spaceId', { nullable: true })),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('instanceId', { nullable: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [Object, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinTargetResolver.prototype, "twinTargets", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation")'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, {
+        description: 'Create or update one operational target. The metric must be one of twinTargetMetrics — an unknown name is rejected rather than stored, because a target nobody can evaluate reads as "no target" and hides the gap.'
+    }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('metric')),
+    tslib_1.__param(1, (0, type_graphql_1.Arg)('target', type => type_graphql_1.Float)),
+    tslib_1.__param(2, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(3, (0, type_graphql_1.Arg)('spaceId', { nullable: true })),
+    tslib_1.__param(4, (0, type_graphql_1.Arg)('instanceId', { nullable: true })),
+    tslib_1.__param(5, (0, type_graphql_1.Arg)('axis', { nullable: true })),
+    tslib_1.__param(6, (0, type_graphql_1.Arg)('axisKey', { nullable: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Number, Object, String, String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinTargetResolver.prototype, "saveTwinTarget", null);
+tslib_1.__decorate([
+    (0, type_graphql_1.Directive)('@privilege(category: "twin", privilege: "mutation")'),
+    (0, type_graphql_1.Mutation)(returns => Boolean, { description: 'Remove an operational target. Removing a target removes the judgement, not the fact — the metric keeps being reported without a verdict.' }),
+    tslib_1.__param(0, (0, type_graphql_1.Arg)('metric')),
+    tslib_1.__param(1, (0, type_graphql_1.Ctx)()),
+    tslib_1.__param(2, (0, type_graphql_1.Arg)('spaceId', { nullable: true })),
+    tslib_1.__param(3, (0, type_graphql_1.Arg)('instanceId', { nullable: true })),
+    tslib_1.__param(4, (0, type_graphql_1.Arg)('axis', { nullable: true })),
+    tslib_1.__param(5, (0, type_graphql_1.Arg)('axisKey', { nullable: true })),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", [String, Object, String, String, String, String]),
+    tslib_1.__metadata("design:returntype", Promise)
+], TwinTargetResolver.prototype, "deleteTwinTarget", null);
+exports.TwinTargetResolver = TwinTargetResolver = tslib_1.__decorate([
+    (0, type_graphql_1.Resolver)()
+], TwinTargetResolver);
+//# sourceMappingURL=twin-target-resolver.js.map

package/dist-server/service/twin-target/twin-target-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twin-target-resolver.js","sourceRoot":"","sources":["../../../server/service/twin-target/twin-target-resolver.ts"],"names":[],"mappings":"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","sourcesContent":["import { Arg, Ctx, Directive, Float, Mutation, Query, Resolver } from 'type-graphql'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { TwinTarget } from './twin-target.js'\nimport { TWIN_METRIC, isTwinMetric } from '../../engine/kpi-target.js'\n\n/*\n * 운영 목표 조회·편집 — **현장 관리자가 트윈 화면에서** 고친다(사용자 결정 2026-08-02).\n *\n * 경영 KPI 관리메뉴가 아니라 여기인 이유: 목표가 숫자 옆에 있어야 맥락이 살고, 운영 임계는 자주\n * 조정된다. 조직 단위 기간 평가는 `@things-factory/kpi` 의 일이고 이쪽으로 베껴 오지 않는다.\n */\n@Resolver()\nexport class TwinTargetResolver {\n  @Directive('@privilege(category: \"twin\", privilege: \"query\")')\n  @Query(returns => [String], {\n    description:\n      'The metric ids a twin target may refer to. Fixed in one place so a target and the fact it judges can never drift into two names.'\n  })\n  async twinTargetMetrics(): Promise<string[]> {\n    return Object.keys(TWIN_METRIC)\n  }\n\n  @Directive('@privilege(category: \"twin\", privilege: \"query\")')\n  @Query(returns => [TwinTarget], {\n    description:\n      'Operational targets in scope — site-wide targets for the space plus targets bound to the given instance. Callers judge with the narrower one when both exist.'\n  })\n  async twinTargets(\n    @Ctx() context: ResolverContext,\n    @Arg('spaceId', { nullable: true }) spaceId?: string,\n    @Arg('instanceId', { nullable: true }) instanceId?: string\n  ): Promise<TwinTarget[]> {\n    const domainId = context.state.domain.id\n    const rows = await getRepository(TwinTarget).find({ where: { domain: { id: domainId } } })\n    return rows.filter(r => (spaceId && r.spaceId === spaceId) || (instanceId && r.instanceId === instanceId))\n  }\n\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\")')\n  @Mutation(returns => Boolean, {\n    description:\n      'Create or update one operational target. The metric must be one of twinTargetMetrics — an unknown name is rejected rather than stored, because a target nobody can evaluate reads as \"no target\" and hides the gap.'\n  })\n  async saveTwinTarget(\n    @Arg('metric') metric: string,\n    @Arg('target', type => Float) target: number,\n    @Ctx() context: ResolverContext,\n    @Arg('spaceId', { nullable: true }) spaceId?: string,\n    @Arg('instanceId', { nullable: true }) instanceId?: string,\n    @Arg('axis', { nullable: true }) axis?: string,\n    @Arg('axisKey', { nullable: true }) axisKey?: string\n  ): Promise<boolean> {\n    if (!isTwinMetric(metric)) throw new Error(`unknown twin metric \"${metric}\" — see twinTargetMetrics`)\n    if (!Number.isFinite(target)) throw new Error('target must be a finite number')\n    if (!spaceId && !instanceId) throw new Error('a target must be scoped to a space or an instance')\n    /* 축만 있고 값이 없으면 **어디에 거는 목표인지 알 수 없다** — 조용히 전체 목표로 만들지 않는다\n       (그러면 사용자는 구역 목표를 걸었다고 믿는데 전체가 바뀐다). */\n    if (axis && !axisKey) throw new Error('axisKey is required when axis is given')\n    if (!axis && axisKey) throw new Error('axis is required when axisKey is given')\n    const domainId = context.state.domain.id\n    const repo = getRepository(TwinTarget)\n    const existing = await repo.findOne({\n      where: { domain: { id: domainId }, spaceId: spaceId ?? null, instanceId: instanceId ?? null, metric, axis: axis ?? null, axisKey: axisKey ?? null } as any\n    })\n    await repo.save(\n      repo.create({\n        ...(existing ?? {}),\n        domain: { id: domainId } as any,\n        spaceId: spaceId ?? null as any,\n        instanceId: instanceId ?? null as any,\n        axis: axis ?? null as any,\n        axisKey: axisKey ?? null as any,\n        metric,\n        target,\n        ...(existing ? { updater: context.state.user } : { creator: context.state.user, updater: context.state.user })\n      })\n    )\n    return true\n  }\n\n  @Directive('@privilege(category: \"twin\", privilege: \"mutation\")')\n  @Mutation(returns => Boolean, { description: 'Remove an operational target. Removing a target removes the judgement, not the fact — the metric keeps being reported without a verdict.' })\n  async deleteTwinTarget(\n    @Arg('metric') metric: string,\n    @Ctx() context: ResolverContext,\n    @Arg('spaceId', { nullable: true }) spaceId?: string,\n    @Arg('instanceId', { nullable: true }) instanceId?: string,\n    @Arg('axis', { nullable: true }) axis?: string,\n    @Arg('axisKey', { nullable: true }) axisKey?: string\n  ): Promise<boolean> {\n    const domainId = context.state.domain.id\n    const repo = getRepository(TwinTarget)\n\n    /*\n     * **찾아서 그 행만 지운다.** 예전에는 조건 객체를 `delete()` 에 그대로 넘겼는데 **아무 행도\n     * 안 지워지면서 `true` 를 돌려줬다.** 사용자는 목표를 지웠다고 믿고 화면을 떠나는데 판정은 그대로\n     * 남는다(실화면에서 그렇게 당했다).\n     *\n     * 무엇이 조건을 깨뜨렸는지는 단정하지 않는다 — 이 조건에는 `domain` 관계 객체와 `null` 값들이\n     * 함께 들어 있었고(`instanceId`·`axis`·`axisKey`), 둘 다 `delete()` 의 조건 해석에서 흔한 함정이다.\n     * 같은 관계-객체 패턴을 쓰는 `resetJournal` 은 실제로 잘 지우므로 관계 객체 하나만으로 설명되지\n     * 않는다. `null` 조건이 `IS NULL` 이 아니라 `= NULL` 로 나갔을 가능성이 크다.\n     *\n     * 그래서 조건을 고쳐 맞추는 대신 **행을 찾아 id 로 지운다**: 저장 경로와 **같은 조회 규칙**을\n     * 쓰므로 규칙이 갈라지지 않고(`findOne` 은 `null` 을 제대로 다룬다), 지우는 대상이 정확히 한\n     * 행이라 넓게 지울 위험도 없다.\n     */\n    const row = await repo.findOne({\n      where: {\n        domain: { id: domainId },\n        spaceId: spaceId ?? null,\n        instanceId: instanceId ?? null,\n        axis: axis ?? null,\n        axisKey: axisKey ?? null,\n        metric\n      } as any\n    })\n    /* 지울 것이 없으면 **없었다고 답한다.** 지우지 않고 true 를 주면 위와 같은 거짓말이 된다. */\n    if (!row) return false\n    await repo.delete(row.id)\n    return true\n  }\n}\n"]}

package/dist-server/service/twin-target/twin-target.d.ts

@@ -0,0 +1,25 @@
+import { Domain } from '@things-factory/shell';
+import { User } from '@things-factory/auth-base';
+export declare class TwinTarget {
+    readonly id: string;
+    domain?: Domain;
+    domainId?: string;
+    spaceId?: string;
+    instanceId?: string;
+    /**
+     * 관점 축과 그 값 — **"이 구역만", "이 교대만" 목표가 다르다.**
+     *
+     * 둘 다 비어 있으면 **전체 목표**다(창 전체의 집계를 판정한다). 축 목표는 전체 목표를 덮지 않는다 —
+     * 다른 질문이기 때문이다: "현장 전체가 100건" 과 "용접 구역이 30건" 은 동시에 참일 수 있다.
+     */
+    axis?: string;
+    axisKey?: string;
+    metric: string;
+    target: number;
+    creator?: User;
+    creatorId?: string;
+    updater?: User;
+    updaterId?: string;
+    createdAt?: Date;
+    updatedAt?: Date;
+}

package/dist-server/service/twin-target/twin-target.js

@@ -0,0 +1,112 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwinTarget = void 0;
+const tslib_1 = require("tslib");
+const typeorm_1 = require("typeorm");
+const type_graphql_1 = require("type-graphql");
+const shell_1 = require("@things-factory/shell");
+const auth_base_1 = require("@things-factory/auth-base");
+/*
+ * TwinTarget — **운영 목표.** "이 구간의 처리량이 목표에 닿았나" 를 판단하는 기준선.
+ *
+ * ── 왜 트윈이 갖나 (사용자 결정 2026-08-02) ─────────────────────────────────
+ * `@things-factory/kpi` 와 **경계를 나눈다**:
+ *   트윈(여기)      이 구간·이 교대·이 공간의 **즉시 판단**. 현장 관리자가 트윈 화면에서 고친다.
+ *                   값은 저널 폴드에서 그때그때 계산된다(저장된 값을 읽지 않는다).
+ *   packages/kpi    **기간 평가**(조직·분기·점수·가중치·알림). 값이 저장돼 있어야 도는 체계다.
+ *
+ * 지키는 규칙 하나: **트윈은 경영 목표를 복제하지 않는다.** 조직 단위 평가가 필요하면 트윈의 사실을
+ * 내보내 그쪽이 소비하고, 그쪽 목표를 여기로 베껴 오지 않는다 — 베끼는 순간 두 개의 진실이 된다.
+ *
+ * ── 범위 (scope) ───────────────────────────────────────────────────────────
+ * `spaceId` 로 현장 전체에, `instanceId` 로 트윈 하나에 건다. 둘 다 있으면 **인스턴스가 이긴다**
+ * (좁은 선언이 넓은 선언을 덮는다 — 예외를 표현할 수 있어야 한다).
+ *
+ * 관점 축별 목표(구역마다 다른 목표)는 **아직 아니다** — 축 교차는 목표가 화면에서 쓰이기 시작한 뒤의
+ * 일이고, 처음부터 넣으면 쓰이지 않는 구조가 먼저 굳는다(performance.md §5.4-5).
+ *
+ * (CLAUDE.md: 모든 @ObjectType/@Field 영문 description 필수.)
+ */
+let TwinTarget = class TwinTarget {
+};
+exports.TwinTarget = TwinTarget;
+tslib_1.__decorate([
+    (0, typeorm_1.PrimaryGeneratedColumn)('uuid'),
+    (0, type_graphql_1.Field)(type => type_graphql_1.ID, { description: 'Unique identifier of the target record.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "id", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => shell_1.Domain),
+    (0, type_graphql_1.Field)(type => shell_1.Domain, { nullable: true, description: 'Owning tenant domain.' }),
+    tslib_1.__metadata("design:type", shell_1.Domain)
+], TwinTarget.prototype, "domain", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((e) => e.domain),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "domainId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Space this target applies to (site-wide). Empty when the target is bound to a single instance.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "spaceId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Instance this target applies to. When both space and instance match, the instance target wins so an exception can be expressed.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "instanceId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Perspective axis this target applies to (area, shift, resource, taskKind, location, order). Empty means the target judges the window total. An axis target does not override the total — "the site does 100" and "the weld area does 30" are both true at once.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "axis", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ nullable: true }),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'The value on that axis (an area id, a shift name…). Required when axis is set.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "axisKey", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)(),
+    (0, type_graphql_1.Field)({ description: 'Metric id from the twin metric vocabulary (throughput.tasks, workTime.p50Ms, …). Names are fixed in one place so target and fact never drift into two dialects.' }),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "metric", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.Column)({ type: 'float' }),
+    (0, type_graphql_1.Field)(type => type_graphql_1.Float, { description: 'The target value, in the metric\'s own unit (count, milliseconds, ratio). Whether higher or lower is better is a property of the metric, not of this record — so a target can never be declared in the wrong direction.' }),
+    tslib_1.__metadata("design:type", Number)
+], TwinTarget.prototype, "target", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'User who created this target.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], TwinTarget.prototype, "creator", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((e) => e.creator),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "creatorId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.ManyToOne)(type => auth_base_1.User, { nullable: true }),
+    (0, type_graphql_1.Field)(type => auth_base_1.User, { nullable: true, description: 'User who last updated this target.' }),
+    tslib_1.__metadata("design:type", auth_base_1.User)
+], TwinTarget.prototype, "updater", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.RelationId)((e) => e.updater),
+    tslib_1.__metadata("design:type", String)
+], TwinTarget.prototype, "updaterId", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.CreateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Timestamp when the target was created.' }),
+    tslib_1.__metadata("design:type", Date)
+], TwinTarget.prototype, "createdAt", void 0);
+tslib_1.__decorate([
+    (0, typeorm_1.UpdateDateColumn)(),
+    (0, type_graphql_1.Field)({ nullable: true, description: 'Timestamp when the target was last updated.' }),
+    tslib_1.__metadata("design:type", Date)
+], TwinTarget.prototype, "updatedAt", void 0);
+exports.TwinTarget = TwinTarget = tslib_1.__decorate([
+    (0, typeorm_1.Entity)(),
+    (0, typeorm_1.Index)('ix_twin_target_0', (e) => [e.domain, e.spaceId, e.instanceId, e.metric, e.axis, e.axisKey], { unique: true }),
+    (0, type_graphql_1.ObjectType)({
+        description: 'An operational performance target for a twin metric — the line that turns a measured number into a judgement. Scoped to a space or to a single instance (instance wins over space, so an exception can be expressed). Distinct from @things-factory/kpi targets, which evaluate organizations over periods; twin targets are for immediate, on-site judgement and are never copied from the management KPI system.'
+    })
+], TwinTarget);
+//# sourceMappingURL=twin-target.js.map

package/dist-server/service/twin-target/twin-target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"twin-target.js","sourceRoot":"","sources":["../../../server/service/twin-target/twin-target.ts"],"names":[],"mappings":"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","sourcesContent":["import { CreateDateColumn, Entity, Index, Column, RelationId, ManyToOne, PrimaryGeneratedColumn, UpdateDateColumn } from 'typeorm'\nimport { ObjectType, Field, ID, Float } from 'type-graphql'\n\nimport { Domain } from '@things-factory/shell'\nimport { User } from '@things-factory/auth-base'\n\n/*\n * TwinTarget — **운영 목표.** \"이 구간의 처리량이 목표에 닿았나\" 를 판단하는 기준선.\n *\n * ── 왜 트윈이 갖나 (사용자 결정 2026-08-02) ─────────────────────────────────\n * `@things-factory/kpi` 와 **경계를 나눈다**:\n *   트윈(여기)      이 구간·이 교대·이 공간의 **즉시 판단**. 현장 관리자가 트윈 화면에서 고친다.\n *                   값은 저널 폴드에서 그때그때 계산된다(저장된 값을 읽지 않는다).\n *   packages/kpi    **기간 평가**(조직·분기·점수·가중치·알림). 값이 저장돼 있어야 도는 체계다.\n *\n * 지키는 규칙 하나: **트윈은 경영 목표를 복제하지 않는다.** 조직 단위 평가가 필요하면 트윈의 사실을\n * 내보내 그쪽이 소비하고, 그쪽 목표를 여기로 베껴 오지 않는다 — 베끼는 순간 두 개의 진실이 된다.\n *\n * ── 범위 (scope) ───────────────────────────────────────────────────────────\n * `spaceId` 로 현장 전체에, `instanceId` 로 트윈 하나에 건다. 둘 다 있으면 **인스턴스가 이긴다**\n * (좁은 선언이 넓은 선언을 덮는다 — 예외를 표현할 수 있어야 한다).\n *\n * 관점 축별 목표(구역마다 다른 목표)는 **아직 아니다** — 축 교차는 목표가 화면에서 쓰이기 시작한 뒤의\n * 일이고, 처음부터 넣으면 쓰이지 않는 구조가 먼저 굳는다(performance.md §5.4-5).\n *\n * (CLAUDE.md: 모든 @ObjectType/@Field 영문 description 필수.)\n */\n@Entity()\n@Index('ix_twin_target_0', (e: TwinTarget) => [e.domain, e.spaceId, e.instanceId, e.metric, e.axis, e.axisKey], { unique: true })\n@ObjectType({\n  description:\n    'An operational performance target for a twin metric — the line that turns a measured number into a judgement. Scoped to a space or to a single instance (instance wins over space, so an exception can be expressed). Distinct from @things-factory/kpi targets, which evaluate organizations over periods; twin targets are for immediate, on-site judgement and are never copied from the management KPI system.'\n})\nexport class TwinTarget {\n  @PrimaryGeneratedColumn('uuid')\n  @Field(type => ID, { description: 'Unique identifier of the target record.' })\n  readonly id: string\n\n  @ManyToOne(type => Domain)\n  @Field(type => Domain, { nullable: true, description: 'Owning tenant domain.' })\n  domain?: Domain\n\n  @RelationId((e: TwinTarget) => e.domain)\n  domainId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Space this target applies to (site-wide). Empty when the target is bound to a single instance.' })\n  spaceId?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Instance this target applies to. When both space and instance match, the instance target wins so an exception can be expressed.' })\n  instanceId?: string\n\n  /**\n   * 관점 축과 그 값 — **\"이 구역만\", \"이 교대만\" 목표가 다르다.**\n   *\n   * 둘 다 비어 있으면 **전체 목표**다(창 전체의 집계를 판정한다). 축 목표는 전체 목표를 덮지 않는다 —\n   * 다른 질문이기 때문이다: \"현장 전체가 100건\" 과 \"용접 구역이 30건\" 은 동시에 참일 수 있다.\n   */\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'Perspective axis this target applies to (area, shift, resource, taskKind, location, order). Empty means the target judges the window total. An axis target does not override the total — \"the site does 100\" and \"the weld area does 30\" are both true at once.' })\n  axis?: string\n\n  @Column({ nullable: true })\n  @Field({ nullable: true, description: 'The value on that axis (an area id, a shift name…). Required when axis is set.' })\n  axisKey?: string\n\n  @Column()\n  @Field({ description: 'Metric id from the twin metric vocabulary (throughput.tasks, workTime.p50Ms, …). Names are fixed in one place so target and fact never drift into two dialects.' })\n  metric: string\n\n  @Column({ type: 'float' })\n  @Field(type => Float, { description: 'The target value, in the metric\\'s own unit (count, milliseconds, ratio). Whether higher or lower is better is a property of the metric, not of this record — so a target can never be declared in the wrong direction.' })\n  target: number\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'User who created this target.' })\n  creator?: User\n\n  @RelationId((e: TwinTarget) => e.creator)\n  creatorId?: string\n\n  @ManyToOne(type => User, { nullable: true })\n  @Field(type => User, { nullable: true, description: 'User who last updated this target.' })\n  updater?: User\n\n  @RelationId((e: TwinTarget) => e.updater)\n  updaterId?: string\n\n  @CreateDateColumn()\n  @Field({ nullable: true, description: 'Timestamp when the target was created.' })\n  createdAt?: Date\n\n  @UpdateDateColumn()\n  @Field({ nullable: true, description: 'Timestamp when the target was last updated.' })\n  updatedAt?: Date\n}\n"]}