VitaminAQuantifier

Vitamin A Quantifier

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

Описание утилиты: Vitamin A Quantifier

Vitamin A Quantifier — Количественный анализ Витамина А (Ретинола)

ℹ️ Утилита проверяет критические параметры качества Витамина А:
• Содержание: 90.0–110.0% от заявленного (например, 1,000,000 МЕ/г)
• Соотношение пиков (325/328 нм или хроматографическое): 1.0–1.2
• Продукты окисления: ≤2.0%
• Потеря в массе при высушивании (LOD): ≤5.0%

⚠️ КРИТИЧНО: Высокий уровень продуктов окисления (>2.0%) → потеря активности и токсичность!
Отклонение соотношения пиков → наличие изомеров или деградация.

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

Формат input.csv:
BatchNumber,ContentIUPerGram,PeakRatio325_328,OxidationProductsPercent,LossOnDryingPercent

Пример:
VITA-2026-001,1050000,1.15,0.5,2.0

— ЗАЧЕМ ЭТО НУЖНО?
Витамин А (Ретинол и его эфиры) — жизненно важный жирорастворимый витамин.
• Используется в фармацевтике, косметике и обогащении пищевых продуктов.
• Крайне нестабилен: подвержен окислению, изомеризации (транс-цис) и полимеризации под действием света, тепла и кислорода.
• Активность измеряется в Международных Единицах (МЕ или IU). 1 МЕ = 0.3 мкг ретинола.
• Фармакопеи требуют строгого контроля содержания и отсутствия продуктов распада.

⚠️ КРИТИЧЕСКИ ВАЖНО:
• Содержание 90-110% — стандартный фармакопейный диапазон для субстанций и препаратов.
• Соотношение пиков (Identity test) подтверждает, что вещество не деградировало в бесцветные или слабоокрашенные продукты окисления.
• Продукты окисления (эпоксиды, альдегиды) токсичны и не обладают витаминной активностью.
• Работа с витамином А должна проводиться в защищенном от света месте (янтарное стекло, красный свет).

Ключевые особенности утилиты:
• Контроль содержания в МЕ/г.
• Оценка степени окислительной деградации.
• Проверка идентичности по спектральным/хроматографическим характеристикам.
• Соответствие требованиям ГФ РФ, Ph. Eur., USP.

Критические параметры:
• Content: 90-110% of Label Claim
• Peak Ratio: 1.0–1.2
• Oxidation Products: ≤2.0%
• Loss on Drying: ≤5.0%

💡 Советы по использованию:
1. Используйте ВЭЖХ с обращенной фазой (C18) и детектированием при 325 нм.
2. Добавляйте антиоксиданты (например, БГТ/БГА) в растворы для стабилизации во время анализа.
3. Избегайте контакта с воздухом и светом на всех этапах пробоподготовки.
4. Для масляных форм используйте метод омыления перед экстракцией, если определяете общий витамин А.
5. Калибруйте систему по стандартному образцу ретинола ацетата или пальмитата.

⚠️ Особенность: Витамин А существует в виде нескольких изомеров. Только все-транс-изомер обладает полной биологической активностью. Изомеризация приводит к снижению potency без значительного изменения массы, поэтому контроль "чистоты" (соотношения пиков) критичен.

input.csv

BatchNumber,Content_IU_g,PeakRatio,Oxidation%,LOD%
VITA-2026-001,1050000,1.15,0.5,2.0
VITA-2026-002,980000,1.12,0.8,2.5
VITA-FAIL-OX,1150000,0.90,5.5,3.0

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

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

ℹ️ Утилита проверяет критические параметры качества Витамина А:
• Содержание: 90.0–110.0% от заявленного (например, 1,000,000 МЕ/г)
• Соотношение пиков (325/328 нм или хроматографическое): 1.0–1.2
• Продукты окисления: ≤2.0%
• Потеря в массе при высушивании (LOD): ≤5.0%
⚠️ КРИТИЧНО: Высокий уровень продуктов окисления (>2.0%) → потеря активности и токсичность!
VitaminAQuantifier.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,ContentIUPerGram,PeakRatio325_328,OxidationProductsPercent,LossOnDryingPercent
• Используется в фармацевтике, косметике и обогащении пищевых продуктов.
• Крайне нестабилен: подвержен окислению, изомеризации (транс-цис) и полимеризации под действием света, тепла и кислорода.
• Активность измеряется в Международных Единицах (МЕ или IU). 1 МЕ = 0.3 мкг ретинола.
• Фармакопеи требуют строгого контроля содержания и отсутствия продуктов распада.
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Содержание 90-110% — стандартный фармакопейный диапазон для субстанций и препаратов.
• Соотношение пиков (Identity test) подтверждает, что вещество не деградировало в бесцветные или слабоокрашенные продукты окисления.

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

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

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

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

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

ID	Требование	Критичность	Критерий приемки
URS-001	Утилита должна поставляться с документацией `VitaminAQuantifier.documentation.html` в той же папке, где находится описание и пример `input.csv`.	Medium	Файл документации присутствует в папке `VitaminAQuantifier` и открывается локально в браузере.
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-сценарии: `VitaminAQuantifier.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	`VITA-2026-001`	Идентификатор серии/партии для трассируемости.
2	`Content_IU_g`	decimal	`1050000`	Значение концентрации/содержания, контролируемое по спецификации.
3	`PeakRatio`	decimal	`1.15`	Положение спектрального пика или характеристика аналитического/хроматографического пика.
4	`Oxidation%`	string	`0.5`	Контролируемый входной параметр для детерминированных QC-правил.
5	`LOD%`	decimal	`2.0`	Влага/вода или потеря в массе при высушивании, важные для стабильности и качества.

BatchNumber,Content_IU_g,PeakRatio,Oxidation%,LOD%
VITA-2026-001,1050000,1.15,0.5,2.0
VITA-2026-002,980000,1.12,0.8,2.5
VITA-FAIL-OX,1150000,0.90,5.5,3.0

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

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

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

ID	Функция	Реализация	Связь с URS
FS-001	Локальная HTML-документация	Предоставить двуязычный файл `VitaminAQuantifier.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	Применить правила для объекта/метода Vitamin A Quantifier, включая критические пределы из описания и утверждённой спецификации.	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": "vitaminaquantifier",
  "utilityName": "VitaminAQuantifier",
  "object": "Vitamin A Quantifier",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 3,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "VITA-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "Content_IU_g",
      "value": "1050000",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "PeakRatio",
      "value": "1.15",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "Oxidation%",
      "value": "0.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    },
    {
      "parameter": "LOD%",
      "value": "2.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-005"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "VitaminAQuantifier.documentation.html"
  }
}

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

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

Открыть