ELISAAssayPlateAcceptanceChecker

ELISA Assay Plate Acceptance

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

Описание утилиты: ELISA Assay Plate Acceptance

ELISA Assay Plate Acceptance Checker — Проверка приемлемости планшета ELISA

ℹ️  Утилита выполняет автоматическую проверку критериев системной пригодности (System Suitability) для иммуноферментного анализа (ELISA) согласно руководствам FDA/EMA и внутренним SOP:
     • Линейность стандартной кривой: Оценка коэффициента детерминации (R²).
     • Контроль фона: Проверка оптической плотности (OD) бланка на отсутствие неспецифического связывания.
     • Контроли эффективности: Проверка попадания OD положительных и отрицательных контролей в установленные диапазоны.
     • Прецизионность: Оценка коэффициента вариации (CV) для реплик стандартов и контролей.

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

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

Формат input.csv:
PlateID,AssayName,StdCurve_R2,StdCurve_Slope,Blank_OD,MaxBlank_OD_Limit,PosControl_OD,MinPosControl_OD,NegControl_OD,MaxNegControl_OD,CV_Replicates_Percent

Пример:
  PLT-001,HepB Ag,0.998,1.2,0.05,0.1,1.5,1.0,0.08,0.15,5.2

📍 Область применения (Usage Where):
     • Валидация аналитических серий: Автоматический скрининг планшетов перед обработкой данных.
     • Лабораторный контроль качества (QC): Ежедневная проверка работы ридеров и реагентов.
     • Расследование OOS: Исключение технических ошибок анализа как причины отклонения.
     • Интеграция с LIMS: Автоматическая загрузка статусов "Accepted/Rejected" в систему.

— ЗАЧЕМ ЭТО НУЖНО?
Ручная проверка каждого параметра системной пригодности трудоемка и подвержена человеческому фактору.
Автоматизация этого процесса гарантирует, что ни один невалидный планшет не будет использован для расчета результатов пациентов или контроля качества продукции.
Это критически важно для соблюдения принципов GLP/GMP в диагностике и контроле биофармацевтики.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• R² Стандартной кривой: Обычно требуется ≥ 0.99. Низкое значение указывает на ошибки разведения или деградацию стандарта.
• Blank OD: Высокий фон снижает чувствительность метода и может указывать на загрязнение планшета или реагентов.
• Положительный контроль: Должен демонстрировать сильный сигнал, подтверждая активность конъюгата и субстрата.
• CV Реплик: Значение >15-20% указывает на плохую технику пипетирования или наличие пузырьков в лунках.

Ключевые особенности утилиты:
• Комплексная проверка всех параметров системной пригодности
• Мгновенное принятие решения Accepted/Rejected
• Детализированный отчет о причинах отклонения
• Генерация JSON для интеграции с лабораторными системами
• Соответствие требованиям валидации аналитических методов

Критические параметры:
• R²: ≥ 0.99
• Blank OD: ≤ Спецификации
• Pos/Neg Controls: В установленных пределах
• CV: ≤ 15%

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

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

input.csv

PlateID,AssayName,StdCurve_R2,StdCurve_Slope,Blank_OD,MaxBlank_OD_Limit,PosControl_OD,MinPosControl_OD,NegControl_OD,MaxNegControl_OD,CV_Replicates_Percent
PLT-2026-001,Hepatitis B Surface Ag,0.9985,1.25,0.045,0.100,1.520,1.000,0.080,0.150,4.5
PLT-2026-002,HIV Combo,0.9990,1.10,0.030,0.100,2.100,1.500,0.050,0.100,3.8
PLT-2026-FAIL-003,HCV Ab,0.9850,0.90,0.120,0.100,0.800,1.000,0.060,0.150,18.5

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

Документ описывает контролируемый интерфейс и поведение утилиты ELISAAssayPlateAcceptanceChecker для сценария ELISA Assay Plate Acceptance Checker.

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

Ниже приведены ключевые фрагменты исходного описания. Перед продуктивным применением пределы должны быть сверены с утверждённой спецификацией, регистрационным досье и локальными SOP.
  • ℹ️ Утилита выполняет автоматическую проверку критериев системной пригодности (System Suitability) для иммуноферментного анализа (ELISA) согласно руководствам FDA/EMA и внутренним SOP:
  • ⚠️ ВАЖНО:
  • • Строгое соблюдение критериев приемлемости планшета обязательно перед расчетом концентраций образцов.
  • PlateID,AssayName,StdCurve_R2,StdCurve_Slope,Blank_OD,MaxBlank_OD_Limit,PosControl_OD,MinPosControl_OD,NegControl_OD,MaxNegControl_OD,CV_Replicates_Percent
  • Это критически важно для соблюдения принципов GLP/GMP в диагностике и контроле биофармацевтики.
  • ⚠️ КРИТИЧЕСКИ ВАЖНО:
  • • R² Стандартной кривой: Обычно требуется ≥ 0.99. Низкое значение указывает на ошибки разведения или деградацию стандарта.
  • • CV Реплик: Значение >15-20% указывает на плохую технику пипетирования или наличие пузырьков в лунках.
  • Критические параметры:
  • • R²: ≥ 0.99
  • • Blank OD: ≤ Спецификации
  • • Pos/Neg Controls: В установленных пределах
  • • CV: ≤ 15%
  • 2. Промывка: Качество промывки планшетов критично для уровня фона и CV.

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

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

#ПолеТипПримерНазначение
1PlateIDstring / controlled vocabularyPLT-2026-001Контролируемый входной параметр для детерминированных QC-правил.
2AssayNamestring / controlled vocabularyHepatitis B Surface AgКонтролируемый входной параметр для детерминированных QC-правил.
3StdCurve_R2decimal0.9985Контролируемый входной параметр для детерминированных QC-правил.
4StdCurve_Slopedecimal1.25Контролируемый входной параметр для детерминированных QC-правил.
5Blank_ODdecimal0.045Контролируемый входной параметр для детерминированных QC-правил.
6MaxBlank_OD_Limitdecimal0.100Утверждённый предел, применяемый при проверке результата.
7PosControl_ODstring / controlled vocabulary1.520Контрольная точка/контрольный образец для валидности серии анализа.
8MinPosControl_ODstring / controlled vocabulary1.000Контрольная точка/контрольный образец для валидности серии анализа.
9NegControl_ODstring / controlled vocabulary0.080Контрольная точка/контрольный образец для валидности серии анализа.
10MaxNegControl_ODstring / controlled vocabulary0.150Контрольная точка/контрольный образец для валидности серии анализа.
11CV_Replicates_Percentinteger / decimal4.5Контролируемый входной параметр для детерминированных QC-правил.
PlateID,AssayName,StdCurve_R2,StdCurve_Slope,Blank_OD,MaxBlank_OD_Limit,PosControl_OD,MinPosControl_OD,NegControl_OD,MaxNegControl_OD,CV_Replicates_Percent
PLT-2026-001,Hepatitis B Surface Ag,0.9985,1.25,0.045,0.100,1.520,1.000,0.080,0.150,4.5
PLT-2026-002,HIV Combo,0.9990,1.10,0.030,0.100,2.100,1.500,0.050,0.100,3.8
PLT-2026-FAIL-003,HCV Ab,0.9850,0.90,0.120,0.100,0.800,1.000,0.060,0.150,18.5

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

IDПолеПравилоКритичность
VR-001PlateIDПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-002AssayNameПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-003StdCurve_R2Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.High
VR-004StdCurve_SlopeПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-005Blank_ODПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-006MaxBlank_OD_LimitПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-007PosControl_ODПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-008MinPosControl_ODПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-009NegControl_ODПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-010MaxNegControl_ODПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.Medium
VR-011CV_Replicates_PercentПоле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.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Применить правила для ELISA Assay Plate Acceptance 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": "elisaassayplateacceptancechecker",
  "utilityFolder": "ELISAAssayPlateAcceptanceChecker",
  "package": "Vet",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "processedAtUtc": "2026-06-10T00:00:00Z",
  "checks": [
    {
      "parameter": "PlateID",
      "value": "PLT-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-001"
    },
    {
      "parameter": "AssayName",
      "value": "Hepatitis B Surface Ag",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-002"
    },
    {
      "parameter": "StdCurve_R2",
      "value": "0.9985",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-003"
    },
    {
      "parameter": "StdCurve_Slope",
      "value": "1.25",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-004"
    },
    {
      "parameter": "Blank_OD",
      "value": "0.045",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-005"
    },
    {
      "parameter": "MaxBlank_OD_Limit",
      "value": "0.100",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-006"
    },
    {
      "parameter": "PosControl_OD",
      "value": "1.520",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-007"
    },
    {
      "parameter": "MinPosControl_OD",
      "value": "1.000",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-008"
    },
    {
      "parameter": "NegControl_OD",
      "value": "0.080",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-009"
    },
    {
      "parameter": "MaxNegControl_OD",
      "value": "0.150",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-010"
    },
    {
      "parameter": "CV_Replicates_Percent",
      "value": "4.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-011"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "audit": {
    "inputHash": "sha256:<calculated at runtime>",
    "rulesVersion": "<utility executable version>",
    "documentation": "ELISAAssayPlateAcceptanceChecker.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-утилит для иммунологии: моноклональные антитела, биоаналоги, иммуномодуляторы, иммуносупрессанты, ELISA/SPR, HCP, белковая характеристика, стерильность и pyrogen/release checks.

Открыть

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

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

Открыть