...

• Ендпоінт повертає розрахунок на момент запиту (прив’язаний до now).

• Ендпоінт є допоміжним: фінальна валідність auctionPeriod.startDate все одно перевіряється ЦБД при створенні/оновленні процедури згідно тих самих правил конфігу.

• Якщо для sellingMethod не визначено validation.max, то maxDate не повертається.

...

Change request

Необхідно реалізувати підтримку query-параметрів у GET /api/procedures/{sellingMethod}/auctionPeriod

Мета зміни

Розширити ендпоінт GET /api/procedures/{sellingMethod}/auctionPeriod, щоб він міг обчислювати min/max дати з урахуванням параметрів конкретного кейсу, переданих у query-string (наприклад: isPerishable, value.amount), а не лише базової validation.min/max.

Це потрібно для того, щоб майданчик міг коректно показувати допустимий діапазон дат до створення процедури, але вже з урахуванням бізнес-умов.

Поточна поведінка (as-is)

Ендпоінт повертає startDate.minDate (та опційно startDate.maxDate) на основі periods.procedure.auctionPeriod.startDate.validation.

conditions[] наразі не параметризовані і не залежать від введених даних користувача (бо немає механізму передати ці дані у запит)

Нова поведінка (to-be)

Підтримка query параметрів

Ендпоінт має приймати query параметри, які будуть використані при визначенні релевантного condition.case та/або правил validation

Базовий приклад:
GET /api/procedures/basicSell-english/auctionPeriod?isPerishable=true

Розширений приклад:
GET /api/procedures/sanctionedAssets-english/auctionPeriod?value.amount=300000000.00

Backward compatibility

Якщо query параметри не передані, ендпоінт працює як зараз: повертає межі з startDate.validation.min/max (або тільки min, якщо max відсутній)

Якщо sellingMethod не має conditions[] для auctionPeriod.startDate — query параметри не впливають (результат як зараз)

Правила вибору умов (conditions/case)

Загальна логіка

1. Система завантажує конфіг для {sellingMethod}

2. Якщо в startDate є масив conditions[], система має:

   • пройтись по conditions[] у вказаному у відповіді порядку

   • знайти першу умову, у якої case повністю матчиться із параметрами запиту

   • застосувати її правила розрахунку дат

3. Якщо жоден case не матчиться — використовується дефолтна логіка з startDate.validation (як зараз)

Робота з case

case — це набір умов над параметрами, переданими у query

Підтримувані типи перевірок:

1. boolean equality
   isPerishable: true → очікує ?isPerishable=true

2. numeric comparisons для чисел
   Наприклад:

   • value.amount > 250000000

   • value.amount >= 250000000

   • value.amount < 250000000

   • value.amount <= 250000000

Розширення формату конфігу

Boolean case (існує і зараз)

"conditions": [
	{
		"auto_set": true,
		"case": {
			"isPerishable": true
		},
		"diff": "2 business days",
		"direction": "forward",
		"from": "now",
		"time": "11:00 - 13:00"
	}
]

Numeric case для value.amount

"conditions": [
	{
		"case": {
			"value.amount": {
				"gt": 250000000.00  //використовуємо оператори gt/gte/lt/lte
			}
		},
		"validation": {
			"min": {
				"diff": "30 days",
				"direction": "forward",
				"from": "now",
				"time": "11:00"
			},
			"max": {
				"diff": "60 days",
				"direction": "forward",
				"from": "now",
				"time": "13:00"
			}
		}
	}
]

conditions[] мають мати можливість:

• задавати “коротке” правило (diff/from/time) — як у прикладі з isPerishable

АБО

• перевизначати validation.min/max локально для цього кейсу

Тобто дозволити один із варіантів:

• Варіант А: condition має власні поля diff/from/... і повертає тільки minDate (або min+max, якщо є).

• Варіант Б: condition містить вкладений validation і повністю замінює дефолтний startDate.validation для обчислення min/max.

"auctionPeriod": {
  "startDate": {
    "conditions": [
      {
        "case": { "value.amount": { "gt": 250000000 } },
        "validation": {
          "min": { "diff": "30 days", "direction": "forward", "from": "now", "time": "11:00" },
          "max": { "diff": "60 days", "direction": "forward", "from": "now", "time": "13:00" }
        }
      },
      {
        "case": { "value.amount": { "lte": 250000000 } },
        "validation": {
          "min": { "diff": "20 days", "direction": "forward", "from": "now", "time": "11:00" },
          "max": { "diff": "35 days", "direction": "forward", "from": "now", "time": "13:00" }
        }
      }
    ],
    "time": "11:00 - 13:00",
    "validation": {
		"is_business_day": true,
		"min": {
			"diff": "20 days",
			"direction": "forward",
			"error": "raise",
			"from": "now",
			"time": "11:00"
		}
	}
  }
}

Формат query параметрів

Boolean

• isPerishable=true|false (case-insensitive)

• якщо параметр переданий не як boolean → 400

Числовий value.amount

• value.amount — decimal

• якщо не число → 400

Правила пріоритетів

1. Якщо знайдено condition, який матчиться, і він містить власний validation — використати його

2. Якщо condition матчиться і він задає пряме правило diff/from/time — розрахувати min/max на його основі

3. Якщо condition не матчиться — використати дефолтний startDate.validation (поточна поведінка)

Якщо матчиться кілька conditions:

• використати перший у списку (тобто порядок у конфігу = пріоритет)

Відповідь ендпоінта (без змін)

Формат відповіді не змінюється:

{
	"startDate": {
		"minDate": "...",
		"maxDate": "..."
	}
}

Помилки / валідації

Некоректні query параметри

• 400 Bad Request

Приклад причин:

• isPerishable = abc

• value.amount = not_a_number

Невідомий sellingMethod

• як зараз - 422 Unprocessable Content

Непідтримуваний параметр

Lenient: невідомі параметри ігноруються (щоб не ламати майданчики)

Приклади сценаріїв

Perishable

Запит:
GET /api/procedures/basicSell-english/auctionPeriod?isPerishable=true

Очікування:

• якщо в конфігу є condition з case.isPerishable=true, повертається min/max за ним (наприклад +2 business days)

• інакше — дефолтний validation.min/max

Поріг стартової ціни

Запит:
GET /api/procedures/sanctionedAssets-english/auctionPeriod?value.amount=300000000.65

Очікування:

• якщо в конфігу є condition value.amount gt 250000000, тоді:

  • minDate = now + 30 days

  • maxDate = now + 60 days (або як задано)

• якщо amount менший — інший condition або дефолтні правила