TreatmentChartAuditor

1. Scope

The Treatment Chart Auditor utility is used for Treatment Chart Auditor. The actual input.csv is the source of truth for the input structure; control criteria are defined by the executable and the domain description.

The utility does not use machine learning; decisions are produced by deterministic rules.

Categories: Radiation physics

Tags: activity, brachytherapy, dosimetry, source calibration, TG-43

2. Execution modes

TreatmentChartAuditor.exe                            → demo mode
TreatmentChartAuditor.exe input.csv output.json      → audit data (first record only)

3. Key controlled areas

• pH and physicochemical parameters
• activity, decay and radiochemical purity

5. URS — user requirements

6. input.csv data contract

The source of truth for the input schema is the actual input.csv header. Column names are technical identifiers and are not translated.

CSV example

PatientID,PlanName,PrescribedDoseGy,PlanDoseGy,TotalFractions,DeliveredFractions,StartDate,EndDate,PhysicianSigned,PhysicistSigned,TechnologistChecked,ConsentFormPresent
PT-2026-LUNG-05,Lung_SBRT_5fx,50.0,50.0,5,2,2026-04-01T09:00:00Z,2026-04-10T09:00:00Z,True,False,True,True

7. FS — functional specification

8. output.json contract

The output file must be suitable for automated processing, audit review and correlation with the source input.csv row.

{
  "utility": "TreatmentChartAuditor",
  "api": "Treatment Chart Auditor",
  "batchNumber": "",
  "overallStatus": "PASS|WARNING|FAIL",
  "checkedAtUtc": "2026-05-18T00:00:00Z",
  "checks": [
    {
      "parameter": "PatientID",
      "value": "PT-2026-LUNG-05",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "PlanName",
      "value": "Lung_SBRT_5fx",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "PrescribedDoseGy",
      "value": "50.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "PlanDoseGy",
      "value": "50.0",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "TotalFractions",
      "value": "5",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "DeliveredFractions",
      "value": "2",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "StartDate",
      "value": "2026-04-01T09:00:00Z",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    },
    {
      "parameter": "EndDate",
      "value": "2026-04-10T09:00:00Z",
      "unit": "as specified",
      "status": "PASS|WARNING|FAIL",
      "message": "Rule-based check result"
    }
  ],
  "criticalFindings": [],
  "sourceFile": "input.csv"
}

9. OQ/PQ test scenarios

10. QA/QC, CSV and change control

• Before production use, the client records executable version, checksum, specification/monograph version, test CSV, expected JSON and IQ/OQ results.
• Column names must not be changed without updating the validator and test scenarios.
• The source CSV, output.json and utility version should be stored together as an evidence package.
• Any change in control rules must go through change control and repeated OQ scenario verification.