Medical Documents and Lab Reports

This module manages uploaded clinical files (lab reports and other medical documents) linked to patients.

Access

• List: /dashboard/medical_documents
• Create/upload: /dashboard/medical_documents/create
• Download: /dashboard/medical_documents/{medical_document}/download
• Delete: /dashboard/medical_documents/{medical_document}

Legacy alias:

• /dashboard/lab_reports redirects to medical documents list.

What You Can Store

Each record includes:

• patient
• document name
• document type
• document date
• notes
• uploaded file metadata (original filename, mime type)

Files are stored on local disk under patient-specific folders.

Upload Workflow

1. Open upload form.
2. Select patient.
3. Enter name and type.
4. Attach file.
5. Optionally add notes and document date.
6. Save.

File Constraints

• file is required
• max file size: 20MB
• document type must be one of configured MedicalDocument::TYPES

Listing and Filters

You can filter by:

• patient
• type
• date range
• keyword search (name/file/patient)

Stats shown:

• filtered count
• current month count
• distinct patients in filtered result

Delete and Download

• Download streams the stored file with the original filename.
• Delete removes both DB record and local stored file.

Common Errors

• Upload rejected: file too large or invalid type.
• Download fails: file missing from storage path.
• No results in list: check date/type/patient filters.

Related

• features/patients.md
• features/clinical-notes.md
• reference/troubleshooting.md