Описание утилиты: AAS Dialysis Fluid Monitor
AAS Dialysis Fluid Monitor — Контроль качества растворов для гемодиализа
ℹ️ Утилита проверяет критические параметры диализирующих растворов:
• Кальций (Ca): в пределах ±5% от заявленного
• Магний (Mg): в пределах ±5% от заявленного
• Натрий (Na): в пределах ±5% от заявленного
• Калий (K): в пределах ±5% от заявленного
• Алюминий (Al): ≤10.0 ppb (мкг/л)
⚠️ КРИТИЧНО: Алюминий >10 ppb → риск диализной энцефалопатии и остеомаляции!
Пациенты на гемодиализе не могут выводить алюминий почками.
Использование:
AAS_Dialysis_Fluid_Monitor.exe → демо-режим (вывод в консоль)
AAS_Dialysis_Fluid_Monitor.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,CalciumMgL,MagnesiumMgL,SodiumMgL,PotassiumMgL,AluminumPPB
Пример:
DIAL-CONC-2026-001,60.0,15.0,8000.0,100.0,2.5
— ЗАЧЕМ ЭТО НУЖНО?
Растворы для гемодиализа используются для коррекции электролитного баланса у пациентов с терминальной почечной недостаточностью.
• Точность концентрации основных электролитов (Na, K, Ca, Mg) жизненно важна для предотвращения аритмий и судорог.
• Алюминий может попадать в диализат из воды или химических реагентов.
• Поскольку барьер диализатора проницаем для алюминия, его избыток в диализате приводит к прямому накоплению в организме пациента.
• Атомно-абсорбционная спектрометрия (AAS) на приборе Lumex MGA-1000 позволяет точно контролировать как макроэлементы (в режиме пламени), так и следовый алюминий (в графитовой печи).
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Алюминий ≤10 ppb — строгий лимит безопасности (соответствует требованиям Ph. Eur. и USP для воды и растворов для диализа).
• Электролиты должны строго соответствовать рецептуре концентрата (обычно допуск ±5%).
• Регулярный мониторинг предотвращает массовые интоксикации пациентов.
• Использование чистой воды (обратный осмос) для приготовления диализата обязательно.
Ключевые особенности утилиты:
• Комплексный контроль электролитного состава.
• Строгий надзор за содержанием токсичного алюминия.
• Соответствие клиническим стандартам безопасности гемодиализа.
Критические параметры:
• Calcium: Target ±5%
• Magnesium: Target ±5%
• Sodium: Target ±5%
• Potassium: Target ±5%
• Aluminum: ≤10.0 ppb
💡 Советы по использованию:
1. Для определения Ca, Mg, Na, K используйте пламенную атомно-абсорбционную спектрометрию (FAAS).
2. Для определения Al используйте электротермическую атомизацию (графитовая печь, GFAAS) из-за низких концентраций.
3. Калий и натрий часто удобнее определять методом пламенной фотометрии, но MGA-1000 позволяет делать это через AAS при правильной настройке.
4. Регулярно проверяйте воду для разведения концентратов на содержание алюминия.
5. Используйте матричные модификаторы для стабилизации сигнала алюминия.
⚠️ Особенность: В отличие от обычных лекарств, где контроль примесей важен для долгосрочной безопасности, в диализе контакт с раствором происходит постоянно (до 400 литров воды в неделю), поэтому требования к чистоте сопоставимы с водой для инъекций, но с учетом специфики электролитного обмена.
input.csv
BatchNumber,Ca_mg_L,Mg_mg_L,Na_mg_L,K_mg_L,Al_ppb
DIAL-CONC-2026-001,60.0,15.0,8000.0,100.0,2.5
DIAL-CONC-2026-002,61.0,15.5,8100.0,102.0,4.0
DIAL-FAIL-AL-003,60.0,15.0,8000.0,100.0,15.0
Описание утилиты
AAS Dialysis Fluid Monitor — Контроль качества растворов для гемодиализа
ℹ️ Утилита проверяет критические параметры диализирующих растворов:
• Кальций (Ca): в пределах ±5% от заявленного
• Магний (Mg): в пределах ±5% от заявленного
• Натрий (Na): в пределах ±5% от заявленного
• Калий (K): в пределах ±5% от заявленного
• Алюминий (Al): ≤10.0 ppb (мкг/л)
⚠️ КРИТИЧНО: Алюминий >10 ppb → риск диализной энцефалопатии и остеомаляции!
Пациенты на гемодиализе не могут выводить алюминий почками.
Использование:
AAS_Dialysis_Fluid_Monitor.exe → демо-режим (вывод в консоль)
AAS_Dialysis_Fluid_Monitor.exe input.csv output.json → оценка ваших данных
Формат input.csv:
BatchNumber,CalciumMgL,MagnesiumMgL,SodiumMgL,PotassiumMgL,AluminumPPB
Пример:
DIAL-CONC-2026-001,60.0,15.0,8000.0,100.0,2.5
— ЗАЧЕМ ЭТО НУЖНО?
Растворы для гемодиализа используются для коррекции электролитного баланса у пациентов с терминальной почечной недостаточностью.
• Точность концентрации основных электролитов (Na, K, Ca, Mg) жизненно важна для предотвращения аритмий и судорог.
• Алюминий может попадать в диализат из воды или химических реагентов.
• Поскольку барьер диализатора проницаем для алюминия, его избыток в диализате приводит к прямому накоплению в организме пациента.
• Атомно-абсорбционная спектрометрия (AAS) на приборе Lumex MGA-1000 позволяет точно контролировать как макроэлементы (в режиме пламени), так и следовый алюминий (в графитовой печи).
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Алюминий ≤10 ppb — строгий лимит безопасности (соответствует требованиям Ph. Eur. и USP для воды и растворов для диализа).
• Электролиты должны строго соответствовать рецептуре концентрата (обычно допуск ±5%).
• Регулярный мониторинг предотвращает массовые интоксикации пациентов.
• Использование чистой воды (обратный осмос) для приготовления диализата обязательно.
Ключевые особенности утилиты:
• Комплексный контроль электролитного состава.
• Строгий надзор за содержанием токсичного алюминия.
• Соответствие клиническим стандартам безопасности гемодиализа.
Критические параметры:
• Calcium: Target ±5%
• Magnesium: Target ±5%
• Sodium: Target ±5%
• Potassium: Target ±5%
• Aluminum: ≤10.0 ppb
💡 Советы по использованию:
1. Для определения Ca, Mg, Na, K используйте пламенную атомно-абсорбционную спектрометрию (FAAS).
2. Для определения Al используйте электротермическую атомизацию (графитовая печь, GFAAS) из-за низких концентраций.
3. Калий и натрий часто удобнее определять методом пламенной фотометрии, но MGA-1000 позволяет делать это через AAS при правильной настройке.
4. Регулярно проверяйте воду для разведения концентратов на содержание алюминия.
5. Используйте матричные модификаторы для стабилизации сигнала алюминия.
⚠️ Особенность: В отличие от обычных лекарств, где контроль примесей важен для долгосрочной безопасности, в диализе контакт с раствором происходит постоянно (до 400 литров воды в неделю), поэтому требования к чистоте сопоставимы с водой для инъекций, но с учетом специфики электролитного обмена.
URS & FS — спецификация пользователя и функциональная спецификация
Документ описывает контролируемый интерфейс, требования пользователя и функциональное поведение утилиты AAS_Dialysis_Fluid_Monitor. Назначение: автоматизированная проверка лабораторных, фармакопейных, аналитических или производственных QC-параметров на основе данных input.csv с формированием структурированного результата output.json.
Предметные ограничения и критические параметры
Перед продуктивным применением пределы должны быть сверены с утверждённой спецификацией, регистрационным досье, фармакопейной статьёй, валидированной методикой и локальными SOP.
- • Кальций (Ca): в пределах ±5% от заявленного
- • Магний (Mg): в пределах ±5% от заявленного
- • Натрий (Na): в пределах ±5% от заявленного
- • Калий (K): в пределах ±5% от заявленного
- • Алюминий (Al): ≤10.0 ppb (мкг/л)
- • Точность концентрации основных электролитов (Na, K, Ca, Mg) жизненно важна для предотвращения аритмий и судорог.
- • Алюминий может попадать в диализат из воды или химических реагентов.
- • Поскольку барьер диализатора проницаем для алюминия, его избыток в диализате приводит к прямому накоплению в организме пациента.
- • Атомно-абсорбционная спектрометрия (AAS) на приборе Lumex MGA-1000 позволяет точно контролировать как макроэлементы (в режиме пламени), так и следовый алюминий (в графитовой печи).
- • Алюминий ≤10 ppb — строгий лимит безопасности (соответствует требованиям Ph. Eur. и USP для воды и растворов для диализа).
- • Электролиты должны строго соответствовать рецептуре концентрата (обычно допуск ±5%).
- • Регулярный мониторинг предотвращает массовые интоксикации пациентов.
- • Использование чистой воды (обратный осмос) для приготовления диализата обязательно.
- • Комплексный контроль электролитного состава.
- • Строгий надзор за содержанием токсичного алюминия.
- • Соответствие клиническим стандартам безопасности гемодиализа.
URS — пользовательские требования
| ID | Требование | Критичность | Критерий приемки |
| URS-001 | Утилита должна принимать файл input.csv с точными заголовками из контракта данных. | High | Файл обрабатывается без ручной правки заголовков. |
| URS-002 | Утилита должна выполнять детерминированную проверку для AAS Dialysis Fluid Monitor на основе входных значений, утверждённых пределов и предметных правил. | High | Для каждой строки формируется статус PASS / WARNING / FAIL. |
| URS-003 | Утилита должна проверять обязательные поля, типы данных, числовые диапазоны, единицы измерения и предметную правдоподобность. | High | Ошибки схемы, формата и преобразования явно отражаются в результате. |
| URS-004 | Утилита должна выявлять критические отклонения по показателям, указанным в описании и спецификации метода. | High | Критическое отклонение приводит к FAIL или отдельному critical finding. |
| URS-005 | Утилита должна формировать output.json с машинно-читаемыми результатами, исходными значениями, предупреждениями и отказами. | High | JSON пригоден для LIMS/ELN/MES, QA/QC review и архивирования. |
| URS-006 | Результат не должен зависеть от машинного обучения или недокументированных эвристик. | Medium | Все решения основаны на явно заданных правилах, порогах и входных значениях. |
| URS-007 | Система должна сохранять трассируемость между серией, входными данными, применёнными правилами и итоговым статусом. | High | Выход содержит идентификатор серии/образца и перечень проверенных параметров. |
| URS-008 | Документация должна поддерживать подготовку IQ/OQ/PQ и обсуждение при инспекции. | Medium | URS, FS, контракт CSV/JSON и тестовые сценарии поставляются вместе с утилитой. |
| URS-009 | Утилита должна быть пригодна для пакетной обработки нескольких строк input.csv. | Medium | Каждая строка получает независимую оценку; ошибки одной строки не скрывают ошибки других строк. |
| URS-010 | Утилита должна поддерживать простую операционную модель: запуск в demo-mode и запуск с входным/выходным файлом. | Medium | CLI-сценарий воспроизводим на тестовом и продуктивном окружении. |
Контракт input.csv
| # | Поле | Тип | Пример | Назначение |
|---|
| 1 | BatchNumber | string | DIAL-CONC-2026-001 | Идентификатор серии/партии для трассируемости, review и последующего расследования отклонений. |
| 2 | Ca_mg_L | string / decimal | 60.0 | Контролируемый входной параметр для детерминированных QC-правил и трассируемого результата. |
| 3 | Mg_mg_L | string / decimal | 15.0 | Контролируемый входной параметр для детерминированных QC-правил и трассируемого результата. |
| 4 | Na_mg_L | string / decimal | 8000.0 | Контролируемый входной параметр для детерминированных QC-правил и трассируемого результата. |
| 5 | K_mg_L | string / decimal | 100.0 | Контролируемый входной параметр для детерминированных QC-правил и трассируемого результата. |
| 6 | Al_ppb | decimal | 2.5 | Контролируемый входной параметр для детерминированных QC-правил и трассируемого результата. |
BatchNumber,Ca_mg_L,Mg_mg_L,Na_mg_L,K_mg_L,Al_ppb
DIAL-CONC-2026-001,60.0,15.0,8000.0,100.0,2.5
DIAL-CONC-2026-002,61.0,15.5,8100.0,102.0,4.0
DIAL-FAIL-AL-003,60.0,15.0,8000.0,100.0,15.0
FS — функциональная спецификация
| ID | Функция | Реализация |
| FS-001 | CSV import | Прочитать input.csv в UTF-8/CSV-совместимом формате, проверить наличие заголовка и ожидаемых колонок. |
| FS-002 | Schema validation | Проверить обязательные поля, количество колонок, отсутствие критических пропусков и корректность структуры строк. |
| FS-003 | Type conversion | Преобразовать числовые, флаговые и текстовые значения; некорректный формат фиксировать как ошибку строки. |
| FS-004 | Domain rule engine | Применить предметные правила для AAS Dialysis Fluid Monitor, включая лимиты из описания утилиты и утверждённой спецификации. |
| FS-005 | Status aggregation | Сформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии. |
| FS-006 | JSON export | Записать output.json с детализацией проверок, исходными значениями, предупреждениями, отказами и critical findings. |
| FS-007 | Audit support | Сохранять структуру результата пригодной для review, расследования отклонений, воспроизведения расчёта и подготовки IQ/OQ/PQ. |
| FS-008 | Integration contract | Поддерживать сценарий: LIMS/ELN/MES формирует input.csv, утилита возвращает output.json, портал отображает описание и документацию. |
| FS-009 | Error handling | Отражать ошибки без неоднозначных сообщений; не подменять отсутствующие значения расчетными значениями без явного правила. |
| FS-010 | Version control support | Документировать версию утилиты, входной контракт, контрольную сумму исполняемого файла и дату применения правил. |
Пример output.json
{
"utilityId": "aas-dialysis-fluid-monitor",
"utilityName": "AAS_Dialysis_Fluid_Monitor",
"overallStatus": "PASS|WARNING|FAIL",
"sourceFile": "input.csv",
"checks": [
{
"parameter": "BatchNumber",
"value": "DIAL-CONC-2026-001",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Ca_mg_L",
"value": "60.0",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Mg_mg_L",
"value": "15.0",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Na_mg_L",
"value": "8000.0",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "K_mg_L",
"value": "100.0",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
},
{
"parameter": "Al_ppb",
"value": "2.5",
"status": "PASS|WARNING|FAIL",
"message": "Rule-based check result"
}
],
"criticalFindings": [],
"warnings": [],
"generatedFor": "QA/QC review and LIMS integration"
}
Матрица трассируемости
| URS | FS | OQ/PQ покрытие |
|---|
| URS-001, URS-003 | FS-001, FS-002, FS-003 | OQ-001/OQ-002/OQ-003 |
| URS-002, URS-004 | FS-004, FS-005 | OQ-004/PQ-001 |
| URS-005, URS-007 | FS-006, FS-007 | OQ-005/PQ-002 |
| URS-008, URS-010 | FS-008, FS-010 | IQ-001/OQ-006 |
OQ/PQ тестовые сценарии
| ID | Сценарий | Ожидаемый результат |
|---|
| OQ-001 | Валидная строка из примера | PASS или допустимый WARNING согласно правилам. |
| OQ-002 | Отсутствует обязательная колонка | Ошибка схемы или FAIL. |
| OQ-003 | Нечисловое значение в числовом поле | Ошибка преобразования типа. |
| OQ-004 | Значение критического параметра за пределом | FAIL и critical finding. |
| OQ-005 | Несколько строк с разными статусами | Независимая оценка каждой строки. |
| PQ-001 | Реальная серия/партия пользователя | Согласованный результат review с сохранением input/output. |
QA/QC и change control
- Не менять имена колонок без обновления валидатора, документации и тестового набора.
- Хранить
input.csv, output.json, версию исполняемого файла, документацию и checksum. - Перед продуктивным использованием провести IQ/OQ/PQ или эквивалентную CSV/CSA-проверку.
- Критические пределы должны быть сверены с утверждённой спецификацией, локальными SOP и регистрационным досье.