Skip to main content

Medical Issues

The Medical Issues screen allows a patient to describe their health concern and optionally upload supporting documents or photos.
The screen is part of the Appointment Request flow. It supports logged-in users only. Access occurs through navigation from the appointment request form and again through the Edit Request option in the confirmation summary.


This screen includes

  • Medical Issue field (textarea). Required input describing the health concern.
  • Upload Photos or Documents link. Optional file upload supporting images and documents.

Workflow​

When the patient opens an Appointment Request, the screen enables them to describe the reason for the appointment and provide supporting information, including photos or documents.

  1. In the Medical Issues field, enter a description of the medical issue.

    • Empty input triggers an inline error message.

  2. Attach photos or documents if needed.

    • Upload accepts image (JPEG, PNG) and PDF formats up to 10 MB.
    • Upload errors display if file type or size is invalid.

  3. Select Next.

    • The app validates required fields.
    • On success, the client navigates to the confirmation summary screen and displays updated data.

  4. If the request is already submitted, go to the appointment and select Edit Request.

    • The option is available only when the appointment has a saved submission.
    • Selecting it reopens the Medical Issues screen with existing data prefilled.

  5. Update the information and select Next > Update.

    • The app validates changes and saves them to the backend.
    • On success, the client navigates back to the confirmation summary and re-fetches updated details.
    • On failure, error messages display and no navigation occurs.

Validations​

  • Medical Issues field

    • Required.
    • Empty input triggers an inline error message.
    • Maximum character length enforced on both frontend and backend.

  • File upload

    • Accepts images (JPEG, PNG) and PDF files.
    • Maximum size per file: 10 MB.
    • Upload rejects unsupported formats or files that exceed size limits.
    • Validation occurs client-side before submission and server-side after upload.

  • Navigation conditions

    • Next is disabled until required fields are valid.
    • Edit Request displays only when an appointment request has been saved.
    • Backend rejects updates for expired or invalid appointment IDs.

  • Session rules

    • Patient must be logged in.
    • Anonymous access is blocked.
    • Session timeouts redirect to login before submission.

Actions​

  • On Next

    • Client validates required fields and file uploads.
    • On success, the app submits the appointment details and navigates to the confirmation summary.
    • On failure, inline error messages display and navigation halts.

  • On Edit Request

    • The app loads the saved appointment data.
    • Screen opens with prefilled medical issue and uploaded files.

  • On Update

    • Client revalidates inputs.
    • Backend updates the appointment request with the new medical issue and files.
    • On success, the confirmation summary refreshes with updated details.
    • On failure, error messages display, and the summary does not update.

  • Error handling

    • Invalid input → inline error message.
    • Upload error → file rejected with alert message.
    • Backend error (e.g., expired request, invalid ID) → summary not updated, error displayed to patient.

Endpoint Resources​

🧰 Endpoint Resources under construction