@flextudio/scenario 0.1.0

package/skill/schemas/data-objects.schema.json

@@ -0,0 +1,161 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/data-objects.schema.json",
+  "title": "Data Objects",
+  "description": "데이터 바인딩/필터 관련 공통 객체 카탈로그. Group의 DataConnection 과 TargetSector.Filters 등.",
+
+  "$defs": {
+    "ckeyOrEmpty": {
+      "$comment": "ckey 또는 빈 문자열. DCLinkItems / Parent / Condition 키처럼 비편집 상태 메타에 빈 키가 들어오는 위치 전용.",
+      "type": "string",
+      "anyOf": [
+        { "const": "" },
+        { "$ref": "naming-objects.schema.json#/$defs/ckey" }
+      ]
+    },
+
+    "dataConnection": {
+      "type": "object",
+      "description": "Group의 데이터 바인딩. TargetType 은 항상 'category' 고정 (DataConnection 사용 시 단일 진실원본 — 누락 금지). 그 외 권장 필수: DataUsage, CategoryName. DataUsage 분기별 동작은 data-objects.md 참조.",
+      "additionalProperties": true,
+      "required": ["TargetType"],
+      "properties": {
+        "TargetType": {
+          "type": "string",
+          "const": "category",
+          "default": "category",
+          "description": "DataConnection 사용 시 고정값 'category'. UseDataConnection=true 면 반드시 포함 (다른 값/누락 모두 금지)."
+        },
+        "DataUsage": {
+          "type": "string",
+          "enum": ["default", "new", "update", "detail", "query"]
+        },
+        "CategoryName":    { "$ref": "naming-objects.schema.json#/$defs/categoryName" },
+        "UseNewSector":    { "type": "boolean" },
+        "OnlyIfNoSector":  { "type": "boolean" },
+        "UseTargetSector": { "type": "boolean" },
+
+        "UseDCLink": {
+          "type": "boolean",
+          "description": "상위 Group 의 DataConnection 과 연결 사용 여부. 신규(new) DataUsage 에서 부모 섹터의 키를 자식 섹터에 자동 매핑할 때 true. true 면 DCLinkCkey 함께 사용. 단일 진실원본."
+        },
+        "DCLinkCkey": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "UseDCLink=true 일 때 부모↔자식 키 매핑 정의. DCLinkItems 배열로 1:N 매핑 지원.",
+          "properties": {
+            "DCLinkItems": {
+              "type": "array",
+              "description": "부모-자식 키 매핑 항목 배열. 각 항목은 DCParentKey(부모 섹터 측), DCChildKey(자식 섹터 측) 쌍. 비편집 상태에서는 빈 문자열 허용.",
+              "items": {
+                "type": "object",
+                "additionalProperties": true,
+                "properties": {
+                  "DCParentKey": { "$ref": "#/$defs/ckeyOrEmpty" },
+                  "DCChildKey":  { "$ref": "#/$defs/ckeyOrEmpty" }
+                }
+              }
+            }
+          }
+        },
+
+        "TargetSector": {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "필터 컨테이너. 카테고리 식별은 상위 DataConnection.CategoryName 만 사용. TargetSector 안에 CategoryName 키를 두는 것은 잘못된 형태로 schema 차원에서 차단 — 어떤 값이든 거부 (group.schema.json 의 UseInnerBlock:false 차단과 동일 패턴).",
+          "properties": {
+            "CategoryName": false,
+            "Filters": {
+              "type": "array",
+              "description": "필터 배열. 모든 필터 통과 섹터만 렌더링. FilterType 별 형태는 data-objects.md TargetSector.Filters 카탈로그 참조.",
+              "items": { "$ref": "#/$defs/sectorFilter" }
+            }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "$comment": "DataUsage 별 부속 필드 결합 규칙 — switch (L2643~2680) 의 공식 규칙.",
+          "if": { "properties": { "DataUsage": { "const": "default" } }, "required": ["DataUsage"] },
+          "then": {
+            "properties": {
+              "UseNewSector":   { "const": true },
+              "OnlyIfNoSector": { "const": true }
+            },
+            "required": ["UseNewSector", "OnlyIfNoSector"]
+          }
+        },
+        {
+          "if": { "properties": { "DataUsage": { "const": "new" } }, "required": ["DataUsage"] },
+          "then": {
+            "properties": { "UseNewSector": { "const": true } },
+            "required": ["UseNewSector"]
+          }
+        },
+        {
+          "if": { "properties": { "DataUsage": { "enum": ["detail", "update"] } }, "required": ["DataUsage"] },
+          "then": {
+            "properties": { "UseTargetSector": { "const": true } },
+            "required": ["UseTargetSector", "TargetSector"]
+          }
+        },
+        {
+          "$comment": "UseDCLink=true 면 DCLinkCkey 필요.",
+          "if": {
+            "properties": { "UseDCLink": { "const": true } },
+            "required": ["UseDCLink"]
+          },
+          "then": { "required": ["DCLinkCkey"] }
+        }
+      ]
+    },
+
+    "sectorFilter": {
+      "type": "object",
+      "additionalProperties": true,
+      "required": ["FilterType"],
+      "description": "TargetSector.Filters 의 한 항목. FilterType 으로 분기. 비편집 상태(필터 추가 직후 키/값 미입력)도 운영 메타로 저장되므로 부속 필드 required 는 비움.",
+      "oneOf": [
+        {
+          "title": "Status",
+          "properties": {
+            "FilterType": { "const": "Status" },
+            "Status": {
+              "type": "array",
+              "$comment": "빈 배열도 비편집 상태로 허용 (사용자가 상태 미선택). 값이 있을 경우 sectorStatus 5종 중 하나.",
+              "items": { "type": "string", "enum": ["active", "selected", "added", "updated", "deleted"] }
+            }
+          }
+        },
+        {
+          "title": "Condition",
+          "properties": {
+            "FilterType":         { "const": "Condition" },
+            "ConditionKey":       { "$ref": "#/$defs/ckeyOrEmpty", "description": "필터 대상 컬렉션 키. 시스템 게터 / JS 빌트인 차단. 비편집 상태 빈 문자열 허용." },
+            "ConditionOperators": {
+              "type": "string",
+              "enum": ["==", "!=", ">", ">=", "<", "<=", "Exists", "Not_Exists", "Like", "RegExp"]
+            },
+            "ConditionValue":     { "$comment": "정적 값 또는 같은 섹터의 다른 필드 참조 `{=Field}`. 다른 카테고리 참조 불가 — 그 경우 Custom 사용." }
+          }
+        },
+        {
+          "title": "Custom",
+          "properties": {
+            "FilterType": { "const": "Custom" },
+            "Script": { "type": "string", "description": "sector 변수 사용, boolean 반환. 다른 카테고리 참조 가능. 비편집 상태 빈 문자열 허용." }
+          }
+        },
+        {
+          "title": "Parent",
+          "description": "1:N 관계 자식 그룹에서 부모 키 매칭. 자식 Group 의 DataConnection 에 배치. 상위 Group 에 DataConnection 이 있고 자식이 query 일 때 사용.",
+          "properties": {
+            "FilterType":  { "const": "Parent" },
+            "DCParentKey": { "$ref": "#/$defs/ckeyOrEmpty", "description": "부모 섹터 측 매칭 키. 시스템 게터 / JS 빌트인 차단. 비편집 상태 빈 문자열 허용." },
+            "DCChildKey":  { "$ref": "#/$defs/ckeyOrEmpty", "description": "자식 섹터 측 매칭 키. 시스템 게터 / JS 빌트인 차단. 비편집 상태 빈 문자열 허용." }
+          }
+        }
+      ]
+    }
+  }
+}

package/skill/schemas/data-sources.schema.json

@@ -0,0 +1,184 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://flextudio.local/meta-contract/v1/data-sources.schema.json",
+  "title": "DataSources",
+  "description": "scenarioMeta.DataSources — 명명 데이터소스 모음. Combo / RadioBox / Search / Tree / CheckBox(Multi) / Approval / TimeTable / Scheduler 등에서 'DataSourceName' 으로 참조. 키=DataSource 이름, 값=dataSource 분기. 엔진 enum: Fixed/Grid/Service/Collection/API (engine/common/const.js).",
+  "type": "object",
+  "propertyNames": { "$ref": "#/$defs/dataSourceName" },
+  "additionalProperties": { "$ref": "#/$defs/dataSource" },
+
+  "$defs": {
+    "dataSourceName": {
+      "type": "string",
+      "minLength": 1,
+      "pattern": "^[^`.~!@#$%^&*()=|\\\\'\";:/?,{}\\[\\]<> \\t\\n]+$",
+      "$comment": "studio-util.js#L4228 isIcludeSpecial() 의 negation. AI 생성 권장: ^[A-Za-z][A-Za-z0-9_]*$ + 의미있는 접미사(_DS / _D / Query 등). 운영 메타엔 한글/언더스코어/하이픈 등 다양 — 특수문자만 차단.",
+      "description": "DataSource 이름. 엔진 isIcludeSpecial 차단 문자: ` . ~ ! @ # $ % ^ & * ( ) = | \\ ' \" ; : / ? , { } [ ] < > 와 공백/탭/개행. AI 생성 권장 패턴: 영문자 시작 + 영문/숫자/언더스코어 + 의미있는 접미사 (`_DS` / `_D` / `Query` / `List` / `Items` 등)."
+    },
+
+    "dataSource": {
+      "description": "DataSourceType discriminator 로 5종 분기 (Fixed / Grid / Collection / Service / API). AI 샘플 데이터 생성은 Fixed / Grid 만 사용 (validate.mjs [sample] 후검증). Collection / Service / API 는 외부 시스템 의존 — 운영 메타 전용.",
+      "type": "object",
+      "required": ["DataSourceType"],
+      "additionalProperties": true,
+      "oneOf": [
+        { "$ref": "#/$defs/dataSourceFixed" },
+        { "$ref": "#/$defs/dataSourceGrid" },
+        { "$ref": "#/$defs/dataSourceCollection" },
+        { "$ref": "#/$defs/dataSourceService" },
+        { "$ref": "#/$defs/dataSourceApi" }
+      ]
+    },
+
+    "fixedItem": {
+      "type": "object",
+      "description": "Fixed/Grid DataSource 의 인라인 항목. 일반적으로 ItemName/ItemValue 페어이지만 임의 필드 허용 (CollectionMapper 로 매핑). ★ additionalProperties 는 자유 데이터 컬럼(임의 키/값)이므로 {} (any) — true 로 두면 strict 변환이 unevaluatedProperties:false 로 뒤집어 자유 컬럼(id/name 등)을 오탐 차단한다.",
+      "additionalProperties": {},
+      "properties": {
+        "ItemName":  { "type": "string" },
+        "ItemValue": { "type": "string", "$comment": "프로퍼티 INPUTBOX 가 항상 string 저장. 숫자 보관 시 따옴표 필수." }
+      }
+    },
+
+    "fixedItemsArray": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/fixedItem" }
+    },
+
+    "fixedItemsValue": {
+      "description": "FixedItems / GridItems 는 보통 배열이지만 운영 메타에 JS 표현식 문자열로 저장된 경우가 있다 (런타임 new Function() 평가). AI 생성 시에는 배열 형태로만 작성한다.",
+      "oneOf": [
+        { "$ref": "#/$defs/fixedItemsArray" },
+        { "type": "string", "$comment": "운영 메타 호환용. AI 생성 금지." }
+      ]
+    },
+
+    "dataSourceFixed": {
+      "type": "object",
+      "title": "Fixed DataSource",
+      "description": "정적 인라인 데이터. AI 생성 권장. Combo/RadioBox/CheckBox(Multi) 의 선택지 또는 Tree 노드.",
+      "required": ["DataSourceType", "FixedItems"],
+      "additionalProperties": true,
+      "properties": {
+        "DataSourceType": { "const": "Fixed" },
+        "FixedItems":     { "$ref": "#/$defs/fixedItemsValue" }
+      }
+    },
+
+    "dataSourceGrid": {
+      "type": "object",
+      "title": "Grid DataSource",
+      "description": "그리드형 인라인 데이터. GridHeader (열 정의) + GridItems (행 데이터). AI 생성 가능 — 외부 시스템 의존 없음.",
+      "required": ["DataSourceType", "GridItems"],
+      "additionalProperties": true,
+      "properties": {
+        "DataSourceType": { "const": "Grid" },
+        "GridHeader":     {
+          "type": "array",
+          "items": { "type": "string" },
+          "description": "(선택) 컬럼 키 문자열 배열 — 예 [\"fCode\", \"fName\"]. GridItems 행의 필드명. (객체 배열 [{Key,Title}] 로 들어오면 materialize 가 키 배열로 정본화.)"
+        },
+        "GridItems": { "$ref": "#/$defs/fixedItemsValue" }
+      }
+    },
+
+    "dataSourceCollection": {
+      "type": "object",
+      "title": "Collection DataSource",
+      "description": "다른 카테고리(Category) 데이터 참조. 외부 시스템 의존 — AI 샘플 생성 금지(대신 Fixed/Grid 사용).",
+      "required": ["DataSourceType", "CategoryName"],
+      "additionalProperties": true,
+      "properties": {
+        "DataSourceType": { "const": "Collection" },
+        "CategoryName":   { "$ref": "naming-objects.schema.json#/$defs/categoryName", "description": "참조할 카테고리 이름. _c.<CategoryName>. JS 빌트인 충돌 키는 schema 차단." },
+        "Target":         {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "(선택) 필터 등 추가 조건.",
+          "properties": {
+            "Filters": {
+              "type": "array",
+              "items": { "$ref": "data-objects.schema.json#/$defs/sectorFilter" }
+            }
+          }
+        },
+        "UseInnerBlock": { "type": "boolean" },
+        "InnerBlock":    {
+          "type": "object",
+          "additionalProperties": true,
+          "description": "InnerBlock (중첩 데이터) 참조. UseInnerBlock=true 일 때.",
+          "properties": {
+            "InnerBlockKey": { "type": "string" }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "UseInnerBlock": { "const": true } },
+            "required": ["UseInnerBlock"]
+          },
+          "then": { "required": ["InnerBlock"] }
+        }
+      ]
+    },
+
+    "dataSourceService": {
+      "type": "object",
+      "title": "Service DataSource",
+      "description": "ServiceBinding 호출 결과. 외부 시스템 의존 — AI 샘플 생성 금지. ServiceName 은 ServiceBinding 의 키와 일치 필수.",
+      "required": ["DataSourceType", "ServiceName"],
+      "additionalProperties": true,
+      "properties": {
+        "DataSourceType": { "const": "Service" },
+        "ServiceName":    { "type": "string" },
+        "Version":        { "type": "number", "minimum": 1, "$comment": "프로퍼티가 숫자로 저장." },
+        "SystemID":       { "type": "string", "examples": ["ksystem", "Other", "Flextudio"] },
+        "UseCategory":    { "type": "boolean", "$comment": "프로퍼티 SWITCH/CHECKBOX 가 boolean 저장." },
+        "UseParamOptions":{ "type": "boolean" },
+        "ParamBlocks":    {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": true,
+            "properties": {
+              "UseFilter": { "type": "boolean" },
+              "UserData":  { "type": "array", "items": { "type": "string" } },
+              "Filters":   {
+                "type": "array",
+                "items": { "$ref": "data-objects.schema.json#/$defs/sectorFilter" }
+              }
+            }
+          }
+        },
+        "ParamBlock":     { "type": "object", "additionalProperties": true, "description": "(레거시) 단일 ParamBlock 형태." },
+        "ServiceBinding": { "type": "object", "additionalProperties": true, "description": "(인라인) ServiceBinding 정의. 일부 운영 메타에서 사용." }
+      }
+    },
+
+    "dataSourceApi": {
+      "type": "object",
+      "title": "API DataSource",
+      "description": "직접 API 호출. 외부 시스템 의존 — AI 샘플 생성 금지. 엔진 내부적으로 Service 와 동일 함수 사용.",
+      "required": ["DataSourceType", "ModuleID"],
+      "additionalProperties": true,
+      "properties": {
+        "DataSourceType":     { "const": "API" },
+        "Action":             { "type": "string", "examples": ["API"] },
+        "SystemID":           { "type": "string" },
+        "SystemType":         { "type": "string" },
+        "ModuleID":           { "type": "string" },
+        "SetCategory":        { "type": "boolean", "$comment": "프로퍼티가 boolean 저장." },
+        "UsePKey":            { "type": "boolean" },
+        "UseParamBlock":      { "type": "boolean" },
+        "UseResultBlock":     { "type": "boolean" },
+        "UseCategory":        { "type": "boolean", "$comment": "프로퍼티가 boolean 저장." },
+        "NotSeperateInnerBlock": { "type": "boolean" },
+        "fEvent":             { "type": "object", "additionalProperties": true },
+        "fEventKey":          { "type": "array", "items": { "type": "string" } },
+        "ParamBlocks":        { "type": "array" },
+        "ResultBlocks":       { "type": "array" }
+      }
+    }
+  }
+}