Skip to main content

Quick Start

Get the app running and launch from the patient picker portal in under 5 minutes.

Prerequisites​

  • The AJ FHIR platform already running: HAPI FHIR on :8080 and Auth Server on :9000
  • The app registered on the auth server (see Platform Registration →)

Step 1 — Configure​

Set the required environment variables:

export SMART_CLIENT_ID=aj-fhir-immunization
export SMART_REDIRECT_URI=http://localhost:8084/callback
export AUTH_SERVER_URL=http://localhost:9000
export FHIR_BASE_URL=http://localhost:8080/fhir

These map to the immunization.* properties in application.yml. All have sensible defaults for local development — in a fresh local setup you can skip this step and just run.

Step 2 — Start​

# From source
cd aj-fhir-immunization
mvn spring-boot:run

# From JAR
java -jar target/aj-fhir-immunization-1.0.0-SNAPSHOT.jar

# Docker
docker run -p 8084:8084 \
  -e SMART_CLIENT_ID=aj-fhir-immunization \
  -e AUTH_SERVER_URL=http://host.docker.internal:9000 \
  -e FHIR_BASE_URL=http://host.docker.internal:8080/fhir \
  ajfhir/immunization:1.0.0

Verify it is running:

curl http://localhost:8084/actuator/health
# {"status":"UP"}

Step 3 — Launch from the portal​

  1. Open the auth server portal: http://localhost:9000/portal
  2. Log in with a clinician account (default: dr.smith / password)
  3. Search for a patient and click Launch App

The portal creates a launch token and redirects your browser to:

http://localhost:8084/launch?iss=http://localhost:8080/fhir&launch=<token>

The app completes the SMART handshake and opens the vaccination dashboard.

What you see​

Dashboard — four stat cards (total vaccinations, overdue, due this month, total recommendations), a red alert banner if any vaccine is overdue, the 5 most recent vaccinations, and the upcoming schedule.

History (/history) — the full vaccination table, filterable by vaccine code and date range.

Schedule (/recommendations) — upcoming and overdue doses grouped by status: Overdue (red), Due (amber), Immune (green).

Certificate (/certificate) — a printable vaccination card with a WHO VDS-NC QR code. Click Print or use Ctrl+P — the nav bar hides automatically.

Build from source​

git clone https://github.com/AJSmart/aj-fhir-immunization
cd aj-fhir-immunization
mvn verify
# 28 tests should pass

Next: Configuration →