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

package/dist-server/service/import-session/import-worker.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runImportJob = runImportJob;
+/**
+ * Background worker — ImportSession 처리.
+ *
+ * 흐름:
+ *   1) ImportSession 로드 (status: queued)
+ *   2) Attachment 본문 읽기 (attachment-base STORAGE.readFile)
+ *   3) importBoard() 실행 (단계별로 status/progress 갱신)
+ *   4) result 저장 + status='completed'
+ *   5) 실패 시 status='failed' + message
+ *
+ * 단일 프로세스 내 setImmediate 기반. 추후 외부 큐(Redis/BullMQ) 로 이전 가능.
+ */
+const shell_1 = require("@things-factory/shell");
+const attachment_base_1 = require("@things-factory/attachment-base");
+const attachment_base_2 = require("@things-factory/attachment-base");
+const index_1 = require("../pipeline/index");
+const import_session_1 = require("./import-session");
+async function runImportJob(sessionId) {
+    const repo = (0, shell_1.getRepository)(import_session_1.ImportSession);
+    const session = await repo.findOneBy({ id: sessionId });
+    if (!session) {
+        console.error(`[board-import] ImportSession ${sessionId} not found`);
+        return;
+    }
+    try {
+        await update(repo, sessionId, { status: 'parsing', progress: 5, message: 'Reading attachment' });
+        const attachment = await (0, shell_1.getRepository)(attachment_base_1.Attachment).findOneBy({ id: session.attachmentId });
+        if (!attachment) {
+            throw new Error(`Attachment ${session.attachmentId} not found`);
+        }
+        // attachment-base STORAGE.readFile 으로 본문 로드 (Buffer).
+        // file storage 는 sync, db/s3/azure 는 async — await 으로 양쪽 다 흡수.
+        const fileBuffer = (await attachment_base_2.STORAGE.readFile(attachment.path, null));
+        await update(repo, sessionId, { status: 'parsing', progress: 20, message: 'Parsing drawing' });
+        const opts = session.options || {};
+        const filename = attachment.name || attachment.path;
+        // importBoard 는 내부에서 stage 1~4 모두 수행. 단계별 progress 는 우선 거시적 업데이트.
+        await update(repo, sessionId, { status: 'mapping', progress: 50, message: 'Mapping entities' });
+        // userPrompt 는 parseOptions 로 합류 — image-adapter 가 VLM 프롬프트에 사용.
+        // 다른 adapter (DXF) 에는 무해 (몰라도 무시).
+        const mergedParseOptions = {
+            ...(opts.parseOptions || {}),
+            ...(opts.userPrompt ? { userPrompt: opts.userPrompt } : {})
+        };
+        // AI 가 같은 도면을 다른 관점으로 해석한 multi-variant. parse 한 번, 시안별 mapping + assemble.
+        // DXF 등 single-variant adapter 는 1 boardModel 만.
+        const result = await (0, index_1.importBoardVariants)({
+            file: fileBuffer,
+            filename,
+            scopes: opts.scopes,
+            normalizeOrigin: opts.normalizeOrigin,
+            flipY: opts.flipY,
+            scale: opts.scale,
+            applyBinding: opts.applyBinding,
+            parseOptions: mergedParseOptions
+        });
+        await update(repo, sessionId, { status: 'assembling', progress: 80, message: 'Assembling boards' });
+        // 시안별 카테고리 분포 — 각 variant 의 entities 가 다르므로.
+        const variantsWithStats = result.variants.map((v, i) => {
+            const dist = {};
+            for (const c of v.boardModel.components ?? []) {
+                const k = c.category ?? 'unknown';
+                dist[k] = (dist[k] ?? 0) + 1;
+            }
+            return { variant: v, mapping: result.mappings[i], categoryDistribution: dist };
+        });
+        // default variantId — 첫 variant.
+        const defaultVariantId = result.variants[0]?.id;
+        // resultJson 구조:
+        //   - variants: 풀 시안 데이터 (선택용 — boardModel + subject + importStrategy + stats + categoryDist)
+        //   - boardModel: default variant 의 boardModel (back-compat)
+        //   - defaultVariantId: 첫 variant 의 id
+        //   - metadata: viewType / aiClientId / userPrompt 등 시안 무관 공통
+        const defaultVariant = variantsWithStats[0];
+        const resultJson = JSON.stringify({
+            variants: variantsWithStats.map(({ variant, mapping, categoryDistribution }) => ({
+                id: variant.id,
+                label: variant.label,
+                description: variant.description,
+                subjectName: variant.subjectName,
+                subjectDescription: variant.subjectDescription,
+                importStrategy: variant.importStrategy,
+                boardModel: variant.boardModel,
+                stats: mapping.stats,
+                warnings: mapping.warnings,
+                categoryDistribution
+            })),
+            defaultVariantId,
+            boardModel: defaultVariant?.variant.boardModel,
+            stats: defaultVariant?.mapping.stats,
+            warnings: defaultVariant?.mapping.warnings,
+            metadata: result.parse.metadata,
+            categoryDistribution: defaultVariant?.categoryDistribution
+        });
+        const totalAcross = result.mappings.reduce((s, m) => s + (m.stats.total ?? 0), 0);
+        await update(repo, sessionId, {
+            status: 'completed',
+            progress: 100,
+            message: `Completed: ${result.variants.length} variants, ${totalAcross} entities total`,
+            totalEntities: defaultVariant?.mapping.stats.total ?? 0,
+            resultJson,
+            completedAt: new Date()
+        });
+    }
+    catch (err) {
+        const message = err?.message ?? String(err);
+        console.error(`[board-import] ImportSession ${sessionId} failed:`, err);
+        await update(repo, sessionId, {
+            status: 'failed',
+            message: `Failed: ${message}`,
+            completedAt: new Date()
+        });
+    }
+}
+async function update(repo, id, patch) {
+    await repo.update(id, patch);
+}
+//# sourceMappingURL=import-worker.js.map

package/dist-server/service/import-session/import-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-worker.js","sourceRoot":"","sources":["../../../server/service/import-session/import-worker.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Background worker — ImportSession 처리.\n *\n * 흐름:\n *   1) ImportSession 로드 (status: queued)\n *   2) Attachment 본문 읽기 (attachment-base STORAGE.readFile)\n *   3) importBoard() 실행 (단계별로 status/progress 갱신)\n *   4) result 저장 + status='completed'\n *   5) 실패 시 status='failed' + message\n *\n * 단일 프로세스 내 setImmediate 기반. 추후 외부 큐(Redis/BullMQ) 로 이전 가능.\n */\nimport { getRepository } from '@things-factory/shell'\n\nimport { Attachment } from '@things-factory/attachment-base'\nimport { STORAGE } from '@things-factory/attachment-base'\n\nimport { importBoardVariants } from '../pipeline/index'\nimport { ImportSession } from './import-session'\n\nexport async function runImportJob(sessionId: string): Promise<void> {\n  const repo = getRepository(ImportSession)\n  const session = await repo.findOneBy({ id: sessionId })\n  if (!session) {\n    console.error(`[board-import] ImportSession ${sessionId} not found`)\n    return\n  }\n\n  try {\n    await update(repo, sessionId, { status: 'parsing', progress: 5, message: 'Reading attachment' })\n\n    const attachment = await getRepository(Attachment).findOneBy({ id: session.attachmentId })\n    if (!attachment) {\n      throw new Error(`Attachment ${session.attachmentId} not found`)\n    }\n\n    // attachment-base STORAGE.readFile 으로 본문 로드 (Buffer).\n    // file storage 는 sync, db/s3/azure 는 async — await 으로 양쪽 다 흡수.\n    const fileBuffer = (await STORAGE.readFile(attachment.path!, null)) as Buffer\n\n    await update(repo, sessionId, { status: 'parsing', progress: 20, message: 'Parsing drawing' })\n\n    const opts = session.options || {}\n    const filename = attachment.name || attachment.path\n\n    // importBoard 는 내부에서 stage 1~4 모두 수행. 단계별 progress 는 우선 거시적 업데이트.\n    await update(repo, sessionId, { status: 'mapping', progress: 50, message: 'Mapping entities' })\n\n    // userPrompt 는 parseOptions 로 합류 — image-adapter 가 VLM 프롬프트에 사용.\n    // 다른 adapter (DXF) 에는 무해 (몰라도 무시).\n    const mergedParseOptions = {\n      ...(opts.parseOptions || {}),\n      ...(opts.userPrompt ? { userPrompt: opts.userPrompt } : {})\n    }\n    // AI 가 같은 도면을 다른 관점으로 해석한 multi-variant. parse 한 번, 시안별 mapping + assemble.\n    // DXF 등 single-variant adapter 는 1 boardModel 만.\n    const result = await importBoardVariants({\n      file: fileBuffer,\n      filename,\n      scopes: opts.scopes,\n      normalizeOrigin: opts.normalizeOrigin,\n      flipY: opts.flipY,\n      scale: opts.scale,\n      applyBinding: opts.applyBinding,\n      parseOptions: mergedParseOptions\n    })\n\n    await update(repo, sessionId, { status: 'assembling', progress: 80, message: 'Assembling boards' })\n\n    // 시안별 카테고리 분포 — 각 variant 의 entities 가 다르므로.\n    const variantsWithStats = result.variants.map((v, i) => {\n      const dist: Record<string, number> = {}\n      for (const c of v.boardModel.components ?? []) {\n        const k = c.category ?? 'unknown'\n        dist[k] = (dist[k] ?? 0) + 1\n      }\n      return { variant: v, mapping: result.mappings[i], categoryDistribution: dist }\n    })\n\n    // default variantId — 첫 variant.\n    const defaultVariantId = result.variants[0]?.id\n\n    // resultJson 구조:\n    //   - variants: 풀 시안 데이터 (선택용 — boardModel + subject + importStrategy + stats + categoryDist)\n    //   - boardModel: default variant 의 boardModel (back-compat)\n    //   - defaultVariantId: 첫 variant 의 id\n    //   - metadata: viewType / aiClientId / userPrompt 등 시안 무관 공통\n    const defaultVariant = variantsWithStats[0]\n    const resultJson = JSON.stringify({\n      variants: variantsWithStats.map(({ variant, mapping, categoryDistribution }) => ({\n        id: variant.id,\n        label: variant.label,\n        description: variant.description,\n        subjectName: variant.subjectName,\n        subjectDescription: variant.subjectDescription,\n        importStrategy: variant.importStrategy,\n        boardModel: variant.boardModel,\n        stats: mapping.stats,\n        warnings: mapping.warnings,\n        categoryDistribution\n      })),\n      defaultVariantId,\n      boardModel: defaultVariant?.variant.boardModel,\n      stats: defaultVariant?.mapping.stats,\n      warnings: defaultVariant?.mapping.warnings,\n      metadata: result.parse.metadata,\n      categoryDistribution: defaultVariant?.categoryDistribution\n    })\n\n    const totalAcross = result.mappings.reduce((s, m) => s + (m.stats.total ?? 0), 0)\n    await update(repo, sessionId, {\n      status: 'completed',\n      progress: 100,\n      message: `Completed: ${result.variants.length} variants, ${totalAcross} entities total`,\n      totalEntities: defaultVariant?.mapping.stats.total ?? 0,\n      resultJson,\n      completedAt: new Date()\n    })\n  } catch (err) {\n    const message = (err as Error)?.message ?? String(err)\n    console.error(`[board-import] ImportSession ${sessionId} failed:`, err)\n    await update(repo, sessionId, {\n      status: 'failed',\n      message: `Failed: ${message}`,\n      completedAt: new Date()\n    })\n  }\n}\n\nasync function update(repo: any, id: string, patch: Partial<ImportSession>): Promise<void> {\n  await repo.update(id, patch as any)\n}\n"]}

package/dist-server/service/import-session/index.d.ts

@@ -0,0 +1,8 @@
+import { ImportSession } from './import-session';
+import { ImportSessionResolver } from './import-session-resolver';
+export { ImportSession, ImportSessionResolver };
+export { runImportJob } from './import-worker';
+export { startImportJobAsync, fetchImportSession, listImportSessionsByChatSession, describeAdapter, type StartImportJobInput, type ImportActionsContext, type SessionRepoLike, type AdapterInfo } from './import-actions';
+export { materializeFromSession, type MaterializeRequest, type MaterializeContext, type MaterializeDeps } from './materialize-from-session';
+export declare const entities: (typeof ImportSession)[];
+export declare const resolverClasses: (typeof ImportSessionResolver)[];

package/dist-server/service/import-session/index.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolverClasses = exports.entities = exports.materializeFromSession = exports.describeAdapter = exports.listImportSessionsByChatSession = exports.fetchImportSession = exports.startImportJobAsync = exports.runImportJob = exports.ImportSessionResolver = exports.ImportSession = void 0;
+const import_session_1 = require("./import-session");
+Object.defineProperty(exports, "ImportSession", { enumerable: true, get: function () { return import_session_1.ImportSession; } });
+const import_session_resolver_1 = require("./import-session-resolver");
+Object.defineProperty(exports, "ImportSessionResolver", { enumerable: true, get: function () { return import_session_resolver_1.ImportSessionResolver; } });
+var import_worker_1 = require("./import-worker");
+Object.defineProperty(exports, "runImportJob", { enumerable: true, get: function () { return import_worker_1.runImportJob; } });
+var import_actions_1 = require("./import-actions");
+Object.defineProperty(exports, "startImportJobAsync", { enumerable: true, get: function () { return import_actions_1.startImportJobAsync; } });
+Object.defineProperty(exports, "fetchImportSession", { enumerable: true, get: function () { return import_actions_1.fetchImportSession; } });
+Object.defineProperty(exports, "listImportSessionsByChatSession", { enumerable: true, get: function () { return import_actions_1.listImportSessionsByChatSession; } });
+Object.defineProperty(exports, "describeAdapter", { enumerable: true, get: function () { return import_actions_1.describeAdapter; } });
+var materialize_from_session_1 = require("./materialize-from-session");
+Object.defineProperty(exports, "materializeFromSession", { enumerable: true, get: function () { return materialize_from_session_1.materializeFromSession; } });
+exports.entities = [import_session_1.ImportSession];
+exports.resolverClasses = [import_session_resolver_1.ImportSessionResolver];
+//# sourceMappingURL=index.js.map

package/dist-server/service/import-session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../server/service/import-session/index.ts"],"names":[],"mappings":";;;AAAA,qDAAgD;AAGvC,8FAHA,8BAAa,OAGA;AAFtB,uEAAiE;AAEzC,sGAFf,+CAAqB,OAEe;AAC7C,iDAA8C;AAArC,6GAAA,YAAY,OAAA;AACrB,mDASyB;AARvB,qHAAA,mBAAmB,OAAA;AACnB,oHAAA,kBAAkB,OAAA;AAClB,iIAAA,+BAA+B,OAAA;AAC/B,iHAAA,eAAe,OAAA;AAMjB,uEAKmC;AAJjC,kIAAA,sBAAsB,OAAA;AAMX,QAAA,QAAQ,GAAG,CAAC,8BAAa,CAAC,CAAA;AAC1B,QAAA,eAAe,GAAG,CAAC,+CAAqB,CAAC,CAAA","sourcesContent":["import { ImportSession } from './import-session'\nimport { ImportSessionResolver } from './import-session-resolver'\n\nexport { ImportSession, ImportSessionResolver }\nexport { runImportJob } from './import-worker'\nexport {\n  startImportJobAsync,\n  fetchImportSession,\n  listImportSessionsByChatSession,\n  describeAdapter,\n  type StartImportJobInput,\n  type ImportActionsContext,\n  type SessionRepoLike,\n  type AdapterInfo\n} from './import-actions'\nexport {\n  materializeFromSession,\n  type MaterializeRequest,\n  type MaterializeContext,\n  type MaterializeDeps\n} from './materialize-from-session'\n\nexport const entities = [ImportSession]\nexport const resolverClasses = [ImportSessionResolver]\n"]}

package/dist-server/service/import-session/materialize-from-session.d.ts

@@ -0,0 +1,66 @@
+/**
+ * materializeFromSession — ImportSession.result.boardModel → 신규 Board 영속화의 **순수 비즈니스
+ * 로직**. typeorm `getRepository` / `ResolverContext` 같은 외부 의존성을 인자로 분리해서 단위
+ * 테스트 가능하도록 구성. resolver 측 mutation 은 IO (repo, ctx) 만 wiring 해서 이 함수를 호출.
+ *
+ * 호출 책임:
+ *   - resolver: getRepository / context.state 에서 도메인/유저 추출
+ *   - 이 함수: 검증 → 정책 적용 → save 호출 → 결과 반환
+ *
+ * 정책:
+ *   - ImportSession.status 가 'completed' 가 아니면 거절
+ *   - result.boardModel 이 없으면 거절
+ *   - Board.name 이 같은 도메인에 이미 있으면 거절 (createBoard 와 동일 정책)
+ *   - 새 보드는 sortOrder = (현재 최소 sortOrder - 1) 또는 0 (createBoard 와 동일 정책)
+ *   - state='draft', sourceImportSessionId=session.id, model=JSON.stringify(boardModel)
+ */
+export interface MaterializeRequest {
+    sessionId: string;
+    name: string;
+    description?: string;
+    groupId?: string;
+    type?: 'main' | 'sub' | 'popup';
+    thumbnail?: string;
+    /** 사용자가 선택한 시안 id. 미지정 시 session.result.defaultVariantId 또는 첫 variant. */
+    variantId?: string;
+}
+export interface SessionLike {
+    id: string;
+    status: string;
+    result?: {
+        boardModel?: any;
+        variants?: Array<{
+            id: string;
+            boardModel: any;
+        }>;
+        defaultVariantId?: string;
+    } | null;
+}
+export interface BoardRepoLike {
+    findOneBy(criteria: any): Promise<any | null>;
+    save(entity: any): Promise<any>;
+    /** sortOrder 결정용 — 미존재 시 0 으로 fallback. */
+    createQueryBuilder?(alias: string): {
+        select(expr: string, alias: string): any;
+        where(cond: string, params: any): any;
+        getRawOne(): Promise<any>;
+    };
+}
+export interface GroupRepoLike {
+    findOneBy(criteria: any): Promise<any | null>;
+}
+export interface MaterializeContext {
+    domain: {
+        id: string;
+        [k: string]: any;
+    };
+    user: any;
+}
+export interface MaterializeDeps {
+    boardRepo: BoardRepoLike;
+    groupRepo: GroupRepoLike;
+}
+/**
+ * ImportSession 결과를 새 Board 로 저장. 검증 실패 시 throw, 성공 시 저장된 Board 반환.
+ */
+export declare function materializeFromSession(session: SessionLike | null, input: MaterializeRequest, context: MaterializeContext, deps: MaterializeDeps): Promise<any>;

package/dist-server/service/import-session/materialize-from-session.js

@@ -0,0 +1,104 @@
+"use strict";
+/**
+ * materializeFromSession — ImportSession.result.boardModel → 신규 Board 영속화의 **순수 비즈니스
+ * 로직**. typeorm `getRepository` / `ResolverContext` 같은 외부 의존성을 인자로 분리해서 단위
+ * 테스트 가능하도록 구성. resolver 측 mutation 은 IO (repo, ctx) 만 wiring 해서 이 함수를 호출.
+ *
+ * 호출 책임:
+ *   - resolver: getRepository / context.state 에서 도메인/유저 추출
+ *   - 이 함수: 검증 → 정책 적용 → save 호출 → 결과 반환
+ *
+ * 정책:
+ *   - ImportSession.status 가 'completed' 가 아니면 거절
+ *   - result.boardModel 이 없으면 거절
+ *   - Board.name 이 같은 도메인에 이미 있으면 거절 (createBoard 와 동일 정책)
+ *   - 새 보드는 sortOrder = (현재 최소 sortOrder - 1) 또는 0 (createBoard 와 동일 정책)
+ *   - state='draft', sourceImportSessionId=session.id, model=JSON.stringify(boardModel)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.materializeFromSession = materializeFromSession;
+const EMPTY_THUMBNAIL = 'data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==';
+/**
+ * ImportSession 결과를 새 Board 로 저장. 검증 실패 시 throw, 성공 시 저장된 Board 반환.
+ */
+async function materializeFromSession(session, input, context, deps) {
+    if (!session) {
+        throw new Error(`ImportSession ${input.sessionId} not found`);
+    }
+    if (session.status !== 'completed') {
+        throw new Error(`ImportSession ${input.sessionId} is not completed (status=${session.status}); cannot materialize.`);
+    }
+    const boardModel = pickVariantBoardModel(session.result, input.variantId);
+    if (!boardModel) {
+        throw new Error(`ImportSession ${input.sessionId} has no boardModel in result.`);
+    }
+    const existing = await deps.boardRepo.findOneBy({
+        name: input.name,
+        domain: { id: context.domain.id }
+    });
+    if (existing) {
+        throw new Error(`Board name '${input.name}' is already taken`);
+    }
+    const group = input.groupId ? (await deps.groupRepo.findOneBy({ id: input.groupId })) ?? undefined : undefined;
+    const nextSortOrder = await resolveNextSortOrder(deps.boardRepo, context.domain.id);
+    return await deps.boardRepo.save({
+        domain: context.domain,
+        name: input.name,
+        description: input.description,
+        type: input.type ?? 'main',
+        thumbnail: input.thumbnail || EMPTY_THUMBNAIL,
+        model: JSON.stringify(boardModel),
+        sourceImportSessionId: session.id,
+        group,
+        sortOrder: nextSortOrder,
+        state: 'draft',
+        creator: context.user,
+        updater: context.user
+    });
+}
+/**
+ * 시안 (variant) 선택 — 사용자가 명시한 variantId > session.result.defaultVariantId > 첫 variant
+ * > 구버전 호환 (session.result.boardModel).
+ */
+function pickVariantBoardModel(result, variantId) {
+    if (!result)
+        return undefined;
+    const variants = Array.isArray(result.variants) ? result.variants : [];
+    if (variants.length > 0) {
+        if (variantId) {
+            const found = variants.find(v => v.id === variantId);
+            if (found?.boardModel)
+                return found.boardModel;
+        }
+        if (result.defaultVariantId) {
+            const found = variants.find(v => v.id === result.defaultVariantId);
+            if (found?.boardModel)
+                return found.boardModel;
+        }
+        if (variants[0]?.boardModel)
+            return variants[0].boardModel;
+    }
+    // back-compat — 구버전 ImportSession (variants 미존재) 의 단일 boardModel
+    return result.boardModel;
+}
+/**
+ * sortOrder = MIN(sortOrder) - 1, 미존재 시 0. createBoard 의 "맨 앞에 배치" 정책과 동일.
+ * createQueryBuilder 미지원 환경 (예: 단위 테스트의 minimal mock) 에서는 0 fallback.
+ */
+async function resolveNextSortOrder(repo, domainId) {
+    if (!repo.createQueryBuilder)
+        return 0;
+    try {
+        const raw = await repo
+            .createQueryBuilder('board')
+            .select('MIN(board.sortOrder)', 'minSortOrder')
+            .where('board.domain = :domainId', { domainId })
+            .getRawOne();
+        const min = raw?.minSortOrder;
+        return typeof min === 'number' && Number.isFinite(min) ? min - 1 : 0;
+    }
+    catch {
+        return 0;
+    }
+}
+//# sourceMappingURL=materialize-from-session.js.map

package/dist-server/service/import-session/materialize-from-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"materialize-from-session.js","sourceRoot":"","sources":["../../../server/service/import-session/materialize-from-session.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * materializeFromSession — ImportSession.result.boardModel → 신규 Board 영속화의 **순수 비즈니스\n * 로직**. typeorm `getRepository` / `ResolverContext` 같은 외부 의존성을 인자로 분리해서 단위\n * 테스트 가능하도록 구성. resolver 측 mutation 은 IO (repo, ctx) 만 wiring 해서 이 함수를 호출.\n *\n * 호출 책임:\n *   - resolver: getRepository / context.state 에서 도메인/유저 추출\n *   - 이 함수: 검증 → 정책 적용 → save 호출 → 결과 반환\n *\n * 정책:\n *   - ImportSession.status 가 'completed' 가 아니면 거절\n *   - result.boardModel 이 없으면 거절\n *   - Board.name 이 같은 도메인에 이미 있으면 거절 (createBoard 와 동일 정책)\n *   - 새 보드는 sortOrder = (현재 최소 sortOrder - 1) 또는 0 (createBoard 와 동일 정책)\n *   - state='draft', sourceImportSessionId=session.id, model=JSON.stringify(boardModel)\n */\n\nconst EMPTY_THUMBNAIL = 'data:image/gif;base64,R0lGODlhAQABAAAAACH5BAEKAAEALAAAAAABAAEAAAICTAEAOw=='\n\nexport interface MaterializeRequest {\n  sessionId: string\n  name: string\n  description?: string\n  groupId?: string\n  type?: 'main' | 'sub' | 'popup'\n  thumbnail?: string\n  /** 사용자가 선택한 시안 id. 미지정 시 session.result.defaultVariantId 또는 첫 variant. */\n  variantId?: string\n}\n\nexport interface SessionLike {\n  id: string\n  status: string\n  result?: {\n    boardModel?: any\n    variants?: Array<{ id: string; boardModel: any }>\n    defaultVariantId?: string\n  } | null\n}\n\nexport interface BoardRepoLike {\n  findOneBy(criteria: any): Promise<any | null>\n  save(entity: any): Promise<any>\n  /** sortOrder 결정용 — 미존재 시 0 으로 fallback. */\n  createQueryBuilder?(alias: string): {\n    select(expr: string, alias: string): any\n    where(cond: string, params: any): any\n    getRawOne(): Promise<any>\n  }\n}\n\nexport interface GroupRepoLike {\n  findOneBy(criteria: any): Promise<any | null>\n}\n\nexport interface MaterializeContext {\n  domain: { id: string; [k: string]: any }\n  user: any\n}\n\nexport interface MaterializeDeps {\n  boardRepo: BoardRepoLike\n  groupRepo: GroupRepoLike\n}\n\n/**\n * ImportSession 결과를 새 Board 로 저장. 검증 실패 시 throw, 성공 시 저장된 Board 반환.\n */\nexport async function materializeFromSession(\n  session: SessionLike | null,\n  input: MaterializeRequest,\n  context: MaterializeContext,\n  deps: MaterializeDeps\n): Promise<any> {\n  if (!session) {\n    throw new Error(`ImportSession ${input.sessionId} not found`)\n  }\n  if (session.status !== 'completed') {\n    throw new Error(\n      `ImportSession ${input.sessionId} is not completed (status=${session.status}); cannot materialize.`\n    )\n  }\n  const boardModel = pickVariantBoardModel(session.result, input.variantId)\n  if (!boardModel) {\n    throw new Error(`ImportSession ${input.sessionId} has no boardModel in result.`)\n  }\n\n  const existing = await deps.boardRepo.findOneBy({\n    name: input.name,\n    domain: { id: context.domain.id }\n  })\n  if (existing) {\n    throw new Error(`Board name '${input.name}' is already taken`)\n  }\n\n  const group = input.groupId ? (await deps.groupRepo.findOneBy({ id: input.groupId })) ?? undefined : undefined\n\n  const nextSortOrder = await resolveNextSortOrder(deps.boardRepo, context.domain.id)\n\n  return await deps.boardRepo.save({\n    domain: context.domain,\n    name: input.name,\n    description: input.description,\n    type: input.type ?? 'main',\n    thumbnail: input.thumbnail || EMPTY_THUMBNAIL,\n    model: JSON.stringify(boardModel),\n    sourceImportSessionId: session.id,\n    group,\n    sortOrder: nextSortOrder,\n    state: 'draft',\n    creator: context.user,\n    updater: context.user\n  })\n}\n\n/**\n * 시안 (variant) 선택 — 사용자가 명시한 variantId > session.result.defaultVariantId > 첫 variant\n * > 구버전 호환 (session.result.boardModel).\n */\nfunction pickVariantBoardModel(\n  result: SessionLike['result'],\n  variantId?: string\n): any | undefined {\n  if (!result) return undefined\n  const variants = Array.isArray(result.variants) ? result.variants : []\n  if (variants.length > 0) {\n    if (variantId) {\n      const found = variants.find(v => v.id === variantId)\n      if (found?.boardModel) return found.boardModel\n    }\n    if (result.defaultVariantId) {\n      const found = variants.find(v => v.id === result.defaultVariantId)\n      if (found?.boardModel) return found.boardModel\n    }\n    if (variants[0]?.boardModel) return variants[0].boardModel\n  }\n  // back-compat — 구버전 ImportSession (variants 미존재) 의 단일 boardModel\n  return result.boardModel\n}\n\n/**\n * sortOrder = MIN(sortOrder) - 1, 미존재 시 0. createBoard 의 \"맨 앞에 배치\" 정책과 동일.\n * createQueryBuilder 미지원 환경 (예: 단위 테스트의 minimal mock) 에서는 0 fallback.\n */\nasync function resolveNextSortOrder(repo: BoardRepoLike, domainId: string): Promise<number> {\n  if (!repo.createQueryBuilder) return 0\n  try {\n    const raw = await repo\n      .createQueryBuilder('board')\n      .select('MIN(board.sortOrder)', 'minSortOrder')\n      .where('board.domain = :domainId', { domainId })\n      .getRawOne()\n    const min = raw?.minSortOrder\n    return typeof min === 'number' && Number.isFinite(min) ? min - 1 : 0\n  } catch {\n    return 0\n  }\n}\n"]}

package/dist-server/service/import-session/suggest-board-name.d.ts

@@ -0,0 +1,80 @@
+/**
+ * suggestBoardName — ImportSession 으로부터 새 Board 의 후보 이름을 추천한다.
+ *
+ * 정책:
+ *   1) base 후보 우선순위: input.hint → session.options.userPrompt → session.result.metadata.viewTypeReasoning
+ *      → attachment.name stem → 'Imported board'
+ *   2) base 정규화: 확장자 제거, _-. → 공백, 다중 공백 단일화, 50자 절단, trim
+ *   3) 도메인 격리 + 단일 LIKE query: `WHERE domain_id = ? AND (name = base OR name LIKE 'base (%)')`
+ *      한 번에 충돌 후보 다 가져오고 메모리에서 사용 가능한 가장 작은 (n) 결정
+ *   4) 결과: base 가 충돌 없으면 base, 있으면 'base (2)' / 'base (3)' / ...
+ *
+ * materializeFromSession 과 동일한 *RepoLike 패턴 — typeorm 의존성 주입으로 단위테스트 가능.
+ */
+export interface SuggestBoardNameInput {
+    /** ImportSession id — 옵션. 있으면 거기서 hint / attachment 정보 추출. */
+    sessionId?: string;
+    /**
+     * 명시 hint. session 정보보다 우선. 사용자가 wizard 에서 직접 메모를 쳐서 그것 기반 추천을
+     * 받고 싶을 때 사용.
+     */
+    hint?: string;
+}
+export interface SessionForSuggest {
+    id: string;
+    attachmentId?: string;
+    optionsJson?: string | null;
+    resultJson?: string | null;
+}
+export interface AttachmentForSuggest {
+    id: string;
+    name?: string;
+}
+export interface SuggestSessionRepoLike {
+    findOneBy(criteria: any): Promise<SessionForSuggest | null>;
+}
+export interface SuggestAttachmentRepoLike {
+    findOneBy(criteria: any): Promise<AttachmentForSuggest | null>;
+}
+export interface SuggestBoardRepoLike {
+    /**
+     * 도메인 격리된 LIKE 쿼리. find({ where: { name: Like('base%'), domain: { id } } }) 형태로
+     * 호출자가 wiring. typeorm Like operator 노출을 피하기 위해 단순 string 으로 받음.
+     */
+    findExistingNames(opts: {
+        domainId: string;
+        basePrefix: string;
+    }): Promise<string[]>;
+}
+export interface SuggestContext {
+    domain: {
+        id: string;
+        [k: string]: any;
+    };
+}
+export interface SuggestDeps {
+    sessionRepo: SuggestSessionRepoLike;
+    attachmentRepo: SuggestAttachmentRepoLike;
+    boardRepo: SuggestBoardRepoLike;
+}
+export declare function suggestBoardName(input: SuggestBoardNameInput, context: SuggestContext, deps: SuggestDeps): Promise<string>;
+/**
+ * Board 이름 + 설명을 함께 추천. 이름은 짧고 심플 (운영 카드/리스트 표시용),
+ * 설명은 자세히 (사용자 hint + AI importStrategy + 통계 요약).
+ *
+ * 정책:
+ *   - **name**: hint / userPrompt / VLM reasoning / attachment stem 에서 짧은 base 추출 후
+ *     30자 이내로 자르고, 충돌 검사 + (n) suffix
+ *   - **description**: userPrompt + AI importStrategy + (있으면) reasoning + 카테고리 분포
+ *     를 자연어 단락으로 합성. 없으면 빈 문자열
+ */
+export interface SuggestBoardMetaResult {
+    name: string;
+    description: string;
+}
+export declare function suggestBoardMeta(input: SuggestBoardNameInput, context: SuggestContext, deps: SuggestDeps): Promise<SuggestBoardMetaResult>;
+/**
+ * existingNames 안에서 base 가 그대로 비어있으면 base 반환, 아니면 'base (2)', '(3)', ...
+ * case-insensitive 비교 (postgres ilike 호환).
+ */
+export declare function pickAvailableSuffix(base: string, existingNames: string[]): string;

package/dist-server/service/import-session/suggest-board-name.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * suggestBoardName — ImportSession 으로부터 새 Board 의 후보 이름을 추천한다.
+ *
+ * 정책:
+ *   1) base 후보 우선순위: input.hint → session.options.userPrompt → session.result.metadata.viewTypeReasoning
+ *      → attachment.name stem → 'Imported board'
+ *   2) base 정규화: 확장자 제거, _-. → 공백, 다중 공백 단일화, 50자 절단, trim
+ *   3) 도메인 격리 + 단일 LIKE query: `WHERE domain_id = ? AND (name = base OR name LIKE 'base (%)')`
+ *      한 번에 충돌 후보 다 가져오고 메모리에서 사용 가능한 가장 작은 (n) 결정
+ *   4) 결과: base 가 충돌 없으면 base, 있으면 'base (2)' / 'base (3)' / ...
+ *
+ * materializeFromSession 과 동일한 *RepoLike 패턴 — typeorm 의존성 주입으로 단위테스트 가능.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestBoardName = suggestBoardName;
+exports.suggestBoardMeta = suggestBoardMeta;
+exports.pickAvailableSuffix = pickAvailableSuffix;
+const FALLBACK = 'Imported board';
+async function suggestBoardName(input, context, deps) {
+    const base = await resolveBaseName(input, context, deps);
+    const cleaned = sanitize(base) || FALLBACK;
+    const existingNames = await deps.boardRepo.findExistingNames({
+        domainId: context.domain.id,
+        basePrefix: cleaned
+    });
+    return pickAvailableSuffix(cleaned, existingNames);
+}
+async function suggestBoardMeta(input, context, deps) {
+    // 보드 정체성 = AI 가 도면을 보고 식별한 subject. import 처리 메타 (importStrategy /
+    // categoryDist / userPrompt — AI 에게 한 지시) 와는 별 차원이라 영속 데이터에 섞지 않는다.
+    const { subjectName, subjectDescription } = await resolveSubject(input, context, deps);
+    // name: subjectName > input.hint > attachment.name stem > FALLBACK
+    // 사용자가 명시 hint 를 줬으면 그것이 우선 (직접 의도). VLM subjectName 은 그 다음.
+    const baseName = (input.hint && input.hint.trim() && firstSentence(input.hint)) ||
+        subjectName ||
+        (await resolveAttachmentStem(input, context, deps)) ||
+        FALLBACK;
+    const cleanedName = shortenName(sanitize(baseName) || FALLBACK);
+    const existingNames = await deps.boardRepo.findExistingNames({
+        domainId: context.domain.id,
+        basePrefix: cleanedName
+    });
+    const name = pickAvailableSuffix(cleanedName, existingNames);
+    // description: subjectDescription > input.hint (full) > 빈 문자열
+    // AI 가 도면을 본 자세한 묘사가 있으면 그것이 가장 가치 있음.
+    const description = subjectDescription || (input.hint && input.hint.trim()) || '';
+    return { name, description };
+}
+/** AI 가 도면을 보고 식별한 subject (보드 정체성) — VLM 응답의 subjectName / subjectDescription. */
+async function resolveSubject(input, context, deps) {
+    if (!input.sessionId)
+        return {};
+    const session = await deps.sessionRepo.findOneBy({
+        id: input.sessionId,
+        domain: { id: context.domain.id }
+    });
+    if (!session)
+        return {};
+    const result = parseJsonSafe(session.resultJson);
+    const subjectName = typeof result?.metadata?.subjectName === 'string'
+        ? result.metadata.subjectName.trim()
+        : undefined;
+    const subjectDescription = typeof result?.metadata?.subjectDescription === 'string'
+        ? result.metadata.subjectDescription.trim()
+        : undefined;
+    return { subjectName, subjectDescription };
+}
+/** subject 미산출 시 fallback — attachment.name stem 만. */
+async function resolveAttachmentStem(input, context, deps) {
+    if (!input.sessionId)
+        return undefined;
+    const session = await deps.sessionRepo.findOneBy({
+        id: input.sessionId,
+        domain: { id: context.domain.id }
+    });
+    if (!session?.attachmentId)
+        return undefined;
+    const att = await deps.attachmentRepo.findOneBy({
+        id: session.attachmentId,
+        domain: { id: context.domain.id }
+    });
+    return stemOf(att?.name) || undefined;
+}
+/**
+ * 짧은 이름 — 단순 30자 단위로 단어 경계에서 자르기. 너무 길면 그대로 자르되 단어 보존.
+ */
+function shortenName(s) {
+    if (s.length <= 30)
+        return s;
+    // 30자 이내 마지막 공백에서 자르기
+    const truncated = s.slice(0, 30);
+    const lastSpace = truncated.lastIndexOf(' ');
+    if (lastSpace > 10)
+        return truncated.slice(0, lastSpace).trim();
+    return truncated.trim();
+}
+// ── helpers ──────────────────────────────────────────────────────────
+async function resolveBaseName(input, context, deps) {
+    // 1) 명시 hint
+    if (input.hint && input.hint.trim())
+        return firstSentence(input.hint);
+    // 2) session 정보
+    if (input.sessionId) {
+        const session = await deps.sessionRepo.findOneBy({
+            id: input.sessionId,
+            domain: { id: context.domain.id }
+        });
+        if (session) {
+            // 2a) userPrompt 우선
+            const opts = parseJsonSafe(session.optionsJson);
+            const userPrompt = typeof opts?.userPrompt === 'string' ? opts.userPrompt.trim() : '';
+            if (userPrompt)
+                return firstSentence(userPrompt);
+            // 2b) VLM reasoning
+            const result = parseJsonSafe(session.resultJson);
+            const reasoning = typeof result?.boardModel?.importMeta?.viewTypeReasoning === 'string'
+                ? result.boardModel.importMeta.viewTypeReasoning.trim()
+                : typeof result?.metadata?.viewTypeReasoning === 'string'
+                    ? result.metadata.viewTypeReasoning.trim()
+                    : '';
+            if (reasoning)
+                return firstSentence(reasoning);
+            // 2c) attachment name stem
+            if (session.attachmentId) {
+                const att = await deps.attachmentRepo.findOneBy({
+                    id: session.attachmentId,
+                    domain: { id: context.domain.id }
+                });
+                const stem = stemOf(att?.name);
+                if (stem)
+                    return stem;
+            }
+        }
+    }
+    return FALLBACK;
+}
+function parseJsonSafe(s) {
+    if (!s)
+        return undefined;
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+function firstSentence(text) {
+    // 첫 문장 종결 부호 또는 줄바꿈까지. 미발견 시 전체.
+    const m = text.match(/^([^.\n!?]{1,120})[.\n!?]?/);
+    return (m?.[1] ?? text).trim();
+}
+function stemOf(name) {
+    if (!name)
+        return '';
+    // 마지막 . 이후 (확장자) 제거. 점이 여러 번이면 가장 마지막만.
+    const lastDot = name.lastIndexOf('.');
+    if (lastDot > 0)
+        return name.slice(0, lastDot);
+    return name;
+}
+/**
+ * 정규화: _-. → 공백, 다중 공백 단일화, trim, 50자 절단.
+ * 결과가 빈 문자열이면 '' 반환 (호출자가 fallback).
+ */
+function sanitize(s) {
+    if (!s)
+        return '';
+    let cleaned = s.replace(/[_\-.]+/g, ' ').replace(/\s+/g, ' ').trim();
+    if (cleaned.length > 50)
+        cleaned = cleaned.slice(0, 50).trim();
+    return cleaned;
+}
+/**
+ * existingNames 안에서 base 가 그대로 비어있으면 base 반환, 아니면 'base (2)', '(3)', ...
+ * case-insensitive 비교 (postgres ilike 호환).
+ */
+function pickAvailableSuffix(base, existingNames) {
+    const lower = base.toLowerCase();
+    const taken = new Set();
+    for (const name of existingNames) {
+        if (typeof name === 'string')
+            taken.add(name.toLowerCase());
+    }
+    if (!taken.has(lower))
+        return base;
+    for (let n = 2; n < 10000; n++) {
+        const candidate = `${base} (${n})`;
+        if (!taken.has(candidate.toLowerCase()))
+            return candidate;
+    }
+    // 9999개 충돌 이라는 비현실 시나리오 — 마지막 fallback
+    return `${base} (${Date.now()})`;
+}
+//# sourceMappingURL=suggest-board-name.js.map