NIR_API_Content_Checker

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

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

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

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

• ℹ️ Утилита проверяет критические параметры количественного NIR-анализа:
• • Предсказанное содержание АФИ (Assay): 95.0–105.0%
• • Расстояние до модели (Mahalanobis Distance / H-statistic): ≤3.0
• • Влажность (Moisture): ≤2.0%
• ⚠️ КРИТИЧНО: Расстояние до модели >3.0 → образец является "аутлайером"!
• NIR_API_Content_Checker.exe input.csv output.json → оценка ваших данных
• Формат input.csv:
• BatchNumber,PredictedContentPercent,ModelDistance,MoisturePercent,BulkDensity
• • Позволяет измерять содержание АФИ в порошках и таблетках за секунды.
• • Основана на калибровочных моделях (PLS — проекция на латентные структуры).
• • Критически важно проверять не только предсказанное значение, но и статистическую пригодность спектра.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Предсказанное содержание 95–105% — стандартный диапазон для фармацевтических субстанций.
• • Mahalanobis Distance (H-stat) ≤3.0 — гарантирует, что физико-химические свойства образца (размер частиц, плотность, влажность) соответствуют калибровочному набору.
• • Если H-stat > 3.0, образец физически отличается (например, слишком крупный помол), и модель дает ошибку.
• • Влажность сильно влияет на спектр NIR (полосы поглощения воды), поэтому контролируется одновременно.

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

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

Контракт input.csv

BatchNumber,PredictedContent%,ModelDistance,Moisture%,BulkDensity
API-NIR-2026-001,99.5,1.2,0.8,0.65
API-NIR-2026-002,98.0,2.5,1.1,0.64
API-FAIL-OUTLIER,99.0,4.5,0.9,0.70

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

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

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

{
  "utilityId": "nir-api-content-checker",
  "utilityName": "NIR_API_Content_Checker",
  "object": "NIR API Content Checker",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 4,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "API-NIR-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "PredictedContent%",
      "value": "99.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "ModelDistance",
      "value": "1.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "Moisture%",
      "value": "0.8",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "BulkDensity",
      "value": "0.65",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "NIR_API_Content_Checker.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 и регрессионные тесты.