About this work

Purpose
A comprehensive ophthalmic evaluation used to confirm the presence of a cataract, grade its severity against the validated LOCS III (Lens Opacities Classification System III) instrument, assess its functional impact on the patient's daily life, rule out competing posterior-segment pathology (glaucoma, age-related macular degeneration, diabetic retinopathy), and determine surgical candidacy. Performed by an optometrist or ophthalmologist. The full evaluation typically takes 1 to 2 hours, because it requires pupil dilation and precise structural measurements of the eye.
Scoring
LOCS III grades four subscales (Nuclear Opalescence, Nuclear Colour, Cortical, Posterior Subcapsular) per eye on a continuous 0.1-step decimal scale. This form's own operational simplification collapses the four subscores into a mild / moderate / severe severity band per eye, which — together with best-corrected visual acuity and glare testing — drives a computed surgical-candidacy recommendation by max-grade: the worse eye and the worse test always set the band. Safety flags are computed independently and are never suppressed by a clinician override.
Clinician override
The engine produces a computed LOCS III severity band per eye and a computed surgical-candidacy recommendation. The clinician may override the final surgical-candidacy recommendation with a documented reason; both the computed and final values are stored and shown in the report, so the audit trail is preserved.
Specification
Spec-driven: the living domain spec defines the data model, the grading engine, and the safety-flag rules. The same pure engine grades both the form and the dashboard, and the HTML front-end runs an identical implementation.
Status
Clinical decision support. It does not make a diagnosis and does not replace the clinical judgement of an optometrist or ophthalmologist, who must sign the evaluation before the report is final.