Mercury197QualityChecker
Mercury-197
radiopharmaceuticals QC URS & FS input.csv output.json radiochemical purity radionuclidic purity sterility
Открыть подборкуОписание утилиты: Mercury-197
Mercury-197 Quality Checker — Ртуть-197 для визуализации почек ℹ️ Утилита проверяет критические параметры Ртути-197: • Радионуклидная чистота (≥99.0%) • Примесь Ртути-197m (≤1.0%) • Примесь Ртути-203 (≤0.1%) • Радиохимическая чистота (≥95%) • Свободная ртуть (≤2%) • рН, эндотоксины, стерильность, тяжёлые металлы ⚠️ КРИТИЧНО: Свободная ртуть >2% → НЕФРОТОКСИЧНОСТЬ! Примесь Hg-203 >0.1% → долгосрочная токсичность и лучевая нагрузка! Использование: Mercury197QualityChecker.exe → демо-режим (вывод в консоль) Mercury197QualityChecker.exe input.csv output.json → оценка ваших данных Формат input.csv: BatchNumber,TotalActivityMBq,RadionuclidicPurityPercent,Mercury197mImpurityPercent,Mercury203ImpurityPercent,RadiochemicalPurityPercent,FreeMercuryPercent,pH,EndotoxinsEU,SterilityTest,HeavyMetalsPPM,ProductType Пример (стерильность: 0=стерильно, 1=контаминация): Hg197-RENAL-2026-001,37.0,99.5,0.5,0.05,98.0,1.0,6.5,40.0,0,2,Renal_Imaging Поддерживаемые типы продуктов: • Renal_Imaging — визуализация коркового слоя почек (исторический/специализированный метод) • Research — доклинические исследования — ЗАЧЕМ ЭТО НУЖНО? Ртуть-197 — радиоизотоп, исторически используемый для сканирования почек: • Период полураспада: 64.1 часа (2.67 дня) • Излучение: Гамма (77-80 кэВ, рентгеновские лучи ртути) и Оже-электроны • Используется в форме хлормеродрина или неогибрина для накопления в почечных канальцах • В современной практике вытеснен Tc-99m препаратами, но используется в специальных исследованиях ⚠️ КРИТИЧЕСКИ ВАЖНО: • Свободная ртуть ≤2% — Неорганическая ртуть высокотоксична для почек (нефротоксичность). Даже небольшие количества свободной ртути могут вызвать повреждение почечных канальцев. • Примесь Ртути-203 ≤0.1% — Hg-203 (T½=46.6 дня) является бета- и гамма-излучателем с долгим периодом полураспада. Ее присутствие недопустимо из-за высокой лучевой нагрузки на пациента и долговременного загрязнения окружающей среды. • Радиохимическая чистота ≥95% — Гарантирует доставку изотопа именно в почки, а не в другие органы. • Примесь Ртути-197m ≤1.0% — Изомер Hg-197m (T½=23.8 ч) увеличивает дозу облучения без диагностической пользы. Ключевые особенности утилиты: • Строгий контроль свободной ртути (нефротоксичность) • Контроль долгоживущей примеси Hg-203 (радиационная безопасность) • Оценка радиохимической чистоты комплексов ртути • Поддержка исторических и исследовательских применений Критические параметры: • Радионуклидная чистота: ≥99.0% • Примесь Ртути-203: ≤0.1% • Примесь Ртути-197m: ≤1.0% • Радиохимическая чистота: ≥95.0% • Свободная ртуть: ≤2.0% • рН: 4.0–8.0 • Эндотоксины: ≤175 EU/vial • Стерильность: отсутствие роста микроорганизмов • Тяжёлые металлы: ≤10 ppm 💡 Советы по использованию: Радиохимическую чистоту определяют методом ТСХ или электрофореза Свободную ртуть контролируют экстракцией диэтилдитиокарбаматом Из-за токсичности ртути, все отходы должны утилизироваться как опасные химические и радиоактивные отходы Препараты ртути требуют осторожности при введении пациентам с нарушением функции почек ⚠️ Особенность: Ртуть-197 распадается путем электронного захвата, испуская характеристическое рентгеновское излучение ртути (77-80 кэВ), которое идеально подходит для гамма-камер. Однако химическая токсичность ртути требует исключительно высокого контроля качества, особенно отсутствия свободной неорганической формы.
input.csv
BatchNumber,TotalActivityMBq,RadionuclidicPurityPercent,Mercury197mImpurityPercent,Mercury203ImpurityPercent,RadiochemicalPurityPercent,FreeMercuryPercent,pH,EndotoxinsEU,SterilityTest,HeavyMetalsPPM,ProductType Hg197-RENAL-2026-001,37.0,99.5,0.5,0.05,98.0,1.0,6.5,40.0,0,2,Renal_Imaging Hg197-RENAL-2026-002,35.0,98.5,1.5,0.2,94.0,3.0,6.0,180.0,0,8,Renal_Imaging Hg197-RES-2026-001,50.0,99.8,0.2,0.02,99.0,0.5,7.0,20.0,0,1,Research
URS & FS — спецификация пользователя и функциональная спецификация
Документ описывает контролируемый интерфейс и поведение утилиты Mercury197QualityChecker для объекта Mercury-197.
Предметные ограничения и критические параметры
Ниже приведены ключевые фрагменты исходного описания. Перед продуктивным применением пределы должны быть сверены с утверждённой спецификацией, регистрационным досье и локальными SOP.
- ℹ️ Утилита проверяет критические параметры Ртути-197:
- • Радионуклидная чистота (≥99.0%)
- • Примесь Ртути-197m (≤1.0%)
- • Примесь Ртути-203 (≤0.1%)
- • Радиохимическая чистота (≥95%)
- • Свободная ртуть (≤2%)
- ⚠️ КРИТИЧНО: Свободная ртуть >2% → НЕФРОТОКСИЧНОСТЬ!
- Примесь Hg-203 >0.1% → долгосрочная токсичность и лучевая нагрузка!
- BatchNumber,TotalActivityMBq,RadionuclidicPurityPercent,Mercury197mImpurityPercent,Mercury203ImpurityPercent,RadiochemicalPurityPercent,FreeMercuryPercent,pH,EndotoxinsEU,SterilityTest,HeavyMetalsPPM,ProductType
- ⚠️ КРИТИЧЕСКИ ВАЖНО:
- • Свободная ртуть ≤2% — Неорганическая ртуть высокотоксична для почек (нефротоксичность). Даже небольшие количества свободной ртути могут вызвать повреждение почечных канальцев.
- • Примесь Ртути-203 ≤0.1% — Hg-203 (T½=46.6 дня) является бета- и гамма-излучателем с долгим периодом полураспада. Ее присутствие недопустимо из-за высокой лучевой нагрузки на пациента и долговременного загрязнения окружающей среды.
- • Радиохимическая чистота ≥95% — Гарантирует доставку изотопа именно в почки, а не в другие органы.
- • Примесь Ртути-197m ≤1.0% — Изомер Hg-197m (T½=23.8 ч) увеличивает дозу облучения без диагностической пользы.
URS — пользовательские требования
| ID | Требование | Критичность | Критерий приемки |
|---|---|---|---|
| URS-001 | Утилита должна принимать файл input.csv с точными заголовками, указанными в контракте данных. | High | Файл обрабатывается без ручного изменения заголовков. |
| URS-002 | Утилита должна выполнять детерминированную проверку для объекта «Mercury-197» на основе входных значений, утверждённых пределов и предметных правил. | High | Для каждой строки формируется статус PASS / WARNING / FAIL. |
| URS-003 | Утилита должна проверять обязательные поля, типы данных, числовые диапазоны, единицы измерения и фармацевтическую/радиохимическую правдоподобность. | High | Ошибки схемы и преобразования явно отражаются в результате. |
| URS-004 | Утилита должна выявлять критические отклонения по радионуклидной чистоте, радиохимической чистоте, свободному радионуклиду, примесям, pH, эндотоксинам и стерильности, если такие поля присутствуют. | High | Критическое отклонение приводит к FAIL или отдельному critical finding. |
| URS-005 | Утилита должна формировать output.json с машинно-читаемыми результатами, исходными значениями, предупреждениями и отказами. | High | JSON пригоден для LIMS/ELN/MES-интеграции и QA/QC review. |
| URS-006 | Утилита не должна использовать машинное обучение для решения о соответствии. | Medium | Результат основан на явно заданных правилах, порогах и входных значениях. |
| URS-007 | Утилита должна сохранять трассируемость между номером серии, входными значениями, применёнными правилами и итоговым статусом. | High | Выход содержит идентификатор серии и перечень проверенных параметров. |
| URS-008 | Документация должна поддерживать подготовку IQ/OQ и обсуждение на инспекции FDA/EMA/Росздравнадзора или локального регулятора. | Medium | URS & FS, контракт input.csv/output.json и тестовые сценарии доступны вместе с утилитой. |
Контракт input.csv
| # | Поле | Тип | Пример | Назначение |
|---|---|---|---|---|
| 1 | BatchNumber | string | Hg197-RENAL-2026-001 | Идентификатор серии/партии для трассируемости. |
| 2 | TotalActivityMBq | decimal | 37.0 | Активность радиофармацевтического материала, применяемая для выпуска, расчётов распада или дозовой оценки. |
| 3 | RadionuclidicPurityPercent | string | 99.5 | Радионуклидная чистота; критический параметр радиационной безопасности и примесей. |
| 4 | Mercury197mImpurityPercent | string | 0.5 | Контролируемая примесь или остаточный материал. |
| 5 | Mercury203ImpurityPercent | string | 0.05 | Контролируемая примесь или остаточный материал. |
| 6 | RadiochemicalPurityPercent | string | 98.0 | Радиохимическая чистота; подтверждает меченую химическую форму и качество связывания. |
| 7 | FreeMercuryPercent | decimal | 1.0 | Свободный радионуклид / несвязанная форма; важна из-за неселективного накопления и токсичности. |
| 8 | pH | decimal | 6.5 | pH раствора; параметр стабильности, совместимости и введения. |
| 9 | EndotoxinsEU | decimal | 40.0 | Бактериальные эндотоксины; критический показатель для парентерального применения. |
| 10 | SterilityTest | flag / boolean | 0 | Результат стерильности; критический параметр выпуска. |
| 11 | HeavyMetalsPPM | decimal | 2 | Элементная примесь / остаточный металл. |
| 12 | ProductType | string | Renal_Imaging | Контролируемый входной параметр для детерминированных QC-правил. |
BatchNumber,TotalActivityMBq,RadionuclidicPurityPercent,Mercury197mImpurityPercent,Mercury203ImpurityPercent,RadiochemicalPurityPercent,FreeMercuryPercent,pH,EndotoxinsEU,SterilityTest,HeavyMetalsPPM,ProductType Hg197-RENAL-2026-001,37.0,99.5,0.5,0.05,98.0,1.0,6.5,40.0,0,2,Renal_Imaging Hg197-RENAL-2026-002,35.0,98.5,1.5,0.2,94.0,3.0,6.0,180.0,0,8,Renal_Imaging Hg197-RES-2026-001,50.0,99.8,0.2,0.02,99.0,0.5,7.0,20.0,0,1,Research
FS — функциональная спецификация
| ID | Функция | Реализация |
|---|---|---|
| FS-001 | CSV import | Прочитать input.csv в UTF-8/CSV-совместимом формате, проверить наличие заголовка и ожидаемых колонок. |
| FS-002 | Schema validation | Проверить обязательные поля и количество колонок; сообщить о неизвестных или отсутствующих ключевых полях. |
| FS-003 | Type conversion | Преобразовать числовые, флаговые и текстовые значения; некорректный формат фиксировать как ошибку строки. |
| FS-004 | Domain rule engine | Применить предметные правила для «Mercury-197», включая критические пределы из описания утилиты и утверждённой спецификации. |
| FS-005 | Status aggregation | Сформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии. |
| FS-006 | JSON export | Записать output.json с детализацией проверок, исходными значениями, предупреждениями, отказами и critical findings. |
| FS-007 | Audit support | Сохранять структуру результата пригодной для review, расследования отклонений, воспроизведения расчёта и подготовки IQ/OQ. |
| FS-008 | Integration contract | Поддерживать простой производственный сценарий: LIMS/ELN/MES формирует input.csv, утилита возвращает output.json, портал отображает описание и документацию. |
Пример output.json
{
"utilityId": "mercury197-quality-checker",
"api": "Mercury-197",
"overallStatus": "PASS|WARNING|FAIL",
"sourceFile": "input.csv",
"checks": [
{
"parameter": "BatchNumber",
"value": "Hg197-RENAL-2026-001",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "TotalActivityMBq",
"value": "37.0",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "RadionuclidicPurityPercent",
"value": "99.5",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Mercury197mImpurityPercent",
"value": "0.5",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Mercury203ImpurityPercent",
"value": "0.05",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "RadiochemicalPurityPercent",
"value": "98.0",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "FreeMercuryPercent",
"value": "1.0",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "pH",
"value": "6.5",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
}
],
"criticalFindings": []
}
OQ/PQ тестовые сценарии
| ID | Сценарий | Ожидаемый результат |
|---|---|---|
| OQ-001 | Валидная строка из примера | PASS или допустимый WARNING согласно правилам. |
| OQ-002 | Отсутствует обязательная колонка | Ошибка схемы или FAIL. |
| OQ-003 | Нечисловое значение в числовом поле | Ошибка преобразования типа. |
| OQ-004 | Значение критического параметра за пределом | FAIL и critical finding. |
| PQ-001 | Реальная серия/партия пользователя | Согласованный результат review с сохранением input.csv и output.json. |
QA/QC и change control
- Не менять имена колонок без обновления валидатора и тестового набора.
- Хранить
input.csv,output.json, версию исполняемого файла и контрольную сумму. - Перед продуктивным использованием провести IQ/OQ/PQ или эквивалентную CSV/CSA-проверку.
- Критические радиофармацевтические пределы должны быть сверены с утверждённой спецификацией и локальными SOP.
Входит в пакеты
PetRad3: расширенный PET/SPECT и радиофармацевтический QC-пакет
Подборка утилит для контроля PET/SPECT радиофармпрепаратов, генераторных и циклотронных радионуклидов, меченых соединений, радиохимической чистоты, прорыва, стерильности и эндотоксинов.
ОткрытьРадиология
Пакет для радиологии и диагностической визуализации: радиофармпрепараты, PET/SPECT, контрастные вещества, йодсодержащие и гадолиниевые препараты, а также проверки частиц, стерильности и эндотоксинов.
ОткрытьRPH: объединённый радиофармацевтический QC-пакет
RPH объединяет PetRad, PetRad2 и PetRad3 в один обзорный пакет для PET/SPECT, терапевтических радионуклидов, генераторов, меченых соединений, расчётов распада, стерильности, эндотоксинов и радиохимической/радионуклидной чистоты.
Открыть