RanitidineImpurityChecker

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

Документ описывает контролируемый интерфейс, валидационное поведение и ожидаемые результаты утилиты RanitidineImpurityChecker. Документ предназначен для включения в папку утилиты рядом с input.csv и файлом описания. Предполагаемый исполняемый файл: RanitidineImpurityChecker.exe.

Область применения

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

• ℹ️ Утилита проверяет критические параметры качества и безопасности ранитидина:
• • Содержание основного вещества (Assay): 98.0–102.0%
• • NDMA (N-нитрозодиметиламин): ≤0.32 ppm (соответствует 96 нг/сутки)
• • N-нитрозоранидин: ≤1.0 ppm
• • Сумма прочих родственных примесей: ≤1.0%
• • Потеря в массе при высушивании (LOD): ≤0.75%
• ⚠️ КРИТИЧНО: NDMA >0.32 ppm → КАТЕГОРИЧЕСКИЙ ЗАПРЕТ на использование!
• RanitidineImpurityChecker.exe input.csv output.json → оценка ваших данных
• Формат input.csv:
• BatchNumber,AssayPercent,NDMAPPM,NitrosoRanitidinePPM,OtherImpuritiesPercent,LossOnDryingPercent
• • В 2019-2020 гг. был отозван с мировых рынков из-за обнаружения NDMA.
• • Молекула ранитидина нестабильна и может самопроизвольно образовывать NDMA, особенно при повышении температуры и влажности.
• • NDMA образуется в результате внутримолекулярной реакции диметиламинной группы и нитрит-иона (или окисления).
• • Контроль NDMA является обязательным требованием регуляторов (FDA, EMA) для любых остаточных запасов или новых синтезов.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • NDMA ≤0.32 ppm (для дозы 150 мг) — строжайший лимит, основанный на допустимом суточном потреблении (AI) 96 нг.

Фармакопейные и нормативные ссылки, найденные в описании

Производственный поток данных

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

Контракт input.csv

BatchNumber,Assay%,NDMA_ppm,NitrosoRan_ppm,OtherImp%,LOD%
RAN-HCL-2026-001,99.5,0.10,0.5,0.3,0.4
RAN-HCL-2026-002,99.1,0.25,0.8,0.4,0.5
RAN-FAIL-NDMA,98.5,1.50,2.0,0.5,0.6

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

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

Пример структуры output.json

{
  "utilityId": "ranitidineimpuritychecker",
  "utilityName": "RanitidineImpurityChecker",
  "object": "Ranitidine Impurity Checker",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 3,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "RAN-HCL-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "Assay%",
      "value": "99.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "NDMA_ppm",
      "value": "0.10",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "NitrosoRan_ppm",
      "value": "0.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "OtherImp%",
      "value": "0.3",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "LOD%",
      "value": "0.4",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "RanitidineImpurityChecker.documentation.html"
  }
}

Матрица трассировки URS → FS → OQ/PQ

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

QA/QC, CSV/CSA и change control

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