@things-factory/board-import 10.0.0-beta.64

package/server/service/types/registry.ts

@@ -0,0 +1,186 @@
+import type { EntityKind, UniversalEntity } from './index'
+
+/**
+ * Universal Component Category — 도메인 비종속 분류 체계.
+ * 코어가 정의하며, 모든 앱이 공유. 새 카테고리 추가는 코어 변경 필요.
+ *
+ * 도메인 type ('Stocker', 'AGV') 과 별개로, 모든 컴포넌트는 카테고리에 속함.
+ * AI 추론 / 기본 3D Preset / Cross-app 호환성의 기반.
+ */
+export type ComponentCategory =
+  | 'container'   // Stocker, Buffer, Shelf, Rack — 정적 보관소
+  | 'vehicle'     // AGV, OHT, Forklift, AMR — 이동체
+  | 'path'        // Conveyor, AGVLine, OHTLine — 이동 경로
+  | 'region'      // Zone, Area, Floor — 영역
+  | 'equipment'   // Machine, Workstation, Robot — 작업 설비
+  | 'io'          // Port, Dock, Gate — 입출력 지점
+  | 'marker'      // Label, Sign, Gauge — 표시·계측
+  | 'structure'   // Wall, Pillar, Door — 건축 구조
+  | 'unknown'     // 분류 미상 (GenericObject 로 변환됨)
+
+/**
+ * ImportRule — 앱이 등록하는 매핑 규칙.
+ * 한 entity 가 어떤 컴포넌트 type 으로 변환될지 결정.
+ */
+export interface ImportRule {
+  /** 결과 컴포넌트 type (예: 'Stocker', 'AGV', 'Conveyor') */
+  componentType: string
+
+  /**
+   * Universal Category. 권장값. 누락 시 'unknown'.
+   * AI 추론 / 기본 3D preset 폴백의 기반.
+   */
+  category?: ComponentCategory
+
+  /** 매칭 조건 — 하나라도 해당되면 매칭. 모두 비어있으면 항상 매칭 안 됨. */
+  match: ImportMatcher
+
+  /** 결과 변환 정책 */
+  build: ImportBuildSpec
+
+  /** 충돌 시 우선순위 (높을수록 먼저). 기본 0 */
+  priority?: number
+}
+
+export interface ImportMatcher {
+  /** CAD (DXF/SVG) 매칭 */
+  cad?: {
+    /** INSERT 블록 이름 패턴 */
+    blockNamePattern?: RegExp
+    /** 레이어 이름 (정확 일치 또는 정규식) */
+    layer?: string | RegExp
+    /** entity 종류 화이트리스트 */
+    entityKinds?: EntityKind[]
+    /** 인접 텍스트 패턴 (라벨 매칭) */
+    textAdjacent?: RegExp
+  }
+
+  /** IFC 매칭 */
+  ifc?: {
+    /** IFC 클래스명 (예: 'IfcStockerStorage', 또는 정규식) */
+    ifcClass?: string | RegExp
+    /** PropertySet 의 특정 속성 */
+    propertySet?: { name: string; value?: any }
+  }
+
+  /** 이미지(VLM) 매칭 — VLM 응답의 라벨 후보 */
+  image?: {
+    labels: string[]
+  }
+
+  /** 모양/크기 기반 매칭 (모든 형식 공통) */
+  geometry?: {
+    shape?: 'rect' | 'circle' | 'polyline' | 'polygon'
+    sizeRange?: { minArea?: number; maxArea?: number }
+    aspectRatio?: { min?: number; max?: number }
+  }
+}
+
+export interface ImportBuildSpec {
+  /** 컴포넌트 기본 상태 */
+  defaultState?: Record<string, any>
+  /** ID 부여 전략 */
+  idStrategy?: IdStrategy
+  /** 사용자 정의 변환 (있으면 우선) */
+  transform?: (entity: UniversalEntity, draft: ComponentDraft) => ComponentDraft
+}
+
+export type IdStrategy =
+  | 'fromAttribute' // attribs.name 사용
+  | 'fromAdjacentText' // 인접 텍스트 라벨
+  | 'fromIfcGlobalId'
+  | 'auto' // 'TYPE_001' 자동 생성
+  | { custom: (entity: UniversalEntity) => string }
+
+/**
+ * Stage 2/3 의 중간 결과. 보드 모델 컴포넌트로 변환되기 직전 상태.
+ */
+export interface ComponentDraft {
+  /** Universal category. 항상 채워짐 (rule 누락 시 'unknown') */
+  category: ComponentCategory
+  /** 도메인 type. 'unknown' 카테고리면 'GenericObject' */
+  type: string
+  id?: string
+  state: Record<string, any>
+  /** 매칭된 ImportRule (디버깅/검수용). 'unknown' 이면 undefined */
+  matchedBy?: ImportRule
+  /** 원본 entity (재참조 / 매핑 검토용 / 변환 시 단서) */
+  source?: UniversalEntity
+}
+
+/**
+ * 3D Preset — 컴포넌트 type 또는 카테고리에 대한 3D 기본 표현.
+ *
+ * 매칭 우선순위:
+ *   1) componentType 정확 일치
+ *   2) componentType 없으면 category 폴백
+ *   3) 둘 다 없으면 코어 기본 'unknown' preset
+ */
+export interface ThreeDPreset {
+  /** 정확 매칭용 도메인 type. category 와 둘 중 하나는 필수. */
+  componentType?: string
+  /** 카테고리 단위 폴백 매칭 */
+  category?: ComponentCategory
+  geometry: ThreeDGeometry
+  material?: ThreeDMaterial
+  /** bbox 기준점 — bottom: 바닥 닿음, center: 중심 */
+  origin?: 'bottom' | 'center'
+  /** 후처리 훅 */
+  postProcess?: (componentState: Record<string, any>) => void
+}
+
+export type ThreeDGeometry =
+  | { kind: 'box'; height: number }
+  | { kind: 'cylinder'; height: number; radius: number }
+  | { kind: 'gltf'; url: string; scale?: number }
+  | { kind: 'extrude'; depth: number; bevel?: boolean }
+
+export interface ThreeDMaterial {
+  color?: string
+  roughness?: number
+  metalness?: number
+  texture?: string
+  opacity?: number
+}
+
+/**
+ * Subscription Rule — 컴포넌트 type ↔ 데이터 소스 태그 매핑.
+ */
+export interface SubscriptionRule {
+  componentType: string
+  /** 데이터 소스 태그 (예: 'MCS_LV_VEHICLE') */
+  tag: string
+  /** 응답 record 의 ID 필드 (default 'NAME') */
+  idField?: string
+  /** 추가 필드 매핑 (서버 필드 → 컴포넌트 상태) */
+  fieldMappings?: Record<string, string>
+}
+
+/**
+ * 매핑 결과 — Stage 2 의 출력.
+ *
+ * 모든 entity 가 ComponentDraft 가 됨:
+ *  - 매칭 성공: 도메인 type (e.g. 'Stocker', category='container')
+ *  - 매칭 실패: 'GenericObject' (category='unknown') — 좌표/원본 attribs 보존
+ *
+ * 사용자가 'GenericObject' 를 사후에 도메인 type 으로 변환 가능 (`convertGenericTo`).
+ */
+export interface MappingResult {
+  /** 모든 컴포넌트 draft (도메인 + GenericObject) */
+  components: ComponentDraft[]
+  /** 매핑 통계 */
+  stats: {
+    total: number
+    matched: number   // 도메인 type 으로 분류
+    generic: number   // GenericObject 로 폴백
+    skipped: number   // 무시 (예: 레이어 제외 등)
+  }
+  /** 경고 / 충돌 정보 */
+  warnings: MappingWarning[]
+}
+
+export interface MappingWarning {
+  level: 'info' | 'warn' | 'error'
+  entity?: UniversalEntity
+  message: string
+}

package/things-factory.config.js

@@ -0,0 +1 @@
+export default {}

package/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../tsconfig-base.json",
+  "compilerOptions": {
+    "outDir": "./dist-server",
+    "baseUrl": "./"
+  },
+  "include": ["./server/**/*"],
+  "exclude": ["**/*.spec.ts", "**/*.test.ts"]
+}