Scandium47QualityChecker

Scandium-47

radiopharmaceuticals QC URS & FS input.csv output.json dosimetry radiochemical purity radionuclidic purity
Открыть подборку

Описание утилиты: Scandium-47

Scandium-47 Quality Checker — Тераностический РФП (Ph. Eur., USP)

ℹ️  Утилита проверяет РХЧ, свободный скандий, долгоживущие примеси (Sc-46), стерильность.
ℹ️  Не использует машинное обучение — только правила.
⚠️  КРИТИЧНО! Свободный Sc ≤5%. Примеси Sc-46 ≤0.1%. Стерильность обязательна!

Использование:
  Scandium47QualityChecker.exe                            → демо-режим
  Scandium47QualityChecker.exe input.csv output.json      → оценка данных

Формат input.csv:
BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Free_Scandium_Ion_Percent,Long_Lived_Impurities_Percent,Target_Metal_Residue_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected

Пример:
SC47-DOTA-2026-001,Sc-47-DOTATATE,99.9,98.5,50.0,1.0,0.05,2.0,6.5,5.0,0,5.0,0,0,0,0,0

— ЗАЧЕМ ЭТО НУЖНО?
Скандий-47 — тераностический бета/гамма-излучатель (T1/2 = 3.35 д):
• Радиохимическая чистота: Свободный ион Sc³⁺ имеет высокое сродство к белкам плазмы и накапливается в печени. РХЧ должна быть ≥95%.
• Долгоживущие примеси: При производстве Sc-47 может образовываться Sc-46 (T1/2 = 83 дня). Его содержание должно быть минимальным (<0.1%), чтобы не создавать лишнюю лучевую нагрузку на пациента после выведения основного препарата.
• Удельная активность: Важна для эффективного связывания с рецепторами (пептидами).
• Стерильность и эндотоксины: Препарат вводится внутривенно. Требования строгие.
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Радионуклидная чистота: ≥ 99.0%
• Радиохимическая чистота: ≥ 95.0%
• Свободный скандий: ≤ 5.0%
• Долгоживущие примеси (Sc-46): ≤ 0.1%
• Удельная активность: ≥ 10 МБк/нмоль
• pH: 4.5–7.5
• Эндотоксины: ≤ 17.5 EU/mL
• Стерильность: Отсутствие роста
• Внешний вид: Прозрачный, без частиц
⚠️ Особенность: Утилита фокусируется на контроле специфических примесей производства Sc-47 (особенно Sc-46) и свободных ионов металла, которые влияют на биораспределение и дозиметрию.

input.csv

BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Free_Scandium_Ion_Percent,Long_Lived_Impurities_Percent,Target_Metal_Residue_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
SC47-DOTA-2026-001,Sc-47-DOTATATE,99.9,98.5,50.0,1.0,0.05,2.0,6.5,5.0,0,5.0,0,0,0,0,0

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

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

Документ описывает требования и функциональное поведение утилиты Scandium47QualityChecker для контроля: Scandium-47. Утилита предназначена для ОКК/QC и использует детерминированные правила, а не машинное обучение.

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

  • Scandium47QualityChecker.exe — демонстрационный режим или справка.
  • Scandium47QualityChecker.exe input.csv output.json — обработка пользовательских данных и запись результата.

3. Ключевые предметные ограничения

  • Scandium-47 Quality Checker — Тераностический РФП (Ph. Eur., USP)
  • ℹ️ Утилита проверяет РХЧ, свободный скандий, долгоживущие примеси (Sc-46), стерильность.
  • ⚠️ КРИТИЧНО! Свободный Sc ≤5%. Примеси Sc-46 ≤0.1%. Стерильность обязательна!
  • BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Free_Scandium_Ion_Percent,Long_Lived_Impurities_Percent,Target_Metal_Residue_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
  • • Радиохимическая чистота: Свободный ион Sc³⁺ имеет высокое сродство к белкам плазмы и накапливается в печени. РХЧ должна быть ≥95%.
  • • Долгоживущие примеси: При производстве Sc-47 может образовываться Sc-46 (T1/2 = 83 дня). Его содержание должно быть минимальным (<0.1%), чтобы не создавать лишнюю лучевую нагрузку на пациента после выведения основного препарата.
  • • Стерильность и эндотоксины: Препарат вводится внутривенно. Требования строгие.
  • ⚠️ КРИТИЧЕСКИ ВАЖНО:
  • • Радионуклидная чистота: ≥ 99.0%
  • • Радиохимическая чистота: ≥ 95.0%
  • • Свободный скандий: ≤ 5.0%
  • • Долгоживущие примеси (Sc-46): ≤ 0.1%
  • • Удельная активность: ≥ 10 МБк/нмоль
  • • pH: 4.5–7.5
  • • Эндотоксины: ≤ 17.5 EU/mL
  • ⚠️ Особенность: Утилита фокусируется на контроле специфических примесей производства Sc-47 (особенно Sc-46) и свободных ионов металла, которые влияют на биораспределение и дозиметрию.

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

IDТребованиеКритичностьКритерий приемки
URS-001Утилита должна принимать input.csv с точными заголовками, указанными в контракте данных.HighФайл обрабатывается без ручного изменения заголовков.
URS-002Утилита должна проверять обязательность, типы данных, диапазоны, единицы и критические фармацевтические/радиохимические пределы.HighДля каждой строки формируется статус PASS/WARNING/FAIL.
URS-003Утилита должна выявлять критические отклонения, связанные с радионуклидной/радиохимической чистотой, примесями, свободным радионуклидом, pH, эндотоксинами и стерильностью, если такие поля присутствуют.HighКритическое отклонение приводит к FAIL или явному critical finding.
URS-004Утилита должна формировать output.json с машинно-читаемыми результатами, исходными значениями, предупреждениями и отказами.HighJSON пригоден для LIMS/ELN/MES-интеграции и QA/QC review.
URS-005Утилита не должна использовать машинное обучение для решения о соответствии.MediumРешение основано на заданных правилах и порогах.
URS-006Утилита должна сохранять трассируемость между номером серии, входными значениями, примененными правилами и итоговым статусом.HighВыход содержит идентификатор серии и перечень проверенных параметров.
URS-007Документация должна поддерживать подготовку IQ/OQ и инспекционное обсуждение FDA/EMA/Росздравнадзора или локального регулятора.MediumURS/FS и тестовые сценарии доступны вместе с утилитой.

5. Контракт input.csv

#ПолеТипПримерНазначение
1BatchNumberstringSC47-DOTA-2026-001Идентификатор серии/партии.
2RadiopharmaceuticalstringSc-47-DOTATATEТип продукта/радиофармпрепарата; влияет на интерпретацию контроля.
3Radionuclidic_Purity_Percentdecimal99.9Радионуклидная чистота; критический показатель радиационной безопасности.
4Radiochemical_Purity_Percentdecimal98.5Радиохимическая чистота; показатель связывания радионуклида и целевой химической формы.
5Specific_Activity_MBq_nmoldecimal50.0Активность радиофармацевтического материала или готового продукта.
6Free_Scandium_Ion_Percentdecimal1.0Свободный радионуклид/ион; критичен из-за неселективного накопления и токсичности.
7Long_Lived_Impurities_Percentdecimal0.05Контролируемый входной параметр из input.csv.
8Target_Metal_Residue_ppmdecimal2.0Контролируемый входной параметр из input.csv.
9pH_Valuedecimal6.5pH раствора; параметр стабильности и совместимости с введением.
10Ethanol_Content_Percentdecimal5.0Контролируемый входной параметр из input.csv.
11SterilityTestflag 0/10Результат проверки стерильности; 0 обычно означает отсутствие контаминации.
12Bacterial_Endotoxins_EU_per_mLdecimal5.0Бактериальные эндотоксины; критический критерий для парентерального применения.
13Appearance_Scoredecimal0Визуальная оценка внешнего вида и отсутствия видимых дефектов.
14Microbial_Count_TAMCdecimal0Микробиологический показатель; положительный результат является критическим отклонением.
15Microbial_Count_TYMCdecimal0Микробиологический показатель; положительный результат является критическим отклонением.
16EColi_Detectedflag 0/10Микробиологический показатель; положительный результат является критическим отклонением.
17Salmonella_Detectedflag 0/10Микробиологический показатель; положительный результат является критическим отклонением.
BatchNumber,Radiopharmaceutical,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_nmol,Free_Scandium_Ion_Percent,Long_Lived_Impurities_Percent,Target_Metal_Residue_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
SC47-DOTA-2026-001,Sc-47-DOTATATE,99.9,98.5,50.0,1.0,0.05,2.0,6.5,5.0,0,5.0,0,0,0,0,0

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

IDФункцияРеализация
FS-001CSV importПрочитать input.csv в UTF-8/CSV-совместимом формате, проверить наличие заголовка и ожидаемых колонок.
FS-002Schema validationПроверить обязательные поля и количество колонок; сообщить о неизвестных или отсутствующих ключевых полях.
FS-003Type conversionПреобразовать числовые, флаговые и текстовые значения; некорректный формат фиксировать как ошибку строки.
FS-004Rule engineПрименить предметные правила для Scandium-47, включая критические пределы из описания утилиты.
FS-005Status aggregationСформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии.
FS-006JSON exportЗаписать output.json с детализацией проверок, исходными значениями, предупреждениями и critical findings.
FS-007Audit supportСохранять структуру результата пригодной для review, расследования отклонений и подготовки IQ/OQ.

7. Пример output.json

{
  "utilityId": "scandium47-quality-checker",
  "api": "Scandium-47",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "SC47-DOTA-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radiopharmaceutical",
      "value": "Sc-47-DOTATATE",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radionuclidic_Purity_Percent",
      "value": "99.9",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radiochemical_Purity_Percent",
      "value": "98.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Specific_Activity_MBq_nmol",
      "value": "50.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Free_Scandium_Ion_Percent",
      "value": "1.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Long_Lived_Impurities_Percent",
      "value": "0.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Target_Metal_Residue_ppm",
      "value": "2.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": []
}

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

IDСценарийОжидаемый результат
OQ-001Валидная строка из примераPASS или допустимый WARNING согласно правилам.
OQ-002Отсутствует обязательная колонкаОшибка схемы или FAIL.
OQ-003Нечисловое значение в числовом полеОшибка преобразования типа.
OQ-004Значение критического параметра за пределомFAIL и critical finding.
PQ-001Реальная серия/партия пользователяСогласованный результат review с сохранением input.csv и output.json.

9. QA/QC и change control

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

Входит в пакеты

PetRad2: расширенный радиофармацевтический QC-пакет

Подборка новых утилит для контроля радионуклидов, таргетной альфа-терапии, удельной активности, радиолиза и предварительных дозиметрических расчётов.

Открыть

Радиология

Пакет для радиологии и диагностической визуализации: радиофармпрепараты, PET/SPECT, контрастные вещества, йодсодержащие и гадолиниевые препараты, а также проверки частиц, стерильности и эндотоксинов.

Открыть

RPH: объединённый радиофармацевтический QC-пакет

RPH объединяет PetRad, PetRad2 и PetRad3 в один обзорный пакет для PET/SPECT, терапевтических радионуклидов, генераторов, меченых соединений, расчётов распада, стерильности, эндотоксинов и радиохимической/радионуклидной чистоты.

Открыть