AAS_Heavy_Metals_Plant_Material

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

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

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

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

• • Свинец (Pb) ≤5.0 ppm
• • Кадмий (Cd) ≤0.3 ppm
• • Мышьяк (As) ≤2.0 ppm
• • Ртуть (Hg) ≤0.1 ppm
• ⚠️ КРИТИЧНО: Растения аккумулируют тяжелые металлы из почвы и воды.
• AAS_Heavy_Metals_Plant_Material.exe input.csv output.json → оценка ваших данных
• Формат input.csv:
• BatchNumber,PlantName,LeadPPM,CadmiumPPM,ArsenicPPM,MercuryPPM
• • Загрязнения почвы промышленными выбросами или удобрениями (фосфаты часто содержат Cd).
• • Использования пестицидов и фунгицидов в прошлом (содержащих As, Pb, Hg).
• • Природного геохимического фона региона выращивания.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Кадмий (Cd): Имеет очень низкий предел (0.3 ppm), так как легко всасывается и накапливается в почках, вызывая нефротоксичность.
• • Свинец (Pb): Нейротоксин, особенно опасен для детей и беременных.
• • Мышьяк (As) и Ртуть (Hg): Высокотоксичны даже в следовых количествах.
• • Анализ проводится после полного минерализации образца (озоление/кислотное разложение).

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

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

Контракт input.csv

BatchNumber,PlantName,LeadPPM,CadmiumPPM,ArsenicPPM,MercuryPPM
HERB-2026-001,Ginkgo Biloba Leaf,2.5,0.1,0.5,0.02
HERB-FAIL-002,Echinacea Root,6.0,0.4,1.5,0.05

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

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

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

{
  "utilityId": "aas-heavy-metals-plant-material",
  "utilityName": "AAS_Heavy_Metals_Plant_Material",
  "object": "AAS Heavy Metals Plant Material",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 2,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "HERB-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "PlantName",
      "value": "Ginkgo Biloba Leaf",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "LeadPPM",
      "value": "2.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "CadmiumPPM",
      "value": "0.1",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "ArsenicPPM",
      "value": "0.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "MercuryPPM",
      "value": "0.02",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "AAS_Heavy_Metals_Plant_Material.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 и регрессионные тесты.