@flextudio/scenario 0.1.0

package/skill/docs/service/README.md

@@ -0,0 +1,127 @@
+# Service 폴더 — 서비스 종류별 메타 + API 연동
+
+`scenarioMeta.ServiceBinding[<name>]` 항목 / `Events.X[*].Action='Service'` 의 인라인 ServiceBinding 객체에서 사용하는 **서비스 종류별 분기 스키마와 가이드**.
+
+> **스킬 생성에서는 모든 서비스 사용 금지** — `[no-service]` 가 차단 (`strict_no_service:true` 기본). 본 폴더의 스키마/가이드는 **운영 메타 검증** 과 **AI 가 사용자 질문에 답할 때의 참고 자료**로 사용. 운영 메타 검증 시 `strict_no_service:false` 로 호출.
+> **참고 문서**: [docs.flextudio.com — Event 와 Service](https://docs.flextudio.com/flextudio/concept/eventservice), [docs.flextudio.com — Service](https://docs.flextudio.com/flextudio/scenario/dev-mode/service), [docs.flextudio.com — API 호출](https://docs.flextudio.com/flextudio/scenario/dev-mode/event/api), [flextudio-guide §6.6–6.8](../../../../flextudio-ai-studio/docs/flextudio-guide.md), [const.js SYSTEM_ID](../../../../public/engine/common/const.js).
+
+## 명명 원칙
+
+**파일명 = `SYSTEM_ID` 값 그대로** (대소문자/공백 보존). const.js `SYSTEM_ID` 의 string value 가 그대로 파일명 basename. 예외: `CustomSystem` 은 `SystemType` (별도 `CUSTOM_SYSTEM_TYPE='CustomSystem'`) 매핑.
+
+## 폴더 구조
+
+```
+schema/v1/service/
+├── README.md                          # 이 파일 — 인덱스 + 비교표
+├── _base.schema.json                  # 공통 commonBase $defs
+├── FlexSQL.{schema.json,md}           # SystemID='FlexSQL'        — 워크스페이스 SQL
+├── FlexAutoQuery.{schema.json,md}     # SystemID='FlexAutoQuery'  — FlexDB 자동 CRUD
+├── ksystem.{schema.json,md}           # SystemID='ksystem'        — 영림원 ksystem (FlexAPI/OpenAPI/Codehelp/Ksystem/Filehelp)
+├── Firestore.{schema.json,md}         # SystemID='Firestore'      — Google Firestore
+├── GoogleSheet.{schema.json,md}       # SystemID='GoogleSheet'    — Google Sheet
+├── Flextudio.{schema.json,md}         # SystemID='Flextudio'      — 워크스페이스 내장 (GetUserList/QueryMessage/SendMessage)
+├── Flextudio API.{schema.json,md}     # SystemID='Flextudio API'  — 사용자/메시지/그룹 REST API (flexApiKey)
+└── CustomSystem.{schema.json,md}      # SystemType='CustomSystem' (SystemID='New_NN') — Action='API' 매핑 + fEventKey/fEvent
+```
+
+## 시스템 비교표
+
+const.js `SYSTEM_ID` 정의 + docs.flextudio.com 공식 문서 + 실 샘플 시나리오 기반.
+
+| 시스템 | SystemID (const.js) | SystemType | ModuleID 후보 | 핵심 필드 | 플랜 | 빈도 |
+|---|---|---|---|---|---|---|
+| **FlexSQL** | `FlexSQL` | — | `Default` | `SQLServiceName`(`<시나리오>:<서비스>`), `MajorVersion`, `ExternalDB`, `BeforeScript`, `ResultScript` | Business+ | 39 |
+| **FlexAutoQuery** | `FlexAutoQuery` | — | `Default` | `ServiceType`(Query/Save/Update/Delete), `TargetTable`, `OrderBy` | Business+ | (실 샘플은 ksystem 으로 박힘) |
+| **ksystem** | `ksystem` | — | `FlexAPI` / `OpenAPI` / `Codehelp` / `Ksystem` / `Filehelp` | `UseTable`(BIZ), `SelectTable`, `SPList[]`, `UseBundle` | Business+ | 25 |
+| **Firestore** | `Firestore` | — | `Query` / `Save` / `Update` / `Delete` | `Collection`, `UseSearch` | All | 4 |
+| **GoogleSheet** | `GoogleSheet` | — | `Query` / `Append` / `Update` / `Clear` | `SpreadsheetId`, `SheetName`, `BaseColumn`(`_SUID`) | All | 0 (실 샘플) |
+| **Flextudio** | `Flextudio` | — | `GetUserList` / `QueryMessage` / `SendMessage` | (없음) | All | (헬퍼) |
+| **Flextudio API** | `Flextudio API` (공백) | — | `User` / `Message` / `Group` | `flexApiKey`, `SubModuleID`, `useUserAppGrant`, `UseSearch`+`SearchItem`, `UseUnreadMessage`, `groupName` | All | (REST) |
+| **CustomSystem** | `New_NN` | `CustomSystem` | GUID v4 | `fEventKey[]`, `fEvent{}` (= "Event Config Key") | All | 12 |
+
+> **`Custom` 시스템은 v1 컨트랙트에서 제외** (const.js `SYSTEM_ID.CUSTOM='Custom'` 은 정의되어 있으나 본 컨트랙트는 미지원 — Custom REST 는 외부 백엔드 호출용으로 보안/검증 부담이 커서 의도적으로 제외).
+
+### ModuleID 비교 (혼동 주의)
+
+| 작업 | FlexAutoQuery | Firestore | GoogleSheet |
+|---|---|---|---|
+| 조회 | `Query` (ServiceType) | `Query` | `Query` |
+| 추가/저장 | `Save` | `Save` | `Append` |
+| 수정 | `Update` | `Update` | `Update` |
+| 삭제 | `Delete` | `Delete` | `Clear` (값만 비움) |
+
+### Flextudio 도메인 모듈 비교 (혼동 주의)
+
+| 작업 | Flextudio (`SystemID='Flextudio'`) | Flextudio API (`SystemID='Flextudio API'`) |
+|---|---|---|
+| 사용자 조회 | `ModuleID:'GetUserList'` | `ModuleID:'User'` + `SubModuleID:'Query'` |
+| 메시지 조회 | `ModuleID:'QueryMessage'` | `ModuleID:'Message'` + `SubModuleID:'Query'` |
+| 메시지 발송 | `ModuleID:'SendMessage'` | (해당 없음 — REST 미지원) |
+| 그룹 회원 조회 | (해당 없음) | `ModuleID:'Group'` + `SubModuleID:'UserQuery'` + `groupName` |
+| 인증 | 워크스페이스 세션 (자동) | `flexApiKey` 헤더 |
+
+### 연산자 비교
+
+| 서비스 | 지원 연산자 |
+|---|---|
+| **FlexAutoQuery** | `=`, `!=`, `<`, `<=`, `>`, `>=`, `LIKE`, `NOT LIKE`, `IS NULL`, `IS NOT NULL` |
+| **Firestore** | `==`, `!=`, `<`, `<=`, `>`, `>=` (LIKE/IS NULL 미지원) |
+| **Flextudio API User Query** (`SearchFilter`) | `contains`, `!contains`, `exists`, `!exists`, `==`, `!=`, `<`, `<=`, `>`, `>=` |
+
+## 분기 결정 규칙
+
+`ServiceBinding[<name>]` 또는 `Action.ServiceBinding` 의 `SystemID` / `SystemType` 값으로 어느 스키마를 적용할지 결정 (const.js SYSTEM_ID 와 1:1).
+
+```
+SystemID === 'FlexSQL'                               → FlexSQL.schema.json
+SystemID === 'FlexAutoQuery'                         → FlexAutoQuery.schema.json
+SystemID === 'ksystem'                               → ksystem.schema.json
+SystemID === 'Firestore'                             → Firestore.schema.json
+SystemID === 'GoogleSheet'                           → GoogleSheet.schema.json
+SystemID === 'Flextudio'                             → Flextudio.schema.json
+SystemID === 'Flextudio API'                         → Flextudio API.schema.json
+SystemType === 'CustomSystem' (SystemID = 'New_NN')  → CustomSystem.schema.json
+그 외                                                → service-binding.schema.json (관용 모드)
+```
+
+## 공통 ParamBlocks / ResultBlocks
+
+서비스 종류와 무관하게 모든 서비스 호출은 `ParamBlocks` (보내는 데이터) / `ResultBlocks` (받은 데이터) / `InnerBlocks` (중첩 매핑) 구조를 공유한다. 자세한 형식은 [`../events.md §2.3`](../events.md) 참조.
+
+| 블록 | 역할 | 필수 필드 |
+|---|---|---|
+| `ParamBlocks[]` | 카테고리/필터/사용자 컨텍스트 데이터 송신 | `CategoryName` 또는 `UserData` |
+| `ResultBlocks[]` | 결과를 컬렉션 카테고리에 반영 (`category` / `replace` / `add` / `merge`) | `TargetType`, `CategoryName` (`merge` 시 `PKeys` 추가) |
+| `InnerBlocks[]` | 결과 객체 안의 자식 배열 키 매핑 | `InnerBlockKey` |
+
+## 런타임 내부 / 미사용 필드 (AI 생성 금지)
+
+> ⚠️ const.js `K_EVENT.SERVICE` 에는 아래 필드들도 정의되어 있으나 일반 시나리오에서는 거의 미사용 — 런타임 내부 / 스튜디오 디버그 전용. AI 생성에서는 **절대 박지 말 것**. 운영 메타에서 마주치면 그대로 보존(스키마 `additionalProperties:true` 가 통과).
+
+| 분류 | 필드 | 용도 |
+|---|---|---|
+| **비동기 콜백** | `useAsync` / `asyncThenScript` / `asyncCatchScript` / `asyncFinallyScript` | 비동기 호출 then/catch/finally 스크립트. 일반 시나리오는 동기 `_fEvent.pause/resume` 흐름 사용 |
+| **모바일 오프라인 큐** | `Flex-Offline` / `FlexOfflineModeType` (`Queue`\|`Cache`) / `FlexOfflineAfterEvent` | 푸시/큐 라우팅 — 모바일 한정 |
+| **오프라인 트랜잭션 키** | `UseFlexSourceID` / `UseFlexSubmissionID` / `Flex-SubmissionID` / `Flex-SourceID` / `Flex-Mapper` (+ `map`/`path`/`match`/`preserveSource`) | 오프라인 큐 SubmissionID/SourceID 매핑 — 운영 환경 자동 채움 |
+| **스튜디오 디버그** | `UseTestGround` / `TestScript` | Test Ground — 스튜디오에서 테스트 호출 시 자동 박힘 |
+| **스튜디오 API 테스트** | `UseApiGround` / `ApiModuleId` / `ApiSystemId` / `ApiEvent` / `ApiEventKey` | API Ground — 스튜디오에서 API 모듈 시뮬레이션 시 사용 |
+| **FlexSQL 임시 테이블** | `UseTempTable` / `TempTableName` | FlexSQL 임시 테이블 — 운영 한정 |
+| **트랜잭션 / 외부 시스템** | `useCommonTran` / `UseExternal` | 공통 트랜잭션 묶음 / 외부 토글 — 운영 한정 |
+| **결과 옵션** | `UseResultOptions` / `NotReflect` / `IsReplace` | 결과 반영 세부 토글 — `ResultBlocks.TargetType` 으로 충분 |
+
+> step.md `AfterOfflineEvent` (`STEP_EVENT.AFTEROFFLINE`) 와 동일한 정책 — const.js 에는 정의되어 있어 형식상 통과되지만 AI 생성 메타에는 박지 않음. 운영 메타와 충돌 회피 목적으로만 정의되어 있다.
+
+## 운영 메타 검증
+
+```jsonc
+{
+  "name": "validate_scenario",
+  "arguments": {
+    "scenario": {…},
+    "strict_no_service": false      // ServiceBinding / Service / API 통과
+  }
+}
+```
+
+`strict_no_service:false` 모드에서도 본 폴더의 스키마는 형식 강제력을 유지한다 — 예: FlexSQL 의 `SQLServiceName` 콜론 패턴, Flextudio API 의 ModuleID/SubModuleID 분기, CustomSystem 의 `New_NN` SystemID 패턴 등.

package/skill/docs/service/ksystem.md

@@ -0,0 +1,76 @@
+# ksystem Service (ksystem.schema.json)
+
+`SystemID:'ksystem'` (소문자) — 영림원소프트랩 ksystem 사내 시스템 호출. const.js `SYSTEM_ID.KSYSTEM='ksystem'` 에 매핑.
+
+> **스킬 생성에서는 사용 금지** — `[no-service]` 가 차단.
+> **운영 메타 호환** 목적으로 형식 정의. AI 자동 생성 시나리오에는 등장 안 함.
+
+## 1. ModuleID 5종
+
+| ModuleID | 의미 |
+|---|---|
+| `FlexAPI` | BIZ 테이블 (자동생성 비즈니스 테이블) 의 스토어드 프로시저 호출 — 가장 흔한 형태 |
+| `OpenAPI` | ksystem 공개 API |
+| `Codehelp` | 코드 매핑 (도메인 코드 ↔ 표시명) |
+| `Ksystem` | ksystem 본체 모듈 |
+| `Filehelp` | 파일 처리 헬퍼 |
+
+> 실 샘플 25 항목 중 대부분이 `ModuleID:'FlexAPI'` + `UseTable:'BIZ'` + `SPList:[...]` 패턴.
+
+## 2. 식별 필드
+
+| 필드 | 값 | 비고 |
+|---|---|---|
+| `SystemID` | `"ksystem"` (고정, 소문자) | const |
+| `ModuleID` | enum 5종 (위 표) | |
+| `UseTable` | `"BIZ"` / `false` | BIZ = 비즈니스 테이블 |
+| `SelectTable` | 테이블 이름 또는 정의 객체 | |
+| `SPList[]` | 자동생성 SP 이름 배열 | 예: `["_SWFlexARUsualCostAppListQuery"]` |
+| `UseBundle` | boolean | 여러 SP 묶음 호출 |
+
+## 3. 형태 — FlexAPI 모듈 (BIZ 테이블 SP 호출)
+
+```jsonc
+"ServiceBinding": {
+  "UsualCostAppListQuery_S": {
+    "SystemID":              "ksystem",
+    "ModuleID":              "FlexAPI",
+    "SetCategory":           true,
+    "UsePKey":               true,
+    "UseParamBlock":         true,
+    "UseResultBlock":        true,
+    "UseInnerBlock":         true,
+    "NotSeperateInnerBlock": true,
+    "UseTable":              "BIZ",
+    "SelectTable":           "",
+    "SPList":                ["_SWFlexARUsualCostAppListQuery"],
+    "UseBundle":             false
+  }
+}
+```
+
+## 4. UseBundle (번들 호출)
+
+여러 SP 를 묶어서 한 번에 호출. `SPList` 에 여러 항목 + `UseBundle: true`.
+
+```jsonc
+{
+  "SPList":    ["_SWFlexUserSave", "_SWFlexUserPrefSave"],
+  "UseBundle": true
+}
+```
+
+## 5. API 연동 흐름
+
+```
+[1] Action='Service' SystemID='ksystem' → ksystem 라우팅
+[2] ModuleID 분기 (FlexAPI / OpenAPI / Codehelp / Ksystem / Filehelp)
+[3] FlexAPI 면 SPList 의 SP 를 BIZ 테이블에 대해 자동 실행
+[4] 결과 → ResultBlocks 카테고리 반영
+```
+
+## 6. FlexAutoQuery 와의 관계
+
+- ksystem `FlexAPI` 모듈은 자동생성된 SP 호출.
+- [`FlexAutoQuery.md`](FlexAutoQuery.md) 는 별도 SystemID — 자동 CRUD 추상화 한 단계 더 위.
+- 둘 다 BIZ 테이블 기반 자동 SP 를 사용하지만 메타 표기가 다르다 — 운영 환경/플랜에 따라 선택.

package/skill/docs/service-binding.md

@@ -0,0 +1,228 @@
+# ServiceBinding (service-binding.schema.json)
+
+`scenarioMeta.ServiceBinding` — 서비스 호출 정의 맵. 키는 서비스 식별자, 값은 SystemID/ModuleID 등 호출 정의.
+DB / 외부 API 호출은 이 맵의 항목을 통해 이루어진다. `Events.X[*].Action='Service'` 의 `ServiceBinding` 필드가 이 맵의 키를 참조한다.
+
+> **참고 문서**: [docs.flextudio.com — Event 와 Service](https://docs.flextudio.com/flextudio/concept/eventservice). 흐름: Event 호출 → Service 호출 → DB 조회 → 결과를 컬렉션 카테고리에 저장 → Step 재로드.
+> **schema ↔ md 동기화**: 본 md 의 표/필드는 `service-binding.schema.json` 과 1:1 일치해야 한다. 실 샘플 99 항목 통계 기반.
+
+---
+
+## 1. 핵심 규칙 — 스킬 생성 시 비어있는 객체 강제
+
+```jsonc
+"ServiceBinding": {}      // 스킬 생성 — 항상 빈 객체
+```
+
+- AI 가 생성하는 메타에는 `ServiceBinding` 항목을 박지 말 것.
+- 서비스 호출 (`Action: 'Service'` / `'API'`) 도 같이 금지.
+- 데이터 샘플은 `DataSources` 의 `Fixed` / `Grid` 만 사용.
+- 검증: `[no-service]` (`strict_no_service:true` 기본). 운영 메타 검증은 `false` 로 비활성.
+
+서비스 구성은 **운영 단계에서 사용자/스튜디오가 직접 추가**. AI 가 임의로 SystemID/ModuleID/SQL 이름을 만들어 박으면 실제로 존재하지 않는 서비스 참조가 되어 런타임 실패.
+
+---
+
+## 2. 키 규칙
+
+| 항목 | 규칙 |
+|---|---|
+| 키 패턴 | `^[A-Za-z_][A-Za-z0-9_]*$` (영문/숫자/언더스코어, 첫 글자 영문/언더스코어) |
+| 실 샘플 예 | `Query_Menu`, `Save_Cart`, `getList`, `chooseIdea`, `BookingEventQuery`, `UsualCostAppQuery_S`, `WkVactionAppSave_S`, `Delete_MenuLike` |
+| 네이밍 관례 | 동작_대상 (`Query_*` 조회, `Save_*` 저장, `Delete_*` 삭제, `*_S` 접미사 = Service 표기) — 강제 아님 |
+
+---
+
+## 3. 항목 형태
+
+```jsonc
+"ServiceBinding": {
+  "VactionDaysQuery_S": {
+    "SystemID":         "Other",
+    "SystemType":       "FlexSQL",
+    "ModuleID":         "VactionDaysQuery",
+    "ServiceName":      "VactionDaysQuery",
+    "SQLServiceName":   "VactionDaysQuery",
+    "MajorVersion":     2,
+    "ExternalDB":       "",
+    "UsePKey":          false,
+    "UseParamBlock":    true,
+    "UseResultBlock":   true,
+    "UseInnerBlock":    false,
+    "UseSearch":        false,
+    "UseBundle":        false,
+    "NotSeperateInnerBlock": false,
+    "SetCategory":      "CtgVactionDays",
+    "fEvent":           "",
+    "fEventKey":        "",
+    "BeforeScript":     "",
+    "ResultScript":     "",
+    "Method":           "",
+    "Url":              "",
+    "RequestHeader":    {},
+    "ParamScript":      "",
+    "SelectTable":      "",
+    "SPList":           [],
+    "UseTable":         false
+  }
+}
+```
+
+### 3.1 핵심 필드
+
+| 필드 | 타입 | 의미 / 비고 |
+|---|---|---|
+| `SystemID` | string | 시스템 식별자. 실 샘플: `Flextudio` (자체) / `Other` (커스텀) / `FlexSQL` |
+| `SystemType` | string | 시스템 종류 (`FlexSQL` / `Firestore` / `FlexAutoQuery` / `GoogleSheet`) |
+| `ModuleID` | string | 모듈 식별자 (필수) |
+| `ServiceName` | string | 서비스 이름 — `Action:'Service'` 의 `ServiceName` 과 매칭 |
+| `SQLServiceName` | string | FlexSQL 사용 시 등록된 SQL 서비스 이름 |
+| `MajorVersion` | integer (≥1) | 서비스 버전. 정수만 허용 (소수/문자열 금지). 보통 1 또는 2 |
+| `ExternalDB` | string | 외부 DB 식별자 |
+| `UseTable` | boolean | 테이블 직접 사용 (FlexAutoQuery) |
+| `SelectTable` | string\|object | FlexAutoQuery 대상 테이블 |
+| `SPList` | array | 스토어드 프로시저 목록 (FlexAutoQuery) |
+
+### 3.2 토글 필드
+
+| 필드 | 의미 |
+|---|---|
+| `UsePKey` | Primary Key 사용 |
+| `UseParamBlock` | 파라미터 블록 사용 |
+| `UseResultBlock` | 결과 블록 사용 |
+| `UseInnerBlock` | 내부 블록 (반복) 사용 |
+| `UseSearch` | 검색 모드 |
+| `UseBundle` | 번들 호출 |
+| `NotSeperateInnerBlock` | 내부 블록 분리 안 함 |
+
+### 3.3 결과/스크립트 필드
+
+| 필드 | 의미 |
+|---|---|
+| `SetCategory` | 결과 반영 대상 카테고리 이름 (`Ctg<Name>`) |
+| `BeforeScript` | FlexSQL Before Script — 호출 전 전처리 (param 가공 등) |
+| `ResultScript` | FlexSQL After Script — 결과 후처리 (반환 데이터 가공) |
+| `ParamScript` | 파라미터 스크립트 (외부 API) |
+| `fEvent` / `fEventKey` | 이벤트 연결 키 |
+
+### 3.4 외부 REST API 필드 (HTTP 호출)
+
+| 필드 | 의미 |
+|---|---|
+| `Method` | HTTP 메서드 — `GET` / `POST` / `PUT` / `DELETE` / `PATCH` / `""` |
+| `Url` | 호출 대상 URL |
+| `RequestHeader` | 요청 헤더 객체 (`{ "Authorization": "...", "Content-Type": "application/json" }`) |
+
+---
+
+## 4. 지원 시스템 (flextudio-guide §6.6 ~ §6.8)
+
+| 시스템 | 설명 | 비고 |
+|---|---|---|
+| **FlexSQL** | 워크스페이스 콘솔에서 등록한 쿼리 호출 | Business 플랜 이상. FlexDB / MySQL / Azure MSSQL 지원. Before/After Script 로 전후처리 |
+| **FlexAutoQuery** | FlexSQL 없이 FlexDB CRUD 자동 구성 | 자동생성 테이블만. 기본 컬럼: `DataSeq`, `CreateDate`, `CreateUserID`, `UpdateDate`, `UpdateUserID`, `TenantID` |
+| **Firestore** | Google Firestore 직접 연동 | |
+| **GoogleSheet** | 구글 시트 데이터 사용 | |
+| 외부 REST API | `Method` + `Url` + `RequestHeader` 로 호출 | |
+
+---
+
+## 5. Action ↔ ServiceBinding 연결
+
+`Action.ServiceBinding` 필드는 두 가지 형태가 가능:
+
+### 5.1 String 참조 — `scenario.ServiceBinding` 의 키 지목 (권장)
+
+```jsonc
+"ServiceBinding": {
+  "VactionDaysQuery_S": {
+    "SystemID": "Other", "ModuleID": "VactionDaysQuery", "MajorVersion": 2,
+    "UsePKey": false, "UseParamBlock": true, "UseResultBlock": true
+  }
+},
+"Events": {
+  "loadVactionDays": [
+    {
+      "Action":         "Service",
+      "ServiceBinding": "VactionDaysQuery_S",   // ← scenario.ServiceBinding 의 키
+      "ServiceName":    "VactionDaysQuery",
+      "SystemID":       "Other",
+      "Version":        2,
+      "ParamBlocks":    [
+        { "CategoryName": "userInfo", "UseFilter": true,
+          "Filters": [{ "FilterType": "Status", "Status": ["active"] }] }
+      ],
+      "ResultBlocks":   [
+        { "TargetType": "replace", "CategoryName": "vactionDays" }
+      ]
+    }
+  ]
+}
+```
+
+### 5.2 Inline 객체 — Action 안에 직접 박는 형태 (실 FlexSQL 패턴)
+
+```jsonc
+"Events": {
+  "showReceiveWho": [
+    {
+      "Action": "Service",
+      "Version": 2,
+      "SystemID": "FlexSQL",
+      "ServiceBinding": {                         // ← inline ServiceBinding
+        "SystemID":             "FlexSQL",
+        "SetCategory":          true,
+        "ModuleID":             "Default",
+        "UsePKey":              true,
+        "UseInnerBlock":        true,
+        "UseParamBlock":        true,
+        "UseResultBlock":       true,
+        "NotSeperateInnerBlock":true,
+        "ExternalDB":           true,
+        "SQLServiceName":       "메인화면:showReceiveWho",
+        "MajorVersion":         1
+      },
+      "UseCategory": true,
+      "ParamBlocks": [
+        { "UseFilter":true, "CategoryName":"", "Filters":[{"FilterType":"Status","Status":["active"]}] }
+      ],
+      "ResultBlocks": [
+        { "TargetType":"replace", "CategoryName":"showReceiveWho" }
+      ]
+    }
+  ]
+}
+```
+
+이 형태에서는 `scenario.ServiceBinding` 맵에 별도 등록 없이 인라인으로 동작한다. FlexSQL `SQLServiceName`(`Scenario:ServiceName` 콜론 표기) 직접 호출 시 흔함.
+
+### 5.3 ParamBlocks / ResultBlocks 형식
+
+자세한 형식은 [`events.md §2.3.1 / §2.3.2`](events.md) 참조.
+
+| 항목 | 형식 |
+|---|---|
+| ParamBlock | `{ CategoryName, UseFilter, Filters[], UserData[], UserFilterOption }` |
+| ResultBlock | `{ TargetType: category\|replace\|add\|merge, CategoryName, PKeys[] (merge 시), IsNotDelete }` |
+| InnerBlock | `{ InnerBlockKey }` |
+
+> 본 항목은 **운영 메타** 에서의 형식 정의이며, 스킬 생성에서는 `[no-service]` 가 Service / API Action 자체를 거부한다.
+
+---
+
+## 6. 검증 후크 정합
+
+| Tag | 위치 | 동작 |
+|---|---|---|
+| `[no-service]` | `validators.mjs` `checkNoService` | (a) ServiceBinding 비어있는 객체만, (b) Action='Service'/'API' 거부, (c) DataSourceType:'Service'/'API' 거부 |
+| `[strict-fields]` | strict Ajv 패스 | 위 표에 없는 필드명을 박으면 거부 |
+
+---
+
+## 7. 운영 메타 검증
+
+```bash
+node validate.mjs --strict-no-service=false path/to/operational.json
+```
+
+이 모드에서 ServiceBinding 항목 / Service / API 액션 / DataSource 'Service'/'API' 모두 통과.