Copper64QualityChecker

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

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

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

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

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

• Copper-64 Quality Checker — Радиофармпрепарат (Ph. Eur., USP)
• ℹ️ Утилита проверяет радиохимическую чистоту, удельную активность, Ni/Zn примеси, стерильность, эндотоксины.
• ⚠️ КРИТИЧНО! РХЧ ≥95%. Удельная активность ≥10 ГБк/мкмоль. Ni ≤5 ppm. Стерильность обязательна!
• BatchNumber,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_GBq_umol,Nickel_Content_ppm,Zinc_Content_ppm,Iron_Content_ppm,Total_Metal_Impurities_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
• • Радиохимическая чистота (РХЧ): Критически важна. Свободная медь ($^{64}\text{Cu}^{2+}$) накапливается в печени и почках, создавая фон и токсичность. РХЧ должна быть ≥95%.
• • Химические примеси (Ni, Zn): Никель (мишень для производства) и Цинк (продукт распада) конкурируют с медью за хелатор (DOTA, NOTA, SAR). Их содержание должно быть минимальным (Ni ≤5 ppm).
• • Стерильность и эндотоксины: Препарат вводится внутривенно. Требования строгие.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Радионуклидная чистота: ≥ 99.0%
• • Радиохимическая чистота: ≥ 95.0%
• • Удельная активность: ≥ 10.0 ГБк/мкмоль (зависит от лиганда)
• • Никель: ≤ 5.0 ppm
• • Цинк: ≤ 10.0 ppm
• • Железо: ≤ 5.0 ppm
• • pH: 4.5–7.5
• • Эндотоксины: ≤ 17.5 EU/mL (или согласно дозе)
• ⚠️ Особенность: Утилита адаптирована под специфику радиофармпрепаратов: контроль конкурентов хелатирования (Ni, Zn) и удельной активности. Время анализа ограничено периодом полураспада (12.7 ч).

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

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

BatchNumber,Radionuclidic_Purity_Percent,Radiochemical_Purity_Percent,Specific_Activity_GBq_umol,Nickel_Content_ppm,Zinc_Content_ppm,Iron_Content_ppm,Total_Metal_Impurities_ppm,pH_Value,Ethanol_Content_Percent,SterilityTest,Bacterial_Endotoxins_EU_per_mL,Appearance_Score,Microbial_Count_TAMC,Microbial_Count_TYMC,EColi_Detected,Salmonella_Detected
CU64-RAD-2026-001,99.9,98.5,50.0,1.5,2.0,0.5,4.0,6.5,5.0,0,5.0,0,0,0,0,0

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

7. Пример output.json

{
  "utilityId": "copper64-quality-checker",
  "api": "Copper-64",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "CU64-RAD-2026-001",
      "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_GBq_umol",
      "value": "50.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Nickel_Content_ppm",
      "value": "1.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Zinc_Content_ppm",
      "value": "2.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Iron_Content_ppm",
      "value": "0.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Total_Metal_Impurities_ppm",
      "value": "4.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.