OncologyCfdnaCgpChecker

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

Документ описывает контролируемый интерфейс и поведение утилиты OncologyCfdnaCgpChecker для сценария Oncology cfDNA CGP Checker.

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

• • cfDNA Yield ≥ 10 ng: Достаточность материала для чувствительного анализа.
• • Hemolysis Index ≤ 50: Гемолиз увеличивает фон gDNA от лейкоцитов.
• • Mean Target Depth ≥ 10,000×: Общая глубина для детекции VAF <0.5%.
• • Unique Molecular Depth ≥ 1,000×: Глубина после UMI-дедупликации — определяет реальную чувствительность.
• • On-Target Rate ≥ 60%: Эффективность обогащения.
• • Uniformity ≥ 80%: Равномерность покрытия целевых регионов.
• • Duplication Rate ≤ 60%: Уровень дупликатов (выше ожидаемого для cfDNA из-за низкой сложности).
• ПОКРЫТИЕ КРИТИЧЕСКИХ ГЕНОВ (12/12 ОБЯЗАТЕЛЬНЫ):
• • TMB: Оценка для пембролизумаба в определенных типах опухолей.
• • LOD SNV ≤ 0.1%, Indel ≤ 0.2%, Fusion ≤ 0.5%, CNV ≥ 2.0× fold change.
• • Background Noise ≤ 0.001% VAF: Фон не должен превышать целевой LOD.
• ⚠️ ВАЖНО:
• • Отсутствие покрытия ЛЮБОГО из 12 критических генов = INVALID для терапевтических решений.
• • UMI depth < 1,000× делает детекцию VAF <0.5% ненадежной.

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

Контракт input.csv

SampleID,PatientID,PrimaryTumorType,PanelName,ClinicalContext,CfDNA_Yield_ng,MinCfDNA_Yield_ng,FragmentSize_Peak_bp,FragmentProfile_Valid,HemolysisIndex,MaxHemolysisIndex,MeanTargetDepth_X,MinMeanTargetDepth_X,UniqueMolecularDepth_X,MinUniqueMolecularDepth_X,OnTargetRate_Percent,MinOnTargetRate_Percent,Uniformity_Percent,MinUniformity_Percent,DuplicationRate_Percent,MaxDuplicationRate_Percent,AssayLOD_SNv_Percent,AssayLOD_Indel_Percent,AssayLOD_Fusion_Percent,AssayLOD_CNV_FoldChange,BackgroundNoise_VAF,MaxBackgroundNoise_VAF,CriticalGenes_Total,CriticalGenes_Covered,EGFR_Covered,ALK_Covered,ROS1_Covered,BRAF_Covered,MET_Exon14_Covered,RET_Covered,NTRK_Covered,KRAS_G12C_Covered,ERBB2_Covered,PIK3CA_Covered,BRCA1_2_Covered,MSI_Status_Assessed,TMB_Assessed,PositiveControl_Pass,NegativeControl_Pass,NoTemplateControl_Pass,InternalAmplification_Control_Pass,ActionableVariants_Detected,DetectedVariants_Summary,TherapyRecommendations,AmpTier_Level,MSiHigh,TMB_Score,TMB_High,GermlineFilter_Applied,ClonalHematopoiesis_Filter_Applied,IndexHopping_Filter_Applied
CFDNA-CGP-2026-001,PAT-LUNG-042,NSCLC,FoundationOne_Liquid,Resistance,32.0,10,167,true,8,50,22000,10000,4800,1000,78.0,60,91.0,80,28.0,60,0.1,0.2,0.5,2.0,0.0003,0.001,12,12,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,2,EGFR:L858R;MET:amplification,Osimertinib+Capmatinib;Clinical_Trial_NCT05123456,Tier I,false,8.5,false,true,true,true
CFDNA-CGP-2026-002,PAT-CRC-055,CRC,Guardant360,First_Line,6.0,10,165,true,62,50,5500,10000,450,1000,52.0,60,68.0,80,72.0,60,0.1,0.2,0.5,2.0,0.0025,0.001,12,9,true,true,true,true,false,true,false,true,true,true,false,true,false,true,true,true,1,KRAS:G12C,Sotorasib (if confirmed),Tier I,false,0,false,true,false,true
CFDNA-CGP-2026-003,PAT-BRCA-061,Breast,Tempus_xF,Screening,25.0,10,168,true,5,50,18000,10000,3500,1000,82.0,60,89.0,80,22.0,60,0.1,0.2,0.5,2.0,0.0002,0.001,12,12,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,true,0,None,Consider tissue biopsy if clinically indicated,N/A,false,4.2,false,true,true,true

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

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

Пример output.json

{
  "utilityId": "oncologycfdnacgpchecker",
  "utilityFolder": "OncologyCfdnaCgpChecker",
  "package": "LiquidBiopsy",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "processedAtUtc": "2026-06-10T00:00:00Z",
  "checks": [
    {
      "parameter": "SampleID",
      "value": "CFDNA-CGP-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-001"
    },
    {
      "parameter": "PatientID",
      "value": "PAT-LUNG-042",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-002"
    },
    {
      "parameter": "PrimaryTumorType",
      "value": "NSCLC",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-003"
    },
    {
      "parameter": "PanelName",
      "value": "FoundationOne_Liquid",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-004"
    },
    {
      "parameter": "ClinicalContext",
      "value": "Resistance",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-005"
    },
    {
      "parameter": "CfDNA_Yield_ng",
      "value": "32.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-006"
    },
    {
      "parameter": "MinCfDNA_Yield_ng",
      "value": "10",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-007"
    },
    {
      "parameter": "FragmentSize_Peak_bp",
      "value": "167",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-008"
    },
    {
      "parameter": "FragmentProfile_Valid",
      "value": "true",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-009"
    },
    {
      "parameter": "HemolysisIndex",
      "value": "8",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-010"
    },
    {
      "parameter": "MaxHemolysisIndex",
      "value": "50",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-011"
    },
    {
      "parameter": "MeanTargetDepth_X",
      "value": "22000",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-012"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "audit": {
    "inputHash": "sha256:<calculated at runtime>",
    "rulesVersion": "<utility executable version>",
    "documentation": "OncologyCfdnaCgpChecker.documentation.html"
  }
}

Матрица трассируемости

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

QA/QC и change control

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