SKU Search

# config.toml
[search]
enable_attrs_indexing = true
extra_filter_mode = "soft"

[search.weights]
extra_match_boost = 0.5

curl -X POST http://localhost:8080/find \
  -H "Content-Type: application/json" \
  -d '{"items": [{"name": "кроссовки", "brand": "Nike"}], "limit": 20}'

# Загружаем группу аналогов
    curl -X POST http://localhost:8080/add \
      -H "Content-Type: application/json" \
      -d '{
        "items": [
          {
            "id": "DETAL-001",
            "name": "Болт М16х60 оцинкованный оригинал",
            "group_id": "GROUP-BOLT-001",
            "is_original": true
          },
          {
            "id": "DETAL-002",
            "name": "Болт М16х60 оцинкованный аналог (Nord)",
            "group_id": "GROUP-BOLT-001",
            "is_original": false
          },
          {
            "id": "DETAL-003",
            "name": "Болт М16х60 оцинкованный аналог (DIN)",
            "group_id": "GROUP-BOLT-001",
            "is_original": false
          }
        ]
      }'

# Тот же запрос через CLI
# Создайте файл items.json:
    [
      {
        "id": "DETAL-001",
        "name": "Болт М16х60 оцинкованный оригинал",
        "group_id": "GROUP-BOLT-001",
        "is_original": true
      },
      {
        "id": "DETAL-002",
        "name": "Болт М16х60 оцинкованный аналог (Nord)",
        "group_id": "GROUP-BOLT-001",
        "is_original": false
      },
      {
        "id": "DETAL-003",
        "name": "Болт М16х60 оцинкованный аналог (DIN)",
        "group_id": "GROUP-BOLT-001",
        "is_original": false
      }
    ]

sku-cli add items.json

{
      "search_time_ms": 10,
      "results": [{
        "query": { "name": "болт м16" },
        "matches": [{
          "original": {
            "name_out": "Болт М16х60 оцинкованный оригинал",
            "id_out": "DETAL-001",
            "group_id": "GROUP-BOLT-001",
            "is_original": true,
            "score": 0.94
          },
          "cross_codes": [
            {
              "name_out": "Болт М16х60 оцинкованный аналог (Nord)",
              "id_out": "DETAL-002",
              "score": 0.89,
              "is_original": false
            },
            {
              "name_out": "Болт М16х60 оцинкованный аналог (DIN)",
              "id_out": "DETAL-003",
              "score": 0.85,
              "is_original": false
            }
          ]
        }]
      }]
    }

[pro.cross_codes]
    enabled = true                      # Включить поддержку кросс-кодов
    max_group_size = 30                 # Максимум аналогов в ответе
    include_in_response = true          # Возвращать кросс-коды в /find
    sort_within_group = true            # Сортировать аналоги по релевантности
    include_original_in_cross_list = false  # Не дублировать оригинал в массиве аналогов

# Загружаем иерархию: Изделие → Деталь1 → Деталь2
    curl -X POST http://localhost:8080/add \
      -H "Content-Type: application/json" \
      -d '{
        "items": [
          {
            "id": "PROD-001",
            "name": "Изделие (корневая сборка)",
            "parent_id": null
          },
          {
            "id": "PART-001",
            "name": "Деталь А",
            "parent_id": "PROD-001"
          },
          {
            "id": "PART-002",
            "name": "Деталь Б",
            "parent_id": "PROD-001"
          },
          {
            "id": "SUB-001",
            "name": "Поддеталь А.1",
            "parent_id": "PART-001"
          }
        ]
      }'

# Тот же запрос через CLI
# Создайте файл items.json:
    [
      {
        "id": "PROD-001",
        "name": "Изделие (корневая сборка)",
        "parent_id": null
      },
      {
        "id": "PART-001",
        "name": "Деталь А",
        "parent_id": "PROD-001"
      },
      {
        "id": "PART-002",
        "name": "Деталь Б",
        "parent_id": "PROD-001"
      },
      {
        "id": "SUB-001",
        "name": "Поддеталь А.1",
        "parent_id": "PART-001"
      }
    ]

sku-cli add items.json

curl -X POST http://localhost:8080/hierarchy \
      -H "Content-Type: application/json" \
      -d '{
        "root_id": "PROD-001",
        "direction": "down",
        "max_depth": 5,
        "include_cross_codes": false,
        "limit": 100
      }'

{
      "root": {
        "name_out": "Изделие (корневая сборка)",
        "id_out": "PROD-001"
      },
      "tree": {
        "item": { "name_out": "Изделие (корневая сборка)", "id_out": "PROD-001" },
        "level": 0,
        "children": [
          {
            "item": { "name_out": "Деталь А", "id_out": "PART-001" },
            "level": 1,
            "children": [
              {
                "item": { "name_out": "Поддеталь А.1", "id_out": "SUB-001" },
                "level": 2,
                "children": []
              }
            ]
          },
          {
            "item": { "name_out": "Деталь Б", "id_out": "PART-002" },
            "level": 1,
            "children": []
          }
        ]
      },
      "stats": {
        "total_nodes": 4,
        "max_depth_reached": 2,
        "cross_codes_found": 0,
        "elapsed_ms": 8
      }
    }

curl -X POST http://localhost:8080/hierarchy \
      -H "Content-Type: application/json" \
      -d '{
        "root_id": "PART-001",
        "direction": "up",
        "max_depth": 5
      }'

{
      "root": {
        "name_out": "Изделие (корневая сборка)",
        "id_out": "PROD-001"
      },
      "tree": {
        "item": { "name_out": "Изделие (корневая сборка)", "id_out": "PROD-001" },
        "level": 0,
        "children": [
          {
            "item": { "name_out": "Деталь А", "id_out": "PART-001" },
            "level": 1,
            "children": []
          }
        ]
      },
      "stats": {
        "total_nodes": 2,
        "max_depth_reached": 1,
        "elapsed_ms": 5
      }
    }

curl -X POST http://localhost:8080/hierarchy \
      -H "Content-Type: application/json" \
      -d '{
        "root_id": "PROD-001",
        "direction": "down",
        "include_cross_codes": true
      }'

{
      "tree": {
        "item": { ... },
        "cross_codes": [],  // у корневого изделия может не быть аналогов
        "children": [
          {
            "item": { "name_out": "Деталь А", "id_out": "PART-001" },
            "cross_codes": [
              { "name_out": "Деталь А аналог (Nord)", "id_out": "PART-001-ALT" }
            ],
            "children": [ ... ]
          }
        ]
      }
    }

[pro.plugins.hierarchy]
    enabled = true                      # Включить плагин иерархии
    default_max_depth = 5               # Максимальная глубина по умолчанию
    default_limit = 1000                # Лимит узлов в ответе
    include_cross_codes_by_default = false  # Включать кросс-коды по умолчанию