MetforminHydrochloridePurityChecker

Metformin Hydrochloride Purity Checker

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

Описание утилиты: Metformin Hydrochloride Purity Checker

Metformin Hydrochloride Purity Checker — Контроль примесей Метформина гидрохлорида

ℹ️  Утилита проверяет критические параметры чистоты метформина гидрохлорида:
   • Содержание основного вещества (Assay): 98.5–101.0%
   • Примесь A (1-циангуанидин / Dicyandiamide): ≤0.5%
   • Примесь B (Меламин / Melamine): ≤0.1%
   • Примесь C (Диметиламин / Dimethylamine): ≤0.1%
   • Сумма прочих неизвестных примесей: ≤0.5%
   • Потеря в массе при высушивании (LOD): ≤0.5%

⚠️  КРИТИЧНО: Примесь B (Меламин) >0.1% → нефротоксичность!
   Примесь A (Циангуанидин) >0.5% → нарушение очистки от сырья!

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

Формат input.csv:
BatchNumber,AssayPercent,ImpurityAPercent,ImpurityBPercent,ImpurityCPercent,OtherImpuritiesPercent,LossOnDryingPercent

Пример:
 MET-HCL-2026-001,99.8,0.10,0.02,0.01,0.15,0.2

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

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Меламин ≤0.1% — строгий лимит из-за риска образования камней в почках.
• Циангуанидин ≤0.5% — показатель полноты реакции и эффективности очистки.
• Сумма примесей ≤0.5% — общий показатель качества субстанции.
• LOD ≤0.5% — метформин HCl обычно выпускается в виде сухого порошка, влага влияет на прессование.

Ключевые особенности утилиты:
• Раздельный контроль токсичного меламина и исходного циангуанидина.
• Контроль летучих примесей (диметиламин).
• Соответствие требованиям ГФ РФ, Ph. Eur., USP.

Критические параметры:
• Assay: 98.5–101.0%
• Impurity A (Cyanoguanidine): ≤0.5%
• Impurity B (Melamine): ≤0.1%
• Impurity C (Dimethylamine): ≤0.1%
• Other Impurities: ≤0.5%
• Loss on Drying: ≤0.5%

💡 Советы по использованию:
1. Используйте ВЭЖХ с полярной колонкой (например, HILIC или модифицированный C18) и УФ-детектированием (230 нм).
2. Для диметиламина может потребоваться ГХ (GC-FID), но в утилите данные агрегированы.
3. Меламин плохо удерживается на обычных фазах, используйте специальные методы.
4. Контролируйте pH мобильной фазы для улучшения пиковой формы бигуанидов.
5. При обнаружении меламина >0.1% партия бракуется немедленно.

⚠️ Особенность: Метформин не метаболизируется в печени и выводится почками в неизменном виде, поэтому чистота субстанции критически важна для безопасности пациентов с уже сниженной функцией почек.

input.csv

BatchNumber,Assay%,ImpA%,ImpB%,ImpC%,OtherImp%,LOD%
MET-HCL-2026-001,99.8,0.10,0.02,0.01,0.15,0.2
MET-HCL-2026-002,99.5,0.20,0.05,0.02,0.20,0.3
MET-FAIL-2026-003,97.0,0.80,0.20,0.15,1.00,0.8

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

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

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

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

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

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

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

ℹ️ Утилита проверяет критические параметры чистоты метформина гидрохлорида:
• Содержание основного вещества (Assay): 98.5–101.0%
• Примесь A (1-циангуанидин / Dicyandiamide): ≤0.5%
• Примесь B (Меламин / Melamine): ≤0.1%
• Примесь C (Диметиламин / Dimethylamine): ≤0.1%
• Сумма прочих неизвестных примесей: ≤0.5%
• Потеря в массе при высушивании (LOD): ≤0.5%
⚠️ КРИТИЧНО: Примесь B (Меламин) >0.1% → нефротоксичность!
Примесь A (Циангуанидин) >0.5% → нарушение очистки от сырья!
MetforminHydrochloridePurityChecker.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,AssayPercent,ImpurityAPercent,ImpurityBPercent,ImpurityCPercent,OtherImpuritiesPercent,LossOnDryingPercent
• Синтез включает реакцию диметиламина и циангуанидина.
• Примесь A (циангуанидин) — исходное сырье, должно быть удалено.
• Примесь B (меламин) — продукт побочной тримеризации, высокотоксичен для почек.
• Примесь C (диметиламин) — летучее основание, остаток синтеза.

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

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

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

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

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

ID	Требование	Критичность	Критерий приемки
URS-001	Утилита должна поставляться с документацией `MetforminHydrochloridePurityChecker.documentation.html` в той же папке, где находится описание и пример `input.csv`.	Medium	Файл документации присутствует в папке `MetforminHydrochloridePurityChecker` и открывается локально в браузере.
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-сценарии: `MetforminHydrochloridePurityChecker.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	`MET-HCL-2026-001`	Идентификатор серии/партии для трассируемости.
2	`Assay%`	decimal	`99.8`	Результат количественного определения/содержания для оценки соответствия.
3	`ImpA%`	decimal	`0.10`	Контролируемый входной параметр для детерминированных QC-правил.
4	`ImpB%`	decimal	`0.02`	Контролируемый входной параметр для детерминированных QC-правил.
5	`ImpC%`	decimal	`0.01`	Контролируемый входной параметр для детерминированных QC-правил.
6	`OtherImp%`	decimal	`0.15`	Контролируемый входной параметр для детерминированных QC-правил.
7	`LOD%`	decimal	`0.2`	Влага/вода или потеря в массе при высушивании, важные для стабильности и качества.

BatchNumber,Assay%,ImpA%,ImpB%,ImpC%,OtherImp%,LOD%
MET-HCL-2026-001,99.8,0.10,0.02,0.01,0.15,0.2
MET-HCL-2026-002,99.5,0.20,0.05,0.02,0.20,0.3
MET-FAIL-2026-003,97.0,0.80,0.20,0.15,1.00,0.8

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

ID	Поле	Тип	Проверка	Критичность
VR-001	`BatchNumber`	string	не пусто; уникально в пределах файла, если применимо	Medium
VR-002	`Assay%`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого %-предела	High
VR-003	`ImpA%`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового предела	Medium
VR-004	`ImpB%`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового предела	Medium
VR-005	`ImpC%`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового предела	Medium
VR-006	`OtherImp%`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового предела	Medium
VR-007	`LOD%`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового предела	Medium

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

ID	Функция	Реализация	Связь с URS
FS-001	Локальная HTML-документация	Предоставить двуязычный файл `MetforminHydrochloridePurityChecker.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	Применить правила для объекта/метода Metformin Hydrochloride Purity Checker, включая критические пределы из описания и утверждённой спецификации.	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": "metforminhydrochloridepuritychecker",
  "utilityName": "MetforminHydrochloridePurityChecker",
  "object": "Metformin Hydrochloride Purity Checker",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 3,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "MET-HCL-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "Assay%",
      "value": "99.8",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "ImpA%",
      "value": "0.10",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "ImpB%",
      "value": "0.02",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "ImpC%",
      "value": "0.01",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "OtherImp%",
      "value": "0.15",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    },
    {
      "parameter": "LOD%",
      "value": "0.2",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-007"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "MetforminHydrochloridePurityChecker.documentation.html"
  }
}

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

URS	FS	Проверка	Ожидаемый результат
URS-001	FS-001	Проверить наличие файла `MetforminHydrochloridePurityChecker.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 и регрессионные тесты.

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

Диабет

Пакет для противодиабетических препаратов: инсулины, метформин, SGLT2/DPP-4/GLP-1 препараты, глюкагон и сопутствующие проверки качества лекарственных форм.

Открыть

Lumex QC Suite

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

Открыть