fmea-api-mcp-server 1.1.37 → 1.1.39

package/endpoints/v2/failure-modes/core.json

@@ -8,7 +8,7 @@
       "method": "GET",
       "operationId": "get",
       "summary": "Get failure mode details",
-      "description": "Returns a failure mode by ID. If search is provided, resolves by failure mode name within the block diagram.",
+      "description": "Returns a failure mode by ID.",
       "tags": [
         "Failure Mode"
       ],
@@ -39,14 +39,6 @@
           "schema": {
             "type": "string"
           }
-        },
-        {
-          "name": "q",
-          "in": "query",
-          "description": "Failure mode name keyword",
-          "schema": {
-            "type": "string"
-          }
         }
       ],
       "requestBody": null,
@@ -498,6 +490,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "failureModeSearch",
           "in": "query",
@@ -667,6 +668,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "failureModeSearch",
           "in": "query",

package/endpoints/v2/fourm/core.json

@@ -6,7 +6,7 @@
     {
       "path": "/api/v2/fourm",
       "method": "GET",
-      "operationId": "list_7",
+      "operationId": "list_8",
       "summary": "List 4M analysis items",
       "description": "Retrieves all 4M (Man, Machine, Material, Environment) analysis items with optional filtering. Supports querying by project ID (projectId) and single or double tags (tag, secondTag) for targeted searches. Use this endpoint to browse, filter, or search for existing 4M analysis records within a project context. Returns a comprehensive list of analysis entries that can be further processed or displayed.",
       "tags": [],
@@ -82,7 +82,7 @@
     {
       "path": "/api/v2/fourm",
       "method": "POST",
-      "operationId": "create_3",
+      "operationId": "create_4",
       "summary": "Create 4M analysis item",
       "description": "Creates a new 4M (Man, Machine, Material, Environment) analysis item in the system. Accepts analysis data including categorization by the four M dimensions (Man/Personnel, Machine/Equipment, Material/Resources, Environment/Conditions). Use this endpoint to initiate a new 4M analysis, register factors for quality or risk assessment, or document production variables. Returns the complete created object with system-generated ID.",
       "tags": [],
@@ -228,7 +228,7 @@
     {
       "path": "/api/v2/fourm/{id}",
       "method": "PUT",
-      "operationId": "update_2",
+      "operationId": "update_3",
       "summary": "Update 4M analysis item",
       "description": "Modifies an existing 4M analysis item identified by its ID. Accepts partial or complete updates to the analysis data including changes to categorization, descriptions, or any of the four M dimensions (Man, Machine, Material, Environment). Use this endpoint to correct, enhance, or evolve analysis records over time. Returns the updated object reflecting all changes applied.",
       "tags": [],
@@ -314,7 +314,7 @@
     {
       "path": "/api/v2/fourm/{id}",
       "method": "DELETE",
-      "operationId": "delete_2",
+      "operationId": "delete_3",
       "summary": "Delete 4M analysis item",
       "description": "Permanently removes a 4M analysis item from the system using its unique identifier. This operation is irreversible and will eliminate all associated data including the four M dimension classifications (Man, Machine, Material, Environment). Use with caution for removing obsolete or incorrect analysis records. Returns no content upon successful deletion (204 status).",
       "tags": [],

package/endpoints/v2/high-items/core.json

@@ -6,7 +6,7 @@
     {
       "path": "/api/v2/projects/{projectId}/high-items",
       "method": "PUT",
-      "operationId": "update_6",
+      "operationId": "update_8",
       "summary": "Batch upsert and reorder high items by project",
       "description": "Updates the project high-item list with batch upsert semantics. Existing items are matched by sequence or title, ranks are recalculated by input order, and omitted items are removed.",
       "tags": [

package/endpoints/v2/notices/core.json

@@ -6,7 +6,7 @@
     {
       "path": "/api/v2/notices/{id}",
       "method": "DELETE",
-      "operationId": "delete_3",
+      "operationId": "delete_4",
       "summary": "Delete notice",
       "description": "Deletes a notice by ID. Requires admin permission. Returns 404 if notice does not exist.",
       "tags": [
@@ -37,7 +37,7 @@
     {
       "path": "/api/v2/notices",
       "method": "GET",
-      "operationId": "list_8",
+      "operationId": "list_9",
       "summary": "List notices",
       "description": "Returns a paged list of notices. Supports optional visibility filter. Use page=0 to retrieve all notices without paging.",
       "tags": [
@@ -286,7 +286,7 @@
     {
       "path": "/api/v2/notices",
       "method": "POST",
-      "operationId": "create_4",
+      "operationId": "create_5",
       "summary": "Create notice",
       "description": "Creates a new notice. Requires admin permission. Title and content are required fields.",
       "tags": [
@@ -362,7 +362,7 @@
     {
       "path": "/api/v2/notices/{id}",
       "method": "PUT",
-      "operationId": "update_3",
+      "operationId": "update_4",
       "summary": "Update notice",
       "description": "Updates an existing notice by ID. Requires admin permission. Returns 404 if notice does not exist.",
       "tags": [

package/endpoints/v2/projects/core.json

@@ -6,9 +6,9 @@
     {
       "path": "/api/v2/projects",
       "method": "GET",
-      "operationId": "list_9",
+      "operationId": "list_10",
       "summary": "List project summaries",
-      "description": "Returns paged project summaries. scope: 'my' (default, user's projects), 'all' (admin, all active), 'deleted' (admin, trashed). Supports divisionId, search, fmeaType, status, sort, pagination.",
+      "description": "Returns paged project summaries. scope: 'my' (default, user's projects), 'division', 'all' (admin, all active). deleted=true returns admin-only trashed projects. Supports divisionId, search, fmeaType, status, sort, pagination.",
       "tags": [
         "Project"
       ],
@@ -16,15 +16,24 @@
         {
           "name": "scope",
           "in": "query",
-          "description": "Scope: my (default), all (admin only), deleted (admin only)",
+          "description": "Scope: my (default), division, all (admin only)",
           "schema": {
             "type": "string"
           }
         },
+        {
+          "name": "deleted",
+          "in": "query",
+          "description": "Deleted-only view (admin only)",
+          "schema": {
+            "type": "boolean",
+            "default": false
+          }
+        },
         {
           "name": "divisionId",
           "in": "query",
-          "description": "Division ID filter (used with scope=all)",
+          "description": "Division ID filter (used with scope=division or scope=all)",
           "schema": {
             "type": "integer",
             "format": "int32"
@@ -46,6 +55,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "fmeaType",
           "in": "query",
@@ -388,6 +406,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "fmeaType",
           "in": "query",
@@ -661,6 +688,15 @@
           "schema": {
             "type": "string"
           }
+        },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
         }
       ],
       "responses": {
@@ -1053,7 +1089,7 @@
     {
       "path": "/api/v2/projects/{projectId}/high-items",
       "method": "GET",
-      "operationId": "list_13",
+      "operationId": "list_15",
       "summary": "List high items by project",
       "description": "Returns high items in the target project ordered by rank. Supports optional keyword search on high-item titles and is used by system-definition screens.",
       "tags": [
@@ -1071,9 +1107,19 @@
         {
           "name": "q",
           "in": "query",
+          "description": "Unified keyword for high-item titles",
           "schema": {
             "type": "string"
           }
+        },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
         }
       ],
       "responses": {

package/endpoints/v2/recommendation-items/core.json

@@ -37,6 +37,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "scope",
           "in": "query",

package/endpoints/v2/search/core.json

@@ -8,7 +8,7 @@
       "method": "GET",
       "operationId": "searchFailureModes",
       "summary": "Search failure modes globally",
-      "description": "Searches failure modes across all projects in the system. Supports keyword search (q), scope filtering (my/division/all), project-level filters (projectId, projectName, fmeaType, status), and sorting (sort=name,asc or sort=rpn,desc). Returns paged results with project summary information and S/O/D cause data.",
+      "description": "Searches failure modes across all projects in the system. Supports keyword search (q, optional, comma-separated with synonym expansion), project-level filters (projectId, projectName, fmeaType, status), and sorting (sort=name,asc or sort=rpn,desc). Returns paged results with project summary information and S/O/D cause data.",
       "tags": [
         "Search"
       ],
@@ -16,7 +16,7 @@
         {
           "name": "q",
           "in": "query",
-          "description": "Search keyword for failure mode names (required, max 100 characters)",
+          "description": "Search keyword for failure mode names (optional, max 100 characters, comma-separated OR search with synonym expansion)",
           "schema": {
             "type": "string"
           }
@@ -72,7 +72,7 @@
         {
           "name": "page",
           "in": "query",
-          "description": "Page number (0 = all, default: 1)",
+          "description": "Page number (default: 1, 0 = all only when q is provided)",
           "schema": {
             "type": "integer",
             "default": 1,
@@ -82,13 +82,22 @@
         {
           "name": "size",
           "in": "query",
-          "description": "Page size (default: 50)",
+          "description": "Page size (default: 50, max: 1000)",
           "schema": {
             "type": "integer",
             "default": 50,
             "format": "int32"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "projectId",
           "in": "query",
@@ -388,6 +397,15 @@
             "format": "int32"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "sort",
           "in": "query",
@@ -682,6 +700,15 @@
             "type": "string"
           }
         },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        },
         {
           "name": "aiId",
           "in": "query",

package/endpoints/v2/synonym-excel/core.json

@@ -0,0 +1,123 @@
+{
+  "category": "Synonym Excel",
+  "version": "v2",
+  "description": "",
+  "endpoints": [
+    {
+      "path": "/api/v2/synonym-excel/export",
+      "method": "GET",
+      "operationId": "export",
+      "summary": "Export synonyms to Excel",
+      "description": "Exports synonym groups to an XLSX file and returns a download URI. Optional q filter narrows the exported groups before generating the workbook.",
+      "tags": [
+        "SynonymExcel"
+      ],
+      "parameters": [
+        {
+          "name": "q",
+          "in": "query",
+          "description": "Optional synonym keyword filter for exported rows",
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "useSynonym",
+          "in": "query",
+          "description": "Whether to expand q with synonym dictionary terms (default: true)",
+          "schema": {
+            "type": "boolean",
+            "default": true
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "fileName": {
+                    "type": "string"
+                  },
+                  "downloadUri": {
+                    "type": "string"
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "path": "/api/v2/synonym-excel/{uuid}",
+      "method": "POST",
+      "operationId": "importExcel",
+      "summary": "Import synonyms from Excel",
+      "description": "Imports synonym groups from a previously uploaded Excel file referenced by uuid. Supports row and column range selection and optional merge into existing groups by first term.",
+      "tags": [
+        "SynonymExcel"
+      ],
+      "parameters": [
+        {
+          "name": "uuid",
+          "in": "path",
+          "description": "Uploaded file UUID",
+          "required": true,
+          "schema": {
+            "type": "string"
+          }
+        },
+        {
+          "name": "rowStart",
+          "in": "query",
+          "description": "Data start row (1-based, default: 1)",
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        {
+          "name": "columnStart",
+          "in": "query",
+          "description": "Start column (1-based, default: 1)",
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        {
+          "name": "columnEnd",
+          "in": "query",
+          "description": "End column (1-based, required)",
+          "schema": {
+            "type": "integer",
+            "format": "int32"
+          }
+        },
+        {
+          "name": "merge",
+          "in": "query",
+          "description": "Merge into existing groups when first term matches (default: false)",
+          "schema": {
+            "type": "boolean"
+          }
+        }
+      ],
+      "requestBody": null,
+      "responses": {
+        "default": {
+          "description": "default response",
+          "content": {
+            "application/json": {}
+          }
+        }
+      },
+      "x-dependency-warning": "REQUIRES PRIOR FILE UPLOAD via [POST /api/v2/files]. The {uuid} parameter is the file identifier returned by the upload endpoint."
+    }
+  ]
+}