InfraLUM_ID_Ciprofloxacin

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

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

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

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

• • Коэффициент корреляции с эталонным спектром: ≥0.995
• • Пик 3050 см⁻¹ (ароматический C-H валентные колебания): ±15 см⁻¹
• • Пик 1715 см⁻¹ (C=O карбоксильной группы): ±10 см⁻¹ — МАРКЕР КИСЛОТНОЙ ФОРМЫ
• • Пик 1620 см⁻¹ (C=O хинолонового кольца + C=C): ±10 см⁻¹
• • Пик 1500 см⁻¹ (ароматический C=C скелетные колебания): ±10 см⁻¹
• • Пик 1270 см⁻¹ (C-F валентные колебания): ±10 см⁻¹ — МАРКЕР ФТОРХИНОЛОНА
• • Шум базовой линии: ≤0.005 Abs
• ⚠️ ВАЖНО: Данная утилита предназначена исключительно для КИСЛОТНОЙ формы ципрофлоксацина.
• • Пик 1715 см⁻¹ (COOH) отсутствует или значительно смещён (карбоксилат-анион ~1580 см⁻¹).
• • Появляются широкие полосы NH₂⁺/NH⁺ в области 2400–3000 см⁻¹.
• InfraLUM_ID_Ciprofloxacin.exe input.csv output.json → оценка ваших данных
• Формат input.csv:
• BatchNumber,CorrelationCoefficient,Peak3050_cm1,Peak1715_cm1,Peak1620_cm1,Peak1500_cm1,Peak1270_cm1,BaselineNoiseAbs,PreparationMethod
• • Структура содержит хинолоновое ядро, карбоксильную группу, фтор, пиперазиновый цикл и циклопропильный заместитель.
• • Атом фтора при C-6 — ключевой структурный элемент, определяющий принадлежность к фторхинолонам.
• • Карбоксильная группа при C-3 необходима для связывания с бактериальной ДНК-гиразой.

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

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

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

Контракт input.csv

BatchNumber,CorrelationCoefficient,Peak3050_cm1,Peak1715_cm1,Peak1620_cm1,Peak1500_cm1,Peak1270_cm1,BaselineNoiseAbs,PreparationMethod
CIP-ID-2026-091,0.9992,3048.0,1716.0,1618.0,1502.0,1268.0,0.0016,KBr
CIP-ID-2026-092,0.9935,3062.0,1705.0,1632.0,1488.0,1285.0,0.006,KBr

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

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

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

{
  "utilityId": "infralum-id-ciprofloxacin",
  "utilityName": "InfraLUM_ID_Ciprofloxacin",
  "object": "InfraLUM ID Ciprofloxacin",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 2,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "CIP-ID-2026-091",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "CorrelationCoefficient",
      "value": "0.9992",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "Peak3050_cm1",
      "value": "3048.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "Peak1715_cm1",
      "value": "1716.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "Peak1620_cm1",
      "value": "1618.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "Peak1500_cm1",
      "value": "1502.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    },
    {
      "parameter": "Peak1270_cm1",
      "value": "1268.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-007"
    },
    {
      "parameter": "BaselineNoiseAbs",
      "value": "0.0016",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-008"
    },
    {
      "parameter": "PreparationMethod",
      "value": "KBr",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-009"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "InfraLUM_ID_Ciprofloxacin.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 и регрессионные тесты.