Holmium166QualityChecker

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

Документ описывает требования и функциональное поведение утилиты Holmium166QualityChecker для контроля: Holmium-166. Утилита предназначена для ОКК/QC и использует детерминированные правила, а не машинное обучение.

2. Режимы запуска

• Holmium166QualityChecker.exe — демонстрационный режим или справка.
• Holmium166QualityChecker.exe input.csv output.json — обработка пользовательских данных и запись результата.

3. Ключевые предметные ограничения

• Holmium-166 Quality Checker — Радиофармпрепарат (SIRT/Therapy) (Ph. Eur., USP)
• ℹ️ Утилита проверяет размер частиц, РХЧ, свободные ионы, стерильность, эндотоксины.
• ⚠️ КРИТИЧНО! Размер частиц 20-50 мкм. Свободные ионы ≤5%. Эндотоксины ≤20 ЕС/мл!
• BatchNumber,Formulation_Type,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_mg,Particle_Size_Mean_um,Particle_Size_Min_um,Particle_Size_Max_um,Particles_Out_of_Range_Percent,Free_Holmium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
• HO166-MS-2026-001,Microspheres,99.9,98.5,1500.0,35.0,20.0,50.0,2.0,1.0,5.0,6.5,0,10.0,0,0,0,0,0
• • Размер частиц: Для микросфер критически важен диапазон 20–50 мкм. Частицы <20 мкм могут проходить через капилляры в легкие (шунтирование), вызывая радиационный пневмонит. Частицы >50 мкм могут закупоривать крупные сосуды.
• • Радиохимическая чистота: Свободный $^{166}\text{Ho}^{3+}$ является остеотропным (накапливается в костях), что приводит к токсичности для костного мозга. РХЧ должна быть ≥95%.
• • Стерильность и эндотоксины: Препарат вводится внутриартериально. Требования строгие.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Радионуклидная чистота: ≥ 99.0%
• • Радиохимическая чистота: ≥ 95.0%
• • Свободные ионы Гольмия: ≤ 5.0%
• • Частицы вне диапазона: ≤ 5.0%
• • pH: 4.0–8.0
• • Эндотоксины: ≤ 20.0 EU/mL (или согласно инструкции)
• ⚠️ Особенность: Утилита фокусируется на специфических параметрах микросфер для SIRT: размере частиц и отсутствии свободных ионов. Отклонение в размере частиц является критическим дефектом, ведущим к серьезным осложнениям (пневмонит, эмболия).

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

5. Контракт input.csv

BatchNumber,Formulation_Type,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_MBq_mg,Particle_Size_Mean_um,Particle_Size_Min_um,Particle_Size_Max_um,Particles_Out_of_Range_Percent,Free_Holmium_Ion_Percent,Target_Material_Residue_ppm,pH_Value,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
HO166-MS-2026-001,Microspheres,99.9,98.5,1500.0,35.0,20.0,50.0,2.0,1.0,5.0,6.5,0,10.0,0,0,0,0,0

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

7. Пример output.json

{
  "utilityId": "holmium166-quality-checker",
  "api": "Holmium-166",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "HO166-MS-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Formulation_Type",
      "value": "Microspheres",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radionuclidic_Purity_Percent",
      "value": "99.9",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Radiochemical_Purity_Percent",
      "value": "98.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Specific_Activity_MBq_mg",
      "value": "1500.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Particle_Size_Mean_um",
      "value": "35.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Particle_Size_Min_um",
      "value": "20.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Particle_Size_Max_um",
      "value": "50.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": []
}

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

9. QA/QC и change control

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