WeightVariationTabletCapsuleQualityChecker
Weight Variation Tablet/Capsule
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. | High | CSV обрабатывается без ручной правки заголовков. |
| URS-002 | Утилита должна выполнять детерминированную проверку данных для объекта «Weight Variation Tablet/Capsule» без применения машинного обучения. | High | Одинаковые входные данные дают одинаковый JSON-результат. |
| URS-003 | Утилита должна валидировать обязательные поля, числовые форматы, флаги, диапазоны и предметную правдоподобность значений. | High | Ошибки схемы и преобразования явно отражаются в результате. |
| URS-004 | Утилита должна формировать output.json со статусами PASS / WARNING / FAIL, исходными значениями, предупреждениями и отказами. | High | JSON пригоден для review, расследования отклонений и интеграции. |
| URS-005 | Документация должна поддерживать подготовку IQ/OQ/PQ или CSV/CSA-проверки. | Medium | URS/FS, контракт CSV/JSON и тестовые сценарии доступны вместе с утилитой. |
Контракт input.csv
| # | Поле | Пример | Назначение |
|---|---|---|---|
| 1 | BatchNumber | WV-2026-TAB-001 | Входной параметр для детерминированной проверки ОКК/QC. |
| 2 | ProductName | Paracetamol 500mg Tablets | Входной параметр для детерминированной проверки ОКК/QC. |
| 3 | DosageForm | Tablet | Входной параметр для детерминированной проверки ОКК/QC. |
| 4 | AverageWeight_mg | 650.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 5 | MinWeight_mg | 630.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 6 | MaxWeight_mg | 670.0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 7 | UnitsOutside5Percent | 1 | Входной параметр для детерминированной проверки ОКК/QC. |
| 8 | UnitsOutside10Percent | 0 | Входной параметр для детерминированной проверки ОКК/QC. |
| 9 | TotalUnitsTested | 20 | Входной параметр для детерминированной проверки ОКК/QC. |
FS — функциональная спецификация
| ID | Функция | Реализация |
|---|---|---|
| FS-001 | CSV import | Прочитать input.csv, проверить заголовок, число колонок и кодировку. |
| FS-002 | Schema validation | Проверить обязательность полей и допустимость входных значений. |
| FS-003 | Rule engine | Применить предметные правила, лимиты и проверки системной пригодности/спецификации, описанные в исходном описании утилиты. |
| FS-004 | Status aggregation | Сформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии. |
| FS-005 | JSON 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 для лабораторных методов контроля качества: хроматография, спектроскопия, микробиология, стерильность, эндотоксины, частицы, растворение, вода, чистые помещения и подготовка образцов.
Открыть