EssentialOilsQualityValidator

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

Утилита Essential Oils Quality Validator применяется для объекта Essential Oils Quality Validator. Источником истины для структуры входных данных является фактический input.csv; критерии контроля задаются исполняемым модулем и предметным описанием.

Утилита не использует машинное обучение; решение формируется детерминированными правилами.

Категории: Pharmacopoeial methods

Теги: heavy metals, microbiology, particulate contamination, Ph. Eur., pharmacopoeia, residual solvents, water quality

2. Режимы запуска

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

3. Ключевые контролируемые области

• остаточные растворители
• тяжёлые металлы / элементные примеси
• pH и физико-химические параметры

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

6. Контракт входных данных input.csv

Источник истины для схемы входа — фактический заголовок input.csv. Имена колонок технические и не переводятся.

Пример CSV

OilName,BatchNumber,Water_percent,ForeignEstersDetected,FattyOilsOrResinifiedDetected,ResidueOnEvaporation_percent,SolubilityInAlcohol,Cineole_percent
Peppermint_Oil,B20250110,0.2,false,false,1.5,Clear,3.0

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

8. Выходной контракт output.json

Выходной файл должен быть пригоден для автоматической обработки, аудита и сопоставления с исходной строкой input.csv.

{
  "utility": "EssentialOilsQualityValidator",
  "api": "Essential Oils Quality Validator",
  "batchNumber": "B20250110",
  "overallStatus": "PASS|WARNING|FAIL",
  "checkedAtUtc": "2026-05-18T00:00:00Z",
  "checks": [
    {
      "parameter": "OilName",
      "value": "Peppermint_Oil",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "BatchNumber",
      "value": "B20250110",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "Water_percent",
      "value": "0.2",
      "unit": "%",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "ForeignEstersDetected",
      "value": "false",
      "unit": "0/1",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "FattyOilsOrResinifiedDetected",
      "value": "false",
      "unit": "0/1",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "ResidueOnEvaporation_percent",
      "value": "1.5",
      "unit": "%",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "SolubilityInAlcohol",
      "value": "Clear",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "Cineole_percent",
      "value": "3.0",
      "unit": "%",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    }
  ],
  "criticalFindings": [],
  "sourceFile": "input.csv"
}

9. Тестовые сценарии OQ/PQ

10. QA/QC, CSV и управление изменениями

• Перед применением на производстве клиент фиксирует версию исполняемого файла, контрольную сумму, версию спецификации/монографии, тестовый CSV, ожидаемый JSON и результаты IQ/OQ.
• Нельзя менять имена колонок без обновления валидатора и тестовых сценариев.
• Исходный CSV, output.json и версия утилиты должны храниться вместе как пакет доказательств.
• Любое изменение правил контроля должно проходить change control и повторную проверку OQ-сценариев.