Iodine131HippuranQualityChecker

URS & FS — User Requirements and Functional Specification

This document describes the controlled interface and behaviour of Iodine131HippuranQualityChecker for Iodine-131 Hippuran.

Domain limits and critical parameters

• BatchNumber,RadiochemicalPurityPercent,FreeIodine131Percent,BenzoicAcidImpurityPercent,SpecificActivityMBqPerMg,pH,EndotoxinsEU,SterilityTest,TotalActivityMBq,AppearanceScore
• ℹ️ Утилита проверяет критические параметры радиофармпрепарата для оценки функции почек:
• • Радиохимическая чистота (≥95%)
• • Примесь свободного Йода-131 (≤3%)
• • Примесь бензойной кислоты (≤2%) — продукт гидролиза!
• ⚠️ КРИТИЧНО: Гиппуран используется для измерения эффективного почечного плазмотока (ЭПФ).
• Примеси свободного йода и бензойной кислоты имеют ДРУГОЙ механизм распределения!
• Свободный йод → щитовидная железа/желудок (ложный фон).
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Радиохимическая чистота ≥95% — гарантия корректности количественных расчетов.
• • Свободный Йод-131 ≤3% — йодид не секретируется канальцами, создает внепочечный фон.
• • Бензойная кислота ≤2% — продукт гидролиза амидной связи гиппурана. Захватывается печенью, искажает кривые активности.

URS — User Requirements Specification

input.csv contract

BatchNumber,RadiochemicalPurityPercent,FreeIodine131Percent,BenzoicAcidImpurityPercent,SpecificActivityMBqPerMg,pH,EndotoxinsEU,SterilityTest,TotalActivityMBq,AppearanceScore
I131-HIP-2026-001,97.5,1.5,1.0,35.0,7.0,45.0,0,185.0,0
I131-HIP-2026-002,93.0,4.0,3.0,28.0,7.2,50.0,0,180.0,0

FS — Functional Specification

Example output.json

{
  "utilityId": "iodine131-hippuran-quality-checker",
  "api": "Iodine-131 Hippuran",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "I131-HIP-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "RadiochemicalPurityPercent",
      "value": "97.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "FreeIodine131Percent",
      "value": "1.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "BenzoicAcidImpurityPercent",
      "value": "1.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "SpecificActivityMBqPerMg",
      "value": "35.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "pH",
      "value": "7.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "EndotoxinsEU",
      "value": "45.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "SterilityTest",
      "value": "0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": []
}

OQ/PQ test scenarios

QA/QC and change control

• Do not rename columns without updating the validator and test set.
• Retain input.csv, output.json, executable version and checksum.
• Before production use, perform IQ/OQ/PQ or equivalent CSV/CSA verification.
• Critical radiopharmaceutical limits must be verified against the approved specification and local SOPs.