RecoilEffectChecker

URS & FS — спецификация пользователя и функциональная спецификация

Документ описывает контролируемый интерфейс и поведение утилиты RecoilEffectChecker для объекта Recoil Effect.

Предметные ограничения и критические параметры

• • Оценка процента свободного дочернего нуклида
• ⚠️ КРИТИЧНО: Энергия отдачи (~100+ кэВ) ВСЕГДА превышает энергию химической связи (~few eV).
• BatchNumber,ParentIsotope,DaughterIsotope,AlphaEnergyMeV,BondEnergyKcalPerMol,ChelatorStabilityConstant,FreeDaughterPercent,RenalUptakeSUV,TimePostLabelingHours,ProductType
• • Результат: Химическая связь РВЕТСЯ в 100% случаев. Дочерний изотоп (например, Fr-221 из Ac-225 или Bi-213 из Ac-225 цепи) становится свободным ионом.
• • Опасность: Свободные дочерние изотопы (особенно Bi-213, Pb-212, Ra-223) накапливаются в почках, вызывая острую лучевую нефропатию.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Контроль свободного дочернего нуклида (Free Daughter Percent) — главный параметр безопасности.
• • Прогнозирование нефротоксичности на основе уровня свободного дочернего нуклида
• Критические параметры:
• • Свободный дочерний нуклид: ≤5.0% (Целевой показатель для наноконтейнеров)
• • Почечный захват (SUV): ≤10.0 (Безопасный порог)
• • Время после мечения: Мониторинг в динамике (накопление свободных изотопов растет со временем)
• ⚠️ Особенность: Эффект отдачи — это фундаментальное физическое ограничение альфа-терапии малыми молекулами. Переход на наночастицы и липосомы является основным путем решения проблемы токсичности почек.

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

Контракт input.csv

BatchNumber,ParentIsotope,DaughterIsotope,AlphaEnergyMeV,BondEnergyKcalPerMol,ChelatorStabilityConstant,FreeDaughterPercent,RenalUptakeSUV,TimePostLabelingHours,ProductType
AC225-PSMA-2026-001,Ac-225,Fr-221,5.83,80.0,25.0,15.0,25.0,24.0,TargetedAlphaTherapy
AT211-MAB-2026-002,At-211,Po-211,5.87,65.0,0.0,2.0,8.0,4.0,TargetedAlphaTherapy
BI213-DOTATATE-003,Bi-213,Tl-209,5.87,85.0,22.0,8.0,12.0,1.0,TargetedAlphaTherapy

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

Пример output.json

{
  "utilityId": "recoil-effect-checker",
  "api": "Recoil Effect",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "AC225-PSMA-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "ParentIsotope",
      "value": "Ac-225",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "DaughterIsotope",
      "value": "Fr-221",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "AlphaEnergyMeV",
      "value": "5.83",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "BondEnergyKcalPerMol",
      "value": "80.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "ChelatorStabilityConstant",
      "value": "25.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "FreeDaughterPercent",
      "value": "15.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "RenalUptakeSUV",
      "value": "25.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": []
}

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

QA/QC и change control

• Не менять имена колонок без обновления валидатора и тестового набора.
• Хранить input.csv, output.json, версию исполняемого файла и контрольную сумму.
• Перед продуктивным использованием провести IQ/OQ/PQ или эквивалентную CSV/CSA-проверку.
• Критические радиофармацевтические пределы должны быть сверены с утверждённой спецификацией и локальными SOP.