Diagnostic Lab Report Download Portal

Patients still collect lab reports as paper printouts or wait for a WhatsApp photo from the lab. Paper gets lost, photos are unreadable, and there is no way to see how a value changed since the last test. This project builds a proper report portal. Patients log in with their hospital ID and see every report as a downloadable, digitally signed PDF; inside the portal each test result is shown against its reference range with a visual marker, and key values are charted across visits. On the staff side, technicians import analyser output, the system flags out-of-range and critical values, a pathologist verifies, and only then is the report published to the patient. Sharing with a doctor happens through expiring secure links, not forwarded PDFs. The project is scoped honestly: it is a document-delivery and workflow system, not a diagnostic tool — it shows results and never interprets them.

1. The patient registers with the UHID given at sample collection and logs in.
2. The technician imports the analyser's CSV against the accession number; the system stores each parameter value.
3. Values are auto-compared to reference ranges; out-of-range flags and critical-value alerts are raised.
4. Critical values follow a documented call-first protocol; everything else routes to the pathologist's verification queue.
5. On verification, the report is digitally signed, rendered to PDF, and published to the patient's library with an SMS/email notification.
6. The patient downloads the PDF or shares an expiring secure link with their doctor; trend charts update automatically.

Tech stack:

• PHP 8 (backend)
• MySQL (patients, accessions, results, verifications, shares)
• HTML5, CSS3, JavaScript + SVG charts
• PDF generation library (report rendering)
• OTP-based share links

• [Patient report library] Every report listed by date with test name, referring doctor, flag summary and one-click signed-PDF download.
• [Reference-range result view] Each parameter shown with its reference interval and a visual marker of where the patient's value falls; out-of-range values are highlighted.
• [Trend charts] Key values (haemoglobin, HbA1c, cholesterol) plotted across all past visits so patients and doctors see direction at a glance.
• [Staff release console] Technicians import analyser CSVs, the queue shows flags, critical values trigger a call-and-document step, and pathologists verify before publish.
• [Secure doctor sharing] Time-limited links (7 days) protected by the doctor's mobile OTP — no more forwarding PDFs over chat.
• [Digital signatures] Published reports carry the verifying pathologist's signature block with a verification hash.
• [Discrepancy queries] Patients can raise a query on a report, which routes back to the lab queue instead of a phone call.

• Complete portal source (patient views, staff console, PDF rendering)
• MySQL schema with anonymized sample patients and reports
• Reference-range configuration for common panels (CBC, lipid, thyroid, LFT)
• Project report PDF (requirements, workflow design, ER diagram, privacy notes, testing)
• PPT presentation for final review
• Viva Q&A preparation document (auth, PDF generation, reference-range logic, audit trails)

• The portal displays results; it does not interpret them and gives no medical advice — a disclaimer to that effect is part of the UI and the report.
• Digital signatures in the base build are system-generated signature blocks with hashes, not government-certified DSC tokens (noted as an integration option).
• Analyser integration is via CSV import in the base build; direct HL7/LIS interfacing is future scope.
• Reference ranges ship for common panels; the lab admin adds or edits ranges for the rest.
• This is an educational prototype of a lab workflow — it is not certified for clinical use, and the report states that plainly.