@dssp/dkpi 1.0.0-y.0 → 1.0.1

package/schema.graphql

@@ -3,15 +3,6 @@
 # !!!   DO NOT MODIFY THIS FILE BY YOURSELF   !!!
 # -----------------------------------------------
 
-input APIDocCompletionInput {
-  code: String!
-  language: String
-}
-
-type APIDocCompletionOutput {
-  message: String
-}
-
 """Represents a pair of access and refresh tokens."""
 type AccessToken {
   """The access token for API authentication."""
@@ -847,6 +838,7 @@ type Attachment {
   refType: String
   size: String!
   tags: Object
+  thumbnail: String
   updatedAt: DateTimeISO!
   updater: User
 }
@@ -1155,12 +1147,27 @@ type Board {
   """A list of play groups that this board is a part of."""
   playGroups: [PlayGroup!]
 
+  """
+  Sort order for display. Lower values appear first. Supports fractional values for insertion.
+  """
+  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
 
@@ -1174,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."""
@@ -1209,12 +1330,27 @@ type BoardFavorite {
   """A list of play groups that this board is a part of."""
   playGroups: [PlayGroup!]
 
+  """
+  Sort order for display. Lower values appear first. Supports fractional values for insertion.
+  """
+  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
 
@@ -1306,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."""
@@ -1514,6 +1660,7 @@ type BuildingInspection {
   creator: User
   deletedAt: DateTimeISO
   drawingMarker: String
+  failCount: Float
   id: ID!
   manager: ProjectManagerOutput
   memo: String
@@ -1582,6 +1729,7 @@ type BuildingInspectionHistory {
   createdAt: DateTimeISO
   creator: User
   drawingMarker: String
+  failCount: Float
   id: ID!
   loggedAt: DateTimeISO
   manager: ProjectManagerOutput
@@ -1611,6 +1759,9 @@ type BuildingInspectionSummary {
   """검측 통과 수"""
   pass: Int!
 
+  """재검측 대기 수 (failCount > 0 인 WAIT/OVERALL_WAIT)"""
+  reWait: Int
+
   """검측 요청 수"""
   request: Int!
 
@@ -1635,6 +1786,11 @@ type BuildingInspectionSummaryOfLevel {
   wait: Int!
 }
 
+input BuildingInspectionsOfBuilding {
+  buildingId: String!
+  limit: Float
+}
+
 input BuildingInspectionsOfBuildingLevel {
   buildingLevelId: String!
   endDate: String
@@ -1645,6 +1801,9 @@ input BuildingInspectionsOfBuildingLevel {
 input BuildingInspectionsOfProject {
   limit: Float
   projectId: String!
+
+  """상태 필터 (WAIT, REQUEST, FAIL, RE_WAIT, PASS)"""
+  statusFilter: String
 }
 
 """층 정보"""
@@ -1692,12 +1851,111 @@ input BuildingPatch {
   name: String
 }
 
-input ChatCompletionInput {
+"""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
 }
 
-type ChatCompletionOutput {
-  message: String
+"""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 {
@@ -1822,9 +2080,11 @@ type ChecklistItem {
   detailType: String!
   id: ID!
   inspctionCriteria: String
+  kcsCriteria: String
   mainType: String!
   name: String
   sequence: Int
+  siteSpecCriteria: String
   supervisoryConfirmStatus: String
   updatedAt: DateTimeISO
   updater: User
@@ -1860,10 +2120,12 @@ type ChecklistItemHistory {
   detailType: String!
   id: ID!
   inspctionCriteria: String
+  kcsCriteria: String
   loggedAt: DateTimeISO
   mainType: String!
   name: String
   sequence: Float
+  siteSpecCriteria: String
   supervisoryConfirmStatus: String
   updater: User
 }
@@ -1876,8 +2138,10 @@ type ChecklistItemHistoryList {
 input ChecklistItemInputType {
   detailType: String!
   inspctionCriteria: String
+  kcsCriteria: String
   mainType: String!
   name: String!
+  siteSpecCriteria: String
 }
 
 type ChecklistItemList {
@@ -1929,6 +2193,7 @@ type ChecklistTemplateItem {
   detailTypeName: String!
   id: ID!
   inspctionCriteria: String
+  inspctionCriteriaText: String
   mainType: String!
   name: String!
   sequence: Int
@@ -1948,6 +2213,7 @@ input ChecklistTemplateItemPatch {
   detailType: String
   id: ID
   inspctionCriteria: String
+  inspctionCriteriaText: String
   mainType: String
   name: String
   sequence: Int
@@ -1987,16 +2253,6 @@ input ChecklistTypePatch {
   mainType: String
 }
 
-input CodeDecipherInput {
-  code: String!
-  language: String
-  system: String
-}
-
-type CodeDecipherOutput {
-  message: String
-}
-
 """Entity for CommonCode"""
 type CommonCode {
   createdAt: DateTimeISO
@@ -2079,6 +2335,11 @@ type Connection {
   """Unique identifier for the connection."""
   id: ID!
 
+  """
+  Inheritance mode for child domains. ISOLATE = per-child instance with isolated session. SHARE = shared parent instance. null = use Connector default (falls back to ISOLATE).
+  """
+  inheritanceMode: ConnectionInheritanceMode
+
   """The name of the connection."""
   name: String!
 
@@ -2103,6 +2364,14 @@ type Connection {
   updater: User
 }
 
+"""
+Child domain inheritance mode — ISOLATE: per-child instance with isolated session/credentials. SHARE: single parent instance reused by all children.
+"""
+enum ConnectionInheritanceMode {
+  ISOLATE
+  SHARE
+}
+
 """A paginated list of connections."""
 type ConnectionList {
   """The list of connection items."""
@@ -2134,6 +2403,11 @@ input ConnectionPatch {
   """The unique identifier of the connection to update."""
   id: ID
 
+  """
+  Inheritance mode for child domains. ISOLATE = per-child instance. SHARE = shared parent instance. null = use connector default.
+  """
+  inheritanceMode: ConnectionInheritanceMode
+
   """The new name for the connection."""
   name: String
 
@@ -2163,6 +2437,11 @@ type ConnectionState {
   """The unique identifier of the connection."""
   id: String
 
+  """
+  Inheritance mode for child domains. ISOLATE = per-child instance. SHARE = shared parent instance. null = use connector default (falls back to ISOLATE).
+  """
+  inheritanceMode: ConnectionInheritanceMode
+
   """The name of the connection."""
   name: String
 
@@ -2210,6 +2489,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
@@ -2244,6 +2585,7 @@ type ConstructionType {
   domain: Domain
   id: ID!
   name: String
+  projectType: String
   updatedAt: DateTimeISO
   updater: User
 }
@@ -2258,6 +2600,7 @@ input ConstructionTypePatch {
   description: String
   id: ID
   name: String
+  projectType: String
 }
 
 """Entity for Contact"""
@@ -2332,6 +2675,11 @@ type Data {
   The tag name attached to the data, used for filtering and identification.
   """
   tag: String!
+
+  """
+  Server publish timestamp in epoch milliseconds, stamped at delivery. Used by clients to monitor data delivery lag.
+  """
+  ts: Float
 }
 
 """
@@ -2500,15 +2848,18 @@ input DataItemPatch {
 
 """type enumeration of a data-item"""
 enum DataItemType {
+  audio
   boolean
   date
   datetime
   file
+  image
   number
   radio
   select
   signature
   text
+  video
 }
 
 """
@@ -3539,6 +3890,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."""
@@ -3976,6 +4348,42 @@ input EnvVarPatch {
   value: String
 }
 
+"""Resolved state of an EnvVar key with ancestor closest-wins lookup."""
+type EnvVarResolution {
+  """EnvVar id (only when found in any domain)."""
+  envVarId: String
+  hasValue: Boolean!
+  key: String!
+  sourceDomainId: String
+  sourceDomainName: String
+  status: String!
+
+  """
+  Resolved value when found. Client decides masking based on propertySpec type.
+  """
+  value: String
+}
+
+"""외부 시스템(세움터/올바로/키스콘) 데이터 수집 시나리오 호출 결과"""
+type ExternalDataCollectionResult {
+  """
+  시나리오 result 객체 — projectKey: value 맵. 세움터={area, floorAreaRatio, upperFloorCount, lowerFloorCount, structureType, siteType}, 올바로={totalConstructionWasteAmount}, 키스콘={constructionPeriod, constructionCost}. siteType (건축물 용도, 예 APARTMENT_COMPLEX) / structureType (구조형태) 는 BuildingComplex 의 시설유형/구조유형 속성 후보. KISCON 의 "공사유형(신설/증축)" 은 DSSP SiteType (용도분류) 와 다른 도메인이라 매핑 대상 아님.
+  """
+  data: Object
+
+  """표시 라벨 (세움터/올바로/키스콘)"""
+  label: String!
+
+  """성공 시 "완료", 실패 시 에러 메시지"""
+  message: String!
+
+  """시나리오 실행 성공 여부"""
+  ok: Boolean!
+
+  """소스 키: saeumteo | allbaro | kiscon"""
+  source: String!
+}
+
 """Entity for Favorite"""
 type Favorite {
   createdAt: DateTimeISO
@@ -3993,6 +4401,48 @@ type FavoriteList {
   total: Int!
 }
 
+"""Entity for FieldDocument"""
+type FieldDocument {
+  aiSummary: String
+  aiSummaryStatus: FieldDocumentSummaryStatus
+  code: String!
+  createdAt: DateTimeISO
+  creator: User
+  deletedAt: DateTimeISO
+  domain: Domain
+
+  """파일 크기"""
+  fileSize: String
+
+  """첨부파일 fullpath"""
+  fullpath: String
+  id: ID
+  isFavorite: Boolean
+  name: String!
+  projectId: String!
+  sourceRefId: String
+  sourceType: String
+  updatedAt: DateTimeISO
+  updater: User
+}
+
+type FieldDocumentCodeCount {
+  code: String!
+  count: Int!
+}
+
+type FieldDocumentList {
+  items: [FieldDocument!]!
+  total: Int!
+}
+
+"""AI 문서 요약 요청 상태"""
+enum FieldDocumentSummaryStatus {
+  FAIL
+  REQUEST
+  SUCCESS
+}
+
 """Input type for specifying a filter condition in a list query."""
 input Filter {
   """The field name to apply the filter on."""
@@ -4098,14 +4548,68 @@ input GroupPatch {
   name: String
 }
 
-input ImageCompletionInput {
-  count: Float!
-  description: String!
-  size: 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 ImageCompletionOutput {
-  images: 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
 }
 
 """
@@ -4281,6 +4785,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.
 """
@@ -4361,6 +4870,11 @@ type Kpi {
   """
   scoreFormula: String
 
+  """
+  value → score 변환 방식. NONE: 미설정, DIRECT: value=score(변환 없음), FORMULA: scoreFormula 수식, LOOKUP: grade table(1D), CUSTOM: 2D 룩업 등 특수 변환.
+  """
+  scoreType: KpiScoreType
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: String
   targetValue: Float
@@ -4385,6 +4899,11 @@ type Kpi {
     orgScope: String
   ): KpiValue
 
+  """
+  value 획득 방식. MEASURED: 외부 시스템 수집 측정값, ASSESSED: 감리자 직접 평가(1~5), CALCULATED: formula 자동 계산, COMPOSITE: 다차원 룩업 결과.
+  """
+  valueType: KpiValueType
+
   """
   Version number of the KPI. Increments on each modification. When the KPI is released, a snapshot is saved in kpi-history and the status becomes RELEASED. Editing after release increases the version and sets status to DRAFT.
   """
@@ -4420,6 +4939,30 @@ type KpiAlert {
   message: String!
 }
 
+type KpiComprehensiveStats {
+  avgVal: Float!
+  kpiName: String
+  maxVal: Float!
+  medVal: Float!
+  minVal: Float!
+  projectCount: Int!
+  q1Val: Float!
+  q3Val: Float!
+}
+
+type KpiComprehensiveStatsByGeoGroup {
+  address: String
+  avgVal: Float!
+  geoGroup: String
+  kpiName: String
+  maxVal: Float!
+  medVal: Float!
+  minVal: Float!
+  projectCount: Int!
+  q1Val: Float!
+  q3Val: Float!
+}
+
 """History Entity of Kpi"""
 type KpiHistory {
   """Whether this KPI is active (usable) or not."""
@@ -4498,12 +5041,18 @@ type KpiMetric {
   """Unique identifier for this KPI metric."""
   id: ID!
 
+  """metric 확장 설정(input/kind/source 등). 입력 UI·소스 바인딩 등을 담는 네임스페이스."""
+  meta: Object
+
   """Metric code, unique within the domain, used in KPI formulas."""
   name: String!
 
   """Aggregation period type for this metric."""
   periodType: KpiPeriodType!
 
+  """목록 표시 순서(오름차순). 미지정(null)은 뒤로 정렬."""
+  rank: Int
+
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
   """
@@ -4553,15 +5102,21 @@ input KpiMetricPatch {
   """데이터 수집 방식"""
   collectType: KpiMetricCollectType
   cuFlag: String
-  dataSetId: ID
+  dataSet: ObjectRef
   description: String
   fieldName: String
   id: ID
+
+  """확장 메타(JSON). 입력 위젯 힌트(meta.input) 등. 스키마 변경 없이 확장."""
+  meta: Object
   name: String
 
   """Aggregation period type for this metric."""
   periodType: KpiPeriodType
 
+  """목록 표시 순서(오름차순). 미지정(null)은 뒤로 정렬."""
+  rank: Int
+
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
   """
@@ -4596,7 +5151,7 @@ type KpiMetricValue {
   """
   org: String
   periodType: KpiPeriodType!
-  project: Project!
+  project: Project
   unit: String
   updatedAt: DateTimeISO
   updater: User
@@ -4652,6 +5207,13 @@ input KpiMetricValuePatch {
   valueDate: String
 }
 
+type KpiMonthlyTrend {
+  avgVal: Float!
+  geoGroup: String
+  projectCount: Int!
+  yearMonth: String!
+}
+
 """
 KPI organization scope mapping entity. Maps business entities to various scope dimensions for KPI analysis using generic reference pattern.
 """
@@ -4797,6 +5359,9 @@ input KpiPatch {
   """
   scoreFormula: String
 
+  """value → score 변환 방식."""
+  scoreType: KpiScoreType
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: KpiStatus
 
@@ -4806,6 +5371,9 @@ input KpiPatch {
   """Timezone for the KPI schedule."""
   timezone: String
 
+  """value 획득 방식."""
+  valueType: KpiValueType
+
   """
   Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.
   """
@@ -4833,6 +5401,19 @@ enum KpiPeriodType {
   YEAR
 }
 
+type KpiProjectStat {
+  avgVal: Float!
+  categoryName: String
+  kpiName: String!
+  maxVal: Float!
+  medVal: Float!
+  minVal: Float!
+  projectCount: Int!
+  q1Val: Float!
+  q3Val: Float!
+  stddevVal: Float!
+}
+
 """
 Defines the meaning and metadata for each scope level (scope01~05) in KpiOrgScope
 """
@@ -4929,6 +5510,16 @@ input KpiScopePatch {
   validationPattern: String
 }
 
+"""
+value → score 변환 방식. DIRECT: value=score(변환 없음), FORMULA: scoreFormula 수식 적용, LOOKUP: grade table(1D) 매핑, CUSTOM: 2D 룩업 등 특수 변환.
+"""
+enum KpiScoreType {
+  CUSTOM
+  DIRECT
+  FORMULA
+  LOOKUP
+}
+
 """
 KPI Statistics Entity - Stores comprehensive statistical information for KPIs and Categories including central tendency measures (mean, median), dispersion metrics (standard deviation, variance), range indicators (min, max), and percentile distributions (25th, 75th percentiles, IQR). Supports both KPI and Category targets with flexible period-based aggregation (daily, weekly, monthly, yearly). Includes extensible JSON fields for additional metrics and metadata for calculation tracking.
 """
@@ -5109,7 +5700,7 @@ type KpiValue {
   project: Project!
 
   """
-  Performance score calculated from KPI value using scoreFormula or grades lookup table. Range: 0-1.
+  Performance score calculated from KPI value using scoreFormula or grades lookup table.
   """
   score: Float
 
@@ -5200,6 +5791,21 @@ input KpiValuePatch {
   version: Int
 }
 
+"""
+value 획득 방식. MEASURED: 외부 시스템 수집 측정값, ASSESSED: 감리자 직접 평가(1~5), CALCULATED: formula 자동 계산, COMPOSITE: 다차원 복합 입력 결과.
+"""
+enum KpiValueType {
+  ASSESSED
+  CALCULATED
+  COMPOSITE
+  MEASURED
+}
+
+type KpiValuesObject {
+  kpiName: String!
+  value: Float!
+}
+
 """Visualization type for KPI display (CARD, GAUGE, PROGRESS, etc.)"""
 enum KpiVizType {
   BADGE
@@ -5336,6 +5942,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!]!
@@ -5714,6 +6347,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!
 
@@ -5734,6 +6370,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."""
@@ -5763,7 +6407,15 @@ type Mutation {
   """
   Clones a board from an existing one, potentially into a different domain.
   """
-  cloneBoard(id: String!, patch: BoardPatch!, targetGroupId: String, targetSubdomain: String!): Board!
+  cloneBoard(id: String!, patch: BoardPatch!, targetGroupId: String, targetSubdomain: String!): Board!
+
+  """Run only 건축물관리대장조회 scenario for project basic info collection."""
+  collectProjectBasicInfo(address: String, projectId: String!): ExternalDataCollectionResult!
+
+  """
+  Run external data collection scenarios per system, returning per-system result.
+  """
+  collectProjectExternalData(projectId: String!): [ExternalDataCollectionResult!]!
 
   """Establishes a live connection to a configured endpoint."""
   connectConnection(name: String!): Connection!
@@ -5822,6 +6474,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!
 
@@ -5898,6 +6560,12 @@ type Mutation {
   """To create new Favorite"""
   createFavorite(favorite: NewFavorite!): Favorite!
 
+  """현장 문서 생성"""
+  createFieldDocument(patch: NewFieldDocument!): FieldDocument!
+
+  """현장 문서 다건 생성"""
+  createFieldDocuments(patches: [NewFieldDocument!]!): [FieldDocument!]!
+
   """To create new Font"""
   createFont(font: NewFont!): Font!
 
@@ -6003,6 +6671,9 @@ type Mutation {
   """프로젝트 생성"""
   createProject(project: NewProject!): Project!
 
+  """프로젝트 체크리스트 생성"""
+  createProjectChecklist(constructionDetailTypeId: String!, constructionTypeId: String!, items: [ProjectChecklistItemInput!]!, name: String!, projectId: String!, siteSpecPdfUrl: String): ProjectChecklist!
+
   """To create new ProjectReport"""
   createProjectReport(projectReport: NewProjectReport!): ProjectReport!
 
@@ -6169,6 +6840,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!
 
@@ -6294,6 +6971,9 @@ type Mutation {
   """To delete Favorite"""
   deleteFavorite(routing: String!): Boolean!
 
+  """현장 문서 삭제"""
+  deleteFieldDocuments(ids: [String!]!): Boolean!
+
   """To delete Font"""
   deleteFont(id: String!): Boolean!
 
@@ -6456,6 +7136,9 @@ type Mutation {
   """To delete Project"""
   deleteProject(id: String!): Boolean!
 
+  """프로젝트 체크리스트 삭제"""
+  deleteProjectChecklists(ids: [String!]!): Boolean!
+
   """To delete ProjectReport"""
   deleteProjectReport(id: String!): Boolean!
 
@@ -6553,6 +7236,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.
   """
@@ -6629,6 +7315,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!]!
 
@@ -6772,6 +7461,14 @@ 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!
+
+  """문서 폴더 이동"""
+  moveFieldDocuments(ids: [String!]!, targetCode: String!): Boolean!
   multipleUpload(files: [Upload!]!): [Attachment!]!
 
   """
@@ -6779,12 +7476,23 @@ type Mutation {
   """
   pickActivityInstance(id: String!): ActivityThread
 
+  """프로젝트를 테넌트로 승격 (관리번호 발번 + project 카테고리 Domain 생성)"""
+  promoteProjectToTenant(projectId: String!): Project!
+
   """기존 KPI Value 인스턴스를 현재 formula/metric 값으로 재계산"""
   recalculateKpiValue(id: String!): KpiValue!
 
+  """Recalculate project KPI without finalizing (interim)."""
+  recalculateProjectKpi(projectId: String!): Boolean!
+
   """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)."""
@@ -6836,8 +7544,17 @@ 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!
 
+  """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!
 
@@ -6858,6 +7575,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.
   """
@@ -6877,6 +7597,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.
   """
@@ -6922,6 +7647,14 @@ type Mutation {
   synchronizePrivilegeMaster(privilege: NewPrivilege!): Boolean!
   terminateContract(partnerName: String!): Boolean!
 
+  """즐겨찾기 토글"""
+  toggleFieldDocumentFavorite(id: String!): FieldDocument!
+
+  """
+  Presence heartbeat — bump current user's lastSeenAt in the session (online indicator).
+  """
+  touchPresence(sessionId: String!): Boolean!
+
   """
   Transfers domain ownership to another user. Use this mutation to assign the owner role to a different user within the domain.
   """
@@ -7076,7 +7809,7 @@ type Mutation {
   updateKpiMetricValuesCumulative(patches: [KpiMetricValuePatch!]!): [KpiMetricValue!]!
 
   """To modify multiple sentiment KpiMetricValues' value"""
-  updateKpiMetricValuesSentiment(patches: [KpiMetricValuePatch!]!): [KpiMetricValue!]!
+  updateKpiMetricValuesSentiment(attachment: NewAttachment!): Attachment
 
   """Update a scope dimension definition"""
   updateKpiScope(id: String!, patch: KpiScopePatch!): KpiScope!
@@ -7150,6 +7883,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!]!
 
@@ -7345,6 +8084,9 @@ type Mutation {
   """프로젝트 업데이트 (중복 사용 금지)"""
   updateProject(project: ProjectPatch!): Project!
 
+  """프로젝트 체크리스트 수정"""
+  updateProjectChecklist(id: String!, items: [ProjectChecklistItemInput!]!, name: String!, siteSpecPdfUrl: String): ProjectChecklist!
+
   """프로젝트 도면 업데이트"""
   updateProjectPlan(project: ProjectPatch!): Project!
 
@@ -7428,6 +8170,9 @@ type Mutation {
 
   """프로젝트 공정표 업로드"""
   uploadProjectScheduleTable(param: UploadProjectScheduleTable!): Boolean!
+
+  """공종+세부공종 조합으로 find-or-create"""
+  upsertConstructionChecklistTemplate(constructionDetailTypeId: String!, constructionTypeId: String!): ConstructionChecklistTemplate!
 }
 
 input NewActionPlan {
@@ -7673,6 +8418,11 @@ input NewConnection {
   """The endpoint URL or address for the new connection."""
   endpoint: String
 
+  """
+  Inheritance mode for child domains. ISOLATE = per-child instance. SHARE = shared parent instance. null = use connector default.
+  """
+  inheritanceMode: ConnectionInheritanceMode
+
   """The name for the new connection."""
   name: String!
 
@@ -7983,6 +8733,17 @@ input NewFavorite {
   routing: String!
 }
 
+input NewFieldDocument {
+  """AI 브리핑 힌트용 분류 문자열 (대 · 중 · 소분류)"""
+  category: String
+  code: String!
+  file: Upload
+  name: String!
+  projectId: String!
+  sourceRefId: String
+  sourceType: String
+}
+
 input NewFont {
   active: Boolean
   files: [Upload!]
@@ -8047,6 +8808,9 @@ input NewKpi {
   """
   scoreFormula: String
 
+  """value → score 변환 방식."""
+  scoreType: KpiScoreType
+
   """Current state of the KPI (DRAFT, RELEASED, ARCHIVED)."""
   state: KpiStatus
 
@@ -8056,6 +8820,9 @@ input NewKpi {
   """Timezone for the KPI schedule."""
   timezone: String
 
+  """value 획득 방식."""
+  valueType: KpiValueType
+
   """
   Visualization options and metadata for this KPI, such as color, icon, thresholds, unit, decimal places, etc.
   """
@@ -8080,8 +8847,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
@@ -8089,12 +8856,18 @@ input NewKpiMetric {
   """Name of the field in the dataset this metric maps to."""
   fieldName: String
 
+  """확장 메타(JSON). 입력 위젯 힌트(meta.input) 등. 스키마 변경 없이 확장."""
+  meta: Object
+
   """Metric code, unique within the domain, used in KPI formulas."""
   name: String!
 
   """Aggregation period type for this metric."""
   periodType: KpiPeriodType
 
+  """목록 표시 순서(오름차순). 미지정(null)은 뒤로 정렬."""
+  rank: Int
+
   """
   Cron schedule string for periodic KPI value aggregation (e.g., "0 0 * * *" for daily).
   """
@@ -9230,6 +10003,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."""
@@ -9494,7 +10287,9 @@ input ProfileInput {
 """프로젝트"""
 type Project {
   buildingComplex: BuildingComplex
-  completeReports: [Attachment!]!
+  buildingUsage: String
+  code: String
+  completeReport: Attachment
   createdAt: DateTimeISO
   creator: User
   deletedAt: DateTimeISO
@@ -9506,6 +10301,7 @@ type Project {
   inputType: String
   inspPassRate: Float
   kpi: Float
+  kpiValues: [KpiValuesObject!]!
   mainPhoto: Attachment
   name: String!
   postalCode: String
@@ -9514,16 +10310,68 @@ type Project {
   robotProgressRate: Float
   rootTasks: [Task!]
   scheduleTable: Attachment
+  sectorType: String
+  siteSpecPdfUrl: String
   startDate: String
   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
+  kcsCriteria: String
+  mainType: String
+  name: String!
+  projectChecklist: ProjectChecklist
+  sequence: Int
+  siteSpecCriteria: String
+  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!]!
@@ -9545,12 +10393,18 @@ input ProjectPatch {
   """연관된 건물 복합체 정보 (선택 사항)"""
   buildingComplex: BuildingComplexPatch
 
+  """건물 용도 (RESIDENTIAL: 주거, NON_RESIDENTIAL: 비주거)"""
+  buildingUsage: String
+
   """프로젝트 문서 네이밍"""
   documentNaming: String
 
   """프로젝트 준공일정"""
   endDate: String
 
+  """지역 구분 코드 (시군구 식별, 통계 그룹핑용)"""
+  geoGroup: String
+
   """수정할 프로젝트의 ID"""
   id: String!
 
@@ -9564,7 +10418,10 @@ input ProjectPatch {
   mainPhotoUpload: Upload
 
   """프로젝트 이름"""
-  name: String!
+  name: String
+
+  """우편 코드 (5자리)"""
+  postalCode: String
 
   """로봇 작업 대수"""
   robotCount: Int
@@ -9572,9 +10429,18 @@ input ProjectPatch {
   """로봇 작업 진행율 (%)"""
   robotProgressRate: Float
 
+  """발주 유형 (PUBLIC: 공공, PRIVATE: 민간)"""
+  sectorType: String
+
+  """현장 시방서 PDF URL (https 전체 URL)"""
+  siteSpecPdfUrl: String
+
   """프로젝트 착공일정"""
   startDate: String
 
+  """프로젝트 상태 (ONGOING/COMPLETED)"""
+  state: ProjectState
+
   """구조 안전도 (%)"""
   structuralSafetyRate: Float
 
@@ -9626,6 +10492,12 @@ enum ProjectReportStatus {
   STATUS_B
 }
 
+"""프로젝트 상태 (ONGOING=10 진행중, COMPLETED=20 완료)"""
+enum ProjectState {
+  COMPLETED
+  ONGOING
+}
+
 """
 Describes a single property for a component or a step, used for UI rendering and configuration.
 """
@@ -9659,8 +10531,6 @@ type PropertySpec {
 }
 
 type Query {
-  APIDocCompletion(input: APIDocCompletionInput!): APIDocCompletionOutput!
-
   """To fetch a ActionPlan"""
   actionPlan(id: String!): ActionPlan
 
@@ -10009,8 +10879,14 @@ type Query {
     sortings: [Sorting!]
   ): AuthProviderList!
 
-  """Finds a single board by its ID."""
-  board(id: String!): Board!
+  """
+  Finds a single board by its ID. If cachedUpdatedAt matches, model is omitted.
+  """
+  board(
+    """Client cache timestamp — if matches, model field is omitted"""
+    cachedUpdatedAt: String
+    id: String!
+  ): Board!
 
   """Finds a single board by its name."""
   boardByName(name: String!): Board
@@ -10087,6 +10963,11 @@ type Query {
     sortings: [Sorting!]
   ): BoardList!
 
+  """
+  Retrieves boards that have been updated or soft-deleted since the given timestamp.
+  """
+  boardsUpdatedSince(since: DateTimeISO!): [Board!]!
+
   """To fetch a building"""
   building(id: String!): Building
 
@@ -10097,9 +10978,15 @@ type Query {
   buildingInspection(id: String!): BuildingInspection
   buildingInspectionDailyWorklogByProjectIdAndDate(date: String!, projectId: String!): BuildingInspectionDailyWorklog
 
+  """To fetch BuildingInspection Date Summary of Building"""
+  buildingInspectionDateSummaryOfBuilding(buildingId: String!, endDate: String!, startDate: String!): [BuildingInspectionSummary!]
+
   """To fetch a BuildingInspection Summary"""
   buildingInspectionDateSummaryOfLevelAndPeriod(buildingLevelId: String!, endDate: String!, startDate: String!): [BuildingInspectionSummary!]
 
+  """To fetch BuildingInspection Date Summary of Project"""
+  buildingInspectionDateSummaryOfProject(endDate: String!, projectId: String!, startDate: String!): [BuildingInspectionSummary!]
+
   """To fetch multiple BuildingInspections"""
   buildingInspectionHistories(
     """An array of filter conditions to apply to the list query."""
@@ -10118,6 +11005,9 @@ type Query {
   """To fetch a BuildingInspectionHistory"""
   buildingInspectionHistory(id: String!): BuildingInspectionHistory
 
+  """To fetch BuildingInspection Summary of Building"""
+  buildingInspectionSummaryOfBuilding(buildingId: String!): BuildingInspectionSummary
+
   """To fetch a BuildingInspection Summary"""
   buildingInspectionSummaryOfBuildingLevel(buildingLevelId: String!): BuildingInspectionSummary
 
@@ -10139,6 +11029,9 @@ type Query {
     sortings: [Sorting!]
   ): BuildingInspectionList!
 
+  """To fetch BuildingInspections of Building"""
+  buildingInspectionsOfBuilding(params: BuildingInspectionsOfBuilding!): BuildingInspectionList!
+
   """To fetch multiple BuildingInspections"""
   buildingInspectionsOfBuildingLevel(params: BuildingInspectionsOfBuildingLevel!): BuildingInspectionList!
 
@@ -10147,7 +11040,28 @@ type Query {
 
   """To fetch a building level"""
   buildingLevel(id: String!): BuildingLevel
-  chatCompletion(input: ChatCompletionInput!): ChatCompletionOutput!
+
+  """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.
@@ -10376,6 +11290,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."""
@@ -10426,6 +11370,12 @@ type Query {
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): ContactList!
+
+  """현재 테넌트 컨텍스트(extType=project)의 프로젝트. subdomain(=Project.code) 으로 조회."""
+  currentProject: Project
+
+  """프로젝트 타입 조회"""
+  currentProjectType: String!
   customers: [Domain!]!
   dailyWorklogDatesOfProject(endDate: String!, projectId: String!, startDate: String!): [BuildingInspectionDailyWorklog!]!
 
@@ -10784,8 +11734,6 @@ type Query {
     """Sorting options for the list query."""
     sortings: [Sorting!]
   ): [DynamicDataSummary!]!
-  decipherCode(input: CodeDecipherInput!): CodeDecipherOutput!
-  decipherErrorCode(input: CodeDecipherInput!): CodeDecipherOutput!
 
   """To fetch a Department"""
   department(id: String!): Department
@@ -10843,11 +11791,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.
   """
@@ -10974,6 +11935,11 @@ type Query {
   """To fetch a EntityMetadata"""
   entityMetadata(name: String!): EntityMetadata!
   envVar(id: String!): EnvVar
+
+  """
+  Resolves a batch of EnvVar keys with ancestor closest-wins inheritance.
+  """
+  envVarResolutions(keys: [String!]!): [EnvVarResolution!]!
   envVars(
     """An array of filter conditions to apply to the list query."""
     filters: [Filter!]
@@ -11024,6 +11990,15 @@ type Query {
   """Fetches the current state of a single connection by its name."""
   fetchConnectionState(name: String!): ConnectionState!
 
+  """단건 문서 상세 조회"""
+  fieldDocument(id: String!): FieldDocument
+
+  """프로젝트별 분류 코드당 문서 수"""
+  fieldDocumentCountsByProject(projectId: String!): [FieldDocumentCodeCount!]!
+
+  """소분류 코드별 문서 목록 조회"""
+  fieldDocumentsByCode(code: String!, projectId: String!): FieldDocumentList!
+
   """To fetch a Font"""
   font(id: String!): Font!
 
@@ -11067,8 +12042,12 @@ type Query {
 
   """To query whether I have the given permission"""
   hasPrivilege(category: String!, privilege: String!): Boolean!
-  i18nCompletion(input: i18nCompletionInput!): i18nCompletionOutput!
-  imageCompletion(input: ImageCompletionInput!): ImageCompletionOutput!
+
+  """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!
@@ -11132,6 +12111,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
 
@@ -11177,7 +12159,7 @@ type Query {
     id: String!
   ): KpiMetricValue
 
-  """To fetch multiple KpiMetricValues"""
+  """To fetch multiple KpiMetricValues (cross-domain admin view)"""
   kpiMetricValues(
     """An array of filter conditions to apply to the list query."""
     filters: [Filter!]
@@ -11249,6 +12231,11 @@ type Query {
     searchTerm: String
   ): [String!]!
 
+  """
+  Get KPI stats aggregated from project data with optional sectorType/buildingUsage filters
+  """
+  kpiProjectStats(buildingUsage: String, endYearMonth: String, kpiNamePattern: String, sectorType: String, startYearMonth: String): [KpiProjectStat!]!
+
   """Fetch a scope dimension definition by ID"""
   kpiScope(id: String!): KpiScope
 
@@ -11309,6 +12296,29 @@ type Query {
     sortings: [Sorting!]
   ): KpiValueList!
 
+  """Get KPI box plot statistics for Y-category KPIs by geo group"""
+  kpiYValueComprehensiveStatsByGeoGroup(geoGroup: String): [KpiComprehensiveStatsByGeoGroup!]!
+
+  """Get Y-level KPI statistics by geo_group code (sigungu)"""
+  kpiYValueStatsByGeoGroup(buildingUsage: String, endYearMonth: String, geoGroup: String!, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+
+  """Get KPI statistics for Y-category KPIs by specific metro area"""
+  kpiYValueStatsByMetroArea(buildingUsage: String, endYearMonth: String, metroArea: String!, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+
+  """Get KPI box plot statistics for Z-category KPIs by metro area"""
+  kpiZValueComprehensiveStatsByGeoGroup(buildingUsage: String, endYearMonth: String, geoGroup: String, kpiName: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStatsByGeoGroup!]!
+
+  """Get monthly KPI trend for Z-category KPIs by metro area"""
+  kpiZValueMonthlyTrendByGeoGroup(buildingUsage: String, endYearMonth: String, kpiName: String, sectorType: String, startYearMonth: String): [KpiMonthlyTrend!]!
+
+  """
+  Get monthly KPI trend for Z-category KPIs for a specific sigungu (geo_group code)
+  """
+  kpiZValueMonthlyTrendBySigungu(buildingUsage: String, endYearMonth: String, geoGroup: String!, kpiName: String, sectorType: String, startYearMonth: String): [KpiMonthlyTrend!]!
+
+  """Get KPI statistics by sigungu (geo_group code) level"""
+  kpiZValueStatsBySigungu(buildingUsage: String, endYearMonth: String, kpiName: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStatsByGeoGroup!]!
+
   """To fetch multiple Kpis"""
   kpis(
     """An array of filter conditions to apply to the list query."""
@@ -11337,6 +12347,23 @@ type Query {
     rootId: String
   ): [Kpi!]!
 
+  """
+  Fetch latest-version KpiValues only — one row per (domain, kpi, valueDate, kpiOrgScope).
+  """
+  latestKpiValues(
+    """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!]
+  ): KpiValueList!
+
   """To fetch a LiteMenu"""
   liteMenu(id: String!): LiteMenu!
 
@@ -11785,6 +12812,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
 
@@ -11803,6 +12860,11 @@ type Query {
     sortings: [Sorting!]
   ): ProjectReportList!
 
+  """
+  To fetch KpiValues by project group with X prefix kpi names (latest valueDate only)
+  """
+  projectXKpiValues(projectId: String!): [KpiValue!]!
+
   """프로젝트 리스트"""
   projects(
     """An array of filter conditions to apply to the list query."""
@@ -11992,6 +13054,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."""
@@ -12126,6 +13196,12 @@ type Query {
     sortings: [Sorting!]
   ): ActivityThreadList!
 
+  """Get KPI box plot statistics for Y-category KPIs for all projects"""
+  totalKpiYValueComprehensiveStats(buildingUsage: String, endYearMonth: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+
+  """Get KPI box plot statistics for Z-category KPIs for all projects"""
+  totalKpiZValueComprehensiveStats(buildingUsage: String, endYearMonth: String, sectorType: String, startYearMonth: String): [KpiComprehensiveStats!]!
+
   """Fetches a user by their email address within the current domain."""
   user(
     """The email address of the user to fetch."""
@@ -12906,6 +13982,16 @@ type Subscription {
   """Subscribes to real-time updates for a specific board."""
   board(id: String!): Board!
 
+  """
+  Subscribes to board edit patches (AI or user-direct) for real-time collaboration on a board.
+  """
+  boardPatchActivity(boardId: String!): PatchEntry!
+
+  """
+  Subscribes to chat messages (user / assistant / system) of a session for real-time group chat.
+  """
+  chatMessageActivity(sessionId: String!): ChatMessage!
+
   """Subscribes to log messages from connections."""
   connectionLog(level: String): Log!
 
@@ -12932,6 +14018,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
@@ -13233,6 +14329,21 @@ input ThemePatch {
   value: Object
 }
 
+"""썸네일 백필 결과"""
+type ThumbnailBackfillResult {
+  """이번 호출에서 처리 시도한 첨부 개수"""
+  attempted: Int!
+
+  """실패(생성 실패/콘텐츠 없음 등) 개수"""
+  failed: Int!
+
+  """이번 처리 후에도 남아있는 썸네일 미생성 후보 개수 (대략치). 0 이면 완료"""
+  remaining: Int!
+
+  """썸네일 생성·저장 성공 개수"""
+  succeeded: Int!
+}
+
 input UpdateBuildingInspection {
   drawingMarker: String
   id: String!
@@ -13244,6 +14355,7 @@ input UpdateBuildingInspectionSubmitType {
   checklistItem: [ChecklistItemSubmitInputType!]!
   id: String!
   memo: String
+  requestDate: String
 }
 
 input UpdateTaskChecklistSubmitType {
@@ -13500,12 +14612,4 @@ input WorkerTypePatch {
   description: String
   id: ID
   name: String
-}
-
-input i18nCompletionInput {
-  json: String!
-}
-
-type i18nCompletionOutput {
-  message: String
 }