Mercury_Speciation_Methyl_vs_Inorganic

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

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

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

• • Общая ртуть (Total Hg): ≤100 ppb (пример)
• • Метилртуть (Methylmercury): ≤50 ppb (пример)
• • Неорганическая ртуть (Inorganic Hg): ≤50 ppb (пример)
• • Масс-баланс: Разница между суммой форм и общей ртутью ≤15%
• • Метилртуть (MeHg) — высокотоксичная органическая форма, легко проникающая через гематоэнцефалический барьер.
• • Неорганическая ртуть (InorgHg) — менее липофильна, но также токсична для почек.
• • В рыбьем жире и морепродуктах до 90-95% общей ртути может составлять метилртуть.
• • Приборы Lumex RA-915M позволяют определять общую ртуть с высокой чувствительностью. Для специации часто требуется хроматографическое разделение (LC-ICP-MS) или использование специальных кинетических методов/экстракции.
• • Контроль баланса форм validates accuracy of the speciation method.
• • Сумма концентраций отдельных форм (MeHg + InorgHg) должна равняться Общей ртути (в пределах погрешности).
• • Метилртуть является приоритетным загрязнителем в мониторинге пищевых продуктов (Sanitary Rules).
• • Для фармацевтического рыбьего жира важно контролировать обе формы, так как процессы очистки могут по-разному влиять на них.
• • Расчет процентного соотношения форм ртути.
• • Проверка масс-баланса аналитических данных.
• • Поддержка данных от гибридных систем или внешних хроматографов.
• • Total Mercury: <= 100 ppb

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

Контракт input.csv

BatchNumber,TotalHg_ppb,InorganicHg_ppb,MethylHg_ppb
FISH-OIL-SPEC-001,80.0,10.0,70.0
FISH-OIL-SPEC-002,95.0,15.0,80.0
FISH-OIL-FAIL-003,120.0,20.0,100.0

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

Пример output.json

{
  "utilityId": "mercury-speciation-methyl-vs-inorganic",
  "utilityName": "Mercury_Speciation_Methyl_vs_Inorganic",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "FISH-OIL-SPEC-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "TotalHg_ppb",
      "value": "80.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "InorganicHg_ppb",
      "value": "10.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "MethylHg_ppb",
      "value": "70.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 и регистрационным досье.