I131VolatilityExtendedChecker
I131 Volatility Extended
I-131 Volatility Extended Checker — Расширенный контроль летучего йода в капсулах йода-131
ℹ️ Утилита проводит ГЛУБОКИЙ анализ летучего йода с:
• Проверкой текущего значения (≤5.0%)
• Прогнозом стабильности до конца срока годности (60 дней)
• Анализом тренда при наличии предыдущих измерений
• Учётом влияния температуры и влажности хранения
• Оценкой рисков для персонала и конкретными рекомендациями
⚠️ КРИТИЧНО: Летучий йод >5.0% создаёт радиационную опасность для персонала!
Даже 5.1% требует немедленных мер — йод сублимируется при комнатной температуре,
создавая облако радиоактивного пара при вскрытии упаковки!
Использование:
I131VolatilityExtendedChecker.exe → демо-режим (вывод в консоль)
I131VolatilityExtendedChecker.exe input.csv output.json → анализ по вашим данным
Формат input.csv:
BatchNumber,VolatileIodinePercent_Current,MeasurementDateTime,ProductionDateTime,StorageTemperatureC,PreviousVolatileIodinePercent,PreviousMeasurementDateTime,HumidityPercent
Примеры (опциональные параметры могут быть пустыми):
I131-VOL-2026-001,2.5,2026-03-18T10:00:00,2026-03-10T08:00:00,22.0,2.3,2026-03-15T10:00:00,45.0
I131-VOL-2026-002,4.2,2026-03-18T10:00:00,2026-03-01T08:00:00,28.0,3.8,2026-03-10T10:00:00,60.0
I131-VOL-2026-003,5.8,2026-03-18T10:00:00,2026-03-15T08:00:00,32.0,,,70.0
— ЗАЧЕМ ЭТО НУЖНО?
Контроль летучего йода — КРИТИЧЕСКИ ВАЖНЫЙ параметр безопасности для йода-131 капсул:
• Летучий йод (сублимированный I-131) создаёт радиационную опасность при вскрытии упаковки
• Персонал лаборатории рискует получить внутреннее облучение при ингаляции
• Даже незначительное превышение (5.1%) требует карантинирования партии
• Стабильность летучего йода зависит от: температуры хранения, влажности, целостности капсулы, времени хранения
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Фармакопейный предел: ≤5.0% летучего йода (USP <823>, Ph. Eur. 2.14.1)
• Предупредительный порог: >4.0% — требует усиленного мониторинга
• Механизм риска: йод сублимируется из капсулы → накапливается в первичной упаковке →
при вскрытии создаёт облако радиоактивного пара → ингаляция персоналом
• Факторы ускорения: температура >25°C, влажность >60%, повреждение капсулы,
длительное хранение (>30 дней)
Ключевые возможности утилиты:
• Прогноз стабильности до конца срока годности (60 дней) с учётом условий хранения
• Анализ тренда при наличии предыдущих измерений (скорость нарастания летучего йода)
• Коррекция прогноза на основе температуры и влажности хранения
• Категоризация риска: LOW / MEDIUM / HIGH / CRITICAL
• Конкретные рекомендации по действиям и хранению
• Оценка риска для персонала с указанием необходимых мер защиты
Модель прогноза:
• Базовая скорость нарастания: 0.03%/день при идеальных условиях (25°C, <50% влажности)
• Коррекция на температуру: ×1.3 при 25-30°C, ×1.8 при >30°C
• Коррекция на влажность: ×1.2 при >60% влажности
• Прогноз = Текущее значение + (Скорость × Дней до окончания срока годности)
Рекомендации по интерпретации:
• CRITICAL (≥5.0%): Немедленно изъять из обращения! Карантин! Расследование!
• HIGH (4.5-4.9% или прогноз >5.0%): Использовать в течение 7 дней или утилизировать
• MEDIUM (4.0-4.4% или тренд >0.02%/день): Ежедневный мониторинг, проверить условия хранения
• LOW (<4.0% и стабильный тренд): Рутинный мониторинг 1 раз в неделю
💡 Практические советы:
1. Всегда измеряйте летучий йод методом сублимации (не газовой хроматографией!)
2. Храните капсулы при 15-25°C и влажности <50% — это снижает скорость нарастания на 60%
3. При значениях >4.0% проверяйте целостность капсул визуально
4. Для партий старше 30 дней увеличьте частоту контроля до ежедневной
5. Документируйте все измерения для аудитов — это критически важный параметр безопасности
⚠️ Ограничения утилиты:
• Прогноз основан на упрощённой модели — реальные условия могут отличаться
• Не учитывает микроповреждения капсул (требуется визуальный контроль)
• Не заменяет официальный метод анализа по фармакопее
• Для партий с повреждённой упаковкой — немедленное изъятие независимо от показаний
Источники данных:
• USP General Chapter <823> — Radiopharmaceuticals for Positron Emission Tomography
• Ph. Eur. Monograph 2481 — Iodine I 131 Capsules
• IAEA Safety Reports Series No. 63 (2009) — Radiation Protection in Nuclear Medicine
• Journal of Radioanalytical and Nuclear Chemistry — Volatility studies of I-131 capsules (2018)input.csv
BatchNumber,VolatileIodinePercent_Current,MeasurementDateTime,ProductionDateTime,StorageTemperatureC,PreviousVolatileIodinePercent,PreviousMeasurementDateTime,HumidityPercent I131-VOL-2026-001,2.5,2026-03-18T10:00:00,2026-03-10T08:00:00,22.0,2.3,2026-03-15T10:00:00,45.0 I131-VOL-2026-002,4.2,2026-03-18T10:00:00,2026-03-01T08:00:00,28.0,3.8,2026-03-10T10:00:00,60.0 I131-VOL-2026-003,5.8,2026-03-18T10:00:00,2026-03-15T08:00:00,32.0,,,70.0
URS & FS — пользовательские требования и функциональная спецификация
Этот документ описывает требования пользователя и функциональную спецификацию для утилиты контроля качества. Он предназначен для обсуждения внедрения, подготовки IQ/OQ и интеграции в контур ОКК/QC.
1. Область применения
Утилита I131 Volatility Extended Checker применяется для объекта I131 Volatility Extended. Источником истины для структуры входных данных является фактический input.csv; критерии контроля задаются исполняемым модулем и предметным описанием.
Утилита не использует машинное обучение; решение формируется детерминированными правилами.
Категории: Radiopharmaceuticals
Теги: capsules, decay correction, endotoxins, medical gases, PET, radionuclide purity, radiopharma, SPECT, sterility
2. Режимы запуска
I131VolatilityExtendedChecker.exe → демо-режим (вывод в консоль) I131VolatilityExtendedChecker.exe input.csv output.json → анализ по вашим данным
3. Ключевые контролируемые области
- чистота и примеси
- микробиология и патогены
- pH и физико-химические параметры
- радиоактивность, распад и радиохимическая чистота
4. Предметные ограничения и критические параметры
- Проверкой текущего значения (≤5.0%)
- ⚠️ КРИТИЧНО: Летучий йод >5.0% создаёт радиационную опасность для персонала!
- ⚠️ КРИТИЧЕСКИ ВАЖНО:
- Фармакопейный предел: ≤5.0% летучего йода (USP <823>, Ph. Eur. 2.14.1)
- Предупредительный порог: >4.0% — требует усиленного мониторинга
- Механизм риска: йод сублимируется из капсулы → накапливается в первичной упаковке →
- Факторы ускорения: температура >25°C, влажность >60%, повреждение капсулы,
- длительное хранение (>30 дней)
- Прогноз стабильности до конца срока годности (60 дней) с учётом условий хранения
- Анализ тренда при наличии предыдущих измерений (скорость нарастания летучего йода)
- Коррекция прогноза на основе температуры и влажности хранения
- Категоризация риска: LOW / MEDIUM / HIGH / CRITICAL
- Конкретные рекомендации по действиям и хранению
- Оценка риска для персонала с указанием необходимых мер защиты
- Базовая скорость нарастания: 0.03%/день при идеальных условиях (25°C, <50% влажности)
- Коррекция на температуру: ×1.3 при 25-30°C, ×1.8 при >30°C
- Коррекция на влажность: ×1.2 при >60% влажности
- Прогноз = Текущее значение + (Скорость × Дней до окончания срока годности)
- CRITICAL (≥5.0%): Немедленно изъять из обращения! Карантин! Расследование!
- HIGH (4.5-4.9% или прогноз >5.0%): Использовать в течение 7 дней или утилизировать
- MEDIUM (4.0-4.4% или тренд >0.02%/день): Ежедневный мониторинг, проверить условия хранения
- LOW (<4.0% и стабильный тренд): Рутинный мониторинг 1 раз в неделю
- 1. Всегда измеряйте летучий йод методом сублимации (не газовой хроматографией!)
- 2. Храните капсулы при 15-25°C и влажности <50% — это снижает скорость нарастания на 60%
5. URS — пользовательские требования
| ID | Требование | Критичность | Критерий приемки |
|---|---|---|---|
| URS-001 | Система должна принимать файл input.csv для I131 Volatility Extended с точным набором колонок, перечисленным в разделе «Контракт входных данных». | High | Файл с корректным заголовком читается без ручного редактирования; отсутствие обязательной колонки приводит к FAIL/ошибке импорта. |
| URS-002 | Система должна обрабатывать запуск без аргументов в демонстрационном режиме и запуск с аргументами input.csv output.json для пользовательских данных. | Medium | Оба сценария запуска дают предсказуемый результат или понятное сообщение об ошибке. |
| URS-003 | Система должна выполнять rule-based контроль по областям: чистота и примеси, микробиология и патогены, pH и физико-химические параметры, радиоактивность, распад и радиохимическая чистота. | High | Каждый контролируемый параметр получает статус и сообщение; результат не зависит от скрытых Excel-формул или ML. |
| URS-004 | Система должна сохранять трассируемость между серией/партией, исходными значениями, применёнными правилами и итоговым вердиктом. | High | В выходе присутствуют идентификатор серии, исходные значения, статусы параметров и критические находки. |
| URS-005 | Система должна формировать машинно-читаемый output.json для LIMS/ELN/MES, batch record и QA/QC review. | High | JSON содержит общий статус, массив проверок, предупреждения, отказы и ссылку на исходный файл. |
| URS-006 | Система должна поддерживать применение в валидационном пакете клиента: URS/FS, IQ/OQ-подготовка, проверка установки и операционных сценариев. | High | Документ, тестовые сценарии и воспроизводимый CSV/JSON-поток пригодны для аудита и внутреннего согласования. |
| URS-007 | Система должна явно отделять технические ошибки данных от предметных несоответствий спецификации. | Medium | Ошибки схемы/типов не смешиваются с фармакопейными отклонениями и отображаются отдельно. |
6. Контракт входных данных input.csv
Источник истины для схемы входа — фактический заголовок input.csv. Имена колонок технические и не переводятся.
| # | Колонка | Тип | Ед. | Описание | Пример | Правило контроля |
|---|---|---|---|---|---|---|
| 1 | BatchNumber | идентификатор | as specified | Batch Number | I131-VOL-2026-001 | обязательное поле; используется для трассируемости серии/партии |
| 2 | VolatileIodinePercent_Current | десятичное число | % | Volatile Iodine % Current | 2.5 | обязательное числовое значение; сравнение с правилом выполняет утилита |
| 3 | MeasurementDateTime | дата/время | as specified | Measurement Date Time | 2026-03-18T10:00:00 | обязательное значение; формат и допустимость проверяются утилитой |
| 4 | ProductionDateTime | дата/время | as specified | Production Date Time | 2026-03-10T08:00:00 | обязательное значение; формат и допустимость проверяются утилитой |
| 5 | StorageTemperatureC | десятичное число | °C | Storage Temperature C | 22.0 | обязательное числовое значение; сравнение с правилом выполняет утилита |
| 6 | PreviousVolatileIodinePercent | десятичное число | % | Previous Volatile Iodine % | 2.3 | обязательное числовое значение; сравнение с правилом выполняет утилита |
| 7 | PreviousMeasurementDateTime | дата/время | as specified | Previous Measurement Date Time | 2026-03-15T10:00:00 | обязательное значение; формат и допустимость проверяются утилитой |
| 8 | HumidityPercent | десятичное число | % | Humidity % | 45.0 | обязательное числовое значение; сравнение с правилом выполняет утилита |
Пример CSV
BatchNumber,VolatileIodinePercent_Current,MeasurementDateTime,ProductionDateTime,StorageTemperatureC,PreviousVolatileIodinePercent,PreviousMeasurementDateTime,HumidityPercent I131-VOL-2026-001,2.5,2026-03-18T10:00:00,2026-03-10T08:00:00,22.0,2.3,2026-03-15T10:00:00,45.0
7. FS — функциональная спецификация
| ID | Функция | Описание реализации |
|---|---|---|
| FS-001 | CLI entry point | Исполняемый файл I131VolatilityExtendedChecker.exe принимает режим демонстрации и режим обработки input.csv output.json. |
| FS-002 | CSV parser | Модуль импорта читает CSV, проверяет заголовок, порядок/наличие колонок, количество значений и кодировку. Для десятичных значений ожидается точка. |
| FS-003 | Field conversion | Для каждой колонки выполняется преобразование к ожидаемому типу: идентификатор, текст, десятичное число, дата/время или логический флаг. |
| FS-004 | Domain rule engine | Для объекта I131 Volatility Extended применяются явные правила: диапазон, минимум, максимум, отсутствие запрещённого признака, полнота данных или расчётная проверка. |
| FS-005 | Criticality handling | Критичные нарушения формируют FAIL; некритичные отклонения и неполные данные формируют WARNING; соответствие всем правилам формирует PASS. |
| FS-006 | JSON writer | output.json сохраняет общий статус, результаты по каждому параметру, исходные значения, предупреждения, отказы и диагностические сообщения. |
| FS-007 | Integration contract | Формат CSV → JSON стабилен для вызова из LIMS/ELN/MES, планировщика задач или wrapper-сервиса. |
| FS-008 | Error handling | При ошибке схемы, отсутствующем файле, нечисловом значении или невозможности записи JSON возвращается диагностируемая ошибка без тихого PASS. |
8. Выходной контракт output.json
Выходной файл должен быть пригоден для автоматической обработки, аудита и сопоставления с исходной строкой input.csv.
{
"utility": "I131VolatilityExtendedChecker",
"api": "I131 Volatility Extended",
"batchNumber": "I131-VOL-2026-001",
"overallStatus": "PASS|WARNING|FAIL",
"checkedAtUtc": "2026-05-18T00:00:00Z",
"checks": [
{
"parameter": "BatchNumber",
"value": "I131-VOL-2026-001",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Результат проверки по правилу"
},
{
"parameter": "VolatileIodinePercent_Current",
"value": "2.5",
"unit": "%",
"status": "PASS|WARNING|FAIL",
"message": "Результат проверки по правилу"
},
{
"parameter": "MeasurementDateTime",
"value": "2026-03-18T10:00:00",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Результат проверки по правилу"
},
{
"parameter": "ProductionDateTime",
"value": "2026-03-10T08:00:00",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Результат проверки по правилу"
},
{
"parameter": "StorageTemperatureC",
"value": "22.0",
"unit": "°C",
"status": "PASS|WARNING|FAIL",
"message": "Результат проверки по правилу"
},
{
"parameter": "PreviousVolatileIodinePercent",
"value": "2.3",
"unit": "%",
"status": "PASS|WARNING|FAIL",
"message": "Результат проверки по правилу"
},
{
"parameter": "PreviousMeasurementDateTime",
"value": "2026-03-15T10:00:00",
"unit": "as specified",
"status": "PASS|WARNING|FAIL",
"message": "Результат проверки по правилу"
},
{
"parameter": "HumidityPercent",
"value": "45.0",
"unit": "%",
"status": "PASS|WARNING|FAIL",
"message": "Результат проверки по правилу"
}
],
"criticalFindings": [],
"sourceFile": "input.csv"
}9. Тестовые сценарии OQ/PQ
| ID | Сценарий | Ожидаемый результат |
|---|---|---|
| TC-001 | Валидный CSV с заголовком и строкой из примера | Все строки обработаны; результат содержит PASS/WARNING/FAIL и детализацию по параметрам. |
| TC-002 | Отсутствует обязательная колонка из input.csv | Импорт отклоняется или строка получает FAIL со ссылкой на схему. |
| TC-003 | Числовое поле содержит текст или пустое значение | Фиксируется ошибка преобразования типа; результат не маскируется как PASS. |
| TC-004 | Параметр выходит за предел спецификации / критического лимита | Для критического параметра формируется FAIL; для некритического — WARNING согласно правилу. |
10. QA/QC, CSV и управление изменениями
- Перед применением на производстве клиент фиксирует версию исполняемого файла, контрольную сумму, версию спецификации/монографии, тестовый CSV, ожидаемый JSON и результаты IQ/OQ.
- Нельзя менять имена колонок без обновления валидатора и тестовых сценариев.
- Исходный CSV, output.json и версия утилиты должны храниться вместе как пакет доказательств.
- Любое изменение правил контроля должно проходить change control и повторную проверку OQ-сценариев.
Входит в пакеты
Эндокринология
Пакет для эндокринологии: щитовидная железа, гипофизарные/пептидные гормоны, кортикостероиды, половые гормоны и часть метаболических препаратов.
ОткрытьЛОР
Пакет для ЛОР-направления: назальные спреи, ушные капли, местные антисептики, кортикостероиды, антибиотики и препараты для дыхательных путей.
ОткрытьPetRad QC Suite
Пакет специализированных утилит для контроля качества радиофармпрепаратов: ПЭТ, SPECT, терапевтические радионуклиды, генераторы и расчёты распада.
ОткрытьРадиология
Пакет для радиологии и диагностической визуализации: радиофармпрепараты, PET/SPECT, контрастные вещества, йодсодержащие и гадолиниевые препараты, а также проверки частиц, стерильности и эндотоксинов.
ОткрытьRPH: объединённый радиофармацевтический QC-пакет
RPH объединяет PetRad, PetRad2 и PetRad3 в один обзорный пакет для PET/SPECT, терапевтических радионуклидов, генераторов, меченых соединений, расчётов распада, стерильности, эндотоксинов и радиохимической/радионуклидной чистоты.
Открыть