TcmPesticideMultiResidueQualityChecker

Tcm Pesticide Multi Residue

TCM Traditional Chinese Medicine Herbal Botanical BHP Chinese Pharmacopoeia CSV→JSON URS & FS
Открыть подборку
TCM Pesticide Multi-Residue Quality Checker — Мультиостаточный анализ пестицидов в ТКМ

ℹ️ Утилита проверяет содержание ключевых классов пестицидов согласно ChP 2020 (Глава 2341) и регламентам ЕС:
• Органохлориновые: ГХЦГ (BHC) ≤200 ppb, ДДТ (DDT) ≤200 ppb, PCNB ≤100 ppb, HCB ≤100 ppb
• Фосфорорганические: Хлорпирифос ≤100 ppb, Диазинон, Паратион-метил
• Пиретроиды: Циперметрин ≤500 ppb, Бифентрин
• Гербициды: Глифосат ≤100 ppb
• Общее количество обнаруженных пестицидов (индикатор агрокультуры)

⚠️ КРИТИЧНО: Органохлориновые пестициды (ДДТ, ГХЦГ) ЗАПРЕЩЕНЫ во всём мире, но сохраняются в почве 20-50 лет!
Их наличие в ТКМ часто связано не с применением, а с загрязнением почвы.
Эффект «коктейля»: сочетание нескольких пестицидов может быть токсичнее суммы отдельных веществ.

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

Формат input.csv:
BatchNumber,HerbName,BHC_Total_ppb,DDT_Total_ppb,Quintozene_ppb,HCB_ppb,Chlorpyrifos_ppb,Diazinon_ppb,Parathion_Methyl_ppb,Cypermethrin_ppb,Bifenthrin_ppb,Glyphosate_ppb,TotalDetectedCount

Пример:
TCM-GINSENG-2026-PEST-001,Panax_ginseng,50.0,80.0,30.0,20.0,40.0,10.0,0.0,200.0,15.0,50.0,6

Классы риска по сырью:
• Корневища (Женьшень, Нотоженьшень) — накапливают стойкие органохлорины из почвы
• Листья и цветы (Чай, Хризантема) — прямой контакт с опрыскиванием (пиретроиды, ФОС)
• Семена и плоды — системные пестициды и фунгициды
• Солодка, Астрагал — риск загрязнения из-за длительного цикла выращивания

— ЗАЧЕМ ЭТО НУЖНО?
Пестициды — основной источник химической токсичности в растительном сырье:
• Используются интенсивно в сельском хозяйстве для защиты урожая
• Многие обладают нейротоксическим, канцерогенным и эндокринно-разрушающим действием
• Способны биоаккумулироваться в организме человека
• Экспорт ТКМ требует строгого соответствия MRLs (Maximum Residue Limits) стран-импортёров

⚠️ КРИТИЧЕСКИ ВАЖНО:
• ГХЦГ и ДДТ ≤200 ppb — запрещённые вещества, лимиты установлены на уровне фонового загрязнения
• PCNB и HCB ≤100 ppb — фунгициды с высокой персистентностью и токсичностью
• Хлорпирифос ≤100 ppb — нейротоксин, запрещён в ЕС и США, но встречается в импортном сырье
• Циперметрин ≤500 ppb — относительно безопасный пиретроид, но частый контаминант
• Глифосат ≤100 ppb — самый распространённый гербицид, спорная канцерогенность
• Total Detected Count > 5 — маркер интенсивной химизации плантации

Ключевые особенности утилиты:
• Скрининг наиболее опасных и распространённых классов пестицидов
• Раздельный контроль запрещённых (POPs) и разрешённых веществ
• Оценка риска поликонтаминации («коктейльный эффект»)
• Соответствие ChP 2020 Chapter 2341 и EU Reg. 396/2005
• Поддержка различных матриц (корни, листья, семена)

Критические параметры:
• BHC Total: ≤200 ppb
• DDT Total: ≤200 ppb
• Quintozene (PCNB): ≤100 ppb
• HCB: ≤100 ppb
• Chlorpyrifos: ≤100 ppb
• Cypermethrin: ≤500 ppb
• Glyphosate: ≤100 ppb

💡 Советы по использованию:
1. Анализ проводится методами GC-MS/MS (для летучих) и LC-MS/MS (для полярных, например, глифосата)
2. Используйте метод QuEChERS для эффективной экстракции пестицидов из сложных матриц ТКМ
3. Для глифосата требуется отдельная дериватизация или специализированная колонка
4. При обнаружении запрещённых пестицидов (ДДТ, ГХЦГ) выше фона рассмотрите смену поставщика региона
5. Регулярный мониторинг помогает выявить сезонные пики применения агрохимикатов

⚠️ Особенность: В отличие от синтетических примесей, профиль пестицидов в ТКМ НЕПРЕДСКАЗУЕМ и зависит от географии, погоды и добросовестности фермера. Одна и та же ботаническая вида из разных провинций может иметь кардинально разные профили загрязнения. Мультирезидуальный анализ (скрининг сотен веществ) является ЗОЛОТЫМ СТАНДАРТОМ безопасности, так как целевой анализ только на 4-5 веществ пропускает до 80% реальных контаминантов.

input.csv

BatchNumber,HerbName,BHC_Total_ppb,DDT_Total_ppb,Quintozene_ppb,HCB_ppb,Chlorpyrifos_ppb,Diazinon_ppb,Parathion_Methyl_ppb,Cypermethrin_ppb,Bifenthrin_ppb,Glyphosate_ppb,TotalDetectedCount
TCM-GINSENG-2026-PEST-001,Panax_ginseng,50.0,80.0,30.0,20.0,40.0,10.0,0.0,200.0,15.0,50.0,6
TCM-LICORICE-2026-PEST-002,Glycyrrhiza_uralensis,180.0,150.0,90.0,80.0,20.0,5.0,0.0,100.0,10.0,30.0,8
TCM-NOTOGINSENG-FAIL-003,Panax_notoginseng,250.0,300.0,120.0,110.0,150.0,50.0,10.0,600.0,80.0,200.0,12
TCM-CHAMOMILE-2026-PEST-004,Matricaria_chamomilla,10.0,15.0,5.0,2.0,5.0,0.0,0.0,50.0,2.0,10.0,4
TcmPesticideMultiResidueQualityChecker — URS/FS Documentation

TcmPesticideMultiResidueQualityChecker — URS & FS

TCM Pesticide Multi-Residue Quality Checker

TCM Pesticide Multi-Residue Quality Checker

FUZKK Pharma Utilities URS / FS / CSV-ready documentation Generated: 2026-06-23 Path: East/tkm/data/apps/TcmPesticideMultiResidueQualityChecker

1. Назначение документа

Документ описывает пользовательские требования (URS) и функциональную спецификацию (FS) для утилиты TcmPesticideMultiResidueQualityChecker. Утилита предназначена для детерминированной проверки данных input.csv, формирования структурированного результата output.json и поддержки прослеживаемого QA/QC review.

Документ является проектной URS/FS-основой для CSV/CSA, IQ/OQ/PQ и дальнейшей валидации в контексте конкретной лабораторной процедуры.

2. Исходное описание утилиты

TCM Pesticide Multi-Residue Quality Checker — Мультиостаточный анализ пестицидов в ТКМ ℹ️ Утилита проверяет содержание ключевых классов пестицидов согласно ChP 2020 (Глава 2341) и регламентам ЕС: • Органохлориновые: ГХЦГ (BHC) ≤200 ppb, ДДТ (DDT) ≤200 ppb, PCNB ≤100 ppb, HCB ≤100 ppb • Фосфорорганические: Хлорпирифос ≤100 ppb, Диазинон, Паратион-метил • Пиретроиды: Циперметрин ≤500 ppb, Бифентрин • Гербициды: Глифосат ≤100 ppb • Общее количество обнаруженных пестицидов (индикатор агрокультуры) ⚠️ КРИТИЧНО: Органохлориновые пестициды (ДДТ, ГХЦГ) ЗАПРЕЩЕНЫ во всём мире, но сохраняются в почве 20-50 лет! Их наличие в ТКМ часто связано не с применением, а с загрязнением почвы. Эффект «коктейля»: сочетание нескольких пестицидов может быть токсичнее суммы отдельных веществ. Использование: TcmPesticideMultiResidueQualityChecker.exe → демо-режим (вывод в консоль) TcmPesticideMultiResidueQualityChecker.exe input.csv output.json → оценка ваших данных Формат input.csv: BatchNumber,HerbName,BHC_Total_ppb,DDT_Total_ppb,Quintozene_ppb,HCB_ppb,Chlorpyrifos_ppb,Diazinon_ppb,Parathion_Methyl_ppb,Cypermethrin_ppb,Bifenthrin_ppb,Glyphosate_ppb,TotalDetectedCount Пример: TCM-GINSENG-2026-PEST-001,Panax_ginseng,50.0,80.0,30.0,20.0,40.0,10.0,0.0,200.0,15.0,50.0,6 Классы риска по сырью: • Корневища (Женьшень, Нотоженьшень) — накапливают стойкие органохлорины из почвы • Листья и цветы (Чай, Хризантема) — прямой контакт с опрыскиванием (пиретроиды, ФОС) • Семена и плоды — системные пестициды и фунгициды • Солодка, Астрагал — риск загрязнения из-за длительного цикла выращивания — ЗАЧЕМ ЭТО НУЖНО? Пестициды — основной источник химической токсичности в растительном сырье: • Используются интенсивно в сельском хозяйстве для защиты урожая • Многие обладают нейротоксическим, канцерогенным и эндокринно-разрушающим действием • Способны биоаккумулироваться в организме человека • Экспорт ТКМ требует строгого соответствия MRLs (Maximum Residue Limits) стран-импортёров ⚠️ КРИТИЧЕСКИ ВАЖНО: • ГХЦГ и ДДТ ≤200 ppb — запрещённые вещества, лимиты установлены на уровне фонового загрязнения • PCNB и HCB ≤100 ppb — фунгициды с высокой персистентностью и токсичностью • Хлорпирифос ≤100 ppb — нейротоксин, запрещён в ЕС и США, но встречается в импортном сырье • Циперметрин ≤500 ppb — относительно безопасный пиретроид, но частый контаминант • Глифосат ≤100 ppb — самый распространённый гербицид, спорная канцерогенность • Total Detected Count > 5 — маркер интенсивной химизации плантации Ключевые особенности утилиты: • Скрининг наиболее опасных и распространённых классов пестицидов • Раздельный контроль запрещённых (POPs) и разрешённых веществ • Оценка риска поликонтаминации («коктейльный эффект») • Соответствие ChP 2020 Chapter 2341 и EU Reg. 396/2005 • Поддержка различных матриц (корни, листья, семена) Критические параметры: • BHC Total: ≤200 ppb • DDT Total: ≤200 ppb • Quintozene (PCNB): ≤100 ppb • HCB: ≤100 ppb • Chlorpyrifos: ≤100 ppb • Cypermethrin: ≤500 ppb • Glyphosate: ≤100 ppb 💡 Советы по использованию: 1. Анализ проводится методами GC-MS/MS (для летучих) и LC-MS/MS (для полярных, например, глифосата) 2. Используйте метод QuEChERS для эффективной экстракции пестицидов из сложных матриц ТКМ 3. Для глифосата требуется отдельная дериватизация или специализированная колонка 4. При обнаружении запрещённых пестицидов (ДДТ, ГХЦГ) выше фона рассмотрите смену поставщика региона 5. Регулярный мониторинг помогает выявить сезонные пики применения агрохимикатов ⚠️ Особенность: В отличие от синтетических примесей, профиль пестицидов в ТКМ НЕПРЕДСКАЗУЕМ и зависит от географии, погоды и добросовестности фермера. Одна и та же ботаническая вида из разных провинций может иметь кардинально разные профили загрязнения. Мультирезидуальный анализ (скрининг сотен веществ) является ЗОЛОТЫМ СТАНДАРТОМ безопасности, так как целевой анализ только на 4-5 веществ пропускает до 80% реальных контаминантов.

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

3.1 Цель и область применения

Система должна принимать табличные результаты лабораторного контроля, выполнять проверку по заранее заданным критериям и возвращать понятный статус по каждой серии/записи: Pass, Review или Fail.

3.2 Нормативная / методическая база

В исходном описании и правилах утилиты используются следующие ориентиры: ChP 2020, ChP, EP. Финальные лимиты должны быть подтверждены утверждённой спецификацией, монографией, SOP или протоколом трансфера метода.

3.3 Ключевые QC-проверки

  • Органохлориновые: ГХЦГ (BHC) ≤200 ppb, ДДТ (DDT) ≤200 ppb, PCNB ≤100 ppb, HCB ≤100 ppb
  • Фосфорорганические: Хлорпирифос ≤100 ppb, Диазинон, Паратион-метил
  • Пиретроиды: Циперметрин ≤500 ppb, Бифентрин
  • Гербициды: Глифосат ≤100 ppb
  • Общее количество обнаруженных пестицидов (индикатор агрокультуры)
  • Корневища (Женьшень, Нотоженьшень) — накапливают стойкие органохлорины из почвы
  • Листья и цветы (Чай, Хризантема) — прямой контакт с опрыскиванием (пиретроиды, ФОС)
  • Семена и плоды — системные пестициды и фунгициды

3.4 Пользователи

  • QC analyst — подготовка и загрузка input.csv.
  • QA/QC reviewer — проверка результата и отклонений.
  • CSV/validation specialist — подтверждение пригодности утилиты.
  • System owner — управление версией, доступом и изменениями.

3.5 Требования к данным и Data Integrity

  • каждая строка CSV должна быть прослеживаемой к серии, образцу или измерению;
  • исходные значения не должны изменяться утилитой;
  • расчёты должны быть воспроизводимыми при повторном запуске;
  • любое отклонение должно сохраняться как структурированное finding с указанием поля и правила;
  • ручное изменение итогового статуса вне QA-процесса не допускается.

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

4.1 Поток обработки

  1. Проверить наличие и кодировку input.csv.
  2. Проверить заголовки, обязательные поля и типы данных.
  3. Нормализовать числовые и булевы значения без изменения исходного следа.
  4. Выбрать набор правил по категории продукта/типа, если он предусмотрен.
  5. Сравнить значения с лимитами и вычислить derived metrics.
  6. Сформировать запись результата по каждой строке.
  7. Сохранить output.json с общей сводкой, findings и traceability.

4.2 CSV-схема

№Поле CSVТипОбяз.Назначение
1BatchNumberstringДаИдентификатор серии / лота для прослеживаемости.
2HerbNamestringДаИдентичность продукта, препарата или образца.
3BHC_Total_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
4DDT_Total_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
5Quintozene_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
6HCB_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
7Chlorpyrifos_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
8Diazinon_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
9Parathion_Methyl_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
10Cypermethrin_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
11Bifenthrin_ppbdecimalДаИзмеренный аналитический результат для сравнения с критерием приемлемости.
12Glyphosate_ppbdecimalДаПоказатель pH для контроля качества и совместимости матрицы.
13TotalDetectedCountintegerДаБинарный признак обнаружения для правил нулевой толерантности или предупреждений.

4.3 Пример входных данных

BatchNumberHerbNameBHC_Total_ppbDDT_Total_ppbQuintozene_ppbHCB_ppbChlorpyrifos_ppbDiazinon_ppbParathion_Methyl_ppbCypermethrin_ppbBifenthrin_ppbGlyphosate_ppbTotalDetectedCount
TCM-GINSENG-2026-PEST-001Panax_ginseng50.080.030.020.040.010.00.0200.015.050.06
TCM-LICORICE-2026-PEST-002Glycyrrhiza_uralensis180.0150.090.080.020.05.00.0100.010.030.08
TCM-NOTOGINSENG-FAIL-003Panax_notoginseng250.0300.0120.0110.0150.050.010.0600.080.0200.012
TCM-CHAMOMILE-2026-PEST-004Matricaria_chamomilla10.015.05.02.05.00.00.050.02.010.04

4.4 Выходной JSON

{
  "utility": "TcmPesticideMultiResidueQualityChecker",
  "runId": "urn:fuzkk:run:example",
  "sourceFile": "input.csv",
  "recordsProcessed": 4,
  "overallStatus": "Pass / Review / Fail",
  "records": [
    {
      "recordId": "TCM-GINSENG-2026-PEST-001",
      "status": "Pass / Review / Fail",
      "criticalFindings": [],
      "warnings": [],
      "evaluatedRules": [
        "Configured acceptance criteria from the utility rule set"
      ],
      "inputTrace": {
        "BatchNumber": "TCM-GINSENG-2026-PEST-001",
        "HerbName": "Panax_ginseng",
        "BHC_Total_ppb": "50.0",
        "DDT_Total_ppb": "80.0",
        "Quintozene_ppb": "30.0",
        "HCB_ppb": "20.0",
        "Chlorpyrifos_ppb": "40.0",
        "Diazinon_ppb": "10.0"
      }
    }
  ],
  "dataIntegrity": {
    "deterministicEvaluation": true,
    "sourceRowTraceability": true,
    "manualOverrideAllowed": false
  }
}

5. Трассировка URS → FS → тесты

URSFS-механизмПроверка
Загрузка корректного input.csvCSV parser + schema validatorOQ: валидный/невалидный CSV
Детерминированная оценка лимитовRule engine с фиксированной конфигурациейOQ: граничные значения и known expected results
Статусы Pass/Review/FailStatus aggregator по findingsOQ/PQ: образцы с проходными и провальными сериями
Прослеживаемость к исходной строкеinputTrace + recordIdPQ: сверка output.json с исходным CSV
Поддержка QA reviewструктурированные findings и warningsPQ: review сценарии и deviation handling

6. CSV/CSA и валидационный подход

IQ

  • проверка версии утилиты;
  • проверка расположения исполняемого файла;
  • проверка шаблона CSV;
  • контроль прав доступа.

OQ

  • проверка обязательных полей;
  • проверка типов данных;
  • проверка граничных значений;
  • проверка zero-tolerance правил.

PQ

  • прогоны на реальных/репрезентативных данных;
  • сверка с ручным расчётом;
  • подтверждение QA review workflow.

Change control

  • версионирование лимитов;
  • impact assessment при изменении правил;
  • регрессия после обновления.

1. Document purpose

This document defines user requirements (URS) and functional specification (FS) for TcmPesticideMultiResidueQualityChecker. The utility is intended to evaluate input.csv data deterministically, generate structured output.json output and support traceable QA/QC review.

This document is a project-level URS/FS baseline for CSV/CSA, IQ/OQ/PQ and further validation under an approved laboratory procedure.

2. Source utility description

TCM Pesticide Multi-Residue Quality Checker — Pesticide Multi-Residue Analysis in TCM ℹ️ Utility checks content of key pesticide classes according to ChP 2020 (Chapter 2341) and EU regulations: • Organochlorines: BHC Total ≤200 ppb, DDT Total ≤200 ppb, PCNB ≤100 ppb, HCB ≤100 ppb • Organophosphates: Chlorpyrifos ≤100 ppb, Diazinon, Parathion-methyl • Pyrethroids: Cypermethrin ≤500 ppb, Bifenthrin • Herbicides: Glyphosate ≤100 ppb • Total number of detected pesticides (indicator of agricultural practice) ⚠️ CRITICAL: Organochlorine pesticides (DDT, BHC) are BANNED worldwide but persist in soil for 20-50 years! Their presence in TCM is often due to soil contamination rather than direct application. "Cocktail effect": combination of several pesticides may be more toxic than sum of individual substances. Usage: TcmPesticideMultiResidueQualityChecker.exe → demo mode (console output) TcmPesticideMultiResidueQualityChecker.exe input.csv output.json → evaluate your data Input format: BatchNumber,HerbName,BHC_Total_ppb,DDT_Total_ppb,Quintozene_ppb,HCB_ppb,Chlorpyrifos_ppb,Diazinon_ppb,Parathion_Methyl_ppb,Cypermethrin_ppb,Bifenthrin_ppb,Glyphosate_ppb,TotalDetectedCount Example: TCM-GINSENG-2026-PEST-001,Panax_ginseng,50.0,80.0,30.0,20.0,40.0,10.0,0.0,200.0,15.0,50.0,6 Risk categories by raw material: • Rhizomes (Ginseng, Notoginseng) — accumulate persistent organochlorines from soil • Leaves and flowers (Tea, Chrysanthemum) — direct contact with spraying (pyrethroids, OPs) • Seeds and fruits — systemic pesticides and fungicides • Licorice, Astragalus — risk of contamination due to long cultivation cycle — WHY IS THIS NEEDED? Pesticides are the main source of chemical toxicity in herbal raw materials: • Used intensively in agriculture for crop protection • Many have neurotoxic, carcinogenic and endocrine-disrupting effects • Capable of bioaccumulation in human body • TCM export requires strict compliance with MRLs (Maximum Residue Limits) of importing countries ⚠️ CRITICAL: • BHC and DDT ≤200 ppb — banned substances, limits set at background contamination level • PCNB and HCB ≤100 ppb — fungicides with high persistence and toxicity • Chlorpyrifos ≤100 ppb — neurotoxin, banned in EU and USA, but found in imported raw materials • Cypermethrin ≤500 ppb — relatively safe pyrethroid, but frequent contaminant • Glyphosate ≤100 ppb — most common herbicide, controversial carcinogenicity • Total Detected Count > 5 — marker of intensive chemical farming Key features: • Screening of most dangerous and common pesticide classes • Separate control of banned (POPs) and permitted substances • Polycontamination risk assessment ("cocktail effect") • Compliance with ChP 2020 Chapter 2341 and EU Reg. 396/2005 • Support for various matrices (roots, leaves, seeds) Critical parameters: • BHC Total: ≤200 ppb • DDT Total: ≤200 ppb • Quintozene (PCNB): ≤100 ppb • HCB: ≤100 ppb • Chlorpyrifos: ≤100 ppb • Cypermethrin: ≤500 ppb • Glyphosate: ≤100 ppb 💡 Usage tips: 1. Analysis performed by GC-MS/MS (for volatiles) and LC-MS/MS (for polar compounds e.g. glyphosate) 2. Use QuEChERS method for efficient pesticide extraction from complex TCM matrices 3. Glyphosate requires separate derivatization or specialized column 4. If banned pesticides (DDT, BHC) detected above background, consider changing supplier region 5. Regular monitoring helps identify seasonal peaks of agrochemical application ⚠️ Note: Unlike synthetic impurities, pesticide profile in TCM is UNPREDICTABLE and depends on geography, weather and farmer integrity. Same botanical species from different provinces may have drastically different contamination profiles. Multi-residue analysis (screening of hundreds of substances) is the GOLD STANDARD of safety, as targeted analysis of only 4-5 substances misses up to 80% of real contaminants.

3. URS — user requirements

3.1 Intended use and scope

The system shall accept tabular laboratory QC results, evaluate them against configured acceptance criteria and return a clear status for each batch or record: Pass, Review or Fail.

3.2 Regulatory / methodological basis

The source description and utility rules refer to the following framework: ChP 2020, ChP, EP. Final acceptance limits shall be confirmed by the approved specification, pharmacopoeial monograph, SOP or method-transfer protocol.

3.3 Key QC checks

  • Organochlorines: BHC Total ≤200 ppb, DDT Total ≤200 ppb, PCNB ≤100 ppb, HCB ≤100 ppb
  • Organophosphates: Chlorpyrifos ≤100 ppb, Diazinon, Parathion-methyl
  • Pyrethroids: Cypermethrin ≤500 ppb, Bifenthrin
  • Herbicides: Glyphosate ≤100 ppb
  • Total number of detected pesticides (indicator of agricultural practice)
  • Rhizomes (Ginseng, Notoginseng) — accumulate persistent organochlorines from soil
  • Leaves and flowers (Tea, Chrysanthemum) — direct contact with spraying (pyrethroids, OPs)
  • Seeds and fruits — systemic pesticides and fungicides

3.4 Users

  • QC analyst — prepares and loads input.csv.
  • QA/QC reviewer — reviews output, findings and deviations.
  • CSV/validation specialist — confirms fitness for intended use.
  • System owner — controls versioning, access and change management.

3.5 Data and data-integrity requirements

  • each CSV row shall be traceable to a batch, sample or analytical measurement;
  • source values shall not be modified by the utility;
  • calculations shall be reproducible on repeated execution;
  • each deviation shall be captured as a structured finding with field and rule references;
  • manual override of the final status outside QA process is not allowed.

4. FS — functional specification

4.1 Processing flow

  1. Verify presence and encoding of input.csv.
  2. Validate headers, mandatory fields and data types.
  3. Normalize numeric and boolean values while preserving the source trace.
  4. Select an adaptive rule set by product/category type, where applicable.
  5. Compare values with limits and compute derived metrics.
  6. Create a result record for each input row.
  7. Write output.json with summary, findings and traceability.

4.2 CSV schema

#CSV fieldTypeReq.Purpose
1BatchNumberstringYesBatch / lot identifier used for traceability.
2HerbNamestringYesProduct, preparation or sample identity.
3BHC_Total_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
4DDT_Total_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
5Quintozene_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
6HCB_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
7Chlorpyrifos_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
8Diazinon_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
9Parathion_Methyl_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
10Cypermethrin_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
11Bifenthrin_ppbdecimalYesMeasured analytical result compared with the configured acceptance criterion.
12Glyphosate_ppbdecimalYespH-related measurement used for quality and matrix compatibility control.
13TotalDetectedCountintegerYesBinary detection flag used for zero-tolerance or warning rules.

4.3 Input data example

BatchNumberHerbNameBHC_Total_ppbDDT_Total_ppbQuintozene_ppbHCB_ppbChlorpyrifos_ppbDiazinon_ppbParathion_Methyl_ppbCypermethrin_ppbBifenthrin_ppbGlyphosate_ppbTotalDetectedCount
TCM-GINSENG-2026-PEST-001Panax_ginseng50.080.030.020.040.010.00.0200.015.050.06
TCM-LICORICE-2026-PEST-002Glycyrrhiza_uralensis180.0150.090.080.020.05.00.0100.010.030.08
TCM-NOTOGINSENG-FAIL-003Panax_notoginseng250.0300.0120.0110.0150.050.010.0600.080.0200.012
TCM-CHAMOMILE-2026-PEST-004Matricaria_chamomilla10.015.05.02.05.00.00.050.02.010.04

4.4 Output JSON

{
  "utility": "TcmPesticideMultiResidueQualityChecker",
  "runId": "urn:fuzkk:run:example",
  "sourceFile": "input.csv",
  "recordsProcessed": 4,
  "overallStatus": "Pass / Review / Fail",
  "records": [
    {
      "recordId": "TCM-GINSENG-2026-PEST-001",
      "status": "Pass / Review / Fail",
      "criticalFindings": [],
      "warnings": [],
      "evaluatedRules": [
        "Configured acceptance criteria from the utility rule set"
      ],
      "inputTrace": {
        "BatchNumber": "TCM-GINSENG-2026-PEST-001",
        "HerbName": "Panax_ginseng",
        "BHC_Total_ppb": "50.0",
        "DDT_Total_ppb": "80.0",
        "Quintozene_ppb": "30.0",
        "HCB_ppb": "20.0",
        "Chlorpyrifos_ppb": "40.0",
        "Diazinon_ppb": "10.0"
      }
    }
  ],
  "dataIntegrity": {
    "deterministicEvaluation": true,
    "sourceRowTraceability": true,
    "manualOverrideAllowed": false
  }
}

5. Traceability URS → FS → tests

URSFS mechanismTest evidence
Load valid input.csvCSV parser + schema validatorOQ: valid/invalid CSV cases
Deterministic limit evaluationRule engine with fixed configurationOQ: boundary values and known expected results
Pass/Review/Fail statusesStatus aggregator based on findingsOQ/PQ: passing and failing representative batches
Traceability to source rowinputTrace + recordIdPQ: output.json reconciliation to source CSV
QA review supportstructured findings and warningsPQ: review and deviation-handling scenarios

6. CSV/CSA and validation approach

IQ

  • utility version check;
  • executable location check;
  • CSV template check;
  • access-right verification.

OQ

  • mandatory field checks;
  • data type checks;
  • boundary-value checks;
  • zero-tolerance rule checks.

PQ

  • runs on real or representative data;
  • comparison with manual calculation;
  • confirmation of QA review workflow.

Change control

  • rule and limit versioning;
  • impact assessment for rule changes;
  • regression after updates.
Generated for FUZKK Pharma Utilities. This URS/FS documentation must be reviewed and approved under the applicable site quality system before regulated use.

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

Традиционная китайская медицина (ТКМ)

Пакет QC-утилит для ТКМ: botanical identity, fingerprint consistency, marker compounds, decoction pieces, Paozhi processing, pesticides, mycotoxins, heavy metals, sulfur fumigation, microbial limits and adulteration screening.

Открыть