LevofloxacinOpticalIsomerChecker

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

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

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

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

• ℹ️ Утилита проверяет критические параметры хиральной чистоты левофлоксацина:
• • Содержание активного S-(-)-изомера (≥99.0%)
• • Примесь неактивного R-(+)-изомера (D-изомер) (≤0.5%)
• • Общая оптическая чистота (≥99.0%)
• • Удельное вращение (от -90° до -105°)
• ⚠️ КРИТИЧНО: Примесь R-изомера >0.5% → снижение эффективности терапии!
• LevofloxacinOpticalIsomerChecker.exe input.csv output.json → оценка ваших данных
• Формат input.csv:
• BatchNumber,LevofloxacinPercent,DIsomerPercent,OpticalPurityPercent,SpecificRotation
• • S-изомер в 8–128 раз активнее R-изомера против различных бактерий.
• • R-изомер практически не обладает антибактериальной активностью, но может contribute to toxicity.
• • Фармакопеи (Ph. Eur., USP, ГФ РФ) требуют строгого контроля энантиомерной чистоты.
• • Метод контроля: Хиральная ВЭЖХ (Chiral HPLC) или поляриметрия.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Содержание S-изомера ≥99.0% — гарантия высокой терапевтической активности.
• • Примесь R-изомера ≤0.5% — критический параметр качества синтеза и очистки.

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

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

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

Контракт input.csv

BatchNumber,LevoPercent%,DIsomer%,OpticalPurity%,SpecificRotation
LEVO-2026-001,99.8,0.1,99.7,-98.5
LEVO-2026-002,99.5,0.3,99.2,-95.0
LEVO-FAIL-003,98.0,1.5,96.5,-85.0

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

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

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

{
  "utilityId": "levofloxacinopticalisomerchecker",
  "utilityName": "LevofloxacinOpticalIsomerChecker",
  "object": "Levofloxacin Optical Isomer Checker",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 3,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "LEVO-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "LevoPercent%",
      "value": "99.8",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "DIsomer%",
      "value": "0.1",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "OpticalPurity%",
      "value": "99.7",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "SpecificRotation",
      "value": "-98.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "LevofloxacinOpticalIsomerChecker.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 и регрессионные тесты.