PotencyAssayTrendChecker

Potency Assay Trend

Vet veterinary veterinary vaccines animal health adjuvants aquaculture batch release CSV→JSON
Открыть подборку

Описание утилиты: Potency Assay Trend

Potency Assay Trend Checker — Статистический анализ трендов активности (SPC)

ℹ️  Утилита выполняет статистический анализ исторических данных активности (Potency) лекарственных препаратов в соответствии с принципами Статистического Контроля Процесса (SPC) и требованиями ICH Q10 / VICH GL:
     • Линейная регрессия: Расчет наклона тренда (Slope) и коэффициента детерминации (R²) для оценки направленности изменений.
     • Контрольные карты Шухарта: Автоматический расчет среднего значения, стандартного отклонения (SD), верхних и нижних контрольных пределов (UCL/LCL ±3SD) и предупредительных пределов (±2SD).
     • Правила Вестгарда (Westgard Rules): Алгоритмическая проверка последовательностей данных на наличие систематических ошибок (сдвиги среднего, дрейф, выход за контрольные пределы).

⚠️  ВАЖНО: 
     • Для обеспечения статистической значимости результатов рекомендуется использовать выборку не менее 10–15 последовательных серий.
     • Выявление статистически значимых трендов позволяет инициировать корректирующие действия до выхода параметров за пределы спецификации (OOS).

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

Формат input.csv:
BatchNumber,ManufacturingDate,PotencyResult_IU_per_dose,TargetPotency_IU_per_dose

Пример:
  VAC-001,2025-01-15,105.5,100.0

— ЗАЧЕМ ЭТО НУЖНО?
Мониторинг трендов является обязательным элементом Системы Фармацевтического Качества (PQS) согласно ICH Q10 и этапу 3 Валидации Процесса (Continued Process Verification).
Постепенное изменение активности может свидетельствовать о деградации сырья, износе оборудования или неконтролируемом дрейфе критических параметров процесса (CPP).
Раннее обнаружение таких отклонений позволяет провести расследование и внедрить CAPA до возникновения брака серии.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Правило 7x Mean: Наличие 7 последовательных точек по одну сторону от центральной линии указывает на статистически значимый сдвиг процесса.
• Правило Тренда: Наличие 6 и более последовательно возрастающих или убывающих точек указывает на систематический дрейф.
• Выход за 3SD: Единичный выход точки за контрольный предел свидетельствует о наличии особой причины вариации (Special Cause Variation), требующей расследования.
• Гомоскедастичность: Анализ предполагает стабильность дисперсии данных во времени. При изменении разброса требуется пересчет базовой линии.

Ключевые особенности утилиты:
• Автоматизированный расчет статистических параметров процесса
• Детекция нарушений правил Вестгарда и других критериев нестабильности
• Количественная оценка направления и достоверности тренда
• Генерация отчетов, соответствующих требованиям аудита QA и регуляторных инспекций
• Поддержка требований ICH Q10 (Pharmaceutical Quality System) и VICH GL

Критические параметры:
• Наклон тренда (Slope): Показатель скорости изменения параметра
• R-Squared: Мера достоверности линейной модели
• Нарушения правил Вестгарда: Индикаторы потери статистического контроля
• Статус процесса: OK (Under Control), WARNING (Investigation Required), ALERT (Out of Control)

💡 Советы по использованию:
1. Целостность данных: Используйте только верифицированные результаты выпущенных серий, прошедших полный цикл контроля качества.
2. Периодичность анализа: Рекомендуется проводить анализ ежемесячно или после выпуска каждой серии в рамках Ежегодного Обзора Качества (APR/PQR).
3. Интерпретация статусов: Статус "WARNING" указывает на необходимость технологического расследования, даже если результаты находятся в пределах спецификации.
4. Документирование: JSON-отчеты должны сохраняться как объективные доказательства проведения мониторинга тенденций.
5. Корректирующие действия: При выявлении значимого тренда необходимо инициировать процедуру управления отклонениями и оценить влияние на ранее выпущенные серии.

⚠️ Примечание: В отличие от посерийного контроля соответствия спецификациям (Pass/Fail), данный инструмент предназначен для оценки состояния статистического контроля производственного процесса (State of Control) в динамике, что является требованием современных стандартов GMP.

input.csv

BatchNumber,ManufacturingDate,PotencyResult_IU_per_dose,TargetPotency_IU_per_dose
VAC-2025-001,2025-01-15,102.5,100.0
VAC-2025-002,2025-02-10,101.8,100.0
VAC-2025-003,2025-03-05,103.1,100.0
VAC-2025-004,2025-04-12,99.5,100.0
VAC-2025-005,2025-05-20,100.2,100.0
VAC-2025-006,2025-06-18,98.7,100.0
VAC-2025-007,2025-07-22,97.5,100.0
VAC-2025-008,2025-08-15,96.8,100.0
VAC-2025-009,2025-09-10,95.2,100.0
VAC-2025-010,2025-10-05,94.1,100.0
VAC-2025-011,2025-11-12,93.5,100.0
VAC-2025-012,2025-12-01,92.0,100.0

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

Документ описывает контролируемый интерфейс и поведение утилиты PotencyAssayTrendChecker для сценария Potency Assay Trend Checker.

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

Ниже приведены ключевые фрагменты исходного описания. Перед продуктивным применением пределы должны быть сверены с утверждённой спецификацией, регистрационным досье и локальными SOP.
  • Potency Assay Trend Checker — Статистический анализ трендов активности (SPC)
  • ℹ️ Утилита выполняет статистический анализ исторических данных активности (Potency) лекарственных препаратов в соответствии с принципами Статистического Контроля Процесса (SPC) и требованиями ICH Q10 / VICH GL:
  • • Контрольные карты Шухарта: Автоматический расчет среднего значения, стандартного отклонения (SD), верхних и нижних контрольных пределов (UCL/LCL ±3SD) и предупредительных пределов (±2SD).
  • • Правила Вестгарда (Westgard Rules): Алгоритмическая проверка последовательностей данных на наличие систематических ошибок (сдвиги среднего, дрейф, выход за контрольные пределы).
  • ⚠️ ВАЖНО:
  • • Выявление статистически значимых трендов позволяет инициировать корректирующие действия до выхода параметров за пределы спецификации (OOS).
  • PotencyAssayTrendChecker.exe → демо-режим (вывод в консоль)
  • PotencyAssayTrendChecker.exe input.csv output.json → оценка ваших данных
  • BatchNumber,ManufacturingDate,PotencyResult_IU_per_dose,TargetPotency_IU_per_dose
  • Мониторинг трендов является обязательным элементом Системы Фармацевтического Качества (PQS) согласно ICH Q10 и этапу 3 Валидации Процесса (Continued Process Verification).
  • Постепенное изменение активности может свидетельствовать о деградации сырья, износе оборудования или неконтролируемом дрейфе критических параметров процесса (CPP).
  • ⚠️ КРИТИЧЕСКИ ВАЖНО:
  • • Выход за 3SD: Единичный выход точки за контрольный предел свидетельствует о наличии особой причины вариации (Special Cause Variation), требующей расследования.
  • • Детекция нарушений правил Вестгарда и других критериев нестабильности
  • • Поддержка требований ICH Q10 (Pharmaceutical Quality System) и VICH GL
  • Критические параметры:
  • 3. Интерпретация статусов: Статус "WARNING" указывает на необходимость технологического расследования, даже если результаты находятся в пределах спецификации.
  • ⚠️ Примечание: В отличие от посерийного контроля соответствия спецификациям (Pass/Fail), данный инструмент предназначен для оценки состояния статистического контроля производственного процесса (State of Control) в динамике, что является требованием современных стандартов GMP.

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

IDТребованиеКритичностьКритерий приемки
URS-001Утилита должна принимать файл input.csv для Potency Assay Trend 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

#ПолеТипПримерНазначение
1BatchNumberstring / controlled vocabularyVAC-2025-001Идентификатор серии/партии для трассируемости.
2ManufacturingDatestring / controlled vocabulary2025-01-15Контролируемый входной параметр для детерминированных QC-правил.
3PotencyResult_IU_per_dosedecimal102.5Потентность/активность; критический параметр эффективности.
4TargetPotency_IU_per_dosedecimal100.0Потентность/активность; критический параметр эффективности.
BatchNumber,ManufacturingDate,PotencyResult_IU_per_dose,TargetPotency_IU_per_dose
VAC-2025-001,2025-01-15,102.5,100.0
VAC-2025-002,2025-02-10,101.8,100.0
VAC-2025-003,2025-03-05,103.1,100.0

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

IDПолеПравилоКритичность
VR-001BatchNumberПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-002ManufacturingDateПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-003PotencyResult_IU_per_doseПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-004TargetPotency_IU_per_doseПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.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Применить правила для Potency Assay Trend 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": "potencyassaytrendchecker",
  "utilityFolder": "PotencyAssayTrendChecker",
  "package": "Vet",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "processedAtUtc": "2026-06-10T00:00:00Z",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "VAC-2025-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-001"
    },
    {
      "parameter": "ManufacturingDate",
      "value": "2025-01-15",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-002"
    },
    {
      "parameter": "PotencyResult_IU_per_dose",
      "value": "102.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-003"
    },
    {
      "parameter": "TargetPotency_IU_per_dose",
      "value": "100.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-004"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "audit": {
    "inputHash": "sha256:<calculated at runtime>",
    "rulesVersion": "<utility executable version>",
    "documentation": "PotencyAssayTrendChecker.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 и утверждёнными процедурами.

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

Vet — ветеринарные QC утилиты

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

Открыть