ShieldingCalculator

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

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

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

Категории: Radiation physics

Теги: activity, brachytherapy, dosimetry, source calibration, TG-43

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

ShieldingCalculator.exe                            → демо-режим
ShieldingCalculator.exe input.csv output.json      → расчет данных (первая запись)

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

• радиоактивность, распад и радиохимическая чистота

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

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

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

Пример CSV

RoomID,BarrierType,WorkloadGyPerWeek,UseFactor,OccupancyFactor,DistanceM,DesignDoseSvPerWeek,ExistingThicknessCm,HVL_Cm,TVL_Cm
CT-Room-01_Barrier_North,Secondary,100.0,1.0,0.2,3.5,0.0001,20.0,2.5,8.3

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

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

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

{
  "utility": "ShieldingCalculator",
  "api": "Shielding Calculator",
  "batchNumber": "",
  "overallStatus": "PASS|WARNING|FAIL",
  "checkedAtUtc": "2026-05-18T00:00:00Z",
  "checks": [
    {
      "parameter": "RoomID",
      "value": "CT-Room-01_Barrier_North",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "BarrierType",
      "value": "Secondary",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "WorkloadGyPerWeek",
      "value": "100.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "UseFactor",
      "value": "1.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "OccupancyFactor",
      "value": "0.2",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "DistanceM",
      "value": "3.5",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "DesignDoseSvPerWeek",
      "value": "0.0001",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Результат проверки по правилу"
    },
    {
      "parameter": "ExistingThicknessCm",
      "value": "20.0",
      "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-сценариев.