Polymorph_Screening_NIR_FTIR

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

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

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

• • Корреляция с эталонным спектром формы: ≥0.99
• • Специфичность (разница с ближайшей формой): >0.05
• • Наличие и положение ключевых спектральных пиков
• • Разные полиморфы имеют разные физико-химические свойства (растворимость, температура плавления, стабильность).
• • Регуляторы (FDA, EMA) требуют строгого контроля полиморфной чистоты, так как это критический атрибут качества (CQA).
• • ИК-спектроскопия (FTIR) и ближняя инфракрасная спектроскопия (NIR) являются быстрыми и неразрушающими методами идентификации форм.
• • Приборы Lumex InfraLUM позволяют проводить экспресс-анализ сырья и готовых форм.
• • Корреляция ≥0.99 гарантирует высокое сходство с референсным стандартом формы.
• • Разница с ближайшей формой (Specificity Delta) должна быть достаточной, чтобы исключить ложную идентификацию.
• • Аморфная фаза часто имеет более широкие и менее интенсивные пики, что снижает корреляцию с кристаллическим эталоном.
• • Для количественной оценки содержания примесной формы требуется калибровочная модель (PLS/PCR), а не только качественный скрининг.
• • Быстрый скрининг полиморфной чистоты.
• • Оценка специфичности идентификации.
• • Поддержка данных FTIR и NIR спектрометров.
• • Correlation to Expected Form: >= 0.99
• • Specificity Delta: > 0.05

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

Контракт input.csv

BatchNumber,ExpectedForm,CorrExpected,CorrNeighbor,KeyPeakPos,KeyPeakInt
API-POLY-2026-001,Form_I,0.998,0.850,1650.0,0.8
API-POLY-2026-002,Form_II,0.995,0.920,1665.0,0.75
API-FAIL-MIX-003,Form_I,0.950,0.940,1650.0,0.6

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

Пример output.json

{
  "utilityId": "polymorph-screening-nir-ftir",
  "utilityName": "Polymorph_Screening_NIR_FTIR",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "API-POLY-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "ExpectedForm",
      "value": "Form_I",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "CorrExpected",
      "value": "0.998",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "CorrNeighbor",
      "value": "0.850",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "KeyPeakPos",
      "value": "1650.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "KeyPeakInt",
      "value": "0.8",
      "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 и регистрационным досье.