AscorbicAcidQualityChecker

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

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

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

Категории: BP monographs, Vitamins and minerals

Теги: API, assay, British Pharmacopoeia, heavy metals, impurities, minerals, monographs, premix, residual solvents, specification, vitamins, water quality

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

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

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

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

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

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

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

Пример CSV

BatchNumber,AssayPercent,OpticalRotation,pH,LossOnDrying,HeavyMetals,ClarityNTU,ColorAPHA,OxalicAcid,RelatedSubstanceA,RelatedSubstanceB,TotalRelatedSubstances,EthanolPPM,AcetonePPM,MethanolPPM
AA-2026-001,99.8,21.0,2.3,0.2,5,2,30,0.1,0.05,0.03,0.18,800,500,200

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

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

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

{
  "utility": "AscorbicAcidQualityChecker",
  "api": "Ascorbic Acid",
  "batchNumber": "AA-2026-001",
  "overallStatus": "PASS|WARNING|FAIL",
  "checkedAtUtc": "2026-05-18T00:00:00Z",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "AA-2026-001",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "AssayPercent",
      "value": "99.8",
      "unit": "%",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "OpticalRotation",
      "value": "21.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "pH",
      "value": "2.3",
      "unit": "pH",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "LossOnDrying",
      "value": "0.2",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "HeavyMetals",
      "value": "5",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "ClarityNTU",
      "value": "2",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "ColorAPHA",
      "value": "30",
      "unit": "as specified",
      "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-сценариев.