CE_Peptide_Map_Validator

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

Документ описывает контролируемый интерфейс, валидационное поведение и ожидаемые результаты утилиты CE_Peptide_Map_Validator. Документ предназначен для включения в папку утилиты рядом с input.csv и файлом описания. Предполагаемый исполняемый файл: CE_Peptide_Map_Validator.exe.

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

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

• • Покрытие последовательности ≥95.0%
• • Количество пептидов (±2 от ожидаемого)
• • Площадь отсутствующих пиков ≤1.0%
• • Максимальный сдвиг времени ≤0.5 мин
• • Идентификационный скор ≥90
• ⚠️ КРИТИЧНО: Пептидное картирование — основной метод подтверждения первичной структуры.
• CE_Peptide_Map_Validator.exe input.csv output.json → оценка ваших данных
• Формат input.csv:
• BatchNumber,ProteinName,CoveragePercent,DetectedCount,ExpectedCount,MissingAreaPercent,MaxRtShift,IdentityScore
• • Подтверждение идентичности: Карта пептидов должна точно соответствовать теоретической карте последовательности.
• • Выявление посттрансляционных модификаций (ПТМ): Сдвиг пика может указывать на дезамидирование, окисление, гликирование.
• • Контроль процессинга: Отсутствие или появление новых пиков может свидетельствовать о неправильном сворачивании или кливаже сигнального пептида.
• • Для биосимиляров: Сравнение с референсным препаратом для доказательства схожести структуры.
• ⚠️ КРИТИЧЕСКИ ВАЖНО:
• • Покрытие последовательности должно быть максимальным (>95%), чтобы гарантировать проверку всей молекулы.
• • Любые недостающие пики или новые пики должны быть исследованы.

Производственный поток данных

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

Контракт input.csv

BatchNumber,ProteinName,CoveragePercent,DetectedCount,ExpectedCount,MissingAreaPercent,MaxRtShift,IdentityScore
MAB-PM-2026-001,Trastuzumab,98.5,42,43,0.2,0.15,98.0
MAB-FAIL-2026-002,Insulin Analog,85.0,28,30,2.5,0.8,82.0

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

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

Пример структуры output.json

{
  "utilityId": "ce-peptide-map-validator",
  "utilityName": "CE_Peptide_Map_Validator",
  "object": "CE Peptide Map Validator",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 2,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "MAB-PM-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "ProteinName",
      "value": "Trastuzumab",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "CoveragePercent",
      "value": "98.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "DetectedCount",
      "value": "42",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "ExpectedCount",
      "value": "43",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "MissingAreaPercent",
      "value": "0.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    },
    {
      "parameter": "MaxRtShift",
      "value": "0.15",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-007"
    },
    {
      "parameter": "IdentityScore",
      "value": "98.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-008"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "CE_Peptide_Map_Validator.documentation.html"
  }
}

Матрица трассировки URS → FS → OQ/PQ

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

QA/QC, CSV/CSA и change control

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