ParacetamolImpurityChecker

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

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

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

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

• ℹ️ Утилита проверяет критические параметры чистоты парацетамола:
• • Содержание основного вещества (Assay): 99.0–101.0%
• • Примесь A (4-аминофенол / 4-Aminophenol): ≤0.005% (50 ppm)
• • Примесь B (4-хлорацетанилид / 4-Chloroacetanilide): ≤0.005% (50 ppm)
• • Примесь C (4'-нитроацетанилид / 4'-Nitroacetanilide): ≤0.005% (50 ppm)
• • Сумма прочих неизвестных примесей: ≤0.1%
• • Потеря в массе при высушивании (LOD): ≤0.5%
• ⚠️ КРИТИЧНО: Примесь A (4-аминофенол) >0.005% → НЕФРОТОКСИЧНОСТЬ!
• ParacetamolImpurityChecker.exe input.csv output.json → оценка ваших данных
• Формат input.csv:
• BatchNumber,AssayPercent,ImpurityAPercent,ImpurityBPercent,ImpurityCPercent,OtherImpuritiesPercent,LossOnDryingPercent
• • Синтез обычно involves ацилирование 4-аминофенола.
• • Примесь A (4-аминофенол) — исходное сырье, высокотоксично для почек (нефротоксично).
• • Примесь B и C — побочные продукты реакций хлорирования и нитрования при синтезе предшественников.
• • Строгий контроль этих примесей требуется всеми фармакопеями (Ph. Eur., USP, ГФ РФ).
• ⚠️ КРИТИЧЕСКИ ВАЖНО:

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

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

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

Контракт input.csv

BatchNumber,Assay%,ImpA%,ImpB%,ImpC%,OtherImp%,LOD%
PAR-2026-001,99.9,0.002,0.001,0.001,0.05,0.2
PAR-2026-002,99.8,0.003,0.002,0.001,0.06,0.3
PAR-FAIL-2026-003,98.5,0.010,0.008,0.005,0.20,0.8

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

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

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

{
  "utilityId": "paracetamolimpuritychecker",
  "utilityName": "ParacetamolImpurityChecker",
  "object": "Paracetamol Impurity Checker",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 3,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "PAR-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "Assay%",
      "value": "99.9",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "ImpA%",
      "value": "0.002",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "ImpB%",
      "value": "0.001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "ImpC%",
      "value": "0.001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "OtherImp%",
      "value": "0.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    },
    {
      "parameter": "LOD%",
      "value": "0.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-007"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "ParacetamolImpurityChecker.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 и регрессионные тесты.