AAS_Nickel_Hydrogenated_Oils

AAS Nickel Hydrogenated Oils

Lumex QC URS & FS input.csv output.json rule-based LIMS-ready AAS
Открыть подборку

Описание утилиты: AAS Nickel Hydrogenated Oils

AAS Nickel Hydrogenated Oils — Контроль никеля в гидрогенизированных маслах

ℹ️  Утилита проверяет содержание остаточного никеля после каталитической гидрогенизации:
    • Никель (Ni) ≤1.0 ppm
    • Источник: Катализатор гидрогенизации (Ni на носителе)

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

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

Формат input.csv:
BatchNumber,OilType,NickelPPM,IodineValue

Пример:
  OIL-HYD-2026-001,Hydrogenated Soybean Oil,0.5,5.0

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

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Предел содержания: Обычно ≤1.0 ppm для гидрогенизированных масел.
• Метод анализа: Атомно-абсорбционная спектрометрия (пламенная ААС) после минерализации масла.
• Контроль йодного числа помогает оценить степень гидрогенизации, но не заменяет анализ на никель.

Ключевые особенности утилиты:
• Специфический контроль остаточного катализатора.
• Соответствие требованиям к качеству жиров и масел.
• Простая интеграция с процессами контроля качества масложировой продукции.
• Интеграция с LIMS LabWare.

Критические параметры:
• Никель (Ni): ≤1.0 ppm

💡 Советы по использованию:
1. Пробоподготовка масел требует осторожности: используйте сухое озоление или микроволновое разложение в кислотах.
2. Пламенная ААС достаточно чувствительна для определения 1 ppm Ni.
3. Если уровень Ni высок, проверьте эффективность стадии отбеливания (bleaching earth) и фильтрации.
4. Йодное число в отчете приведено как справочная информация о степени насыщения жира.

⚠️ Особенность: В отличие от других тяжелых металлов, никель здесь является технологической примесью (process impurity), а не загрязнителем окружающей среды.

input.csv

AAS Nickel Hydrogenated Oils — Контроль никеля в гидрогенизированных маслах

ℹ️  Утилита проверяет содержание остаточного никеля после каталитической гидрогенизации:
    • Никель (Ni) ≤1.0 ppm
    • Источник: Катализатор гидрогенизации (Ni на носителе)

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

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

Формат input.csv:
BatchNumber,OilType,NickelPPM,IodineValue

Пример:
  OIL-HYD-2026-001,Hydrogenated Soybean Oil,0.5,5.0

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

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Предел содержания: Обычно ≤1.0 ppm для гидрогенизированных масел.
• Метод анализа: Атомно-абсорбционная спектрометрия (пламенная ААС) после минерализации масла.
• Контроль йодного числа помогает оценить степень гидрогенизации, но не заменяет анализ на никель.

Ключевые особенности утилиты:
• Специфический контроль остаточного катализатора.
• Соответствие требованиям к качеству жиров и масел.
• Простая интеграция с процессами контроля качества масложировой продукции.
• Интеграция с LIMS LabWare.

Критические параметры:
• Никель (Ni): ≤1.0 ppm

💡 Советы по использованию:
1. Пробоподготовка масел требует осторожности: используйте сухое озоление или микроволновое разложение в кислотах.
2. Пламенная ААС достаточно чувствительна для определения 1 ppm Ni.
3. Если уровень Ni высок, проверьте эффективность стадии отбеливания (bleaching earth) и фильтрации.
4. Йодное число в отчете приведено как справочная информация о степени насыщения жира.

⚠️ Особенность: В отличие от других тяжелых металлов, никель здесь является технологической примесью (process impurity), а не загрязнителем окружающей среды.

[English]
AAS Nickel Hydrogenated Oils — Nickel Control in Hydrogenated Oils

ℹ️  Utility checks residual nickel content after catalytic hydrogenation:
    • Nickel (Ni) ≤1.0 ppm
    • Source: Hydrogenation catalyst (supported Ni)

⚠️  CRITICAL: Nickel is a strong allergen and has toxicity.
    Its presence in food and pharmaceutical oils is strictly regulated.

Usage:
  AAS_Nickel_Hydrogenated_Oils.exe                            → demo mode (console output)
  AAS_Nickel_Hydrogenated_Oils.exe input.csv output.json      → evaluate your data

Input format:
BatchNumber,OilType,NickelPPM,IodineValue

Example:
  OIL-HYD-2026-001,Hydrogenated Soybean Oil,0.5,5.0

— WHY IS THIS NEEDED?
The hydrogenation process of vegetable oils (converting liquid oils to solid fats) uses nickel catalysts.
After the reaction, the catalyst is filtered, but trace amounts of nickel may remain in the product.
• Toxicity: Nickel can cause contact dermatitis and allergic reactions upon ingestion in sensitized individuals.
• Quality: High nickel content indicates inefficient purification (bleaching) of the oil.
• Regulation: Pharmacopoeias (USP, Ph.Eur.) and food standards set strict limits (usually 1 ppm or lower).

⚠️  CRITICAL:
• Limit: Usually ≤1.0 ppm for hydrogenated oils.
• Analysis method: Atomic Absorption Spectrometry (Flame AAS) after oil mineralization.
• Iodine value control helps assess the degree of hydrogenation but does not replace nickel analysis.

Key features:
• Specific control of residual catalyst.
• Compliance with fat and oil quality requirements.
• Simple integration with quality control processes for oil and fat products.
• LabWare LIMS integration.

Critical parameters:
• Nickel (Ni): ≤1.0 ppm

💡 Usage tips:
1. Oil sample preparation requires care: use dry ashing or microwave acid digestion.
2. Flame AAS is sensitive enough for 1 ppm Ni determination.
3. If Ni levels are high, check the efficiency of the bleaching earth stage and filtration.
4. Iodine value in the report is provided as reference information on fat saturation degree.

⚠️ Note: Unlike other heavy metals, nickel here is a process impurity, not an environmental contaminant.

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

Документ описывает контролируемый интерфейс, валидационное поведение и ожидаемые результаты утилиты AAS_Nickel_Hydrogenated_Oils. Документ предназначен для включения в папку утилиты рядом с input.csv и файлом описания. Предполагаемый исполняемый файл: AAS_Nickel_Hydrogenated_Oils.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.
  • • Никель (Ni) ≤1.0 ppm
  • • Источник: Катализатор гидрогенизации (Ni на носителе)
  • ⚠️ КРИТИЧНО: Никель является сильным аллергеном и обладает токсичностью.
  • AAS_Nickel_Hydrogenated_Oils.exe input.csv output.json → оценка ваших данных
  • Формат input.csv:
  • BatchNumber,OilType,NickelPPM,IodineValue
  • • Токсичность: Никель может вызывать контактный дерматит и аллергические реакции при приеме внутрь у сенсибилизированных лиц.
  • • Качество: Высокое содержание никеля указывает на неэффективную очистку (отбеливание) масла.
  • • Регламент: Фармакопеи (USP, Ph.Eur.) и пищевые стандарты устанавливают строгие пределы (обычно 1 ppm или ниже).
  • ⚠️ КРИТИЧЕСКИ ВАЖНО:
  • • Предел содержания: Обычно ≤1.0 ppm для гидрогенизированных масел.
  • • Метод анализа: Атомно-абсорбционная спектрометрия (пламенная ААС) после минерализации масла.
  • • Контроль йодного числа помогает оценить степень гидрогенизации, но не заменяет анализ на никель.
  • • Специфический контроль остаточного катализатора.
  • • Соответствие требованиям к качеству жиров и масел.
  • • Простая интеграция с процессами контроля качества масложировой продукции.

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

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

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

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

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

IDТребованиеКритичностьКритерий приемки
URS-001Утилита должна поставляться с документацией AAS_Nickel_Hydrogenated_Oils.documentation.html в той же папке, где находится описание и пример input.csv.MediumФайл документации присутствует в папке AAS_Nickel_Hydrogenated_Oils и открывается локально в браузере.
URS-002Утилита должна принимать input.csv с точными заголовками, определёнными в контракте данных.HighCSV с корректным заголовком обрабатывается без ручного редактирования.
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.HighJSON содержит исходные значения, правила, статусы, предупреждения и критические находки.
URS-007Утилита должна сохранять трассируемость между идентификатором серии, входными значениями, применёнными правилами и итоговым статусом.HighВ выходе есть идентификатор серии/строки и перечень проверенных параметров.
URS-008Утилита не должна использовать машинное обучение или вероятностную интерпретацию для решения о соответствии.MediumРезультат воспроизводим и основан на явных правилах, порогах и входных значениях.
URS-009Утилита должна быть пригодна для запуска в CLI-сценарии: AAS_Nickel_Hydrogenated_Oils.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Утилита должна поддерживать архивирование входа и выхода без изменения данных.Mediuminput.csv и output.json могут быть сохранены как часть записи серии или OQ/PQ-доказательства.

Контракт input.csv

#ПолеТипПримерНазначение
1BatchNumberstringOIL-HYD-2026-001Идентификатор серии/партии для трассируемости.
2OilTypecontrolled stringHydrogenated Soybean OilКонтролируемая категория для выбора корректного набора правил.
3NickelPPMdecimal0.5Элементная примесь / остаточный металл.
4IodineValuedecimal5.0Контролируемый входной параметр для детерминированных QC-правил.
BatchNumber,OilType,NickelPPM,IodineValue
OIL-HYD-2026-001,Hydrogenated Soybean Oil,0.5,5.0

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

IDПолеТипПроверкаКритичность
VR-001BatchNumberstringне пусто; уникально в пределах файла, если применимоMedium
VR-002OilTypecontrolled stringне пусто; значение входит в контролируемый перечень либо фиксируется как warningMedium
VR-003NickelPPMdecimalпреобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового пределаHigh
VR-004IodineValuedecimalпреобразуется как invariant decimal; конечное значение; без NaN/Infinity; оценка относительно утверждённого числового пределаMedium

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

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

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

{
  "utilityId": "aas-nickel-hydrogenated-oils",
  "utilityName": "AAS_Nickel_Hydrogenated_Oils",
  "object": "AAS Nickel Hydrogenated Oils",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "recordCount": 1,
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "OIL-HYD-2026-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-001"
    },
    {
      "parameter": "OilType",
      "value": "Hydrogenated Soybean Oil",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-002"
    },
    {
      "parameter": "NickelPPM",
      "value": "0.5",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-003"
    },
    {
      "parameter": "IodineValue",
      "value": "5.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result",
      "ruleReference": "VR-004"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "metadata": {
    "executionMode": "CLI",
    "interface": "CSV to JSON",
    "documentationFile": "AAS_Nickel_Hydrogenated_Oils.documentation.html"
  }
}

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

URSFSПроверкаОжидаемый результат
URS-001FS-001Проверить наличие файла AAS_Nickel_Hydrogenated_Oils.documentation.html в папке утилиты.Файл присутствует, открывается, RU/EN переключатель работает.
URS-002/003FS-002/003/004Запустить утилиту с корректным CSV, CSV без обязательной колонки и CSV с неверным типом.Корректный CSV обработан; ошибки схемы и типа явно указаны.
URS-004/005FS-005/006Передать значения в пределах, на предупредительном уровне и за критическим пределом.Получены PASS, WARNING, FAIL согласно правилам.
URS-006/007FS-007/009/012Проверить структуру output.json и трассируемость серии.JSON содержит идентификатор серии, значения, правила, статусы и critical findings.
URS-008FS-005Повторить запуск с тем же input.csv.Результат идентичен; нет вероятностного поведения.
URS-009/010/012FS-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 и деградационные примеси.

Открыть