SCRS – User manual

SCRS — User Manual

The Sonographic Classified Reporting System (SCRS) is a web-based structured reporting interface for ultrasound examinations. SCRS standardizes data entry, measurement capture, quick-insert abnormality statements, and report export (PDF / Word / Share). This manual describes the interface components, workflow, and tips to create accurate, print-ready sonographic reports.

1. Page Overview

The page is divided into: Patient Details, Protocol & Template, Measurements, Abnormalities, Findings, Conclusion, Attachments, and Preview / Export. Use the top controls to select protocol and template — templates drive measurement fields and pre-formatted report text.

2. Patient Details

Enter patient name, age, gender, patient ID, referring doctor and exam date. These fields are inserted automatically into the report header when you generate the preview. Keep demographic information accurate — it appears on printed/exported reports and is used for legal traceability.

3. Protocol & Template

Choose the examination Protocol (e.g., Abdomen, Obs-&-Fetus, Breast). After selecting a protocol the Template dropdown populates with available templates for that protocol. Selecting a template will:

• Reveal the Measurements panel (fields relevant to the template).
• Populate the Findings editor with a pre-formatted template where measurement placeholders (e.g. {{liver_size}}) will be replaced when you fill values.
• Populate the Abnormalities quick-insert library relevant to that template if available.

4. Measurements

The Measurements panel displays fields (size, diameters, volumes) driven by the chosen template. Enter numeric values into these fields — they auto-fill the corresponding placeholders in the Findings text. Tips:

• Units: Fields show units (mm, cc) — maintain consistent units as shown.
• Auto-update: Changing measurement values immediately updates the Findings editor.
• Fallback: If a template has no predefined schema, SCRS builds a fallback schema with generic size fields and organ lines you can edit.

5. Abnormalities — Quick Insert

The Abnormalities panel exposes commonly used statements organized by organ. Workflow:

1. Select the organ card.
2. Pick the specific abnormality from the dropdown.
3. Click Insert — the finding is appended to the matching organ span in the Findings editor (or created if missing) and a short, de-duplicated conclusion statement is appended to the Conclusion editor.

This feature provides fast, consistent phrasing for frequently encountered conditions (e.g., cholelithiasis, hydronephrosis).

6. Findings & Conclusion Editors

Both fields are rich-text editable. Use the toolbar to Bold, Underline, or Highlight selected text. Guidelines:

• Keep Findings objective (measurement-based, descriptive).
• Conclusions should be concise, interpretive, and actionable (e.g., “Mild hepatic steatosis. Recommend clinical correlation”).
• Avoid definitive diagnostic language unless imaging criteria are unequivocal.

7. Attachments — Images & Files

Use the Attach Images / Files area to upload images (JPG/PNG) or PDFs. You can drag-and-drop or use the Upload button. Uploaded files show thumbnails and can be inserted into the Report Preview. Notes:

• Insert into Report: Adds images after the Conclusion in the Preview; images are embedded as data URIs in-page.
• Clear: Removes staged uploads prior to insertion.
• Privacy: Uploaded images are handled client-side (no server upload in this build) — confirm storage policy before sharing externally.

8. Generate Preview & Print / Export

Click Generate Report (Preview) to render the formatted report in the Preview box. From there:

• Print / Save as PDF opens the browser print dialog and formats the page for A4.
• Export .doc (Word) downloads a .doc file containing the report HTML (suitable for most Word processors).
• Share / WhatsApp composes a text summary and opens web.whatsapp for manual sharing; full HTML can also be shared where supported.

9. Save / Load (Local Storage)

Saved reports are stored in the browser's localStorage (key: scrs_reports_v1). The UI provides a Saved Reports panel where you can:

• Load a report into Preview
• Open a saved report in a new tab for printing
• Download a report as Word (.doc)
• Delete saved entries

Note: In this build the Save UI may be hidden/disabled by admin configuration. The code includes a non-destructive override that can disable saving in environments where local storage is not desired.

10. Admin / Multi-user & Security Notes

SCRS supports multi-user workflows conceptually — administrators can manage templates and monitor usage. However, this front-end demonstration does not include server-side authentication or centralized storage. For production deployment integrate with your hospital's authentication, audit logs, and secure storage (PACS / EMR). Ensure compliance with local data protection policies before enabling sharing or server storage.

11. Limitations & Best Practices

Limitations: The templates, abnormality statements and measurement reference values are provided as author-curated examples. They do not replace validated clinical reference charts or specialist interpretation. Best practices:

• Verify all automatically-inserted text and measurements before finalizing a report.
• Use dedicated PACS/EMR integration in production for secure record-keeping.
• Keep templates and abnormality library reviewed and updated by a clinical lead.

12. Troubleshooting

Common issues & fixes:

• Template not loading: Re-select the Protocol then Template; check console for errors.
• Measurements not reflected: Ensure measurement inputs are filled and not empty strings; fields are bound to the template keys.
• Save disabled: The build can programmatically hide Save; check console message: SCRS: Save UI hidden and saveReport disabled.
• Print formatting issues: Use the Print button which opens a print-friendly view; browser print preview helps set margins.

13. Glossary

Template: Predefined report text with placeholders for measurements. Findings: Objective, descriptive imaging observations. Conclusion: Interpreted, summarized statements derived from findings. Abnormality library: Standard phrases for common observations, used to speed reporting.

Declaration

The SCRS Ultrasound Report tool is provided as a structured reporting aid to improve consistency and efficiency in sonography reporting. It is intended for educational and reporting support purposes only. It should not be used as the exclusive basis for clinical diagnosis, therapeutic decisions, or medico-legal judgements. Clinical correlation, validated institutional reference charts, and professional judgment must always guide final diagnosis and patient management.

Created and declared by:
R.K. Mourj — Radioimaging Technologist