Описание утилиты: 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 с машинно-читаемыми результатами, исходными значениями, предупреждениями, отказами и критическими находками. | High | JSON пригоден для LIMS/ELN/MES-интеграции и QA/QC review. |
| URS-006 | Утилита должна сохранять трассируемость между серией/образцом, входным файлом, применёнными правилами и итоговым статусом. | High | Выход содержит идентификаторы, список параметров и audit metadata. |
| URS-007 | Документация должна поддерживать подготовку IQ/OQ/PQ, CSV/CSA и обсуждение с инспекторами или внутренним QA. | Medium | URS, FS, контракт input/output и тестовые сценарии поставляются вместе с утилитой. |
| URS-008 | Утилита должна использоваться как decision-support инструмент QC, а не как замена утверждённым спецификациям и выпускному решению Qualified Person/QA. | Medium | В документации указан контроль change control и необходимость сверки пределов. |
Контракт input.csv
| # | Поле | Тип | Пример | Назначение |
|---|
| 1 | BatchNumber | string / controlled vocabulary | VAC-2025-001 | Идентификатор серии/партии для трассируемости. |
| 2 | ManufacturingDate | string / controlled vocabulary | 2025-01-15 | Контролируемый входной параметр для детерминированных QC-правил. |
| 3 | PotencyResult_IU_per_dose | decimal | 102.5 | Потентность/активность; критический параметр эффективности. |
| 4 | TargetPotency_IU_per_dose | decimal | 100.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-001 | BatchNumber | Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме. | High |
| VR-002 | ManufacturingDate | Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме. | High |
| VR-003 | PotencyResult_IU_per_dose | Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме. | High |
| VR-004 | TargetPotency_IU_per_dose | Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме. | Medium |
FS — функциональная спецификация
| ID | Функция | Реализация |
|---|
| FS-001 | CLI execution | Поддержать режимы запуска: demo mode без аргументов и production mode input.csv output.json. |
| FS-002 | CSV import | Прочитать input.csv в UTF-8/CSV-совместимом формате, проверить наличие заголовка и ожидаемых колонок. |
| FS-003 | Schema validation | Проверить обязательные поля, количество колонок, неизвестные ключевые поля и пустые обязательные значения. |
| FS-004 | Type conversion | Преобразовать числовые, флаговые и текстовые значения; некорректный формат фиксировать как ошибку строки. |
| FS-005 | Domain rule engine | Применить правила для Potency Assay Trend Checker, включая критические пределы из описания и утверждённой спецификации. |
| FS-006 | Status aggregation | Сформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии. |
| FS-007 | JSON export | Записать output.json с детализацией проверок, исходными значениями, предупреждениями, отказами и critical findings. |
| FS-008 | Audit support | Сохранять структуру результата пригодной для review, расследования отклонений и воспроизведения расчёта. |
| FS-009 | Integration contract | Поддержать сценарий LIMS/ELN/MES → input.csv → utility → output.json → portal/admin review. |
| FS-010 | Error 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"
}
}
Матрица трассируемости
| URS | FS | Тест | Подтверждение |
|---|
| URS-001 | FS-001, FS-002 | OQ-001 | Проверить запуск и импорт валидного input.csv. |
| URS-002 | FS-005, FS-006 | OQ-004 | Повторить один и тот же набор данных и сравнить output.json. |
| URS-003 | FS-003, FS-004, FS-010 | OQ-002, OQ-003 | Проверить отсутствующие колонки и неверные типы. |
| URS-004 | FS-005, FS-006 | OQ-004, PQ-001 | Проверить критические отклонения по реальным/граничным данным. |
| URS-005 | FS-007, FS-009 | OQ-005 | Проверить JSON schema и пригодность для downstream-систем. |
| URS-006 | FS-008 | OQ-006 | Проверить наличие идентификаторов и audit metadata. |
| URS-007 | FS-008, FS-010 | IQ-001, OQ-007 | Проверить комплектность документации и control evidence. |
| URS-008 | FS-005, FS-008 | PQ-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 и утверждёнными процедурами.