VMS

Frontend Requirements¶

The UI shall:

1. Display examination markers in a clear vertical or card-based layout.
2. Display the marker name.
3. Display available values as selectable controls.
4. Allow the doctor to select a value using a single tap where applicable.
5. Clearly indicate the selected value.
6. Allow the doctor to change a selected value before saving.
7. Preserve the selected value while moving through the consultation.
8. Clearly distinguish unanswered markers from completed markers.
9. Support the final configurable order of markers.
10. Provide a free clinical notes area at the bottom.

Acceptance Criteria¶

AC-01

Given the doctor opens the examination screen,

when the screen loads,

then the configured examination markers are displayed.

AC-02

Given a marker has predefined values,

when the doctor taps a value,

then that value becomes selected.

AC-03

Given a value has been selected,

when the doctor selects another value,

then the previous value is replaced.

AC-04

Given a marker has not been answered,

then the UI clearly indicates that it is incomplete/unanswered.

AC-05

Given the doctor has entered examination findings,

when the doctor navigates within the consultation,

then entered values are not accidentally lost.

Out of Scope¶

• Automatic diagnosis.
• Automatic prescription.
• AI-generated medical conclusions.
• Conversational clinical assistant.
• Final clinical marker list/order until approved.

backend

Backend Requirements¶

Backend shall provide:

1. Examination marker definitions.
2. Marker values/options.
3. Marker display order.
4. Active/inactive status.
5. Marker identifier.
6. Value identifier.
7. Validation of submitted values.
8. Storage of selected examination findings against the consultation.
9. Timestamp.
10. User/doctor who recorded the finding.

Acceptance Criteria¶

AC-01

Backend returns all active examination markers.

AC-02

Backend returns the valid values for each marker.

AC-03

Backend rejects a value that is not configured for that marker.

AC-04

Backend stores examination findings against the correct patient/visit/consultation.

AC-05

Each stored finding identifies who recorded it and when.

Out of Scope¶

• Clinical diagnosis engine.
• AI reasoning.
• Treatment recommendation.
• Prescription generation.