ResidualSolventsGCQualityChecker
Residual Solvents GC
Residual Solvents GC Quality Checker — Контроль остаточных растворителей (ГХ)
ℹ️ Утилита проверяет содержание остаточных растворителей согласно руководству ICH Q3C:
• Класс 1 (Избегать): Бензол (≤2 ppm) — канцероген
• Класс 2 (Лимит): Метанол (≤3000 ppm), Ацетонитрил (≤410 ppm), Дихлорметан (≤600 ppm), Гексан (≤290 ppm)
• Класс 3 (Низкая токсичность): Этилацетат (≤5000 ppm), Ацетон (≤5000 ppm)
• Общая сумма растворителей (≤5000 ppm или 0.5%)
⚠️ КРИТИЧНО: Превышение бензола (>2 ppm) недопустимо из-за высокой канцерогенности!
Превышение общей суммы растворителей указывает на недостаточную сушку или очистку.
Использование:
ResidualSolventsGCQualityChecker.exe → демо-режим (вывод в консоль)
ResidualSolventsGCQualityChecker.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,ProductName,MethanolPPM,AcetonitrilePPM,DichloromethanePPM,HexanePPM,EthylAcetatePPM,AcetonePPM,BenzenePPM,TotalSolventsPPM
Пример:
API-2026-RS-001,Active Ingredient X,1500.0,200.0,300.0,100.0,2500.0,1000.0,0.5,5600.5
— ЗАЧЕМ ЭТО НУЖНО?
Остаточные растворители могут присутствовать в активных фармацевтических субстанциях (АФС) и вспомогательных веществах после синтеза или очистки.
Согласно ICH Q3C, они классифицируются по степени токсичности:
• Класс 1: Растворители, которых следует избегать (известные канцерогены или токсины окружающей среды).
• Класс 2: Растворители, которые следует ограничивать (негенотоксические животные канцерогены или вызывающие другие необратимые токсические эффекты).
• Класс 3: Растворители с низкой потенциальной токсичностью для человека.
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Бензол ≤2 ppm — строгий лимит из-за канцерогенности. Даже следовые количества опасны.
• Общая сумма растворителей ≤5000 ppm (0.5%) — стандартный предел для большинства АФС, если не обосновано иное.
• Метанол ≤3000 ppm — часто используется в синтезе, но токсичен при накоплении.
• Дихлорметан ≤600 ppm — потенциальный канцероген, требует строгого контроля.
Ключевые особенности утилиты:
• Проверка растворителей всех трех классов ICH Q3C
• Строгий контроль бензола (Класс 1)
• Расчет и проверка общей суммы растворителей
• Генерация отчетов, совместимых с LIMS LabWare
• Поддержка множественных проб в одном файле
Критические параметры:
• Бензол: ≤2 ppm (Класс 1)
• Метанол: ≤3000 ppm (Класс 2)
• Ацетонитрил: ≤410 ppm (Класс 2)
• Дихлорметан: ≤600 ppm (Класс 2)
• Гексан: ≤290 ppm (Класс 2)
• Этилацетат: ≤5000 ppm (Класс 3)
• Ацетон: ≤5000 ppm (Класс 3)
• Общая сумма: ≤5000 ppm
💡 Советы по использованию:
1. Метод анализа: Газовая хроматография с пламенно-ионизационным детектором (ГХ-ПИД/GC-FID) или масс-спектрометрией (ГХ-МС/GC-MS).
2. Пробоподготовка: Обычно используется метод прямого введения раствора или равновесная газовая фаза (HeadSpace).
3. Если сумма индивидуальных растворителей превышает 5000 ppm, партия бракуется, даже если каждый отдельный растворитель в норме.
4. Для растворителей Класса 3 лимит может быть выше, если это обосновано производственным процессом, но по умолчанию используется 5000 ppm.
5. Бензол должен определяться с высокой чувствительностью из-за низкого лимита.
⚠️ Особенность: Наличие растворителей Класса 1 (например, бензола) должно быть полностью исключено из производственного процесса, если это возможно. Если их присутствие неизбежно, они должны контролироваться с помощью валидированных аналитических процедур с пределами обнаружения, соответствующими уровню токсичности.
input.csv
BatchNumber,ProductName,MethanolPPM,AcetonitrilePPM,DichloromethanePPM,HexanePPM,EthylAcetatePPM,AcetonePPM,BenzenePPM,TotalSolventsPPM API-2026-RS-001,Active Pharmaceutical Ingredient X,1500.0,200.0,300.0,100.0,2500.0,1000.0,0.5,5600.5 API-2026-RS-002,Intermediate Compound Y,2800.0,400.0,550.0,280.0,4800.0,4900.0,1.8,4900.0
URS & FS — Residual Solvents GC
Документ описывает пользовательские требования и функциональную спецификацию для утилиты ResidualSolventsGCQualityChecker. Утилита предназначена для использования в лаборатории ОКК/QC как rule-based проверка данных, подготовленных из прибора, LIMS, ELN, MES или вручную утверждённого input.csv.
URS — пользовательские требования
| ID | Требование | Критичность | Критерий приемки |
|---|---|---|---|
| URS-001 | Утилита должна принимать input.csv с утверждёнными колонками: BatchNumber, ProductName, MethanolPPM, AcetonitrilePPM, DichloromethanePPM, HexanePPM, EthylAcetatePPM, AcetonePPM, BenzenePPM, TotalSolventsPPM. | High | CSV обрабатывается без ручной правки заголовков. |
| URS-002 | Утилита должна выполнять детерминированную проверку данных для объекта «Residual Solvents GC» без применения машинного обучения. | High | Одинаковые входные данные дают одинаковый JSON-результат. |
| URS-003 | Утилита должна валидировать обязательные поля, числовые форматы, флаги, диапазоны и предметную правдоподобность значений. | High | Ошибки схемы и преобразования явно отражаются в результате. |
| URS-004 | Утилита должна формировать output.json со статусами PASS / WARNING / FAIL, исходными значениями, предупреждениями и отказами. | High | JSON пригоден для review, расследования отклонений и интеграции. |
| URS-005 | Документация должна поддерживать подготовку IQ/OQ/PQ или CSV/CSA-проверки. | Medium | URS/FS, контракт CSV/JSON и тестовые сценарии доступны вместе с утилитой. |
Контракт input.csv
| # | Поле | Пример | Назначение |
|---|---|---|---|
| 1 | BatchNumber | API-2026-RS-001 | Входной параметр для детерминированной проверки ОКК/QC. |
| 2 | ProductName | Active Pharmaceutical Ingredient X | Входной параметр для детерминированной проверки ОКК/QC. |
| 3 | MethanolPPM | 1500.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 4 | AcetonitrilePPM | 200.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 5 | DichloromethanePPM | 300.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 6 | HexanePPM | 100.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 7 | EthylAcetatePPM | 2500.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 8 | AcetonePPM | 1000.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 9 | BenzenePPM | 0.5 | Входной параметр для детерминированной проверки ОКК/QC. |
| 10 | TotalSolventsPPM | 5600.5 | Входной параметр для детерминированной проверки ОКК/QC. |
FS — функциональная спецификация
| ID | Функция | Реализация |
|---|---|---|
| FS-001 | CSV import | Прочитать input.csv, проверить заголовок, число колонок и кодировку. |
| FS-002 | Schema validation | Проверить обязательность полей и допустимость входных значений. |
| FS-003 | Rule engine | Применить предметные правила, лимиты и проверки системной пригодности/спецификации, описанные в исходном описании утилиты. |
| FS-004 | Status aggregation | Сформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии. |
| FS-005 | JSON export | Записать машинно-читаемый output.json для LIMS/ELN/MES и QA/QC review. |
OQ/PQ сценарии
- OQ-001: валидная строка из примера должна обрабатываться без ошибки схемы.
- OQ-002: отсутствие обязательной колонки должно приводить к ошибке схемы.
- OQ-003: нечисловое значение в числовом поле должно приводить к ошибке преобразования.
- OQ-004: значение критического параметра вне предела должно давать
FAILили critical finding. - PQ-001: реальные серии пользователя проверяются с сохранением
input.csv,output.json, версии утилиты и контрольной суммы.
Входит в пакеты
Наркология
Пакет QC-утилит для наркологии и регулируемых лекарственных средств: препараты для терапии зависимости, опиоиды, бензодиазепины, стимуляторы, седативные средства, летучие примеси, assay/identity/dissolution/release checks.
ОткрытьБиофармацевтика расширенная
Расширенный coverage-пакет QC-утилит для mAb, биоаналогов, белков, инсулинов, вакцин, mRNA/LNP, HCP, стерильного выпуска, микробиологии, воды, cleanroom и стабильности.
ОткрытьСтоматология и стоматологические материалы
Пакет QC-утилит для стоматологических лекарственных продуктов, средств для полости рта и стоматологических материалов: анестетики, антисептики, обезболивание/антибиотики, полимеры/минералы, смолы, бондинги, микробиология, стабильность и material QC.
ОткрытьИнфекционистика
Пакет QC-утилит для инфекционистики: антибактериальные, противовирусные, противогрибковые и противопаразитарные продукты, микробиология, стерильность, эндотоксины, вирусная безопасность, вакцинные release-checks.
ОткрытьLabEx QC Suite
Пакет LabEx для лабораторных методов контроля качества: хроматография, спектроскопия, микробиология, стерильность, эндотоксины, частицы, растворение, вода, чистые помещения и подготовка образцов.
ОткрытьРадиология
Пакет для радиологии и диагностической визуализации: радиофармпрепараты, PET/SPECT, контрастные вещества, йодсодержащие и гадолиниевые препараты, а также проверки частиц, стерильности и эндотоксинов.
ОткрытьТоксикология
Пакет QC-утилит для токсикологически значимых рисков: генотоксичные примеси, остаточные растворители, элементные примеси, тяжёлые металлы, ртуть, микотоксины, пестициды, extractables/leachables и деградационные примеси.
Открыть