Excipient_Incoming_QC_Library

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

Документ описывает контролируемый интерфейс, требования пользователя и функциональное поведение утилиты Excipient_Incoming_QC_Library. Назначение: автоматизированная проверка лабораторных, фармакопейных, аналитических или производственных QC-параметров на основе данных input.csv с формированием структурированного результата output.json.

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

• • HQI ≥0.95 — стандартный порог для уверенной идентификации чистых веществ.
• • Строгое совпадение имен (Expected == Matched) исключает риск ошибки оператора при выборе метода.
• • Контроль разницы со вторым лучшим совпадением (Specificity Delta) гарантирует, что спектр уникален и не похож на другое вещество из библиотеки.
• • Для гигроскопичных веществ (МКЦ, повидон) важно учитывать влияние влаги на спектр или использовать БИК с соответствующими моделями.
• • Автоматическая проверка соответствия спектра эталону из библиотеки.
• • Контроль специфичности идентификации.
• • Интеграция с системами складского учета и LIMS.
• • Correlation Index (HQI): >= 0.95
• • Name Match: True
• • Specificity Delta: > 0.05
• • Индекс качества совпадения (HQI / Correlation): ≥0.95

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

Контракт input.csv

BatchNumber,ExpectedMaterial,HQI,MatchedMaterial,SecondBestHQI
EXC-LAC-2026-001,Lactose_Monohydrate,0.992,Lactose_Monohydrate,0.850
EXC-MCC-2026-001,Microcrystalline_Cellulose,0.985,Microcrystalline_Cellulose,0.720
EXC-FAIL-2026-001,Lactose_Monohydrate,0.850,Starch_Potato,0.840

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

Пример output.json

{
  "utilityId": "excipient-incoming-qc-library",
  "utilityName": "Excipient_Incoming_QC_Library",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "EXC-LAC-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "ExpectedMaterial",
      "value": "Lactose_Monohydrate",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "HQI",
      "value": "0.992",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "MatchedMaterial",
      "value": "Lactose_Monohydrate",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "SecondBestHQI",
      "value": "0.850",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "generatedFor": "QA/QC review and LIMS integration"
}

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

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

QA/QC и change control

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