Dissolution_Profile_f2_Calculator

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

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

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

• • f2 >= 50 является стандартным критерием подобия.
• • Разница в средних значениях растворения в любой точке времени не должна превышать 10-15% (в зависимости от регуляторных требований).
• • Разница в последней точке времени не должна превышать 10%.
• • Дисперсия (RSD) в ранних точках не должна превышать 20%, в поздних — 10%.
• • Расчет f2 по формуле USP <711>.
• • Проверка количества точек и разницы в конечной точке.
• • Генерация JSON-отчета для LIMS.
• • Similarity Factor f2: 50-100
• • Time Points: >= 3
• • Max Diff at Last Point: <= 10%
• • Максимальная разница в последней точке: ≤10%

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

Контракт input.csv

Batch,Ref15,Test15,Ref30,Test30,Ref45,Test45,Ref60,Test60,Ref90,Test90
DISS-F2-2026-001,25.0,26.0,50.0,52.0,75.0,76.0,90.0,91.0,98.0,99.0
DISS-F2-2026-002,25.0,30.0,50.0,58.0,75.0,85.0,90.0,95.0,98.0,99.5
DISS-FAIL-2026-003,25.0,10.0,50.0,20.0,75.0,30.0,90.0,40.0,98.0,50.0

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

Пример output.json

{
  "utilityId": "dissolution-profile-f2-calculator",
  "utilityName": "Dissolution_Profile_f2_Calculator",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "checks": [
    {
      "parameter": "Batch",
      "value": "DISS-F2-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Ref15",
      "value": "25.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Test15",
      "value": "26.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Ref30",
      "value": "50.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Test30",
      "value": "52.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Ref45",
      "value": "75.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Test45",
      "value": "76.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Ref60",
      "value": "90.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Test60",
      "value": "91.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Ref90",
      "value": "98.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "Test90",
      "value": "99.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 и регистрационным досье.