AcyclovirImpurityChecker

Acyclovir Impurity Checker

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

Описание утилиты: Acyclovir Impurity Checker

Acyclovir Impurity Checker — Контроль примесей Ацикловира

ℹ️ Утилита проверяет критические параметры качества ацикловира:
• Содержание основного вещества (98.0–102.0%)
• Примесь А (Гуанин) ≤0.5%
• Примесь В (Родственное соединение В) ≤0.5%
• Любая другая одиночная примесь ≤0.10%
• Сумма примесей ≤1.0%
• Потеря в массе при высушивании ≤7.0%
• Остаток после прокаливания ≤0.1%

⚠️ КРИТИЧНО: Гуанин является исходным веществом и продуктом деградации.
Его контроль важен для оценки полноты синтеза и стабильности.

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

Формат input.csv:
BatchNumber,AssayPercent,GuaninePercent,CompoundBPercent,AnyOtherSingleImpurityPercent,TotalImpuritiesPercent,LossOnDryingPercent,ResidueOnIgnitionPercent

Пример:
ACV-2026-001,99.5,0.15,0.10,0.05,0.40,4.5,0.05

— ЗАЧЕМ ЭТО НУЖНО?
Ацикловир — противовирусный препарат, аналог нуклеозида гуанина.
Качество субстанции критически важно из-за наличия специфических примесей синтеза и деградации:
• Гуанин (Impurity A) — исходное сырье и продукт гидролитического распада.
• Родственное соединение В (Impurity B) — побочный продукт конденсации.
• Контроль осуществляется методом ВЭЖХ (HPLC) с УФ-детектированием согласно ФАР/USP.

⚠️ КРИТИЧЕСКИ ВАЖНО:
• Примесь А (Гуанин) ≤0.5% — контроль полноты реакции и чистоты.
• Любая неуидентифицированная примесь ≤0.10%.
• Суммарное содержание примесей ≤1.0%.
• Потеря в массе ≤7.0% (ацикловир может содержать влагу).
• Остаток после прокаливания ≤0.1% (неорганические примеси).

Ключевые особенности утилиты:
• Строгий контроль гуанина (ключевая примесь).
• Проверка профиля родственных веществ по ВЭЖХ.
• Оценка физического качества (влажность, зола).
• Соответствие требованиям GMP для фармацевтических субстанций.

Критические параметры:
• Содержание (Assay): 98.0–102.0%
• Примесь А (Guanine): ≤0.5%
• Примесь В (Related Compound B): ≤0.5%
• Любая другая одиночная примесь: ≤0.10%
• Сумма примесей: ≤1.0%
• Потеря в массе: ≤7.0%
• Остаток после прокаливания: ≤0.1%

💡 Советы по использованию:
1. Метод анализа: ВЭЖХ с колонкой C18 и УФ-детектором (254 нм).
2. Гуанин имеет другую полярность и хорошо разделяется на обращенно-фазных колонках.
3. При превышении лимита по гуанину следует проверить условия хранения (гидролиз) или эффективность очистки синтеза.
4. Контроль влажности важен, так как ацикловир гигроскопичен.

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

input.csv

BatchNumber,AssayPercent,GuaninePercent,CompoundBPercent,AnyOtherSingleImpurityPercent,TotalImpuritiesPercent,LossOnDryingPercent,ResidueOnIgnitionPercent
ACV-2026-001,99.5,0.15,0.10,0.05,0.40,4.5,0.05
ACV-FAIL-002,99.0,0.65,0.10,0.05,0.90,4.0,0.05

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

Документ описывает контролируемый интерфейс, валидационное поведение и ожидаемые результаты утилиты AcyclovirImpurityChecker. Документ предназначен для включения в папку утилиты рядом с input.csv и файлом описания. Предполагаемый исполняемый файл: AcyclovirImpurityChecker.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.

ℹ️ Утилита проверяет критические параметры качества ацикловира:
• Содержание основного вещества (98.0–102.0%)
• Примесь А (Гуанин) ≤0.5%
• Примесь В (Родственное соединение В) ≤0.5%
• Любая другая одиночная примесь ≤0.10%
• Сумма примесей ≤1.0%
• Потеря в массе при высушивании ≤7.0%
• Остаток после прокаливания ≤0.1%
⚠️ КРИТИЧНО: Гуанин является исходным веществом и продуктом деградации.
AcyclovirImpurityChecker.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,AssayPercent,GuaninePercent,CompoundBPercent,AnyOtherSingleImpurityPercent,TotalImpuritiesPercent,LossOnDryingPercent,ResidueOnIgnitionPercent
Качество субстанции критически важно из-за наличия специфических примесей синтеза и деградации:
• Гуанин (Impurity A) — исходное сырье и продукт гидролитического распада.
• Родственное соединение В (Impurity B) — побочный продукт конденсации.
• Контроль осуществляется методом ВЭЖХ (HPLC) с УФ-детектированием согласно ФАР/USP.

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

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

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

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

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

ID	Требование	Критичность	Критерий приемки
URS-001	Утилита должна поставляться с документацией `AcyclovirImpurityChecker.documentation.html` в той же папке, где находится описание и пример `input.csv`.	Medium	Файл документации присутствует в папке `AcyclovirImpurityChecker` и открывается локально в браузере.
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-сценарии: `AcyclovirImpurityChecker.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	`ACV-2026-001`	Идентификатор серии/партии для трассируемости.
2	`AssayPercent`	decimal	`99.5`	Результат количественного определения/содержания для оценки соответствия.
3	`GuaninePercent`	decimal	`0.15`	Контролируемый входной параметр для детерминированных QC-правил.
4	`CompoundBPercent`	decimal	`0.10`	Контролируемый входной параметр для детерминированных QC-правил.
5	`AnyOtherSingleImpurityPercent`	controlled string	`0.05`	Параметр чистоты; используется для оценки соответствия, примесей и выпуска.
6	`TotalImpuritiesPercent`	decimal	`0.40`	Показатель специфической, неспецифической или суммарной примеси, контролируемый относительно утверждённого предела.
7	`LossOnDryingPercent`	decimal	`4.5`	Влага/вода или потеря в массе при высушивании, важные для стабильности и качества.
8	`ResidueOnIgnitionPercent`	string	`0.05`	Контролируемый входной параметр для детерминированных QC-правил.

BatchNumber,AssayPercent,GuaninePercent,CompoundBPercent,AnyOtherSingleImpurityPercent,TotalImpuritiesPercent,LossOnDryingPercent,ResidueOnIgnitionPercent
ACV-2026-001,99.5,0.15,0.10,0.05,0.40,4.5,0.05
ACV-FAIL-002,99.0,0.65,0.10,0.05,0.90,4.0,0.05

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

ID	Поле	Тип	Проверка	Критичность
VR-001	`BatchNumber`	string	не пусто; уникально в пределах файла, если применимо	Medium
VR-002	`AssayPercent`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого %-предела	High
VR-003	`GuaninePercent`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого %-предела	Medium
VR-004	`CompoundBPercent`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого %-предела	Medium
VR-005	`AnyOtherSingleImpurityPercent`	controlled string	не пусто; значение входит в контролируемый перечень либо фиксируется как warning	High
VR-006	`TotalImpuritiesPercent`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого %-предела	Medium
VR-007	`LossOnDryingPercent`	decimal	преобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого %-предела	Medium
VR-008	`ResidueOnIgnitionPercent`	string	не пусто для обязательного поля	Medium

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

ID	Функция	Реализация	Связь с URS
FS-001	Локальная HTML-документация	Предоставить двуязычный файл `AcyclovirImpurityChecker.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	Применить правила для объекта/метода Acyclovir Impurity 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": "acyclovirimpuritychecker",
  "utilityName": "AcyclovirImpurityChecker",
  "object": "Acyclovir Impurity Checker",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 2,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "ACV-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "AssayPercent",
      "value": "99.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "GuaninePercent",
      "value": "0.15",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "CompoundBPercent",
      "value": "0.10",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "AnyOtherSingleImpurityPercent",
      "value": "0.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    },
    {
      "parameter": "TotalImpuritiesPercent",
      "value": "0.40",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-006"
    },
    {
      "parameter": "LossOnDryingPercent",
      "value": "4.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-007"
    },
    {
      "parameter": "ResidueOnIgnitionPercent",
      "value": "0.05",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-008"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "AcyclovirImpurityChecker.documentation.html"
  }
}

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

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

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

Инфекционистика

Пакет QC-утилит для инфекционистики: антибактериальные, противовирусные, противогрибковые и противопаразитарные продукты, микробиология, стерильность, эндотоксины, вирусная безопасность, вакцинные release-checks.

Открыть

Lumex QC Suite

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

Открыть

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

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

Открыть