Định Dạng Chiến Lược AI

interface Pipeline {
  id: string;           // Mã định danh duy nhất UUID
  userId: string;       // Mã định danh người dùng UUID
  name: string;         // Tên gọi của chiến lược
  description: string;  // Mô tả chi tiết chiến lược
  nodes: Node[];        // Mảng chứa danh sách các khối chức năng trên canvas
  connections: Connection[]; // Mảng chứa các liên kết cổng kết nối giữa các khối
  parameters: Record<string, unknown>; // Các tham số cấu hình toàn cục
  version: string;      // Phiên bản cấu trúc schema
  status: "draft";      // Luôn đặt là "draft" (bản nháp) khi nhập vào hệ thống
  createdAt: string;    // Dấu thời gian tạo (chuẩn ISO 8601)
  updatedAt: string;    // Dấu thời gian cập nhật (chuẩn ISO 8601)
}

interface Node {
  id: string;            // ID duy nhất của khối (UUID)
  type: string;          // Loại khối từ danh mục (ví dụ: "rsi", "sma_crossover")
  position: { x: number; y: number }; // Vị trí hiển thị của khối trên canvas
  parameters: Record<string, unknown>; // Các tham số cấu hình riêng biệt của khối
  inputs: Port[];        // Danh sách các cổng dữ liệu đầu vào
  outputs: Port[];       // Danh sách các cổng dữ liệu đầu ra
}

interface Port {
  id: string;
  name: string;
  dataType: string;      // Kiểu dữ liệu: OHLCV, TIMESERIES, SIGNAL, ORDER, v.v.
  required: boolean;     // Cổng bắt buộc phải kết nối hay không
}

interface Connection {
  id: string;            // ID duy nhất của liên kết (UUID)
  source: { nodeId: string; portId: string }; // Cổng nguồn (đầu ra)
  target: { nodeId: string; portId: string }; // Cổng đích (đầu vào)
}

{
  "id": "example-rsi-crossover",
  "userId": "your-user-id",
  "name": "RSI Crossover Strategy",
  "description": "Buy when RSI crosses above 30, sell when RSI crosses below 70",
  "nodes": [
    {
      "id": "node-1",
      "type": "ohlcv_data",
      "position": { "x": 100, "y": 200 },
      "parameters": { "exchange": "binance", "symbol": "BTC/USDT", "timeframe": "1h" },
      "inputs": [],
      "outputs": [
        { "id": "ohlcv", "name": "OHLCV", "dataType": "OHLCV" }
      ]
    },
    {
      "id": "node-2",
      "type": "rsi",
      "position": { "x": 400, "y": 200 },
      "parameters": { "period": 14 },
      "inputs": [
        { "id": "ohlcv", "name": "OHLCV", "dataType": "OHLCV", "required": true }
      ],
      "outputs": [
        { "id": "rsi", "name": "RSI", "dataType": "NUMBER" }
      ]
    },
    {
      "id": "node-3",
      "type": "threshold_signal",
      "position": { "x": 700, "y": 100 },
      "parameters": { "upperThreshold": 70, "lowerThreshold": 30 },
      "inputs": [
        { "id": "input", "name": "Input", "dataType": "NUMBER", "required": true }
      ],
      "outputs": [
        { "id": "signal", "name": "Signal", "dataType": "SIGNAL" }
      ]
    },
    {
      "id": "node-4",
      "type": "signal_to_order",
      "position": { "x": 1000, "y": 100 },
      "parameters": { "orderType": "market", "quantity": 0.01 },
      "inputs": [
        { "id": "signal", "name": "Signal", "dataType": "SIGNAL", "required": true }
      ],
      "outputs": [
        { "id": "order", "name": "Order", "dataType": "ORDER" }
      ]
    }
  ],
  "connections": [
    {
      "id": "conn-1",
      "source": { "nodeId": "node-1", "portId": "ohlcv" },
      "target": { "nodeId": "node-2", "portId": "ohlcv" }
    },
    {
      "id": "conn-2",
      "source": { "nodeId": "node-2", "portId": "rsi" },
      "target": { "nodeId": "node-3", "portId": "input" }
    },
    {
      "id": "conn-3",
      "source": { "nodeId": "node-3", "portId": "signal" },
      "target": { "nodeId": "node-4", "portId": "signal" }
    }
  ],
  "parameters": {},
  "version": 1,
  "status": "draft",
  "createdAt": "2026-01-01T00:00:00.000Z",
  "updatedAt": "2026-01-01T00:00:00.000Z"
}