@bimatrix-aud-platform/aud_mcp_server 1.1.19 → 1.1.20

package/dist/generators/fixer.js

@@ -56,7 +56,9 @@ export function fixMtsd(filePath) {
     fixOlapGridFields(doc, datas, fixes);
     // Rule 2-2: OlapGrid Fields 내 CreateType=1 (Measures) 필드 보정
     fixOlapMeasuresField(doc, fixes);
-    // Rule 3: DataSource Params에 Value 누락 보정
+    // Rule 3: Enum/Range 값 범위 초과 보정
+    fixEnumAndRangeValues(doc, datas, fixes);
+    // Rule (disabled): DataSource Params에 Value 누락 보정
     //fixParamsMissingValue(datas, fixes);
     // Rule 4: DataSource Columns에 Type 누락 보정
     //fixColumnsMissingType(datas, fixes);
@@ -308,6 +310,137 @@ const BORDER_DEFAULTS = {
 //     });
 //   }
 // }
+// ---- Rule 3: Enum/Range 값 범위 초과 보정 ----
+// string enum 검증: 허용값에 없으면 기본값으로 보정
+function fixStringEnum(obj, key, allowed, defaultVal, path, fixes) {
+    if (!(key in obj))
+        return;
+    const val = obj[key];
+    if (typeof val !== "string" || !allowed.includes(val)) {
+        obj[key] = defaultVal;
+        fixes.push(`[Rule3] ${path}.${key}: "${val}" → "${defaultVal}" 보정 (허용값: ${allowed.join(", ")})`);
+    }
+}
+// integer 범위 검증: min~max 범위 밖이면 기본값으로 보정
+function fixIntRange(obj, key, min, max, defaultVal, path, fixes) {
+    if (!(key in obj))
+        return;
+    const val = obj[key];
+    if (typeof val !== "number" || !Number.isInteger(val) || val < min || val > max) {
+        obj[key] = defaultVal;
+        fixes.push(`[Rule3] ${path}.${key}: ${val} → ${defaultVal} 보정 (범위: ${min}~${max})`);
+    }
+}
+// integer enum 검증: 허용 값 집합에 없으면 기본값으로 보정 (비연속 enum용)
+function fixIntEnum(obj, key, allowed, defaultVal, path, fixes) {
+    if (!(key in obj))
+        return;
+    const val = obj[key];
+    if (typeof val !== "number" || !allowed.includes(val)) {
+        obj[key] = defaultVal;
+        fixes.push(`[Rule3] ${path}.${key}: ${val} → ${defaultVal} 보정 (허용값: ${allowed.join(", ")})`);
+    }
+}
+// RGBA 색상 clamp (0~255)
+function clampColorRGBA(obj, path, fixes) {
+    if (!obj || typeof obj !== "object")
+        return;
+    for (const key of ["R", "G", "B", "A", "ColorR", "ColorG", "ColorB", "ColorA"]) {
+        if (!(key in obj))
+            continue;
+        const val = obj[key];
+        if (typeof val !== "number")
+            continue;
+        if (val < 0) {
+            obj[key] = 0;
+            fixes.push(`[Rule3] ${path}.${key}: ${val} → 0 보정 (범위: 0~255)`);
+        }
+        else if (val > 255) {
+            obj[key] = 255;
+            fixes.push(`[Rule3] ${path}.${key}: ${val} → 255 보정 (범위: 0~255)`);
+        }
+    }
+}
+function fixEnumAndRangeValues(doc, datas, fixes) {
+    // ── 1. ReportInfo ──
+    const ri = doc.ReportInfo;
+    if (ri) {
+        fixIntRange(ri, "TabPosition", 0, 2, 0, "ReportInfo", fixes); // 기본값: 1(None)
+        fixIntRange(ri, "RefreshType", 0, 1, 0, "ReportInfo", fixes); // 기본값: 0(All)
+    }
+    // ── 2. DataSources ──
+    for (const ds of datas) {
+        const dsPath = `DataSource("${ds.Name || ds.Id || "?"}")`;
+        fixIntRange(ds, "DSType", 0, 5, 2, dsPath, fixes); // 기본값: 2(DataSource) 
+    }
+    // ── 3. FormStyle ──
+    const forms = doc.Forms || [];
+    for (const form of forms) {
+        if (form.Style) {
+            fixIntRange(form.Style, "Type", 0, 2, 0, `Form("${form.Name}").Style`, fixes); // 기본값: 0(Skin)  
+        }
+    }
+    // ── 4. Elements (walkElements 순회) ──
+    for (const form of forms) {
+        const elements = form.Elements || [];
+        walkElements(elements, (el, path) => {
+            // ---- Style.Border.LineType ----
+            const border = el.Style?.Border;
+            if (border) {
+                fixStringEnum(border, "LineType", ["none", "solid", "dashed", "dotted"], "solid", // 기본값: "solid"
+                `${path}.Style.Border`, fixes);
+                clampColorRGBA(border, `${path}.Style.Border`, fixes);
+                if (border.Color)
+                    clampColorRGBA(border.Color, `${path}.Style.Border.Color`, fixes);
+            }
+            // ---- Style.Font.HorizontalAlignment / VerticalAlignment ----
+            const font = el.Style?.Font;
+            if (font) {
+                fixStringEnum(font, "HorizontalAlignment", ["left", "center", "right"], "left", // 기본값: "left" 
+                `${path}.Style.Font`, fixes);
+                fixStringEnum(font, "VerticalAlignment", ["top", "middle", "bottom"], "middle", // 기본값: "middle"
+                `${path}.Style.Font`, fixes);
+                if (font.Color)
+                    clampColorRGBA(font.Color, `${path}.Style.Font.Color`, fixes);
+            }
+            // ---- Style.Background Color ----
+            const bg = el.Style?.Background;
+            if (bg) {
+                clampColorRGBA(bg, `${path}.Style.Background`, fixes);
+                if (bg.Color)
+                    clampColorRGBA(bg.Color, `${path}.Style.Background.Color`, fixes);
+            }
+            // ---- DataGrid / TreeGrid Columns ----
+            if ((el.Type === "DataGrid" || el.Type === "TreeGrid") && Array.isArray(el.Columns)) {
+                for (let i = 0; i < el.Columns.length; i++) {
+                    const col = el.Columns[i];
+                    const colPath = `${path}.Columns[${i}]("${col.Name || ""}")`;
+                    fixStringEnum(col, "HeaderPosition", ["left", "center", "right", "start", "end"], "center", // 기본값: "center" 
+                    colPath, fixes);
+                    fixStringEnum(col, "TextPosition", ["left", "center", "right", "start", "end"], "left", // 기본값: "left"
+                    colPath, fixes);
+                    // 0:None, 1:Text, 2:CheckBox, 3:NumberBox, 4:ComboBox, 5:DateTime, 6:MaskEdit, 8:Image, 9:MultiLineText, 10:TrendLine, 11:SingleBarChart, 12:ColorPicker, 15:Time
+                    fixIntEnum(col, "ColumnType", [0, 1, 2, 3, 4, 5, 6, 8, 9, 10, 11, 12, 15], 1, colPath, fixes); // 기본값: 0(None)
+                    fixIntRange(col, "KeyType", 0, 3, 2, colPath, fixes); // 기본값: 2(Nullable)
+                    fixIntRange(col, "DataType", 0, 2, 0, colPath, fixes); // 기본값: 1(String)
+                }
+            }
+            // ---- OlapGrid Fields ----
+            if (el.Type === "OlapGrid") {
+                const fields = el.iOLAPView?.Fields;
+                if (fields && Array.isArray(fields)) {
+                    for (const field of fields) {
+                        const fPath = `${path}.Fields["${field.Key || "?"}"]`;
+                        fixIntRange(field, "Category", 0, 4, 1, fPath, fixes); // 기본값: 1(Dimension)
+                        fixIntRange(field, "Area", 0, 4, 3, fPath, fixes); // 기본값: 3(Filter)
+                        fixIntRange(field, "SortType", 0, 5, 0, fPath, fixes); // 기본값: 0(None)
+                        fixIntRange(field, "CreateType", 0, 3, 0, fPath, fixes); // 기본값: 0(Default)
+                    }
+                }
+            }
+        });
+    }
+}
 // ---- 유틸: Element 트리 순회 ----
 function walkElements(elements, callback, parentPath = "") {
     for (const el of elements) {

package/dist/index.js

@@ -545,7 +545,7 @@ const tools = [
     },
     {
         name: "fix_mtsd",
-        description: "MTSD 파일을 읽어 자동 보정 규칙을 적용하고 파일을 덮어씁니다. DataSource Name→Id 참조 보정, Params Value 누락 보정, Columns Type 누락 보정, Docking/Border 필수 속성 보정을 수행합니다.",
+        description: "MTSD 파일을 읽어 자동 보정 규칙을 적용하고 파일을 덮어씁니다. [Rule1] DataSource Name→Id 참조 보정, [Rule2] OlapGrid DataSource 기반 Fields 자동 생성, [Rule2-2] OlapGrid Fields 내 CreateType=1 중복 보정 (#MEASURES_HEADER#만 허용), [Rule3] Enum/Range 값 범위 초과 보정 (Border.LineType, Font 정렬, Color RGBA clamp, GridColumn 속성, OlapField 속성 등), Params ParamType 누락 보정을 수행합니다.",
         inputSchema: {
             type: "object",
             properties: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bimatrix-aud-platform/aud_mcp_server",
-  "version": "1.1.19",
+  "version": "1.1.20",
   "description": "MCP Server for i-AUD MTSD document validation and generation",
   "type": "module",
   "main": "dist/index.js",

package/schemas/mtsd.interface.ts

@@ -115,7 +115,7 @@ export interface IDataSource {
   ConnectionCode: string;
   /** SQL 쿼리 암호화 여부 */
   Encrypted:  boolean;
-  /** 데이터소스 타입 (0: DataSource, 1: MetaData, 2: Template, 3: ServerDataSource) */
+  /** 데이터소스 타입 (0:메타 템플릿,1:메타 쿼리, 2:일반 SQL,3:OLAP Drill to Detail,4:공통데이터소스,5:메타 필터) */
   DSType: number;
   /** 실행할 SQL 쿼리문 */
   SQL: string;
@@ -657,13 +657,13 @@ export interface IGridColumn {
   Resizable?: boolean;
   /** 내보내기 포함 여부 */
   UseExport?: boolean;
-  /** 컬럼 타입 (0: Text, 1: CheckBox, 2: ComboBox 등) */
+  /** 컬럼 타입 (0:None, 1:Text, 2:CheckBox, 3:NumberBox, 4:ComboBox, 5:DateTime, 6:MaskEdit, 8:Image, 9:MultiLineText, 10:TrendLine, 11:SingleBarChart, 12:ColorPicker, 15:Time) */
   ColumnType?: number;
   /** 커서 타입 */
   CursorType?: string;
-  /** 키 타입 (0: None, 1: Primary, 2: Foreign 등) */
+  /** 키 타입 (0:None, 1:NotNull, 2:Nullable, 3:Primary) */
   KeyType: number;
-  /** 데이터 타입 (0: String, 1: Number, 2: Date 등) */
+  /** 데이터 타입 (0:Numeric, 1:String, 2:DateTime8(yyyyMMdd), 3:DateTimeNow, 4:UserCode, 5:CLOB, 7:UUID) */
   DataType?: number;
   /** 헤더 텍스트 정렬 */
   HeaderPosition: 'left' | 'center' | 'right' | 'start' | 'end';
@@ -1433,7 +1433,7 @@ export interface IOlapField {
   ToolTipField?: string;
   /** 툴팁 텍스트 */
   ToolTipText?: string;
-  /** 필드 카테고리 (0: Dimension, 1: Measure, 2: Attribute, 3: Period, 4: Datas) */
+  /** 필드 카테고리 (0: Default, 1: Dimension, 2: Measure, 3: Attribute, 4: Period) */
   Category: number;
   /** 필드 영역 (0: None, 1: Row, 2: Column, 3: Data, 4: Filter) */
   Area: number;

package/schemas/mtsd.schema.json

@@ -102,7 +102,7 @@
         "UseCache": { "type": "boolean", "description": "쿼리 결과 캐싱 사용 여부" },
         "ConnectionCode": { "type": "string", "description": "연결된 DB 커넥션 코드" },
         "Encrypted": { "type": "boolean", "description": "SQL 쿼리 암호화 여부" },
-        "DSType": { "type": "integer", "enum": [0, 1, 2, 3], "description": "데이터소스 타입 (0:DataSource, 1:MetaData, 2:Template, 3:ServerDataSource)" },
+        "DSType": { "type": "integer", "enum": [0, 1, 2, 3,4,5], "description": "데이터소스 타입 (0:메타 템플릿,1:메타 쿼리, 2:일반 SQL,3:OLAP Drill to Detail,4:공통데이터소스,5:메타 필터)" },
         "SQL": { "type": "string", "description": "실행할 SQL 쿼리문" },
         "Params": {
           "type": "array",
@@ -1019,7 +1019,7 @@
         "Caption": { "type": "string", "description": "필드 캡션" },
         "ToolTipField": { "type": "string", "description": "툴팁 필드 키" },
         "ToolTipText": { "type": "string", "description": "툴팁 텍스트" },
-        "Category": { "type": "number", "description": "카테고리 (0:Dimension, 1:Measure, 2:Attribute, 3:Period, 4:Datas)" },
+        "Category": { "type": "number", "description": "카테고리 (0: Default, 1: Dimension, 2: Measure, 3: Attribute, 4: Period)" },
         "Area": { "type": "number", "description": "영역 (0:None, 1:Row, 2:Column, 3:Data, 4:Filter)" },
         "SummaryType": { "type": "number", "description": "요약 유형 (0:Sum, 1:Count, 2:Average, 3:Min, 4:Max 등)" },
         "TotalSummaryType": { "type": "number", "description": "합계 요약 유형" },
@@ -1325,10 +1325,10 @@
         "Mergeable": { "type": "boolean" },
         "Resizable": { "type": "boolean" },
         "UseExport": { "type": "boolean" },
-        "ColumnType": { "type": "integer", "description": "컬럼 타입 (0:Text, 1:CheckBox, 2:ComboBox)" },
+        "ColumnType": { "type": "integer", "description": "컬럼 타입 (0:None, 1:Text, 2:CheckBox, 3:NumberBox, 4:ComboBox, 5:DateTime, 6:MaskEdit, 8:Image, 9:MultiLineText, 10:TrendLine, 11:SingleBarChart, 12:ColorPicker, 15:Time)" },
         "CursorType": { "type": "string" },
-        "KeyType": { "type": "integer", "description": "키 타입 (0:None, 1:Primary, 2:Foreign)" },
-        "DataType": { "type": "integer", "description": "데이터 타입 (0:String, 1:Number, 2:Date)" },
+        "KeyType": { "type": "integer", "description": "키 타입 (0:None, 1:NotNull, 2:Nullable, 3:Primary)" },
+        "DataType": { "type": "integer", "description": "데이터 타입 (0:Numeric, 1:String, 2:DateTime8(yyyyMMdd), 3:DateTimeNow, 4:UserCode, 5:CLOB, 7:UUID)" },
         "HeaderPosition": { "type": "string", "enum": ["left", "center", "right", "start", "end"] },
         "TextPosition": { "type": "string", "enum": ["left", "center", "right", "start", "end"] },
         "GridColumnWidthType": { "type": "integer" },