@dssp/dkpi 1.0.0-alpha.71 → 1.0.0-alpha.76

package/schema.graphql

@@ -838,6 +838,7 @@ type Attachment {
   refType: String
   size: String!
   tags: Object
+  thumbnail: String
   updatedAt: DateTimeISO!
   updater: User
 }
@@ -1151,12 +1152,22 @@ type Board {
   """
   sortOrder: Float
 
+  """
+  Source ImportSession id (board-import) when this board was generated from a drawing/image import.
+  """
+  sourceImportSessionId: String
+
   """The state of the board, can be 'draft' or 'released'."""
   state: String
 
   """A base64 encoded thumbnail image of the board."""
   thumbnail: String
 
+  """
+  Timestamp of the last thumbnail generation. Separate lifecycle from updatedAt; only changes when the thumbnail image itself is regenerated.
+  """
+  thumbnailUpdatedAt: DateTimeISO
+
   """The type of the board, can be 'main', 'sub', or 'popup'."""
   type: String
 
@@ -1170,6 +1181,120 @@ type Board {
   version: Float
 }
 
+input BoardAIChatInput {
+  """
+  Component categories to surface (e.g. ["3D", "form"]). Subset filter for groupings exposed in component-schemas.
+  """
+  categories: [String!]
+
+  """
+  Component schemas — array of { type, description?, group?, properties? } so the LLM knows valid props per type.
+  """
+  componentSchemas: JSON
+
+  """Current BoardModel JSON."""
+  currentBoard: JSON
+
+  """
+  Component types the LLM is allowed to emit (e.g. ["rect", "label"]). Constrains generation to the current solution.
+  """
+  knownTypes: [String!]
+
+  """
+  Max output tokens override per LLM call. Falls back to assistant default when omitted.
+  """
+  maxTokens: Float
+
+  """
+  Explicit #mention picks from popup — {token, refid}. User text stays clean (#token only); these picks let server resolve deterministically without exposing refid in the user-visible message. Tokens not in this list fall back to free name/id/type matching.
+  """
+  mentions: [BoardAIMentionPickInput!]
+
+  """
+  Conversation history (latest user message at the end). For persisted sessions, only the last user message is appended; older are loaded from DB.
+  """
+  messages: [BoardAILLMMessageInput!]!
+
+  """
+  AI model identifier override (e.g. "claude-opus-4-7"). Falls back to the configured default when omitted.
+  """
+  model: String
+
+  """
+  Capability scopes the AI is allowed to use (e.g. 'create', 'edit', 'style'). Filters which tools are exposed to the LLM.
+  """
+  scopes: [String!]
+
+  """
+  Refids of components currently selected in the modeller (universal numeric handle, things-scene auto-assigned). For "selected" / "선택한" intent. Note: distinct from `id` which is a data-binding name.
+  """
+  selectedRefids: [Int!]
+
+  """
+  ChatSession id. Omit for ad-hoc (no persistence). When given, messages/patches are persisted.
+  """
+  sessionId: String
+
+  """
+  Sampling temperature override. Falls back to assistant default when omitted.
+  """
+  temperature: Float
+}
+
+type BoardAIChatOutput {
+  """
+  Ephemeral scene actions (selection/view/mode) — sequence of BoardActionOp. Applied via board-action-execute event on the host. Distinct from `patch` which carries persistent model changes.
+  """
+  actions: JSON
+
+  """Persisted ChatMessage id of the AI reply."""
+  assistantMessageId: String
+
+  """AI client identifier (provider:model)."""
+  clientId: String!
+
+  """Clarifying question when input is ambiguous."""
+  followUp: String
+
+  """BoardEditPatch."""
+  patch: JSON
+
+  """Persisted PatchEntry id (when patch was generated)."""
+  patchId: String
+
+  """Conversational reply."""
+  reply: String!
+
+  """Echo of session id (when persisted)."""
+  sessionId: String
+
+  """
+  Tool usages collected during agentic loop — sequence of {name, arguments, result, kind}. UI fold-able box for transparency / debug.
+  """
+  toolUsages: JSON
+
+  """Persisted ChatMessage id of the user input."""
+  userMessageId: String
+}
+
+input BoardAILLMMessageInput {
+  """Message content"""
+  content: String!
+
+  """Role: 'user' or 'assistant'"""
+  role: String!
+}
+
+input BoardAIMentionPickInput {
+  """
+  Refid explicitly picked from popup. Server uses this for deterministic resolution — bypasses fallback name/id/type matching for this token.
+  """
+  refid: Int!
+
+  """Token used by user (e.g. "경광등1" — the part after #)."""
+  token: String!
+}
+
 """Represents a board that a user has marked as a favorite."""
 type BoardFavorite {
   """The timestamp when the board was created."""
@@ -1210,12 +1335,22 @@ type BoardFavorite {
   """
   sortOrder: Float
 
+  """
+  Source ImportSession id (board-import) when this board was generated from a drawing/image import.
+  """
+  sourceImportSessionId: String
+
   """The state of the board, can be 'draft' or 'released'."""
   state: String
 
   """A base64 encoded thumbnail image of the board."""
   thumbnail: String
 
+  """
+  Timestamp of the last thumbnail generation. Separate lifecycle from updatedAt; only changes when the thumbnail image itself is regenerated.
+  """
+  thumbnailUpdatedAt: DateTimeISO
+
   """The type of the board, can be 'main', 'sub', or 'popup'."""
   type: String
 
@@ -1307,6 +1442,16 @@ type BoardList {
   total: Int!
 }
 
+type BoardMetaSuggestion {
+  """
+  Suggested detailed description — combines user prompt, AI importStrategy narrative, and category distribution stats.
+  """
+  description: String!
+
+  """Suggested short board name (collision-free with current domain)."""
+  name: String!
+}
+
 """Input for updating (patching) an existing board."""
 input BoardPatch {
   """The new description for the board."""
@@ -1701,6 +1846,113 @@ input BuildingPatch {
   name: String
 }
 
+"""A single chat message in a ChatSession."""
+type ChatMessage {
+  """Message content"""
+  content: String!
+
+  """Creation timestamp."""
+  createdAt: DateTimeISO
+
+  """User who triggered this message."""
+  creator: User
+
+  """Soft delete timestamp."""
+  deletedAt: DateTimeISO
+  id: ID
+
+  """
+  Id of the message this one is in-response-to / continues. Enables linear / branching / tree structures.
+  """
+  parentMessageId: String
+
+  """ImportSession.id this message triggered (if any)."""
+  relatedImportSessionId: String
+
+  """PatchEntry.id this message triggered (if any)."""
+  relatedPatchId: String
+
+  """'user' | 'assistant' | 'system'"""
+  role: String!
+
+  """
+  Tool usage trace — array of {name, arguments, result, kind}. Only on assistant messages.
+  """
+  toolUsagesJson: JSON
+
+  """Last update timestamp (relevant once message editing is supported)."""
+  updatedAt: DateTimeISO
+
+  """Last user to update this message (for future edit support)."""
+  updater: User
+}
+
+"""AI 협력 세션 — Board 와 결합. 한 보드에 여러 세션 가능 (thread / 사용자별 / 컨텍스트별 등 미래 확장)."""
+type ChatSession {
+  aiClientId: String
+
+  """
+  Connected Board id. Multiple sessions per board allowed (future: threads / per-user / contexts).
+  """
+  boardId: String
+  createdAt: DateTimeISO
+
+  """User who created this session."""
+  creator: User
+  domain: Domain
+  id: ID
+
+  """Compressed summary of older messages (for token saving)."""
+  lastSummary: String
+
+  """User-given name of this session (tab label / identification)."""
+  name: String
+  updatedAt: DateTimeISO
+
+  """User who last updated this session."""
+  updater: User
+}
+
+"""
+Participant of a ChatSession — links a User to a session with a role. Foundation for multi-user chat / per-user filtering / member display.
+"""
+type ChatSessionParticipant {
+  """Joined-at timestamp."""
+  createdAt: DateTimeISO
+
+  """
+  User who created this participant record (typically session owner who invited).
+  """
+  creator: User
+
+  """Soft delete (= left session) timestamp."""
+  deletedAt: DateTimeISO
+
+  """Domain to which this participant belongs."""
+  domain: Domain
+
+  """Unique participant id."""
+  id: ID!
+
+  """Last seen / activity timestamp (presence indicator)."""
+  lastSeenAt: DateTimeISO
+
+  """Role of this participant: owner | member | viewer."""
+  role: String!
+
+  """The ChatSession this participation belongs to."""
+  session: ChatSession
+
+  """Last update timestamp (role change / lastSeenAt bump)."""
+  updatedAt: DateTimeISO
+
+  """Last user to update this participant record (e.g., role change)."""
+  updater: User
+
+  """The user participating in the session."""
+  user: User
+}
+
 type Checklist {
   buildingInspection: BuildingInspection!
   checklistAttachments(description: String): [Attachment!]!
@@ -2203,6 +2455,68 @@ type ConnectorType {
   taskPrefixes: [String!]
 }
 
+type ConstructionChecklistTemplate {
+  constructionChecklistTemplateItems: [ConstructionChecklistTemplateItem!]
+  constructionDetailTypeId: String!
+  constructionTypeId: String!
+  createdAt: DateTimeISO
+  creator: User
+  deletedAt: DateTimeISO
+  domain: Domain
+  id: ID!
+  updatedAt: DateTimeISO
+  updater: User
+}
+
+type ConstructionChecklistTemplateItem {
+  constructionChecklistTemplate: ConstructionChecklistTemplate
+  createdAt: DateTimeISO
+  creator: User
+  criteriaRequestStatus: CriteriaRequestStatus
+  id: ID!
+  inspctionCriteria: String
+  mainType: String
+  name: String!
+  recommendation1: String
+  recommendation2: String
+  recommendation3: String
+  recommendation4: String
+  recommendation5: String
+  sequence: Int
+  updatedAt: DateTimeISO
+  updater: User
+}
+
+type ConstructionChecklistTemplateItemList {
+  items: [ConstructionChecklistTemplateItem!]!
+  total: Int!
+}
+
+input ConstructionChecklistTemplateItemPatch {
+  id: ID
+  inspctionCriteria: String
+  mainType: String
+  name: String
+  recommendation1: String
+  recommendation2: String
+  recommendation3: String
+  recommendation4: String
+  recommendation5: String
+  sequence: Int
+}
+
+type ConstructionChecklistTemplateList {
+  items: [ConstructionChecklistTemplate!]!
+  total: Int!
+}
+
+input ConstructionChecklistTemplatePatch {
+  constructionDetailTypeId: String
+  constructionTypeId: String
+  cuFlag: String
+  id: ID
+}
+
 """세부 공종 타입"""
 type ConstructionDetailType {
   constructionType: ConstructionType
@@ -2237,6 +2551,7 @@ type ConstructionType {
   domain: Domain
   id: ID!
   name: String
+  projectType: String
   updatedAt: DateTimeISO
   updater: User
 }
@@ -2251,6 +2566,7 @@ input ConstructionTypePatch {
   description: String
   id: ID
   name: String
+  projectType: String
 }
 
 """Entity for Contact"""
@@ -3535,6 +3851,27 @@ type DomainList {
   total: Int
 }
 
+"""An ownership record binding a User to a Domain (multi-owner support)."""
+type DomainOwner {
+  """Domain that the user owns."""
+  domain: Domain!
+
+  """When the ownership was granted."""
+  grantedAt: DateTimeISO!
+
+  """User who granted this ownership (audit)."""
+  grantedBy: User
+
+  """Unique identifier."""
+  id: ID!
+
+  """Optional reason/memo for granting ownership."""
+  reason: String
+
+  """User who owns the domain."""
+  user: User!
+}
+
 """Input type for updating an existing domain entity."""
 input DomainPatch {
   """Additional attributes for the domain in key-value pairs."""
@@ -4094,6 +4431,70 @@ input GroupPatch {
   name: String
 }
 
+input ImportBoardAsyncInput {
+  """Apply Stage 4 (data binding)."""
+  applyBinding: Boolean
+
+  """
+  Attachment id of the source drawing file (uploaded via attachment-base).
+  """
+  attachmentId: String!
+
+  """ChatSession id when triggered from board-ai chat."""
+  chatSessionId: String
+
+  """Flip Y axis (CAD Y-up → scene Y-down)."""
+  flipY: Boolean
+
+  """Normalize coordinates so minX,minY=0"""
+  normalizeOrigin: Boolean
+
+  """Adapter parse options (excludeLayers, maxEntities, ...)."""
+  parseOptions: JSON
+
+  """Scale factor (e.g. 1 for mm:1unit)."""
+  scale: Float
+
+  """Registry scopes to use (board-import)."""
+  scopes: [String!]
+
+  """
+  User-provided context / hints about the drawing — passed to VLM as additional guidance. e.g. "fab lithography zone, central rectangles are stockers, thin lines are OHT rails."
+  """
+  userPrompt: String
+}
+
+"""도면 → 보드 변환 작업의 영속 단위 (비동기 진행상태 추적)."""
+type ImportSession {
+  """Attachment id (the source drawing file)"""
+  attachmentId: String!
+
+  """ChatSession id when triggered from chat (board-ai)."""
+  chatSessionId: String
+  completedAt: DateTimeISO
+  createdAt: DateTimeISO
+  creator: User
+  domain: Domain
+  id: ID
+  message: String
+
+  """Options used (parsed JSON)."""
+  options: JSON
+
+  """Progress percentage 0..100"""
+  progress: Float!
+
+  """Result (parsed JSON): { boardModel, stats, warnings }."""
+  result: JSON
+
+  """queued | parsing | mapping | assembling | binding | completed | failed"""
+  status: String!
+
+  """Total entities counted (when known)."""
+  totalEntities: Int
+  updatedAt: DateTimeISO
+}
+
 """
 Enumeration for inherited value types: None, Only, or Include. Used to specify how values are inherited in queries or filters.
 """
@@ -4267,6 +4668,11 @@ enum IssueStatus {
   STATUS_B
 }
 
+"""
+The `JSON` scalar type represents JSON values as specified by [ECMA-404](http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf).
+"""
+scalar JSON @specifiedBy(url: "http://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf")
+
 """
 A field whose value is a JSON Web Token (JWT): https://jwt.io/introduction.
 """
@@ -4573,7 +4979,7 @@ input KpiMetricPatch {
   """데이터 수집 방식"""
   collectType: KpiMetricCollectType
   cuFlag: String
-  dataSetId: ID
+  dataSet: ObjectRef
   description: String
   fieldName: String
   id: ID
@@ -4616,7 +5022,7 @@ type KpiMetricValue {
   """
   org: String
   periodType: KpiPeriodType!
-  project: Project!
+  project: Project
   unit: String
   updatedAt: DateTimeISO
   updater: User
@@ -5407,6 +5813,33 @@ input ManagerPatch {
   userId: ID
 }
 
+input MaterializeImportSessionInput {
+  """Optional Board description."""
+  description: String
+
+  """Optional Group id to attach the Board to."""
+  groupId: ID
+
+  """New Board name."""
+  name: String!
+
+  """ImportSession id (must be in completed state)."""
+  sessionId: ID!
+
+  """
+  Base64 thumbnail. If omitted, board-service default empty thumbnail is used.
+  """
+  thumbnail: String
+
+  """Board type — 'main' | 'sub' | 'popup'. Default 'main'."""
+  type: String
+
+  """
+  ImportSession 의 결과 시안 중 하나의 id. 'as-is' / 'scene' / 'auto-fit'. 미지정 시 default variant (보통 'scene') 사용.
+  """
+  variantId: String
+}
+
 """Entity for Menu"""
 type Menu {
   buttons: [MenuButton!]!
@@ -5785,6 +6218,9 @@ type Mutation {
     username: String!
   ): Boolean!
 
+  """Add a user as owner of the current domain."""
+  addDomainOwner(reason: String, username: String!): DomainOwner!
+
   """To apply to all building inspection"""
   applyToAllBuildingInspection(buildingInspectionId: String!): Boolean!
 
@@ -5805,6 +6241,14 @@ type Mutation {
   """
   attachContact(contactId: String!, id: String!): Employee!
 
+  """
+  썸네일이 없는 기존 첨부파일들에 대해 서버에서 썸네일을 일괄 생성한다. 한 호출당 limit 개까지만 처리하며, remaining > 0 이면 반복 호출 필요.
+  """
+  backfillAttachmentThumbnails(limit: Int = 20): ThumbnailBackfillResult!
+
+  """AI 주도 보드 모델링 — 자연어 채팅으로 보드 생성·구조편집·스타일링. sessionId 로 영속 컨텍스트."""
+  boardAIChat(input: BoardAIChatInput!): BoardAIChatOutput!
+
   """Bulk create or update KPI org-scope mappings."""
   bulkUpsertKpiOrgScopes(
     """Array of org-scope mapping data for bulk upsert."""
@@ -5893,6 +6337,16 @@ type Mutation {
   """Create Daily Worklog by projectId+date"""
   createBuildingInspectionDailyWorklog(patch: BuildingInspectionDailyWorklogNew!): BuildingInspectionDailyWorklog!
 
+  """
+  Always create a new AI chat session for a board (no idempotent reuse). For multi-session UX — 새 탭 열기.
+  """
+  createChatSession(
+    boardId: String!
+
+    """Optional name (defaults to auto-generated `세션 N`)."""
+    name: String
+  ): ChatSession!
+
   """To create new ChecklistItemComment"""
   createChecklistItemComment(checklistItemComment: NewChecklistItemComment!): ChecklistItemComment!
 
@@ -6074,6 +6528,9 @@ type Mutation {
   """프로젝트 생성"""
   createProject(project: NewProject!): Project!
 
+  """프로젝트 체크리스트 생성"""
+  createProjectChecklist(constructionDetailTypeId: String!, constructionTypeId: String!, items: [ProjectChecklistItemInput!]!, name: String!, projectId: String!): ProjectChecklist!
+
   """To create new ProjectReport"""
   createProjectReport(projectReport: NewProjectReport!): ProjectReport!
 
@@ -6240,6 +6697,12 @@ type Mutation {
   """Deletes multiple connections by their names."""
   deleteConnections(names: [String!]!): Boolean!
 
+  """공종 체크리스트 템플릿 아이템 삭제"""
+  deleteConstructionChecklistTemplateItems(ids: [String!]!): Boolean!
+
+  """공종 기반 체크리스트 템플릿 삭제"""
+  deleteConstructionChecklistTemplates(ids: [String!]!): Boolean!
+
   """To delete multiple ConstructionDetailTypes"""
   deleteConstructionDetailTypes(ids: [String!]!): Boolean!
 
@@ -6527,6 +6990,9 @@ type Mutation {
   """To delete Project"""
   deleteProject(id: String!): Boolean!
 
+  """프로젝트 체크리스트 삭제"""
+  deleteProjectChecklists(ids: [String!]!): Boolean!
+
   """To delete ProjectReport"""
   deleteProjectReport(id: String!): Boolean!
 
@@ -6624,6 +7090,9 @@ type Mutation {
   """To delete multiple WorkerTypes"""
   deleteWorkerTypes(ids: [String!]!): Boolean!
 
+  """프로젝트 테넌트 강등 (Domain soft-delete, Project.code 보존)"""
+  demoteProjectTenant(projectId: String!): Boolean!
+
   """
   Detaches an existing contact from an employee. The employee is identified by their ID.
   """
@@ -6700,6 +7169,9 @@ type Mutation {
     attributes: [AttributeSetPatch!]!
   ): Boolean!
 
+  """도면 → 보드 변환을 비동기로 시작. 즉시 ImportSession 반환, 백그라운드에서 처리."""
+  importBoardAsync(input: ImportBoardAsyncInput!): ImportSession!
+
   """Imports multiple boards from JSON files."""
   importBoards(files: [Upload!]!, groupId: String!, overwrite: Boolean!): [Board!]!
 
@@ -6843,6 +7315,11 @@ type Mutation {
 
   """Removes one or more boards from a play group."""
   leavePlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
+
+  """
+  완료된 ImportSession 의 결과 boardModel 을 새 Board entity 로 영속화한다. 검수 단계 (사용자/AI 가 import 결과를 확인 후 명시적으로 호출) 에서 사용. Board.state="draft" 로 생성되므로 release mutation 으로 별도 발행 필요.
+  """
+  materializeImportSession(input: MaterializeImportSessionInput!): Board!
   multipleUpload(files: [Upload!]!): [Attachment!]!
 
   """
@@ -6850,12 +7327,20 @@ type Mutation {
   """
   pickActivityInstance(id: String!): ActivityThread
 
+  """프로젝트를 테넌트로 승격 (관리번호 발번 + project 카테고리 Domain 생성)"""
+  promoteProjectToTenant(projectId: String!): Project!
+
   """기존 KPI Value 인스턴스를 현재 formula/metric 값으로 재계산"""
   recalculateKpiValue(id: String!): KpiValue!
 
   """Recalculate scores for all KpiValues of a specific KPI"""
   recalculateScoresForKpi(kpiId: String!): Boolean!
 
+  """
+  Record a patch from user direct edit. Adds a system message so AI sees the change next turn.
+  """
+  recordDirectPatch(ops: JSON!, sessionId: String!, summary: String): PatchEntry!
+
   """Record a metric value by metric name, value, meta, and org."""
   recordKpiMetricValue(
     """Extended or non-numeric information (JSON)."""
@@ -6907,10 +7392,16 @@ type Mutation {
 
   """Release a KPI and create a version history."""
   releaseKpi(id: String!): Kpi!
+
+  """Remove a user from the owners of the current domain."""
+  removeDomainOwner(reason: String, username: String!): Boolean!
+
+  """Rename a ChatSession (tab label)."""
+  renameChatSession(name: String!, sessionId: String!): Boolean!
   renewApplicationAccessToken(id: String!, scope: String!): AccessToken!
 
-  """Updates the sortOrder of a single board."""
-  reorderBoard(id: String!, sortOrder: Float!): Boolean!
+  """Reorders a board between two adjacent boards by ID."""
+  reorderBoard(id: String!, nextId: String, prevId: String): Boolean!
 
   """Sets the custom playback order for boards in a play group."""
   reorderPlayGroup(boardIds: [String!]!, id: String!): PlayGroup!
@@ -6932,6 +7423,9 @@ type Mutation {
   """Revert a KPI to a specific historical version."""
   revertKpiVersion(id: String!, version: Float!): Kpi!
 
+  """Mark a patch as reverted (does not undo, only flags)."""
+  revertPatch(patchId: String!): Boolean!
+
   """
   Runs a new scenario instance once and returns the result after it finishes.
   """
@@ -6951,6 +7445,11 @@ type Mutation {
   """To start ActivityThread"""
   startActivityThread(id: String!, output: Object, reason: String): ActivityThread
 
+  """
+  Start (or get existing) AI chat session for a board. Idempotent — returns first existing or creates one.
+  """
+  startBoardAISession(boardId: String!): ChatSession!
+
   """
   Starts automated data collection scheduling for the specified dataset. This mutation registers a cron-based schedule that automatically triggers data collection tasks according to the dataset configuration.
   """
@@ -7224,6 +7723,12 @@ type Mutation {
   """Updates multiple connections at once."""
   updateMultipleConnection(patches: [ConnectionPatch!]!): [Connection!]!
 
+  """공종 기반 체크리스트 템플릿 생성/수정"""
+  updateMultipleConstructionChecklistTemplate(patches: [ConstructionChecklistTemplatePatch!]!): [ConstructionChecklistTemplate!]!
+
+  """공종 체크리스트 템플릿 아이템 일괄 저장"""
+  updateMultipleConstructionChecklistTemplateItems(constructionChecklistTemplateId: String!, patches: [ConstructionChecklistTemplateItemPatch!]!): [ConstructionChecklistTemplateItem!]!
+
   """To modify multiple ConstructionDetailTypes' information"""
   updateMultipleConstructionDetailType(constructionTypeId: String!, patches: [ConstructionDetailTypePatch!]!): [ConstructionDetailType!]!
 
@@ -7419,6 +7924,9 @@ type Mutation {
   """프로젝트 업데이트 (중복 사용 금지)"""
   updateProject(project: ProjectPatch!): Project!
 
+  """프로젝트 체크리스트 수정"""
+  updateProjectChecklist(id: String!, items: [ProjectChecklistItemInput!]!, name: String!): ProjectChecklist!
+
   """프로젝트 도면 업데이트"""
   updateProjectPlan(project: ProjectPatch!): Project!
 
@@ -7502,6 +8010,9 @@ type Mutation {
 
   """프로젝트 공정표 업로드"""
   uploadProjectScheduleTable(param: UploadProjectScheduleTable!): Boolean!
+
+  """공종+세부공종 조합으로 find-or-create"""
+  upsertConstructionChecklistTemplate(constructionDetailTypeId: String!, constructionTypeId: String!): ConstructionChecklistTemplate!
 }
 
 input NewActionPlan {
@@ -8160,8 +8671,8 @@ input NewKpiMetric {
   """데이터 수집 방식"""
   collectType: KpiMetricCollectType
 
-  """ID of the source dataset for this metric."""
-  dataSetId: ID
+  """Source dataset for this metric."""
+  dataSet: ObjectRef
 
   """User-friendly name or description of the metric."""
   description: String
@@ -9310,6 +9821,26 @@ type PasswordRule {
   useTightPattern: Boolean
 }
 
+"""One board edit operation history (cascade-deleted with ChatSession)."""
+type PatchEntry {
+  """AI confidence 0..1 (null for user-direct)."""
+  confidence: Float
+  createdAt: DateTimeISO
+  id: ID
+
+  """BoardEditOp[] (parsed JSON array)."""
+  opsJson: JSON!
+
+  """Whether this patch was reverted."""
+  reverted: Boolean!
+
+  """'ai' | 'user-direct' | 'import'"""
+  source: String!
+
+  """Short human summary of this patch."""
+  summary: String
+}
+
 """Logs the request and response payloads for API interactions."""
 type PayloadLog {
   """The timestamp when the log entry was created."""
@@ -9575,6 +10106,7 @@ input ProfileInput {
 type Project {
   buildingComplex: BuildingComplex
   buildingUsage: String
+  code: String
   completeReport: Attachment
   createdAt: DateTimeISO
   creator: User
@@ -9601,12 +10133,60 @@ type Project {
   state: String!
   structuralSafetyRate: Float
   tasks: [Task!]
+
+  """활성 테넌트 Domain (extType=project). 미승격 또는 강등 상태이면 null"""
+  tenantDomain: Domain
   totalProgress: Float
   updatedAt: DateTimeISO
   updater: User
   weeklyProgress: Float
 }
 
+type ProjectChecklist {
+  constructionDetailTypeId: String!
+  constructionTypeId: String!
+  createdAt: DateTimeISO
+  creator: User
+  deletedAt: DateTimeISO
+  domain: Domain
+  id: ID!
+  name: String!
+  projectChecklistItems: [ProjectChecklistItem!]
+  projectId: String!
+  updatedAt: DateTimeISO
+  updater: User
+}
+
+type ProjectChecklistItem {
+  createdAt: DateTimeISO
+  creator: User
+  id: ID!
+  inspctionCriteria: String
+  mainType: String
+  name: String!
+  projectChecklist: ProjectChecklist
+  sequence: Int
+  updatedAt: DateTimeISO
+  updater: User
+}
+
+input ProjectChecklistItemInput {
+  inspctionCriteria: String
+  mainType: String
+  name: String!
+  sequence: Int
+}
+
+type ProjectChecklistItemList {
+  items: [ProjectChecklistItem!]!
+  total: Int!
+}
+
+type ProjectChecklistList {
+  items: [ProjectChecklist!]!
+  total: Int!
+}
+
 type ProjectList {
   """프로젝트 리스트 항목들"""
   items: [Project!]!
@@ -10246,6 +10826,28 @@ type Query {
   """To fetch a building level"""
   buildingLevel(id: String!): BuildingLevel
 
+  """List chat messages of a session, oldest first."""
+  chatMessages(limit: Int = 100, offset: Int = 0, sessionId: String!): [ChatMessage!]!
+
+  """List patch entries of a session, newest first."""
+  chatPatches(limit: Int = 100, sessionId: String!): [PatchEntry!]!
+
+  """Get AI chat session by id."""
+  chatSession(id: String!): ChatSession
+
+  """
+  Get AI chat session by board id (returns first match — backward compat single-session lookup).
+  """
+  chatSessionByBoard(boardId: String!): ChatSession
+
+  """List participants of a ChatSession (members / owner)."""
+  chatSessionParticipants(sessionId: String!): [ChatSessionParticipant!]!
+
+  """
+  List all AI chat sessions for a board (oldest first). Multi-session support — UI 탭으로 표시.
+  """
+  chatSessionsByBoard(boardId: String!): [ChatSession!]!
+
   """
   Checks if the system is configured to provide a default password for new users.
   """
@@ -10473,6 +11075,36 @@ type Query {
   """Fetches a list of all available connector types."""
   connectors: ConnectorList!
 
+  """공종 체크리스트 템플릿 아이템 목록"""
+  constructionChecklistTemplateItems(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): ConstructionChecklistTemplateItemList!
+
+  """공종 기반 체크리스트 템플릿 목록"""
+  constructionChecklistTemplates(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): ConstructionChecklistTemplateList!
+
   """To fetch multiple ConstructionDetailTypes"""
   constructionDetailTypes(
     """An array of filter conditions to apply to the list query."""
@@ -10524,6 +11156,9 @@ type Query {
     sortings: [Sorting!]
   ): ContactList!
 
+  """현재 테넌트 컨텍스트(extType=project)의 프로젝트. subdomain(=Project.code) 으로 조회."""
+  currentProject: Project
+
   """프로젝트 타입 조회"""
   currentProjectType: String!
   customers: [Domain!]!
@@ -10941,11 +11576,24 @@ type Query {
     sortings: [Sorting!]
   ): DomainLinkList!
 
+  """List owners of the current domain."""
+  domainOwners: [DomainOwner!]!
+
   """
   Fetches the list of available domain types from configuration. Only superusers are granted this privilege.
   """
   domainTypes: [String!]!
 
+  """
+  List users in the current domain for `@` mention popup. board-ai 권한이면 누구나 멘션용 검색 가능 (관리자 전용 users() 와 별도).
+  """
+  domainUsersForMention(
+    limit: Int = 50
+
+    """Substring to match against name/email (case-insensitive). Empty → all."""
+    query: String
+  ): [User!]!
+
   """
   Fetches all domain entities with pagination and filtering options. Only superusers are granted this privilege.
   """
@@ -11166,6 +11814,12 @@ type Query {
   """To query whether I have the given permission"""
   hasPrivilege(category: String!, privilege: String!): Boolean!
 
+  """Get import session progress."""
+  importSession(id: String!): ImportSession
+
+  """List recent import sessions for a chat session."""
+  importSessionsByChatSession(chatSessionId: String!): [ImportSession!]!
+
   """BuildingInspection By ChecklistItemId"""
   inspectionByChecklistItemId: BuildingInspection!
 
@@ -11228,6 +11882,9 @@ type Query {
   invitation(email: EmailAddress!, reference: String!, type: String!): Invitation!
   invitations(reference: String!, type: String!): InvitationList!
 
+  """Check if a user is an owner of the current domain."""
+  isDomainOwner(username: String!): Boolean!
+
   """To fetch a Issue"""
   issue(id: String!): Issue
 
@@ -11904,6 +12561,36 @@ type Query {
   """To fetch Project"""
   projectByBuildingLevelId(buildingLevelId: String!): Project!
 
+  """프로젝트 체크리스트 아이템 목록"""
+  projectChecklistItems(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): ProjectChecklistItemList!
+
+  """프로젝트 체크리스트 목록"""
+  projectChecklists(
+    """An array of filter conditions to apply to the list query."""
+    filters: [Filter!]
+
+    """Inherited value type for the list query."""
+    inherited: InheritedValueType
+
+    """Pagination options for the list query."""
+    pagination: Pagination
+
+    """Sorting options for the list query."""
+    sortings: [Sorting!]
+  ): ProjectChecklistList!
+
   """To fetch a ProjectReport"""
   projectReport(id: String!): ProjectReport
 
@@ -12114,6 +12801,14 @@ type Query {
     sortings: [Sorting!]
   ): StepList!
 
+  """
+  도메인 안에서 충돌하지 않는 Board name + 상세 description 제안. name 은 짧고 심플 (30자 이내, 충돌 회피 (n) suffix), description 은 자세히 (사용자 prompt + AI importStrategy + 카테고리 분포 통계 합성).
+  """
+  suggestBoardMeta(input: SuggestBoardNameInput!): BoardMetaSuggestion!
+
+  """@deprecated suggestBoardMeta 사용 권장. 단순 string name 만 반환하는 구버전 query."""
+  suggestBoardName(input: SuggestBoardNameInput!): String!
+
   """To fetch the list of activities that I can report on"""
   supervisableActivities(
     """An array of filter conditions to apply to the list query."""
@@ -13060,6 +13755,16 @@ type Subscription {
   scenarioQueueState: ScenarioQueueState!
 }
 
+input SuggestBoardNameInput {
+  """명시 hint. session 정보보다 우선. 사용자가 직접 적은 메모를 기반으로 추천받고 싶을 때."""
+  hint: String
+
+  """
+  ImportSession id — 있으면 거기서 userPrompt / VLM reasoning / attachment.name 추출.
+  """
+  sessionId: ID
+}
+
 """Entity for Supervisor"""
 type Supervisor {
   active: Boolean
@@ -13361,6 +14066,21 @@ input ThemePatch {
   value: Object
 }
 
+"""썸네일 백필 결과"""
+type ThumbnailBackfillResult {
+  """이번 호출에서 처리 시도한 첨부 개수"""
+  attempted: Int!
+
+  """실패(생성 실패/콘텐츠 없음 등) 개수"""
+  failed: Int!
+
+  """이번 처리 후에도 남아있는 썸네일 미생성 후보 개수 (대략치). 0 이면 완료"""
+  remaining: Int!
+
+  """썸네일 생성·저장 성공 개수"""
+  succeeded: Int!
+}
+
 input UpdateBuildingInspection {
   drawingMarker: String
   id: String!
@@ -13372,6 +14092,7 @@ input UpdateBuildingInspectionSubmitType {
   checklistItem: [ChecklistItemSubmitInputType!]!
   id: String!
   memo: String
+  requestDate: String
 }
 
 input UpdateTaskChecklistSubmitType {