Назначение

Определить пользовательские требования к автономной FUZKK-утилите, которая принимает CSV-файл лабораторных данных, выполняет проверку по зашитым в код правилам и формирует LabWare-compatible JSON.

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

Утилита предназначена для предварительной QC/QA-оценки, интеграционного тестирования, LIMS/LabWare flow и подготовки evidence trail. Окончательное решение остаётся за валидированной процедурой лаборатории и ответственным персоналом.

Пользователи

QC analyst, QA reviewer, CSV/validation engineer, LIMS/LabWare integration engineer, responsible laboratory specialist.

Пользовательские требования

1. Утилита должна запускаться без параметров и выводить самоописание, пример input.csv из GetDemoData() и demo evaluation для встроенного набора данных.
2. Утилита должна запускаться с двумя параметрами: input.csv output.json.
3. Утилита не должна читать input.csv и не должна писать output.json при запуске без параметров.
4. CSV должен читаться с CultureInfo.InvariantCulture для числовых значений.
5. Результат должен формироваться в LabWare-compatible JSON с Header, Samples, Results, Status, StatusCode, ErrorMessage, Description и DescriptionEN.
6. При PASS поле ErrorMessage должно быть пустой строкой.
7. Зашитые лимиты должны следовать приоритету: Ph. Eur. → British Pharmacopoeia / UK implementation → ЕАЭС / региональные требования → EMA/ICH/EU guidance → USP fallback.
8. Если точная монография неизвестна, применяются строгие стандартные API-лимиты: Assay 98–102%, total impurities ≤1.0%, individual impurity ≤0.5%, если это применимо к типу утилиты.
9. Для биопрепаратов и mAb-like продуктов должны учитываться агрегаты, стерильность и эндотоксины, если такие параметры релевантны назначению утилиты.
10. Если параметр может приходить в разных единицах, единица должна быть отдельным входным полем или явно отражаться в имени поля input.csv.

Входной CSV

BatchNumber,ProductName,Volume_ml,Particles_ge10um_per_unit,Particles_ge25um_per_unit,Visible_Particles_Count,Visible_Particle_Type,Silicone_Droplets_Count,Glass_Fragments_Count,Protein_Aggregates_Count,Needle_Occlusion
EYE-PM-2026-001,Aflibercept PFS 2mg,0.05,15,2,0,None,5,0,3,false
EYE-PM-2026-002,Ranibizumab PFS 0.5mg,0.05,25,3,0,None,8,0,2,false
EYE-PM-2026-003,Faricimab PFS 6mg,0.05,800,70,0,None,12,0,5,false

Поля input.csv

Описание утилиты

Intravitreal Particulate Matter Analyzer — Анализатор частиц для интравитреальных инъекций

Intravitreal Particulate Matter Analyzer — Анализатор частиц для интравитреальных инъекций

ℹ️ Утилита контролирует чистоту офтальмологических препаратов:
• Частицы ≥10 мкм (≤600 на шприц)
• Частицы ≥25 мкм (≤60 на шприц)
• Видимые частицы (0 допуск)
• Осколки стекла (0 допуск)
• Капли силиконового масла
• Проходимость иглы

⚠️ КРИТИЧНО: Глаз не имеет лимфатической системы для очистки!
Любая частица может вызвать необратимое повреждение сетчатки.

Использование:
IntravitrealParticulateMatterAnalyzer.exe → демо-режим (вывод в консоль)
IntravitrealParticulateMatterAnalyzer.exe input.csv output.json → оценка ваших данных

Формат input.csv:
BatchNumber,ProductName,Volume_ml,Particles_ge10um_per_unit,Particles_ge25um_per_unit,Visible_Particles_Count,Visible_Particle_Type,Silicone_Droplets_Count,Glass_Fragments_Count,Protein_Aggregates_Count,Needle_Occlusion

Пример:
EYE-PM-2026-001,Aflibercept PFS 2mg,0.05,15,2,0,None,5,0,3,false

— ЗАЧЕМ ЭТО НУЖНО?
Контроль частиц критичен для интравитреальных препаратов (Roche, Novartis, Kanghong):
• Инъекция производится непосредственно в стекловидное тело, где нет механизма быстрого выведения частиц
• Частицы могут оседать на сетчатке, вызывая механическое повреждение или воспаление
• Тонкие иглы (30G-32G) легко закупориваются даже мелкими агрегатами
• Силиконовое масло из шприца может эмульгироваться и вызывать визуальные артефакты у пациента

⚠️ КРИТИЧЕСКИ ВАЖНО:
• Частицы ≥10 мкм ≤600 на единицу (строже, чем USP <788> из-за малого объема)
• Частицы ≥25 мкм ≤60 на единицу
• Видимые частицы: Абсолютный ноль (Zero Tolerance)
• Осколки стекла: Абсолютный ноль (риск отслоения сетчатки)
• Силиконовые капли: Минимизация (≤10) для предотвращения визуальных помех
• Игла: Должна быть полностью проходима

Ключевые особенности утилиты:
• Расчет на единицу упаковки (шприц), а не на мл, так как объем очень мал (0.05 мл)
• Разделение типов частиц (стекло, силикон, белок)
• Контроль видимых частиц методом инспекции
• Проверка проходимости иглы (Occlusion test)

Критические параметры:
• Частицы ≥10 мкм: ≤600 шт/шприц
• Частицы ≥25 мкм: ≤60 шт/шприц
• Видимые частицы: 0
• Стекло: 0
• Силикон: ≤10

💡 Советы по использованию:
1. Используйте метод световой окклюзии (Light Obscuration) для субвидимых частиц
2. Подтверждайте результаты микроскопией для идентификации типа частиц
3. Для силиконовых капель используйте методы флуоресценции или специальной микроскопии
4. Тщательно проверяйте целостность иглы после теста на проходимость
5. Любая видимая частица ведет к немедленной отбраковке всей партии

⚠️ Особенность: В офтальмологии стандарты USP <789> (видимые частицы) и <788> (субвидимые) применяются с максимальной строгостью. Из-за малого объема дозы (0.05 мл) даже одна крупная частица является значительным загрязнением. Утилита помогает обеспечить безопасность, недостижимую при стандартных подходах к парентеральным препаратам.

Трассируемость и ограничения

• URS используется как исходный документ для functional specification, CSV review и последующей CSV/validation работы.
• Документ не является заменой утверждённой фармакопейной монографии, валидированного метода или внутренней спецификации продукта.
• Для product-specific лимитов приоритет имеет утверждённая спецификация заказчика.

Функциональная спецификация описывает поведение автономной консольной утилиты FUZKK, формат входных данных, алгоритм оценки и структуру выходного JSON.

Функциональный поток

1. Main() проверяет количество аргументов.
2. Если аргументов нет: PrintHello() выводит описание и встроенный пример input.csv, затем RunDemoEvaluation() выполняет Evaluate() по GetDemoData() и печатает demo JSON.
3. Если передано два аргумента: RunWithFiles(input.csv, output.json) читает CSV, выполняет Evaluate() по каждой строке и записывает LabWare-compatible JSON.
4. LoadData() использует CultureInfo.InvariantCulture и не должен вызываться в no-args режиме.
5. Evaluate() возвращает именованный кортеж с BatchNumber, ProductName, Parameters, CriticalFailCount, WarningCount, Recommendation и RecommendationEN.
6. GetIssues() формирует сообщения для ErrorMessage при WARNING/FAIL.

Правила оценки

• PASS: CriticalFailCount = 0 и WarningCount = 0.
• WARNING: CriticalFailCount = 0 и WarningCount > 0.
• FAIL: CriticalFailCount > 0.
• ERROR: исключение при чтении или обработке данных.
• ErrorMessage остаётся пустым при PASS.
• Лимиты зашиты в Program.cs; внешняя конфигурация лимитов не требуется.

Ввод и поля

BatchNumber,ProductName,Volume_ml,Particles_ge10um_per_unit,Particles_ge25um_per_unit,Visible_Particles_Count,Visible_Particle_Type,Silicone_Droplets_Count,Glass_Fragments_Count,Protein_Aggregates_Count,Needle_Occlusion
EYE-PM-2026-001,Aflibercept PFS 2mg,0.05,15,2,0,None,5,0,3,false
EYE-PM-2026-002,Ranibizumab PFS 0.5mg,0.05,25,3,0,None,8,0,2,false
EYE-PM-2026-003,Faricimab PFS 6mg,0.05,800,70,0,None,12,0,5,false

Выходной JSON

{
  "Header": {
    "UtilityName": "Intravitreal_Particulate_Matter_Analyzer",
    "Version": "1.0.0",
    "Timestamp": "UTC",
    "InstrumentID": "FUZKK-QC-WORKSTATION",
    "OperatorID": "Admin"
  },
  "Samples": [
    {
      "SampleID": "from BatchNumber",
      "BatchNumber": "from CSV",
      "ProductName": "from CSV",
      "TestName": "utility-specific test",
      "AnalysisCode": "utility-specific code",
      "Status": "PASS | WARNING | FAIL | ERROR",
      "StatusCode": "1 | 2 | 0 | -1",
      "ErrorMessage": "",
      "Description": "Russian recommendation",
      "DescriptionEN": "English recommendation",
      "Results": [
        {
          "ParameterName": "parameter",
          "ResultValue": 0.0,
          "UnitOfMeasure": "unit",
          "SpecificationLimit": "limit",
          "IsWithinSpec": true
        }
      ]
    }
  ]
}