BatchReleaseCertificateBuilder

Batch Release Certificate Builder

Vet veterinary veterinary vaccines animal health adjuvants aquaculture batch release CSV→JSON

Описание утилиты: Batch Release Certificate Builder

Batch Release Certificate Builder — Генератор сертификатов выпуска (CoA)

ℹ️  Утилита выполняет автоматизированную сборку и валидацию данных для Сертификата анализа (Certificate of Analysis) согласно требованиям GMP Annex 16 и 21 CFR Part 211.194:
     • Агрегация данных: Сбор результатов из различных лабораторных модулей (HPLC, GC, Wet Chem, Micro).
     • Проверка спецификаций: Сравнение полученных значений с утвержденными пределами (Numeric limits и Textual criteria).
     • Формирование вердикта: Автоматическое определение статуса партии (Compliant/Non-Compliant).
     • Генерация метаданных: Включение дат производства, срока годности и условий хранения.

⚠️  ВАЖНО: 
     • Утилита обрабатывает только лабораторные данные. Она не проверяет отклонения в производстве (Deviation Management).
     • Окончательное решение о выпуске (Batch Certification) принимает уполномоченное лицо (QP).

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

Формат input.csv:
BatchNumber,ProductName,TestName,NumericResult,StringResult,Unit,SpecLower,SpecUpper,SpecText,MfgDate,ExpDate

Пример:
  BATCH-001,Drug X,Assay,99.5,,%,98.0,102.0,,2026-01-01,2028-01-01

📍 Область применения (Usage Where):
     • Отдел контроля качества (QC): Финальная проверка перед передачей досье в QA.
     • Уполномоченное лицо (QP): Инструмент для быстрого обзора критических параметров.
     • Регуляторные инспекции: Демонстрация целостности данных и прозрачности процесса выпуска.
     • Интеграция с LIMS: Экспорт готовых сертификатов для клиентов или регуляторов.

— ЗАЧЕМ ЭТО НУЖНО?
Ручное перенесение десятков результатов тестов в шаблон сертификата подвержено ошибкам транскрипции.
Автоматизация гарантирует, что в финальный документ попадут только проверенные и валидные данные.
Это критически важно для соблюдения принципов Data Integrity (ALCOA+) и ускорения цикла выпуска продукции.

⚠️  КРИТИЧЕСКИ ВАЖНО:
• Полнота данных: Все обязательные тесты (Monographed tests) должны быть представлены в файле.
• Статус OOS: Любой результат, выходящий за спецификацию, автоматически блокирует выпуск.
• Единицы измерения: Должны строго соответствовать фармакопейным статьям.
• Версионность спецификаций: Убедитесь, что используются актуальные лимиты.

Ключевые особенности утилиты:
• Поддержка числовых и текстовых критериев приемлемости
• Автоматический расчет общего статуса соответствия
• Включение метаданных о сроке годности и хранении
• Структурированный JSON-вывод для электронных систем
• Соответствие требованиям к оформлению сертификатов качества

Критические параметры:
• Assay/Potency: Основное действующее вещество
• Impurities: Примеси (Related substances)
• Microbiology: Стерильность/Бионагрузка
• Dissolution: Растворение (для твердых форм)
• Physical Properties: pH, Appearance, Identification

💡 Советы по использованию:
1. Валидация источника: Убедитесь, что входной CSV экспортируется из валидированной LIMS.
2. Обзор исключений: Даже при статусе "Compliant" QP должен проверить наличие закрытых отклонений.
3. Архивирование: Сохраняйте сгенерированные JSON как часть электронного досье серии.
4. Безопасность: Доступ к утилите должен быть ограничен авторизованным персоналом.
5. Печать: Используйте JSON для автоматической генерации PDF-сертификатов с защитой от подделки.

⚠️ Примечание: Данная утилита является инструментом технической консолидации данных. Она не заменяет экспертную оценку качества производственного процесса, но обеспечивает точность лабораторной части сертификата выпуска.

input.csv

BatchNumber,ProductName,TestName,NumericResult,StringResult,Unit,SpecLower,SpecUpper,SpecText,MfgDate,ExpDate
BATCH-2026-API-001,Paracetamol Tablets 500mg,Assay,99.8,,%,98.0,102.0,,2026-01-15,2028-01-15
BATCH-2026-API-001,Paracetamol Tablets 500mg,Impurity_A,0.05,,%,0.0,0.10,,2026-01-15,2028-01-15
BATCH-2026-API-001,Paracetamol Tablets 500mg,Dissolution_Q,85,,%,80,,,2026-01-15,2028-01-15
BATCH-2026-API-001,Paracetamol Tablets 500mg,Microbial_Limit,0,Pass,CFU/g,,,Pass,2026-01-15,2028-01-15
BATCH-2026-API-001,Paracetamol Tablets 500mg,Water_Content,0.2,,%,0.0,0.5,,2026-01-15,2028-01-15

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

Документ описывает контролируемый интерфейс и поведение утилиты BatchReleaseCertificateBuilder для сценария Batch Release Certificate Builder.

Предметные ограничения URS input.csv FS IQ/OQ/PQ

Предметные ограничения и критические параметры

Ниже приведены ключевые фрагменты исходного описания. Перед продуктивным применением пределы должны быть сверены с утверждённой спецификацией, регистрационным досье и локальными SOP.

ℹ️ Утилита выполняет автоматизированную сборку и валидацию данных для Сертификата анализа (Certificate of Analysis) согласно требованиям GMP Annex 16 и 21 CFR Part 211.194:
• Проверка спецификаций: Сравнение полученных значений с утвержденными пределами (Numeric limits и Textual criteria).
• Формирование вердикта: Автоматическое определение статуса партии (Compliant/Non-Compliant).
⚠️ ВАЖНО:
• Уполномоченное лицо (QP): Инструмент для быстрого обзора критических параметров.
Это критически важно для соблюдения принципов Data Integrity (ALCOA+) и ускорения цикла выпуска продукции.
⚠️ КРИТИЧЕСКИ ВАЖНО:
• Единицы измерения: Должны строго соответствовать фармакопейным статьям.
• Поддержка числовых и текстовых критериев приемлемости
Критические параметры:
• Assay/Potency: Основное действующее вещество
• Microbiology: Стерильность/Бионагрузка

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

ID	Требование	Критичность	Критерий приемки
URS-001	Утилита должна принимать файл input.csv для Batch Release Certificate Builder с заголовками, определёнными в контракте данных.	High	Файл обрабатывается без ручного изменения заголовков.
URS-002	Утилита должна выполнять детерминированную оценку QC/ОКК без машинного обучения и без вероятностного принятия решения о соответствии.	High	При одинаковых входных данных, версии правил и конфигурации результат полностью воспроизводим.
URS-003	Утилита должна валидировать обязательные поля, типы данных, диапазоны, единицы измерения и предметную правдоподобность значений.	High	Ошибки схемы, преобразования и диапазона явно отражаются в результате.
URS-004	Утилита должна применять предметные пределы и правила из описания, утверждённой спецификации, регистрационного досье и локальных SOP.	High	Каждая проверка имеет результат PASS/WARNING/FAIL и понятное сообщение.
URS-005	Утилита должна формировать output.json с машинно-читаемыми результатами, исходными значениями, предупреждениями, отказами и критическими находками.	High	JSON пригоден для LIMS/ELN/MES-интеграции и QA/QC review.
URS-006	Утилита должна сохранять трассируемость между серией/образцом, входным файлом, применёнными правилами и итоговым статусом.	High	Выход содержит идентификаторы, список параметров и audit metadata.
URS-007	Документация должна поддерживать подготовку IQ/OQ/PQ, CSV/CSA и обсуждение с инспекторами или внутренним QA.	Medium	URS, FS, контракт input/output и тестовые сценарии поставляются вместе с утилитой.
URS-008	Утилита должна использоваться как decision-support инструмент QC, а не как замена утверждённым спецификациям и выпускному решению Qualified Person/QA.	Medium	В документации указан контроль change control и необходимость сверки пределов.

Контракт input.csv

#	Поле	Тип	Пример	Назначение
1	`BatchNumber`	string / controlled vocabulary	`BATCH-2026-API-001`	Идентификатор серии/партии для трассируемости.
2	`ProductName`	string / controlled vocabulary	`Paracetamol Tablets 500mg`	Наименование продукта или проверяемой лекарственной формы.
3	`TestName`	string / controlled vocabulary	`Assay`	Контролируемый входной параметр для детерминированных QC-правил.
4	`NumericResult`	string / controlled vocabulary	`99.8`	Результат или статус, применяемый в итоговой классификации.
5	`StringResult`	string / controlled vocabulary		Результат или статус, применяемый в итоговой классификации.
6	`Unit`	string / controlled vocabulary	`%`	Контролируемый входной параметр для детерминированных QC-правил.
7	`SpecLower`	decimal	`98.0`	Контролируемый входной параметр для детерминированных QC-правил.
8	`SpecUpper`	decimal	`102.0`	Контролируемый входной параметр для детерминированных QC-правил.
9	`SpecText`	string / controlled vocabulary		Контролируемый входной параметр для детерминированных QC-правил.
10	`MfgDate`	string / controlled vocabulary	`2026-01-15`	Контролируемый входной параметр для детерминированных QC-правил.
11	`ExpDate`	string / controlled vocabulary	`2028-01-15`	Контролируемый входной параметр для детерминированных QC-правил.

BatchNumber,ProductName,TestName,NumericResult,StringResult,Unit,SpecLower,SpecUpper,SpecText,MfgDate,ExpDate
BATCH-2026-API-001,Paracetamol Tablets 500mg,Assay,99.8,,%,98.0,102.0,,2026-01-15,2028-01-15
BATCH-2026-API-001,Paracetamol Tablets 500mg,Impurity_A,0.05,,%,0.0,0.10,,2026-01-15,2028-01-15
BATCH-2026-API-001,Paracetamol Tablets 500mg,Dissolution_Q,85,,%,80,,,2026-01-15,2028-01-15

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

ID	Поле	Правило	Критичность
VR-001	`BatchNumber`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	High
VR-002	`ProductName`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	High
VR-003	`TestName`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	High
VR-004	`NumericResult`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	Medium
VR-005	`StringResult`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	Medium
VR-006	`Unit`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	Medium
VR-007	`SpecLower`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	Medium
VR-008	`SpecUpper`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	Medium
VR-009	`SpecText`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	Medium
VR-010	`MfgDate`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	Medium
VR-011	`ExpDate`	Поле должно соответствовать утверждённому справочнику/словарю или допустимой строковой форме.	Medium

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

ID	Функция	Реализация
FS-001	CLI execution	Поддержать режимы запуска: demo mode без аргументов и production mode input.csv output.json.
FS-002	CSV import	Прочитать input.csv в UTF-8/CSV-совместимом формате, проверить наличие заголовка и ожидаемых колонок.
FS-003	Schema validation	Проверить обязательные поля, количество колонок, неизвестные ключевые поля и пустые обязательные значения.
FS-004	Type conversion	Преобразовать числовые, флаговые и текстовые значения; некорректный формат фиксировать как ошибку строки.
FS-005	Domain rule engine	Применить правила для Batch Release Certificate Builder, включая критические пределы из описания и утверждённой спецификации.
FS-006	Status aggregation	Сформировать итоговый статус: FAIL при критическом отказе, WARNING при некритическом отклонении, PASS при соответствии.
FS-007	JSON export	Записать output.json с детализацией проверок, исходными значениями, предупреждениями, отказами и critical findings.
FS-008	Audit support	Сохранять структуру результата пригодной для review, расследования отклонений и воспроизведения расчёта.
FS-009	Integration contract	Поддержать сценарий LIMS/ELN/MES → input.csv → utility → output.json → portal/admin review.
FS-010	Error handling	Возвращать явные сообщения для отсутствующего файла, пустого CSV, неверной схемы, ошибки записи output.json и некорректного формата.

Пример output.json

{
  "utilityId": "batchreleasecertificatebuilder",
  "utilityFolder": "BatchReleaseCertificateBuilder",
  "package": "Vet",
  "overallStatus": "PASS|WARNING|FAIL",
  "sourceFile": "input.csv",
  "processedAtUtc": "2026-06-10T00:00:00Z",
  "checks": [
    {
      "parameter": "BatchNumber",
      "value": "BATCH-2026-API-001",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-001"
    },
    {
      "parameter": "ProductName",
      "value": "Paracetamol Tablets 500mg",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-002"
    },
    {
      "parameter": "TestName",
      "value": "Assay",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-003"
    },
    {
      "parameter": "NumericResult",
      "value": "99.8",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-004"
    },
    {
      "parameter": "StringResult",
      "value": "",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-005"
    },
    {
      "parameter": "Unit",
      "value": "%",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-006"
    },
    {
      "parameter": "SpecLower",
      "value": "98.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-007"
    },
    {
      "parameter": "SpecUpper",
      "value": "102.0",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-008"
    },
    {
      "parameter": "SpecText",
      "value": "",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-009"
    },
    {
      "parameter": "MfgDate",
      "value": "2026-01-15",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-010"
    },
    {
      "parameter": "ExpDate",
      "value": "2028-01-15",
      "status": "PASS|WARNING|FAIL",
      "message": "Deterministic rule-based check result",
      "ruleReference": "FS-RULE-011"
    }
  ],
  "criticalFindings": [],
  "warnings": [],
  "audit": {
    "inputHash": "sha256:<calculated at runtime>",
    "rulesVersion": "<utility executable version>",
    "documentation": "BatchReleaseCertificateBuilder.documentation.html"
  }
}

Матрица трассируемости

URS	FS	Тест	Подтверждение
URS-001	FS-001, FS-002	OQ-001	Проверить запуск и импорт валидного input.csv.
URS-002	FS-005, FS-006	OQ-004	Повторить один и тот же набор данных и сравнить output.json.
URS-003	FS-003, FS-004, FS-010	OQ-002, OQ-003	Проверить отсутствующие колонки и неверные типы.
URS-004	FS-005, FS-006	OQ-004, PQ-001	Проверить критические отклонения по реальным/граничным данным.
URS-005	FS-007, FS-009	OQ-005	Проверить JSON schema и пригодность для downstream-систем.
URS-006	FS-008	OQ-006	Проверить наличие идентификаторов и audit metadata.
URS-007	FS-008, FS-010	IQ-001, OQ-007	Проверить комплектность документации и control evidence.
URS-008	FS-005, FS-008	PQ-002	Проверить review workflow и запрет автоматической замены QA-решения.

IQ/OQ/PQ тестовые сценарии

ID	Сценарий	Ожидаемый результат
IQ-001	Проверить наличие executable, input.csv, документации и контрольной суммы.	Комплект поставки полон; версия зафиксирована.
OQ-001	Валидная строка из примера input.csv.	PASS или допустимый WARNING согласно правилам.
OQ-002	Удалить обязательную колонку из CSV.	Ошибка схемы или FAIL с указанием отсутствующей колонки.
OQ-003	Внести нечисловое значение в числовое поле.	Ошибка преобразования типа с указанием строки/поля.
OQ-004	Значение критического параметра вывести за предел.	FAIL и critical finding.
OQ-005	Проверить структуру output.json.	Все обязательные секции присутствуют, JSON валиден.
OQ-006	Проверить трассируемость серии/образца.	Идентификаторы входа и результатов совпадают.
PQ-001	Проверить 3–5 реальных партий/образцов пользователя.	Результат подтверждён QC/QA review.
PQ-002	Проверить workflow отклонения и ручного QA-решения.	Утилита поддерживает review, но не заменяет утверждённое решение.

QA/QC и change control

Не менять имена колонок без обновления валидатора, документации и тестового набора.
Хранить input.csv, output.json, версию исполняемого файла и контрольную сумму.
Перед продуктивным использованием провести IQ/OQ/PQ или эквивалентную CSV/CSA-проверку.
Критические пределы должны быть сверены с утверждённой спецификацией, регистрационным досье и локальными SOP.
Утилита предоставляет формализованный QC decision support, но окончательное решение выпуска остаётся за QA/QP и утверждёнными процедурами.

Входит в пакеты

Vet — ветеринарные QC утилиты

Пакет Vet предназначен для ветеринарной фармацевтики и вакцин: адъюванты, антигены, аутогенные вакцины, аквакультура, корма/премиксы, антибактериальные и паразитарные препараты, стерильность и выпуск серии.

Открыть