TcmEndotoxinAndSterilityQualityChecker
Tcm Endotoxin And Sterility
ℹ️ Утилита проводит комплексную оценку безопасности парентеральных форм традиционной китайской медицины согласно ChP 2020 (Главы 1101, 1143):
• Бактериальные эндотоксины: расчёт индивидуального лимита по формуле K/M (5.0 EU/kg ÷ макс. доза)
• Валидация метода BET: восстановление спайка 50–200% (подтверждение отсутствия интерференции матрицы)
• Стерильность: отсутствие роста в TSB (тиогликоль) и FTM (соево-казеин) средах
• Длительность инкубации: ≥14 суток
• Пригодность системы: валидность положительного и отрицательного контролей
⚠️ КРИТИЧНО: Инъекционные формы ТКМ представляют ОСОБЫЙ РИСК!
В отличие от синтетических инъекций, растительные экстракты содержат сапонины, полифенолы, белки и полисахариды, которые:
1. Вызывают ложноотрицательные результаты в LAL-тесте (ингибирование гелеобразования)
2. Могут сами обладать пирогенной активностью независимо от эндотоксинов
3. Создают питательную среду для микроорганизмов при нарушении стерилизации
Без валидации восстановления (Recovery) результат теста на эндотоксины в ТКМ НЕДОСТОВЕРЕН!
Использование:
TcmEndotoxinAndSterilityQualityChecker.exe → демо-режим (вывод в консоль)
TcmEndotoxinAndSterilityQualityChecker.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,ProductName,MaxDose_ml_per_kg,Endotoxin_EU_per_ml,BET_Recovery_pct,Sterility_TSB,Sterility_FTM,IncubationDays,PosCtrl,NegCtrl
Пример (стерильность: true=нет роста, false=есть рост):
TCM-001,Qingkailing_Injection,0.4,1.2,95.0,true,true,14,true,true
Типичные инъекционные препараты ТКМ:
• Qingkailing (清开灵) — жаропонижающее, противовирусное
• Xuebijing (血必净) — сепсис, системное воспаление
• Shenmai (生脉) — сердечно-сосудистая поддержка
• Danhong (丹红) — улучшение микроциркуляции
• Yinxingye (银杏叶) — цереброваскулярные нарушения
— ЗАЧЕМ ЭТО НУЖНО?
Парентеральное введение обходит все защитные барьеры организма. Для ТКМ это создаёт уникальные вызовы:
• Сложный многокомпонентный состав невозможно полностью охарактеризовать химически
• Традиционные методы стерилизации (автокламирование) могут разрушать активные компоненты → производители используют фильтрацию, которая менее надёжна
• Растительное сырьё несёт высокую начальную бионагрузку
• Исторически инъекции ТКМ были причиной серьёзных нежелательных явлений (анафилаксия, пирогенные реакции)
Строгий комбинированный контроль эндотоксинов + стерильности + валидации матрицы является ОБЯЗАТЕЛЬНЫМ условием безопасности.
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Endotoxin Limit = 5.0 EU/kg ÷ Max Dose (mL/kg) — индивидуальный расчёт для каждого препарата
• BET Recovery 50–200% — БЕЗ этого подтверждения тест считается невалидным для ТКМ
• Sterility: NO GROWTH в обеих средах после 14 дней
• Positive Control MUST pass — иначе тест не чувствителен к эндотоксинам в данной матрице
• Negative Control MUST be clean — иначе контаминация реагентов/лаборатории
• Любое нарушение стерильности = АВТОМАТИЧЕСКАЯ ОТБРАКОВКА партии
Ключевые особенности утилиты:
• Автоматический расчёт лимита эндотоксинов на основе дозировки
• Обязательная проверка валидации метода (Recovery) — уникально для ТКМ
• Комбинированная оценка стерильности и эндотоксинов в одном отчёте
• Контроль пригодности тест-системы (Pos/Neg controls)
• Специфические предупреждения о матричной интерференции
• Соответствие ChP 2020 Chapters 1101, 1143 и USP <85>, <71>
Критические параметры:
• Endotoxin Limit: K/M (5.0 EU/kg ÷ dose mL/kg)
• BET Spike Recovery: 50–200%
• Sterility TSB: No Growth (14 days)
• Sterility FTM: No Growth (14 days)
• Incubation Period: ≥14 days
• Positive Control: Valid
• Negative Control: Valid
💡 Советы по использованию:
1. Для инъекций ТКМ ВСЕГДА проводите предварительную валидацию BET с несколькими разведениями
2. Если Recovery <50%, используйте разведение, нейтрализацию буфером или рекомбинантный фактор C (rFC)
3. Стерильность должна тестироваться методом мембранной фильтрации (для удаления ингибиторов)
4. Инкубация стерильности строго 14 дней при 30-35°C (TSB) и 20-25°C (FTM)
5. При любом росте в стерильности — идентификация микроорганизма обязательна для CAPA
6. Ведите тренды по эндотоксинам: рост значений может указывать на деградацию фильтров или проблемы с водой
⚠️ Особенность: Данная утилита объединяет два критических теста безопасности, которые для инъекций ТКМ НЕЛЬЗЯ рассматривать изолированно. Высокие эндотоксины при стерильности указывают на проблему воды/фильтрации. Рост при низких эндотоксинах — на нарушение асептики. Низкое восстановление при «нормальных» эндотоксинах — на ЛОЖНООТРИЦАТЕЛЬНЫЙ результат. Только комплексная оценка даёт реальную картину безопасности парентерального препарата ТКМ. Этот подход превосходит требования Ph.Eur., где BET и стерильность часто оцениваются раздельно без учёта специфики растительной матрицы.
input.csv
BatchNumber,ProductName,MaxDose_ml_per_kg,Endotoxin_EU_per_ml,BET_Recovery_Percent,Sterility_TSB_Ok,Sterility_FTG_Ok,IncubationDays,PositiveControlValid,NegativeControlValid TCM-QKL-INJ-2026-001,Qingkailing_Injection,0.4,1.2,95.0,true,true,14,true,true TCM-XBJ-INJ-2026-002,Xuebijing_Injection,0.2,2.8,88.0,true,true,14,true,true TCM-SHENMAI-FAIL-2026-003,Shenmai_Injection,0.3,25.0,42.0,true,true,14,true,true TCM-DANHONG-STERILE-FAIL-004,Danhong_Injection,0.4,0.8,105.0,false,true,14,true,true TCM-INVALID-CTRL-005,Yinxingye_Injection,0.5,0.5,98.0,true,true,14,false,true
TcmEndotoxinAndSterilityQualityChecker — URS & FS
TCM Endotoxin and Sterility Quality Checker
TCM Endotoxin and Sterility Quality Checker
1. Назначение документа
Документ описывает пользовательские требования (URS) и функциональную спецификацию (FS) для утилиты TcmEndotoxinAndSterilityQualityChecker. Утилита предназначена для детерминированной проверки данных input.csv, формирования структурированного результата output.json и поддержки прослеживаемого QA/QC review.
Документ является проектной URS/FS-основой для CSV/CSA, IQ/OQ/PQ и дальнейшей валидации в контексте конкретной лабораторной процедуры.
2. Исходное описание утилиты
3. URS — пользовательские требования
3.1 Цель и область применения
Система должна принимать табличные результаты лабораторного контроля, выполнять проверку по заранее заданным критериям и возвращать понятный статус по каждой серии/записи: Pass, Review или Fail.
3.2 Нормативная / методическая база
В исходном описании и правилах утилиты используются следующие ориентиры: ChP 2020, ChP, USP, EP, Ph.Eur, Ph.Eur., ICH. Финальные лимиты должны быть подтверждены утверждённой спецификацией, монографией, SOP или протоколом трансфера метода.
3.3 Ключевые QC-проверки
- Бактериальные эндотоксины: расчёт индивидуального лимита по формуле K/M (5.0 EU/kg ÷ макс. доза)
- Валидация метода BET: восстановление спайка 50–200% (подтверждение отсутствия интерференции матрицы)
- Стерильность: отсутствие роста в TSB (тиогликоль) и FTM (соево-казеин) средах
- Длительность инкубации: ≥14 суток
- Пригодность системы: валидность положительного и отрицательного контролей
- Qingkailing (清开灵) — жаропонижающее, противовирусное
- Xuebijing (血必净) — сепсис, системное воспаление
- Shenmai (生脉) — сердечно-сосудистая поддержка
3.4 Пользователи
- QC analyst — подготовка и загрузка
input.csv. - QA/QC reviewer — проверка результата и отклонений.
- CSV/validation specialist — подтверждение пригодности утилиты.
- System owner — управление версией, доступом и изменениями.
3.5 Требования к данным и Data Integrity
- каждая строка CSV должна быть прослеживаемой к серии, образцу или измерению;
- исходные значения не должны изменяться утилитой;
- расчёты должны быть воспроизводимыми при повторном запуске;
- любое отклонение должно сохраняться как структурированное finding с указанием поля и правила;
- ручное изменение итогового статуса вне QA-процесса не допускается.
4. FS — функциональная спецификация
4.1 Поток обработки
- Проверить наличие и кодировку
input.csv. - Проверить заголовки, обязательные поля и типы данных.
- Нормализовать числовые и булевы значения без изменения исходного следа.
- Выбрать набор правил по категории продукта/типа, если он предусмотрен.
- Сравнить значения с лимитами и вычислить derived metrics.
- Сформировать запись результата по каждой строке.
- Сохранить
output.jsonс общей сводкой, findings и traceability.
4.2 CSV-схема
| № | Поле CSV | Тип | Обяз. | Назначение |
|---|---|---|---|---|
| 1 | BatchNumber | string | Да | Идентификатор серии / лота для прослеживаемости. |
| 2 | ProductName | string | Да | Идентичность продукта, препарата или образца. |
| 3 | MaxDose_ml_per_kg | decimal | Да | Входной атрибут для детерминированной оценки правил и прослеживаемости результата. |
| 4 | Endotoxin_EU_per_ml | decimal | Да | Входной атрибут для детерминированной оценки правил и прослеживаемости результата. |
| 5 | BET_Recovery_Percent | decimal | Да | Измеренный аналитический результат для сравнения с критерием приемлемости. |
| 6 | Sterility_TSB_Ok | boolean | Да | Входной атрибут для детерминированной оценки правил и прослеживаемости результата. |
| 7 | Sterility_FTG_Ok | boolean | Да | Входной атрибут для детерминированной оценки правил и прослеживаемости результата. |
| 8 | IncubationDays | integer | Да | Входной атрибут для детерминированной оценки правил и прослеживаемости результата. |
| 9 | PositiveControlValid | boolean | Да | Входной атрибут для детерминированной оценки правил и прослеживаемости результата. |
| 10 | NegativeControlValid | boolean | Да | Входной атрибут для детерминированной оценки правил и прослеживаемости результата. |
4.3 Пример входных данных
| BatchNumber | ProductName | MaxDose_ml_per_kg | Endotoxin_EU_per_ml | BET_Recovery_Percent | Sterility_TSB_Ok | Sterility_FTG_Ok | IncubationDays | PositiveControlValid | NegativeControlValid |
|---|---|---|---|---|---|---|---|---|---|
| TCM-QKL-INJ-2026-001 | Qingkailing_Injection | 0.4 | 1.2 | 95.0 | true | true | 14 | true | true |
| TCM-XBJ-INJ-2026-002 | Xuebijing_Injection | 0.2 | 2.8 | 88.0 | true | true | 14 | true | true |
| TCM-SHENMAI-FAIL-2026-003 | Shenmai_Injection | 0.3 | 25.0 | 42.0 | true | true | 14 | true | true |
| TCM-DANHONG-STERILE-FAIL-004 | Danhong_Injection | 0.4 | 0.8 | 105.0 | false | true | 14 | true | true |
| TCM-INVALID-CTRL-005 | Yinxingye_Injection | 0.5 | 0.5 | 98.0 | true | true | 14 | false | true |
4.4 Выходной JSON
{
"utility": "TcmEndotoxinAndSterilityQualityChecker",
"runId": "urn:fuzkk:run:example",
"sourceFile": "input.csv",
"recordsProcessed": 5,
"overallStatus": "Pass / Review / Fail",
"records": [
{
"recordId": "TCM-QKL-INJ-2026-001",
"status": "Pass / Review / Fail",
"criticalFindings": [],
"warnings": [],
"evaluatedRules": [
"Configured acceptance criteria from the utility rule set"
],
"inputTrace": {
"BatchNumber": "TCM-QKL-INJ-2026-001",
"ProductName": "Qingkailing_Injection",
"MaxDose_ml_per_kg": "0.4",
"Endotoxin_EU_per_ml": "1.2",
"BET_Recovery_Percent": "95.0",
"Sterility_TSB_Ok": "true",
"Sterility_FTG_Ok": "true",
"IncubationDays": "14"
}
}
],
"dataIntegrity": {
"deterministicEvaluation": true,
"sourceRowTraceability": true,
"manualOverrideAllowed": false
}
}
5. Трассировка URS → FS → тесты
| URS | FS-механизм | Проверка |
|---|---|---|
| Загрузка корректного input.csv | CSV parser + schema validator | OQ: валидный/невалидный CSV |
| Детерминированная оценка лимитов | Rule engine с фиксированной конфигурацией | OQ: граничные значения и known expected results |
| Статусы Pass/Review/Fail | Status aggregator по findings | OQ/PQ: образцы с проходными и провальными сериями |
| Прослеживаемость к исходной строке | inputTrace + recordId | PQ: сверка output.json с исходным CSV |
| Поддержка QA review | структурированные findings и warnings | PQ: review сценарии и deviation handling |
6. CSV/CSA и валидационный подход
IQ
- проверка версии утилиты;
- проверка расположения исполняемого файла;
- проверка шаблона CSV;
- контроль прав доступа.
OQ
- проверка обязательных полей;
- проверка типов данных;
- проверка граничных значений;
- проверка zero-tolerance правил.
PQ
- прогоны на реальных/репрезентативных данных;
- сверка с ручным расчётом;
- подтверждение QA review workflow.
Change control
- версионирование лимитов;
- impact assessment при изменении правил;
- регрессия после обновления.
1. Document purpose
This document defines user requirements (URS) and functional specification (FS) for TcmEndotoxinAndSterilityQualityChecker. The utility is intended to evaluate input.csv data deterministically, generate structured output.json output and support traceable QA/QC review.
This document is a project-level URS/FS baseline for CSV/CSA, IQ/OQ/PQ and further validation under an approved laboratory procedure.
2. Source utility description
3. URS — user requirements
3.1 Intended use and scope
The system shall accept tabular laboratory QC results, evaluate them against configured acceptance criteria and return a clear status for each batch or record: Pass, Review or Fail.
3.2 Regulatory / methodological basis
The source description and utility rules refer to the following framework: ChP 2020, ChP, USP, EP, Ph.Eur, Ph.Eur., ICH. Final acceptance limits shall be confirmed by the approved specification, pharmacopoeial monograph, SOP or method-transfer protocol.
3.3 Key QC checks
- Bacterial endotoxins: individual limit calculation by K/M formula (5.0 EU/kg ÷ max dose)
- BET method validation: spike recovery 50–200% (confirmation of matrix interference absence)
- Sterility: no growth in TSB (thioglycollate) and FTM (soybean-casein) media
- Incubation duration: ≥14 days
- System suitability: positive and negative control validity
- Qingkailing (清开灵) — antipyretic, antiviral
- Xuebijing (血必净) — sepsis, systemic inflammation
- Shenmai (生脉) — cardiovascular support
3.4 Users
- QC analyst — prepares and loads
input.csv. - QA/QC reviewer — reviews output, findings and deviations.
- CSV/validation specialist — confirms fitness for intended use.
- System owner — controls versioning, access and change management.
3.5 Data and data-integrity requirements
- each CSV row shall be traceable to a batch, sample or analytical measurement;
- source values shall not be modified by the utility;
- calculations shall be reproducible on repeated execution;
- each deviation shall be captured as a structured finding with field and rule references;
- manual override of the final status outside QA process is not allowed.
4. FS — functional specification
4.1 Processing flow
- Verify presence and encoding of
input.csv. - Validate headers, mandatory fields and data types.
- Normalize numeric and boolean values while preserving the source trace.
- Select an adaptive rule set by product/category type, where applicable.
- Compare values with limits and compute derived metrics.
- Create a result record for each input row.
- Write
output.jsonwith summary, findings and traceability.
4.2 CSV schema
| # | CSV field | Type | Req. | Purpose |
|---|---|---|---|---|
| 1 | BatchNumber | string | Yes | Batch / lot identifier used for traceability. |
| 2 | ProductName | string | Yes | Product, preparation or sample identity. |
| 3 | MaxDose_ml_per_kg | decimal | Yes | Input attribute required for deterministic rule evaluation and output traceability. |
| 4 | Endotoxin_EU_per_ml | decimal | Yes | Input attribute required for deterministic rule evaluation and output traceability. |
| 5 | BET_Recovery_Percent | decimal | Yes | Measured analytical result compared with the configured acceptance criterion. |
| 6 | Sterility_TSB_Ok | boolean | Yes | Input attribute required for deterministic rule evaluation and output traceability. |
| 7 | Sterility_FTG_Ok | boolean | Yes | Input attribute required for deterministic rule evaluation and output traceability. |
| 8 | IncubationDays | integer | Yes | Input attribute required for deterministic rule evaluation and output traceability. |
| 9 | PositiveControlValid | boolean | Yes | Input attribute required for deterministic rule evaluation and output traceability. |
| 10 | NegativeControlValid | boolean | Yes | Input attribute required for deterministic rule evaluation and output traceability. |
4.3 Input data example
| BatchNumber | ProductName | MaxDose_ml_per_kg | Endotoxin_EU_per_ml | BET_Recovery_Percent | Sterility_TSB_Ok | Sterility_FTG_Ok | IncubationDays | PositiveControlValid | NegativeControlValid |
|---|---|---|---|---|---|---|---|---|---|
| TCM-QKL-INJ-2026-001 | Qingkailing_Injection | 0.4 | 1.2 | 95.0 | true | true | 14 | true | true |
| TCM-XBJ-INJ-2026-002 | Xuebijing_Injection | 0.2 | 2.8 | 88.0 | true | true | 14 | true | true |
| TCM-SHENMAI-FAIL-2026-003 | Shenmai_Injection | 0.3 | 25.0 | 42.0 | true | true | 14 | true | true |
| TCM-DANHONG-STERILE-FAIL-004 | Danhong_Injection | 0.4 | 0.8 | 105.0 | false | true | 14 | true | true |
| TCM-INVALID-CTRL-005 | Yinxingye_Injection | 0.5 | 0.5 | 98.0 | true | true | 14 | false | true |
4.4 Output JSON
{
"utility": "TcmEndotoxinAndSterilityQualityChecker",
"runId": "urn:fuzkk:run:example",
"sourceFile": "input.csv",
"recordsProcessed": 5,
"overallStatus": "Pass / Review / Fail",
"records": [
{
"recordId": "TCM-QKL-INJ-2026-001",
"status": "Pass / Review / Fail",
"criticalFindings": [],
"warnings": [],
"evaluatedRules": [
"Configured acceptance criteria from the utility rule set"
],
"inputTrace": {
"BatchNumber": "TCM-QKL-INJ-2026-001",
"ProductName": "Qingkailing_Injection",
"MaxDose_ml_per_kg": "0.4",
"Endotoxin_EU_per_ml": "1.2",
"BET_Recovery_Percent": "95.0",
"Sterility_TSB_Ok": "true",
"Sterility_FTG_Ok": "true",
"IncubationDays": "14"
}
}
],
"dataIntegrity": {
"deterministicEvaluation": true,
"sourceRowTraceability": true,
"manualOverrideAllowed": false
}
}
5. Traceability URS → FS → tests
| URS | FS mechanism | Test evidence |
|---|---|---|
| Load valid input.csv | CSV parser + schema validator | OQ: valid/invalid CSV cases |
| Deterministic limit evaluation | Rule engine with fixed configuration | OQ: boundary values and known expected results |
| Pass/Review/Fail statuses | Status aggregator based on findings | OQ/PQ: passing and failing representative batches |
| Traceability to source row | inputTrace + recordId | PQ: output.json reconciliation to source CSV |
| QA review support | structured findings and warnings | PQ: review and deviation-handling scenarios |
6. CSV/CSA and validation approach
IQ
- utility version check;
- executable location check;
- CSV template check;
- access-right verification.
OQ
- mandatory field checks;
- data type checks;
- boundary-value checks;
- zero-tolerance rule checks.
PQ
- runs on real or representative data;
- comparison with manual calculation;
- confirmation of QA review workflow.
Change control
- rule and limit versioning;
- impact assessment for rule changes;
- regression after updates.
Входит в пакеты
Традиционная китайская медицина (ТКМ)
Пакет QC-утилит для ТКМ: botanical identity, fingerprint consistency, marker compounds, decoction pieces, Paozhi processing, pesticides, mycotoxins, heavy metals, sulfur fumigation, microbial limits and adulteration screening.
Открыть