AAS_Microelements_Supplements

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

Документ описывает контролируемый интерфейс, требования пользователя и функциональное поведение утилиты AAS_Microelements_Supplements. Назначение: автоматизированная проверка лабораторных, фармакопейных, аналитических или производственных QC-параметров на основе данных input.csv с формированием структурированного результата output.json.

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

• • Допуск 90-110% — стандартное требование для лекарственных форм и качественных БАД.
• • Железо может мешать определению других элементов при неправильном выборе длины волны или наличии спектральных наложений.
• • Селен требует особой осторожности при пробоподготовке из-за летучести некоторых его соединений.
• • Обязательна полная минерализация образца (кислотное разложение) перед анализом.
• • Мультиэлементный анализ (5 ключевых микроэлементов).
• • Проверка соответствия заявленному составу (Label Claim).
• • Поддержка различных режимов атомизации (пламя/печь).
• • Zinc: 90-110% LC
• • Copper: 90-110% LC
• • Iron: 90-110% LC
• • Manganese: 90-110% LC
• • Selenium: 90-110% LC

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

Контракт input.csv

BatchNumber,Zn_mg,Cu_mg,Fe_mg,Mn_mg,Se_mcg
SUPP-MULTI-2026-001,10.5,1.0,18.0,2.3,55.0
SUPP-MULTI-2026-002,10.0,0.95,17.5,2.2,53.0
SUPP-FAIL-LOW-003,8.0,0.5,15.0,1.8,40.0

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

Пример output.json

{
  "utilityId": "aas-microelements-supplements",
  "utilityName": "AAS_Microelements_Supplements",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "SUPP-MULTI-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Zn_mg",
      "value": "10.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Cu_mg",
      "value": "1.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Fe_mg",
      "value": "18.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Mn_mg",
      "value": "2.3",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Se_mcg",
      "value": "55.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "generatedFor": "QA/QC review and LIMS integration"
}

Матрица трассируемости

OQ/PQ тестовые сценарии

QA/QC и change control

• Не менять имена колонок без обновления валидатора, документации и тестового набора.
• Хранить input.csv, output.json, версию исполняемого файла, документацию и checksum.
• Перед продуктивным использованием провести IQ/OQ/PQ или эквивалентную CSV/CSA-проверку.
• Критические пределы должны быть сверены с утверждённой спецификацией, локальными SOP и регистрационным досье.