From 13f3c7b053ce59834d79201cb84af891f5a3445d Mon Sep 17 00:00:00 2001
From: raymond <iko@datacom.jp>
Date: Wed, 10 Sep 2025 06:39:58 +0000
Subject: [PATCH] update server.ts for documentation

---
 api-documentation.html |  2 +-
 server.ts              | 30 +++++++++++++++---------------
 2 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/api-documentation.html b/api-documentation.html
index 475d326..6da21b0 100644
--- a/api-documentation.html
+++ b/api-documentation.html
@@ -28,7 +28,7 @@
     <script>
         window.onload = function() {
             const ui = SwaggerUIBundle({
-                spec: {"openapi":"3.0.0","info":{"title":"My Express API","version":"1.0.0","description":"API documentation for my awesome Express app"},"servers":[{"url":"http://localhost:3000"}],"paths":{"/api/health":{"get":{"summary":"Health check endpoint","description":"Returns the health status of the API","responses":{"200":{"description":"API is healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"OK"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"/api/unique":{"post":{"summary":"Get unique values from a data series","description":"Returns an array of unique values from the provided data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"}}}}}},"responses":{"200":{"description":"Unique values calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/mean":{"post":{"summary":"Calculate mean of a data series","description":"Returns the arithmetic mean of the provided data series, optionally filtered by conditions","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}},"examples":{"value":{"series":{"values":[10,20,30,40,50],"labels":["Q1","Q2","Q3","Q4","Q5"]}}}}}},"responses":{"200":{"description":"Mean calculated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"successful_calculation":{"summary":"Successful mean calculation","description":"Mean of [10, 20, 30, 40, 50] is 30","value":{"success":true,"data":30}}}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"empty_series":{"summary":"Empty series error","value":{"success":false,"error":"Series must contain at least one value"}},"invalid_format":{"summary":"Invalid data format","value":{"success":false,"error":"Series values must be an array of numbers"}}}}}}}}},"/api/count":{"post":{"summary":"Count data points in a series","description":"Returns the count of data points in the series, optionally filtered by conditions","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Count calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/variance":{"post":{"summary":"Calculate variance of a data series","description":"Returns the variance of the provided data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Variance calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/std":{"post":{"summary":"Calculate standard deviation of a data series","description":"Returns the standard deviation of the provided data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Standard deviation calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/percentile":{"post":{"summary":"Calculate percentile of a data series","description":"Returns the specified percentile of the provided data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"percent":{"type":"number","description":"Percentile to calculate (0-100)","example":95},"ascending":{"type":"boolean","description":"Sort order","default":true},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Percentile calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/median":{"post":{"summary":"Calculate median of a data series","description":"Returns the median (50th percentile) of the provided data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Median calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/mode":{"post":{"summary":"Calculate mode of a data series","description":"Returns the mode (most frequent values) of the provided data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Mode calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/max":{"post":{"summary":"Find maximum value in a data series","description":"Returns the maximum value from the provided data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Maximum value found successfully"},"400":{"description":"Invalid input data"}}}},"/api/min":{"post":{"summary":"Find minimum value in a data series","description":"Returns the minimum value from the provided data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Minimum value found successfully"},"400":{"description":"Invalid input data"}}}},"/api/correlation":{"post":{"summary":"Calculate correlation between two data series","description":"Returns the Pearson correlation coefficient between two data series","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series1":{"$ref":"#/components/schemas/DataSeries"},"series2":{"$ref":"#/components/schemas/DataSeries"}}},"examples":{"value":{"series1":{"values":[1,2,3,4,5],"labels":["Day 1","Day 2","Day 3","Day 4","Day 5"]},"series2":{"values":[2,4,6,8,10],"labels":["Day 1","Day 2","Day 3","Day 4","Day 5"]}}}}}},"responses":{"200":{"description":"Correlation calculated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"perfect_positive":{"value":{"success":true,"data":1}}}}}},"400":{"description":"Invalid input data or series have different lengths","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"different_lengths":{"summary":"Series length mismatch","value":{"success":false,"error":"Series must have same length for correlation"}},"insufficient_data":{"summary":"Insufficient data points","value":{"success":false,"error":"At least 2 data points required for correlation"}}}}}}}}},"/api/series/moving-average":{"post":{"summary":"Calculate moving average of a data series","description":"Returns the moving average of the provided data series with specified window size","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"windowSize":{"type":"integer","description":"Size of the moving window","minimum":1,"example":3}}},"examples":{"stock_prices":{"summary":"Stock price data","value":{"series":{"values":[100,102,98,105,110,108,112,115],"labels":["Mon","Tue","Wed","Thu","Fri","Sat","Sun","Mon"]},"windowSize":3}}}}}},"responses":{"200":{"description":"Moving average calculated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"array","items":{"type":"number"}}}},"examples":{"stock_moving_avg":{"summary":"3-day moving average result","description":"Moving average for stock prices with window size 3","value":{"success":true,"data":[100,101.67,104.33,107.67,110,111.67]}}}}}},"400":{"description":"Invalid input data or window size","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"window_too_large":{"summary":"Window size exceeds data length","value":{"success":false,"error":"Window size cannot be larger than series length"}},"invalid_window_size":{"summary":"Invalid window size","value":{"success":false,"error":"Window size must be a positive number"}}}}}}}}},"/api/series/rolling":{"post":{"summary":"Get rolling windows of a data series","description":"Returns rolling windows of the provided data series with specified window size","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"windowSize":{"type":"integer","description":"Size of the rolling window","minimum":1,"example":3}}}}}},"responses":{"200":{"description":"Rolling windows calculated successfully"},"400":{"description":"Invalid input data or window size"}}}},"/api/ml/kmeans":{"post":{"summary":"Perform K-means clustering","description":"Performs K-means clustering on the provided data matrix","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"matrix":{"$ref":"#/components/schemas/DataMatrix"},"nClusters":{"type":"integer","description":"Number of clusters","minimum":1,"example":3},"options":{"type":"object","description":"K-means options"}}},"examples":{"customer_segmentation":{"summary":"Customer segmentation data","value":{"matrix":{"data":[[25,50000],[30,60000],[35,70000],[40,45000],[22,35000],[28,55000]],"columns":["age","income"]},"nClusters":2,"options":{"maxIterations":100}}}}}}},"responses":{"200":{"description":"K-means clustering completed successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"clusters":{"type":"array","items":{"type":"array","items":{"type":"array","items":{"type":"number"}}}},"centroids":{"type":"array","items":{"type":"array","items":{"type":"number"}}}}}}},"examples":{"customer_clusters":{"summary":"Customer segmentation result","description":"Customers grouped into 2 clusters by age and income","value":{"success":true,"data":{"clusters":[[[30,60000],[35,70000],[28,55000]],[[25,50000],[40,45000],[22,35000]]],"centroids":[[31.000000000000004,61666.666666666664],[29.000000000000007,43333.33333333333]]}}}}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"too_many_clusters":{"summary":"More clusters than data points","value":{"success":false,"error":"Number of clusters cannot exceed number of data points"}},"invalid_data":{"summary":"Invalid matrix data","value":{"success":false,"error":"Matrix must contain at least one row"}}}}}}}}},"/api/time/week-number":{"post":{"summary":"Get week number from date","description":"Returns the ISO week number for the provided date string","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"Date string in ISO format","example":"2024-03-15"}}}}}},"responses":{"200":{"description":"Week number calculated successfully"},"400":{"description":"Invalid date format"}}}},"/api/time/same-day-last-year":{"post":{"summary":"Get same day of week from last year","description":"Returns the date string for the same day of the week from the previous year","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"Date string in ISO format","example":"2024-03-15"}}}}}},"responses":{"200":{"description":"Same day last year calculated successfully"},"400":{"description":"Invalid date format"}}}},"/api/retail/purchase-rate":{"post":{"summary":"Calculate purchase rate","description":"Calculates the purchase rate as a percentage of product purchases over total transactions","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"productPurchases":{"type":"number","description":"Number (or amount) of product purchases","example":150},"totalTransactions":{"type":"number","description":"Total number (or amount) of transactions","example":1000}}},"examples":{"value":{"productPurchases":320,"totalTransactions":2500}}}}},"responses":{"200":{"description":"Purchase rate calculated successfully","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"successful_calculation":{"description":"320 purchases out of 2500 transactions = 12.8%","value":{"success":true,"data":12.8}}}}}},"400":{"description":"Invalid input data or division by zero","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"zero_transactions":{"summary":"Zero total transactions","value":{"success":false,"error":"Total transactions cannot be zero"}},"negative_values":{"summary":"Negative input values","value":{"success":false,"error":"Purchase count and transactions must be positive numbers"}}}}}}}}},"/api/retail/lift-value":{"post":{"summary":"Calculate lift value","description":"Calculates the lift value for market basket analysis","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jointPurchaseRate":{"type":"number","description":"Joint purchase rate of both products","example":0.05},"productAPurchaseRate":{"type":"number","description":"Purchase rate of product A","example":0.2},"productBPurchaseRate":{"type":"number","description":"Purchase rate of product B","example":0.3}}}}}},"responses":{"200":{"description":"Lift value calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/cost-ratio":{"post":{"summary":"Calculate cost ratio","description":"Calculates the cost ratio (cost divided by sale price)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cost":{"type":"number","description":"Cost of the product","example":50},"salePrice":{"type":"number","description":"Sale price of the product","example":100}}}}}},"responses":{"200":{"description":"Cost ratio calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/gross-margin":{"post":{"summary":"Calculate gross margin rate","description":"Calculates the gross margin rate as a percentage","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"salePrice":{"type":"number","description":"Sale price of the product","example":100},"cost":{"type":"number","description":"Cost of the product","example":60}}}}}},"responses":{"200":{"description":"Gross margin rate calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/average-spend":{"post":{"summary":"Calculate average spend per customer","description":"Calculates the average amount spent per customer","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"totalRevenue":{"type":"number","description":"Total revenue","example":50000},"numberOfCustomers":{"type":"number","description":"Number of customers","example":500}}}}}},"responses":{"200":{"description":"Average spend calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/purchase-index":{"post":{"summary":"Calculate purchase index","description":"Calculates the purchase index (items per 1000 customers)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"totalItemsSold":{"type":"number","description":"Total number of items sold","example":2500},"numberOfCustomers":{"type":"number","description":"Number of customers","example":1000}}}}}},"responses":{"200":{"description":"Purchase index calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/predict/forecast":{"post":{"summary":"Generate time series forecast","description":"Generates a forecast for time series data using linear regression","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"forecastPeriods":{"type":"integer","description":"Number of periods to forecast","minimum":1,"example":5}}},"examples":{"sales_forecast":{"summary":"Monthly sales forecast","value":{"series":{"values":[1000,1200,1100,1300,1250,1400,1350,1500],"labels":["Jan","Feb","Mar","Apr","May","Jun","Jul","Aug"]},"forecastPeriods":3}}}}}},"responses":{"200":{"description":"Forecast generated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean"},"data":{"type":"object","properties":{"forecast":{"type":"array","items":{"type":"number"}},"predictionIntervals":{"type":"object","properties":{"lower":{"type":"array","items":{"type":"number"}},"upper":{"type":"array","items":{"type":"number"}}}},"modelParameters":{"type":"object","properties":{"slope":{"type":"number"},"intercept":{"type":"number"}}}}}}},"examples":{"sales_forecast_result":{"summary":"3-month sales forecast","description":"Forecast shows upward trend in sales","value":{"success":true,"data":{"forecast":[1535.7142857142858,1596.4285714285716,1657.142857142857],"predictionIntervals":{"lower":[1399.6187310477208,1460.3330167620065,1521.047302476292],"upper":[1671.8098403808508,1732.5241260951366,1793.2384118094221]},"modelParameters":{"slope":60.714285714285715,"intercept":1050}}}}}}}},"400":{"description":"Invalid input data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"},"examples":{"insufficient_data":{"summary":"Not enough data points","value":{"success":false,"error":"At least 2 data points required for forecasting"}},"invalid_periods":{"summary":"Invalid forecast periods","value":{"success":false,"error":"Forecast periods must be a positive integer"}}}}}}}}},"/api/docs/export/json":{"get":{"summary":"Export API documentation as JSON","description":"Returns the complete OpenAPI specification in JSON format","responses":{"200":{"description":"OpenAPI specification in JSON format","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/docs/export/yaml":{"get":{"summary":"Export API documentation as YAML","description":"Returns the complete OpenAPI specification in YAML format","responses":{"200":{"description":"OpenAPI specification in YAML format","content":{"text/yaml":{"schema":{"type":"string"}}}}}}},"/api/docs/export/html":{"get":{"summary":"Export API documentation as HTML","description":"Returns a standalone HTML file with the complete API documentation","responses":{"200":{"description":"Standalone HTML documentation","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"DataSeries":{"type":"object","required":["values"],"properties":{"values":{"type":"array","items":{"type":"number"},"description":"Array of numerical values","example":[1,2,3,4,5]},"labels":{"type":"array","items":{"type":"string"},"description":"Optional labels for the values","example":["Jan","Feb","Mar","Apr","May"]}}},"DataMatrix":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"array","items":{"type":"number"}},"description":"2D array of numerical values","example":[[1,2],[3,4],[5,6]]},"columns":{"type":"array","items":{"type":"string"},"description":"Optional column names","example":["x","y"]},"rows":{"type":"array","items":{"type":"string"},"description":"Optional row names","example":["row1","row2","row3"]}}},"Condition":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","description":"Field name to apply condition on","example":"value"},"operator":{"type":"string","enum":[">","<","=",">=","<=","!="],"description":"Comparison operator","example":">"},"value":{"oneOf":[{"type":"number"},{"type":"string"}],"description":"Value to compare against","example":10}}},"ApiResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was successful"},"data":{"description":"Response data (varies by endpoint)"},"error":{"type":"string","description":"Error message if success is false"}}}}},"tags":[]},
+                spec: {"openapi":"3.0.0","info":{"title":"My Express API","version":"1.0.0","description":"API documentation for my awesome Express app"},"servers":[{"url":"http://localhost:3000"}],"paths":{"/api/health":{"get":{"summary":"Health check endpoint","description":"Returns the health status of the API","tags":["Health"],"responses":{"200":{"description":"API is healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"OK"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"/api/unique":{"post":{"summary":"Get unique values from a data series","description":"Returns an array of unique values from the provided data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"}}}}}},"responses":{"200":{"description":"Unique values calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/mean":{"post":{"summary":"Calculate mean of a data series","description":"Returns the arithmetic mean of the provided data series, optionally filtered by conditions","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Mean calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/count":{"post":{"summary":"Count data points in a series","description":"Returns the count of data points in the series, optionally filtered by conditions","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Count calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/variance":{"post":{"summary":"Calculate variance of a data series","description":"Returns the variance of the provided data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Variance calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/std":{"post":{"summary":"Calculate standard deviation of a data series","description":"Returns the standard deviation of the provided data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Standard deviation calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/percentile":{"post":{"summary":"Calculate percentile of a data series","description":"Returns the specified percentile of the provided data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"percent":{"type":"number","description":"Percentile to calculate (0-100)","example":95},"ascending":{"type":"boolean","description":"Sort order","default":true},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Percentile calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/median":{"post":{"summary":"Calculate median of a data series","description":"Returns the median (50th percentile) of the provided data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Median calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/mode":{"post":{"summary":"Calculate mode of a data series","description":"Returns the mode (most frequent values) of the provided data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Mode calculated successfully"},"400":{"description":"Invalid input data"}}}},"/api/max":{"post":{"summary":"Find maximum value in a data series","description":"Returns the maximum value from the provided data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Maximum value found successfully"},"400":{"description":"Invalid input data"}}}},"/api/min":{"post":{"summary":"Find minimum value in a data series","description":"Returns the minimum value from the provided data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"conditions":{"type":"array","items":{"$ref":"#/components/schemas/Condition"}}}}}}},"responses":{"200":{"description":"Minimum value found successfully"},"400":{"description":"Invalid input data"}}}},"/api/correlation":{"post":{"summary":"Calculate correlation between two data series","description":"Returns the Pearson correlation coefficient between two data series","tags":["Statistics"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series1":{"$ref":"#/components/schemas/DataSeries"},"series2":{"$ref":"#/components/schemas/DataSeries"}}}}}},"responses":{"200":{"description":"Correlation calculated successfully"},"400":{"description":"Invalid input data or series have different lengths"}}}},"/api/series/moving-average":{"post":{"summary":"Calculate moving average of a data series","description":"Returns the moving average of the provided data series with specified window size","tags":["Series Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"windowSize":{"type":"integer","description":"Size of the moving window","minimum":1,"example":5}}}}}},"responses":{"200":{"description":"Moving average calculated successfully"},"400":{"description":"Invalid input data or window size"}}}},"/api/series/rolling":{"post":{"summary":"Get rolling windows of a data series","description":"Returns rolling windows of the provided data series with specified window size","tags":["Series Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"windowSize":{"type":"integer","description":"Size of the rolling window","minimum":1,"example":3}}}}}},"responses":{"200":{"description":"Rolling windows calculated successfully"},"400":{"description":"Invalid input data or window size"}}}},"/api/ml/kmeans":{"post":{"summary":"Perform K-means clustering","description":"Performs K-means clustering on the provided data matrix","tags":["Machine Learning"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"matrix":{"$ref":"#/components/schemas/DataMatrix"},"nClusters":{"type":"integer","description":"Number of clusters","minimum":1,"example":3},"options":{"type":"object","description":"K-means options"}}}}}},"responses":{"200":{"description":"K-means clustering completed successfully"},"400":{"description":"Invalid input data"}}}},"/api/time/week-number":{"post":{"summary":"Get week number from date","description":"Returns the ISO week number for the provided date string","tags":["Time"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"Date string in ISO format","example":"2024-03-15"}}}}}},"responses":{"200":{"description":"Week number calculated successfully"},"400":{"description":"Invalid date format"}}}},"/api/time/same-day-last-year":{"post":{"summary":"Get same day of week from last year","description":"Returns the date string for the same day of the week from the previous year","tags":["Time"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"date":{"type":"string","format":"date","description":"Date string in ISO format","example":"2024-03-15"}}}}}},"responses":{"200":{"description":"Same day last year calculated successfully"},"400":{"description":"Invalid date format"}}}},"/api/retail/purchase-rate":{"post":{"summary":"Calculate purchase rate","description":"Calculates the purchase rate as a percentage of product purchases over total transactions","tags":["Retail"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"productPurchases":{"type":"number","description":"Number of product purchases","example":150},"totalTransactions":{"type":"number","description":"Total number of transactions","example":1000}}}}}},"responses":{"200":{"description":"Purchase rate calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/lift-value":{"post":{"summary":"Calculate lift value","description":"Calculates the lift value for market basket analysis","tags":["Retail"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"jointPurchaseRate":{"type":"number","description":"Joint purchase rate of both products","example":0.05},"productAPurchaseRate":{"type":"number","description":"Purchase rate of product A","example":0.2},"productBPurchaseRate":{"type":"number","description":"Purchase rate of product B","example":0.3}}}}}},"responses":{"200":{"description":"Lift value calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/cost-ratio":{"post":{"summary":"Calculate cost ratio","description":"Calculates the cost ratio (cost divided by sale price)","tags":["Retail"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cost":{"type":"number","description":"Cost of the product","example":50},"salePrice":{"type":"number","description":"Sale price of the product","example":100}}}}}},"responses":{"200":{"description":"Cost ratio calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/gross-margin":{"post":{"summary":"Calculate gross margin rate","description":"Calculates the gross margin rate as a percentage","tags":["Retail"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"salePrice":{"type":"number","description":"Sale price of the product","example":100},"cost":{"type":"number","description":"Cost of the product","example":60}}}}}},"responses":{"200":{"description":"Gross margin rate calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/average-spend":{"post":{"summary":"Calculate average spend per customer","description":"Calculates the average amount spent per customer","tags":["Retail"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"totalRevenue":{"type":"number","description":"Total revenue","example":50000},"numberOfCustomers":{"type":"number","description":"Number of customers","example":500}}}}}},"responses":{"200":{"description":"Average spend calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/retail/purchase-index":{"post":{"summary":"Calculate purchase index","description":"Calculates the purchase index (items per 1000 customers)","tags":["Retail"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"totalItemsSold":{"type":"number","description":"Total number of items sold","example":2500},"numberOfCustomers":{"type":"number","description":"Number of customers","example":1000}}}}}},"responses":{"200":{"description":"Purchase index calculated successfully"},"400":{"description":"Invalid input data or division by zero"}}}},"/api/predict/forecast":{"post":{"summary":"Generate time series forecast","description":"Generates a forecast for time series data using linear regression","tags":["Prediction"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"forecastPeriods":{"type":"integer","description":"Number of periods to forecast","minimum":1,"example":10}}}}}},"responses":{"200":{"description":"Forecast generated successfully"},"400":{"description":"Invalid input data"}}}},"/api/series/smooth":{"post":{"summary":"Smooth a 1D data series","description":"Applies a smoothing filter (Gaussian or Moving Average) to a 1D data series to reduce noise.","tags":["Series Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"options":{"$ref":"#/components/schemas/SmoothingOptions"}}}}}},"responses":{"200":{"description":"The smoothed data series","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"}}}},"400":{"description":"Invalid input data"}}}},"/api/series/detect-peaks":{"post":{"summary":"Detect peaks in a 1D data series","description":"Identifies local maxima (peaks) in a 1D data series. More robust and accurate logic.","tags":["Series Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"options":{"type":"object","properties":{"smoothWindow":{"type":"integer","description":"Optional window size for Gaussian smoothing to reduce noise before peak detection.","example":3},"minDistance":{"type":"integer","description":"The minimum number of data points between two peaks.","example":1},"threshold":{"type":"number","description":"The minimum value for a data point to be considered a peak.","example":0.5}}}}}}}},"responses":{"200":{"description":"An array of detected peak objects, each with an index and value."},"400":{"description":"Invalid input data"}}}},"/api/series/detect-valleys":{"post":{"summary":"Detect valleys in a 1D data series","description":"Identifies local minima (valleys) in a 1D data series. More robust and accurate logic.","tags":["Series Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"options":{"type":"object","properties":{"smoothWindow":{"type":"integer","description":"Optional window size for Gaussian smoothing to reduce noise before valley detection.","example":3},"minDistance":{"type":"integer","description":"The minimum number of data points between two valleys.","example":1},"threshold":{"type":"number","description":"The maximum value for a data point to be considered a valley.","example":-0.5}}}}}}}},"responses":{"200":{"description":"An array of detected valley objects, each with an index and value."},"400":{"description":"Invalid input data"}}}},"/api/series/detect-outliers":{"post":{"summary":"Detect outliers in a 1D data series","description":"Identifies outliers in a 1D data series using statistically sound methods.","tags":["Series Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"options":{"type":"object","properties":{"method":{"type":"string","enum":["local_deviation","mean_diff"],"default":"local_deviation"},"windowSize":{"type":"integer","default":7},"threshold":{"type":"number","description":"The sensitivity threshold. For 'local_deviation', this is the number of standard deviations (Z-score).","default":3}}}}}}}},"responses":{"200":{"description":"An array of detected outlier objects.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"}}}},"400":{"description":"Invalid input data"}}}},"/api/series/detect-vertices":{"post":{"summary":"Detect trend vertices (turning points) in a 1D series","description":"Identifies all significant peaks and valleys in a data series trend using a robust local maxima/minima search.","tags":["Series Operations"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"series":{"$ref":"#/components/schemas/DataSeries"},"options":{"type":"object","properties":{"smoothingWindow":{"type":"integer","default":5,"description":"Window size for an initial Gaussian smoothing pass to reduce noise."},"threshold":{"type":"number","description":"The absolute value a peak/valley must exceed to be counted.","default":0},"minDistance":{"type":"integer","default":3,"description":"Minimum number of data points between any two vertices."}}}}}}}},"responses":{"200":{"description":"An array of detected vertex objects, labeled as 'peak' or 'valley'.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"}}}},"400":{"description":"Invalid input data"}}}},"/api/kernels/{name}":{"get":{"summary":"Get a pre-defined convolution kernel","description":"Retrieves a standard 1D or 2D convolution kernel by its name.","tags":["Kernels"],"parameters":[{"in":"path","name":"name","required":true,"schema":{"type":"string","enum":["sobel-x","sobel-y","laplacian","difference1d","average1d"]},"description":"The name of the kernel to retrieve."},{"in":"query","name":"size","schema":{"type":"integer","default":3},"description":"The size of the kernel (for kernels like 'average1d')."}],"responses":{"200":{"description":"The requested kernel as a 1D or 2D array.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiResponse"}}}},"400":{"description":"Unknown kernel name or invalid options."}}}},"/api/docs/export/json":{"get":{"summary":"Export API documentation as JSON","description":"Returns the complete OpenAPI specification in JSON format","tags":["Documentation"],"responses":{"200":{"description":"OpenAPI specification in JSON format","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/docs/export/yaml":{"get":{"summary":"Export API documentation as YAML","description":"Returns the complete OpenAPI specification in YAML format","tags":["Documentation"],"responses":{"200":{"description":"OpenAPI specification in YAML format","content":{"text/yaml":{"schema":{"type":"string"}}}}}}},"/api/docs/export/html":{"get":{"summary":"Export API documentation as HTML","description":"Returns a standalone HTML file with the complete API documentation","tags":["Documentation"],"responses":{"200":{"description":"Standalone HTML documentation","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"DataSeries":{"type":"object","required":["values"],"properties":{"values":{"type":"array","items":{"type":"number"},"description":"Array of numerical values","example":[1,2,3,4,5]},"labels":{"type":"array","items":{"type":"string"},"description":"Optional labels for the values","example":["Jan","Feb","Mar","Apr","May"]}}},"DataMatrix":{"type":"object","required":["data"],"properties":{"data":{"type":"array","items":{"type":"array","items":{"type":"number"}},"description":"2D array of numerical values","example":[[1,2],[3,4],[5,6]]},"columns":{"type":"array","items":{"type":"string"},"description":"Optional column names","example":["x","y"]},"rows":{"type":"array","items":{"type":"string"},"description":"Optional row names","example":["row1","row2","row3"]}}},"Condition":{"type":"object","required":["field","operator","value"],"properties":{"field":{"type":"string","description":"Field name to apply condition on","example":"value"},"operator":{"type":"string","enum":[">","<","=",">=","<=","!="],"description":"Comparison operator","example":">"},"value":{"oneOf":[{"type":"number"},{"type":"string"}],"description":"Value to compare against","example":10}}},"SmoothingOptions":{"type":"object","properties":{"method":{"type":"string","enum":["gaussian","moving_average"],"default":"gaussian","description":"The smoothing method to use."},"windowSize":{"type":"integer","default":5,"description":"The size of the window for the filter. Must be an odd number for Gaussian."},"sigma":{"type":"number","default":1,"description":"The standard deviation for the Gaussian filter."}}},"EdgeDetectionOptions":{"type":"object","properties":{"method":{"type":"string","enum":["sobel","laplacian"],"default":"sobel","description":"The edge detection algorithm to use."},"threshold":{"type":"number","default":0.1,"description":"The sensitivity threshold for detecting an edge. Values below this will be set to 0."}}},"ApiResponse":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was successful"},"data":{"description":"Response data (varies by endpoint)"},"error":{"type":"string","description":"Error message if success is false"}}}}},"tags":[]},
                 dom_id: '#swagger-ui',
                 deepLinking: true,
                 presets: [
diff --git a/server.ts b/server.ts
index b10045c..4991752 100644
--- a/server.ts
+++ b/server.ts
@@ -1244,11 +1244,11 @@ app.post('/api/predict/forecast', (req, res) => {
 
 /**
  * @swagger
- * /api/signal/smooth:
+ * /api/series/smooth:
  *   post:
  *     summary: Smooth a 1D data series
  *     description: Applies a smoothing filter (Gaussian or Moving Average) to a 1D data series to reduce noise.
- *     tags: [Signal Processing]
+ *     tags: [Series Operations]
  *     requestBody:
  *       required: true
  *       content:
@@ -1270,7 +1270,7 @@ app.post('/api/predict/forecast', (req, res) => {
  *       '400':
  *         description: Invalid input data
  */
-app.post('/api/signal/smooth', (req, res) => {
+app.post('/api/series/smooth', (req, res) => {
     try {
         const { series, options } = req.body;
         validateSeries(series);
@@ -1284,11 +1284,11 @@ app.post('/api/signal/smooth', (req, res) => {
 
 /**
  * @swagger
- * /api/signal/detect-peaks:
+ * /api/series/detect-peaks:
  *   post:
  *     summary: Detect peaks in a 1D data series
  *     description: Identifies local maxima (peaks) in a 1D data series. More robust and accurate logic.
- *     tags: [Signal Processing]
+ *     tags: [Series Operations]
  *     requestBody:
  *       required: true
  *       content:
@@ -1319,7 +1319,7 @@ app.post('/api/signal/smooth', (req, res) => {
  *       '400':
  *         description: Invalid input data
  */
-app.post('/api/signal/detect-peaks', (req, res) => {
+app.post('/api/series/detect-peaks', (req, res) => {
     try {
         const { series, options } = req.body;
         validateSeries(series);
@@ -1333,11 +1333,11 @@ app.post('/api/signal/detect-peaks', (req, res) => {
 
 /**
  * @swagger
- * /api/signal/detect-valleys:
+ * /api/series/detect-valleys:
  *   post:
  *     summary: Detect valleys in a 1D data series
  *     description: Identifies local minima (valleys) in a 1D data series. More robust and accurate logic.
- *     tags: [Signal Processing]
+ *     tags: [Series Operations]
  *     requestBody:
  *       required: true
  *       content:
@@ -1368,7 +1368,7 @@ app.post('/api/signal/detect-peaks', (req, res) => {
  *       '400':
  *         description: Invalid input data
  */
-app.post('/api/signal/detect-valleys', (req, res) => {
+app.post('/api/series/detect-valleys', (req, res) => {
     try {
         const { series, options } = req.body;
         validateSeries(series);
@@ -1382,11 +1382,11 @@ app.post('/api/signal/detect-valleys', (req, res) => {
 
 /**
  * @swagger
- * /api/signal/detect-outliers:
+ * /api/series/detect-outliers:
  *   post:
  *     summary: Detect outliers in a 1D data series
  *     description: Identifies outliers in a 1D data series using statistically sound methods.
- *     tags: [Signal Processing]
+ *     tags: [Series Operations]
  *     requestBody:
  *       required: true
  *       content:
@@ -1420,7 +1420,7 @@ app.post('/api/signal/detect-valleys', (req, res) => {
  *       '400':
  *         description: Invalid input data
  */
-app.post('/api/signal/detect-outliers', (req, res) => {
+app.post('/api/series/detect-outliers', (req, res) => {
     try {
         const { series, options } = req.body;
         validateSeries(series);
@@ -1434,11 +1434,11 @@ app.post('/api/signal/detect-outliers', (req, res) => {
 
 /**
  * @swagger
- * /api/signal/detect-vertices:
+ * /api/series/detect-vertices:
  *   post:
  *     summary: Detect trend vertices (turning points) in a 1D series
  *     description: Identifies all significant peaks and valleys in a data series trend using a robust local maxima/minima search.
- *     tags: [Signal Processing]
+ *     tags: [Series Operations]
  *     requestBody:
  *       required: true
  *       content:
@@ -1473,7 +1473,7 @@ app.post('/api/signal/detect-outliers', (req, res) => {
  *       '400':
  *         description: Invalid input data
  */
-app.post('/api/signal/detect-vertices', (req, res) => {
+app.post('/api/series/detect-vertices', (req, res) => {
     try {
         const { series, options } = req.body;
         validateSeries(series);