Preservatives_Combo_QC

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

Документ описывает контролируемый интерфейс, требования пользователя и функциональное поведение утилиты Preservatives_Combo_QC. Назначение: автоматизированная проверка лабораторных, фармакопейных, аналитических или производственных QC-параметров на основе данных input.csv с формированием структурированного результата output.json.

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

• • Бензоат натрия: 90–110% от заявленного
• • Сорбат калия: 90–110% от заявленного
• • Метилпарабен: 90–110% от заявленного
• • Пропилпарабен: 90–110% от заявленного
• • pH раствора: 4.0–6.0 (Оптимальный диапазон)
• • Бензоаты и сорбаты активны преимущественно против дрожжей и плесени в кислой среде.
• • Парабены активны против бактерий и грибов в более широком диапазоне pH.
• • Синергический эффект позволяет снизить концентрацию каждого компонента.
• • ВЭЖХ позволяет одновременно количественно определять все компоненты в одном анализе.
• • Контроль pH обязателен, так как он определяет долю недиссоциированной (активной) формы кислот.
• • pH должен поддерживаться в диапазоне 4.0–5.5 для максимальной эффективности бензоатов/сорбатов.
• • Парабены могут гидролизоваться при экстремальных значениях pH.
• • Суммарная концентрация консервантов не должна превышать безопасные лимиты (токсичность).
• • Необходимо проверять совместимость консервантов с другими эксципиентами (например, ПЭГ может связывать парабены).
• • Одновременный контроль 4-х популярных консервантов.
• • Оценка критичности pH для антимикробной активности.

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

Контракт input.csv

BatchNumber,Benzoate%,Sorbate%,MethylPar%,PropylPar%,pH
PRES-COMBO-2026-001,0.10,0.10,0.05,0.05,5.0
PRES-COMBO-2026-002,0.09,0.09,0.045,0.045,4.8
PRES-FAIL-PH-003,0.10,0.10,0.05,0.05,7.2

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

Пример output.json

{
  "utilityId": "preservatives-combo-qc",
  "utilityName": "Preservatives_Combo_QC",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "PRES-COMBO-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Benzoate%",
      "value": "0.10",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Sorbate%",
      "value": "0.10",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "MethylPar%",
      "value": "0.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "PropylPar%",
      "value": "0.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "pH",
      "value": "5.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "generatedFor": "QA/QC review and LIMS integration"
}

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

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

QA/QC и change control

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