@things-factory/headless-twin 10.0.8 → 10.0.10

package/dist-server/engine/entity-delta.d.ts

@@ -1,19 +0,0 @@
-export interface EntityDelta {
-    tag: string;
-    data: any;
-}
-/** 집약 고정 태그 — 클라 provider 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */
-export declare const ORDERS_TAG = "__orders__";
-export declare const TASKS_TAG = "__tasks__";
-export declare const ITEMS_TAG = "__items__";
-export declare const PERSONS_TAG = "__persons__";
-export declare const ASSETS_TAG = "__assets__";
-/**
- * 물품 집약의 상한 — 큰 현장은 물품이 수만 개라, 전량을 매 방송에 실으면 전달이 현장을 느리게 한다.
- *
- * **조용히 자르지 않는다**: 넘치면 `total`(전체 수)과 `truncated`(잘린 수)를 함께 실어, 소비처가
- * "이게 전부" 라고 오해하지 않게 한다. 개별 물품은 태그별 delta 로 따로 나가고 그쪽은 시그니처 dedup
- * 이 걸려 **변한 것만** 재방송된다.
- */
-export declare const ITEMS_AGGREGATE_LIMIT = 500;
-export declare function buildEntityDeltas(state: any): EntityDelta[];

package/dist-server/engine/entity-delta.js

@@ -1,161 +0,0 @@
-"use strict";
-/*
- * 트윈 State 스냅샷 → 라이브 바인딩 delta 목록 (순수 매핑 — pubsub/도메인 무관 → 단위 테스트 가능).
- * publishEntityData 가 이 목록을 엔티티별 시그니처로 dedup 후 data(tag) 채널로 발행한다.
- *
- * ── 규율: 레퍼런스가 아는 것은 **전부** 내보낸다 ────────────────────────────
- * 트윈에서 사소한 속성은 없다. 소속 구역·소속 팔레트·수량·만료처럼 곁가지로 보이는 값이 실제로는
- * 구역 롤업·적재 표현·로트 추적의 전제다. 그래서 여기서 **필드를 손으로 골라 담지 않는다.**
- *
- * 예전에는 엔티티마다 필요할 것 같은 필드만 열거했고, 그 결과 계약에 있는 것이 조용히 누락됐다
- * (2026-08-01 감사: 노드 parentId 누락 · 작업 전량 누락 · 물품 전량 누락). 화이트리스트 방식은
- * **계약이 자라도 화면이 따라오지 못한다** — 커널이 속성을 늘릴 때마다 이 파일을 고쳐야 하고, 고치는
- * 것을 잊으면 아무 신호 없이 정보가 사라진다.
- *
- * 그래서 반대로 한다: **상태 객체가 가진 것을 그대로 통과**시키고, 통과시키지 **않을** 것만 이유와 함께
- * 열거한다(EXCLUDED). 새 속성은 자동으로 화면에 도달하고, 빼려면 이유를 적어야 한다.
- *
- * ── 표식은 도메인 낱말을 훔치지 않는다 ─────────────────────────────────────
- * 예전 payload 는 엔티티 종류 표식을 `kind` 로 실었다. 그런데 `kind` 는 **도메인의 낱말**이다 —
- * 무버 kind=cutter, 작업 kind=putaway, 오더 kind=workorder. 표식이 그 이름을 차지하면 도메인 속성을
- * 실을 자리가 없어진다(같은 병을 오늘 ox-timeline 의 `group` 에서도 고쳤다).
- * 그래서 표식은 `entity`(우리 이름)로 옮기고 `kind` 는 도메인에 돌려준다.
- *
- * payload 계약(씬 컴포넌트가 소비): `entity`(표식) + 그 엔티티의 모든 속성(도메인 `kind` 포함).
- *   entity = location · equipment · person · asset · order · task · item,
- *   그리고 집약 태그(__orders__ · __tasks__ · __items__ · __persons__ · __assets__).
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ITEMS_AGGREGATE_LIMIT = exports.ASSETS_TAG = exports.PERSONS_TAG = exports.ITEMS_TAG = exports.TASKS_TAG = exports.ORDERS_TAG = void 0;
-exports.buildEntityDeltas = buildEntityDeltas;
-/** 집약 고정 태그 — 클라 provider 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */
-exports.ORDERS_TAG = '__orders__';
-exports.TASKS_TAG = '__tasks__';
-exports.ITEMS_TAG = '__items__';
-exports.PERSONS_TAG = '__persons__';
-exports.ASSETS_TAG = '__assets__';
-/**
- * 통과시키지 않는 필드 — **빼는 데는 이유가 필요하다.**
- *
- * · `id`/`epc` — 태그로 이미 나가므로 개별 payload 에 중복해 싣지 않는다(집약 뷰에는 넣는다).
- * · `oee` — 원시 누적(idleMs 등)이 매 delta 증가해 "무변화 생략" 을 무력화한다. shapeOee 로 정형화해 얹는다.
- */
-const EXCLUDED = new Set(['id', 'epc', 'oee']);
-/**
- * OEE 원시 비율/카운트 → 표시용 정수 퍼센트 + 카운트.
- * 원시 누적 ms(idleMs 등)는 매 delta 증가해 무변화-생략을 무력화하므로 제외(유휴 자원의 매초 재방송 억제).
- * oee 미측정이면 undefined.
- */
-function shapeOee(o) {
-    if (!o)
-        return undefined;
-    return {
-        overall: Math.round((o.overall ?? 0) * 100),
-        availability: Math.round((o.availability ?? 0) * 100),
-        performance: Math.round((o.performance ?? 0) * 100),
-        quality: Math.round((o.quality ?? 0) * 100),
-        good: o.goodCount ?? 0,
-        scrap: o.scrapCount ?? 0
-    };
-}
-/**
- * 엔티티 하나의 payload — `entity` 표식 + 나머지 전부(도메인 `kind` 포함).
- *
- * `undefined` 값은 싣지 않는다(키의 유무가 시그니처를 흔들지 않게). 값이 없는 것과 키가 없는 것은
- * 소비처에서 같으므로 안전하고, 무변화 생략이 잘 듣는다.
- */
-function payloadOf(entityKind, entity) {
-    /* 표식은 `entity` — 도메인의 `kind` 를 덮지 않는다. */
-    const data = { entity: entityKind };
-    for (const [k, v] of Object.entries(entity ?? {})) {
-        if (EXCLUDED.has(k) || v === undefined)
-            continue;
-        data[k] = v;
-    }
-    return data;
-}
-/**
- * 집약 뷰의 항목 — 개별 payload 와 같은 내용 + 식별자.
- * 집약은 "전체를 한 컴포넌트가 추적" 하는 용도라 식별자가 있어야 한다.
- */
-function aggregateItem(entity, idKey) {
-    const out = { [idKey]: entity?.[idKey] };
-    for (const [k, v] of Object.entries(entity ?? {})) {
-        if (k === idKey || k === 'oee' || v === undefined)
-            continue;
-        out[k] = v;
-    }
-    const shaped = shapeOee(entity?.oee);
-    if (shaped)
-        out.oee = shaped;
-    return out;
-}
-/**
- * 물품 집약의 상한 — 큰 현장은 물품이 수만 개라, 전량을 매 방송에 실으면 전달이 현장을 느리게 한다.
- *
- * **조용히 자르지 않는다**: 넘치면 `total`(전체 수)과 `truncated`(잘린 수)를 함께 실어, 소비처가
- * "이게 전부" 라고 오해하지 않게 한다. 개별 물품은 태그별 delta 로 따로 나가고 그쪽은 시그니처 dedup
- * 이 걸려 **변한 것만** 재방송된다.
- */
-exports.ITEMS_AGGREGATE_LIMIT = 500;
-function buildEntityDeltas(state) {
-    const out = [];
-    for (const n of state?.locations ?? []) {
-        out.push({ tag: n.id, data: payloadOf('location', n) });
-    }
-    for (const m of state?.equipment ?? []) {
-        /* Mobile(location/motion) + Operable(status/held) + Processable(oee) — 한 payload 로.
-         * oee 만 정형화가 필요해 따로 얹는다(나머지는 통과). */
-        const data = payloadOf('equipment', m);
-        const oee = shapeOee(m?.oee);
-        if (oee)
-            data.oee = oee;
-        out.push({ tag: m.id, data });
-    }
-    /* 사람 — 설비와 별개 엔티티다. 같은 통과 규칙(가진 것을 전부 내보낸다). */
-    for (const p of state?.persons ?? []) {
-        out.push({ tag: p.id, data: payloadOf('person', p) });
-    }
-    /* 물리 자산(반복사용) — 물품도 설비도 아닌 네 번째 자원. */
-    for (const a of state?.assets ?? []) {
-        out.push({ tag: a.id, data: payloadOf('asset', a) });
-    }
-    for (const o of state?.orders ?? []) {
-        out.push({ tag: o.id, data: payloadOf('order', o) });
-    }
-    for (const t of state?.tasks ?? []) {
-        out.push({ tag: t.id, data: payloadOf('task', t) });
-    }
-    for (const it of state?.items ?? []) {
-        /* 물품의 태그는 epc(개체 식별자) — 노드·무버와 달리 id 가 아니다. */
-        if (it?.epc)
-            out.push({ tag: it.epc, data: payloadOf('item', it) });
-    }
-    /* ── 집약 뷰 ──────────────────────────────────────────────────────────────
-     * 런타임에 생기고 사라지는 엔티티(오더·작업·물품)는 보드에 개별 배치할 수 없다 → 한 컴포넌트가
-     * 전체를 추적하는 집약 태그를 항상 방출한다. */
-    const orders = state?.orders ?? [];
-    out.push({ tag: exports.ORDERS_TAG, data: { entity: 'orders', orders: orders.map((o) => aggregateItem(o, 'id')) } });
-    const tasks = state?.tasks ?? [];
-    out.push({ tag: exports.TASKS_TAG, data: { entity: 'tasks', tasks: tasks.map((t) => aggregateItem(t, 'id')) } });
-    /* 사람 집약 — 인원은 보드에 개별 배치할 수도 있지만(설비처럼), 전체를 한눈에 보는 소비처도 있다.
-     * 인원을 선언하지 않은 트윈에서는 빈 배열이 나간다(없음과 모름을 구별). */
-    const persons = state?.persons ?? [];
-    out.push({ tag: exports.PERSONS_TAG, data: { entity: 'persons', persons: persons.map((p) => aggregateItem(p, 'id')) } });
-    const assets = state?.assets ?? [];
-    out.push({ tag: exports.ASSETS_TAG, data: { entity: 'assets', assets: assets.map((a) => aggregateItem(a, 'id')) } });
-    const items = state?.items ?? [];
-    const shown = items.slice(0, exports.ITEMS_AGGREGATE_LIMIT);
-    out.push({
-        tag: exports.ITEMS_TAG,
-        data: {
-            entity: 'items',
-            items: shown.map((it) => aggregateItem(it, 'epc')),
-            total: items.length,
-            /* 잘렸으면 그 사실을 말한다 — "이게 전부" 로 읽히면 재고를 과소 판단한다. */
-            ...(items.length > shown.length ? { truncated: items.length - shown.length } : {})
-        }
-    });
-    return out;
-}
-//# sourceMappingURL=entity-delta.js.map

package/dist-server/engine/entity-delta.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"entity-delta.js","sourceRoot":"","sources":["../../server/engine/entity-delta.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * 트윈 State 스냅샷 → 라이브 바인딩 delta 목록 (순수 매핑 — pubsub/도메인 무관 → 단위 테스트 가능).\n * publishEntityData 가 이 목록을 엔티티별 시그니처로 dedup 후 data(tag) 채널로 발행한다.\n *\n * ── 규율: 레퍼런스가 아는 것은 **전부** 내보낸다 ────────────────────────────\n * 트윈에서 사소한 속성은 없다. 소속 구역·소속 팔레트·수량·만료처럼 곁가지로 보이는 값이 실제로는\n * 구역 롤업·적재 표현·로트 추적의 전제다. 그래서 여기서 **필드를 손으로 골라 담지 않는다.**\n *\n * 예전에는 엔티티마다 필요할 것 같은 필드만 열거했고, 그 결과 계약에 있는 것이 조용히 누락됐다\n * (2026-08-01 감사: 노드 parentId 누락 · 작업 전량 누락 · 물품 전량 누락). 화이트리스트 방식은\n * **계약이 자라도 화면이 따라오지 못한다** — 커널이 속성을 늘릴 때마다 이 파일을 고쳐야 하고, 고치는\n * 것을 잊으면 아무 신호 없이 정보가 사라진다.\n *\n * 그래서 반대로 한다: **상태 객체가 가진 것을 그대로 통과**시키고, 통과시키지 **않을** 것만 이유와 함께\n * 열거한다(EXCLUDED). 새 속성은 자동으로 화면에 도달하고, 빼려면 이유를 적어야 한다.\n *\n * ── 표식은 도메인 낱말을 훔치지 않는다 ─────────────────────────────────────\n * 예전 payload 는 엔티티 종류 표식을 `kind` 로 실었다. 그런데 `kind` 는 **도메인의 낱말**이다 —\n * 무버 kind=cutter, 작업 kind=putaway, 오더 kind=workorder. 표식이 그 이름을 차지하면 도메인 속성을\n * 실을 자리가 없어진다(같은 병을 오늘 ox-timeline 의 `group` 에서도 고쳤다).\n * 그래서 표식은 `entity`(우리 이름)로 옮기고 `kind` 는 도메인에 돌려준다.\n *\n * payload 계약(씬 컴포넌트가 소비): `entity`(표식) + 그 엔티티의 모든 속성(도메인 `kind` 포함).\n *   entity = location · equipment · person · asset · order · task · item,\n *   그리고 집약 태그(__orders__ · __tasks__ · __items__ · __persons__ · __assets__).\n */\n\nexport interface EntityDelta {\n  tag: string\n  data: any\n}\n\n/** 집약 고정 태그 — 클라 provider 와 일치해야 한다(런타임 생성 엔티티는 개별 배치가 불가하므로 집약 뷰). */\nexport const ORDERS_TAG = '__orders__'\nexport const TASKS_TAG = '__tasks__'\nexport const ITEMS_TAG = '__items__'\nexport const PERSONS_TAG = '__persons__'\nexport const ASSETS_TAG = '__assets__'\n\n/**\n * 통과시키지 않는 필드 — **빼는 데는 이유가 필요하다.**\n *\n * · `id`/`epc` — 태그로 이미 나가므로 개별 payload 에 중복해 싣지 않는다(집약 뷰에는 넣는다).\n * · `oee` — 원시 누적(idleMs 등)이 매 delta 증가해 \"무변화 생략\" 을 무력화한다. shapeOee 로 정형화해 얹는다.\n */\nconst EXCLUDED = new Set(['id', 'epc', 'oee'])\n\n/**\n * OEE 원시 비율/카운트 → 표시용 정수 퍼센트 + 카운트.\n * 원시 누적 ms(idleMs 등)는 매 delta 증가해 무변화-생략을 무력화하므로 제외(유휴 자원의 매초 재방송 억제).\n * oee 미측정이면 undefined.\n */\nfunction shapeOee(o: any): any {\n  if (!o) return undefined\n  return {\n    overall: Math.round((o.overall ?? 0) * 100),\n    availability: Math.round((o.availability ?? 0) * 100),\n    performance: Math.round((o.performance ?? 0) * 100),\n    quality: Math.round((o.quality ?? 0) * 100),\n    good: o.goodCount ?? 0,\n    scrap: o.scrapCount ?? 0\n  }\n}\n\n/**\n * 엔티티 하나의 payload — `entity` 표식 + 나머지 전부(도메인 `kind` 포함).\n *\n * `undefined` 값은 싣지 않는다(키의 유무가 시그니처를 흔들지 않게). 값이 없는 것과 키가 없는 것은\n * 소비처에서 같으므로 안전하고, 무변화 생략이 잘 듣는다.\n */\nfunction payloadOf(entityKind: string, entity: any): any {\n  /* 표식은 `entity` — 도메인의 `kind` 를 덮지 않는다. */\n  const data: any = { entity: entityKind }\n  for (const [k, v] of Object.entries(entity ?? {})) {\n    if (EXCLUDED.has(k) || v === undefined) continue\n    data[k] = v\n  }\n  return data\n}\n\n/**\n * 집약 뷰의 항목 — 개별 payload 와 같은 내용 + 식별자.\n * 집약은 \"전체를 한 컴포넌트가 추적\" 하는 용도라 식별자가 있어야 한다.\n */\nfunction aggregateItem(entity: any, idKey: 'id' | 'epc'): any {\n  const out: any = { [idKey]: entity?.[idKey] }\n  for (const [k, v] of Object.entries(entity ?? {})) {\n    if (k === idKey || k === 'oee' || v === undefined) continue\n    out[k] = v\n  }\n  const shaped = shapeOee(entity?.oee)\n  if (shaped) out.oee = shaped\n  return out\n}\n\n/**\n * 물품 집약의 상한 — 큰 현장은 물품이 수만 개라, 전량을 매 방송에 실으면 전달이 현장을 느리게 한다.\n *\n * **조용히 자르지 않는다**: 넘치면 `total`(전체 수)과 `truncated`(잘린 수)를 함께 실어, 소비처가\n * \"이게 전부\" 라고 오해하지 않게 한다. 개별 물품은 태그별 delta 로 따로 나가고 그쪽은 시그니처 dedup\n * 이 걸려 **변한 것만** 재방송된다.\n */\nexport const ITEMS_AGGREGATE_LIMIT = 500\n\nexport function buildEntityDeltas(state: any): EntityDelta[] {\n  const out: EntityDelta[] = []\n\n  for (const n of state?.locations ?? []) {\n    out.push({ tag: n.id, data: payloadOf('location', n) })\n  }\n  for (const m of state?.equipment ?? []) {\n    /* Mobile(location/motion) + Operable(status/held) + Processable(oee) — 한 payload 로.\n     * oee 만 정형화가 필요해 따로 얹는다(나머지는 통과). */\n    const data = payloadOf('equipment', m)\n    const oee = shapeOee(m?.oee)\n    if (oee) data.oee = oee\n    out.push({ tag: m.id, data })\n  }\n  /* 사람 — 설비와 별개 엔티티다. 같은 통과 규칙(가진 것을 전부 내보낸다). */\n  for (const p of state?.persons ?? []) {\n    out.push({ tag: p.id, data: payloadOf('person', p) })\n  }\n  /* 물리 자산(반복사용) — 물품도 설비도 아닌 네 번째 자원. */\n  for (const a of state?.assets ?? []) {\n    out.push({ tag: a.id, data: payloadOf('asset', a) })\n  }\n  for (const o of state?.orders ?? []) {\n    out.push({ tag: o.id, data: payloadOf('order', o) })\n  }\n  for (const t of state?.tasks ?? []) {\n    out.push({ tag: t.id, data: payloadOf('task', t) })\n  }\n  for (const it of state?.items ?? []) {\n    /* 물품의 태그는 epc(개체 식별자) — 노드·무버와 달리 id 가 아니다. */\n    if (it?.epc) out.push({ tag: it.epc, data: payloadOf('item', it) })\n  }\n\n  /* ── 집약 뷰 ──────────────────────────────────────────────────────────────\n   * 런타임에 생기고 사라지는 엔티티(오더·작업·물품)는 보드에 개별 배치할 수 없다 → 한 컴포넌트가\n   * 전체를 추적하는 집약 태그를 항상 방출한다. */\n  const orders = state?.orders ?? []\n  out.push({ tag: ORDERS_TAG, data: { entity: 'orders', orders: orders.map((o: any) => aggregateItem(o, 'id')) } })\n\n  const tasks = state?.tasks ?? []\n  out.push({ tag: TASKS_TAG, data: { entity: 'tasks', tasks: tasks.map((t: any) => aggregateItem(t, 'id')) } })\n\n  /* 사람 집약 — 인원은 보드에 개별 배치할 수도 있지만(설비처럼), 전체를 한눈에 보는 소비처도 있다.\n   * 인원을 선언하지 않은 트윈에서는 빈 배열이 나간다(없음과 모름을 구별). */\n  const persons = state?.persons ?? []\n  out.push({ tag: PERSONS_TAG, data: { entity: 'persons', persons: persons.map((p: any) => aggregateItem(p, 'id')) } })\n\n  const assets = state?.assets ?? []\n  out.push({ tag: ASSETS_TAG, data: { entity: 'assets', assets: assets.map((a: any) => aggregateItem(a, 'id')) } })\n\n  const items = state?.items ?? []\n  const shown = items.slice(0, ITEMS_AGGREGATE_LIMIT)\n  out.push({\n    tag: ITEMS_TAG,\n    data: {\n      entity: 'items',\n      items: shown.map((it: any) => aggregateItem(it, 'epc')),\n      total: items.length,\n      /* 잘렸으면 그 사실을 말한다 — \"이게 전부\" 로 읽히면 재고를 과소 판단한다. */\n      ...(items.length > shown.length ? { truncated: items.length - shown.length } : {})\n    }\n  })\n\n  return out\n}\n"]}

package/dist-server/service/twin-event/backfill-keys.d.ts

@@ -1,11 +0,0 @@
-export interface BackfillResult {
-    /** 실제로 갱신한 행 수. */
-    updated: number;
-    /** 훑었지만 payload 가 없어 채울 수 없던 행 수 — 0 이 아니면 인제스트 쪽을 봐야 한다. */
-    skipped: number;
-}
-/**
- * 남은 행을 전부 채운다. 진행 상황을 로그로 남긴다 — 조용히 오래 도는 작업은
- * 멈춘 것과 구분되지 않는다.
- */
-export declare function backfillTwinEventKeys(): Promise<BackfillResult>;

package/dist-server/service/twin-event/backfill-keys.js

@@ -1,63 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.backfillTwinEventKeys = backfillTwinEventKeys;
-const typeorm_1 = require("typeorm");
-const shell_1 = require("@things-factory/shell");
-const twin_event_js_1 = require("./twin-event.js");
-const twin_event_keys_js_1 = require("./twin-event-keys.js");
-/*
- * 승격 검색 키 백필 — 컬럼이 생기기 **전에** 쌓인 저널 행을 채운다.
- *
- * 이게 없으면 검색은 "오늘부터의 이력" 만 찾는다. 사용자에게는 그냥 **과거가 없는 것으로 보이고**,
- * 그건 이번에 고치려던 결함(조용히 빠진 데이터)과 정확히 같은 종류다.
- *
- * 성질:
- *  · 멱등 — 이미 채워진 행은 건드리지 않는다(bizStep IS NULL 인 것만 집는다).
- *  · 재개 가능 — 중간에 죽어도 다음 기동에서 남은 것부터 이어간다.
- *  · 조각내서 — 한 번에 다 읽지 않는다. 저널은 크다는 전제로 만든다.
- *  · payload 는 손대지 않는다 — 정본은 그대로 두고 파생 색인만 채운다.
- *
- * 아주 큰 운영 저널이라면 기동 시 백그라운드보다 **마이그레이션으로 한 번** 도는 편이 낫다.
- * 이 함수를 그대로 부르면 되므로 경로는 하나다.
- */
-const CHUNK = 1000;
-/**
- * 남은 행을 전부 채운다. 진행 상황을 로그로 남긴다 — 조용히 오래 도는 작업은
- * 멈춘 것과 구분되지 않는다.
- */
-async function backfillTwinEventKeys() {
-    const repo = (0, shell_1.getRepository)(twin_event_js_1.TwinEvent);
-    let updated = 0;
-    let skipped = 0;
-    let round = 0;
-    for (;;) {
-        /* bizStep 은 이벤트 타입에서라도 유추되므로 **정상 인제스트라면 반드시 채워진다** —
-         * 즉 NULL 은 "승격 이전 행" 의 확실한 표식이다. epc 로 판정하면 품목 없는 이벤트를
-         * 매번 다시 집어 무한히 돈다. */
-        const rows = await repo.find({ where: { bizStep: (0, typeorm_1.IsNull)() }, take: CHUNK, order: { revision: 'ASC' } });
-        if (rows.length === 0)
-            break;
-        const dirty = [];
-        for (const row of rows) {
-            if (!row.payload) {
-                skipped++;
-                continue;
-            }
-            Object.assign(row, (0, twin_event_keys_js_1.twinEventKeys)(row.payload));
-            dirty.push(row);
-        }
-        if (dirty.length)
-            await repo.save(dirty, { chunk: 500 });
-        updated += dirty.length;
-        /* payload 가 없는 행만 남으면 같은 조각을 영원히 다시 읽는다 — 진도가 없으면 멈춘다. */
-        if (dirty.length === 0)
-            break;
-        if (++round % 10 === 0)
-            console.log(`[twin-event backfill] ${updated} rows filled…`);
-    }
-    if (updated || skipped) {
-        console.log(`[twin-event backfill] done — ${updated} filled, ${skipped} skipped (no payload)`);
-    }
-    return { updated, skipped };
-}
-//# sourceMappingURL=backfill-keys.js.map

package/dist-server/service/twin-event/backfill-keys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"backfill-keys.js","sourceRoot":"","sources":["../../../server/service/twin-event/backfill-keys.ts"],"names":[],"mappings":";;AAoCA,sDAmCC;AAvED,qCAAgC;AAEhC,iDAAqD;AAErD,mDAA2C;AAC3C,6DAAoD;AAEpD;;;;;;;;;;;;;;GAcG;AAEH,MAAM,KAAK,GAAG,IAAI,CAAA;AASlB;;;GAGG;AACI,KAAK,UAAU,qBAAqB;IACzC,MAAM,IAAI,GAAG,IAAA,qBAAa,EAAC,yBAAS,CAAC,CAAA;IACrC,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,KAAK,GAAG,CAAC,CAAA;IAEb,SAAS,CAAC;QACR;;8BAEsB;QACtB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAA,gBAAM,GAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,CAAC,CAAA;QACvG,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAK;QAE5B,MAAM,KAAK,GAAgB,EAAE,CAAA;QAC7B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjB,OAAO,EAAE,CAAA;gBACT,SAAQ;YACV,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAA,kCAAa,EAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAA;YAC9C,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;QACD,IAAI,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;QACxD,OAAO,IAAI,KAAK,CAAC,MAAM,CAAA;QAEvB,0DAA0D;QAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,MAAK;QAE7B,IAAI,EAAE,KAAK,GAAG,EAAE,KAAK,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,yBAAyB,OAAO,eAAe,CAAC,CAAA;IACtF,CAAC;IAED,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,gCAAgC,OAAO,YAAY,OAAO,uBAAuB,CAAC,CAAA;IAChG,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAA;AAC7B,CAAC","sourcesContent":["import { IsNull } from 'typeorm'\n\nimport { getRepository } from '@things-factory/shell'\n\nimport { TwinEvent } from './twin-event.js'\nimport { twinEventKeys } from './twin-event-keys.js'\n\n/*\n * 승격 검색 키 백필 — 컬럼이 생기기 **전에** 쌓인 저널 행을 채운다.\n *\n * 이게 없으면 검색은 \"오늘부터의 이력\" 만 찾는다. 사용자에게는 그냥 **과거가 없는 것으로 보이고**,\n * 그건 이번에 고치려던 결함(조용히 빠진 데이터)과 정확히 같은 종류다.\n *\n * 성질:\n *  · 멱등 — 이미 채워진 행은 건드리지 않는다(bizStep IS NULL 인 것만 집는다).\n *  · 재개 가능 — 중간에 죽어도 다음 기동에서 남은 것부터 이어간다.\n *  · 조각내서 — 한 번에 다 읽지 않는다. 저널은 크다는 전제로 만든다.\n *  · payload 는 손대지 않는다 — 정본은 그대로 두고 파생 색인만 채운다.\n *\n * 아주 큰 운영 저널이라면 기동 시 백그라운드보다 **마이그레이션으로 한 번** 도는 편이 낫다.\n * 이 함수를 그대로 부르면 되므로 경로는 하나다.\n */\n\nconst CHUNK = 1000\n\nexport interface BackfillResult {\n  /** 실제로 갱신한 행 수. */\n  updated: number\n  /** 훑었지만 payload 가 없어 채울 수 없던 행 수 — 0 이 아니면 인제스트 쪽을 봐야 한다. */\n  skipped: number\n}\n\n/**\n * 남은 행을 전부 채운다. 진행 상황을 로그로 남긴다 — 조용히 오래 도는 작업은\n * 멈춘 것과 구분되지 않는다.\n */\nexport async function backfillTwinEventKeys(): Promise<BackfillResult> {\n  const repo = getRepository(TwinEvent)\n  let updated = 0\n  let skipped = 0\n  let round = 0\n\n  for (;;) {\n    /* bizStep 은 이벤트 타입에서라도 유추되므로 **정상 인제스트라면 반드시 채워진다** —\n     * 즉 NULL 은 \"승격 이전 행\" 의 확실한 표식이다. epc 로 판정하면 품목 없는 이벤트를\n     * 매번 다시 집어 무한히 돈다. */\n    const rows = await repo.find({ where: { bizStep: IsNull() }, take: CHUNK, order: { revision: 'ASC' } })\n    if (rows.length === 0) break\n\n    const dirty: TwinEvent[] = []\n    for (const row of rows) {\n      if (!row.payload) {\n        skipped++\n        continue\n      }\n      Object.assign(row, twinEventKeys(row.payload))\n      dirty.push(row)\n    }\n    if (dirty.length) await repo.save(dirty, { chunk: 500 })\n    updated += dirty.length\n\n    /* payload 가 없는 행만 남으면 같은 조각을 영원히 다시 읽는다 — 진도가 없으면 멈춘다. */\n    if (dirty.length === 0) break\n\n    if (++round % 10 === 0) console.log(`[twin-event backfill] ${updated} rows filled…`)\n  }\n\n  if (updated || skipped) {\n    console.log(`[twin-event backfill] done — ${updated} filled, ${skipped} skipped (no payload)`)\n  }\n  return { updated, skipped }\n}\n"]}