Mercury_Analyzer_Vaccine_Thimerosal

Mercury Analyzer Vaccine Thimerosal

Lumex QC URS & FS input.csv output.json rule-based LIMS-ready mercury

Описание утилиты: Mercury Analyzer Vaccine Thimerosal

Mercury Analyzer Vaccine Thimerosal — Контроль тиомерсала в вакцинах

ℹ️ Утилита проверяет критические параметры консерванта тиомерсала в вакцинах:
• Концентрация тиомерсала: 40–60 мкг/мл (для целевого значения 50 мкг/мл)
• Общее содержание ртути: корреляция с тиомерсалом (~49.6% массы)
• Неорганическая ртуть (продукт распада): ≤1.0 ppm
• pH раствора: 6.0–8.0

⚠️ КРИТИЧНО: Низкое содержание тиомерсала → риск бактериального загрязнения многодозового флакона!
Высокая неорганическая ртуть → деградация препарата при хранении!

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

Формат input.csv:
BatchNumber,ThimerosalConcentration_mcg_ml,TotalMercury_ppm,pH,InorganicMercury_ppm

Пример:
VAC-FLU-2026-001,50.0,24.5,7.2,0.2

— ЗАЧЕМ ЭТО НУЖНО?
Тиомерсал (этилртутьтиосалицилат натрия) используется как консервант в многодозовых флаконах вакцин.
• Предотвращает рост бактерий и грибков после вскрытия флакона.
• Содержит органическую ртуть (этилртуть), которая метаболизируется быстрее, чем метилртуть.
• Требует строгого контроля концентрации для обеспечения эффективности и безопасности.
• Тиомерсал нестабилен и может разлагаться до неорганической ртути под воздействием света и тепла.

⚠️ КРИТИЧЕСКИ ВАЖНО:
• Концентрация 80–120% от заявленной (обычно 0.005%–0.01%) — гарантия антимикробной защиты.
• Неорганическая ртуть ≤1.0 ppm — маркер правильных условий хранения (холодовая цепь, защита от света).
• Общее содержание ртути должно строго соответствовать стехиометрии тиомерсала.
• pH влияет на стабильность тиомерсала; отклонения ускоряют распад.

Ключевые особенности утилиты:
• Расчетная проверка баланса "Тиомерсал — Общая ртуть".
• Контроль примеси деградации (неорганическая ртуть).
• Соответствие требованиям WHO, USP, Ph. Eur. для вакцин.

Критические параметры:
• Thimerosal: 40–60 mcg/mL (пример для 0.005%)
• Total Mercury: ~24.8 ppm (для 50 mcg/mL Thimerosal)
• Inorganic Mercury: ≤1.0 ppm
• pH: 6.0–8.0

💡 Советы по использованию:
1. Используйте метод холодного пара атомно-абсорбционной спектрометрии (CV-AAS) для определения общей ртути.
2. Для специфического определения тиомерсала используйте ВЭЖХ с УФ-детектированием или ICP-MS.
3. Разница между общей ртутью и ртутью в составе тиомерсала указывает на наличие неорганических примесей.
4. Защищайте пробы от света при подготовке к анализу, чтобы избежать фотодеградации.
5. Этилртуть имеет короткий период полувыведения из организма по сравнению с метилртутью, но контроль все равно строгий.

⚠️ Особенность: В современных однодозовых вакцинах тиомерсал часто отсутствует. Данная утилита применима только для многодозовых форм (например, некоторые вакцины против гриппа, АКДС в отдельных странах).

input.csv

BatchNumber,Thimerosal_mcg_ml,TotalHg_ppm,pH,InorganicHg_ppm
VAC-FLU-2026-001,50.0,24.5,7.2,0.2
VAC-FLU-2026-002,48.0,23.8,7.1,0.3
VAC-FAIL-2026-003,30.0,14.8,6.5,2.5

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

Документ описывает контролируемый интерфейс, валидационное поведение и ожидаемые результаты утилиты Mercury_Analyzer_Vaccine_Thimerosal. Документ предназначен для включения в папку утилиты рядом с input.csv и файлом описания. Предполагаемый исполняемый файл: Mercury_Analyzer_Vaccine_Thimerosal.exe.

Назначение: утилита выполняет детерминированную проверку входных QC-данных по утверждённым пределам, формирует машинно-читаемый output.json и поддерживает review в QC/QA, интеграцию с LIMS/ELN/MES и подготовку CSV/CSA-пакета.

Область применения

Класс утилиты	ААС / элементные примеси
Основной объект/метод	Контроль тиомерсала в вакцинах
Вход	`input.csv` с фиксированным заголовком и контролируемыми типами данных.
Выход	`output.json` со статусами `PASS`, `WARNING`, `FAIL`, перечнем проверок и критическими находками.
Исключения	Утилита не заменяет утверждённую спецификацию, методику анализа, расследование OOS/OOT и решение Qualified Person / QA о выпуске.

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

Ниже приведены ключевые фрагменты исходного описания. Перед продуктивным применением пределы должны быть сверены с утверждённой спецификацией, регистрационным досье, актуальной фармакопейной редакцией и локальными SOP.

ℹ️ Утилита проверяет критические параметры консерванта тиомерсала в вакцинах:
• Концентрация тиомерсала: 40–60 мкг/мл (для целевого значения 50 мкг/мл)
• Общее содержание ртути: корреляция с тиомерсалом (~49.6% массы)
• Неорганическая ртуть (продукт распада): ≤1.0 ppm
• pH раствора: 6.0–8.0
⚠️ КРИТИЧНО: Низкое содержание тиомерсала → риск бактериального загрязнения многодозового флакона!
Mercury_Analyzer_Vaccine_Thimerosal.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,ThimerosalConcentration_mcg_ml,TotalMercury_ppm,pH,InorganicMercury_ppm
• Предотвращает рост бактерий и грибков после вскрытия флакона.
• Содержит органическую ртуть (этилртуть), которая метаболизируется быстрее, чем метилртуть.
• Требует строгого контроля концентрации для обеспечения эффективности и безопасности.
• Тиомерсал нестабилен и может разлагаться до неорганической ртути под воздействием света и тепла.
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Концентрация 80–120% от заявленной (обычно 0.005%–0.01%) — гарантия антимикробной защиты.
• Неорганическая ртуть ≤1.0 ppm — маркер правильных условий хранения (холодовая цепь, защита от света).

Фармакопейные и нормативные ссылки, найденные в описании

#	Источник	Примечание
1	Ph. Eur	Используется как указание на источник/контекст метода; перед внедрением требуется сверка с актуальной редакцией.
2	Ph. Eur. requirements for vaccines	Используется как указание на источник/контекст метода; перед внедрением требуется сверка с актуальной редакцией.
3	USP	Используется как указание на источник/контекст метода; перед внедрением требуется сверка с актуальной редакцией.
4	ema	Используется как указание на источник/контекст метода; перед внедрением требуется сверка с актуальной редакцией.

Производственный поток данных

Шаг	Ответственный объект	Описание	Контроль
1	LIMS/ELN/MES или аналитик QC	Формирует `input.csv` с результатами измерений и идентификатором серии.	Проверка заголовков, обязательных полей и единиц измерения.
2	Mercury_Analyzer_Vaccine_Thimerosal	Загружает CSV, выполняет приведение типов, применяет предметные правила и формирует результат.	Детерминированные правила, отсутствие ML/эвристического решения о соответствии.
3	QC reviewer / QA	Проверяет `output.json`, предупреждения, критические отклонения и исходные значения.	Review, расследование отклонений, сохранение следа данных.
4	Архив / eQMS	Сохраняет вход, выход, версию утилиты, документацию и контрольную сумму.	Data integrity: ALCOA+, воспроизводимость, change control.

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

ID	Требование	Критичность	Критерий приемки
URS-001	Утилита должна поставляться с документацией `Mercury_Analyzer_Vaccine_Thimerosal.documentation.html` в той же папке, где находится описание и пример `input.csv`.	Medium	Файл документации присутствует в папке `Mercury_Analyzer_Vaccine_Thimerosal` и открывается локально в браузере.
URS-002	Утилита должна принимать `input.csv` с точными заголовками, определёнными в контракте данных.	High	CSV с корректным заголовком обрабатывается без ручного редактирования.
URS-003	Утилита должна проверять наличие обязательных полей, количество колонок, типы данных и базовую правдоподобность значений.	High	Ошибки схемы и преобразования явно отражаются в результате.
URS-004	Утилита должна выполнять оценку по утверждённым пределам для каждого критического и некритического QC-параметра.	High	Каждый проверяемый параметр получает статус и пояснение.
URS-005	Утилита должна формировать итоговый статус серии/строки: `PASS`, `WARNING` или `FAIL`.	High	Критическое отклонение приводит к `FAIL`; некритическое — к `WARNING`.
URS-006	Утилита должна формировать `output.json`, пригодный для LIMS/ELN/MES-интеграции и QA/QC review.	High	JSON содержит исходные значения, правила, статусы, предупреждения и критические находки.
URS-007	Утилита должна сохранять трассируемость между идентификатором серии, входными значениями, применёнными правилами и итоговым статусом.	High	В выходе есть идентификатор серии/строки и перечень проверенных параметров.
URS-008	Утилита не должна использовать машинное обучение или вероятностную интерпретацию для решения о соответствии.	Medium	Результат воспроизводим и основан на явных правилах, порогах и входных значениях.
URS-009	Утилита должна быть пригодна для запуска в CLI-сценарии: `Mercury_Analyzer_Vaccine_Thimerosal.exe input.csv output.json`.	High	При корректных аргументах создаётся `output.json`; при ошибке возвращается диагностическое сообщение.
URS-010	Документация должна поддерживать подготовку IQ/OQ/PQ или эквивалентной CSV/CSA-проверки.	Medium	Документ содержит URS, FS, CSV-контракт, правила, тестовые сценарии и traceability.
URS-011	Утилита должна разделять ошибки данных, предупреждения метода и критические отказы спецификации.	High	В `output.json` доступны отдельные коллекции/поля для errors, warnings, critical findings.
URS-012	Утилита должна поддерживать архивирование входа и выхода без изменения данных.	Medium	`input.csv` и `output.json` могут быть сохранены как часть записи серии или OQ/PQ-доказательства.

Контракт input.csv

#	Поле	Тип	Пример	Назначение
1	`BatchNumber`	string	`VAC-FLU-2026-001`	Идентификатор серии/партии для трассируемости.
2	`Thimerosal_mcg_ml`	decimal	`50.0`	Контролируемый входной параметр для детерминированных QC-правил.
3	`TotalHg_ppm`	decimal	`24.5`	Контролируемый входной параметр для детерминированных QC-правил.
4	`pH`	decimal	`7.2`	pH раствора; параметр стабильности, совместимости и применения.
5	`InorganicHg_ppm`	decimal	`0.2`	Контролируемый входной параметр для детерминированных QC-правил.

BatchNumber,Thimerosal_mcg_ml,TotalHg_ppm,pH,InorganicHg_ppm
VAC-FLU-2026-001,50.0,24.5,7.2,0.2
VAC-FLU-2026-002,48.0,23.8,7.1,0.3
VAC-FAIL-2026-003,30.0,14.8,6.5,2.5

Правила валидации входных данных

ID	Поле	Тип	Проверка	Критичность
VR-001	`BatchNumber`	string	не пусто; уникально в пределах файла, если применимо	Medium
VR-002	`Thimerosal_mcg_ml`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового предела	Medium
VR-003	`TotalHg_ppm`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового предела	Medium
VR-004	`pH`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого интервала pH	High
VR-005	`InorganicHg_ppm`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового предела	Medium

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

ID	Функция	Реализация	Связь с URS
FS-001	Локальная HTML-документация	Предоставить двуязычный файл `Mercury_Analyzer_Vaccine_Thimerosal.documentation.html` с переключателем RU/EN, исходным описанием, URS, FS, контрактами и тестами.	URS-001, URS-010
FS-002	CSV import	Считать `input.csv` в UTF-8/CSV-совместимом формате, определить строку заголовка и записи данных.	URS-002, URS-009
FS-003	Schema validation	Сравнить фактические колонки с ожидаемым контрактом; отсутствующие ключевые поля фиксировать как ошибку схемы.	URS-002, URS-003
FS-004	Type conversion	Преобразовать decimal, flag/boolean и controlled string. Некорректные значения фиксировать на уровне строки и поля.	URS-003
FS-005	Domain rule engine	Применить правила для объекта/метода Mercury Analyzer Vaccine Thimerosal, включая критические пределы из описания и утверждённой спецификации.	URS-004, URS-008
FS-006	Status aggregation	Агрегировать статусы параметров: `FAIL` при критическом отказе, `WARNING` при некритическом отклонении, `PASS` при соответствии.	URS-005, URS-011
FS-007	JSON export	Записать `output.json` с идентификатором утилиты, исходными значениями, результатами проверок, warnings и critical findings.	URS-006, URS-007
FS-008	Error handling	Разделить ошибки запуска, ошибки схемы, ошибки преобразования и ошибки предметных пределов.	URS-003, URS-011
FS-009	Audit support	Обеспечить структуру результата, пригодную для review, расследования OOS/OOT, повторного расчёта и инспекционного обсуждения.	URS-007, URS-012
FS-010	Integration contract	Поддерживать стандартный сценарий: LIMS/ELN/MES создаёт `input.csv`, утилита возвращает `output.json`, портал отображает описание и документацию.	URS-006, URS-009
FS-011	Configuration/change control	Любое изменение пределов, имён колонок или логики правил требует версии, review, регрессионных тестов и обновления документации.	URS-010, URS-012
FS-012	Data integrity	Не изменять исходный `input.csv`; результаты сохранять отдельно в `output.json` с возможностью архивирования.	URS-007, URS-012

Пример структуры output.json

{
  "utilityId": "mercury-analyzer-vaccine-thimerosal",
  "utilityName": "Mercury_Analyzer_Vaccine_Thimerosal",
  "object": "Mercury Analyzer Vaccine Thimerosal",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 3,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "VAC-FLU-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "Thimerosal_mcg_ml",
      "value": "50.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "TotalHg_ppm",
      "value": "24.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "pH",
      "value": "7.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "InorganicHg_ppm",
      "value": "0.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "Mercury_Analyzer_Vaccine_Thimerosal.documentation.html"
  }
}

Матрица трассировки URS → FS → OQ/PQ

URS	FS	Проверка	Ожидаемый результат
URS-001	FS-001	Проверить наличие файла `Mercury_Analyzer_Vaccine_Thimerosal.documentation.html` в папке утилиты.	Файл присутствует, открывается, RU/EN переключатель работает.
URS-002/003	FS-002/003/004	Запустить утилиту с корректным CSV, CSV без обязательной колонки и CSV с неверным типом.	Корректный CSV обработан; ошибки схемы и типа явно указаны.
URS-004/005	FS-005/006	Передать значения в пределах, на предупредительном уровне и за критическим пределом.	Получены `PASS`, `WARNING`, `FAIL` согласно правилам.
URS-006/007	FS-007/009/012	Проверить структуру `output.json` и трассируемость серии.	JSON содержит идентификатор серии, значения, правила, статусы и critical findings.
URS-008	FS-005	Повторить запуск с тем же `input.csv`.	Результат идентичен; нет вероятностного поведения.
URS-009/010/012	FS-010/011/012	Выполнить CLI-сценарий и архивировать вход/выход/версию.	Артефакты пригодны для OQ/PQ и change-control записи.

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

ID	Сценарий	Входные данные	Ожидаемый результат
OQ-001	Позитивный путь	CSV из примера с валидными значениями.	`output.json` создан; итоговый статус `PASS` или допустимый `WARNING` согласно правилам.
OQ-002	Отсутствует обязательная колонка	Удалить один ключевой столбец из заголовка.	Ошибка схемы; строка не должна считаться прошедшей проверку.
OQ-003	Некорректный тип	В числовое поле внести текстовое значение.	Ошибка преобразования типа с указанием поля и строки.
OQ-004	Критический предел	Значение критического параметра вне утверждённого предела.	`FAIL` и запись в `criticalFindings`.
OQ-005	Предупреждение	Некритическое отклонение или неизвестная контролируемая категория.	`WARNING` без сокрытия исходного значения.
PQ-001	Реальная серия пользователя	Реальный `input.csv` из QC-процесса.	Согласованный review с сохранением `input.csv`, `output.json`, версии и контрольной суммы.

QA/QC, CSV/CSA и change control

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

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

Lumex QC Suite

Единый пакет Lumex, объединяющий исходные Lumex и Lumex2: инструментальный и общий фармацевтический QC, AAS/ICP, CE, HPLC, NIR/PAT, стабильность, растворение, однородность дозирования, системная пригодность и статистический контроль.

Открыть

Радиология

Пакет для радиологии и диагностической визуализации: радиофармпрепараты, PET/SPECT, контрастные вещества, йодсодержащие и гадолиниевые препараты, а также проверки частиц, стерильности и эндотоксинов.

Открыть

Токсикология

Пакет QC-утилит для токсикологически значимых рисков: генотоксичные примеси, остаточные растворители, элементные примеси, тяжёлые металлы, ртуть, микотоксины, пестициды, extractables/leachables и деградационные примеси.

Открыть