AssayImpuritiesResultReviewer

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

Документ описывает контролируемый интерфейс и поведение утилиты AssayImpuritiesResultReviewer для сценария Assay & Impurities Result Reviewer.

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

• ℹ️ Утилита проверяет результаты хроматографического анализа (ВЭЖХ/ГХ) активных фармацевтических субстанций и готовых препаратов на соответствие требованиям ICH Q3A (для АФС), ICH Q3B (для готовых форм) и частным фармакопейным статьям:
• • Единичная примесь (Single Impurity): Максимальное количество любой известной или неизвестной примеси.
• • Неустановленные примеси (Unspecified): Примеси, для которых нет стандарта и предела в монографии.
• ⚠️ КРИТИЧНО:
• BatchNumber,ProductName,Assay_Percent,SingleImpurity_Max_Percent,TotalImpurities_Percent,UnspecifiedImpurity_Max_Percent,PeaksAboveReportingThreshold,ReportingThreshold_Percent
• ICH Q3A/B устанавливают строгие пороги в зависимости от суточной дозы препарата.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Автоматическая проверка лимитов по ICH Q3A/B
• • Соответствие требованиям GMP и Фармакопей
• Критические параметры:
• • Единичная примесь: ≤ 0.10% (типично)
• • Сумма примесей: ≤ 0.50% (типично)
• • Неустановленная примесь: ≤ 0.10%
• 3. Стандарты: Для количественного определения примесей используйте соответствующие стандарты или коэффициенты поправки.
• 5. Генотоксичность: Особое внимание уделяйте примесям, которые могут быть генотоксичными (ICH M7).

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

Контракт input.csv

BatchNumber,ProductName,Assay_Percent,SingleImpurity_Max_Percent,TotalImpurities_Percent,UnspecifiedImpurity_Max_Percent,PeaksAboveReportingThreshold,ReportingThreshold_Percent
API-2026-HPLC-001,Paracetamol API,99.8,0.05,0.12,0.03,3,0.05
API-2026-HPLC-002,Ibuprofen API,99.5,0.08,0.25,0.04,5,0.05
API-2026-FAIL-003,Amoxicillin Trihydrate,97.5,0.15,0.80,0.12,8,0.05

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

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

Пример output.json

{
  "utilityId": "assayimpuritiesresultreviewer",
  "utilityFolder": "AssayImpuritiesResultReviewer",
  "package": "Vet",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "processedAtUtc": "2026-06-10T00:00:00Z",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "API-2026-HPLC-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-001"
    },
    {
      "parameter": "ProductName",
      "value": "Paracetamol API",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-002"
    },
    {
      "parameter": "Assay_Percent",
      "value": "99.8",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-003"
    },
    {
      "parameter": "SingleImpurity_Max_Percent",
      "value": "0.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-004"
    },
    {
      "parameter": "TotalImpurities_Percent",
      "value": "0.12",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-005"
    },
    {
      "parameter": "UnspecifiedImpurity_Max_Percent",
      "value": "0.03",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-006"
    },
    {
      "parameter": "PeaksAboveReportingThreshold",
      "value": "3",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-007"
    },
    {
      "parameter": "ReportingThreshold_Percent",
      "value": "0.05",
      "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": "AssayImpuritiesResultReviewer.documentation.html"
  }
}

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

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

QA/QC и change control

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