@things-factory/headless-twin 10.0.19 → 10.1.0

package/dist-server/engine/oee-accumulator.js

@@ -20,11 +20,49 @@ class OeeAccumulator {
     constructor() {
         this.acc = new Map();
         this.maxMs = 0; // 최신 이벤트 시각 — nowMs 기본값(현재 계측 시점)
+        this.calendarByResource = new Map();
+    }
+    /**
+     * 모델에서 조업 달력을 읽어 얹는다 — 모델을 들고 있는 쪽(`TwinEngine`)이 부른다.
+     *
+     * ── 우선순위가 여기 있는 이유 ───────────────────────────────────────────────
+     * ```
+     * 설비의 달력    이 설비의 가동 계획 — 선언했으면 이것이 이긴다 (24시간 도는 로)
+     * 현장의 달력    이 현장의 조업일
+     * 없음          제약 없음 — 계획 조업 시간이 창 전체가 된다
+     * ```
+     * 계획 조업 시간을 내는 자리가 여기라 그 규칙도 여기 둔다. 부르는 쪽마다 고르게 하면 라이브와
+     * 히스토리가 다른 답을 낸다.
+     *
+     * ⚠ **설비의 달력은 사람의 근무조가 아니다.** 씨앗이 사람의 근무조를 설비 달력에 복사한 일이 있었고,
+     * 그때 아무도 근무하지 않는 시간이 근무 시간으로 기록됐다. 사람 쪽은 `persons[].workCalendar` 다.
+     *
+     * 세우는 자리에서 한 번만 주지 않고 따로 부르는 이유는 모델이 다시 실릴 수 있기 때문이다
+     * (재동기화 · 이관). 그때 달력만 갈아 끼우면 누적된 계측을 버리지 않는다.
+     */
+    setWorkCalendar(model) {
+        this.siteCalendar = model?.workCalendar?.length ? model.workCalendar : undefined;
+        this.utcOffsetMinutes = model?.utcOffsetMinutes;
+        this.calendarByResource.clear();
+        for (const e of model?.equipment ?? []) {
+            const cal = e?.workCalendar;
+            if (e?.id && Array.isArray(cal) && cal.length)
+                this.calendarByResource.set(String(e.id), cal);
+        }
+    }
+    /**
+     * 이 설비의 계획 가동 달력 — 자기 것이 있으면 그것, 없으면 현장의 것.
+     *
+     * 인자 이름이 `moverId` 인 것은 **봉투의 옛 세대 필드 이름**이라 그렇다(§`apply`). 새로 만드는
+     * 이름에는 그 낱말을 쓰지 않는다 — 어휘 가드가 그것을 잡았고, 맞게 잡았다.
+     */
+    calendarFor(moverId) {
+        return this.calendarByResource.get(moverId) ?? this.siteCalendar;
     }
     ensure(moverId, t) {
         let a = this.acc.get(moverId);
         if (!a) {
-            a = { lastMs: t, startMs: t, busyMs: 0, downMs: 0, goodCount: 0, scrapCount: 0 };
+            a = { lastMs: t, startMs: t, busyMs: 0, downMs: 0, goodCount: 0, nonconformingCount: 0 };
             this.acc.set(moverId, a);
         }
         return a;
@@ -59,7 +97,7 @@ class OeeAccumulator {
                 return;
             const a = this.ensure(q.moverId, t);
             a.goodCount = q.goodCount ?? a.goodCount; // 누적값 최신화(good/scrap 은 무버 누적)
-            a.scrapCount = q.scrapCount ?? a.scrapCount;
+            a.nonconformingCount = q.nonconformingCount ?? a.nonconformingCount;
             return;
         }
         if (env.eventType !== 'equipment.status')
@@ -86,7 +124,7 @@ class OeeAccumulator {
          * 없음을 없음으로 다룬다(§computeOee).
          */
         if (!a)
-            return { runMs: 0, setupMs: 0, downMs: 0, goodCount: 0, scrapCount: 0 };
+            return { runMs: 0, setupMs: 0, downMs: 0, goodCount: 0, nonconformingCount: 0 };
         const dt = Math.max(0, nowMs - a.lastMs);
         let busyMs = a.busyMs;
         let downMs = a.downMs;
@@ -94,7 +132,21 @@ class OeeAccumulator {
             busyMs += dt;
         else if (a.status === 'down')
             downMs += dt;
-        return { runMs: busyMs, setupMs: 0, downMs, goodCount: a.goodCount, scrapCount: a.scrapCount, metricsSinceMs: a.startMs };
+        /*
+         * 계획 정지 — 계약이 이 칸에 그 뜻을 적어 뒀다(점심 · 예방보전 · 교대). 휴일과 주말이 같은
+         * 갈래다. `metricsSinceMs` 를 당겨서 같은 효과를 내지 않는다: 그 칸은 「언제부터 쟀나」라는
+         * 사실이고, 파생값을 얹으면 실제보다 늦게 재기 시작했다고 말하는 것이 된다.
+         */
+        const holdMs = (0, ops_contract_1.nonWorkingMsIn)(this.calendarFor(moverId), a.startMs, nowMs, this.utcOffsetMinutes);
+        return {
+            runMs: busyMs,
+            setupMs: 0,
+            downMs,
+            goodCount: a.goodCount,
+            nonconformingCount: a.nonconformingCount,
+            metricsSinceMs: a.startMs,
+            ...(holdMs !== undefined ? { holdMs } : {})
+        };
     }
     /** 공유 공식으로 근사 OEE 산출 — 정확한 OEE 는 실 텔레메트리(option ①). nowMs 기본=최신 이벤트 시각. */
     oee(moverId, nowMs = this.maxMs) {

package/dist-server/engine/oee-accumulator.js.map

@@ -1 +1 @@
-{"version":3,"file":"oee-accumulator.js","sourceRoot":"","sources":["../../server/engine/oee-accumulator.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * OEE 이벤트 누적기 (순수·근사) — live-모드 OEE 입력 생산의 한 경로(face2-inbound-live §1.1, option ②).\n *\n * 문제: OEE 공식(computeOee)은 sim/live 공유되나, 입력 카운터(runMs/downMs/…)는 미러 State·이벤트에 없다\n *   (emitEquipment 는 status/location/motion 만 방출). → live 는 카운터를 별도 생산해야 한다.\n * 이 누적기: equipment.status 전이 스트림으로 무버별 시간-in-상태를 누적해 카운터를 근사 생산.\n *\n * 정확: downMs(고장 시간 = down 구간 합) · quality(good/scrap = quality.output 델타). 근사·한계:\n *   - busyMs 를 runMs 로(setup 분리 불가 — 이벤트에 setup 없음) → performance 낙관·availability 는 setup 손실 미반영.\n *   - quality.output 이 없으면(예: WMS/YMS) quality=1(품질 개념 없음).\n * 시간축 = Date.parse(eventTime)(ms) — 구간 차분은 sim/실시간 무관하게 정확(고정 오프셋 상쇄).\n */\n/* OEE 공식은 계약에 있다 — 소비자가 셋이라(시뮬·미러·MES) 커널에 두면 밖에서 다시 쓰게 된다. */\nimport { computeOee } from '@operato/ops-contract'\nimport type { OeeCounters } from '@operato/ops-contract'\nimport type { CanonicalEnvelope, OeeMetrics } from '@operato/ops-contract'\n\ninterface Acc {\n  status?: string\n  lastMs: number\n  startMs: number\n  busyMs: number\n  downMs: number\n  goodCount: number\n  scrapCount: number\n}\n\n/** 누적기의 완전한 재개점 — 저장했다 되살릴 수 있어야 꼬리만 계산할 수 있다. */\nexport interface OeeCheckpoint {\n  maxMs: number\n  acc: ({ moverId: string } & Acc)[]\n}\n\nexport class OeeAccumulator {\n  private acc = new Map<string, Acc>()\n  private maxMs = 0 // 최신 이벤트 시각 — nowMs 기본값(현재 계측 시점)\n\n  private ensure(moverId: string, t: number): Acc {\n    let a = this.acc.get(moverId)\n    if (!a) {\n      a = { lastMs: t, startMs: t, busyMs: 0, downMs: 0, goodCount: 0, scrapCount: 0 }\n      this.acc.set(moverId, a)\n    }\n    return a\n  }\n\n  /**\n   * **재개점** — 이 누적기의 상태 전부(이어 계산의 씨앗).\n   *\n   * ── 왜 필요한가 (2026-08-18) ────────────────────────────────────────────────\n   * 가동 이력은 원 시스템이 누적을 주지 않아 **우리가 이벤트를 적분해** 만든다. 그래서 저널을 꼬리만\n   * 계산하면 이 누적기는 꼬리분만 갖게 되고, 화면의 가용률·수율이 알리지 않고 작아진다(오류는 나지 않는다).\n   * 재개점을 함께 저장·복원해야 「이어 계산한 값」이 「0부터 계산한 값」과 같아진다.\n   */\n  serialize(): OeeCheckpoint {\n    return {\n      maxMs: this.maxMs,\n      acc: [...this.acc.entries()].map(([moverId, a]) => ({ moverId, ...a }))\n    }\n  }\n\n  /** 재개점에서 되세운다 — 모르는 것은 지어내지 않는다(없으면 빈 누적기다). */\n  restore(cp: OeeCheckpoint | undefined | null): void {\n    this.maxMs = cp?.maxMs ?? 0\n    this.acc = new Map((cp?.acc ?? []).map(({ moverId, ...a }) => [moverId, { ...a }]))\n  }\n\n  /** equipment.status(시간-in-상태) + quality.output(양품/불량) 소비. 다른 eventType 무시. */\n  apply(env: CanonicalEnvelope): void {\n    const t = Date.parse(env.eventTime)\n    if (t > this.maxMs) this.maxMs = t\n    if (env.eventType === 'quality.output') {\n      const q = env.data as { moverId?: string; goodCount?: number; scrapCount?: number }\n      if (!q?.moverId) return\n      const a = this.ensure(q.moverId, t)\n      a.goodCount = q.goodCount ?? a.goodCount // 누적값 최신화(good/scrap 은 무버 누적)\n      a.scrapCount = q.scrapCount ?? a.scrapCount\n      return\n    }\n    if (env.eventType !== 'equipment.status') return\n    const d = env.data as { moverId?: string; status?: string }\n    if (!d?.moverId) return\n    const a = this.ensure(d.moverId, t)\n    const dt = Math.max(0, t - a.lastMs)\n    if (a.status === 'busy') a.busyMs += dt\n    else if (a.status === 'down') a.downMs += dt\n    a.status = d.status\n    a.lastMs = t\n  }\n\n  /** 무버 OEE 카운터 — 마지막 상태 구간을 nowMs(기본=최신 이벤트 시각)까지 flush. busy→run 근사, setup=0. */\n  counters(moverId: string, nowMs: number = this.maxMs): OeeCounters {\n    const a = this.acc.get(moverId)\n    /*\n     * **이 설비의 이벤트를 하나도 못 봤다** — 계측 창이 없다는 뜻이고, 그것을 `0` 으로 메우면\n     * \"1970년부터 재고 있었다\" 가 된다. 시각이 밀리초 epoch 이므로 그 값이 곧 지금 시각이 되어,\n     * 화면에 `idleMs 1767226603000`(약 56,000년) 유휴가 섰다. 창을 **말하지 않는다** — 공식이\n     * 없음을 없음으로 다룬다(§computeOee).\n     */\n    if (!a) return { runMs: 0, setupMs: 0, downMs: 0, goodCount: 0, scrapCount: 0 }\n    const dt = Math.max(0, nowMs - a.lastMs)\n    let busyMs = a.busyMs\n    let downMs = a.downMs\n    if (a.status === 'busy') busyMs += dt\n    else if (a.status === 'down') downMs += dt\n    return { runMs: busyMs, setupMs: 0, downMs, goodCount: a.goodCount, scrapCount: a.scrapCount, metricsSinceMs: a.startMs }\n  }\n\n  /** 공유 공식으로 근사 OEE 산출 — 정확한 OEE 는 실 텔레메트리(option ①). nowMs 기본=최신 이벤트 시각. */\n  oee(moverId: string, nowMs: number = this.maxMs): OeeMetrics {\n    return computeOee(this.counters(moverId, nowMs), nowMs)\n  }\n}\n\n/**\n * live State 를 OEE 로 보강 — projector 미러 State(관측)의 무버에 누적기 OEE(계산)를 채운다.\n * live-모드 publishEntityData 가 buildEntityDeltas 전에 적용 → equipment data(tag) payload 에 oee 포함\n * (sim 은 커널이 채움 — 이로써 live 도 동일 payload 형상). 순수(입력 불변, 얕은 복사).\n */\nexport function withLiveOee<S extends { equipment?: any[] }>(state: S, acc: OeeAccumulator, nowMs?: number): S {\n  if (!state?.equipment) return state\n  return { ...state, equipment: state.equipment.map(m => ({ ...m, oee: acc.oee(m.id, nowMs) })) }\n}\n"]}
+{"version":3,"file":"oee-accumulator.js","sourceRoot":"","sources":["../../server/engine/oee-accumulator.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n * OEE 이벤트 누적기 (순수·근사) — live-모드 OEE 입력 생산의 한 경로(face2-inbound-live §1.1, option ②).\n *\n * 문제: OEE 공식(computeOee)은 sim/live 공유되나, 입력 카운터(runMs/downMs/…)는 미러 State·이벤트에 없다\n *   (emitEquipment 는 status/location/motion 만 방출). → live 는 카운터를 별도 생산해야 한다.\n * 이 누적기: equipment.status 전이 스트림으로 무버별 시간-in-상태를 누적해 카운터를 근사 생산.\n *\n * 정확: downMs(고장 시간 = down 구간 합) · quality(good/scrap = quality.output 델타). 근사·한계:\n *   - busyMs 를 runMs 로(setup 분리 불가 — 이벤트에 setup 없음) → performance 낙관·availability 는 setup 손실 미반영.\n *   - quality.output 이 없으면(예: WMS/YMS) quality=1(품질 개념 없음).\n * 시간축 = Date.parse(eventTime)(ms) — 구간 차분은 sim/실시간 무관하게 정확(고정 오프셋 상쇄).\n */\n/* OEE 공식은 계약에 있다 — 소비자가 셋이라(시뮬·미러·MES) 커널에 두면 밖에서 다시 쓰게 된다. */\nimport { computeOee, nonWorkingMsIn } from '@operato/ops-contract'\nimport type { OeeCounters, WorkCalendarEntry } from '@operato/ops-contract'\nimport type { CanonicalEnvelope, OeeMetrics } from '@operato/ops-contract'\n\ninterface Acc {\n  status?: string\n  lastMs: number\n  startMs: number\n  busyMs: number\n  downMs: number\n  goodCount: number\n  nonconformingCount: number\n}\n\n/** 누적기의 완전한 재개점 — 저장했다 되살릴 수 있어야 꼬리만 계산할 수 있다. */\nexport interface OeeCheckpoint {\n  maxMs: number\n  acc: ({ moverId: string } & Acc)[]\n}\n\nexport class OeeAccumulator {\n  private acc = new Map<string, Acc>()\n  private maxMs = 0 // 최신 이벤트 시각 — nowMs 기본값(현재 계측 시점)\n\n  /*\n   * ── 현장이 언제 도나 — **계획 조업 시간의 근거** (2026-09-07) ────────────────\n   * 이것이 없던 동안 계획 조업 시간이 「재기 시작한 뒤 흐른 시간 전부」였다. 주말도 야간도 휴일도\n   * 계획 조업으로 세었다.\n   *\n   * [산술] 8시간 × 주5일이면 168시간 중 40시간이 조업이다 — PBT 가 4.2배 크고 가동률이 그만큼 작다.\n   * 그리고 그 수가 1로 잘려 있어서(오늘 걷었다) 그럴싸하게 보였다. 두 오류가 서로를 가렸다.\n   *\n   * plant 레인이 같은 자리를 먼저 겪고 실측을 냈다 — 3교대를 물려받으면 `availability 0.4583`,\n   * 달력이 아예 없으면 **수를 안 낸다**. 트윈은 창 전체를 계획으로 쳐서 수를 냈다.\n   *\n   * ⚠ **선언이 없으면 채우지 않는다.** `nonWorkingMsIn` 이 그때 `undefined` 를 내고, 그 값을 0 으로\n   * 바꾸지 않는다 — 0 은 「달력을 봤고 쉬는 시간이 없었다」는 주장이다. 지금은 그러면 PBT 가 창 전체가\n   * 되어 예전과 같은 수가 나온다. **그것을 「안 낸다」로 바꿀지는 아직 결정되지 않았다** — 거동 변화가\n   * 크고 화면이 비는 자리라 사용자 판단을 기다린다(성숙도에 미달로 세우는 짝과 함께 가야 한다).\n   */\n  private siteCalendar?: readonly WorkCalendarEntry[]\n  private calendarByResource = new Map<string, readonly WorkCalendarEntry[]>()\n  private utcOffsetMinutes?: number\n\n  /**\n   * 모델에서 조업 달력을 읽어 얹는다 — 모델을 들고 있는 쪽(`TwinEngine`)이 부른다.\n   *\n   * ── 우선순위가 여기 있는 이유 ───────────────────────────────────────────────\n   * ```\n   * 설비의 달력    이 설비의 가동 계획 — 선언했으면 이것이 이긴다 (24시간 도는 로)\n   * 현장의 달력    이 현장의 조업일\n   * 없음          제약 없음 — 계획 조업 시간이 창 전체가 된다\n   * ```\n   * 계획 조업 시간을 내는 자리가 여기라 그 규칙도 여기 둔다. 부르는 쪽마다 고르게 하면 라이브와\n   * 히스토리가 다른 답을 낸다.\n   *\n   * ⚠ **설비의 달력은 사람의 근무조가 아니다.** 씨앗이 사람의 근무조를 설비 달력에 복사한 일이 있었고,\n   * 그때 아무도 근무하지 않는 시간이 근무 시간으로 기록됐다. 사람 쪽은 `persons[].workCalendar` 다.\n   *\n   * 세우는 자리에서 한 번만 주지 않고 따로 부르는 이유는 모델이 다시 실릴 수 있기 때문이다\n   * (재동기화 · 이관). 그때 달력만 갈아 끼우면 누적된 계측을 버리지 않는다.\n   */\n  setWorkCalendar(model?: { workCalendar?: readonly WorkCalendarEntry[]; equipment?: readonly any[]; utcOffsetMinutes?: number }): void {\n    this.siteCalendar = model?.workCalendar?.length ? model.workCalendar : undefined\n    this.utcOffsetMinutes = model?.utcOffsetMinutes\n    this.calendarByResource.clear()\n    for (const e of model?.equipment ?? []) {\n      const cal = e?.workCalendar\n      if (e?.id && Array.isArray(cal) && cal.length) this.calendarByResource.set(String(e.id), cal)\n    }\n  }\n\n  /**\n   * 이 설비의 계획 가동 달력 — 자기 것이 있으면 그것, 없으면 현장의 것.\n   *\n   * 인자 이름이 `moverId` 인 것은 **봉투의 옛 세대 필드 이름**이라 그렇다(§`apply`). 새로 만드는\n   * 이름에는 그 낱말을 쓰지 않는다 — 어휘 가드가 그것을 잡았고, 맞게 잡았다.\n   */\n  private calendarFor(moverId: string): readonly WorkCalendarEntry[] | undefined {\n    return this.calendarByResource.get(moverId) ?? this.siteCalendar\n  }\n\n  private ensure(moverId: string, t: number): Acc {\n    let a = this.acc.get(moverId)\n    if (!a) {\n      a = { lastMs: t, startMs: t, busyMs: 0, downMs: 0, goodCount: 0, nonconformingCount: 0 }\n      this.acc.set(moverId, a)\n    }\n    return a\n  }\n\n  /**\n   * **재개점** — 이 누적기의 상태 전부(이어 계산의 씨앗).\n   *\n   * ── 왜 필요한가 (2026-08-18) ────────────────────────────────────────────────\n   * 가동 이력은 원 시스템이 누적을 주지 않아 **우리가 이벤트를 적분해** 만든다. 그래서 저널을 꼬리만\n   * 계산하면 이 누적기는 꼬리분만 갖게 되고, 화면의 가용률·수율이 알리지 않고 작아진다(오류는 나지 않는다).\n   * 재개점을 함께 저장·복원해야 「이어 계산한 값」이 「0부터 계산한 값」과 같아진다.\n   */\n  serialize(): OeeCheckpoint {\n    return {\n      maxMs: this.maxMs,\n      acc: [...this.acc.entries()].map(([moverId, a]) => ({ moverId, ...a }))\n    }\n  }\n\n  /** 재개점에서 되세운다 — 모르는 것은 지어내지 않는다(없으면 빈 누적기다). */\n  restore(cp: OeeCheckpoint | undefined | null): void {\n    this.maxMs = cp?.maxMs ?? 0\n    this.acc = new Map((cp?.acc ?? []).map(({ moverId, ...a }) => [moverId, { ...a }]))\n  }\n\n  /** equipment.status(시간-in-상태) + quality.output(양품/불량) 소비. 다른 eventType 무시. */\n  apply(env: CanonicalEnvelope): void {\n    const t = Date.parse(env.eventTime)\n    if (t > this.maxMs) this.maxMs = t\n    if (env.eventType === 'quality.output') {\n      const q = env.data as { moverId?: string; goodCount?: number; nonconformingCount?: number }\n      if (!q?.moverId) return\n      const a = this.ensure(q.moverId, t)\n      a.goodCount = q.goodCount ?? a.goodCount // 누적값 최신화(good/scrap 은 무버 누적)\n      a.nonconformingCount = q.nonconformingCount ?? a.nonconformingCount\n      return\n    }\n    if (env.eventType !== 'equipment.status') return\n    const d = env.data as { moverId?: string; status?: string }\n    if (!d?.moverId) return\n    const a = this.ensure(d.moverId, t)\n    const dt = Math.max(0, t - a.lastMs)\n    if (a.status === 'busy') a.busyMs += dt\n    else if (a.status === 'down') a.downMs += dt\n    a.status = d.status\n    a.lastMs = t\n  }\n\n  /** 무버 OEE 카운터 — 마지막 상태 구간을 nowMs(기본=최신 이벤트 시각)까지 flush. busy→run 근사, setup=0. */\n  counters(moverId: string, nowMs: number = this.maxMs): OeeCounters {\n    const a = this.acc.get(moverId)\n    /*\n     * **이 설비의 이벤트를 하나도 못 봤다** — 계측 창이 없다는 뜻이고, 그것을 `0` 으로 메우면\n     * \"1970년부터 재고 있었다\" 가 된다. 시각이 밀리초 epoch 이므로 그 값이 곧 지금 시각이 되어,\n     * 화면에 `idleMs 1767226603000`(약 56,000년) 유휴가 섰다. 창을 **말하지 않는다** — 공식이\n     * 없음을 없음으로 다룬다(§computeOee).\n     */\n    if (!a) return { runMs: 0, setupMs: 0, downMs: 0, goodCount: 0, nonconformingCount: 0 }\n    const dt = Math.max(0, nowMs - a.lastMs)\n    let busyMs = a.busyMs\n    let downMs = a.downMs\n    if (a.status === 'busy') busyMs += dt\n    else if (a.status === 'down') downMs += dt\n    /*\n     * 계획 정지 — 계약이 이 칸에 그 뜻을 적어 뒀다(점심 · 예방보전 · 교대). 휴일과 주말이 같은\n     * 갈래다. `metricsSinceMs` 를 당겨서 같은 효과를 내지 않는다: 그 칸은 「언제부터 쟀나」라는\n     * 사실이고, 파생값을 얹으면 실제보다 늦게 재기 시작했다고 말하는 것이 된다.\n     */\n    const holdMs = nonWorkingMsIn(this.calendarFor(moverId), a.startMs, nowMs, this.utcOffsetMinutes)\n    return {\n      runMs: busyMs,\n      setupMs: 0,\n      downMs,\n      goodCount: a.goodCount,\n      nonconformingCount: a.nonconformingCount,\n      metricsSinceMs: a.startMs,\n      ...(holdMs !== undefined ? { holdMs } : {})\n    }\n  }\n\n  /** 공유 공식으로 근사 OEE 산출 — 정확한 OEE 는 실 텔레메트리(option ①). nowMs 기본=최신 이벤트 시각. */\n  oee(moverId: string, nowMs: number = this.maxMs): OeeMetrics {\n    return computeOee(this.counters(moverId, nowMs), nowMs)\n  }\n}\n\n/**\n * live State 를 OEE 로 보강 — projector 미러 State(관측)의 무버에 누적기 OEE(계산)를 채운다.\n * live-모드 publishEntityData 가 buildEntityDeltas 전에 적용 → equipment data(tag) payload 에 oee 포함\n * (sim 은 커널이 채움 — 이로써 live 도 동일 payload 형상). 순수(입력 불변, 얕은 복사).\n */\nexport function withLiveOee<S extends { equipment?: any[] }>(state: S, acc: OeeAccumulator, nowMs?: number): S {\n  if (!state?.equipment) return state\n  return { ...state, equipment: state.equipment.map(m => ({ ...m, oee: acc.oee(m.id, nowMs) })) }\n}\n"]}

package/dist-server/engine/twin-engine.d.ts

@@ -597,8 +597,23 @@ export declare class TwinEngine {
      * `timezone` 을 읽는다. 공간이 말하지 않으면 **테넌트로 내려가지 않는다** — 잘못된 입자로 답하는 것이
      * 모르는 것보다 나쁘다(그때는 커널이 UTC 로 읽고, 그 기본값은 계약에 밝혀져 있다).
      *
-     * 커널은 zero-dep 이라 시간대 데이터베이스를 갖지 않으므로 **분 오프셋**으로 풀어 넘긴다. 그 값은
-     * 지금 계절의 것이다(일광절약시간) — 계절을 넘는 긴 예측은 한 시간 어긋난다(계약에 명시).
+     * 커널은 zero-dep 이라 시간대 데이터베이스를 갖지 않으므로 **분 오프셋**으로 풀어 넘긴다.
+     *
+     * ── 이름도 함께 얹는다 (2026-09-07) ────────────────────────────────────────
+     * 오프셋 하나만 얹으면 **그 값이 이 순간의 것으로 모델에 굳는다.** 트윈은 몇 주씩 돌고, 자료에
+     * 이미 `America/Tijuana`(PST −480 / PDT −420)가 있다 — 여름에 뜬 트윈이 11월까지 돌면 그 뒤 모든
+     * 시각이 한 시간 틀린다.
+     *
+     * 지난 구간을 접을 때가 더 나쁘다. 1년치를 교대별로 접으면 그 1년을 한 오프셋으로 읽는데 그 안에
+     * 전환이 두 번 있다. 어긋난 시각이 오류를 내지 않고 **다른 교대로 세어진다.**
+     *
+     * 그래서 이름(`timezone`)을 함께 얹어, 순간마다 다시 풀 수 있게 한다. 커널은 이 값을 쓰지 않는다 —
+     * 여전히 오프셋을 호출마다 받는다. 푸는 것은 호스트의 몫이고 그것이 계약이 적어 둔 분담이다.
+     *
+     * `utcOffsetMinutes` 도 계속 얹는다. 아직 이름을 안 보는 소비처가 그 값으로 돌고, 이름이 없는 공간에
+     * 대해서는 그것이 유일한 답이다.
+     *
+     * ⚠ 이것으로도 완전하지 않다. 정확한 답은 호스트가 표준대로 **절대 구간**을 계산해 넣는 것이다.
      */
     static withSpaceTimeBase(model: TwinModelDef, domainId: string, spaceId?: string): Promise<TwinModelDef>;
     static startLive(id: string, domainId: string, kind: string, model: TwinModelDef): InstanceRuntime;
@@ -1181,6 +1196,28 @@ export declare class TwinEngine {
      */
     static modeOf(domainId: string, id: string): 'live' | 'sim' | undefined;
     static owns(domainId: string, id: string): boolean;
+    /**
+     * 이 트윈의 **중복 판정 기억을 미리 채운다** — 저널에서 읽은 정체로.
+     *
+     * 기억은 프로세스 안에만 있어서 재기동하면 비워진다(§`FactDeduper`). 그 뒤 backfill 을 돌리면
+     * 이미 저널에 있는 사실도 「처음 본 것」이 되어 다시 앉는다. 실측으로 39건이 통째로 다시 앉았다
+     * (2026-09-06, `mes-line-a`).
+     *
+     * 안 도는 트윈에는 채울 곳이 없다 — 0을 낸다(거짓이 아니라 사실이다).
+     */
+    static warmDeduper(domainId: string, id: string, identities: readonly string[]): number;
+    /**
+     * 이 프로세스가 지금 들고 있는 트윈들 — 테넌트로 좁혀서.
+     *
+     * 주기 작업(규칙 판정 등)이 「무엇을 돌아야 하나」를 물을 자리다. 등록부(DB)를 읽으면 **다른 프로세스가
+     * 든 트윈까지 나온다** — 그것을 돌면 같은 조치가 두 벌 올라간다. 도는 것은 든 쪽이 돈다.
+     *
+     * `owns()` 와 같은 술어를 쓴다(`this.instances`). 두 벌이면 어긋난다.
+     */
+    static ownedTwins(domainId?: string): {
+        domainId: string;
+        instanceId: string;
+    }[];
     /**
      * 이 트윈이 이 테넌트 것인가 — **떠 있든 아니든.**
      *
@@ -1250,6 +1287,30 @@ export declare class TwinEngine {
         domainId: string;
         instanceId: string;
     }, closed: IngestWindow) => void): void;
+    /**
+     * **모든 트윈의 창을 굴린다** — 보는 사람이 없어도 창이 닫히게.
+     *
+     * ── 무엇이 있었나 (2026-09-05 실측) ────────────────────────────────────────
+     * 창은 「다음 사건이 왔을 때 이전 창을 닫는」 모양으로만 굴렀다. 그러면 사실이 드문 트윈은 창이
+     * 계속 열려 있고, 표에 아무것도 안 남는다. 두 수가 그것을 정확히 말한다.
+     *
+     *   mes-miratek   사실 46건 · 62분에 흩어짐   창  1개
+     *   mes-line-a    사실 11건                   창 48개
+     *
+     * **사실 수와 창 수가 거꾸로다.** 창을 만든 것이 유입이 아니라 **누가 물어본 것**이다 —
+     * `ingestHealthOf()` 가 굴리므로, 점검표·화면이 계속 묻는 트윈만 기록이 쌓였다.
+     *
+     * 그래서 **아무도 안 보는 트윈일수록 기록이 없다.** 사실이 조용히 사라지는 것을 잡으려고 만든
+     * 장부가 정확히 그 반대로 돌고 있었다. 실제로 137봉투가 장부 없이 지나갔다(인티그레이션 레인 실측).
+     *
+     * ── 왜 주기인가 ────────────────────────────────────────────────────────────
+     * 창이 닫히는 이유는 **시간이 지난 것**이다. 사건도 질의도 그것을 알려 주는 신호일 뿐이고, 둘 다
+     * 안 올 수 있다. 시간은 늘 지나므로 주기가 그 사실에 맞는 신호다.
+     *
+     * 조용한 트윈이 자기 침묵을 기록하게 되는 것이 이 변경의 값이다 — `expected-quiet` 판정이 그
+     * 기록 위에 선다.
+     */
+    static rollAllIngestWindows(nowMs?: number): number;
     /**
      * 한 번의 인제스트 결과를 장부에 적는다.
      *
@@ -1296,7 +1357,15 @@ export declare class TwinEngine {
      *
      * 「통과」로 세지 않는다 — 트윈이 멈춘 사이 사실이 사라지는데 화면이 100% 라고 말하게 된다.
      */
-    undelivered?: number): void;
+    undelivered?: number, 
+    /**
+     * **저널에 안 간 어휘 요소의 수** — 로트 번호·소비기한처럼 시각축이 없는 값.
+     *
+     * 사라진 것이 아니라 저널로 가지 않는 것이다. 그런데 그 수를 빼 주는 자리가 없으면
+     * 「보낸 것 − 앉은 것」이 안 맞고 **그 차이를 사라진 것으로 읽게 된다**(2026-09-05 실측:
+     * 커서 20 · 저널 17 · 어휘 1 을 사람이 손으로 세서 「둘이 빈다」를 찾았다).
+     */
+    vocabulary?: number): void;
     /**
      * **원본에 닿지 못했다**를 적는다 — 「받은 것이 없다」와 가른다(§`recordReadFailure`).
      *

package/dist-server/engine/twin-engine.js

@@ -1539,8 +1539,23 @@ class TwinEngine {
      * `timezone` 을 읽는다. 공간이 말하지 않으면 **테넌트로 내려가지 않는다** — 잘못된 입자로 답하는 것이
      * 모르는 것보다 나쁘다(그때는 커널이 UTC 로 읽고, 그 기본값은 계약에 밝혀져 있다).
      *
-     * 커널은 zero-dep 이라 시간대 데이터베이스를 갖지 않으므로 **분 오프셋**으로 풀어 넘긴다. 그 값은
-     * 지금 계절의 것이다(일광절약시간) — 계절을 넘는 긴 예측은 한 시간 어긋난다(계약에 명시).
+     * 커널은 zero-dep 이라 시간대 데이터베이스를 갖지 않으므로 **분 오프셋**으로 풀어 넘긴다.
+     *
+     * ── 이름도 함께 얹는다 (2026-09-07) ────────────────────────────────────────
+     * 오프셋 하나만 얹으면 **그 값이 이 순간의 것으로 모델에 굳는다.** 트윈은 몇 주씩 돌고, 자료에
+     * 이미 `America/Tijuana`(PST −480 / PDT −420)가 있다 — 여름에 뜬 트윈이 11월까지 돌면 그 뒤 모든
+     * 시각이 한 시간 틀린다.
+     *
+     * 지난 구간을 접을 때가 더 나쁘다. 1년치를 교대별로 접으면 그 1년을 한 오프셋으로 읽는데 그 안에
+     * 전환이 두 번 있다. 어긋난 시각이 오류를 내지 않고 **다른 교대로 세어진다.**
+     *
+     * 그래서 이름(`timezone`)을 함께 얹어, 순간마다 다시 풀 수 있게 한다. 커널은 이 값을 쓰지 않는다 —
+     * 여전히 오프셋을 호출마다 받는다. 푸는 것은 호스트의 몫이고 그것이 계약이 적어 둔 분담이다.
+     *
+     * `utcOffsetMinutes` 도 계속 얹는다. 아직 이름을 안 보는 소비처가 그 값으로 돌고, 이름이 없는 공간에
+     * 대해서는 그것이 유일한 답이다.
+     *
+     * ⚠ 이것으로도 완전하지 않다. 정확한 답은 호스트가 표준대로 **절대 구간**을 계산해 넣는 것이다.
      */
     static async withSpaceTimeBase(model, domainId, spaceId) {
         const sid = spaceId ?? model?.spaceId;
@@ -1553,7 +1568,8 @@ class TwinEngine {
                 (0, log_js_1.twinWarn)(`[twin-engine] space "${sid}" declares time zone "${space.timezone}" but it is not a known IANA zone — times will be read as UTC.`);
             return model;
         }
-        return { ...model, utcOffsetMinutes: offset };
+        /* 이름이 IANA 로 읽히는 것을 위에서 이미 확인했다 — 오프셋이 나왔다는 것이 그 증거다. */
+        return { ...model, utcOffsetMinutes: offset, timezone: space.timezone };
     }
     static startLive(id, domainId, kind, model) {
         const key = (0, runtime_key_js_1.runtimeKey)(domainId, id);
@@ -1570,7 +1586,13 @@ class TwinEngine {
         /* `projector` 필드는 옛 이름으로 남긴다 — 소비처가 `snapshot()` 을 부르므로 얇은 어댑터로 잇는다.
          * (P3 에서 소비처를 커널 어휘로 바꾸면 사라진다.) */
         const projector = { apply: (e) => kernel.apply(e), snapshot: () => kernel.getSnapshot() };
-        const inst = { id, domainId, mode: 'live', restartPolicy: 'resync', kernel, projector, oee: new oee_accumulator_js_1.OeeAccumulator(), spaceId: model?.spaceId, model, unsub: () => { } };
+        const oeeAcc = new oee_accumulator_js_1.OeeAccumulator();
+        /*
+         * **현장의 조업 달력을 얹는다** — 이것을 안 부르면 계획 조업 시간이 창 전체가 된다(§`OeeAccumulator`).
+         * 자리를 만들고 부르지 않는 것이 이 저장소에서 가장 자주 나는 결함이라, 세우는 자리에서 바로 붙인다.
+         */
+        oeeAcc.setWorkCalendar(model);
+        const inst = { id, domainId, mode: 'live', restartPolicy: 'resync', kernel, projector, oee: oeeAcc, spaceId: model?.spaceId, model, unsub: () => { } };
         /*
          * ── 커널이 **판정으로 낸 사실**도 저널에 남는다 (2026-08-14 실측으로 잡음) ────
          *
@@ -3581,6 +3603,12 @@ class TwinEngine {
          * 가동 이력이 나온다(그 뒤에 일어난 고장이 과거 화면에 섞이지 않는다).
          */
         const oee = new oee_accumulator_js_1.OeeAccumulator();
+        /*
+         * 히스토리도 같은 달력으로 읽는다 — 라이브와 다른 기준으로 세면 두 화면이 다른 수를 보인다.
+         * 여기서 쓸 모델은 `newest` 다(이 스코프의 마지막 구조). 구간마다의 `model` 은 위 루프 안에만
+         * 있고, 달력은 구조 개정마다 갈리는 값이 아니다.
+         */
+        oee.setWorkCalendar(newest);
         /* 재개점이 있으면 그 위에 꼬리만 얹는다 — 없으면 꼬리분만 세어 가용률이 알리지 않고 작아진다. */
         if (resume?.fold?.oee)
             oee.restore(resume.fold.oee);
@@ -3941,6 +3969,34 @@ class TwinEngine {
     static owns(domainId, id) {
         return !!this.instances[(0, runtime_key_js_1.runtimeKey)(domainId, id)];
     }
+    /**
+     * 이 트윈의 **중복 판정 기억을 미리 채운다** — 저널에서 읽은 정체로.
+     *
+     * 기억은 프로세스 안에만 있어서 재기동하면 비워진다(§`FactDeduper`). 그 뒤 backfill 을 돌리면
+     * 이미 저널에 있는 사실도 「처음 본 것」이 되어 다시 앉는다. 실측으로 39건이 통째로 다시 앉았다
+     * (2026-09-06, `mes-line-a`).
+     *
+     * 안 도는 트윈에는 채울 곳이 없다 — 0을 낸다(거짓이 아니라 사실이다).
+     */
+    static warmDeduper(domainId, id, identities) {
+        const inst = this.instances[(0, runtime_key_js_1.runtimeKey)(domainId, id)];
+        if (!inst || !identities.length)
+            return 0;
+        return (inst.deduper ??= new ingest_dedupe_js_1.FactDeduper()).remember(identities);
+    }
+    /**
+     * 이 프로세스가 지금 들고 있는 트윈들 — 테넌트로 좁혀서.
+     *
+     * 주기 작업(규칙 판정 등)이 「무엇을 돌아야 하나」를 물을 자리다. 등록부(DB)를 읽으면 **다른 프로세스가
+     * 든 트윈까지 나온다** — 그것을 돌면 같은 조치가 두 벌 올라간다. 도는 것은 든 쪽이 돈다.
+     *
+     * `owns()` 와 같은 술어를 쓴다(`this.instances`). 두 벌이면 어긋난다.
+     */
+    static ownedTwins(domainId) {
+        return Object.entries(this.instances)
+            .map(([key, inst]) => ({ domainId: inst.domainId, instanceId: (0, runtime_key_js_1.parseRuntimeKey)(key).instanceId }))
+            .filter(t => !domainId || t.domainId === domainId);
+    }
     /**
      * 이 트윈이 이 테넌트 것인가 — **떠 있든 아니든.**
      *
@@ -4098,6 +4154,53 @@ class TwinEngine {
     static onIngestWindowClosed(fn) {
         this.onWindowClosed = fn;
     }
+    /**
+     * **모든 트윈의 창을 굴린다** — 보는 사람이 없어도 창이 닫히게.
+     *
+     * ── 무엇이 있었나 (2026-09-05 실측) ────────────────────────────────────────
+     * 창은 「다음 사건이 왔을 때 이전 창을 닫는」 모양으로만 굴렀다. 그러면 사실이 드문 트윈은 창이
+     * 계속 열려 있고, 표에 아무것도 안 남는다. 두 수가 그것을 정확히 말한다.
+     *
+     *   mes-miratek   사실 46건 · 62분에 흩어짐   창  1개
+     *   mes-line-a    사실 11건                   창 48개
+     *
+     * **사실 수와 창 수가 거꾸로다.** 창을 만든 것이 유입이 아니라 **누가 물어본 것**이다 —
+     * `ingestHealthOf()` 가 굴리므로, 점검표·화면이 계속 묻는 트윈만 기록이 쌓였다.
+     *
+     * 그래서 **아무도 안 보는 트윈일수록 기록이 없다.** 사실이 조용히 사라지는 것을 잡으려고 만든
+     * 장부가 정확히 그 반대로 돌고 있었다. 실제로 137봉투가 장부 없이 지나갔다(인티그레이션 레인 실측).
+     *
+     * ── 왜 주기인가 ────────────────────────────────────────────────────────────
+     * 창이 닫히는 이유는 **시간이 지난 것**이다. 사건도 질의도 그것을 알려 주는 신호일 뿐이고, 둘 다
+     * 안 올 수 있다. 시간은 늘 지나므로 주기가 그 사실에 맞는 신호다.
+     *
+     * 조용한 트윈이 자기 침묵을 기록하게 되는 것이 이 변경의 값이다 — `expected-quiet` 판정이 그
+     * 기록 위에 선다.
+     */
+    static rollAllIngestWindows(nowMs = Date.now()) {
+        let closed = 0;
+        for (const key of Object.keys(this.ingestLedgers)) {
+            const ledger = this.ingestLedgers[key];
+            if (!ledger)
+                continue;
+            /*
+             * 키가 깨져 있으면 그 트윈만 건너뛴다 — 하나 때문에 나머지 장부가 안 굴러서는 안 된다.
+             * 훅의 실패도 `rollIngestWindow` 가 감싼다(영속을 지키려고 관측을 멈추지 않는다).
+             */
+            let at;
+            try {
+                at = (0, runtime_key_js_1.parseRuntimeKey)(key);
+            }
+            catch {
+                continue;
+            }
+            (0, ingest_health_js_1.rollIngestWindow)(ledger, nowMs, undefined, w => {
+                closed++;
+                this.onWindowClosed?.(at, w);
+            });
+        }
+        return closed;
+    }
     /**
      * 한 번의 인제스트 결과를 장부에 적는다.
      *
@@ -4155,10 +4258,20 @@ class TwinEngine {
      *
      * 「통과」로 세지 않는다 — 트윈이 멈춘 사이 사실이 사라지는데 화면이 100% 라고 말하게 된다.
      */
-    undelivered = 0) {
+    undelivered = 0, 
+    /**
+     * **저널에 안 간 어휘 요소의 수** — 로트 번호·소비기한처럼 시각축이 없는 값.
+     *
+     * 사라진 것이 아니라 저널로 가지 않는 것이다. 그런데 그 수를 빼 주는 자리가 없으면
+     * 「보낸 것 − 앉은 것」이 안 맞고 **그 차이를 사라진 것으로 읽게 된다**(2026-09-05 실측:
+     * 커서 20 · 저널 17 · 어휘 1 을 사람이 손으로 세서 「둘이 빈다」를 찾았다).
+     */
+    vocabulary = 0) {
         const key = (0, runtime_key_js_1.runtimeKey)(domainId, instanceId);
         const ledger = this.ingestLedgers[key] ?? (this.ingestLedgers[key] = (0, ingest_health_js_1.newIngestLedger)());
         (0, ingest_health_js_1.recordIngest)(ledger, offered, rejected, nowMs, closed => this.onWindowClosed?.({ domainId, instanceId }, closed), undelivered);
+        /* 창을 이미 굴린 뒤라 순서가 중요하다 — 먼저 적으면 한 유입이 두 창에 걸친다. */
+        (0, ingest_health_js_1.recordVocabulary)(ledger, vocabulary);
     }
     /**
      * **원본에 닿지 못했다**를 적는다 — 「받은 것이 없다」와 가른다(§`recordReadFailure`).