DwellTimeValidator

1. Область применения

Утилита Dwell Time Validator применяется для объекта Dwell Time Validator. Источником истины для структуры входных данных является фактический input.csv; критерии контроля задаются исполняемым модулем и предметным описанием.

Утилита не использует машинное обучение; решение формируется детерминированными правилами.

Категории: Radiation physics

Теги: activity, brachytherapy, dosimetry, source calibration, TG-43

2. Режимы запуска

DwellTimeValidator.exe                            → демо-режим
DwellTimeValidator.exe input.csv output.json      → валидация данных (первая запись)

3. Ключевые контролируемые области

• радиоактивность, распад и радиохимическая чистота

5. URS — пользовательские требования

6. Контракт входных данных input.csv

Источник истины для схемы входа — фактический заголовок input.csv. Имена колонок технические и не переводятся.

Пример CSV

PatientID,ChannelID,TotalPositions,TotalDwellTimeSec,MaxSingleDwellSec,MaxDwellPositionIndex,PlannedTotalTimeSec,MaxAllowedSingleSec
PT-2026-CERVIX-05,CH-03,12,185.5,42.0,7,184.0,30.0

7. FS — функциональная спецификация

8. Выходной контракт output.json

Выходной файл должен быть пригоден для автоматической обработки, аудита и сопоставления с исходной строкой input.csv.

{
  "utility": "DwellTimeValidator",
  "api": "Dwell Time Validator",
  "batchNumber": "",
  "overallStatus": "PASS|WARNING|FAIL",
  "checkedAtUtc": "2026-05-18T00:00:00Z",
  "checks": [
    {
      "parameter": "PatientID",
      "value": "PT-2026-CERVIX-05",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "ChannelID",
      "value": "CH-03",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "TotalPositions",
      "value": "12",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "TotalDwellTimeSec",
      "value": "185.5",
      "unit": "min",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "MaxSingleDwellSec",
      "value": "42.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "MaxDwellPositionIndex",
      "value": "7",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "PlannedTotalTimeSec",
      "value": "184.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "MaxAllowedSingleSec",
      "value": "30.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    }
  ],
  "criticalFindings": [],
  "sourceFile": "input.csv"
}

9. Тестовые сценарии OQ/PQ

10. QA/QC, CSV и управление изменениями

• Перед применением на производстве клиент фиксирует версию исполняемого файла, контрольную сумму, версию спецификации/монографии, тестовый CSV, ожидаемый JSON и результаты IQ/OQ.
• Нельзя менять имена колонок без обновления валидатора и тестовых сценариев.
• Исходный CSV, output.json и версия утилиты должны храниться вместе как пакет доказательств.
• Любое изменение правил контроля должно проходить change control и повторную проверку OQ-сценариев.