UI Layer
UiController
UiController handles all browser-facing routes. It builds a SessionModel for every request — a typed view model passed to Thymeleaf.
@GetMapping("/dashboard")
public String dashboard(HttpSession session, Model model) {
SmartLaunchContext ctx = getContext(session);
model.addAttribute("session", buildSessionModel(ctx));
model.addAttribute("patient", fhirService.loadPatient(ctx));
model.addAttribute("stats", fhirService.loadStats(ctx));
return "dashboard";
}
SessionModel
The SessionModel record flattens SmartLaunchContext into template-friendly fields:
| Field | Type | Description |
|---|---|---|
patientId | String | FHIR Patient ID |
patientName | String | Patient display name |
clinicianName | String | From UserProfile.name |
fhirUser | String | Practitioner reference |
needBanner | boolean | From needPatientBanner |
secondsRemaining | long | expiresAt - now() |
scopeList | List<String> | Granted scopes |
fhirBaseUrl | String | For client-side display |
Patient banner
The patient banner is rendered on every clinical page when needBanner=true:
<div class="patient-banner" th:if="${session.needBanner}">
<div class="patient-id">
<span class="mrn-label">MRN</span>
<code th:text="${session.patientId}"
onclick="navigator.clipboard.writeText(this.innerText)">—</code>
</div>
<div class="patient-name" th:text="${session.patientName}">—</div>
</div>
Epic's SMART App Launch specification requires the patient banner when need_patient_banner=true. Omitting it fails App Orchard review.
Session timer
app.js shows a countdown and warns the clinician before session expiry:
const secondsRemaining = /*[[${session.secondsRemaining}]]*/ 3600;
let remaining = secondsRemaining;
setInterval(() => {
remaining--;
if (remaining <= 120) {
document.getElementById('session-warning').style.display = 'block';
document.getElementById('session-countdown').textContent =
Math.floor(remaining / 60) + ':' + String(remaining % 60).padStart(2, '0');
}
if (remaining <= 0) {
window.location.href = '/launch?error=session_expired';
}
}, 1000);
Template structure
src/main/resources/templates/
├── layout.html Base layout — nav, patient banner, footer
├── dashboard.html Stat cards, recent activity
├── patient/
│ ├── conditions.html Conditions table with ICD-10 codes
│ └── medications.html Medications table with status badges
└── error.html Error page
All templates extend layout.html via Thymeleaf fragment:
<html th:replace="~{layout :: page(~{::title}, ~{::main})}">