OsmolalityQualityChecker

Osmolality

LabEx laboratory QC CSV→JSON URS & FS utilities / cleanroom
Открыть подборку
Osmolality Quality Checker — Контроль осмоляльности растворов

ℹ️  Утилита проверяет соответствие осмоляльности установленным пределам (USP <785> / Ph. Eur. 2.2.35):
   • Измеренное значение должно находиться в диапазоне [Lower Limit – Upper Limit].
   • Типичные диапазоны: 280–310 мОсм/кг (изотонические растворы).

⚠️  КРИТИЧНО: Гипо- или гиперосмолярные растворы могут быть опасны для пациента!
   Инъекции с неправильной осмоляльностью вызывают гемолиз, боль или флебит.

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

Формат input.csv:
BatchNumber,MeasuredOsmolality,LowerLimit,UpperLimit

Пример:
 OSMO-INJ-2026-001,295.0,280.0,310.0

— ЗАЧЕМ ЭТО НУЖНО?
Осмоляльность — критический параметр качества для парентеральных, офтальмологических и назальных препаратов.
• Определяет тоничность раствора относительно плазмы крови.
• Измеряется методом понижения температуры замерзания (криоскопия) или давления пара.
• USP <785> и Ph. Eur. 2.2.35 регламентируют методы измерения.
• Контроль необходим для обеспечения безопасности и комфорта пациента при введении препарата.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Для инъекционных препаратов осмоляльность должна быть близка к физиологической (~290 мОсм/кг).
• Высокая осмоляльность (>1000 мОсм/кг) требует введения только в крупные вены.
• Калибровка осмометра должна проводиться ежедневно по стандартным растворам (NaCl).
• Образец не должен содержать пузырьков воздуха.

Ключевые особенности утилиты:
• Быстрая проверка соответствия спецификации.
• Поддержка данных криоскопических осмометров.
• Генерация статуса PASS/FAIL для LIMS.

Критические параметры:
• Measured Osmolality: Within [LL - UL]

💡 Советы по использованию:
1. Тщательно перемешивайте образец перед измерением.
2. Используйте чистые пробирки для исключения контаминации.
3. Проверяйте точку замерзания чистого растворителя (воды) перед серией.
4. Учитывайте влияние летучих компонентов (спиртов) на результат.
5. Для вязких образцов убедитесь в полном термостатировании.

⚠️ Особенность: Осмоляльность (мОсм/кг) зависит от количества частиц растворенного вещества и не зависит от их природы, в отличие от осмолярности (мОсм/л), которая зависит от объема и температуры.

input.csv

BatchNumber,MeasuredOsmolality,LowerLimit,UpperLimit
OSMO-INJ-2026-001,295.0,280.0,310.0
OSMO-EYE-2026-001,305.0,250.0,350.0
OSMO-FAIL-HYPO-001,260.0,280.0,310.0

URS & FS — Osmolality

Документ описывает пользовательские требования и функциональную спецификацию для утилиты OsmolalityQualityChecker. Утилита предназначена для использования в лаборатории ОКК/QC как rule-based проверка данных, подготовленных из прибора, LIMS, ELN, MES или вручную утверждённого input.csv.

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

IDТребованиеКритичностьКритерий приемки
URS-001Утилита должна принимать input.csv с утверждёнными колонками: BatchNumber, MeasuredOsmolality, LowerLimit, UpperLimit.HighCSV обрабатывается без ручной правки заголовков.
URS-002Утилита должна выполнять детерминированную проверку данных для объекта «Osmolality» без применения машинного обучения.HighОдинаковые входные данные дают одинаковый JSON-результат.
URS-003Утилита должна валидировать обязательные поля, числовые форматы, флаги, диапазоны и предметную правдоподобность значений.HighОшибки схемы и преобразования явно отражаются в результате.
URS-004Утилита должна формировать output.json со статусами PASS / WARNING / FAIL, исходными значениями, предупреждениями и отказами.HighJSON пригоден для review, расследования отклонений и интеграции.
URS-005Документация должна поддерживать подготовку IQ/OQ/PQ или CSV/CSA-проверки.MediumURS/FS, контракт CSV/JSON и тестовые сценарии доступны вместе с утилитой.

Контракт input.csv

#ПолеПримерНазначение
1BatchNumberOSMO-INJ-2026-001Входной параметр для детерминированной проверки ОКК/QC.
2MeasuredOsmolality295.0Входной параметр для детерминированной проверки ОКК/QC.
3LowerLimit280.0Входной параметр для детерминированной проверки ОКК/QC.
4UpperLimit310.0Входной параметр для детерминированной проверки ОКК/QC.

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

IDФункцияРеализация
FS-001CSV importПрочитать input.csv, проверить заголовок, число колонок и кодировку.
FS-002Schema validationПроверить обязательность полей и допустимость входных значений.
FS-003Rule engineПрименить предметные правила, лимиты и проверки системной пригодности/спецификации, описанные в исходном описании утилиты.
FS-004Status aggregationСформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии.
FS-005JSON 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, версии утилиты и контрольной суммы.

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

Биофармацевтика расширенная

Расширенный coverage-пакет QC-утилит для mAb, биоаналогов, белков, инсулинов, вакцин, mRNA/LNP, HCP, стерильного выпуска, микробиологии, воды, cleanroom и стабильности.

Открыть

Стоматология и стоматологические материалы

Пакет QC-утилит для стоматологических лекарственных продуктов, средств для полости рта и стоматологических материалов: анестетики, антисептики, обезболивание/антибиотики, полимеры/минералы, смолы, бондинги, микробиология, стабильность и material QC.

Открыть

ЛОР

Пакет для ЛОР-направления: назальные спреи, ушные капли, местные антисептики, кортикостероиды, антибиотики и препараты для дыхательных путей.

Открыть

LabEx QC Suite

Пакет LabEx для лабораторных методов контроля качества: хроматография, спектроскопия, микробиология, стерильность, эндотоксины, частицы, растворение, вода, чистые помещения и подготовка образцов.

Открыть

Неврология

Пакет для неврологии и психоневрологии: противоэпилептические, противопаркинсонические, антидепрессанты, антипсихотики, анальгетики и диагностические радиофармпрепараты.

Открыть

Офтальмология

Пакет для офтальмологии: глазные капли, противоглаукомные средства, антибиотики, стерильные растворы, осмоляльность, pH, частицы и консерванты.

Открыть