ColdChainShippingTemperatureAndMKT_QualityChecker

Cold Chain Shipping Temperature And MKT

Huvac human vaccines vaccination adjuvants mRNA vaccines sterility endotoxins cold chain
Открыть подборку

Описание утилиты: Cold Chain Shipping Temperature And MKT

Cold Chain Shipping Temperature And MKT Quality Checker — Анализ температуры и MKT при перевозке

ℹ️  Утилита выполняет глубокий анализ температурных профилей при транспортировке фармацевтических грузов согласно USP <1079> и Ph. Eur. 5.2.2:
     • Абсолютные пределы: Проверка выхода за минимальные и максимальные допустимые температуры.
     • Средняя Кинетическая Температура (MKT): Расчет параметра, отражающего кумулятивный эффект температурных колебаний на скорость деградации продукта.
     • Детекция замораживания: Критическая проверка для биофармацевтических препаратов.
     • Оценка теплового стресса: Сравнение MKT с установленным лимитом (обычно равным верхней границе диапазона хранения).

⚠️  ВАЖНО: 
     • MKT является более строгим показателем, чем среднее арифметическое.
     • Даже если температура вернулась в норму, высокий MKT указывает на необратимые изменения в молекуле.

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

Формат input.csv:
ShipmentID,ProductName,StorageCondition,MinTemp_C,MaxTemp_C,AvgTemp_C,MKT_C,LimitLow_C,LimitHigh_C,MKT_Limit_C

Пример:
  SHIP-001,Drug X,2-8C,3.0,7.5,5.0,5.2,2.0,8.0,8.0

📍 Область применения (Usage Where):
     • Логистика и дистрибуция: Приемка международных грузов.
     • Контроль качества (QC): Оценка данных с логгеров перед выпуском партии.
     • Расследование отклонений: Обоснование пригодности продукта после температурных эксурсий.
     • Валидация упаковки: Анализ результатов квалификационных испытаний термоконтейнеров.

— ЗАЧЕМ ЭТО НУЖНО?
Простая проверка "минимум-максимум" не учитывает время воздействия повышенной температуры.
MKT позволяет количественно оценить риск деградации, основываясь на уравнении Аррениуса.
Это дает научное обоснование для принятия решения о выпуске или браковке продукции, сэкономив миллионы долларов на утилизации годного товара.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Замораживание: Для большинства жидких форм выход ниже 0°C или 2°C является критическим браком, независимо от MKT.
• MKT Limit: Превышение MKT над верхним пределом диапазона (например, >8°C для холодовой цепи) указывает на значительную потерю стабильности.
• Частота записи: Для точного расчета MKT необходимы данные с интервалом не более 15-30 минут.

Ключевые особенности утилиты:
• Расчет и валидация параметра MKT
• Комплексная проверка абсолютных температурных пределов
• Автоматическая классификация статуса (Pass/Fail/Warning)
• Генерация отчетов для регуляторных органов
• Соответствие требованиям USP и WHO TRS 953

Критические параметры:
• Min Temp: Должна быть >= Limit Low
• Max Temp: Должна быть <= Limit High
• MKT: Должна быть <= MKT Limit
• Data Points: Достаточное количество для статистики

💡 Советы по использованию:
1. Калибровка логгеров: Используйте только сертифицированные устройства с действующей поверкой.
2. Размещение датчиков: Датчики должны находиться рядом с продуктом, а не на стенках контейнера.
3. Интерпретация MKT: MKT особенно полезна для продуктов с известной энергией активации деградации.
4. Документирование: Сохраняйте сырые данные логгеров вместе с отчетом утилиты.
5. Обучение: Персонал должен понимать разницу между средней температурой и MKT.

⚠️ Примечание: Данная утилита предоставляет математическую оценку теплового воздействия. Окончательное решение о пригодности продукта принимает уполномоченное лицо (QP) с учетом данных по стабильности конкретного препарата.

input.csv

ShipmentID,ProductName,StorageCondition,MinTemp_C,MaxTemp_C,AvgTemp_C,MKT_C,LimitLow_C,LimitHigh_C,MKT_Limit_C
SHIP-2026-MKT-001,Insulin Glargine,2-8C,3.2,7.8,5.1,5.3,2.0,8.0,8.0
SHIP-2026-MKT-002,Vaccine X,2-8C,1.5,9.5,5.5,6.8,2.0,8.0,8.0
SHIP-2026-MKT-003,Monoclonal Ab,CRT,18.0,24.5,21.0,21.5,15.0,25.0,25.0

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

Документ описывает контролируемый интерфейс и поведение утилиты ColdChainShippingTemperatureAndMKT_QualityChecker для сценария Cold Chain Shipping Temperature And MKT Quality Checker.

Предметные ограничения и критические параметры

Ниже приведены ключевые фрагменты исходного описания. Перед продуктивным применением пределы должны быть сверены с утверждённой спецификацией, регистрационным досье и локальными SOP.
  • ℹ️ Утилита выполняет глубокий анализ температурных профилей при транспортировке фармацевтических грузов согласно USP <1079> и Ph. Eur. 5.2.2:
  • • Абсолютные пределы: Проверка выхода за минимальные и максимальные допустимые температуры.
  • • Детекция замораживания: Критическая проверка для биофармацевтических препаратов.
  • ⚠️ ВАЖНО:
  • ShipmentID,ProductName,StorageCondition,MinTemp_C,MaxTemp_C,AvgTemp_C,MKT_C,LimitLow_C,LimitHigh_C,MKT_Limit_C
  • ⚠️ КРИТИЧЕСКИ ВАЖНО:
  • • Замораживание: Для большинства жидких форм выход ниже 0°C или 2°C является критическим браком, независимо от MKT.
  • • MKT Limit: Превышение MKT над верхним пределом диапазона (например, >8°C для холодовой цепи) указывает на значительную потерю стабильности.
  • • Комплексная проверка абсолютных температурных пределов
  • • Соответствие требованиям USP и WHO TRS 953
  • Критические параметры:
  • • Min Temp: Должна быть >= Limit Low
  • • Max Temp: Должна быть <= Limit High
  • • MKT: Должна быть <= MKT Limit

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

IDТребованиеКритичностьКритерий приемки
URS-001Утилита должна принимать файл input.csv для Cold Chain Shipping Temperature And MKT Quality Checker с заголовками, определёнными в контракте данных.HighФайл обрабатывается без ручного изменения заголовков.
URS-002Утилита должна выполнять детерминированную оценку QC/ОКК без машинного обучения и без вероятностного принятия решения о соответствии.HighПри одинаковых входных данных, версии правил и конфигурации результат полностью воспроизводим.
URS-003Утилита должна валидировать обязательные поля, типы данных, диапазоны, единицы измерения и предметную правдоподобность значений.HighОшибки схемы, преобразования и диапазона явно отражаются в результате.
URS-004Утилита должна применять предметные пределы и правила из описания, утверждённой спецификации, регистрационного досье и локальных SOP.HighКаждая проверка имеет результат PASS/WARNING/FAIL и понятное сообщение.
URS-005Утилита должна формировать output.json с машинно-читаемыми результатами, исходными значениями, предупреждениями, отказами и критическими находками.HighJSON пригоден для LIMS/ELN/MES-интеграции и QA/QC review.
URS-006Утилита должна сохранять трассируемость между серией/образцом, входным файлом, применёнными правилами и итоговым статусом.HighВыход содержит идентификаторы, список параметров и audit metadata.
URS-007Документация должна поддерживать подготовку IQ/OQ/PQ, CSV/CSA и обсуждение с инспекторами или внутренним QA.MediumURS, FS, контракт input/output и тестовые сценарии поставляются вместе с утилитой.
URS-008Утилита должна использоваться как decision-support инструмент QC, а не как замена утверждённым спецификациям и выпускному решению Qualified Person/QA.MediumВ документации указан контроль change control и необходимость сверки пределов.

Контракт input.csv

#ПолеТипПримерНазначение
1ShipmentIDstring / controlled vocabularySHIP-2026-MKT-001Контролируемый входной параметр для детерминированных QC-правил.
2ProductNamestring / controlled vocabularyInsulin GlargineНаименование продукта или проверяемой лекарственной формы.
3StorageConditionstring / controlled vocabulary2-8CКонтролируемый входной параметр для детерминированных QC-правил.
4MinTemp_Cdecimal3.2Температурный профиль/MKT; параметр хранения, перевозки и стабильности.
5MaxTemp_Cdecimal7.8Температурный профиль/MKT; параметр хранения, перевозки и стабильности.
6AvgTemp_Cdecimal5.1Температурный профиль/MKT; параметр хранения, перевозки и стабильности.
7MKT_Cdecimal5.3Температурный профиль/MKT; параметр хранения, перевозки и стабильности.
8LimitLow_Cdecimal2.0Утверждённый предел, применяемый при проверке результата.
9LimitHigh_Cdecimal8.0Утверждённый предел, применяемый при проверке результата.
10MKT_Limit_Cdecimal8.0Температурный профиль/MKT; параметр хранения, перевозки и стабильности.
ShipmentID,ProductName,StorageCondition,MinTemp_C,MaxTemp_C,AvgTemp_C,MKT_C,LimitLow_C,LimitHigh_C,MKT_Limit_C
SHIP-2026-MKT-001,Insulin Glargine,2-8C,3.2,7.8,5.1,5.3,2.0,8.0,8.0
SHIP-2026-MKT-002,Vaccine X,2-8C,1.5,9.5,5.5,6.8,2.0,8.0,8.0
SHIP-2026-MKT-003,Monoclonal Ab,CRT,18.0,24.5,21.0,21.5,15.0,25.0,25.0

Правила валидации входных данных

IDПолеПравилоКритичность
VR-001ShipmentIDПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-002ProductNameПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-003StorageConditionПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-004MinTemp_CПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-005MaxTemp_CПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-006AvgTemp_CПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-007MKT_CПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-008LimitLow_CПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-009LimitHigh_CПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-010MKT_Limit_CПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium

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

IDФункцияРеализация
FS-001CLI executionПоддержать режимы запуска: demo mode без аргументов и production mode input.csv output.json.
FS-002CSV importПрочитать input.csv в UTF-8/CSV-совместимом формате, проверить наличие заголовка и ожидаемых колонок.
FS-003Schema validationПроверить обязательные поля, количество колонок, неизвестные ключевые поля и пустые обязательные значения.
FS-004Type conversionПреобразовать числовые, флаговые и текстовые значения; некорректный формат фиксировать как ошибку строки.
FS-005Domain rule engineПрименить правила для Cold Chain Shipping Temperature And MKT Quality Checker, включая критические пределы из описания и утверждённой спецификации.
FS-006Status aggregationСформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии.
FS-007JSON exportЗаписать output.json с детализацией проверок, исходными значениями, предупреждениями, отказами и critical findings.
FS-008Audit supportСохранять структуру результата пригодной для review, расследования отклонений и воспроизведения расчёта.
FS-009Integration contractПоддержать сценарий LIMS/ELN/MES → input.csv → utility → output.json → portal/admin review.
FS-010Error handlingВозвращать явные сообщения для отсутствующего файла, пустого CSV, неверной схемы, ошибки записи output.json и некорректного формата.

Пример output.json

{
  "utilityId": "coldchainshippingtemperatureandmkt-qualitychecker",
  "utilityFolder": "ColdChainShippingTemperatureAndMKT_QualityChecker",
  "package": "huvac",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "processedAtUtc": "2026-06-10T00:00:00Z",
  "checks": [
    {
      "parameter": "ShipmentID",
      "value": "SHIP-2026-MKT-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-001"
    },
    {
      "parameter": "ProductName",
      "value": "Insulin Glargine",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-002"
    },
    {
      "parameter": "StorageCondition",
      "value": "2-8C",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-003"
    },
    {
      "parameter": "MinTemp_C",
      "value": "3.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-004"
    },
    {
      "parameter": "MaxTemp_C",
      "value": "7.8",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-005"
    },
    {
      "parameter": "AvgTemp_C",
      "value": "5.1",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-006"
    },
    {
      "parameter": "MKT_C",
      "value": "5.3",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-007"
    },
    {
      "parameter": "LimitLow_C",
      "value": "2.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-008"
    },
    {
      "parameter": "LimitHigh_C",
      "value": "8.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-009"
    },
    {
      "parameter": "MKT_Limit_C",
      "value": "8.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-010"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "audit": {
    "inputHash": "sha256:<calculated at runtime>",
    "rulesVersion": "<utility executable version>",
    "documentation": "ColdChainShippingTemperatureAndMKT_QualityChecker.documentation.html"
  }
}

Матрица трассируемости

URSFSТестПодтверждение
URS-001FS-001, FS-002OQ-001Проверить запуск и импорт валидного input.csv.
URS-002FS-005, FS-006OQ-004Повторить один и тот же набор данных и сравнить output.json.
URS-003FS-003, FS-004, FS-010OQ-002, OQ-003Проверить отсутствующие колонки и неверные типы.
URS-004FS-005, FS-006OQ-004, PQ-001Проверить критические отклонения по реальным/граничным данным.
URS-005FS-007, FS-009OQ-005Проверить JSON schema и пригодность для downstream-систем.
URS-006FS-008OQ-006Проверить наличие идентификаторов и audit metadata.
URS-007FS-008, FS-010IQ-001, OQ-007Проверить комплектность документации и control evidence.
URS-008FS-005, FS-008PQ-002Проверить review workflow и запрет автоматической замены QA-решения.

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

IDСценарийОжидаемый результат
IQ-001Проверить наличие executable, input.csv, документации и контрольной суммы.Комплект поставки полон; версия зафиксирована.
OQ-001Валидная строка из примера input.csv.PASS или допустимый WARNING согласно правилам.
OQ-002Удалить обязательную колонку из CSV.Ошибка схемы или FAIL с указанием отсутствующей колонки.
OQ-003Внести нечисловое значение в числовое поле.Ошибка преобразования типа с указанием строки/поля.
OQ-004Значение критического параметра вывести за предел.FAIL и critical finding.
OQ-005Проверить структуру output.json.Все обязательные секции присутствуют, JSON валиден.
OQ-006Проверить трассируемость серии/образца.Идентификаторы входа и результатов совпадают.
PQ-001Проверить 3–5 реальных партий/образцов пользователя.Результат подтверждён QC/QA review.
PQ-002Проверить workflow отклонения и ручного QA-решения.Утилита поддерживает review, но не заменяет утверждённое решение.

QA/QC и change control

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

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

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

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

Открыть

Huvac — QC утилиты для вакцин человека

Пакет Huvac содержит утилиты для контроля качества вакцин человека: адъюванты, антигенная активность, стерильность, эндотоксины, cold chain, mRNA-контроль, контейнеры и стабильность.

Открыть

Инфекционистика

Пакет QC-утилит для инфекционистики: антибактериальные, противовирусные, противогрибковые и противопаразитарные продукты, микробиология, стерильность, эндотоксины, вирусная безопасность, вакцинные release-checks.

Открыть