Capillary_ID_Galantamine

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

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

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

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

• • Время миграции (сравнение со стандартом)
• • Чистота по площади пика (≥99.0%)
• • Примесь норгалантамина (≤0.5%)
• • Эффективность (≥50000 т.т.) и фактор асимметрии (0.8-1.5)
• ⚠️ КРИТИЧНО: Галантамин — алкалоид с третичным амином.
• Capillary_ID_Galantamine.exe input.csv output.json → оценка ваших данных
• Формат input.csv:
• BatchNumber,MigrationTimeMin,PeakArea,TheoreticalPlates,TailingFactor,PurityPercent,NorgalantaminePercent
• • Идентификация проводится по времени миграции относительно стандартного образца.
• • Норгалантамин (десметил-аналог) является ключевой примесью синтеза и деградации.
• • Высокая эффективность разделения (>50000 теоретических тарелок) позволяет отделять близкие по структуре примеси.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Время миграции должно строго соответствовать стандарту (окно ±0.3 мин).
• • Чистота основного вещества ≥99.0%.
• • Содержание норгалантамина ≤0.5%.
• • Использование кислого буфера (например, фосфатного, pH 2.5-3.0) обязательно для протонирования азота и получения sharp пиков.

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

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

Контракт input.csv

BatchNumber,MigrationTimeMin,PeakArea,TheoreticalPlates,TailingFactor,PurityPercent,NorgalantaminePercent
GAL-HBr-2026-001,6.25,250000,65000,1.05,99.6,0.15
GAL-FAIL-2026-002,6.80,210000,45000,1.8,98.5,0.8

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

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

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

{
  "utilityId": "capillary-id-galantamine",
  "utilityName": "Capillary_ID_Galantamine",
  "object": "Capillary ID Galantamine",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 2,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "GAL-HBr-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "MigrationTimeMin",
      "value": "6.25",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "PeakArea",
      "value": "250000",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "TheoreticalPlates",
      "value": "65000",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "TailingFactor",
      "value": "1.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "PurityPercent",
      "value": "99.6",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    },
    {
      "parameter": "NorgalantaminePercent",
      "value": "0.15",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-007"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "Capillary_ID_Galantamine.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 и регрессионные тесты.