RabiesVaccinePotencyAssayReviewer

Rabies Vaccine Potency Assay

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

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

Rabies Vaccine Potency Assay Reviewer — Ревью теста на потенцию антирабической вакцины

ℹ️  Утилита выполняет автоматическую проверку критериев приемлемости для тестов на потенцию антирабических вакцин согласно Ph. Eur. 2.7.13 и рекомендациям WHO:
     • Валидность анализа: Проверка смертности в группе контроля заражения (Challenge Control) и выживаемости негативного контроля.
     • Статистическая корректность: Оценка фактора наклона (Slope) и линейности зависимости "доза-ответ".
     • Расчет потенции: Определение активности в Международных Единицах (IU) относительно международного стандарта.
     • Соответствие нормам: Сравнение с минимальными требованиями (≥ 2.5 IU/доза для человека, ≥ 1.0 IU/доза для животных).

⚠️  ВАЖНО: 
     • Тест на потенцию бешенства является одним из самых строгих биологических тестов.
     • Любое отклонение в контрольных группах делает результат неприменимым, так как ставит под сомнение вирулентность штамма вируса.

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

Формат input.csv:
BatchNumber,VaccineType,StdReference_IU,Slope_Factor,ControlGroup_SurvivalRate,ChallengeControl_MortalityRate,Calculated_Potency_IU,MinPotency_Requirement

Пример:
  RAB-001,Human,1.0,1.2,1.0,0.95,4.8,2.5

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

— ЗАЧЕМ ЭТО НУЖНО?
Бешенство — заболевание со 100% летальностью. Эффективность вакцины критически важна.
Автоматизированный ревью исключает ошибки в интерпретации сложных статистических данных (Probit/Spearman-Kärber analysis) и гарантирует, что только высокоиммуногенные серии поступают в продажу.
Это соответствует принципам GLP и требованиям глобальной безопасности здравоохранения.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Challenge Control: Смертность в этой группе должна быть высокой (обычно >80%), иначе вирус был слабым или доза недостаточной.
• Negative Control: Выживаемость должна быть близка к 100%, чтобы исключить случайную гибель животных.
• Slope Factor: Слишком пологий наклон кривой указывает на плохую воспроизводимость метода.
• IU Limit: Для человеческих вакцин предел 2.5 IU является жестким требованием WHO.

Ключевые особенности утилиты:
• Автоматическая проверка системной пригодности (System Suitability)
• Расчет статуса валидности теста (Valid/Invalid)
• Сравнение полученной потенции с нормативными требованиями (Human/Vet)
• Поддержка различных статистических моделей расчета
• Генерация отчетов для интеграции с LIMS

Критические параметры:
• Challenge Mortality: ≥ 80%
• Negative Control Survival: ≥ 90-100%
• Calculated Potency: ≥ 2.5 IU (Human) / ≥ 1.0 IU (Vet)
• Test Validity: True

💡 Советы по использованию:
1. Статистика: Используйте специализированное ПО для первичного расчета IU, а эту утилиту для ревью.
2. Архивные данные: Сравнивайте текущие показатели контролей с историческими данными лаборатории.
3. Биобезопасность: Все работы проводятся в условиях BSL-3.
4. Альтернативные методы: In vitro методы (псевдовирусы) могут использоваться для скрининга, но финальный релиз часто требует in vivo.
5. Документирование: Сохраняйте отчеты как часть протокола испытания.

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

input.csv

BatchNumber,VaccineType,StdReference_IU,Slope_Factor,ControlGroup_SurvivalRate,ChallengeControl_MortalityRate,Calculated_Potency_IU,MinPotency_Requirement
RAB-HUMAN-2026-001,Human,1.0,1.2,1.0,0.95,4.8,2.5
RAB-VET-2026-002,Veterinary,1.0,1.1,0.9,0.60,1.5,1.0
RAB-HUMAN-2026-003,Human,1.0,1.15,1.0,0.90,2.1,2.5

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

Документ описывает контролируемый интерфейс и поведение утилиты RabiesVaccinePotencyAssayReviewer для сценария Rabies Vaccine Potency Assay Reviewer.

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

Ниже приведены ключевые фрагменты исходного описания. Перед продуктивным применением пределы должны быть сверены с утверждённой спецификацией, регистрационным досье и локальными SOP.
  • Rabies Vaccine Potency Assay Reviewer — Ревью теста на потенцию антирабической вакцины
  • ℹ️ Утилита выполняет автоматическую проверку критериев приемлемости для тестов на потенцию антирабических вакцин согласно Ph. Eur. 2.7.13 и рекомендациям WHO:
  • • Расчет потенции: Определение активности в Международных Единицах (IU) относительно международного стандарта.
  • • Соответствие нормам: Сравнение с минимальными требованиями (≥ 2.5 IU/доза для человека, ≥ 1.0 IU/доза для животных).
  • ⚠️ ВАЖНО:
  • RabiesVaccinePotencyAssayReviewer.exe → демо-режим (вывод в консоль)
  • RabiesVaccinePotencyAssayReviewer.exe input.csv output.json → оценка ваших данных
  • BatchNumber,VaccineType,StdReference_IU,Slope_Factor,ControlGroup_SurvivalRate,ChallengeControl_MortalityRate,Calculated_Potency_IU,MinPotency_Requirement
  • Бешенство — заболевание со 100% летальностью. Эффективность вакцины критически важна.
  • ⚠️ КРИТИЧЕСКИ ВАЖНО:
  • • Challenge Control: Смертность в этой группе должна быть высокой (обычно >80%), иначе вирус был слабым или доза недостаточной.
  • • IU Limit: Для человеческих вакцин предел 2.5 IU является жестким требованием WHO.
  • • Сравнение полученной потенции с нормативными требованиями (Human/Vet)
  • Критические параметры:
  • • Challenge Mortality: ≥ 80%
  • • Negative Control Survival: ≥ 90-100%
  • • Calculated Potency: ≥ 2.5 IU (Human) / ≥ 1.0 IU (Vet)

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

IDТребованиеКритичностьКритерий приемки
URS-001Утилита должна принимать файл input.csv для Rabies Vaccine Potency Assay Reviewer с заголовками, определёнными в контракте данных.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 vocabularyRAB-HUMAN-2026-001Идентификатор серии/партии для трассируемости.
2VaccineTypestring / controlled vocabularyHumanКонтролируемый входной параметр для детерминированных QC-правил.
3StdReference_IUdecimal1.0Контролируемый входной параметр для детерминированных QC-правил.
4Slope_Factordecimal1.2Контролируемый входной параметр для детерминированных QC-правил.
5ControlGroup_SurvivalRatestring / controlled vocabulary1.0Контрольная точка/контрольный образец для валидности серии анализа.
6ChallengeControl_MortalityRatedecimal0.95Контрольная точка/контрольный образец для валидности серии анализа.
7Calculated_Potency_IUdecimal4.8Потентность/активность; критический параметр эффективности.
8MinPotency_Requirementdecimal2.5Потентность/активность; критический параметр эффективности.
BatchNumber,VaccineType,StdReference_IU,Slope_Factor,ControlGroup_SurvivalRate,ChallengeControl_MortalityRate,Calculated_Potency_IU,MinPotency_Requirement
RAB-HUMAN-2026-001,Human,1.0,1.2,1.0,0.95,4.8,2.5
RAB-VET-2026-002,Veterinary,1.0,1.1,0.9,0.60,1.5,1.0
RAB-HUMAN-2026-003,Human,1.0,1.15,1.0,0.90,2.1,2.5

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

IDПолеПравилоКритичность
VR-001BatchNumberПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-002VaccineTypeПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-003StdReference_IUПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-004Slope_FactorПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-005ControlGroup_SurvivalRateПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-006ChallengeControl_MortalityRateПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-007Calculated_Potency_IUПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-008MinPotency_RequirementПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.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Применить правила для Rabies Vaccine Potency Assay Reviewer, включая критические пределы из описания и утверждённой спецификации.
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": "rabiesvaccinepotencyassayreviewer",
  "utilityFolder": "RabiesVaccinePotencyAssayReviewer",
  "package": "Vet",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "processedAtUtc": "2026-06-10T00:00:00Z",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "RAB-HUMAN-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-001"
    },
    {
      "parameter": "VaccineType",
      "value": "Human",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-002"
    },
    {
      "parameter": "StdReference_IU",
      "value": "1.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-003"
    },
    {
      "parameter": "Slope_Factor",
      "value": "1.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-004"
    },
    {
      "parameter": "ControlGroup_SurvivalRate",
      "value": "1.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-005"
    },
    {
      "parameter": "ChallengeControl_MortalityRate",
      "value": "0.95",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-006"
    },
    {
      "parameter": "Calculated_Potency_IU",
      "value": "4.8",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-007"
    },
    {
      "parameter": "MinPotency_Requirement",
      "value": "2.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-008"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "audit": {
    "inputHash": "sha256:<calculated at runtime>",
    "rulesVersion": "<utility executable version>",
    "documentation": "RabiesVaccinePotencyAssayReviewer.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 и утверждёнными процедурами.

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

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

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

Открыть

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

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

Открыть