@flextudio/scenario 0.1.0

package/skill/schemas/patterns/molecule/input-pair.schema.json

@@ -0,0 +1,210 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/patterns/molecule/input-pair.schema.json",
+  "title": "pattern.molecule.input-pair",
+  "description": "두 개의 입력 컨트롤이 가로로 나란히 50%/50% 로 배치되는 페어 (molecule). 쿼리/필터 행에 자주 쓰이는 'duo' 구조 — 예: 부서(inputCombo) + 담당자(inputSearch), 시작일(inputDate) + 종료일(inputDate), 기간(inputCombo) + 상태(inputCombo). 두 입력은 서로 다른 inputType 을 가질 수 있다 (per-item). 각 입력은 Caption(입력 위 라벨) 을 옵션으로 가질 수 있으며 Caption 유무에 따라 Height 가 68px(라벨 포함) / 44px(라벨 없음) 로 자동 결정.\n\nbgColor 가 있으면 'carded' 모드 — wrapper 에 라이트 톤 배경 + 상하 20px Margin + (8/10) Padding 이 깔리고, 두 입력은 columnGap 8px 로 모이고 border 는 radius-only(시각 hairline 없음) 가 되어 카드 안에 잠긴다. bgColor 가 없으면 'open' 모드 — wrapper 는 투명, columnGap 16px 로 더 여유 있고, 두 입력은 1px Gray4 hairline 으로 페이지 위에 또렷이 선다.\n\n[naming] inputType 식별자 + per-type 옵션 키 prefix — `inputCombo / inputSearch / inputDate`, `comboItems`, `comboDataSourceName`, `comboTitle`, `searchDataSourceName`, `searchTitle`, `searchSubTitle`, `searchKeywordCkey`, `dateFormat`, `dateSelectType`. 공통 키(`name`, `caption`, `placeholder`) 는 접두사 없음.",
+  "x-tier": "molecule",
+  "x-tags": [
+    "input",
+    "pair",
+    "duo",
+    "horizontal",
+    "filter",
+    "query-row",
+    "combo",
+    "search",
+    "date",
+    "mixed"
+  ],
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["inputOptions"],
+  "properties": {
+    "inputOptions": {
+      "type": "array",
+      "minItems": 2,
+      "maxItems": 2,
+      "description": "두 입력 컨트롤의 옵션 (배열 인덱스 0=왼쪽, 1=오른쪽). 각 항목이 자신의 inputType 을 가지며 서로 달라도 된다.",
+      "items": {
+        "type": "object",
+        "additionalProperties": false,
+        "required": ["inputType"],
+        "properties": {
+          "inputType": {
+            "type": "string",
+            "enum": ["inputCombo", "inputSearch", "inputDate"],
+            "description": "입력 컨트롤 종류. inputCombo=Combo(고정 Items 또는 DataSource ComboList), inputSearch=Search(DataSource 기반 Lookup List), inputDate=InputDate(Calendar Dialog)."
+          },
+          "caption": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 30,
+            "description": "입력 컨트롤 위에 표시되는 라벨 텍스트. 지정 시 Height 68px(라벨 포함), 미지정 시 44px. CaptionStyle 은 고정 (SemiBold 13 left). 다국어/바인딩 토큰 가능."
+          },
+          "placeholder": {
+            "type": "string",
+            "maxLength": 80,
+            "description": "Placeholder 텍스트. 미지정 시 빈 문자열."
+          },
+          "name": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 40,
+            "description": "ControlName / ControlName2 (스튜디오 explorer 식별자 + 데이터 키). 미지정 시 inputType + 인덱스 기반 기본값 (ComboLeft / ComboRight, DateLeft / DateRight, SearchLeft / SearchRight)."
+          },
+          "comboItems": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 8,
+            "items": { "type": "string", "minLength": 1, "maxLength": 30 },
+            "description": "inputType=inputCombo 의 고정 항목 모드. 각 문자열이 ComboList Items[].ItemName + ItemValue 로 매핑. 8개 초과 / 동적 데이터는 comboDataSourceName 사용."
+          },
+          "comboDataSourceName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "inputType=inputCombo 의 DataSource ComboList 모드. comboItems 와 둘 중 하나 필수."
+          },
+          "comboTitle": {
+            "type": "string",
+            "minLength": 1,
+            "description": "inputType=inputCombo + comboDataSourceName 모드의 ComboList 항목 Title 필드 (선택)."
+          },
+          "searchDataSourceName": {
+            "type": "string",
+            "minLength": 1,
+            "description": "inputType=inputSearch 일 때 필수. Dialog 내 List 의 DataSourceName."
+          },
+          "searchTitle": {
+            "type": "string",
+            "minLength": 1,
+            "description": "inputType=inputSearch 일 때 필수. List 의 항목 Title 필드 (보통 검색 결과의 표시 컬럼명)."
+          },
+          "searchSubTitle": {
+            "type": "string",
+            "description": "inputType=inputSearch 일 때 선택. List 의 SubTitle 필드."
+          },
+          "searchKeywordCkey": {
+            "type": "string",
+            "description": "inputType=inputSearch 일 때 선택. 키워드 검색 컬럼키. 지정 시 UseKeywordSearch=true 활성."
+          },
+          "dateFormat": {
+            "type": "string",
+            "enum": ["YYYY-MM-DD", "YYYY.MM.DD", "YYYY/MM/DD", "YYYY-MM"],
+            "description": "inputType=inputDate 일 때. 기본 'YYYY-MM-DD'."
+          },
+          "dateSelectType": {
+            "type": "string",
+            "enum": ["SingleDate", "FromTo"],
+            "description": "inputType=inputDate 의 캘린더 선택 모드. 기본 'SingleDate'. 시작일/종료일 페어는 두 입력 모두 SingleDate."
+          }
+        },
+        "allOf": [
+          {
+            "$comment": "inputCombo 는 comboItems 또는 comboDataSourceName 중 하나 필요.",
+            "if": {
+              "properties": { "inputType": { "const": "inputCombo" } },
+              "required": ["inputType"]
+            },
+            "then": {
+              "anyOf": [
+                { "required": ["comboItems"] },
+                { "required": ["comboDataSourceName"] }
+              ]
+            }
+          },
+          {
+            "$comment": "inputSearch 는 searchDataSourceName + searchTitle 필수.",
+            "if": {
+              "properties": { "inputType": { "const": "inputSearch" } },
+              "required": ["inputType"]
+            },
+            "then": { "required": ["searchDataSourceName", "searchTitle"] }
+          }
+        ]
+      }
+    },
+    "bgColor": {
+      "type": "string",
+      "enum": [
+        "surface",
+        "surface.subtle",
+        "surface.tag",
+        "surface.brand-soft"
+      ],
+      "description": "컨테이너 wrapper 배경 토큰 (_base.style.mjs COLOR 가족 중 surface 톤). 지정 시 wrapper 가 라이트 톤 카드형 쿼리 영역이 되며: 상하 20px Margin + (좌우 10 / 상하 8) Padding 적용, 두 입력 사이 8px gap, 입력 border 는 radius-only(시각 hairline 없음). 미지정 시 wrapper 는 투명, 입력 사이 16px gap, 입력 border 는 1px Gray4 hairline. 일반적 선택: surface.tag (Gray10), surface.subtle (Gray9)."
+    },
+    "override": {
+      "type": "object",
+      "propertyNames": { "enum": ["root", "left", "right"] },
+      "additionalProperties": { "type": "object" },
+      "description": "(L1 escape hatch) 패턴이 노출하지 않는 raw 엔진 메타데이터를 materialized 트리의 특정 노드에 deep-merge 로 주입한다. anchor 로 위치 지정 — root=외부 Group, left=좌측 입력(inputOptions[0]), right=우측 입력(inputOptions[1]). 값은 엔진 필드 패치 객체이며, 어떤 엔진 스키마에든 정의된 필드명만 검증을 통과한다(예: UseDataConnection, UseMove). 배열 필드는 deep-merge 가 아니라 통째 교체된다. 일반 케이스는 props 로 충분하므로 props 로 표현 못 하는 필드가 필요할 때만 사용.",
+      "examples": [
+        { "left": { "UseDataConnection": true } },
+        { "root": { "UseDataConnection": true } }
+      ]
+    }
+  },
+  "examples": [
+    {
+      "inputOptions": [
+        {
+          "inputType": "inputCombo",
+          "name": "duration",
+          "placeholder": "최근 3개월",
+          "comboItems": ["최근 3개월", "최근 6개월"]
+        },
+        {
+          "inputType": "inputCombo",
+          "name": "status",
+          "placeholder": "전체",
+          "comboItems": ["전체", "신청", "승인", "완료"]
+        }
+      ],
+      "bgColor": "surface.tag"
+    },
+    {
+      "inputOptions": [
+        {
+          "inputType": "inputCombo",
+          "name": "replyDept",
+          "caption": "부서선택",
+          "comboItems": [
+            "경영기획팀",
+            "IT전략팀",
+            "시설안전관리팀",
+            "영업팀",
+            "생산팀",
+            "공정개선팀",
+            "제조팀"
+          ]
+        },
+        {
+          "inputType": "inputSearch",
+          "name": "replyUser",
+          "caption": "담당자명",
+          "searchDataSourceName": "UserQuery",
+          "searchTitle": "UserName",
+          "searchKeywordCkey": "UserName"
+        }
+      ]
+    },
+    {
+      "inputOptions": [
+        {
+          "inputType": "inputDate",
+          "caption": "시작일",
+          "placeholder": "YYYY.MM.DD",
+          "dateFormat": "YYYY.MM.DD",
+          "dateSelectType": "SingleDate"
+        },
+        {
+          "inputType": "inputDate",
+          "caption": "종료일",
+          "placeholder": "YYYY.MM.DD",
+          "dateFormat": "YYYY.MM.DD",
+          "dateSelectType": "SingleDate"
+        }
+      ]
+    }
+  ]
+}

package/skill/schemas/scenario.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/scenario.schema.json",
+  "title": "Scenario",
+  "description": "flextudio scenarioMeta 루트. modules/htmlkey/ScenarioTitle/fConverterVersion/Collections 는 고정값 강제.",
+  "$comment": "Compatible flextudio engine: 6.4.x (verified against 6.4 series scenario samples and public/engine source). Engine major bump (6→7) requires new contract version (v2).",
+  "x-engineCompat": {
+    "minEngine": "6.4.0",
+    "testedAgainst": "6.4.x",
+    "verifiedSamples": "flextudio-ai-studio/scenario_sample*/*.json (45 files)",
+    "lastVerified": "2026-05-04"
+  },
+  "type": "object",
+  "required": ["Steps"],
+  "additionalProperties": true,
+  "properties": {
+
+    "modules": {
+      "description": "런타임 모듈 슬롯. 항상 빈 객체 고정.",
+      "const": {}
+    },
+
+    "htmlkey": {
+      "description": "고정값 'stephtml'.",
+      "const": "stephtml"
+    },
+
+    "ScenarioTitle": {
+      "description": "가비지 슬롯. 항상 빈 문자열 '' 고정 (실제 표시명은 fScenarioName 사용).",
+      "const": ""
+    },
+
+    "fScenarioName": {
+      "type": "string",
+      "description": "시나리오 표시명."
+    },
+
+    "fConverterVersion": {
+      "description": "메타 컨버터 버전. 1 고정.",
+      "const": 1
+    },
+
+    "StartSteps": {
+      "type": "array",
+      "description": "진입 StepId 배열. Steps가 있으면 1개 이상 필수.",
+      "items": { "type": "string", "pattern": "^Step[1-9][0-9]*$" }
+    },
+
+    "Steps": {
+      "type": "object",
+      "description": "Step 컨테이너. 키가 StepId, 값이 Step 객체.",
+      "patternProperties": {
+        "^Step[1-9][0-9]*$": { "$ref": "step.schema.json" }
+      },
+      "additionalProperties": false
+    },
+
+    "Language": {
+      "type": "object",
+      "description": "다국어 매핑 ({{key}} 치환 대상)."
+    },
+
+    "Events": {
+      "$ref": "events.schema.json",
+      "description": "시나리오 이벤트 핸들러 맵. 키=핸들러 이름, 값=Action 배열(Script/LinkedEvent/Service/API). 스킬 생성 시 Service/API 액션 금지 — [no-service] strict."
+    },
+
+    "ServiceBinding": {
+      "$ref": "service-binding.schema.json",
+      "description": "서비스 바인딩 맵. 스킬 생성 시 비어있는 객체 {} 만 허용 — [no-service] strict (`strict_no_service:true`). 운영 메타 호환을 위해 형식 정의."
+    },
+
+    "Collections": {
+      "description": "런타임 채움 슬롯. AI 생성 모드에서는 **빈 객체 const 고정** — 스튜디오가 컬렉션키 type 정의를 자동 재생성하므로 AI 는 채우지 않는다. Panel.{Category, CategoryOrder, Collection.Ckeys} 도 동일 정책.",
+      "const": {}
+    },
+
+    "DataSources": {
+      "$ref": "data-sources.schema.json",
+      "description": "명명 DataSource 모음. Combo/RadioBox/Search/Tree/MultiCheckBox/Approval/TimeTable/Scheduler 의 DataSourceName 참조 대상."
+    },
+
+    "__notes": {
+      "type": "array",
+      "description": "비대화형 생성(`flex-scenario gen`) 호출 시 모델이 자기-인터뷰 5질문에 답한 결정 가정. 사용자가 결과 JSON 만 보고도 '어떤 가정으로 만들어졌는가' 를 파악해 redirect 할 수 있게 5~7줄 권장. UI 에 표시되지 않으며 strict-fields 통과용 화이트리스트 슬롯. 진실원본: skill-guides/prompt-interview.md",
+      "items": { "type": "string", "minLength": 1 },
+      "maxItems": 12
+    },
+
+    "Scenario": {
+      "type": "object",
+      "description": "시나리오 옵션. StyleURLs 배열에 외부 JS 라이브러리(Chart.js, 지도 SDK 등) 경로 추가.",
+      "additionalProperties": false,
+      "properties": {
+        "StyleURLs": {
+          "type": "array",
+          "description": "외부 라이브러리 JS 경로 배열. 차트/지도/외부 SDK 등 사용 시 여기에 URL 추가.",
+          "items": { "type": "string" }
+        }
+      }
+    },
+
+    "Panel": {
+      "type": "object",
+      "description": "데이터 모델 슬롯. 키 6개 고정 — AI 생성 시 별도 키 추가 금지. 각 슬롯의 내부 값(Ckeys 배열, Category 객체 등)은 운영 메타에서 채워짐.",
+      "additionalProperties": false,
+      "properties": {
+        "Collection": {
+          "type": "object",
+          "description": "전역 컬렉션. AI 생성 시 { Ckeys: [] } 빈 형태. 운영 메타에서 채울 때는 `_SUID` 시스템 키 + 모든 카테고리 Ckey 합집합. 시스템 게터 (`status`/`isActive`/`length` 등) / JS 빌트인 충돌 키는 schema 차단 (단 `_SUID` 는 시스템 등록 키이므로 예외).",
+          "properties": {
+            "Ckeys": { "$ref": "naming-objects.schema.json#/$defs/ckeysArrayWithSuid" }
+          }
+        },
+        "Category":      {
+          "type": "object",
+          "description": "카테고리 정의. AI 생성 시 빈 객체. 운영 메타에서 채울 때 키(카테고리명) 는 JS 식별자 규칙 + JS 빌트인 충돌 차단 (naming-objects.categoryName).",
+          "propertyNames": { "$ref": "naming-objects.schema.json#/$defs/categoryName" }
+        },
+        "CategoryOrder": {
+          "type": "array",
+          "description": "카테고리 순서. AI 생성 시 빈 배열. Category 키 집합과 정확히 일치해야 함 (validator).",
+          "items": { "$ref": "naming-objects.schema.json#/$defs/categoryName" }
+        },
+        "Table":         { "type": "array",  "description": "AI 생성 시 빈 배열." },
+        "ExternalTable": { "type": "array",  "description": "AI 생성 시 빈 배열." },
+        "AuthKey":       { "type": "array", "maxItems": 0, "description": "★ AI 생성 시 반드시 빈 배열 `[]` — 권한키는 사용자 수동 설정 전용 (schema 레벨 maxItems:0 로 차단)." }
+      }
+    },
+
+    "LastSavedTime": {
+      "type": "number",
+      "description": "마지막 저장 시각 (Unix timestamp, milliseconds). 스튜디오 저장 시 자동 기록 — 실 시나리오 42/45 에 존재. AI 생성 시 누락/0 허용."
+    },
+
+    "FlexSQLService": {
+      "description": "FlexSQL 서비스 이름/버전 매핑 슬롯(getFlexSQLServiceList). 운영 메타에서는 {NameArray, VersionMap} 으로 채워질 수 있으나, AI 생성 시 빈 객체 고정.",
+      "const": {}
+    },
+
+    "EmbedScenarioPrefix": false
+  },
+
+  "allOf": [
+    {
+      "$comment": "Steps 가 1개 이상이면 StartSteps 도 1개 이상 필수.",
+      "if": {
+        "required": ["Steps"],
+        "properties": {
+          "Steps": { "type": "object", "minProperties": 1 }
+        }
+      },
+      "then": {
+        "required": ["StartSteps"],
+        "properties": {
+          "StartSteps": { "type": "array", "minItems": 1 }
+        }
+      }
+    }
+  ]
+}

package/skill/schemas/service/CustomSystem.schema.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/service/CustomSystem.schema.json",
+  "title": "CustomSystem ServiceBinding",
+  "description": "API 연동 사용자 정의 시스템 호출 (외부 마이크로서비스 / 인증 시스템 등). SystemType='CustomSystem' 고정. SystemID 문자열. fEventKey + fEvent 로 외부 라우팅 정의.",
+  "type": "object",
+  "required": ["SystemID", "SystemType", "ModuleID", "fEventKey", "fEvent"],
+  "additionalProperties": true,
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/commonBase" },
+    {
+      "properties": {
+        "SystemID":   {
+          "type": "string",
+          "description": "CustomSystem 식별자. (실 샘플: New_01, New_02, New_05, GUID v4 형식 식별자)."
+        },
+        "SystemType": { "const": "CustomSystem" },
+        "ModuleID":   {
+          "type": "string",
+          "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
+          "description": "GUID v4 형식의 모듈 식별자."
+        },
+        "fEventKey": {
+          "type": "array",
+          "minItems": 1,
+          "description": "fEvent 객체에서 사용할 키 이름 배열. 호출 시 이 키들이 실제 외부 시스템 파라미터로 전달.",
+          "items": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" }
+        },
+        "fEvent": {
+          "type": "object",
+          "description": "fEventKey 의 각 키에 대응하는 실제 값. 값은 정적 문자열 또는 `{%_base.X.Y%}` / `{%_c.Cat[0].field%}` 템플릿 표현식.",
+          "additionalProperties": { "type": "string" }
+        },
+        "UsePKey":      { "type": "boolean" },
+        "UseParamBlock":{ "type": "boolean" },
+        "UseResultBlock":{ "type": "boolean" }
+      },
+      "$comment": "fEventKey 와 fEvent.keys() 가 일치해야 함은 후검증으로 처리 (TODO: [service-fevent] 추가 가능)."
+    }
+  ]
+}

package/skill/schemas/service/Firestore.schema.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/service/Firestore.schema.json",
+  "title": "Firestore ServiceBinding",
+  "description": "Google Firestore 서비스 호출 정의. SystemID='Firestore' 고정. ModuleID 로 작업 종류 식별 (Query / Save / Update / Delete).",
+  "type": "object",
+  "required": ["SystemID", "ModuleID"],
+  "additionalProperties": true,
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/commonBase" },
+    {
+      "properties": {
+        "SystemID": { "const": "Firestore" },
+        "ModuleID": {
+          "type": "string",
+          "enum": ["Query", "Save", "Update", "Delete"],
+          "description": "Firestore 작업 종류. Query=조회 / Save=신규 저장 / Update=업데이트 / Delete=삭제."
+        },
+        "Collection":     { "type": "string", "description": "Firestore 컬렉션 명칭 (서비스 대상)." },
+        "UseSearch":      { "type": "boolean", "description": "검색 모드 토글. true 면 인덱스 기반 텍스트 검색 활성화 (정렬+검색 동시 사용 시 복합 인덱스 등록 필요)." },
+        "UsePKey":        { "type": "boolean" },
+        "UseParamBlock":  { "type": "boolean" },
+        "UseResultBlock": { "type": "boolean" },
+        "UseInnerBlock":  { "type": "boolean" }
+      }
+    }
+  ]
+}

package/skill/schemas/service/FlexAutoQuery.schema.json

@@ -0,0 +1,35 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/service/FlexAutoQuery.schema.json",
+  "title": "FlexAutoQuery ServiceBinding",
+  "description": "FlexAutoQuery 서비스 호출 정의. const.js 의 SYSTEM_ID.FLEXAUTOQUERY='FlexAutoQuery' 에 매핑. FlexSQL 없이 FlexDB '자동생성 테이블 (AI로 DB연결하기)' 에 대한 CRUD 자동 구성. flextudio-guide §6.8 / FlexAutoQuery. Business+ 플랜.",
+  "type": "object",
+  "required": ["SystemID", "ModuleID"],
+  "additionalProperties": true,
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/commonBase" },
+    {
+      "properties": {
+        "SystemID": { "const": "FlexAutoQuery", "description": "FlexAutoQuery 호출 시 'FlexAutoQuery' 고정." },
+        "ModuleID": {
+          "type": "string",
+          "enum": ["Default"],
+          "description": "FlexAutoQuery 모듈 — const.js 상 'Default' 단일."
+        },
+        "ServiceType": {
+          "type": "string",
+          "enum": ["Query", "Save", "Update", "Delete"],
+          "description": "FlexAutoQuery 서비스 유형 4종 (조회/저장/업데이트/삭제)."
+        },
+        "TargetTable":      { "type": "string", "description": "자동생성 테이블 이름." },
+        "OrderBy":          { "type": "string", "description": "정렬 기준 컬럼명 (Query 전용)." },
+        "OrderDirection":   { "type": "string", "enum": ["ASC", "DESC", ""], "description": "정렬 순서." },
+        "UsePKey":          { "type": "boolean" },
+        "UseParamBlock":    { "type": "boolean" },
+        "UseResultBlock":   { "type": "boolean" },
+        "UseInnerBlock":    { "type": "boolean" },
+        "BeforeScript":     { "type": "string" }
+      }
+    }
+  ]
+}

package/skill/schemas/service/FlexSQL.schema.json

@@ -0,0 +1,33 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/service/FlexSQL.schema.json",
+  "title": "FlexSQL ServiceBinding",
+  "description": "FlexSQL 서비스 호출 정의. 워크스페이스 콘솔에 등록된 SQL 쿼리를 시나리오 명:서비스 명 형식으로 호출. flextudio-guide §6.7. SystemID 'FlexSQL' 고정.",
+  "type": "object",
+  "required": ["SystemID", "SQLServiceName"],
+  "additionalProperties": true,
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/commonBase" },
+    {
+      "properties": {
+        "SystemID":         { "const": "FlexSQL", "description": "FlexSQL 호출 시 'FlexSQL' 고정." },
+        "ModuleID":         { "type": "string", "description": "보통 'Default'. 다중 모듈 환경에서만 다른 값." },
+        "ServiceName":      { "type": "string", "description": "FlexSQL 표기 이름 (보통 'FlexSQL' 고정)." },
+        "SQLServiceName":   {
+          "type": "string",
+          "minLength": 1,
+          "pattern": ".+:.+",
+          "description": "FlexSQL 서비스 식별자. 형식: `<시나리오/그룹명>:<서비스명>` (예: `메인화면:showReceiveWho`, `Ideation:getDetail`). 콜론 1 개 필수."
+        },
+        "MajorVersion":     { "type": "integer", "minimum": 1, "description": "FlexSQL 메이저 버전 (정수, 보통 1 또는 2)." },
+        "ExternalDB":       { "type": "boolean", "description": "외부 DB 연결 사용 여부. 프로퍼티 SWITCH 가 boolean 저장." },
+        "UsePKey":          { "type": "boolean" },
+        "UseParamBlock":    { "type": "boolean" },
+        "UseResultBlock":   { "type": "boolean" },
+        "UseInnerBlock":    { "type": "boolean" },
+        "BeforeScript":     { "type": "string", "description": "Before Script — SQL 호출 전 전처리 (param 가공 등)." },
+        "ResultScript":     { "type": "string", "description": "After Script — SQL 결과 후처리 (반환 데이터 가공)." }
+      }
+    }
+  ]
+}

package/skill/schemas/service/Flextudio API.schema.json

@@ -0,0 +1,115 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/service/Flextudio%20API.schema.json",
+  "title": "Flextudio API ServiceBinding",
+  "description": "Flextudio API 시스템 호출. const.js 의 SYSTEM_ID.FLEXTUDIO_API='Flextudio API' (공백 포함) 에 매핑. flexApiKey 기반 인증. 사용자(User) / 메시지(Message) / 그룹(Group) 3 모듈 + SubModuleID 로 CRUD 식별. 런타임: public/system/flextudio/flextudio_api.js.",
+  "type": "object",
+  "required": ["SystemID", "ModuleID", "flexApiKey"],
+  "additionalProperties": true,
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/commonBase" },
+    {
+      "properties": {
+        "SystemID":   { "const": "Flextudio API", "description": "Flextudio API 호출 시 'Flextudio API' 고정 (공백 포함)." },
+        "ModuleID":   {
+          "type": "string",
+          "enum": ["User", "Message", "Group"],
+          "description": "Flextudio API 모듈. User=사용자 CRUD / Message=메시지 조회 / Group=그룹 회원 조회. const.js MODULE_ID[FLEXTUDIO_API]."
+        },
+        "SubModuleID":{
+          "type": "string",
+          "enum": ["Query", "Save", "Update", "Delete", "UserQuery"],
+          "description": "ModuleID 별 하위 작업. User: Query/Save/Update/Delete · Message: Query · Group: UserQuery. const.js SUB_MODULE_ID[FLEXTUDIO_API]."
+        },
+        "flexApiKey": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Flextudio API 호출용 인증 키 (필수). HTTP 요청 헤더 `x-flex-api-key` 로 전송. 워크스페이스 콘솔에서 발급."
+        },
+        "useUserAppGrant": {
+          "type": "boolean",
+          "description": "User Save 시 현재 앱 ID(_base.appid)를 함께 전송해 앱 사용 권한 자동 부여. const.js K_FLEXTUDIO_API_PROP.USE_USER_APP_GRANT."
+        },
+        "UseSearch": {
+          "type": "boolean",
+          "description": "User Query 검색 모드 토글. true 면 SearchItem 의 필터 조건이 쿼리 파라미터로 전송."
+        },
+        "SearchItem": {
+          "type": "array",
+          "description": "User Query 검색 조건 배열. UseSearch:true 일 때 사용.",
+          "items": { "$ref": "#/$defs/searchItem" }
+        },
+        "UseUnreadMessage": {
+          "type": "boolean",
+          "description": "Message Query 시 읽지 않은 메시지만 조회 토글. const.js K_FLEXTUDIO_API_PROP.USE_UNREAD_MESSAGE."
+        },
+        "groupName": {
+          "type": "string",
+          "description": "Group UserQuery 의 대상 그룹 이름. `{% %}` 대체 표현식 가능 (예: `'{%_c.activeGroup[0].groupName%}'`)."
+        },
+        "UsePKey":       { "type": "boolean" },
+        "UseParamBlock": { "type": "boolean" },
+        "UseResultBlock":{ "type": "boolean" },
+        "UseInnerBlock": { "type": "boolean" }
+      },
+      "allOf": [
+        {
+          "$comment": "User 모듈은 Query/Save/Update/Delete SubModule 중 하나 필수.",
+          "if": {
+            "properties": { "ModuleID": { "const": "User" } },
+            "required": ["ModuleID"]
+          },
+          "then": {
+            "required": ["SubModuleID"],
+            "properties": {
+              "SubModuleID": { "enum": ["Query", "Save", "Update", "Delete"] }
+            }
+          }
+        },
+        {
+          "$comment": "Message 모듈은 Query 만.",
+          "if": {
+            "properties": { "ModuleID": { "const": "Message" } },
+            "required": ["ModuleID"]
+          },
+          "then": {
+            "required": ["SubModuleID"],
+            "properties": {
+              "SubModuleID": { "const": "Query" }
+            }
+          }
+        },
+        {
+          "$comment": "Group 모듈은 UserQuery 만 + groupName 필수.",
+          "if": {
+            "properties": { "ModuleID": { "const": "Group" } },
+            "required": ["ModuleID"]
+          },
+          "then": {
+            "required": ["SubModuleID", "groupName"],
+            "properties": {
+              "SubModuleID": { "const": "UserQuery" }
+            }
+          }
+        }
+      ]
+    }
+  ],
+
+  "$defs": {
+    "searchItem": {
+      "type": "object",
+      "description": "User Query 검색 항목. 필드명 + 연산자 + 컬렉션 키 매핑.",
+      "additionalProperties": true,
+      "properties": {
+        "FieldName":    { "type": "string", "description": "조회 대상 필드명 (서버 필드)." },
+        "SearchFilter": {
+          "type": "string",
+          "enum": ["contains", "!contains", "exists", "!exists", "==", "!=", "<", "<=", ">", ">="],
+          "description": "검색 연산자. const.js K_FLEXTUDIO_API_USER_FILTER."
+        },
+        "FieldValue":   { "type": "string", "description": "비교값이 들어있는 컬렉션 키 (sector 의 키 이름)." }
+      }
+    }
+  }
+}

package/skill/schemas/service/Flextudio.schema.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/service/Flextudio.schema.json",
+  "title": "Flextudio ServiceBinding",
+  "description": "Flextudio 내장 시스템 호출. const.js 의 SYSTEM_ID.FLEXTUDIO='Flextudio' 에 매핑. 워크스페이스 사용자/메시지 도메인 기능 (GetUserList / QueryMessage / SendMessage). 런타임 구현: public/system/flextudio/flextudio.js.",
+  "type": "object",
+  "required": ["SystemID", "ModuleID"],
+  "additionalProperties": true,
+  "allOf": [
+    { "$ref": "_base.schema.json#/$defs/commonBase" },
+    {
+      "properties": {
+        "SystemID": { "const": "Flextudio", "description": "Flextudio 내장 시스템 호출 시 'Flextudio' 고정." },
+        "ModuleID": {
+          "type": "string",
+          "enum": ["GetUserList", "QueryMessage", "SendMessage"],
+          "description": "Flextudio 모듈. GetUserList=사용자 목록 조회 / QueryMessage=메시지 조회 / SendMessage=메시지 발송."
+        },
+        "UsePKey":       { "type": "boolean" },
+        "UseParamBlock": { "type": "boolean" },
+        "UseResultBlock":{ "type": "boolean" },
+        "UseInnerBlock": { "type": "boolean" }
+      }
+    }
+  ]
+}