WeightVariationTabletCapsuleQualityChecker

Weight Variation Tablet/Capsule

LabEx laboratory QC CSV→JSON URS & FS solid dosage forms utilities / cleanroom
Открыть подборку
Weight Variation Tablet/Capsule Quality Checker — Контроль вариации массы таблеток и капсул

ℹ️  Утилита оценивает однородность массы дозированных форм (таблеток и капсул) согласно USP <905> (Метод вариации массы):
     • Применимость: Непокрытые таблетки или твердые капсулы, содержащие ≥50 мг АФС или ≥50% АФС от общей массы.
     • Критерий 1: Не более 2 единиц из 20 могут отклоняться от средней массы более чем на 5%.
     • Критерий 2: Ни одна единица не может отклоняться от средней массы более чем на 10%.
     • Расчет основан на взвешивании 20 индивидуальных единиц.

⚠️  КРИТИЧНО: Отклонение массы любой единицы более чем на 10% ведет к немедленному браку серии!
     Высокая вариация массы является индикатором проблем с процессом прессования или наполнения капсул.

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

Формат input.csv:
BatchNumber,ProductName,DosageForm,AverageWeight_mg,MinWeight_mg,MaxWeight_mg,UnitsOutside5Percent,UnitsOutside10Percent,TotalUnitsTested

Пример:
  WV-2026-TAB-001,Paracetamol 500mg,Tablet,650.0,630.0,670.0,1,0,20

— ЗАЧЕМ ЭТО НУЖНО?
Однородность массы — критический параметр качества для обеспечения равномерности дозирования пациента.
Для препаратов с высокой дозой активного вещества метод вариации массы является альтернативой тесту на содержание (Content Uniformity), так как он менее трудоемок и разрушителен.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Метод применим только если доля АФС велика. Для низкодозированных препаратов (<50 мг или <50%) требуется тест Content Uniformity (CU).
• Точность весов: Должны использоваться аналитические весы с точностью до 0.1 мг или лучше.
• Статистика: Если более 2 единиц выходят за пределы 5%, но ни одна за 10%, допускается повторное тестирование еще 20 единиц (всего 40).
• Капсулы: Перед взвешиванием капсулы очищают от пыли мягкой щеткой.

Ключевые особенности утилиты:
• Автоматическая проверка критериев USP <905>
• Разделение логики для таблеток и капсул
• Контроль экстремальных значений (Min/Max)
• Генерация отчетов для отделов контроля качества и LIMS LabWare
• Соответствие требованиям GMP и Фармакопей

Критические параметры:
• Отклонение >5%: ≤ 2 единиц
• Отклонение >10%: 0 единиц
• Средняя масса: Используется как референс

💡 Советы по использованию:
1. Отбор проб: Единицы должны отбираться случайным образом из разных частей серии.
2. Калибровка: Весы должны быть калиброваны перед началом теста.
3. Условия: Взвешивание проводится в условиях контролируемой влажности и температуры.
4. Интерпретация: Если серия не проходит тест по массе, она автоматически не проходит и тест на однородность дозирования.
5. Процесс: Высокая вариация массы часто указывает на плохую текучесть гранулята или проблемы с матрицей/дозатором.

⚠️ Особенность: Этот метод является "суррогатным" для оценки однородности содержания. Он предполагает, что смесь порошка гомогенна, и вариация массы напрямую отражает вариацию количества АФС.

input.csv

BatchNumber,ProductName,DosageForm,AverageWeight_mg,MinWeight_mg,MaxWeight_mg,UnitsOutside5Percent,UnitsOutside10Percent,TotalUnitsTested
WV-2026-TAB-001,Paracetamol 500mg Tablets,Tablet,650.0,630.0,670.0,1,0,20
WV-2026-CAP-002,Amoxicillin 250mg Capsules,Capsule,300.0,280.0,320.0,3,0,20
WV-2026-TAB-FAIL-003,Ibuprofen 400mg Tablets,Tablet,450.0,390.0,510.0,5,1,20

URS & FS — Weight Variation Tablet/Capsule

Документ описывает пользовательские требования и функциональную спецификацию для утилиты WeightVariationTabletCapsuleQualityChecker. Утилита предназначена для использования в лаборатории ОКК/QC как rule-based проверка данных, подготовленных из прибора, LIMS, ELN, MES или вручную утверждённого input.csv.

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

IDТребованиеКритичностьКритерий приемки
URS-001Утилита должна принимать input.csv с утверждёнными колонками: BatchNumber, ProductName, DosageForm, AverageWeight_mg, MinWeight_mg, MaxWeight_mg, UnitsOutside5Percent, UnitsOutside10Percent, TotalUnitsTested.HighCSV обрабатывается без ручной правки заголовков.
URS-002Утилита должна выполнять детерминированную проверку данных для объекта «Weight Variation Tablet/Capsule» без применения машинного обучения.HighОдинаковые входные данные дают одинаковый JSON-результат.
URS-003Утилита должна валидировать обязательные поля, числовые форматы, флаги, диапазоны и предметную правдоподобность значений.HighОшибки схемы и преобразования явно отражаются в результате.
URS-004Утилита должна формировать output.json со статусами PASS / WARNING / FAIL, исходными значениями, предупреждениями и отказами.HighJSON пригоден для review, расследования отклонений и интеграции.
URS-005Документация должна поддерживать подготовку IQ/OQ/PQ или CSV/CSA-проверки.MediumURS/FS, контракт CSV/JSON и тестовые сценарии доступны вместе с утилитой.

Контракт input.csv

#ПолеПримерНазначение
1BatchNumberWV-2026-TAB-001Входной параметр для детерминированной проверки ОКК/QC.
2ProductNameParacetamol 500mg TabletsВходной параметр для детерминированной проверки ОКК/QC.
3DosageFormTabletВходной параметр для детерминированной проверки ОКК/QC.
4AverageWeight_mg650.0Входной параметр для детерминированной проверки ОКК/QC.
5MinWeight_mg630.0Входной параметр для детерминированной проверки ОКК/QC.
6MaxWeight_mg670.0Входной параметр для детерминированной проверки ОКК/QC.
7UnitsOutside5Percent1Входной параметр для детерминированной проверки ОКК/QC.
8UnitsOutside10Percent0Входной параметр для детерминированной проверки ОКК/QC.
9TotalUnitsTested20Входной параметр для детерминированной проверки ОКК/QC.

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

IDФункцияРеализация
FS-001CSV importПрочитать input.csv, проверить заголовок, число колонок и кодировку.
FS-002Schema validationПроверить обязательность полей и допустимость входных значений.
FS-003Rule engineПрименить предметные правила, лимиты и проверки системной пригодности/спецификации, описанные в исходном описании утилиты.
FS-004Status aggregationСформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии.
FS-005JSON exportЗаписать машинно-читаемый output.json для LIMS/ELN/MES и QA/QC review.

OQ/PQ сценарии

  • OQ-001: валидная строка из примера должна обрабатываться без ошибки схемы.
  • OQ-002: отсутствие обязательной колонки должно приводить к ошибке схемы.
  • OQ-003: нечисловое значение в числовом поле должно приводить к ошибке преобразования.
  • OQ-004: значение критического параметра вне предела должно давать FAIL или critical finding.
  • PQ-001: реальные серии пользователя проверяются с сохранением input.csv, output.json, версии утилиты и контрольной суммы.

Входит в пакеты

Стоматология и стоматологические материалы

Пакет QC-утилит для стоматологических лекарственных продуктов, средств для полости рта и стоматологических материалов: анестетики, антисептики, обезболивание/антибиотики, полимеры/минералы, смолы, бондинги, микробиология, стабильность и material QC.

Открыть

LabEx QC Suite

Пакет LabEx для лабораторных методов контроля качества: хроматография, спектроскопия, микробиология, стерильность, эндотоксины, частицы, растворение, вода, чистые помещения и подготовка образцов.

Открыть